James-Chahwan/repo-graph

What's new

Cold-start cache reuse — the wrapper now caches the graph at <repo>/.ai/repo-graph/ between server restarts. On a 22k-node repo, cold start drops from ~2.8s to ~257ms (≈11× faster through the wrapper). Requires engine repo-graph-py>=0.4.14.

Release-gate test framework — 52 tests across five layers, all green before any future publish:

| Layer | Tests | What it covers |
|---|---|---|
| test_mcp_e2e.py | 14 | Spawns repo-graph subprocess, drives MCP/JSON-RPC over stdio, asserts content-block shapes |
| test_mcp_tools.py | 22 | In-process @mcp.tool function calls + 11-tool surface lock |
| test_cache.py | 5 | .gmap cache roundtrip: cold write, warm read, source-change invalidation |
| test_init.py | 5 | repo-graph-init bootstrap CLI: idempotency, preserves existing config |
| test_perf.py | 6 | generate / dense_text / activate perf budgets, opt-in via -m perf |

pip install -e ".[dev]"
pytest                  # all five layers
pytest -m e2e           # MCP wire only
pytest -m "not e2e"     # fast loop, skip subprocess spin-up

Other

• CLAUDE.md tool list corrected: 11 tools across 4 tiers (the phantom cost, hotspots, minimal_read, bloat_report, split_plan references are gone)
• Surface-lock test (test_eleven_tools_decorated) fails fast if server.py and CLAUDE.md ever drift
• Dead tests/test_py_smoke.py removed (imported modules that no longer exist post-v0.4.10c clean break)

Install

```bash
pip install mcp-repo-graph
```

The engine wheel (repo-graph-py 0.4.14) is fetched automatically from PyPI.

Full changelog

3bad3e5...v0.4.12