KB-5552

IU Core 120x Three-Axis — 01 Precheck, survey, backup, gates

4 min read Revision 1
dieu44iu-core-mvp120xprecheckbackupgatesv0.62026-05-22

01 — Precheck, Survey, Backup, Gates

Macro

IU_CORE_120X_THREE_AXIS_METADATA_DELIVERY_AUTOCUT_TEXTCODE_OPEN_GOAL — 2026-05-22. A 120x macro = two coherent 60x slices: (A) the three-axis metadata layer; (B) non-reparent rollout + auto-cut mapping + text-as-code kickoff.

Host + repo

Check Value
Host MacBook/dev /Users/nmhuyen/iu-cutter-build/repo/iu-cutter
Branch main
HEAD before e789bff
Tree clean, no remote

Production identity (positive)

Check Value
Host VPS vmi3080463 (ssh contabo)
Container postgres (image postgres:16, healthy)
Role / DB directus / directus
Version PostgreSQL 16.13
IU surface information_unit 158, iu_tree_path 158, v_iu_tree 158

60x state verification (intact)

The 60x durable state was re-verified before any change — no repair needed: iu_structure_operation 46, iu_tree_change_log 1, iu_route_attempt 45 (1 sent), iu_route_dead_letter 0, DOT 60/60, 712 tests. The 60x KB reports are in AgentData (uploaded by the report-evidence-repair macro).

Pre-macro survey — the three-axis raw material

  • information_unit columns confirm the axes' substrate:
    • Axis Adoc_code, sort_order (integer, document-linear), section_type, section_code, canonical_address. No duplicate sort_order within any doc_codesort_order is a valid linear key.
    • Axis Cparent_or_container_ref + iu_tree_path + v_iu_tree + iu_relation + iu_structure_operation — already built.
    • Axis B — NO semantic tagging existed anywhere. This is the only genuinely new data the macro adds.
  • 11 stale pilot.*/test/* scratch IUs remain draft (the 60x macro deprecated 1 of the original 12).

Backup

pg_dump -Fc/opt/incomex/backups/directus-pre-iucore-120x-20260522T065235Z.dump — 75 747 731 bytes — sha256 38ba6ffdb2792d9e82722019cb0f703dd2abc51f3ceafc4ad0fe82d6b4cc6900. Verified: pg_restore --list reports 280 TABLE DATA entries (valid; +1 vs the 60x backup — the new iu_tree_change_log table).

Baseline before any mutation

  • DOT runtime/110 60/60 PASS, D8 drift 0.
  • Test suite 712 passed.

Mandatory gates — all 14 PASS before any production mutation

  1. Host correct. 2. Target identity positive. 3. Fresh backup + sha verified.
  2. DOT / no-hardcode / tests baseline clean. 5. Candidate scope by live discovery (02/04). 6. Operations bounded + reversible. 7. Rollback authored before apply (rollback/014, runtime/rollback/230, fn_iu_structure_op _rollback). 8. Metadata vocabulary registry-backed (iu_metadata_tag _registry). 9. No axis duplicates a source of truth — axis A is a pure projection, axis C reads existing tables, only axis B stores new rows. 10. Existing IU tree/lineage unchanged. 11. Worker/delivery stays controlled, no external delivery. 12. Disable path known (rollback files / close gates). 13. runtime/110 verifies post-change visibility (68/68). 14. AgentData list/read/search verification path exists.
Back to Knowledge Hub knowledge/dev/laws/dieu44-trien-khai/v0.6-iu-core-120x-three-axis-metadata-delivery-autocut-textcode-open-goal/01-precheck-survey-backup.md