taskboard-workbench 0.0.0-stage → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/CHANGELOG.md +403 -0
  2. package/LICENSE +21 -0
  3. package/README.md +210 -2
  4. package/cli/tb.mjs +314 -0
  5. package/cordis.patch.yml +5 -0
  6. package/index.js +633 -0
  7. package/lib/client.js +522 -0
  8. package/package.json +96 -4
  9. package/scripts/tb-flow.mjs +86 -0
  10. package/skills/taskboard-flow/SKILL.md +89 -0
  11. package/skills/taskboard-flow/references/errors.md +61 -0
  12. package/skills/taskboard-flow/references/injection.md +70 -0
  13. package/skills/taskboard-flow/references/steps/S0.md +31 -0
  14. package/skills/taskboard-flow/references/steps/S1.md +28 -0
  15. package/skills/taskboard-flow/references/steps/S2.md +31 -0
  16. package/skills/taskboard-flow/references/steps/S3.md +22 -0
  17. package/skills/taskboard-flow/references/steps/S4.md +25 -0
  18. package/skills/taskboard-flow/references/steps/S5.md +36 -0
  19. package/skills/taskboard-flow/references/steps/S6.md +30 -0
  20. package/skills/taskboard-flow/references/steps/S7.md +23 -0
  21. package/spec/norms/acceptance.md +36 -0
  22. package/spec/norms/card-update.md +39 -0
  23. package/spec/norms/doc-editing.md +30 -0
  24. package/spec/norms/flow.md +45 -0
  25. package/spec/norms/manifest.json +41 -0
  26. package/spec/norms/project-defaults.md +33 -0
  27. package/spec//345/233/242/351/230/237agent.md +171 -0
  28. package/src/core/acceptance.mjs +62 -0
  29. package/src/core/advance.mjs +192 -0
  30. package/src/core/agent-teams.mjs +48 -0
  31. package/src/core/binding.mjs +44 -0
  32. package/src/core/config.mjs +22 -0
  33. package/src/core/contract.mjs +287 -0
  34. package/src/core/debug-dispatch.mjs +94 -0
  35. package/src/core/delivery.mjs +93 -0
  36. package/src/core/deps.mjs +53 -0
  37. package/src/core/diagnostics.mjs +648 -0
  38. package/src/core/domain.mjs +235 -0
  39. package/src/core/empty-state.mjs +240 -0
  40. package/src/core/errors.mjs +142 -0
  41. package/src/core/evidence.mjs +86 -0
  42. package/src/core/executor.mjs +645 -0
  43. package/src/core/human-review.mjs +773 -0
  44. package/src/core/intake.mjs +179 -0
  45. package/src/core/kickoff.mjs +147 -0
  46. package/src/core/loop.mjs +498 -0
  47. package/src/core/memory.mjs +193 -0
  48. package/src/core/next-step.mjs +377 -0
  49. package/src/core/notify.mjs +183 -0
  50. package/src/core/owner.mjs +41 -0
  51. package/src/core/requirements.mjs +292 -0
  52. package/src/core/review.mjs +82 -0
  53. package/src/core/session-naming.mjs +64 -0
  54. package/src/core/split-ask.mjs +107 -0
  55. package/src/core/store.mjs +3442 -0
  56. package/src/core/team.mjs +170 -0
  57. package/src/core/ticket-stage.mjs +150 -0
  58. package/src/core/verify.mjs +170 -0
  59. package/src/core/watchdog.mjs +144 -0
  60. package/src/host/ai-elaborator.mjs +26 -0
  61. package/src/host/team-engine.mjs +125 -0
  62. package/src/host/tool-surface.mjs +205 -0
  63. package/src/mcp/flow-block.mjs +173 -0
  64. package/src/mcp/server.mjs +156 -0
  65. package/src/mcp/tools.mjs +764 -0
  66. package/src/server/api.mjs +2050 -0
  67. package/src/server/events.mjs +32 -0
  68. package/src/server/kickoff.mjs +46 -0
  69. package/src/server/server.mjs +214 -0
  70. package/src/server/verify.mjs +112 -0
  71. package/tools/env-check.mjs +35 -0
  72. package/tools/seed.mjs +67 -0
  73. package/web/app.js +5337 -0
  74. package/web/index.html +15 -0
  75. package/web/tokens.css +1151 -0
@@ -0,0 +1,645 @@
1
+ /**
2
+ * executor.mjs —— CLI 执行器(FR-85 前置的"真实落盘"执行通道)。
3
+ *
4
+ * 背景:看板项目设置里 `teamTemplate.roles[].executor` 已经写了 `cli:claude`(**角色级**执行器),
5
+ * 但仓库里此前**没有任何代码去执行它** —— 派发只做到"把指令投进项目主会话",而那条路在当前 DSH
6
+ * 版本上被 preset/scope 机制挡住(见 docs/进度/2026-10-18-*.md §三)。本模块补上缺的执行器本体:
7
+ * 由看板侧**真的**以非交互方式调用 `claude` CLI 干活,并把证据(stdout/stderr/退出码/改动清单/
8
+ * 自测)落回看板(评论 + 尝试记录 + 状态回流)。
9
+ *
10
+ * 设计约束(与 AGENTS.md 一致):
11
+ * · 纯 Node 内置模块,零依赖;spawn 可注入(便于单测与桩替身)。
12
+ * · 一切外部行为都 try/catch 收口,绝不吞错:失败要如实写"受阻 + 证据"。
13
+ * · 不 commit / 不 push:只让执行器改工作区文件,提交仍归人。
14
+ */
15
+ import { spawn } from "node:child_process";
16
+ import { createHash } from "node:crypto";
17
+ import { readFile, readdir, stat } from "node:fs/promises";
18
+ import { join, relative, sep } from "node:path";
19
+
20
+ // 配额/鉴权类错误的正则**只有一份**(`store.mjs` 导出);本处用于给 CLI 失败**正确分类**,
21
+ // 不另抄一份免得漂移。
22
+ import { QUOTA_AUTH_ERROR_RE } from "./store.mjs";
23
+
24
+ /** 支持的 CLI 执行器形态(`cli:<命令>`)。 */
25
+ export const CLI_EXECUTOR_PREFIX = "cli:";
26
+ /** 默认超时:30 分钟(一次真实开发任务的合理上限)。 */
27
+ export const DEFAULT_TIMEOUT_MS = 30 * 60 * 1000;
28
+ /** 默认放行工具(非交互下必须显式放行,否则 claude 会因权限被拒而空转)。 */
29
+ export const DEFAULT_ALLOWED_TOOLS = "Bash Edit Write Read Glob Grep";
30
+ /** stdout/stderr 落盘上限(看板评论不需要 MB 级日志)。 */
31
+ export const MAX_OUTPUT_CHARS = 4000;
32
+ /**
33
+ * CLI 执行期的**心跳间隔**(2026-10-22 真机 `-122` 补口)。
34
+ *
35
+ * 缺陷现场:子进程真在跑(`durationMs=688222`,11.5 分钟),但执行器**只在开跑时写一次认领**,
36
+ * 整个执行期不打心跳 ⇒ 心跳停在开跑那刻。而本仓库的停滞阈值是 10 分钟
37
+ * (`store.DEFAULT_HEARTBEAT_GAP_MS`)—— 于是:
38
+ * · `GET /execution` 回 `claim.stale=true`、`heartbeatAgeSeconds=656`;
39
+ * · 看护因 CLI 路径 `sessionId` 恒为 `null` → 必落 `session-offline` → `watchdog.state="stalled"`;
40
+ * · 诊断出 `stalled/high`,主按钮变成「退回待办(重新派发)」——人一点就与**仍在写文件**的
41
+ * 子进程并发 ⇒ 同文件双写,违反 FR-86「共享文件串行」。
42
+ * 取 45s:远小于 10 分钟阈值(一个阈值窗口内至少 13 次心跳),也不会因为写库而喧宾夺主。
43
+ */
44
+ export const HEARTBEAT_INTERVAL_MS = 45 * 1000;
45
+ /** 判定"改动落地"依据:git 工作区是否有变更。 */
46
+ export const DISALLOWED_OUTCOME_RE = /(EACCES|ENOENT|command not found|permission denied)/i;
47
+
48
+ export function cliCommandOf(executorId) {
49
+ return String(executorId ?? "").startsWith(CLI_EXECUTOR_PREFIX) ? String(executorId).slice(CLI_EXECUTOR_PREFIX.length) : null;
50
+ }
51
+
52
+ /**
53
+ * 角色 → CLI 执行器解析。
54
+ * 口径:① 禁用清单(`forbiddenExecutors`)里的执行器一律不选;② 同角色条目优先;
55
+ * ③ 退一步取该角色族里任意 `cli:*`;④ 再退一步取工程角色。
56
+ * 返回 `{ id, cli, role }` 或 `null`(= 该项目不走 CLI 执行器,保持原会话派发)。
57
+ */
58
+ export function resolveCliExecutor(settings, { role = "engineer" } = {}) {
59
+ const tpl = settings?.teamTemplate ?? {};
60
+ const forbidden = new Set((tpl.forbiddenExecutors ?? []).map((x) => String(x)));
61
+ const roles = Array.isArray(tpl.roles) ? tpl.roles : [];
62
+ const usable = (entry) => {
63
+ const id = entry?.executor;
64
+ const cli = cliCommandOf(id);
65
+ if (!cli || forbidden.has(String(id))) return null;
66
+ return { id: String(id), cli, role: entry.role ?? role };
67
+ };
68
+ return usable(roles.find((r) => r.role === role))
69
+ ?? usable(roles.find((r) => cliCommandOf(r?.executor)))
70
+ ?? usable({ role, executor: tpl.engineer?.executor })
71
+ ?? null;
72
+ }
73
+
74
+ /** CLI 参数:非交互 + 显式放行工具 + 允许访问项目目录(可被设置里的 `engineer.args` 覆盖)。 */
75
+ export function cliArgsFor({ executorId, cwd, settings }) {
76
+ const override = settings?.teamTemplate?.engineer?.args;
77
+ if (Array.isArray(override) && override.length) return override.map(String);
78
+ return [
79
+ "-p",
80
+ "--permission-mode", "acceptEdits",
81
+ "--allowedTools", String(settings?.teamTemplate?.engineer?.allowedTools ?? DEFAULT_ALLOWED_TOOLS),
82
+ "--add-dir", cwd,
83
+ ];
84
+ }
85
+
86
+ /**
87
+ * 「本次参数是否**允许写文件**」—— 2026-10-26 补口(真机实测过的静默陷阱)。
88
+ *
89
+ * 背景:裸 `claude -p`(**不带** `--permission-mode acceptEdits`)会**拒绝写入、零产出**,
90
+ * 却仍然**退出码 0**(隔离实验原文见 `docs/进度/2026-10-26-验证台真跑claude-HTTP客户端修复.md` §三)。
91
+ * 而 `cliArgsFor` 允许用 `teamTemplate.engineer.args` **整体覆盖**默认参数(含那句 acceptEdits)——
92
+ * 一旦有人这么配,执行器就会「成功」跑完却什么都没改,看板还会把卡推进「待验收」:**闭环静默空转**。
93
+ *
94
+ * 判据只看「有没有显式的写权限模式」,**不猜** CLI 的默认值;**未覆盖**(空 / 非数组)视为走默认
95
+ * (默认参数里就有 acceptEdits)⇒ 返回 true,不制造噪音。
96
+ */
97
+ export const EDIT_PERMISSION_HINTS = Object.freeze([
98
+ "acceptEdits", "bypassPermissions", "--dangerously-skip-permissions",
99
+ ]);
100
+
101
+ export function argsAllowEdits(args) {
102
+ if (!Array.isArray(args) || args.length === 0) return true; // 未覆盖 ⇒ 用默认(默认含 acceptEdits)
103
+ const tokens = args.map(String);
104
+ return tokens.some((token) => EDIT_PERMISSION_HINTS.some((hint) => token.includes(hint)));
105
+ }
106
+
107
+ /**
108
+ * 给 CLI 的任务指令(自包含:目标 / 边界 / 产出 / 纪律)。
109
+ *
110
+ * **格式口径(卡 `-145` · `docs/规范/01-协作规范.md` §一)**:本函数是本仓「派发任务书」的
111
+ * **唯一代码产出点**(`api.mjs` 的 `/kickoff` 与 `/exec-cli` 都经它),故按 §一 模板分五段:
112
+ * **已获授权 / 硬边界 / 已知前置 / 分步判据 / 停下情形**,外加 **回报格式**。
113
+ * §一 硬规则 #1:模板外层用 **4 反引号**(内含 3 反引号代码块时必须如此,否则提前闭合)——
114
+ * 本函数产出的就是「要嵌进外层 ``` 围栏」的正文,故正文内**任何代码块一律 4 反引号**。
115
+ * §一 硬规则 #2:**每个 Step 必须同时给判据与停下情形**,缺一即为不合格模板。
116
+ */
117
+ export function buildTaskPrompt(task, { project, requirementId = null, verifyCommand = null } = {}) {
118
+ const cwd = project?.workspacePath ?? null;
119
+ const steps = [
120
+ `## Step 0 — 预检(只读,不通过就停)`,
121
+ ``,
122
+ "确认工作目录与仓库状态,不通过即按下方「停下情形」处理:",
123
+ ``,
124
+ "````bash",
125
+ `cd ${cwd ?? "<工作目录>"} && pwd && git status --porcelain | head -20`,
126
+ "````",
127
+ ``,
128
+ "判据:能进入工作目录且能读到 git 状态。",
129
+ "停下情形:目录进不去 / git 不可用且任务并非纯读图时,停并回报「停下(Step 0)」,如实贴出实际状态。",
130
+ ];
131
+ const verify = verifyCommand
132
+ ? { cmd: verifyCommand, label: "运行任务书指定的复核动作" }
133
+ : { cmd: "运行本任务相关的自测", label: "运行相关自测" };
134
+
135
+ return [
136
+ `# 任务:完成看板任务 ${task.identifier} — ${task.title}`,
137
+ ``,
138
+ `## 已获授权`,
139
+ `- 直接改代码完成「${task.identifier}」,范围限于该任务所需的最小文件集。`,
140
+ `- 允许运行只读检查与本任务相关的测试 / 构建命令。`,
141
+ verifyCommand ? `- 完成后可运行复核动作:\`${verifyCommand}\`。` : `- 完成后可运行相关自测并贴出结果。`,
142
+ ``,
143
+ `## 硬边界`,
144
+ `- ❌ 不 commit、不 push(提交归人或队长)。`,
145
+ `- ❌ 不改历史决策文档(\`docs/历史归档/\`、已定稿的需求与计划条款)。`,
146
+ `- ❌ 不删任何既有数据(任务 / 看板项目 / 需求条目)。`,
147
+ `- ❌ 不改本任务范围外的文件;共享文件(core/store、server/api、web/app.js)改动保持最小。`,
148
+ `- ❌ **不自行置「完成(done)」** —— 完成只能由人确认,你只提交「待验收」。`,
149
+ cwd ? `- ✅ 只允许改 ${cwd} 内的文件。` : "",
150
+ `- ✅ 隔离验证用临时目录 / 临时端口 / 独立进程,跑完即删。`,
151
+ ``,
152
+ `## 已知前置`,
153
+ requirementId ? `- 需求条目:${requirementId}(先读该条目与其验收口径)。` : "",
154
+ task.description ? `- 任务描述(原样):\n\n${task.description}` : "",
155
+ ``,
156
+ `---`,
157
+ ``,
158
+ ...steps,
159
+ ``,
160
+ `## Step 1 — 改代码(不要只给建议)`,
161
+ `目的:把「${task.identifier}」落到盘上。`,
162
+ `判据:改动只落在本任务所需文件;无范围外改动。`,
163
+ `停下情形:发现需要改共享文件或范围外文件时,停并写进「偏离说明」。`,
164
+ ``,
165
+ `## Step 2 — ${verify.label}`,
166
+ `目的:取得可核验的结果。`,
167
+ "````bash",
168
+ verify.cmd,
169
+ "````",
170
+ `判据:命令退出码为 0(若退出码非 0,如实贴出失败输出,不要修饰)。`,
171
+ `停下情形:测试失败但根因在本任务范围外时,停并写进「偏离说明」,不要顺手改无关代码。`,
172
+ ``,
173
+ `---`,
174
+ ``,
175
+ `## 回报格式(严格按这四节,逐节都写,缺节=不合格)`,
176
+ ``,
177
+ "**判定**:完成 / 部分 / 停下(哪一步)",
178
+ ``,
179
+ "**偏离说明**:指令假设 X、实测 Y、故改为 Z 的逐条记录;**无偏离也要显式写「无」**,不得省略本节。",
180
+ ``,
181
+ "**边界自查**:逐条对齐上方「硬边界」的 ❌ 清单(未 commit / 未 push / 未删数据 / 未置 done …)。",
182
+ ``,
183
+ "**产物路径**:改动文件清单、测试输出、落盘报告或截图的路径。",
184
+ ``,
185
+ `## 停下情形(严格,逐条编号;命中即停,不要继续往下做)`,
186
+ `1. **前置不满足**:工作目录进不去 / 基线测试非绿 / 依赖缺失 → 停,回报「停下(Step 0)」并如实贴出实际状态。`,
187
+ `2. **门禁不过**:复核动作退出码非 0 → 停;若根因在本任务内,先尝试最小修复;仍不过则停并贴出失败证据。`,
188
+ `3. **需要越权时**:要改范围外文件、要 commit / push、要删数据 → **一律停**,不得自行放行。`,
189
+ `4. **触及宿主级动作**:改 \`~/.dsh/profiles/**\`、plist、插件增删、重启 dsh 宿主进程 → **一律停**(属须报批范围,指令不含此授权)。`,
190
+ `5. **偏离预期**:实测与指令假设不一致 → 停,并在「偏离说明」写清「指令假设 X、实测 Y、故改为 Z」。`,
191
+ ``,
192
+ `## 禁止`,
193
+ `- 与「硬边界」呼应:不得 commit / push、不得删数据、不得自行置「完成(done)」、不得改历史决策文档。`,
194
+ `- 不得把「报告说完成」当事实:交付前用实际命令(\`git status\`、测试输出)自证。`,
195
+ `- 不得臆断:实测不到的事实写「未取得 / 无法判定」,不编造。`,
196
+ ].filter(Boolean).join("\n");
197
+ }
198
+
199
+ const tail = (text, limit = MAX_OUTPUT_CHARS) => {
200
+ const s = String(text ?? "");
201
+ return s.length <= limit ? s : `…(已截断,共 ${s.length} 字符)\n${s.slice(-limit)}`;
202
+ };
203
+
204
+ /**
205
+ * **内容指纹**(2026-10-22 真机 `-122` 补口):脏工作区里「改的正是本来就脏的文件」时,
206
+ * `git status --porcelain` 的**行串前后完全相同**(都是 ` M src/host/tool-surface.mjs`),
207
+ * 行级差集必然把这次真实产出吃掉 —— 真机实测该卡主产出 `+91 行` 却不在证据清单里。
208
+ *
209
+ * 口径:对基线/收尾两侧**同一份文件清单**各算一次内容 sha1,指纹不同 ⇒ 内容确实被执行器改过。
210
+ * · 只认「基线里也有、且两侧指纹都能算出、且不相等」的条目 → 本仓库执行前的 181 项历史脏改动
211
+ * **指纹不变 ⇒ 仍然不进清单**(FR-74 红线不回退)。
212
+ * · 算不出指纹(目录条目 `?? dir/`、被删、不可读、超过 `maxBytes`)→ **不当本次产出**(宁漏不滥:
213
+ * 宁可退回旧口径的漏报,也不把历史脏改动算成产出)。
214
+ */
215
+ export async function hashWorkspaceFiles(cwd, files = [], { maxFiles = 500, maxBytes = 4 * 1024 * 1024 } = {}) {
216
+ const out = new Map();
217
+ for (const path of pathsOfStatusLines(files).slice(0, maxFiles)) {
218
+ if (!path || path.endsWith("/")) continue; // `?? docs/新目录/` 这类目录条目不做内容指纹
219
+ try {
220
+ const abs = join(cwd, path);
221
+ const st = await stat(abs);
222
+ if (!st.isFile() || st.size > maxBytes) continue;
223
+ out.set(path, createHash("sha1").update(await readFile(abs)).digest("hex"));
224
+ } catch { /* 被删 / 读不了 → 不做指纹 */ }
225
+ }
226
+ return out;
227
+ }
228
+
229
+ /** 指纹表是否真的判定出「内容变了」(两侧都算得出且不等)。 */
230
+ function contentChanged(prev, next, path) {
231
+ const a = prev?.get?.(path); const b = next?.get?.(path);
232
+ return typeof a === "string" && typeof b === "string" && a !== b;
233
+ }
234
+
235
+ /**
236
+ * 采集工作区改动清单(git 只读命令)。返回值语义**必须**区分开:
237
+ * · `{ files, stat, hashes? }` —— git 正常退出;`files: []` 表示**基线确实为空**(工作区干净)。
238
+ * · `null` —— **拿不到基线**:spawn 失败 / 超时 / git 非零退出(非 git 目录、index.lock 抢占等)。
239
+ * 真机事故(2026-10-18):把"拿不到"退化成 `files: []` 会让差集退化成全量,证据评论于是把
240
+ * 35 条历史脏改动当成本次产出。因此这里绝不允许用空数组冒充空基线。
241
+ * 瞬时失败(超时 / 锁竞争)较常见:首次失败后隔 `retryDelayMs` 重试一次。
242
+ * `hashes`:仅在全量扫描(未限定 `paths`)且算得出指纹时附带 —— 供 `diffDelta` 识别
243
+ * "本来就脏的文件的**内容**改动"(见 `hashWorkspaceFiles`)。
244
+ */
245
+ export async function collectDiffEvidence(cwd, { spawnImpl = spawn, timeoutMs = 20000, paths = null, retryDelayMs = 300 } = {}) {
246
+ const attempt = async () => {
247
+ const run = (args) => new Promise((resolve) => {
248
+ let out = ""; let done = false;
249
+ const finish = (v) => { if (!done) { done = true; resolve(v); } };
250
+ let child;
251
+ try { child = spawnImpl("git", ["-C", cwd, ...args], { cwd }); } catch { return finish(null); }
252
+ const timer = setTimeout(() => { try { child.kill("SIGKILL"); } catch { /* ignore */ } finish(null); }, timeoutMs);
253
+ child.on?.("error", () => { clearTimeout(timer); finish(null); });
254
+ child.stdout?.on("data", (b) => { out += String(b); });
255
+ child.on?.("close", (code) => { clearTimeout(timer); finish(code === 0 ? out : null); });
256
+ });
257
+ const status = await run(["status", "--porcelain"]);
258
+ if (status === null) return null; // 非零退出 / 超时 → 明确"拿不到",不冒充空基线
259
+ // 仓库本来就可能是"脏"的(本仓库就是),所以改动清单必须能和执行前的基线做差集;
260
+ // stat 只在给了具体路径时才有意义(否则会把历史改动也算进来)。
261
+ const stat = await run(paths && paths.length ? ["diff", "--stat", "--", ...paths] : ["diff", "--stat"]);
262
+ const files = status.split("\n").map((l) => l.trim()).filter(Boolean);
263
+ const result = { files, stat: (stat ?? "").trim() };
264
+ // 内容指纹:只在全量扫描时算(`paths` 模式是收尾取 diffstat,不需要)。
265
+ if (!paths) {
266
+ try {
267
+ const hashes = await hashWorkspaceFiles(cwd, files);
268
+ if (hashes.size) result.hashes = hashes;
269
+ } catch { /* 拿不到指纹 → 退回行级差集口径 */ }
270
+ }
271
+ return result;
272
+ };
273
+ const first = await attempt();
274
+ if (first !== null) return first;
275
+ if (retryDelayMs > 0) await new Promise((resolve) => setTimeout(resolve, retryDelayMs));
276
+ return attempt();
277
+ }
278
+
279
+ /**
280
+ * 前后基线差集:只保留**本次执行新增**的工作区改动条目。
281
+ * 动机:真机事故——任务在脏仓库里跑完,证据评论把 35 条历史改动全列成"本次产出",不可信。
282
+ *
283
+ * 2026-10-22 真机 `-122` 补口:**行级**差集在脏仓库下有系统性漏报 —— 开跑前已脏的文件
284
+ * (本仓库开跑前 181 项)被再改一次,`status` 行串不变 ⇒ 差集把真实产出吃掉。这里补一层
285
+ * **内容指纹**比较:基线里也有、但两侧指纹不同 ⇒ 确属本次产出,如实列入。
286
+ * 没有指纹(旧调用方 / 算不出 / 非 git 场景)→ 完全退回原行级口径(零行为变化)。
287
+ */
288
+ export function diffDelta(before, after) {
289
+ if (!after) return null;
290
+ const prev = new Set(before?.files ?? []);
291
+ const prevHashes = before?.hashes ?? null;
292
+ const nextHashes = after.hashes ?? null;
293
+ const baselinePaths = new Set(pathsOfStatusLines(before?.files ?? []));
294
+ // 内容确实变了的文件:只认「基线里也有(含脏条目)+ 两侧指纹都算得出 + 不相等」。
295
+ const changed = new Set(
296
+ pathsOfStatusLines(after.files ?? []).filter((p) => baselinePaths.has(p) && contentChanged(prevHashes, nextHashes, p)),
297
+ );
298
+ const files = (after.files ?? []).filter((f) => {
299
+ if (!prev.has(f)) return true; // 本次新增的脏条目(原有口径)
300
+ return pathsOfStatusLines([f]).some((p) => changed.has(p)); // 本来就脏 + 内容确实变了
301
+ });
302
+ // baselineFiles:`0` 也必须如实展示(= 执行前工作区干净),只有"拿不到基线"才是 null。
303
+ return { files, baselineFiles: before?.files?.length != null ? before.files.length : null, repoStat: after.stat ?? "", mode: "git" };
304
+ }
305
+
306
+ /**
307
+ * 工作区快照(**git 不可用时的兜底**):相对路径 → `size:mtimeMs`。返回 Map;拿不到返回 null。
308
+ *
309
+ * 动机(2026-10-18 真机复现):执行器只在 git 仓库里能算改动清单,**非 git 工作区**(探针项目 `tb-cli-probe`
310
+ * 的 `/private/tmp/…/ws` 就是)会一路退化成 `diff: null`,而证据评论当时仍写死一句
311
+ * 「本次工作区改动:无(执行器未落盘任何文件变更)」——**明明是它自己写出的两个文件**。
312
+ * 这里补一个不依赖 git 的快照对比:能如实说出"新增/被修改了哪些文件",模式记为 `fs`。
313
+ */
314
+ export async function snapshotWorkspace(cwd, { maxFiles = 4000, skipDirs = [".git", "node_modules", ".dsh"] } = {}) {
315
+ if (!cwd) return null;
316
+ const out = new Map();
317
+ try {
318
+ const walk = async (dir) => {
319
+ let entries;
320
+ try { entries = await readdir(dir, { withFileTypes: true }); } catch { return; }
321
+ for (const entry of entries) {
322
+ if (out.size >= maxFiles) return;
323
+ const abs = join(dir, entry.name);
324
+ if (entry.isDirectory()) {
325
+ if (skipDirs.includes(entry.name)) continue;
326
+ await walk(abs);
327
+ continue;
328
+ }
329
+ if (!entry.isFile()) continue;
330
+ try {
331
+ const st = await stat(abs);
332
+ out.set(relative(cwd, abs).split(sep).join("/"), `${st.size}:${Math.floor(st.mtimeMs)}`);
333
+ } catch { /* ignore */ }
334
+ }
335
+ };
336
+ await walk(cwd);
337
+ } catch { return null; }
338
+ return out;
339
+ }
340
+
341
+ /**
342
+ * 快照差集:**新增**或**被修改**(size/mtime 变化)的文件。`before` 为 null 时**必须**由调用方
343
+ * 自行判定为"无法归属",不要拿全量冒充本次产出(同 `diffDelta` 的红线)。
344
+ */
345
+ export function snapshotDelta(before, after) {
346
+ if (!before || !after) return null;
347
+ const files = [];
348
+ for (const [p, sig] of after) if (before.get(p) !== sig) files.push(p);
349
+ return { files, baselineFiles: before.size, repoStat: "", mode: "fs" };
350
+ }
351
+
352
+ /**
353
+ * 从 `git status --porcelain` 行里取文件路径(兼容 `R old -> new`)。
354
+ *
355
+ * **不能用 `slice(3)`**:`collectDiffEvidence` 会对每行 `.trim()`(有意为之,便于行级比较),
356
+ * 于是真机上的 `" M tracked.mjs"` 变成 `"M tracked.mjs"` —— 状态段从 2 字符塌成 1 字符,
357
+ * 固定切 3 位就会把路径首字符吃掉(`tracked.mjs` → `racked.mjs`)。这里改为**按状态段识别**:
358
+ * 前 1–2 个 porcelain 状态字符 + 至少一个空白,才是状态段。
359
+ */
360
+ const PORCELAIN_PREFIX = /^[ MADRCU?!]{1,2}\s+/;
361
+ export function pathOfStatusLine(line) {
362
+ let p = String(line ?? "").replace(PORCELAIN_PREFIX, "").trim();
363
+ if (p.includes(" -> ")) p = p.split(" -> ").pop(); // 重命名:取新路径
364
+ return p.replace(/^"(.*)"$/, "$1").trim();
365
+ }
366
+
367
+ export function pathsOfStatusLines(lines = []) {
368
+ return lines.map(pathOfStatusLine).filter(Boolean);
369
+ }
370
+
371
+ /**
372
+ * 跑一次 CLI 执行器(**不写库**,只产出结果对象;写库交给 executeTaskWithCli)。
373
+ * @returns {{ started, executorId, cli, cwd, exitCode, signal, timedOut, durationMs, stdout, stderr, diff, ok }}
374
+ */
375
+ /**
376
+ * 执行前认领(FR-52 / FR-60 保真):真正跑 CLI 之前把卡片推进「进行中」。
377
+ *
378
+ * **为什么必须做**:`/exec-cli` 的 UI 明确承诺「执行前会先认领该任务(todo → 进行中)」。
379
+ * 但此前只有 `todo` 会经 `startTaskExecution` 真的进「进行中」;其它状态(backlog / in_review /
380
+ * blocked / done …)只开了一条尝试记录、**状态原地不动**——整个执行期看板显示的是错的列。
381
+ * 2026-10-18 真机实测:`taskboard-workbench-73` 在「待办池」列里跑了 14 分钟。
382
+ *
383
+ * **口径**:人在卡片上显式点「交给 CLI 执行器执行」**即为授权**(沿用既有设计,不收紧执行权限);
384
+ * 但状态必须如实——非 `in_progress` 一律先置「进行中」(走执行侧状态入口,带治理审计)。
385
+ * 终态仍由写回决定(成功 → 待验收;失败 → 统一受阻入口)。
386
+ *
387
+ * 任何一步失败都不阻断执行——执行结果仍会如实写回看板。
388
+ */
389
+ export function claimForCliExecution(store, ref, { actor = "cli-executor" } = {}) {
390
+ const outcome = { claimed: false, runStarted: false, fromStatus: null, toStatus: null, note: null };
391
+ try {
392
+ const fresh = store.requireTaskRef(ref);
393
+ outcome.fromStatus = fresh.status;
394
+ if (fresh.status === "todo") {
395
+ store.startTaskExecution(fresh.identifier, { sessionId: null });
396
+ outcome.claimed = true;
397
+ outcome.note = "authorized";
398
+ } else if (fresh.status !== "in_progress") {
399
+ try {
400
+ store.teamSetTaskStatus(fresh.identifier, { status: "in_progress", actor });
401
+ outcome.claimed = true;
402
+ outcome.note = `direct-handoff:${fresh.status}->in_progress`;
403
+ } catch (error) {
404
+ outcome.note = `status-move-failed:${error?.message ?? error}`;
405
+ }
406
+ } else {
407
+ outcome.note = "already-in-progress";
408
+ }
409
+ const cur = store.requireTaskRef(fresh.identifier);
410
+ if (cur.status === "in_progress" && typeof store.getCurrentRun === "function" && !store.getCurrentRun(cur)) {
411
+ store.startTaskRun(cur.identifier, { actor });
412
+ outcome.runStarted = true;
413
+ }
414
+ outcome.toStatus = store.requireTaskRef(fresh.identifier).status;
415
+ } catch (error) {
416
+ outcome.note = `claim-failed:${error?.message ?? error}`;
417
+ }
418
+ return outcome;
419
+ }
420
+
421
+ export async function runCliExecutor({
422
+ task, project, executor, cwd = null, settings = null,
423
+ timeoutMs = DEFAULT_TIMEOUT_MS, spawnImpl = spawn, env = process.env, now = () => Date.now(),
424
+ verifyCommand = null, requirementId = null,
425
+ store = null, heartbeatIntervalMs = HEARTBEAT_INTERVAL_MS,
426
+ } = {}) {
427
+ if (!executor?.cli) return { started: false, reason: "no-cli-executor" };
428
+ const workdir = cwd ?? project?.workspacePath ?? null;
429
+ if (!workdir) return { started: false, reason: "no-workspace", executorId: executor.id };
430
+ // 测试/离线替身:`TB_CLI_EXECUTOR_BIN` 指定可执行文件时优先使用(不改 executor id 语义)。
431
+ const cli = String(env?.TB_CLI_EXECUTOR_BIN ?? "") || executor.cli;
432
+ const prompt = buildTaskPrompt(task, { project, requirementId, verifyCommand });
433
+ const args = cliArgsFor({ executorId: executor.id, cwd: workdir, settings });
434
+ // 参数来源与「能不能写文件」都要如实记进结果(证据与状态都取它,见 isBlindRun)。
435
+ const argsSource = (Array.isArray(settings?.teamTemplate?.engineer?.args) && settings.teamTemplate.engineer.args.length) ? "override" : "default";
436
+ const startedAt = now();
437
+ // 基线快照(脏仓库下用于算"本次真实产出")。
438
+ // 拿不到基线**不得静默继续**:在结果上打 `baseline: "unavailable"`,证据评论里显式告警,
439
+ // 否则差集退化成全量 → 历史脏改动被当成本次产出(真机事故 2026-10-18)。
440
+ let before = null;
441
+ try { before = await collectDiffEvidence(workdir, { spawnImpl }); } catch { before = null; }
442
+ // git 拿不到基线时退到**文件快照**(非 git 工作区也能算出"本次新增/改了哪些文件");
443
+ // 两条都拿不到才是 `unavailable`。`baseline` 如实记下用的是哪种口径:`git` / `fs` / `unavailable`。
444
+ let beforeSnap = null;
445
+ if (!before) { try { beforeSnap = await snapshotWorkspace(workdir); } catch { beforeSnap = null; } }
446
+ const baseline = before ? "git" : beforeSnap ? "fs" : "unavailable";
447
+ const result = { started: true, executorId: executor.id, cli, cwd: workdir, args, argsSource, argsAllowsEdits: argsAllowEdits(args), baseline, exitCode: null, signal: null, timedOut: false, durationMs: 0, stdout: "", stderr: "", diff: null, ok: false };
448
+ // ---- 执行期心跳(2026-10-22 真机 `-122`)----
449
+ // 子进程活着期间必须持续续命认领锁:否则心跳停在开跑那刻,10 分钟后 `claim.stale=true`、
450
+ // 看护按 `session-offline` 判 `stalled/high`,主按钮变「退回待办(重新派发)」——
451
+ // 人一点就与仍在写文件的子进程**并发同文件双写**(违反 FR-86 串行意图)。
452
+ // 收尾必然 `clearInterval`(成功 / 失败 / 超时 / spawn 失败四条路都在 finally 或 finish 里清):
453
+ // 执行结束心跳即停,**不新增常驻心跳**。
454
+ const beatOnce = () => {
455
+ if (!store) return;
456
+ // `heartbeatTask` 续任务级认领心跳(判 `claim.stale` 的依据),且**内部已顺带**续尝试心跳
457
+ // (`heartbeatTaskRun`)—— 所以只在它没生效时才补一次,避免同一拍把 heartbeats 加两次。
458
+ // 需要补的那条路:`/exec-cli` 的 `direct-handoff`(非 todo 状态人工点执行)**不建认领锁**,
459
+ // `heartbeatTask` 会返回 `ok:false`,此时只能靠尝试心跳表明"在途"。
460
+ let ok = false;
461
+ try { ok = store.heartbeatTask(task.identifier, { note: null })?.ok === true; } catch { /* 心跳失败不阻断执行 */ }
462
+ if (!ok) { try { store.heartbeatTaskRun(task.identifier); } catch { /* 心跳失败不阻断执行 */ } }
463
+ };
464
+ const heartbeat = (store && heartbeatIntervalMs > 0) ? setInterval(beatOnce, heartbeatIntervalMs) : null;
465
+ if (heartbeat && typeof heartbeat.unref === "function") heartbeat.unref();
466
+ const stopHeartbeat = () => { if (heartbeat) { clearInterval(heartbeat); } };
467
+ try {
468
+ await new Promise((resolve) => {
469
+ let child;
470
+ try {
471
+ child = spawnImpl(cli, args, { cwd: workdir, env: { ...env, TB_TASK: String(task.identifier) } });
472
+ } catch (error) {
473
+ result.exitCode = -1; result.stderr = `spawn 失败:${error?.message ?? error}`; return resolve();
474
+ }
475
+ let finished = false;
476
+ const finish = () => { if (!finished) { finished = true; resolve(); } };
477
+ const timer = setTimeout(() => { result.timedOut = true; try { child.kill("SIGTERM"); } catch { /* ignore */ } setTimeout(() => { try { child.kill("SIGKILL"); } catch { /* ignore */ } finish(); }, 5000); }, timeoutMs);
478
+ child.on?.("error", (error) => { clearTimeout(timer); result.exitCode = -1; result.stderr = String(error?.message ?? error); finish(); });
479
+ child.stdout?.on("data", (b) => { result.stdout += String(b); });
480
+ child.stderr?.on("data", (b) => { result.stderr += String(b); });
481
+ child.on?.("close", (code, signal) => { clearTimeout(timer); result.exitCode = code; result.signal = signal ?? null; finish(); });
482
+ // 指令走 stdin(避免超长命令行)+ 立即结束 stdin
483
+ try { child.stdin?.write(prompt); child.stdin?.end(); } catch { /* ignore */ }
484
+ });
485
+ } finally {
486
+ stopHeartbeat();
487
+ }
488
+ result.durationMs = Math.max(0, now() - startedAt);
489
+ try {
490
+ const after = await collectDiffEvidence(workdir, { spawnImpl });
491
+ if (before && after) {
492
+ const delta = diffDelta(before, after);
493
+ if (delta && delta.files.length) {
494
+ const restat = await collectDiffEvidence(workdir, { spawnImpl, paths: pathsOfStatusLines(delta.files) });
495
+ result.diff = { ...delta, stat: restat?.stat ?? delta.repoStat ?? "" };
496
+ } else result.diff = delta;
497
+ } else {
498
+ // git 侧缺任一端 → 用快照对比;**没有执行前快照就只能判 null**(不得拿全量冒充本次产出)。
499
+ const afterSnap = await snapshotWorkspace(workdir);
500
+ result.diff = beforeSnap ? snapshotDelta(beforeSnap, afterSnap) : null;
501
+ }
502
+ } catch { result.diff = null; }
503
+ result.ok = result.exitCode === 0 && !result.timedOut;
504
+ return result;
505
+ }
506
+
507
+ /**
508
+ * 证据正文(回写评论用;纯文本,看板直接展示)。
509
+ *
510
+ * **格式口径(卡 `-145` · `docs/规范/01-协作规范.md` §二)**:按「四节」骨架书写 ——
511
+ * **判定 / 偏离说明 / 边界自查 / 产物路径**,让评审人能按字段扫读而不必通读。
512
+ * §二.3:**偏离报告是强制项** —— 机器执行器拿不到「指令假设」,故本节**如实写明不可由执行器判定**
513
+ * 并指回执行器输出,**不得静默省略、也不得臆断**(「不写偏离 = 隐藏信息,比写错更糟」)。
514
+ * 既有措辞(退出码 / 基线剔除 / 无法判定 …)**逐字保留**,只在其外层加四节骨架。
515
+ */
516
+ /**
517
+ * 「跑完了、但**什么都没改**,而且参数**根本不允许写文件**」—— **唯一一处**判定。
518
+ *
519
+ * 为什么收敛成一个函数:这条结论同时决定**证据评论怎么写**与**尝试记录记什么结果**;
520
+ * 两处各判一次必然漂移(一边说「部分」、另一边记 `success`,正是本次要堵的口子)。故证据与状态都取它。
521
+ *
522
+ * 保守边界:`diff == null`(根本算不出改动)**不算** —— 不得拿「判不出来」冒充「没改」;
523
+ * `argsAllowsEdits !== false`(允许写 / 未覆盖走默认)也**不算** —— 那种零改动可能只是任务本身
524
+ * 不需要改代码,属正常,不许硬判失败。
525
+ */
526
+ export function isBlindRun(result) {
527
+ if (!result || result.ok !== true) return false;
528
+ if (result.argsAllowsEdits !== false) return false;
529
+ if (result.diff == null) return false;
530
+ return (result.diff.files ?? []).length === 0;
531
+ }
532
+
533
+ export function evidenceComment(task, result, { actor = "cli-executor" } = {}) {
534
+ const head = result.ok
535
+ ? `🤖 CLI 执行器完成:${result.executorId}(${result.cli})`
536
+ : result.timedOut
537
+ ? `⛔ CLI 执行器超时:${result.executorId}(${result.cli})`
538
+ : `⛔ CLI 执行器失败:${result.executorId}(${result.cli})`;
539
+ const files = result.diff?.files ?? [];
540
+ const baselineFiles = result.diff?.baselineFiles ?? null;
541
+ const mode = result.diff?.mode ?? (result.baseline === "fs" ? "fs" : "git");
542
+ // `diff == null` = **根本算不出改动**(既没基线也没快照)。此时绝不能说「无」——
543
+ // 2026-10-18 真机复现:非 git 工作区里 claude 写出了两个文件,评论却写「本次工作区改动:无」。
544
+ const undetermined = result.diff == null;
545
+ const baselineLost = result.baseline === "unavailable" || (result.diff != null && baselineFiles == null);
546
+ const changed = files.length
547
+ ? [
548
+ `本次工作区改动(${files.length})${mode === "fs"
549
+ ? "|对比方式:文件快照(该目录不是 git 仓库,仅反映新增 / 被修改的文件)"
550
+ : baselineFiles != null ? `|执行前基线已有 ${baselineFiles} 条改动,已剔除` : ""}:`,
551
+ ...files.slice(0, 40).map((l) => ` ${l}`),
552
+ ].join("\n")
553
+ : undetermined
554
+ ? "本次工作区改动:**无法判定**(未取得工作区基线:目录不是 git 仓库且文件快照失败)"
555
+ : mode === "fs"
556
+ ? "本次工作区改动:无(文件快照前后一致:未新增 / 未修改任何文件)"
557
+ : "本次工作区改动:无(执行器未落盘任何文件变更)";
558
+ // §二 判定节取值:完成 / 部分 / 停下 —— 机器侧只能判到「本次执行」这一层。
559
+ const verdict = isBlindRun(result)
560
+ ? "停下(参数未允许写文件:退出码 0 但零工作区改动 —— 见下方告警)"
561
+ : result.ok
562
+ ? (undetermined || baselineLost
563
+ ? "完成(附保留:本次改动归属未完全可判定,见下方产物路径节)"
564
+ : files.length ? "完成" : "部分(退出码 0,但未取得任何工作区改动)")
565
+ : result.timedOut
566
+ ? `停下(执行超时:${result.executorId} 超时被终止)`
567
+ : `停下(执行失败:退出码 ${result.exitCode})`;
568
+ return [
569
+ head,
570
+ ``,
571
+ `**判定**:${verdict}`,
572
+ ``,
573
+ `**偏离说明**:执行器为非交互进程,**无「指令假设 X / 实测 Y」可核**,本节不由机器填写;`,
574
+ `若与任务书不符之处,请人工据下方「执行器输出」与工作区实况补充(缺本节=不合格,见 docs/规范/01-协作规范.md §二.3)。`,
575
+ ``,
576
+ `**边界自查**:执行侧不 commit / 不 push;不改历史决策文档;不删既有数据;不自行置「完成(done)」(${actor})。`,
577
+ ``,
578
+ `**产物路径**:`,
579
+ `任务:${task.identifier} · 目录:${result.cwd}`,
580
+ `退出码:${result.exitCode}${result.signal ? ` · 信号:${result.signal}` : ""}${result.timedOut ? " · 已超时终止" : ""} · 耗时:${Math.round(result.durationMs / 1000)}s`,
581
+ undetermined
582
+ ? "⚠️ 本次未取得工作区基线(目录不是 git 仓库且文件快照失败),**本次是否落盘改动无法判定**,请以文件时间戳与目录清单人工甄别。"
583
+ : baselineLost
584
+ ? "⚠️ 本次无法取得执行前基线,下列改动可能包含执行前已有的改动,请以 diffstat 与文件时间戳人工甄别(不得当成本次产出)。"
585
+ : "",
586
+ result.argsAllowsEdits === false
587
+ ? "⚠️ 本次 CLI 参数(来自设置 `teamTemplate.engineer.args`)**未包含任何「允许写文件」的权限模式**:进程可能以退出码 0 结束却**什么都没改**(真机实测:不带 `--permission-mode acceptEdits` 时写入被拒、零产出)。请核对设置后重新派发。"
588
+ : "",
589
+ changed,
590
+ result.diff?.stat ? `本次 diffstat:\n${result.diff.stat}` : "",
591
+ result.stdout ? `执行器输出(尾段):\n${tail(result.stdout)}` : "",
592
+ result.stderr ? `错误输出(尾段):\n${tail(result.stderr)}` : "",
593
+ ].filter(Boolean).join("\n");
594
+ }
595
+
596
+ /**
597
+ * 一次完整的"CLI 执行 + 回写看板":跑执行器 → 落尝试记录 → 写证据评论 → 回流状态。
598
+ * 成功 → 提交"待验收"(= 请求评审,FR-83);失败/超时 → 走统一受阻入口(FR-80)。
599
+ */
600
+ export async function executeTaskWithCli({
601
+ store, task, project, settings = null, role = "engineer", timeoutMs = DEFAULT_TIMEOUT_MS,
602
+ spawnImpl = spawn, env = process.env, now = () => Date.now(), heartbeatIntervalMs = HEARTBEAT_INTERVAL_MS,
603
+ } = {}) {
604
+ const executor = resolveCliExecutor(settings ?? store.getProjectSettings(task.projectId), { role });
605
+ if (!executor) return { ran: false, reason: "no-cli-executor" };
606
+ const verifyCommand = settings?.teamTemplate?.engineer?.verifyCommand ?? null;
607
+ const result = await runCliExecutor({
608
+ task, project, executor, settings, timeoutMs, spawnImpl, env, now,
609
+ verifyCommand, requirementId: task.requirementId ?? null, store, heartbeatIntervalMs,
610
+ });
611
+ const body = evidenceComment(task, result);
612
+ let review = null; let blocked = null;
613
+ try { store.addComment(task.id, { body }); } catch { /* ignore */ }
614
+ // 2026-10-26:参数不允许写文件 ⇒ 退出码 0 但零产出。这种「跑完了却什么都没干」**不得**记 success、
615
+ // 更不能把卡推进「待验收」—— 否则闭环静默空转(看板显示成功,代码一个字没动)。
616
+ const blind = isBlindRun(result);
617
+ if (result.ok && !blind) {
618
+ try { store.endTaskRun(task.identifier, { outcome: "success", summary: `CLI 执行器成功(${executor.id})`, actor: "cli-executor" }); } catch { /* ignore */ }
619
+ try { review = store.submitTaskForReview(task.identifier, { comment: `CLI 执行器产出,待人工验收(${executor.id})` }); } catch { /* ignore */ }
620
+ } else {
621
+ const reason = blind
622
+ ? "CLI 参数未允许写文件(teamTemplate.engineer.args 覆盖掉了 --permission-mode acceptEdits):退出码 0 但零产出,疑似写入被拒 —— 请核对设置后重新派发"
623
+ : result.timedOut ? `CLI 执行器超时(${Math.round(timeoutMs / 1000)}s)` : `CLI 执行器失败(退出码 ${result.exitCode})`;
624
+ const failureText = tail(result.stderr || result.stdout, 500);
625
+ try { store.endTaskRun(task.identifier, { outcome: (!blind && result.timedOut) ? "timeout" : "failed", summary: reason, error: failureText, actor: "cli-executor" }); } catch { /* ignore */ }
626
+ // 分类修正(2026-10-26 运行期探针):此处原先把 `kind` **硬编码为 `capability`**,于是「超时 / 退出码非 0」
627
+ // 这类**瞬时**失败也被标成「能力类(配额/鉴权)」—— 语义错标会让「受阻」队列把偶发故障当成配额问题。
628
+ // 现按三类判(都与 `routeBlock` 的阻断口径一致,均为 blocked + 复发计数):
629
+ // · 参数未允许写文件 ⇒ `needs_input`(**人得改设置**;原样重试必然再失败,不是偶发)
630
+ // · 错误原文命中配额/鉴权 ⇒ `capability`(与 FR-78「配额不重试」同源)
631
+ // · 其余(超时 / 非 0 退出)⇒ `transient`
632
+ // 同时把 stderr 尾段经 `error` 写进 `last_failure_error`,让「受阻原因」「连续失败熔断」「配额不再自动重试」
633
+ // 三条下游都拿得到数(修复前该字段恒空)。
634
+ const quotaFailure = QUOTA_AUTH_ERROR_RE.test(failureText) || QUOTA_AUTH_ERROR_RE.test(String(result.stdout ?? ""));
635
+ const failureKind = blind ? "needs_input" : (quotaFailure ? "capability" : "transient");
636
+ try {
637
+ blocked = store.recordTaskExecutionFailure(task.identifier, {
638
+ evidence: reason,
639
+ kind: failureKind,
640
+ error: failureText ? `${reason}:${failureText}` : reason,
641
+ });
642
+ } catch { /* ignore */ }
643
+ }
644
+ return { ran: true, executor, result, comment: body, review, blocked };
645
+ }