The Consolidation Program
Program home: one engine by extraction. The destination, the topology, the method, and the ratified charter — start here.
The Consolidation Program
One engine. The v2 family (crates/n0, crates/n0-model,
crates/n0_dev) is the chassis; the legacy family (crates/grida
and its satellites) is the know-how. The program ends when the
chassis carries all the know-how, the conformance bar has flipped, and
the legacy engine has contracted to nothing.
Status: Active. Owner: universe@grida.co. Tracking: gridaco/nothing#43 (umbrella), gridaco/nothing#9 (the v2 model program), gridaco/nothing#1 (the migration anchor).
Genre: program record — doctrine, destination, and method for the
people and agents doing the work. Not a domain spec. The domain specs
live in the sibling wg clusters (canvas/, format/, feat-*) and
always win on conflict; a conflict with one of them is a finding to
file, never something to paper over here.
Read in this order
A zero-context session becomes a working session by reading four short docs, in order:
- The goal of n0 — what the consolidated engine becomes, and what it refuses to be.
- End-state topology — chassis vs know-how: who absorbs whom, per domain, and the render-mode taxonomy.
- The method — how one consolidation step is executed, with a worked example.
- The charter — the ratified route: phases with entry/exit gates, the first PRs, the owner decision registry, and the known unknowns.
Reference, consulted as needed: the glossary — the program vocabulary. Use its terms; do not mint synonyms.
The charter is the only doc of the four that sequences work — and it records the route; the current position (active phase, landed PRs, taken decisions) is tracked on gridaco/nothing#43, which a session reads before starting work. The other three docs are direction: stable in shape, expected to gain detail as decisions in the registry land.
Standing rules (bind every session)
Stated once, owned by the charter's doctrine section:
- Patrol-before-drop. No deletion or replacement without a patrol triage and a captured-essence ledger first.
- Migration by extraction. A module becomes a shared crate when its second consumer appears in the workspace — never before.
- Absorption direction. The chassis absorbs the engine role by consuming extracted crates — never by copying; the legacy engine is decomposed, not absorbed.
- Two gate classes. Zero-behavior moves gate on byte-identical sweeps; capability grants gate on the scoreboard. Nothing lands unmeasured.
- Oracle discipline. The conformance bar is the Chromium/consensus oracle — never the legacy engine itself.
- Frozen surfaces. The v1 schema (
format/grida.fbs) and the published wasm freeze contract stay untouched until Phase 6 says otherwise. - Owner gates. Merges to main and every registry decision need the owner's explicit GO. All-green CI is necessary, not sufficient.
Working conventions
- Plans are
*.plan.mdfiles — gitignored working scratch, never committed knowledge. Durable knowledge lands in this directory or the sibling wg clusters; work items land in issues. - Skills to load per task:
docs-wgandnamingbefore authoring or renaming anything;linksfor cross-repo references;fixtures,render-reftest,render-perf,io-svg,io-gridafor their engine loops. - Concluded programs are archived under repo-root
archive/— the frozen v2 workbench record atarchive/model-v2/is the precedent, and this directory retires the same way when the program concludes.
Targeting & Selection
The pointer→node resolution mathematics — hit chains, graph-distance targeting, descent, deep-select, additive rules, and the marquee predicates including containment suppression.
The Consolidation Charter
The ratified route of the consolidation program — phases with entry/exit gates, the doctrine, the owner decision registry, and the known unknowns.