KB-5498

dot-iu-cutter v0.5 Fabric Addendum — Consolidated Open Decisions

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

dot-iu-cutter v0.5 Fabric Addendum — Consolidated Open Decisions

Phase: design-only · 2026-05-18 · Self-contained. Mỗi OD: mô tả · options · impact nếu defer · recommendation · phân loại. Phân loại: resolve_in_WS1 | defer_WS2 | defer_WS3 | defer_WS4 | defer_post_pilot. Agent KHÔNG tự quyết — đây là input cho GPT/User review.


A. Open decisions MỚI từ gap G1..G5 (trọng tâm)

OD-FA1 — assembly_profile storage

  • Mô tả: assembly_profile (G1) lưu thành bảng riêng hay tái dùng ledger pattern trong cutter_governance?
  • Options: (a) bảng assembly_profile mới; (b) tái dùng append-only pattern như label_assignment (R6); (c) JSONB config.
  • Impact nếu defer: WS-3 không có nơi cụ thể lưu profile → vẫn ad-hoc.
  • Recommendation: chốt logical contract trong WS-1; physical storage defer cycle schema-design (gắn Q5 master plan). Không mở migration nay.
  • Phân loại: logical resolve_in_WS1, physical defer_WS3.

OD-FA2 — IU↔entity binding option

  • Mô tả: chọn A/B/C/D cho G2.
  • Options: A extend universal_edges; B typed binding+registry; C JSONB pointer; D hybrid.
  • Impact nếu defer: không nối được IU↔SQL data; chiều user yêu cầu bị chặn.
  • Recommendation: Option D (hybrid) — universal_edges giữ nguyên (P44-4A), iu_entity_binding cho entity thô, G1 tiêu thụ cả hai.
  • Phân loại: resolve_in_WS1 (chốt option); physical bảng defer_post_pilot.

OD-FA3 — topic registry option

  • Mô tả: chọn A/B/C cho G3.
  • Options: A physical sớm; B JSONB free-text tiếp; C logical contract nay + defer physical.
  • Impact nếu defer: duplicate topic_code tích luỹ (AP-3 P11D §8.1).
  • Recommendation: Option C — chốt logical contract + ownership + duplicate-mitigation logic nay; physical topic_vocab chờ Pilot Tier 1 + duplicate-rate + APR Đ32 (đúng P11D-α).
  • Phân loại: resolve_in_WS1 (chốt C + contract); physical defer_post_pilot (P44-6).

OD-FA4 — new cross-family edge types

  • Mô tả: G4 cần 6 edge type mới constrains, maps_to_requirement, maps_to_process, maps_to_code, evidenced_by, lesson_from — chưa có trong P44-4A 11 loại.
  • Options: (a) qua P44-4A §3.3 APR cấp medium từng loại; (b) gộp 1 APR batch; (c) tái dùng edge sẵn có (vd implements/governed_by/references) thay vì tạo mới.
  • Impact nếu defer: WS-3 cross-source assembly không chạy được đúng ngữ nghĩa authority.
  • Recommendation: (b) 1 APR batch cấp medium, justify per type; cân nhắc (c) cho loại trùng ngữ nghĩa để giảm số edge mới. KHÔNG tự tạo (NT4, forbidden §6).
  • Phân loại: defer_WS3 (gated bởi APR Đ32 trước khi WS-3 dùng).

OD-FA5 — entity_reference_registry field scope

  • Mô tả: registry G2 core minimal vs có thêm permission/snapshot.
  • Options: (a) core 5 field + 2 deferred placeholder; (b) full ngay.
  • Impact nếu defer permission/snapshot: chưa render snapshot hợp đồng — chấp nhận được (GPT defer render/snapshot lifecycle).
  • Recommendation: (a) core minimal (entity_ref_id, entity_kind, source_system, natural_key, authority_note); permission_policy_ref + snapshot_policy_ref = logical placeholder.
  • Phân loại: core resolve_in_WS1; permission/snapshot defer_post_pilot.

OD-FA6 — Directus boundary formalization

  • Mô tả: boundary G5 ban hành thành tài liệu chính thức ràng buộc session sau?
  • Options: (a) chốt ngay trong WS-1 brief làm boundary chính thức; (b) tách thành law/Điều.
  • Impact nếu defer: session sau dễ biến Directus thành authority.
  • Recommendation: (a) dùng G5 (file 2) làm boundary formal; nâng thành amendment Đ-liên-quan nếu User muốn (defer).
  • Phân loại: resolve_in_WS1; nâng cấp luật defer_WS4.

OD-FA7 — authority_semantics attach point

  • Mô tả: normative/evidence/implementation authority gắn ở đâu — IU core, source_family registry, hay assembly profile?
  • Options: (a) suy ra từ source_family (WS-2 registry); (b) field trên IU core; (c) chỉ ở assembly profile lúc lắp.
  • Impact nếu defer: ordering cross-family không authority-aware.
  • Recommendation: (a) suy ra từ source_family registry (không thêm field IU core — tôn trọng P38-XC UMC; không over-design).
  • Phân loại: resolve_in_WS1 (nguyên tắc); registry cụ thể defer_WS2.

OD-FA8 — assembly engine generic vs per-type

  • Mô tả: engine chạy assembly_profile là 1 generic executor hay nhiều executor.
  • Options: (a) 1 generic chạy pipeline P11D theo profile; (b) plugin per profile_type.
  • Impact nếu defer: WS-3 prototype không rõ hình.
  • Recommendation: (a) generic executor trên pipeline P11D §6.1 (Assembly First, no-hardcode).
  • Phân loại: defer_WS3 (prototype logical, không code nay).

B. Kế thừa từ v0.5 Master Plan §9 (vẫn mở, liên quan Fabric)

OD Tóm tắt Impact nếu defer Recommendation Phân loại
OD-G1 Source = Hiến pháp Kiến trúc nội bộ, KHÔNG phải HP 2013; xác nhận grammar profile (Nguyên tắc/Kiến trúc/Điều), không có Chương/Khoản/Điểm Cut sai grammar GPT/User rule trước Constitution dry-run defer_post_pilot (ngoài WS-1)
OD-G2 leaf-IU definition (Điều/sub-bullet/status-aware) Sai volume +15 invariant rule trước dry-run defer_post_pilot
OD-A1 canonical_address namespacing cross-document Collision địa chỉ document-scoped prefix defer_WS2 (gắn source profile)
OD-S1 KB-7294 rev44 đủ authority để cut? loại 📋 controlled draft Đ44? Cut bản chưa enacted enacted-only snapshot gate defer_post_pilot
OD-M1 manifest per-IU (+15) vs document-level Ảnh hưởng scale giữ per-IU tới khi đo defer_post_pilot
OD-L1..L5 label_assignment table vs ledger; metadata JSONB vs EAV; cardinality enforce; hot-key threshold; ownership schema Registry chưa concrete chuyển vào WS-2 design cycle defer_WS2
OD-P1 projection store + rebuild trigger Search chậm projection doc sau defer_post_pilot
OD-R1 forward-compensation record shape multi-IU Sửa nhiều IU lúng túng gắn WS-4 defer_WS4
OD-I1 index execution route tách sovereign cycle (Q1/Q2) defer_post_pilot

OD-V1 (dry-run fixture) thuần execution, ngoài phạm vi Fabric Addendum — giữ ở master plan.


C. Kế thừa từ P11D §9.1 (topic, liên quan WS-1/WS-3)

OD Tóm tắt Recommendation Phân loại
P11D-α Topic vocab table + governance + alias Gắn OD-FA3 option C; physical chờ P44-6+APR defer_post_pilot
P11D-β Topic source method chi tiết (manual/section_derived; agent/relation defer) WS-3 chỉ proof manual+section_derived defer_WS3
P11D-γ Topic confidence threshold số Pilot benchmark defer_post_pilot
P11D-δ Cross-publication alias resolution Gắn G4; full mechanism chờ APR defer_post_pilot
P11D-ε Topic lifecycle full transition + grace Đ4 amendment / P44-6 defer_post_pilot
P11D-ζ Q-T3 edge whitelist final (uses include?) + max hops Pilot benchmark; WS-3 dùng whitelist §5.3.1 tạm defer_WS3

D. Kế thừa P44-4A / 23-P1 / TD-P1 (relation & edit pipeline)

OD/Item Tóm tắt Recommendation Phân loại
P44-4A §3.3 extension Edge mới phải APR medium Gắn OD-FA4 defer_WS3
P44-4A reverse-index P1/P2/P3 Pattern per scale tier P44-5 + volume defer_post_pilot
23-P1 / 23-P2 Read-only inspection version_seq trước implement edit/merge WS-4 prerequisite defer_WS4
TD-P1 SPLIT/MERGE Pipeline metadata propagation sau flag WS-4 detailed design defer_WS4

E. Tổng hợp phân loại

  • resolve_in_WS1: OD-FA1(logical), OD-FA2, OD-FA3(logical), OD-FA5(core), OD-FA6, OD-FA7(nguyên tắc).
  • defer_WS2: OD-A1, OD-L1..L5, OD-FA7(registry).
  • defer_WS3: OD-FA4, OD-FA8, OD-FA1(physical), P11D-β, P11D-ζ.
  • defer_WS4: OD-R1, OD-FA6(luật), 23-P2, TD-P1.
  • defer_post_pilot: OD-G1, OD-G2, OD-S1, OD-M1, OD-P1, OD-I1, OD-FA2(physical), OD-FA3(physical), OD-FA5(permission/snapshot), P11D-α/γ/δ/ε, P44-4A reverse-index.

Conflict cần User/GPT quyết (không tự quyết): OD-FA4 (edge mới vs APR), OD-G1/OD-S1 (authority nguồn). Các điểm này flag rõ, KHÔNG self-resolve.

Back to Knowledge Hub knowledge/dev/laws/dieu44-trien-khai/v0.5-fabric-addendum-scope/dot-iu-cutter-v0.5-fabric-addendum-open-decisions-2026-05-18.md