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/web/app.js
CHANGED
|
@@ -537,7 +537,7 @@
|
|
|
537
537
|
// FR-28:会话内**默认按本会话收敛**(档位=`session:<本会话标识>`,可用「全部」一键切回);
|
|
538
538
|
// 拿不到 sessionId(非会话作用域入口)时保持「全部」,并由工具栏明写降级文案(见 NO_SESSION_NOTICE)。
|
|
539
539
|
const defaultSessionScope = sessionId ? `${SESSION_SCOPE_CURRENT_PREFIX}${sessionId}` : "";
|
|
540
|
-
const state = { statuses: [], priorities: [], projects: [], tasks: [], projectId: "", priority: "", label: "", sessionScope: defaultSessionScope, session: sessionId, keyword: "", loop: {}, host: null, binding: { projectId: null, bound: true, mainSessionId: null, association: null }, showArchived: false, collapsedSections: [], touchedSections: [], emptyState: null, dragTask: null, dragEl: null };
|
|
540
|
+
const state = { statuses: [], priorities: [], projects: [], tasks: [], projectId: "", priority: "", label: "", sessionScope: defaultSessionScope, session: sessionId, keyword: "", loop: {}, host: null, instanceRole: "writer", leaseOwner: null, dataDir: "", dataDirHint: null, binding: { projectId: null, bound: true, mainSessionId: null, association: null }, showArchived: false, collapsedSections: [], touchedSections: [], emptyState: null, dragTask: null, dragEl: null };
|
|
541
541
|
let editing = null;
|
|
542
542
|
let destroyed = false;
|
|
543
543
|
|
|
@@ -683,6 +683,24 @@
|
|
|
683
683
|
const hostNotice = mk("div", "banner warn");
|
|
684
684
|
hostNotice.hidden = true;
|
|
685
685
|
hostNotice.setAttribute("role", "status");
|
|
686
|
+
/**
|
|
687
|
+
* 卡 `-236` / `-237`(需求 `R173`)· **只读跟随者**常驻条。
|
|
688
|
+
*
|
|
689
|
+
* 真机 2026-11-10:dsh web 与 dsh desktop 同时打开同一个库时,同一时刻只允许一个实例写
|
|
690
|
+
* (租约在库里,见 `src/core/instance-lease.mjs`)。后起的那个窗口**能看不能写**,
|
|
691
|
+
* 但它如果什么都不说,用户点「新建任务」只会收到一条 409 —— 不如在顶上直接讲清楚
|
|
692
|
+
* 「谁在写、要写去哪里、对端退出后会自己接管」。
|
|
693
|
+
* 与一次性 `banner` 分开:这条是**状态**,要一直留到角色变化为止。
|
|
694
|
+
*/
|
|
695
|
+
const followerNotice = mk("div", "banner warn");
|
|
696
|
+
followerNotice.hidden = true;
|
|
697
|
+
followerNotice.setAttribute("role", "status");
|
|
698
|
+
// 卡 `-222`(需求 `R163` ①):**可降级步骤**失败时的常驻条 —— 「面板能用,但这几项没读到」。
|
|
699
|
+
// 与一次性 `banner` 分开:条里要**留住原因**并带「重试」按钮;banner 到时会自动消失。
|
|
700
|
+
// 复用 `.empty-guide` 既有排版(只在 tokens.css 补一条宽度收敛,不新增取数通道)。
|
|
701
|
+
const bootStrip = mk("div", "empty-guide tb-boot-strip");
|
|
702
|
+
bootStrip.hidden = true;
|
|
703
|
+
bootStrip.setAttribute("role", "status");
|
|
686
704
|
const boardScroll = mk("main", "board-scroll");
|
|
687
705
|
const board = mk("div", "board");
|
|
688
706
|
board.setAttribute("aria-label", "任务看板(按状态分列)");
|
|
@@ -709,6 +727,10 @@
|
|
|
709
727
|
const advanceRoot = mk("div", "advance-view");
|
|
710
728
|
advanceScroll.appendChild(advanceRoot);
|
|
711
729
|
shell.append(header, toolbar, banner, connNotice, hostNotice, boardScroll, reqScroll, teamScroll, configScroll, gateScroll, advanceScroll);
|
|
730
|
+
// 卡 `-222`:常驻条挂在「能力提示」与各视图之间(单独插,不改上面那条已被 FR-20 守卫钉住的挂载行)。
|
|
731
|
+
try { shell.insertBefore(bootStrip, boardScroll); } catch { /* ignore */ }
|
|
732
|
+
// 卡 `-236`/`-237`:只读跟随者条同样单独插,挂载行不动。
|
|
733
|
+
try { shell.insertBefore(followerNotice, boardScroll); } catch { /* ignore */ }
|
|
712
734
|
|
|
713
735
|
// 任务详情抽屉(含"归属团队 / 执行会话"关联)
|
|
714
736
|
const drawerBackdrop = mk("div", "tb-drawer-backdrop");
|
|
@@ -722,7 +744,7 @@
|
|
|
722
744
|
const drawerStage = mk("span", "tb-stage-badge", "");
|
|
723
745
|
drawerStage.hidden = true;
|
|
724
746
|
drawerHeadMain.append(drawerId, drawerStage, drawerTitle);
|
|
725
|
-
const drawerClose = mk("button", "ghost", "✕");
|
|
747
|
+
const drawerClose = mk("button", "ghost icon", "✕");
|
|
726
748
|
drawerClose.type = "button";
|
|
727
749
|
drawerClose.title = "关闭";
|
|
728
750
|
// FR-87 修订(2026-10-19):抽屉头加「全部收起 / 全部展开」与「全屏 / 还原」两个动作。
|
|
@@ -734,8 +756,16 @@
|
|
|
734
756
|
drawerFull.title = "抽屉铺满窗口(再点一下还原为按视口分级的默认宽度)";
|
|
735
757
|
// 2026-10-23(用户真机批注):整卡动作区上移到标题栏 —— 与「全部收起 / 还原 / ✕」同一排;
|
|
736
758
|
// 卡片级操作(编辑 / 移动列 / 启动执行 / 拆解…)不再沉在正文最底部的「操作」区块里。
|
|
759
|
+
// 卡 `-224`(需求 `R164`):标题栏拆**两段** —— `.tb-drawer-actions` 只放卡片级动作
|
|
760
|
+
// (编辑 / 上一列 / 下一列 / 处置指针),`.tb-drawer-utils` 只放工具(全部收起 / 全屏 / ✕)。
|
|
761
|
+
// 原先这七个按钮一起 append,位置由**插入顺序**决定:动作一多就把工具挤向左边,高频与低频混在一排
|
|
762
|
+
// (真机批注「常用按钮位置和按钮样式不统一」)。现在顺序写死:动作区 → 分隔线 → 工具组,
|
|
763
|
+
// 工具组内部永远是 收起 → 全屏 → 关闭;两块之间由 CSS 画一条发丝线,不再靠"谁先 append"表达分区。
|
|
737
764
|
const drawerActions = mk("div", "tb-drawer-actions");
|
|
738
|
-
|
|
765
|
+
const drawerUtils = mk("div", "tb-drawer-utils");
|
|
766
|
+
const drawerSep = mk("div", "tb-drawer-sep");
|
|
767
|
+
drawerUtils.append(drawerExpandAll, drawerFull, drawerClose);
|
|
768
|
+
drawerHead.append(drawerHeadMain, mk("div", "spacer"), drawerActions, drawerSep, drawerUtils);
|
|
739
769
|
const drawerResize = mk("div", "tb-drawer-resize");
|
|
740
770
|
drawerResize.title = "拖动调整抽屉宽度(双击还原)";
|
|
741
771
|
const drawerBody = mk("div", "tb-drawer-body");
|
|
@@ -830,6 +860,32 @@
|
|
|
830
860
|
const allCollapsed = sections.length > 0 && sections.every((section) => section.classList.contains("collapsed"));
|
|
831
861
|
drawerExpandAll.textContent = allCollapsed ? "全部展开" : "全部收起";
|
|
832
862
|
};
|
|
863
|
+
/**
|
|
864
|
+
* 卡 `-224`(需求 `R164`):**全抽屉至多一个 primary**。
|
|
865
|
+
*
|
|
866
|
+
* 真机批注:「常用按钮位置和按钮样式不统一」。实证:未归因卡的抽屉里同时出现 3 个蓝按钮
|
|
867
|
+
* (头部「去归因」/「下一步」区「去归因」/「归因」区「关联需求条目」),各处置区又各配一个
|
|
868
|
+
* primary ⇒ 一屏 5–7 个同权重蓝块,人无法一眼看出"现在该点哪个"。
|
|
869
|
+
*
|
|
870
|
+
* 口径(只做**呈现**,不删按钮、不改回调、不改服务端 `next-step` 的 kind):
|
|
871
|
+
* · 「下一步」区的 primary 优先保留 —— 它是唯一回答"该干嘛"的地方;
|
|
872
|
+
* · 其它区块的 primary 降为 `secondary`(照样可点,只是不再抢主色);
|
|
873
|
+
* · 只换 class 与补 title,不动 disabled / onclick。
|
|
874
|
+
* 幂等:没有多余 primary 时什么都不做(重复渲染/手动展开区块都安全)。
|
|
875
|
+
*/
|
|
876
|
+
const normalizeActionTiers = () => {
|
|
877
|
+
const primaries = Array.from(drawerBody.querySelectorAll("button.primary"));
|
|
878
|
+
if (primaries.length <= 1) return;
|
|
879
|
+
const sectionOf = (b) => (typeof b.closest === "function" ? b.closest(".drawer-section") : null);
|
|
880
|
+
const keep = primaries.find((b) => sectionOf(b)?.classList.contains("next-step")) ?? primaries[0];
|
|
881
|
+
for (const b of primaries) {
|
|
882
|
+
if (b === keep) continue;
|
|
883
|
+
b.classList.remove("primary");
|
|
884
|
+
b.classList.add("secondary");
|
|
885
|
+
const why = "全抽屉只保留一个主按钮(在「下一步」区)";
|
|
886
|
+
b.title = b.title ? `${b.title}(${why})` : why;
|
|
887
|
+
}
|
|
888
|
+
};
|
|
833
889
|
const setSectionCollapsed = (section, collapsed) => {
|
|
834
890
|
const key = String(section.querySelector(":scope > h3")?.textContent ?? "");
|
|
835
891
|
section.classList.toggle("collapsed", collapsed);
|
|
@@ -952,6 +1008,110 @@
|
|
|
952
1008
|
shell.appendChild(dialog);
|
|
953
1009
|
root.replaceChildren(shell);
|
|
954
1010
|
|
|
1011
|
+
/**
|
|
1012
|
+
* 宿主内嵌环境(Electron / 受限 webview)**不实现浏览器原生 prompt()** —— 调用即抛
|
|
1013
|
+
* `prompt() is not supported`,于是「新建项目」这类入口从可用变成直接报错。这里用**页面内原生
|
|
1014
|
+
* `<dialog>` 表单**替代,样式复用既有 `dialog` / `.field` / `.dialog-actions`(与「新建任务」
|
|
1015
|
+
* 对话框同一套),不引入第二套弹窗体系,也不引入前端框架。
|
|
1016
|
+
*
|
|
1017
|
+
* 契约:返回 `{ [name]: string }`;`取消 / Esc / 点遮罩` 一律 resolve(`null`) ——
|
|
1018
|
+
* 调用方**先判 null 再发请求** ⇒ 取消路径零副作用(不产生半截项目、不写事件流)。
|
|
1019
|
+
* 必填校验在本地做(不依赖原生 `required` 的冒泡提示,宿主里的呈现不可控):
|
|
1020
|
+
* 留空则改写提示文案并聚焦,**不关闭对话框、不提交**。
|
|
1021
|
+
*/
|
|
1022
|
+
function askFields({ title, hint = "", fields = [], submit = "确定" }) {
|
|
1023
|
+
return new Promise((resolve) => {
|
|
1024
|
+
const d = mk("dialog");
|
|
1025
|
+
const form = mk("form");
|
|
1026
|
+
form.method = "dialog";
|
|
1027
|
+
d.appendChild(mk("h2", null, title));
|
|
1028
|
+
const controls = new Map();
|
|
1029
|
+
fields.forEach((spec, index) => {
|
|
1030
|
+
const wrap = mk("div", "field");
|
|
1031
|
+
const id = `tb-ask-${index}-${Math.random().toString(36).slice(2, 8)}`;
|
|
1032
|
+
const label = mk("label", null, spec.label ?? spec.name);
|
|
1033
|
+
label.htmlFor = id;
|
|
1034
|
+
const control = spec.multiline ? mk("textarea") : mk("input");
|
|
1035
|
+
if (spec.multiline) control.rows = spec.rows ?? 3;
|
|
1036
|
+
else control.type = "text";
|
|
1037
|
+
control.id = id;
|
|
1038
|
+
control.value = spec.value ?? "";
|
|
1039
|
+
control.placeholder = spec.placeholder ?? "";
|
|
1040
|
+
controls.set(spec.name, { control, spec });
|
|
1041
|
+
wrap.append(label, control);
|
|
1042
|
+
form.appendChild(wrap);
|
|
1043
|
+
});
|
|
1044
|
+
const hintEl = mk("p", "hint", hint);
|
|
1045
|
+
form.appendChild(hintEl);
|
|
1046
|
+
const actions = mk("div", "dialog-actions");
|
|
1047
|
+
const cancel = mk("button", "ghost", "取消");
|
|
1048
|
+
cancel.type = "button";
|
|
1049
|
+
const ok = mk("button", "primary", submit);
|
|
1050
|
+
ok.type = "submit";
|
|
1051
|
+
actions.append(cancel, ok);
|
|
1052
|
+
form.appendChild(actions);
|
|
1053
|
+
d.appendChild(form);
|
|
1054
|
+
shell.appendChild(d);
|
|
1055
|
+
let settled = false;
|
|
1056
|
+
const finish = (value) => {
|
|
1057
|
+
if (settled) return;
|
|
1058
|
+
settled = true;
|
|
1059
|
+
if (d.open) d.close();
|
|
1060
|
+
d.remove();
|
|
1061
|
+
resolve(value);
|
|
1062
|
+
};
|
|
1063
|
+
cancel.addEventListener("click", () => finish(null));
|
|
1064
|
+
// Esc:`cancel` 事件在关闭前触发,拦下并走同一条「取消」路径(保证只 resolve 一次)。
|
|
1065
|
+
d.addEventListener("cancel", (event) => { event.preventDefault(); finish(null); });
|
|
1066
|
+
// 点遮罩=取消;点内容不算。按坐标判断,避免把对话框内边距上的点击也当成取消。
|
|
1067
|
+
d.addEventListener("click", (event) => {
|
|
1068
|
+
if (event.target !== d) return;
|
|
1069
|
+
const r = d.getBoundingClientRect();
|
|
1070
|
+
const inside = event.clientX >= r.left && event.clientX <= r.right && event.clientY >= r.top && event.clientY <= r.bottom;
|
|
1071
|
+
if (!inside) finish(null);
|
|
1072
|
+
});
|
|
1073
|
+
/** 收集 + 必填校验。**两条入口共用**:提交按钮的 click 与表单 submit(回车)——
|
|
1074
|
+
* 只挂 submit 会赌「宿主一定派发 submit 事件」,赌输的表现是对话框关不掉也交不出去(Promise 永久挂起)。 */
|
|
1075
|
+
const collect = () => {
|
|
1076
|
+
const out = {};
|
|
1077
|
+
for (const [name, entry] of controls) {
|
|
1078
|
+
const value = String(entry.control.value ?? "");
|
|
1079
|
+
if (entry.spec.required && !value.trim()) {
|
|
1080
|
+
hintEl.textContent = entry.spec.requiredMessage ?? `请填写「${entry.spec.label ?? entry.spec.name}」`;
|
|
1081
|
+
entry.control.focus();
|
|
1082
|
+
return;
|
|
1083
|
+
}
|
|
1084
|
+
out[name] = value;
|
|
1085
|
+
}
|
|
1086
|
+
finish(out);
|
|
1087
|
+
};
|
|
1088
|
+
form.addEventListener("submit", (event) => { event.preventDefault(); collect(); });
|
|
1089
|
+
// click 先于 submit 触发;`finish` 有 settled 守卫,双触发只会生效一次。
|
|
1090
|
+
ok.addEventListener("click", (event) => { event.preventDefault(); collect(); });
|
|
1091
|
+
d.showModal();
|
|
1092
|
+
const first = controls.values().next().value;
|
|
1093
|
+
if (first) first.control.focus();
|
|
1094
|
+
});
|
|
1095
|
+
}
|
|
1096
|
+
|
|
1097
|
+
/**
|
|
1098
|
+
* 新建项目的字段表(会话绑定门 / 工具栏共用一份)—— 两个入口各自拼文案必然漂移。
|
|
1099
|
+
* 返回 `{ name, workspacePath }`(工作目录留空 ⇒ `null`);取消 ⇒ `null`(一个请求都不发)。
|
|
1100
|
+
*/
|
|
1101
|
+
async function askNewProject() {
|
|
1102
|
+
const input = await askFields({
|
|
1103
|
+
title: "新建项目",
|
|
1104
|
+
hint: "项目 id 由名称生成;工作目录可留空(留空=不绑定目录)。",
|
|
1105
|
+
submit: "创建",
|
|
1106
|
+
fields: [
|
|
1107
|
+
{ name: "name", label: "项目名称 *", placeholder: "例如:水电站集控 · 测试台", required: true, requiredMessage: "项目名称不能为空(项目 id 由它生成)" },
|
|
1108
|
+
{ name: "workspacePath", label: "项目工作目录(绝对路径,可留空)", placeholder: "/Users/…/项目目录" },
|
|
1109
|
+
],
|
|
1110
|
+
});
|
|
1111
|
+
if (!input) return null;
|
|
1112
|
+
return { name: input.name.trim(), workspacePath: (input.workspacePath ?? "").trim() || null };
|
|
1113
|
+
}
|
|
1114
|
+
|
|
955
1115
|
// ---------------------------------------------------------------- helpers
|
|
956
1116
|
/**
|
|
957
1117
|
* FR-95(2026-10-26 补):会话**命名结果**的如实呈现片段 —— 供各「建会话」出口的横幅复用。
|
|
@@ -969,16 +1129,39 @@
|
|
|
969
1129
|
if (r.titleApplied === true) return r.sessionName ? ` · 会话名《${r.sessionName}》` : "";
|
|
970
1130
|
return ` · ⚠ 会话名未生效(${r.titleReason ?? "原因未知"})`;
|
|
971
1131
|
};
|
|
972
|
-
|
|
1132
|
+
/**
|
|
1133
|
+
* 卡 `-222`(需求 `R163` ③):`sticky` —— **初始化失败态横幅不自动消失**。
|
|
1134
|
+
*
|
|
1135
|
+
* 取证(2026-11-04):`bootstrap()` 末尾**无条件** `hideBanner()`,而 error 横幅本身也只活 10s
|
|
1136
|
+
* ⇒ 一次 `Failed to fetch` 之后,那条唯一的失败理由被抹掉,人回来看到的是「全空且没有任何理由」。
|
|
1137
|
+
* 除初始化失败外,其余调用点都是「一次性操作提示」,故缺省 `sticky: false`,既有行为不变。
|
|
1138
|
+
*/
|
|
1139
|
+
const showBanner = (message, kind = "info", { sticky = false } = {}) => {
|
|
973
1140
|
banner.textContent = message;
|
|
974
|
-
banner.className = `banner ${kind}`;
|
|
1141
|
+
banner.className = `banner ${kind}${sticky ? " tb-banner-sticky" : ""}`;
|
|
975
1142
|
banner.hidden = false;
|
|
976
1143
|
try { banner.scrollIntoView({ block: "nearest" }); } catch { /* ignore */ }
|
|
977
1144
|
clearTimeout(bannerTimer);
|
|
978
|
-
bannerTimer = setTimeout(() => { banner.hidden = true; }, kind === "error" ? 10000 : 5000);
|
|
1145
|
+
bannerTimer = sticky ? null : setTimeout(() => { banner.hidden = true; }, kind === "error" ? 10000 : 5000);
|
|
1146
|
+
};
|
|
1147
|
+
/**
|
|
1148
|
+
* 卡 `-222`(需求 `R163` ③):**初始化失败态横幅不许被清掉**。
|
|
1149
|
+
*
|
|
1150
|
+
* 原缺陷两层:① `bootstrap()` 末尾无条件 `hideBanner()`;② error 横幅本身只活 10s。
|
|
1151
|
+
* 于是「一次 `Failed to fetch`」的结果是:全空 + 没有任何理由,人只能去刷新整页。
|
|
1152
|
+
*
|
|
1153
|
+
* 现在两道锁:横幅 `sticky`(不挂定时器)+ 失败未解除时 `hideBanner()` 直接不生效。
|
|
1154
|
+
* 失败被解除的唯一入口是 `bootstrap()` 成功(那里先把 `bootFailureSticky` 置回 false 再收起)。
|
|
1155
|
+
* 这里用 `bootFailureSticky` 这个**先行声明的标志**而不是 `bootState`:`hideBanner` 定义在
|
|
1156
|
+
* `bootState` 之前,直接引用 `const` 会在 TDZ 里抛 ReferenceError。
|
|
1157
|
+
*/
|
|
1158
|
+
const hideBanner = () => {
|
|
1159
|
+
if (bootFailureSticky) return; // 初始化失败未解除 ⇒ 理由必须留得住(否则又回到"全空且没有理由")
|
|
1160
|
+
banner.hidden = true;
|
|
1161
|
+
clearTimeout(bannerTimer);
|
|
979
1162
|
};
|
|
980
|
-
const hideBanner = () => { banner.hidden = true; clearTimeout(bannerTimer); };
|
|
981
1163
|
let bannerTimer = null;
|
|
1164
|
+
let bootFailureSticky = false;
|
|
982
1165
|
|
|
983
1166
|
/**
|
|
984
1167
|
* 能力边界(真机 2026-10-29 · `:47830`「未能投递:host-unavailable」+「无法自动打开…」连撞两次)。
|
|
@@ -1041,6 +1224,30 @@
|
|
|
1041
1224
|
hostNotice.textContent = "本实例是独立进程,没有 DSH 宿主会话通道:「投给主会话 / 打开会话 / 派发团队」这类动作在这里不可用(相关按钮已置灰)。看板、建卡、改状态、评审、人工收口都照常可用;要投递或派发,请到 DSH 内的任务工作台(地址以 /integrations/taskboard-workbench 结尾的那个页面)操作。";
|
|
1042
1225
|
hostNotice.hidden = false;
|
|
1043
1226
|
}
|
|
1227
|
+
/** 卡 `-236`/`-237`:只读跟随者常驻条(角色来自 `/api/health` 的 `role` / `leaseOwner`)。 */
|
|
1228
|
+
function renderFollowerNotice() {
|
|
1229
|
+
if (state.instanceRole !== "follower") { followerNotice.hidden = true; return; }
|
|
1230
|
+
const owner = state.leaseOwner;
|
|
1231
|
+
const who = owner ? `${owner.host ?? "另一个宿主"} · pid ${owner.pid ?? "?"}` : "另一个工作台实例";
|
|
1232
|
+
followerNotice.textContent = `本窗口只读:${who} 正在写同一个数据库(${state.dataDir || "同一 dataDir"})。看板照常可看;新建 / 改状态 / 评论等写操作会被拒绝。要写请去那个窗口;它退出后(约 45 秒租约过期)本窗口会自动接管,无需重启。`;
|
|
1233
|
+
followerNotice.hidden = false;
|
|
1234
|
+
}
|
|
1235
|
+
/** 角色会变(对端退出 ⇒ 自动接管),所以轻量轮询一次 `/api/health`,只更新角色,不动数据。 */
|
|
1236
|
+
async function refreshInstanceRole() {
|
|
1237
|
+
try {
|
|
1238
|
+
const health = await api("GET", "/api/health");
|
|
1239
|
+
const nextRole = health?.role === "follower" ? "follower" : "writer";
|
|
1240
|
+
const changed = nextRole !== state.instanceRole;
|
|
1241
|
+
state.instanceRole = nextRole;
|
|
1242
|
+
state.leaseOwner = health?.leaseOwner ?? null;
|
|
1243
|
+
state.dataDirHint = health?.dataDirHint ?? state.dataDirHint ?? null;
|
|
1244
|
+
renderFollowerNotice();
|
|
1245
|
+
if (changed && nextRole === "writer") {
|
|
1246
|
+
showBanner("已接管写者租约(对端已退出),本窗口恢复读写", "info");
|
|
1247
|
+
if (view === "board") void loadTasks();
|
|
1248
|
+
}
|
|
1249
|
+
} catch { /* 轮询失败不打扰:连接问题由 connNotice 负责 */ }
|
|
1250
|
+
}
|
|
1044
1251
|
/**
|
|
1045
1252
|
* FR-84 补口(2026-10-18 真机):`navigator.clipboard.writeText()` 返回 **Promise**,
|
|
1046
1253
|
* 权限被拒或非安全上下文时是 **rejection** —— 老写法 `try { writeText(x) } catch {}` **抓不到**,
|
|
@@ -1572,6 +1779,10 @@
|
|
|
1572
1779
|
}
|
|
1573
1780
|
|
|
1574
1781
|
async function loadTasks() {
|
|
1782
|
+
// 卡 `-222`:必要步失败期间,**任何**刷新路径(SSE 回流 / 60s 看护轮询 / 重新同步)都不许把
|
|
1783
|
+
// 失败面板顶成一块空看板 —— 那正是「一次 Failed to fetch ⇒ 永久空白」的第二条复发路径
|
|
1784
|
+
// (面板画出来只是第一条;不拦住定时刷新,人过一分钟回来还是空白)。
|
|
1785
|
+
if (bootEssentialFailure()) { showBootPanel(); return; }
|
|
1575
1786
|
const params = new URLSearchParams();
|
|
1576
1787
|
if (state.projectId) params.set("project", state.projectId);
|
|
1577
1788
|
if (state.priority) params.set("priority", state.priority);
|
|
@@ -1710,28 +1921,165 @@
|
|
|
1710
1921
|
}
|
|
1711
1922
|
}
|
|
1712
1923
|
|
|
1924
|
+
/**
|
|
1925
|
+
* 卡 `-222`(需求 `R163` ①–③):`bootstrap()` **分步容错** —— 一次 `Failed to fetch` 不再永久空白。
|
|
1926
|
+
*
|
|
1927
|
+
* 现场(2026-11-04 · `/integrations/taskboard-workbench`):服务端与压测全绿,问题在浏览器侧 ——
|
|
1928
|
+
* 同一毫秒内 10 条 `TypeError: Failed to fetch`(`api()` ← `loadTasks()`),是连接被同时掐断,
|
|
1929
|
+
* 不是某个接口 5xx。而当时的 `bootstrap()` 是**全有或全无**:`/api/meta`、`/api/projects` 两处裸
|
|
1930
|
+
* `await`,任一网络层失败 ⇒ `renderCurrentView()` 永不执行 ⇒ `.board` 0 子元素、8 个下拉 0 option;
|
|
1931
|
+
* `bootstrap().catch` 只弹一次 banner,**且末尾无条件 `hideBanner()` 把它抹掉**,还没有重试入口
|
|
1932
|
+
* ⇒ 用户看到的就是「全空且没有任何理由」,唯一自救是刷新整页。
|
|
1933
|
+
*
|
|
1934
|
+
* 处置(只在前端;**不改 `/api/*` 契约**):
|
|
1935
|
+
* ① 每步独立 `runBootStep`,一步失败**不中断**后续步骤;
|
|
1936
|
+
* ② 失败步**留占位 + 原因**(`bootState.failures`):
|
|
1937
|
+
* · **必要步**(`meta` / `projects`)→ 整块面板(`.tb-boot-panel`):画不出看板时如实说「哪一步、为什么」;
|
|
1938
|
+
* · **可降级步**(`health` / `context` / `settings` / `binding`)→ 常驻条(`.tb-boot-strip`):
|
|
1939
|
+
* 面板照常可用,但**缺哪几项、为什么**必须看得见(不再静默降级);
|
|
1940
|
+
* ③ 两处都带**显式「重试」**(只重跑 `bootstrap()`,**不刷新整页**);
|
|
1941
|
+
* ④ 有失败时**绝不 `hideBanner()`**,且失败横幅 `sticky`(不自动消失)—— 失败理由必须留得住。
|
|
1942
|
+
*/
|
|
1943
|
+
const bootState = { running: false, at: null, failures: [] };
|
|
1944
|
+
const noteBootFailure = (id, label, essential, error) => {
|
|
1945
|
+
bootState.failures.push({
|
|
1946
|
+
id, label, essential,
|
|
1947
|
+
message: error?.message ?? String(error ?? "未知错误"),
|
|
1948
|
+
code: error?.code ?? null,
|
|
1949
|
+
});
|
|
1950
|
+
};
|
|
1951
|
+
/** 跑一步:成功返回 `{ ok:true, value }`,失败**记账后**返回 `{ ok:false, value:null }`(不抛)。 */
|
|
1952
|
+
async function runBootStep(id, label, essential, run) {
|
|
1953
|
+
try { return { ok: true, value: await run() }; }
|
|
1954
|
+
catch (error) { noteBootFailure(id, label, essential, error); return { ok: false, value: null }; }
|
|
1955
|
+
}
|
|
1956
|
+
const bootEssentialFailure = () => bootState.failures.some((f) => f.essential);
|
|
1957
|
+
const bootFailureLine = (f) => `✕ ${f.label} 读取失败:${f.message}${f.code ? `(${f.code})` : ""}`;
|
|
1958
|
+
/** 必要步失败的面板:**必须**能看出「哪一步、为什么、怎么再来一次」。 */
|
|
1959
|
+
function bootPanel() {
|
|
1960
|
+
const box = mk("div", "empty-guide tb-boot-panel");
|
|
1961
|
+
box.id = "tb-boot-panel";
|
|
1962
|
+
box.setAttribute("role", "alert");
|
|
1963
|
+
box.appendChild(mk("div", "empty-guide-title", "面板初始化没完成:看板暂时没能画出来"));
|
|
1964
|
+
box.appendChild(mk("div", "empty-guide-hint", "这不是「没有任务」—— 是初始化取数失败。下面逐步列出「哪一步」失败、失败原因;点「重试」只重跑初始化,不必刷新整页(刷新整页不是唯一出路)。"));
|
|
1965
|
+
for (const f of bootState.failures) {
|
|
1966
|
+
const row = mk("div", "empty-guide-hint tb-boot-failure");
|
|
1967
|
+
row.dataset.bootStep = f.id;
|
|
1968
|
+
row.dataset.bootEssential = f.essential ? "1" : "0";
|
|
1969
|
+
row.textContent = bootFailureLine(f);
|
|
1970
|
+
box.appendChild(row);
|
|
1971
|
+
}
|
|
1972
|
+
const bar = mk("div", "empty-guide-actions");
|
|
1973
|
+
bar.appendChild(bootRetryButton("primary"));
|
|
1974
|
+
box.appendChild(bar);
|
|
1975
|
+
return box;
|
|
1976
|
+
}
|
|
1977
|
+
/** 可降级步骤失败时的常驻条:面板照常可用,但缺项与原因不静默。 */
|
|
1978
|
+
function renderBootStrip() {
|
|
1979
|
+
const degraded = bootState.failures.filter((f) => !f.essential);
|
|
1980
|
+
bootStrip.replaceChildren();
|
|
1981
|
+
if (!degraded.length) { bootStrip.hidden = true; return; }
|
|
1982
|
+
bootStrip.appendChild(mk("div", "empty-guide-title", `面板已加载,但有 ${degraded.length} 项数据没读到(不是空白,只是缺这几项)`));
|
|
1983
|
+
for (const f of degraded) {
|
|
1984
|
+
const row = mk("div", "empty-guide-hint tb-boot-failure");
|
|
1985
|
+
row.dataset.bootStep = f.id;
|
|
1986
|
+
row.dataset.bootEssential = "0";
|
|
1987
|
+
row.textContent = bootFailureLine(f);
|
|
1988
|
+
bootStrip.appendChild(row);
|
|
1989
|
+
}
|
|
1990
|
+
const bar = mk("div", "empty-guide-actions");
|
|
1991
|
+
bar.appendChild(bootRetryButton("ghost"));
|
|
1992
|
+
bootStrip.appendChild(bar);
|
|
1993
|
+
bootStrip.hidden = false;
|
|
1994
|
+
}
|
|
1995
|
+
/** 显式重试入口(面板与常驻条共用同一份实现;`id` 供守卫读数)。 */
|
|
1996
|
+
function bootRetryButton(cls) {
|
|
1997
|
+
const retry = btn("重试(只重跑初始化)", () => { void retryBootstrap(); }, cls);
|
|
1998
|
+
retry.id = "tb-boot-retry";
|
|
1999
|
+
return retry;
|
|
2000
|
+
}
|
|
2001
|
+
/** 只重跑初始化 —— **不刷新整页**(需求 `R163` ②)。 */
|
|
2002
|
+
async function retryBootstrap() {
|
|
2003
|
+
if (bootState.running) return; // 连点不叠加:一次只跑一轮
|
|
2004
|
+
showBanner("正在重跑面板初始化…", "info");
|
|
2005
|
+
try { await bootstrap(); }
|
|
2006
|
+
catch (error) {
|
|
2007
|
+
bootFailureSticky = true;
|
|
2008
|
+
showBanner(`重试失败:${error?.message ?? error} —— 可再点「重试」,不必刷新整页。`, "error", { sticky: true });
|
|
2009
|
+
}
|
|
2010
|
+
}
|
|
2011
|
+
/** 必要步失败 ⇒ 只画面板(不画空看板、不画空下拉);其余视图一律让位给它。 */
|
|
2012
|
+
function showBootPanel() {
|
|
2013
|
+
boardScroll.hidden = false;
|
|
2014
|
+
reqScroll.hidden = true; teamScroll.hidden = true; configScroll.hidden = true;
|
|
2015
|
+
gateScroll.hidden = true; advanceScroll.hidden = true;
|
|
2016
|
+
bootStrip.hidden = true;
|
|
2017
|
+
board.replaceChildren(bootPanel());
|
|
2018
|
+
}
|
|
2019
|
+
/** 失败横幅:**sticky**(不自动消失),内容只列失败步 —— 成功的步不占位。 */
|
|
2020
|
+
function syncBootBanner() {
|
|
2021
|
+
if (!bootState.failures.length) {
|
|
2022
|
+
bootFailureSticky = false;
|
|
2023
|
+
hideBanner();
|
|
2024
|
+
return;
|
|
2025
|
+
}
|
|
2026
|
+
const head = bootEssentialFailure() ? "面板初始化未完成" : "面板已加载,但有数据没读到";
|
|
2027
|
+
bootFailureSticky = true; // 锁住 hideBanner:失败未解除前,任何后续收起都不许抹掉这条理由
|
|
2028
|
+
showBanner(`${head}:${bootState.failures.map((f) => `${f.label}(${f.message})`).join(";")} —— 点面板内「重试」只重跑初始化,不必刷新整页。`, "error", { sticky: true });
|
|
2029
|
+
}
|
|
2030
|
+
|
|
1713
2031
|
async function bootstrap() {
|
|
1714
|
-
|
|
1715
|
-
|
|
1716
|
-
|
|
1717
|
-
|
|
1718
|
-
|
|
1719
|
-
|
|
1720
|
-
|
|
1721
|
-
|
|
1722
|
-
|
|
1723
|
-
|
|
1724
|
-
|
|
1725
|
-
|
|
1726
|
-
|
|
1727
|
-
|
|
1728
|
-
|
|
1729
|
-
|
|
1730
|
-
|
|
1731
|
-
|
|
1732
|
-
|
|
1733
|
-
|
|
1734
|
-
|
|
2032
|
+
if (bootState.running) return;
|
|
2033
|
+
bootState.running = true;
|
|
2034
|
+
bootState.failures = [];
|
|
2035
|
+
bootState.at = new Date().toISOString();
|
|
2036
|
+
try {
|
|
2037
|
+
// ① 能力位(**可降级**:读不到 = 能力未知,交给服务端如实拒绝,不擅自禁用)
|
|
2038
|
+
// 先读能力位再渲染:否则首屏会先画出"能点"的按钮、几百毫秒后再置灰(闪一下更困惑)。
|
|
2039
|
+
const health = await runBootStep("health", "宿主能力位(/api/health)", false, () => api("GET", "/api/health"));
|
|
2040
|
+
state.host = health.value?.host ?? null;
|
|
2041
|
+
state.instanceRole = health.value?.role === "follower" ? "follower" : "writer";
|
|
2042
|
+
state.leaseOwner = health.value?.leaseOwner ?? null;
|
|
2043
|
+
state.dataDirHint = health.value?.dataDirHint ?? null;
|
|
2044
|
+
renderHostNotice();
|
|
2045
|
+
renderFollowerNotice();
|
|
2046
|
+
// ② 状态 / 优先级元数据(**必要**:看板列与优先级下拉全靠它,缺了画不出列)
|
|
2047
|
+
const meta = await runBootStep("meta", "状态与优先级元数据(/api/meta)", true, () => api("GET", "/api/meta"));
|
|
2048
|
+
state.statuses = meta.value?.statuses ?? [];
|
|
2049
|
+
state.dataDir = meta.value?.dataDir ?? "";
|
|
2050
|
+
renderFollowerNotice(); // 只读条里要写清"哪个库",meta 回来后再刷一次文案
|
|
2051
|
+
state.priorities = meta.value?.priorities ?? [];
|
|
2052
|
+
// ③ FR-60:会话/工作区 → 项目(**可降级**:拿不到就按项目列表第一项)
|
|
2053
|
+
const ctxParams = new URLSearchParams();
|
|
2054
|
+
if (cwd) ctxParams.set("cwd", cwd);
|
|
2055
|
+
if (sessionId) ctxParams.set("session", sessionId);
|
|
2056
|
+
const ctx = await runBootStep("context", "会话上下文(/api/context)", false,
|
|
2057
|
+
() => api("GET", `/api/context${ctxParams.toString() ? `?${ctxParams}` : ""}`));
|
|
2058
|
+
// ④ 项目列表(**必要**:没有项目就没有取数范围)
|
|
2059
|
+
const projects = await runBootStep("projects", "项目列表(/api/projects)", true, () => api("GET", "/api/projects"));
|
|
2060
|
+
const projectList = projects.value?.projects ?? [];
|
|
2061
|
+
if (destroyed) return;
|
|
2062
|
+
state.projects = projectList;
|
|
2063
|
+
state.projectId = ctx.value?.project?.id ?? projectList[0]?.id ?? "";
|
|
2064
|
+
state.context = ctx.value ?? null;
|
|
2065
|
+
// ⑤ 项目配置(**可降级**:读不到就按默认,不挡看板)
|
|
2066
|
+
if (state.projectId) {
|
|
2067
|
+
const settings = await runBootStep("settings", "项目设置(/api/projects/:id/settings)", false,
|
|
2068
|
+
() => api("GET", `/api/projects/${encodeURIComponent(state.projectId)}/settings`));
|
|
2069
|
+
state.loop = settings.value?.loop ?? {};
|
|
2070
|
+
}
|
|
2071
|
+
// ⑥ FR-63(扩展到所有视图):解析"本会话×本项目"绑定态,未绑定则全视图显示关联门(**可降级**)
|
|
2072
|
+
await resolveBinding(state.projectId);
|
|
2073
|
+
if (destroyed) return;
|
|
2074
|
+
// 必要步失败 ⇒ 画「哪一步、为什么」的面板 + 重试;**不画空看板**
|
|
2075
|
+
if (bootEssentialFailure()) { showBootPanel(); syncBootBanner(); return; }
|
|
2076
|
+
renderCurrentView();
|
|
2077
|
+
// 卡 `-222` ③:失败态横幅**不被清** —— 只有全部成功才 hideBanner(原实现无条件 hide ⇒ 唯一理由被抹掉)
|
|
2078
|
+
if (bootState.failures.length) { renderBootStrip(); syncBootBanner(); }
|
|
2079
|
+
else { bootStrip.hidden = true; bootStrip.replaceChildren(); bootFailureSticky = false; hideBanner(); }
|
|
2080
|
+
} finally {
|
|
2081
|
+
bootState.running = false;
|
|
2082
|
+
}
|
|
1735
2083
|
}
|
|
1736
2084
|
// 会话×项目 绑定态解析(FR-63 → 全视图生效)
|
|
1737
2085
|
async function resolveBinding(projectId) {
|
|
@@ -1739,7 +2087,11 @@
|
|
|
1739
2087
|
try {
|
|
1740
2088
|
const c = await api("GET", `/api/context?session=${encodeURIComponent(sessionId)}&project=${encodeURIComponent(projectId)}`);
|
|
1741
2089
|
state.binding = { projectId, bound: c.sessionBound !== false, mainSessionId: c.mainSessionId ?? null, association: c.association ?? null, sessionOrigin: c.sessionOrigin ?? null };
|
|
1742
|
-
} catch
|
|
2090
|
+
} catch (error) {
|
|
2091
|
+
state.binding = { projectId, bound: true, mainSessionId: null, association: null };
|
|
2092
|
+
// 卡 `-222` ①:绑定态也是 bootstrap 的一步 —— 失败要留原因(项目内切换时不算 boot 步骤,不记账)
|
|
2093
|
+
if (bootState.running) noteBootFailure("binding", "会话绑定态(/api/context?project=…)", false, error);
|
|
2094
|
+
}
|
|
1743
2095
|
}
|
|
1744
2096
|
const isBlocked = () => Boolean(sessionId) && state.binding.projectId === state.projectId && state.binding.bound === false;
|
|
1745
2097
|
function hideGate() { gateScroll.hidden = true; }
|
|
@@ -1777,10 +2129,10 @@
|
|
|
1777
2129
|
bar.append(
|
|
1778
2130
|
btn(state.binding.association === "pending" ? "重新申请关联" : "申请关联", async () => { try { await api("POST", `/api/projects/${encodeURIComponent(state.projectId)}/sessions/request`, { sessionId }); showBanner("已提交关联申请,等待主会话批准", "info"); await resolveBinding(state.projectId); renderCurrentView(); } catch (e) { showBanner(`申请失败:${e.message}`, "error"); } }, "primary"),
|
|
1779
2131
|
btn("新建项目(绑定本会话)", async () => {
|
|
1780
|
-
const
|
|
1781
|
-
|
|
2132
|
+
const input = await askNewProject();
|
|
2133
|
+
if (!input) return;
|
|
1782
2134
|
try {
|
|
1783
|
-
const r = await api("POST", "/api/projects", { name, workspacePath:
|
|
2135
|
+
const r = await api("POST", "/api/projects", { name: input.name, workspacePath: input.workspacePath });
|
|
1784
2136
|
state.projectId = r.project.id;
|
|
1785
2137
|
state.projects = [r.project, ...projects.filter((p) => p.id !== r.project.id)];
|
|
1786
2138
|
await resolveBinding(state.projectId); // 新项目无主会话 → 本会话成为主会话
|
|
@@ -1833,20 +2185,31 @@
|
|
|
1833
2185
|
const rowActions = (item) => {
|
|
1834
2186
|
const box = mk("div", "advance-actions");
|
|
1835
2187
|
for (const action of (item.actions ?? [])) {
|
|
1836
|
-
|
|
2188
|
+
// 取值改走页面内 dialog ⇒ 回调必须是 async(原生 prompt() 是同步阻塞的)。
|
|
2189
|
+
box.appendChild(btn(ADVANCE_ACTION_LABEL[action.code] ?? action.code, async () => {
|
|
1837
2190
|
if (action.code === "complete") { void decide(item, "complete"); return; }
|
|
1838
2191
|
if (action.code === "approve") { void decide(item, "approve"); return; }
|
|
1839
2192
|
if (action.code === "retry") { void decide(item, "retry"); return; }
|
|
1840
2193
|
if (action.code === "changes") {
|
|
1841
|
-
const
|
|
1842
|
-
|
|
1843
|
-
|
|
2194
|
+
const input = await askFields({
|
|
2195
|
+
title: `#${item.taskRef} 返工说明`,
|
|
2196
|
+
hint: "会写进事件流;可留空=只记「返工」不写说明。",
|
|
2197
|
+
submit: "提交返工",
|
|
2198
|
+
fields: [{ name: "note", label: "返工说明", multiline: true, rows: 4, placeholder: "哪里不达标、要改成什么样" }],
|
|
2199
|
+
});
|
|
2200
|
+
if (!input) return;
|
|
2201
|
+
void decide(item, "changes", input.note);
|
|
1844
2202
|
return;
|
|
1845
2203
|
}
|
|
1846
2204
|
if (action.code === "choose") {
|
|
1847
|
-
const
|
|
1848
|
-
|
|
1849
|
-
|
|
2205
|
+
const input = await askFields({
|
|
2206
|
+
title: `#${item.taskRef} 的结论`,
|
|
2207
|
+
hint: "一句话结论,会写进事件流。",
|
|
2208
|
+
submit: "提交结论",
|
|
2209
|
+
fields: [{ name: "conclusion", label: "结论 *", placeholder: "例如:同意,按子任务 B 执行", required: true, requiredMessage: "结论不能为空" }],
|
|
2210
|
+
});
|
|
2211
|
+
if (!input || !input.conclusion.trim()) return;
|
|
2212
|
+
void decide(item, input.conclusion.trim(), item.why);
|
|
1850
2213
|
return;
|
|
1851
2214
|
}
|
|
1852
2215
|
// attribute / dispatch:不在本页代做,指回既有入口(不造第二条写路径)
|
|
@@ -1946,6 +2309,9 @@
|
|
|
1946
2309
|
}
|
|
1947
2310
|
|
|
1948
2311
|
function renderCurrentView() {
|
|
2312
|
+
// 卡 `-222`(需求 `R163` ①):必要步失败 ⇒ 任何视图切换都只画「哪一步失败、为什么」的面板,
|
|
2313
|
+
// 不画空看板、不画只剩占位项的下拉(旧实现这里照样渲染 ⇒ 人看到的是「全空且没有理由」)。
|
|
2314
|
+
if (bootEssentialFailure()) { showBootPanel(); return; }
|
|
1949
2315
|
if (isBlocked()) { void showBlockedGate(); return; }
|
|
1950
2316
|
hideGate();
|
|
1951
2317
|
if (view === "req") void renderRequirements();
|
|
@@ -2163,11 +2529,10 @@
|
|
|
2163
2529
|
// 「新建项目」统一入口(工具栏 / 配置页共用)—— 建完即切换,并让本会话成为该项目主会话
|
|
2164
2530
|
// (与「会话绑定门」里的建项目同口径:POST /api/projects → resolveBinding)。
|
|
2165
2531
|
async function createProjectFlow() {
|
|
2166
|
-
const
|
|
2167
|
-
if (!
|
|
2168
|
-
const ws = window.prompt("项目工作目录(绝对路径,可留空)");
|
|
2532
|
+
const input = await askNewProject();
|
|
2533
|
+
if (!input) return;
|
|
2169
2534
|
try {
|
|
2170
|
-
const r = await api("POST", "/api/projects", { name: name
|
|
2535
|
+
const r = await api("POST", "/api/projects", { name: input.name, workspacePath: input.workspacePath });
|
|
2171
2536
|
state.projectId = r.project.id;
|
|
2172
2537
|
state.projects = [r.project, ...(state.projects ?? []).filter((p) => p.id !== r.project.id)];
|
|
2173
2538
|
await resolveBinding(state.projectId);
|
|
@@ -2243,7 +2608,8 @@
|
|
|
2243
2608
|
// 能力门是**渲染后**才知道要不要置灰的(区块/抽屉随时新建)⇒ 观察 DOM 变化,把新出现的宿主依赖按钮一并置灰。
|
|
2244
2609
|
// 只观察 childList(不观察 attributes),故 `disabled/title` 的写入不会再触发自己。
|
|
2245
2610
|
try { new MutationObserver(() => { try { applyHostGate(); } catch { /* ignore */ } }).observe(doc.body, { childList: true, subtree: true }); } catch { /* ignore */ }
|
|
2246
|
-
|
|
2611
|
+
// 卡 `-222`:这一步只是**兜底**(每步已各自容错)—— 真抛出时也留住理由并指到「重试」,不给人「只剩刷新整页」。
|
|
2612
|
+
bootstrap().catch((error) => showBanner(`初始化失败:${error?.message ?? error} —— 点面板内「重试」可重跑初始化(不必刷新整页)。`, "error", { sticky: true }));
|
|
2247
2613
|
|
|
2248
2614
|
// FR-41:进度可见(SSE 失效信号 → 重取)
|
|
2249
2615
|
let boardEvents = null;
|
|
@@ -2295,6 +2661,8 @@
|
|
|
2295
2661
|
};
|
|
2296
2662
|
} catch { boardEvents = null; }
|
|
2297
2663
|
// FR-75/76:看护状态会随"阈值到达"自行变化(不产生 SSE),用轻量轮询兜底刷新看板/详情。
|
|
2664
|
+
// 卡 `-237`:写者租约随时可能交接(对端退出 / 对端起来)—— 30s 刷新一次角色,只读写者身份。
|
|
2665
|
+
const instancePoll = window.setInterval(() => { if (!destroyed) void refreshInstanceRole(); }, 30000);
|
|
2298
2666
|
const watchdogPoll = window.setInterval(() => {
|
|
2299
2667
|
if (destroyed) return;
|
|
2300
2668
|
if (view === "board") void loadTasks();
|
|
@@ -2346,8 +2714,10 @@
|
|
|
2346
2714
|
if (!value) return "—";
|
|
2347
2715
|
return String(value).replace("T", " ").replace(/\.\d+Z?$/, "").replace(/Z$/, "");
|
|
2348
2716
|
}
|
|
2349
|
-
function pill(text, cls = "") {
|
|
2350
|
-
|
|
2717
|
+
function pill(text, cls = "", title = "") {
|
|
2718
|
+
const node = mk("span", `chip ${cls}`.trim(), text);
|
|
2719
|
+
if (title) node.title = title;
|
|
2720
|
+
return node;
|
|
2351
2721
|
}
|
|
2352
2722
|
function statusPill(status) {
|
|
2353
2723
|
return mk("span", `chip dot status-chip status-${status}`, STATUS_LABELS[status] ?? status);
|
|
@@ -2356,6 +2726,19 @@
|
|
|
2356
2726
|
function reqStatusLabel(status) {
|
|
2357
2727
|
return status === "draft" ? "待确认" : status === "open" ? "在办" : status === "done" ? "已完成" : status === "closed" ? "已关闭" : String(status ?? "");
|
|
2358
2728
|
}
|
|
2729
|
+
/**
|
|
2730
|
+
* 卡 `-218`(R159 D-1=`c`):条目**完整性**三态的唯一文案表(列表胶囊与详情字段共用,避免两处走样)。
|
|
2731
|
+
* 口径来自服务端派生字段 `detailState`(`src/core/requirements.mjs` `deriveDetailState`)。
|
|
2732
|
+
*/
|
|
2733
|
+
const DETAIL_STATE_LABELS = {
|
|
2734
|
+
truncated: { text: "残片", tone: "warn", title: "描述被截断(早期导入上限 2000 字符)—— 完整原文见来源文档,别当完整描述引用" },
|
|
2735
|
+
mirror: { text: "镜像", tone: "", title: "文档镜像条目:正文是某份文档的片段,不是可执行需求" },
|
|
2736
|
+
};
|
|
2737
|
+
function detailStateText(state) {
|
|
2738
|
+
return state === "truncated" ? "已截断 · 残片(仅存前 2000 字符;完整原文见「来源」所指文档)"
|
|
2739
|
+
: state === "mirror" ? "文档镜像(原文片段,非需求正文)"
|
|
2740
|
+
: "完整";
|
|
2741
|
+
}
|
|
2359
2742
|
function btn(label, onClick, cls = "ghost") {
|
|
2360
2743
|
const node = mk("button", cls, label);
|
|
2361
2744
|
node.type = "button";
|
|
@@ -2476,6 +2859,41 @@
|
|
|
2476
2859
|
return box;
|
|
2477
2860
|
}
|
|
2478
2861
|
|
|
2862
|
+
/**
|
|
2863
|
+
* 卡 `-227`(需求 `R168`):从「会话关联」**直接跳到那条会话**。
|
|
2864
|
+
*
|
|
2865
|
+
* 真机批注(2026-11-05):「增加会话关联对应主会话以及相关会话的直接跳转能力」。
|
|
2866
|
+
* 此前这两行列的只有截断标识(`session-70a0bcda…`)与存活胶囊 —— 想看一眼那条会话在聊什么,
|
|
2867
|
+
* 只能记住/复制标识回侧栏翻。**面板里没有任何入口能把人送到那条会话**。
|
|
2868
|
+
*
|
|
2869
|
+
* 口径(与 `-211` 同一教训:**能跳才叫跳转**):
|
|
2870
|
+
* ① 优先**客户端导航**(`options.openSession`;实机里它走 `uiWorkspace.openSession` / 路由);
|
|
2871
|
+
* ② 成功后再把该会话的视图偏好改写成「对话」页 —— 否则嵌套宿主按上次偏好把标签页弹回看板,
|
|
2872
|
+
* "跳过去了但看到的还是看板"(真机取证见 `bringConversationToFront` 注释);
|
|
2873
|
+
* ③ 没有通道 / 宿主拒绝 ⇒ **复制标识 + 如实说明**,绝不说"已打开"(那是 `-211` 之前的老毛病)。
|
|
2874
|
+
* 能力门:按钮文案固定「打开会话」,`HOST_BUTTON_LABELS` 里已有该条 ⇒ `applyHostGate` 按
|
|
2875
|
+
* `openSession` 能力位统一置灰并补 title,不需要这里再判一次。
|
|
2876
|
+
*/
|
|
2877
|
+
const openSessionJump = (sid) => {
|
|
2878
|
+
const target = String(sid ?? "").trim();
|
|
2879
|
+
if (!target) { showBanner("没有可打开的会话标识", "error"); return; }
|
|
2880
|
+
const short = target.length > 18 ? `${target.slice(0, 18)}…` : target;
|
|
2881
|
+
if (!openHostSession) {
|
|
2882
|
+
void copyText(target);
|
|
2883
|
+
showBanner(`本实例没有宿主会话通道,无法直接跳转 —— 已复制会话标识 ${short},可在侧栏搜索`, "error");
|
|
2884
|
+
return;
|
|
2885
|
+
}
|
|
2886
|
+
let result = null;
|
|
2887
|
+
try { result = openHostSession(target); } catch (error) { result = { ok: false, reason: error?.message ?? String(error) }; }
|
|
2888
|
+
if (result?.ok) {
|
|
2889
|
+
bringConversationToFront(doc, target);
|
|
2890
|
+
showBanner(`已打开会话 ${short}(若仍停在「任务工作台」页,点上方「对话」即可看历史)`, "info");
|
|
2891
|
+
return;
|
|
2892
|
+
}
|
|
2893
|
+
void copyText(target);
|
|
2894
|
+
showBanner(`打开会话失败:${result?.reason ?? "宿主未接受该会话"} —— 已复制会话标识 ${short}`, "error");
|
|
2895
|
+
};
|
|
2896
|
+
|
|
2479
2897
|
async function renderConfig() {
|
|
2480
2898
|
configRoot.replaceChildren(mk("p", "hint", "加载配置…"));
|
|
2481
2899
|
try {
|
|
@@ -2490,11 +2908,18 @@
|
|
|
2490
2908
|
box.appendChild(mk("h2", null, `任务工作台 · 配置`));
|
|
2491
2909
|
box.appendChild(mk("p", "hint", `配置对象:${state.projectId}(${projName})${sessionId ? " · 会话内" : " · 全局入口"} — 用上方“项目”下拉切换;下方所有保存都作用于该项目。`));
|
|
2492
2910
|
// 开局向导(团队先行七步 + 复制指令)
|
|
2493
|
-
const [gSettings, gDocs, gItems, gTasks] = await Promise.all([
|
|
2911
|
+
const [gSettings, gDocs, gItems, gTasks, gNorms, gSpec, gTeams] = await Promise.all([
|
|
2494
2912
|
api("GET", `/api/projects/${encodeURIComponent(state.projectId)}/settings`).catch(() => ({})),
|
|
2495
2913
|
api("GET", `/api/requirements/docs?project=${encodeURIComponent(state.projectId)}`).catch(() => ({ docs: [] })),
|
|
2496
2914
|
api("GET", `/api/requirements/items?project=${encodeURIComponent(state.projectId)}`).catch(() => ({ items: [] })),
|
|
2497
2915
|
api("GET", `/api/tasks?project=${encodeURIComponent(state.projectId)}`).catch(() => ({ tasks: [] })),
|
|
2916
|
+
// 卡 `-216`(R160):规范来源(旧服务端没有这条路由 ⇒ null,卡片显示"不可用"而不是崩)
|
|
2917
|
+
api("GET", `/api/projects/${encodeURIComponent(state.projectId)}/norms`).catch(() => null),
|
|
2918
|
+
// 卡 `-220`(R161):随包人读文档的位置(包内默认 / 项目存放 / 生效来源)
|
|
2919
|
+
api("GET", `/api/projects/${encodeURIComponent(state.projectId)}/docs`).catch(() => null),
|
|
2920
|
+
// 卡 `-228`(R169):第 4 步「创建执行团队」的真实判据 —— 工作区 `.agent-teams/` 里的第三方团队。
|
|
2921
|
+
// 官方团队是常量(永远在)⇒ 不能拿 `teams.length>0` 当「已创建」,否则这一步恒绿=假绿。
|
|
2922
|
+
api("GET", `/api/projects/${encodeURIComponent(state.projectId)}/agent-teams`).catch(() => null),
|
|
2498
2923
|
]);
|
|
2499
2924
|
const gDoc = (gDocs.docs || [])[0] || null;
|
|
2500
2925
|
const gItemsAll = gItems.items || [];
|
|
@@ -2503,28 +2928,76 @@
|
|
|
2503
2928
|
const gEnv = Object.keys(gSettings.envConfig || {}).length > 0;
|
|
2504
2929
|
const gRoster = (gSettings.teamTemplate?.roles || []).length > 0;
|
|
2505
2930
|
const gIntake = gDoc ? /##\s*资料清单/.test(gDoc.body || "") : false;
|
|
2506
|
-
|
|
2931
|
+
// 卡 `-228`(R169):**「已确认」= 非 draft**。原来只数 `open` ⇒ 已交付(done/closed)的条目
|
|
2932
|
+
// 一律不算 ⇒ 本项目 164 条全确认却显示「已确认 3」(真机读数,2026-11-05)。
|
|
2507
2933
|
const gDraft = gItemsAll.filter((i) => i.status === "draft").length;
|
|
2934
|
+
const gConfirmed = gItemsAll.filter((i) => i.status !== "draft").length;
|
|
2935
|
+
const gThirdPartyTeams = (gTeams?.teams || []).filter((t) => t.source !== "official").length;
|
|
2508
2936
|
const gProg = gTasksAll.filter((t) => ["in_progress", "in_review", "blocked"].includes(t.status)).length;
|
|
2509
2937
|
const guide = mk("section", "config-card");
|
|
2510
|
-
guide.appendChild(mk("h3", null, "
|
|
2938
|
+
guide.appendChild(mk("h3", null, "开局向导(团队先行 · 7 步)"));
|
|
2511
2939
|
const engine = gSettings.teamTemplate?.engine ?? "instruction";
|
|
2512
2940
|
const gcopy = (label, text) => btn(label, () => { void copyText(text).then((ok) => showBanner(ok ? `已复制:${label}` : `复制失败:浏览器拒绝了剪贴板写入 —— 请手动选择复制(${label})`, ok ? "info" : "error")); });
|
|
2513
|
-
|
|
2941
|
+
/**
|
|
2942
|
+
* 卡 `-228`(R169)· 三态步骤条:`true` ✅ / `false` ○(**确知**未做)/ `null` ◐ 待核验。
|
|
2943
|
+
*
|
|
2944
|
+
* 原来只有布尔,于是两件「非布尔事实」被硬塞成 `false`:① 第 4 步「创建执行团队」本机没有
|
|
2945
|
+
* 可核验产物;② 「开局提示词」根本不是步骤。结果两行永久 ○ —— 既像「一直没做」,又让人以为
|
|
2946
|
+
* 还有两件事没做完(真机批注:「为什么开局提示词在第八步」)。
|
|
2947
|
+
* 口径:**没有信号时如实说「待核验」,不谎报成未做,也不谎报成已完成**(同 FR-84 存活胶囊三态)。
|
|
2948
|
+
*/
|
|
2949
|
+
const srow = (state, n, title, ...actions) => {
|
|
2950
|
+
const r = mk("div", "config-row");
|
|
2951
|
+
const badge = state === true
|
|
2952
|
+
? pill(`✅ 第 ${n} 步`, "ok")
|
|
2953
|
+
: state === false
|
|
2954
|
+
? pill(`○ 第 ${n} 步`, "warn")
|
|
2955
|
+
: pill(`◐ 第 ${n} 步`, "", "本机没有可核验信号 —— 不等于没做,需要人工确认");
|
|
2956
|
+
r.appendChild(badge);
|
|
2957
|
+
r.appendChild(mk("span", null, title));
|
|
2958
|
+
const right = mk("span", "config-actions"); right.append(...actions); r.appendChild(right);
|
|
2959
|
+
return r;
|
|
2960
|
+
};
|
|
2961
|
+
// 开工语 —— **不是第 8 步**:它是新会话发给队长的**第一条消息**(`KICKOFF_STEPS` 的 ①–⑧ 就是
|
|
2962
|
+
// 下面这 7 步的完整流程),复制即用,没有「做完」这个状态,因此不编号、不参与 ✅/○。
|
|
2963
|
+
//
|
|
2964
|
+
// R177(卡 `-243`):**按「配置对象」取项目,而不是按 `/api/context` 的全局绑定取** ——
|
|
2965
|
+
// 页面头部写的是「配置对象:${state.projectId}」,用顶部下拉切项目时 `info.project` 并不跟着变;
|
|
2966
|
+
// 若拿 `info.project` 插值,切到 B 项目后复制出来仍是 A 项目 ⇒ 与本次要修的 bug 同型。
|
|
2967
|
+
const kickoffProject = (state.projects ?? []).find((p) => p.id === state.projectId)
|
|
2968
|
+
?? (info.project?.id === state.projectId ? info.project : { id: state.projectId, name: projName, workspacePath: null });
|
|
2969
|
+
const kickoffText = buildKickoffPrompt(kickoffProject);
|
|
2970
|
+
const kickoffRow = mk("div", "config-row");
|
|
2971
|
+
kickoffRow.appendChild(pill("开工语", "warn", "新会话首条 —— 不是步骤,不编号也没有完成态"));
|
|
2972
|
+
kickoffRow.appendChild(mk("span", null, "新会话首条:把这句发给队长(它驱动下面 1–7 步)"));
|
|
2973
|
+
const kickoffRight = mk("span", "config-actions");
|
|
2974
|
+
kickoffRight.appendChild(gcopy("复制开局提示词", kickoffText));
|
|
2975
|
+
kickoffRow.appendChild(kickoffRight);
|
|
2976
|
+
guide.appendChild(kickoffRow);
|
|
2977
|
+
// R177:**把「复制出去到底带了什么」写在界面上** —— 只有一个按钮,人分不清复制的是哪个项目/哪个目录
|
|
2978
|
+
// (这正是 bug 能在界面上「看起来正常」的原因)。缺 workspacePath 时如实说会写成「请先在配置页补」。
|
|
2979
|
+
guide.appendChild(mk("p", "hint", kickoffProject.workspacePath
|
|
2980
|
+
? `开工语已带上:项目 ${kickoffProject.id} · 工作目录 ${kickoffProject.workspacePath}`
|
|
2981
|
+
: `⚠ 项目 ${kickoffProject.id || "(未解析)"} 未设 workspacePath —— 开工语里会写「(项目未设 workspacePath → 请先在配置页补)」,新会话仍可能回落默认项目。`));
|
|
2982
|
+
guide.appendChild(mk("p", "hint", "「开工语」不是步骤:它没有 ✅,复制进新会话即可;下面的 1–7 步才是可核验的进度。"));
|
|
2514
2983
|
guide.append(
|
|
2515
2984
|
srow(gBound, 1, "绑定项目 / 会话", mk("span", "hint", info.project ? `${info.project.id}${sessionId ? (info.sessionBound === false ? "(未绑定)" : " · 已绑定会话") : " · 全局入口"}` : "(未解析)")),
|
|
2516
2985
|
srow(gEnv, 2, "项目环境与约束", mk("span", "hint", gEnv ? "已配置" : "未配置(见下方卡片)")),
|
|
2986
|
+
// 第 3 步保留**唯一**的复制入口(第 4 步原来又发一个同样的按钮,属重复动作)。
|
|
2517
2987
|
srow(gRoster, 3, `执行团队模板 · 引擎=${engine}`, mk("span", "hint", gRoster ? `${(gSettings.teamTemplate?.roles || []).length} 个角色` : "未配置"), gcopy("复制团队创建指令", teamPrompt(engine))),
|
|
2518
|
-
|
|
2988
|
+
// 第 4 步口径:真发现第三方团队 ⇒ ✅;读不到或没有产物 ⇒ ◐ 待核验(官方团队是常量,不能当「已创建」)。
|
|
2989
|
+
srow(gThirdPartyTeams > 0 ? true : null, 4, "创建执行团队(对应引擎)",
|
|
2990
|
+
mk("span", "hint", gTeams === null ? "本机读不到团队清单(服务端较旧)" : gThirdPartyTeams > 0 ? `已发现 ${gThirdPartyTeams} 个第三方团队(.agent-teams/)` : "本机无产物:团队由队长在新会话里按第 3 步指令创建")),
|
|
2519
2991
|
srow(gIntake, 5, "引入项目资料", mk("span", "hint", gIntake ? `已引入(条目 ${gItemsAll.length})` : "未引入(见下方卡片)")),
|
|
2520
|
-
srow(
|
|
2992
|
+
srow(gConfirmed > 0, 6, "确认需求条目", mk("span", "hint", `待确认 ${gDraft} · 已确认 ${gConfirmed}`), btn("去需求页", () => setView("req"))),
|
|
2521
2993
|
srow(gTasksAll.length > 0, 7, "生成看板任务", mk("span", "hint", `任务 ${gTasksAll.length}(进行中/待验 ${gProg})`), btn("去看板", () => setView("board"))),
|
|
2522
|
-
srow(false, 8, "开局提示词(新会话首条)", gcopy("复制开局提示词", KICKOFF_PROMPT)),
|
|
2523
2994
|
);
|
|
2524
2995
|
box.appendChild(guide);
|
|
2525
2996
|
if (stale) box.appendChild(mk("p", "hint", "当前服务端为旧版(无 /api/context):请重启 web profile 后重试。"));
|
|
2526
2997
|
const card = (title, hint) => { const c = mk("section", "config-card"); c.appendChild(mk("h3", null, title)); if (hint) c.appendChild(mk("p", "hint", hint)); return c; };
|
|
2527
|
-
|
|
2998
|
+
// 卡 `-227`:label 允许直接传节点 —— 会话行需要给标签挂 `title`(完整会话标识),
|
|
2999
|
+
// 而纯字符串会被 `mk` 重新包一层,改不动它。传字符串时行为一字不变。
|
|
3000
|
+
const row = (label, ...nodes) => { const r = mk("div", "config-row"); r.appendChild(label && label.nodeType ? label : mk("span", null, label)); const right = mk("span", "config-actions"); right.append(...nodes); r.appendChild(right); return r; };
|
|
2528
3001
|
|
|
2529
3002
|
const bind = card("当前绑定", "工作区 → 项目 → 需求文档(初始绑定)");
|
|
2530
3003
|
bind.appendChild(kvList([
|
|
@@ -2537,12 +3010,153 @@
|
|
|
2537
3010
|
// 新建走这里的按钮 —— 此前配置页只有「前往需求视图」,正常使用路径下无法新建项目。
|
|
2538
3011
|
bind.appendChild(mk("p", "hint", "切换项目用顶部「项目」下拉;要新建项目点上面的「新建项目」(建完即切换为本会话的项目)。"));
|
|
2539
3012
|
|
|
3013
|
+
// ── 卡 `-216`(R160 · D-A/D-B/D-C 已拍):规范来源 ───────────────────────────
|
|
3014
|
+
// 真机缺口的原貌:`web/app.js` 里 `contract` / `norms` **一次都没出现** ⇒ 规范在包内、
|
|
3015
|
+
// 契约在变、`NORM_STALE` 会拦写,而界面上**一个字都没有**。人只能靠报错反推规则在哪。
|
|
3016
|
+
const normsCard = card("规范来源(机器规范)", "看板读写用的规则来自哪里;可以直接改副本 —— 改正文必须 bump version");
|
|
3017
|
+
const normsBody = mk("div", "config-body");
|
|
3018
|
+
normsCard.appendChild(normsBody);
|
|
3019
|
+
const drawNorms = (v) => {
|
|
3020
|
+
normsBody.replaceChildren();
|
|
3021
|
+
if (!v) { normsBody.appendChild(mk("p", "hint", "当前服务端没有 /norms 路由(旧版)—— 请重启 web profile 后再看。")); return; }
|
|
3022
|
+
const fallback = v.fallbackIds || [];
|
|
3023
|
+
const changed = (v.norms || []).filter((n) => n.modified).length;
|
|
3024
|
+
normsBody.appendChild(kvList([
|
|
3025
|
+
["来源", v.source === "project" ? "项目副本(本工作区优先)" : "随包默认(安装包内)"],
|
|
3026
|
+
["目录", v.dir || v.packagedDir || "—"],
|
|
3027
|
+
["份数", `${(v.norms || []).length} 份${fallback.length ? `(缺 ${fallback.length} 份已回落包内:${fallback.join(" / ")})` : ""}`],
|
|
3028
|
+
["与内置不同", `${changed} 份`],
|
|
3029
|
+
]));
|
|
3030
|
+
const list = mk("ul", "req-list");
|
|
3031
|
+
for (const n of (v.norms || [])) {
|
|
3032
|
+
const li = mk("li", "req-item");
|
|
3033
|
+
li.append(mk("span", "req-title", `${n.id}@v${n.version}`));
|
|
3034
|
+
li.appendChild(pill(n.origin === "project" ? "副本" : "包内", n.origin === "project" ? "accent" : ""));
|
|
3035
|
+
if (n.modified) li.appendChild(pill("已改", "warn"));
|
|
3036
|
+
list.appendChild(li);
|
|
3037
|
+
}
|
|
3038
|
+
normsBody.appendChild(list);
|
|
3039
|
+
if ((v.ignoredFiles || []).length) {
|
|
3040
|
+
normsBody.appendChild(mk("p", "hint", `已忽略 ${v.ignoredFiles.length} 个非规范文件:${v.ignoredFiles.map((x) => `${x.file}(${x.reason})`).join(" · ")}`));
|
|
3041
|
+
}
|
|
3042
|
+
const actions = mk("div", "config-row");
|
|
3043
|
+
actions.appendChild(btn("生成默认副本", () => void normsAction("materialize"), "primary"));
|
|
3044
|
+
actions.appendChild(btn("恢复默认(覆盖副本)", () => void normsAction("reset")));
|
|
3045
|
+
normsBody.appendChild(actions);
|
|
3046
|
+
normsBody.appendChild(mk("p", "hint", "改法:直接编辑副本里的 .md(frontmatter 的 norm_id 别动);**改正文必须把 version 加 1**,否则会被判「规范被偷偷改了」而拦写。改完在「契约」里重算一次基线。要不要把 .taskboard/ 入库由你定。"));
|
|
3047
|
+
};
|
|
3048
|
+
const refreshNorms = async () => {
|
|
3049
|
+
const v = await api("GET", `/api/projects/${encodeURIComponent(state.projectId)}/norms`).catch(() => null);
|
|
3050
|
+
drawNorms(v);
|
|
3051
|
+
};
|
|
3052
|
+
const normsAction = async (action) => {
|
|
3053
|
+
if (action === "reset" && !window.confirm("用安装包里的默认规范覆盖本项目副本?已做的修改会丢。")) return;
|
|
3054
|
+
try {
|
|
3055
|
+
const r = await api("POST", `/api/projects/${encodeURIComponent(state.projectId)}/norms`, { action, actor: "human" });
|
|
3056
|
+
// 只弹一条:规范变了 ⇒ 契约基线一定变。**不自动重算**(那是写库,让人自己点)。
|
|
3057
|
+
const head = action === "materialize"
|
|
3058
|
+
? `已生成规范副本(写 ${r.written?.length ?? 0} 份 / 保留 ${r.kept?.length ?? 0} 份)`
|
|
3059
|
+
: `已恢复默认(写 ${r.written?.length ?? 0} 份)`;
|
|
3060
|
+
showBanner(`${head};规范已变 ⇒ 请重算契约基线,否则写操作会按旧契约被拦`, "warn");
|
|
3061
|
+
} catch (err) { showBanner(`${action === "reset" ? "恢复" : "生成"}失败:${err.message}`, "error"); }
|
|
3062
|
+
await refreshNorms();
|
|
3063
|
+
};
|
|
3064
|
+
box.appendChild(normsCard);
|
|
3065
|
+
drawNorms(gNorms);
|
|
3066
|
+
|
|
3067
|
+
// ── 卡 `-220`(R161):文档与规范位置 ────────────────────────────────────
|
|
3068
|
+
// 用户要求:**落地真实启动包的相关配套文档**,其「默认解压位置 / 后续存放位置」要能查、能看、能改。
|
|
3069
|
+
// 与上面「规范来源」分卡的理:这份改了**不影响契约**(契约只吃 spec/norms 的机器规范)。
|
|
3070
|
+
const specCard = card("文档与规范位置(随包人读文档)", "开局 / 流程 / 条目文档放在哪:包内默认 → 项目存放 → 生效来源;存放位置可改");
|
|
3071
|
+
const specBody = mk("div", "config-body");
|
|
3072
|
+
specCard.appendChild(specBody);
|
|
3073
|
+
const drawSpec = (v) => {
|
|
3074
|
+
specBody.replaceChildren();
|
|
3075
|
+
if (!v) { specBody.appendChild(mk("p", "hint", "当前服务端没有 /docs 路由(旧版)—— 重启 web profile 后再看。")); return; }
|
|
3076
|
+
const proj = v.project || {};
|
|
3077
|
+
const pack = v.packaged || {};
|
|
3078
|
+
specBody.appendChild(kvList([
|
|
3079
|
+
["包内默认(解压后)", pack.dir || "—"],
|
|
3080
|
+
["项目存放位置", `${proj.dir || "—"}${proj.dirIsOverride ? "(已改)" : "(默认)"}`],
|
|
3081
|
+
["生效来源", (v.effective || {}).source === "project" ? "项目副本(本工作区优先)" : "包内默认(安装包内)"],
|
|
3082
|
+
["文件数", `${(proj.files || []).length} 份 / 包内 ${(pack.files || []).length} 份`],
|
|
3083
|
+
]));
|
|
3084
|
+
const list = mk("ul", "req-list");
|
|
3085
|
+
for (const f of (pack.files || [])) {
|
|
3086
|
+
const li = mk("li", "req-item");
|
|
3087
|
+
li.append(mk("span", "req-title", f));
|
|
3088
|
+
li.appendChild(pill((proj.files || []).includes(f) ? "副本" : "包内", (proj.files || []).includes(f) ? "accent" : ""));
|
|
3089
|
+
li.addEventListener("click", () => void openSpecDoc(f));
|
|
3090
|
+
list.appendChild(li);
|
|
3091
|
+
}
|
|
3092
|
+
specBody.appendChild(list);
|
|
3093
|
+
if ((v.missingInProject || []).length) {
|
|
3094
|
+
specBody.appendChild(mk("p", "hint", `副本里缺 ${v.missingInProject.length} 份(回落包内):${v.missingInProject.join(" · ")}`));
|
|
3095
|
+
}
|
|
3096
|
+
// 存放位置:可改、可恢复默认
|
|
3097
|
+
const dirInput = mk("input");
|
|
3098
|
+
dirInput.placeholder = "留空=默认 <工作区>/.taskboard/docs;也可填相对工作区的路径";
|
|
3099
|
+
dirInput.value = proj.dirIsOverride ? proj.dir : "";
|
|
3100
|
+
const dirRow = mk("div", "config-row");
|
|
3101
|
+
dirRow.appendChild(mk("span", null, "存放位置"));
|
|
3102
|
+
const dirRight = mk("span", "config-actions");
|
|
3103
|
+
dirRight.appendChild(dirInput);
|
|
3104
|
+
dirRight.appendChild(btn("保存路径", async () => {
|
|
3105
|
+
const val = dirInput.value.trim();
|
|
3106
|
+
try { const out = await api("PUT", `/api/projects/${encodeURIComponent(state.projectId)}/docs`, { dir: val, actor: "human" }); showBanner(val ? `存放位置已改为:${out.project.dir}` : "已恢复默认存放位置", "info"); drawSpec(out); }
|
|
3107
|
+
catch (e) { showBanner(`保存失败:${e.message}`, "error"); }
|
|
3108
|
+
}, "primary"));
|
|
3109
|
+
dirRight.appendChild(btn("恢复默认路径", async () => {
|
|
3110
|
+
try { const out = await api("PUT", `/api/projects/${encodeURIComponent(state.projectId)}/docs`, { dir: null, actor: "human" }); showBanner(`已恢复默认存放位置:${out.project.dir}`, "info"); drawSpec(out); }
|
|
3111
|
+
catch (e) { showBanner(`恢复失败:${e.message}`, "error"); }
|
|
3112
|
+
}));
|
|
3113
|
+
dirRow.appendChild(dirRight);
|
|
3114
|
+
specBody.appendChild(dirRow);
|
|
3115
|
+
const actions = mk("div", "config-row");
|
|
3116
|
+
actions.appendChild(btn("生成默认副本", () => void specAction("materialize"), "primary"));
|
|
3117
|
+
actions.appendChild(btn("恢复默认(覆盖副本)", () => void specAction("reset")));
|
|
3118
|
+
specBody.appendChild(actions);
|
|
3119
|
+
specBody.appendChild(mk("p", "hint", "改这些人读文档**不影响契约与门禁**(那只看 spec/norms 的机器规范);要不要把副本入库由你定。"));
|
|
3120
|
+
};
|
|
3121
|
+
const openSpecDoc = async (file) => {
|
|
3122
|
+
try {
|
|
3123
|
+
const d = await api("GET", `/api/projects/${encodeURIComponent(state.projectId)}/docs?file=${encodeURIComponent(file)}`);
|
|
3124
|
+
const c = mk("section", "config-card");
|
|
3125
|
+
c.appendChild(mk("h3", null, `${d.file} · ${d.source === "project" ? "项目副本" : "包内默认"}`));
|
|
3126
|
+
c.appendChild(mk("p", "hint", d.dir));
|
|
3127
|
+
const pre = mk("pre", "doc-preview"); pre.textContent = d.text;
|
|
3128
|
+
c.appendChild(pre);
|
|
3129
|
+
specBody.replaceChildren(c, btn("← 返回位置视图", () => void refreshSpec(), "ghost"));
|
|
3130
|
+
} catch (e) { showBanner(`打开失败:${e.message}`, "error"); }
|
|
3131
|
+
};
|
|
3132
|
+
const refreshSpec = async () => {
|
|
3133
|
+
const v = await api("GET", `/api/projects/${encodeURIComponent(state.projectId)}/docs`).catch(() => null);
|
|
3134
|
+
drawSpec(v);
|
|
3135
|
+
};
|
|
3136
|
+
const specAction = async (action) => {
|
|
3137
|
+
if (action === "reset" && !window.confirm("用安装包里的默认文档覆盖本项目副本?已做的修改会丢。")) return;
|
|
3138
|
+
try {
|
|
3139
|
+
const r = await api("POST", `/api/projects/${encodeURIComponent(state.projectId)}/docs`, { action, actor: "human" });
|
|
3140
|
+
showBanner(action === "materialize"
|
|
3141
|
+
? `已生成文档副本(写 ${r.written?.length ?? 0} 份 / 保留 ${r.kept?.length ?? 0} 份)⇒ ${r.dir}`
|
|
3142
|
+
: `已恢复默认(写 ${r.written?.length ?? 0} 份)`, "info");
|
|
3143
|
+
drawSpec(r.view);
|
|
3144
|
+
} catch (e) { showBanner(`${action === "reset" ? "恢复" : "生成"}失败:${e.message}`, "error"); }
|
|
3145
|
+
};
|
|
3146
|
+
box.appendChild(specCard);
|
|
3147
|
+
drawSpec(gSpec);
|
|
3148
|
+
|
|
2540
3149
|
const req = card("需求", "需求文档与条目的管理入口");
|
|
2541
3150
|
req.appendChild(row("需求视图", btn("打开", () => setView("req"), "primary")));
|
|
2542
3151
|
req.appendChild(row("新建需求条目", btn("新建", async () => {
|
|
2543
|
-
const
|
|
2544
|
-
|
|
2545
|
-
|
|
3152
|
+
const input = await askFields({
|
|
3153
|
+
title: "新建需求条目",
|
|
3154
|
+
hint: "标题写「动词开头 + 一句话」;详细内容按规范 07 在条目详情里补。",
|
|
3155
|
+
submit: "创建",
|
|
3156
|
+
fields: [{ name: "title", label: "需求条目标题 *", placeholder: "例如:需求条目面板工具区不再挤在左侧", required: true, requiredMessage: "需求条目标题不能为空" }],
|
|
3157
|
+
});
|
|
3158
|
+
if (!input) return;
|
|
3159
|
+
try { await api("POST", "/api/requirements/items", { projectId: state.projectId, title: input.title.trim() }); showBanner("已新建需求条目", "info"); await renderConfig(); }
|
|
2546
3160
|
catch (e) { showBanner(`新建失败:${e.message}`, "error"); }
|
|
2547
3161
|
})));
|
|
2548
3162
|
req.appendChild(row("AI 拆解(auto · 不可用即报错)", btn("拆解", async () => {
|
|
@@ -2608,6 +3222,11 @@
|
|
|
2608
3222
|
opsD.appendChild(kvList([
|
|
2609
3223
|
["数据目录", meta?.dataDir ?? "—"],
|
|
2610
3224
|
["数据库", meta?.dbPath ?? "—"],
|
|
3225
|
+
// 卡 `-236`/`-237`:同一个 dataDir 被多个宿主打开时,这里能一眼看出本窗口是哪个角色。
|
|
3226
|
+
["实例角色", state.instanceRole === "follower"
|
|
3227
|
+
? `只读跟随(${state.leaseOwner ? `${state.leaseOwner.host ?? "宿主"} · pid ${state.leaseOwner.pid ?? "?"}` : "对端实例"} 正在写)`
|
|
3228
|
+
: "写者(可读写)"],
|
|
3229
|
+
...(state.dataDirHint ? [["数据目录提示", state.dataDirHint.hint]] : []),
|
|
2611
3230
|
["接口版本", meta ? `schemaVersion=${meta.schemaVersion ?? "?"}` : "—"],
|
|
2612
3231
|
["工作台版本", `app v${window.__TB_BOARD__?.version ?? "?"}`],
|
|
2613
3232
|
]));
|
|
@@ -2630,6 +3249,7 @@
|
|
|
2630
3249
|
try {
|
|
2631
3250
|
const k = await api("GET", `/api/projects/${encodeURIComponent(state.projectId)}/kickoff`);
|
|
2632
3251
|
lastKickoff = k;
|
|
3252
|
+
alignGapState(k);
|
|
2633
3253
|
const wrap = mk("div", "kickoff-steps");
|
|
2634
3254
|
wrap.appendChild(mk("div", `kickoff-verdict ${k.ready ? "ok" : "warn"}`, `${k.ready ? "✔ " : "⚠ "}${k.verdict}`));
|
|
2635
3255
|
if (!k.readable) wrap.appendChild(mk("p", "hint", "项目未配置工作区目录(workspacePath)⇒ 文件类判据无法自检(设置里填上工作区即可)。"));
|
|
@@ -2652,11 +3272,51 @@
|
|
|
2652
3272
|
src.appendChild(link);
|
|
2653
3273
|
wrap.appendChild(src);
|
|
2654
3274
|
alignBody.replaceChildren(wrap);
|
|
2655
|
-
} catch (e) { alignBody.replaceChildren(mk("div", "empty-note", `自检失败:${e.message}(服务端旧版本需重载插件才有该端点)`)); }
|
|
3275
|
+
} catch (e) { alignBody.replaceChildren(mk("div", "empty-note", `自检失败:${e.message}(服务端旧版本需重载插件才有该端点)`)); alignGapState(null); }
|
|
2656
3276
|
};
|
|
3277
|
+
// 卡 `-229`(需求 R170):把**当前实时缺口**引入主对话(不是复制到剪贴板就结束)。
|
|
3278
|
+
// 零缺口 = 自检 `ready`(六步全 done ⇒ 没有任何未通过判据)⇒ 置灰 + 明说「开局已对齐」。
|
|
3279
|
+
// 不挂 `data-needs-host`:无宿主会话通道时服务端会回带正文,本按钮仍要有用(降级为复制 + 如实说明未投递)。
|
|
3280
|
+
const alignGapCount = (k) => (k?.missing ?? []).reduce((n, s) => n + (s.todo?.length ?? 0), 0);
|
|
3281
|
+
const gapHint = mk("span", "hint", "自检完成后可点");
|
|
3282
|
+
const gapBtn = btn("引入主对话", () => void announceGaps(), "primary");
|
|
3283
|
+
gapBtn.disabled = true;
|
|
3284
|
+
const alignGapState = (k) => {
|
|
3285
|
+
const n = alignGapCount(k);
|
|
3286
|
+
const aligned = Boolean(k?.ready) || (k ? n === 0 : false);
|
|
3287
|
+
gapBtn.disabled = !k || aligned;
|
|
3288
|
+
gapBtn.title = !k ? "自检完成后可点" : aligned ? "开局已对齐:没有缺口可引入" : `把当前 ${n} 项缺口引入项目主会话`;
|
|
3289
|
+
gapHint.textContent = !k ? "自检完成后可点" : aligned ? "开局已对齐" : `缺口 ${n} 项(按依赖顺序引入)`;
|
|
3290
|
+
};
|
|
3291
|
+
const announceGaps = async () => {
|
|
3292
|
+
if (!lastKickoff) { showBanner("请先「重新自检」拿到当前缺口", "error"); return; }
|
|
3293
|
+
if (lastKickoff.ready) { showBanner("开局已对齐:没有缺口可引入", "info"); return; }
|
|
3294
|
+
gapBtn.disabled = true;
|
|
3295
|
+
try {
|
|
3296
|
+
const r = await api("POST", `/api/projects/${encodeURIComponent(state.projectId)}/kickoff/announce`, {});
|
|
3297
|
+
if (r?.delivered) {
|
|
3298
|
+
showBanner(`已把 ${r?.gaps?.count ?? "?"} 项缺口引入主会话 ${String(r.sessionId ?? "").slice(0, 12)}…(按依赖顺序推进;每完成一项回本页点「重新自检」)`, "info");
|
|
3299
|
+
} else if (r?.prompt) {
|
|
3300
|
+
const copied = await copyText(r.prompt);
|
|
3301
|
+
showBanner(`未投递(${r?.reason === "host-unavailable" ? "本实例没有宿主会话通道" : (r?.reason ?? "原因未知")}):缺口清单${copied ? "已复制到剪贴板" : "复制失败,请点「复制对齐清单」手动投递"} —— 这不是「已引入」;下一步:${r?.nextAction ?? "到 DSH 内的任务工作台重试"}`, "error");
|
|
3302
|
+
} else {
|
|
3303
|
+
showBanner(`未投递:${r?.reason ?? "未知原因"};请点「复制对齐清单」手工投递`, "error");
|
|
3304
|
+
}
|
|
3305
|
+
} catch (e) {
|
|
3306
|
+
const fallback = e?.details?.prompt ?? null;
|
|
3307
|
+
const copied = fallback ? await copyText(fallback) : false;
|
|
3308
|
+
const why = e?.code === "NO_MAIN_SESSION"
|
|
3309
|
+
? "该项目还没有主会话:先在本卡「会话关联」重建/绑定主会话,再点「引入主对话」"
|
|
3310
|
+
: `投递失败:${e?.message ?? e}${e?.code ? `(${e.code})` : ""}`;
|
|
3311
|
+
showBanner(`${why}${fallback ? `;缺口清单${copied ? "已复制到剪贴板" : "复制失败,请点「复制对齐清单」手动投递"}(未投递)` : ""}`, "error");
|
|
3312
|
+
} finally { alignGapState(lastKickoff); }
|
|
3313
|
+
};
|
|
3314
|
+
|
|
2657
3315
|
const alignBar = mk("div", "btn-row");
|
|
2658
3316
|
alignBar.append(
|
|
2659
|
-
btn("重新自检", () => void refreshAlign()
|
|
3317
|
+
btn("重新自检", () => void refreshAlign()),
|
|
3318
|
+
gapBtn,
|
|
3319
|
+
gapHint,
|
|
2660
3320
|
btn("复制对齐清单", () => {
|
|
2661
3321
|
const k = lastKickoff;
|
|
2662
3322
|
if (!k) { showBanner("请先「重新自检」拿到清单", "error"); return; }
|
|
@@ -2729,7 +3389,15 @@
|
|
|
2729
3389
|
};
|
|
2730
3390
|
const mainRow = sessList.main ?? (state.context?.mainSessionId ? { sessionId: state.context.mainSessionId, liveness: null } : null);
|
|
2731
3391
|
if (mainRow) {
|
|
2732
|
-
|
|
3392
|
+
// 卡 `-227`:主会话行加「打开会话」;标签挂 `title`(截断文本不再丢完整标识)。
|
|
3393
|
+
const mainLabel = mk("span", null, `主会话 · ${String(mainRow.sessionId).slice(0, 14)}…`);
|
|
3394
|
+
mainLabel.title = String(mainRow.sessionId);
|
|
3395
|
+
links.appendChild(row(
|
|
3396
|
+
mainLabel,
|
|
3397
|
+
livenessPill(mainRow.liveness),
|
|
3398
|
+
hostBtn("打开会话", () => openSessionJump(mainRow.sessionId)),
|
|
3399
|
+
sessList.staleMain ? btn("重建并绑定主会话", rebindMain, "primary") : mk("span", "hint", ""),
|
|
3400
|
+
));
|
|
2733
3401
|
}
|
|
2734
3402
|
// FR-84 补口(2026-10-22):**不新建会话**的接续出口(宿主建会话不可用时的保底路径)。
|
|
2735
3403
|
const bindBar = mk("div", "tb-bind-bar");
|
|
@@ -2763,9 +3431,13 @@
|
|
|
2763
3431
|
links.appendChild(probeLine);
|
|
2764
3432
|
if ((sessList.sessions ?? []).length) {
|
|
2765
3433
|
for (const s of sessList.sessions) {
|
|
3434
|
+
// 卡 `-227`:每条相关会话都能直接跳过去(待批准的也允许 —— 存在不代表不能用来看历史)。
|
|
3435
|
+
const sessLabel = mk("span", null, `${s.status === "approved" ? "✅ 已批准" : "⏳ 待批准"} · ${String(s.sessionId).slice(0, 14)}…`);
|
|
3436
|
+
sessLabel.title = String(s.sessionId);
|
|
2766
3437
|
links.appendChild(row(
|
|
2767
|
-
|
|
3438
|
+
sessLabel,
|
|
2768
3439
|
livenessPill(s.liveness),
|
|
3440
|
+
hostBtn("打开会话", () => openSessionJump(s.sessionId)),
|
|
2769
3441
|
s.status === "pending" ? btn("批准", async () => {
|
|
2770
3442
|
try { await api("POST", `/api/projects/${encodeURIComponent(state.projectId)}/sessions/approve`, { sessionId: s.sessionId }); showBanner("已批准关联", "info"); await renderConfig(); }
|
|
2771
3443
|
catch (e) { showBanner(`批准失败:${e.message}`, "error"); }
|
|
@@ -2927,7 +3599,41 @@
|
|
|
2927
3599
|
if (engine === "nanmicoder") return `请用【@nanmicoder/dsh-agent-teams】创建一个完整执行团队(approval=required,先出计划、由人确认后再启动):agent_teams_create({ name, approval:"required", plan:{ members:[{name,role,provider,model}], tasks:[...] } })。\n${roster}\n队长=本会话(lead):按依赖就绪派发、汇总回流。\n红线:执行侧不得置"完成";不 commit/push/publish。`;
|
|
2928
3600
|
return `当前为【指令降级(P2)】:不驱动团队插件,只把以下派发指令发给会话并记账。\n${roster}\n(如需真正执行,请在配置里切换到官方或 @nanmicoder 引擎。)`;
|
|
2929
3601
|
};
|
|
2930
|
-
|
|
3602
|
+
/**
|
|
3603
|
+
* 需求 `R177`(卡 `-243`,2026-11-12 真机):**开局提示词必须自证「哪个项目 + 哪个工作目录」**。
|
|
3604
|
+
*
|
|
3605
|
+
* 原实现是一条**纯静态常量**,工作目录写死成一个尖括号占位符(形如「工作目录:‹…›」)——
|
|
3606
|
+
* 从任何项目配置页复制出来的文本一字不差,新会话里的 agent 拿不到项目标识 ⇒
|
|
3607
|
+
* `taskboard_context` 按会话 cwd 匹配不到任何项目 ⇒ `binding.mjs` **静默回落默认项目** ⇒
|
|
3608
|
+
* agent 按**别的仓库**的目录开工(真机现场:拿着 `taskboard-workbench` 的 AGENTS.md 去改另一个项目)。
|
|
3609
|
+
*
|
|
3610
|
+
* 口径三条:① 项目以 **id** 为准(名字只是给人看的补充);② 工作目录写**真实绝对路径**,
|
|
3611
|
+
* 不留任何字面占位符;③ 项目没设 `workspacePath` ⇒ **如实写「请先在配置页补」**,
|
|
3612
|
+
* 不写空值、也不猜路径(猜出来的路径正是这条 bug 的成因)。
|
|
3613
|
+
*
|
|
3614
|
+
* 纯函数:只吃 `{ id, name, workspacePath }`,不碰全局状态 —— 因此可在 `new Function` 里单测(见
|
|
3615
|
+
* `tests/kickoff-prompt-project.test.mjs`)。
|
|
3616
|
+
*/
|
|
3617
|
+
/** 开局提示词的**流程正文**(①–⑧):与项目无关,故单列;前半段「项目 / 工作目录」由 `buildKickoffPrompt` 插值。 */
|
|
3618
|
+
const KICKOFF_STEPS = "① 先做「项目开局对齐」六步自检(配置页 → 项目开局对齐):统一代码规范 / 文档驱动 / Git 协作流程 / 代码审查门 / 协作机制与知识沉淀 / 明确分工;缺哪步补哪步(依据《Vibe Coding 团队协作技巧》,对齐结果要能核验);\n② 确认已加载「任务工作台」插件 + agent team 插件可用;\n③ 绑定项目到本会话作为初始会话;\n④ 配置「项目入口·初始化」:创建执行团队 + 约定环境约束(把①的对齐结论写进 envConfig / teamTemplate);\n⑤ 引入项目资料(md/doc);\n⑥ 团队完成需求梳理 → 落盘需求文档;\n⑦ 拆解成看板任务并归因;\n⑧ 授权开工 → 派发执行 → 反馈回流(执行侧不得写 done)。";
|
|
3619
|
+
function buildKickoffPrompt(project) {
|
|
3620
|
+
const id = String(project?.id ?? "").trim();
|
|
3621
|
+
const name = String(project?.name ?? "").trim();
|
|
3622
|
+
const workspacePath = String(project?.workspacePath ?? "").trim();
|
|
3623
|
+
const noWorkspace = "(项目未设 workspacePath → 请先在配置页补)";
|
|
3624
|
+
const head = [
|
|
3625
|
+
"【项目开局】你是本项目队长(lead)。",
|
|
3626
|
+
`项目:${id || "(未解析)"}${name ? `(${name})` : ""}`,
|
|
3627
|
+
`工作目录:${workspacePath || noWorkspace}`,
|
|
3628
|
+
];
|
|
3629
|
+
if (workspacePath) {
|
|
3630
|
+
head.push(`本会话的看板读写**只作用于**这个项目:taskboard_context 传 cwd=${workspacePath};taskboard_* 写操作传 project=${id || "(项目 id)"}。`);
|
|
3631
|
+
} else {
|
|
3632
|
+
head.push("⚠ 该项目还没有工作目录:先在配置页「当前绑定」补 workspacePath,再开新会话;否则 agent 只能按 cwd 回落默认项目。");
|
|
3633
|
+
}
|
|
3634
|
+
head.push("若当前会话的工作目录不是它 ⇒ **不要**在这里开工:请用户在该目录重开会话(按 cwd 回落会读到别的仓库)。");
|
|
3635
|
+
return `${head.join("\n")}\n${KICKOFF_STEPS}`;
|
|
3636
|
+
}
|
|
2931
3637
|
// 从需求文档里解析"资料清单" → 引入的文件列表
|
|
2932
3638
|
function parseIntakeFiles(body) {
|
|
2933
3639
|
const out = []; let inList = false;
|
|
@@ -2987,7 +3693,32 @@
|
|
|
2987
3693
|
return { folders: merged, files, folderCount, fileTotal, byteTotal };
|
|
2988
3694
|
}
|
|
2989
3695
|
|
|
2990
|
-
/**
|
|
3696
|
+
/**
|
|
3697
|
+
* 卡 `-226`(需求 `R167`):**文件类型徽标**的 kind —— 纯呈现,只决定图标的底色与字母。
|
|
3698
|
+
*
|
|
3699
|
+
* 真机批注(2026-11-05):「引入文件的样式我希望引用 dsh 侧边栏的文件列表样式」。
|
|
3700
|
+
* DSH 侧栏的每个文件前有一个按类型着色的小图标(`.mjs` 琥珀 / `.md` 绿 / `.json` 橙),
|
|
3701
|
+
* 扫一眼就能分辨「这是代码还是文档」。这里**不引入图标字体、不引外链资源**,只用 14×14 的
|
|
3702
|
+
* 圆角色块 + 8px 字母(纯 CSS 绘制),所以离线、随包、零请求。
|
|
3703
|
+
* ⚠️ 它**不参与** FR-96 的树结构 / 排序 / 计数 —— 那部分(`buildFileFolderTree`)一字未改。
|
|
3704
|
+
*/
|
|
3705
|
+
function fileKind(name) {
|
|
3706
|
+
const n = String(name ?? "").toLowerCase();
|
|
3707
|
+
if (/\.(mjs|cjs|js|jsx)$/.test(n)) return "js";
|
|
3708
|
+
if (/\.(ts|tsx|mts|cts)$/.test(n)) return "ts";
|
|
3709
|
+
if (/\.(md|markdown|mdx)$/.test(n)) return "md";
|
|
3710
|
+
if (/\.json$/.test(n)) return "json";
|
|
3711
|
+
if (/\.ya?ml$/.test(n)) return "yaml";
|
|
3712
|
+
if (/\.(png|jpe?g|gif|svg|webp|ico)$/.test(n)) return "img";
|
|
3713
|
+
if (/\.(css|scss|less)$/.test(n)) return "css";
|
|
3714
|
+
if (/\.(sh|bash|zsh)$/.test(n)) return "sh";
|
|
3715
|
+
return "file";
|
|
3716
|
+
}
|
|
3717
|
+
const FILE_KIND_LABEL = { js: "JS", ts: "TS", md: "MD", json: "{}", yaml: "YML", img: "IMG", css: "CSS", sh: "SH", file: "·" };
|
|
3718
|
+
|
|
3719
|
+
/** FR-96:渲染文件夹树 —— 叶子是文件;节点可展开/收起,**默认展开**(不隐藏任何文件)。
|
|
3720
|
+
* 卡 `-226`:叶子行由「名字 + spacer + 体积胶囊」改为「类型图标 + 名字 + 定宽体积列」,
|
|
3721
|
+
* 与 DSH 侧栏文件列表同一套语言;`ul`/`li`/`details`/`summary` 的**结构不变**(既有 11 项守卫照旧)。 */
|
|
2991
3722
|
function renderFileTree(tree) {
|
|
2992
3723
|
const wrap = mk("div", "req-tree");
|
|
2993
3724
|
const walk = (node, container) => {
|
|
@@ -3007,7 +3738,11 @@
|
|
|
3007
3738
|
for (const f of node.files) {
|
|
3008
3739
|
const li = mk("li", "req-file");
|
|
3009
3740
|
li.title = f.path;
|
|
3010
|
-
|
|
3741
|
+
const kind = fileKind(f.name);
|
|
3742
|
+
const icon = mk("span", "req-file-icon", FILE_KIND_LABEL[kind] ?? "·");
|
|
3743
|
+
icon.dataset.kind = kind;
|
|
3744
|
+
icon.setAttribute("aria-hidden", "true");
|
|
3745
|
+
li.append(icon, mk("span", "req-file-name", f.name), mk("span", "req-file-size", `${f.bytes} B`));
|
|
3011
3746
|
ul.appendChild(li);
|
|
3012
3747
|
}
|
|
3013
3748
|
container.appendChild(ul);
|
|
@@ -3251,7 +3986,9 @@
|
|
|
3251
3986
|
mk("span", "hint", `${tree.folderCount} 个文件夹 · 根级文件 ${tree.files.length} · 合计 ${(tree.byteTotal / 1024).toFixed(1)} KB`),
|
|
3252
3987
|
);
|
|
3253
3988
|
fs.appendChild(head);
|
|
3254
|
-
|
|
3989
|
+
// 卡 `-226`:工具条不再用 `.field-inline`(那个是表单行,`align-items: flex-end` 会贴底),
|
|
3990
|
+
// 改为树自己的紧凑工具栏(左侧起头、与树的左内边距对齐)。
|
|
3991
|
+
const bar = mk("div", "req-tree-tools");
|
|
3255
3992
|
bar.append(btn("全部展开", () => setAllFolders(fs, true)), btn("全部收起", () => setAllFolders(fs, false)));
|
|
3256
3993
|
fs.appendChild(bar);
|
|
3257
3994
|
fs.appendChild(renderFileTree(tree));
|
|
@@ -3302,7 +4039,10 @@
|
|
|
3302
4039
|
const newTitle = mk("input");
|
|
3303
4040
|
newTitle.type = "text";
|
|
3304
4041
|
newTitle.placeholder = "新条目标题";
|
|
3305
|
-
|
|
4042
|
+
// 卡 `-225`(需求 `R166`):真机批注「同类输入框&按钮都挤在左侧」。三段(新建 / 筛选 / 批量)
|
|
4043
|
+
// 现在各自成行并挂在 `.req-toolbar` 里 —— 行内左右分组、控件同高,行距由容器统一给。
|
|
4044
|
+
// 不再套 `.field-inline`(全局表单类,`align-items: flex-end` 会把同排控件压得基线不齐)。
|
|
4045
|
+
const createRow = mk("div", "req-toolbar-row req-toolbar-create");
|
|
3306
4046
|
// 真机批注 2026-10-28「新建条目点击无效」:此前标题为空时**静默 return** —— 点了没反应、
|
|
3307
4047
|
// 也没有任何提示,被读成按钮坏了。口径:空标题必须**当场说话**并把焦点送回输入框;
|
|
3308
4048
|
// 另外支持回车提交(填完标题顺手敲回车是常态)。
|
|
@@ -3323,7 +4063,8 @@
|
|
|
3323
4063
|
event.preventDefault();
|
|
3324
4064
|
void createItem();
|
|
3325
4065
|
});
|
|
3326
|
-
|
|
4066
|
+
const reqToolbar = mk("div", "req-toolbar");
|
|
4067
|
+
reqToolbar.appendChild(createRow);
|
|
3327
4068
|
const filt = mk("select");
|
|
3328
4069
|
// FR-91:新增「已完成 / 已关闭」——需求层此前没有"做完了没有"的落点
|
|
3329
4070
|
for (const [v, l] of [["all", "全部状态"], ["draft", "待确认"], ["open", "在办"], ["done", "已完成"], ["closed", "已关闭"]]) { const o = mk("option"); o.value = v; o.textContent = l; filt.appendChild(o); }
|
|
@@ -3334,11 +4075,13 @@
|
|
|
3334
4075
|
search.placeholder = "搜索编号 / 标题";
|
|
3335
4076
|
search.value = reqState.q ?? "";
|
|
3336
4077
|
search.addEventListener("change", () => { reqState.q = search.value.trim(); void renderRequirements(); });
|
|
3337
|
-
const fr = mk("div", "
|
|
3338
|
-
|
|
3339
|
-
|
|
3340
|
-
|
|
3341
|
-
|
|
4078
|
+
const fr = mk("div", "req-toolbar-row req-toolbar-filter");
|
|
4079
|
+
// U-1:下一步引导(团队先行后的收敛路径)。卡 `-225`:从独占一行改为**并到筛选行右侧**
|
|
4080
|
+
// (宽视口右对齐、窄视口自动换行),不再让左侧控件与右侧长提示之间空出一大片。
|
|
4081
|
+
const nextHint = mk("p", "hint req-toolbar-hint", `下一步:确认条目 → 生成看板任务 → 授权开工 → 派发执行 (待确认 ${draftCount} · 已确认 ${openCount})`);
|
|
4082
|
+
fr.append(filt, search, nextHint);
|
|
4083
|
+
reqToolbar.appendChild(fr);
|
|
4084
|
+
itemBody.appendChild(reqToolbar);
|
|
3342
4085
|
if (reqState.candidates.length) {
|
|
3343
4086
|
const cs = mk("div", "drawer-section");
|
|
3344
4087
|
cs.appendChild(mk("h3", null, `待确认候选(${reqState.candidates.length})`));
|
|
@@ -3385,9 +4128,12 @@
|
|
|
3385
4128
|
: "逐行从既有 GET /api/requirements/items/:ref/completion 取数:关联任务全部收口的需求会显示「可收口」";
|
|
3386
4129
|
};
|
|
3387
4130
|
// 批量工具条(默认多选 → 批量生成任务)
|
|
3388
|
-
|
|
4131
|
+
// 卡 `-225`:批量条拆成「左=已选 N」+「右=动作组」。此前六个元素从左往右平铺,
|
|
4132
|
+
// 蓝色主按钮夹在中间、删除紧挨生成 —— 既难扫也危险(误点批量删除)。
|
|
4133
|
+
const bulkBar = mk("div", "req-bulk-bar");
|
|
4134
|
+
const bulkActions = mk("div", "req-bulk-actions");
|
|
3389
4135
|
bulkBar.append(
|
|
3390
|
-
mk("span", "hint", `已选 ${reqState.selected.size}`),
|
|
4136
|
+
mk("span", "hint req-bulk-count", `已选 ${reqState.selected.size}`),
|
|
3391
4137
|
btn("全选可见", () => { for (const it of visible) reqState.selected.add(it.identifier); void renderRequirements(); }),
|
|
3392
4138
|
btn("清除选择", () => { reqState.selected.clear(); void renderRequirements(); }),
|
|
3393
4139
|
btn("批量确认", async () => {
|
|
@@ -3417,8 +4163,11 @@
|
|
|
3417
4163
|
reqState.selected.clear();
|
|
3418
4164
|
showBanner(failed.length ? `已删除 ${ok} 条,失败 ${failed.length} 条(首条:${failed[0]})` : `已删除 ${ok} 条`, failed.length ? "error" : "info");
|
|
3419
4165
|
await renderRequirements();
|
|
3420
|
-
}),
|
|
4166
|
+
}, "danger"),
|
|
3421
4167
|
);
|
|
4168
|
+
// 五个动作整体挪到右侧动作组(顺序保持:全选 → 清除 → 批量确认 → 批量生成 → 批量删除)
|
|
4169
|
+
bulkActions.append(...Array.from(bulkBar.querySelectorAll(":scope > button")));
|
|
4170
|
+
bulkBar.appendChild(bulkActions);
|
|
3422
4171
|
itemBody.appendChild(bulkBar);
|
|
3423
4172
|
const ul = mk("ul", "req-list");
|
|
3424
4173
|
for (const it of visible) {
|
|
@@ -3442,6 +4191,9 @@
|
|
|
3442
4191
|
const completionChip = reqCompletionChip(it, reqState.completion.get(it.identifier)?.payload ?? null);
|
|
3443
4192
|
const meta = mk("div", "req-item-meta");
|
|
3444
4193
|
meta.append(pill(srcLabel, it.source === "intake" ? "" : "accent"));
|
|
4194
|
+
// 卡 `-218`(R159 D-1=`c`):**行上**就要看出这条是不是残片/镜像 —— 不点进详情才发现的等于没标。
|
|
4195
|
+
const integrity = DETAIL_STATE_LABELS[it.detailState];
|
|
4196
|
+
if (integrity) meta.append(pill(integrity.text, integrity.tone, integrity.title));
|
|
3445
4197
|
if (it.feasibility === "infeasible") meta.append(pill("不可行", "danger"));
|
|
3446
4198
|
li.append(main, statusChip, completionChip, meta);
|
|
3447
4199
|
const acts = mk("div", "req-item-actions");
|
|
@@ -3589,6 +4341,7 @@
|
|
|
3589
4341
|
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); };
|
|
3590
4342
|
addF("状态", statusTxt);
|
|
3591
4343
|
addF("来源", srcLabel);
|
|
4344
|
+
addF("完整性", detailStateText(item.detailState), item.detailState === "truncated" ? "warn" : "");
|
|
3592
4345
|
addF("优先级", PRIORITY_LABELS[item.priority] ?? item.priority);
|
|
3593
4346
|
addF("可行性", item.feasibility ?? "未评估", item.feasibility === "infeasible" ? "danger" : item.feasibility === "feasible" ? "ok" : "");
|
|
3594
4347
|
if (item.acceptance) addF("验收要点", item.acceptance);
|
|
@@ -3884,6 +4637,10 @@
|
|
|
3884
4637
|
} catch (error) {
|
|
3885
4638
|
host.replaceChildren(head, mk("p", "hint", `加载失败:${error.message}`));
|
|
3886
4639
|
}
|
|
4640
|
+
// 卡 `-224`:本区块是**异步后补**的(`void fillTaskTeam(...)`,晚于 openTaskDetail 的收尾归一),
|
|
4641
|
+
// 且它在未归因时会追加一个 primary「去归因」—— 这里补一次归一,否则「一屏一个主按钮」会被
|
|
4642
|
+
// 后到的按钮破坏(验证台实测:primary=2,两条都在团队区块与「下一步」区)。
|
|
4643
|
+
normalizeActionTiers();
|
|
3887
4644
|
}
|
|
3888
4645
|
/** FR-42/47:从任务详情发起一次团队派发(单任务;引擎经 /api/teams 决定,默认 P2 指令降级)。 */
|
|
3889
4646
|
async function dispatchTeam(identifier, onDone) {
|
|
@@ -3905,6 +4662,195 @@
|
|
|
3905
4662
|
showBanner(`派发失败(${identifier}):${error.message}${error.code ? `(${error.code})` : ""}`, "error");
|
|
3906
4663
|
}
|
|
3907
4664
|
}
|
|
4665
|
+
// ── 卡 `-238`(需求 `R174`):执行者按卡选择 ─────────────────────────────────
|
|
4666
|
+
// 前端**唯一**的执行者知识:只认 `GET /api/executors` 给的 `id` / `kind`。
|
|
4667
|
+
// **不硬编码任何命令行** —— 参数在服务端注册表里,前端说了不算(改参数只改一处)。
|
|
4668
|
+
// 未安装 / 被项目 `forbiddenExecutors` 禁用 ⇒ 置灰 + `title` 写明原因,不把注定被拒的路摆到人面前。
|
|
4669
|
+
const AGENT_ICON_PATHS = {
|
|
4670
|
+
// 16×16、单色 `currentColor`、内联(不引图标字体、不引外部资源)
|
|
4671
|
+
team: [
|
|
4672
|
+
"M6 7.4a2.2 2.2 0 1 0 0-4.4 2.2 2.2 0 0 0 0 4.4Z",
|
|
4673
|
+
"M11 7.2a1.8 1.8 0 1 0 0-3.6 1.8 1.8 0 0 0 0 3.6Z",
|
|
4674
|
+
"M2.1 13.6c0-2 1.8-3.6 3.9-3.6s3.9 1.6 3.9 3.6v.5H2.1v-.5Z",
|
|
4675
|
+
"M11 9.9c1.7 0 3.1 1.2 3.1 2.7v.5h-3.2v-.5c0-1.1-.4-2-1.1-2.7",
|
|
4676
|
+
],
|
|
4677
|
+
dsh: [
|
|
4678
|
+
"M3.2 2.4h3.9c3.3 0 5.6 2.2 5.6 5.6s-2.3 5.6-5.6 5.6H3.2V2.4Zm2.3 2.2v6.8h1.5c2 0 3.3-1.3 3.3-3.4S9 4.6 7 4.6H5.5Z",
|
|
4679
|
+
"M2.2 13.2h11.6v1.4H2.2v-1.4Z",
|
|
4680
|
+
],
|
|
4681
|
+
claude: [
|
|
4682
|
+
"M8 1.3l1.15 4.55 4.55-1.15-3.4 3.3 3.4 3.3-4.55-1.15L8 14.7l-1.15-4.55L2.3 11.3l3.4-3.3-3.4-3.3 4.55 1.15L8 1.3Z",
|
|
4683
|
+
],
|
|
4684
|
+
codex: [
|
|
4685
|
+
"M8 1.5l5.6 3.2v6.6L8 14.5 2.4 11.3V4.7L8 1.5Zm0 3L4.8 6.3v3.4L8 11.5l3.2-1.8V6.3L8 4.5Z",
|
|
4686
|
+
],
|
|
4687
|
+
hermes: [
|
|
4688
|
+
"M1.5 8.3l12.4-6-3.2 11-2.9-4-6.3-1Z",
|
|
4689
|
+
],
|
|
4690
|
+
};
|
|
4691
|
+
function agentIcon(agent) {
|
|
4692
|
+
const paths = AGENT_ICON_PATHS[agent] ?? AGENT_ICON_PATHS.team;
|
|
4693
|
+
const svg = doc.createElementNS("http://www.w3.org/2000/svg", "svg");
|
|
4694
|
+
svg.setAttribute("viewBox", "0 0 16 16");
|
|
4695
|
+
svg.setAttribute("aria-hidden", "true");
|
|
4696
|
+
svg.setAttribute("focusable", "false");
|
|
4697
|
+
svg.classList.add("tb-agent-icon");
|
|
4698
|
+
for (const d of paths) {
|
|
4699
|
+
const path = doc.createElementNS("http://www.w3.org/2000/svg", "path");
|
|
4700
|
+
path.setAttribute("d", d);
|
|
4701
|
+
svg.appendChild(path);
|
|
4702
|
+
}
|
|
4703
|
+
return svg;
|
|
4704
|
+
}
|
|
4705
|
+
|
|
4706
|
+
/**
|
|
4707
|
+
* 执行者清单按 `projectId` 缓存 60s(`forbiddenExecutors` / `executionTeam` 都是项目设置)。
|
|
4708
|
+
* @returns {Promise<{ list: Array, defaultId: string|null }>}
|
|
4709
|
+
* `defaultId` 由服务端给(=「不换执行者时本来会走谁」),前端不自己猜项目配置。
|
|
4710
|
+
*/
|
|
4711
|
+
const executorsCache = new Map();
|
|
4712
|
+
async function loadExecutors(projectId) {
|
|
4713
|
+
const key = String(projectId ?? "");
|
|
4714
|
+
const hit = executorsCache.get(key);
|
|
4715
|
+
if (hit && Date.now() - hit.at < 60000) return { list: hit.list, defaultId: hit.defaultId };
|
|
4716
|
+
const payload = await api("GET", `/api/executors?projectId=${encodeURIComponent(key)}`);
|
|
4717
|
+
const list = Array.isArray(payload?.executors) ? payload.executors : [];
|
|
4718
|
+
const defaultId = typeof payload?.defaultId === "string" ? payload.defaultId : null;
|
|
4719
|
+
executorsCache.set(key, { at: Date.now(), list, defaultId });
|
|
4720
|
+
return { list, defaultId };
|
|
4721
|
+
}
|
|
4722
|
+
|
|
4723
|
+
/**
|
|
4724
|
+
* 按 `kind` 分流到**三条既有入口** —— 这里只做分发,**不新开任何旁路**:
|
|
4725
|
+
* 归因门 / 授权门 / 人工校验门 / 评审门全在服务端原处照旧。
|
|
4726
|
+
*/
|
|
4727
|
+
async function runWithExecutor(task, executor, onDone) {
|
|
4728
|
+
const ref = encodeURIComponent(task.identifier);
|
|
4729
|
+
if (executor.kind === "team") {
|
|
4730
|
+
await dispatchTeam(task.identifier, onDone);
|
|
4731
|
+
return `已派发团队执行(${task.identifier})`;
|
|
4732
|
+
}
|
|
4733
|
+
if (executor.kind === "host-session") {
|
|
4734
|
+
const r = await api("POST", `/api/tasks/${ref}/execute`, {});
|
|
4735
|
+
const launch = r?.launch ?? null;
|
|
4736
|
+
onDone?.();
|
|
4737
|
+
return `已下发宿主会话:mode=${launch?.mode ?? "?"}${launch?.sessionId ? ` · 会话 ${String(launch.sessionId).slice(0, 12)}` : ""}`;
|
|
4738
|
+
}
|
|
4739
|
+
const r = await api("POST", `/api/tasks/${ref}/exec-cli`, { executor: executor.id, async: true });
|
|
4740
|
+
onDone?.();
|
|
4741
|
+
return `已提交 ${executor.label} 后台执行(${r?.executor ?? executor.id})`;
|
|
4742
|
+
}
|
|
4743
|
+
|
|
4744
|
+
/**
|
|
4745
|
+
* 执行者图标行。
|
|
4746
|
+
* @returns {{ node: HTMLElement, selected: () => string|null, list: () => Array }}
|
|
4747
|
+
* `selected()` 给同区块的「预览 / 执行」按钮取当前选择(否则选了 codex 却预览 claude = 预览在骗人)。
|
|
4748
|
+
*
|
|
4749
|
+
* 挂点(稳定,供验证台定位,不靠中文文案):`data-exec-picker` / `data-executor` / `data-executor-kind`。
|
|
4750
|
+
*/
|
|
4751
|
+
function mountExecutorPicker(task, { onDone, note: idleNote = null, kinds = null } = {}) {
|
|
4752
|
+
const wrap = mk("div", "tb-exec-picker");
|
|
4753
|
+
wrap.setAttribute("data-exec-picker", "1");
|
|
4754
|
+
wrap.appendChild(mk("span", "tb-exec-picker-label", "执行者"));
|
|
4755
|
+
const choices = mk("div", "tb-exec-picker-choices");
|
|
4756
|
+
const launch = mk("button", "tb-exec-launch", "用所选执行者启动");
|
|
4757
|
+
launch.type = "button";
|
|
4758
|
+
launch.disabled = true;
|
|
4759
|
+
const note = mk("p", "hint tb-exec-note", "加载执行者…");
|
|
4760
|
+
wrap.append(choices, launch, note);
|
|
4761
|
+
|
|
4762
|
+
// 每条通道**此刻**能不能走:服务端注册表只回答「装了没 / 被禁没」,
|
|
4763
|
+
// 「这张卡现在准不准从这条路走」是**卡的状态**决定的(归因门 / 授权门 / 人工校验门),
|
|
4764
|
+
// 与既有「启动执行 / 交给 CLI 执行器执行」用同一把尺子(`executionEntry` / `cliEntry`),不另判一套。
|
|
4765
|
+
const channelBlocker = (executor) => {
|
|
4766
|
+
if (executor.kind === "cli") {
|
|
4767
|
+
const entry = cliEntry(task);
|
|
4768
|
+
if (entry === "start") return null;
|
|
4769
|
+
return entry === "human-review"
|
|
4770
|
+
? "人工校验任务(FR-85b 升级门):结论只能人给,不得交给执行器"
|
|
4771
|
+
: "本卡未归属需求条目:先归因再执行(EXECUTION_NOT_ATTRIBUTED)";
|
|
4772
|
+
}
|
|
4773
|
+
const entry = executionEntry(task);
|
|
4774
|
+
if (entry === "start") return null;
|
|
4775
|
+
if (entry === "attribute") return "本卡未归属需求条目:先归因再执行";
|
|
4776
|
+
if (entry === "authorize") return "本卡还在「待办池」:先授权开工(授权只是放行,仍需人点执行)";
|
|
4777
|
+
return `当前状态「${STATUS_LABELS[task.status] ?? task.status}」不可从这里启动(仅「可开工」卡可启动)`;
|
|
4778
|
+
};
|
|
4779
|
+
let all = [];
|
|
4780
|
+
let list = [];
|
|
4781
|
+
let selectedId = null;
|
|
4782
|
+
const buttons = [];
|
|
4783
|
+
const pick = (id) => {
|
|
4784
|
+
selectedId = id;
|
|
4785
|
+
for (const button of buttons) button.setAttribute("aria-pressed", String(button.dataset.executor === id));
|
|
4786
|
+
const chosen = buttons.find((button) => button.dataset.executor === id) ?? null;
|
|
4787
|
+
launch.disabled = !chosen || chosen.disabled;
|
|
4788
|
+
};
|
|
4789
|
+
|
|
4790
|
+
void (async () => {
|
|
4791
|
+
let defaultId = null;
|
|
4792
|
+
try { ({ list: all, defaultId } = await loadExecutors(task.projectId)); }
|
|
4793
|
+
catch (error) {
|
|
4794
|
+
note.textContent = `执行者清单加载失败:${error.message}(其余按钮不受影响)`;
|
|
4795
|
+
return;
|
|
4796
|
+
}
|
|
4797
|
+
// `kinds` 过滤:CLI 区块里放「团队 / 宿主会话」只会让人点出一个必然 400 的按钮。
|
|
4798
|
+
list = kinds ? all.filter((executor) => kinds.includes(executor.kind)) : all;
|
|
4799
|
+
if (!list.length) { note.textContent = "没有可用执行者:/api/executors 返回空清单(旧版服务端?)"; return; }
|
|
4800
|
+
for (const executor of list) {
|
|
4801
|
+
const button = mk("button", "tb-exec-choice");
|
|
4802
|
+
button.type = "button";
|
|
4803
|
+
button.dataset.executor = executor.id;
|
|
4804
|
+
button.dataset.executorKind = executor.kind;
|
|
4805
|
+
button.setAttribute("aria-pressed", "false");
|
|
4806
|
+
button.appendChild(agentIcon(executor.agent));
|
|
4807
|
+
button.appendChild(mk("span", null, executor.label));
|
|
4808
|
+
const blockedWhy = executor.usable ? channelBlocker(executor) : null;
|
|
4809
|
+
button.title = !executor.usable
|
|
4810
|
+
? `${executor.label} 不可用:${executor.reason ?? "原因未知"}`
|
|
4811
|
+
: blockedWhy ? `${executor.label}:${blockedWhy}` : `${executor.label} · ${executor.hint}`;
|
|
4812
|
+
button.disabled = !executor.usable || Boolean(blockedWhy);
|
|
4813
|
+
// 供验证台断言「为什么灰」:状态码化,不靠中文文案。
|
|
4814
|
+
button.dataset.execBlocked = !executor.usable ? "unusable" : blockedWhy ? "gate" : "ok";
|
|
4815
|
+
button.addEventListener("click", () => pick(executor.id));
|
|
4816
|
+
buttons.push(button);
|
|
4817
|
+
choices.appendChild(button);
|
|
4818
|
+
}
|
|
4819
|
+
const unavailable = buttons.filter((button) => button.disabled);
|
|
4820
|
+
// 默认选中:**服务端给的 `defaultId`**(= 不换执行者时本来会走谁),不可用才退第一个可用的。
|
|
4821
|
+
const preferred = list.find((executor) => executor.id === defaultId && executor.usable)
|
|
4822
|
+
?? list.find((executor) => executor.usable)
|
|
4823
|
+
?? null;
|
|
4824
|
+
if (preferred) pick(preferred.id);
|
|
4825
|
+
note.textContent = idleNote ?? (unavailable.length
|
|
4826
|
+
? `选中后点「用所选执行者启动」;${unavailable.length} 个执行者当前不可用(悬停看原因)。原有「启动执行」固定走宿主会话。`
|
|
4827
|
+
: "选中后点「用所选执行者启动」;原有「启动执行」固定走宿主会话。三条通道的既有门(归因 / 人工校验 / 评审)一个不绕。");
|
|
4828
|
+
})();
|
|
4829
|
+
|
|
4830
|
+
launch.addEventListener("click", async () => {
|
|
4831
|
+
const chosen = list.find((executor) => executor.id === selectedId) ?? null;
|
|
4832
|
+
if (!chosen) return;
|
|
4833
|
+
const confirmText = chosen.kind === "team"
|
|
4834
|
+
? `把 ${task.identifier} 派发给「${chosen.label}」执行?\n\n· 派发后由项目执行团队接手(roles 由项目设置决定)\n· 完成回写「待验收」,收口仍由人确认`
|
|
4835
|
+
: chosen.kind === "host-session"
|
|
4836
|
+
? `把 ${task.identifier} 交给「${chosen.label}」执行?\n\n· 会尝试新建/切换会话(可能切换主视图)\n· 执行前先认领:卡片置「进行中」`
|
|
4837
|
+
: `把 ${task.identifier} 交给「${chosen.label}」**真实执行**?\n\n· 非交互调用本地 CLI(通常带文件写权限),耗时数十秒到数分钟\n· 执行前先认领:卡片置「进行中」\n· 完成后回流「待验收」或「受阻」,并附证据评论\n· 期间请勿重复点击`;
|
|
4838
|
+
if (typeof window !== "undefined" && typeof window.confirm === "function" && !window.confirm(confirmText)) return;
|
|
4839
|
+
launch.disabled = true;
|
|
4840
|
+
try {
|
|
4841
|
+
const message = await runWithExecutor(task, chosen, onDone);
|
|
4842
|
+
showBanner(message, "info");
|
|
4843
|
+
await loadTasks();
|
|
4844
|
+
} catch (error) {
|
|
4845
|
+
// 归因门等执行类拒绝走统一处置(与既有「启动执行 / 派发团队」同一套措辞与补救入口)
|
|
4846
|
+
if (error.code === "EXECUTION_NOT_ATTRIBUTED") { await handleExecutionFailure(error, task.identifier, task, "派发"); return; }
|
|
4847
|
+
showBanner(`派发失败(${task.identifier} · ${chosen.label}):${error.message}${error.code ? `(${error.code})` : ""}`, "error");
|
|
4848
|
+
} finally { launch.disabled = false; }
|
|
4849
|
+
});
|
|
4850
|
+
|
|
4851
|
+
return { node: wrap, selected: () => selectedId, list: () => list, reload: () => { executorsCache.delete(String(task.projectId ?? "")); } };
|
|
4852
|
+
}
|
|
4853
|
+
|
|
3908
4854
|
/**
|
|
3909
4855
|
* FR-108(卡 `-198`):交付阶段徽标的**唯一**渲染点。
|
|
3910
4856
|
* 文案只描述"交付物到哪一步",不替代"下一步点哪里"(那是 `next` 的活)。
|
|
@@ -4313,13 +5259,20 @@
|
|
|
4313
5259
|
}
|
|
4314
5260
|
// 入口口径与卡片、下一步面板同一份(executionEntry):未归因的可开工卡在抽屉里也给「去归因」。
|
|
4315
5261
|
const drawerEntry = executionEntry(t);
|
|
4316
|
-
|
|
5262
|
+
// 卡 `-224`:标题栏**不承担主按钮**。归因是「下一步」区的主动作(服务端 `goto-attribution`),
|
|
5263
|
+
// 标题栏只保留一条 `link` 指针(与 FR-89「下一列 → 处置见『下一步』」同一先例:
|
|
5264
|
+
// 同一动作不摆两个同等权重的平行入口)。
|
|
5265
|
+
if (drawerEntry === "attribute") {
|
|
5266
|
+
const gotoAttr = btn("去归因(见「归因」区)", () => { void openAttributionEntry(t); }, "link");
|
|
5267
|
+
gotoAttr.title = "等同于「下一步」区的「去归因(关联需求条目)」:展开并滚到下方「归因」区块";
|
|
5268
|
+
ops.appendChild(gotoAttr);
|
|
5269
|
+
}
|
|
4317
5270
|
// 第九报:待办池卡在抽屉里也要有显式入口(此前只有「下一列」按钮,得靠人自己推断那是授权)。
|
|
4318
5271
|
if (drawerEntry === "authorize") ops.appendChild(btn("授权开工(移出待办池)", async () => {
|
|
4319
5272
|
if (!window.confirm(`把 ${t.identifier} 移出「待办池」→「可开工」?授权只是放行,仍需人点「启动执行」或由团队/执行循环认领。`)) return;
|
|
4320
5273
|
const ok = await moveTask(t, "todo");
|
|
4321
5274
|
if (ok) showBanner(`${t.identifier} 已授权开工(待办池 → 可开工)。下一步:点「启动执行」,或让它被团队/执行循环认领。`, "info");
|
|
4322
|
-
}, "
|
|
5275
|
+
}, "secondary"));
|
|
4323
5276
|
if (drawerEntry === "start") ops.appendChild(btn("启动执行", async () => {
|
|
4324
5277
|
if (!window.confirm(`启动执行会尝试新建/切换会话(可能切换主视图)。${execRunning ? "\n\n⚠ 该任务已有执行会话正在执行且未返回结论,继续会被拒绝(EXECUTION_ALREADY_RUNNING)。" : ""}确认继续?`)) return;
|
|
4325
5278
|
try { await api("POST", `/api/tasks/${ref}/execute`, undefined); closeDrawer(); await loadTasks(); }
|
|
@@ -4327,11 +5280,11 @@
|
|
|
4327
5280
|
// 与卡片入口同一份处置(含「打开并高亮归因入口」),不再各写一套措辞。
|
|
4328
5281
|
await handleExecutionFailure(e, ref, t);
|
|
4329
5282
|
}
|
|
4330
|
-
}, "
|
|
5283
|
+
}, "secondary"));
|
|
4331
5284
|
if (t.status === "in_progress") {
|
|
4332
5285
|
const r2 = mk("div", "btn-row");
|
|
4333
5286
|
r2.append(
|
|
4334
|
-
btn("提交待验收", async () => { try { await api("POST", `/api/tasks/${ref}/execution/review`, {}); closeDrawer(); await loadTasks(); } catch (e) { showBanner(e.message, "error"); } }, "
|
|
5287
|
+
btn("提交待验收", async () => { try { await api("POST", `/api/tasks/${ref}/execution/review`, {}); closeDrawer(); await loadTasks(); } catch (e) { showBanner(e.message, "error"); } }, "secondary"),
|
|
4335
5288
|
btn("标记失败", async () => { try { await api("POST", `/api/tasks/${ref}/execution/fail`, { evidence: "手动标记失败" }); closeDrawer(); await loadTasks(); } catch (e) { showBanner(e.message, "error"); } }),
|
|
4336
5289
|
btn("退回待办(重新派发)", async () => {
|
|
4337
5290
|
const extra = execRunning ? "\n\n⚠ 该任务已有执行会话正在执行中;退回后会释放任务级锁,但再次下发仍会被拒(需等会话结束)。" : "";
|
|
@@ -4343,12 +5296,39 @@
|
|
|
4343
5296
|
);
|
|
4344
5297
|
ops.appendChild(r2);
|
|
4345
5298
|
}
|
|
4346
|
-
if (t.status === "blocked") ops.appendChild(btn("重试", async () => { try { await api("POST", `/api/tasks/${ref}/execution/retry`, {}); closeDrawer(); await loadTasks(); } catch (e) { showBanner(e.message, "error"); } }, "
|
|
5299
|
+
if (t.status === "blocked") ops.appendChild(btn("重试", async () => { try { await api("POST", `/api/tasks/${ref}/execution/retry`, {}); closeDrawer(); await loadTasks(); } catch (e) { showBanner(e.message, "error"); } }, "secondary"));
|
|
4347
5300
|
ops.appendChild(btn("拆解为子任务", async () => {
|
|
4348
5301
|
if (!window.confirm("按任务描述自动拆解为关联子任务?(无编号行则生成 实现/验证 两条)")) return;
|
|
4349
5302
|
try { const r = await api("POST", `/api/tasks/${ref}/decompose`, {}); showBanner(`已生成子任务:${(r.children || []).map((c) => c.identifier).join("、")}(待办池)`, "info"); closeDrawer(); await loadTasks(); }
|
|
4350
5303
|
catch (e) { showBanner(`拆解失败:${e.message}`, "error"); }
|
|
4351
5304
|
}));
|
|
5305
|
+
// 需求 `R180` / 卡 `-252`(2026-11-12 真机批注「这条任务确认不执行,但是人工操作没有关闭按钮」):
|
|
5306
|
+
// `canceled` 早就是合法终态(服务端 `PATCH /api/tasks/:ref {status:"canceled"}` 放行、库内已有既有 canceled 卡),
|
|
5307
|
+
// 缺的只是**前端入口** —— 「确认不执行」的卡此前只能挂着,或被人拖去别的列。
|
|
5308
|
+
// 口径三条(刻意如此):① 终态卡(done / canceled)不摆这枚按钮;② 必须写原因,空原因直接拒;
|
|
5309
|
+
// ③ 二次确认走**页内 dialog**(宿主没有 `window.prompt`,见卡 `-242`),撤单后落评论 + 审计,不是静默改库。
|
|
5310
|
+
if (t.status !== "done" && t.status !== "canceled") {
|
|
5311
|
+
ops.appendChild(btn("取消任务(撤单)", async () => {
|
|
5312
|
+
const filled = await askFields({
|
|
5313
|
+
title: `取消任务 ${t.identifier}`,
|
|
5314
|
+
hint: "撤单是终态:卡片进「已取消」。原因会写进评论 —— 后人必须能看懂为什么不执行。本动作不删除任何数据。",
|
|
5315
|
+
fields: [{ name: "reason", label: "撤单原因", multiline: true, rows: 3, required: true, requiredMessage: "撤单必须写原因" }],
|
|
5316
|
+
submit: "确认取消",
|
|
5317
|
+
});
|
|
5318
|
+
if (!filled) return;
|
|
5319
|
+
const reason = String(filled.reason ?? "").trim();
|
|
5320
|
+
if (!reason) { showBanner("撤单必须写原因(否则后人不知道为什么不执行)", "error"); return; }
|
|
5321
|
+
try {
|
|
5322
|
+
// 抽屉里的 `t` 可能是几十秒前的快照 ⇒ 先取最新 version,避免 VERSION_CONFLICT 白跑一次。
|
|
5323
|
+
const fresh = await api("GET", `/api/tasks/${ref}`);
|
|
5324
|
+
await api("PATCH", `/api/tasks/${ref}`, { version: fresh?.task?.version, status: "canceled", actor: "human" });
|
|
5325
|
+
await api("POST", `/api/tasks/${ref}/comments`, { body: `人工撤单(不执行):${reason}`, actor: "human" });
|
|
5326
|
+
closeDrawer(); await loadTasks(); showBanner(`${t.identifier} 已撤单(已取消)—— 依赖它的下游卡需要按「前置已撤单」重估`, "info");
|
|
5327
|
+
} catch (e) {
|
|
5328
|
+
showBanner(`撤单失败:${e.message}`, "error");
|
|
5329
|
+
}
|
|
5330
|
+
}, "danger"));
|
|
5331
|
+
}
|
|
4352
5332
|
// (原 `drawerBody.appendChild(ops)` 已移除:动作区改挂标题栏 `drawerActions`。)
|
|
4353
5333
|
|
|
4354
5334
|
const related = (audit.audit ?? []).filter((a) => a.target === t.identifier);
|
|
@@ -4636,6 +5616,14 @@
|
|
|
4636
5616
|
const cliSec = mk("div", "drawer-section");
|
|
4637
5617
|
cliSec.appendChild(mk("h3", null, "CLI 执行器(真实执行)"));
|
|
4638
5618
|
cliSec.appendChild(mk("p", "hint", "把该任务交给项目配置的 CLI 执行器(teamTemplate.roles[].executor = cli:*,且不在 forbiddenExecutors 中)真实执行:非交互调用 → 采集退出码 / 耗时 / 本次改动差集 → 写回评论 + 尝试记录;成功转「待验收」,失败走统一受阻入口。执行前会先认领并把卡片置为「进行中」——即使它原先在待办池等其它列,执行期也会如实显示在「进行中」,跑完再回到「待验收」。"));
|
|
5619
|
+
// 卡 `-238`(R174):CLI 区也放一个**只含 CLI 形态**的选择器(放团队/宿主会话只会点出必然的 400)。
|
|
5620
|
+
// 「预览 / 执行」都按这里选的那个走 —— 否则选了 codex 却预览 claude,预览就在骗人。
|
|
5621
|
+
const cliPicker = cliEntry(t) === "start" ? mountExecutorPicker(t, {
|
|
5622
|
+
onDone: () => void openTaskDetail(t),
|
|
5623
|
+
kinds: ["cli"],
|
|
5624
|
+
note: "选中后「预览执行计划」与下方按钮都按所选执行者走;「交给 CLI 执行器执行」固定用项目配置的那个。",
|
|
5625
|
+
}) : null;
|
|
5626
|
+
if (cliPicker) cliSec.appendChild(cliPicker.node);
|
|
4639
5627
|
const cliOut = mk("pre", "cli-plan");
|
|
4640
5628
|
cliOut.textContent = "(未预览)先点「预览执行计划」看清要跑什么,再决定是否真实执行。";
|
|
4641
5629
|
cliSec.appendChild(cliOut);
|
|
@@ -4643,7 +5631,7 @@
|
|
|
4643
5631
|
const cliClosed = t.status === "done" || t.status === "cancelled";
|
|
4644
5632
|
cliBar.appendChild(btn("预览执行计划", async () => {
|
|
4645
5633
|
try {
|
|
4646
|
-
const r = await api("POST", `/api/tasks/${ref}/exec-cli`, { dryRun: true });
|
|
5634
|
+
const r = await api("POST", `/api/tasks/${ref}/exec-cli`, { dryRun: true, executor: cliPicker?.selected() ?? undefined });
|
|
4647
5635
|
const p = r.plan ?? {};
|
|
4648
5636
|
cliOut.textContent = [
|
|
4649
5637
|
`执行器:${p.executor ?? "—"}(CLI:${p.cli ?? "—"})`,
|
|
@@ -4664,7 +5652,7 @@
|
|
|
4664
5652
|
if (cliEntryKind === "start") cliBar.appendChild(btn("交给 CLI 执行器执行", async () => {
|
|
4665
5653
|
if (!window.confirm(`确认把 ${t.identifier} 交给 CLI 执行器**真实执行**?\n\n· 非交互调用本地 CLI(通常带文件写权限),耗时数十秒到数分钟\n· 执行前先认领:卡片将被置为「进行中」(原为 todo 则走授权门)\n· 完成后看板自动刷新为「待验收」或「受阻」,并附退出码/耗时/改动清单\n· 期间请勿重复点击`)) return;
|
|
4666
5654
|
try {
|
|
4667
|
-
const r = await api("POST", `/api/tasks/${ref}/exec-cli`, { async: true });
|
|
5655
|
+
const r = await api("POST", `/api/tasks/${ref}/exec-cli`, { async: true, executor: cliPicker?.selected() ?? undefined });
|
|
4668
5656
|
cliOut.textContent = [
|
|
4669
5657
|
`已提交后台执行:${r.executor ?? "—"}(CLI:${r.plan?.cli ?? "—"})`,
|
|
4670
5658
|
`工作目录:${r.plan?.cwd ?? "—"}`,
|
|
@@ -5093,6 +6081,11 @@
|
|
|
5093
6081
|
} else {
|
|
5094
6082
|
sec.appendChild(mk("div", "next-step-title", step.title));
|
|
5095
6083
|
if (step.hint) sec.appendChild(mk("p", "hint", step.hint));
|
|
6084
|
+
// 卡 `-238`(R174):执行者图标行 —— 只在**这张卡真的能执行**时出现(能走 CLI 或能走宿主/团队)。
|
|
6085
|
+
// 单独一行、不抢主按钮层级:原有「启动执行」仍是主色,本行是「换谁跑」的选择器。
|
|
6086
|
+
if (cliEntry(t) === "start" || executionEntry(t) === "start") {
|
|
6087
|
+
sec.appendChild(mountExecutorPicker(t, { onDone: () => void reopen() }).node);
|
|
6088
|
+
}
|
|
5096
6089
|
// 操作顺序:异常/待办卡不许只丢几个并列按钮让人自己猜先点哪个(FR-89 第二条约束)。
|
|
5097
6090
|
if (Array.isArray(step.steps) && step.steps.length) {
|
|
5098
6091
|
const ol = mk("ol", "next-steps");
|
|
@@ -5140,6 +6133,8 @@
|
|
|
5140
6133
|
for (const staleNextStep of Array.from(drawerBody.querySelectorAll(".drawer-section.next-step"))) staleNextStep.remove();
|
|
5141
6134
|
drawerBody.insertBefore(sec, drawerBody.firstChild); // 放最前:先回答"该干嘛",再看明细
|
|
5142
6135
|
}
|
|
6136
|
+
// 卡 `-224`:所有区块(含刚插到最前面的「下一步」)都渲染完后,统一收敛主按钮层级。
|
|
6137
|
+
normalizeActionTiers();
|
|
5143
6138
|
} catch (error) {
|
|
5144
6139
|
if (renderSeq !== detailRenderSeq) return; // 已被更新的一代取代 ⇒ 不要把失败占位压到新一代的成品上
|
|
5145
6140
|
drawerActions.replaceChildren();
|