proofdeck 0.0.0-stage → 0.1.1
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.
- package/LICENSE +201 -0
- package/NOTICE +23 -0
- package/README.md +152 -2
- package/README.zh-CN.md +152 -0
- package/bin/proofdeck.js +191 -0
- package/board/LICENSE +201 -0
- package/board/README.md +473 -0
- package/board/README.zh-CN.md +424 -0
- package/board/dist/_chk.db-shm +0 -0
- package/board/dist/_chk.db-wal +0 -0
- package/board/dist/adapters.d.ts +40 -0
- package/board/dist/adapters.d.ts.map +1 -0
- package/board/dist/adapters.js +124 -0
- package/board/dist/adapters.js.map +1 -0
- package/board/dist/board.d.ts +628 -0
- package/board/dist/board.d.ts.map +1 -0
- package/board/dist/board.js +2767 -0
- package/board/dist/board.js.map +1 -0
- package/board/dist/cli.d.ts +3 -0
- package/board/dist/cli.d.ts.map +1 -0
- package/board/dist/cli.js +1663 -0
- package/board/dist/cli.js.map +1 -0
- package/board/dist/config.d.ts +57 -0
- package/board/dist/config.d.ts.map +1 -0
- package/board/dist/config.js +99 -0
- package/board/dist/config.js.map +1 -0
- package/board/dist/db.d.ts +9 -0
- package/board/dist/db.d.ts.map +1 -0
- package/board/dist/db.js +506 -0
- package/board/dist/db.js.map +1 -0
- package/board/dist/git.d.ts +35 -0
- package/board/dist/git.d.ts.map +1 -0
- package/board/dist/git.js +147 -0
- package/board/dist/git.js.map +1 -0
- package/board/dist/index.d.ts +18 -0
- package/board/dist/index.d.ts.map +1 -0
- package/board/dist/index.js +13 -0
- package/board/dist/index.js.map +1 -0
- package/board/dist/mcp-config.d.ts +26 -0
- package/board/dist/mcp-config.d.ts.map +1 -0
- package/board/dist/mcp-config.js +88 -0
- package/board/dist/mcp-config.js.map +1 -0
- package/board/dist/mcp.d.ts +3 -0
- package/board/dist/mcp.d.ts.map +1 -0
- package/board/dist/mcp.js +949 -0
- package/board/dist/mcp.js.map +1 -0
- package/board/dist/quickstart.d.ts +75 -0
- package/board/dist/quickstart.d.ts.map +1 -0
- package/board/dist/quickstart.js +156 -0
- package/board/dist/quickstart.js.map +1 -0
- package/board/dist/serve.d.ts +10 -0
- package/board/dist/serve.d.ts.map +1 -0
- package/board/dist/serve.js +445 -0
- package/board/dist/serve.js.map +1 -0
- package/board/dist/signing.d.ts +18 -0
- package/board/dist/signing.d.ts.map +1 -0
- package/board/dist/signing.js +26 -0
- package/board/dist/signing.js.map +1 -0
- package/board/dist/sync.d.ts +49 -0
- package/board/dist/sync.d.ts.map +1 -0
- package/board/dist/sync.js +158 -0
- package/board/dist/sync.js.map +1 -0
- package/board/dist/types.d.ts +359 -0
- package/board/dist/types.d.ts.map +1 -0
- package/board/dist/types.js +20 -0
- package/board/dist/types.js.map +1 -0
- package/board/docs/adr/0001-shared-worktree-collision.md +102 -0
- package/board/docs/adr/0001-shared-worktree-collision.zh-CN.md +90 -0
- package/board/docs/attribution.md +123 -0
- package/board/docs/attribution.zh-CN.md +104 -0
- package/board/docs/development-workflow.md +81 -0
- package/board/docs/development-workflow.zh-CN.md +75 -0
- package/board/docs/diagrams/banner.png +0 -0
- package/board/docs/diagrams/banner.svg +1 -0
- package/board/docs/diagrams/before-after.png +0 -0
- package/board/docs/diagrams/before-after.svg +1 -0
- package/board/docs/diagrams/governance-chain.png +0 -0
- package/board/docs/diagrams/governance-chain.svg +1 -0
- package/board/docs/diagrams/value-flow.png +0 -0
- package/board/docs/diagrams/value-flow.svg +1 -0
- package/board/docs/entry-point.md +81 -0
- package/board/docs/entry-point.zh-CN.md +65 -0
- package/board/docs/kanban.png +0 -0
- package/board/docs/octoryn-mark.png +0 -0
- package/board/docs/registry-metadata.md +34 -0
- package/board/docs/registry-metadata.zh-CN.md +30 -0
- package/board/package.json +87 -0
- package/config.example.json +72 -0
- package/daemon.js +1148 -0
- package/docs/assets/demo.gif +0 -0
- package/docs/assets/logo-512.png +0 -0
- package/docs/assets/logo.svg +31 -0
- package/docs/assets/social-preview.png +0 -0
- package/docs/demo-run.mjs +61 -0
- package/docs/render-demo.py +94 -0
- package/docs/render-logo.py +101 -0
- package/docs/task-book.md +58 -0
- package/e2e/verify-acceptance.mjs +150 -0
- package/e2e/verify-antifraud.mjs +128 -0
- package/e2e/verify-caps.mjs +46 -0
- package/e2e/verify-checkpoint.mjs +208 -0
- package/e2e/verify-firstclass.mjs +110 -0
- package/e2e/verify-judge.mjs +52 -0
- package/e2e/verify-lease.mjs +95 -0
- package/e2e/verify-replay.mjs +92 -0
- package/e2e/verify-resilience.mjs +323 -0
- package/e2e/verify-review.mjs +86 -0
- package/e2e/verify-scheduling.mjs +110 -0
- package/e2e/verify-schema-evolution.mjs +107 -0
- package/e2e/verify-sla-digest.mjs +105 -0
- package/guard.js +97 -0
- package/lib/adapters/codex.js +206 -0
- package/lib/billing-convert.js +57 -0
- package/lib/board.js +46 -0
- package/lib/caps.js +35 -0
- package/lib/checkpoint.js +130 -0
- package/lib/gating.js +218 -0
- package/lib/guard-core.mjs +108 -0
- package/lib/http.js +161 -0
- package/lib/judge.js +89 -0
- package/lib/lease.js +93 -0
- package/lib/notify.js +56 -0
- package/lib/platform.js +120 -0
- package/lib/replay.js +68 -0
- package/lib/review.js +40 -0
- package/lib/runner.js +152 -0
- package/lib/schedule.js +59 -0
- package/lib/sla.js +42 -0
- package/lib/spans.js +36 -0
- package/lib/starve.js +43 -0
- package/lib/store.js +109 -0
- package/lib/supply.js +101 -0
- package/lib/usage.js +103 -0
- package/lib/verify.js +223 -0
- package/lib/watchdog-core.mjs +68 -0
- package/lib/watchdog-worker.mjs +75 -0
- package/package.json +55 -4
- package/scripts/run-daemon.sh +18 -0
- package/scripts/run-e2e.mjs +39 -0
package/lib/judge.js
ADDED
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
// V1.5 judge(验证层,2026-10-07 采纳建议①):机械检查验"形",judge 验"质"。
|
|
2
|
+
// 用指定面(缺省 dsh,成本最低)做一次性无头评审:读任务书 + 产物,按 rubric 产出
|
|
3
|
+
// 严格 JSON {pass, reason}。判定语义(judge 是信号不是闸门,调研报告 §4.3):
|
|
4
|
+
// judge 说 fail → 不自动拒:升级进人工复核队列(V3),复核人才是裁决者
|
|
5
|
+
// judge 说 pass → 维持原路由(auto 全过关单 / cross·human 照旧进队)
|
|
6
|
+
// judge 基础设施不可用(spawn 失败/超时/解析不出 JSON)→ 跳过 judge 记日志,
|
|
7
|
+
// 不阻塞任务流——不能因为质检员请假就停生产线。
|
|
8
|
+
// 复用 runner.runTask(无头 spawn/超时/结果收集全套现成),judge 只是"一次性任务"。
|
|
9
|
+
import { writeFileSync, mkdirSync } from "node:fs";
|
|
10
|
+
import { join } from "node:path";
|
|
11
|
+
import { runTask } from "./runner.js";
|
|
12
|
+
|
|
13
|
+
export const DEFAULT_RUBRIC = [
|
|
14
|
+
"产物是否真实回应了任务书的要求(对照任务书原文逐条看)",
|
|
15
|
+
"内容是否自洽:无占位符(TODO/TBD/XXX/lorem)、无成段重复凑数、无明显截断",
|
|
16
|
+
"产物之间是否互洽(台账数字与实际产物对得上、引用的文件真实存在)",
|
|
17
|
+
].join(";");
|
|
18
|
+
|
|
19
|
+
export function buildJudgePrompt({ key, description, rubric, workdir }) {
|
|
20
|
+
return [
|
|
21
|
+
`你是质检评审(V1.5 judge)。任务 ${key} 的执行者自报完成,机械检查已通过;现在请你读产物,判断质量是否过关。`,
|
|
22
|
+
"",
|
|
23
|
+
"## 任务书原文",
|
|
24
|
+
(description ?? "(未提供)").slice(0, 4000),
|
|
25
|
+
"",
|
|
26
|
+
"## 评审要点(rubric)",
|
|
27
|
+
rubric ?? DEFAULT_RUBRIC,
|
|
28
|
+
"",
|
|
29
|
+
"## 工作目录",
|
|
30
|
+
`${workdir} —— 产物都在这里,用读文件的方式实际查看,不要凭空猜测。`,
|
|
31
|
+
"",
|
|
32
|
+
"## 输出要求(严格遵守)",
|
|
33
|
+
"只输出一个 JSON 对象,不要任何其他文字:",
|
|
34
|
+
'{"pass": true 或 false, "reason": "一句话结论,指出关键证据(引用具体文件与位置)"}',
|
|
35
|
+
"拿不准就 pass:false,把疑点写进 reason——宁可错报给人工复核,不可放行假完成。",
|
|
36
|
+
].join("\n");
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
// 从模型输出提取 {pass, reason};容忍 markdown 围栏与前后杂讯。提取不到 → null
|
|
40
|
+
//(调用方按 judge-unavailable 处理,不当成 fail——解析失败是基础设施问题,不是产物问题)。
|
|
41
|
+
export function parseVerdict(text) {
|
|
42
|
+
if (typeof text !== "string" || !text.trim()) return null;
|
|
43
|
+
const candidates = [];
|
|
44
|
+
const fenced = text.match(/```(?:json)?\s*\n([\s\S]*?)```/);
|
|
45
|
+
if (fenced) candidates.push(fenced[1]);
|
|
46
|
+
const i = text.indexOf("{"), j = text.lastIndexOf("}");
|
|
47
|
+
if (i >= 0 && j > i) candidates.push(text.slice(i, j + 1));
|
|
48
|
+
candidates.push(text);
|
|
49
|
+
for (const c of candidates) {
|
|
50
|
+
try {
|
|
51
|
+
const v = JSON.parse(c);
|
|
52
|
+
if (v && typeof v === "object" && !Array.isArray(v) && typeof v.pass === "boolean") {
|
|
53
|
+
return { pass: v.pass, reason: typeof v.reason === "string" ? v.reason : "" };
|
|
54
|
+
}
|
|
55
|
+
} catch { /* 试下一个候选 */ }
|
|
56
|
+
}
|
|
57
|
+
return null;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* runJudge({judgeAgent, agentCfg, key, description, rubric, workdir, runDirBase, log})
|
|
62
|
+
* -> {verdict: "pass"|"fail"|"unavailable", reason, model?, runDir}
|
|
63
|
+
* agentCfg = 守护 cfg.agents[judgeAgent],叠加 judge 自己的短超时(评审不该跑长任务)。
|
|
64
|
+
*/
|
|
65
|
+
export async function runJudge({ judgeAgent, agentCfg = {}, key, description, rubric, workdir, runDirBase, log = () => { } }) {
|
|
66
|
+
const runDir = join(runDirBase, `judge-${key}-${Date.now()}`);
|
|
67
|
+
mkdirSync(runDir, { recursive: true });
|
|
68
|
+
const promptFile = join(runDir, "prompt.md");
|
|
69
|
+
writeFileSync(promptFile, buildJudgePrompt({ key, description, rubric, workdir }), "utf8");
|
|
70
|
+
const cfg = {
|
|
71
|
+
...agentCfg,
|
|
72
|
+
timeoutMs: agentCfg.timeoutMs ?? 300000,
|
|
73
|
+
stallMs: agentCfg.stallMs ?? 120000,
|
|
74
|
+
stallStartupMs: agentCfg.stallStartupMs ?? 180000,
|
|
75
|
+
};
|
|
76
|
+
let r;
|
|
77
|
+
try {
|
|
78
|
+
r = await runTask({ agentCfg: cfg, adapter: judgeAgent, runDir, promptFile, workdir, fm: null, runId: `judge-${key}`, log });
|
|
79
|
+
} catch (e) {
|
|
80
|
+
return { verdict: "unavailable", reason: `judge spawn 异常:${e.message}`, runDir };
|
|
81
|
+
}
|
|
82
|
+
if (r.spawnError) return { verdict: "unavailable", reason: `judge 面 spawn 失败:${r.spawnError}`, runDir };
|
|
83
|
+
if (r.killed || r.stalled || (r.exitCode ?? 0) !== 0) {
|
|
84
|
+
return { verdict: "unavailable", reason: `judge 运行未正常结束(exit=${r.exitCode}${r.stalled ? ",判停" : ""}${r.killed ? ",超时" : ""})`, runDir };
|
|
85
|
+
}
|
|
86
|
+
const v = parseVerdict(r.resultText);
|
|
87
|
+
if (!v) return { verdict: "unavailable", reason: "judge 输出解析不出 {pass,reason} JSON", runDir, raw: r.resultText?.slice(0, 200) };
|
|
88
|
+
return { verdict: v.pass ? "pass" : "fail", reason: v.reason, model: r.model ?? null, runDir };
|
|
89
|
+
}
|
package/lib/lease.js
ADDED
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
// 认领租约(claim lease)——"状态在库里"形态的 K8s Lease / etcd 式租约。
|
|
2
|
+
// 问题:claim 免费且永久(Board API 没有 TTL),谁忘了收尾谁就把卡占死——
|
|
3
|
+
// 实测 codex 把 uumit-contract-matrix 持有 147h 无任何事件(2026-10-02);
|
|
4
|
+
// 桥自己也有裸窗口:execute() 的 write-back 失败路径 runs 已被 endRun 清掉、
|
|
5
|
+
// 板面 claim 残留(daemon.js 结案 catch),守护重启 reap 结案用 setStatus(blocked)
|
|
6
|
+
// 也不释放 claim。先例调研见 docs/design/2026-10-02-调研-*.md §一。
|
|
7
|
+
//
|
|
8
|
+
// 形态选择:黑板没有 broker、没有"重投"原语,所以抄 K8s/etcd(读侧检测过期),
|
|
9
|
+
// 不抄 SQS(broker 重投)。心跳用两路现成信号,零新增写路径:
|
|
10
|
+
// ① 任务级 task.updatedAt——claim/progress/setStatus 都会戳它;
|
|
11
|
+
// ② 持有者级 activeSessions——heartbeat 各端已在打(桥自己每 60s 一跳)。
|
|
12
|
+
// 最小权力(fencing 思路):Board.release 本就只允许持有者身份调用——
|
|
13
|
+
// 桥只自动释放【自己身份】的过期 claim;他人的过期 claim 只报告、绝不代释放:
|
|
14
|
+
// 桥分不清"对方死了"和"对方在做慢活没写进度",而我们的任务没有 SQS 那样的
|
|
15
|
+
// 幂等前提,接管必须保守。
|
|
16
|
+
// 不自动重投(v1):释放落回 open 后交给既有 assign/re-poke/人工流程。
|
|
17
|
+
// 10-01 一晚 54 连戳的教训:这套系统里"自动化再触发"比"自动化停手"危险。
|
|
18
|
+
import * as board from "./board.js";
|
|
19
|
+
|
|
20
|
+
const HOUR = 3600000;
|
|
21
|
+
const DONE_LIKE = new Set(["done", "closed", "cancelled"]);
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* 一轮租约巡检(读侧检测;apply=false 时纯只读)。
|
|
25
|
+
* @returns {{ownStale:Array, otherStale:Array, aliveOwn:Array, released:Array}}
|
|
26
|
+
* ownStale 自己身份持有、超 TTL、且不在 busyKeys 的 claim(apply 时被释放)
|
|
27
|
+
* otherStale 他人持有、超 TTL 且持有者无 active session 的 claim(只报告)
|
|
28
|
+
* aliveOwn 自己持有且在本守护 runs 里的键(在跑,不动)
|
|
29
|
+
* released apply 后实际释放成功的键
|
|
30
|
+
*/
|
|
31
|
+
export async function leaseSweep({
|
|
32
|
+
boardCfg, identity, ttlMs, sessionMs = 600000,
|
|
33
|
+
busyKeys = new Set(), apply = false, log = () => {}, now = Date.now(),
|
|
34
|
+
}) {
|
|
35
|
+
return board.withBoard(boardCfg, (b) => {
|
|
36
|
+
const activeAgents = new Set(
|
|
37
|
+
b.activeSessions(sessionMs).map((s) => s.agentName).filter(Boolean)
|
|
38
|
+
);
|
|
39
|
+
const ownStale = [], otherStale = [], aliveOwn = [];
|
|
40
|
+
for (const c of b.listTaskCards()) {
|
|
41
|
+
const t = c.task;
|
|
42
|
+
if (!t?.claimedBy || DONE_LIKE.has(t.status)) continue;
|
|
43
|
+
const rawAge = now - Date.parse(t.updatedAt ?? "");
|
|
44
|
+
const rec = { key: t.key, status: t.status, ageMs: Number.isFinite(rawAge) ? rawAge : 0, progress: t.progress };
|
|
45
|
+
if (t.claimedBy === identity) {
|
|
46
|
+
// busy 豁免必须先于 TTL 判定:刚认领的卡 updatedAt 很新,本来也到不了 TTL,
|
|
47
|
+
// 但豁免是"在跑"的语义声明,与年龄无关(也保住 aliveOwn 报告的完整性)。
|
|
48
|
+
if (busyKeys.has(t.key)) { aliveOwn.push(rec); continue; }
|
|
49
|
+
if (!Number.isFinite(rawAge) || rawAge <= ttlMs) continue;
|
|
50
|
+
ownStale.push(rec);
|
|
51
|
+
} else {
|
|
52
|
+
if (!Number.isFinite(rawAge) || rawAge <= ttlMs) continue;
|
|
53
|
+
if (!activeAgents.has(t.claimedBy)) otherStale.push({ ...rec, holder: t.claimedBy });
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
const released = [];
|
|
57
|
+
if (apply) {
|
|
58
|
+
for (const s of ownStale) {
|
|
59
|
+
try {
|
|
60
|
+
b.release(identity, s.key);
|
|
61
|
+
b.note(identity, `[${identity}] 租约到期自动释放:${s.key}(claimedBy=${identity},最后活动 ${(s.ageMs / HOUR).toFixed(1)}h 前,status=${s.status},progress=${s.progress}%)。桥只释放自己持有的 claim;若这张卡该继续做,请重新 claim。产物与 run 目录未被触碰,以磁盘为准。`);
|
|
62
|
+
released.push(s.key);
|
|
63
|
+
log(`lease released ${s.key}(own claim 超期 ${(s.ageMs / HOUR).toFixed(1)}h,status=${s.status})`);
|
|
64
|
+
} catch (e) {
|
|
65
|
+
log(`lease release failed ${s.key}: ${e.message}`);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
ownStale.sort((a, x) => x.ageMs - a.ageMs);
|
|
70
|
+
otherStale.sort((a, x) => x.ageMs - a.ageMs);
|
|
71
|
+
return { ownStale, otherStale, aliveOwn, released };
|
|
72
|
+
});
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
const age = (ms) => (ms >= HOUR ? `${(ms / HOUR).toFixed(1)}h` : `${Math.round(ms / 60000)}min`);
|
|
76
|
+
|
|
77
|
+
/** 人读报告(bridge-ctl leases / 手动巡检共用)。纯只读,不写板。 */
|
|
78
|
+
export async function leaseReport({ boardCfg, identity, ttlMs, sessionMs, busyKeys, log }) {
|
|
79
|
+
const r = await leaseSweep({ boardCfg, identity, ttlMs, sessionMs, busyKeys, apply: false, log });
|
|
80
|
+
const lines = [];
|
|
81
|
+
lines.push(`租约巡检(TTL=${age(ttlMs)},判定=updatedAt 超时${identity === null ? "" : `,释放权仅限 ${identity} 自己的 claim`}):`);
|
|
82
|
+
if (!r.ownStale.length && !r.otherStale.length) {
|
|
83
|
+
lines.push(" 无过期 claim。");
|
|
84
|
+
}
|
|
85
|
+
for (const s of r.ownStale) {
|
|
86
|
+
lines.push(` [own-stale] ${s.key} 持有=${identity} 超 ${age(s.ageMs)} status=${s.status} progress=${s.progress}% → apply 时将释放`);
|
|
87
|
+
}
|
|
88
|
+
for (const s of r.otherStale) {
|
|
89
|
+
lines.push(` [other-stale] ${s.key} 持有=${s.holder} 超 ${age(s.ageMs)} status=${s.status} progress=${s.progress}% → 只报告不代释放(最小权力)`);
|
|
90
|
+
}
|
|
91
|
+
if (r.aliveOwn.length) lines.push(` 在跑(本守护 runs,豁免):${r.aliveOwn.join(", ")}`);
|
|
92
|
+
return { text: lines.join("\n"), ...r };
|
|
93
|
+
}
|
package/lib/notify.js
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
// Doorbell watcher: OS file event on <boardDir>/notify.json (zero polling),
|
|
2
|
+
// with debounce, a mtime fallback and a slow reconcile timer that exists only
|
|
3
|
+
// as a crash backstop — the notification path is the fs.watch event.
|
|
4
|
+
import { watch, existsSync, readFileSync } from "node:fs";
|
|
5
|
+
import { join } from "node:path";
|
|
6
|
+
|
|
7
|
+
export function createNotifier(boardDir, { debounceMs = 50, reconcileMs = 60000 }, onWake) {
|
|
8
|
+
const bellPath = join(boardDir, "notify.json");
|
|
9
|
+
let lastSeqSeen = -1;
|
|
10
|
+
let timer = null;
|
|
11
|
+
let watcher = null;
|
|
12
|
+
let stopped = false;
|
|
13
|
+
|
|
14
|
+
const fire = (why) => {
|
|
15
|
+
if (stopped) return;
|
|
16
|
+
clearTimeout(timer);
|
|
17
|
+
timer = setTimeout(() => {
|
|
18
|
+
if (!stopped) onWake(why);
|
|
19
|
+
}, debounceMs);
|
|
20
|
+
};
|
|
21
|
+
|
|
22
|
+
const start = () => {
|
|
23
|
+
try {
|
|
24
|
+
watcher = watch(boardDir, { recursive: false }, (_evt, filename) => {
|
|
25
|
+
if (filename && filename !== "notify.json") return;
|
|
26
|
+
fire("doorbell");
|
|
27
|
+
});
|
|
28
|
+
watcher.on("error", (e) => {
|
|
29
|
+
console.error("notify: watcher error, relying on reconcile:", e.message);
|
|
30
|
+
});
|
|
31
|
+
} catch (e) {
|
|
32
|
+
console.error("notify: fs.watch failed, relying on reconcile:", e.message);
|
|
33
|
+
}
|
|
34
|
+
// catch a bell that rang before we started watching
|
|
35
|
+
if (existsSync(bellPath)) {
|
|
36
|
+
try {
|
|
37
|
+
const hint = JSON.parse(readFileSync(bellPath, "utf8"));
|
|
38
|
+
if (typeof hint.head === "number" && hint.head !== lastSeqSeen) fire("bell-at-boot");
|
|
39
|
+
} catch { fire("bell-at-boot"); }
|
|
40
|
+
}
|
|
41
|
+
};
|
|
42
|
+
|
|
43
|
+
// periodic reconcile — backstop for missed OS events / daemon restart, NOT the notify path
|
|
44
|
+
const interval = setInterval(() => fire("reconcile"), reconcileMs);
|
|
45
|
+
start();
|
|
46
|
+
|
|
47
|
+
return {
|
|
48
|
+
stop() {
|
|
49
|
+
stopped = true;
|
|
50
|
+
clearInterval(interval);
|
|
51
|
+
clearTimeout(timer);
|
|
52
|
+
if (watcher) try { watcher.close(); } catch { /* noop */ }
|
|
53
|
+
},
|
|
54
|
+
noteSeq(seq) { lastSeqSeen = seq; },
|
|
55
|
+
};
|
|
56
|
+
}
|
package/lib/platform.js
ADDED
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
// Process-management primitives, per-OS. Part of the platform split that keeps
|
|
2
|
+
// daemon/runner/guard/watchdog OS-agnostic.
|
|
3
|
+
//
|
|
4
|
+
// Honest status (2026-10): the Windows paths are production-proven (months of
|
|
5
|
+
// fleet duty, incident-hardened — see comments). The POSIX paths are written to
|
|
6
|
+
// spec and exercised by CI only; real-world macOS/Linux mileage is thin, so the
|
|
7
|
+
// POSIX story is marked beta in the README until it has real users.
|
|
8
|
+
import { spawn } from "node:child_process";
|
|
9
|
+
import { platform } from "node:os";
|
|
10
|
+
|
|
11
|
+
export const IS_WINDOWS = platform() === "win32";
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* Forceful process-tree kill.
|
|
15
|
+
* - win32: `taskkill /PID <pid> /T /F` — tree kill by pid, ignores our process-group state.
|
|
16
|
+
* - posix: SIGKILL the process group (`kill(-pid)`); only works when the child is a group
|
|
17
|
+
* leader (spawned with detached:true). Falls back to single-process SIGKILL otherwise —
|
|
18
|
+
* descendants may survive; faces that fork grandchildren should spawn detached.
|
|
19
|
+
* Fire-and-forget: returns without waiting for exit (callers already treat rc=0 as
|
|
20
|
+
* "killed, likely before it could flush" — see daemon stalled-kill semantics).
|
|
21
|
+
*/
|
|
22
|
+
export function killTree(pid, { log = () => { } } = {}) {
|
|
23
|
+
if (IS_WINDOWS) {
|
|
24
|
+
try {
|
|
25
|
+
spawn("taskkill", ["/PID", String(pid), "/T", "/F"], { windowsHide: true });
|
|
26
|
+
return true;
|
|
27
|
+
} catch (e) {
|
|
28
|
+
log(`killTree(${pid}): taskkill spawn failed: ${e.message}`);
|
|
29
|
+
return false;
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
try {
|
|
33
|
+
process.kill(-pid, "SIGKILL");
|
|
34
|
+
return true;
|
|
35
|
+
} catch (e) {
|
|
36
|
+
if (e.code === "ESRCH") return false;
|
|
37
|
+
try {
|
|
38
|
+
process.kill(pid, "SIGKILL");
|
|
39
|
+
return true;
|
|
40
|
+
} catch (e2) {
|
|
41
|
+
log(`killTree(${pid}): ${e2.message}`);
|
|
42
|
+
return false;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* Identify a pid before acting on it (pids get recycled after reboot/restart).
|
|
49
|
+
* Returns { parentPid: number|null, commandLine: string|null }; null fields mean
|
|
50
|
+
* "could not observe" and callers must treat that as NOT confirmed.
|
|
51
|
+
*
|
|
52
|
+
* win32: PowerShell CIM query with explicit pipe draining + a timer race. The
|
|
53
|
+
* drain matters: execFileSync-style timeouts kill powershell.exe but a surviving
|
|
54
|
+
* conhost keeps the stdout pipe open and the caller waits forever (incidents
|
|
55
|
+
* 4020 — wedged 50 minutes — and 36700, same shape). Timeout ⇒ resolve(null).
|
|
56
|
+
* posix: `ps -o ppid= -o command= -p <pid>` (one roundtrip, no cold start).
|
|
57
|
+
*/
|
|
58
|
+
export function getProcessInfo(pid, timeoutMs = 5000) {
|
|
59
|
+
if (IS_WINDOWS) {
|
|
60
|
+
return new Promise((resolve) => {
|
|
61
|
+
let out = "";
|
|
62
|
+
let settled = false;
|
|
63
|
+
let t = null;
|
|
64
|
+
let p = null;
|
|
65
|
+
const settle = (v) => {
|
|
66
|
+
if (settled) return;
|
|
67
|
+
settled = true;
|
|
68
|
+
if (t) clearTimeout(t);
|
|
69
|
+
try { p?.kill(); } catch { /* already gone */ }
|
|
70
|
+
resolve(v);
|
|
71
|
+
};
|
|
72
|
+
try {
|
|
73
|
+
// 两行输出(ppid 行 + commandline 行)——表达式里不嵌双引号,避开 node spawn
|
|
74
|
+
// 在 Windows 的参数转义把 PS 插值字符串搅碎的问题(2026-11-17 实锤)。
|
|
75
|
+
p = spawn("powershell.exe", ["-NoProfile", "-Command",
|
|
76
|
+
`$p = Get-CimInstance Win32_Process -Filter 'ProcessId=${pid}'; Write-Output ($p.ParentProcessId); Write-Output ($p.CommandLine)`],
|
|
77
|
+
{ stdio: ["ignore", "pipe", "pipe"], windowsHide: true });
|
|
78
|
+
} catch { resolve({ parentPid: null, commandLine: null }); return; }
|
|
79
|
+
t = setTimeout(() => settle({ parentPid: null, commandLine: null }), timeoutMs);
|
|
80
|
+
p.stdout.on("data", (c) => { out += c; });
|
|
81
|
+
p.on("error", () => settle({ parentPid: null, commandLine: null }));
|
|
82
|
+
p.on("close", (code) => {
|
|
83
|
+
if (code !== 0) return settle({ parentPid: null, commandLine: null });
|
|
84
|
+
const nl = out.indexOf("\n");
|
|
85
|
+
if (nl === -1) return settle({ parentPid: null, commandLine: null });
|
|
86
|
+
const ppid = Number(out.slice(0, nl).trim());
|
|
87
|
+
const commandLine = out.slice(nl + 1).replace(/\r?\n$/, "");
|
|
88
|
+
resolve({ parentPid: Number.isInteger(ppid) && ppid > 0 ? ppid : null, commandLine: commandLine || null });
|
|
89
|
+
});
|
|
90
|
+
});
|
|
91
|
+
}
|
|
92
|
+
return new Promise((resolve) => {
|
|
93
|
+
let out = "";
|
|
94
|
+
let settled = false;
|
|
95
|
+
let t = null;
|
|
96
|
+
let p = null;
|
|
97
|
+
const settle = (v) => {
|
|
98
|
+
if (settled) return;
|
|
99
|
+
settled = true;
|
|
100
|
+
if (t) clearTimeout(t);
|
|
101
|
+
try { p?.kill(); } catch { /* already gone */ }
|
|
102
|
+
resolve(v);
|
|
103
|
+
};
|
|
104
|
+
try {
|
|
105
|
+
p = spawn("ps", ["-o", "ppid=", "-o", "command=", "-p", String(pid)],
|
|
106
|
+
{ stdio: ["ignore", "pipe", "pipe"] });
|
|
107
|
+
} catch { resolve({ parentPid: null, commandLine: null }); return; }
|
|
108
|
+
t = setTimeout(() => settle({ parentPid: null, commandLine: null }), timeoutMs);
|
|
109
|
+
p.stdout.on("data", (c) => { out += c; });
|
|
110
|
+
p.on("error", () => settle({ parentPid: null, commandLine: null }));
|
|
111
|
+
p.on("close", (code) => {
|
|
112
|
+
if (code !== 0) return settle({ parentPid: null, commandLine: null }); // no such process
|
|
113
|
+
const line = out.split("\n").find((l) => l.trim().length > 0) ?? "";
|
|
114
|
+
const m = /^(\d+)\s+(.*)$/.exec(line.trim());
|
|
115
|
+
if (!m) return resolve({ parentPid: null, commandLine: null });
|
|
116
|
+
const ppid = Number(m[1]);
|
|
117
|
+
resolve({ parentPid: Number.isInteger(ppid) && ppid > 0 ? ppid : null, commandLine: m[2] });
|
|
118
|
+
});
|
|
119
|
+
});
|
|
120
|
+
}
|
package/lib/replay.js
ADDED
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
// replay(2026-10-07 采纳建议④):把 append-only 哈希链当事件源,折叠出"任意 seq
|
|
2
|
+
// 时刻的任务卡状态"。只读、本地、不依赖守护活着——排查纠纷/还原现场从翻日志变一条命令。
|
|
3
|
+
// 这是 durable execution lite 的第一步(只读时间旅行);重入式恢复另行设计评审。
|
|
4
|
+
//
|
|
5
|
+
// 折叠规则(与 Board 的写路径一一对应):
|
|
6
|
+
// kind=task → 任务出现(open;payload 只带 key,不带 number)
|
|
7
|
+
// kind=claim → claimedBy=actor(不改 status——claim 只登记持有)
|
|
8
|
+
// kind=progress → progress=payload.progress(≥100 同步 done,与 setProgress 语义一致)
|
|
9
|
+
// kind=complete → status=done
|
|
10
|
+
// kind=task-status → status=payload.status(open 时释放持有者,对应 requeue/重开)
|
|
11
|
+
// 其余 kind(note/message/verify/...)不影响任务状态,但保留计数。
|
|
12
|
+
|
|
13
|
+
const STATUS_KINDS = new Set(["task", "claim", "progress", "complete", "task-status"]);
|
|
14
|
+
|
|
15
|
+
function payloadOf(e) {
|
|
16
|
+
if (e.payload == null) return {};
|
|
17
|
+
if (typeof e.payload === "object") return e.payload;
|
|
18
|
+
try { return JSON.parse(e.payload); } catch { return {}; }
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* foldTasks(events, uptoSeq) -> Map<key, {status, claimedBy, progress, number, lastSeq, lastAt, events}>
|
|
23
|
+
* events 须按 seq 升序(b.since(0) 即是)。uptoSeq 缺省 = 全部。
|
|
24
|
+
*/
|
|
25
|
+
export function foldTasks(events, uptoSeq = Infinity) {
|
|
26
|
+
const tasks = new Map();
|
|
27
|
+
for (const e of events) {
|
|
28
|
+
if (e.seq > uptoSeq) break;
|
|
29
|
+
if (!STATUS_KINDS.has(e.kind)) continue;
|
|
30
|
+
const p = payloadOf(e);
|
|
31
|
+
const key = p.key ?? e.refId;
|
|
32
|
+
if (!key) continue;
|
|
33
|
+
const t = tasks.get(key) ?? { status: "open", claimedBy: null, progress: 0, lastSeq: 0, lastAt: null, events: 0 };
|
|
34
|
+
t.events++;
|
|
35
|
+
t.lastSeq = e.seq;
|
|
36
|
+
t.lastAt = e.at ?? null;
|
|
37
|
+
if (e.kind === "claim") {
|
|
38
|
+
t.claimedBy = e.actor; // 只登记持有,不动状态
|
|
39
|
+
} else if (e.kind === "progress") {
|
|
40
|
+
if (Number.isFinite(p.progress)) {
|
|
41
|
+
t.progress = p.progress;
|
|
42
|
+
if (p.progress >= 100) t.status = "done";
|
|
43
|
+
else if (t.status === "open") t.status = "in-progress";
|
|
44
|
+
}
|
|
45
|
+
} else if (e.kind === "complete") {
|
|
46
|
+
t.status = "done";
|
|
47
|
+
t.progress = Math.max(t.progress, 100);
|
|
48
|
+
} else if (e.kind === "task-status") {
|
|
49
|
+
if (typeof p.status === "string") {
|
|
50
|
+
t.status = p.status;
|
|
51
|
+
if (p.status === "open") { t.claimedBy = null; t.progress = 0; } // 重派/人工重开 → 释放持有
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
tasks.set(key, t);
|
|
55
|
+
}
|
|
56
|
+
return tasks;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/** 与"现在"对比:返回 [{key, atSeq, now}] —— 状态在 uptoSeq 之后变过的任务。 */
|
|
60
|
+
export function diffToNow(folded, currentTasks) {
|
|
61
|
+
const diffs = [];
|
|
62
|
+
for (const [key, t] of folded) {
|
|
63
|
+
const cur = currentTasks.get(key);
|
|
64
|
+
const nowStatus = cur?.status ?? "(已删除)";
|
|
65
|
+
if (nowStatus !== t.status) diffs.push({ key, atSeq: t.status, now: nowStatus });
|
|
66
|
+
}
|
|
67
|
+
return diffs;
|
|
68
|
+
}
|
package/lib/review.js
ADDED
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
// 复核队列(验证层 V2 交叉 / V3 人工,2026-10-02 设计稿 Part B.2 的落地)。
|
|
2
|
+
// mode=cross / mode=human 的任务执行完成后**不自动关单**:进队列、落 REVIEW note、
|
|
3
|
+
// 私信复核人;复核人用 bridge-ctl review-accept / review-reject 裁决。
|
|
4
|
+
// cross 的机械项(若有 checks)仍在关单前先跑(失败走 work 类失败路径),本模块只管
|
|
5
|
+
// "机械项已过或未声明后,等独立复核"这一段。
|
|
6
|
+
export function queueReview({ b, io, store, ID, key, agent, mode, reviewer, runDir, v1Note = "" }) {
|
|
7
|
+
const level = mode === "human" ? "V3" : "V2";
|
|
8
|
+
(store.s.review ??= {})[key] = { at: Date.now(), agent, mode, reviewer, runDir };
|
|
9
|
+
io.note(b, ID, `[[verify]] key=${key} verdict=REVIEW level=${level} reviewer=${reviewer} by=${ID}`);
|
|
10
|
+
io.note(b, ID, `[${ID}→${agent}] ${key} 执行完成,提请${mode === "human" ? "人工" : "交叉"}复核(未关单)${v1Note}。复核: node bridge-ctl.js review-accept ${key} / review-reject ${key}「理由」。工件: ${runDir}`);
|
|
11
|
+
io.message(b, ID, reviewer, `[${ID}] 任务 ${key} 提请复核(${level})${v1Note}:任务书+工件见 ${runDir}。通过: review-accept ${key};驳回: review-reject ${key}「理由」。`);
|
|
12
|
+
return { level, reviewer };
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
export function applyReviewAccept({ b, io, store, ID, key }) {
|
|
16
|
+
const r = store.s.review?.[key];
|
|
17
|
+
if (!r) return { ok: false, why: "该卡不在复核队列" };
|
|
18
|
+
io.done(b, ID, key);
|
|
19
|
+
const level = r.mode === "human" ? "V3" : "V2";
|
|
20
|
+
io.verify?.(b, ID, key, "pass", { level, summary: `verify PASS ${key} (${level}, reviewer=${r.reviewer})` });
|
|
21
|
+
io.note(b, ID, `[[verify]] key=${key} verdict=PASS level=${level} by=${ID}(复核人=${r.reviewer})`);
|
|
22
|
+
if (r.agent) io.message(b, ID, r.agent, `[${ID}] 任务 ${key} 复核通过,已关单。`);
|
|
23
|
+
delete store.s.review[key];
|
|
24
|
+
delete store.s.retries?.[key]; // 防御:复核关单后残留的重试台账会在 dueAt 把 done 卡再派一次
|
|
25
|
+
store.save();
|
|
26
|
+
return { ok: true, mode: r.mode, reviewer: r.reviewer };
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
export function applyReviewReject({ b, io, store, ID, key, reason }) {
|
|
30
|
+
const r = store.s.review?.[key];
|
|
31
|
+
if (!r) return { ok: false, why: "该卡不在复核队列" };
|
|
32
|
+
const level = r.mode === "human" ? "V3" : "V2";
|
|
33
|
+
io.setStatus(b, ID, key, "open");
|
|
34
|
+
io.verify?.(b, ID, key, "fail", { level, summary: `verify FAIL ${key} (${level}, reviewer=${r.reviewer}) — ${reason ?? "未给理由"}` });
|
|
35
|
+
io.note(b, ID, `[[verify]] key=${key} verdict=FAIL level=${level} by=${ID}(复核人=${r.reviewer}) — 复核驳回:${reason ?? "未给理由"}`);
|
|
36
|
+
if (r.agent) io.message(b, ID, r.agent, `[${ID}] 任务 ${key} 复核被驳回(${reason ?? "未给理由"})。已回 open;修正后重派: node bridge-ctl.js requeue ${key} ${r.agent}。`);
|
|
37
|
+
delete store.s.review[key];
|
|
38
|
+
store.save();
|
|
39
|
+
return { ok: true, mode: r.mode };
|
|
40
|
+
}
|
package/lib/runner.js
ADDED
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
// runner: spawn an agent headless, stream logs, enforce timeout, classify exit.
|
|
2
|
+
import { spawn } from "node:child_process";
|
|
3
|
+
import { createWriteStream, writeFileSync, readFileSync } from "node:fs";
|
|
4
|
+
import { join } from "node:path";
|
|
5
|
+
import { killTree } from "./platform.js";
|
|
6
|
+
import * as codex from "./adapters/codex.js";
|
|
7
|
+
|
|
8
|
+
// Adapter registry: an adapter is a small module with
|
|
9
|
+
// buildRun({agentCfg, runDir, promptFile, workdir}) -> spawn spec
|
|
10
|
+
// parseEvent(line) -> {milestone, step, raw} | null
|
|
11
|
+
// readMeta(run)? / readResult(run)? / readUsage({runDir})?
|
|
12
|
+
// resumeSpec(o)? (optional — session-level resume)
|
|
13
|
+
// The reference implementation ships in-box (codex = generic CLI adapter).
|
|
14
|
+
// Additional faces register their own module at bootstrap:
|
|
15
|
+
// registerAdapter("myface", await import("./adapters/myface.js"))
|
|
16
|
+
const ADAPTERS = { codex };
|
|
17
|
+
|
|
18
|
+
export function registerAdapter(name, mod) {
|
|
19
|
+
ADAPTERS[name] = mod;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export function getAdapter(name) {
|
|
23
|
+
const a = ADAPTERS[name];
|
|
24
|
+
if (!a) throw new Error(`adapter '${name}' not registered — call registerAdapter('${name}', mod) at bootstrap, or ship lib/adapters/${name}.js`);
|
|
25
|
+
return a;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* runTask({agentCfg, adapter, runDir, promptFile, workdir, fm, runId, log, onMilestone, resume})
|
|
30
|
+
* -> Promise<{exitCode, killed, stalled, items, resultText, threadId, spawnError?}>
|
|
31
|
+
* `stalled` = 无进展判停掐的;`items` = 累计 milestone 数(0 表示一步没走)。
|
|
32
|
+
* `resume` = {threadId, segment} 时,优先让适配器的 resumeSpec 接管建令;
|
|
33
|
+
* 该面没有会话级续跑(或拿不到 threadId)就退回 buildRun —— 检查点题面照样带过去。
|
|
34
|
+
*/
|
|
35
|
+
export function runTask(o) {
|
|
36
|
+
const adapter = getAdapter(o.adapter);
|
|
37
|
+
const spec = (o.resume && adapter.resumeSpec ? adapter.resumeSpec(o) : null) ?? adapter.buildRun(o);
|
|
38
|
+
spec.segment = o.resume?.segment ?? 1;
|
|
39
|
+
const jsonlPath = join(o.runDir, `${o.adapter}.jsonl`);
|
|
40
|
+
const errPath = join(o.runDir, "stderr.txt");
|
|
41
|
+
o.log(`spawn: ${spec.exe} ${spec.args.map(a => (a.length > 60 ? a.slice(0, 57) + "..." : a)).join(" ")}`);
|
|
42
|
+
|
|
43
|
+
return new Promise((resolve) => {
|
|
44
|
+
const child = spawn(spec.exe, spec.args, {
|
|
45
|
+
cwd: spec.cwd,
|
|
46
|
+
env: { ...process.env, ...spec.env, BRIDGE_RUN: o.runId },
|
|
47
|
+
windowsHide: true,
|
|
48
|
+
stdio: ["pipe", "pipe", "pipe"],
|
|
49
|
+
});
|
|
50
|
+
const state = { killed: false, stalled: false, threadId: null, lastMsgCount: 0, model: null, provider: null };
|
|
51
|
+
o.onSpawn?.(child.pid);
|
|
52
|
+
// 无进展判停(#25):计时只被 milestone 重置,不被 stdout 字节重置。
|
|
53
|
+
// 理由是实测决定的:四面都在「每完成一个 step / 每起一个工具」时吐 milestone
|
|
54
|
+
// (codex=item.completed,pi=tool_execution_start,trae=Step N: Completed,
|
|
55
|
+
// dsh=ITEM n),所以「有字节但无 milestone」= 模型在原地说话不干活;
|
|
56
|
+
// 反过来按字节重置会让最话痨的失败跑法永远判不停。
|
|
57
|
+
// 首个 milestone 前用更宽的 startupMs:长任务书 + 冷启动的首轮思考本来就慢。
|
|
58
|
+
const stallMs = o.agentCfg.stallMs ?? o.stall?.ms ?? 600000;
|
|
59
|
+
const startupStallMs = o.agentCfg.stallStartupMs ?? o.stall?.startupMs ?? 900000;
|
|
60
|
+
let sawFirstMilestone = false;
|
|
61
|
+
let stallTimer = null;
|
|
62
|
+
const armStall = () => {
|
|
63
|
+
clearTimeout(stallTimer);
|
|
64
|
+
stallTimer = setTimeout(() => {
|
|
65
|
+
state.stalled = true;
|
|
66
|
+
o.log(`no progress for ${sawFirstMilestone ? stallMs : startupStallMs}ms(milestone 未增长)— killing pid ${child.pid} tree`);
|
|
67
|
+
killTree(child.pid, { log: o.log });
|
|
68
|
+
}, sawFirstMilestone ? stallMs : startupStallMs);
|
|
69
|
+
};
|
|
70
|
+
armStall();
|
|
71
|
+
const out = createWriteStream(jsonlPath, { flags: "a" });
|
|
72
|
+
const err = createWriteStream(errPath, { flags: "a" });
|
|
73
|
+
let lineBuf = "";
|
|
74
|
+
child.stdout.on("data", (c) => {
|
|
75
|
+
out.write(c);
|
|
76
|
+
lineBuf += c.toString("utf8");
|
|
77
|
+
let i;
|
|
78
|
+
while ((i = lineBuf.indexOf("\n")) >= 0) {
|
|
79
|
+
const line = lineBuf.slice(0, i).trim();
|
|
80
|
+
lineBuf = lineBuf.slice(i + 1);
|
|
81
|
+
if (!line) continue;
|
|
82
|
+
try {
|
|
83
|
+
const ev = adapter.parseEvent(line);
|
|
84
|
+
if (ev?.threadId && !state.threadId) state.threadId = ev.threadId;
|
|
85
|
+
if (ev?.model && !state.model) state.model = ev.model;
|
|
86
|
+
if (ev?.provider && !state.provider) state.provider = ev.provider;
|
|
87
|
+
if (ev?.milestone) {
|
|
88
|
+
state.lastMsgCount += ev.milestone === "item" ? 1 : 0;
|
|
89
|
+
sawFirstMilestone = true;
|
|
90
|
+
armStall();
|
|
91
|
+
o.onMilestone?.(ev.milestone, state);
|
|
92
|
+
}
|
|
93
|
+
} catch (e) { o.log(`parseEvent error: ${e.message}`); }
|
|
94
|
+
}
|
|
95
|
+
});
|
|
96
|
+
child.stderr.on("data", (c) => err.write(c));
|
|
97
|
+
if (spec.stdin !== false) { // adapters that take the task by file must not get a stdin write
|
|
98
|
+
child.stdin.write(readFileSync(o.promptFile, "utf8"));
|
|
99
|
+
}
|
|
100
|
+
child.stdin.end();
|
|
101
|
+
|
|
102
|
+
const killer = setTimeout(() => {
|
|
103
|
+
state.killed = true;
|
|
104
|
+
o.log(`timeout after ${o.agentCfg.timeoutMs}ms — killing pid ${child.pid} tree`);
|
|
105
|
+
killTree(child.pid, { log: o.log });
|
|
106
|
+
}, o.agentCfg.timeoutMs ?? 3600000);
|
|
107
|
+
|
|
108
|
+
child.on("error", (e) => {
|
|
109
|
+
clearTimeout(killer);
|
|
110
|
+
clearTimeout(stallTimer);
|
|
111
|
+
o.log(`spawn error: ${e.message}`);
|
|
112
|
+
writeFileSync(join(o.runDir, "exit-code"), `-1 spawn-error ${e.message}`);
|
|
113
|
+
resolve({ exitCode: -1, killed: false, stalled: false, resultText: null, threadId: null, spawnError: e.message });
|
|
114
|
+
});
|
|
115
|
+
child.on("close", (code) => {
|
|
116
|
+
clearTimeout(killer);
|
|
117
|
+
clearTimeout(stallTimer);
|
|
118
|
+
out.end(); err.end();
|
|
119
|
+
// 服务端实际用的模型名只在 run 结束后的产物里(trae 轨迹的 response.model),
|
|
120
|
+
// 可能与请求名不同 ⇒ readMeta 的权威戳优先于 stdout 流里首见的那个。
|
|
121
|
+
const stamp = (adapter.readMeta ? adapter.readMeta({ lastMsgFile: spec.lastMsgFile }) : null) ?? {};
|
|
122
|
+
const model = stamp.model ?? state.model;
|
|
123
|
+
const provider = stamp.provider ?? state.provider;
|
|
124
|
+
// 遥测落盘绝不能反过来砸进程:spawn 失败等场景 runDir 可能已被清理。
|
|
125
|
+
try {
|
|
126
|
+
writeFileSync(join(o.runDir, "exit-code"), String(code));
|
|
127
|
+
writeFileSync(join(o.runDir, "meta.json"), JSON.stringify({
|
|
128
|
+
runId: o.runId, agent: o.adapter, pid: child.pid, exitCode: code,
|
|
129
|
+
killed: state.killed, stalled: state.stalled,
|
|
130
|
+
segment: spec.segment, resumed: !!spec.resumed,
|
|
131
|
+
threadId: state.threadId, items: state.lastMsgCount,
|
|
132
|
+
model, provider, agentSuccess: stamp.success ?? null,
|
|
133
|
+
starve: stamp.starve ?? null, starvedTotal: stamp.starvedTotal ?? null,
|
|
134
|
+
}, null, 1));
|
|
135
|
+
} catch { /* runDir 已被清理等场景——遥测丢了就丢了,resolve 照常 */ }
|
|
136
|
+
resolve({
|
|
137
|
+
exitCode: code ?? -1,
|
|
138
|
+
killed: state.killed,
|
|
139
|
+
stalled: state.stalled,
|
|
140
|
+
items: state.lastMsgCount,
|
|
141
|
+
threadId: state.threadId,
|
|
142
|
+
model,
|
|
143
|
+
provider,
|
|
144
|
+
agentSuccess: stamp.success ?? null,
|
|
145
|
+
// 该面自报 success=true 也可能一个字没写出(输出预算在落笔前被切)⇒ 饿死读数单独透传
|
|
146
|
+
starve: stamp.starve ?? null,
|
|
147
|
+
starvedTotal: stamp.starvedTotal ?? null,
|
|
148
|
+
resultText: adapter.readResult ? adapter.readResult({ lastMsgFile: spec.lastMsgFile }) : null,
|
|
149
|
+
});
|
|
150
|
+
});
|
|
151
|
+
});
|
|
152
|
+
}
|