Per-repo documentation — each repo's docs/ and README, ingested and associated with the repo. Rendered through the <<<RepoDocs>>> tag.
← big-jazz docs · spec/README.md
The clean, from-scratch, born-instrumented, contained codebase that replaces the old rot. This is the working prototype of the Living Code-Graph architecture specified in SPEC.md — the "enclosure": the boundary that holds the code, governs who touches it, and watches it.
| package | role | status | |---|---|---| | packages/code_pipeline | Observability — the born-instrumented execution-graph tracer (nodes = functions pinned to (file, commit), edges = calls, every branch via sys.monitoring), into a new auto-timestamped DB. Retired + replaced the split-brained dz_debug. | built, 15/15 tests | | packages/routed_vm | The enclosure, physical — a persistent OVS fabric + Incus instances + VNC desktop, in Python, systemd-backed (survives reboot). A contained, routed environment standing in for the logical enclosure until the object-model lands. | built, 4/4 tests, reboot-proven | | packages/wayback | Ground truth — a read-only git×telemetry visualiser: what the codebase is over time vs what it stubs against (the anti-degeneration lens). | built |
- Observe everything (code_pipeline): degeneration becomes a visible diff, not a silent swap. - Contain everything (routed_vm + the tiers in SPEC): no agent is handed the whole spec or raw code — only its slice, via MCP. - Together: you can see the whole from the controller, while nothing can be overwhelmed by the whole.
~/code/.venv/bin/pip install -e packages/code_pipeline
python packages/code_pipeline/tests/test_graph.py # 15/15
python packages/routed_vm/tests/test_routed_vm.py # 4/4
Refactored + generated 2026-07-01/02. dz_debug retired (its Logger folded into code_pipeline.log). Not a jazz package — its own tree, prototyping the monorepo shape (task #27).