taskboard-workbench 0.0.0-stage → 0.2.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.
- package/CHANGELOG.md +132 -0
- package/LICENSE +21 -0
- package/README.md +121 -2
- package/cli/tb.mjs +314 -0
- package/cordis.patch.yml +5 -0
- package/index.js +633 -0
- package/lib/client.js +522 -0
- package/package.json +83 -4
- package/spec//345/233/242/351/230/237agent.md +171 -0
- package/src/core/advance.mjs +192 -0
- package/src/core/agent-teams.mjs +48 -0
- package/src/core/binding.mjs +44 -0
- package/src/core/config.mjs +22 -0
- package/src/core/debug-dispatch.mjs +94 -0
- package/src/core/delivery.mjs +93 -0
- package/src/core/deps.mjs +53 -0
- package/src/core/diagnostics.mjs +648 -0
- package/src/core/domain.mjs +235 -0
- package/src/core/empty-state.mjs +240 -0
- package/src/core/errors.mjs +139 -0
- package/src/core/executor.mjs +645 -0
- package/src/core/human-review.mjs +773 -0
- package/src/core/intake.mjs +116 -0
- package/src/core/kickoff.mjs +147 -0
- package/src/core/loop.mjs +498 -0
- package/src/core/memory.mjs +193 -0
- package/src/core/next-step.mjs +377 -0
- package/src/core/notify.mjs +183 -0
- package/src/core/owner.mjs +41 -0
- package/src/core/requirements.mjs +262 -0
- package/src/core/review.mjs +82 -0
- package/src/core/session-naming.mjs +64 -0
- package/src/core/split-ask.mjs +107 -0
- package/src/core/store.mjs +3103 -0
- package/src/core/team.mjs +170 -0
- package/src/core/verify.mjs +170 -0
- package/src/core/watchdog.mjs +144 -0
- package/src/host/ai-elaborator.mjs +26 -0
- package/src/host/team-engine.mjs +125 -0
- package/src/host/tool-surface.mjs +205 -0
- package/src/server/api.mjs +1974 -0
- package/src/server/events.mjs +32 -0
- package/src/server/kickoff.mjs +46 -0
- package/src/server/server.mjs +211 -0
- package/src/server/verify.mjs +112 -0
- package/tools/env-check.mjs +35 -0
- package/tools/seed.mjs +67 -0
- package/web/app.js +5237 -0
- package/web/index.html +15 -0
- package/web/tokens.css +1139 -0
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* delivery.mjs —— 「投递到会话」与「会话里真的交了作业」的**分档判定**(FR-79 / FR-82 补口)。
|
|
3
|
+
*
|
|
4
|
+
* 背景(真机 2026-10-22 · 续二十二):看板把派发指令投进项目主会话后,会话里的 agent 确实在干活
|
|
5
|
+
* (会话记录里能看到改 `web/app.js`、调 `taskboard_*` 工具),但**既没有提交「待验收」,也没有留评论**
|
|
6
|
+
* ⇒ 30 分钟后被看护按「认领心跳陈旧」回收,任务静默退回「todo」。看板上只留下一句「认领已回收」,
|
|
7
|
+
* **看不出**「这次是投递给会话的、会话没交作业、工作区可能已经有改动」——工作成果与看板状态脱钩。
|
|
8
|
+
*
|
|
9
|
+
* 本模块**只做判定**(纯函数、零副作用、零 I/O),措辞与落盘由调用方决定:
|
|
10
|
+
* · `store` 在收口(回收 / 超时)时用它决定是否补一条「未收尾」留痕(评论 + 事件);
|
|
11
|
+
* · `diagnostics` 用它产出 `delivery_untaken` 诊断 —— 走 FR-79 的统一出口:**可见 + 给恢复动作**。
|
|
12
|
+
*
|
|
13
|
+
* 判据(四条,缺一不算):
|
|
14
|
+
* ① 任务仍停在**可执行侧**(`todo` / `in_progress`)—— 已提交待验收 / 已完成 / 已取消的任务都有结论;
|
|
15
|
+
* ② 最近一次尝试是**会话投递**(`run.sessionId` 非空)—— CLI 执行器投递以退出码收口,成败都是结论;
|
|
16
|
+
* ③ 该次尝试的收口结局是「**被回收 / 超时**」(有结论的结局是 `success` / `failed` / `cancelled` …);
|
|
17
|
+
* ④ 该次尝试**开始之后没有任何评论**(提交待验收、进展汇报、人工反馈都会留评论)。
|
|
18
|
+
*
|
|
19
|
+
* 判定为“未收尾”不等于“失败了” —— 它表达的是:**投出去的东西没有回报**,需要人看一眼工作区。
|
|
20
|
+
*/
|
|
21
|
+
|
|
22
|
+
/** 「会话投递没回报」的收口结局。`interrupted`(进程重启)不在此列:那是另一类事故,已有自己的留痕。 */
|
|
23
|
+
export const UNTAKEN_RUN_OUTCOMES = Object.freeze(["reclaimed", "timeout"]);
|
|
24
|
+
|
|
25
|
+
/** 只有还站在可执行侧的任务才算“未收尾”(有结论的任务不会命中)。 */
|
|
26
|
+
export const UNTAKEN_STATUSES = Object.freeze(["todo", "in_progress"]);
|
|
27
|
+
|
|
28
|
+
/** 收口留痕用的固定前缀 —— 也用于把「系统留痕」与「人的结论」区分开。 */
|
|
29
|
+
export const UNTAKEN_COMMENT_MARKER = "【投递未收尾】";
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* **系统留痕**(不是结论)。判定「该次尝试有没有交作业」时必须把它们排除,否则:
|
|
33
|
+
* · 投递那一刻写的「派发指令已投递到项目主会话…」会把自己这次尝试判成“已回报”;
|
|
34
|
+
* · 收口时写的「【投递未收尾】…」会让 FR-79 诊断再也命中不了(自己消掉自己的证据)。
|
|
35
|
+
* 三处留痕的措辞都从这里取,避免又出现两份常量。
|
|
36
|
+
*/
|
|
37
|
+
export const SYSTEM_TRACE_MARKERS = Object.freeze([
|
|
38
|
+
UNTAKEN_COMMENT_MARKER,
|
|
39
|
+
"派发指令已投递到项目主会话",
|
|
40
|
+
"已交给 CLI 执行器",
|
|
41
|
+
// 看护回收时写的那句「认领已回收(…)→ 退回「todo」」同样是**系统留痕**:它描述的是"锁被收回",
|
|
42
|
+
// 不是"会话交过作业"。不排除它,回收动作会**自己消掉自己**要暴露的证据(第一次接线上就被这条挡住过)。
|
|
43
|
+
"认领已回收",
|
|
44
|
+
]);
|
|
45
|
+
|
|
46
|
+
/** 这条评论算不算「结论/进展」(系统留痕不算)。 */
|
|
47
|
+
export function isConclusionComment(body) {
|
|
48
|
+
const text = String(body ?? "");
|
|
49
|
+
return !SYSTEM_TRACE_MARKERS.some((marker) => text.includes(marker));
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** 取最近一次尝试(按 attempt 取最大;attempt 相同则靠后写入者胜)。 */
|
|
53
|
+
export function findLatestRun(runs = []) {
|
|
54
|
+
let best = null;
|
|
55
|
+
for (const run of Array.isArray(runs) ? runs : []) {
|
|
56
|
+
if (!run) continue;
|
|
57
|
+
if (!best) { best = run; continue; }
|
|
58
|
+
const a = Number(run.attempt ?? 0);
|
|
59
|
+
const b = Number(best.attempt ?? 0);
|
|
60
|
+
if (a > b) best = run;
|
|
61
|
+
else if (a === b) best = run; // 同 attempt:以列表更靠后的为准(与 listTaskRuns 的 order by attempt,rowid 对齐)
|
|
62
|
+
}
|
|
63
|
+
return best;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/** 结局 → 人话(用于评论/诊断文案)。 */
|
|
67
|
+
export function untakenReasonLabel(outcome) {
|
|
68
|
+
if (outcome === "reclaimed") return "认领被回收(心跳陈旧 / 认领过期)";
|
|
69
|
+
if (outcome === "timeout") return "超过运行时上限被收口";
|
|
70
|
+
return `收口结局 ${outcome ?? "未知"}`;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* 判定最近一次尝试是否属「投递到会话后没有收尾」。
|
|
75
|
+
* @returns {{run: object, reason: string}|null} 命中时给出该次尝试与结局说明;否则 `null`。
|
|
76
|
+
*/
|
|
77
|
+
export function detectUntakenDelivery({ task = null, runs = [], comments = [] } = {}) {
|
|
78
|
+
if (!task) return null;
|
|
79
|
+
if (!UNTAKEN_STATUSES.includes(task.status)) return null;
|
|
80
|
+
const run = findLatestRun(runs);
|
|
81
|
+
if (!run) return null;
|
|
82
|
+
if (!run.sessionId) return null;
|
|
83
|
+
if (!UNTAKEN_RUN_OUTCOMES.includes(run.outcome)) return null;
|
|
84
|
+
const startedAt = Date.parse(run.startedAt ?? "");
|
|
85
|
+
if (!Number.isFinite(startedAt)) return null;
|
|
86
|
+
const reported = (Array.isArray(comments) ? comments : []).some((c) => {
|
|
87
|
+
if (!isConclusionComment(c?.body)) return false;
|
|
88
|
+
const at = Date.parse(c?.createdAt ?? "");
|
|
89
|
+
return Number.isFinite(at) && at >= startedAt;
|
|
90
|
+
});
|
|
91
|
+
if (reported) return null;
|
|
92
|
+
return { run, reason: untakenReasonLabel(run.outcome) };
|
|
93
|
+
}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* deps.mjs —— 任务依赖(blocks)纯函数层(FR-39)。
|
|
3
|
+
* 有向依赖 A blocks B;同项目、无自环、无环。环检测的权威实现基于存储层递归 CTE,
|
|
4
|
+
* 本模块提供可单测的纯函数版本(供 domain 层复用)。
|
|
5
|
+
*/
|
|
6
|
+
import { TbError, invalidField } from "./errors.mjs";
|
|
7
|
+
|
|
8
|
+
/** 断言:不能自环。 */
|
|
9
|
+
export function assertNotSelfDependency(blockerId, blockedId) {
|
|
10
|
+
if (blockerId === blockedId) {
|
|
11
|
+
throw new TbError("DEPENDENCY_SELF", "任务不能依赖自己", { taskId: blockerId });
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
/** 断言:依赖两端必须同项目。 */
|
|
16
|
+
export function assertSameProjectDependency(blocker, blocked) {
|
|
17
|
+
if (blocker.projectId !== blocked.projectId) {
|
|
18
|
+
throw new TbError(
|
|
19
|
+
"DEPENDENCY_CROSS_PROJECT",
|
|
20
|
+
`依赖不能跨项目(前置 ${blocker.projectId},后继 ${blocked.projectId})`,
|
|
21
|
+
{ blockerProjectId: blocker.projectId, blockedProjectId: blocked.projectId },
|
|
22
|
+
);
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* 环检测(纯函数版):新增 blocker→blocked 是否成环。
|
|
28
|
+
* 成环 ⇔ 沿现有 blocker→blocked 边,从 `blockedId` 能回到 `blockerId`。
|
|
29
|
+
* @param {string} blockerId
|
|
30
|
+
* @param {string} blockedId
|
|
31
|
+
* @param {(id: string) => string[]} dependentsOf 返回某任务的直接后继(blocked)列表
|
|
32
|
+
*/
|
|
33
|
+
export function assertNoDependencyCycle(blockerId, blockedId, dependentsOf) {
|
|
34
|
+
const seen = new Set();
|
|
35
|
+
const stack = [blockedId];
|
|
36
|
+
while (stack.length) {
|
|
37
|
+
const cur = stack.pop();
|
|
38
|
+
if (cur === blockerId) {
|
|
39
|
+
throw new TbError("DEPENDENCY_CYCLE", "依赖会形成环,已拒绝", { blockerId, blockedId });
|
|
40
|
+
}
|
|
41
|
+
if (seen.has(cur)) continue;
|
|
42
|
+
seen.add(cur);
|
|
43
|
+
for (const nxt of dependentsOf(cur) ?? []) stack.push(nxt);
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/** 断言:blocker 不是 blocked 的必填字段缺失。 */
|
|
48
|
+
export function requireTaskRef(task, ref) {
|
|
49
|
+
if (!task) throw new TbError("TASK_NOT_FOUND", `任务不存在:${ref}`, { ref });
|
|
50
|
+
return task;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
export { invalidField };
|