dot-iu-cutter v0.5 Fabric Addendum — Report

Phase: design-only · 2026-05-18 · Self-contained.

---

1. Executive summary

Phase rà soát thiết kế dot-iu-cutter / Information Unit Fabric hiện tại, xác nhận 5 gap thật G1..G5, chốt 4 workstream WS-1..WS-4 và soạn WS-1 design brief chi tiết. Không thiết kế lại phần đã chốt. Kết quả: 4 file logical/pseudo-schema trong v0.5-fabric-addendum-scope/. KHÔNG schema/code/dry-run/mutation/commit. Self-advance PROHIBITED — route về GPT/User review.

2. What was read (§1 mandatory_read — 10/10 đọc full)

P44-4A (relation edge conformance), P11D (topic view proof), P11C (closure note), P38-XC (IU profile schema), v0.5 Master Plan, v0.5 Label/Metadata, v0.4 Hybrid, 23-P1 (edit/merge), TD-P1 (split/merge gap), GPT Position. Optional scan: v0.4 scale review, v0.5 source-ingestion, v0.5 canonicalization, P11E, LSL-01 — đã đối chiếu, không mâu thuẫn.

3. What was found

• Đã có & chốt: IU↔IU relation edges (P44-4A 8 core + 3 candidate, INV-DUAL, reverse-index), topic field model + Q-T1..Q-T5 + pipeline 5 bước (P11D), universal_edges=SSOT (P11C), UMC + Cap-1..5 + profiles (P38-XC), SQL SSOT + field taxonomy (v0.4 Hybrid), label/metadata registry concept (v0.5), Git-like edit/merge (23-P1).
• Thiếu thật: abstract assembly contract; IU↔non-IU entity binding; topic registry physical-vs-logical decision; cross-source-family authority-aware assembly; Directus boundary formal.
• GPT Position pre-resolve: 4 WS, WS-1 highest, WS-4 high_after_WS1_WS2; defer SQL data binding schema / Directus contract template / render-snapshot lifecycle.

4. Overlaps avoided (QG1)

KHÔNG redesign: IU↔IU edges (chỉ reference P44-4A §2.1/§3); topic field model (reference P11D §3); Q-T pipeline (build on top P11D §6, không thay); universal_edges SSOT (reference P11C §3); UMC/Cap (reference P38-XC §5/§8); SQL SSOT (reference v0.4 §1); label/metadata concept (reference v0.5 R6); edit/merge model (reference 23-P1). G2 dùng option D bổ sung không sửa P44-4A. G4 edge mới đẩy qua P44-4A §3.3 APR thay vì tự tạo.

5. Gaps confirmed

G1 Assembly Contract · G2 IU↔non-IU Entity Binding · G3 Topic Registry Decision · G4 Cross-source-family Assembly · G5 Directus Boundary Formal. Justify chi tiết: file existing-design-map §3.

6. What was designed (logical only)

• G1: assembly_profile abstract (11 field logical) + generic executor trên pipeline P11D; 3 sketch original_document / topic_thread / compliance_matrix (cover ≥3 loại — QG5).
• G2: option A/B/C/D + trade-off matrix → recommend D hybrid; entity_reference_registry core 5 field + 2 deferred placeholder (QG6/QG8).
• G3: option A/B/C → recommend C (logical contract nay, physical defer P44-6+APR).
• G4: source_family taxonomy 9 loại + authority_semantics (normative/evidence/implementation) + ordering authority-aware + 6 edge mới gated APR.
• G5: boundary formal Directus (được/own/không-được/governance).
• 4 file: existing-design-map-and-workstreams, WS1-relation-topic-assembly-design-brief, fabric-addendum-open-decisions, fabric-addendum-report. Mỗi gap có ≥1 ví dụ nôm na (QG3): kho nguyên liệu nhà hàng, thẻ khách hàng, sổ tay phân loại kho, hồ sơ xây nhà, quầy trưng bày bếp.

7. Risks

• R-G1 profile quá tự do → assembly không deterministic. Mitigate: provenance_policy bắt buộc.
• R-G2 binding stale; binding_kind trùng edge ngữ nghĩa. Mitigate: trỏ natural_key đọc live; flag OD.
• R-G3 free-text duplicate kéo dài. Mitigate: snake_case + provenance bắt buộc từ WS-3.
• R-G4 dùng edge mới trước APR → vi phạm P44-4A. Mitigate: gate cứng OD-FA4.
• R-G5 nhầm Directus là authority. Mitigate: render_template chỉ là pointer.
• R-process: nguy cơ over-design. Mitigate: chỉ logical, defer physical, QG7 size.

8. Next steps

1. GPT/User review 4 file (Q0-equivalent).
2. Nếu PASS: ratify OD-FA1/2/3/5/6/7 (resolve_in_WS1); mở APR batch cho OD-FA4 (6 edge mới).
3. WS-2 metadata/source profile cycle (gắn Q5 master plan).
4. WS-3 proof assembly-by-topic cross-source (logical prototype, không cut).
5. WS-4 amend/split/merge/supersede sau WS-1+WS-2 (23-P1 + TD-P1).
6. Physical table chỉ ở schema-design cycle riêng có sovereign gate.

9. Forbidden respected (QG2 / §6)

KHÔNG: schema migration, production write, code change, index DDL, CUT, VERIFY, Constitution dry-run, any dry-run, bulk cut, Directus mutation, vector/NoSQL integration/write, contract template implementation, create PG table, ALTER TABLE, CREATE INDEX, deploy, restart, git commit, redesign §2 items. Tất cả output là logical/pseudo-schema (YAML field list) — không executable SQL. Self-advance PROHIBITED.

10. Git / repo status (§9)

• VPS access: no VPS access in this session (môi trường: working dir /Users/nmhuyen, không phải git repo, không có SSH tới /opt/incomex/dot).
• repo_ssot: /opt/incomex/dot — không truy cập được phiên này, bỏ qua theo chỉ dẫn (chỉ read-only nếu có; tuyệt đối không write).
• branch / HEAD / git status --short -- iu-cutter: không truy cập được → không báo.
• code_changed: false
• commit_made: false

11. Quality Gates self-check

• QG1 không redesign §2 — chỉ reference path+section: ✅
• QG2 không vi phạm forbidden §6: ✅
• QG3 mỗi G1..G5 có ≥1 ví dụ nôm na: ✅
• QG4 pseudo-schema/YAML, không executable migration SQL: ✅
• QG5 assembly contract cover ≥3 loại (original_document/topic_thread/compliance_matrix): ✅
• QG6 G2 đủ option A/B/C/D + trade-off: ✅
• QG7 mỗi file ≤ 25K chars (preferred ≤15K; file 2 lớn nhất vẫn < hard limit): ✅
• QG8 entity registry core minimal + deferred fields, không over-design: ✅

12. Routing

4 file đã upload vào knowledge/dev/laws/dieu44-trien-khai/v0.5-fabric-addendum-scope/. DỪNG. Route về GPT/User review. Agent self-advance PROHIBITED — không tự sang WS-2/WS-3/WS-4, không schema/code/dry-run.