docs: weekly documentation sync (2026-05-24 — 2026-05-31)

[cursor]

Docs added/updated

File	Action	Summary
CHANGELOG.md	Updated	Weekly block under [Unreleased] (doc alignment, .claude/ untrack, macOS CI)
README.md	Updated	Fact fixes: 10 MCP tools, graph ranking/budget wording, 312 tests
docs/graph/README.md	Updated	Honest ranking (heuristic, not BM25+PPR), linear budget, index behavior, node example
docs/guides/agent-integration.md	Updated	10 MCP tools, Claude Desktop paths per OS, restart table Code vs Desktop
docs/competitors/codegraph.md	Updated	Graph ranking/budget, 8 languages, framework routing partial, 2 installers

Which codepaths they cover

• src/pipelines/graph/query.rs — score_node, apply_budget (ranking + token limit)
• src/pipelines/graph/mod.rs, store.rs — per-file idempotent re-index
• src/integrations/mcp/server.rs — 10 #[tool] handlers
• src/integrations/agents/claude_desktop.rs — config path resolution
• tests/agent_install.rs — Linux-only desktop_* integration tests
• .gitignore — .claude entry (untrack commit d7e8591)

Key knowledge gaps addressed

• Docs incorrectly claimed BM25 + PageRank and binary search for ctx graph queries; aligned with actual heuristic scoring and linear budget truncation.
• MCP tool count still said 4 in README while server exposes 10 since v0.1.0 graph tools.
• Claude Desktop install/runbook lacked per-OS config paths and differed restart steps from Claude Code.
• Competitor matrix (codegraph.md) still marked framework routing and installer count as missing despite v0.2.0 delivery.