Incomex AI Portal
KB-1666

Handoff S178 Fix 24 → Phiên sau

5 min read Revision 1
handoffs178-fix24law-amendmentdieu37dieu22health-checkssotnt14

Handoff S178 Fix 24 → Phiên sau

Phiên: S178 Fix 24 | Ngày: 2026-04-21 Trọng tâm: Sửa luật SSOT nội dung luật + hạ tầng health check thống nhất

ĐÃ LÀM

Hotfix sửa chui (6 items, không qua Council)

  • HF-1: HP NT12 +auto-scale 100% hệ thống
  • HF-2: HP NT13 → PG First · PG Native · PG Driven (3 chiều)
  • HF-3: Đ1 v3.0→v3.2 (trả nợ SSOT: 11→14 NT, +NT12+NT13+NT14 body)
  • HF-4: Đ4 §2.1 +phân trách nhiệm SSOT (Đ4 định nghĩa, Đ22 giám sát)
  • HF-5: HP +NT14 THỰC THI ĐƯỢC NGAY (6 câu hỏi bắt buộc trước ban hành)
  • HF-6: Đ1 v3.2 +NT14 body

Dự thảo sửa 5 luật — Council 2 vòng APPROVED (Gemini 9.8 + GPT 9.7)

  • Đ37 +§4.12 SSOT nội dung luật (6 bước chuyển giao, 4 tiêu chí luật gốc) + §4.13 Trang bị đủ công cụ + §4.14 Tham chiếu liên luật 2 mức (header + inline)
  • Đ22 +§4.3 bảng system_health_checks (FK jurisdiction, check_kind, generic executor) + §4.4 HC-TRIGGER (7 guards, auto-attach) + §5 bổ sung triết lý
  • Đ43 §5.8 chuyển giao ownership HC → Đ22, giữ rows H1-H11 jurisdiction='LAW-43'
  • Đ35 §8.1 chuyển giao H10-H14 → jurisdiction='LAW-35'
  • Đ36 +GP8.1 HC-REG (bảng chưa đăng ký) + HC-SCHEMA (governed thiếu cột description)

Soi NT14 — 3 phụ lục triển khai

Council soi NT14 phát hiện dự thảo FINAL đúng pháp lý nhưng thiếu implementation spec. Đã bổ sung:

  • Appendix A: HC-TRIGGER (SQL detect + pseudocode PL/pgSQL + config key + fail path 6 tình huống)
  • Appendix B: Migration parity (mapping 12 cột + SQL INSERT...SELECT + parity check + dual-read + cut-over rules)
  • Appendix C: Header reference (ví dụ mẫu Đ22 + 3 inline mẫu + rule coverage)

5 luật đã patch trên KB

File Rev Ai
Đ37 r2→r5 Desktop
Đ22 r2→r5 Desktop
Đ36 r2→r4 Desktop
Đ43 r41→r43 Agent
Đ35 r7→r9 Agent

PHIÊN SAU LÀM — Triển khai SQL + VPS

Ưu tiên 1 — Triển khai hạ tầng HC mới trên VPS

Theo thứ tự dự thảo §VI + phụ lục Appendix A+B:

Bước 1: CREATE TABLE system_health_checks trên DB directus (schema đầy đủ trong Đ22 §4.3)

  • FK jurisdiction → normative_registry.code — cần verify normative_registry đã có codes LAW-22, LAW-35, LAW-36, LAW-43

Bước 2: Migrate Đ43 rows — INSERT INTO system_health_checks SELECT ... FROM context_pack_health_checks (Appendix B2 có SQL đầy đủ)

Bước 3: Đ43 verify.sh dual-read — query cả 2 bảng 48h (Appendix B4 có bash script)

Bước 4: Migrate Đ35 H10-H14 — INSERT rows jurisdiction='LAW-35'

Bước 5: INSERT HC-REG + HC-SCHEMA — jurisdiction='LAW-36' (Đ36 GP8.1 có seed SQL)

Bước 6: INSERT HC-TRIGGER — jurisdiction='LAW-22' (Đ22 §4.4 có seed SQL)

Bước 7: Seed dot_config key hc_trigger_autofix_enabled = 'false' (Appendix A3)

Bước 8: Upload 3 SQL query files vào KB path whitelist:

  • knowledge/current-state/queries/hc-trigger-enforcement-gap.sql
  • knowledge/current-state/queries/hc-reg-unregistered-tables.sql
  • knowledge/current-state/queries/hc-schema-missing-description-column.sql

Bước 9: Chạy HC lần đầu — 3 HC mới detect → verify kết quả → nếu OK, chuyển hc_trigger_autofix_enabled = 'true'

Bước 10: Parity check (Appendix B3) → nếu PASS → sau 48h DROP context_pack_health_checks

Ưu tiên 2 — Quay lại roadmap Đ43 Phase C

Sau khi hạ tầng HC ổn → quay lại bước 7 Phase C (backfill description):

  • C1: Nới max_size 2 section
  • C2: Backfill description 1314 entity → MỤC TIÊU 2
  • C3: Project Identity trang bìa
  • C4: Architecture Annotation 4 layer

TÀI LIỆU THAM CHIẾU

Tài liệu Path KB
Dự thảo FINAL (rev 6) reports/du-thao-sua-luat-ssot-noi-dung-luat-hc-ha-tang-fix24.md
Phụ lục triển khai (Appendix A+B+C) reports/phu-luc-trien-khai-du-thao-ssot-hc-fix24.md
Council R1 prompt prompts/council-prompt-ssot-hc-fix24-round1.md
Council R2 prompt prompts/council-prompt-ssot-hc-fix24-round2.md
Đ22 v1.2 (mới sửa) laws/law-22-self-healing.md
Đ37 (mới sửa) laws/dieu37-governance-organization-law.md

NGUYÊN TẮC GHI NHỚ

  • 14 NT — HP giờ có 14 nguyên tắc (NT14: THỰC THI ĐƯỢC NGAY)
  • Luật = Spec triển khai — agent cầm luật phải code được không hỏi lại (NT14)
  • Tham chiếu 2 mức — đầu luật (header block) + tại chỗ dùng (inline) (Đ37 §4.14)
  • 1 nội dung = 1 luật — chồng chéo → chuyển giao (Đ37 §4.12)
  • HC thuộc Đ22 — system_health_checks là bảng chung, luật khác chỉ INSERT rows
  • Phụ lục triển khai — đọc cả dự thảo + phụ lục trước khi code