taskboard-workbench 0.0.0-stage → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/CHANGELOG.md +403 -0
  2. package/LICENSE +21 -0
  3. package/README.md +210 -2
  4. package/cli/tb.mjs +314 -0
  5. package/cordis.patch.yml +5 -0
  6. package/index.js +633 -0
  7. package/lib/client.js +522 -0
  8. package/package.json +96 -4
  9. package/scripts/tb-flow.mjs +86 -0
  10. package/skills/taskboard-flow/SKILL.md +89 -0
  11. package/skills/taskboard-flow/references/errors.md +61 -0
  12. package/skills/taskboard-flow/references/injection.md +70 -0
  13. package/skills/taskboard-flow/references/steps/S0.md +31 -0
  14. package/skills/taskboard-flow/references/steps/S1.md +28 -0
  15. package/skills/taskboard-flow/references/steps/S2.md +31 -0
  16. package/skills/taskboard-flow/references/steps/S3.md +22 -0
  17. package/skills/taskboard-flow/references/steps/S4.md +25 -0
  18. package/skills/taskboard-flow/references/steps/S5.md +36 -0
  19. package/skills/taskboard-flow/references/steps/S6.md +30 -0
  20. package/skills/taskboard-flow/references/steps/S7.md +23 -0
  21. package/spec/norms/acceptance.md +36 -0
  22. package/spec/norms/card-update.md +39 -0
  23. package/spec/norms/doc-editing.md +30 -0
  24. package/spec/norms/flow.md +45 -0
  25. package/spec/norms/manifest.json +41 -0
  26. package/spec/norms/project-defaults.md +33 -0
  27. package/spec//345/233/242/351/230/237agent.md +171 -0
  28. package/src/core/acceptance.mjs +62 -0
  29. package/src/core/advance.mjs +192 -0
  30. package/src/core/agent-teams.mjs +48 -0
  31. package/src/core/binding.mjs +44 -0
  32. package/src/core/config.mjs +22 -0
  33. package/src/core/contract.mjs +287 -0
  34. package/src/core/debug-dispatch.mjs +94 -0
  35. package/src/core/delivery.mjs +93 -0
  36. package/src/core/deps.mjs +53 -0
  37. package/src/core/diagnostics.mjs +648 -0
  38. package/src/core/domain.mjs +235 -0
  39. package/src/core/empty-state.mjs +240 -0
  40. package/src/core/errors.mjs +142 -0
  41. package/src/core/evidence.mjs +86 -0
  42. package/src/core/executor.mjs +645 -0
  43. package/src/core/human-review.mjs +773 -0
  44. package/src/core/intake.mjs +179 -0
  45. package/src/core/kickoff.mjs +147 -0
  46. package/src/core/loop.mjs +498 -0
  47. package/src/core/memory.mjs +193 -0
  48. package/src/core/next-step.mjs +377 -0
  49. package/src/core/notify.mjs +183 -0
  50. package/src/core/owner.mjs +41 -0
  51. package/src/core/requirements.mjs +292 -0
  52. package/src/core/review.mjs +82 -0
  53. package/src/core/session-naming.mjs +64 -0
  54. package/src/core/split-ask.mjs +107 -0
  55. package/src/core/store.mjs +3442 -0
  56. package/src/core/team.mjs +170 -0
  57. package/src/core/ticket-stage.mjs +150 -0
  58. package/src/core/verify.mjs +170 -0
  59. package/src/core/watchdog.mjs +144 -0
  60. package/src/host/ai-elaborator.mjs +26 -0
  61. package/src/host/team-engine.mjs +125 -0
  62. package/src/host/tool-surface.mjs +205 -0
  63. package/src/mcp/flow-block.mjs +173 -0
  64. package/src/mcp/server.mjs +156 -0
  65. package/src/mcp/tools.mjs +764 -0
  66. package/src/server/api.mjs +2050 -0
  67. package/src/server/events.mjs +32 -0
  68. package/src/server/kickoff.mjs +46 -0
  69. package/src/server/server.mjs +214 -0
  70. package/src/server/verify.mjs +112 -0
  71. package/tools/env-check.mjs +35 -0
  72. package/tools/seed.mjs +67 -0
  73. package/web/app.js +5337 -0
  74. package/web/index.html +15 -0
  75. package/web/tokens.css +1151 -0
package/lib/client.js ADDED
@@ -0,0 +1,522 @@
1
+ /**
2
+ * client.js —— DSH 客户端 bundle(手写 IIFE,无构建步骤;形态对照 t17 的 p4-probe/lib/client.js)。
3
+ *
4
+ * 契约:window.__ModuleLoader__.load({ id, factory }),工厂可 require("react")(宿主冻结模块表)。
5
+ * 承载形态(决策 D5):
6
+ * · 会话区标签页 → conversation.view(session 作用域;对齐 对话/轨迹/上下文/团队 的放置位置)
7
+ * · 面板落点 → main(keyed, key="taskboard-workbench") + sidebar.panellist(list, id 同 key)
8
+ * · 不使用 shell.overlay(其宿主层 pointer-events:none,会"看得见点不动")
9
+ * · 不注册 sidebar.footer.action("设置上方"的侧栏底部入口已按用户要求取消)
10
+ * 面板内容复用 web/app.js 的看板渲染(同源加载该脚本后调用 window.__TB_BOARD__.createBoard)。
11
+ */
12
+ (() => {
13
+ const BUNDLE_ID = "taskboard-workbench";
14
+ const BASE = "/integrations/taskboard-workbench";
15
+ const report = { bundle: BUNDLE_ID, base: BASE, slots: {}, errors: [], startedAt: null };
16
+ window.__TB_PLUGIN__ = report;
17
+ const log = (kind, payload) => {
18
+ try {
19
+ console.log(`[taskboard-workbench][${kind}]`, typeof payload === "string" ? payload : JSON.stringify(payload));
20
+ } catch (_) {}
21
+ };
22
+ const fail = (kind, error) => {
23
+ const message = error instanceof Error ? error.message : String(error);
24
+ report.errors.push({ kind, message });
25
+ log(kind, `ERROR: ${message}`);
26
+ };
27
+
28
+ /**
29
+ * #region repair-draft-store
30
+ * 宿主缺陷自愈(2026-10-18 真机定位):**会话中心区整块白屏、只剩输入框**。
31
+ *
32
+ * 链路(全部在 DSH 宿主侧,本仓库无法改):
33
+ * · `@deepseek-ai/dsh-client-store` 把**整值 JSON** 持久化进 localStorage,键名
34
+ * `dsh.conversation`(有作用域时为 `dsh.conversation.<scope>`),而 rehydrate 是
35
+ * `api.setState(JSON.parse(raw), true)` —— **整值覆盖、零校验**;
36
+ * · 于是历史遗留/旧版本写下的 `draft` 可能是**非字符串**(旧版 zustand `persist` 的
37
+ * `{state,version}` 包装会让 `draft` 变成 `undefined`;DSH 自己的注释也点名了
38
+ * 「字符串草稿被炸成 `{0:'h',1:'e',…}`」这类损坏);
39
+ * · `dsh-client-ui-conversation` 的 `DefaultConversationViews` effect 只判
40
+ * `storedDraft !== ""` 就 `inputActions.setDraft(storedDraft)`,进而在
41
+ * `DraftEditorRuntime.setDraft` 的 `text.replace(...)` 抛
42
+ * `TypeError: text.replace is not a function`;
43
+ * · 该错误冒泡成 `slot entry crashed in 'conversation.session'` → **整个会话区不渲染**。
44
+ * 真机现象:任何会话、任何标签页都只剩输入框,看不到历史对话(2026-10-18 复现)。
45
+ *
46
+ * 处置:插件挂载时做一次**窄修复** —— `draft` 不是字符串就归位成 `""`。
47
+ * 只碰这一个字段、幂等、失败不抛(绝不因为修复动作把面板弄崩)、不改宿主任何文件。
48
+ * 因为宿主 store 在会话视图挂载时才 rehydrate,本修复在**下一次页面加载**即生效。
49
+ * @param {{getItem:Function,setItem:Function}} [storage] 供测试注入;默认 window.localStorage
50
+ */
51
+ const repairConversationDraftStore = (storage) => {
52
+ const result = { scanned: 0, repaired: 0, keys: [] };
53
+ let store = storage;
54
+ if (store === undefined) {
55
+ try { store = typeof window !== "undefined" ? window.localStorage : undefined; } catch (_) { store = undefined; }
56
+ }
57
+ if (!store) return result;
58
+ let names = [];
59
+ try { names = Object.keys(store); } catch (_) { return result; }
60
+ for (const name of names) {
61
+ if (name !== "dsh.conversation" && name.indexOf("dsh.conversation.") !== 0) continue;
62
+ result.scanned += 1;
63
+ try {
64
+ const raw = store.getItem(name);
65
+ if (raw === null || raw === undefined) continue;
66
+ const value = JSON.parse(raw);
67
+ if (!value || typeof value !== "object") continue;
68
+ if (typeof value.draft === "string") continue;
69
+ value.draft = "";
70
+ store.setItem(name, JSON.stringify(value));
71
+ result.repaired += 1;
72
+ result.keys.push(name);
73
+ } catch (_) { /* 解析失败 / 不可写:保持原样,绝不影响面板 */ }
74
+ }
75
+ return result;
76
+ };
77
+ report.repairConversationDraftStore = repairConversationDraftStore;
78
+ // #endregion
79
+
80
+ /** 注入 tokens.css + app.js(同源绝对路径),并等待 window.__TB_BOARD__ 就绪。 */
81
+ let assetsPromise = null; // **同一时刻**只允许一次注入(并发挂载共享同一次,避免重复拉取)
82
+ let assetsVersion = null; // 最近一次注入用的 `?v=`(页面生命周期内允许换多次,见 ensureAssets)
83
+ let assetsSeq = 0; // 让同一毫秒内的多次注入也各自拿到不同的 `?v=`(避免复用旧脚本)
84
+ const STYLE_LINK_ID = "tb-tokens-css";
85
+ /** 回到页签时探测「服务端 app.js 是否已变」的最小间隔(毫秒):避免 focus 风暴反复拉 240KB。 */
86
+ const STALE_CHECK_MIN_MS = 60000;
87
+ // 载入即登记的诊断元数据:真机上用它判断「页面跑的是不是含自愈逻辑的这一版客户端」
88
+ // (插件客户端 bundle 由宿主按 `rev` 组合分发,光靠 ⌘R 未必换到新版)。
89
+ report.assetsSelfHeal = { minIntervalMs: STALE_CHECK_MIN_MS, watches: ["app.js", "tokens.css"] };
90
+ // #region pure-assets-fingerprint
91
+ /**
92
+ * 面板资源「变更即重载」判据(**纯函数,供 tests/dsh-plugin.test.mjs 提取执行**)。
93
+ *
94
+ * 真机第四次踩坑(2026-10-22 用户再报「归因门拦下可开工卡」):`ensureAssets()` 只在
95
+ * **每次挂载面板**时重新注入脚本,而宿主页面是长生命周期的 —— 面板开着一整天不重挂,
96
+ * 屏上就一直是几小时前的旧构建(取证:抽屉 `版本 v3` vs 服务端 `v8`、需求条目打裸 UUID),
97
+ * 用户据此反复判断「改的代码根本没生效」(`-80` / `-126` 同类)。
98
+ * 处置:记住注入那一刻服务端的**字节指纹**,回到页签时比一次;变了才重注入并重建看板。
99
+ *
100
+ * `-80` 的补口:**指纹必须同时覆盖 `tokens.css`**。原实现只探测 `app.js`,于是「只改了 CSS、
101
+ * 没有改动任何 JS」这一类提交在长生命周期面板上探测不到 —— 而 `-80` 恰恰就是纯 CSS 缺陷
102
+ * (卡片徽标溢出),这会让本卡的修复在「面板不重挂」时再次失效。同理 `mergeFingerprint()` 判别
103
+ * **哪一侧变了**,好让 CSS 变化走轻量的「只重挂样式表」而不必重建整块看板。
104
+ */
105
+ function assetsFingerprint(text) {
106
+ const input = typeof text === "string" ? text : "";
107
+ let hash = 0x811c9dc5;
108
+ for (let i = 0; i < input.length; i += 1) {
109
+ hash ^= input.charCodeAt(i);
110
+ hash = (hash + (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24)) >>> 0;
111
+ }
112
+ return `${input.length.toString(16)}-${hash.toString(16)}`;
113
+ }
114
+ /** 把 app.js / tokens.css 两份指纹合成一个可比较的整体指纹(任一侧缺失即整体缺失 ⇒ 不重载)。 */
115
+ function mergeFingerprint(js, css) {
116
+ if (!js || !css) return "";
117
+ return `js:${js}|css:${css}`;
118
+ }
119
+ /** 没有基线指纹(首次挂载尚未记上 / 探测失败)时**不重载**:宁可不动,也不要把能用的看板重挂一遍。 */
120
+ function shouldReloadAssets(loadedFingerprint, currentFingerprint) {
121
+ if (!loadedFingerprint || !currentFingerprint) return false;
122
+ return loadedFingerprint !== currentFingerprint;
123
+ }
124
+ /**
125
+ * 判别两侧变化的种类,供自愈走最轻的处置:
126
+ * · `js` —— 脚本变了 ⇒ 必须重注入 + 重建看板;
127
+ * · `css` —— **只有样式变了** ⇒ 重挂 `<link>` 即可,不动 DOM、不必重建(面板不闪 loading);
128
+ * · `both` —— 两边都变;
129
+ * · `none` —— 没变;
130
+ * · `unknown`—— 基线或探测缺一侧(如探测失败)⇒ 什么都不做,绝不猜。
131
+ */
132
+ function classifyAssetsChange(loadedFingerprint, currentFingerprint) {
133
+ if (!loadedFingerprint || !currentFingerprint) return "unknown";
134
+ if (loadedFingerprint === currentFingerprint) return "none";
135
+ const loaded = splitFingerprint(loadedFingerprint);
136
+ const current = splitFingerprint(currentFingerprint);
137
+ if (!loaded.js || !loaded.css || !current.js || !current.css) return "unknown";
138
+ const jsChanged = loaded.js !== current.js;
139
+ const cssChanged = loaded.css !== current.css;
140
+ if (jsChanged && cssChanged) return "both";
141
+ if (jsChanged) return "js";
142
+ if (cssChanged) return "css";
143
+ return "none";
144
+ }
145
+ function splitFingerprint(merged) {
146
+ const input = typeof merged === "string" ? merged : "";
147
+ const match = /^js:([^|]+)\|css:(.+)$/.exec(input);
148
+ if (!match) return { js: "", css: "" };
149
+ return { js: match[1], css: match[2] };
150
+ }
151
+ // #endregion
152
+ /**
153
+ * 确保样式表存在,且**每次进入面板都重挂一次**(换新的 `?v=`)。
154
+ * 真机踩坑(2026-10-18,两次复现):`assetsPromise` 是**页面级单例**,面板首次挂载注入的
155
+ * tokens.css 会跟着整页一直用下去——之后修了 CSS,除非**整页 ⌘R**,否则面板里永远是修复前那份,
156
+ * 表现成「改了代码但界面没变」(事故现场:卡片顶行徽标压出卡框、文字被挤成竖排)。
157
+ * 改 href 而不是换元素:旧样式表在新表下载完成前**仍在生效**,因此不会闪白;同源 35KB 近乎瞬时。
158
+ *
159
+ * `force=true`(仅供 `checkForStaleBundle()` 自愈调用):面板**不重挂**时同样强制换新 `?v=`,
160
+ * 于是「只改了 CSS、面板一直开着」也能生效,不必整页 ⌘R、也不必重建看板(重挂 `<link href>`
161
+ * 是纯样式替换,不动 DOM 结构、无需 destroy/createBoard)。
162
+ */
163
+ function ensureStyles(force = false) {
164
+ let link = document.getElementById(STYLE_LINK_ID);
165
+ if (!link) {
166
+ link = document.createElement("link");
167
+ link.rel = "stylesheet";
168
+ link.id = STYLE_LINK_ID;
169
+ link.dataset.taskboardOwned = "true";
170
+ document.head.appendChild(link);
171
+ }
172
+ if (!force) {
173
+ const href = `${BASE}/tokens.css?v=${encodeURIComponent(String(Date.now()))}`;
174
+ if (link.getAttribute("href") !== href) link.setAttribute("href", href);
175
+ return link;
176
+ }
177
+ // 与 assetsSeq 同源的序号:同一毫秒内连续自愈也要换到不同的 `?v=`(否则浏览器直接命中旧缓存)。
178
+ assetsSeq += 1;
179
+ const href = `${BASE}/tokens.css?v=${encodeURIComponent(`${Date.now()}-${assetsSeq}`)}`;
180
+ link.setAttribute("href", href);
181
+ return link;
182
+ }
183
+ /** 清掉已注入的脚本/样式,供自动重试重来(避免残留失败脚本)。 */
184
+ function resetAssets() {
185
+ assetsPromise = null;
186
+ document.querySelectorAll('script[data-taskboard-owned="true"], link[data-taskboard-owned="true"]').forEach((el) => el.remove());
187
+ }
188
+ /** 面板侧最小覆盖(仅嵌入态):不让看板按 1248px 居中(消除两侧留空),外壳改用容器高度。 */
189
+ function ensureEmbedStyles() {
190
+ if (document.getElementById("tb-embed-style")) return;
191
+ const style = document.createElement("style");
192
+ style.id = "tb-embed-style";
193
+ style.textContent = ".tb-embed{--board-max-width:none;}.tb-embed .app-shell{height:100%;}";
194
+ document.head.appendChild(style);
195
+ }
196
+ /**
197
+ * 注入**当前版本**的 web/app.js,并等到本次注入的工厂就绪。
198
+ *
199
+ * 真机踩坑(2026-10-18,本类问题第三次):看板前端脚本此前是**页面级单例** ——
200
+ * 宿主的 client world 不会因为 `dsh web` 重启就重新加载本项目前端,页面一直活着,
201
+ * 于是「改了 web/app.js 但界面没变」反复出现。实测取证:用户页面上
202
+ * `script[data-taskboard-owned]` 的 `?v=` 停在 22:36:50,而同页 tokens.css 每次进面板都重挂
203
+ * (`?v=` 是当下时间)→ **CSS 的修复能落地、JS 的修复落不了地**,用户据此认为
204
+ * 「问题根本没修」(本轮真实症状:抽屉里仍显示旧口径的「接续存活=在线」,
205
+ * 22:36 之后才加的「仅存于磁盘 · 未加载」四态与告警一条都不见)。
206
+ *
207
+ * 处置:与 tokens.css 同口径 —— **每次挂载都换新的 `?v=` 重新注入一次**。
208
+ * · 先清掉旧的 owned `<script>`(已执行过的脚本移除不会撤销其效果,留着只会堆积);
209
+ * · 注入前**清掉 `window.__TB_BOARD__`**:否则「工厂已就绪」会立刻成立,拿到的还是上一版旧工厂
210
+ * (这正是本缺陷的本质)。注入失败则**回滚**旧工厂,绝不把本来能用的看板弄没。
211
+ */
212
+ function injectBoardBundle(styleLink) {
213
+ return new Promise((resolve, reject) => {
214
+ assetsSeq += 1;
215
+ const version = `${Date.now()}-${assetsSeq}`;
216
+ document.querySelectorAll('script[data-taskboard-owned="true"]').forEach((el) => el.remove());
217
+ const previousFactory = window.__TB_BOARD__;
218
+ window.__TB_BOARD__ = undefined;
219
+
220
+ const waitForFactory = (deadline = Date.now() + 8000) => {
221
+ if (window.__TB_BOARD__?.createBoard) {
222
+ assetsVersion = version;
223
+ report.assets = { css: styleLink?.href ?? null, js: version, ready: true };
224
+ resolve(window.__TB_BOARD__);
225
+ return;
226
+ }
227
+ if (Date.now() > deadline) {
228
+ reject(new Error("看板渲染脚本未就绪(web/app.js 未加载)"));
229
+ return;
230
+ }
231
+ window.setTimeout(waitForFactory, 60);
232
+ };
233
+
234
+ const script = document.createElement("script");
235
+ script.src = `${BASE}/app.js?v=${encodeURIComponent(version)}`;
236
+ script.dataset.taskboardOwned = "true";
237
+ script.onerror = () => {
238
+ if (previousFactory?.createBoard) window.__TB_BOARD__ = previousFactory; // 回滚上一版工厂
239
+ reject(new Error(`无法加载 ${BASE}/app.js`));
240
+ };
241
+ script.onload = () => waitForFactory();
242
+ document.head.appendChild(script);
243
+ });
244
+ }
245
+
246
+ /**
247
+ * 拿到看板工厂。**并发挂载共享同一次注入**;本次注入结算后放行,使下一次挂载(换标签页/换会话)
248
+ * 能取到新一版 `web/app.js` —— 这就是「前端修复不必整页 ⌘R 也能生效」的机制。
249
+ */
250
+ function ensureAssets() {
251
+ ensureEmbedStyles();
252
+ const styleLink = ensureStyles();
253
+ if (assetsPromise) return assetsPromise;
254
+ assetsPromise = injectBoardBundle(styleLink);
255
+ // 结算即放行:`finally` 的回调先于调用方的 await 续体执行,因此「这一次注入已完成」与
256
+ // 「下一次挂载会重新注入」之间没有窗口期(并发挂载仍共享同一次 —— 上方的 `if` 兜住)。
257
+ assetsPromise.finally(() => { assetsPromise = null; }).catch(() => {});
258
+ return assetsPromise;
259
+ }
260
+
261
+ /**
262
+ * 只读取回服务端两份前端资源(app.js + tokens.css)并各记一份字节指纹当基线(失败不影响面板)。
263
+ * 必须**两份都取到**才记基线:缺一侧就整条判据失效,宁可不自愈也不能拿半份基线去比对。
264
+ */
265
+ function probeAssetsFingerprints() {
266
+ return Promise.all([
267
+ fetch(`${BASE}/app.js`, { cache: "no-store" }).then((res) => res.text()).catch(() => ""),
268
+ fetch(`${BASE}/tokens.css`, { cache: "no-store" }).then((res) => res.text()).catch(() => ""),
269
+ ]).then(([js, css]) => ({ js: assetsFingerprint(js), css: assetsFingerprint(css) }));
270
+ }
271
+
272
+ window.__ModuleLoader__.load({
273
+ id: BUNDLE_ID,
274
+ factory: (require) => {
275
+ const React = require("react");
276
+ const h = React.createElement;
277
+ report.startedAt = new Date().toISOString();
278
+ // 客户端"打开会话"能力:会话切换属于**客户端**导航(宿主 uiWorkspace 服务),
279
+ // 而非宿主插件(宿主侧永远拿不到 → ui-workspace-unavailable)。这里在点击时懒取。
280
+ let hostOpenSession = null;
281
+
282
+ function Panel(props) {
283
+ const sessionId = props?.sessionId ?? null;
284
+ const cwd = props?.cwd ?? null;
285
+ const hostRef = React.useRef(null);
286
+ const controllerRef = React.useRef(null);
287
+ const retryRef = React.useRef(null);
288
+ const [status, setStatus] = React.useState("loading");
289
+ const [error, setError] = React.useState("");
290
+ const [note, setNote] = React.useState("");
291
+
292
+ React.useEffect(() => {
293
+ let cancelled = false;
294
+ let timer = null;
295
+ let staleTimer = null;
296
+ let loadedFingerprint = ""; // 注入那一刻服务端 app.js + tokens.css 的合并指纹(自愈判据基线)
297
+ let lastStaleCheckAt = 0; // 上次探测时刻(节流:focus 风暴不重复拉 240KB)
298
+ const MAX_RETRIES = 5;
299
+ const BACKOFF_MS = [300, 800, 2000, 5000, 5000];
300
+
301
+ /** 建 / 重建看板。重建前**必须先 destroy 旧控制器**,否则旧监听与定时器会跟着页面活下去。 */
302
+ const mountBoard = () => {
303
+ if (cancelled || !hostRef.current) return;
304
+ try { controllerRef.current?.destroy(); } catch (_) {}
305
+ controllerRef.current = window.__TB_BOARD__.createBoard({ root: hostRef.current, apiBase: BASE, session: sessionId, cwd, openSession: hostOpenSession });
306
+ };
307
+
308
+ /** 只读取回服务端两份前端资源并记下合并字节指纹当基线(失败不影响面板)。 */
309
+ const rememberFingerprint = () => {
310
+ probeAssetsFingerprints()
311
+ .then(({ js, css }) => {
312
+ loadedFingerprint = mergeFingerprint(js, css);
313
+ report.assetsFingerprint = loadedFingerprint;
314
+ })
315
+ .catch(() => {});
316
+ };
317
+
318
+ /**
319
+ * 回到页签(focus / 可见性变化 / 每 2 分钟)时探测服务端前端资源是否已变。
320
+ * · 脚本变了 ⇒ 清掉旧脚本、重注入、重建看板(**不整页 ⌘R,也不闪 loading**);
321
+ * · **只有样式变了** ⇒ 只重挂 `<link>`(纯样式替换:不 destroy、不重建,面板零闪烁);
322
+ * · 探测失败 ⇒ 什么都不做,绝不阻断面板。
323
+ */
324
+ const checkForStaleBundle = () => {
325
+ if (cancelled) return;
326
+ try { if (document.visibilityState === "hidden") return; } catch (_) {}
327
+ const now = Date.now();
328
+ if (now - lastStaleCheckAt < STALE_CHECK_MIN_MS) return;
329
+ lastStaleCheckAt = now;
330
+ probeAssetsFingerprints()
331
+ .then(({ js, css }) => {
332
+ const current = mergeFingerprint(js, css);
333
+ if (cancelled || !shouldReloadAssets(loadedFingerprint, current)) return;
334
+ const kind = classifyAssetsChange(loadedFingerprint, current);
335
+ if (kind === "unknown") return; // 半份基线不猜
336
+ loadedFingerprint = current;
337
+ log("panel", { staleBundle: kind, from: loadedFingerprint, to: current });
338
+ report.assetsReload = { at: new Date().toISOString(), kind, to: current };
339
+ if (kind === "css") {
340
+ // 只变了样式:重挂样式表即可,不必重建看板(`-80` 的补口:只改 CSS 也要能生效)。
341
+ ensureStyles(true);
342
+ return;
343
+ }
344
+ resetAssets();
345
+ ensureAssets()
346
+ .then(() => { mountBoard(); log("panel", { remounted: true, bundle: assetsVersion }); })
347
+ .catch(() => {});
348
+ })
349
+ .catch(() => { /* 探测失败不阻断面板 */ });
350
+ };
351
+ const onReturn = () => checkForStaleBundle();
352
+ try {
353
+ window.addEventListener("focus", onReturn);
354
+ document.addEventListener("visibilitychange", onReturn);
355
+ } catch (_) {}
356
+ staleTimer = window.setInterval(onReturn, STALE_CHECK_MIN_MS * 2);
357
+
358
+ const attempt = (n) => {
359
+ if (cancelled) return;
360
+ setStatus(n === 0 ? "loading" : "retry");
361
+ setNote(n === 0 ? "" : `正在重试(第 ${n} 次)…`);
362
+ if (n === 0) rememberFingerprint();
363
+ ensureAssets()
364
+ .then(() => {
365
+ if (cancelled || !hostRef.current) return;
366
+ mountBoard();
367
+ setStatus("ready");
368
+ setNote("");
369
+ log("panel", { mounted: true, base: BASE, attempts: n + 1, bundle: assetsVersion });
370
+ })
371
+ .catch((cause) => {
372
+ if (cancelled) return;
373
+ if (n < MAX_RETRIES) {
374
+ resetAssets(); // 下次重进 ensureAssets,重新注入脚本
375
+ const delay = BACKOFF_MS[Math.min(n, BACKOFF_MS.length - 1)];
376
+ timer = window.setTimeout(() => attempt(n + 1), delay);
377
+ } else {
378
+ setError(cause instanceof Error ? cause.message : String(cause));
379
+ setStatus("error");
380
+ fail("panel", cause);
381
+ }
382
+ });
383
+ };
384
+ retryRef.current = () => {
385
+ resetAssets();
386
+ setError("");
387
+ setNote("");
388
+ attempt(0);
389
+ };
390
+ attempt(0);
391
+
392
+ return () => {
393
+ cancelled = true;
394
+ if (timer) window.clearTimeout(timer);
395
+ if (staleTimer) window.clearInterval(staleTimer);
396
+ try {
397
+ window.removeEventListener("focus", onReturn);
398
+ document.removeEventListener("visibilitychange", onReturn);
399
+ } catch (_) {}
400
+ try {
401
+ controllerRef.current?.destroy();
402
+ } catch (_) {}
403
+ controllerRef.current = null;
404
+ };
405
+ }, [sessionId, cwd]);
406
+
407
+ return h(
408
+ "div",
409
+ { style: { display: "flex", flexDirection: "column", height: "100%", minHeight: 0 } },
410
+ status === "loading" || status === "retry"
411
+ ? h("div", { style: { padding: 16, opacity: 0.7, fontSize: 13 } }, status === "retry" ? note : "正在加载任务工作台…")
412
+ : null,
413
+ status === "error"
414
+ ? h(
415
+ "div",
416
+ { style: { padding: 16, fontSize: 13 } },
417
+ h("div", { style: { marginBottom: 8 } }, `加载失败:${error}`),
418
+ h("button", { type: "button", onClick: () => retryRef.current?.() }, "重试"),
419
+ )
420
+ : null,
421
+ h("div", {
422
+ ref: hostRef,
423
+ className: "tb-embed",
424
+ style: { flex: "1 1 auto", minHeight: 0, display: status === "ready" ? "block" : "none" },
425
+ }),
426
+ );
427
+ }
428
+
429
+ const PanellistEntry = () =>
430
+ h(
431
+ "button",
432
+ {
433
+ type: "button",
434
+ id: "taskboard-workbench-panellist",
435
+ title: "任务工作台",
436
+ "aria-label": "任务工作台",
437
+ style: {
438
+ width: 28, height: 28, borderRadius: 8, cursor: "pointer", fontSize: 13, lineHeight: 1,
439
+ border: "1px solid var(--dsw-alias-border-secondary, rgba(128,128,128,.4))",
440
+ background: "transparent", color: "inherit",
441
+ },
442
+ },
443
+ "▦",
444
+ );
445
+
446
+ function register(ctx, slot, options, component, flag) {
447
+ try {
448
+ ctx.slots.inject(slot, () => {
449
+ ctx.slots.register({ name: slot, ...options }, component);
450
+ report.slots[flag] = true;
451
+ log("slots", { slot, registered: true });
452
+ });
453
+ } catch (error) {
454
+ report.slots[flag] = false;
455
+ fail(`slots:${slot}`, error);
456
+ }
457
+ }
458
+
459
+ function apply(ctx) {
460
+ // 宿主草稿持久化自愈(见上方 #region repair-draft-store)。
461
+ // 必须**早于**会话视图挂载:宿主在会话视图挂载时才 rehydrate `dsh.conversation`。
462
+ try {
463
+ const repaired = repairConversationDraftStore();
464
+ if (repaired.repaired > 0) log("repair-draft-store", repaired);
465
+ } catch (error) {
466
+ fail("repair-draft-store", error);
467
+ }
468
+ // FR-48:客户端会话切换(对齐 DSH 的 uiWorkspace 导航服务)。失败则返回原因,由 UI 降级为"复制会话标识"。
469
+ hostOpenSession = (id) => {
470
+ if (!id) return { ok: false, reason: "no-session" };
471
+ // 1) 客户端会话控制器 `ctx.sessions.open(id)`(对齐 @nanmicoder/dsh-agent-teams 的会话导航)
472
+ try {
473
+ // ⚠ 必须先走 `ctx.get(name)`:cordis 对**未声明在 inject 里**的属性取值会抛
474
+ // `cannot get property "sessions" without inject`,`ctx.sessions` 只是把它包在
475
+ // try/catch 里"静默失败"(2026-10-27 rc.3 真机复核确认)。`ctx.get` 缺失时返回 undefined,不抛。
476
+ let sessions = null;
477
+ try { sessions = ctx?.get?.("sessions") ?? null; } catch (_) { sessions = null; }
478
+ if (!sessions) { try { sessions = ctx?.sessions ?? null; } catch (_) { sessions = null; } }
479
+ if (typeof sessions?.open === "function") { sessions.open(id); return { ok: true, via: "sessions.open" }; }
480
+ } catch (_) { /* 该宿主未暴露 → 试下一个 */ }
481
+ // 2) 工作区导航 `uiWorkspace.openSession(id)`
482
+ let ui = null;
483
+ try { ui = ctx?.get?.("uiWorkspace") ?? ctx?.uiWorkspace ?? null; } catch (_) { ui = null; }
484
+ if (typeof ui?.openSession === "function") {
485
+ try { ui.openSession(id); return { ok: true, via: "uiWorkspace.openSession" }; }
486
+ catch (error) { return { ok: false, reason: error?.message ?? String(error) }; }
487
+ }
488
+ return { ok: false, reason: "ui-workspace-unavailable" };
489
+ };
490
+ report.openSession = true;
491
+ // 入口:会话区标签页(主) + 侧栏面板图标 + 主列面板(**取消**侧栏底部/设置上方入口)
492
+ register(ctx, "sidebar.panellist", { id: BUNDLE_ID, order: 0, label: "任务工作台" }, PanellistEntry, "panellist");
493
+ // keyed `main` 只认 `key`(sidebar.panellist 的 list id 与之相等即联动);不传非契约字段。
494
+ register(ctx, "main", { key: BUNDLE_ID }, Panel, "main");
495
+ // 参考样式:会话作用域"中心标签页"(对齐 对话/轨迹/上下文/团队 的放置位置)
496
+ // FR-60:注入会话上下文(对齐 ui-trajectory 的 inject(sessionId) 写法),
497
+ // 使工作台能把"当前会话"透传给后端(/api/context?session=)并绑定项目初始会话。
498
+ register(ctx, "conversation.view", {
499
+ id: BUNDLE_ID, order: 40, label: "任务工作台",
500
+ inject: (sessionId) => {
501
+ let workspaceId = null;
502
+ let cwd = null;
503
+ try {
504
+ const sessions = (() => {
505
+ try { return ctx.get?.("sessions") ?? null; } catch (_) { return null; }
506
+ })();
507
+ const s = sessions?.binding?.(sessionId)?.session;
508
+ if (s) {
509
+ workspaceId = s.workspaceId ?? null;
510
+ cwd = s.cwd ?? s.workspacePath ?? s.workspace?.path ?? null;
511
+ }
512
+ } catch (_) { /* 会话快照不可得则不传 cwd,由后端按项目回退 */ }
513
+ return { sessionId, workspaceId, cwd };
514
+ },
515
+ }, Panel, "conversationView");
516
+ log("apply", { slots: report.slots, errors: report.errors.length });
517
+ }
518
+
519
+ return { apply, inject: ["slots"] };
520
+ },
521
+ });
522
+ })();
package/package.json CHANGED
@@ -1,6 +1,98 @@
1
1
  {
2
2
  "name": "taskboard-workbench",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.3.0",
4
+ "type": "module",
5
+ "description": "agent team 任务工作台:零依赖核心(node:sqlite)+ CLI + 本地 Web 看板 + DSH 内嵌插件",
6
+ "license": "MIT",
7
+ "author": {
8
+ "name": "SilenZerOrz",
9
+ "email": "SilenZerOrz@users.noreply.github.com"
10
+ },
11
+ "repository": {
12
+ "type": "git",
13
+ "url": "git+https://github.com/SilenZerOrz/taskboard-workbench.git"
14
+ },
15
+ "homepage": "https://github.com/SilenZerOrz/taskboard-workbench#readme",
16
+ "bugs": {
17
+ "url": "https://github.com/SilenZerOrz/taskboard-workbench/issues"
18
+ },
19
+ "keywords": [
20
+ "dsh",
21
+ "dsh-plugin",
22
+ "taskboard",
23
+ "agent",
24
+ "agent-team",
25
+ "sqlite",
26
+ "local-first"
27
+ ],
28
+ "publishConfig": {
29
+ "access": "public"
30
+ },
31
+ "engines": {
32
+ "node": ">=22.5.0"
33
+ },
34
+ "main": "./index.js",
35
+ "exports": {
36
+ ".": "./index.js",
37
+ "./client": "./lib/client.js",
38
+ "./cordis.patch.yml": "./cordis.patch.yml",
39
+ "./package.json": "./package.json"
40
+ },
41
+ "files": [
42
+ "CHANGELOG.md",
43
+ "index.js",
44
+ "lib/client.js",
45
+ "cordis.patch.yml",
46
+ "skills",
47
+ "src",
48
+ "web",
49
+ "cli",
50
+ "spec/团队agent.md",
51
+ "spec/norms",
52
+ "scripts/tb-flow.mjs",
53
+ "tools/seed.mjs",
54
+ "tools/env-check.mjs"
55
+ ],
56
+ "bin": {
57
+ "tb": "./cli/tb.mjs",
58
+ "tb-mcp": "./src/mcp/server.mjs",
59
+ "tb-flow": "./scripts/tb-flow.mjs"
60
+ },
61
+ "scripts": {
62
+ "start": "node src/server/server.mjs",
63
+ "mcp": "node src/mcp/server.mjs",
64
+ "flow": "node scripts/tb-flow.mjs",
65
+ "seed": "node tools/seed.mjs",
66
+ "test": "node --test",
67
+ "env-check": "node tools/env-check.mjs"
68
+ },
69
+ "peerDependencies": {
70
+ "@deepseek-ai/dsh-client-ui-layout": "*",
71
+ "@deepseek-ai/dsh-client-ui-sidebar": "*",
72
+ "@deepseek-ai/dsh-client-ui-slots": "*"
73
+ },
74
+ "peerDependenciesMeta": {
75
+ "@deepseek-ai/dsh-client-ui-layout": {
76
+ "optional": true
77
+ },
78
+ "@deepseek-ai/dsh-client-ui-sidebar": {
79
+ "optional": true
80
+ },
81
+ "@deepseek-ai/dsh-client-ui-slots": {
82
+ "optional": true
83
+ }
84
+ },
85
+ "dsh": {
86
+ "bundle": {
87
+ "patch": "./cordis.patch.yml"
88
+ },
89
+ "client": {
90
+ "platform": "web",
91
+ "inject": [
92
+ "@deepseek-ai/dsh-client-ui-layout",
93
+ "@deepseek-ai/dsh-client-ui-sidebar",
94
+ "@deepseek-ai/dsh-client-ui-slots"
95
+ ]
96
+ }
97
+ }
98
+ }