Opus Review — Birth Pipeline Inventory Reconciliation

Date: 2026-05-05 | Reviewer: Opus 4.6 Source: knowledge/dev/laws/dieu44-trien-khai/reports/p2b-inv-birth-pipeline-inventory-report.md For: GPT/User quyết định thứ tự việc tiếp theo

---

1. P2B-INV Report Verdict

PASS — toàn diện, read-only, trả lời đủ 8 câu hỏi.

Một gap nhỏ: Agent không verify binary existence cho DOT_KG_ORPHAN và DOT-TAC-BIRTH-VERIFY ngoài /opt/incomex/dot/bin/ (có thể ở subdir khác). Không cần prompt bổ sung — ghi TD, kiểm khi cần.

---

2. Reconcile — Triết lý User vs Runtime

Kênh chính (Main/Canonical)

Triết lý User	Runtime thực tế	Khớp?
Mỗi entity khai sinh phải có birth record	PG trigger fn_birth_registry_auto × 157 instances → auto-write birth row SAU INSERT	✅ Khớp
Birth-first (entity không tồn tại nếu chưa khai sinh)	Thực tế là birth-AFTER: trigger fire SAU INSERT, không phải TRƯỚC. fn_birth_gate (16 tables) là BEFORE gate nhưng chỉ check prerequisites, không tạo birth row	⚠️ Lệch nhẹ — nhưng safety-belt đủ mạnh

Nôm na: Hộ khẩu được cấp TỰ ĐỘNG ngay sau khi em bé sinh ra (trigger AFTER INSERT). Không phải "phải có hộ khẩu trước khi sinh" — mà là "sinh ra là có hộ khẩu ngay". Hiệu quả tương đương.

Safety-belt trigger

Triết lý	Runtime	Khớp?
Dây an toàn — không thể quên khai sinh	162 triggers trên ~78+ collections	✅
Metadata-driven, không hardcode	DOT-119 v2 đã metadata-driven (31 triggers mới). 131 triggers cũ pattern birth_trigger_* vẫn active	⚠️ Dual pattern — hoạt động nhưng chưa migrate hết

Động cơ phụ / Backfill

Triết lý	Runtime	Khớp?
Có cơ chế backfill cho entities đã tồn tại trước birth system	dot-birth-backfill (DOT-118) v1.0.0	✅
Backfill có cron tự động	KHÔNG có cron — chạy thủ công	❌ Gap
Warning khi backfill chạy	KHÔNG có warning trực tiếp — chỉ gián tiếp qua fn_registry_health gap thay đổi	❌ Gap

Orphan detector

Triết lý	Runtime	Khớp?
Phát hiện entity không có birth record	4 mechanisms runtime-active	✅ Thừa
Birth-aware (đếm 2 nơi)	fn_registry_health() status=ORPHAN	✅

Ghost detector

Triết lý	Runtime	Khớp?
Phát hiện birth record không có entity	fn_registry_health() status=PHANTOM	✅
Hiện có 13 collections PHANTOM	Tồn tại, chưa có cảnh báo tự động	⚠️ Signal có, alert thiếu

---

3. Phân loại rõ ràng

Đã có và runtime-active

• 162 PG birth triggers (2 patterns song song)
• fn_birth_registry_auto + variant _auto_id
• fn_birth_gate × 16 + IU gates + TAC gates
• fn_birth_auto_certify trigger
• fn_registry_health() (orphan + ghost)
• fn_refresh_orphan_* (cron */10 phút)
• dot-birth-backfill (manual), dot-birth-trigger-setup v2, dot-inspect-pen
• 4 orphan scanners (DOT-095, 115, 317, refresh)
• dot-trigger-guard (DOT-316)

Chỉ có trong docs/design — chưa runtime

• QT-002 wrapper tool (policy name, không có binary)
• fn_birth_first() (nêu trong doc, không tồn tại trong PG)
• dot-iu-create (đề xuất, chưa có file)
• Phase B/C inspectors: dot-inspect-stamp, dot-inspect-gate, dot-certify-scan, dot-birth-orphan-scan
• system_health_checks rows cho birth gap
• dot_config keys cho birth policy

Docs stale (lệch runtime)

• Trigger count: doc nói 31, runtime = 162
• birth_registry schema: doc nói 18 cols, runtime = 19 (thiếu status)
• birth-process-v1.md mô tả QT-002 wrapper chưa tồn tại
• Đ0-G liệt kê tools Phase B/C chưa tạo

Hardcode legacy cần refactor (TD)

• dot-pg-triggers-ensure: 16 atom collections hardcoded
• dot-orphan-scanner (DOT-115): governance scope hardcoded
• dot-orphan-scan (DOT-095): source list hardcoded
• Duplicate DOT registrations: DOT-118 + DOT_BIRTH_BACKFILL, DOT-119 + DOT_BIRTH_TRIGGER_SETUP

---

4. Tuyên bố rõ

Không redesign birth process. Pipeline hiện tại HOẠT ĐỘNG — 76.004 birth rows, 78 collections covered, safety-belt trigger active trên 162 instances. Các lệch/gap là bug/TD dưới quy trình hiện có, không phải thiếu kiến trúc.

---

5. Đề xuất thứ tự việc tiếp

Ưu tiên	Việc	Loại	Lý do
1	Patch stale docs: trigger count 162, birth_registry 19 cols	Doc fix	Docs sai = quyết định sai. Nhanh, rủi ro thấp.
2	Thiết kế dot-iu-create wrapper dưới existing pipeline	Design → implement	Đây là mục tiêu Đ44 Pack 2B. IU birth trigger đã active (DOT-119). Wrapper chỉ cần orchestrate: validate → INSERT IU → trigger auto-fires → verify birth row.
3	Health check cho fn_registry_health gap	Implement	Thêm system_health_checks row + cron emit warning khi ORPHAN/PHANTOM gap vượt ngưỡng. Không redesign — chỉ nối signal đã có vào alert system đã có.
4	Duplicate DOT registration cleanup	Registry fix	2 records/1 file × 2 tools. Nhanh, rủi ro thấp.
5	Verify ghost binaries (DOT_KG_ORPHAN, DOT-TAC-BIRTH-VERIFY)	Investigation	Registry entry không có binary = ghost hoặc mislocated.

Khuyến nghị: Bắt đầu từ việc 2 (dot-iu-create design) vì đó là mục tiêu chính Đ44. Việc 1 (doc fix) có thể gộp vào commit cùng. Việc 3-5 là TD, không block IU pipeline.

---

Opus Reconciliation | 2026-05-05 | Birth pipeline inventory reviewed. No redesign. Ready for dot-iu-create design.