@kienntpixon/dieu-phoi 0.7.0 → 0.7.2

package/lib/worktree.cjs

@@ -0,0 +1,186 @@
+'use strict';
+// s17 (core 0.7.2): worktree của một bước điều phối, có dấu dieu-phoi.
+//  - `wt add` tạo `<cha của repo>/<tên repo>-wt-<task_id>` trên nhánh dp/<task_id> và ghi dấu
+//    `<git-dir của worktree>/dieu-phoi.json` {task_id, root, created_ts, branch}. Dấu nằm trong git-dir nên không làm
+//    worktree dirty.
+//  - verdict --task accept (người dùng) và discard chỉ gỡ worktree CÓ DẤU của đúng task: sạch thì
+//    `git worktree remove` (không --force), nhánh giữ nguyên; còn thay đổi chưa commit thì giữ và báo.
+//    Worktree không dấu không bị đụng.
+//  - `wt clean` (dry-run mặc định) liệt kê worktree có dấu mà task đã nghiệm thu / bị loại, hoặc thư mục đã mất.
+// Sự kiện `worktree` (chỉ ở máy, không đồng bộ sink) ghi repo chính để verdict/discard tìm đúng repo.
+const fs = require('fs');
+const path = require('path');
+const cp = require('child_process');
+const core = require('../hook.cjs');
+const agg = require('./aggregate.cjs');
+const { ctxOf, repoOf } = require('./args.cjs');
+
+const MARK = 'dieu-phoi.json';
+const BRANCH_PREFIX = 'dp/';
+
+function git(cwd, args) {
+  const r = cp.spawnSync('git', args, { cwd, encoding: 'utf8', windowsHide: true, timeout: 60000 });
+  const err = r.stderr || (r.error ? r.error.message : '') || '';
+  return { ok: r.status === 0, out: (r.stdout || '').trim(), err: err.trim() };
+}
+
+function requireTaskId(id) {
+  if (!core.isValidTaskId(id)) throw new Error(core.taskIdError(id));
+  return id;
+}
+
+/** Checkout chính của repo (thư mục có .git) từ một đường dẫn bất kỳ trong repo hoặc worktree của nó. */
+function mainCheckoutOf(dir) {
+  const r = git(dir, ['rev-parse', '--path-format=absolute', '--git-common-dir']);
+  if (!r.ok) throw new Error(`không phải repo git: ${dir}${r.err ? ` (${r.err})` : ''}`);
+  if (path.basename(r.out) !== '.git') throw new Error(`repo không có thư mục .git (${r.out}); wt chỉ làm việc với checkout thường`);
+  return { main: path.dirname(r.out), common: r.out };
+}
+
+/** Worktree có dấu của repo (đọc <common>/worktrees/<name>/dieu-phoi.json). Không ném. */
+function markedWorktrees(common) {
+  const dir = path.join(common, 'worktrees');
+  let names = [];
+  try { names = fs.readdirSync(dir); } catch (_) { return []; }
+  const out = [];
+  for (const name of names) {
+    const admin = path.join(dir, name);
+    const mark = core.readJsonFile(path.join(admin, MARK), null);
+    if (!mark || typeof mark.task_id !== 'string') continue;
+    let wtPath = null;
+    try { wtPath = path.dirname(fs.readFileSync(path.join(admin, 'gitdir'), 'utf8').trim()); } catch (_) { /* no gitdir: stale admin */ }
+    out.push({
+      admin, name, task_id: mark.task_id, root: mark.root || null, branch: mark.branch || null,
+      created_ts: mark.created_ts || null, path: wtPath, exists: !!wtPath && fs.existsSync(wtPath),
+    });
+  }
+  return out;
+}
+
+/** true = còn thay đổi (kể cả file chưa theo dõi), false = sạch, null = không đọc được. */
+function dirtyOf(wtPath) {
+  const r = git(wtPath, ['status', '--porcelain']);
+  if (!r.ok) return null;
+  return r.out.length > 0;
+}
+
+/** Gỡ một worktree có dấu đang còn thư mục. Không --force: còn thay đổi thì giữ. */
+function removeMarked(w, mainDir) {
+  const dirty = dirtyOf(w.path);
+  if (dirty !== false) return { removed: false, msg: `giữ ${w.path}: ${dirty ? 'còn thay đổi chưa commit' : 'không đọc được trạng thái git'}` };
+  const r = git(mainDir, ['worktree', 'remove', w.path]);
+  if (!r.ok) return { removed: false, msg: `giữ ${w.path}: git worktree remove lỗi (${r.err || 'không rõ'})` };
+  return { removed: true, msg: `đã gỡ worktree ${w.path} (nhánh ${w.branch || '?'} giữ nguyên)` };
+}
+
+function recordWt(ctx, taskId, fields) {
+  try {
+    core.appendEvent(ctx, Object.assign({
+      schema: core.SCHEMA, kind: 'worktree', ts: core.nowIso(), agent_id: `wt:${taskId}`, task_id: taskId,
+    }, fields, core.commonFields(ctx)));
+  } catch (_) { /* best effort: the worktree itself is the truth */ }
+}
+
+/** Các repo chính mà task đã có worktree (sự kiện `worktree` action=add), kèm repo người dùng chỉ định nếu có. */
+function reposOfTask(events, taskId, repoDir) {
+  const set = new Set();
+  for (const e of events) {
+    if (e && e.kind === 'worktree' && e.task_id === taskId && e.action === 'add' && typeof e.repo === 'string') set.add(e.repo);
+  }
+  if (typeof repoDir === 'string' && repoDir) set.add(repoDir);
+  return Array.from(set);
+}
+
+/**
+ * verdict --task accept (người dùng) / discard: gỡ worktree có dấu của đúng task. Trả các dòng báo, không ném.
+ * repoDir: --repo của lệnh (nếu có) — ngoài repo đã ghi trong sự kiện worktree.
+ */
+function cleanupTask(ctx, events, taskId, repoDir) {
+  const lines = [];
+  for (const repo of reposOfTask(events, taskId, repoDir)) {
+    let info;
+    try { info = mainCheckoutOf(repo); } catch (e) { lines.push(`wt: bỏ qua ${repo} (${e.message})`); continue; }
+    const mine = markedWorktrees(info.common).filter((w) => w.task_id === taskId);
+    for (const w of mine) {
+      if (!w.exists) { lines.push(`wt: ${w.path || w.name} đã mất thư mục — dọn bằng dieu-phoi wt clean --yes`); continue; }
+      const r = removeMarked(w, info.main);
+      if (r.removed) recordWt(ctx, taskId, { action: 'remove', path: w.path, repo: info.main, reason: 'verdict' });
+      lines.push(`wt: ${r.msg}`);
+    }
+  }
+  return lines;
+}
+
+function wtAdd(opts) {
+  if (typeof opts.task !== 'string') throw new Error('Cú pháp: dieu-phoi wt add --task <task_id> [--repo r] [--path dir] [--branch b]');
+  const taskId = requireTaskId(opts.task);
+  const ctx = ctxOf(opts);
+  const { main, common } = mainCheckoutOf(repoOf(opts));
+  const dup = markedWorktrees(common).filter((w) => w.task_id === taskId && w.exists);
+  if (dup.length) throw new Error(`task ${taskId} đã có worktree có dấu: ${dup.map((w) => w.path).join(', ')}`);
+  const wtPath = typeof opts.path === 'string' && opts.path
+    ? path.resolve(opts.path)
+    : path.join(path.dirname(main), `${path.basename(main)}-wt-${taskId}`);
+  if (fs.existsSync(wtPath)) throw new Error(`wt add: ${wtPath} đã tồn tại`);
+  const branch = typeof opts.branch === 'string' && opts.branch ? opts.branch : `${BRANCH_PREFIX}${taskId}`;
+  const r = git(main, ['worktree', 'add', '-b', branch, wtPath]);
+  if (!r.ok) throw new Error(`git worktree add lỗi: ${r.err || 'không rõ'}`);
+  const adminDir = git(wtPath, ['rev-parse', '--path-format=absolute', '--git-dir']).out;
+  if (!adminDir) throw new Error(`worktree ${wtPath} tạo xong nhưng không đọc được git-dir để ghi dấu`);
+  const mark = { task_id: taskId, root: main, created_ts: core.nowIso(), branch };
+  fs.writeFileSync(path.join(adminDir, MARK), `${JSON.stringify(mark, null, 2)}\n`);
+  recordWt(ctx, taskId, { action: 'add', path: wtPath, repo: main, branch });
+  const msg = `Đã tạo worktree ${wtPath} trên nhánh ${branch} (dấu dieu-phoi: task ${taskId}). Brief dùng dòng "worktree: ${wtPath}".`;
+  return { code: 0, out: opts.json ? JSON.stringify({ task_id: taskId, path: wtPath, branch }) : msg };
+}
+
+function wtClean(opts) {
+  const ctx = ctxOf(opts);
+  const { main, common } = mainCheckoutOf(repoOf(opts));
+  const events = core.readEvents(ctx);
+  const accepted = new Set(events.filter((e) => e && e.kind === 'verdict' && agg.normalizeVerdict(e).by === 'user' && e.outcome === 'accept')
+    .map((e) => e.task_id));
+  const gone = agg.discardedTaskIds(events);
+  const rows = [];
+  for (const w of markedWorktrees(common)) {
+    let why = null;
+    if (!w.exists) why = 'thư mục đã mất';
+    else if (accepted.has(w.task_id)) why = 'đã nghiệm thu';
+    else if (gone.has(w.task_id)) why = 'đã loại (discard)';
+    if (why) rows.push(Object.assign({}, w, { why }));
+  }
+  if (!rows.length) return { code: 0, out: 'wt clean: không có worktree có dấu nào cần dọn.' };
+  const apply = opts.yes === true;
+  const lines = [];
+  for (const w of rows) {
+    const label = `task=${w.task_id} nhánh=${w.branch || '?'} (${w.why})`;
+    if (!w.exists) {
+      // Thư mục đã mất: chỉ bỏ thư mục đăng ký của chính worktree có dấu này (git-dir), không đụng thư mục khác.
+      if (apply && path.dirname(w.admin) === path.join(common, 'worktrees')) {
+        fs.rmSync(w.admin, { recursive: true, force: true, maxRetries: 3 });
+        recordWt(ctx, w.task_id, { action: 'remove', path: w.path, repo: main, reason: 'missing' });
+        lines.push(`đã bỏ đăng ký ${w.path || w.name}: ${label}`);
+      } else lines.push(`sẽ bỏ đăng ký ${w.path || w.name}: ${label}`);
+      continue;
+    }
+    const dirty = dirtyOf(w.path);
+    if (dirty !== false) { lines.push(`giữ ${w.path}: ${dirty ? 'còn thay đổi chưa commit' : 'không đọc được trạng thái git'} — ${label}`); continue; }
+    if (!apply) { lines.push(`sẽ gỡ ${w.path}: ${label}`); continue; }
+    const r = removeMarked(w, main);
+    if (r.removed) recordWt(ctx, w.task_id, { action: 'remove', path: w.path, repo: main, reason: w.why });
+    lines.push(`${r.msg}: ${label}`);
+  }
+  const tail = apply ? '' : '\nDry-run: chưa xoá gì. Chạy lại với --yes để thực hiện.';
+  return { code: 0, out: `wt clean (${apply ? 'đã thực hiện' : 'dry-run'}):\n${lines.join('\n')}${tail}` };
+}
+
+/** `dieu-phoi wt add|clean` (core 0.7.2 s17). */
+function cmdWt(opts) {
+  const sub = opts._[0];
+  if (sub === 'add') return wtAdd(opts);
+  if (sub === 'clean') return wtClean(opts);
+  throw new Error('Cú pháp: dieu-phoi wt add --task <task_id> [--repo r] [--path dir] [--branch b]\n'
+    + '         dieu-phoi wt clean [--repo r] [--yes]');
+}
+
+module.exports = { cmdWt, cleanupTask, mainCheckoutOf, markedWorktrees, MARK };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kienntpixon/dieu-phoi",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "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>",
@@ -22,6 +22,7 @@
     "bin/",
     "agents/",
     "lib/",
+    "profile/",
     "hook.cjs",
     "pricing.json",
     "README.md",
@@ -32,6 +33,7 @@
     "node": ">=18"
   },
   "scripts": {
+    "prepack": "node scripts/pack-profile.cjs",
     "test": "node --test"
   },
   "keywords": [

package/profile/lessons.md

@@ -0,0 +1,83 @@
+# Bài học điều phối — phòng ai-lab
+
+Một dòng mỗi bài học, ghi sau mỗi lần fail hoặc người dùng phải sửa lại. Brief cho lần sau chèn các dòng khớp `task_type` / tag. Retro gộp dòng trùng và xoá dòng lỗi thời.
+
+Định dạng:
+
+```
+- [YYYY-MM-DD] <task_type> | <model>/<effort> | <tag tự do, vd. repo/miền> — <điều đã sai> → <cách tránh trong brief/kiểm tra>
+```
+
+Ví dụ: `- [2026-10-09] feature-impl | sonnet/high | isle — quên chạy migration → thêm "chạy migration + test trên DB test" vào tiêu chí nghiệm thu`
+
+Không ghi nội dung prompt, dữ liệu khách hàng, secrets, đường dẫn tuyệt đối.
+
+Bài học viết cho **điều phối viên** đặt `[orch]` ở chỗ `<task_type>` (vd. `- [2026-10-12] [orch] | * | verdict — …`): điều phối viên không đọc file này, CLI (≥ 0.4.0) hiện 5 dòng `[orch]` cuối trong khối khởi động / `dieu-phoi start`. Các dòng khác do agent tự lọc theo `task_type`.
+
+Nhiều máy: file trong skill đã publish là bản đã duyệt (một nguồn duy nhất, sửa ở repo nguồn). Dòng ghi `>>` trên một máy chỉ ở máy đó; khi cài hoặc cập nhật skill, `profile/.lessons.published.md` giữ nguyên bản đã publish mà máy đang dùng, để `tools/lessons_sync.cjs` (`harvest`) biết dòng nào là của riêng máy (so sánh văn bản đã chuẩn hoá) và đẩy vào `lessons-inbox/<máy>.md` trong repo nguồn (ngoài `skill/`, không lên Hub). Retro gộp inbox vào file này; dòng đã gộp tự biến khỏi tập dòng riêng của máy.
+
+## Câu hỏi cổng 1
+
+Câu hỏi bắt buộc hỏi ở cổng 1 cho từng loại task (retro thêm khi tỉ lệ steer cao). Định dạng: `- <task_type>: <câu hỏi>`
+
+- *: (chỉ khi kế hoạch có ≥ 4 bước s≤6) Chọn mode? fast (bước s≤6 không verifier riêng, test chọn lọc, một verifier gộp chạy cả suite trước khi trình, tự nghiệm thu rồi bạn duyệt cuối) | normal (mặc định) | strict (luôn cả suite + kiểm ngẫu nhiên 1/3). Kế hoạch nhỏ hơn: dùng normal, không hỏi (retro 11-05: 46/46 lần chọn normal, fast 0 lần qua 2 retro). Sàn an toàn giữ ở mọi mode; đổi được giữa chừng.
+- extract: Cần đúng những trường nào, đầu ra định dạng gì (bảng/JSON/cột Sheet), và khi các nguồn lệch nhau thì nguồn nào là chuẩn? (retro 11-05: steer_rate 0,3, n10)
+
+## Bài học
+
+- [2026-10-12] plan-design,search | * | steps.json — 23 agent dùng task_type tự đặt (bug-fix, config, shell, docs, design, plan, deploy, research, art-fix) nên mất prior, rơi về opus/medium → chỉ dùng 12 loại cố định + art-gen; bug-fix→debug, config/shell/deploy→mechanical-edit, docs→content-write, design/plan→plan-design, research→research-synth, art-fix→art-gen
+- [2026-10-12] feature-impl,content-write,debug,art-gen | * | quota — dừng vì hết usage limit bị ghi thành timeout (5/18 lượt không pass) → báo "STATUS: partial — quota-pause", không bao giờ báo timeout
+- [2026-10-11] [orch] | * | state/log — lấy tier --approved từ `dieu-phoi state` (lần duyệt mới nhất), xem lại sau mỗi lần duyệt lại, không theo trí nhớ; yêu cầu nhầm thì `dieu-phoi discard --task <id>`, không sửa tay events.jsonl
+- [2026-10-12] [orch] | * | verdict — 4 verdict ghi "điều phối viên chạy lại test" → verdict chỉ dựa trên file dp-out verify của verifier; còn nghi thì giao verifier mới, không tự chạy
+- [2026-10-12] [orch] | * | cổng 3 — chỉ 16% task có verdict người dùng nên retro học trên verdict agent → ở cổng 3 hỏi nghiệm thu từng bước; bước chưa đạt reject theo task, phần còn lại `verdict --root <root> accept`
+- [2026-10-16] * | * | report — Claude Code chặn cứng Write trong subagent khi tên file khớp `/^(REPORT|SUMMARY|FINDINGS|ANALYSIS).*.md$/i` ("Subagents should return findings as text"; không cấu hình được, chạy trước permissions) → mọi file kết quả của exec/verify/scout đặt tên `dp-out-<task>-<role>-try<n>.md` (handoff-*.md không bị chặn); ghi hỏng thì Bash heredoc, vẫn hỏng thì trả inline (hook tự lưu `.inline.md`); áp dụng cả file sản phẩm trong repo (REPORT.md bị chặn 2026-10-17) → đặt tên khác, vd. RESULTS.md / docs/<topic>.md
+- [2026-10-13] feature-impl | * | web/brand — QA headless bỏ sót lỗi cache cũ → trước khi deploy yêu cầu cache-busting `?v=` cho css/js và layout vẫn đúng khi không có CSS/JS (inline SVG)
+- [2026-10-11] art-gen | * | qis — agent in hub key từ qis-information.md ra output công cụ → brief ghi rõ: đọc file trong script, không cat/grep/in nội dung
+- [2026-10-11] feature-impl,test-write | * | lanes — DoD của bước lane phải chạy mọi smoke mode chạm màn hình bước đổi; smoke mode mới chờ theo điều kiện, không đếm tap cố định (PB)
+- [2026-10-13] art-gen,feature-impl | * | brand/logo — logo nhiều lớp: mọi xử lý tương phản (viền/glow) áp dụng giống nhau cho mọi lớp của logo, không chỉ một lớp
+- [2026-10-13] feature-impl,debug,test-write | * | unity-lanes — nhiều editor Unity cùng máy dẫm nhau (khớp process lỏng, đóng nhầm editor, play không focus đứng hình, C: đầy) → brief bước Unity đọc <skill>/profile/unity-lanes.md mục 4-11
+- [2026-10-13] plan-design | * | unity-lanes — kế hoạch Unity dài chạy tuần tự → planner đọc unity-lanes.md mục 1-3, ghi unity_lane/unity_lane_2 + bước integrator
+- [2026-10-13] plan-design,feature-impl | * | unity-lanes — nhiều máy cùng repo game → planner gán thêm `machine` cho bước Unity; claim bước bằng commit+push, push thường (không force); đọc unity-lanes.md mục "Nhiều máy"
+- [2026-10-13] [orch] | * | unity-lanes — bước Unity song song/nhiều máy → planner gán unity_lane (+machine), mỗi lane một agent, sau mỗi bước lane có bước integrator trên trunk; editor/khoá/claim: <skill>/profile/unity-lanes.md
+- [2026-10-13] feature-impl,debug,test-write | * | stuck — git/Unity "treo" thường là hộp thoại modal ẩn (UnityYAMLMerge, Safe Mode) → soi cây process con + tên cửa sổ; git qua lanes.py có timeout; chỉ kill PID mình; unity-lanes.md mục 14
+- [2026-10-13] test-write,feature-impl | * | device-qa — QA MuMu chơi save thật của người dùng, adb hay chết → sao lưu save app trước, khôi phục sau; adb offline: kill-server, MuMuManager restart, đọc lại cổng
+- [2026-10-13] [orch] | integrate | trunk — phiên khác commit/push trunk trong lúc integrator đang test → mọi commit/push trên trunk phải tôn trọng MERGE_LOCK; lượt tap đầu của smoke chờ theo điều kiện ≤ 30 s khi nhiều editor cùng chạy
+- [2026-10-13] [orch] | * | stuck — agent im > min(15 phút, ½ budget_s) hoặc lặp một trạng thái → SendMessage hỏi đang chờ gì; 10 phút không tiến → steer theo unity-lanes.md mục 14; không ngồi chờ, "Waiting." lặp thì không trả lời
+- [2026-10-16] [orch] | feature-impl | brief — brief trỏ 4+ báo cáo/hợp đồng làm exec chạm ngưỡng handoff (200k) trước khi viết code → chỉ trỏ bước + báo cáo đầu vào trực tiếp; agent tiếp nối chỉ đọc handoff
+- [2026-10-18] feature-impl | * | demo-match — game làm sát demo: test xanh không chứng minh khớp hình ảnh → exec đo tỉ lệ (px/ô, nhân vật, khung UI) từ ảnh demo tham chiếu, dựng sprite theo demo; verifier so ảnh chụp cạnh demo
+- [2026-10-18] feature-impl | * | process — `taskkill /F /IM node.exe` giết tiến trình node của agent song song/người dùng → chỉ dừng PID mình khởi chạy
+- [2026-10-18] feature-impl | * | web-audio — Chromium desktop xanh không đủ cho game web có âm thanh → nghiệm thu gồm Safari iOS/Chrome Android thật hoặc WebKit e2e (unlock/resume AudioContext, định dạng)
+- [2026-10-18] [orch] | * | ports — exec song song trên cùng repo chạy e2e/preview tranh cổng 4173 và dist → brief ghi cổng riêng (--port) hoặc gộp e2e vào 1 verifier sau khi các bước song song xong
+- [2026-10-18] feature-impl | sonnet/high | handoff — era 200k: 3/9 chuỗi handoff sonnet không đạt (0/12 opus) → bước feature-impl lớn (dự đoán > 200k) giao opus/medium, hoặc tách bước ngay ở kế hoạch; không leo tier giữa chuỗi
+- [2026-10-22] [orch] | feature-impl | handoff — 10-22: 15/63 task handoff ≥ 2 lần (median $16 so với $2,3), cq7yn1ws 10 handoff $70 rồi fail; 10-26: phiên 36cee993 vẫn 25/66 task ≥ 2 handoff, 11 task tới handoff thứ 3 (phiên khác 2/87) → sau handoff thứ 2 của một task: dừng tiếp nối, giao planner chia phần còn lại thành bước mới (task_id mới); nhận handoff còn > 1 hạng mục thì giao thành các bước riêng; ở cổng 1, bước feature-impl đụng > 1 màn hình/module lớn thì tách sẵn
+- [2026-10-18] [orch] | * | handoff — 2 chuỗi đóng ở `partial — handoff` không có agent tiếp nối mà vẫn pass → STATUS handoff luôn phải có agent tiếp nối hoặc verifier kiểm phần còn lại trước verdict
+- [2026-10-18] review,verify | haiku/* | dp-out — 10/24 file .inline.md ở era B là của verifier → brief verify: Write dp-out trước khi trả VERDICT
+- [2026-10-18] feature-impl,content-write | * | edit — s32b xoá nhầm 41 dòng design.md bằng script regex/sed → sửa docs/markdown bằng Edit với chuỗi khớp duy nhất, không dùng script thay khối; backup file trước khi sửa hàng loạt
+- [2026-10-18] [orch] | * | verify — giao verifier sớm thì nó đọc dp-out rỗng và trả fail giả → chỉ giao verifier SAU khi nhận task-notification completed của chính exec đó
+- [2026-10-22] [orch] | * | tag — 76 dp-exec ($407) mất task_id vì `[dp:<id>|…]`; 10-26 còn 10 nhãn lạ; 11-05 hook đã tự đổi 15 bí danh, còn 10 bad-type (test-run, test-verify, device-qa, git-ops, release-build, read-scan, untagged), và sau compact từng viết root=/step= → tag luôn đủ `[dp:<task_type>|s<n>|<urgency>|try<n>|task=<id>|role=…]`, task_type lấy đúng chuỗi `choose --json` trả về; quét/đọc → search, architecture → plan-design, shell/git-ops/release-build → mechanical-edit, test-run/device-qa → test-write
+- [2026-10-22] [orch] | * | agent — 9 agent general-purpose chạy tới 311–367k (không có watchdog handoff) → mọi việc điều phối dùng dp-scout/dp-exec/dp-verify; general-purpose chỉ khi `doctor` báo chưa cài
+- [2026-10-26] [orch] | * | session — 10-26: phiên 36cee993 (168 lượt, 946k, 20 nén, 73% chi phí); 11-05: phiên d8fe5944 vẫn chạy 10-25..11-04, 286 lượt, ngữ cảnh 956k, 27 nén, chi phí điều phối $673 (66% chi phí điều phối của kỳ), 0 verdict người dùng, 31 task ≥ 2 handoff, 273 lượt exec không chạy `choose` → khi `choose`/`ctx` báo `new_session` (ngữ cảnh > 400k hoặc ≥ 5 nén): ghi trạng thái (plan.md + backlog), trình cổng 3 các bước đã xong, mở phiên mới; không giao bước mới trong phiên cũ
+- [2026-10-26] [orch] | * | knowledge — kho chỉ gộp delta khi người dùng `accept`; 11-05: 73 delta đọng > 24h, đa số thuộc task chỉ có verdict agent, nhưng 16 task ĐÃ accept vẫn chưa gộp (7 task không có trong plan file nên accept không tìm thấy run dir; 3 xung đột build-test) → ở cổng 3 dùng `verdict --root <root> accept` và ĐỌC dòng "knowledge (tự gộp khi accept)": không có dòng đó mà run có delta của task → `knowledge merge --run <root> --task <id> --dry-run` rồi chạy thật; bước thêm ngoài kế hoạch cũng phải vào plan file; header `repo:` là đường dẫn tuyệt đối
+- [2026-10-26] [orch] | * | input-recall — sau khi nén ngữ cảnh, điều phối viên báo "nội dung X còn chờ người khác" dù người dùng đã giao đủ nguồn trong run dir → trước khi báo việc gì "chờ người dùng/bên ngoài": grep plan.md + mở thư mục nguồn đã giao; việc đã giao mà chưa xếp lane ghi backlog "chưa làm", không ghi "chờ"
+- [2026-10-26] [orch] | * | e2e-base — exec s7 chạy e2e mcp/install/integrity quên đặt BASE nên gọi prod skillhub.pixon.cc (chỉ đọc, token sai) → brief chạy e2e luôn ghi rõ BASE=localhost và bắt agent kiểm biến trước khi chạy
+- [2026-10-26] [orch] | feature-impl,debug,test-write | unity-lanes — agent nào cũng tự mở/đóng Unity, worktree mới mỗi bước → trần 3 editor/máy, 3 slot worktree cố định (Library ấm), editor mở sẵn + cầu nối job queue (`unity_slot.py`); brief bước Unity ghi slot + "không tự chạy Unity.exe"; xoá worktree hết dùng sau khi kiểm sạch; đọc unity-lanes.md mục 2.1
+- [2026-10-27] [orch] | debug,test-write,feature-impl | slow-fix-escalate — bug khó tái hiện (flaky E2E/race) ở sonnet/medium→sonnet/high: 2 lượt ~45 phút đổi test qua lại không ra gốc, người dùng phải tự nâng lên opus/medium thì 1 lượt ~16 phút chốt nguyên nhân bằng log timestamp và sửa ở code app → khi bước debug/flaky không hội tụ sau 1 lượt (tỉ lệ xanh không tăng, chưa có nguyên nhân gốc) hoặc vượt ~2× est_time, đề xuất leo thẳng opus/medium thay vì bậc kế tiếp cùng họ model; retro nên đưa ngưỡng thời gian vào luật leo thang
+- [2026-11-05] [orch] | * | python-stdin — máy Windows này: `python3 -`/heredoc/pipe vào python qua shim pyenv-win mất stdin → REPL lặp vô hạn (log 63 GB đầy C:); agent đã vi phạm 2 lần dù có luật → brief ghi nguyên văn: "chỉ chạy Python bằng `python file.py` (ghi script ra file), không bao giờ qua stdin"; giới hạn output lệnh nền
+- [orch] Parallel dp-exec in one worktree: an agent staging a shared file swept another's WIP and left HEAD uncompilable; give each parallel agent its own worktree, or require py_compile at HEAD + clean git status before reporting.
+- [2026-11-02] [orch] | feature-impl | ctx-ceiling — prototype game Three.js+WS ở sonnet/medium: 3 bước liên tiếp handoff ở ~210k token (server+client+smoke trong 1 bước) → chia bước theo lớp: (1) shared+server+test, (2) client+smoke+push; dặn commit phần xanh trước handoff
+- [2026-11-03] [orch] | feature-impl | netcode-smooth — prototype multiplayer qua verifier (smoke/test xanh) nhưng người dùng thấy di chuyển giật + camera không ra TPS hành động: tiêu chí máy không bắt cảm giác chơi → brief game client phải ghi rõ nội suy/snapshot buffer + client prediction và tham chiếu camera của game TPS cụ thể; verifier chụp/quay vài khung để đánh giá
+- [2026-11-03] [orch] | art-gen,feature-impl | asset-tier — người dùng chỉ định: việc model nhân vật (mọi dự án; sonnet/medium ra bản diorama "cute" chưa đủ) và MỌI việc dựng asset của Anti Sleep City (nhân vật, NPC, monster, cosmetic, props, VFX, UI art) giao opus/medium bằng `--override`; brief trỏ asset guideline (docs/asset-guideline + PAS) khi đã có
+- [2026-11-03] [orch] | deploy,smoke | prod-cleanup — smoke trên prod: script dọn dẹp revoke cả token thật (pixi) của người dùng → brief smoke prod phải buộc chỉ thu hồi/xoá đúng id token/user do chính lượt đó tạo (ghi id lúc tạo), cấm revoke theo tên/pattern/toàn bộ.
+
+- [2026-11-03] review,feature-impl | * | docker-cleanup — verifier kill "tiến trình nghe cổng pg/redis của mình" (2kaq9gvq M1) nhưng đó là backend Docker Desktop, mọi container trên máy dừng → dọn bằng `docker compose -p <project> down -v`, chỉ kill PID node/vite do chính mình spawn (ghi PID lúc spawn); KHÔNG kill theo cổng, KHÔNG kill com.docker.*/wsl*/vmmem
+- [orch] home-school: không cho agent `docker exec`/psql/pg_isready vào DB prod (Postgres PID 1 không init → tiến trình mồ côi exit 2 gây crash recovery); hạn chế chạy song song test/DB container khi ổ D HDD nghẽn (docker vhdx trên D:).
+- [orch] feature-impl port lớn (Rust parity): agent opus/medium hay chạm 200k ngữ cảnh trước khi commit — brief phải ép 'build+commit từng phần ngay', đọc file lớn theo đoạn, và tách bước >8 người-ngày thành bước con trước khi giao
+- [2026-11-04] [orch] | debug,security | argv-secret — brief điều tra tiến trình có secret trong argv phải cấm ps -ef/ps aux/cat /proc/*/cmdline (chỉ grep -c), agent haiku đã in argv làm lộ token GitLab trong phiên
+- [2026-11-04] [orch] | debug,security | secret-file-read — brief sửa webapp/deploy phải cấm sed/cat/grep không -c lên /etc/comfy-studio/* và mọi file secret (chỉ stat/ls/grep -c), agent sonnet đã in admin-initial-password ra tool output
+- [orch] Agent kiểm prod viết lệnh git grep sai (pattern/ref đảo) nên kết luận ngược; brief kiểm code phải ghi sẵn lệnh git grep đúng cú pháp hoặc yêu cầu trích dòng code làm bằng chứng.
+- [2026-11-05] [orch] | * | orphan — 143/2.423 agent (5,9%) kết thúc không có dòng STATUS (đã chết giữa chừng), 117 không được giao lại, 42 không có verdict nào; giao lại sau p50 31 phút, p75 71, tối đa 12 giờ; sau nén ngữ cảnh tỉ lệ này cao gấp 3 lần (10% so với 3%); từng báo s16 "đang chạy" nhiều giờ khi không còn agent → sau mỗi restart/compact/handoff/stop: lấy danh sách agent đang chạy (TaskStop lỗi liệt kê) đối chiếu với các bước báo "đang chạy"; bước không có agent hoặc dp-out chỉ có `.inline.md` dở dang/không STATUS → giao lại ngay (try+1), không chờ thông báo sẽ không tới
+- [orch] Trước khi giao một bước, xem tên/đặc tả trong steps có phải deploy không. Nếu đúng: choose --publish y, hỏi người dùng go-ahead rồi trích nguyên văn vào brief, kẻo exec dừng blocked (bwkuqdna s8, 05/11).
+- [orch] Trước khi giao bước, kiểm depends_on của nó đã merge vào nhánh tích hợp chưa (g4 giao trước khi g1 merge → blocked).
+- [2026-11-05] [orch] | * | verify-task-id — 41/756 lượt verify (5,4%) mang task_id không có exec nào (19 không có cả trong plan), 24 verdict agent rơi vào id sai nên bước thật thiếu verdict → thẻ verify chép đúng `task=<id>` từ lượt exec của bước đó (không tự đặt id mới); verifier gộp dùng thẻ `|batch`
+- [2026-11-05] [orch] | * | choose — 425/1.540 lượt exec (28%) giao không chạy `choose` (273 trong phiên d8fe5944: debug chạy opus 61 lượt, $p50 5,5 so với sonnet/medium 1,1) và 138 lượt khác tier của `choose` không ghi override → mỗi lượt exec chạy `choose --json`; giao tier khác thì `--override` để retro học
+- [2026-11-05] plan-design | * | tier-table — kế hoạch xếp opus/medium cho mechanical-edit ≥ 35 lần (n105, $p50 1,50 trong khi haiku/medium $0,03 accept 0,91, sonnet/medium $0,58 accept 0,91) và haiku/low 13 lần (accept 0,73, n15) → cột tier lấy từ `dieu-phoi choose --json` cho từng bước; opus cho mechanical-edit/debug phải ghi lý do một dòng; không xếp haiku/low