taskboard-workbench 0.3.1 → 0.3.3
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 +101 -2
- package/index.js +112 -13
- package/package.json +6 -2
- package/scripts/tb-flow.mjs +109 -8
- package/skills/taskboard-flow/SKILL.md +2 -2
- package/skills/taskboard-flow/references/injection.md +76 -29
- package/skills/taskboard-flow/references/steps/S5.md +21 -1
- package/spec/docs/01-/351/241/271/347/233/256/345/274/200/345/261/200.md +63 -0
- package/spec/docs/02-/346/265/201/347/250/213/346/211/247/350/241/214/344/270/216/346/235/241/347/233/256.md +110 -0
- package/spec/docs/README.md +36 -0
- package/spec/docs/assets//346/235/241/347/233/256/350/257/246/346/203/205/346/250/241/346/235/277.md +105 -0
- package/spec/norms/item-detail.md +73 -0
- package/spec/norms/manifest.json +7 -0
- package/src/core/config.mjs +12 -3
- package/src/core/contract.mjs +17 -7
- package/src/core/data-dir-hint.mjs +52 -0
- package/src/core/docs-assets.mjs +135 -0
- package/src/core/errors.mjs +11 -0
- package/src/core/evidence.mjs +28 -0
- package/src/core/executor.mjs +27 -7
- package/src/core/executors.mjs +279 -0
- package/src/core/flow-inject.mjs +190 -0
- package/src/core/instance-lease.mjs +113 -0
- package/src/core/kickoff.mjs +289 -0
- package/src/core/norms.mjs +177 -0
- package/src/core/requirements.mjs +38 -0
- package/src/core/store.mjs +333 -36
- package/src/core/verify.mjs +39 -4
- package/src/mcp/flow-block.mjs +30 -0
- package/src/mcp/server.mjs +19 -6
- package/src/mcp/tools.mjs +99 -7
- package/src/server/api.mjs +361 -11
- package/web/app.js +1077 -82
- package/web/tokens.css +166 -28
package/src/core/verify.mjs
CHANGED
|
@@ -13,21 +13,56 @@
|
|
|
13
13
|
* 跑命令的 I/O 在 `../server/verify.mjs`(有超时与输出截断),本模块保持纯函数以便单测。
|
|
14
14
|
*/
|
|
15
15
|
|
|
16
|
+
import { TbError } from "./errors.mjs";
|
|
16
17
|
import { latestProgressComment } from "./watchdog.mjs";
|
|
17
18
|
|
|
18
19
|
/** 证据评论前缀与默认命令(项目未配置时的兜底)。 */
|
|
19
20
|
export const VERIFY_COMMENT_PREFIX = "【自动复核】";
|
|
20
21
|
export const VERIFY_DEFAULT_COMMAND = "npm test";
|
|
21
|
-
/**
|
|
22
|
-
|
|
22
|
+
/** 命令长度上限:**2000**(原 300 是"手敲命令"的尺寸;开局缺口命令是**机器生成**的,
|
|
23
|
+
* 一步要覆盖 2–4 条判据,实测最长 1133 字符 —— 300 会让生成侧根本无法产出可存的命令)。
|
|
24
|
+
* 超限一律报错,**不静默截断**:截断会把命令切成语法错误(`-232` 自动复核 exit 2 的根因)。 */
|
|
25
|
+
export const VERIFY_MAX_COMMAND = 2000;
|
|
26
|
+
/** 输出尾段上限:评论是给人看的证据,不是日志搬运。 */
|
|
23
27
|
export const VERIFY_MAX_TAIL = 4000;
|
|
24
28
|
/** FR-94:随证据一起落盘的「本卡验收标准」上限(给人看,长文截断即可)。 */
|
|
25
29
|
export const VERIFY_MAX_ACCEPTANCE = 2000;
|
|
26
30
|
|
|
27
|
-
/** 命令归一:空/非字符串 →
|
|
31
|
+
/** 命令归一:空/非字符串 → 默认命令;超长**报错**(不再静默截断 —— 截断后命令会变成语法错误)。 */
|
|
28
32
|
export function normalizeVerifyCommand(raw) {
|
|
29
33
|
const s = String(raw ?? "").trim();
|
|
30
|
-
|
|
34
|
+
if (s === "") return VERIFY_DEFAULT_COMMAND;
|
|
35
|
+
if (s.length > VERIFY_MAX_COMMAND) {
|
|
36
|
+
throw new TbError("USAGE_ERROR", `复核命令过长(${s.length} 字符 > 上限 ${VERIFY_MAX_COMMAND}):请压短后再提交(不再静默截断 —— 截断会把命令切成语法错误)`, { length: s.length, max: VERIFY_MAX_COMMAND });
|
|
37
|
+
}
|
|
38
|
+
return s;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* 「这条命令根本跑不起来」的前置识别(卡 `-249` / 需求 `R179`)。
|
|
43
|
+
*
|
|
44
|
+
* 真机 2026-11-12(`scada-vibe-1`):复核动作被写成
|
|
45
|
+
* `git -C 00-project-real/scada status --porcelain && git apply --check <diff文件>` ——
|
|
46
|
+
* `<diff文件>` 是**给人看的占位符**,但 `spawn(cmd, { shell: true })` 会交给 `/bin/sh` 解析:
|
|
47
|
+
* `<` 被当成重定向、`>` 没有目标 ⇒ **语法错误** ⇒ 退出码 2 ⇒ 结论写成「失败(退出码 2)」。
|
|
48
|
+
* 读起来像「产品挂了 / 测试没过」,实际是「这条命令不是命令,是模板」。
|
|
49
|
+
*
|
|
50
|
+
* 处置与 FR-94 的第三态同构:**不跑**,判「不适用」,并把该替换的位置原样点名。
|
|
51
|
+
* 只认两种明显的模板痕迹(`<…>` 与 `{{…}}`):`diff <(a) <(b)` 这类进程替换、`2>&1` 这类
|
|
52
|
+
* 重定向都不会命中,避免把合法命令误判成模板。
|
|
53
|
+
*/
|
|
54
|
+
export function detectUnrunnableVerify(raw) {
|
|
55
|
+
const s = String(raw ?? "").trim();
|
|
56
|
+
if (s === "") return null;
|
|
57
|
+
const angle = /<([^<>\n]{1,40})>/.exec(s);
|
|
58
|
+
if (angle) {
|
|
59
|
+
return { kind: "placeholder", token: angle[0], reason: `复核命令含未替换的占位符 ${angle[0]}(shell 会把 \`<\` 当重定向解析 ⇒ 语法错误,永远跑不起来)` };
|
|
60
|
+
}
|
|
61
|
+
const brace = /\{\{([^}\n]{1,40})\}\}/.exec(s);
|
|
62
|
+
if (brace) {
|
|
63
|
+
return { kind: "placeholder", token: brace[0], reason: `复核命令含未替换的占位符 ${brace[0]}(模板变量没展开)` };
|
|
64
|
+
}
|
|
65
|
+
return null;
|
|
31
66
|
}
|
|
32
67
|
|
|
33
68
|
/**
|
package/src/mcp/flow-block.mjs
CHANGED
|
@@ -152,6 +152,36 @@ export function buildFlowBlock({ store, project, cwd, matchedBy } = {}) {
|
|
|
152
152
|
};
|
|
153
153
|
}
|
|
154
154
|
|
|
155
|
+
/**
|
|
156
|
+
* P5 档 C(卡 `-210`)· **摘要版**装载块 —— 给执行 / 关联会话用(≤ 300 tokens)。
|
|
157
|
+
*
|
|
158
|
+
* 三条约束(为什么是「从 block 剪裁」而不是「另写一份」):
|
|
159
|
+
* ① **唯一真源仍是一个**:本函数只吃 `buildFlowBlock()` 的返回值(`nextStep` / `contract`),
|
|
160
|
+
* 不读库、不读 SKILL.md、不写字面量步骤 —— 八步改了这里不可能说旧话;
|
|
161
|
+
* ② **只留护栏**:执行会话不需要八步全文(完整版 ≈2–3k tokens),只需要「别把 done 写了」
|
|
162
|
+
* 「backlog→todo 是人工授权」「回填要带什么」这三类会当场报错的东西;
|
|
163
|
+
* ③ **确定性**:同样的 block ⇒ 逐字节同样的摘要(可比较、可审计)。
|
|
164
|
+
*
|
|
165
|
+
* @param {ReturnType<typeof buildFlowBlock>} block
|
|
166
|
+
* @returns {string} 摘要文本(以 `\n` 结尾,与完整版同一收尾约定)
|
|
167
|
+
*/
|
|
168
|
+
export function buildFlowSummary(block) {
|
|
169
|
+
if (!block || typeof block !== "object" || !block.nextStep) {
|
|
170
|
+
throw new Error("buildFlowSummary 需要 buildFlowBlock() 的返回值(含 nextStep),不接受裸数据");
|
|
171
|
+
}
|
|
172
|
+
const step = block.nextStep;
|
|
173
|
+
const version = block.contract?.version ?? "(未取到)";
|
|
174
|
+
return [
|
|
175
|
+
"任务看板主流程(摘要)",
|
|
176
|
+
`当前步:${step.step} · ${step.title}`,
|
|
177
|
+
"两道门:done 只能人点(GOVERNANCE_AGENT_DONE)· backlog→todo 是人工授权(EXECUTION_NOT_AUTHORIZED)",
|
|
178
|
+
"回填要带:evidence[](file/command/url/reading)+ norm_digest(norm_get \"card-update\")",
|
|
179
|
+
`契约:${version}(用旧版本会落 contract-warn)`,
|
|
180
|
+
"常见错误码:EXECUTION_NOT_ATTRIBUTED(先补归因)· CONTRACT_STALE / NORM_STALE(重取规范)· REVIEW_NOT_APPROVED(等人复核)",
|
|
181
|
+
"全文:`node scripts/tb-flow.mjs start`(与宿主注入同源)",
|
|
182
|
+
].join("\n").trimEnd() + "\n";
|
|
183
|
+
}
|
|
184
|
+
|
|
155
185
|
/** 档 B:给项目 `AGENTS.md` 用的片段(只指路,不复制正文)。 */
|
|
156
186
|
export function buildAgentsSnippet({ project, pkgPath } = {}) {
|
|
157
187
|
const pkg = pkgPath ?? PKG_ROOT;
|
package/src/mcp/server.mjs
CHANGED
|
@@ -8,7 +8,8 @@
|
|
|
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
|
|
11
|
+
* node src/mcp/server.mjs --read-only # **只读模式**(P3 的回滚开关):写件不出现在 tools/list,调用即 READ_ONLY_MODE
|
|
12
|
+
* node src/mcp/server.mjs --agent-id <id> # 0-B-b:登记进程级本地身份(缺省生成匿名 id 落盘)
|
|
12
13
|
*
|
|
13
14
|
* 传输:newline-delimited JSON-RPC 2.0(MCP stdio transport)。
|
|
14
15
|
* stdout **只允许**出现协议消息;日志一律走 stderr(否则客户端解析失败)。
|
|
@@ -37,9 +38,9 @@ const ACTIVE_TOOLS = READ_ONLY ? TOOLS.filter((t) => t.annotations?.readOnlyHint
|
|
|
37
38
|
const ACTIVE_NAMES = ACTIVE_TOOLS.map((t) => t.name);
|
|
38
39
|
|
|
39
40
|
if (has("--help") || has("-h")) {
|
|
40
|
-
process.stderr.write(`taskboard-workbench MCP server
|
|
41
|
-
用法: node src/mcp/server.mjs [--data-dir <dir>] [--print-tools] [--read-only]
|
|
42
|
-
只读: --read-only
|
|
41
|
+
process.stderr.write(`taskboard-workbench MCP server(${TOOL_NAMES.length} 个工具:只读五 / 写五 · prompt 1)
|
|
42
|
+
用法: node src/mcp/server.mjs [--data-dir <dir>] [--agent-id <id>] [--print-tools] [--read-only]
|
|
43
|
+
只读: --read-only 关闭写件(card_create / card_progress / card_evidence_submit / requirement_upsert / requirement_change)——P3 的回滚开关
|
|
43
44
|
工具: ${TOOL_NAMES.join(", ")}
|
|
44
45
|
提示: prompt taskboard.flow(= node scripts/tb-flow.mjs start 的输出)
|
|
45
46
|
数据: --data-dir > $TB_DATA_DIR > 默认(同 Web/CLI)
|
|
@@ -56,10 +57,22 @@ if (has("--print-tools")) {
|
|
|
56
57
|
|
|
57
58
|
const dataDir = argOf("--data-dir") ?? process.env.TB_DATA_DIR ?? undefined;
|
|
58
59
|
const store = openStore({ dataDir, env: process.env });
|
|
59
|
-
|
|
60
|
+
// 0-B-b(FR-108):**进程级本地身份**。`--agent-id` 显式给就复用那一行;不给就生成匿名 id 并落盘
|
|
61
|
+
// (不是"每次调用一个新 id" —— 同一进程内只有一个 id,重启才可能换)。
|
|
62
|
+
// 注意边界:`token_hash` 只是建表留接口,stdio MCP **没有鉴权通道**,这里**不宣称鉴权生效**。
|
|
63
|
+
// ⚠ `--read-only` 是**零写入**的回滚开关:只读模式下**不登记**(登记本身是一条 insert),
|
|
64
|
+
// 用一个不落库的进程内身份代替 —— 否则"只读"会变成"只读 + 悄悄写一行 agents"。
|
|
65
|
+
const agent = READ_ONLY
|
|
66
|
+
? { id: argOf("--agent-id") ?? "readonly", created: false, persisted: false }
|
|
67
|
+
: { ...store.registerAgent({
|
|
68
|
+
id: argOf("--agent-id") ?? undefined,
|
|
69
|
+
displayName: argOf("--agent-name") ?? "",
|
|
70
|
+
kind: "agent",
|
|
71
|
+
}), persisted: true };
|
|
72
|
+
const ctx = { store, agentId: agent.id };
|
|
60
73
|
let skillMeta = null;
|
|
61
74
|
try { skillMeta = readSkill().meta; } catch { /* skill 缺失时不影响工具面;prompts/* 会报出具体原因 */ }
|
|
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`);
|
|
75
|
+
process.stderr.write(`[tb-mcp] ready dataDir=${store.dataDir} readOnly=${READ_ONLY} agent=${agent.id}${agent.created ? "(new)" : ""} tools=${ACTIVE_NAMES.join(",")} prompt=taskboard.flow skill=${skillMeta ? `v${skillMeta.version}` : "missing"}\n`);
|
|
63
76
|
|
|
64
77
|
const SERVER_INFO = { name: "taskboard-workbench", version: pkg.version };
|
|
65
78
|
const DEFAULT_PROTOCOL = "2025-06-18";
|
package/src/mcp/tools.mjs
CHANGED
|
@@ -25,6 +25,8 @@ import { evaluateSubmittedContract, loadNorms, NORM_IDS, sha256 } from "../core/
|
|
|
25
25
|
import { TbError } from "../core/errors.mjs";
|
|
26
26
|
import { matchProjectForCwd } from "../core/binding.mjs";
|
|
27
27
|
import { markAcceptance, acceptanceFlag } from "../core/acceptance.mjs";
|
|
28
|
+
import { EVIDENCE_KINDS, EVIDENCE_REF_KINDS, artifactRefKindProblems } from "../core/evidence.mjs";
|
|
29
|
+
import { ticketStage } from "../core/ticket-stage.mjs";
|
|
28
30
|
|
|
29
31
|
/** 包根目录(仓库里 = 仓库根;npm 包里 = package 根)。`spec/norms` 在两处都随包存在。 */
|
|
30
32
|
export const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
|
|
@@ -211,7 +213,10 @@ export function workbenchAudit({ store }, args = {}) {
|
|
|
211
213
|
|
|
212
214
|
/* --------------------------------------------------- P3:写工具 + 条目列表 ---- */
|
|
213
215
|
|
|
214
|
-
|
|
216
|
+
// `EVIDENCE_KINDS` 现在只有一处定义(`src/core/evidence.mjs`)—— 三个入口共用,避免各写一份漂移。
|
|
217
|
+
// `card_progress` 只收**过程性证据**(command/url/reading/file);`commit` 属交付证据(`card_evidence_submit`),
|
|
218
|
+
// 从同一个枚举里派生而不是另写一份,这样新增 kind 时只改一处。
|
|
219
|
+
const PROCESS_EVIDENCE_KINDS = Object.freeze(EVIDENCE_KINDS.filter((k) => k !== "commit"));
|
|
215
220
|
/** 条目「版本」:`requirement_items` 没有 version 列 ⇒ 用**内容摘要**当乐观锁(纯读、可重算、与行数无关)。 */
|
|
216
221
|
const REQ_VERSION_FIELDS = Object.freeze(["title", "description", "acceptance", "priority", "status"]);
|
|
217
222
|
|
|
@@ -250,7 +255,7 @@ function normalizeEvidence(list) {
|
|
|
250
255
|
throw fail(
|
|
251
256
|
"EVIDENCE_REQUIRED",
|
|
252
257
|
"回填进度必须带 evidence[](非空数组),每项 {kind, ref, note?};只写「已完成」三个字不算证据",
|
|
253
|
-
{ allowedKinds:
|
|
258
|
+
{ allowedKinds: PROCESS_EVIDENCE_KINDS },
|
|
254
259
|
);
|
|
255
260
|
}
|
|
256
261
|
return list.map((raw, i) => {
|
|
@@ -258,8 +263,8 @@ function normalizeEvidence(list) {
|
|
|
258
263
|
throw fail("EVIDENCE_INVALID", `evidence[${i}] 必须是对象 {kind, ref, note?}`, { index: i });
|
|
259
264
|
}
|
|
260
265
|
const kind = String(raw.kind ?? "").trim();
|
|
261
|
-
if (!
|
|
262
|
-
throw fail("EVIDENCE_INVALID", `evidence[${i}].kind 必须是 ${
|
|
266
|
+
if (!PROCESS_EVIDENCE_KINDS.includes(kind)) {
|
|
267
|
+
throw fail("EVIDENCE_INVALID", `evidence[${i}].kind 必须是 ${PROCESS_EVIDENCE_KINDS.join(" / ")} 之一`, { index: i, received: kind, allowedKinds: EVIDENCE_KINDS });
|
|
263
268
|
}
|
|
264
269
|
const ref = String(raw.ref ?? "").trim();
|
|
265
270
|
if (ref === "") {
|
|
@@ -314,7 +319,8 @@ export function requirementUpsert({ store }, args = {}) {
|
|
|
314
319
|
const ref = refCandidate ? refCandidate.trim() : "";
|
|
315
320
|
|
|
316
321
|
if (ref !== "") {
|
|
317
|
-
|
|
322
|
+
// 卡 `-234`:MCP 这里已解析出项目 ⇒ 简写 `R170` 按本项目解析(不再因为「没写全」被判不存在)。
|
|
323
|
+
const current = store.requireRequirementItemRef(ref, { projectId: project.id });
|
|
318
324
|
if (current.projectId !== project.id) {
|
|
319
325
|
throw fail("DEPENDENCY_CROSS_PROJECT", `条目属于别的项目:${ref}(${current.projectId})`, { requirement: ref, requirementProject: current.projectId, project: project.id });
|
|
320
326
|
}
|
|
@@ -361,7 +367,7 @@ export function requirementChange({ store }, args = {}) {
|
|
|
361
367
|
const { project } = resolveProject(store, args);
|
|
362
368
|
const ref = [args.requirement, args.id].find((x) => typeof x === "string" && x.trim() !== "");
|
|
363
369
|
if (!ref) throw fail("USAGE_ERROR", "requirement_change 需要 requirement(条目编号或 id)", {});
|
|
364
|
-
const item = store.requireRequirementItemRef(ref.trim());
|
|
370
|
+
const item = store.requireRequirementItemRef(ref.trim(), { projectId: project.id }); // 卡 `-234`:简写按本项目解析
|
|
365
371
|
if (item.projectId !== project.id) {
|
|
366
372
|
throw fail("DEPENDENCY_CROSS_PROJECT", `条目属于别的项目:${ref}(${item.projectId})`, { requirement: ref, requirementProject: item.projectId, project: project.id });
|
|
367
373
|
}
|
|
@@ -585,6 +591,59 @@ export function cardProgress({ store }, args = {}) {
|
|
|
585
591
|
};
|
|
586
592
|
}
|
|
587
593
|
|
|
594
|
+
/* ---------------- card_evidence_submit(写 · 交付证据 · FR-106 / 0-B-b) ---------------- */
|
|
595
|
+
|
|
596
|
+
/**
|
|
597
|
+
* 交付证据写入口(MCP 侧)。与 HTTP `POST /api/tasks/:ref/evidence` **同源**。
|
|
598
|
+
*
|
|
599
|
+
* 刻意**不接受**「只给 `evidence[]`」的调用形态:`store.addTaskEvidence` 的四字段硬门会整笔拒,
|
|
600
|
+
* 工具一上线就是死的。要写过程性证据(command / url / reading)请走 `card_progress`;
|
|
601
|
+
* 这里只写**交付证据**(verdict / deviation / boundary / artifacts)。
|
|
602
|
+
*/
|
|
603
|
+
export function cardEvidenceSubmit({ store, agentId }, args = {}) {
|
|
604
|
+
const ref = [args.card, args.ref, args.task]
|
|
605
|
+
.find((x) => typeof x === "string" && x.trim() !== "")?.trim() ?? "";
|
|
606
|
+
if (ref === "") throw fail("USAGE_ERROR", "card_evidence_submit 需要 card(任务编号或 id)", {});
|
|
607
|
+
const task = store.requireTaskRef(ref);
|
|
608
|
+
|
|
609
|
+
const submittedRefs = args.artifact_refs ?? args.artifactRefs;
|
|
610
|
+
const badKinds = artifactRefKindProblems(submittedRefs);
|
|
611
|
+
if (badKinds.length) {
|
|
612
|
+
throw fail("INVALID_ARTIFACT_REF", `artifact_refs 只接受 ${EVIDENCE_REF_KINDS.join(" / ")}(非法项:第 ${badKinds.map((b) => b.index + 1).join("、")} 项)`, { problems: badKinds });
|
|
613
|
+
}
|
|
614
|
+
|
|
615
|
+
const evidence = store.addTaskEvidence(task.identifier, {
|
|
616
|
+
verdict: args.verdict,
|
|
617
|
+
deviation: args.deviation,
|
|
618
|
+
boundary: args.boundary,
|
|
619
|
+
artifacts: args.artifacts,
|
|
620
|
+
artifactRefs: submittedRefs,
|
|
621
|
+
// 身份不是自报:默认取**进程身份**(`--agent-id`),显式 `actor_id` 只在测试里用。
|
|
622
|
+
actor: args.actor_id ?? agentId ?? "agent",
|
|
623
|
+
});
|
|
624
|
+
|
|
625
|
+
const after = store.requireTaskRef(task.identifier);
|
|
626
|
+
return {
|
|
627
|
+
card: {
|
|
628
|
+
identifier: after.identifier,
|
|
629
|
+
status: after.status,
|
|
630
|
+
version: after.version,
|
|
631
|
+
requirementId: after.requirementId ?? null,
|
|
632
|
+
},
|
|
633
|
+
evidence: {
|
|
634
|
+
id: evidence.id,
|
|
635
|
+
deduped: Boolean(evidence.deduped),
|
|
636
|
+
refsState: evidence.refsState,
|
|
637
|
+
evidenceHash: evidence.evidenceHash ?? null,
|
|
638
|
+
actor: evidence.actor,
|
|
639
|
+
artifacts: evidence.artifacts,
|
|
640
|
+
artifactRefs: evidence.artifactRefs,
|
|
641
|
+
},
|
|
642
|
+
ticketStage: ticketStage(after, { evidence, comments: store.listComments(after.id) }),
|
|
643
|
+
contract: contractReadout(store, task.projectId, args.contract),
|
|
644
|
+
};
|
|
645
|
+
}
|
|
646
|
+
|
|
588
647
|
/* ------------------------------------------------------------------ 注册表 ---- */
|
|
589
648
|
|
|
590
649
|
const ok = (schema) => schema;
|
|
@@ -732,6 +791,39 @@ export const TOOLS = Object.freeze([
|
|
|
732
791
|
annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
|
|
733
792
|
handler: cardCreate,
|
|
734
793
|
},
|
|
794
|
+
{
|
|
795
|
+
name: "card_evidence_submit",
|
|
796
|
+
description: "提交交付证据(写)。四字段**必填**:verdict / deviation / boundary / artifacts(缺一 ⇒ EVIDENCE_INCOMPLETE,零落库)。artifact_refs 只接受 commit / file(其余 ⇒ INVALID_ARTIFACT_REF)。同指纹重复提交幂等(返回首次结果、不增行)。与 HTTP POST /api/tasks/:ref/evidence 同源。",
|
|
797
|
+
inputSchema: ok({
|
|
798
|
+
type: "object",
|
|
799
|
+
required: ["card", "verdict", "deviation", "boundary", "artifacts"],
|
|
800
|
+
properties: {
|
|
801
|
+
card: { type: "string", description: "任务编号或 id" },
|
|
802
|
+
verdict: { type: "string", description: "判定(做了什么、结论是什么)" },
|
|
803
|
+
deviation: { type: "string", description: "偏离说明(没按原计划做的部分都写这里;不写=隐藏信息)" },
|
|
804
|
+
boundary: { type: "string", description: "边界自查(未取得/无法判定的读数必须明说)" },
|
|
805
|
+
artifacts: { type: "array", items: { type: "string" }, description: "产物路径 / 命令 / 指纹(非空)" },
|
|
806
|
+
artifact_refs: {
|
|
807
|
+
type: "array",
|
|
808
|
+
items: {
|
|
809
|
+
type: "object",
|
|
810
|
+
properties: {
|
|
811
|
+
kind: { type: "string", enum: [...EVIDENCE_REF_KINDS] },
|
|
812
|
+
ref: { type: "string" },
|
|
813
|
+
note: { type: "string" },
|
|
814
|
+
},
|
|
815
|
+
required: ["kind", "ref"],
|
|
816
|
+
additionalProperties: false,
|
|
817
|
+
},
|
|
818
|
+
description: "需要核验的产物引用(仅 commit / file)",
|
|
819
|
+
},
|
|
820
|
+
contract: { type: "object", description: "调用方用的契约(warn 档:只留痕不阻断)" },
|
|
821
|
+
},
|
|
822
|
+
additionalProperties: false,
|
|
823
|
+
}),
|
|
824
|
+
annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
|
|
825
|
+
handler: cardEvidenceSubmit,
|
|
826
|
+
},
|
|
735
827
|
{
|
|
736
828
|
name: "card_progress",
|
|
737
829
|
description: "回填进度(写)。**证据必填**(evidence[] 非空,每项 {kind:file|command|url|reading, ref, note?})+ **norm_digest 必填**(card-update 规范的 sha256)。状态走执行侧门:done 只能人点。",
|
|
@@ -746,7 +838,7 @@ export const TOOLS = Object.freeze([
|
|
|
746
838
|
items: {
|
|
747
839
|
type: "object",
|
|
748
840
|
properties: {
|
|
749
|
-
kind: { type: "string", enum: [
|
|
841
|
+
kind: { type: "string", enum: [...PROCESS_EVIDENCE_KINDS] },
|
|
750
842
|
ref: { type: "string" },
|
|
751
843
|
note: { type: "string" },
|
|
752
844
|
},
|