taskboard-workbench 0.2.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 +321 -0
- package/README.md +95 -0
- package/package.json +20 -6
- package/scripts/tb-flow.mjs +86 -0
- package/skills/taskboard-flow/SKILL.md +89 -0
- package/skills/taskboard-flow/references/errors.md +61 -0
- package/skills/taskboard-flow/references/injection.md +76 -0
- package/skills/taskboard-flow/references/steps/S0.md +31 -0
- package/skills/taskboard-flow/references/steps/S1.md +28 -0
- package/skills/taskboard-flow/references/steps/S2.md +31 -0
- package/skills/taskboard-flow/references/steps/S3.md +22 -0
- package/skills/taskboard-flow/references/steps/S4.md +25 -0
- package/skills/taskboard-flow/references/steps/S5.md +36 -0
- package/skills/taskboard-flow/references/steps/S6.md +30 -0
- package/skills/taskboard-flow/references/steps/S7.md +23 -0
- package/spec/norms/acceptance.md +36 -0
- package/spec/norms/card-update.md +39 -0
- package/spec/norms/doc-editing.md +30 -0
- package/spec/norms/flow.md +45 -0
- package/spec/norms/manifest.json +41 -0
- package/spec/norms/project-defaults.md +33 -0
- package/src/core/acceptance.mjs +62 -0
- package/src/core/contract.mjs +287 -0
- package/src/core/errors.mjs +3 -0
- package/src/core/evidence.mjs +86 -0
- package/src/core/intake.mjs +87 -24
- package/src/core/requirements.mjs +31 -1
- package/src/core/store.mjs +376 -6
- package/src/core/ticket-stage.mjs +162 -0
- package/src/mcp/flow-block.mjs +173 -0
- package/src/mcp/server.mjs +175 -0
- package/src/mcp/tools.mjs +769 -0
- package/src/server/api.mjs +128 -30
- package/src/server/server.mjs +3 -0
- package/web/app.js +162 -34
- package/web/tokens.css +12 -0
package/src/server/api.mjs
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
* api.mjs —— 纯路由逻辑(不依赖 node:http)。独立服务与 DSH 宿主插件共用。
|
|
3
3
|
*/
|
|
4
4
|
import { PRIORITIES, STATUSES } from "../core/domain.mjs";
|
|
5
|
+
import { clampElaborateLimit } from "../core/requirements.mjs";
|
|
5
6
|
import { EXIT, TbError, invalidField } from "../core/errors.mjs";
|
|
6
7
|
import { resolveContext } from "../core/binding.mjs";
|
|
7
8
|
import { scanProjectMaterials, buildMaterialIndex, collectExternalFiles } from "../core/intake.mjs";
|
|
@@ -10,6 +11,7 @@ import { buildTeamDirective } from "../host/team-engine.mjs";
|
|
|
10
11
|
import { runExecutionLoop, activeEngine } from "../core/loop.mjs";
|
|
11
12
|
import { assertTeamTemplate, assertQualityGates, planTeamMembers } from "../core/team.mjs";
|
|
12
13
|
import { assessTaskRef, projectWatchdog } from "../core/watchdog.mjs";
|
|
14
|
+
import { ticketStage } from "../core/ticket-stage.mjs";
|
|
13
15
|
import { isHumanReviewTask, planHumanReview } from "../core/human-review.mjs";
|
|
14
16
|
import { deriveNextStep } from "../core/next-step.mjs";
|
|
15
17
|
/**
|
|
@@ -36,6 +38,8 @@ import { DIAGNOSTIC_KINDS, evaluateTaskDiagnostics, projectDiagnostics, summariz
|
|
|
36
38
|
import { summarizeNotifyDelivery } from "../core/notify.mjs";
|
|
37
39
|
import { resolveCliExecutor, executeTaskWithCli, buildTaskPrompt, cliArgsFor, claimForCliExecution, DEFAULT_TIMEOUT_MS } from "../core/executor.mjs";
|
|
38
40
|
import { DEFAULT_FAILURE_LIMIT } from "../core/store.mjs";
|
|
41
|
+
// 卡 `-177`(2026-10-29 · 口径 X):acceptance 缺省口径与 MCP **共用同一份**,不在本文件另写判断。
|
|
42
|
+
import { markAcceptance, acceptanceFlag } from "../core/acceptance.mjs";
|
|
39
43
|
|
|
40
44
|
export const API_SCHEMA_VERSION = 2;
|
|
41
45
|
|
|
@@ -287,32 +291,26 @@ export function createApiRouter({ store, aiElaborator, events } = {}) {
|
|
|
287
291
|
if (body.dryRun) {
|
|
288
292
|
return { status: 200, payload: { project: project.id, root: combined.root, scanned: combined.count, truncated: combined.truncated, files: combined.files.map((f) => ({ relPath: f.relPath, bytes: f.bytes, readable: f.readable, external: !!f.external })), dryRun: true } };
|
|
289
293
|
}
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
if (existing.has(d.title)) continue;
|
|
301
|
-
const item = store.createRequirementItem({
|
|
302
|
-
projectId: project.id, title: d.title, docId: doc?.id,
|
|
303
|
-
description: `来源:\`${d.relPath}\`\n\n${d.content.slice(0, 2000)}`,
|
|
304
|
-
source: "intake", status: body.status ?? "draft",
|
|
305
|
-
});
|
|
306
|
-
existing.add(d.title);
|
|
307
|
-
created.push({ identifier: item.identifier, title: item.title });
|
|
294
|
+
// FR-57(2026-10-29 修订 · A 方案):**引入只建资料索引,不产生需求条目**。
|
|
295
|
+
// 条目只由三条正路产生:人工新建 / elaborate 候选确认 / MCP requirement_upsert。
|
|
296
|
+
// 旧 `items` / `both` 一律**显式拒绝**(不静默降级成 doc-only)——「那条路根本不存在」要在契约层成立,
|
|
297
|
+
// 而不是「前端不点它就没事」。未知 mode 同样收紧为用法错误(仓内无调用方传未知值,见
|
|
298
|
+
// 进度/2026-10-29-intake口径A-FR条款修订草案.md §8.3)。
|
|
299
|
+
const mode = body.mode ?? "doc";
|
|
300
|
+
if (mode !== "doc") {
|
|
301
|
+
if (mode === "items" || mode === "both") {
|
|
302
|
+
throw new TbError("INTAKE_ITEMS_DISABLED",
|
|
303
|
+
"资料引入只生成索引、不产生需求条目;条目请走人工新建 / elaborate 候选确认 / MCP requirement_upsert。历史 source=intake 条目仍可查询、筛选、关闭、删除。");
|
|
308
304
|
}
|
|
305
|
+
throw new TbError("USAGE_ERROR", `未知 mode:${mode}(intake 仅支持 "doc")`);
|
|
309
306
|
}
|
|
307
|
+
const ensured = store.ensureRequirementDoc(project.id, { body: "" });
|
|
308
|
+
const doc = store.updateRequirementDoc(ensured.id, { expectedVersion: ensured.version, body: built.index });
|
|
310
309
|
return {
|
|
311
310
|
status: 201,
|
|
312
311
|
payload: {
|
|
313
312
|
project: project.id, root: combined.root, scanned: combined.count, truncated: combined.truncated, mode,
|
|
314
|
-
doc:
|
|
315
|
-
itemsCreated: created.length, items: created,
|
|
313
|
+
doc: { id: doc.id, version: doc.version, bytes: built.index.length },
|
|
316
314
|
},
|
|
317
315
|
};
|
|
318
316
|
}
|
|
@@ -590,6 +588,8 @@ export function createApiRouter({ store, aiElaborator, events } = {}) {
|
|
|
590
588
|
// 中间任何失败都留一张无归因卡(2026-10-28 修 69 张,其中 56 张来源已不可考)。
|
|
591
589
|
requirementId: body.requirementId ?? body.requirement,
|
|
592
590
|
unattributedReason: body.unattributedReason,
|
|
591
|
+
// P1.5:契约校验在**内核**(store)里做,门面只负责把调用方的契约原样带下去。
|
|
592
|
+
contract: body.contract,
|
|
593
593
|
});
|
|
594
594
|
// 未归因时必须**可见**:返回体带 `attribution.warning`(CLI 侧走 stderr,Web 侧画黄条)。
|
|
595
595
|
// 不写成错误是因为严格拒绝要等 P3(见 store.mjs 的 strictAttribution 注释)。
|
|
@@ -626,11 +626,45 @@ export function createApiRouter({ store, aiElaborator, events } = {}) {
|
|
|
626
626
|
// FR-90:详情里直接带上「评审证据包」(自动复核结论 + 最近一条进展评论),
|
|
627
627
|
// 评审人打开抽屉即可看到机器结论,而不是只看到两个按钮。
|
|
628
628
|
const comments = store.listComments(task.id);
|
|
629
|
-
|
|
629
|
+
// FR-108(卡 `-198` → 卡 `-199`):详情带**阶段推导单一口径**(`ticketStage`,0-A1 的纯函数)。
|
|
630
|
+
// 只读附加字段:不改任何既有字段语义,也不写库。
|
|
631
|
+
// · `decision` 先给 null —— `decision_log` 表属 0-C(FR-109),建表后在这里读行传进来即可;
|
|
632
|
+
// · `diagnostics` **真实求值但零写**(卡 `-199`):抽屉的「下一步 / 看护 / 诊断」三块现在只消费
|
|
633
|
+
// 这一份 `ticketStage`,不再各自去打 `/next-step` 与 `/execution`(那里一次请求算一次、还会落库)。
|
|
634
|
+
// 所以这里必须把诊断算出来,否则诊断块会因为"没人再算"而永远空着。
|
|
635
|
+
// `persist:false` 保住本端点的既有不变量「详情 GET 不得有写副作用」;计数字段从**已落库行**补回
|
|
636
|
+
// (否则界面上永远显示"第 1 次",把复发次数这条信息抹掉)。
|
|
637
|
+
const evidence = typeof store.latestTaskEvidence === "function" ? store.latestTaskEvidence(task.identifier) : null;
|
|
638
|
+
let sessionState = null;
|
|
639
|
+
try { sessionState = store.taskSessionState(task); } catch { sessionState = null; }
|
|
640
|
+
let currentRun = null;
|
|
641
|
+
try { currentRun = typeof store.getCurrentRun === "function" ? store.getCurrentRun(task) : null; } catch { currentRun = null; }
|
|
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 });
|
|
662
|
+
return { status: 200, payload: { task, comments, reviewEvidence: buildReviewEvidence({ comments }), ticketStage: stage } };
|
|
630
663
|
}
|
|
631
664
|
if (method === "PATCH") {
|
|
632
665
|
const task = store.updateTask(ref, {
|
|
633
666
|
expectedVersion: body.version ?? body.expectedVersion,
|
|
667
|
+
contract: body.contract,
|
|
634
668
|
title: body.title,
|
|
635
669
|
description: body.description,
|
|
636
670
|
acceptance: body.acceptance,
|
|
@@ -699,23 +733,56 @@ export function createApiRouter({ store, aiElaborator, events } = {}) {
|
|
|
699
733
|
const ref = decodeURIComponent(reqElaborateRoute[1]);
|
|
700
734
|
const doc = store.getRequirementDocById(ref) ?? store.getRequirementDoc(ref);
|
|
701
735
|
if (!doc) throw new TbError("REQUIREMENT_DOC_NOT_FOUND", `需求文档不存在:${ref}`, { ref });
|
|
736
|
+
// ── 条目化契约(卡 `-169` P4② · 2026-10-29 口径变更) ───────────────────────
|
|
737
|
+
// 旧口径(已废):`auto` 在 AI 不可用时**静默跑规则并落库**,只加一个 `degraded:true` 标注。
|
|
738
|
+
// 真机后果:一份「资料索引」文档一次落 100 条 pending 候选,其中 0 条真需求。
|
|
739
|
+
// 新口径:
|
|
740
|
+
// · `mode:"auto"` ≈ **只用 AI**;AI 不可用/失败 ⇒ **拒绝**(`AI_UNAVAILABLE`,**零落库**);
|
|
741
|
+
// · 要规则降级必须**显式** `fallback:"rule"`(旧行为整体退到这条分支,语义不变);
|
|
742
|
+
// · `mode:"rule"` 支持 `dryRun:true` ⇒ 只回预览、零落库(规则模式不再「一点就写」);
|
|
743
|
+
// · `limit` 从 body 透传,默认 20、硬顶 200(旧默认 100 且 body 不生效)。
|
|
702
744
|
const mode = body.mode ?? "auto";
|
|
703
|
-
|
|
745
|
+
if (mode !== "auto" && mode !== "ai" && mode !== "rule") {
|
|
746
|
+
throw new TbError("USAGE_ERROR", `elaborate mode 必须是 auto/ai/rule,收到:${mode}`);
|
|
747
|
+
}
|
|
748
|
+
const fallback = body.fallback;
|
|
749
|
+
if (fallback !== undefined && fallback !== "rule") {
|
|
750
|
+
throw new TbError("USAGE_ERROR", `elaborate fallback 只能是 rule(显式规则降级),收到:${fallback}`);
|
|
751
|
+
}
|
|
752
|
+
const dryRun = body.dryRun === true;
|
|
753
|
+
if (dryRun && mode !== "rule") {
|
|
754
|
+
throw new TbError("USAGE_ERROR", `dryRun 仅适用于 mode:"rule"(AI 产出量由模型决定,没有"预演"意义),收到 mode:${mode}`);
|
|
755
|
+
}
|
|
756
|
+
const limit = clampElaborateLimit(body.limit);
|
|
757
|
+
const runRule = () => ({ ...store.elaborateRequirementDoc(doc.id, { limit, dryRun }), mode: "rule" });
|
|
704
758
|
const runAi = async () => {
|
|
705
|
-
if (typeof aiElaborator !== "function")
|
|
706
|
-
|
|
759
|
+
if (typeof aiElaborator !== "function") {
|
|
760
|
+
throw new TbError("AI_UNAVAILABLE", `AI 条目化不可用(当前环境未提供 LLM 直连):改传 mode:"rule" 或 {mode:"auto",fallback:"rule"} 走规则拆解;规则模式 limit 默认 20 条`);
|
|
761
|
+
}
|
|
762
|
+
let candidates;
|
|
763
|
+
try {
|
|
764
|
+
candidates = await aiElaborator(doc);
|
|
765
|
+
} catch (error) {
|
|
766
|
+
// AI 自己的失败也统一成可判定的错误码,不再被"降级"吞掉(除非人显式要 fallback)
|
|
767
|
+
if (error instanceof TbError) throw error;
|
|
768
|
+
// 上游已带机器可读 code(如 `AI_OUTPUT_INVALID`)时**保留它** —— 排障要能区分
|
|
769
|
+
// 「没有 AI」与「AI 回了没法解析的东西」;压成同一个码等于丢掉线索。
|
|
770
|
+
const code = typeof error?.code === "string" && error.code ? error.code : "AI_UNAVAILABLE";
|
|
771
|
+
throw new TbError(code, `AI 条目化失败:${error?.message ?? error}(本次未落库)`);
|
|
772
|
+
}
|
|
707
773
|
return { ...store.addRequirementCandidates(doc.id, candidates, { source: "elaborated-ai" }), mode: "ai" };
|
|
708
774
|
};
|
|
709
|
-
if (mode === "rule") return { status: 201, payload: runRule() };
|
|
775
|
+
if (mode === "rule") return { status: dryRun ? 200 : 201, payload: runRule() };
|
|
710
776
|
if (mode === "ai") return { status: 201, payload: await runAi() };
|
|
711
|
-
|
|
777
|
+
// mode === "auto"
|
|
778
|
+
if (fallback !== "rule") return { status: 201, payload: await runAi() };
|
|
779
|
+
// 显式 fallback:"rule" ⇒ 保留旧行为:先试 AI,失败则规则降级并标注 degraded
|
|
712
780
|
if (typeof aiElaborator === "function") {
|
|
713
781
|
try { return { status: 201, payload: await runAi() }; }
|
|
714
782
|
catch (error) {
|
|
715
783
|
return { status: 201, payload: { ...runRule(), degraded: true, aiError: error?.code ?? String(error?.message ?? error) } };
|
|
716
784
|
}
|
|
717
785
|
}
|
|
718
|
-
// B-1:无 AI 时显式标注降级,避免用户误以为用了 AI
|
|
719
786
|
return { status: 201, payload: { ...runRule(), degraded: true, aiError: "AI_UNAVAILABLE" } };
|
|
720
787
|
}
|
|
721
788
|
|
|
@@ -733,8 +800,15 @@ export function createApiRouter({ store, aiElaborator, events } = {}) {
|
|
|
733
800
|
const item = store.createRequirementItem({
|
|
734
801
|
projectId: body.projectId, title: body.title, description: body.description,
|
|
735
802
|
acceptance: body.acceptance, priority: body.priority, docId: body.docId,
|
|
803
|
+
contract: body.contract,
|
|
736
804
|
});
|
|
737
|
-
|
|
805
|
+
// 卡 `-177`(口径 X):人工建条目缺省验收 ⇒ **显式缺口**(回包 `acceptanceSet:false` + `governance_audit`)。
|
|
806
|
+
// 此前只回 `{ item }`,「没给验收」与「给了空串」在调用方眼里都是 201 成功 —— 与 MCP 侧同一个沉默。
|
|
807
|
+
const acc = markAcceptance(store, {
|
|
808
|
+
identifier: item.identifier, acceptance: item.acceptance,
|
|
809
|
+
actor: body.actor ?? "human", entry: "http:POST /api/requirements/items",
|
|
810
|
+
});
|
|
811
|
+
return { status: 201, payload: { item, acceptanceSet: acc.acceptanceSet } };
|
|
738
812
|
}
|
|
739
813
|
throw new TbError("USAGE_ERROR", "/api/requirements/items 仅支持 GET 或 POST");
|
|
740
814
|
}
|
|
@@ -751,12 +825,22 @@ export function createApiRouter({ store, aiElaborator, events } = {}) {
|
|
|
751
825
|
const item = store.updateRequirementItem(ref, {
|
|
752
826
|
status: body.status, title: body.title, description: body.description,
|
|
753
827
|
acceptance: body.acceptance, priority: body.priority, docId: body.docId,
|
|
828
|
+
contract: body.contract,
|
|
754
829
|
});
|
|
830
|
+
// 卡 `-177`:与 MCP 同一边界 —— `acceptanceSet` 永远反映写入后状态;
|
|
831
|
+
// **只有本次 body 真带 `acceptance` 才落审计**(否则 99/129 空验收条目每改一次标题就添一行审计)。
|
|
755
832
|
// 需求终态(done/closed)落审计:谁在什么时候把哪条需求收口的(自动只给建议,终态由人定)。
|
|
756
833
|
if (body.status === "done" || body.status === "closed" || item.status === "done" || item.status === "closed") {
|
|
757
834
|
try { store.recordAudit({ actor: body.actor ?? "human", action: "requirement-status", target: item.identifier, allowed: true, reason: String(body.status ?? item.status), detail: body.reason ?? null }); } catch { /* ignore */ }
|
|
758
835
|
}
|
|
759
|
-
|
|
836
|
+
const acc = body.acceptance !== undefined
|
|
837
|
+
? markAcceptance(store, {
|
|
838
|
+
identifier: item.identifier, acceptance: item.acceptance,
|
|
839
|
+
actor: body.actor ?? "human", entry: "http:PATCH /api/requirements/items/:ref",
|
|
840
|
+
detail: { changed: Object.keys(body).filter((k) => k !== "actor") },
|
|
841
|
+
})
|
|
842
|
+
: acceptanceFlag(item.acceptance);
|
|
843
|
+
return { status: 200, payload: { item, acceptanceSet: acc.acceptanceSet } };
|
|
760
844
|
}
|
|
761
845
|
if (method === "DELETE") {
|
|
762
846
|
return { status: 200, payload: store.deleteRequirementItem(ref) };
|
|
@@ -1477,7 +1561,7 @@ export function createApiRouter({ store, aiElaborator, events } = {}) {
|
|
|
1477
1561
|
if (taskCommentsRoute) {
|
|
1478
1562
|
const ref = decodeURIComponent(taskCommentsRoute[1]);
|
|
1479
1563
|
if (method === "GET") { const task = store.requireTaskRef(ref); return { status: 200, payload: { comments: store.listComments(task.id) } }; }
|
|
1480
|
-
if (method === "POST") { const task = store.requireTaskRef(ref); const c = store.addComment(task.id, { body: body.body ?? body.comment ?? "" }); emit("task.updated", { taskId: task.id, identifier: task.identifier, status: task.status }); return { status: 201, payload: { comment: c } }; }
|
|
1564
|
+
if (method === "POST") { const task = store.requireTaskRef(ref); const c = store.addComment(task.id, { body: body.body ?? body.comment ?? "", contract: body.contract }); emit("task.updated", { taskId: task.id, identifier: task.identifier, status: task.status }); return { status: 201, payload: { comment: c } }; }
|
|
1481
1565
|
throw new TbError("USAGE_ERROR", "comments 仅支持 GET 或 POST");
|
|
1482
1566
|
}
|
|
1483
1567
|
// FR-17:编辑一条评论(PATCH)。口径见 store.updateComment —— 乐观锁(冲突 → VERSION_CONFLICT/409)
|
|
@@ -1741,6 +1825,20 @@ export function createApiRouter({ store, aiElaborator, events } = {}) {
|
|
|
1741
1825
|
},
|
|
1742
1826
|
};
|
|
1743
1827
|
}
|
|
1828
|
+
// ---------------- 契约快照(P1 · 方案 §6.4 / §8) ----------------
|
|
1829
|
+
// 只读投影:`contractVersion = f(需求文档 digest, spec/norms digest×版本, 门配置)`。
|
|
1830
|
+
// GET 不写库(重算即可);POST …/recheck 才落基线 —— 这样「看一眼契约」永远无副作用。
|
|
1831
|
+
const projectContractRoute = /^\/api\/projects\/([^/]+)\/contract(?:\/(recheck))?$/.exec(pathname);
|
|
1832
|
+
if (projectContractRoute) {
|
|
1833
|
+
const projectId = decodeURIComponent(projectContractRoute[1]);
|
|
1834
|
+
const isRecheck = Boolean(projectContractRoute[2]);
|
|
1835
|
+
if (isRecheck && method !== "POST") throw new TbError("USAGE_ERROR", "contract/recheck 仅支持 POST");
|
|
1836
|
+
if (!isRecheck && method !== "GET") throw new TbError("USAGE_ERROR", "contract 仅支持 GET(重算基线用 POST …/contract/recheck)");
|
|
1837
|
+
const result = isRecheck
|
|
1838
|
+
? store.refreshProjectContract(projectId, { reason: body.reason ?? null })
|
|
1839
|
+
: store.contractSnapshot(projectId);
|
|
1840
|
+
return { status: 200, payload: result };
|
|
1841
|
+
}
|
|
1744
1842
|
// ---------------- 项目推进清单(2026-10-28 · 拍板 E1/E3) ----------------
|
|
1745
1843
|
// E1:**纯投影**,不落表;同状态重复请求字节级一致(不含 now/minutes)。
|
|
1746
1844
|
const projectAdvanceRoute = /^\/api\/projects\/([^/]+)\/advance$/.exec(pathname);
|
package/src/server/server.mjs
CHANGED
|
@@ -177,6 +177,9 @@ export function startServer({ dataDir, port, host = "127.0.0.1", env = process.e
|
|
|
177
177
|
server.listen(resolvedPort, host, () => {
|
|
178
178
|
const address = server.address();
|
|
179
179
|
console.log(`[tb] listening on http://${host}:${address.port}${basePath}/`);
|
|
180
|
+
// 2026-10-29:把「本实例没有宿主通道」在**启动那一刻**就说清,而不是等用户点投递才撞墙。
|
|
181
|
+
// 独立进程里没有 DSH 的 ctx.sessions ⇒ /api/health 的 host.capabilities 恒为 null。
|
|
182
|
+
console.log("[tb] mode=standalone · 无 DSH 宿主会话通道(投递/建会话/派发团队不可用;需要这些能力请用 DSH 内的 /integrations/taskboard-workbench)");
|
|
180
183
|
console.log(`[tb] dataDir=${store.dataDir}`);
|
|
181
184
|
console.log(`[tb] db=${store.dbPath}`);
|
|
182
185
|
console.log(`[tb] projects=${ensured.projects.length}${ensured.created ? " (auto-created default project)" : ""}`);
|
package/web/app.js
CHANGED
|
@@ -717,7 +717,11 @@
|
|
|
717
717
|
const drawerHeadMain = mk("div");
|
|
718
718
|
const drawerTitle = mk("h2", null, "");
|
|
719
719
|
const drawerId = mk("div", "tb-drawer-id", "");
|
|
720
|
-
|
|
720
|
+
// FR-108(卡 `-198`):交付阶段徽标 —— 服务端 `ticketStage` 的单一口径,只读展示。
|
|
721
|
+
// `stale` 单独给警示样式:判定过期时**不许**看起来像"可以确认"。
|
|
722
|
+
const drawerStage = mk("span", "tb-stage-badge", "");
|
|
723
|
+
drawerStage.hidden = true;
|
|
724
|
+
drawerHeadMain.append(drawerId, drawerStage, drawerTitle);
|
|
721
725
|
const drawerClose = mk("button", "ghost", "✕");
|
|
722
726
|
drawerClose.type = "button";
|
|
723
727
|
drawerClose.title = "关闭";
|
|
@@ -2313,9 +2317,11 @@
|
|
|
2313
2317
|
let detailTask = null;
|
|
2314
2318
|
// 真机 2026-10-23(用户报障「评审通过点击后…有两个完成按钮」):抽屉渲染会被**并发**触发 ——
|
|
2315
2319
|
// 评审/授权成功后处理器里的 `reopen()`、SSE `task.updated` 回流、60s 看护轮询、回到页签自愈,
|
|
2316
|
-
//
|
|
2317
|
-
//
|
|
2320
|
+
// 任两条撞在一起就有两代渲染同时在跑。当时「下一步」区块是**唯一在额外的 await(`GET …/next-step`)
|
|
2321
|
+
// 之后才追加**的区块 ⇒ 先完成的那一代把自己的 `<section>` 插进了后一代的 body,该区块于是出现两次
|
|
2318
2322
|
// (按钮自然也就成了两个)。处置=渲染代次:每代自增序号,await 回来发现已被更新的一代取代即退出。
|
|
2323
|
+
// 卡 `-199` 之后取数已收敛为一次 `Promise.all`(不再单独 await `/next-step`),代次守卫仍保留:
|
|
2324
|
+
// 它同时兜住「用户连点两张卡」这类**已知**并发,而幂等兜底(见「下一步」区块)兜住未知的。
|
|
2319
2325
|
let detailRenderSeq = 0;
|
|
2320
2326
|
const setView = (next) => {
|
|
2321
2327
|
view = next;
|
|
@@ -2539,13 +2545,12 @@
|
|
|
2539
2545
|
try { await api("POST", "/api/requirements/items", { projectId: state.projectId, title }); showBanner("已新建需求条目", "info"); await renderConfig(); }
|
|
2540
2546
|
catch (e) { showBanner(`新建失败:${e.message}`, "error"); }
|
|
2541
2547
|
})));
|
|
2542
|
-
req.appendChild(row("AI 拆解(auto
|
|
2548
|
+
req.appendChild(row("AI 拆解(auto · 不可用即报错)", btn("拆解", async () => {
|
|
2543
2549
|
try {
|
|
2544
2550
|
const docs = await api("GET", `/api/requirements/docs?project=${encodeURIComponent(state.projectId)}`);
|
|
2545
2551
|
const doc = docs.docs[0];
|
|
2546
2552
|
if (!doc) { showBanner("请先新建/编辑需求文档", "error"); return; }
|
|
2547
|
-
|
|
2548
|
-
showBanner(`拆解:mode=${r.mode}${r.degraded ? "(降级:" + (r.aiError ?? "无AI") + ")" : ""} 候选=${r.candidates ? r.candidates.length : 0}${r.totalFound && r.totalFound > (r.candidates ? r.candidates.length : 0) ? `(共 ${r.totalFound},已截断)` : ""}`, r.degraded ? "error" : "info");
|
|
2553
|
+
await runElaborateAi(doc, { render: false });
|
|
2549
2554
|
} catch (e) { showBanner(`拆解失败:${e.message}`, "error"); }
|
|
2550
2555
|
})));
|
|
2551
2556
|
|
|
@@ -2669,10 +2674,11 @@
|
|
|
2669
2674
|
init.appendChild(alignBox);
|
|
2670
2675
|
void refreshAlign();
|
|
2671
2676
|
|
|
2672
|
-
init.appendChild(row("引入项目资料(md/doc)", btn("
|
|
2677
|
+
init.appendChild(row("引入项目资料(md/doc)", btn("引入资料(仅索引)", async () => {
|
|
2673
2678
|
try {
|
|
2674
|
-
|
|
2675
|
-
|
|
2679
|
+
// FR-57(2026-10-29 A):引入**只写资料索引**,不产生需求条目 —— 文案必须说清副作用。
|
|
2680
|
+
const r = await api("POST", `/api/projects/${encodeURIComponent(state.projectId)}/intake`, { mode: "doc" });
|
|
2681
|
+
showBanner(`已同步资料索引:扫描 ${r.scanned} 个文档,需求文档 v${r.doc?.version ?? "?"}(${r.doc?.bytes ?? 0} 字节);本次不生成需求条目`, "info");
|
|
2676
2682
|
await renderConfig();
|
|
2677
2683
|
} catch (e) { showBanner(`引入失败:${e.message}`, "error"); }
|
|
2678
2684
|
}, "primary")));
|
|
@@ -2902,6 +2908,9 @@
|
|
|
2902
2908
|
// ------------------------------------------------------------ 需求视图(文档 + 条目 + 详情)
|
|
2903
2909
|
const reqState = {
|
|
2904
2910
|
docId: null, itemId: null, editingDoc: false, candidates: [], filter: "all", q: "", selected: new Set(),
|
|
2911
|
+
// 卡 `-169` P4②(2026-10-29):规则拆解的**预览态**(零落库)。非 null 时文档面板里渲染
|
|
2912
|
+
// 一块「预览 + 确认写入 / 取消」——规则模式不再「一点就写 100 条」。
|
|
2913
|
+
rulePreview: null,
|
|
2905
2914
|
// 卡 `-160` 收尾(2026-10-27):列表内「完成度结论」的懒取缓存 —— identifier → { at, payload }。
|
|
2906
2915
|
// `completionInflight` 去重在途请求(同一行不重复打),`focusCompletion` 是「点胶囊 ⇒ 抽屉滚到完成度段」的一次性定位标记。
|
|
2907
2916
|
completion: new Map(), completionInflight: new Set(), focusCompletion: false,
|
|
@@ -3095,6 +3104,76 @@
|
|
|
3095
3104
|
await Promise.all(Array.from({ length: Math.min(REQ_COMPLETION_CONCURRENCY, queue.length) }, () => worker()));
|
|
3096
3105
|
}
|
|
3097
3106
|
|
|
3107
|
+
// ── 需求条目化:三个入口统一走这里(卡 `-169` P4② · 2026-10-29 口径变更)────────────
|
|
3108
|
+
// 服务端新契约:`auto` 只用 AI,AI 不可用 ⇒ `AI_UNAVAILABLE` + **零落库**;
|
|
3109
|
+
// 规则降级必须显式 `fallback:"rule"`;规则模式支持 `dryRun` 预览。
|
|
3110
|
+
// 前端因此必须做两件事:① 把 `AI_UNAVAILABLE` 说成人话(不再"假装成功");
|
|
3111
|
+
// ② 规则拆解**先预览再二次确认**(`window.confirm` 在 IAB 里会被自动拒绝 ⇒ 一律用页面内按钮,
|
|
3112
|
+
// 见 06 §E3 —— 用原生弹窗会变成"点了没反应")。
|
|
3113
|
+
const elaborateUrl = (doc) => `/api/requirements/docs/${encodeURIComponent(doc.id)}/elaborate`;
|
|
3114
|
+
const elaborateSummary = (r) => {
|
|
3115
|
+
const n = (r.candidates ?? []).length;
|
|
3116
|
+
const trunc = r.totalFound != null && r.totalFound > n ? `(共 ${r.totalFound},本次写 ${n})` : "";
|
|
3117
|
+
const deg = r.degraded ? `(规则降级:${r.aiError ?? "无AI"})` : "";
|
|
3118
|
+
return `拆解:mode=${r.mode}${deg} 候选=${n}${trunc}`;
|
|
3119
|
+
};
|
|
3120
|
+
async function runElaborateAi(doc, { render = true } = {}) {
|
|
3121
|
+
try {
|
|
3122
|
+
const r = await api("POST", elaborateUrl(doc), { mode: "auto" });
|
|
3123
|
+
reqState.candidates = r.candidates ?? [];
|
|
3124
|
+
showBanner(elaborateSummary(r), "info");
|
|
3125
|
+
if (render) await renderRequirements();
|
|
3126
|
+
} catch (e) {
|
|
3127
|
+
if (e && e.code === "AI_UNAVAILABLE") {
|
|
3128
|
+
showBanner(`AI 拆解不可用:${e.message}。这次没有任何落库;要规则拆解请点「规则拆解(先预览)」。`, "error");
|
|
3129
|
+
} else {
|
|
3130
|
+
showBanner(`拆解失败:${e.message}`, "error");
|
|
3131
|
+
}
|
|
3132
|
+
}
|
|
3133
|
+
}
|
|
3134
|
+
async function startElaborateRulePreview(doc) {
|
|
3135
|
+
try {
|
|
3136
|
+
const pre = await api("POST", elaborateUrl(doc), { mode: "rule", dryRun: true });
|
|
3137
|
+
reqState.rulePreview = { ...pre, docId: doc.id };
|
|
3138
|
+
await renderRequirements();
|
|
3139
|
+
} catch (e) { showBanner(`规则拆解预览失败:${e.message}`, "error"); }
|
|
3140
|
+
}
|
|
3141
|
+
async function commitElaborateRule(doc) {
|
|
3142
|
+
const pv = reqState.rulePreview;
|
|
3143
|
+
try {
|
|
3144
|
+
const r = await api("POST", elaborateUrl(doc), { mode: "rule", limit: pv?.limit });
|
|
3145
|
+
reqState.candidates = r.candidates ?? [];
|
|
3146
|
+
reqState.rulePreview = null;
|
|
3147
|
+
showBanner(elaborateSummary(r), "info");
|
|
3148
|
+
await renderRequirements();
|
|
3149
|
+
} catch (e) { showBanner(`规则拆解失败:${e.message}`, "error"); }
|
|
3150
|
+
}
|
|
3151
|
+
/** 预览块:把「会写多少条 / 规则会把文件清单行也当需求 / 前 10 条长什么样」摆在人眼前。 */
|
|
3152
|
+
function appendElaborateRulePreview(host, doc) {
|
|
3153
|
+
const pv = reqState.rulePreview;
|
|
3154
|
+
if (!pv || pv.docId !== doc.id) return;
|
|
3155
|
+
const box = mk("div", "req-warn");
|
|
3156
|
+
box.appendChild(mk("div", null,
|
|
3157
|
+
`⚠ 规则拆解预览(未落库):共找到 ${pv.totalFound} 条`
|
|
3158
|
+
+ (pv.truncated ? `,本次最多写 ${pv.limit} 条(已截断)` : `,将全部写为候选(${pv.limit} 条以内)`)));
|
|
3159
|
+
box.appendChild(mk("div", null,
|
|
3160
|
+
"⚠ 规则拆解会把「文件清单行」也当需求 —— 一份资料索引类文档曾产出 4213 条、其中 0 条是真需求。请先扫一眼下面这些标题。"));
|
|
3161
|
+
if ((pv.preview ?? []).length) {
|
|
3162
|
+
const ol = mk("ol", "req-rule-preview");
|
|
3163
|
+
for (const c of pv.preview) ol.appendChild(mk("li", null, c.title));
|
|
3164
|
+
box.appendChild(ol);
|
|
3165
|
+
} else {
|
|
3166
|
+
box.appendChild(mk("div", null, "(这份文档没解析出任何候选 —— 点「取消」即可)"));
|
|
3167
|
+
}
|
|
3168
|
+
const bar = mk("div", "btn-row");
|
|
3169
|
+
bar.append(
|
|
3170
|
+
btn(`确认写入 ${pv.truncated ? pv.limit + " 条" : "全部候选"}`, () => void commitElaborateRule(doc), "primary"),
|
|
3171
|
+
btn("取消", () => { reqState.rulePreview = null; void renderRequirements(); }),
|
|
3172
|
+
);
|
|
3173
|
+
box.appendChild(bar);
|
|
3174
|
+
host.appendChild(box);
|
|
3175
|
+
}
|
|
3176
|
+
|
|
3098
3177
|
async function renderRequirements() {
|
|
3099
3178
|
reqRoot.replaceChildren(mk("p", "hint", "加载需求…"));
|
|
3100
3179
|
try {
|
|
@@ -3136,10 +3215,9 @@
|
|
|
3136
3215
|
catch (e) { showBanner(`保存失败:${e.message}`, "error"); }
|
|
3137
3216
|
}, "primary"),
|
|
3138
3217
|
btn("取消", () => { reqState.editingDoc = false; void renderRequirements(); }),
|
|
3139
|
-
btn("AI 拆解",
|
|
3140
|
-
|
|
3141
|
-
|
|
3142
|
-
}),
|
|
3218
|
+
btn("AI 拆解", () => void runElaborateAi(doc)),
|
|
3219
|
+
// 编辑态下正文未保存:规则拆解基于**已保存**正文,直接切走会让人以为用的是眼前这段 ⇒ 明确拒绝
|
|
3220
|
+
btn("规则拆解(先预览)", () => showBanner("请先「保存」或「取消」编辑,再用规则拆解(它读的是已保存的正文)", "error")),
|
|
3143
3221
|
);
|
|
3144
3222
|
docBody.append(ta, bar);
|
|
3145
3223
|
} else {
|
|
@@ -3192,12 +3270,11 @@
|
|
|
3192
3270
|
const bar = mk("div", "btn-row");
|
|
3193
3271
|
bar.append(
|
|
3194
3272
|
btn("编辑", () => { reqState.editingDoc = true; void renderRequirements(); }, "primary"),
|
|
3195
|
-
btn("AI 拆解(auto)",
|
|
3196
|
-
|
|
3197
|
-
catch (e) { showBanner(`拆解失败:${e.message}`, "error"); }
|
|
3198
|
-
}),
|
|
3273
|
+
btn("AI 拆解(auto)", () => void runElaborateAi(doc)),
|
|
3274
|
+
btn("规则拆解(先预览)", () => void startElaborateRulePreview(doc)),
|
|
3199
3275
|
);
|
|
3200
3276
|
docBody.appendChild(bar);
|
|
3277
|
+
appendElaborateRulePreview(docBody, doc);
|
|
3201
3278
|
}
|
|
3202
3279
|
|
|
3203
3280
|
// —— 条目面板(新建 + 筛选 + 确认/删除;FR-64/65 便于人工查阅确认)
|
|
@@ -3352,7 +3429,7 @@
|
|
|
3352
3429
|
li.dataset.status = it.status;
|
|
3353
3430
|
const statusTxt = reqStatusLabel(it.status);
|
|
3354
3431
|
li.title = `状态:${statusTxt}`;
|
|
3355
|
-
const srcLabel = it.source === "intake" ? "资料索引" : it.source === "elaborated-ai" ? "AI" : it.source === "elaborated-rule" ? "规则" : "手工";
|
|
3432
|
+
const srcLabel = it.source === "intake" ? "资料索引" : it.source === "elaborated-ai" ? "AI" : it.source === "elaborated-rule" ? "规则" : it.source === "mcp" ? "MCP" : "手工";
|
|
3356
3433
|
const main = mk("div", "req-item-main");
|
|
3357
3434
|
const cb = mk("input"); cb.type = "checkbox"; cb.checked = reqState.selected.has(it.identifier); cb.title = "选择";
|
|
3358
3435
|
cb.addEventListener("click", (e) => { e.stopPropagation(); if (cb.checked) reqState.selected.add(it.identifier); else reqState.selected.delete(it.identifier); void renderRequirements(); });
|
|
@@ -3506,7 +3583,7 @@
|
|
|
3506
3583
|
head.appendChild(mk("p", "req-meta", item.identifier));
|
|
3507
3584
|
head.appendChild(mk("h2", null, item.title));
|
|
3508
3585
|
host.appendChild(head);
|
|
3509
|
-
const srcLabel = item.source === "intake" ? "资料索引(引入)" : item.source === "elaborated-ai" ? "AI 拆解" : item.source === "elaborated-rule" ? "规则拆解" : "手工";
|
|
3586
|
+
const srcLabel = item.source === "intake" ? "资料索引(引入)" : item.source === "elaborated-ai" ? "AI 拆解" : item.source === "elaborated-rule" ? "规则拆解" : item.source === "mcp" ? "MCP" : "手工";
|
|
3510
3587
|
const statusTxt = reqStatusLabel(item.status);
|
|
3511
3588
|
const dl = mk("dl", "req-fields");
|
|
3512
3589
|
const addF = (k, v, cls) => { dl.appendChild(mk("dt", null, k)); const dd = mk("dd", null, v); if (cls) dd.className = cls; dl.appendChild(dd); };
|
|
@@ -3828,11 +3905,35 @@
|
|
|
3828
3905
|
showBanner(`派发失败(${identifier}):${error.message}${error.code ? `(${error.code})` : ""}`, "error");
|
|
3829
3906
|
}
|
|
3830
3907
|
}
|
|
3908
|
+
/**
|
|
3909
|
+
* FR-108(卡 `-198`):交付阶段徽标的**唯一**渲染点。
|
|
3910
|
+
* 文案只描述"交付物到哪一步",不替代"下一步点哪里"(那是 `next` 的活)。
|
|
3911
|
+
* `stale` 必须显式告警 —— 判定绑定的证据/版本已经变了,人看到的不是被确认的那一版。
|
|
3912
|
+
*/
|
|
3913
|
+
function renderStageBadge(stageInfo) {
|
|
3914
|
+
const stage = stageInfo?.stage ?? null;
|
|
3915
|
+
const LABELS = {
|
|
3916
|
+
format_ok: "交付物格式合格(未判)",
|
|
3917
|
+
ready: "交付物已判可收",
|
|
3918
|
+
stale: "证据/版本已变,判定作废",
|
|
3919
|
+
refs_unresolved: "产物引用解不开",
|
|
3920
|
+
};
|
|
3921
|
+
const label = LABELS[stage] ?? null;
|
|
3922
|
+
if (!label) { drawerStage.hidden = true; drawerStage.textContent = ""; drawerStage.removeAttribute("data-stage"); return; }
|
|
3923
|
+
drawerStage.hidden = false;
|
|
3924
|
+
drawerStage.textContent = label;
|
|
3925
|
+
drawerStage.dataset.stage = stage;
|
|
3926
|
+
drawerStage.title = stageInfo?.reason ? `${label}:${stageInfo.reason}` : label;
|
|
3927
|
+
}
|
|
3928
|
+
|
|
3831
3929
|
async function openTaskDetail(task) {
|
|
3832
3930
|
const renderSeq = ++detailRenderSeq; // 本代编号(并发渲染时只有最新一代允许落地)
|
|
3833
3931
|
detailTask = task;
|
|
3834
3932
|
drawerId.textContent = task.identifier;
|
|
3835
3933
|
drawerTitle.textContent = task.title;
|
|
3934
|
+
drawerStage.hidden = true;
|
|
3935
|
+
drawerStage.textContent = "";
|
|
3936
|
+
drawerStage.removeAttribute("data-stage");
|
|
3836
3937
|
drawerActions.replaceChildren(); // 换卡先清空标题栏动作区,避免上一张卡的按钮残留
|
|
3837
3938
|
drawerBody.replaceChildren(mk("p", "hint", "加载详情…"));
|
|
3838
3939
|
drawerBackdrop.classList.add("show");
|
|
@@ -3850,6 +3951,7 @@
|
|
|
3850
3951
|
api("GET", `/api/requirements/items?project=${encodeURIComponent(task.projectId)}`).catch(() => ({ items: [] })),
|
|
3851
3952
|
]);
|
|
3852
3953
|
if (renderSeq !== detailRenderSeq) return; // 取数期间已被更新的一代取代 ⇒ 本次渲染作废
|
|
3954
|
+
renderStageBadge(detail.ticketStage ?? null);
|
|
3853
3955
|
const t = detail.task ?? task;
|
|
3854
3956
|
// 需求条目 id → 可读「identifier · title」。真机报障(2026-10-22):概览只打裸 UUID,
|
|
3855
3957
|
// 用户「不知道这个关联的是哪个需求」—— 归属成了没人看得懂的字段。
|
|
@@ -4593,9 +4695,10 @@
|
|
|
4593
4695
|
cliSec.appendChild(cliBar);
|
|
4594
4696
|
drawerBody.appendChild(cliSec);
|
|
4595
4697
|
|
|
4596
|
-
// 诊断与恢复动作(FR-79):结构化诊断(类型 / 严重度 / 说明 /
|
|
4597
|
-
//
|
|
4598
|
-
|
|
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 : [];
|
|
4599
4702
|
if (diagList.length > 0) {
|
|
4600
4703
|
const SEV_LABEL = { high: "高危", medium: "中等", low: "提示" };
|
|
4601
4704
|
const dsec = mk("div", "drawer-section");
|
|
@@ -4731,7 +4834,9 @@
|
|
|
4731
4834
|
}
|
|
4732
4835
|
|
|
4733
4836
|
// 执行看护(FR-75 停滞 / FR-76 "下一步建议"跟进)
|
|
4734
|
-
|
|
4837
|
+
// 卡 `-199`:改读 `ticketStage.watch`(与「下一步」「诊断」同源)。`watch` 是 `assessTask()` 的完整回包,
|
|
4838
|
+
// `followups / reason` 都在里面 —— 「派生为子任务 / 忽略」和「执行会话未在线」文案不会因此丢掉。
|
|
4839
|
+
const watch = detail?.ticketStage?.watch ?? null;
|
|
4735
4840
|
if (watch && (watch.state === "stalled" || watch.state === "awaiting-decision")) {
|
|
4736
4841
|
const wsec = mk("div", "drawer-section");
|
|
4737
4842
|
wsec.appendChild(mk("h3", null, "执行看护"));
|
|
@@ -4870,7 +4975,8 @@
|
|
|
4870
4975
|
// 「下一步」引导(真机反馈 2026-10-22:「详情界面没有下一步该做啥的提示,也没有操作按钮」)。
|
|
4871
4976
|
// 缺口实质:按钮此前按**功能分类**散落在「评审 / 操作 / 人工校验」各区块,没有一处回答
|
|
4872
4977
|
// "我现在该干嘛";被人工校验门挡住的卡只有一行文字,连跳过去下结论的入口都没有。
|
|
4873
|
-
// 口径唯一来源=服务端 `
|
|
4978
|
+
// 口径唯一来源=服务端 `ticketStage.next`(`ticketStage()` 内部调 `deriveNextStep()`,纯函数 + 单测;
|
|
4979
|
+
// 卡 `-199` 起随 `GET /api/tasks/:ref` 一并返回,不再单独请求 `/next-step`)。
|
|
4874
4980
|
// 这里只把 action id 映射成按钮与处理器 —— 不在前端重写一遍判断,避免两份口径。
|
|
4875
4981
|
{
|
|
4876
4982
|
const scrollToSection = (keyword) => {
|
|
@@ -4948,20 +5054,42 @@
|
|
|
4948
5054
|
} catch (e) { showBanner(`转调试失败:${e.message}`, "error"); }
|
|
4949
5055
|
},
|
|
4950
5056
|
};
|
|
4951
|
-
|
|
4952
|
-
|
|
4953
|
-
//
|
|
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`),本段是同步构建;代次判断保留作为并发兜底。
|
|
4954
5077
|
if (renderSeq !== detailRenderSeq) return;
|
|
4955
|
-
//
|
|
5078
|
+
// 引导拿不到不阻断抽屉(老服务/回包缺字段时照旧能看到其它区块);但不静默 —— 留一行说明。
|
|
4956
5079
|
// FR-89(真机反馈 2026-10-22):「收口了为何还有这么多校验/评审/执行会话按钮」「异常时既可评审又可检验、无从下手」。
|
|
4957
5080
|
// 处置 = 只做**呈现层默认折叠**(内容与按钮一个不删,点标题即可展开),并把人手动开过的区块排除在外。
|
|
4958
5081
|
const isClosed = t.status === "done" || t.status === "canceled";
|
|
4959
|
-
const foldedTitles = step ? applyFocusPolicy(step.focus) : [];
|
|
5082
|
+
const foldedTitles = step && !nextShapeMissing ? applyFocusPolicy(step.focus) : [];
|
|
4960
5083
|
syncExpandAllLabel();
|
|
4961
5084
|
const sec = mk("div", "drawer-section next-step");
|
|
4962
5085
|
sec.appendChild(mk("h3", null, "下一步"));
|
|
4963
|
-
if (!step) {
|
|
4964
|
-
|
|
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`(旧版服务端)——重载插件后生效。当前请按下方各区块自行判断。"));
|
|
4965
5093
|
} else {
|
|
4966
5094
|
sec.appendChild(mk("div", "next-step-title", step.title));
|
|
4967
5095
|
if (step.hint) sec.appendChild(mk("p", "hint", step.hint));
|
|
@@ -5006,9 +5134,9 @@
|
|
|
5006
5134
|
sec.appendChild(moreBar);
|
|
5007
5135
|
}
|
|
5008
5136
|
}
|
|
5009
|
-
// 幂等兜底(2026-10-23 ·
|
|
5010
|
-
//
|
|
5011
|
-
//
|
|
5137
|
+
// 幂等兜底(2026-10-23 · 用户批注「两个完成按钮」的第二道防线):代次守卫已挡住已知的并发路径。
|
|
5138
|
+
// 卡 `-199` 起本区块不再单独 await(数据来自 `Promise.all` 取回的 `ticketStage`),
|
|
5139
|
+
// 但**保留**这条输出不变量:一旦将来又冒出新的并发入口绕过守卫,症状仍旧是「两个完成按钮」。
|
|
5012
5140
|
for (const staleNextStep of Array.from(drawerBody.querySelectorAll(".drawer-section.next-step"))) staleNextStep.remove();
|
|
5013
5141
|
drawerBody.insertBefore(sec, drawerBody.firstChild); // 放最前:先回答"该干嘛",再看明细
|
|
5014
5142
|
}
|