Handoff S178 Fix 12 FINAL — Đ43 v1.2 rev 4 + Phase 4a P1+P2 PASS
HANDOFF S178 Fix 12 FINAL → Phiên sau
Phiên hiện tại: 2026-04-17 S178 Fix 12 Luật hiện hành: Đ43 v1.2 FINAL rev 6 + HP v4.6.2
§0. TÓM TẮT 1 CÂU
Đ43 v1.2 rev 6 BAN HÀNH. Hạ tầng PG + KB kho template đầy đủ. Migration 08 (target_db) PASS. Agent đang install chevron (Việc 2). Sau Việc 2 → Stage D' generic renderer.
§1. TRẠNG THÁI TRIỂN KHAI
| Phase | Kết quả |
|---|---|
| 1 SQL schema | ✅ PASS |
| 2 FS init (3 siblings) | ✅ PASS |
Q2 user incomex UID 1001 |
✅ PASS |
| 3 KB README | ✅ DONE |
| 1.5 Hạ tầng v1.2 (dot_config + section_defs + health_checks + role + FDW) | ✅ PASS 7/7 |
| 1.6 Hoàn thiện (ALTER CHECK + schema migrate + FDW cache 24x) | ✅ PASS 6/6 |
| 4a P1+P2 Skeleton + Bước 1-4 | ✅ PASS 3 stage A/B/C (567 dòng) |
| Pre-D' Task 1 (thiết kế 8 template + 7 SQL) | ✅ PASS |
| Pre-D' Task 2 (upload 15 KB + UPDATE 8 row PG) | ✅ PASS |
| Migration 08 target_db rev 6 | ✅ PASS 4/4 test |
| Install chevron (Việc 2) | 🟡 AGENT ĐANG LÀM |
| Stage D' Generic renderer | ⏸️ Chờ chevron |
| Stage E 2 checksum | ⏸️ |
| P4 Bước 7-8 publish + repair | ⏸️ |
| Phase 4b verify.sh | ⏸️ |
| Phase 5-8 register+cron+trigger+first run | ⏸️ |
Tiến độ build.sh: 567 dòng, 4/8 bước, ~47%.
§2. QUYẾT ĐỊNH KỸ THUẬT QUAN TRỌNG
§2.1 — Đ43 v1.2 rev 6 (BAN HÀNH)
| Rev | Nội dung |
|---|---|
| rev 2 | P10 GRANT DEFAULT PRIVILEGES + P11 Trigger runtime |
| rev 3 | Separator /→__ khớp PG reality |
| rev 4 | CẤM built-in renderer fallback + CẤM case-dispatch per-section |
| rev 5 | Volatile header wording exact + strip rule cho logical_checksum |
| rev 6 | Cột target_db §5.7 — multi-DB dispatch (NT1/NT8/NT11). CẤM hardcode DB trong code, CẤM magic comment SQL body. |
Bài học rev 4: Lỗ hổng nằm ở chỗ luật KHÔNG NÓI GÌ (template NULL xử lý thế nào) — nguy hiểm hơn chỗ nói sai. Rà luật phải săn cả chỗ im lặng.
§2.2 — Generic renderer pattern (cốt lõi Phase 4a D')
Giống §5.8 health_checks generic executor. Thêm section = INSERT row PG + upload 2 KB file. 0 sửa code vĩnh viễn. Tham chiếu pattern này khi code Stage D'.
§2.3 — Volatile header format (Đ43 chưa ghi rõ)
Pre-D' phải kiểm tra luật có định nghĩa chưa. Nếu chưa → DỪNG báo Desktop amend rev 5 trước khi code.
Format đề xuất (chờ duyệt):
- md/mermaid:
<!-- VOLATILE HEADER -->...<!-- /VOLATILE HEADER --> - json: key
_volatile_header
§2.4 — FDW cache (Phase 1.6)
Local cache table + bidirectional sync. 24x speedup (4.9→0.20 ms/insert). P11 compliance: UPDATE dot_config → propagate zero-latency same-TX.
§2.5 — Kiến trúc 4 DB (HP S176 — ĐỌC KỸ)
| DB | Lớp | Gateway |
|---|---|---|
directus |
KHO | psql role directus |
incomex_metadata |
KHO | Agent Data FastAPI (KHÔNG ghi trực tiếp DB) |
postgres |
— | admin only |
workflow |
ENGINE | chưa active |
Lớp NÃO = Agent Data FastAPI (ứng dụng), không phải DB.
§3. FILES QUAN TRỌNG
| Path | Rev/Status |
|---|---|
dieu43-system-context-law.md |
rev 6 (KB rev 35) |
constitution.md |
rev 23 (HP v4.6.2) |
dieu43-phu-luc-ban-do-he-thong.md |
rev 7 |
/opt/incomex/dot/bin/dot-context-pack-build.sh |
567 dòng, 4/8 bước |
dieu43-migrations/08-dieu43-v1-2-rev6-target-db.sql |
rev 1 PASS |
dieu43-migrations/report-pre-d-prime-task2.md |
rev 1 |
KB templates: 8 file knowledge__current-state__templates__* |
rev 1 |
KB queries: 7 file knowledge__current-state__queries__* |
rev 1 |
§4. TD ĐANG MỞ
| TD | Mô tả | Ưu tiên |
|---|---|---|
| TD-S178-12 | fn_log_issue stub |
🟡 Sau Đ35 BLOCK 4 |
| TD-S178-14 | .env.production missing (dùng trust auth Unix socket) |
🟡 |
| TD-S178-17 | vps_deploy_log trống → git_commit=unknown tier 5 |
🟡 |
| TD-S178-19 | Khi S170 PA5 duyệt: đảo __→/ cho 3 CHECK + §5.9 |
🟢 Backlog |
| TD-S178-20 | 🟡 | |
| TD-S178-21 | Git commit 5-tier fallback wording §15.3 | 🟢 |
| TD-S178-22 | ✅ ĐÓNG |
§5. VIỆC TIẾP THEO (thứ tự)
- Chờ agent xong Việc 2 (install chevron) → duyệt evidence
- Stage D' — Generic renderer dispatcher trong build.sh (~150 dòng). Đọc
section_definitions→ load template KB → load SQL KB → connecttarget_db→ render mustache via chevron → write file. 1 bộ máy vạn năng, 0 per-section code. - Stage E — 2 checksum (logical strip volatile + file raw). 2 test cốt tử: idempotent + sensitivity.
- P4 — Bước 7-8 publish + repair (critical nhất, chia stage tiếp)
- Phase 4b — verify.sh cặp NT12
- Phase 5-8 — register DOT + cron + trigger + first run → Đ43 sống chính thức
§6. MEMORY QUAN TRỌNG
| # | Nội dung |
|---|---|
| #14 | P0→P5 pattern, Desktop gate mỗi step |
| #25 | Prompt mục tiêu mở |
| #26 | PG user VPS = directus, SSH alias = contabo |
| #29 | Rà NT 3 tầng (code/DDL/data) |
| #30 | Điều hành: bác vi phạm HP NGAY, không đưa lên user quyết |
§7. NGUYÊN TẮC ĐIỀU HÀNH (quan trọng cho Desktop phiên sau)
- Bác vi phạm HP ngay — không đưa lên user chọn
- Luật trước hành động — đọc luật trước khi code
- Bàn trước làm sau — không soạn prompt khi chưa bàn xong
- Phản hồi ngắn + hình tượng — user non-IT, tiết kiệm token
- Chia nhỏ stage — rủi ro cao = báo cáo môi trường trước khi code
- Lỗ hổng luật = im lặng nguy hiểm — rà cả chỗ không nói gì
- Đọc ngữ cảnh trước khi hành động — agent đang trong phiên thì KHÔNG soạn prompt mới. Chỉ gõ lệnh duyệt/tiếp. Soạn prompt thừa = tốn token + gây lẫn agent.
Handoff Fix 12 rev 8 | 2026-04-17 | Đ43 v1.2 rev 6 | Phase 4a ~47% | Agent đang install chevron → Stage D' generic renderer kế tiếp