dsh-taskboard 0.6.6 → 0.7.0

package/lib/host/routes.js

@@ -2,6 +2,9 @@ import { asBoardSettings, asIsolation, asPermission, asStatus, asUrgency, canTra
 import { WORKTREE_DIR, worktreePathOf } from "./git.js";
 import { removeMirror, repoMainPath } from "./isolation.js";
 import { createRepoScanner } from "./repos.js";
+import { archiveTaskSessions } from "./archive-sessions.js";
+import { activeHostLocale } from "./locale.js";
+import { MAX_ASSET_BYTES } from "./assets.js";
 import { ROUTE_PREFIX, SSE_PATH } from "../shared/api.js";
 import { ERR, ToolError } from "./tools.js";
 import { join, resolve, sep } from "node:path";
@@ -15,6 +18,7 @@ const MAX_BODY_BYTES = 5 * 1024 * 1024;
 const TASK_DIFF_RE = new RegExp(`^${ROUTE_PREFIX}/tasks/([^/]+)/diff$`);
 const TASK_RE = new RegExp(`^${ROUTE_PREFIX}/tasks/([^/]+)$`);
 const TASK_ACTION_RE = new RegExp(`^${ROUTE_PREFIX}/tasks/([^/]+)/([\\w-]+)$`);
+const ASSET_RE = new RegExp(`^${ROUTE_PREFIX}/assets/([a-f0-9]{64}\\.(?:png|jpg|gif|webp))$`);
 /** How long a workspace git-detection result stays cached (fail-soft). */
 const GIT_DETECT_TTL_MS = 6e4;
 /** Validate a template's task spec (routes-side, unknown → invalid_input). */
@@ -101,6 +105,18 @@ async function readBody(req) {
 		return null;
 	}
 }
+/** Read one bounded binary upload without ever buffering beyond the file cap. */
+async function readBytes(req, limit) {
+	const chunks = [];
+	let total = 0;
+	for await (const chunk of req) {
+		const bytes = chunk;
+		total += bytes.length;
+		if (total > limit) throw new Error("body too large");
+		chunks.push(bytes);
+	}
+	return Buffer.concat(chunks);
+}
 /** String field accessor (null when absent/not a string). */
 function str(body, key) {
 	const v = body[key];
@@ -228,7 +244,11 @@ function registerTaskboardRoutes(ctx, options) {
 		} catch {}
 		if (rootRepo && !gitHinted.has(path)) {
 			gitHinted.add(path);
-			if (await gitignoreMissing(path)) console.info(`[dsh-taskboard] 建议在 ${path}/.gitignore 加入一行 ${WORKTREE_DIR}/ 以隐藏任务 worktree 目录（不会自动修改）`);
+			if (await gitignoreMissing(path)) {
+				const file = `${path}/.gitignore`;
+				const hint = activeHostLocale(ctx) === "zh" ? `建议在 ${file} 加入一行 ${WORKTREE_DIR}/ 以隐藏任务 worktree 目录（不会自动修改）` : `suggests adding one line to ${file}: ${WORKTREE_DIR}/ to hide the task worktree directory (no automatic edits)`;
+				console.info(`[dsh-taskboard] ${hint}`);
+			}
 		}
 		let nestedCount = 0;
 		try {
@@ -281,11 +301,44 @@ function registerTaskboardRoutes(ctx, options) {
 			const url = new URL(req.url ?? "/", "http://x");
 			const pathname = url.pathname;
 			if (req.method === "GET") {
+				if (pathname === `/dsh-taskboard/storage`) {
+					if (options.storage === void 0) {
+						res.writeHead(501);
+						res.end();
+						return;
+					}
+					json(res, {
+						ok: true,
+						value: await options.storage.status()
+					});
+					return;
+				}
+				await options.ready?.();
+				const assetMatch = pathname.match(ASSET_RE);
+				if (assetMatch !== null) {
+					const asset = await options.assets?.read(assetMatch[1]);
+					if (asset === void 0) {
+						res.writeHead(404);
+						res.end();
+						return;
+					}
+					res.writeHead(200, {
+						"content-type": asset.mime,
+						"content-length": asset.bytes.length,
+						"cache-control": "public, max-age=31536000, immutable",
+						"x-content-type-options": "nosniff"
+					});
+					res.end(asset.bytes);
+					return;
+				}
 				if (pathname === `/dsh-taskboard/state`) {
 					await store.load();
 					json(res, {
 						ok: true,
-						value: store.snapshot()
+						value: {
+							...store.snapshot(),
+							capabilities: { archiveSessions: typeof workspaces.archiveSession === "function" }
+						}
 					});
 					return;
 				}
@@ -426,6 +479,31 @@ function registerTaskboardRoutes(ctx, options) {
 				res.end();
 				return;
 			}
+			if (pathname === `/dsh-taskboard/assets`) {
+				await options.ready?.();
+				if (options.assets === void 0) {
+					json(res, fail("invalid_input", "image attachments unavailable").res, 501);
+					return;
+				}
+				if (req.headers["x-dsh-taskboard-upload"] !== "1") {
+					json(res, fail("forbidden", "missing upload header").res, 403);
+					return;
+				}
+				const declaredMime = String(req.headers["content-type"] ?? "").split(";", 1)[0].trim().toLowerCase();
+				try {
+					const bytes = await readBytes(req, MAX_ASSET_BYTES);
+					await options.assets.cleanup(JSON.stringify(store.snapshot()));
+					json(res, {
+						ok: true,
+						value: await options.assets.put(bytes, declaredMime)
+					}, 201);
+				} catch (error) {
+					const message = error instanceof Error ? error.message : String(error);
+					const status = message.includes("1..") ? 413 : message.includes("quota") ? 507 : 400;
+					json(res, fail("invalid_input", message).res, status);
+				}
+				return;
+			}
 			if (!(req.headers["content-type"] ?? "").toLowerCase().startsWith("application/json")) {
 				json(res, fail("invalid_input", "content-type must be application/json").res, 415);
 				return;
@@ -441,6 +519,24 @@ function registerTaskboardRoutes(ctx, options) {
 				json(res, fail("invalid_input", "body is not a JSON object").res, 400);
 				return;
 			}
+			if (pathname === `/dsh-taskboard/storage/check` || pathname === `/dsh-taskboard/storage/migrate`) {
+				if (options.storage === void 0) {
+					json(res, fail("invalid_input", "storage configuration unavailable").res, 501);
+					return;
+				}
+				try {
+					const directory = str(body, "directory") ?? "";
+					json(res, {
+						ok: true,
+						value: pathname.endsWith("/check") ? await options.storage.check(directory) : await options.storage.migrate(directory)
+					});
+				} catch (error) {
+					const f = fail("invalid_input", error instanceof Error ? error.message : String(error));
+					json(res, f.res, f.status);
+				}
+				return;
+			}
+			await options.ready?.();
 			if (pathname === `/dsh-taskboard/tasks`) {
 				try {
 					const title = normalizeTitle(str(body, "title") ?? "");
@@ -507,6 +603,14 @@ function registerTaskboardRoutes(ctx, options) {
 				try {
 					const task = store.get(id);
 					if (task === void 0) throw new Error("Error: not_found: no such task");
+					if (action === "archive-sessions") {
+						if (task.trashedAt !== void 0 || task.status !== "archived") throw new Error("Error: invalid_transition: only archived live tasks can retry session archiving");
+						json(res, {
+							ok: true,
+							value: await archiveTaskSessions(task, workspaces.archiveSession)
+						});
+						return;
+					}
 					if (action === "update") {
 						const ifVersion = num(body, "ifVersion");
 						if (ifVersion === void 0 || ifVersion === null) throw new Error("Error: version_conflict: ifVersion required");
@@ -563,13 +667,16 @@ function registerTaskboardRoutes(ctx, options) {
 					if (action === "move") {
 						const ifVersion = num(body, "ifVersion");
 						const status = str(body, "status") ?? "";
+						const archiveSessions = body.archiveSessions === true;
 						if (ifVersion === void 0 || ifVersion === null) throw new Error("Error: version_conflict: ifVersion required");
 						const to = asStatus(status);
 						let next;
+						let beforeTask;
 						await store.mutate("task-moved", (ledger) => {
 							const { index, task } = liveTaskAt(ledger, id);
 							if (ifVersion !== task.version) throw new Error(`Error: version_conflict: stale version ${ifVersion} (current ${task.version})`);
 							if (!canTransition(task.status, to)) throw new Error(`Error: invalid_transition: illegal transition ${task.status} → ${to}`);
+							beforeTask = task;
 							next = structuredClone(task);
 							next.status = to;
 							next.version = task.version + 1;
@@ -580,9 +687,13 @@ function registerTaskboardRoutes(ctx, options) {
 							ledger.tasks[index] = next;
 							return [next];
 						});
+						const sessionArchive = to === "archived" && archiveSessions ? await archiveTaskSessions(beforeTask ?? next, workspaces.archiveSession) : void 0;
 						json(res, {
 							ok: true,
-							value: summarize(next)
+							value: {
+								...summarize(next),
+								...sessionArchive !== void 0 ? { sessionArchive } : {}
+							}
 						});
 						return;
 					}
@@ -799,12 +910,17 @@ function registerTaskboardRoutes(ctx, options) {
 								});
 							}
 						}
-						const pushComment = (body) => store.mutate("comment-added", (ledger) => {
+						const pushComment = (body, system) => store.mutate("comment-added", (ledger) => {
 							const { index, task: fresh } = liveTaskAt(ledger, id);
 							const next = structuredClone(fresh);
 							next.comments.push({
 								id: newCommentId(),
 								body: normalizeBody(body),
+								...system !== void 0 ? {
+									systemKey: system.key,
+									...system.params !== void 0 ? { systemParams: system.params } : {},
+									...system.rows !== void 0 ? { systemRows: system.rows } : {}
+								} : {},
 								version: 1,
 								createdAt: options.now()
 							});
@@ -828,7 +944,10 @@ function registerTaskboardRoutes(ctx, options) {
 								return;
 							}
 							if (root.outcome === "failed") throw new Error(`Error: invalid_input: ${root.error ?? "合并失败"}`);
-							await pushComment(`[系统] 分支 ${root.branch} 已合并到主工作区（--no-ff）。`);
+							await pushComment(`[系统] 分支 ${root.branch} 已合并到主工作区（--no-ff）。`, {
+								key: "sys.mergeSingle",
+								params: { branch: root.branch }
+							});
 							json(res, {
 								ok: true,
 								value: {
@@ -841,7 +960,14 @@ function registerTaskboardRoutes(ctx, options) {
 						const labelOf = (repo) => repo === "" ? "根仓库" : repo;
 						const mergedCount = results.filter((r) => r.outcome === "merged").length;
 						const failedCount = results.filter((r) => r.outcome === "failed").length;
-						await pushComment(`[系统] 分支已按仓库合并（--no-ff）：${results.map((r) => r.outcome === "merged" ? `${labelOf(r.repo)} ✓ 已合并` : r.outcome === "noop" ? `${labelOf(r.repo)} ⟲ 无新提交` : `${labelOf(r.repo)} ✗ ${(r.error ?? "合并失败").slice(0, 150)}`).join("；")}`);
+						await pushComment(`[系统] 分支已按仓库合并（--no-ff）：${results.map((r) => r.outcome === "merged" ? `${labelOf(r.repo)} ✓ 已合并` : r.outcome === "noop" ? `${labelOf(r.repo)} ⟲ 无新提交` : `${labelOf(r.repo)} ✗ ${(r.error ?? "合并失败").slice(0, 150)}`).join("；")}`, {
+							key: "sys.mergeMulti",
+							rows: results.map((r) => ({
+								repo: r.repo,
+								outcome: r.outcome,
+								...r.error !== void 0 ? { error: r.error.slice(0, 150) } : {}
+							}))
+						});
 						json(res, {
 							ok: true,
 							value: {