taskboard-workbench 0.3.0 → 0.3.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/CHANGELOG.md +50 -0
- package/README.md +6 -0
- package/package.json +3 -2
- package/skills/taskboard-flow/references/injection.md +8 -2
- package/src/core/store.mjs +44 -13
- package/src/core/ticket-stage.mjs +13 -1
- package/src/mcp/server.mjs +26 -7
- package/src/mcp/tools.mjs +6 -1
- package/src/server/api.mjs +26 -4
- package/web/app.js +45 -17
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,56 @@
|
|
|
6
6
|
版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
|
|
7
7
|
每个版本对应一个 annotated tag(`vX.Y.Z`)与一条 GitHub Release;npm dist-tag 与 dsh 兼容区间随版本记录。
|
|
8
8
|
|
|
9
|
+
## [0.3.1] - 2026-11-04
|
|
10
|
+
|
|
11
|
+
> 主题:**7 笔攒批一次发**(`v0.3.0` 后连续攒到 6 项进包变更 + 1 项打包声明),把「卡上收口了、包里还没到」这段补齐。
|
|
12
|
+
> npm `latest` 由 `0.2.0` 直接对齐到本版(跳过从未发布的 `0.3.0`,D7「攒批」口径的兑现)。
|
|
13
|
+
> `npm test` **986 / 0**、`release-precheck` **EXIT=0**、tarball **75** 文件。
|
|
14
|
+
|
|
15
|
+
### 新增
|
|
16
|
+
|
|
17
|
+
- **`--read-only` 回滚开关(卡 `-208` / 需求 `R153`,`260bdf6`)** —— P3 设计稿承诺的逃生口此前从未实现:
|
|
18
|
+
`--read-only` 下 MCP 工具面 **9 → 5**(只留只读工具),写入类工具不注册而非「注册后报错」——
|
|
19
|
+
注册了就等于告诉调用方「有这条路」,而它注定失败。反向对照:不带开关时 9 个工具全在。
|
|
20
|
+
- **`engines.dsh` 打包声明(卡 `-212` / 需求 `R156`,`2385e11`)** —— `package.json` 增 `engines.dsh: ">=0.2.1-rc.3"`
|
|
21
|
+
(下限=首个实际验证过的宿主版本)。插件市场卡片的 `DSH <range>` 标签读的就是它,此前 `engines` 只有 `node`
|
|
22
|
+
⇒ 卡片只能显示「未声明宿主要求」。**生效时序**:本版发布后,还要等上游 `probe-npm` 与一轮 nightly 重建索引才会显形。
|
|
23
|
+
|
|
24
|
+
### 修复
|
|
25
|
+
|
|
26
|
+
- **「下一步」把半残回包当成「无待办动作」(卡 `-211` / 需求 `R155`,`e8c226b`)** —— 真机事故:宿主未重载时服务端仍回旧形状
|
|
27
|
+
`ticketStage.next = {code,title}`,而前端兜底只判 `next` 是否为 `null` ⇒ 半残回包绕过「旧版服务端」提示,
|
|
28
|
+
落到 else 分支输出**错误结论**「本卡无待办动作。」(那张卡其实只差人点「完成」,且没有「完成」按钮)。
|
|
29
|
+
修:判据改为**按形状**——缺 `steps/focus/actions/hint/blocker` 任一即提示「引导不完整(旧版服务端)」;
|
|
30
|
+
`actions: []` 仍是已收口卡的**合法**形态(空数组是真值,齐全必须回 `null`,首版自测即抓到)。
|
|
31
|
+
**守卫**:新增第 15 台 `tools/bench-next-step-shape.mjs`(真 headless Chrome + CDP;前置代理把详情回包降级成旧形状,
|
|
32
|
+
不必真退回旧进程),A/B/C/D 四组 **11/11 PASS**;反向对照(判据退回 `if (!step)`)**9/11**、A1/A2 双红。
|
|
33
|
+
- **任务抽屉三处判断收敛到单一口径(卡 `-199` / 需求 `R151`,`1c83059`)** —— 「下一步 / 看护 / 诊断」不再各自打
|
|
34
|
+
`/next-step` 与 `/execution`(一次请求算一次、还会落库),统一消费详情里那一份 `ticketStage`;
|
|
35
|
+
诊断在详情 GET 里**真实求值但零写**(`persist:false`),计数字段从已落库行补回,保住「详情 GET 无写副作用」这条不变量。
|
|
36
|
+
|
|
37
|
+
### 变更
|
|
38
|
+
|
|
39
|
+
- **契约门切 `reject`(R-A,卡 `-209`,`9bb5fcf`)** —— 调用方带 `contract` 且版本/摘要不符时,由「照常写入 + 一条 `contract-warn` 审计」
|
|
40
|
+
改为**拒绝写入**;校验整体前移到事务之前(拒绝即零副作用)。不带 `contract` 仍按 `skipped` 向后兼容。
|
|
41
|
+
⚠ **这是一处行为口径变更**:靠「带错契约也能写」跑通的脚本会开始报错——请先核对调用方是否带对了 `contract`。
|
|
42
|
+
- **`flow_inject_policy` 明标未实现(卡 `-186` / 需求 `R141`,`ad98227`)** —— 技能文档三处(标题 / 顶部警示 / 预埋项表格)
|
|
43
|
+
写明「未实现(全仓无 reader)」,并加缺口守卫 `tests/flow-inject-policy-gap.test.mjs`:扫 `src/scripts/web/cli/tools/spec`
|
|
44
|
+
断言该键命中 **0**,将来接线却没更新文档即转红(反向对照:临时探针 ⇒ 2/3 转红)。
|
|
45
|
+
|
|
46
|
+
### 移出
|
|
47
|
+
|
|
48
|
+
- **`dsh --import` shim 死代码下线(卡 `-207` / 需求 `R152`,`f1e4216`)** —— **13 文件 / +13 −538**:
|
|
49
|
+
三个 shim 早已被宿主能力位取代,留着只会让人以为还有那条路;残留引用一并清理。
|
|
50
|
+
|
|
51
|
+
### 兼容性与升级注意
|
|
52
|
+
|
|
53
|
+
- **npm `latest` 由 `0.2.0` 跳到 `0.3.1`**:registry 上**不存在 `0.3.0`**,`changelog` 仍保留其条目(它对应 `v0.3.0` tag 与源码快照)。
|
|
54
|
+
- **`engines.dsh = ">=0.2.1-rc.3"`**:宿主低于此版本不再满足声明(此前未声明,等于默认可装)。本版是本机验证过的形态。
|
|
55
|
+
- **契约门是行为变更**(上条 `-209`):升级后请重新核对 CI/脚本里的 `contract` 版本与摘要。
|
|
56
|
+
- **`schemaVersion` 仍为 13**(本版无表结构变更,`-197` 引入的两表已在 `0.3.0` 就位)。
|
|
57
|
+
- 插件市场卡片出现 `DSH >=0.2.1-rc.3` 标签**不等于**发布当天可见:需上游 `probe-npm` + 一轮 nightly 重建索引。
|
|
58
|
+
|
|
9
59
|
## [0.3.0] - 2026-11-03
|
|
10
60
|
|
|
11
61
|
> 主题:让「待验收 → 确认」这段**先变得可信** —— 有度量、有事件、有单一口径、有结构化证据。
|
package/README.md
CHANGED
|
@@ -96,9 +96,15 @@ CLI 约定:成功 `stdout` 输出 JSON(含 `schemaVersion`),退出码 `0
|
|
|
96
96
|
```bash
|
|
97
97
|
node src/mcp/server.mjs --data-dir "$TB_DATA_DIR" # MCP 客户端作为子进程拉起(stdio)
|
|
98
98
|
node src/mcp/server.mjs --print-tools # 只打印工具清单(调试用)
|
|
99
|
+
node src/mcp/server.mjs --read-only # **只读模式**:只暴露五件只读工具,写四件调用即 READ_ONLY_MODE
|
|
99
100
|
npm run mcp -- --data-dir "$TB_DATA_DIR" # 同上,走 npm script
|
|
100
101
|
```
|
|
101
102
|
|
|
103
|
+
`--read-only` 是写工具的**回滚开关**(写路径出问题时的逃生口):`tools/list` 里不再出现
|
|
104
|
+
`card_create` / `card_progress` / `requirement_upsert` / `requirement_change`,直接调用返回
|
|
105
|
+
`isError:true` + `code=READ_ONLY_MODE`(**不是**「未知工具」,便于区分「开关生效」与「名字拼错」)。
|
|
106
|
+
不带该参数时行为不变(9 个工具)。
|
|
107
|
+
|
|
102
108
|
传输是 **stdio + newline-delimited JSON-RPC 2.0**(MCP stdio transport):
|
|
103
109
|
**不占端口、不碰 `:3080`、不写 `~/.dsh/**`、不需要重载宿主**,每个 agent 会话一个进程。
|
|
104
110
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "taskboard-workbench",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.1",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "agent team 任务工作台:零依赖核心(node:sqlite)+ CLI + 本地 Web 看板 + DSH 内嵌插件",
|
|
6
6
|
"license": "MIT",
|
|
@@ -29,7 +29,8 @@
|
|
|
29
29
|
"access": "public"
|
|
30
30
|
},
|
|
31
31
|
"engines": {
|
|
32
|
-
"node": ">=22.5.0"
|
|
32
|
+
"node": ">=22.5.0",
|
|
33
|
+
"dsh": ">=0.2.1-rc.3"
|
|
33
34
|
},
|
|
34
35
|
"main": "./index.js",
|
|
35
36
|
"exports": {
|
|
@@ -1,4 +1,10 @@
|
|
|
1
|
-
# 三档装载 + 分层注入策略(档 C
|
|
1
|
+
# 三档装载 + 分层注入策略(档 C 预埋,**未实现**)
|
|
2
|
+
|
|
3
|
+
> ⚠ **未实现(全仓无 reader)** —— `flow_inject_policy` 在当前代码里**没有任何读取点**:
|
|
4
|
+
> `grep -rn "flow_inject_policy" src scripts web cli tools` 命中 **0** ⇒ **改它不改变任何行为**。
|
|
5
|
+
> 它只是为「档 C 宿主自动注入」预留的配置位(卡 `-186` / 需求 `R141`);要真正接线,得先做 P5(卡 `-210`)。
|
|
6
|
+
> **自证**:`node --test tests/flow-inject-policy-gap.test.mjs` —— 该守卫在「有人接线却没更新本文」时转红,
|
|
7
|
+
> 所以这条标注不是承诺,是可执行判据。
|
|
2
8
|
|
|
3
9
|
## 一、三档从侵入性低到高
|
|
4
10
|
|
|
@@ -29,7 +35,7 @@
|
|
|
29
35
|
|
|
30
36
|
| 预埋项 | 内容 | 现在生效吗 |
|
|
31
37
|
| --- | --- | --- |
|
|
32
|
-
| `flow_inject_policy` | `off` / `main-only` / `main+exec` / `all`(**默认 `off`**) |
|
|
38
|
+
| `flow_inject_policy` | `off` / `main-only` / `main+exec` / `all`(**默认 `off`**) | ⚠ **未实现(全仓无 reader)** —— 无任何代码读它去注入;改它不改变行为(卡 `-186` / 需求 `R141`) |
|
|
33
39
|
| 审计表 | `flow_injections(session_id, project_id, policy, contract_version, digest, injected_at)` | ✅ 表在(P1 建的),`recordFlowInjection` / `listFlowInjections` 可用 |
|
|
34
40
|
| 接入位 | 「会话创建 → 注入」的 hook 点 | ⏸ **只在本文件文档化,不写任何 `~/.dsh/**` 补丁** |
|
|
35
41
|
|
package/src/core/store.mjs
CHANGED
|
@@ -878,6 +878,11 @@ export function openStore(options = {}) {
|
|
|
878
878
|
// 797 条既有用例与真机交互一起打红;按 §17.5「先 warn 后 reject」两步走,P3 随 MCP 一起翻默认。
|
|
879
879
|
const strictAttribution =
|
|
880
880
|
String((options.env ?? process.env)?.TB_STRICT_ATTRIBUTION ?? "") === "1";
|
|
881
|
+
// D2 契约门(2026-11-04 人拍 **R-A**):默认 `reject` —— **只拒「带了但过期」**。
|
|
882
|
+
// `skipped`(调用方根本没带 contract,如 Web / CLI)**照旧放行** ⇒ 主力入口零影响。
|
|
883
|
+
// 回滚开关:`TB_CONTRACT_MODE=warn`(一行降级,等价 2026-10-29 起的旧行为)。
|
|
884
|
+
const contractMode =
|
|
885
|
+
String((options.env ?? process.env)?.TB_CONTRACT_MODE ?? "reject").trim().toLowerCase() === "warn" ? "warn" : "reject";
|
|
881
886
|
// P1 契约快照:机器规范默认随包读 `spec/norms/*.md`;测试可传 `normsDir` 或直接传 `norms`。
|
|
882
887
|
const normsDir = options.normsDir ?? path.join(PKG_ROOT, "spec", "norms");
|
|
883
888
|
const injectedNorms = Array.isArray(options.norms) ? options.norms : null;
|
|
@@ -921,25 +926,48 @@ export function openStore(options = {}) {
|
|
|
921
926
|
return contractCheckCache.byProject.get(projectId);
|
|
922
927
|
}
|
|
923
928
|
/**
|
|
924
|
-
*
|
|
925
|
-
*
|
|
926
|
-
*
|
|
929
|
+
* 契约门(**门在写入之前**,这是切 reject 的硬前提)。
|
|
930
|
+
*
|
|
931
|
+
* 只有**调用方显式带 `contract`** 才校验(老客户端 / Web / CLI 不带 ⇒ `skipped`,零打扰)。
|
|
932
|
+
* 带了但与当前不符 ⇒ `warn` verdict:
|
|
933
|
+
* · `contractMode === "warn"`(回滚档)⇒ 只落 `contract-warn` 审计,照常写入;
|
|
934
|
+
* · `contractMode === "reject"`(**默认**,2026-11-04 人拍 R-A)⇒ 落 `contract-reject` 审计并抛
|
|
935
|
+
* `CONTRACT_STALE`。**必须在任何写库动作之前调用**,否则会「先写成功再回 409」。
|
|
936
|
+
*
|
|
937
|
+
* 为什么默认就拒:MCP 写工具**总是**带契约,所以被拒的正是「拿旧模板干活的 agent」;
|
|
938
|
+
* 而 `contract-warn` 生产审计自 2026-10-29 起一直是 **0 行** ⇒ 无存量会被打断。
|
|
927
939
|
*/
|
|
928
|
-
function
|
|
940
|
+
function assertContractUsable(projectId, submitted, target) {
|
|
929
941
|
const current = currentContractCached(projectId);
|
|
930
942
|
const verdict = evaluateSubmittedContract(current, submitted);
|
|
931
943
|
if (verdict.verdict !== "warn") return verdict;
|
|
944
|
+
const detail = JSON.stringify({ problems: verdict.problems, current_version: current?.contractVersion ?? null, mode: contractMode });
|
|
932
945
|
try {
|
|
933
946
|
store.recordAudit({
|
|
934
947
|
actor: String(submitted?.actor ?? "unknown"),
|
|
935
948
|
action: "contract-warn",
|
|
936
949
|
target: String(target ?? projectId),
|
|
937
|
-
allowed:
|
|
950
|
+
allowed: contractMode !== "reject",
|
|
938
951
|
reason: "stale",
|
|
939
|
-
detail
|
|
952
|
+
detail,
|
|
940
953
|
});
|
|
941
954
|
} catch { /* 审计写失败也不能影响业务写入 */ }
|
|
942
|
-
return verdict;
|
|
955
|
+
if (contractMode !== "reject") return verdict;
|
|
956
|
+
try {
|
|
957
|
+
store.recordAudit({
|
|
958
|
+
actor: String(submitted?.actor ?? "unknown"),
|
|
959
|
+
action: "contract-reject",
|
|
960
|
+
target: String(target ?? projectId),
|
|
961
|
+
allowed: false,
|
|
962
|
+
reason: "stale",
|
|
963
|
+
detail,
|
|
964
|
+
});
|
|
965
|
+
} catch { /* 同上 */ }
|
|
966
|
+
throw new TbError(
|
|
967
|
+
"CONTRACT_STALE",
|
|
968
|
+
`你带的契约已过期(${verdict.problems.map((p) => (p.norm ? `${p.kind}:${p.norm}` : p.kind)).join(", ")});先取最新契约再重试;确需按旧契约写入请设 TB_CONTRACT_MODE=warn`,
|
|
969
|
+
{ problems: verdict.problems, currentVersion: current?.contractVersion ?? null },
|
|
970
|
+
);
|
|
943
971
|
}
|
|
944
972
|
|
|
945
973
|
/**
|
|
@@ -1268,6 +1296,10 @@ export function openStore(options = {}) {
|
|
|
1268
1296
|
throw new TbError("REQUIREMENT_REQUIRED", "建卡必须归属需求条目:请给 requirement <条目>;确实不需要归属时用 unattributedReason <理由> 显式声明(会落审计)", { projectId });
|
|
1269
1297
|
}
|
|
1270
1298
|
|
|
1299
|
+
// 契约门(D2/R-A):**必须在 begin 之前** —— 否则旧契约会「先建出卡再回 409」。
|
|
1300
|
+
// 代价:审计 target 只能指到 `project:new-task`(卡号此时还不存在)。
|
|
1301
|
+
assertContractUsable(projectId, input.contract, `${projectId}:new-task`);
|
|
1302
|
+
|
|
1271
1303
|
let requirementId = null; // 事务内解析、事务外留痕(故声明在 try 之外)
|
|
1272
1304
|
|
|
1273
1305
|
db.exec("begin immediate");
|
|
@@ -1313,8 +1345,6 @@ export function openStore(options = {}) {
|
|
|
1313
1345
|
store.recordTaskEvent(id, { type: "attribution_missing", to: status, actor: "human", detail: "建卡未归属需求条目(未声明理由)—— 启动执行/派发团队会被归因门拒绝" });
|
|
1314
1346
|
}
|
|
1315
1347
|
const created = store.getTaskById(id);
|
|
1316
|
-
// P1.5 · warn 档:审计要指到**这张卡**(不是 `task:new`)。切 reject 时必须把这行挪到 `begin` 之前。
|
|
1317
|
-
noteContractUse(projectId, input.contract, created.identifier);
|
|
1318
1348
|
return created;
|
|
1319
1349
|
},
|
|
1320
1350
|
|
|
@@ -1414,7 +1444,7 @@ export function openStore(options = {}) {
|
|
|
1414
1444
|
|
|
1415
1445
|
updateTask(ref, changes = {}) {
|
|
1416
1446
|
const current = store.requireTaskRef(ref);
|
|
1417
|
-
|
|
1447
|
+
assertContractUsable(current.projectId, changes.contract, current.identifier);
|
|
1418
1448
|
const { expectedVersion } = changes;
|
|
1419
1449
|
if (expectedVersion === undefined || expectedVersion === null) {
|
|
1420
1450
|
throw new TbError("MISSING_VERSION", "更新必须提供 expectedVersion(我读到的版本)", { taskId: current.id, currentVersion: current.version });
|
|
@@ -1575,7 +1605,7 @@ export function openStore(options = {}) {
|
|
|
1575
1605
|
|
|
1576
1606
|
addComment(ref, input = {}) {
|
|
1577
1607
|
const task = store.requireTaskRef(ref);
|
|
1578
|
-
|
|
1608
|
+
assertContractUsable(task.projectId, input.contract, task.identifier);
|
|
1579
1609
|
const body = normalizeDescription(input.body);
|
|
1580
1610
|
const id = input.id ?? randomUUID();
|
|
1581
1611
|
const timestamp = nowIso();
|
|
@@ -1744,6 +1774,8 @@ export function openStore(options = {}) {
|
|
|
1744
1774
|
}
|
|
1745
1775
|
const id = input.id ?? randomUUID();
|
|
1746
1776
|
const ts = nowIso();
|
|
1777
|
+
// 契约门(D2/R-A):同上,必须在 begin 之前。
|
|
1778
|
+
assertContractUsable(projectId, input.contract, `${projectId}:new-requirement`);
|
|
1747
1779
|
db.exec("begin immediate");
|
|
1748
1780
|
try {
|
|
1749
1781
|
insertRequirementItem(db, { id, projectId, docId, title, description, acceptance, priority, status, source, ts });
|
|
@@ -1754,13 +1786,12 @@ export function openStore(options = {}) {
|
|
|
1754
1786
|
throw error;
|
|
1755
1787
|
}
|
|
1756
1788
|
const createdItem = store.getRequirementItemById(id);
|
|
1757
|
-
noteContractUse(projectId, input.contract, createdItem.identifier);
|
|
1758
1789
|
return createdItem;
|
|
1759
1790
|
},
|
|
1760
1791
|
/** 更新需求条目(状态/标题/说明/验收/优先级)——资料引入后的"确认/修订"。 */
|
|
1761
1792
|
updateRequirementItem(ref, changes = {}) {
|
|
1762
1793
|
const item = store.requireRequirementItemRef(ref);
|
|
1763
|
-
|
|
1794
|
+
assertContractUsable(item.projectId, changes.contract, item.identifier);
|
|
1764
1795
|
const sets = []; const params = [];
|
|
1765
1796
|
if (changes.title !== undefined) {
|
|
1766
1797
|
const nextTitle = assertTitle(changes.title);
|
|
@@ -86,6 +86,8 @@ export function deriveDelivery({ task = {}, evidence = null, decision = null } =
|
|
|
86
86
|
* 归一为单一 `stage`(纯)。优先级见文件头三条。
|
|
87
87
|
* 返回 `{ stage, reason, delivery, next, watch, verify, diagnostics }` ——
|
|
88
88
|
* 后四者是**同批读数**(不参与 stage 计算,但同一函数给出,避免调用方各取一套再自己拼)。
|
|
89
|
+
* `next` = `deriveNextStep()` 的**完整**回包,`watch` = `assessTask()` 的**完整**回包(卡 `-199`:
|
|
90
|
+
* 抽屉直接消费这两个对象,不再各自去请求 `/next-step` 与 `/execution`)。
|
|
89
91
|
*/
|
|
90
92
|
export function ticketStage(task = {}, ctx = {}) {
|
|
91
93
|
const t = task ?? {};
|
|
@@ -108,7 +110,17 @@ export function ticketStage(task = {}, ctx = {}) {
|
|
|
108
110
|
const next = deriveNextStep(t, { humanReviewBlocker: ctx.humanReviewBlocker ?? null, stalled });
|
|
109
111
|
const autoReview = latestAutoReview(ctx.comments ?? []);
|
|
110
112
|
|
|
111
|
-
|
|
113
|
+
// 卡 `-199`(FR-108 收口):`next` / `watch` **原样整份透传**,不再削成 `{code,title}` / `{state,minutes}`。
|
|
114
|
+
// 削字段不是"瘦身",是**静默删功能**:`next` 少了 `hint/steps/focus/actions/blocker`,「下一步」区块
|
|
115
|
+
// 就只剩一句标题(步骤、按钮、默认折叠、前置卡跳转全没了);`watch` 少了 `followups/reason`,
|
|
116
|
+
// 「派生为子任务 / 忽略」与「执行会话未在线」文案就一起消失。调用方只消费这一份,所以必须给全。
|
|
117
|
+
const base = {
|
|
118
|
+
delivery,
|
|
119
|
+
next,
|
|
120
|
+
watch,
|
|
121
|
+
verify: autoReview ? { verdict: autoReview.verdict ?? null, at: autoReview.at ?? null } : null,
|
|
122
|
+
diagnostics: Array.isArray(ctx.diagnostics) ? ctx.diagnostics.slice() : [],
|
|
123
|
+
};
|
|
112
124
|
|
|
113
125
|
// 1) 终态
|
|
114
126
|
if (status === "done") return { stage: "done", reason: "已完成", ...base };
|
package/src/mcp/server.mjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
/**
|
|
3
|
-
* server.mjs —— Taskboard Workbench MCP server(stdio · 零依赖 ·
|
|
3
|
+
* server.mjs —— Taskboard Workbench MCP server(stdio · 零依赖 · 只读五 + 写四)。
|
|
4
4
|
*
|
|
5
5
|
* 方案依据:§6.1 —— **stdio 而不是 HTTP**:① 不占端口、不碰 `:3080`;② 不需要重载宿主、
|
|
6
6
|
* 不写 `~/.dsh/**`;③ 每个 agent 会话一个进程,天然隔离。数据连**同一个** `taskboard.sqlite`。
|
|
@@ -8,6 +8,7 @@
|
|
|
8
8
|
* 用法:
|
|
9
9
|
* node src/mcp/server.mjs --data-dir <dir> # 由 MCP 客户端作为子进程拉起
|
|
10
10
|
* node src/mcp/server.mjs --print-tools # 打印工具清单(调试 / 守卫测试用)
|
|
11
|
+
* node src/mcp/server.mjs --read-only # **只读模式**(P3 的回滚开关):写四件不出现在 tools/list,调用即 READ_ONLY_MODE
|
|
11
12
|
*
|
|
12
13
|
* 传输:newline-delimited JSON-RPC 2.0(MCP stdio transport)。
|
|
13
14
|
* stdout **只允许**出现协议消息;日志一律走 stderr(否则客户端解析失败)。
|
|
@@ -29,9 +30,16 @@ const argOf = (name) => {
|
|
|
29
30
|
};
|
|
30
31
|
const has = (name) => argv.includes(name);
|
|
31
32
|
|
|
33
|
+
// P3 的回滚开关(方案 §十 回滚列 / 风险表 R2):只读模式下按 annotations.readOnlyHint 过滤工具面。
|
|
34
|
+
// 这是**承诺过的逃生口** —— 写工具出问题时应能一条参数降级,而不是回退提交。
|
|
35
|
+
const READ_ONLY = has("--read-only");
|
|
36
|
+
const ACTIVE_TOOLS = READ_ONLY ? TOOLS.filter((t) => t.annotations?.readOnlyHint === true) : TOOLS;
|
|
37
|
+
const ACTIVE_NAMES = ACTIVE_TOOLS.map((t) => t.name);
|
|
38
|
+
|
|
32
39
|
if (has("--help") || has("-h")) {
|
|
33
40
|
process.stderr.write(`taskboard-workbench MCP server(9 个工具:只读五 / 写四 · prompt 1)
|
|
34
|
-
用法: node src/mcp/server.mjs [--data-dir <dir>] [--print-tools]
|
|
41
|
+
用法: node src/mcp/server.mjs [--data-dir <dir>] [--print-tools] [--read-only]
|
|
42
|
+
只读: --read-only 关闭写四件(card_create / card_progress / requirement_upsert / requirement_change)——P3 的回滚开关
|
|
35
43
|
工具: ${TOOL_NAMES.join(", ")}
|
|
36
44
|
提示: prompt taskboard.flow(= node scripts/tb-flow.mjs start 的输出)
|
|
37
45
|
数据: --data-dir > $TB_DATA_DIR > 默认(同 Web/CLI)
|
|
@@ -42,7 +50,7 @@ if (has("--help") || has("-h")) {
|
|
|
42
50
|
const pkg = JSON.parse(readFileSync(path.join(PKG_ROOT, "package.json"), "utf8"));
|
|
43
51
|
|
|
44
52
|
if (has("--print-tools")) {
|
|
45
|
-
process.stdout.write(`${JSON.stringify({ name: pkg.name, version: pkg.version,
|
|
53
|
+
process.stdout.write(`${JSON.stringify({ name: pkg.name, version: pkg.version, readOnly: READ_ONLY, tools: ACTIVE_NAMES }, null, 2)}\n`);
|
|
46
54
|
process.exit(0);
|
|
47
55
|
}
|
|
48
56
|
|
|
@@ -51,7 +59,7 @@ const store = openStore({ dataDir, env: process.env });
|
|
|
51
59
|
const ctx = { store };
|
|
52
60
|
let skillMeta = null;
|
|
53
61
|
try { skillMeta = readSkill().meta; } catch { /* skill 缺失时不影响工具面;prompts/* 会报出具体原因 */ }
|
|
54
|
-
process.stderr.write(`[tb-mcp] ready dataDir=${store.dataDir} tools=${
|
|
62
|
+
process.stderr.write(`[tb-mcp] ready dataDir=${store.dataDir} readOnly=${READ_ONLY} tools=${ACTIVE_NAMES.join(",")} prompt=taskboard.flow skill=${skillMeta ? `v${skillMeta.version}` : "missing"}\n`);
|
|
55
63
|
|
|
56
64
|
const SERVER_INFO = { name: "taskboard-workbench", version: pkg.version };
|
|
57
65
|
const DEFAULT_PROTOCOL = "2025-06-18";
|
|
@@ -72,7 +80,7 @@ const toolError = (error) => {
|
|
|
72
80
|
};
|
|
73
81
|
|
|
74
82
|
function listTools() {
|
|
75
|
-
return
|
|
83
|
+
return ACTIVE_TOOLS.map((t) => ({
|
|
76
84
|
name: t.name,
|
|
77
85
|
description: t.description,
|
|
78
86
|
inputSchema: t.inputSchema,
|
|
@@ -94,8 +102,19 @@ async function handle(message) {
|
|
|
94
102
|
if (method === "tools/list") return result(id, { tools: listTools() });
|
|
95
103
|
if (method === "tools/call") {
|
|
96
104
|
const name = params?.name;
|
|
97
|
-
const tool =
|
|
98
|
-
if (!tool)
|
|
105
|
+
const tool = ACTIVE_TOOLS.find((t) => t.name === name);
|
|
106
|
+
if (!tool) {
|
|
107
|
+
// 只读模式下「写工具存在但被关掉」与「工具根本不存在」必须分开报:
|
|
108
|
+
// 前者是**预期降级**(回滚开关生效),后者是客户端拼错了名字。
|
|
109
|
+
if (READ_ONLY && TOOLS.some((t) => t.name === name)) {
|
|
110
|
+
return result(id, toolError(new TbError(
|
|
111
|
+
"READ_ONLY_MODE",
|
|
112
|
+
`--read-only 已启用:写工具 ${name} 不可用(P3 回滚开关)。只读工具:${ACTIVE_NAMES.join(", ")}`,
|
|
113
|
+
{ tool: name, readOnly: true, available: ACTIVE_NAMES },
|
|
114
|
+
)));
|
|
115
|
+
}
|
|
116
|
+
return rpcError(id, -32602, `Unknown tool: ${name ?? "(missing)"}`, { tools: ACTIVE_NAMES });
|
|
117
|
+
}
|
|
99
118
|
try {
|
|
100
119
|
const value = await tool.handler(ctx, params?.arguments ?? {});
|
|
101
120
|
return result(id, { content: [{ type: "text", text: JSON.stringify(value, null, 2) }], isError: false });
|
package/src/mcp/tools.mjs
CHANGED
|
@@ -180,7 +180,12 @@ export function workbenchAudit({ store }, args = {}) {
|
|
|
180
180
|
// ① contract-stale:内核 warn 档留下的审计(P1.5)——「有 agent 用旧契约写过东西」
|
|
181
181
|
const warns = store.listGovernanceAudit({ action: "contract-warn" })
|
|
182
182
|
.filter((r) => Date.parse(r.at) >= sinceMs)
|
|
183
|
-
|
|
183
|
+
// target 有两种形态:`<project>-<seq>`(既有卡/条目的编号)与 `<project>:new-task|new-requirement`
|
|
184
|
+
// (2026-11-04 起契约门挪到**事务之前**,建卡/建条目时编号还不存在)。两种都要算本项目。
|
|
185
|
+
.filter((r) => {
|
|
186
|
+
const target = String(r.target ?? "");
|
|
187
|
+
return target.startsWith(`${project.id}-`) || target.startsWith(`${project.id}:`) || target === project.id;
|
|
188
|
+
});
|
|
184
189
|
// ② unattributed:未完成且无归因的卡
|
|
185
190
|
const unattributed = tasks.filter((t) => !TERMINAL.has(t.status) && !t.requirementId);
|
|
186
191
|
// ③ unbound-session:项目主会话未绑定
|
package/src/server/api.mjs
CHANGED
|
@@ -626,17 +626,39 @@ export function createApiRouter({ store, aiElaborator, events } = {}) {
|
|
|
626
626
|
// FR-90:详情里直接带上「评审证据包」(自动复核结论 + 最近一条进展评论),
|
|
627
627
|
// 评审人打开抽屉即可看到机器结论,而不是只看到两个按钮。
|
|
628
628
|
const comments = store.listComments(task.id);
|
|
629
|
-
// FR-108(卡 `-198`):详情带**阶段推导单一口径**(`ticketStage`,0-A1 的纯函数)。
|
|
629
|
+
// FR-108(卡 `-198` → 卡 `-199`):详情带**阶段推导单一口径**(`ticketStage`,0-A1 的纯函数)。
|
|
630
630
|
// 只读附加字段:不改任何既有字段语义,也不写库。
|
|
631
631
|
// · `decision` 先给 null —— `decision_log` 表属 0-C(FR-109),建表后在这里读行传进来即可;
|
|
632
|
-
// · `diagnostics`
|
|
633
|
-
//
|
|
632
|
+
// · `diagnostics` **真实求值但零写**(卡 `-199`):抽屉的「下一步 / 看护 / 诊断」三块现在只消费
|
|
633
|
+
// 这一份 `ticketStage`,不再各自去打 `/next-step` 与 `/execution`(那里一次请求算一次、还会落库)。
|
|
634
|
+
// 所以这里必须把诊断算出来,否则诊断块会因为"没人再算"而永远空着。
|
|
635
|
+
// `persist:false` 保住本端点的既有不变量「详情 GET 不得有写副作用」;计数字段从**已落库行**补回
|
|
636
|
+
// (否则界面上永远显示"第 1 次",把复发次数这条信息抹掉)。
|
|
634
637
|
const evidence = typeof store.latestTaskEvidence === "function" ? store.latestTaskEvidence(task.identifier) : null;
|
|
635
638
|
let sessionState = null;
|
|
636
639
|
try { sessionState = store.taskSessionState(task); } catch { sessionState = null; }
|
|
637
640
|
let currentRun = null;
|
|
638
641
|
try { currentRun = typeof store.getCurrentRun === "function" ? store.getCurrentRun(task) : null; } catch { currentRun = null; }
|
|
639
|
-
|
|
642
|
+
let diagnostics = [];
|
|
643
|
+
try {
|
|
644
|
+
const preview = evaluateTaskDiagnostics(store, task, { persist: false });
|
|
645
|
+
const persisted = new Map(
|
|
646
|
+
(typeof store.listTaskDiagnostics === "function" ? store.listTaskDiagnostics(task) : []).map((d) => [String(d.kind ?? ""), d]),
|
|
647
|
+
);
|
|
648
|
+
diagnostics = (preview.diagnostics ?? []).map((d) => {
|
|
649
|
+
const prev = persisted.get(String(d.kind ?? ""));
|
|
650
|
+
if (!prev) return d;
|
|
651
|
+
const count = Number(prev.count ?? 0);
|
|
652
|
+
return {
|
|
653
|
+
...d,
|
|
654
|
+
// 计数只认已落库行:它才是"这条诊断第几次出现"的事实来源;预览恒为 1。
|
|
655
|
+
count: count > 0 ? count : d.count,
|
|
656
|
+
firstSeenAt: prev.firstSeenAt ?? null,
|
|
657
|
+
lastSeenAt: prev.lastSeenAt ?? d.lastSeenAt,
|
|
658
|
+
};
|
|
659
|
+
});
|
|
660
|
+
} catch { diagnostics = []; }
|
|
661
|
+
const stage = ticketStage(task, { evidence, decision: null, comments, sessionState, currentRun, diagnostics });
|
|
640
662
|
return { status: 200, payload: { task, comments, reviewEvidence: buildReviewEvidence({ comments }), ticketStage: stage } };
|
|
641
663
|
}
|
|
642
664
|
if (method === "PATCH") {
|
package/web/app.js
CHANGED
|
@@ -2317,9 +2317,11 @@
|
|
|
2317
2317
|
let detailTask = null;
|
|
2318
2318
|
// 真机 2026-10-23(用户报障「评审通过点击后…有两个完成按钮」):抽屉渲染会被**并发**触发 ——
|
|
2319
2319
|
// 评审/授权成功后处理器里的 `reopen()`、SSE `task.updated` 回流、60s 看护轮询、回到页签自愈,
|
|
2320
|
-
//
|
|
2321
|
-
//
|
|
2320
|
+
// 任两条撞在一起就有两代渲染同时在跑。当时「下一步」区块是**唯一在额外的 await(`GET …/next-step`)
|
|
2321
|
+
// 之后才追加**的区块 ⇒ 先完成的那一代把自己的 `<section>` 插进了后一代的 body,该区块于是出现两次
|
|
2322
2322
|
// (按钮自然也就成了两个)。处置=渲染代次:每代自增序号,await 回来发现已被更新的一代取代即退出。
|
|
2323
|
+
// 卡 `-199` 之后取数已收敛为一次 `Promise.all`(不再单独 await `/next-step`),代次守卫仍保留:
|
|
2324
|
+
// 它同时兜住「用户连点两张卡」这类**已知**并发,而幂等兜底(见「下一步」区块)兜住未知的。
|
|
2323
2325
|
let detailRenderSeq = 0;
|
|
2324
2326
|
const setView = (next) => {
|
|
2325
2327
|
view = next;
|
|
@@ -4693,9 +4695,10 @@
|
|
|
4693
4695
|
cliSec.appendChild(cliBar);
|
|
4694
4696
|
drawerBody.appendChild(cliSec);
|
|
4695
4697
|
|
|
4696
|
-
// 诊断与恢复动作(FR-79):结构化诊断(类型 / 严重度 / 说明 /
|
|
4697
|
-
//
|
|
4698
|
-
|
|
4698
|
+
// 诊断与恢复动作(FR-79):结构化诊断(类型 / 严重度 / 说明 / 恢复动作)。
|
|
4699
|
+
// 卡 `-199`:改读 `GET /api/tasks/:ref` 回包里的 `ticketStage.diagnostics` —— 三块判断
|
|
4700
|
+
// (下一步 / 看护 / 诊断)自此同源,不再各取一套(旧口径是 `exec.diagnostics`,走 `/execution`)。
|
|
4701
|
+
const diagList = Array.isArray(detail?.ticketStage?.diagnostics) ? detail.ticketStage.diagnostics : [];
|
|
4699
4702
|
if (diagList.length > 0) {
|
|
4700
4703
|
const SEV_LABEL = { high: "高危", medium: "中等", low: "提示" };
|
|
4701
4704
|
const dsec = mk("div", "drawer-section");
|
|
@@ -4831,7 +4834,9 @@
|
|
|
4831
4834
|
}
|
|
4832
4835
|
|
|
4833
4836
|
// 执行看护(FR-75 停滞 / FR-76 "下一步建议"跟进)
|
|
4834
|
-
|
|
4837
|
+
// 卡 `-199`:改读 `ticketStage.watch`(与「下一步」「诊断」同源)。`watch` 是 `assessTask()` 的完整回包,
|
|
4838
|
+
// `followups / reason` 都在里面 —— 「派生为子任务 / 忽略」和「执行会话未在线」文案不会因此丢掉。
|
|
4839
|
+
const watch = detail?.ticketStage?.watch ?? null;
|
|
4835
4840
|
if (watch && (watch.state === "stalled" || watch.state === "awaiting-decision")) {
|
|
4836
4841
|
const wsec = mk("div", "drawer-section");
|
|
4837
4842
|
wsec.appendChild(mk("h3", null, "执行看护"));
|
|
@@ -4970,7 +4975,8 @@
|
|
|
4970
4975
|
// 「下一步」引导(真机反馈 2026-10-22:「详情界面没有下一步该做啥的提示,也没有操作按钮」)。
|
|
4971
4976
|
// 缺口实质:按钮此前按**功能分类**散落在「评审 / 操作 / 人工校验」各区块,没有一处回答
|
|
4972
4977
|
// "我现在该干嘛";被人工校验门挡住的卡只有一行文字,连跳过去下结论的入口都没有。
|
|
4973
|
-
// 口径唯一来源=服务端 `
|
|
4978
|
+
// 口径唯一来源=服务端 `ticketStage.next`(`ticketStage()` 内部调 `deriveNextStep()`,纯函数 + 单测;
|
|
4979
|
+
// 卡 `-199` 起随 `GET /api/tasks/:ref` 一并返回,不再单独请求 `/next-step`)。
|
|
4974
4980
|
// 这里只把 action id 映射成按钮与处理器 —— 不在前端重写一遍判断,避免两份口径。
|
|
4975
4981
|
{
|
|
4976
4982
|
const scrollToSection = (keyword) => {
|
|
@@ -5048,20 +5054,42 @@
|
|
|
5048
5054
|
} catch (e) { showBanner(`转调试失败:${e.message}`, "error"); }
|
|
5049
5055
|
},
|
|
5050
5056
|
};
|
|
5051
|
-
|
|
5052
|
-
|
|
5053
|
-
//
|
|
5057
|
+
// 卡 `-199`:改读 `detail.ticketStage.next`(与「看护」「诊断」同源),**不再**单独请求
|
|
5058
|
+
// `GET /api/tasks/:ref/next-step` —— 那条路径会让同一张卡在同一屏上出现两套判断。
|
|
5059
|
+
// `ticketStage.next` 是 `deriveNextStep()` 的完整回包(hint / steps / focus / actions / blocker),
|
|
5060
|
+
// 所以下面按 `focus` 折叠、按 `actions` 生成按钮、按 `blocker` 跳前置卡的能力一条不减。
|
|
5061
|
+
const step = detail?.ticketStage?.next ?? null;
|
|
5062
|
+
// 卡 `-211`(需求 `R155`):`next` 能不能用,按**形状**判,不按存在性判。
|
|
5063
|
+
// 真机事故(2026-11-04,卡 `-185`):宿主没重载,服务端仍回 `{code,title}`;旧判据只看 `next` 是否为 null
|
|
5064
|
+
// ⇒ 半残回包绕过「旧版服务端」提示,落到 else 分支输出「本卡无待办动作」,把一个**错误结论**摆到人脸上
|
|
5065
|
+
// (那张卡其实只差人点「完成」)。注意 `actions: []` 是合法形态(已收口卡就是空数组),
|
|
5066
|
+
// 所以判据必须看**字段在不在**,不能看数组空不空。
|
|
5067
|
+
const NEXT_STEP_ARRAY_FIELDS = ["steps", "focus", "actions"];
|
|
5068
|
+
const NEXT_STEP_PLAIN_FIELDS = ["hint", "blocker"];
|
|
5069
|
+
const nextShapeMissing = (() => {
|
|
5070
|
+
if (!step || typeof step !== "object") return null; // 完全没有 ⇒ 走「不可用」文案
|
|
5071
|
+
const missing = [];
|
|
5072
|
+
for (const k of NEXT_STEP_ARRAY_FIELDS) if (!Array.isArray(step[k])) missing.push(k);
|
|
5073
|
+
for (const k of NEXT_STEP_PLAIN_FIELDS) if (!(k in step)) missing.push(k);
|
|
5074
|
+
return missing.length ? missing : null; // 空数组也是真值 ⇒ 齐全时必须回 null,否则好形态会被当成缺字段
|
|
5075
|
+
})();
|
|
5076
|
+
// 取数阶段已整体 await 完(`Promise.all`),本段是同步构建;代次判断保留作为并发兜底。
|
|
5054
5077
|
if (renderSeq !== detailRenderSeq) return;
|
|
5055
|
-
//
|
|
5078
|
+
// 引导拿不到不阻断抽屉(老服务/回包缺字段时照旧能看到其它区块);但不静默 —— 留一行说明。
|
|
5056
5079
|
// FR-89(真机反馈 2026-10-22):「收口了为何还有这么多校验/评审/执行会话按钮」「异常时既可评审又可检验、无从下手」。
|
|
5057
5080
|
// 处置 = 只做**呈现层默认折叠**(内容与按钮一个不删,点标题即可展开),并把人手动开过的区块排除在外。
|
|
5058
5081
|
const isClosed = t.status === "done" || t.status === "canceled";
|
|
5059
|
-
const foldedTitles = step ? applyFocusPolicy(step.focus) : [];
|
|
5082
|
+
const foldedTitles = step && !nextShapeMissing ? applyFocusPolicy(step.focus) : [];
|
|
5060
5083
|
syncExpandAllLabel();
|
|
5061
5084
|
const sec = mk("div", "drawer-section next-step");
|
|
5062
5085
|
sec.appendChild(mk("h3", null, "下一步"));
|
|
5063
|
-
if (!step) {
|
|
5064
|
-
|
|
5086
|
+
if (!step || nextShapeMissing) {
|
|
5087
|
+
// 半残回包(有 code/title、缺 actions 等)同样算「引导不可用」:它**不是**「本卡无待办动作」。
|
|
5088
|
+
// 标题照旧显示(它常常已经把结论说对了,如「只差你点『完成』」),但动作区不能凭空下结论。
|
|
5089
|
+
if (step && step.title) sec.appendChild(mk("div", "next-step-title", step.title));
|
|
5090
|
+
sec.appendChild(mk("div", "empty-note", nextShapeMissing
|
|
5091
|
+
? `下一步引导不完整:详情回包里的 ticketStage.next 缺 ${nextShapeMissing.join(" / ")}(旧版服务端)——重载插件后生效。此处不是「无待办」,请按下方各区块自行判断。`
|
|
5092
|
+
: "下一步引导不可用:详情回包里没有 `ticketStage.next`(旧版服务端)——重载插件后生效。当前请按下方各区块自行判断。"));
|
|
5065
5093
|
} else {
|
|
5066
5094
|
sec.appendChild(mk("div", "next-step-title", step.title));
|
|
5067
5095
|
if (step.hint) sec.appendChild(mk("p", "hint", step.hint));
|
|
@@ -5106,9 +5134,9 @@
|
|
|
5106
5134
|
sec.appendChild(moreBar);
|
|
5107
5135
|
}
|
|
5108
5136
|
}
|
|
5109
|
-
// 幂等兜底(2026-10-23 ·
|
|
5110
|
-
//
|
|
5111
|
-
//
|
|
5137
|
+
// 幂等兜底(2026-10-23 · 用户批注「两个完成按钮」的第二道防线):代次守卫已挡住已知的并发路径。
|
|
5138
|
+
// 卡 `-199` 起本区块不再单独 await(数据来自 `Promise.all` 取回的 `ticketStage`),
|
|
5139
|
+
// 但**保留**这条输出不变量:一旦将来又冒出新的并发入口绕过守卫,症状仍旧是「两个完成按钮」。
|
|
5112
5140
|
for (const staleNextStep of Array.from(drawerBody.querySelectorAll(".drawer-section.next-step"))) staleNextStep.remove();
|
|
5113
5141
|
drawerBody.insertBefore(sec, drawerBody.firstChild); // 放最前:先回答"该干嘛",再看明细
|
|
5114
5142
|
}
|