diff --git a/apps/llm-mcp-reference/clients/cursor/README.md b/apps/llm-mcp-reference/clients/cursor/README.md index 51793b6..d0ee987 100644 --- a/apps/llm-mcp-reference/clients/cursor/README.md +++ b/apps/llm-mcp-reference/clients/cursor/README.md @@ -2,11 +2,17 @@ ## Setup -1. Traverse checkout with working `traverse-mcp`. -2. Copy [`mcp.json.example`](mcp.json.example) into Cursor MCP settings (or project `.cursor`/MCP config as applicable). -3. Fix absolute paths. +1. Traverse checkout with working `traverse-mcp` (tested with **v0.8.2+**). +2. Copy [`mcp.json.example`](mcp.json.example) into Cursor MCP settings (Cursor Settings → MCP, or project MCP config as applicable). +3. Replace `/ABS/PATH/TO/Traverse` with your **absolute** Traverse checkout in both `cwd` and `env.TRAVERSE_REPO`. 4. Apply [`../../shared/prompts/system-boundary.md`](../../shared/prompts/system-boundary.md) in rules/instructions. -5. Exercise [`../../shared/workflows/traverse-starter.md`](../../shared/workflows/traverse-starter.md). -6. For meeting transcripts, follow [`../../shared/workflows/meeting-notes.md`](../../shared/workflows/meeting-notes.md) (tool sequence + sample transcript). +5. Exercise [`../../shared/workflows/traverse-starter.md`](../../shared/workflows/traverse-starter.md) when starter entrypoints are available in the MCP catalog; until then use discovery (`list_entrypoints`) and only render runtime fields. +6. For meeting transcripts, follow [`../../shared/workflows/meeting-notes.md`](../../shared/workflows/meeting-notes.md) (tool sequence + sample transcript) once `meeting-notes.process` is catalogued. + +## Live evidence + +See [`evidence/`](evidence/) — Cursor cloud agent ran the **same** `cargo run -p traverse-mcp -- stdio` command as `mcp.json.example` and captured discovery + execute/render transcripts (`llm-mcp-cursor-live-smoke`). + +## Boundary Cursor agents working **in this repo** still claim OS tickets via `AGENTS.md`; this façade is for **product** workflows through Traverse MCP, not for replacing Project 2 claim locks. diff --git a/apps/llm-mcp-reference/clients/cursor/evidence/README.md b/apps/llm-mcp-reference/clients/cursor/evidence/README.md new file mode 100644 index 0000000..c351a10 --- /dev/null +++ b/apps/llm-mcp-reference/clients/cursor/evidence/README.md @@ -0,0 +1,56 @@ +# Cursor MCP live evidence (`llm-mcp-cursor-live-smoke`) + +Captured **2026-07-29** against Traverse **v0.8.2** (`TRAVERSE_REPO=/tmp/Traverse`). + +## What was proven + +The Cursor façade config in [`../mcp.json.example`](../mcp.json.example) launches: + +```bash +cargo run -p traverse-mcp -- stdio +``` + +with `cwd` / `TRAVERSE_REPO` pointing at a Traverse checkout. That exact command was exercised here (stdio JSONL envelopes, local_trust Mode A). + +### Transcript A — discovery + +File: [`cursor-mcp-stdio-transcript.jsonl`](cursor-mcp-stdio-transcript.jsonl) + +Commands: `describe_server` → `list_entrypoints` → `list_content_groups` → `shutdown` + +Observed kinds: `mcp_stdio_server_startup` (ready), `mcp_stdio_server_description`, `mcp_stdio_server_entrypoint_list`, `mcp_stdio_server_content_group_list`, `mcp_stdio_server_shutdown`. + +### transcript B — validate / execute / render + +File: [`cursor-mcp-execute-transcript.jsonl`](cursor-mcp-execute-transcript.jsonl) + +Commands follow the upstream `mcp_stdio_server_execution_report_smoke.sh` path against the **current** MCP catalog workflow `expedition.planning.plan-expedition` (request_path `examples/expedition/runtime-requests/plan-expedition.json`). + +Observed: validation `valid` → execution `completed` → report `rendered` → shutdown `complete`. stderr empty. + +## Runtime fields only + +Execution/report envelopes come from Traverse MCP — this façade does **not** invent structured business fields. Agents must present only fields returned by `render_execution_report` / execution envelopes. + +## Catalog note (honest) + +As of Traverse v0.8.2, `traverse-mcp stdio`’s default governed catalog is the **expedition** registry bundle (plus `core-runtime-example` content group). **`traverse-starter.*` / `meeting-notes.process` entrypoints are not listed yet** in that default catalog. + +Implication for App-Refs: + +- Cursor MCP config is correct for Mode A (stdio → `traverse-mcp`). +- Live product smoke against starter/meeting-notes **IDs** lands when those capabilities are published into the MCP catalog (or a documented catalog override ships upstream). Until then, this evidence proves the Cursor→MCP host path end-to-end on the catalog the server actually serves. + +## Reproduce + +```bash +export TRAVERSE_REPO=/absolute/path/to/Traverse +cd "$TRAVERSE_REPO" +printf '%s\n' \ + '{"command":"describe_server"}' \ + '{"command":"list_entrypoints"}' \ + '{"command":"shutdown"}' \ + | cargo run -q -p traverse-mcp -- stdio +``` + +Optional full execute path: see Traverse `scripts/ci/mcp_stdio_server_execution_report_smoke.sh`. diff --git a/apps/llm-mcp-reference/clients/cursor/evidence/cursor-mcp-execute-transcript.jsonl b/apps/llm-mcp-reference/clients/cursor/evidence/cursor-mcp-execute-transcript.jsonl new file mode 100644 index 0000000..130fa81 --- /dev/null +++ b/apps/llm-mcp-reference/clients/cursor/evidence/cursor-mcp-execute-transcript.jsonl @@ -0,0 +1,8 @@ +{"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"} +{"entrypoint":{"artifact_kind":"workflow","artifact_path":"/tmp/Traverse/crates/traverse-mcp/../../examples/expedition/registry-bundle/../../../workflows/examples/expedition/plan-expedition/workflow.json","id":"expedition.planning.plan-expedition","lifecycle":"active","owner_team":"traverse-core","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_description","server_name":"traverse-mcp"} +{"entrypoint":{"entrypoint":{"artifact_kind":"workflow","artifact_path":"/tmp/Traverse/crates/traverse-mcp/../../examples/expedition/registry-bundle/../../../workflows/examples/expedition/plan-expedition/workflow.json","id":"expedition.planning.plan-expedition","lifecycle":"active","owner_team":"traverse-core","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_description","server_name":"traverse-mcp"},"governing_spec":"022-mcp-wasm-server","host_mode":"stdio","kind":"mcp_stdio_server_entrypoint_validation","request":{"caller":"expedition-demo-cli","correlation_id":"expedition-demo-correlation-001","governing_spec":"006-runtime-request-execution","intent":{"capability_id":"expedition.planning.plan-expedition","capability_version":"1.0.0","intent_key":null},"kind":"runtime_request","lookup":{"allow_ambiguity":false,"scope":"prefer_private"},"request_id":"expedition-plan-request-001","requested_target":"local","schema_version":"1.0.0"},"request_path":"examples/expedition/runtime-requests/plan-expedition.json","server_name":"traverse-mcp","status":"valid"} +{"entrypoint":{"entrypoint":{"artifact_kind":"workflow","artifact_path":"/tmp/Traverse/crates/traverse-mcp/../../examples/expedition/registry-bundle/../../../workflows/examples/expedition/plan-expedition/workflow.json","id":"expedition.planning.plan-expedition","lifecycle":"active","owner_team":"traverse-core","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_description","server_name":"traverse-mcp"},"execution_id":"exec_expedition-plan-request-001","governing_spec":"022-mcp-wasm-server","host_mode":"stdio","kind":"mcp_stdio_server_entrypoint_execution","observation_messages":[{"execution_id":"exec_expedition-plan-request-001","kind":"lifecycle","request_id":"expedition-plan-request-001","sequence":0,"status":"stream_started"},{"kind":"state","sequence":1,"state_event":{"details":{"identity":null,"registry_status":"available","transition_reason":"runtime_initialization_started"},"entered_at":"1970-01-01T00:00:00Z","event_id":"rse_exec_expedition-plan-request-001_0000","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"loading_registry"}},{"kind":"state","sequence":2,"state_event":{"details":{"governing_spec":"006-runtime-request-execution","transition_reason":"registry_loaded"},"entered_at":"1970-01-01T00:00:01Z","event_id":"rse_exec_expedition-plan-request-001_0001","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"ready"}},{"kind":"state","sequence":3,"state_event":{"details":{"identity":null,"lookup_scope":"prefer_private","transition_reason":"request_started"},"entered_at":"1970-01-01T00:00:02Z","event_id":"rse_exec_expedition-plan-request-001_0002","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"discovering"}},{"kind":"state","sequence":4,"state_event":{"details":{"candidate_count":1,"transition_reason":"candidates_collected"},"entered_at":"1970-01-01T00:00:03Z","event_id":"rse_exec_expedition-plan-request-001_0003","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"evaluating_constraints"}},{"kind":"state","sequence":5,"state_event":{"details":{"eligible_candidates":1,"rejected_candidates":0,"transition_reason":"constraints_evaluated"},"entered_at":"1970-01-01T00:00:04Z","event_id":"rse_exec_expedition-plan-request-001_0004","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"selecting"}},{"kind":"state","sequence":6,"state_event":{"details":{"artifact_ref":"bundle:expedition.planning.seed-bundle:expedition.planning.plan-expedition:1.0.0","capability_id":"expedition.planning.plan-expedition","capability_version":"1.0.0","identity":null,"placement_reason":"requested_target_selected","placement_status":"selected","requested_target":"local","selected_target":"local","transition_reason":"candidate_selected"},"entered_at":"1970-01-01T00:00:06Z","event_id":"rse_exec_expedition-plan-request-001_0005","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"executing"}},{"kind":"state","sequence":7,"state_event":{"details":{"capability_id":"expedition.planning.plan-expedition","capability_version":"1.0.0","declared_event_count":1,"transition_reason":"execution_succeeded_with_events"},"entered_at":"1970-01-01T00:00:08Z","event_id":"rse_exec_expedition-plan-request-001_0006","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"emitting_events"}},{"kind":"state","sequence":8,"state_event":{"details":{"capability_id":"expedition.planning.plan-expedition","capability_version":"1.0.0","transition_reason":"events_emitted"},"entered_at":"1970-01-01T00:00:09Z","event_id":"rse_exec_expedition-plan-request-001_0007","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"completed"}},{"kind":"state","sequence":9,"state_event":{"details":{"terminal_state":"completed","transition_reason":"execution_closed"},"entered_at":"1970-01-01T00:00:10Z","event_id":"rse_exec_expedition-plan-request-001_0008","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"ready"}},{"kind":"trace","model_resolution_count":0,"sequence":10,"trace":{"emitted_event_count":5,"execution_id":"exec_expedition-plan-request-001","governing_spec":"006-runtime-request-execution","kind":"runtime_trace","model_resolution_count":0,"private_fields_omitted":["request","decision_evidence","state_progression","candidate_collection","selection","execution","result","otel_trace"],"request_id":"expedition-plan-request-001","runtime_status":"completed","schema_version":"1.0.0","selected_capability_id":"expedition.planning.plan-expedition","state_transition_count":9,"trace_id":"trace_exec_expedition-plan-request-001"},"trace_redacted":true},{"kind":"terminal","result":{"error":null,"execution_id":"exec_expedition-plan-request-001","kind":"runtime_result","output":{"conditions_summary":{"blocking_concerns":[],"conditions_summary_id":"conditions-objective-sky-pilot","key_findings":["stable morning window for Sky Pilot","preferred style: conservative-alpine-push"],"objective_id":"objective-sky-pilot","overall_rating":"watchful"},"constraints":["priority:same-day-return"],"destination":"Sky Pilot","interpreted_intent":{"assumptions":["Plan a same-day alpine push with a conservative turnaround point and clear readiness actions."],"confidence":0.87,"constraints":["priority:same-day-return"],"intent_id":"intent-objective-sky-pilot","objective_id":"objective-sky-pilot","route_preferences":["conservative-alpine-push","same-day-return"]},"key_steps":["depart before sunrise","reassess winds at mid-route checkpoint","apply conservative turnaround time"],"notes":"Prefer an early start and a conservative turnaround decision if winds build.","objective":{"destination":"Sky Pilot","notes":"Prefer an early start and a conservative turnaround decision if winds build.","objective_id":"objective-sky-pilot","preferences":{"priority":"same-day-return","risk_tolerance":"moderate","style":"conservative-alpine-push"},"target_window":{"end":"2026-07-20T16:00:00Z","start":"2026-07-20T04:30:00Z"}},"objective_id":"objective-sky-pilot","plan_id":"plan-objective-sky-pilot","planning_intent":"Plan a same-day alpine push with a conservative turnaround point and clear readiness actions.","preferences":{"priority":"same-day-return","risk_tolerance":"moderate","style":"conservative-alpine-push"},"readiness_notes":["team profile satisfies baseline expedition requirements"],"readiness_result":{"objective_id":"objective-sky-pilot","readiness_result_id":"readiness-objective-sky-pilot","reasons":["team profile satisfies baseline expedition requirements"],"required_actions":[],"status":"ready"},"recommended_route_style":"conservative-alpine-push","status":"ready","summary":"Proceed with a conservative same-day ascent plan under a limited morning weather window.","target_window":{"end":"2026-07-20T16:00:00Z","start":"2026-07-20T04:30:00Z"},"team_profile":{"equipment_ready":true,"experience_level":"advanced","member_count":3,"team_id":"team-alpine-01"}},"request_id":"expedition-plan-request-001","schema_version":"1.0.0","status":"completed","trace_ref":"trace_exec_expedition-plan-request-001","warnings":[{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"}]},"sequence":11},{"execution_id":"exec_expedition-plan-request-001","kind":"lifecycle","request_id":"expedition-plan-request-001","sequence":12,"status":"stream_completed"}],"request_id":"expedition-plan-request-001","request_path":"examples/expedition/runtime-requests/plan-expedition.json","result":{"error":null,"execution_id":"exec_expedition-plan-request-001","kind":"runtime_result","output":{"conditions_summary":{"blocking_concerns":[],"conditions_summary_id":"conditions-objective-sky-pilot","key_findings":["stable morning window for Sky Pilot","preferred style: conservative-alpine-push"],"objective_id":"objective-sky-pilot","overall_rating":"watchful"},"constraints":["priority:same-day-return"],"destination":"Sky Pilot","interpreted_intent":{"assumptions":["Plan a same-day alpine push with a conservative turnaround point and clear readiness actions."],"confidence":0.87,"constraints":["priority:same-day-return"],"intent_id":"intent-objective-sky-pilot","objective_id":"objective-sky-pilot","route_preferences":["conservative-alpine-push","same-day-return"]},"key_steps":["depart before sunrise","reassess winds at mid-route checkpoint","apply conservative turnaround time"],"notes":"Prefer an early start and a conservative turnaround decision if winds build.","objective":{"destination":"Sky Pilot","notes":"Prefer an early start and a conservative turnaround decision if winds build.","objective_id":"objective-sky-pilot","preferences":{"priority":"same-day-return","risk_tolerance":"moderate","style":"conservative-alpine-push"},"target_window":{"end":"2026-07-20T16:00:00Z","start":"2026-07-20T04:30:00Z"}},"objective_id":"objective-sky-pilot","plan_id":"plan-objective-sky-pilot","planning_intent":"Plan a same-day alpine push with a conservative turnaround point and clear readiness actions.","preferences":{"priority":"same-day-return","risk_tolerance":"moderate","style":"conservative-alpine-push"},"readiness_notes":["team profile satisfies baseline expedition requirements"],"readiness_result":{"objective_id":"objective-sky-pilot","readiness_result_id":"readiness-objective-sky-pilot","reasons":["team profile satisfies baseline expedition requirements"],"required_actions":[],"status":"ready"},"recommended_route_style":"conservative-alpine-push","status":"ready","summary":"Proceed with a conservative same-day ascent plan under a limited morning weather window.","target_window":{"end":"2026-07-20T16:00:00Z","start":"2026-07-20T04:30:00Z"},"team_profile":{"equipment_ready":true,"experience_level":"advanced","member_count":3,"team_id":"team-alpine-01"}},"request_id":"expedition-plan-request-001","schema_version":"1.0.0","status":"completed","trace_ref":"trace_exec_expedition-plan-request-001","warnings":[{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"}]},"server_name":"traverse-mcp","status":"completed","trace":{"emitted_event_count":5,"execution_id":"exec_expedition-plan-request-001","governing_spec":"006-runtime-request-execution","kind":"runtime_trace","model_resolution_count":0,"private_fields_omitted":["request","decision_evidence","state_progression","candidate_collection","selection","execution","result","otel_trace"],"request_id":"expedition-plan-request-001","runtime_status":"completed","schema_version":"1.0.0","selected_capability_id":"expedition.planning.plan-expedition","state_transition_count":9,"trace_id":"trace_exec_expedition-plan-request-001"},"trace_redaction":{"auth_mode":"local_trust","enabled":true,"reason":"MCP stdio responses omit full runtime traces by default.","tier":"public_summary"}} +{"entrypoint":{"entrypoint":{"artifact_kind":"workflow","artifact_path":"/tmp/Traverse/crates/traverse-mcp/../../examples/expedition/registry-bundle/../../../workflows/examples/expedition/plan-expedition/workflow.json","id":"expedition.planning.plan-expedition","lifecycle":"active","owner_team":"traverse-core","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_description","server_name":"traverse-mcp"},"execution":{"execution_id":"exec_expedition-plan-request-001","observation_messages":[{"execution_id":"exec_expedition-plan-request-001","kind":"lifecycle","request_id":"expedition-plan-request-001","sequence":0,"status":"stream_started"},{"kind":"state","sequence":1,"state_event":{"details":{"identity":null,"registry_status":"available","transition_reason":"runtime_initialization_started"},"entered_at":"1970-01-01T00:00:00Z","event_id":"rse_exec_expedition-plan-request-001_0000","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"loading_registry"}},{"kind":"state","sequence":2,"state_event":{"details":{"governing_spec":"006-runtime-request-execution","transition_reason":"registry_loaded"},"entered_at":"1970-01-01T00:00:01Z","event_id":"rse_exec_expedition-plan-request-001_0001","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"ready"}},{"kind":"state","sequence":3,"state_event":{"details":{"identity":null,"lookup_scope":"prefer_private","transition_reason":"request_started"},"entered_at":"1970-01-01T00:00:02Z","event_id":"rse_exec_expedition-plan-request-001_0002","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"discovering"}},{"kind":"state","sequence":4,"state_event":{"details":{"candidate_count":1,"transition_reason":"candidates_collected"},"entered_at":"1970-01-01T00:00:03Z","event_id":"rse_exec_expedition-plan-request-001_0003","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"evaluating_constraints"}},{"kind":"state","sequence":5,"state_event":{"details":{"eligible_candidates":1,"rejected_candidates":0,"transition_reason":"constraints_evaluated"},"entered_at":"1970-01-01T00:00:04Z","event_id":"rse_exec_expedition-plan-request-001_0004","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"selecting"}},{"kind":"state","sequence":6,"state_event":{"details":{"artifact_ref":"bundle:expedition.planning.seed-bundle:expedition.planning.plan-expedition:1.0.0","capability_id":"expedition.planning.plan-expedition","capability_version":"1.0.0","identity":null,"placement_reason":"requested_target_selected","placement_status":"selected","requested_target":"local","selected_target":"local","transition_reason":"candidate_selected"},"entered_at":"1970-01-01T00:00:06Z","event_id":"rse_exec_expedition-plan-request-001_0005","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"executing"}},{"kind":"state","sequence":7,"state_event":{"details":{"capability_id":"expedition.planning.plan-expedition","capability_version":"1.0.0","declared_event_count":1,"transition_reason":"execution_succeeded_with_events"},"entered_at":"1970-01-01T00:00:08Z","event_id":"rse_exec_expedition-plan-request-001_0006","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"emitting_events"}},{"kind":"state","sequence":8,"state_event":{"details":{"capability_id":"expedition.planning.plan-expedition","capability_version":"1.0.0","transition_reason":"events_emitted"},"entered_at":"1970-01-01T00:00:09Z","event_id":"rse_exec_expedition-plan-request-001_0007","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"completed"}},{"kind":"state","sequence":9,"state_event":{"details":{"terminal_state":"completed","transition_reason":"execution_closed"},"entered_at":"1970-01-01T00:00:10Z","event_id":"rse_exec_expedition-plan-request-001_0008","execution_id":"exec_expedition-plan-request-001","kind":"runtime_state_event","request_id":"expedition-plan-request-001","schema_version":"1.0.0","state":"ready"}},{"kind":"trace","model_resolution_count":0,"sequence":10,"trace":{"emitted_event_count":5,"execution_id":"exec_expedition-plan-request-001","governing_spec":"006-runtime-request-execution","kind":"runtime_trace","model_resolution_count":0,"private_fields_omitted":["request","decision_evidence","state_progression","candidate_collection","selection","execution","result","otel_trace"],"request_id":"expedition-plan-request-001","runtime_status":"completed","schema_version":"1.0.0","selected_capability_id":"expedition.planning.plan-expedition","state_transition_count":9,"trace_id":"trace_exec_expedition-plan-request-001"},"trace_redacted":true},{"kind":"terminal","result":{"error":null,"execution_id":"exec_expedition-plan-request-001","kind":"runtime_result","output":{"conditions_summary":{"blocking_concerns":[],"conditions_summary_id":"conditions-objective-sky-pilot","key_findings":["stable morning window for Sky Pilot","preferred style: conservative-alpine-push"],"objective_id":"objective-sky-pilot","overall_rating":"watchful"},"constraints":["priority:same-day-return"],"destination":"Sky Pilot","interpreted_intent":{"assumptions":["Plan a same-day alpine push with a conservative turnaround point and clear readiness actions."],"confidence":0.87,"constraints":["priority:same-day-return"],"intent_id":"intent-objective-sky-pilot","objective_id":"objective-sky-pilot","route_preferences":["conservative-alpine-push","same-day-return"]},"key_steps":["depart before sunrise","reassess winds at mid-route checkpoint","apply conservative turnaround time"],"notes":"Prefer an early start and a conservative turnaround decision if winds build.","objective":{"destination":"Sky Pilot","notes":"Prefer an early start and a conservative turnaround decision if winds build.","objective_id":"objective-sky-pilot","preferences":{"priority":"same-day-return","risk_tolerance":"moderate","style":"conservative-alpine-push"},"target_window":{"end":"2026-07-20T16:00:00Z","start":"2026-07-20T04:30:00Z"}},"objective_id":"objective-sky-pilot","plan_id":"plan-objective-sky-pilot","planning_intent":"Plan a same-day alpine push with a conservative turnaround point and clear readiness actions.","preferences":{"priority":"same-day-return","risk_tolerance":"moderate","style":"conservative-alpine-push"},"readiness_notes":["team profile satisfies baseline expedition requirements"],"readiness_result":{"objective_id":"objective-sky-pilot","readiness_result_id":"readiness-objective-sky-pilot","reasons":["team profile satisfies baseline expedition requirements"],"required_actions":[],"status":"ready"},"recommended_route_style":"conservative-alpine-push","status":"ready","summary":"Proceed with a conservative same-day ascent plan under a limited morning weather window.","target_window":{"end":"2026-07-20T16:00:00Z","start":"2026-07-20T04:30:00Z"},"team_profile":{"equipment_ready":true,"experience_level":"advanced","member_count":3,"team_id":"team-alpine-01"}},"request_id":"expedition-plan-request-001","schema_version":"1.0.0","status":"completed","trace_ref":"trace_exec_expedition-plan-request-001","warnings":[{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"}]},"sequence":11},{"execution_id":"exec_expedition-plan-request-001","kind":"lifecycle","request_id":"expedition-plan-request-001","sequence":12,"status":"stream_completed"}],"request_id":"expedition-plan-request-001","result":{"error":null,"execution_id":"exec_expedition-plan-request-001","kind":"runtime_result","output":{"conditions_summary":{"blocking_concerns":[],"conditions_summary_id":"conditions-objective-sky-pilot","key_findings":["stable morning window for Sky Pilot","preferred style: conservative-alpine-push"],"objective_id":"objective-sky-pilot","overall_rating":"watchful"},"constraints":["priority:same-day-return"],"destination":"Sky Pilot","interpreted_intent":{"assumptions":["Plan a same-day alpine push with a conservative turnaround point and clear readiness actions."],"confidence":0.87,"constraints":["priority:same-day-return"],"intent_id":"intent-objective-sky-pilot","objective_id":"objective-sky-pilot","route_preferences":["conservative-alpine-push","same-day-return"]},"key_steps":["depart before sunrise","reassess winds at mid-route checkpoint","apply conservative turnaround time"],"notes":"Prefer an early start and a conservative turnaround decision if winds build.","objective":{"destination":"Sky Pilot","notes":"Prefer an early start and a conservative turnaround decision if winds build.","objective_id":"objective-sky-pilot","preferences":{"priority":"same-day-return","risk_tolerance":"moderate","style":"conservative-alpine-push"},"target_window":{"end":"2026-07-20T16:00:00Z","start":"2026-07-20T04:30:00Z"}},"objective_id":"objective-sky-pilot","plan_id":"plan-objective-sky-pilot","planning_intent":"Plan a same-day alpine push with a conservative turnaround point and clear readiness actions.","preferences":{"priority":"same-day-return","risk_tolerance":"moderate","style":"conservative-alpine-push"},"readiness_notes":["team profile satisfies baseline expedition requirements"],"readiness_result":{"objective_id":"objective-sky-pilot","readiness_result_id":"readiness-objective-sky-pilot","reasons":["team profile satisfies baseline expedition requirements"],"required_actions":[],"status":"ready"},"recommended_route_style":"conservative-alpine-push","status":"ready","summary":"Proceed with a conservative same-day ascent plan under a limited morning weather window.","target_window":{"end":"2026-07-20T16:00:00Z","start":"2026-07-20T04:30:00Z"},"team_profile":{"equipment_ready":true,"experience_level":"advanced","member_count":3,"team_id":"team-alpine-01"}},"request_id":"expedition-plan-request-001","schema_version":"1.0.0","status":"completed","trace_ref":"trace_exec_expedition-plan-request-001","warnings":[{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"},{"code":"unsigned_local_dev_artifact","message":"unsigned local/dev artifact allowed by development security mode"}]},"trace":{"emitted_event_count":5,"execution_id":"exec_expedition-plan-request-001","governing_spec":"006-runtime-request-execution","kind":"runtime_trace","model_resolution_count":0,"private_fields_omitted":["request","decision_evidence","state_progression","candidate_collection","selection","execution","result","otel_trace"],"request_id":"expedition-plan-request-001","runtime_status":"completed","schema_version":"1.0.0","selected_capability_id":"expedition.planning.plan-expedition","state_transition_count":9,"trace_id":"trace_exec_expedition-plan-request-001"},"trace_redaction":{"auth_mode":"local_trust","enabled":true,"reason":"MCP stdio responses omit full runtime traces by default.","tier":"public_summary"}},"governing_spec":"022-mcp-wasm-server","host_mode":"stdio","kind":"mcp_stdio_server_execution_report","report":{"execution_id":"exec_expedition-plan-request-001","observation_message_count":13,"request_id":"expedition-plan-request-001","result_status":"completed","summary":"Rendered execution report from governed runtime output","trace_kind":"runtime_trace","trace_redacted":true},"request_path":"examples/expedition/runtime-requests/plan-expedition.json","server_name":"traverse-mcp","status":"rendered"} +{"governing_spec":"022-mcp-wasm-server","host_mode":"stdio","kind":"mcp_stdio_server_shutdown","reason":"shutdown_command","server_name":"traverse-mcp","status":"complete"} diff --git a/apps/llm-mcp-reference/clients/cursor/evidence/cursor-mcp-stdio-transcript.jsonl b/apps/llm-mcp-reference/clients/cursor/evidence/cursor-mcp-stdio-transcript.jsonl new file mode 100644 index 0000000..3880544 --- /dev/null +++ b/apps/llm-mcp-reference/clients/cursor/evidence/cursor-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"} diff --git a/docs/llm-reference-apps-plan.md b/docs/llm-reference-apps-plan.md index 16c56fa..a4a95bf 100644 --- a/docs/llm-reference-apps-plan.md +++ b/docs/llm-reference-apps-plan.md @@ -87,8 +87,8 @@ v1 documents **Mode A** only. Do not revive HTTP `traverse-cli serve` as the pro |---|---|---| | `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 | Ready | -| `llm-mcp-meeting-notes-workflow` | Document + config for meeting-notes via MCP | In Progress | +| `llm-mcp-cursor-live-smoke` | Live Cursor MCP path | In Progress | +| `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-embedded-host` | Mode B embedded prepare/cache for MCP host | Blocked on Traverse Spec 520 implement | diff --git a/scripts/ci/llm_mcp_reference_smoke.sh b/scripts/ci/llm_mcp_reference_smoke.sh index 0f19935..30527ad 100755 --- a/scripts/ci/llm_mcp_reference_smoke.sh +++ b/scripts/ci/llm_mcp_reference_smoke.sh @@ -22,6 +22,9 @@ 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/cursor/README.md need apps/llm-mcp-reference/clients/cursor/mcp.json.example +need apps/llm-mcp-reference/clients/cursor/evidence/README.md +need apps/llm-mcp-reference/clients/cursor/evidence/cursor-mcp-stdio-transcript.jsonl +need apps/llm-mcp-reference/clients/cursor/evidence/cursor-mcp-execute-transcript.jsonl need apps/llm-mcp-reference/clients/chatgpt/README.md need apps/llm-mcp-reference/clients/grok/README.md # Configs must mention traverse-mcp, not invent business fields