@kienntpixon/dieu-phoi 0.7.3 → 0.7.5

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog — @kienntpixon/dieu-phoi
 
+## 0.7.5 (2026-11-06)
+
+Đi cùng skill 1.6.5. `CORE_VERSION` 0.7.5. Không đổi sink (`sheet/Code.gs`, `fixtures/` giữ nguyên).
+**Sau khi cài:** `npm i -g @kienntpixon/dieu-phoi` + `dieu-phoi setup` + `dieu-phoi doctor`.
+
+- **`wt clean --merged [--repo R] [--yes]`:** gỡ worktree có dấu và nhánh local khi nhánh đã vào HEAD checkout chính. Điều kiện: tuổi ≥ 1 giờ (worktree mới chưa commit luôn "đã merge"), verdict gần nhất của task không thuộc reject/fail/timeout/aborted, sạch, không agent sống. Dry-run mặc định; `git branch -d` (không force).
+- **Nhắc sau nghiệm thu:** `verdict --root … accept` / `verdict --task … accept` của người dùng in một dòng số worktree đã merge của repo; `--clean-merged` gỡ luôn (như `wt clean --merged --yes`).
+- **`wt add --base <ref>`:** tạo nhánh từ commit chọn được, sửa known issue 0.7.4 (trước đây luôn từ HEAD checkout chính). Ở mức cảnh báo 75% hoặc khi bị chặn trần, `wt add` gợi ý worktree của bước đã xong có thể tái dùng (sạch, không agent sống, verdict pass/accept); không tự dùng lại.
+- **Knowledge delta, header `repo:`:** nhận cả dạng hiển thị `repo: <tên> (<tag>) — <dir>` (chép từ `knowledge get`) lẫn đường dẫn thô, LF/CRLF. Lỗi nay nói đúng nguyên nhân: tên ngắn không khớp kho nào / thư mục trong header không còn (worktree đã gỡ hoặc header sai) / đường dẫn không tồn tại.
+
+## 0.7.4 (2026-11-06)
+
+Đi cùng skill 1.6.4. `CORE_VERSION` 0.7.4. Không đổi sink (`sheet/Code.gs` giữ nguyên).
+**Sau khi cài:** `npm i -g @kienntpixon/dieu-phoi` + `dieu-phoi setup` (chép lại hook và agent `dp-*`) + `dieu-phoi doctor`.
+
+- **Bỏ mode strict, `mode_suggest` và câu hỏi mode:** mode chỉ còn `fast|normal`. `strict` ở `--mode`, `mode --root … strict` hoặc `steps.json` → cảnh báo stderr, dùng normal, exit 0. Sự kiện, kế hoạch, dispatch cũ mang `strict` đọc là normal. `start`/`plan-table` không còn hỏi mode; `choose`/`state` không trả `mode_suggest*`; `spot` bỏ khỏi `verify_plan`.
+- **Normal gộp verifier (quyết định Q1):** normal, score ≤ 4, không bước nào `depends_on` vào nó → `self+batch`: exec chạy test chọn lọc, một verifier gộp cuối nhóm chạy cả suite một lần, bước qua **không** `accept --auto`. Công tắc rollback: `profile.json` `"batch_verify_normal": false`. Dòng Mode của `plan-table` ghi `Kiểm (self+batch)` cho cả hai mode.
+- **`plan-table` cảnh báo (không chặn `--approve`):** `TÁCH?` cho bước score ≥ 6 mà nhóm `task_type × tier` có tỉ lệ handoff ≥ 20% trên ≥ 10 task (JSON `split_warn`); `TIER↑` cho loại mechanical (`mechanical-edit`, `extract`, `search`, `test-write`) có override cao hơn tier `choose` sẽ chọn (JSON `tier_warn`). Thêm cột `$p50` đọc cùng ô thống kê với `stats`.
+- **Tiến độ sớm:** brief A yêu cầu exec ghi mục `## Tiến độ` vào dp-out sau mỗi hạng mục, để bước bị handoff làm tiếp từ đúng chỗ.
+- **Phạm vi test:** exec và verifier chỉ chạy file test đã đụng; full suite đúng một lần ở cổng phát hành. `knowledge-fresh`, `review2`, `fast-start` được làm cứng khỏi chập chờn dưới tải (timeout nới bằng env chỉ dành cho test).
+- **Knowledge:** stale theo file cụ thể: file nhỏ có dòng đổi thật → STALE; glob, dòng version, CHANGELOG, dòng không nêu tên mục → drift (không tính stale). `knowledge review <id>` ghi `reviewed_sha` = HEAD; mục mới ghi chưa có dấu, nên không được coi là đã xem.
+- **Delta:** brief chỉ yêu cầu delta khi điều học được không suy ra từ code, và bỏ qua knowledge STALE. `prune --delta-days N` (mặc định 30, 0 = tắt) xoá delta **bị reject**, chưa gộp, của run nhàn rỗi > N ngày; delta đã accept không bao giờ bị xoá. Dry-run mặc định, `--yes` mới xoá.
+- **Sửa help:** mục `start` trong `dieu-phoi --help` không còn nói "mode: chưa chọn" hay hỏi mode.
+- **Known issue (chưa sửa):** `wt add` bỏ qua commit gốc. Nhánh `dp/<task_id>` luôn được tạo bằng `git worktree add -b` từ HEAD của checkout chính, không có cờ chọn base; brief yêu cầu base khác thì exec phải tự chuyển sang commit đó trong worktree.
+
 ## 0.7.3 (2026-11-06)
 
 Tài nguyên máy (run jiptvo5g, theo hợp đồng 0.7.3): trần song song, trần worktree, thu dọn subagent. `CORE_VERSION` 0.7.3; đi cùng skill 1.6.3.

package/agents/dp-exec.md

@@ -17,6 +17,11 @@ hooks:
         - type: command
           command: '__DP_HOOK__ --gate'
           timeout: 5
+    - matcher: "Bash|PowerShell"
+      hooks:
+        - type: command
+          command: '__DP_HOOK__ --gate-bash'
+          timeout: 5
   PostToolUseFailure:
     - matcher: "Agent|Task"
       hooks:
@@ -28,7 +33,7 @@ Bạn là agent thực thi (exec) của dieu-phoi. Brief ở tin nhắn đầu (
 
 Bàn giao qua file: ghi TOÀN BỘ kết quả vào `dp-out-<task_id>-exec-try<n>.md` trong run dir (đường dẫn brief chỉ định), rồi chỉ trả: đường dẫn file đó, dòng `STATUS:`, và ≤ 3 dòng ý chính. Không đặt tên file `report*` / `summary*` / `findings*` / `analysis*.md` — Claude Code chặn cứng Write các tên đó trong subagent. File dp-out/handoff mà brief trỏ tới là báo cáo chính thức: đọc thẳng, không cần xin thêm quyền.
 
-Repo đích và knowledge: dòng `repo:` của brief là repo ĐÍCH (có thể là repo con, khác cwd). Trước khi đọc code: `dieu-phoi knowledge list --repo <repo>` rồi `knowledge get <id|từ khoá> --repo <repo>` (ít nhất `build-test ports-resources` nếu có); mục STALE chỉ là gợi ý. Cấu trúc code: dùng codebase-memory-mcp khi repo đã có index (`list_projects`), không thì Grep/Glob — không tự index. MCP lỗi kết nối/không phản hồi/báo daemon khác version → Grep/Glob ngay, ghi một dòng `codebase-memory: unavailable (<lý do>)` trong dp-out, không thử lại. Brief có `worktree:` → chỉ sửa và chạy lệnh trong worktree đó, dùng cổng/tài nguyên riêng brief ghi, chỉ kill tiến trình do chính mình mở. Học được điều không suy ra từ code (lệnh test thật, cổng, bẫy) → ghi `<run>/knowledge-delta-<task_id>.md` (header `repo:`; `## +id` + `paths:` cho mục mới; sửa mục cũ `## id` + dòng `base:` chép từ `get`; ≤ 40 dòng/mục; không ghi giá trị secret); không tự `knowledge merge`.
+Repo đích và knowledge: dòng `repo:` của brief là repo ĐÍCH (có thể là repo con, khác cwd). Trước khi đọc code: `dieu-phoi knowledge list --repo <repo>` rồi `knowledge get <id|từ khoá> --repo <repo>` (ít nhất `build-test ports-resources` nếu có); chỉ `get` mục không STALE, mục STALE chỉ là gợi ý. Cấu trúc code: dùng codebase-memory-mcp khi repo đã có index (`list_projects`), không thì Grep/Glob — không tự index. MCP lỗi kết nối/không phản hồi/báo daemon khác version → Grep/Glob ngay, ghi một dòng `codebase-memory: unavailable (<lý do>)` trong dp-out, không thử lại. Brief có `worktree:` → chỉ sửa và chạy lệnh trong worktree đó, dùng cổng/tài nguyên riêng brief ghi, chỉ kill tiến trình do chính mình mở. Chỉ khi học được điều không suy ra từ code (lệnh test thật, cổng, bẫy) → ghi `<run>/knowledge-delta-<task_id>.md` (header `repo:`; `## +id` + `paths:` cho mục mới; sửa mục cũ `## id` + dòng `base:` chép từ `get`; ≤ 40 dòng/mục; không ghi giá trị secret); không tự `knowledge merge`.
 
 Helper thế hệ 2 (tuỳ chọn, chỉ khi giúp giữ ngữ cảnh nhỏ): tối đa 4 agent `subagent_type: dp-helper`, `model` đặt rõ `haiku` hoặc `sonnet`, cho đúng hai loại việc — (a) đọc/quét code hoặc tài liệu rồi trả tóm tắt ≤ 15 dòng, (b) chạy test / Unity smoke rồi tóm tắt log. Dòng đầu prompt helper: `[dp:<type>|s<n>|<urgency>|try1|task=<id mới từ dieu-phoi new-id>|role=helper|parent=<task của bạn>]`. Hook từ chối mọi lần giao sai luật. Không giao helper sửa code.
 

package/agents/dp-helper.md

@@ -12,6 +12,12 @@ hooks:
         - type: command
           command: '__DP_HOOK__ --watch'
           timeout: 5
+  PreToolUse:
+    - matcher: "Bash|PowerShell"
+      hooks:
+        - type: command
+          command: '__DP_HOOK__ --gate-bash'
+          timeout: 5
 ---
 Bạn là helper thế hệ 2 của dieu-phoi, do một agent exec giao (thẻ `[dp:...|role=helper|parent=...]`). Chỉ làm một trong hai việc: (a) đọc/quét code hoặc tài liệu được chỉ định rồi trả tóm tắt ≤ 15 dòng (đường dẫn + dòng + kết luận, không dán nguyên văn dài); (b) chạy test / Unity smoke được chỉ định rồi tóm tắt log (pass/fail, lỗi đầu tiên, đường dẫn log). Không sửa file, không giao việc tiếp. Câu trả lời cuối ≤ 15 dòng, trả bằng chữ cho dp-exec cha (helper không ghi file).
 

package/agents/dp-scout.md

@@ -12,6 +12,12 @@ hooks:
         - type: command
           command: '__DP_HOOK__ --watch'
           timeout: 5
+  PreToolUse:
+    - matcher: "Bash|PowerShell"
+      hooks:
+        - type: command
+          command: '__DP_HOOK__ --gate-bash'
+          timeout: 5
 ---
 Bạn là scout/planner của dieu-phoi: khảo sát (code, tài liệu, dữ liệu) theo brief ở tin nhắn đầu (thẻ `[dp:...|role=plan]`) và trả về kế hoạch/câu hỏi đúng định dạng brief. Không sửa file của dự án; Write chỉ dùng để ghi báo cáo/kế hoạch vào run dir.
 
@@ -19,7 +25,7 @@ Bạn là scout/planner của dieu-phoi: khảo sát (code, tài liệu, dữ li
 
 Bàn giao qua file: ghi TOÀN BỘ kết quả vào `dp-out-<task_id>-plan-try<n>.md` trong run dir (đường dẫn brief chỉ định), rồi chỉ trả: đường dẫn file đó, dòng `STATUS:`, và ≤ 3 dòng ý chính. Không đặt tên file `report*` / `summary*` / `findings*` / `analysis*.md` — Claude Code chặn cứng Write các tên đó trong subagent. File dp-out/handoff mà brief trỏ tới là báo cáo chính thức: đọc thẳng, không cần xin thêm quyền.
 
-Repo đích và knowledge: `repo:` trong prompt là repo ĐÍCH (phiên ở repo cha làm việc trên repo con → repo con). Bắt đầu bằng `dieu-phoi knowledge list --repo <repo>` + `knowledge get <id|từ khoá> --repo <repo>` (`--follow` cho phần chép từ repo cha); chưa có kho → ghi vào NOTES. Cấu trúc code: codebase-memory-mcp khi repo đã có index (`list_projects`), không thì Grep/Glob — không tự index. MCP lỗi kết nối/không phản hồi/báo daemon khác version → Grep/Glob ngay, ghi một dòng `codebase-memory: unavailable (<lý do>)` trong dp-out, không thử lại. Bước sửa code chạy song song cùng repo → ghi cần worktree + cổng riêng. Điều không suy ra từ code → `<run>/knowledge-delta-<task_id>.md` (header `repo:`, `## +id` + `paths:`), không tự merge.
+Repo đích và knowledge: `repo:` trong prompt là repo ĐÍCH (phiên ở repo cha làm việc trên repo con → repo con). Bắt đầu bằng `dieu-phoi knowledge list --repo <repo>` + `knowledge get <id|từ khoá> --repo <repo>` (`--follow` cho phần chép từ repo cha); chưa có kho → ghi vào NOTES. Cấu trúc code: codebase-memory-mcp khi repo đã có index (`list_projects`), không thì Grep/Glob — không tự index. MCP lỗi kết nối/không phản hồi/báo daemon khác version → Grep/Glob ngay, ghi một dòng `codebase-memory: unavailable (<lý do>)` trong dp-out, không thử lại. Bước sửa code chạy song song cùng repo → ghi cần worktree + cổng riêng. Chỉ khi có điều không suy ra từ code → `<run>/knowledge-delta-<task_id>.md` (header `repo:`, `## +id` + `paths:`), không tự merge.
 
 Trước STATUS/VERDICT: dừng mọi Bash/PowerShell `run_in_background` và Monitor bạn đã mở (TaskStop), chờ helper đã giao trả xong; không dừng được → ghi `LEFTOVER: <id/lệnh>` trong dp-out.
 

package/agents/dp-verify.md

@@ -12,6 +12,12 @@ hooks:
         - type: command
           command: '__DP_HOOK__ --watch'
           timeout: 5
+  PreToolUse:
+    - matcher: "Bash|PowerShell"
+      hooks:
+        - type: command
+          command: '__DP_HOOK__ --gate-bash'
+          timeout: 5
 ---
 Bạn là agent kiểm chứng (verify) của dieu-phoi: kiểm tra độc lập kết quả của bước exec theo brief ở tin nhắn đầu (thẻ `[dp:...|role=verify]`). Chỉ đọc và chạy lệnh kiểm tra (test, lint, build); không sửa code của dự án. Ghi báo cáo vào run dir (Write chỉ dùng cho báo cáo) và trả về verdict ngắn đúng định dạng brief.
 

package/bin/dieu-phoi.cjs

@@ -18,12 +18,11 @@ 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 [--mode fast|normal|strict] [--json]
+  start [--mode fast|normal] [--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ì ghi "mode: chưa chọn" (mặc định normal); chỉ hỏi người dùng ở cổng 1
-                         khi plan-table báo ≥ 4 bước s≤6
-  mode --root <root_task_id> [fast|normal|strict] [--reason R] [--session S] [--json]
+                         không có --mode thì mặc định normal (0.7.4: không hỏi mode ở cổng 1)
+  mode --root <root_task_id> [fast|normal] [--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]
@@ -36,10 +35,11 @@ Cách dùng: dieu-phoi <lệnh> [tuỳ chọn]
   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ỏ)
+                         accept của người dùng nhắc số worktree đã merge của repo (một dòng); --clean-merged: gỡ luôn (wt clean --merged --yes)
   discard --task <task_id> [--reason R]
                          loại một task nhầm khỏi thống kê/choose/state (ghi sự kiện discard, không sửa log);
                          gỡ worktree có dấu của task nếu sạch (còn thay đổi thì giữ và báo)
-  wt add --task <task_id> [--repo R] [--path D] [--branch B] [--force] [--deps auto|link|install|none] [--deps-path D]
+  wt add --task <task_id> [--repo R] [--path D] [--branch B] [--base REF] [--force] [--deps auto|link|install|none] [--deps-path D]
                          tạo worktree cho một bước: <cha repo>/<tên repo>-wt-<task_id> trên nhánh dp/<task_id>,
                          có dấu dieu-phoi (điều phối viên dùng lệnh này, không git worktree add tay).
                          Repo đủ max_worktrees_repo (8; đếm cả checkout chính) thì từ chối kèm ứng viên dọn; --force vượt trần.
@@ -49,6 +49,9 @@ Cách dùng: dieu-phoi <lệnh> [tuỳ chọn]
   wt clean [--repo R] [--stale-days N] [--yes]
                          liệt kê worktree có dấu mà task đã nghiệm thu / bị loại, thư mục đã mất, hoặc sạch + nhánh đã merge
                          + cũ ≥ N ngày (mặc định wt_stale_days 7); mặc định dry-run, --yes mới gỡ (còn thay đổi luôn giữ; nhánh giữ nguyên)
+  wt clean --merged [--repo R] [--yes]
+                         gỡ worktree có dấu mà nhánh đã vào HEAD checkout chính, có verdict (không reject/fail), tuổi ≥ 1 giờ,
+                         không agent sống, sạch; rồi git branch -d nhánh. Dry-run mặc định; không đụng checkout chính / worktree không dấu
   wt list [--repo R] [--all] [--json]
                          bảng worktree có dấu: task, tuổi, sạch/bẩn, node_modules (link|dir|none), deps của dấu; --all thêm worktree không dấu (chỉ báo)
   steer <agent_id> --kind minor|plan|redirect [--reason R]
@@ -57,11 +60,11 @@ 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] [--publish y|n] [--dependents y|n] [--mode fast|normal|strict]
+         [--verifiable y|n] [--publish y|n] [--dependents y|n] [--mode fast|normal]
          [--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,
-                         verify_plan (independent-blocking|independent-nonblocking|self+batch|spot) theo mode
+                         verify_plan (independent-blocking|independent-nonblocking|self+batch) 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
@@ -82,11 +85,12 @@ Cách dùng: dieu-phoi <lệnh> [tuỳ chọn]
                          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
   retro [--json]         tóm tắt cho vòng retro (không chứa nội dung)
-  prune --after-retro <file retro> [--yes] [--session <id>] [--force]
+  prune --after-retro <file retro> [--yes] [--delta-days N] [--session <id>] [--force]
+  prune --delta-days N [--yes] [--json]           (chỉ dọn delta đã reject của run nhàn rỗi)
                          dọn sau retro: run dir đã nghiệm thu (giữ retro-*.md + dp-out exec/verify cuối), plan hỏng,
                          events cũ → data/archive/*.jsonl.gz (không xoá event). Mặc định dry-run; --yes mới thực hiện
                          (từ chối nếu phiên khác có event trong 15 phút gần nhất, trừ khi --force)
-  knowledge path|rekey|list|get|merge|link|status|bootstrap
+  knowledge path|rekey|list|get|merge|link|status|review|bootstrap
                          kho knowledge theo project (mọi worktree/clone của một repo dùng chung): tra mục bằng get/list,
                          ghi chỉ qua merge --run <id> (delta của agent); knowledge --help
   profile base --save <dir> | apply --base <dir> [--lessons F] [--profile F] [--dry-run]