Repo docs

Per-repo documentation — each repo's docs/ and README, ingested and associated with the repo. Rendered through the <<<RepoDocs>>> tag.

← code__big-jazz-2nd__big-jazz docs · spec/README.md

new_repo — the enclosure (prototype)

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.

The three pieces (and how they form the enclosure)

| 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 |

The idea (see SPEC.md for the full normative version)

- 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.

Dev

~/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

Provenance

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).