@kienntpixon/dieu-phoi 0.6.1 → 0.7.1

package/CHANGELOG.md

@@ -1,5 +1,77 @@
 # Changelog — @kienntpixon/dieu-phoi
 
+## 0.7.1 (2026-10-26)
+
+Đề xuất core C1–C6 của retro 2026-10-26 (run 4b3mohix, task fgcq8dl9). `CORE_VERSION` 0.7.1; đi cùng skill 1.6.1.
+**Thứ tự phát hành:** deploy Code.gs bản mới (cột `batch`, C5) TRƯỚC, rồi `npm i -g` + `dieu-phoi setup`.
+
+- **`setup`: matcher `Agent|Task`** (task y5lcc5vx): hook PostToolUse/PreToolUse đăng ký cho cả tên công cụ `Agent` (Claude Code hiện tại) lẫn `Task`
+  (bản cũ). Đăng ký cũ chỉ `Agent` không còn tính là "đã đăng ký" → `setup` viết lại (không nhân đôi); `doctor` nhận cả hai.
+
+- **C5 — verifier gộp là ô riêng** (task meq4adm7): agent `role=verify` có `batch:true` (thẻ `|batch`) không còn cộng chi phí/thời gian
+  vào task mang `task_id` của nó (tức ô `task_type × tier` của bước fast cuối) — ở cả `aggregate` lẫn `sheet/Code.gs` (cột mới `batch`).
+  `stats --json`/`retro --json` thêm `batch_verify: [{model, effort, n, tasks, cost_total_usd, cost_mean_usd, cost_p50_usd,
+  time_mean_min, time_p50_min}]` (CLI-only, ngoài parity); `stats` in bảng "verifier gộp", `retro` thêm một dòng. Thống kê theo mode
+  (`verify_min`…), `sub_usd_total`, `totals.cost_usd` vẫn tính nó. Dữ liệu cũ (không `batch`) không đổi số. **Sink: dán lại Code.gs**
+  (≈ 39 KB → minify khi deploy qua gws); Code.gs cũ làm rơi `batch` nên ô sink còn lệch CLI tới khi deploy.
+- **C6 — delta knowledge chưa gộp + `repo:` tên ngắn** (task 1l9as0f3): `start` (khối hook, bản chữ, `--json` `unmerged_deltas`) và `state` (dòng cuối, `--json`)
+  cảnh báo `knowledge_delta: N file delta chưa gộp quá 24h …` khi có `knowledge-delta*.md` tuổi 24 h–30 ngày mà hash không nằm trong sổ `applied` của kho nào
+  (quét ~20 ms, chỉ đọc file). `knowledge merge`: header `repo:` nhận tên ngắn/basename (`pff-tailor`) nếu khớp đúng một kho đã biết (`name`, tên thư mục kho hoặc
+  basename của `roots`); HEAD từ `head:`, `roots` (mới: `meta.json` ghi checkout chính sau mỗi lần gộp có đổi) hoặc `--repo`; khớp ≥ 2 kho hoặc không khớp → lỗi rõ ràng.
+  File delta mà mọi mục đều "không đổi" nay cũng được ghi vào `applied` (để hết cảnh báo; test `knowledge-idem` cập nhật: meta.json chỉ thêm sổ `applied`).
+  Delta cũ gộp trước khi có sổ sẽ còn bị cảnh báo đến khi chạy `knowledge merge` một lần (idempotent, thành "không đổi").
+- **C4 — sàn tier theo sở thích (`tier_floor`)**: profile.json có thể ghi `tier_floor {task_type: "model/effort"}`; `choose` lấy
+  max(sàn này, sàn an toàn, leo thang), không thăm dò xuống dưới, Thompson không chọn ô thấp hơn dù dữ liệu nghiêng về ô rẻ hơn.
+  Chỉ siết (trên trần → kẹp opus/medium; ngoài thang → bỏ). `--override`/`--approved` thấp hơn sàn vẫn giữ, có ghi chú.
+- **C3 — telemetry của `choose`**: kết quả có thêm `score`, `reason_code` (`thompson | floor | escalation | prior | user-prior | explore |
+  plan | override | ask | unknown-type`), `thompson_score`; bản ghi `data/suggest/*.json` lưu `choose_task_type`, `choose_score`, `explored`,
+  `reason_code`, `thompson_score`, dispatch chép thành `choose_*` (chỉ ở máy). Thẻ ghi loại khác loại đã hỏi `choose` → `choose_type_mismatch:true`
+  + PostToolUse nhắc điều phối viên.
+- **C2 — bí danh task_type trong hook**: bảng bí danh dời sang hook.cjs (`TYPE_ALIASES`, `choose` dùng chung) và thêm
+  `scan`/`read`/`code-read`/`explore`/`scout`/`lookup` → `search`. Thẻ dispatch mang nhãn có bí danh (vd. `architecture`, `shell`, `config`,
+  `deploy`) được ghi `task_type` = loại đích, `tag_issue=aliased` + `type_alias_from` thay cho `bad-type` (số liệu gộp vào ô đúng).
+- **C1 — trần phiên/chuỗi handoff**: cảnh báo PostToolUse dời về handoff **thứ 2** (`HANDOFF_CHAIN_WARN=2`); hook PreToolUse(Agent) mới
+  (setup đăng ký thêm, `doctor` mục `chain-gate`) **từ chối** lượt exec tiếp nối của task đã handoff ≥ 3 lần (sự kiện `gate` `deny`,
+  `reason_code=handoff-chain`, `agent_id=task:<id>`) trừ khi thẻ có `|chain_ok` (dispatch ghi `chain_ok:true`); trong subagent không áp.
+  `ctx`/`choose`: context > 400k hoặc ≥ 5 lần nén → `new_session:true` (`choose`: `orch_new_session`), `over:true`, advice "mở phiên mới
+  + `state`" thay cho `/compact`. Thẻ cũng nhận cờ `|batch` (C5). **Cần chạy lại `dieu-phoi setup`.**
+
+## 0.7.0 (2026-10-23)
+
+`CORE_VERSION` 0.7.0; đi cùng skill 1.6.0. Chế độ `fast | normal | strict` theo yêu cầu (nhánh `fast-mode`, kế hoạch hzgqonzr; egm0w7mx, ue15wumm, d1m3rg7s). Sự kiện `mode` chỉ ở máy, không gửi sink. `sheet/Code.gs` ĐỔI ở phần dữ liệu học fast (d1m3rg7s): **deploy Apps Script trước khi phát hành CLI** (sink cũ đọc `by=auto` thành verdict agent).
+
+- **Mode theo yêu cầu (root_task_id)**: `start --mode fast|normal|strict` và lệnh mới `dieu-phoi mode --root <id> [mode] [--reason R] [--session S]`
+  (không có giá trị = xem). Mỗi lần đổi ghi một sự kiện `kind=mode` cục bộ (`runSync` bỏ qua kind này); cùng mode thì không ghi. Bước đã giao giữ
+  mode lúc giao (`dispatch.mode`), bước chưa giao áp mode mới; thứ tự: lần giao exec đầu > `mode` của bước trong kế hoạch > mode root > normal.
+  Không có logic tự đổi mode. `start` (text) và khối hook khởi động luôn in dòng nhắc HỎI người dùng chọn mode (`--json`: `mode:null`).
+- **`choose` trả `verify_plan`** (`independent-blocking | independent-nonblocking | self+batch | spot`) cùng `verify_reason`, `verify_floor`,
+  `test_scope` (`selective|full`), `mode`, `mode_source`; thêm `--mode`, `--publish`, `--dependents`. Sàn an toàn (reversible=n, publish,
+  verifiable=n, s>=9) xét trước và thắng ở mọi mode. fast: s<=6 → `self+batch` (test chọn lọc, không verifier riêng, một verify gộp);
+  s7-8 → `independent-nonblocking` (blocking nếu có bước phụ thuộc); strict: 1/3 `spot`, luôn chạy cả suite.
+- **`verdict ... --verify self`** hợp lệ (exec tự kiểm).
+- **`plan-table`**: file là mảng (như cũ) hoặc `{"mode":…,"steps":[…]}`, bước có thể ghi đè `mode`/`publish`; thêm cột **Kiểm** (cuối bảng),
+  dòng `**Mode:**` và "bỏ N verifier riêng, 1 verify gộp"; cờ `--mode`; `--approve` ghi sự kiện mode (source plan) khi mode hiệu lực khác
+  mode hiện tại của root.
+- **`state`** dựng lại mode: `modes[]` + `task.mode` (--json), dòng "Mode (theo yêu cầu…)" (text).
+- Test: `test/mode.test.cjs` (8 ca); cập nhật kỳ vọng cũ cho khối `start` và khoá `state --json`.
+- **Gợi ý quay về normal, không tự đổi** (task ue15wumm): khi root đang fast, `choose` (exec) và `state` trả `mode_suggest:"normal"` +
+  `mode_suggest_reason` (bản chữ: dòng `GỢI Ý mode: … hỏi người dùng … KHÔNG tự đổi mode`) khi có verdict fail `batch-verify`, reject chất
+  lượng (từ sự kiện mode mới nhất của root), hoặc ≥ 15% fail trong 10 bước fast gần nhất (cần ≥ 5 bước). Không ghi sự kiện mode nào.
+- **`complete.test_s`** (+ `test_runs`, `full_suite_runs`, `test_s_source`): hook SubagentStop đo thời gian lệnh test từ transcript subagent
+  (tool_use Bash/PowerShell → tool_result), không có thì đọc dòng `TEST_S:` trong dp-out; lệnh nền chỉ đếm.
+- **`stats`/`retro` tách theo mode** (`modes` trong `--json`, bảng/dòng "Theo mode" ở bản chữ): catch rate, reject, phút verify, test_s,
+  số lần chạy cả suite. Hàm mới `aggregate.modeSummary` (ngoài parity CLI ↔ sink).
+- Test: `test/mode-suggest.test.cjs` (7 ca).
+- **Dữ liệu học của fast (task d1m3rg7s)**: verdict `--verify self` không vào `agent_pass_rate` / verdict agent đầu (`first_outcome`)
+  nhưng vẫn là kết quả leo thang; số phụ theo ô `n_self`, `self_pass`, `auto_accept`, `auto_overturned`, note "ít bằng chứng" khi
+  self chiếm > 50% verdict của ô. Verifier gộp ghi `verdict <exec_agent> fail|pass --verify tests --reason batch-verify`.
+- **`verdict --task <id> accept --auto`**: nghiệm thu tự động (`by=auto`, `verify=tests`, round null) — chỉ accept, chỉ task mode fast,
+  chưa có verdict người dùng, score exec ≤ 6 nếu có; `reject --auto`, `--root … --auto`, `--round/--cause` kèm `--auto` bị từ chối.
+  Verdict người dùng sau đó thắng; reject sau auto accept đếm `auto_overturned`. `retro` totals thêm `self_verdicts`, `auto_accept`,
+  `auto_overturned` + dòng "Fast: …".
+- **`sheet/Code.gs`** cùng logic (normalizeVerdict_ giữ `auto`, firstOutcome bỏ self, số phụ trên) — parity fixture +ptask201–205.
+- Test: `test/fast-learning.test.cjs` (4 ca).
+
 ## 0.6.1 (2026-10-22)
 
 `CORE_VERSION` 0.6.1; đi cùng skill 1.5.1. codebase-memory-mcp là **khuyến nghị, không bắt buộc** (nhánh `cbm-support`, task 7s6mouxg). `sheet/` không đổi, không cần deploy lại `Code.gs`.

package/bin/dieu-phoi.cjs

@@ -18,12 +18,20 @@ Cách dùng: dieu-phoi <lệnh> [tuỳ chọn]
                          kiểm hook, node, config, sink (sink lấy từ bộ nhớ đệm 24 giờ; --net kiểm trực tiếp) và
                          codebase-memory-mcp (khuyến nghị: cài/MCP/index của repo; --cbm hoặc --net mới chạy \`daemon status\` ~3 s,
                          kết quả nhớ 10 phút; --net còn so bản mới nhất)
-  start [--json]         khởi động cổng 1 trong một lệnh (~150 ms, không gọi mạng): kiểm cục bộ, task_id gốc,
-                         tạo run dir, đường dẫn brief scout — dùng khi hook UserPromptSubmit không chạy
-  verdict <agent_id|last> <pass|fail|timeout|aborted> [--verify tests|lint|review|judgment|none] [--reason short-kebab]
+  start [--mode fast|normal|strict] [--json]
+                         khởi động cổng 1 trong một lệnh (~150 ms, không gọi mạng): kiểm cục bộ, task_id gốc,
+                         tạo run dir, đường dẫn brief scout — dùng khi hook UserPromptSubmit không chạy;
+                         không có --mode thì in dòng nhắc HỎI người dùng chọn mode (mặc định normal)
+  mode --root <root_task_id> [fast|normal|strict] [--reason R] [--session S] [--json]
+                         xem/đổi mode của một yêu cầu (một sự kiện mỗi lần đổi, cục bộ); bước chưa giao áp mode mới,
+                         bước đã giao giữ mode lúc giao; không bao giờ tự đổi
+  verdict <agent_id|last> <pass|fail|timeout|aborted> [--verify tests|lint|review|judgment|self|none] [--reason short-kebab]
                          nghiệm thu tầng agent (by=agent); aborted = dừng vì hết quota/usage limit (không phải fail)
   verdict --task <task_id> <accept|reject> [--cause quality|scope] [--round n] [--reason R]
                          nghiệm thu của người dùng (by=user); reject bắt buộc --cause
+  verdict --task <task_id> accept --auto [--reason R]
+                         tự nghiệm thu bước fast (score ≤ 6) sau verifier gộp (by=auto): không vào accept_rate;
+                         người dùng vẫn duyệt cuối bằng --root, reject sau đó thắng auto
   verdict --root <root_task_id> accept [--steps a,b]
                          người dùng nhận mọi bước đã giao exec của kế hoạch đã duyệt chưa có verdict người dùng
                          accept (--task/--root) tự gộp knowledge-delta-<task_id>*.md của run vào kho (--no-knowledge: bỏ)
@@ -35,15 +43,19 @@ Cách dùng: dieu-phoi <lệnh> [tuỳ chọn]
   stats [--type T] [--json]
                          bảng task_type × model/effort: n, accept%, agent_pass%, chi phí/thời gian (TB, p50, p75), steer
   choose --type T --score N [--urgency relaxed|normal|urgent] [--reversible y|n]
-         [--verifiable y|n] [--role exec|verify|plan|helper] [--task ID]
+         [--verifiable y|n] [--publish y|n] [--dependents y|n] [--mode fast|normal|strict]
+         [--role exec|verify|plan|helper] [--task ID]
          [--override model/effort (cần --task) | --approved model/effort] [--skill-dir P] [--seed S] [--json]
-                         đề xuất model + effort, lý do, action (dispatch|ask_user), ước tính chi phí/thời gian
+                         đề xuất model + effort, lý do, action (dispatch|ask_user), ước tính chi phí/thời gian,
+                         verify_plan (independent-blocking|independent-nonblocking|self+batch|spot) theo mode
+                         (--mode mặc định: mode của root của --task, rồi normal)
   ctx [--session <id>] [--json]
                          context + chi phí của phiên điều phối (mặc định $CLAUDE_CODE_SESSION_ID) so với trần mềm
   state [--session <id>] [--json]
                          trạng thái điều phối của phiên dựng lại từ log (cũng được nạp tự động sau /compact)
-  plan-table --file <steps.json> [--json] [--approve --root <root_task_id>]
-                         bảng phân công: Bước | Model/effort | Lý do | Ước tính + tổng + đường găng
+  plan-table --file <steps.json> [--mode M] [--json] [--approve --root <root_task_id>]
+                         bảng phân công: Bước | Model/effort | Kiểm | Lý do | Ước tính + tổng + đường găng;
+                         file là mảng bước hoặc { "mode": "fast", "steps": [...] } (bước có thể ghi đè "mode")
   new-id [--count n] [--json]
                          in task_id mới hợp lệ (8 ký tự a-z0-9), mỗi dòng một id — không tự bịa id
   sync                   đẩy bản ghi chưa đồng bộ lên sink
@@ -96,6 +108,7 @@ async function main(argv) {
     setup: c.cmdSetup,
     doctor: c.cmdDoctor,
     start: c.cmdStart,
+    mode: c.cmdMode,
     verdict: c.cmdVerdict,
     steer: c.cmdSteer,
     discard: c.cmdDiscard,