Incomex AI Portal
KB-582D

dot-iu-cutter v0.5 Fabric Addendum — Existing Design Map + Workstreams

11 min read Revision 1
dot-iu-cutterv0.5fabric-addendumdesign-onlyws-1dieu44dieu382026-05-18

dot-iu-cutter v0.5 Fabric Addendum — Existing Design Map + Workstreams

Phase: design-only · Date: 2026-05-18 · Authority: User + GPT Position + Opus + consensus Self-contained: reader không cần mở file khác để hiểu file này.

0. Mục tiêu file này

Vẽ bản đồ thiết kế đã có của dot-iu-cutter / Information Unit Fabric, chỉ ra 5 gap thật G1..G5, chốt 4 workstream WS-1..WS-4 và trình tự downstream. KHÔNG thiết kế lại phần đã chốt (chi tiết §2 dưới đây). Brief chi tiết WS-1 nằm ở file 2.

1. Tóm tắt 10 tài liệu nền (mandatory_read)

Mỗi mục: path + câu chốt cụ thể. Đây là authority đã duyệt — chỉ reference.

R1 — P44-4A knowledge/dev/laws/dieu44-trien-khai/design/05-relation-edge-conformance-design.md Logical contract cho relation/composition edges. §3.1: 8 core edge types contains, references, depends_on, uses, implements, supersedes, contradicts, compatible_with. §3.2: 3 candidate derived_from, governed_by, published_in. §3.3: edge type ngoài 11 loại phải qua APR cấp medium (Đ32) + amend vocab framework; cấm hardcode edge_type list (NT4). §7.7.3 INV-DUAL-1..4 anti-drift. §6.2 reverse-index P1/P2/P3. §2.1: endpoint là bất kỳ Object OQC≥3/4 — không chỉ information_unit. Execution defer P44-5.

R2 — P11D knowledge/dev/laws/dieu38-trien-khai/closure/p11d-logical-topic-view-proof-design.md §3.1: 4 field topic bắt buộc topic_code, topic_name, topic_namespace, topic_status; §3.3 topic_confidence; §3.4 topic_provenance{creator,method,timestamp,source_context} bắt buộc post-Đ44. §5: 5 query Q-T1..Q-T5. §6.1: assembly pipeline 5 bước GATHER→ENRICH→GROUP→QUALITY→PROVENANCE. §3.5: vocab table defer P44-6, start free-text + provenance (Q-D3). OPEN P11D-α..ζ.

R3 — P11C knowledge/dev/laws/dieu38-trien-khai/closure/p11c-closure-note-2026-05-02.md §3: universal_edges là SSOT cho relation+composition; tac_publication_member chỉ là helper, KHÔNG phải SSOT. Cap-4 Relation + Cap-5 Composition chốt. Execution defer P44-6.

R4 — P38-XC knowledge/dev/laws/dieu44-trien-khai/design/04-information-unit-profile-schema.md §1: information_unit là universal substrate, không sinh object mới. §5: UMC 10 element U1..U10 (unit_id, canonical_address, unit_kind, lifecycle_status, content_anchor_ref, version_anchor_ref, owner_ref, audit, parent_or_container_ref, conformance_status). §3.2/§8: Cap-1 identity, Cap-2 content, Cap-3 publication, Cap-4 relation, Cap-5 composition. §7: profile information_unit_identity_v1 / content_v1 / publication_v1 (JSONB anchor trên tac_*).

R5 — v0.5 Master Plan knowledge/dev/laws/dieu44-trien-khai/v0.5-constitution-hardtest-design/dot-iu-cutter-v0.5-constitution-hardtest-master-plan-2026-05-17.md Pipeline S0..S7 (intent→ingestion→canonicalization→plan→dry-run-at-volume→staged-production→projection→closeout). Principles P1..P10 (SQL SSOT, append-only, no-hardcode, deterministic identity, provenance total, projection-only, JSONB không là hidden authority, no big-bang, idempotent, sovereign gates). Sequencing Q0..Q9. OD-G1/G2/A1/S1/V1/M1/L1-5/P1/R1/I1. Source thật = Hiến pháp Kiến trúc nội bộ Incomex (KB-7294 rev44), KHÔNG phải Hiến pháp 2013.

R6 — v0.5 Label/Metadata knowledge/dev/laws/dieu44-trien-khai/v0.5-constitution-hardtest-design/dot-iu-cutter-v0.5-information-unit-label-metadata-registry-master-design-2026-05-17.md Concept (chưa tạo): label_dictionary, label_assignment (append-only), metadata_key_registry, metadata_value, hot_key_promotion_ledger. Promotion flow cold→observe→propose→sovereign_gate→execute_later. Anti-hardcode binding. OD-L1..L5. Physical defer Q5.

R7 — v0.4 Hybrid knowledge/dev/laws/dieu44-trien-khai/v0.4-schema-binding/dot-iu-cutter-v0.4-sql-nosql-hybrid-information-unit-strategy-2026-05-17.md §1: PostgreSQL cutter_governance = SSOT; doc/vector store = projection rebuildable, không phải authority. §2: 7-category field taxonomy (identity/relationship/governance-event/query-projection = SQL column; JSONB payload; vector; blob pointer). §4: normalize queue, idempotency_key graduate đầu tiên. Invariant: không hardcode collection/DSN.

R8 — 23-P1 knowledge/dev/laws/dieu44-trien-khai/design/23-p1-iu-text-as-code-edit-merge-design.md Git-like cho IU: branch tip = unit_version(proposed), commit = unit_version(merged), merge = fn_iu_merge_edit, PR = edit proposal. Hàm Phase-1 fn_iu_propose_edit / fn_iu_merge_edit / fn_iu_edit. Trạng thái: design note rev2, chờ review; cần 23-P2 read-only inspection trước implement.

R9 — TD-P1 knowledge/dev/laws/dieu44-trien-khai/backlog/td-p1-split-merge-metadata-propagation-gap-2026-05-15.md Gap xác nhận: pipeline hiện chỉ cắt lần đầu, chưa có SPLIT/MERGE + metadata propagation (canonical_address, birth_registry, universal_edges, render_order...). Đã có detection signals (co-citation/co-edit), chưa có pipeline xử lý sau khi flag. Ghi nhận P1 capability.

R10 — GPT Position knowledge/dev/laws/dieu44-trien-khai/reviews/dot-iu-cutter-v0.5-fabric-addendum-topic-formation-gpt-position-2026-05-18.md Chấp thuận 4 workstream; WS-1 highest (mở rộng nhẹ để gồm minimal cross-cutting contracts), WS-4 high_after_WS1_WS2. Defer: SQL data binding (record principle now, schema sau pilot thật), Directus contract template (UI/assembly thôi), render/snapshot lifecycle. Forbidden: schema migration, prod write, code change, index DDL, CUT/VERIFY, Constitution dry-run, bulk cut, Directus mutation, vector/NoSQL integration, contract template implementation.

Optional scan: v0.4 scale-automation review, v0.5 source-ingestion design, v0.5 canonicalization design, P11E checker proof, LSL-01 — đã đối chiếu, không mâu thuẫn với thiết kế dưới đây.

2. KHÔNG thiết kế lại (reference only)

Hạng mục Nguồn Trạng thái
IU↔IU relation edges (8 core + 3 candidate, INV-DUAL, reverse-index) P44-4A design CLOSED, exec defer P44-5/6
Topic field model (topic_code/name/namespace/status/confidence/provenance) P11D §3 logical CLOSED, runtime defer Pilot Tier 1
Topic query catalog Q-T1..Q-T5 + 5-step pipeline P11D §5/§6 logical proof CLOSED
universal_edges = SSOT P11C §3 chốt
UMC + Cap-1..5 + profiles P38-XC design CLOSED
label/metadata registry concept v0.5 Label/Metadata concept CLOSED, table defer Q5
SQL SSOT / projection / JSONB rule v0.4 Hybrid CLOSED
Git-like edit/merge model 23-P1 design note, chờ review

WS-1 chỉ bổ sung trên nền này, ghi rõ "bổ sung so với [tài liệu]" khi cần.

3. 5 gap thật G1..G5 + justify

  • G1 Assembly Contract — P10D đã chứng minh assembly-by-document (Nuxt Laws Page chạy thật); P11D §6 chứng minh assembly-by-topic (logical). Nhưng mỗi loại là pipeline ad-hoc riêng, chưa có abstract layer chung → khi có nhiều loại assembly sẽ phải hardcode pipeline từng loại. Gap thật: thiếu interface assembly_profile trừu tượng.

  • G2 IU↔non-IU Entity Binding — P44-4A §2.1 cho endpoint là Object OQC≥3/4, nhưng business entity SQL thật (customer, contract, invoice, GitHub file) không phải Object đã đăng ký. User yêu cầu nối miếng thông tin với SQL data mà không copy data vào IU. Gap thật: chưa có cơ chế binding IU↔entity authoritative.

  • G3 Topic Registry Decision — P11D §3.5 defer vocab table sang P44-6, dùng free-text topic_code → rủi ro duplicate (AP-3). Gap thật: chưa phân biệt rõ "logical registry contract" vs "physical table creation"; cần quyết định, không tự mở migration.

  • G4 Cross-source-family Assembly — P11D proof chỉ chạy 3 publication cùng một source family. User yêu cầu chiều thứ 2: xâu chủ đề xuyên Hiến pháp nội bộ → Luật → Quy trình → SQL → Code → Report → Lesson, authority khác nhau. Gap thật: chưa có taxonomy source_family + authority semantics + ordering xuyên family.

  • G5 Directus Boundary Formal — Nguyên tắc đã chốt (v0.4 Hybrid §1 + GPT Position) nhưng chưa formal hóa → session sau dễ vi phạm. Gap thật: thiếu boundary document chính thức.

4. 4 Workstream

WS Scope Priority Dependencies
WS-1 Relation Edge + Topic Graph + Assembly Contract G1+G2+G3+G4+G5 (cross-cutting contracts) highest (GPT) P44-4A, P11D, P11C, P38-XC, v0.4 Hybrid
WS-2 Metadata Key Registry + Source Profile concrete hóa metadata_key_registry + source profile (internal governance + external gov law) + grammar profile per family high v0.5 Label/Metadata, WS-1 source_family taxonomy
WS-3 Assembly by Topic dùng G1 contract + P11D pipeline; proof cross-source; ≥2 profile (topic_thread + compliance_matrix); logical view/function prototype only high WS-1 (G1, G4), WS-2
WS-4 Edit/Amend/Supersede Pipeline nay chỉ identify interface + dependency; đảm bảo WS-1 không chặn amend/split/merge/supersede; detailed design defer high_after_WS1_WS2 (GPT) WS-1, WS-2, 23-P1, TD-P1

WS-1 KHÔNG redesign IU↔IU relation (P44-4A) hay topic field model (P11D).

5. Downstream sequence sau WS-1

  1. WS-1 brief PASS (GPT/User review file 2) → ratify G1..G5 options.
  2. New cross-family edge types (G4) cần qua P44-4A §3.3 APR cấp medium trước khi WS-3 dùng.
  3. WS-2 concrete hóa metadata/source profile (gắn Q5 master plan).
  4. WS-3 proof assembly-by-topic cross-source (logical, không cut).
  5. WS-4 detailed (amend/split/merge/supersede) — sau WS-1+WS-2, dùng 23-P1 + TD-P1, tích hợp MARK→SWEEP→REVIEW→CUT→VERIFY.
  6. Physical table (assembly_profile, entity_reference_registry, topic_vocab) chỉ mở ở schema-design cycle riêng có sovereign gate — KHÔNG ở phase này.

6. Principles binding (bắt buộc mọi WS)

  • SQL SSOT — cutter_governance + public.tac_logical_unit là authority (v0.4 Hybrid §1, P1 master plan).
  • PG First — thiết kế trên PostgreSQL trước; vector/NoSQL là projection rebuildable (P6).
  • Assembly First — assembly là contract, không phải code hardcode từng loại (G1).
  • No hardcode — label/metadata-key/grammar/topic-type/source-family/DSN/collection resolve qua registry, không literal trong runtime (P3, R6 §6).
  • JSONB không là hidden authority — hot key phải promote sang SQL/registry (P7, R7 §4).
  • Directus boundary — UI/form/template assembly/exposure; KHÔNG own lifecycle/provenance/compliance (G5, GPT Position).
  • universal_edges = SSOT cho edges; helper table không thay thế (P11C §3).
  • Design-only — không schema/code/dry-run/mutation; self-advance PROHIBITED.
Back to Knowledge Hub knowledge/dev/laws/dieu44-trien-khai/v0.5-fabric-addendum-scope/dot-iu-cutter-v0.5-fabric-addendum-existing-design-map-and-workstreams-2026-05-18.md