~bigbes/sr-ht-dolt · parade

main · last commit 6 hours ago · ti41arbu

← Back to the parade

sr-ht-dolt-0qf MCP surface: a read-only agent door to hosted databases epic Past Stand

status: closed P1 epic
bd reopen sr-ht-dolt-0qf
Created byEugene Blikh
Ownerbigbes@gmail.com
Created2026-08-12T20:10:04Z
Updated2026-08-13T07:07:08Z
Closed2026-08-13T07:07:08Z
Description
Serve /mcp on the web listener so an agent reads a hosted Dolt database — and the beads tracker inside it — by calling tools instead of scraping the board HTML. Read-only by construction: no SQL tool (the pure-Go build stands on never starting the engine), no writes, no second reading of any schema. Spec: docs/DESIGN.mcp.md.
Design
docs/DESIGN.mcp.md is normative. Donor is sourcehut-coverage/mcpsrv (modelcontextprotocol/go-sdk v1.6.1): stateless streamable HTTP, Host allowlist replacing the SDK DNS-rebinding guard, consumer-side seams in ports.go, in-process client over fakes in tests.

Subtasks 9 of 9 done

  • sr-ht-dolt-0qf.1 — Extract the beads projection into a root beads/ package P1 closed
  • sr-ht-dolt-0qf.2 — authn: the tokens.sr.ht bearer plane and core.GrantRead P1 closed
  • sr-ht-dolt-0qf.3 — mcpsrv: skeleton, Host allowlist, grant gate, list_databases P1 closed
  • sr-ht-dolt-0qf.4 — mcpsrv: generic tools over the browse seam P2 closed
  • sr-ht-dolt-0qf.5 — mcpsrv: beads tools over the shared projection P2 closed
  • sr-ht-dolt-0qf.6 — Wire /mcp into the daemon, config and README P2 closed
  • sr-ht-dolt-0qf.8 — mcpsrv: list_memories over the shared memory projection P2 closed
  • sr-ht-dolt-0qf.7 — mcpsrv: ready_work across every visible beads database P3 closed
  • sr-ht-dolt-0qf.9 — mcpsrv: carry the per-table clip list on list_issues P3 closed

Depends on

No outgoing dependencies.

Depended on by

  • sr-ht-dolt-0qf.4 — mcpsrv: generic tools over the browse seam parent-child
  • sr-ht-dolt-0qf.2 — authn: the tokens.sr.ht bearer plane and core.GrantRead parent-child
  • sr-ht-dolt-0qf.1 — Extract the beads projection into a root beads/ package parent-child
  • sr-ht-dolt-0qf.5 — mcpsrv: beads tools over the shared projection parent-child
  • sr-ht-dolt-0qf.7 — mcpsrv: ready_work across every visible beads database parent-child
  • sr-ht-dolt-0qf.3 — mcpsrv: skeleton, Host allowlist, grant gate, list_databases parent-child
  • sr-ht-dolt-0qf.9 — mcpsrv: carry the per-table clip list on list_issues parent-child
  • sr-ht-dolt-0qf.8 — mcpsrv: list_memories over the shared memory projection parent-child
  • sr-ht-dolt-0qf.6 — Wire /mcp into the daemon, config and README parent-child

Unblocks — everything waiting on this, transitively

  • sr-ht-dolt-0qf.4 — mcpsrv: generic tools over the browse seam parent-child closed
  • sr-ht-dolt-0qf.6 — Wire /mcp into the daemon, config and README blocks closed
  • sr-ht-dolt-0qf.2 — authn: the tokens.sr.ht bearer plane and core.GrantRead parent-child closed
  • sr-ht-dolt-0qf.3 — mcpsrv: skeleton, Host allowlist, grant gate, list_databases blocks closed
  • sr-ht-dolt-0qf.5 — mcpsrv: beads tools over the shared projection blocks closed
  • sr-ht-dolt-0qf.1 — Extract the beads projection into a root beads/ package parent-child closed
  • sr-ht-dolt-44n.5 — /ready: the cross-database ready page blocks closed
  • sr-ht-dolt-44n.6 — Cross-database issue links in rendered text blocks closed
  • sr-ht-dolt-0qf.7 — mcpsrv: ready_work across every visible beads database blocks closed
  • sr-ht-dolt-0qf.9 — mcpsrv: carry the per-table clip list on list_issues parent-child closed
  • sr-ht-dolt-0qf.8 — mcpsrv: list_memories over the shared memory projection parent-child closed

No comments.

Close reason

All eight tasks landed: the beads/ extraction, the bearer plane, the mcpsrv skeleton, the generic tools, the beads tools, the daemon wiring, list_memories and ready_work. docs/DESIGN.mcp.md is implemented end to end.
  • Eugene Blikh created the issue · 2026-08-12T23:10:04Z
  • Eugene Blikh added subtask sr-ht-dolt-0qf.1 · 2026-08-12T23:11:37Z
  • Eugene Blikh added subtask sr-ht-dolt-0qf.2 · 2026-08-12T23:11:43Z
  • Eugene Blikh added subtask sr-ht-dolt-0qf.4 · 2026-08-12T23:11:44Z
  • Eugene Blikh added subtask sr-ht-dolt-0qf.3 · 2026-08-12T23:11:44Z
  • Eugene Blikh added subtask sr-ht-dolt-0qf.5 · 2026-08-12T23:11:45Z
  • Eugene Blikh added subtask sr-ht-dolt-0qf.6 · 2026-08-12T23:11:46Z
  • Eugene Blikh added subtask sr-ht-dolt-0qf.7 · 2026-08-12T23:11:51Z
  • Eugene Blikh added subtask sr-ht-dolt-0qf.8 · 2026-08-13T08:46:26Z
  • Eugene Blikh closed the issue · 2026-08-13T10:07:07Z
    All eight tasks landed: the beads/ extraction, the bearer plane, the mcpsrv skeleton, the generic tools, the beads tools, the daemon wiring, list_memories and ready_work. docs/DESIGN.mcp.md is implemented end to end.
  • Eugene Blikh added subtask sr-ht-dolt-0qf.9 · 2026-08-13T11:12:17Z
Stored rows — what this pane was built from, as read
issues 1 row
id sr-ht-dolt-0qf
content_hash fc02bbd7697c59c02d006fb5e3bf2c052d971c36d809bea95e2ef0a159889b16
title MCP surface: a read-only agent door to hosted databases
description Serve /mcp on the web listener so an agent reads a hosted Dolt database — and the beads tracker inside it — by calling tools instead of scraping the board HTML. Read-only by construction: no SQL tool (the pure-Go build stands on never starting the engine), no writes, no second reading of any schema. Spec: docs/DESIGN.mcp.md.
design docs/DESIGN.mcp.md is normative. Donor is sourcehut-coverage/mcpsrv (modelcontextprotocol/go-sdk v1.6.1): stateless streamable HTTP, Host allowlist replacing the SDK DNS-rebinding guard, consumer-side seams in ports.go, in-process client over fakes in tests.
acceptance_criteria
notes
status closed
priority 1
issue_type epic
assignee NULL
estimated_minutes NULL
created_at 2026-08-12T20:10:04Z
created_by Eugene Blikh
owner bigbes@gmail.com
updated_at 2026-08-13T07:07:08Z
closed_at 2026-08-13T07:07:08Z
closed_by_session
external_ref NULL
spec_id
compaction_level 0
compacted_at NULL
compacted_at_commit NULL
original_size NULL
sender
ephemeral 0
wisp_type
pinned 0
is_template 0
mol_type
work_type
source_system
metadata �{}
source_repo
close_reason All eight tasks landed: the beads/ extraction, the bearer plane, the mcpsrv skeleton, the generic tools, the beads tools, the daemon wiring, list_memories and ready_work. docs/DESIGN.mcp.md is implemented end to end.
event_kind
actor
target
payload
await_type
await_id
timeout_ns 0
waiters
hook_bead
role_bead
agent_state
last_activity NULL
role_type
rig
due_at NULL
defer_until NULL
no_history 0
started_at NULL
is_blocked 0
dependencies 9 rows
id 03f3e80e-f338-5ac8-9e05-18bcd396d161
issue_id sr-ht-dolt-0qf.4
type parent-child
created_at 2026-08-12T23:11:44Z
created_by Eugene Blikh
metadata �{}
thread_id
depends_on_issue_id sr-ht-dolt-0qf
depends_on_wisp_id NULL
depends_on_external NULL
id 077a135e-06c7-595a-9dda-2a09f4c1225d
issue_id sr-ht-dolt-0qf.2
type parent-child
created_at 2026-08-12T23:11:43Z
created_by Eugene Blikh
metadata �{}
thread_id
depends_on_issue_id sr-ht-dolt-0qf
depends_on_wisp_id NULL
depends_on_external NULL
id 09146b3e-e820-5e43-ae15-4f26449dedf8
issue_id sr-ht-dolt-0qf.1
type parent-child
created_at 2026-08-12T23:11:37Z
created_by Eugene Blikh
metadata �{}
thread_id
depends_on_issue_id sr-ht-dolt-0qf
depends_on_wisp_id NULL
depends_on_external NULL
id 29280a2b-2a4b-51cd-b4d9-6e170f1e1239
issue_id sr-ht-dolt-0qf.5
type parent-child
created_at 2026-08-12T23:11:45Z
created_by Eugene Blikh
metadata �{}
thread_id
depends_on_issue_id sr-ht-dolt-0qf
depends_on_wisp_id NULL
depends_on_external NULL
id 304e3b2f-5801-540d-ab76-901d777ea0b8
issue_id sr-ht-dolt-0qf.7
type parent-child
created_at 2026-08-12T23:11:51Z
created_by Eugene Blikh
metadata �{}
thread_id
depends_on_issue_id sr-ht-dolt-0qf
depends_on_wisp_id NULL
depends_on_external NULL
id 5e3c79a4-431d-5096-88f6-615afe422328
issue_id sr-ht-dolt-0qf.3
type parent-child
created_at 2026-08-12T23:11:44Z
created_by Eugene Blikh
metadata �{}
thread_id
depends_on_issue_id sr-ht-dolt-0qf
depends_on_wisp_id NULL
depends_on_external NULL
id 96f227d7-e67e-5092-b6d4-d6e8c6e816ed
issue_id sr-ht-dolt-0qf.9
type parent-child
created_at 2026-08-13T11:12:17Z
created_by Eugene Blikh
metadata �{}
thread_id
depends_on_issue_id sr-ht-dolt-0qf
depends_on_wisp_id NULL
depends_on_external NULL
id 9b18ea59-ad11-5127-a90b-0ae02138f780
issue_id sr-ht-dolt-0qf.8
type parent-child
created_at 2026-08-13T08:46:26Z
created_by Eugene Blikh
metadata �{}
thread_id
depends_on_issue_id sr-ht-dolt-0qf
depends_on_wisp_id NULL
depends_on_external NULL
id c8edf5f3-6bf5-53cd-b71f-592e7509200a
issue_id sr-ht-dolt-0qf.6
type parent-child
created_at 2026-08-12T23:11:46Z
created_by Eugene Blikh
metadata �{}
thread_id
depends_on_issue_id sr-ht-dolt-0qf
depends_on_wisp_id NULL
depends_on_external NULL
events 2 rows
id 019ff798-a5e4-7459-8de9-af3bc522f624
issue_id sr-ht-dolt-0qf
event_type created
actor Eugene Blikh
old_value
new_value
comment NULL
created_at 2026-08-12T23:10:04Z
id 019ff9f2-3377-763d-9c7a-2be75c8bef77
issue_id sr-ht-dolt-0qf
event_type closed
actor Eugene Blikh
old_value
new_value All eight tasks landed: the beads/ extraction, the bearer plane, the mcpsrv skeleton, the generic tools, the beads tools, the daemon wiring, list_memories and ready_work. docs/DESIGN.mcp.md is implemented end to end.
comment NULL
created_at 2026-08-13T10:07:07Z