KB-13F9

00 — Readme First — RP Dynamic Layer Graph + Count Contract Finalize 2026-06-03

3 min read Revision 1
registries-pivotlayer-graphcount-contractfinalize2026-06-03readme

00 — Readme First

Macro: REGISTRIES_PIVOT_DYNAMIC_LAYER_GRAPH_AND_COUNT_CONTRACT_FINALIZE Date: 2026-06-03 Final status: PARTIAL (contract layer LIVE; parent graph rehearsed-clean + apply-ready; missing-pivot bundle apply-ready/held) Execution mode: EXECUTION_MODE (read = query_pg RO; write = ssh contabo → docker exec postgres psql -U workflow_admin -d directus, superuser) Live mutation: YES — exactly ONE additive read-only object: CREATE VIEW v_registries_pivot_node_contract. 0 base-table / 0 count mutation (pivot_definitions byte-identical: pd_hash=1e31696f3cb47d244c578bd9390ca56d).

What this macro did

  1. Verified the Layer-definition canon is KB-readable (doc 2 readback PASS — no repair needed). See doc 01.
  2. Recovered prior RP state and separated the layer engine track from the composition cleanup / dot-pivot-update track (which is OUT OF SCOPE here and was not touched). See doc 02.
  3. Live-verified RP — 37 pivots, 35 active, parent_code NULL on all 37 (graph still unwired); the backend contract views already exist live; PIV-500/30x/31x absent. See doc 03.
  4. Proved the dynamic parent graph via a live BEGIN..ROLLBACK rehearsal: 13 edges → 24 roots / 6 parents / 0 dangling, fully reversible (entry hash == exit hash). See doc 04.
  5. Completed the count contract (pivot-only sources + invariant + PIVOT_MISSING ledger). See doc 05.
  6. Audited + extended the backend contract — applied the live v_registries_pivot_node_contract (26-col §8 node contract). See doc 06.
  7. UI handoff preserving the old Registries column/drill philosophy. See doc 07.
  8. Pin/label/auto-grouping thresholds. See doc 08.
  9. Apply strategy + done-definition, operator apply packet, final summary, MCP checkpoint. Docs 09–12.

Read order

00 (this) → 03 (live truth) → 04 (graph) → 05 (counts) → 06 (backend) → 09 (done decision) → 10 (apply packet) → 11 (summary) → 12 (checkpoint).

Forbidden-action compliance (full)

No composition cleanup; dot-pivot-update NOT run / NOT registered; no Nuxt count math; no hardcoded depth; PIVOT_MISSING surfaced not hidden; no birth_registry / birth-gate change; no pre-birth/governance rollout; orphan/phantom defs not faked (sourced from live v_birth_orphan/v_birth_phantom/v_count_integrity).

Back to Knowledge Hub knowledge/dev/reports/architecture/registries-pivot-dynamic-layer-graph-count-contract-finalize-2026-06-03/00-readme-first.md