Incomex AI Portal
KB-6015

Đ43 v1.1 FINAL BACKUP (superseded by v1.2)

5 min read Revision 1
lawdieu43v1.1backupsupersededhistory

ĐIỀU 43 — LUẬT BẢN ĐỒ HỆ THỐNG — v1.1 FINAL (BACKUP)

⚠️ BACKUP FILE — KHÔNG PHẢI LUẬT HIỆN HÀNH Luật hiện hành: dieu43-system-context-law.md = v1.2 FINAL (ban hành 2026-04-17 S178 Fix 11) File này: Backup nội dung v1.1 FINAL (ban hành 2026-04-16 S178 Fix 8, đã được v1.2 thay thế) Mục đích backup: Giữ trace lịch sử Council R1 + R2 của v1.1 để đối chiếu + audit nếu cần. KHÔNG viện dẫn file này như luật hiện hành.

§1. MỤC TIÊU (v1.1)

Đ43 v1.1 giải bệnh "AI/agent mất nhiều giờ mới hiểu kiến trúc Incomex mỗi phiên mới". Fix 7+Fix 8 Desktop mất >24h để rà lại 4 Root Cause + Timeline 7 bước — đáng lẽ AI đọc 30 giây là hiểu toàn cảnh.

Luật này quy định cơ chế sinh Context Pack tự động để AI/agent/người đều có bản đồ hệ thống sống.

5 mục tiêu MT1-MT5:

  • MT1: Tổng cảnh 30s qua PROJECT_MAP.md ≤ 15KB target / 20KB trần
  • MT2: Sống theo hệ thống (tự regenerate khi PG/DOT/luật/entity đổi)
  • MT3: 3 lớp Code + System + Meta-Incomex
  • MT4: Không lạc lối (red zones)
  • MT5: Xem được bằng mắt thường (Mermaid SVG)

§2. PHẠM VI (v1.1)

Áp: /opt/incomex/, 3 PG DBs (directus/incomex_metadata/workflow), KB documents, DOT registry, birth registry, meta catalog, system infrastructure. KHÔNG áp: secret values (chỉ map tồn tại), user data (chỉ đếm), file media (chỉ stat).

§3. 13 NT + §3.1 Clause Vận hành AI (v1.1)

Kế thừa 13 NT HP v4.6.0 (không amend). Mọi AI/agent phiên mới task hệ thống BẮT BUỘC đọc PROJECT_MAP.md trước hành động. 3 mức enforce A/B/C.

§4. BẢN ĐỒ 3 LỚP META-INCOMEX (v1.1)

Lớp 3 Meta-Incomex (40+ luật, 272 DOT, 17K entity) — TRÁI TIM Đ43. Lớp 2 System (Nuxt, Directus, Agent Data, 3 PG DB). Lớp 1 Code (.ts/.py/.sql import graph).

§5. SCHEMA PG (v1.1)

  • §5.1 context_trigger_sources — 6 rows enum
  • §5.2 context_pack_requests — queue chống storm, unique partial index
  • §5.3 context_pack_manifest — 2 checksum (logical + file), publish_step, section_count CHECK=8 (★ v1.2 P1 đã sửa)
  • §5.4 context_pack_sections — CHECK enum 8 section_name (★ v1.2 P3 đổi FK)
  • §5.5 View v_context_pack_latest
  • §5.6 Seed dot_operations 2 ops

§6. 8 BƯỚC QUY TRÌNH (v1.1)

  1. PRECHECK + git_commit fallback 5 tầng
  2. TRY-LOCK pg_try_advisory_lock(43,1)
  3. QUERY PG (laws/DOT/entities/DBs hardcode 3/species) — ★ v1.2 chuyển config
  4. SCAN FS (4 folder hardcode) — ★ v1.2 chuyển config
  5. GENERATE + 2 checksum
  6. VALIDATE + logical compare skip
  7. 2-PHASE PUBLISH (7a-7g) + repair mode
  8. RELEASE + LOG

§7. OUTPUT FILES (v1.1)

8 section cứng trong luật: PROJECT_MAP.md, LAWS_INDEX.md, DOT_REGISTRY.md, ENTITIES_OVERVIEW.md, DB_MAP.md, RED_ZONES.md, ARCHITECTURE.mmd, project-map.json (★ v1.2 chuyển reference table).

§8. DOT GOVERNANCE (v1.1)

  • §8.1 dot-context-pack-build Tier B, cron 0 */3 * * *, secondary triggers
  • §8.2 dot-context-pack-verify Tier A, cron 30 */3 * * *

§9. HEALTH CHECKS H1-H9 (v1.1)

Enum cứng 9 checks trong luật (★ v1.2 chuyển reference table generic executor).

§10. GRACE PERIOD (v1.1)

7 ngày cứng (★ v1.2 chuyển config).

§11. BOOTSTRAP 14 BƯỚC (v1.1)

Triển khai 1 lần khi enact.

§12-§16 (v1.1)

Success metrics + AP-24 + Retrofit clause + Phụ lục + Liên kết luật khác. Giữ nguyên.

§17 CHANGELOG (v1.1)

Version Ngày Thay đổi
v1.0 DRAFT 2026-04-16 sáng Soạn lần đầu
v1.0 DRAFT patch 2026-04-16 trưa §3 thêm NT12+NT13
v1.1 DRAFT 2026-04-16 chiều 14 patches Council R1 (Gemini 8.2 + GPT 7.8)
v1.1 FINAL 2026-04-16 chiều BAN HÀNH. 4 patches Council R2 inline

LÝ DO BỊ THAY THẾ BỞI v1.2 (2026-04-17)

Phiên S178 Fix 11 Phase 4a rà soát phát hiện 16 điểm vi phạm HP v4.6.1 (NT2/NT4/NT11) do v1.1 có nhiều điểm hardcode (số DB=3, 4 folder scan, law pattern %/laws/%, CHECK enum 8 section, 9 health check, grace 7 ngày, output path). Mở rộng hệ thống = sửa code = vi phạm tự động 100%.

v1.2 amend thuần kỹ thuật (giữ 100% triết lý v1.1) — chuyển mọi hardcode thành:

  • Reference tables PG: context_pack_section_definitions, context_pack_health_checks
  • dot_config keys: 7 keys cho paths/whitelist/patterns/retry/output_root/grace/mode
  • Generic executor pattern cho health checks (builtin/sql/function)

Council 2 vòng approve: R1 (Gemini 9.5 MINOR + GPT 6.9 CHANGES → apply 7 patches), R2 (Gemini 10 FINAL + GPT 8.8 MINOR → apply 2 guard security inline).

Đ43 v1.1 FINAL BACKUP | Ban hành 2026-04-16 → Superseded 2026-04-17 bởi v1.2 FINAL Giữ trace lịch sử, KHÔNG viện dẫn làm luật hiện hành.