taskboard-workbench 0.0.0-stage → 0.2.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 (50) hide show
  1. package/CHANGELOG.md +132 -0
  2. package/LICENSE +21 -0
  3. package/README.md +121 -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 +83 -4
  9. package/spec//345/233/242/351/230/237agent.md +171 -0
  10. package/src/core/advance.mjs +192 -0
  11. package/src/core/agent-teams.mjs +48 -0
  12. package/src/core/binding.mjs +44 -0
  13. package/src/core/config.mjs +22 -0
  14. package/src/core/debug-dispatch.mjs +94 -0
  15. package/src/core/delivery.mjs +93 -0
  16. package/src/core/deps.mjs +53 -0
  17. package/src/core/diagnostics.mjs +648 -0
  18. package/src/core/domain.mjs +235 -0
  19. package/src/core/empty-state.mjs +240 -0
  20. package/src/core/errors.mjs +139 -0
  21. package/src/core/executor.mjs +645 -0
  22. package/src/core/human-review.mjs +773 -0
  23. package/src/core/intake.mjs +116 -0
  24. package/src/core/kickoff.mjs +147 -0
  25. package/src/core/loop.mjs +498 -0
  26. package/src/core/memory.mjs +193 -0
  27. package/src/core/next-step.mjs +377 -0
  28. package/src/core/notify.mjs +183 -0
  29. package/src/core/owner.mjs +41 -0
  30. package/src/core/requirements.mjs +262 -0
  31. package/src/core/review.mjs +82 -0
  32. package/src/core/session-naming.mjs +64 -0
  33. package/src/core/split-ask.mjs +107 -0
  34. package/src/core/store.mjs +3103 -0
  35. package/src/core/team.mjs +170 -0
  36. package/src/core/verify.mjs +170 -0
  37. package/src/core/watchdog.mjs +144 -0
  38. package/src/host/ai-elaborator.mjs +26 -0
  39. package/src/host/team-engine.mjs +125 -0
  40. package/src/host/tool-surface.mjs +205 -0
  41. package/src/server/api.mjs +1974 -0
  42. package/src/server/events.mjs +32 -0
  43. package/src/server/kickoff.mjs +46 -0
  44. package/src/server/server.mjs +211 -0
  45. package/src/server/verify.mjs +112 -0
  46. package/tools/env-check.mjs +35 -0
  47. package/tools/seed.mjs +67 -0
  48. package/web/app.js +5237 -0
  49. package/web/index.html +15 -0
  50. package/web/tokens.css +1139 -0
@@ -0,0 +1,32 @@
1
+ /**
2
+ * events.mjs —— 极简 SSE 事件中心(FR-41:进度可见,无需手动刷新)。
3
+ * 语义与上游一致:**事件只是"失效信号"**,客户端收到后重取(不做增量合并)。
4
+ */
5
+ export function createEventHub() {
6
+ const clients = new Set();
7
+ return {
8
+ subscribe(response) {
9
+ response.writeHead(200, {
10
+ "content-type": "text/event-stream; charset=utf-8",
11
+ "cache-control": "no-store",
12
+ connection: "keep-alive",
13
+ "x-content-type-options": "nosniff",
14
+ });
15
+ response.write(": connected\n\n");
16
+ clients.add(response);
17
+ // unref:心跳只服务于「这条连接还活着」,**不得**因为漏 unsub / 客户端异常收尾而把整个进程
18
+ // (含 node:test 子进程 / 测试套件)钉住 —— 真机事故:两个红用例提前抛错跳过 unsub ⇒ npm test 永久挂死。
19
+ const ping = setInterval(() => { try { response.write(": ping\n\n"); } catch { /* ignore */ } }, 20000);
20
+ ping.unref?.();
21
+ const close = () => { clearInterval(ping); clients.delete(response); };
22
+ response.on?.("close", close);
23
+ response.on?.("error", close);
24
+ return close;
25
+ },
26
+ publish(type, payload = {}) {
27
+ const frame = `event: ${type}\ndata: ${JSON.stringify({ type, at: new Date().toISOString(), ...payload })}\n\n`;
28
+ for (const response of clients) { try { response.write(frame); } catch { /* ignore */ } }
29
+ },
30
+ get size() { return clients.size; },
31
+ };
32
+ }
@@ -0,0 +1,46 @@
1
+ /**
2
+ * FR-92 开局对齐自检的 **I/O 半**(黑盒:只读工作区,不写任何东西)。
3
+ *
4
+ * 与 `../core/kickoff.mjs`(纯函数)配对,沿用本仓 verify.mjs 的分层习惯:
5
+ * 纯函数负责判据口径,本模块只负责"把工作区的事实采集出来"。
6
+ */
7
+ import { existsSync, statSync } from "node:fs";
8
+ import path from "node:path";
9
+
10
+ import { KICKOFF_ALIGNMENT_STEPS } from "../core/kickoff.mjs";
11
+
12
+ /** 采集工作区事实:把每个步骤里提到的候选路径都查一遍存在性。 */
13
+ export function collectKickoffFacts(root) {
14
+ const files = {};
15
+ if (typeof root !== "string" || root === "" || !existsSync(root)) return { root: root ?? null, readable: false, files };
16
+ for (const step of KICKOFF_ALIGNMENT_STEPS) {
17
+ for (const check of step.checks) {
18
+ for (const rel of check.paths ?? []) {
19
+ if (rel in files) continue;
20
+ files[rel] = existsSync(path.join(root, rel));
21
+ }
22
+ }
23
+ }
24
+ return { root, readable: true, files };
25
+ }
26
+
27
+ /** 团队模板里有没有 reviewer(审计)角色 —— 各仓模板写法不一,这里做**宽松但明确**的判定。 */
28
+ export function hasReviewerRole(teamTemplate) {
29
+ const roles = teamTemplate?.roles;
30
+ if (Array.isArray(roles)) return roles.some((r) => String(r?.role ?? r ?? "").toLowerCase().includes("review"));
31
+ if (roles && typeof roles === "object") return Object.keys(roles).some((k) => k.toLowerCase().includes("review"));
32
+ return false;
33
+ }
34
+
35
+ /** 工程师角色的执行器/验证命令有没有约定(roles 数组里找 engineer;或模板里单开 engineer 段)。 */
36
+ export function hasEngineerExecutor(teamTemplate) {
37
+ const roles = teamTemplate?.roles;
38
+ if (Array.isArray(roles) && roles.some((r) => String(r?.role ?? "").toLowerCase() === "engineer" && String(r?.executor ?? "").trim() !== "")) return true;
39
+ if (roles && typeof roles === "object" && roles.engineer) return true;
40
+ return String(teamTemplate?.engineer?.verifyCommand ?? "").trim() !== "";
41
+ }
42
+
43
+ /** 目录是否是可读目录(避免把文件当工作区)。 */
44
+ export function isDirectory(p) {
45
+ try { return statSync(p).isDirectory(); } catch { return false; }
46
+ }
@@ -0,0 +1,211 @@
1
+ /**
2
+ * server.mjs —— 独立开发验证台(零依赖 http 外壳)。
3
+ * 路由逻辑在 api.mjs(与 DSH 宿主插件共用);本文件只负责:
4
+ * · 解析 URL / 请求体,把请求交给 router;
5
+ * · 静态托管 web/(DSH 插件在同一路径下复用同一 handler);
6
+ * · basePath 前缀剥离(DSH 挂在 /integrations/taskboard-workbench 下)。
7
+ */
8
+ import http from "node:http";
9
+ import { readFile, stat } from "node:fs/promises";
10
+ import path from "node:path";
11
+ import { fileURLToPath, pathToFileURL } from "node:url";
12
+
13
+ import { resolveDataDir } from "../core/config.mjs";
14
+ import { TbError } from "../core/errors.mjs";
15
+ import { openStore } from "../core/store.mjs";
16
+ import { API_SCHEMA_VERSION, createApiRouter, httpStatusFor } from "./api.mjs";
17
+ import { createEventHub } from "./events.mjs";
18
+
19
+ export const DEFAULT_PORT = 47830;
20
+ export const DEFAULT_PROJECT_ID = "default";
21
+ export const DEFAULT_BASE_PATH = "";
22
+
23
+ const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
24
+ export const WEB_DIR = path.join(ROOT, "web");
25
+ const MAX_BODY_BYTES = 1_000_000;
26
+ const CONTENT_TYPES = new Map([
27
+ [".html", "text/html; charset=utf-8"],
28
+ [".js", "text/javascript; charset=utf-8"],
29
+ [".css", "text/css; charset=utf-8"],
30
+ [".json", "application/json; charset=utf-8"],
31
+ [".svg", "image/svg+xml"],
32
+ [".ico", "image/x-icon"],
33
+ ]);
34
+
35
+ function sendJson(response, status, payload, schemaVersion = API_SCHEMA_VERSION) {
36
+ const body = JSON.stringify({ schemaVersion, ...payload }, null, 2);
37
+ response.setHeader("x-content-type-options", "nosniff");
38
+ response.setHeader("referrer-policy", "no-referrer");
39
+ response.writeHead(status, {
40
+ "content-type": "application/json; charset=utf-8",
41
+ "cache-control": "no-store",
42
+ "content-length": Buffer.byteLength(body),
43
+ });
44
+ response.end(body);
45
+ }
46
+
47
+ function sendError(response, error, schemaVersion = API_SCHEMA_VERSION) {
48
+ const tbError = error instanceof TbError ? error : new TbError("DATA_ERROR", error instanceof Error ? error.message : String(error));
49
+ sendJson(response, httpStatusFor(tbError), { error: tbError.toJSON() }, schemaVersion);
50
+ }
51
+
52
+ async function readJsonBody(request) {
53
+ const chunks = [];
54
+ let size = 0;
55
+ for await (const chunk of request) {
56
+ size += chunk.length;
57
+ if (size > MAX_BODY_BYTES) throw new TbError("INVALID_FIELD", "请求体过大(上限 1MB)");
58
+ chunks.push(chunk);
59
+ }
60
+ if (chunks.length === 0) return {};
61
+ const text = Buffer.concat(chunks).toString("utf8").trim();
62
+ if (text === "") return {};
63
+ let parsed;
64
+ try {
65
+ parsed = JSON.parse(text);
66
+ } catch (error) {
67
+ throw new TbError("INVALID_FIELD", `请求体不是合法 JSON:${error.message}`);
68
+ }
69
+ if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
70
+ throw new TbError("INVALID_FIELD", "请求体必须是 JSON 对象");
71
+ }
72
+ return parsed;
73
+ }
74
+
75
+ /** 首次启动若无项目则建一个内置默认项目。 */
76
+ export function ensureDefaultProject(store) {
77
+ const projects = store.listProjects();
78
+ if (projects.length > 0) return { created: false, projects };
79
+ const project = store.createProject({ id: DEFAULT_PROJECT_ID, name: "默认项目" });
80
+ return { created: true, projects: [project], project };
81
+ }
82
+
83
+ /** 剥离 basePath:不在前缀下的请求返回 null(调用方决定 404)。 */
84
+ export function stripBasePath(pathname, basePath) {
85
+ if (!basePath || basePath === "/") return pathname;
86
+ const prefix = basePath.endsWith("/") ? basePath.slice(0, -1) : basePath;
87
+ if (pathname === prefix) return "/";
88
+ if (pathname.startsWith(`${prefix}/`)) return pathname.slice(prefix.length);
89
+ return null;
90
+ }
91
+
92
+ /**
93
+ * 构造 Node 请求处理器:独立服务与 DSH 宿主插件共用。
94
+ * @param {{store: object, webDir?: string, basePath?: string, schemaVersion?: number}} options
95
+ */
96
+ export function createRequestHandler({ store, webDir = WEB_DIR, basePath = DEFAULT_BASE_PATH, schemaVersion = API_SCHEMA_VERSION, aiElaborator, events } = {}) {
97
+ if (!store) throw new Error("createRequestHandler 需要 store");
98
+ const router = createApiRouter({ store, aiElaborator, events });
99
+
100
+ async function serveStatic(response, urlPath) {
101
+ const relative = urlPath === "/" ? "index.html" : urlPath.replace(/^\/+/, "");
102
+ const base = path.resolve(webDir);
103
+ const target = path.resolve(base, relative);
104
+ if (target !== base && !target.startsWith(`${base}${path.sep}`)) {
105
+ sendJson(response, 403, { error: { code: "FORBIDDEN", message: "路径越界" } }, schemaVersion);
106
+ return;
107
+ }
108
+ try {
109
+ const info = await stat(target);
110
+ if (!info.isFile()) throw Object.assign(new Error("not a file"), { code: "ENOENT" });
111
+ const body = await readFile(target);
112
+ response.setHeader("x-content-type-options", "nosniff");
113
+ response.setHeader("referrer-policy", "no-referrer");
114
+ response.writeHead(200, {
115
+ "content-type": CONTENT_TYPES.get(path.extname(target)) ?? "application/octet-stream",
116
+ "content-length": body.length,
117
+ "cache-control": "no-store",
118
+ });
119
+ response.end(body);
120
+ } catch (error) {
121
+ if (error.code === "ENOENT") {
122
+ response.writeHead(404, { "content-type": "text/plain; charset=utf-8" });
123
+ response.end("404 Not Found\n");
124
+ return;
125
+ }
126
+ throw error;
127
+ }
128
+ }
129
+
130
+ return async function handle(request, response) {
131
+ try {
132
+ const url = new URL(request.url ?? "/", "http://127.0.0.1");
133
+ const inner = stripBasePath(url.pathname, basePath);
134
+ if (inner === null) {
135
+ sendJson(response, 404, { error: { code: "NOT_FOUND", message: `不在插件命名空间下:${url.pathname}` } }, schemaVersion);
136
+ return;
137
+ }
138
+ const method = request.method ?? "GET";
139
+
140
+ if (inner === "/api/events" && method === "GET" && events) {
141
+ events.subscribe(response);
142
+ return;
143
+ }
144
+
145
+ if (!inner.startsWith("/api/")) {
146
+ if (method !== "GET" && method !== "HEAD") {
147
+ response.writeHead(405, { allow: "GET, HEAD" });
148
+ response.end();
149
+ return;
150
+ }
151
+ await serveStatic(response, inner);
152
+ return;
153
+ }
154
+
155
+ const body = method === "GET" || method === "HEAD" ? {} : await readJsonBody(request);
156
+ const { status, payload } = await router.route({ method, pathname: inner, searchParams: url.searchParams, body });
157
+ sendJson(response, status, payload, schemaVersion);
158
+ } catch (error) {
159
+ sendError(response, error, schemaVersion);
160
+ }
161
+ };
162
+ }
163
+
164
+ export function createServer(options = {}) {
165
+ const events = options.events ?? createEventHub();
166
+ const handler = createRequestHandler({ ...options, events });
167
+ return http.createServer((request, response) => {
168
+ handler(request, response).catch((error) => sendError(response, error, options.schemaVersion ?? API_SCHEMA_VERSION));
169
+ });
170
+ }
171
+
172
+ export function startServer({ dataDir, port, host = "127.0.0.1", env = process.env, basePath = DEFAULT_BASE_PATH } = {}) {
173
+ const store = openStore({ dataDir, env });
174
+ const ensured = ensureDefaultProject(store);
175
+ const server = createServer({ store, basePath });
176
+ const resolvedPort = Number(port ?? env.TB_PORT ?? DEFAULT_PORT);
177
+ server.listen(resolvedPort, host, () => {
178
+ const address = server.address();
179
+ console.log(`[tb] listening on http://${host}:${address.port}${basePath}/`);
180
+ console.log(`[tb] dataDir=${store.dataDir}`);
181
+ console.log(`[tb] db=${store.dbPath}`);
182
+ console.log(`[tb] projects=${ensured.projects.length}${ensured.created ? " (auto-created default project)" : ""}`);
183
+ console.log(`[tb] migration(owner)=${JSON.stringify(store.stats().migration)}`);
184
+ });
185
+ const close = () => {
186
+ server.close(() => {
187
+ store.close();
188
+ process.exit(0);
189
+ });
190
+ // 优雅重启必须真的退出(P1-4,2026-10-29 修)。
191
+ // 根因:前端常开 `new EventSource('/api/events')`(SSE 长连接),而 `server.close(cb)` 只停止接受
192
+ // 新连接、要等**既有连接全部结束**才回调 => 只要有一个页面开着,回调永不触发 => SIGTERM 之后进程
193
+ // 挂着不退,继续持有 SQLite,下一个实例起来就形成同库双写者,再下次重启还要撞 EADDRINUSE。
194
+ // 真机事故:孤儿 52278(2026-10-28)与 41116(2026-10-29)都是这一条留下的。
195
+ // closeAllConnections 强制断开 SSE 与 keep-alive(Node >= 18.2;本包 engines 要求 >= 22.5)。
196
+ server.closeAllConnections?.();
197
+ // 兜底:即便运行环境没有 closeAllConnections,也必须在 3s 内退出 —— 不许再留孤儿。
198
+ setTimeout(() => {
199
+ try { store.close(); } catch { /* ignore */ }
200
+ process.exit(0);
201
+ }, 3000).unref();
202
+ };
203
+ process.once("SIGINT", close);
204
+ process.once("SIGTERM", close);
205
+ return { server, store };
206
+ }
207
+
208
+ const entryHref = process.argv[1] ? pathToFileURL(path.resolve(process.argv[1])).href : "";
209
+ if (entryHref === import.meta.url) {
210
+ startServer({ dataDir: resolveDataDir({ env: process.env }), port: process.env.TB_PORT });
211
+ }
@@ -0,0 +1,112 @@
1
+ /**
2
+ * FR-90:把「跑一遍验证命令」这件 I/O 与纯函数分开,便于单测与超时兜底。
3
+ *
4
+ * 约束(写在最前面,避免以后被"顺手"放宽):
5
+ * - **只跑一条命令**,在项目配置的工作区目录里,**超时即杀**(默认 180s,可由调用方指定);
6
+ * - 输出**只留尾段**(默认 4000 字符)——证据评论不是日志搬运;
7
+ * - **不改任何任务状态**:评审通过 / 完成仍然只能由人点。
8
+ */
9
+ import { spawn } from "node:child_process";
10
+ import { readFile, stat } from "node:fs/promises";
11
+ import path from "node:path";
12
+
13
+ import { VERIFY_DEFAULT_COMMAND } from "../core/verify.mjs";
14
+
15
+ export const VERIFY_DEFAULT_TIMEOUT_MS = 180000;
16
+
17
+ /**
18
+ * 跑一条验证命令。
19
+ *
20
+ * @param {object} opts
21
+ * @param {string} opts.command 命令行(交给 shell 执行:项目自己配置的验证脚本本就是命令行)
22
+ * @param {string} opts.cwd 工作目录(项目 workspacePath)
23
+ * @param {number} [opts.timeoutMs]
24
+ * @param {number} [opts.maxTailChars]
25
+ * @returns {Promise<{exitCode:number|null,timedOut:boolean,durationMs:number,tail:string}>}
26
+ */
27
+ export function runVerifyCommand({ command, cwd, timeoutMs = VERIFY_DEFAULT_TIMEOUT_MS, maxTailChars = 4000 } = {}) {
28
+ return new Promise((resolve) => {
29
+ const startedAt = Date.now();
30
+ const chunks = [];
31
+ let timedOut = false;
32
+ let child;
33
+ try {
34
+ child = spawn(String(command), { cwd, shell: true, env: process.env });
35
+ } catch (error) {
36
+ resolve({ exitCode: null, timedOut: false, durationMs: Date.now() - startedAt, tail: `命令无法启动:${error.message}` });
37
+ return;
38
+ }
39
+ const collect = (buf) => {
40
+ chunks.push(String(buf));
41
+ // 只保留尾部:长输出的命令(如全量测试)不该把内存与评论撑爆。
42
+ let total = 0;
43
+ for (let i = chunks.length - 1; i >= 0; i -= 1) {
44
+ total += chunks[i].length;
45
+ if (total > maxTailChars * 2) { chunks.splice(0, i); break; }
46
+ }
47
+ };
48
+ child.stdout?.on("data", collect);
49
+ child.stderr?.on("data", collect);
50
+ const timer = setTimeout(() => {
51
+ timedOut = true;
52
+ try { child.kill("SIGKILL"); } catch { /* 已被回收 */ }
53
+ }, Math.max(1000, Number(timeoutMs) || VERIFY_DEFAULT_TIMEOUT_MS));
54
+ const finish = (exitCode) => {
55
+ clearTimeout(timer);
56
+ const text = chunks.join("");
57
+ resolve({
58
+ exitCode: timedOut ? null : exitCode,
59
+ timedOut,
60
+ durationMs: Date.now() - startedAt,
61
+ tail: text.length > maxTailChars ? text.slice(text.length - maxTailChars) : text,
62
+ });
63
+ };
64
+ child.on("error", (error) => {
65
+ clearTimeout(timer);
66
+ resolve({ exitCode: null, timedOut: false, durationMs: Date.now() - startedAt, tail: `命令执行出错:${error.message}` });
67
+ });
68
+ child.on("close", (code) => finish(code));
69
+ });
70
+ }
71
+
72
+ /**
73
+ * FR-90 补口(真机 2026-10-28 · hydro-two-ticket 的 T7-B):**默认命令适用性探测**。
74
+ *
75
+ * 报障原文:`npm error enoent Could not read package.json … /00-project-realDemo/package.json`、
76
+ * 退出码 **254**、结论「失败」 —— 但该工作区是 Java 工程(8091 旧 Node → 8096 新 Java),
77
+ * **它本来就没有 `npm test`**。把「命令不适用」记成「测试失败」,评委只能误判。
78
+ *
79
+ * 边界(刻意收窄,不做"智能选命令"):
80
+ * - **只探内置默认命令** —— 人配过的命令(任务级 / 项目设置 / 本次显式指定)一律照跑,不替他判断;
81
+ * - 只看 `cwd/package.json` 这一层:没有 ⇒ 不是 Node 工程;有但没有 `scripts.test` ⇒ 无可跑测试;
82
+ * - `package.json` 坏 JSON ⇒ **不判断**,交给 npm 自己报(不替它吞错)。
83
+ */
84
+ export async function probeVerifyApplicability({ command, cwd } = {}) {
85
+ const cmd = String(command ?? "").trim();
86
+ if (cmd !== VERIFY_DEFAULT_COMMAND) return { applicable: true, reason: null };
87
+ const dir = String(cwd ?? "").trim();
88
+ if (!dir) return { applicable: true, reason: null };
89
+ const pkg = path.resolve(dir, "package.json");
90
+ try {
91
+ await stat(pkg);
92
+ } catch {
93
+ return { applicable: false, reason: "工作区里没有 package.json(不是 Node 工程)" };
94
+ }
95
+ let raw;
96
+ try {
97
+ raw = await readFile(pkg, "utf8");
98
+ } catch {
99
+ return { applicable: true, reason: null };
100
+ }
101
+ let parsed;
102
+ try {
103
+ parsed = JSON.parse(raw);
104
+ } catch {
105
+ return { applicable: true, reason: null };
106
+ }
107
+ const test = parsed?.scripts?.test;
108
+ if (typeof test !== "string" || test.trim() === "") {
109
+ return { applicable: false, reason: "package.json 里没有 test 脚本" };
110
+ }
111
+ return { applicable: true, reason: null };
112
+ }
@@ -0,0 +1,35 @@
1
+ // 环境自检工具:确认本项目代码在本机可运行的最小前提。
2
+ // 用法:node tools/env-check.mjs (cwd = 本项目根目录)
3
+ import { DatabaseSync } from "node:sqlite";
4
+ import { writeFileSync, mkdtempSync } from "node:fs";
5
+ import os from "node:os";
6
+ import path from "node:path";
7
+
8
+ const out = { node: process.version, cwd: process.cwd() };
9
+
10
+ try {
11
+ const db = new DatabaseSync(":memory:");
12
+ db.exec("create table t(a integer)");
13
+ db.prepare("insert into t values (?)").run(1);
14
+ const row = db.prepare("select count(*) as n from t").get();
15
+ out.nodeSqlite = `ok (rows=${row.n})`;
16
+ } catch (e) {
17
+ out.nodeSqlite = `FAIL: ${e.message}`;
18
+ }
19
+
20
+ try {
21
+ const dir = mkdtempSync(path.join(os.tmpdir(), "tb-probe-"));
22
+ writeFileSync(path.join(dir, "x.txt"), "1");
23
+ out.tmpWrite = "ok";
24
+ } catch (e) {
25
+ out.tmpWrite = `FAIL: ${e.code || e.message}`;
26
+ }
27
+
28
+ try {
29
+ writeFileSync(path.join(process.cwd(), ".perm-write-test"), "1");
30
+ out.repoWrite = "ok";
31
+ } catch (e) {
32
+ out.repoWrite = `FAIL: ${e.code || e.message}`;
33
+ }
34
+
35
+ console.log(JSON.stringify(out, null, 2));
package/tools/seed.mjs ADDED
@@ -0,0 +1,67 @@
1
+ /**
2
+ * seed.mjs —— 灌入体现 agent team 语义的示例数据(幂等:项目已有任务则跳过)。
3
+ * owner 为 tasks 表正式字段(t24 起不再写 owner: 标签)。
4
+ * 用法:TB_DATA_DIR=/path/to/taskboard-data node tools/seed.mjs
5
+ */
6
+ import { resolveDataDir } from "../src/core/config.mjs";
7
+ import { openStore } from "../src/core/store.mjs";
8
+
9
+ const PROJECTS = [
10
+ {
11
+ id: "workbench",
12
+ name: "Agent Team 工作台(自研)",
13
+ tasks: [
14
+ { title: "看板骨架:七状态分列渲染", description: "按状态分列渲染任务卡;卡片显示编号/标题/优先级/标签/负责人。", status: "done", priority: "high", owner: "engineer", labels: ["看板", "MVP-A+"] },
15
+ { title: "HTTP API:任务列表/创建/更新/删除", description: "零依赖 node:http;写操作带 version 乐观锁。", status: "in_review", priority: "high", owner: "engineer", labels: ["API"] },
16
+ { title: "验收:浏览器可打开且能改状态", description: "在真实浏览器打开看板,点按钮改状态后刷新仍保持。", status: "in_progress", priority: "urgent", owner: "tester", labels: ["验收"] },
17
+ { title: "示例数据:角色与状态分布", description: "planner/engineer/tester/reviewer/archivist 五角色,七状态各有代表任务。", status: "in_progress", priority: "medium", owner: "planner", labels: ["数据"] },
18
+ { title: "评审:API 契约与前端一致性", description: "核对退出码/JSON 形状与前端调用一致;检查乐观锁冲突提示。", status: "todo", priority: "medium", owner: "reviewer", labels: ["评审"] },
19
+ { title: "待授权:会话关联(MVP-C)", description: "把任务与会话双向关联;本阶段不做,先登记在待办池。", status: "backlog", priority: "low", owner: "planner", labels: ["MVP-C"] },
20
+ { title: "受阻:浏览器自动化截图环境", description: "沙箱下 headless Chrome 不退出,截图改由人工核对页面 HTML。", status: "blocked", priority: "low", owner: "tester", labels: ["环境"] },
21
+ { title: "已取消:甘特视图", description: "不在 MVP-A+ 范围,明确取消。", status: "canceled", priority: "none", owner: "archivist", labels: ["不做"] },
22
+ { title: "文档:MVP-A+ 交付说明", description: "文件清单、API 一览、启动方式、实测命令与输出、已知限制。", status: "todo", priority: "high", owner: "archivist", labels: ["文档"] },
23
+ ],
24
+ },
25
+ {
26
+ id: "upstream",
27
+ name: "上游 dashi-taskboard 参考",
28
+ tasks: [
29
+ { title: "样式 token 对照:38 个语义变量", description: "把上游 tokens 映射到本项目 tokens.css,含暗色覆盖。", status: "done", priority: "medium", owner: "engineer", labels: ["样式"] },
30
+ { title: "参考实现盘点:看板与卡片职责", description: "见 docs/设计/前端样式与实现参考-2026-10-10.md。", status: "in_review", priority: "low", owner: "archivist", labels: ["参考"] },
31
+ ],
32
+ },
33
+ ];
34
+
35
+ const store = openStore({ dataDir: resolveDataDir({ env: process.env }) });
36
+ const created = { projects: [], tasks: [] };
37
+ try {
38
+ for (const spec of PROJECTS) {
39
+ if (!store.getProject(spec.id)) {
40
+ store.createProject({ id: spec.id, name: spec.name, workspacePath: null });
41
+ created.projects.push(spec.id);
42
+ }
43
+ if (store.listTasks({ projectId: spec.id }).length > 0) continue;
44
+ for (const task of spec.tasks) {
45
+ const saved = store.createTask({
46
+ projectId: spec.id,
47
+ title: task.title,
48
+ description: task.description,
49
+ status: task.status,
50
+ priority: task.priority,
51
+ owner: task.owner,
52
+ labels: task.labels,
53
+ });
54
+ created.tasks.push(saved.identifier);
55
+ }
56
+ }
57
+ console.log(JSON.stringify({
58
+ ok: true,
59
+ dataDir: store.dataDir,
60
+ dbPath: store.dbPath,
61
+ createdProjects: created.projects,
62
+ createdTasks: created.tasks,
63
+ stats: store.stats(),
64
+ }, null, 2));
65
+ } finally {
66
+ store.close();
67
+ }