KB-1672 rev 2

Handoff S178 Fix 18 → Phiên sau

4 min read Revision 2

HANDOFF S178 Fix 18 → Phiên sau

MỤC TIÊU TỔNG THỂ — Điều 43 trọn vẹn

# Mục tiêu Status
1 Khai sinh Đ41/Đ43 vào normative_registry ✅ DONE Fix 18
2 Rà description cho đủ (1277 row thiếu) ⏳ Phase C
3 AI mới đọc Đ43 là hiểu (test agent lạ ≥80%) ⏳ Phase D

ĐÃ XONG (Fix 18)

# Việc
1 M3 nhẹ: 4 triggers DDL (quorum, rename block, overdue scan, unimplemented block)
2 Retroactive APR id=1,3,4 — 3 fallback Fix 16+17 (APR-0201/0202/0203)
3 Enact 7 luật: HP v4.6.3, Đ22 v1.1, Đ32 v1.1, Đ33 v2.1, Đ35 v5.2, Đ41 v1.1, Đ43 v1.2
4 Retroactive APR id=5 — fallback khi enact (APR-0211)
5 Retire old NRM-CON-HP v4.6.2 — chỉ 1 HP enacted
6 Fix schema: DROP old UNIQUE article_number (migration oversight S157)
7 Fix drift: NRM-LAW-33 enacted_at=NULL
8 OR soạn luật v1.1: §VIII amend convention + code naming
9 Audit trail: law_version_verification_log id=2 (drift) + id=3 (match)

ROADMAP PHIÊN SAU — theo thứ tự

4. M3 nặng — DOT scripts (NHIỀU PROMPT)

  • 2 DOT APR cập nhật: dot-apr-propose + dot-apr-execute đọc cột code mới (thay JSONB cũ)
  • 3 DOT cặp mới (6 scripts): flow fix_repair_dot (Đ35 v5.2 §6)
  • Tổng: 8 scripts = viết code, test, deploy
  • Spec: knowledge/dev/laws/dieu35-dot-governance-law.md §6 + gói spec knowledge/dev/laws/patch-dot-repair-governance-s178-fix15.md §II P3

5. M4 — Scanner detect-only (/effort low)

  • P4 gói spec: quét silent-fail annotation markers
  • 1 prompt

6. M5 — Context pack regenerate (/effort low)

  • Section ops_code_inventory mới (P11 gói spec)
  • 1 prompt

7. Phase C — Hoàn thiện Đ43 content

  • C1: Nới max_size_bytes section project_map (hiện 22KB > 20KB max)
  • C2: Backfill description 1277 row thiếu → MỤC TIÊU 2
  • C3: Project Identity trang bìa (5-7 dòng mô tả Incomex)
  • C4: Architecture Annotation 4 layer
  • C7: Section ops_code_inventory verify

8. Phase D — Test agent lạ → MỤC TIÊU 3

  • CLI mới đọc context pack, mô tả lại hệ thống ≥80%

9. Phase E — Bảo vệ

  • E1: Test chống agent phá (4 lớp)
  • E2: Verify Đ39 shadow trigger binding

LƯU Ý GHI NHỚ

Enforcement gap (cần xử lý trước khi enact luật kế tiếp)

  • law_dot_enforcement trống cho 7 luật vừa enact
  • Trigger nrm_enacted_must_have_enforcement đã bật lại → sẽ CHẶN enact luật kế tiếp nếu không seed enforcement
  • Fix 18 tạm disable/re-enable, ghi admin_fallback_log id=5

4 old superseded rows chưa retire

  • NRM-LAW-22, NRM-LAW-32, NRM-LAW-33, NRM-LAW-35 vẫn status='enacted' + superseded_by trỏ bản mới
  • Không blocking nhưng nên retire dọn sạch khi tiện

Convention mới — Amend code naming

  • {BASE_CODE}-V{MAJOR}P{MINOR} (VD: NRM-LAW-22-V1P1)
  • Chi tiết: knowledge/dev/ssot/operating-rules-law-drafting.md §VIII v1.1

HẠ TẦNG GHI NHỚ

  • DB governance: directus (KHÔNG phải incomex_metadata)
  • POSTGRES_USER: directus (KHÔNG phải postgres)
  • Container: docker exec postgres psql -U directus -d directus
  • Alias SSH: contabo (key ~/.ssh/contabo_vps)
  • KB đọc qua: dot-knowledge-search (đã fix auth header Fix 17)
  • Gói spec: knowledge/dev/laws/patch-dot-repair-governance-s178-fix15.md
  • Đ35 v5.2: knowledge/dev/laws/dieu35-dot-governance-law.md
  • Đ43 v1.2: knowledge/dev/laws/dieu43-system-context-law.md
  • dot-nrm-enact backup: /opt/incomex/dot/bin/.backup-s178-fix16/

NGUYÊN TẮC

  • Theo đúng luật. Thiếu → bổ sung luật. Không sáng tác.
  • Ủi thẳng. Vướng đâu fix đó.
  • Prompt mục tiêu mở. Agent tự quyết cách làm.
  • Mỗi lần soạn 1 prompt DUY NHẤT cho agent.