@kienntpixon/dieu-phoi 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog — @kienntpixon/dieu-phoi
 
+## 0.4.0
+
+Theo bản rà soát telemetry tune0001 (2026-10-12: 886 sự kiện sạch, ~157 task, 8 phiên điều phối).
+
+- **Nâng cấp:** **dán lại `sheet/Code.gs` và deploy bản mới TRƯỚC khi nâng CLI** — Code.gs cũ từ chối kind mới `discard` (rơi vào `sync-rejected.jsonl`), coi `aborted` như verdict thường và tính `orch_share` từ đầu phiên. Sau đó `npm i -g @kienntpixon/dieu-phoi@0.4.0` rồi `dieu-phoi setup`.
+- **Chi phí điều phối tính từ dispatch đầu tiên** của mỗi phiên, không từ đầu phiên (`orchestration.orch_usd_total` / `orch_share`, CLI + sink, fixture parity cập nhật). Trước đây một phiên làm việc khác suốt buổi rồi mới giao một agent bị tính $540 "điều phối": `orch_share` báo 46% trong khi thật ~9,5%, làm tín hiệu retro mục 6 bắn sai.
+- **Outcome mới `aborted`** cho agent dừng vì hết usage limit / quota: không phải pass hay fail, không thành mẫu, không tính leo thang. Hook `SubagentStop` tự ghi verdict `aborted` (`reason_code` `auto-usage-limit` khi dòng cuối là lỗi API "You've hit your … limit" / `rate_limit` / 429; `auto-quota-pause` khi dòng đầu báo cáo cuối là đúng dấu `STATUS: partial — quota-pause`). `verdict <agent_id> aborted` để ghi tay. Dữ liệu cũ: `timeout` có `reason_code` bắt đầu bằng `paused-for-quota` / `quota-pause` / `usage-limit` được đọc là `aborted` (5/18 lượt không pass trong log thật là quota pause, 3 trên sonnet/high). `state` hiện `aborted`, rồi `done` khi agent được làm tiếp và xong; `verdict last` vẫn coi agent `aborted` là chờ verdict.
+- **Leo thang đếm cả làm lại bằng `SendMessage`:** mỗi verdict agent là một kết quả ở tier đó — fail, fail trên **cùng** một agent = 2 fail cùng tier → lên tier (trước đây chỉ verdict cuối của mỗi agent được tính, nên luật "2 fail cùng tier" không bao giờ bắn: 10 agent fail-rồi-pass, 2 agent fail-fail-pass).
+- **`verdict --root <root_task_id> accept [--steps a,b]`:** người dùng nghiệm thu mọi bước đã giao exec của kế hoạch đã duyệt mà chưa có verdict người dùng, trong một lệnh (chỉ 16% task có verdict người dùng).
+- **Steer chỉ tính pha exec:** steer trên scout/planner (trả lời câu hỏi cổng 1) và verifier không vào `steer_rate` / tín hiệu "brainstorm hỏi quá ít" nữa, mà vào cột mới `plan_phase_actions` (16/28 hành động lái trong log thật là trả lời cổng 1 cho scout). `steer --task` không đánh dấu verifier. Sink cũng bỏ steer trên agent không phải exec khỏi cột `steer_*`.
+- **Bài học cho điều phối viên tới được điều phối viên:** `start` (`orch_lessons` trong `--json`) và khối UserPromptSubmit in 5 dòng cuối của `profile/lessons.md` có thẻ `[orch]` (hoặc `[orchestrator]` cũ), mỗi dòng ≤ 240 ký tự.
+- **Override khi duyệt kế hoạch:** `plan-table --approve` ghi sự kiện `override` cho bước có `override` khác đề xuất (cả khi duyệt lại đổi tier); không nhân đôi khi đã có override cùng task + tier. Trước đây override trong file steps không bao giờ thành sự kiện (0 override trong log thật).
+- **Chặn task_type tự đặt:** `choose` đổi nhãn quen sang loại cố định (`bug-fix`→`debug`, `config`/`shell`/`deploy`→`mechanical-edit`, `docs`→`content-write`, `design`/`plan`→`plan-design`, `research`→`research-synth`, `art-fix`→`art-gen` khi profile có, …) kèm `task_type`, `mapped_from`, `type_warning`; nhãn lạ khác → `action:"ask_user"`, `unknown_type:true`. `plan-table` cảnh báo, `--approve` từ chối nhãn lạ, bản ghi kế hoạch lưu loại đã đổi. (23 agent / 9 nhãn tự đặt trong log thật đã rơi về opus/medium.)
+- **Ghi log an toàn hơn:** mỗi sự kiện là một lệnh ghi O_APPEND trọn dòng; file không kết thúc bằng `\n` (tiến trình chết giữa dòng) → ghi `\n` trước để mảnh dở không nuốt sự kiện mới. Điều tra dispatch `a955459fed35d6614` có trên Sheet mà mất ở `events.jsonl`: không phải tranh ghi — một agent theo yêu cầu người dùng đã **sửa tay** log để xoá một yêu cầu nhầm (task `63w6xmsh`, có bản sao `.bak-63w6xmsh`) sau khi dòng đó đã được đẩy lên sink. Sửa gốc: lệnh mới **`dieu-phoi discard --task <id> [--reason R]`** ghi sự kiện `discard` (kind mới, đồng bộ lên sink); CLI (stats/choose/state/verdict --root) và sink bỏ mọi sự kiện của task đó và của agent của nó; `orchestration` giữ nguyên (tiền đã tiêu).
+- (sau verifier) Nhận diện `aborted` chỉ theo dấu chính xác: dòng đầu báo cáo `STATUS: partial — quota-pause`, hoặc dòng lỗi usage limit tổng hợp của Claude Code (`<synthetic>` + `rate_limit`/429/"You've hit your … limit"); `timeout` cũ chỉ đổi thành `aborted` khi `reason_code` bắt đầu bằng `quota-pause|usage-limit|auto-*|paused-for-quota`. `doctor` bỏ qua thư mục có tên giống file tạm.
+- **Cảnh báo context bớt ồn:** `choose --json` thêm `orch_ctx_warn` — `true` chỉ khi vượt một ngưỡng mới của phiên (trần, 2×, 4×, …) hoặc vẫn vượt sau một lần `/compact`; dòng `CẢNH BÁO` của bản chữ chỉ in khi đó (trạng thái ở `data/ctx-warn.json`). `orch_ctx_over` giữ nghĩa cũ. Trước đây cảnh báo bắn ở 78% dispatch.
+- `doctor`: dòng `tmp-files` xoá file `*.tmp-*` bỏ dở cũ hơn 1 giờ (6 file trong máy thật), dòng `plans` cảnh báo kế hoạch có root id sai định dạng.
+- `retro --json`: `outcomes.aborted`, `totals.discarded_tasks`.
+- `time_cap_min` mặc định của core (chỉ dùng khi không có profile) theo profile ai-lab đã tune: feature-impl 80, content-write 40, debug 55.
+- **Không đổi:** priors, λ, `explore_rate`, `orch_ctx_soft_cap`, trần opus/medium, không Fable, không thăm dò task phán đoán / khó hoàn tác / gấp.
+
 ## 0.3.0
 
 - **Khởi động không qua shell:** hook mới `UserPromptSubmit` (`setup` đăng ký, không matcher, timeout 5 s; chạy lại không nhân đôi; `uninstall` gỡ). Chỉ kích hoạt khi prompt **mở đầu** (sau khi cắt khoảng trắng) bằng `/dieu-phoi`, "điều phối" (không phân biệt hoa thường / có dấu hay không, có thể kèm ":") hoặc một cụm đặc trưng "spawn subagents", "orchestrate subagents", "chia việc cho agent", "giao cho subagent"; "điều phối" ở giữa câu ("trung tâm điều phối…", "không cần điều phối") không kích hoạt, yêu cầu kiểu retro / state / stats / lệnh CLI và "điều phối viên…" cũng không → hook tạo sẵn `root_task_id` (cùng bộ sinh với `new-id`), **tạo** run dir `~/.dieu-phoi/runs/<id>/` (theo `DIEU_PHOI_RUNS_DIR`), 10 `step_ids` dự phòng cho các bước, tình trạng sức khoẻ cục bộ và đường dẫn brief scout dựng sẵn, rồi tiêm vào `hookSpecificOutput.additionalContext` (dòng đầu `dieu-phoi: khởi động sẵn (hook UserPromptSubmit, …)`). Prompt khác → im lặng. Không gọi mạng, không ghi sự kiện, luôn exit 0 (lỗi → `hook-errors.log`). Đo: ~40 ms cả tiến trình node, < 5 ms phần xử lý. Lý do: lệnh shell đầu tiên của phiên Claude Code trong repo lớn có thể treo 6–11 phút trước khi có shell snapshot; trước đây `doctor; new-id` nằm đúng trên đường găng của cổng 1.

package/README.md

@@ -8,6 +8,8 @@ Hook + CLI cho skill **dieu-phoi**: ghi lại mỗi lần Claude Code giao việ
 
 ## Cài đặt
 
+> Nâng cấp lên 0.4.0: **dán lại `sheet/Code.gs` và deploy bản mới TRƯỚC khi nâng CLI** — Code.gs cũ từ chối kind mới `discard` và tính `orch_share` theo cách cũ; sau đó `npm i -g @kienntpixon/dieu-phoi@0.4.0` rồi `dieu-phoi setup`.
+>
 > Nâng cấp lên 0.2.0: **dán lại `sheet/Code.gs` và deploy bản mới TRƯỚC khi nâng CLI** — Code.gs cũ bỏ qua (làm rơi) các trường mới `session_id, orch_ctx_tokens, orch_cum_usd, orch_ctx_baseline, orch_compactions` của bản ghi được đẩy lên trong lúc chưa cập nhật; sau đó `npm i -g @kienntpixon/dieu-phoi@0.2.0` rồi `dieu-phoi setup`.
 
 Khuyến nghị cài toàn cục để skill gọi được `dieu-phoi …` trực tiếp:
@@ -36,8 +38,10 @@ Khởi động lại Claude Code sau khi cài. Kiểm tra bằng `dieu-phoi doct
 |---|---|
 | `setup [--dept D] [--sink-url U --sink-token T] [--skill-dir P]` | cài hook, đăng ký `PostToolUse(Agent)` + `SubagentStop` + `SessionStart(compact)` + `UserPromptSubmit` trong settings, ghi config; tạo thư mục báo cáo `~/.dieu-phoi/runs` (env `DIEU_PHOI_RUNS_DIR` để đổi; ngoài `~/.claude` vì đó là protected path) và thêm quyền `Read`/`Edit(~/.dieu-phoi/runs/**)` + `additionalDirectories` để subagent nền ghi được báo cáo (không nhân đôi, có sao lưu); gỡ luật cũ của bản dev cho `~/.claude/dieu-phoi/runs` |
 | `doctor [--net] [--json]` | kiểm node, hook, settings (+ `prompt-hook`), config, profile, sink (từ bộ nhớ đệm 24 giờ; `--net` kiểm trực tiếp); context phiên điều phối hiện tại nếu đo được (`orch-ctx`); thư mục `~/.dieu-phoi/runs` + quyền của nó, không còn luật cũ (`run-permissions`); `--json` có `runs_dir` |
-| `verdict <agent_id\|last> <pass\|fail\|timeout> [--verify tests\|lint\|review\|judgment\|none] [--reason short-kebab]` | nghiệm thu tầng agent (`by=agent`). `last` = agent hoàn thành gần nhất; từ chối (liệt kê ứng viên) nếu trong 30 phút qua có > 1 agent xong mà chưa có verdict. Được viết tắt agent_id nếu không trùng |
+| `verdict <agent_id\|last> <pass\|fail\|timeout\|aborted> [--verify tests\|lint\|review\|judgment\|none] [--reason short-kebab]` | nghiệm thu tầng agent (`by=agent`). `aborted` (0.4.0) = dừng vì usage limit/quota: không pass/fail, không leo thang; hook tự ghi khi bắt được. `last` = agent hoàn thành gần nhất; từ chối (liệt kê ứng viên) nếu trong 30 phút qua có > 1 agent xong mà chưa có verdict. Được viết tắt agent_id nếu không trùng |
 | `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`: `quality` = làm sai (tính là fail), `scope` = yêu cầu đổi/thiếu (không tính cho model). `--round` mặc định tự tăng |
+| `verdict --root <root_task_id> accept [--steps a,b]` | (0.4.0) người dùng nhận một lúc mọi bước đã giao exec của kế hoạch đã duyệt mà chưa có verdict người dùng |
+| `discard --task <task_id> [--reason R]` | (0.4.0) rút một task nhầm khỏi stats/choose/state/sink bằng sự kiện `discard` — không bao giờ sửa tay `events.jsonl` |
 | `steer <agent_id> \| --task <task_id> --kind minor\|plan\|redirect [--reason R]` | ghi **một** lần người dùng lái giữa chừng (một `steer_id`). `--task` chỉ đánh dấu agent đang chạy của task; không có agent nào đang chạy → bản ghi cấp task. `plan`/`redirect` trước verdict loại lượt đó khỏi tỉ lệ của tier (chi phí vẫn tính); steer không xoá fail đã ghi |
 | `stats [--type T] [--json]` | các ô `task_type × model/effort` theo "Thước đo" của `CONTRACT.md`: n, n_excluded, accept_rate, agent_pass_rate, chi phí/thời gian mỗi task (TB, p50, p75); bảng steer theo task_type; tóm tắt điều phối (`orchestration`: số phiên, context p50/max, chi phí điều phối vs subagent, `orch_share`) |
 | `choose --type T --score N [--urgency U] [--reversible y\|n] [--verifiable y\|n] [--role R] [--task ID] [--override M/E \| --approved M/E] [--skill-dir P] [--seed S] [--json]` | đề xuất model + effort kèm lý do, `action`, `role`, ước tính chi phí/thời gian. `--override` cần `--task`. Kèm `orch_ctx_tokens`, `orch_ctx_growth`, `orch_ctx_over` (như `ctx`); vượt trần mềm → thêm một dòng cảnh báo |
@@ -53,7 +57,7 @@ Khởi động lại Claude Code sau khi cài. Kiểm tra bằng `dieu-phoi doct
 ### `choose`
 
 1. **Luật an toàn** (cố định trong core): trần `opus/medium` (opus/high, xhigh, max, Fable bị kẹp về opus/medium; `--override opus/high` bị từ chối). Sàn: score ≥ 9 → opus/medium; `--verifiable n` → tối thiểu opus/medium; `--reversible n` → tối thiểu opus/medium (role exec). Score ≥ 9, `--verifiable n`, `--reversible n` hoặc `urgent` → không thăm dò xuống tier thấp. Sàn được ghi rõ trong `reason`.
-2. **Leo thang** với `--task <task_id>`: fail 1 lần → cùng tier (làm lại kèm lỗi); fail 2 lần cùng tier → lên một tier; tier kế vượt opus/medium (role exec) → **không tự lập lại kế hoạch**, trả `action: "ask_user"` kèm `fails` và `tried` để hỏi người dùng. Fail = agent `fail|timeout` hoặc người dùng `reject --cause quality`. Lượt bị steer `plan`/`redirect` không tính.
+2. **Leo thang** với `--task <task_id>`: fail 1 lần → cùng tier (làm lại kèm lỗi); fail 2 lần cùng tier → lên một tier; tier kế vượt opus/medium (role exec) → **không tự lập lại kế hoạch**, trả `action: "ask_user"` kèm `fails` và `tried` để hỏi người dùng. Fail = agent `fail|timeout` hoặc người dùng `reject --cause quality`; mỗi verdict là một kết quả, nên làm lại bằng `SendMessage` cho cùng agent cũng được đếm (0.4.0); `aborted` không bao giờ tính. Lượt bị steer `plan`/`redirect` không tính.
 3. **Prior** từ `<skill-dir>/profile/profile.json` (không thấy thì dùng bản sao dựng sẵn của `skill/profile/profile.json` v1.0.0). `profile_source` trong kết quả cho biết đang dùng file nào (`builtin` hoặc đường dẫn).
 4. **Thompson sampling** khi ô của prior có ≥ 5 task đã xong + có verdict: rút p ~ Beta(1+pass, 1+fail) cho từng tier đủ dữ liệu, điểm = E[cost]/p + λ·E[time_phút]/p (urgent dùng p75 thời gian), chọn điểm thấp nhất. Tier có p75 vượt `time_cap_min` của loại task bị loại.
 5. **Thăm dò** một tier thấp hơn với xác suất `explore_rate` (mặc định 0.1) khi luật an toàn cho phép.
@@ -85,7 +89,7 @@ Kết quả `--json`: `{"action":"dispatch","model":"sonnet","model_id":"claude-
 
 ## Dữ liệu
 
-- Sự kiện: `~/.claude/dieu-phoi/data/events.jsonl` (`dispatch`, `complete`, `verdict`, `steer`, `override`; `schema: 1`), xem `CONTRACT.md`. File chỉ ghi nối (append-only), không bao giờ viết lại. Tiến độ đẩy lên sink nằm ở `data/sync-offset.json` (byte offset sau dòng cuối đã đẩy); trạng thái segment từng agent ở `data/segments/<agent_id>.json`.
+- Sự kiện: `~/.claude/dieu-phoi/data/events.jsonl` (`dispatch`, `complete`, `verdict`, `steer`, `override`, `discard`; `schema: 1`), xem `CONTRACT.md`. File chỉ ghi nối (append-only), không bao giờ viết lại. Tiến độ đẩy lên sink nằm ở `data/sync-offset.json` (byte offset sau dòng cuối đã đẩy); trạng thái segment từng agent ở `data/segments/<agent_id>.json`.
 - Lỗi của hook: `~/.claude/dieu-phoi/hook-errors.log`.
 - Subagent nội bộ của Claude Code (không có transcript, không qua Agent tool) không được ghi; số lần bỏ qua ở `data/skipped-internal.json`. Log cũ của 0.1.0 có các `complete` rỗng loại này — `stats`/`retro` tự bỏ qua, không cần sửa file (từ 0.1.1).
 - Người dùng chỉ lưu dạng sha256 rút gọn 8 ký tự (`git config user.email`, không có thì tên tài khoản máy). Phiên: `session` = sha256-8; từ 0.2.0 `dispatch` có thêm `session_id` thô (mã phiên, không phải nội dung) để nối với `dieu-phoi ctx`.

package/bin/dieu-phoi.cjs

@@ -13,10 +13,14 @@ Cách dùng: dieu-phoi <lệnh> [tuỳ chọn]
   doctor [--net]         kiểm hook, node, config, sink (sink lấy từ bộ nhớ đệm 24 giờ; --net kiểm trực tiếp)
   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> [--verify tests|lint|review|judgment|none] [--reason short-kebab]
-                         nghiệm thu tầng agent (by=agent)
+  verdict <agent_id|last> <pass|fail|timeout|aborted> [--verify tests|lint|review|judgment|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 --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
+  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)
   steer <agent_id> --kind minor|plan|redirect [--reason R]
   steer --task <task_id> --kind minor|plan|redirect [--reason R]
                          ghi một lần người dùng lái giữa chừng (--task: chỉ các agent đang chạy của task)
@@ -68,6 +72,7 @@ async function main(argv) {
     start: c.cmdStart,
     verdict: c.cmdVerdict,
     steer: c.cmdSteer,
+    discard: c.cmdDiscard,
     'plan-table': c.cmdPlanTable,
     'new-id': c.cmdNewId,
     stats: c.cmdStats,

package/hook.cjs

@@ -20,7 +20,7 @@ const path = require('path');
 const os = require('os');
 const crypto = require('crypto');
 
-const CORE_VERSION = '0.3.0';
+const CORE_VERSION = '0.4.0';
 const SCHEMA = 1;
 const TASK_TYPES = [
   'search', 'extract', 'mechanical-edit', 'feature-impl', 'debug', 'refactor',
@@ -737,10 +737,30 @@ function findSessionTranscript(claudeDir, sessionId) {
 
 // ------------------------------------------------------------------ events (append-only)
 
-/** Append one event. events.jsonl is append-only: never rewritten, sync progress lives elsewhere. */
+/**
+ * Append one event. events.jsonl is append-only: never rewritten, sync progress lives elsewhere.
+ * Core 0.4.0: one O_APPEND write of the whole line (hooks of parallel agents may append at the same time:
+ * an O_APPEND write lands as one unit, so lines never interleave). If the file does not
+ * end with '\n' (a writer died mid-line), a '\n' is written first so the torn fragment cannot swallow this
+ * event — readers skip the fragment as one unparsable line. Withdrawing a task = `dieu-phoi discard`, never an
+ * edit of this file.
+ */
 function appendEvent(ctx, ev) {
   fs.mkdirSync(ctx.paths.data, { recursive: true });
-  fs.appendFileSync(ctx.paths.events, `${JSON.stringify(ev)}\n`);
+  const fd = fs.openSync(ctx.paths.events, 'a+');
+  try {
+    let lead = '';
+    const size = fs.fstatSync(fd).size;
+    if (size > 0) {
+      const last = Buffer.alloc(1);
+      if (fs.readSync(fd, last, 0, 1, size - 1) === 1 && last[0] !== 0x0a) lead = '\n';
+    }
+    const buf = Buffer.from(`${lead}${JSON.stringify(ev)}\n`, 'utf8');
+    let off = 0;
+    while (off < buf.length) off += fs.writeSync(fd, buf, off, buf.length - off);
+  } finally {
+    fs.closeSync(fd);
+  }
 }
 
 function readEventsBuffer(ctx) {
@@ -859,7 +879,10 @@ function verdictLayer(ev) {
   const by = ev.by === 'user' ? 'user' : 'agent';
   let cause = ev.cause || null;
   if (by === 'user' && ev.outcome === 'reject' && cause !== 'scope') cause = 'quality';
-  return { by, outcome: ev.outcome, cause };
+  // legacy quota pause recorded as timeout → aborted (same reading as the stats)
+  const outcome = by === 'agent' && ev.outcome === 'timeout' && /^(?:quota-pause|usage-limit|auto-quota-pause|auto-usage-limit|paused-for-quota)(?:-|$)/.test(String(ev.reason_code || ''))
+    ? 'aborted' : ev.outcome;
+  return { by, outcome, cause };
 }
 
 function dispatchInSession(ev, sessionId) {
@@ -893,7 +916,9 @@ function buildSessionState(events, sessionId, opts) {
   const runs = toPosix(o.runsDir || runsDir());
   const taskIds = [];
   const seenTask = new Set();
+  const discarded = new Set(events.filter((ev) => ev && ev.kind === 'discard' && ev.task_id).map((ev) => ev.task_id));
   for (const ev of events) {
+    if (ev && discarded.has(ev.task_id)) continue;
     if (dispatchInSession(ev, sessionId) && typeof ev.task_id === 'string' && ev.task_id && !seenTask.has(ev.task_id)) {
       seenTask.add(ev.task_id);
       taskIds.push(ev.task_id);
@@ -908,7 +933,7 @@ function buildSessionState(events, sessionId, opts) {
     for (const s of p.steps) if (s && s.task_id && !stepOf.has(s.task_id)) stepOf.set(s.task_id, { plan: p, step: s });
   }
   for (const id of [...planOfRoot.keys(), ...stepOf.keys()]) {
-    if (!seenTask.has(id)) { seenTask.add(id); taskIds.push(id); }
+    if (!seenTask.has(id) && !discarded.has(id)) { seenTask.add(id); taskIds.push(id); }
   }
   const per = new Map(taskIds.map((id) => [id, { dispatches: [], user: [], steers: [], overrides: [], agentIds: new Set() }]));
   events.forEach((ev, i) => {
@@ -925,7 +950,7 @@ function buildSessionState(events, sessionId, opts) {
   const agentVerdicts = new Map();
   for (const ev of events) {
     if (!ev || typeof ev !== 'object') continue;
-    if (ev.kind === 'complete' && agentTask.has(ev.agent_id)) completes.set(ev.agent_id, (completes.get(ev.agent_id) || 0) + 1);
+    if (ev.kind === 'complete' && agentTask.has(ev.agent_id)) completes.set(ev.agent_id, Math.max(completes.get(ev.agent_id) || 1, evMs(ev) || 1));
     if (ev.kind === 'verdict') {
       const v = verdictLayer(ev);
       if (v.by === 'user') {
@@ -970,7 +995,9 @@ function buildSessionState(events, sessionId, opts) {
       const vs = (agentVerdicts.get(d.agent_id) || []).slice().sort(byTime);
       const last = vs[vs.length - 1];
       let status;
-      if (last) status = last.outcome;
+      // aborted (quota pause) then resumed and completed again, no verdict yet → done (waiting for a verdict)
+      if (last && last.outcome === 'aborted' && (completes.get(d.agent_id) || 0) > evMs(last)) status = 'done';
+      else if (last) status = last.outcome;
       else status = completes.get(d.agent_id) ? 'done' : 'running';
       return {
         agent_id: d.agent_id, role: d.role || 'exec', try: d.try === undefined ? null : d.try,
@@ -1209,6 +1236,32 @@ function scoutBriefPath(ctx) {
   return fs.existsSync(f) ? toPosix(f) : null;
 }
 
+const ORCH_LESSON_RE = /\[(?:orch|orchestrator)\]/i;
+const ORCH_LESSONS_MAX = 5;
+const ORCH_LESSON_CHARS = 240;
+const LESSONS_MAX_BYTES = 256 * 1024;
+
+/**
+ * Lessons addressed to the orchestrator (core 0.4.0): list lines of <skill_dir>/profile/lessons.md that carry the
+ * tag `[orch]` (legacy `[orchestrator]`), the last ORCH_LESSONS_MAX of them, each cut to ORCH_LESSON_CHARS chars.
+ * The orchestrator never reads lessons.md itself; `start` and the UserPromptSubmit block surface these lines.
+ */
+function orchLessons(ctx) {
+  const sd = ctx.config && ctx.config.skill_dir;
+  if (!sd) return [];
+  let txt;
+  try {
+    const f = path.join(sd, 'profile', 'lessons.md');
+    if (fs.statSync(f).size > LESSONS_MAX_BYTES) return [];
+    txt = fs.readFileSync(f, 'utf8');
+  } catch (_) { return []; }
+  const out = txt.split(/\r?\n/).map((l) => l.trim())
+    .filter((l) => /^[-*] /.test(l) && ORCH_LESSON_RE.test(l))
+    .map((l) => l.replace(/^[-*] +/, ''))
+    .map((l) => (l.length > ORCH_LESSON_CHARS ? `${l.slice(0, ORCH_LESSON_CHARS - 1)}…` : l));
+  return out.slice(-ORCH_LESSONS_MAX);
+}
+
 /** Local, network-free health: config, profile, run dir, cached sink status. */
 function quickHealth(ctx, runs) {
   const problems = [];
@@ -1256,7 +1309,15 @@ function stepIds(root, n) {
 function startInfo(ctx) {
   const run = startRun();
   const health = quickHealth(ctx, run.runs);
-  return { id: run.id, run_dir: run.run_dir, step_ids: stepIds(run.id, START_STEP_IDS), health, scout_brief: scoutBriefPath(ctx) };
+  return {
+    id: run.id, run_dir: run.run_dir, step_ids: stepIds(run.id, START_STEP_IDS), health, scout_brief: scoutBriefPath(ctx),
+    orch_lessons: orchLessons(ctx),
+  };
+}
+
+function orchLessonLines(info) {
+  const ls = (info && info.orch_lessons) || [];
+  return ls.length ? ['bài học cho điều phối viên (profile/lessons.md, [orch]):'].concat(ls.map((l) => `  - ${l}`)) : [];
 }
 
 function formatStartBlock(info) {
@@ -1267,6 +1328,7 @@ function formatStartBlock(info) {
     `step_ids: ${info.step_ids.join(' ')}`,
     `health: ${healthLine(info.health)}`,
     `scout_brief: ${info.scout_brief || '(không thấy — dùng references/brief-template.md mục E)'}`,
+    ...orchLessonLines(info),
     'Dùng khối này cho yêu cầu MỚI ở cổng 1 (không dùng nếu đang giữa một lần điều phối). Không chạy `dieu-phoi doctor` / `new-id` / mkdir: lượt đầu tiên là Agent scout + câu hỏi cổng 1 cho người dùng.',
   ].join('\n');
 }
@@ -1425,9 +1487,50 @@ function handleSubagentStop(p, ctx) {
     });
   }
   appendEvent(ctx, ev);
+  // Core 0.4.0: a segment that ended on a usage-limit / quota pause gets an automatic agent verdict
+  // `aborted` (never a fail, never counted toward escalation); the real verdict comes after the resume.
+  const why = exists ? abortReasonOf(lines) : null;
+  if (why) {
+    appendEvent(ctx, Object.assign({
+      schema: SCHEMA, kind: 'verdict', ts: nowIso(), agent_id: agentId, task_id: t.task_id, by: 'agent', outcome: 'aborted',
+      verify: 'none', reason_code: `auto-${why}`, cause: null, round: null,
+    }, commonFields(ctx)));
+  }
   return ev;
 }
 
+// Exact marker an agent puts on the FIRST line of its final report when it stops at a safe point because of a quota
+// / usage limit (brief template A, SKILL.md). Nothing looser: "STATUS: partial" + "quota" can be a real failure
+// ("Drive storage quota exceeded", a half-built rate limiter).
+const QUOTA_PAUSE_MARKER = 'STATUS: partial — quota-pause';
+// Claude Code's own usage-limit stop text on its synthetic API-error line ("You've hit your session limit · resets 11am").
+const CC_LIMIT_TEXT_RE = /^You['’]ve hit your (?:[\w-]+ )?limit\b/;
+
+/**
+ * Why the agent's last segment stopped on a usage limit, or null. Reads only the LAST assistant line:
+ * - Claude Code's synthetic API-error line (`model:"<synthetic>"` + `isApiErrorMessage:true`) whose `error` is
+ *   "rate_limit", or HTTP 429, or whose text starts "You've hit your … limit" → "usage-limit";
+ * - the agent's final report whose first line starts with the exact marker QUOTA_PAUSE_MARKER → "quota-pause".
+ * Only a short label is returned; no text is stored.
+ */
+function abortReasonOf(lines) {
+  let last = null;
+  for (let i = lines.length - 1; i >= 0; i--) {
+    const l = lines[i];
+    if (l && l.type === 'assistant' && l.message) { last = l; break; }
+  }
+  if (!last) return null;
+  const content = Array.isArray(last.message.content) ? last.message.content : [];
+  const text = content.filter((c) => c && c.type === 'text' && typeof c.text === 'string').map((c) => c.text).join('\n').slice(0, 2000);
+  if (last.isApiErrorMessage === true) {
+    if (last.message.model !== '<synthetic>') return null;
+    if (last.error === 'rate_limit' || last.apiErrorStatus === 429 || CC_LIMIT_TEXT_RE.test(text.trim())) return 'usage-limit';
+    return null;
+  }
+  if (text.trimStart().split('\n')[0].trim().startsWith(QUOTA_PAUSE_MARKER)) return 'quota-pause';
+  return null;
+}
+
 function maybeSpawnSync(ctx) {
   if (!ctx.config.sink_url || !ctx.config.sink_token) return false;
   if (process.env.DIEU_PHOI_NO_SPAWN === '1') return false;
@@ -1632,7 +1735,7 @@ async function runSync(ctx, opts) {
 // ------------------------------------------------------------------ exports / main
 
 module.exports = {
-  runsDir, loadPlans, isDieuPhoiPrompt, foldPrompt, sinkStatusCached, sinkUrlKey, SINK_CACHE_TTL_MS, scoutBriefPath, quickHealth, startRun, startInfo, stepIds, START_STEP_IDS, healthLine, formatStartBlock, handleUserPromptSubmit, START_PREFIX, buildSessionState, formatSessionState, stateCounts, compactSystemMessage, handleSessionStart, dispatchInSession, STATE_TEXT_CAP, COMPACT_PREFIX,
+  runsDir, loadPlans, isDieuPhoiPrompt, foldPrompt, sinkStatusCached, sinkUrlKey, SINK_CACHE_TTL_MS, scoutBriefPath, quickHealth, startRun, startInfo, orchLessons, orchLessonLines, abortReasonOf, QUOTA_PAUSE_MARKER, stepIds, START_STEP_IDS, healthLine, formatStartBlock, handleUserPromptSubmit, START_PREFIX, buildSessionState, formatSessionState, stateCounts, compactSystemMessage, handleSessionStart, dispatchInSession, STATE_TEXT_CAP, COMPACT_PREFIX,
   CORE_VERSION, SCHEMA, TASK_TYPES, URGENCIES, ROLES, MODEL_ALIASES, UNTAGGED,
   sha8, nowIso, readJsonFile, writeFileAtomic, defaultClaudeDir, resolveHome, pathsFor, loadConfig, makeCtx,
   logError, computeUserHash, userHash, commonFields, parseTag, TASK_ID_RE, isValidTaskId, newTaskId, taskIdError, normalizeModel, loadPricing,

package/lib/aggregate.cjs

@@ -9,6 +9,12 @@ const core = require('../hook.cjs');
 const MIN_N = 5;
 const FAIL_OUTCOMES = new Set(['fail', 'timeout']);
 const HEAVY_STEERS = new Set(['plan', 'redirect']);
+// core 0.4.0: an agent stopped by a usage-limit/quota pause is `aborted` — neither pass nor fail. Legacy
+// rows recorded such pauses as `timeout` with a quota-ish reason_code; they are read as `aborted` too.
+const ABORTED = 'aborted';
+// Exact markers only (anchored): `quota-pause`, `usage-limit`, the hook's `auto-*` codes and the legacy
+// `paused-for-quota-*` codes the orchestrator wrote before 0.4.0. A reason that merely mentions a rate limit stays a timeout.
+const QUOTA_REASON_RE = /^(?:quota-pause|usage-limit|auto-quota-pause|auto-usage-limit|paused-for-quota)(?:-|$)/;
 
 function tsOf(ev) {
   const t = Date.parse(ev && ev.ts);
@@ -56,7 +62,33 @@ function normalizeVerdict(ev) {
   const by = ev.by === 'user' ? 'user' : 'agent';
   let cause = ev.cause || null;
   if (by === 'user' && ev.outcome === 'reject' && cause !== 'scope') cause = 'quality';
-  return { by, outcome: ev.outcome, cause, round: Number(ev.round) || null };
+  let outcome = ev.outcome;
+  if (by === 'agent' && outcome === 'timeout' && typeof ev.reason_code === 'string' && QUOTA_REASON_RE.test(ev.reason_code)) {
+    outcome = ABORTED;
+  }
+  return { by, outcome, cause, round: Number(ev.round) || null };
+}
+
+/**
+ * Task ids withdrawn with `dieu-phoi discard --task` (kind=discard). Every event of such a task — and every
+ * event of an agent dispatched for it — is left out of tasks, cells and steers (CONTRACT "Sự kiện cục bộ").
+ */
+function discardedTaskIds(events) {
+  const out = new Set();
+  for (const ev of events) if (ev && ev.kind === 'discard' && typeof ev.task_id === 'string' && ev.task_id) out.add(ev.task_id);
+  return out;
+}
+
+/** Events with discarded tasks (and the discard records themselves) replaced by null; order kept. */
+function withoutDiscarded(events) {
+  const gone = discardedTaskIds(events);
+  const agents = new Set(events.filter((ev) => ev && ev.kind === 'dispatch' && gone.has(ev.task_id)).map((ev) => ev.agent_id));
+  return events.map((ev) => {
+    if (!ev || typeof ev !== 'object' || ev.kind === 'discard') return null;
+    if (gone.has(ev.task_id) || agents.has(ev.agent_id)) return null;
+    if (typeof ev.agent_id === 'string' && ev.agent_id.startsWith('task:') && gone.has(ev.agent_id.slice(5))) return null;
+    return ev;
+  });
 }
 
 function blank(v) {
@@ -111,7 +143,9 @@ function buildAgents(events) {
     const d = a.dispatch || {};
     const c0 = a.completes[0] || {};
     const cl = a.completes[a.completes.length - 1] || {};
-    const v = a.verdicts.slice().sort((x, y) => tsOf(x) - tsOf(y) || x._idx - y._idx);
+    const vAll = a.verdicts.slice().sort((x, y) => tsOf(x) - tsOf(y) || x._idx - y._idx);
+    // `aborted` (quota pause) is neither pass nor fail: it never sets the outcome nor counts as a result.
+    const v = vAll.filter((x) => x.outcome !== ABORTED);
     const verdict = v.length ? v[v.length - 1] : null;
     const firstVerdictTs = v.length ? tsOf(v[0]) : Infinity;
     const pick = (k) => (d[k] !== undefined && d[k] !== null ? d[k] : (c0[k] !== undefined && c0[k] !== null ? c0[k] : null));
@@ -137,6 +171,9 @@ function buildAgents(events) {
       tool_uses: a.completes.length ? sumOrNull(a.completes.map((x) => x.tool_uses)) : null,
       outcome: verdict ? verdict.outcome : null,
       first_outcome: v.length ? v[0].outcome : null,
+      // every non-aborted agent verdict in time order: a retry by SendMessage to the same agent is a new result
+      verdict_seq: v.map((x) => ({ outcome: x.outcome, ts: tsOf(x), idx: x._idx })),
+      aborted: vAll.length > 0 && vAll[vAll.length - 1].outcome === ABORTED,
       verify: verdict ? verdict.verify : null,
       reason_code: verdict ? verdict.reason_code : null,
       steers: a.steers.map((s) => s.steer_kind).filter(Boolean),
@@ -175,16 +212,25 @@ function buildTasks(agents, userVerdicts) {
     const first = t.agents.filter((a) => a.role === 'exec').sort(byTry)[0] || null;
     const user = t.user.slice().sort((x, y) => ((x.round || 0) - (y.round || 0)) || (tsOf(x) - tsOf(y)) || (x._idx - y._idx));
 
-    // Effective per-attempt outcome for escalation: agent verdict, overridden by a user verdict
-    // landing on the latest attempt dispatched before it (reject/quality = fail, accept = pass).
-    for (const a of attempts) a.eff_outcome = a.outcome === 'pass' ? 'pass' : (FAIL_OUTCOMES.has(a.outcome) ? 'fail' : null);
+    // Results for escalation. Each agent verdict of an attempt is one result at its tier (a retry by
+    // SendMessage to the same agent is a new result); a user verdict adds a result to the latest attempt
+    // dispatched before it (reject/quality = fail, accept = pass). eff_outcome = the attempt's latest result.
+    for (const a of attempts) {
+      a.results = (a.verdict_seq || [])
+        .filter((x) => x.outcome === 'pass' || FAIL_OUTCOMES.has(x.outcome))
+        .map((x) => ({ outcome: x.outcome === 'pass' ? 'pass' : 'fail', ts: x.ts, idx: x.idx }));
+      a.eff_outcome = a.results.length ? a.results[a.results.length - 1].outcome : null;
+    }
     for (const v of user) {
       if (v.cause === 'scope') continue;
       const vt = tsOf(v);
       let target = null;
       for (const a of attempts) if (a.ts <= vt && (!target || a.ts >= target.ts)) target = a;
       if (!target) target = attempts[attempts.length - 1] || null;
-      if (target) target.eff_outcome = v.outcome === 'accept' ? 'pass' : 'fail';
+      if (target) {
+        target.eff_outcome = v.outcome === 'accept' ? 'pass' : 'fail';
+        target.results.push({ outcome: target.eff_outcome, ts: vt, idx: v._idx, user: true });
+      }
     }
 
     const firstUser = user[0] || null;
@@ -307,13 +353,19 @@ function canonicalCells(cells) {
   return cells.map((c) => Object.fromEntries(CANONICAL_CELL_FIELDS.map((k) => [k, c[k] === undefined ? null : c[k]])));
 }
 
-/** Steering per task_type, counted in distinct user actions (steer_id), not events. */
+/**
+ * Steering per task_type, counted in distinct user actions (steer_id), not events. Core 0.4.0: only
+ * exec-phase steers count — a steer on a role=exec agent, or a task-level steer on a task that has an exec
+ * attempt. Steers on scouts/planners (gate-1 Q&A) and on verifiers go to `plan_phase_actions` and never
+ * touch actions / steer_rate.
+ */
 function buildSteers(tasks, steers, agents) {
   const typeOfTask = new Map(tasks.map((t) => [t.task_id, t.task_type]));
+  const execTask = new Set(tasks.filter((t) => t.first && t.task_id).map((t) => t.task_id));
   const agentById = new Map(agents.map((a) => [a.agent_id, a]));
   const by = {};
   const row = (type) => by[type] || (by[type] = {
-    task_type: type, tasks: 0, steered_tasks: 0, actions: 0, minor: 0, plan: 0, redirect: 0, _tasks: new Set(), _ids: new Set(),
+    task_type: type, tasks: 0, steered_tasks: 0, actions: 0, minor: 0, plan: 0, redirect: 0, _tasks: new Set(), _ids: new Set(), _plan: new Set(),
   });
   for (const t of tasks) if (t.first) row(t.task_type).tasks++;
   for (const s of steers) {
@@ -322,6 +374,8 @@ function buildSteers(tasks, steers, agents) {
     const type = (taskId && typeOfTask.get(taskId)) || s.task_type || (a && a.task_type) || 'untagged';
     const r = row(type);
     const id = steerIdOf(s);
+    const execPhase = a ? a.role === 'exec' : !(taskId && typeOfTask.has(taskId) && !execTask.has(taskId));
+    if (!execPhase) { r._plan.add(id); continue; }
     if (r._ids.has(id)) continue;
     r._ids.add(id);
     r.actions++;
@@ -334,6 +388,7 @@ function buildSteers(tasks, steers, agents) {
       task_type: r.task_type, tasks: r.tasks, steered_tasks: steered, actions: r.actions,
       minor: r.minor, plan: r.plan, redirect: r.redirect,
       steer_rate: r.tasks ? round6(Math.min(1, steered / r.tasks)) : 0,
+      plan_phase_actions: Array.from(r._plan).filter((x) => !r._ids.has(x)).length,
     };
     return outRow;
   }).sort((a, b) => b.steer_rate - a.steer_rate || a.task_type.localeCompare(b.task_type));
@@ -345,7 +400,8 @@ function finiteNum(v) {
 
 /**
  * Orchestration cost (CONTRACT "Thước đo" mục 6). Sessions = distinct non-empty `session_id` over
- * dispatch events. Per session: ctx = max orch_ctx_tokens, usd = max orch_cum_usd, growth = max of
+ * dispatch events. Per session: ctx = max orch_ctx_tokens, usd = max orch_cum_usd minus orch_cum_usd of the
+ * session's first dispatch carrying a number (core 0.4.0; never negative), growth = max of
  * max(0, orch_ctx_tokens - orch_ctx_baseline) over dispatches carrying both, comp = max orch_compactions
  * (numbers only). compactions_total = sum of per-session comp, compactions_max = max.
  * Each agent belongs to the session of its FIRST dispatch (file order); sub_usd_total sums the
@@ -357,11 +413,14 @@ function orchestrationSummary(events) {
   for (const ev of events) {
     if (!ev || ev.kind !== 'dispatch' || typeof ev.session_id !== 'string' || !ev.session_id) continue;
     const sid = ev.session_id;
-    if (!sessions.has(sid)) sessions.set(sid, { ctx: null, usd: null, growth: null, comp: null });
+    if (!sessions.has(sid)) sessions.set(sid, { ctx: null, usd: null, base: null, growth: null, comp: null });
     const s = sessions.get(sid);
     const c = finiteNum(ev.orch_ctx_tokens);
     const u = finiteNum(ev.orch_cum_usd);
     if (c !== null && (s.ctx === null || c > s.ctx)) s.ctx = c;
+    // core 0.4.0: orchestrator cost counts from the session's FIRST dispatch carrying a number (file order),
+    // not from session start — whatever the session did before it started dispatching is not orchestration.
+    if (u !== null && s.base === null) s.base = u;
     if (u !== null && (s.usd === null || u > s.usd)) s.usd = u;
     const k = finiteNum(ev.orch_compactions);
     if (k !== null && (s.comp === null || k > s.comp)) s.comp = k;
@@ -386,7 +445,7 @@ function orchestrationSummary(events) {
     if (s.ctx !== null) ctxs.push(s.ctx);
     if (s.growth !== null) growths.push(s.growth);
     if (s.comp !== null) comps.push(s.comp);
-    if (s.usd !== null) orch += s.usd;
+    if (s.usd !== null) orch += Math.max(0, s.usd - s.base);
   }
   return {
     sessions: sessions.size,
@@ -403,7 +462,7 @@ function orchestrationSummary(events) {
 }
 
 function analyze(events, opts) {
-  const { agents, userVerdicts, overrides, steers } = buildAgents(events);
+  const { agents, userVerdicts, overrides, steers } = buildAgents(withoutDiscarded(events));
   const tasks = buildTasks(agents, userVerdicts);
   const cells = buildCells(tasks, opts);
   return {
@@ -413,6 +472,6 @@ function analyze(events, opts) {
 }
 
 module.exports = {
-  MIN_N, FAIL_OUTCOMES, HEAVY_STEERS, CANONICAL_CELL_FIELDS, normalizeVerdict, isInternalComplete, buildAgents, buildTasks,
+  MIN_N, FAIL_OUTCOMES, HEAVY_STEERS, ABORTED, QUOTA_REASON_RE, discardedTaskIds, withoutDiscarded, CANONICAL_CELL_FIELDS, normalizeVerdict, isInternalComplete, buildAgents, buildTasks,
   buildCells, buildSteers, canonicalCells, orchestrationSummary, analyze, cellKey, mean, percentile, tsOf, steerIdOf,
 };

package/lib/choose.cjs

@@ -19,7 +19,8 @@ const LADDER = [
 const TOP = LADDER.length - 1;
 const EFFORT_RANK = { low: 0, medium: 1, high: 2, xhigh: 3, max: 4 };
 
-// Built-in defaults = skill/profile/profile.json (v1.0.0); used only when no profile is found.
+// Built-in defaults = skill/profile/profile.json for the fixed task types (time caps as tuned 2026-10-12: feature-impl 80,
+// content-write 40, debug 55 — the old ones sat below the observed p50); used only when no profile is found.
 const DEFAULT_PRIORS = {
   search: 'haiku/medium',
   extract: 'haiku/medium',
@@ -38,13 +39,13 @@ const DEFAULT_TIME_CAP_MIN = {
   search: 3,
   extract: 5,
   'mechanical-edit': 10,
-  'feature-impl': 25,
-  debug: 25,
+  'feature-impl': 80,
+  debug: 55,
   refactor: 30,
   'test-write': 15,
   review: 10,
   'research-synth': 20,
-  'content-write': 15,
+  'content-write': 40,
   'plan-design': 15,
   'data-analysis': 15,
 };
@@ -187,25 +188,35 @@ const OPUS_MEDIUM = 5;
  * - one fail at a tier -> same tier again (retry with the error);
  * - two fails at the same tier -> next tier up;
  * - if that next tier would exceed the opus/medium ceiling -> ask the user (no auto re-plan).
- * Fail = agent fail|timeout or user reject cause=quality (eff_outcome). Attempts steered
- * plan/redirect by the user are ignored.
+ * Fail = agent fail|timeout or user reject cause=quality. Core 0.4.0: every result counts, so a retry by
+ * SendMessage to the same agent (fail, then fail again) is two fails at that tier; `aborted` (quota pause)
+ * is never a result. Attempts steered plan/redirect by the user are ignored.
  */
 function escalation(task, role) {
   const none = { floor: 0, ask: false, note: null, fails: 0, tried: [] };
   if (!task) return none;
   const att = task.attempts
-    .filter((a) => a.eff_outcome && a.role !== 'verify' && !a.steered)
-    .map((a) => ({ a, i: tierIndex(a.model, a.effort) }))
-    .filter((x) => x.i !== null)
+    .filter((a) => a.role !== 'verify' && !a.steered)
+    .map((a) => ({
+      a,
+      i: tierIndex(a.model, a.effort),
+      results: Array.isArray(a.results) ? a.results : (a.eff_outcome ? [{ outcome: a.eff_outcome, ts: a.ts, idx: 0 }] : []),
+    }))
+    .filter((x) => x.i !== null && x.results.length)
     .sort((x, y) => (x.a.try - y.a.try) || (x.a.ts - y.a.ts));
   if (!att.length) return none;
+  const res = [];
+  for (const x of att) {
+    const rs = x.results.slice().sort((p, q) => (p.ts - q.ts) || ((p.idx || 0) - (q.idx || 0)));
+    for (const r of rs) res.push({ i: x.i, outcome: r.outcome });
+  }
   const tried = Array.from(new Set(att.map((x) => tierName(x.i))));
-  const totalFails = att.filter((x) => x.a.eff_outcome === 'fail').length;
-  const last = att[att.length - 1];
+  const totalFails = res.filter((r) => r.outcome === 'fail').length;
+  const last = res[res.length - 1];
   const cur = last.i;
   const base = { tried, fails: totalFails, ask: false };
-  if (last.a.eff_outcome !== 'fail') return Object.assign(base, { floor: cur, note: null });
-  const fails = att.filter((x) => x.i === cur && x.a.eff_outcome === 'fail').length;
+  if (last.outcome !== 'fail') return Object.assign(base, { floor: cur, note: null });
+  const fails = res.filter((r) => r.i === cur && r.outcome === 'fail').length;
   if (fails < 2) {
     return Object.assign(base, { floor: cur, note: `task fail 1 lần ở ${tierName(cur)} → làm lại cùng tier kèm lỗi` });
   }
@@ -287,6 +298,40 @@ function estimateFor(idx, cell, pricing) {
   return roughEstimate(idx, pricing);
 }
 
+// ------------------------------------------------------------------ task type guard
+
+// Ad-hoc labels seen in real logs → the closest fixed type (core 0.4.0). A label maps only when its target
+// is known (fixed list or the profile's extra_task_types), e.g. art-fix → art-gen needs art-gen in the profile.
+const TYPE_ALIASES = {
+  'bug-fix': 'debug', bugfix: 'debug', fix: 'debug', bug: 'debug',
+  config: 'mechanical-edit', shell: 'mechanical-edit', deploy: 'mechanical-edit', ops: 'mechanical-edit', edit: 'mechanical-edit',
+  docs: 'content-write', doc: 'content-write', documentation: 'content-write', writing: 'content-write', copy: 'content-write',
+  design: 'plan-design', plan: 'plan-design', planning: 'plan-design', architecture: 'plan-design',
+  research: 'research-synth', synth: 'research-synth',
+  test: 'test-write', tests: 'test-write',
+  analysis: 'data-analysis', data: 'data-analysis',
+  impl: 'feature-impl', feature: 'feature-impl', implement: 'feature-impl',
+  'code-review': 'review',
+  'art-fix': 'art-gen', art: 'art-gen',
+};
+
+/**
+ * { type, known, mapped_from, warning }: a fixed/extra type passes; an ad-hoc label with a known alias target
+ * maps to it (with a warning); anything else stays unknown (choose asks the user to pick a fixed type).
+ */
+function resolveTaskType(raw, profile) {
+  const t = String(raw || '').toLowerCase();
+  const extra = (profile && profile.extra_task_types) || [];
+  const isKnown = (x) => core.TASK_TYPES.includes(x) || extra.includes(x);
+  if (isKnown(t)) return { type: t, known: true, mapped_from: null, warning: null };
+  const target = TYPE_ALIASES[t];
+  if (target && isKnown(target)) {
+    return { type: target, known: true, mapped_from: t, warning: `loại "${t}" không cố định → dùng "${target}" (ghi --type ${target} trong thẻ)` };
+  }
+  const list = core.TASK_TYPES.concat(extra).join(', ');
+  return { type: t, known: false, mapped_from: null, warning: `loại "${t}" không có trong danh sách cố định (${list}) — chọn loại gần nhất hoặc hỏi người dùng` };
+}
+
 // ------------------------------------------------------------------ choose
 
 /**
@@ -296,8 +341,8 @@ function estimateFor(idx, cell, pricing) {
  * Throws when an override goes below a safety floor or off the ladder.
  */
 function choose(opts) {
-  const type = String(opts.type || '').toLowerCase();
-  if (!type) throw new Error('Thiếu --type');
+  const rawType = String(opts.type || '').toLowerCase();
+  if (!rawType) throw new Error('Thiếu --type');
   const score = Number(opts.score);
   if (opts.score === undefined || opts.score === null || opts.score === true || !isFinite(score)
     || score < 0 || score > 12) throw new Error('--score phải trong 0–12');
@@ -327,12 +372,15 @@ function choose(opts) {
   const notes = [];
 
   const analysis = agg.analyze(opts.events || [], { lambda });
-  const known = core.TASK_TYPES.includes(type) || profile.extra_task_types.includes(type);
+  const rt = resolveTaskType(rawType, profile);
+  const type = rt.type;
+  const known = rt.known;
+  if (rt.warning) notes.push(rt.warning);
   let prior = profile.priors[type];
   let priorWhy = 'prior';
   if (prior === undefined || prior === null) {
     prior = OPUS_MEDIUM;
-    notes.push(known ? 'không có prior, dùng opus/medium' : `loại "${type}" lạ, dùng opus/medium`);
+    if (known) notes.push('không có prior, dùng opus/medium');
   }
   const ov = overridePrior(analysis.overrides, type);
   if (ov && ov.tier !== prior) {
@@ -382,10 +430,17 @@ function choose(opts) {
       explored,
       tier: tierName(idx),
       role,
+      task_type: type,
       budget_s: budgetFor(cell),
-    }, estimateFor(idx, cell, opts.pricing), { profile_source: src }, extra || {});
+    }, estimateFor(idx, cell, opts.pricing), { profile_source: src },
+    rt.mapped_from ? { mapped_from: rt.mapped_from } : {}, rt.warning ? { type_warning: rt.warning } : {}, extra || {});
   };
 
+  // Unknown task type (not fixed, not in the profile, no alias): its stats would never pool — ask first.
+  if (!known) {
+    return finish(Math.max(prior, safetyFloor), rt.warning, false, { action: 'ask_user', unknown_type: true });
+  }
+
   if (overrideIdx !== null && overrideIdx < safetyFloor) {
     throw new Error(`Từ chối override ${tierName(overrideIdx)}: dưới sàn an toàn ${tierName(safetyFloor)} (${floorWhy.join(', ')}).`);
   }
@@ -474,4 +529,5 @@ module.exports = {
   DEFAULT_ORCH_CTX_SOFT_CAP,
   LADDER, DEFAULT_PRIORS, DEFAULT_LAMBDA, DEFAULT_TIME_CAP_MIN, ROUGH, tierIndex, tierName, parsePrior,
   parseTier, loadProfile, makeRng, betaSample, escalation, overridePrior, roughEstimate, choose, shortModel,
+  TYPE_ALIASES, resolveTaskType,
 };

package/lib/commands.cjs

@@ -10,7 +10,7 @@ const chooser = require('./choose.cjs');
 const setupLib = require('./setup.cjs');
 const { claudeDirOf, ctxOf, yesNo } = require('./args.cjs');
 
-const AGENT_OUTCOMES = ['pass', 'fail', 'timeout'];
+const AGENT_OUTCOMES = ['pass', 'fail', 'timeout', 'aborted'];
 const USER_OUTCOMES = ['accept', 'reject'];
 const CAUSES = ['quality', 'scope'];
 const STEER_KINDS = ['minor', 'plan', 'redirect'];
@@ -145,6 +145,15 @@ async function cmdDoctor(opts) {
   add(!badIds.length, 'task-ids', badIds.length
     ? `${badIds.length} dispatch trong ${INVALID_ID_WINDOW_DAYS} ngày gần đây có task_id sai định dạng (${Array.from(new Set(badIds.map((e) => e.task_id))).slice(0, 3).map((x) => `"${x}"`).join(', ')}) — task_id phải đúng 8 ký tự a-z0-9, lấy bằng \`dieu-phoi new-id\``
     : `mọi dispatch trong ${INVALID_ID_WINDOW_DAYS} ngày gần đây có task_id đúng định dạng`, 'CẢNH BÁO');
+  const tmp = sweepStaleTmp(ctx);
+  add(!tmp.left.length, 'tmp-files', tmp.left.length
+    ? `${tmp.left.length} file tạm còn mới (đang ghi?): ${tmp.left.slice(0, 3).join(', ')}`
+    : `không còn file *.tmp-* bỏ dở${tmp.removed ? ` (đã xoá ${tmp.removed} file cũ hơn 1 giờ)` : ''}`, 'CẢNH BÁO');
+  let badPlans = [];
+  try { badPlans = fs.readdirSync(ctx.paths.plans).filter((n) => n.endsWith('.json') && !core.isValidTaskId(n.slice(0, -5))); } catch (_) { /* none */ }
+  add(!badPlans.length, 'plans', badPlans.length
+    ? `${badPlans.length} kế hoạch có root id sai định dạng (${badPlans.slice(0, 3).join(', ')}) — \`state\` vẫn đọc; loại task bằng \`dieu-phoi discard --task <id>\` hoặc xoá file trong ${ctx.paths.plans}`
+    : 'mọi kế hoạch đã duyệt có root id đúng định dạng', 'CẢNH BÁO');
   const orch = measureOrch(opts, ctx, profileOrNull(opts, ctx));
   if (orch.ctx_tokens !== null) {
     add(!orch.over, 'orch-ctx', `session ${orch.session_id}: ${orch.ctx_tokens} token, tăng ${orch.ctx_growth}/${orch.soft_cap}, ≈ ${fmtUsd(orch.cum_usd)} — ${orch.advice}`, 'CẢNH BÁO');
@@ -166,6 +175,33 @@ async function cmdDoctor(opts) {
   return { code: failed ? 1 : 0, out };
 }
 
+const TMP_RE = /\.tmp-\d+-[0-9a-f]+$/;
+const TMP_STALE_MS = 3600 * 1000;
+
+/**
+ * Leftovers of writeFileAtomic (tmp written, rename never happened: process killed, or rename lost a race on
+ * Windows) under data/, data/orch, data/segments, data/plans. Older than 1 h → removed; newer → reported.
+ */
+function sweepStaleTmp(ctx) {
+  let removed = 0;
+  const left = [];
+  const now = Date.now();
+  for (const dir of [ctx.paths.data, path.join(ctx.paths.data, 'orch'), ctx.paths.segments, ctx.paths.plans]) {
+    let names = [];
+    try { names = fs.readdirSync(dir); } catch (_) { continue; }
+    for (const n of names) {
+      if (!TMP_RE.test(n)) continue;
+      const f = path.join(dir, n);
+      try {
+        const st = fs.statSync(f);
+        if (!st.isFile()) continue; // a directory (or anything else) with a tmp-like name: not ours, leave it alone
+        if (now - st.mtimeMs > TMP_STALE_MS) { fs.unlinkSync(f); removed++; } else left.push(n);
+      } catch (_) { left.push(n); }
+    }
+  }
+  return { removed, left };
+}
+
 /** Live sink check (view=stats); result cached in data/sink-check.json for 24 h. */
 async function checkSinkLive(ctx) {
   let ok = false;
@@ -211,6 +247,7 @@ function cmdStart(opts) {
     `step_ids: ${info.step_ids.join(' ')}`,
     `health: ${core.healthLine(h)}`,
     `scout_brief: ${info.scout_brief || '(không thấy — dùng references/brief-template.md mục E)'}`,
+    ...core.orchLessonLines(info),
   ];
   return { code: 0, out: out.join('\n') };
 }
@@ -248,7 +285,10 @@ function resolveAgentId(events, ref, now) {
     const verdicted = new Set();
     events.forEach((e, i) => {
       if (!e.agent_id) return;
-      if (e.kind === 'verdict' && agg.normalizeVerdict(e).by === 'agent') verdicted.add(e.agent_id);
+      if (e.kind === 'verdict') {
+        const nv = agg.normalizeVerdict(e);
+        if (nv.by === 'agent' && nv.outcome !== agg.ABORTED) verdicted.add(e.agent_id); // aborted still needs a verdict
+      }
       if (e.kind !== 'complete') return;
       const t = Date.parse(e.ts) || 0;
       const cur = latest.get(e.agent_id);
@@ -285,8 +325,9 @@ function kebab(s) {
 function verdictAgent(opts, ctx, events) {
   const [ref, outcome] = opts._;
   if (!ref || !outcome) {
-    throw new Error('Cú pháp: dieu-phoi verdict <agent_id|last> <pass|fail|timeout> [--verify V] [--reason R]\n'
-      + '         dieu-phoi verdict --task <task_id> <accept|reject> [--cause quality|scope] [--round n]');
+    throw new Error('Cú pháp: dieu-phoi verdict <agent_id|last> <pass|fail|timeout|aborted> [--verify V] [--reason R]\n'
+      + '         dieu-phoi verdict --task <task_id> <accept|reject> [--cause quality|scope] [--round n]\n'
+      + '         dieu-phoi verdict --root <root_task_id> accept [--steps a,b]');
   }
   if (outcome === 'rework') {
     throw new Error('"rework" đã bỏ. Người dùng không nhận kết quả → dieu-phoi verdict --task <task_id> reject --cause quality');
@@ -344,9 +385,46 @@ function verdictUser(opts, ctx, events) {
   }, core.commonFields(ctx));
 }
 
+/**
+ * `verdict --root <root> accept [--steps a,b]` (core 0.4.0): the user accepts the steps of the latest approved plan
+ * in one call. Covers every step whose task has an exec dispatch and no user verdict yet (a step already rejected
+ * or accepted is left alone: reject the bad ones per task first, then accept the rest by root).
+ */
+function verdictRoot(opts, ctx, events) {
+  const root = requireTaskId(String(opts.root));
+  if (opts._[0] !== 'accept') {
+    throw new Error('verdict --root chỉ nhận accept; bước không đạt → dieu-phoi verdict --task <task_id> reject --cause quality|scope');
+  }
+  const plan = core.readJsonFile(path.join(ctx.paths.plans, `${root}.json`), null);
+  if (!plan || !Array.isArray(plan.steps)) throw new Error(`Không thấy kế hoạch đã duyệt của root ${root} (plan-table --approve --root ${root}).`);
+  let steps = plan.steps.filter((x) => x && x.task_id);
+  if (typeof opts.steps === 'string') {
+    const want = new Set(opts.steps.split(',').map((x) => x.trim()).filter(Boolean));
+    const ids = new Set(steps.map((x) => String(x.id)));
+    const missing = Array.from(want).filter((x) => !ids.has(x));
+    if (missing.length) throw new Error(`--steps: không có bước ${missing.join(', ')} trong kế hoạch ${root}`);
+    steps = steps.filter((x) => want.has(String(x.id)));
+  }
+  const execTasks = new Set(events.filter((e) => e.kind === 'dispatch' && (e.role || 'exec') === 'exec').map((e) => e.task_id));
+  const judged = new Set(events.filter((e) => e.kind === 'verdict' && agg.normalizeVerdict(e).by === 'user').map((e) => e.task_id));
+  const gone = agg.discardedTaskIds(events);
+  const todo = steps.filter((x) => execTasks.has(x.task_id) && !judged.has(x.task_id) && !gone.has(x.task_id));
+  if (!todo.length) throw new Error(`Không có bước nào của ${root} cần nghiệm thu (chưa giao exec, hoặc đã có verdict người dùng).`);
+  return todo.map((x) => ({
+    step: String(x.id),
+    ev: verdictUser(Object.assign({}, opts, { task: x.task_id, _: ['accept'], round: undefined, cause: undefined }), ctx, events),
+  }));
+}
+
 function cmdVerdict(opts) {
   const ctx = ctxOf(opts);
   const events = core.readEvents(ctx);
+  if (typeof opts.root === 'string' && typeof opts.task !== 'string') {
+    const list = verdictRoot(opts, ctx, events);
+    for (const x of list) core.appendEvent(ctx, x.ev);
+    if (opts.json) return { code: 0, out: JSON.stringify(list.map((x) => x.ev)) };
+    return { code: 0, out: `Đã ghi người dùng accept cho ${list.length} bước của ${opts.root}: ${list.map((x) => `${x.step}=${x.ev.task_id}`).join(', ')}.` };
+  }
   const ev = typeof opts.task === 'string' ? verdictUser(opts, ctx, events) : verdictAgent(opts, ctx, events);
   core.appendEvent(ctx, ev);
   if (opts.json) return { code: 0, out: JSON.stringify(ev) };
@@ -356,6 +434,29 @@ function cmdVerdict(opts) {
   return { code: 0, out: `Đã ghi ${ev.outcome} cho ${ev.agent_id}${ev.task_id ? ` (task ${ev.task_id})` : ''}.` };
 }
 
+// ------------------------------------------------------------------ discard
+
+/**
+ * `dieu-phoi discard --task <task_id> [--reason R]` (core 0.4.0): withdraw a mistaken task. Appends one
+ * `discard` event (synced like any other); stats, choose, state and the sink then leave out every event of the
+ * task and of its agents. events.jsonl is never edited — a hand edit once lost a dispatch that the sink kept.
+ */
+function cmdDiscard(opts) {
+  if (typeof opts.task !== 'string') throw new Error('Cú pháp: dieu-phoi discard --task <task_id> [--reason R]');
+  const taskId = requireTaskId(opts.task);
+  const ctx = ctxOf(opts);
+  const events = core.readEvents(ctx);
+  if (!events.some((e) => e.task_id === taskId)) throw new Error(`Không thấy task "${taskId}" trong log.`);
+  if (agg.discardedTaskIds(events).has(taskId)) return { code: 0, out: opts.json ? JSON.stringify({ already: true, task_id: taskId }) : `Task ${taskId} đã bị loại trước đó.` };
+  const ev = Object.assign({
+    schema: core.SCHEMA, kind: 'discard', ts: core.nowIso(), agent_id: `task:${taskId}`, task_id: taskId, reason_code: kebab(opts.reason),
+  }, core.commonFields(ctx));
+  core.appendEvent(ctx, ev);
+  const n = events.filter((e) => e.task_id === taskId).length;
+  if (opts.json) return { code: 0, out: JSON.stringify(ev) };
+  return { code: 0, out: `Đã loại task ${taskId} (${n} bản ghi) khỏi thống kê, choose và state. Log không bị sửa; sink nhận bản ghi discard ở lần sync kế tiếp.` };
+}
+
 // ------------------------------------------------------------------ steer
 
 /**
@@ -383,7 +484,8 @@ function cmdSteer(opts) {
     const taskId = String(opts.task);
     const mine = agents.filter((a) => a.task_id === taskId);
     if (!mine.length && !events.some((e) => e.task_id === taskId)) throw new Error(`Không thấy task ${taskId} trong log`);
-    const inFlight = mine.filter((a) => a.dispatched && !(a.completed && a.outcome));
+    // core 0.4.0: verifiers are never marked (a steer is about the work, not its check)
+    const inFlight = mine.filter((a) => a.dispatched && a.role !== 'verify' && !(a.completed && a.outcome));
     const type = (mine.find((a) => a.role === 'exec') || mine[0] || {}).task_type || null;
     out = inFlight.length ? inFlight.map((a) => mk(a.agent_id, taskId, a.task_type)) : [mk(`task:${taskId}`, taskId, type)];
   } else {
@@ -427,6 +529,40 @@ function measureOrch(opts, ctx, prof) {
   };
 }
 
+const CTX_WARN_KEEP_MS = 14 * 24 * 3600 * 1000;
+
+/** 0 = within the cap; 1 = over the cap, 2 = over 2×, 3 = over 4×, … */
+function ctxWarnLevel(growth, cap) {
+  if (!(typeof growth === 'number' && cap > 0 && growth > cap)) return 0;
+  return 1 + Math.floor(Math.log2(growth / cap));
+}
+
+/**
+ * Core 0.4.0: the over-cap advice fires once per threshold crossing (cap, 2×, 4×, …) per session, and again after
+ * a /compact that left the session over. State: data/ctx-warn.json {session_id: {level, compactions, t}}.
+ * Never throws (no state → warn).
+ */
+function ctxWarnOnce(ctx, m) {
+  if (!m || !m.over || !m.session_id) return false;
+  const file = path.join(ctx.paths.data, 'ctx-warn.json');
+  const level = ctxWarnLevel(m.ctx_growth, m.soft_cap);
+  try {
+    const st = core.readJsonFile(file, {}) || {};
+    const cur = st[m.session_id];
+    const comp = typeof m.compactions === 'number' ? m.compactions : null;
+    const warn = !cur || cur.compactions !== comp || level > (Number(cur.level) || 0);
+    if (warn) {
+      const now = Date.now();
+      st[m.session_id] = { level, compactions: comp, t: now };
+      for (const k of Object.keys(st)) if (!(now - Number(st[k] && st[k].t) < CTX_WARN_KEEP_MS)) delete st[k];
+      core.writeFileAtomic(file, `${JSON.stringify(st)}\n`);
+    }
+    return warn;
+  } catch (_) {
+    return true;
+  }
+}
+
 function profileOrNull(opts, ctx) {
   try { return chooser.loadProfile(skillDirOf(opts, ctx)); } catch (_) { return null; }
 }
@@ -508,9 +644,9 @@ function cmdStats(opts) {
       c.note,
     ]);
   }
-  const s = [['task_type', 'task', 'task có steer', 'lần steer', 'minor', 'plan', 'redirect', 'tỉ lệ steer']];
+  const s = [['task_type', 'task', 'task có steer', 'lần steer', 'minor', 'plan', 'redirect', 'tỉ lệ steer', 'ngoài exec (không tính)']];
   for (const r of steerRows) {
-    s.push([r.task_type, r.tasks, r.steered_tasks, r.actions, r.minor, r.plan, r.redirect, pct(r.steer_rate)]);
+    s.push([r.task_type, r.tasks, r.steered_tasks, r.actions, r.minor, r.plan, r.redirect, pct(r.steer_rate), r.plan_phase_actions || 0]);
   }
   return {
     code: 0,
@@ -534,6 +670,7 @@ function cmdRetro(opts) {
   const userOutcomes = {};
   for (const a of agents) {
     if (a.outcome) outcomes[a.outcome] = (outcomes[a.outcome] || 0) + 1;
+    if (a.aborted) outcomes.aborted = (outcomes.aborted || 0) + 1;
     if (a.reason_code) reasons[a.reason_code] = (reasons[a.reason_code] || 0) + 1;
   }
   for (const v of userVerdicts) {
@@ -565,6 +702,7 @@ function cmdRetro(opts) {
       no_verdict_agents: agents.filter((a) => a.completed && !a.outcome && a.role !== 'verify').length,
       no_user_verdict_tasks: tasks.filter((t) => !t.user_verdicts.length).length,
       multi_attempt_tasks: escalations,
+      discarded_tasks: agg.discardedTaskIds(events).size,
       overrides: overrides.length,
       cost_usd: agents.reduce((s, a) => s + (a.cost_usd || 0), 0),
     },
@@ -614,6 +752,19 @@ function chooseInput(opts, ctx, events) {
   };
 }
 
+function overrideEvent(ctx, taskId, taskType, suggested, chosen) {
+  return Object.assign({
+    schema: core.SCHEMA,
+    kind: 'override',
+    ts: core.nowIso(),
+    agent_id: taskId ? `task:${taskId}` : `override-${crypto.randomBytes(6).toString('hex')}`,
+    task_id: taskId || null,
+    task_type: taskType,
+    suggested_tier: suggested,
+    chosen_tier: chosen,
+  }, core.commonFields(ctx));
+}
+
 function cmdChoose(opts) {
   const ctx = ctxOf(opts);
   if (opts.override !== undefined && typeof opts.task !== 'string') {
@@ -626,21 +777,14 @@ function cmdChoose(opts) {
   res.orch_ctx_tokens = orch.ctx_tokens;
   res.orch_ctx_growth = orch.ctx_growth;
   res.orch_ctx_over = orch.over;
+  res.orch_ctx_warn = ctxWarnOnce(ctx, orch); // over AND a new threshold crossed since the last warning
   if (res.overridden) {
     const tid = input.taskId;
-    core.appendEvent(ctx, Object.assign({
-      schema: core.SCHEMA,
-      kind: 'override',
-      ts: core.nowIso(),
-      agent_id: tid ? `task:${tid}` : `override-${require('crypto').randomBytes(6).toString('hex')}`,
-      task_id: tid,
-      task_type: String(input.type).toLowerCase(),
-      suggested_tier: res.suggested_tier,
-      chosen_tier: res.tier,
-    }, core.commonFields(ctx)));
+    core.appendEvent(ctx, overrideEvent(ctx, tid, res.task_type || String(input.type).toLowerCase(), res.suggested_tier, res.tier));
   }
   if (opts.json) return { code: 0, out: JSON.stringify(res) };
-  const warn = orch.over ? `\nCẢNH BÁO: ${orch.advice}` : '';
+  const typeWarn = res.type_warning && !String(res.reason).includes(res.type_warning) ? `\nCẢNH BÁO: ${res.type_warning}` : '';
+  const warn = `${typeWarn}${res.orch_ctx_warn ? `\nCẢNH BÁO: ${orch.advice}` : ''}`;
   const est =`~${fmtUsd(res.est_cost_usd)} · ~${fmtNum(res.est_time_min)} phút (${res.est_source === 'data' ? 'dữ liệu' : 'ước lượng thô'})`;
   if (res.action === 'ask_user') {
     return { code: 0, out: `HỎI NGƯỜI DÙNG — ${res.reason}${warn}` };
@@ -775,9 +919,35 @@ function planTaskIdProblems(plan, root) {
     const same = plan.steps.filter((r) => r.task_id === root).map((r) => r.step);
     if (same.length) problems.push(`task_id của bước ${same.join(', ')} trùng --root "${root}" (root dành cho scout/planner)`);
   }
+  // core 0.4.0: a label outside the fixed list (and without an alias) would never pool its stats
+  for (const r of plan.steps) if (r.unknown_type) problems.push(`bước ${r.step}: ${r.type_warning}`);
   return problems;
 }
 
+/** Mapped ad-hoc labels (bug-fix → debug, …): not an error, but the tag must carry the mapped type. */
+function planTypeNotes(plan) {
+  return plan.steps.filter((r) => r.mapped_from).map((r) => `bước ${r.step}: ${r.type_warning}`);
+}
+
+/**
+ * Overrides chosen in the steps file (step `override`) become override events when the plan is approved —
+ * also on a re-approval that changes a step's tier — so the override learning sees them (core 0.4.0; before,
+ * only `choose --override` logged one). One event per (task_id, chosen tier): re-approving the same tier or a
+ * `choose --override` already logged adds nothing.
+ */
+function planOverrideEvents(ctx, plan, events) {
+  const seen = new Set(events.filter((e) => e.kind === 'override').map((e) => `${e.task_id}|${e.chosen_tier}`));
+  const out = [];
+  for (const r of plan.steps) {
+    if (!r.overridden || !r.task_id || !r.tier || !r.suggested_tier) continue;
+    const k = `${r.task_id}|${r.tier}`;
+    if (seen.has(k)) continue;
+    seen.add(k);
+    out.push(overrideEvent(ctx, r.task_id, r.task_type || r.type, r.suggested_tier, r.tier));
+  }
+  return out;
+}
+
 function recordApprovedPlan(ctx, root, stepsFile, plan) {
   const file = path.join(ctx.paths.plans, `${root}.json`);
   const prev = core.readJsonFile(file, null);
@@ -793,7 +963,7 @@ function recordApprovedPlan(ctx, root, stepsFile, plan) {
     approved_at: core.nowIso(),
     approval: prevApproval(prev) + 1,
     steps: plan.steps.map((r) => ({
-      id: r.step, task_id: r.task_id || null, title: r.title === undefined ? null : r.title, type: r.type || null,
+      id: r.step, task_id: r.task_id || null, title: r.title === undefined ? null : r.title, type: r.task_type || r.type || null,
       tier: r.action === 'refused' ? null : (r.tier || null), depends_on: r.depends_on,
     })),
     history,
@@ -840,9 +1010,15 @@ function cmdPlanTable(opts) {
     throw new Error(`plan-table --approve: không ghi kế hoạch — ${problems.join('; ')}. Mỗi bước cần task_id riêng (8 ký tự a-z0-9, lấy bằng \`dieu-phoi new-id\`), khác --root.`);
   }
   if (problems.length) process.stderr.write(`dieu-phoi plan-table: cảnh báo — ${problems.join('; ')} (cần sửa trước khi --approve)\n`);
+  const typeNotes = planTypeNotes(plan);
+  if (typeNotes.length) process.stderr.write(`dieu-phoi plan-table: cảnh báo — ${typeNotes.join('; ')}\n`);
   const rec = opts.approve ? recordApprovedPlan(ctx, String(opts.root), path.resolve(opts.file), plan) : null;
+  const ovs = rec ? planOverrideEvents(ctx, plan, base.events) : [];
+  for (const ev of ovs) core.appendEvent(ctx, ev);
   if (opts.json) {
-    const out = rec ? Object.assign({}, plan, { approved: { root_task_id: rec.root_task_id, approval: rec.approval, record: rec.file } }) : plan;
+    const out = rec ? Object.assign({}, plan, {
+      approved: { root_task_id: rec.root_task_id, approval: rec.approval, record: rec.file, overrides_logged: ovs.length },
+    }) : plan;
     return { code: 0, out: JSON.stringify(out, null, 2) };
   }
   const lines = ['| Bước | Model/effort | Rubric (điểm · kiểm chứng · đảo ngược) | Lý do | Ước tính |', '|---|---|---|---|---|'];
@@ -862,11 +1038,12 @@ function cmdPlanTable(opts) {
     process.stderr.write(`dieu-phoi plan-table: cảnh báo — ${plan.refused.length} bước bị từ chối
 `);
   }
-  if (rec) lines.push('', `Đã ghi kế hoạch đã duyệt (root ${rec.root_task_id}, lần duyệt ${rec.approval})`);
+  if (typeNotes.length) lines.push('', `**Loại task:** ${typeNotes.join('; ')}`);
+  if (rec) lines.push('', `Đã ghi kế hoạch đã duyệt (root ${rec.root_task_id}, lần duyệt ${rec.approval})${ovs.length ? `; ghi ${ovs.length} override` : ''}`);
   return { code: 0, out: lines.join('\n') };
 }
 
 module.exports = {
-  cmdSetup, cmdUninstall, cmdDoctor, cmdStart, checkSinkLive, cmdHook, cmdSync, cmdVerdict, cmdSteer, cmdStats, cmdRetro, cmdChoose, cmdCtx, cmdState, measureOrch,
+  cmdSetup, cmdUninstall, cmdDoctor, cmdStart, checkSinkLive, cmdHook, cmdSync, cmdVerdict, cmdSteer, cmdDiscard, ctxWarnOnce, ctxWarnLevel, sweepStaleTmp, planOverrideEvents, cmdStats, cmdRetro, cmdChoose, cmdCtx, cmdState, measureOrch,
   cmdPlanTable, cmdNewId, requireTaskId, buildPlanTable, recordApprovedPlan, planTaskIdProblems, criticalPath, resolveAgentId, AGENT_OUTCOMES, USER_OUTCOMES, VERIFY,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kienntpixon/dieu-phoi",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Hook + CLI ghi log subagent của Claude Code và chọn model/effort theo chi phí + thời gian tới lúc nghiệm thu.",
   "license": "MIT",
   "author": "kiennt <kiennt@pixon.games>",