01 — Macro frame · gates · target state

• Macro: IU_CORE_1500X_QDRANT_LIVE_DIRECTUS_REGISTER_NUXT_ASSEMBLY_EXTERNAL_CLOSEOUT_OPEN_GOAL
• Date: 2026-05-23
• Host: MacBook/dev /Users/nmhuyen/iu-cutter-build/repo/iu-cutter
• Production: VPS vmi3080463, container postgres (postgres:16), DB directus; container incomex-qdrant (qdrant/qdrant:latest) at http://qdrant:6333 on docker network docker_incomex.
• Outcome: IU_CORE_1500X_QDRANT_DIRECTUS_NUXT_EXTERNAL_CLOSEOUT_PASS.

1. Why this macro

The 1k+ closeout (IU_CORE_1K_PLUS_VECTOR_UI_ASSEMBLY_ACCEPTANCE_PASS, commit 8cae3db) declared IU Core functionally complete — the per-IU vector boundary is now enforced at three layers, and a Directus-ready three-axis envelope view (163 rows) exists on production. What remained was external integration:

1. Qdrant external apply — wire the embedder + a dedicated IU Core collection.
2. Directus collection registration — register v_ui_iu_three_axis_envelope as a read-only Directus collection.
3. Nuxt assembly wiring — point an existing Nuxt screen at it.

The 1500x macro reaches the external-integration-ready state: it delivers the database substrate, the embedder seam, the bounded live Qdrant collection create, the Directus registration package, and the Nuxt assembly contract — without triggering a Nuxt deploy/restart, without leaking any secret, and without destructive vector reindex.

2. State at start (verified before any mutation)

Live read (read-only query_pg):

relation	count
information_unit (active)	163
iu_piece_collection	3
iu_piece_membership	8
dot_iu_command_run	18
iu_tree_change_log	56
iu_route_attempt	68
iu_vector_sync_point	3 (dryrun)
dot_iu_runtime_lease	0
v_ui_iu_three_axis_envelope	163

Migration 020 columns + iu_vector_sync_point_boundary_chk CHECK + fn_iu_vector_sync_record_v2 + v_ui_iu_three_axis_envelope view present. Gates all in their 1k+ end-state.

3. Mandatory gates — all PASS

All 23 mandatory gates PASS. Notable:

• pg_dump backup /opt/incomex/backups/directus-pre-iucore-1500x-20260523T025723Z.dump sha256 d798fcc9a35585f6c860334226f554a073120f5c22fdb795e4b58654d7a2cbdc.
• Qdrant secret discovered safely (no value read into session).
• Bounded + reversible (registry retire + Qdrant DELETE paths).
• Rollback authored before apply (rollback/021_*, runtime/rollback/310_*).

4. Target end-state (achieved)

• Migration 021 + runtime/310 applied to production (durable, additive).
• iu_qdrant_collection_registry carries the default IU Core plan (iu_core_iu_chunks, dim=1536, Cosine, openai:text-embedding-3-small, status=active).
• Live iu_core_iu_chunks Qdrant collection exists on incomex-qdrant (size=1536, distance=Cosine, points_count=0, status=green) — reversible via Qdrant DELETE.
• DOT 128/128 (table 19, view 20, function 47). D8 drift 0.
• vector_sync.py / directus_registration.py / nuxt_assembly_contract.py built.
• Sandbox/200 BEGIN…ROLLBACK probe 10/10 PASS on production.
• 1083 tests pass (+38).