docs: Claude Desktop/Code MCP live smoke evidence

apps/llm-mcp-reference/clients/claude-code/README.md

@@ -2,12 +2,16 @@
 
 ## Setup
 
-1. Ensure Traverse builds: `cargo run -p traverse-mcp -- stdio` from the Traverse root.
+1. Ensure Traverse builds: `cargo run -p traverse-mcp -- stdio` from the Traverse root (tested **v0.8.2+**).
 2. Copy [`.mcp.json.example`](.mcp.json.example) to your project or user MCP config as supported by Claude Code.
-3. Set absolute `cwd` / `TRAVERSE_REPO`.
+3. Set **absolute** `cwd` / `TRAVERSE_REPO` (replace `/ABS/PATH/TO/Traverse`).
 4. Load [`../../shared/prompts/system-boundary.md`](../../shared/prompts/system-boundary.md).
-5. Run [`../../shared/workflows/traverse-starter.md`](../../shared/workflows/traverse-starter.md).
+5. Run [`../../shared/workflows/traverse-starter.md`](../../shared/workflows/traverse-starter.md) when starter IDs are in the MCP catalog; otherwise use `list_entrypoints` and render runtime fields only.
 6. For transcripts, follow [`../../shared/workflows/meeting-notes.md`](../../shared/workflows/meeting-notes.md).
 
+## Live evidence
+
+See [`evidence/`](evidence/) — Mode A stdio transcripts for the same command as `.mcp.json.example` (`llm-mcp-claude-live-smoke`).
+
 Companion authoring skill (contracts only — not product business logic):  
 https://github.com/traverse-framework/claude-skills

apps/llm-mcp-reference/clients/claude-code/evidence/README.md

@@ -0,0 +1,26 @@
+# Claude Code MCP live evidence (`llm-mcp-claude-live-smoke`)
+
+Captured **2026-07-29** against Traverse **v0.8.2**.
+
+## What was proven
+
+[`.mcp.json.example`](../.mcp.json.example) launches the same Mode A command as Claude Desktop:
+
+```bash
+cargo run -p traverse-mcp -- stdio
+```
+
+Command transcripts (Claude Code CLI GUI not required for this evidence):
+
+| File | Contents |
+|---|---|
+| [`claude-code-mcp-stdio-transcript.jsonl`](claude-code-mcp-stdio-transcript.jsonl) | discovery + shutdown |
+| [`claude-code-mcp-execute-transcript.jsonl`](claude-code-mcp-execute-transcript.jsonl) | validate → execute → render on `expedition.planning.plan-expedition` |
+
+## Runtime fields only
+
+Do not invent business fields; render MCP/runtime output only.
+
+## Catalog note
+
+Same as Desktop: default catalog is expedition until starter/meeting-notes entrypoints are published to MCP.

apps/llm-mcp-reference/clients/claude-code/evidence/claude-code-mcp-stdio-transcript.jsonl

@@ -0,0 +1,5 @@
+{"auth_boundary":{"default_mode":"local_trust","required_commands":["execute_entrypoint","render_execution_report"],"required_token_env":"TRAVERSE_MCP_STDIO_BEARER_TOKEN"},"content_group_count":1,"governing_spec":"022-mcp-wasm-server","host_mode":"stdio","kind":"mcp_stdio_server_startup","public_surface_id":"traverse.mcp.stdio-server","server_name":"traverse-mcp","status":"ready","supported_commands":["describe_server","list_content_groups","describe_content_group","list_entrypoints","describe_entrypoint","validate_entrypoint","execute_entrypoint","render_execution_report","shutdown"]}
+{"auth_boundary":{"default_mode":"local_trust","required_commands":["execute_entrypoint","render_execution_report"],"required_token_env":"TRAVERSE_MCP_STDIO_BEARER_TOKEN","token_output_policy":"never_echo_raw_token"},"content_groups":[{"content_group_id":"core-runtime-example","display_name":"Core runtime example","governed_paths":["examples/templates/executable-capability-package/manifest.template.json","docs/executable-package-template.md","docs/local-runtime-home.md","scripts/ci/executable_package_template_smoke.sh"],"invocable_entrypoints":["describe_content_group"],"summary":"Traverse-neutral executable capability package template and local runtime shape.","validation_commands":["bash scripts/ci/executable_package_template_smoke.sh"]}],"downstream_validation_path":{"consumer_name":"youaskm3","governing_specs":["019-downstream-consumer-contract","020-downstream-integration-validation","021-app-facing-operational-constraints"],"public_surface_id":"traverse.mcp.downstream-consumer","validated_flow_id":"youaskm3_mcp_validation"},"governed_surface_counts":{"capabilities":6,"events":5,"workflows":1},"governing_spec":"022-mcp-wasm-server","host_mode":"stdio","kind":"mcp_stdio_server_description","public_surface_id":"traverse.mcp.stdio-server","runtime_authority":"Traverse runtime authority","server_name":"traverse-mcp","supported_commands":["describe_server","list_content_groups","describe_content_group","list_entrypoints","describe_entrypoint","validate_entrypoint","execute_entrypoint","render_execution_report","shutdown"]}
+{"content_groups":[{"content_group_id":"core-runtime-example","display_name":"Core runtime example","governed_paths":["examples/templates/executable-capability-package/manifest.template.json","docs/executable-package-template.md","docs/local-runtime-home.md","scripts/ci/executable_package_template_smoke.sh"],"invocable_entrypoints":["describe_content_group"],"summary":"Traverse-neutral executable capability package template and local runtime shape.","validation_commands":["bash scripts/ci/executable_package_template_smoke.sh"]}],"entrypoints":{"capabilities":[{"artifact_kind":"capability","id":"expedition.planning.capture-expedition-objective","lifecycle":"active","summary":"Capture a structured expedition objective from destination, timing, and planning preference inputs.","version":"1.0.0"},{"artifact_kind":"capability","id":"expedition.planning.interpret-expedition-intent","lifecycle":"active","summary":"Interpret free-form expedition planning intent into structured route preferences, constraints, and assumptions.","version":"1.0.0"},{"artifact_kind":"capability","id":"expedition.planning.assess-conditions-summary","lifecycle":"active","summary":"Assess a deterministic expedition conditions summary from objective and interpreted intent context.","version":"1.0.0"},{"artifact_kind":"capability","id":"expedition.planning.validate-team-readiness","lifecycle":"active","summary":"Validate expedition team readiness from objective, conditions summary, and team profile context.","version":"1.0.0"},{"artifact_kind":"capability","id":"expedition.planning.assemble-expedition-plan","lifecycle":"active","summary":"Assemble the final expedition plan from objective, interpreted intent, conditions, and readiness inputs.","version":"1.0.0"},{"artifact_kind":"capability","id":"expedition.planning.plan-expedition","lifecycle":"active","summary":"Compose the canonical expedition planning workflow into one first-class governed capability.","version":"1.0.0"}],"events":[{"artifact_kind":"event","id":"expedition.planning.expedition-objective-captured","lifecycle":"active","summary":"A normalized expedition objective has been captured and is ready for downstream planning.","version":"1.0.0"},{"artifact_kind":"event","id":"expedition.planning.expedition-intent-interpreted","lifecycle":"active","summary":"An expedition intent has been interpreted into structured planning inputs for downstream steps.","version":"1.0.0"},{"artifact_kind":"event","id":"expedition.planning.conditions-summary-assessed","lifecycle":"active","summary":"A deterministic expedition conditions summary has been assessed for the current planning context.","version":"1.0.0"},{"artifact_kind":"event","id":"expedition.planning.team-readiness-validated","lifecycle":"active","summary":"A team readiness result has been validated for the expedition objective and conditions context.","version":"1.0.0"},{"artifact_kind":"event","id":"expedition.planning.expedition-plan-assembled","lifecycle":"active","summary":"A final expedition plan has been assembled and is ready for downstream consumption.","version":"1.0.0"}],"workflows":[{"artifact_kind":"workflow","id":"expedition.planning.plan-expedition","lifecycle":"active","summary":"Capture, interpret, validate, and assemble an expedition plan deterministically.","version":"1.0.0"}]},"governing_spec":"022-mcp-wasm-server","host_mode":"stdio","kind":"mcp_stdio_server_entrypoint_list","server_name":"traverse-mcp"}
+{"content_groups":[{"content_group_id":"core-runtime-example","display_name":"Core runtime example","governed_paths":["examples/templates/executable-capability-package/manifest.template.json","docs/executable-package-template.md","docs/local-runtime-home.md","scripts/ci/executable_package_template_smoke.sh"],"invocable_entrypoints":["describe_content_group"],"summary":"Traverse-neutral executable capability package template and local runtime shape.","validation_commands":["bash scripts/ci/executable_package_template_smoke.sh"]}],"governing_spec":"022-mcp-wasm-server","host_mode":"stdio","kind":"mcp_stdio_server_content_group_list","server_name":"traverse-mcp"}
+{"governing_spec":"022-mcp-wasm-server","host_mode":"stdio","kind":"mcp_stdio_server_shutdown","reason":"shutdown_command","server_name":"traverse-mcp","status":"complete"}

apps/llm-mcp-reference/clients/claude-desktop/README.md

@@ -2,12 +2,16 @@
 
 ## Setup
 
-1. Install/build Traverse so `cargo run -p traverse-mcp -- stdio` works.
+1. Install/build Traverse so `cargo run -p traverse-mcp -- stdio` works (tested **v0.8.2+**).
 2. Copy [`mcp.json.example`](mcp.json.example) into Claude Desktop’s MCP config (merge with existing servers).
-3. Replace `TRAVERSE_REPO` paths with your absolute Traverse checkout.
+3. Replace `/ABS/PATH/TO/Traverse` with your **absolute** Traverse checkout in both `cwd` and `env.TRAVERSE_REPO`.
 4. Add [`../../shared/prompts/system-boundary.md`](../../shared/prompts/system-boundary.md) to the project/custom instructions.
-5. Follow [`../../shared/workflows/traverse-starter.md`](../../shared/workflows/traverse-starter.md).
-6. For transcripts, follow [`../../shared/workflows/meeting-notes.md`](../../shared/workflows/meeting-notes.md).
+5. Follow [`../../shared/workflows/traverse-starter.md`](../../shared/workflows/traverse-starter.md) when starter entrypoints appear in `list_entrypoints`; until then discover via MCP and render runtime fields only.
+6. For transcripts, follow [`../../shared/workflows/meeting-notes.md`](../../shared/workflows/meeting-notes.md) once `meeting-notes.process` is catalogued.
+
+## Live evidence
+
+See [`evidence/`](evidence/) — Mode A stdio command transcripts matching `mcp.json.example` (`llm-mcp-claude-live-smoke`).
 
 ## Boundary
 

apps/llm-mcp-reference/clients/claude-desktop/evidence/README.md

@@ -0,0 +1,28 @@
+# Claude Desktop MCP live evidence (`llm-mcp-claude-live-smoke`)
+
+Captured **2026-07-29** against Traverse **v0.8.2**.
+
+## What was proven
+
+[`../mcp.json.example`](../mcp.json.example) launches:
+
+```bash
+cargo run -p traverse-mcp -- stdio
+```
+
+That exact Mode A command was exercised (JSONL stdio envelopes). Claude Desktop GUI was **not** available in this Linux cloud-agent environment; DoD allows a **command transcript** in lieu of screenshots.
+
+### Files
+
+| File | Contents |
+|---|---|
+| [`claude-desktop-mcp-stdio-transcript.jsonl`](claude-desktop-mcp-stdio-transcript.jsonl) | `describe_server` → `list_entrypoints` → `list_content_groups` → `shutdown` |
+| [`claude-desktop-mcp-execute-transcript.jsonl`](claude-desktop-mcp-execute-transcript.jsonl) | validate → execute → `render_execution_report` on `expedition.planning.plan-expedition` (status valid / completed / rendered) |
+
+## Runtime fields only
+
+Present only fields returned by MCP envelopes / `render_execution_report`. Do not invent title/tags or meeting-notes rows.
+
+## Catalog note
+
+Default `traverse-mcp` catalog on v0.8.2 is the **expedition** bundle. `traverse-starter.*` IDs are not listed yet; the Claude Desktop config still correctly binds to Mode A stdio. See Cursor evidence for the same catalog honesty note.

apps/llm-mcp-reference/clients/claude-desktop/evidence/claude-desktop-mcp-stdio-transcript.jsonl

@@ -0,0 +1,5 @@
+{"auth_boundary":{"default_mode":"local_trust","required_commands":["execute_entrypoint","render_execution_report"],"required_token_env":"TRAVERSE_MCP_STDIO_BEARER_TOKEN"},"content_group_count":1,"governing_spec":"022-mcp-wasm-server","host_mode":"stdio","kind":"mcp_stdio_server_startup","public_surface_id":"traverse.mcp.stdio-server","server_name":"traverse-mcp","status":"ready","supported_commands":["describe_server","list_content_groups","describe_content_group","list_entrypoints","describe_entrypoint","validate_entrypoint","execute_entrypoint","render_execution_report","shutdown"]}
+{"auth_boundary":{"default_mode":"local_trust","required_commands":["execute_entrypoint","render_execution_report"],"required_token_env":"TRAVERSE_MCP_STDIO_BEARER_TOKEN","token_output_policy":"never_echo_raw_token"},"content_groups":[{"content_group_id":"core-runtime-example","display_name":"Core runtime example","governed_paths":["examples/templates/executable-capability-package/manifest.template.json","docs/executable-package-template.md","docs/local-runtime-home.md","scripts/ci/executable_package_template_smoke.sh"],"invocable_entrypoints":["describe_content_group"],"summary":"Traverse-neutral executable capability package template and local runtime shape.","validation_commands":["bash scripts/ci/executable_package_template_smoke.sh"]}],"downstream_validation_path":{"consumer_name":"youaskm3","governing_specs":["019-downstream-consumer-contract","020-downstream-integration-validation","021-app-facing-operational-constraints"],"public_surface_id":"traverse.mcp.downstream-consumer","validated_flow_id":"youaskm3_mcp_validation"},"governed_surface_counts":{"capabilities":6,"events":5,"workflows":1},"governing_spec":"022-mcp-wasm-server","host_mode":"stdio","kind":"mcp_stdio_server_description","public_surface_id":"traverse.mcp.stdio-server","runtime_authority":"Traverse runtime authority","server_name":"traverse-mcp","supported_commands":["describe_server","list_content_groups","describe_content_group","list_entrypoints","describe_entrypoint","validate_entrypoint","execute_entrypoint","render_execution_report","shutdown"]}
+{"content_groups":[{"content_group_id":"core-runtime-example","display_name":"Core runtime example","governed_paths":["examples/templates/executable-capability-package/manifest.template.json","docs/executable-package-template.md","docs/local-runtime-home.md","scripts/ci/executable_package_template_smoke.sh"],"invocable_entrypoints":["describe_content_group"],"summary":"Traverse-neutral executable capability package template and local runtime shape.","validation_commands":["bash scripts/ci/executable_package_template_smoke.sh"]}],"entrypoints":{"capabilities":[{"artifact_kind":"capability","id":"expedition.planning.capture-expedition-objective","lifecycle":"active","summary":"Capture a structured expedition objective from destination, timing, and planning preference inputs.","version":"1.0.0"},{"artifact_kind":"capability","id":"expedition.planning.interpret-expedition-intent","lifecycle":"active","summary":"Interpret free-form expedition planning intent into structured route preferences, constraints, and assumptions.","version":"1.0.0"},{"artifact_kind":"capability","id":"expedition.planning.assess-conditions-summary","lifecycle":"active","summary":"Assess a deterministic expedition conditions summary from objective and interpreted intent context.","version":"1.0.0"},{"artifact_kind":"capability","id":"expedition.planning.validate-team-readiness","lifecycle":"active","summary":"Validate expedition team readiness from objective, conditions summary, and team profile context.","version":"1.0.0"},{"artifact_kind":"capability","id":"expedition.planning.assemble-expedition-plan","lifecycle":"active","summary":"Assemble the final expedition plan from objective, interpreted intent, conditions, and readiness inputs.","version":"1.0.0"},{"artifact_kind":"capability","id":"expedition.planning.plan-expedition","lifecycle":"active","summary":"Compose the canonical expedition planning workflow into one first-class governed capability.","version":"1.0.0"}],"events":[{"artifact_kind":"event","id":"expedition.planning.expedition-objective-captured","lifecycle":"active","summary":"A normalized expedition objective has been captured and is ready for downstream planning.","version":"1.0.0"},{"artifact_kind":"event","id":"expedition.planning.expedition-intent-interpreted","lifecycle":"active","summary":"An expedition intent has been interpreted into structured planning inputs for downstream steps.","version":"1.0.0"},{"artifact_kind":"event","id":"expedition.planning.conditions-summary-assessed","lifecycle":"active","summary":"A deterministic expedition conditions summary has been assessed for the current planning context.","version":"1.0.0"},{"artifact_kind":"event","id":"expedition.planning.team-readiness-validated","lifecycle":"active","summary":"A team readiness result has been validated for the expedition objective and conditions context.","version":"1.0.0"},{"artifact_kind":"event","id":"expedition.planning.expedition-plan-assembled","lifecycle":"active","summary":"A final expedition plan has been assembled and is ready for downstream consumption.","version":"1.0.0"}],"workflows":[{"artifact_kind":"workflow","id":"expedition.planning.plan-expedition","lifecycle":"active","summary":"Capture, interpret, validate, and assemble an expedition plan deterministically.","version":"1.0.0"}]},"governing_spec":"022-mcp-wasm-server","host_mode":"stdio","kind":"mcp_stdio_server_entrypoint_list","server_name":"traverse-mcp"}
+{"content_groups":[{"content_group_id":"core-runtime-example","display_name":"Core runtime example","governed_paths":["examples/templates/executable-capability-package/manifest.template.json","docs/executable-package-template.md","docs/local-runtime-home.md","scripts/ci/executable_package_template_smoke.sh"],"invocable_entrypoints":["describe_content_group"],"summary":"Traverse-neutral executable capability package template and local runtime shape.","validation_commands":["bash scripts/ci/executable_package_template_smoke.sh"]}],"governing_spec":"022-mcp-wasm-server","host_mode":"stdio","kind":"mcp_stdio_server_content_group_list","server_name":"traverse-mcp"}
+{"governing_spec":"022-mcp-wasm-server","host_mode":"stdio","kind":"mcp_stdio_server_shutdown","reason":"shutdown_command","server_name":"traverse-mcp","status":"complete"}

docs/llm-reference-apps-plan.md

@@ -86,8 +86,8 @@ v1 documents **Mode A** only. Do not revive HTTP `traverse-cli serve` as the pro
 | Ticket ID | Intent | Status intent |
 |---|---|---|
 | `llm-mcp-reference-apps-plan` | Plan + scaffold (this doc + tree) | Done (#238) |
-| `llm-mcp-claude-live-smoke` | Live Claude Desktop/Code path against `traverse-starter` | Ready |
-| `llm-mcp-cursor-live-smoke` | Live Cursor MCP path | In Progress |
+| `llm-mcp-claude-live-smoke` | Live Claude Desktop/Code path against `traverse-starter` | In Progress |
+| `llm-mcp-cursor-live-smoke` | Live Cursor MCP path | Done (#240) |
 | `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 |

scripts/ci/llm_mcp_reference_smoke.sh

@@ -18,8 +18,14 @@ need apps/llm-mcp-reference/shared/workflows/traverse-starter.md
 need apps/llm-mcp-reference/shared/workflows/meeting-notes.md
 need apps/llm-mcp-reference/clients/claude-desktop/README.md
 need apps/llm-mcp-reference/clients/claude-desktop/mcp.json.example
+need apps/llm-mcp-reference/clients/claude-desktop/evidence/README.md
+need apps/llm-mcp-reference/clients/claude-desktop/evidence/claude-desktop-mcp-stdio-transcript.jsonl
+need apps/llm-mcp-reference/clients/claude-desktop/evidence/claude-desktop-mcp-execute-transcript.jsonl
 need apps/llm-mcp-reference/clients/claude-code/README.md
 need apps/llm-mcp-reference/clients/claude-code/.mcp.json.example
+need apps/llm-mcp-reference/clients/claude-code/evidence/README.md
+need apps/llm-mcp-reference/clients/claude-code/evidence/claude-code-mcp-stdio-transcript.jsonl
+need apps/llm-mcp-reference/clients/claude-code/evidence/claude-code-mcp-execute-transcript.jsonl
 need apps/llm-mcp-reference/clients/cursor/README.md
 need apps/llm-mcp-reference/clients/cursor/mcp.json.example
 need apps/llm-mcp-reference/clients/cursor/evidence/README.md