chore(compass): check in the Compass code graph and wire its MCP server

[GQAdonis]

Checks in a Compass code graph of this repository and configures its MCP server, so coding agents can navigate the code from the graph instead of reading broadly.

What's included

• .compass/config.toml: Compass 0.3.28 project scope, using the JSON store (no SQLite sidecar). Excluded from the graph: .prometheus/ (session records), the agent and tool folders (.agents, .codex, .dsh, .kimi-code, .opencode), .agent-team/ and .kbd-orchestrator/.
• compass-out/graph.json: 2,613 nodes, 4,216 edges and 58 communities over 74 files (45 code, the rest docs and OpenSpec). It's about 5.8 MB of minified JSON on a single line.
• compass-out/GRAPH_REPORT.md: architecture summary with hubs and communities, and an agent orientation section.
• MCP server: compass serve --transport stdio, which serves compass-out/graph.json. The configs were rendered by compass agent mcp-config for each harness:
  • Claude Code: .mcp.json
  • Codex: .codex/config.toml
  • OpenCode: opencode.json
• .gitignore: ignores the rest of compass-out/ (snapshots, cache, the HTML view and run state), which Compass treats as local to each worktree.

Checked

• Fresh clone: with only graph.json in an otherwise empty folder, compass serve starts (Compass 0.3.28) and lists 18 MCP tools, including search_symbols, get_callers, get_callees, get_impact, query_graph, shortest_path, get_community and task_context.
• Accuracy: compass query "how does the store rebuild index.md" lands on the pk ingest rewrites wiki/index.md destructively (drops frontmatter and existing sections) #15 fix (MarkdownStore::rebuild_index_locked, render_index_preserving, write_atomic) with file and line locations.
• Sensitive content: the graph has no secret-like strings. It contains three absolute paths, each copied from text already in the repo (CLAUDE.md and an OpenSpec tasks.md).

Things to know

• Staleness: the committed graph is a snapshot. Run compass update . or compass ensure after code changes; they rewrite graph.json, so it shows up as modified until the refresh is committed.
• Unsupported harnesses: compass agent mcp-config supports only Claude Code, Codex and OpenCode, so Kimi Code, MiniMax and DeepSeek Harness get no config here. They can run the same command if they support stdio MCP.
• Approval: Claude Code asks once before enabling a project .mcp.json server.
• Requirement: every client needs compass on its PATH.

These are configuration and generated files only; there are no code changes.

🤖 Generated with Claude Code