From 6c997e72b6d642259f795dccb1b3d51eae75e230 Mon Sep 17 00:00:00 2001 From: Enrico Piovesan Date: Mon, 24 Aug 2026 17:59:31 -0600 Subject: [PATCH 1/2] docs: park MCP tickets after Traverse Specs 114/115 Record the board-hygiene decisions and align start-plan notes with Blocked catalog/Mode B work plus meeting-notes natives Done via #236. Co-authored-by: Cursor --- AGENTS.md | 5 ++-- docs/decision-log.md | 52 +++++++++++++++++++++++++++++++++ docs/llm-reference-apps-plan.md | 4 +-- 3 files changed, 57 insertions(+), 4 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 47c1048..d300057 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -28,12 +28,13 @@ gh project item-list 2 --owner traverse-framework --format json --limit 300 \ | `llm-mcp-meeting-notes-workflow` | **Done** (#239) | Meeting-notes MCP tool-sequence runbook | | `llm-mcp-cursor-live-smoke` | **Done** (#240) | Cursor MCP Mode A stdio evidence | | `llm-mcp-claude-live-smoke` | **Done** (#241) | Claude Desktop/Code MCP Mode A evidence | -| `llm-mcp-traverse-starter-catalog` | **Blocked** | Traverse #865 (registry #99 closed) | +| `llm-mcp-traverse-starter-catalog` | **Blocked** | Traverse #865; Specs 114/115 ratified; Mode A implement gated on #1132 then #876 | | `loop-wf1-registry-deps` | **Done** (#263) | Digest inventory in `docs/loop-registry-deps.md` | | `loop-wf1-multi-os` | **Done** (#265) | `apps/loop/` WF1 × 7 OS; compose via `registry_ref` | | `retire-registry-ref-materialize` | **Done** (#267) | Phase A gate; host cutover → Future `retire-registry-ref-materialize-hosts` | | `retire-registry-ref-materialize-hosts` | **Future** | Full materialize delete after BundleEmbedder + Spec 107 | -| `llm-mcp-embedded-host` | **In Progress** | Mode B scaffold on Spec 520 cache; live host → Traverse #865 | +| `meeting-notes-remaining-natives` | **Done** (#236) | Shipped via `meeting-notes-wave2-os-ports` | +| `llm-mcp-embedded-host` | **Blocked** | Scaffold Done (#268); live Mode B host → Traverse #865 | Full gap table + wave notes: [`docs/production-reference-plan.md`](docs/production-reference-plan.md). diff --git a/docs/decision-log.md b/docs/decision-log.md index b30ef19..656085b 100644 --- a/docs/decision-log.md +++ b/docs/decision-log.md @@ -206,3 +206,55 @@ Append-only record of design decisions for App-References. Newest sessions at th - Using recorded fixtures as the primary Loop demo path - Filling meeting-notes native gaps inside Phase 1 - Expanding Trace Explorer beyond web + +--- + +## 2026-08-24 — Next App-Refs slice after Traverse Specs 114/115 + +**Context:** Project 2 Ready was empty. Traverse ratified Specs 114 (MCP capability search) and 115 (browser-verified entrypoint execution), closed Mode A spec ticket #1125, and opened Ready spec #1132 (verified public contract-metadata cache). App-Refs asked what to do next. + +### Next slice + +**Question:** Where should the next App-References slice go? + +**Options considered:** +- Board hygiene + park MCP consumer work as Blocked — pros: honest board; no fake Ready; tracks Traverse without implementing against unshipped hosts; cons: no new App-Refs code this turn +- Promote Loop WF3 to Ready and implement — pros: independent product work now that WF1 is Done; cons: ignores the Traverse progress that prompted the question +- Wait with no board/docs changes until Traverse #1132 + Mode A implement are Ready — pros: zero extra tickets; cons: Project 2 stays stale (In Progress Mode B scaffold, leftover Future natives) +- File Spec 114/115 consumer tickets as Ready and start docs/smoke now — pros: looks like progress; cons: would fake catalog/browser behavior the runtime does not serve yet + +**Recommendation:** Board hygiene + park MCP consumer work as Blocked. + +**Decision:** Board hygiene + park MCP consumer work as Blocked. + +**Why:** Ready is empty for a real reason; the next honest consumer work is Mode A kit catalog after Traverse lands #1132 and implement children. Keep Loop WF3 Future. + +### Ticket shape + +**Question:** How should Spec 114/115 consumer work be parked without fake-Ready tickets? + +**Options considered:** +- Retarget existing tickets only — pros: no duplicate backlog; catalog + Mode B tickets already exist; cons: Spec 115 browser path is only implied, not a dedicated App-Refs ticket +- One new Blocked umbrella for Spec 114/115 consumers — pros: visible new work; cons: overlaps `llm-mcp-traverse-starter-catalog` +- Two new Blocked tickets (MCP search façade + browser Spec 115) — pros: precise DoD later; cons: over-filing before Traverse implement exists + +**Recommendation:** Retarget existing tickets only. + +**Decision:** Retarget existing tickets only. + +**Why:** `llm-mcp-traverse-starter-catalog` already is the Mode A kit-catalog consumer; Mode B stays on `llm-mcp-embedded-host`. Do not invent Ready work. + +### Stale meeting-notes Future ticket + +**Question:** Wave 2 already shipped meeting-notes iOS/macOS/Android/Windows. What should happen to `meeting-notes-remaining-natives`? + +**Options considered:** +- Mark Done with a note pointing at #236 — pros: Future ticket intent is satisfied; single Done record; cons: two ticket IDs point at the same ship +- Cancel as duplicate of `meeting-notes-wave2-os-ports` — pros: no double-count; cons: Future item disappears without a Done trail +- Keep Future (treat Wave 2 as incomplete) — pros: none; cons: contradicts the tree and README all-OS matrix + +**Recommendation:** Mark Done, note #236. + +**Decision:** Mark Done, note #236. + +**Why:** The leftover Future item’s DoD (add the missing natives) is met by `meeting-notes-wave2-os-ports` (#236). diff --git a/docs/llm-reference-apps-plan.md b/docs/llm-reference-apps-plan.md index 3426c10..346d58c 100644 --- a/docs/llm-reference-apps-plan.md +++ b/docs/llm-reference-apps-plan.md @@ -91,8 +91,8 @@ v1 documents **Mode A** only. Do not revive HTTP `traverse-cli serve` as the pro | `llm-mcp-meeting-notes-workflow` | Document + config for meeting-notes via MCP | Done (#239) | | `llm-mcp-chatgpt-adapter` | ChatGPT Actions/GPT mapping (or MCP when shipped) | Future / Ready when API stable | | `llm-mcp-grok-adapter` | Grok tool-calling mapping | Future / Ready when API stable | -| `llm-mcp-traverse-starter-catalog` | Expose kit (`traverse-starter.*` / meeting-notes) on MCP stdio catalog | Blocked — Traverse [#865](https://github.com/traverse-framework/Traverse/issues/865) / registry [#99](https://github.com/traverse-framework/registry/issues/99) | -| `llm-mcp-embedded-host` | Mode B embedded prepare/cache for MCP host | Scaffold Done (this slice); live Mode B host waits on Traverse #865 | +| `llm-mcp-traverse-starter-catalog` | Expose kit (`traverse-starter.*` / meeting-notes) on MCP stdio catalog | Blocked — Traverse [#865](https://github.com/traverse-framework/Traverse/issues/865); Specs [114](https://github.com/traverse-framework/Traverse/blob/main/specs/114-mcp-capability-search/spec.md)/[115](https://github.com/traverse-framework/Traverse/blob/main/specs/115-browser-verified-entrypoint-execution/spec.md) ratified; Mode A implement gated on Traverse [#1132](https://github.com/traverse-framework/Traverse/issues/1132) then [#876](https://github.com/traverse-framework/Traverse/issues/876). Registry [#99](https://github.com/traverse-framework/registry/issues/99) closed | +| `llm-mcp-embedded-host` | Mode B embedded prepare/cache for MCP host | Scaffold Done (#268); live Mode B host blocked on Traverse [#865](https://github.com/traverse-framework/Traverse/issues/865) (Mode B out of Mode A spec #1125) | ## Success criteria (plan slice) From b4d1e8353aff72e9f703e163752dd7986bfb99bd Mon Sep 17 00:00:00 2001 From: Enrico Piovesan Date: Tue, 25 Aug 2026 16:36:43 -0600 Subject: [PATCH 2/2] docs: treat Spec 119 Mode A as approved consumer contract Record user approval and keep the catalog ticket Blocked on traverse-mcp implement, not kit content groups. Co-authored-by: Cursor --- AGENTS.md | 2 +- docs/decision-log.md | 8 ++++++++ docs/llm-reference-apps-plan.md | 2 +- 3 files changed, 10 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index d300057..4458538 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -28,7 +28,7 @@ gh project item-list 2 --owner traverse-framework --format json --limit 300 \ | `llm-mcp-meeting-notes-workflow` | **Done** (#239) | Meeting-notes MCP tool-sequence runbook | | `llm-mcp-cursor-live-smoke` | **Done** (#240) | Cursor MCP Mode A stdio evidence | | `llm-mcp-claude-live-smoke` | **Done** (#241) | Claude Desktop/Code MCP Mode A evidence | -| `llm-mcp-traverse-starter-catalog` | **Blocked** | Traverse #865; Specs 114/115 ratified; Mode A implement gated on #1132 then #876 | +| `llm-mcp-traverse-starter-catalog` | **Blocked** | Spec 119 Approved; wait on Mode A `traverse-mcp` implement (#865). No kit content groups in v1 (FR-007) | | `loop-wf1-registry-deps` | **Done** (#263) | Digest inventory in `docs/loop-registry-deps.md` | | `loop-wf1-multi-os` | **Done** (#265) | `apps/loop/` WF1 × 7 OS; compose via `registry_ref` | | `retire-registry-ref-materialize` | **Done** (#267) | Phase A gate; host cutover → Future `retire-registry-ref-materialize-hosts` | diff --git a/docs/decision-log.md b/docs/decision-log.md index 656085b..68c9bf2 100644 --- a/docs/decision-log.md +++ b/docs/decision-log.md @@ -258,3 +258,11 @@ Append-only record of design decisions for App-References. Newest sessions at th **Decision:** Mark Done, note #236. **Why:** The leftover Future item’s DoD (add the missing natives) is met by `meeting-notes-wave2-os-ports` (#236). + +### Spec 119 Mode A host (2026-08-25) + +**Question:** Is Traverse spec `119-verified-registry-mcp-mode-a` approved for App-Refs to treat as the Mode A consumer contract? + +**Decision:** Approved. Artifact is on Traverse main (PR #1146); status **Approved (2026-08-25)**. + +**Why:** User confirmed approval. App-Refs catalog ticket stays Blocked until the Mode A binary/implement lands; v1 discovery is public registry entries, not hardcoded kit content groups (FR-007). diff --git a/docs/llm-reference-apps-plan.md b/docs/llm-reference-apps-plan.md index 346d58c..ce2f950 100644 --- a/docs/llm-reference-apps-plan.md +++ b/docs/llm-reference-apps-plan.md @@ -91,7 +91,7 @@ v1 documents **Mode A** only. Do not revive HTTP `traverse-cli serve` as the pro | `llm-mcp-meeting-notes-workflow` | Document + config for meeting-notes via MCP | Done (#239) | | `llm-mcp-chatgpt-adapter` | ChatGPT Actions/GPT mapping (or MCP when shipped) | Future / Ready when API stable | | `llm-mcp-grok-adapter` | Grok tool-calling mapping | Future / Ready when API stable | -| `llm-mcp-traverse-starter-catalog` | Expose kit (`traverse-starter.*` / meeting-notes) on MCP stdio catalog | Blocked — Traverse [#865](https://github.com/traverse-framework/Traverse/issues/865); Specs [114](https://github.com/traverse-framework/Traverse/blob/main/specs/114-mcp-capability-search/spec.md)/[115](https://github.com/traverse-framework/Traverse/blob/main/specs/115-browser-verified-entrypoint-execution/spec.md) ratified; Mode A implement gated on Traverse [#1132](https://github.com/traverse-framework/Traverse/issues/1132) then [#876](https://github.com/traverse-framework/Traverse/issues/876). Registry [#99](https://github.com/traverse-framework/registry/issues/99) closed | +| `llm-mcp-traverse-starter-catalog` | Discover/execute kit capabilities (`traverse-starter.*` / meeting-notes) via Mode A public registry discovery | Blocked — Spec [`119-verified-registry-mcp-mode-a`](https://github.com/traverse-framework/Traverse/blob/main/specs/119-verified-registry-mcp-mode-a/spec.md) **Approved**; wait on Mode A `traverse-mcp` implement under Traverse [#865](https://github.com/traverse-framework/Traverse/issues/865). First release has no kit content groups (FR-007). Registry [#99](https://github.com/traverse-framework/registry/issues/99) closed | | `llm-mcp-embedded-host` | Mode B embedded prepare/cache for MCP host | Scaffold Done (#268); live Mode B host blocked on Traverse [#865](https://github.com/traverse-framework/Traverse/issues/865) (Mode B out of Mode A spec #1125) | ## Success criteria (plan slice)