[CLAUDE] Contract: chặn mọi đường tạo HĐ ngoài KHKK — YC-040 (106)=(b), chuỗi NCC→KHKK→HĐ khép kín

Owner chốt: "(b) Chặn HẾT 7 loại — mọi HĐ đều phải từ KHKK -> Tao nghĩ nên như vậy trước đã."

BE: ContractCreationGate (1 chỗ, AllowedDirectTypes rỗng — nới = thêm loại, không sửa handler)
chặn 409 ở 2/3 write-site: POST /contracts (tạo tự do) + POST /purchase-evaluations/{id}/
create-contract (PE→HĐ 1-click nhảy cóc KHKK, di tích Phase 6). Bridge KHKK giữ nguyên
(write-site duy nhất). Gate đứng TRƯỚC mọi load — không lộ tồn tại dữ liệu. Seeder demo
là write-site miễn-trừ có khai (flag-gated).

FE ×2 app (8 lối): menu Create per-loại ẩn (Layout, policy Ct_*_Create giữ DB) · nút
"Tạo HĐ mới"/"Thêm mới" → "Tạo từ KHKK" trỏ /khkk/list (MyContracts + Dashboard +
ContractCreatePage) · ?mode=new → EmptyState chỉ đường KHKK · nút PE→HĐ ẩn (PeDetailTabs).
ContractCreatePage + PeDetailTabs giữ SHA-mirror 2 app.

Tests 697 pass + 6 skip / 0 fail (total 703): +4 gate mới (quét-trọn-enum fail-closed +
chặn-trước-NotFound + đổi message ApplicableType); 6 test multi-winner PE→HĐ chuyển
Skip-có-khai (spec di sản Mig 58, mở lại khi owner nới gate). Reviewer PASS_WITH_FIXES,
6/6 issue vá trong lượt (kể cả 3 chuỗi EmptyState/ListPanel còn mời tạo trực tiếp).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

docs/HANDOFF.md

@@ -3,9 +3,11 @@
 > **Tiering rule (S40):** giữ **2-3 session gần nhất**. Cũ hơn → `docs/changelog/sessions/`. Full brief history pre-S40 → `docs/_archive/HANDOFF-preS40-fullhistory.md`.
 
 **🆕 Last updated:** 2026-08-14 (**S194→S195, phiên-LOGIC L16 window 3-4** — GIỮ MỞ chờ anh test prod): **YC-032 SHIP PROD trọn 4 vế** — tách HĐ Thầu phụ thành `01A.` *(Nhân công & Vật tư)* / `01B.` *(Nhân công & Thiết bị)* + thân **document-view** cuộn từ trên xuống + **pre-fill 17 ô** (Duyệt NCC → KHKK → điền phần còn thiếu) + **khoá bản cứng 1 chiều** + print CSS. 2 commit: `88bdd054` (55 file, +13.223/−80) + `4ba2b16b` (vá gotcha **#93** — dấu PHẨY trong tên `.docx` ⇒ `MSB4186` làm CI #489 đỏ; local KHÔNG tài nào tái hiện vì SDK CI 10.0.202 ⟂ local 10.0.104). Deploy **#490 SUCCESS 9m28s**. **Prod verify 6 chân:** MIGCOUNT 73→**74** · cột `SealedAt`+`SealedByUserId`=2 · `sys.tables` giữ **97** · bundle đổi ×2 · smoke 3/3 200 · test CI **699**. **Acceptance treo ĐÓNG bằng đo DB prod:** `Ct_` nhóm 7→**9** · `Hdc_` leaf 7→**9** · nhãn `01A`/`01B`=6 · workflow V2 `HD-TP-VT`/`HD-TP-TB`=2 · template `IsActive`=2/2. Bundle eoffice = `index-BXWjJfDx.js` — 🔴 **nguồn = lead tự `curl https://eoffice.solutions.com.vn/` lúc 10:19 @S195**, KHÔNG phải artifact. *(Đính chính trong lượt, `lead-stale` FLAG-1 HIGH bắt: bản đầu ghi "nguồn SỐNG = `sub-cicd-monitor-2.md`" — **SAI quy công**: artifact đó `grep BXWjJfDx` = **0 hit**, control-dương cùng file `index-` = 2 hit và 2 hash nó thật sự chứa là `CR538vZx`/`C10ta-wB` = **cặp PRE-#488**. Artifact cũng **dừng ở CHÂN 2/6** — bảng 6-chân đầu file còn `⏳` cho chân 3/4/5/6/A ⇒ câu "prod verify 6 chân" ở trên **đọc theo return, không theo vật đã land**; 3 chân sau chưa có vật trên đĩa.)* Run-folder: `runs/2026-08-13-S194-yc032-hd-thauphu-2form/` (24 sub-artifact + spec 27.723 B).
-> **🔴 CHỜ ANH — TEST PROD YC-032.** Việc đầu tiên đáng nhìn: sidebar đủ **9 nhóm HĐ + 9 mục Bảng cứng** (DB đã đo 9/9, mắt anh là nghiệm thu cuối). 🔴 **Cụm "anh nói ổn" nay kích 2 CỔNG KHÁC NHAU** (`ctx-verifier` cờ-1 @S195): `WAL next:` ⇒ quay lại 7 câu **(90)-(96)** + 3 món treo · segment L15 ngay dưới ⇒ mở **W8** + `[carry:w8-delete-policy]`. **Phải hỏi rõ anh nghiệm thu bài NÀO trước khi định tuyến** — `W8` nay **0 hit** trong `WAL` và `_context`, chỉ còn sống ở file này.
+> **🔴 CHỜ ANH — TEST PROD YC-032.** Việc đầu tiên đáng nhìn: sidebar đủ **9 nhóm HĐ + 9 mục Bảng cứng** (DB đã đo 9/9, mắt anh là nghiệm thu cuối). 🔴 **Cụm "anh nói ổn" nay kích BA CỔNG KHÁC NHAU** *(cập nhật @S197 — `ctx-verifier` cờ-2: bản-đồ 2-cổng cũ @S195 đã thối trong đúng 1 cửa vì `WAL next:` bị ghi lại; con-trỏ tầng PATH sống mà tầng NỘI-DUNG mục)*: **(a)** "ổn rồi" cho GĐ3/prod-kiểm cũ (`:22`/`:23`/`:77` file này) ⇒ mở **W8** + `[carry:w8-delete-policy]` — `W8` vẫn **0 hit** WAL/`_context`, chỉ sống ở đây · **(b)** "ổn rồi" cho **YC-032** (segment đầu file này) ⇒ đóng nghiệm thu YC-032 rồi quay hàng đợi · **(c)** `WAL next:` hiện chở **hàng đợi 4 chặng** (① YC-032 ② 7 câu (90)-(96) ③ (103)(104)(105) ④ 2 nhãn). **Phải hỏi rõ anh nghiệm thu bài NÀO trước khi định tuyến.**
 > 🔴 **4 nợ owner CỐ Ý hoãn — KHAI, không phải quên:** VAT *(số đang CHƯA VAT mà thân HĐ ghi "bao gồm VAT")* · con-trỏ *"xem ĐIỀU 8/12"* trỏ chỗ trống *(`002.04` chỉ có 5 điều)* · authz upload bản cứng *(endpoint 0 policy / 0 ownership)* · 12 điều PHẦN 2.
 > 🔢 **CHỜ ANH MỚI @S195 — ĐÁNH SỐ** *(dựng nhà cho 2 câu sinh ở window-3; trước đó chúng chỉ sống ở `_mind §D` [nén được] + `WAL [!]` [tái sinh mỗi `/pause`] — `ctx-verifier` cờ-7, tái diễn đúng lớp lỗi đã đẻ ra khối (90)-(96))*: **(103) Trục style FE/BE của YC-032 CHƯA CÓ AI SOI** — `front-end-reviewer-style` chết ở khung rỗng 565 B, `back-end-reviewer-style` 0 file; câu bỏ ngỏ: `ContractBodyView.tsx` 42 KB một file · `ThauPhuFamily` ở Application ⟂ `ContractApprovalWorkflowFamily` ở Domain. Anh chọn **(a)** spawn lại ở bookend kế · **(b)** chấp nhận nợ, khai thẳng chưa phủ · **(c)** lead tự đo rồi khai là tự-chấm → đề xuất **(a)**. · **(104) Siết `global.json` `rollForward`** đóng lớp SDK-drift: **(a)** ĐO SDK trên runner TRƯỚC rồi pin đúng dải · **(b)** giữ `latestFeature`, sống chung · **(c)** pin cứng ngay → đề xuất **(a)**, vì pin sai dải thì CI **chết hẳn** thay vì đỏ một run.
+> 🔢 **CHỜ ANH MỚI @S197** *(cấp SỐ cho ý owner-gated đang vô-danh — `ctx-verifier` cờ-9: án S195 "cấm đề ③/④ lần nữa, escalate cơ-chế" đã bị phạm ngay cửa S196 [nén `harvest-curator` theo MỨC cho bệnh TỐC-ĐỘ] và ý này là ý duy nhất cùng lớp (103)(104) mà KHÔNG có số nên rơi qua 3 bề mặt)*: **(105) Escalate CƠ-CHẾ trần bộ-nhớ cho vai tái-vượt** — 2 vai (`lead-gap-auditor` · `ring2-audit`) vượt trần ở **CẢ HAI đơn-vị** byte/ký-tự, đã ăn thuốc nén ③ rồi vượt lại ⇒ nén tiếp là vô hạn. Anh chọn: **(a)** đổi số cap (quyền anh — cap = owner) · **(b)** đổi quy-ước ghi của vai (tách tầng / hạn tốc-độ ghi — lead thi hành) · **(c)** dựng auto-drain tooling theo value-gate → đề xuất **(b)**, và nên phán **SAU** khi trả câu (94) byte⟂ký-tự vì chọn đơn-vị đổi cả tập vai bị nén.
+> 🔢 **CHỜ ANH MỚI @S197 (2/2)** *(sinh từ `YC-039` — anh nói "tạo hợp đồng thì PHẢI bắt từ KHKK"; đo hiện trạng: đường bridge KHKK→HĐ ĐÃ là đường chuẩn [K7 hội-2-khóa, write-site duy nhất] + pre-fill 3 tầng NCC→KHKK→HĐ đã ship #490, NHƯNG **đường tạo HĐ TỰ DO còn MỞ**: `ContractsController:49 POST /contracts` + 3 lối UI [menu Create per-loại `Layout:178` · nút Tạo mới `MyContractsPage:156` · Dashboard `:1106`] — HĐ đi đường này **0 liên kết** ngược KHKK/NCC, chuỗi đứt tại chỗ tạo)*: **(106) Siết đường tạo HĐ tự do?** — **(a)** CHẶN tạo tự do cho 5 loại thi-công/mua-bán (TP·GK·NCC·DV·MB — bắt buộc từ KHKK), GIỮ tự do cho 2 loại Nguyên tắc (NT-NCC·NT-DV thường ký khung TRƯỚC khi có PE/KHKK) · **(b)** chặn HẾT 7 loại — mọi HĐ phải từ KHKK · **(c)** giữ nguyên 2 đường, gắn nhãn "HĐ ngoài chuỗi" cho bản tạo tự do → đề xuất **(a)** — khớp chữ "phải bắt từ KHKK" mà không khoá nhầm ca nghiệp-vụ HĐ nguyên tắc.
 >
 > 🔺 **DI-TRÚ KHỎI WAL @S195 — `lead-gap-auditor` deep 7 FLAG, 4 cờ hội tụ về CÙNG một nguyên nhân:** mọi mục dưới đây trước lượt này **chỉ sống ở `.claude/WAL.md`**, mà `§6.4` **xoá trắng WAL ở bước CUỐI closeout** ⇒ đóng phiên là mất. Ghi TAY ở đây vì nghi-thức RE-STAMP **chép danh sách kỳ trước** nên slug sinh-trong-WAL **vô hình có cấu trúc**.
 > - 🔴 **3 slug carry mồ côi (FLAG-1 HIGH, im 4 nhãn phiên, 3 lượt audit liên tiếp đã chỉ đích danh mà vẫn 0 hit):** `[carry:mind-dinh-chinh-mot-be-mat]` · `[carry:du-cua-rule-khong-phai-phep-kiem]` · `[carry:session-end-thieu-buoc-ghi-block]`. Control-dương cùng lệnh: `[carry:w5-host-ondeleted]`=1 hit · `[carry:reset-doi-het]`=2 hit ⇒ thước sống, 0 là 0 thật. **Bài học kèm:** 2/3 slug này nằm ĐÚNG trong `runs/2026-08-13-S191-bookend-close/sub-ctx-audit-close.md:16` — nguồn mà khối RE-STAMP @S191 **tuyên là đã quét** ⇒ nghi-thức "dựng-từ-nguồn" **không bắt được slug sinh trong chính run-folder của nó**.

docs/governance/so-yeu-cau-chu-du-an.md

@@ -68,6 +68,8 @@ Dữ-liệu cũ (WAL · HANDOFF · auto-memory · migration-todos) **KHÔNG** đ
 | `YC-036` | "OK xong hết hoàn toàn đi rồi tao sẽ test" | 2026-08-14 · S194 | **mở** | — | WAL chain G1-G5 *(thi-công → WAL)* | Lệnh làm TRỌN `YC-032` — hết 4 vế, không dừng giữa chừng để hỏi, rồi anh tự kiểm trên prod. Đội hiểu: chạy nốt G1 (office + verify FE) → G2 khung document-view → G3 pre-fill → G4 in + khoá bản cứng → G5 review + deploy, và **deploy lên prod** vì "tao sẽ test" hàm ý anh test trên máy thật. 🔴 Ràng buộc GIỮ NGUYÊN, không được lấy chữ "xong hết" để bỏ qua: 4 nợ đã-biết ở spec `§⑥.c` (VAT · con-trỏ chết ĐIỀU 8/12 · authz đính kèm · 12 điều PHẦN 2) là owner CỐ Ý hoãn — vẫn phải KHAI khi báo cáo, cấm im lặng cho tròn. | **`YC-032`** |
 | `YC-037` | *(chốt bằng chọn-đáp-án ở AskUserQuestion, không phải free-text)* — câu 1 **"Chuẩn thuận + vá cửa git (Đề xuất)"** · câu 2 việc-kế **"Vá 3 lỗ hạ-tầng vừa bắt"** | 2026-08-14 · S196 | **mở** | 1 | `.claude/commands/tiep.md` §0 khối ⑤(a) *(vá đã land)* + `runs/2026-08-14-S196-bookend-open/` | Hai lệnh tách bạch. **(1)** Chuẩn thuận việc lead đi tiếp sau khi Sàn-3 ⑤ kêu — chẩn đoán dương-giả ĐÚNG, nhưng lead **vượt quyền** khi tự thi hành (`ctx-audit` C-1: trụ bằng chứng là phép trích RỖNG; ⑤ là phép HỢP, lead đổi thành "đĩa thắng git"). Chuẩn thuận = tha ca này, **KHÔNG** nới luật — anh cố ý chọn nhánh vá MÁY thay vì nhánh "cho lead tự phán". **(2)** Việc kế = 3 lỗ hạ-tầng: `agents/README.md:264` thiếu 3 vai (`ring5-audit`·`score-counter`·`score-count-auditor`) ⇒ vai gọi trong workflow sẽ THROW · 4 ô canonical stale `STATUS:6/9/11/484` · self-compact `harvest-curator` (L1 **bị cắt thật** khi spawn phiên này, 27.360 B > hook read-limit ~24,4 KB). 🔴 Lead khai ràng buộc: 3 lỗ này nằm trong **bề-mặt-đo bị đóng băng** (Mirror C1) nên phải chờ `ring1`/`ring2` trả verdict mới sửa — không phải hoãn, là thứ-tự bắt buộc. | |
 | `YC-038` | "disposition 52 slug -> OK" | 2026-08-14 · S196 | **mở** | 1 | `docs/governance/carry-disposition-S196.md` *(sinh trong lượt)* + `docs/HANDOFF.md` khối RE-STAMP | Lệnh CHẠY disposition per-slug cho 52 slug `[carry:*]` ở `HANDOFF:44`, thay vì hoãn tiếp. Nền: `lead-gap` F-2 @S196 chứng lời hẹn *"disposition per-slug = việc bookend kế"* đã hoãn **3 bookend liên tiếp** (S192-open → S195-close → S196-open) vì neo vào chữ **"bookend kế"** ⇒ **tự gia hạn vô hạn, không bao giờ quá hạn**; `grep -rn "disposition per-slug"` = 7 hit, **7/7 đều là lời NHẮC, 0 hit là kết quả**. Đội hiểu: mỗi slug phải ra đúng 1 trong 3 nhãn {ĐÓNG · MỞ · CHƯA ĐO ĐƯỢC} kèm bằng chứng đo, **CẤM làm tròn "không thấy" thành "đã đóng"**; rồi **đổi chữ "bookend kế" thành mốc SỐ thật** để hết trôi. 🔴 Caveat mang theo (`ring2` @S196): con số 52 đúng theo `HANDOFF:44`, nhưng tập slug trên đĩa **phụ thuộc SCOPE** (docs/ = 71 · tracked trừ run-folder = 72 · toàn tracked = 86) ⇒ phải khai scope, đừng trình 2 thước như một phép trừ. | |
+| `YC-039` | "Hiện tạo hợp đồng -> thì phải bắt từ KHKK vậy thì các thông tin sẽ liên kết dối dài thêm từ Duyệt NCC -> KHKK -> Hợp đồng." | 2026-08-14 · S197 | **mở** | 1 | báo-cáo assessment S197 *(thi-công → WAL nếu thành việc)* | Hai tầng, khai ranh rõ: **(i) vế XÁC-NHẬN chuỗi kế thừa** Duyệt NCC → KHKK → HĐ = trùng `YC-024`(81) + `YC-032`(3) **đã ship** (bridge K7 hội-2-khóa + pre-fill 17 ô, deploy #490) · **(ii) vế "PHẢI bắt từ KHKK"** đọc được thành RÀNG BUỘC MỚI: hiện máy **CÒN đường tạo HĐ tự do KHÔNG qua KHKK** (`POST /contracts` + 3 lối UI: menu Create per-loại, nút Tạo mới MyContracts, Dashboard) — HĐ tạo đường này **0 liên kết** ngược KHKK/NCC. Cần anh phán siết hay giữ (câu hỏi ở báo-cáo S197). *Anh bác cách hiểu (ii) ⇒ lật dòng này thành nhắc-lại-của `YC-024`, không xoá.* | |
+| `YC-040` | "(b) Chặn HẾT 7 loại — mọi HĐ đều phải từ KHKK -> Tao nghĩ nên như vậy trước đã." | 2026-08-14 · S197 | **mở** | 1 | WAL chain *(thi-công → WAL)* | Phán quyết câu **(106)** = nhánh **(b)**: chặn đường tạo HĐ tự do cho CẢ 7 loại (kể cả 2 loại Nguyên tắc) — mọi HĐ chỉ sinh từ KHKK đã duyệt qua "Đưa vào HĐ". Vế *"nên như vậy trước đã"* = posture TẠM-THỜI-SIẾT: code chặn phải GỌN-DỄ-ĐẢO (guard 1 chỗ BE + đổi lối UI, không phá máy tạo — sau anh muốn nới loại nào thì mở lại rẻ). Thi công 2 tầng theo #82: API `POST /contracts` chặn 409 + UI đổi 3 lối tạo tự do (menu Create · nút Tạo mới · Dashboard) về hướng KHKK; giữ nguyên nhánh EDIT Nháp + đường bridge. Kèm test guard (test-before cho guard theo rules §7). | |
 | `YC-018` | "2 phần bookend và bookstart -> trong đợt adapt này AI_INFRA cũng có hướng dẫn bọn mày chạy 1 mạch hết toàn bộ ko còn pause/tiep nữa, chú ý cấu hình cái đó kỹ nhé" | 2026-08-09 · S185 | **đóng** *(cấu hình land 4 site @S185 + chạy thật trọn 1 mạch bookend @close cùng đêm — nghiệm bằng vận hành; 🔴 nhắc lần 2 @S188 = PN-001: lead bỏ 3 vai @close với lý do "ngân sách" — owner bác, chạy nốt ngay trong lượt)* | **2** | WAL chain (TASK → WAL) | Nghi-thức 2 đầu phiên (`/session-start` bookstart + `/session-end` bookend) phải chạy **TRỌN TRONG MỘT LƯỢT** như hub kể ở thư 08-08 Phần 1b ("lượt mở phiên gần nhất chạy trọn trong một lượt duy nhất, không cần cửa tạm dừng nào chen giữa") — cấu hình luật ONE-SHOT vào 2 file lệnh, CẤM rải nghi-thức qua nhiều cửa pause/tiep, CẤM hẹn-cửa-sau. *(Đội hiểu: pause/tiep VẪN là recovery khi đứt bất-khả-kháng [limit/crash — H22 giữ nguyên]; thứ bị cấm là DÙNG chúng làm nhịp chia-chặng nghi-thức. Anh bác cách hiểu này thì em sửa.)* | |
 
 > 🔴 **MỘT yêu-cầu, nhắc 4 lần.** Đây là dữ-liệu **TC-01** sinh ra để bắt, và nó tố-giác chính lead: hiểu sai ở `YC-002` nên anh phải nói lại 3 lần. **Ghi lại chứ không làm đẹp.**