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_profilemớ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, physicaldefer_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_bindingcho entity thô, G1 tiêu thụ cả hai. - Phân loại:
resolve_in_WS1(chốt option); physical bảngdefer_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_vocabchờ Pilot Tier 1 + duplicate-rate + APR Đ32 (đúng P11D-α). - Phân loại:
resolve_in_WS1(chốt C + contract); physicaldefer_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/snapshotdefer_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ậtdefer_WS4.
OD-FA7 — authority_semantics attach point
- Mô tả:
normative/evidence/implementation authoritygắ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.