dsh-taskboard 0.6.6 → 0.7.0

package/lib/host/templates.js

@@ -1,3 +1,4 @@
+import { BUILTIN_TEMPLATE_CONTENT, BUILTIN_TEMPLATE_IDS } from "../shared/builtin-templates.js";
 import { readFile } from "node:fs/promises";
 //#region src/host/templates.ts
 /**
@@ -10,81 +11,16 @@ import { readFile } from "node:fs/promises";
 *
 * @module dsh-taskboard/host/templates
 */
-/** The built-in templates seeded when the side file does not exist yet. */
-const BUILTIN_TEMPLATES = [
-	{
-		id: "tpl-feature",
-		name: "新增功能",
-		task: {
-			title: "新增：",
-			prompt: [
-				"实现以上新功能并按序交接：",
-				"1. 明确需求边界与验收标准，列出实现要点",
-				"2. 实现功能（含类型定义与错误处理）",
-				"3. 补充测试（单测/回归）",
-				"4. 运行相关测试套件确认通过"
-			].join("\n"),
-			urgency: "normal",
-			checklist: [
-				"实现要点已明确（需求边界与验收标准）",
-				"功能已实现并补充测试",
-				"相关测试套件通过"
-			]
-		}
-	},
-	{
-		id: "tpl-bugfix",
-		name: "Bug 修复",
-		task: {
-			title: "修复：",
-			prompt: [
-				"修复以上问题并按序交接：",
-				"1. 复现问题（写最小复现步骤或测试）",
-				"2. 定位根因，说明为什么会发生",
-				"3. 修复并补回归测试",
-				"4. 运行相关测试套件确认无回归"
-			].join("\n"),
-			urgency: "urgent",
-			checklist: [
-				"已复现并定位根因",
-				"修复已提交到任务分支",
-				"回归测试通过"
-			]
-		}
-	},
-	{
-		id: "tpl-release",
-		name: "发布检查",
-		task: {
-			title: "发布：",
-			prompt: "执行发布流程：版本号更新、构建、测试、变更记录，完成后按序交接（不要实际推送/发布，等用户确认）。",
-			urgency: "normal",
-			checklist: [
-				"版本号已更新（package.json 与版本常量同步）",
-				"构建通过",
-				"全部测试通过",
-				"变更记录已写"
-			]
-		}
-	},
-	{
-		id: "tpl-patrol",
-		name: "例行巡检",
-		task: {
-			title: "巡检：",
-			prompt: [
-				"例行巡检：检查依赖更新、失败测试、明显代码问题与未处理的告警。",
-				"发现的问题逐条列出（严重度/位置/建议），小问题直接修复，大问题只报告不动手。",
-				"输出巡检摘要（用 {{lastComments}} 可回看上次巡检结论）。"
-			].join("\n"),
-			urgency: "relaxed",
-			execution: {
-				mode: "scheduled",
-				cron: "0 9 * * 1"
-			}
-		}
-	}
-];
+/**
+* The built-in templates seeded when the side file does not exist yet.
+* Seeded from the shared zh content (the side file is plain data; the client
+* resolves the active locale at render time — see shared/builtin-templates.ts).
+*/
+const BUILTIN_TEMPLATES = BUILTIN_TEMPLATE_IDS.map((id) => ({
+	id,
+	name: BUILTIN_TEMPLATE_CONTENT.zh[id].name,
+	task: BUILTIN_TEMPLATE_CONTENT.zh[id].task
+}));
 /** Mint a template id. */
 function newTemplateId() {
 	return `tpl-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
@@ -94,11 +30,26 @@ function newTemplateId() {
 * writes are rare, human-paced GUI operations; last-write-wins is fine).
 */
 var TemplateStore = class {
-	file;
+	storageQueue;
 	templates;
 	loaded = false;
+	file;
 	/** @param file - absolute side-file path (next to the ledger). */
-	constructor(file) {
+	constructor(file, storageQueue) {
+		this.storageQueue = storageQueue;
+		this.file = file;
+	}
+	/** Current absolute template-file path. */
+	location() {
+		return this.file;
+	}
+	/** Persist the loaded template set to another file without switching. */
+	async writeCopy(file) {
+		await this.ensure();
+		await this.persist(this.templates ?? [], file);
+	}
+	/** Switch future writes after a prepared migration commits. */
+	setLocation(file) {
 		this.file = file;
 	}
 	/** Load once; a missing file seeds the built-ins; a corrupt file resets. */
@@ -127,11 +78,11 @@ var TemplateStore = class {
 		this.loaded = true;
 	}
 	/** Atomic persist (temp + fsync + rename — S10, same discipline as the ledger). */
-	async persist(templates) {
+	async persist(templates, file = this.file) {
 		const { mkdir, open, rename } = await import("node:fs/promises");
 		const { dirname, join } = await import("node:path");
-		await mkdir(dirname(this.file), { recursive: true });
-		const temp = join(dirname(this.file), `.${Math.random().toString(36).slice(2)}.tmp`);
+		await mkdir(dirname(file), { recursive: true });
+		const temp = join(dirname(file), `.${Math.random().toString(36).slice(2)}.tmp`);
 		const fh = await open(temp, "w");
 		try {
 			await fh.writeFile(JSON.stringify({ templates }, null, 2), "utf8");
@@ -139,52 +90,61 @@ var TemplateStore = class {
 		} finally {
 			await fh.close();
 		}
-		await rename(temp, this.file);
+		await rename(temp, file);
 	}
 	/** All templates (oldest first). */
 	async list() {
-		await this.ensure();
-		return (this.templates ?? []).slice();
+		const run = async () => {
+			await this.ensure();
+			return (this.templates ?? []).slice();
+		};
+		return this.storageQueue === void 0 ? run() : this.storageQueue.run(run);
 	}
 	/**
 	* Create or replace a template by id (a body without id creates).
 	* @returns the stored template.
 	*/
 	async upsert(input) {
-		await this.ensure();
-		const templates = this.templates ?? [];
-		const name = input.name.trim();
-		if (name.length === 0 || name.length > 60) throw new Error("模板名必须 1..60 字符");
-		const now = Date.now();
-		const existing = input.id !== void 0 ? templates.find((t) => t.id === input.id) : void 0;
-		if (existing?.builtin === true) throw new Error("内置模板不可覆盖；可删除后另建，或以新名称存为新模板");
-		const stored = existing !== void 0 ? {
-			...existing,
-			name,
-			task: input.task,
-			updatedAt: now
-		} : {
-			id: input.id ?? newTemplateId(),
-			name,
-			task: input.task,
-			createdAt: now,
-			updatedAt: now
+		const run = async () => {
+			await this.ensure();
+			const templates = this.templates ?? [];
+			const name = input.name.trim();
+			if (name.length === 0 || name.length > 60) throw new Error("模板名必须 1..60 字符");
+			const now = Date.now();
+			const existing = input.id !== void 0 ? templates.find((t) => t.id === input.id) : void 0;
+			if (existing?.builtin === true) throw new Error("内置模板不可覆盖；可删除后另建，或以新名称存为新模板");
+			const stored = existing !== void 0 ? {
+				...existing,
+				name,
+				task: input.task,
+				updatedAt: now
+			} : {
+				id: input.id ?? newTemplateId(),
+				name,
+				task: input.task,
+				createdAt: now,
+				updatedAt: now
+			};
+			const index = existing !== void 0 ? templates.indexOf(existing) : -1;
+			if (index >= 0) templates[index] = stored;
+			else templates.push(stored);
+			await this.persist(templates);
+			return stored;
 		};
-		const index = existing !== void 0 ? templates.indexOf(existing) : -1;
-		if (index >= 0) templates[index] = stored;
-		else templates.push(stored);
-		await this.persist(templates);
-		return stored;
+		return this.storageQueue === void 0 ? run() : this.storageQueue.run(run);
 	}
 	/** Delete a template by id; returns whether it existed. */
 	async remove(id) {
-		await this.ensure();
-		const templates = this.templates ?? [];
-		const index = templates.findIndex((t) => t.id === id);
-		if (index < 0) return false;
-		templates.splice(index, 1);
-		await this.persist(templates);
-		return true;
+		const run = async () => {
+			await this.ensure();
+			const templates = this.templates ?? [];
+			const index = templates.findIndex((t) => t.id === id);
+			if (index < 0) return false;
+			templates.splice(index, 1);
+			await this.persist(templates);
+			return true;
+		};
+		return this.storageQueue === void 0 ? run() : this.storageQueue.run(run);
 	}
 };
 //#endregion

package/lib/host/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","names":[],"sources":["../../src/host/templates.ts"],"sourcesContent":["/**\n * Host-side task-template store (0.4.0): one JSON side file next to the\n * ledger, seeded with the built-in templates on first load, mutated through\n * the same atomic persist discipline as the ledger.\n *\n * Pure data, no Cordis deps — the routes layer owns it and tests drive it\n * directly against a temp dir.\n *\n * @module dsh-taskboard/host/templates\n */\nimport { readFile } from 'node:fs/promises'\nimport type { TaskTemplate } from '../shared/api.ts'\n\n/** The built-in templates seeded when the side file does not exist yet. */\nexport const BUILTIN_TEMPLATES: ReadonlyArray<{ id: string; name: string; task: TaskTemplate['task'] }> = [\n  {\n    id: 'tpl-feature',\n    name: '新增功能',\n    task: {\n      title: '新增：',\n      prompt: [\n        '实现以上新功能并按序交接：',\n        '1. 明确需求边界与验收标准，列出实现要点',\n        '2. 实现功能（含类型定义与错误处理）',\n        '3. 补充测试（单测/回归）',\n        '4. 运行相关测试套件确认通过',\n      ].join('\\n'),\n      urgency: 'normal',\n      checklist: ['实现要点已明确（需求边界与验收标准）', '功能已实现并补充测试', '相关测试套件通过'],\n    },\n  },\n  {\n    id: 'tpl-bugfix',\n    name: 'Bug 修复',\n    task: {\n      title: '修复：',\n      prompt: [\n        '修复以上问题并按序交接：',\n        '1. 复现问题（写最小复现步骤或测试）',\n        '2. 定位根因，说明为什么会发生',\n        '3. 修复并补回归测试',\n        '4. 运行相关测试套件确认无回归',\n      ].join('\\n'),\n      urgency: 'urgent',\n      checklist: ['已复现并定位根因', '修复已提交到任务分支', '回归测试通过'],\n    },\n  },\n  {\n    id: 'tpl-release',\n    name: '发布检查',\n    task: {\n      title: '发布：',\n      prompt: '执行发布流程：版本号更新、构建、测试、变更记录，完成后按序交接（不要实际推送/发布，等用户确认）。',\n      urgency: 'normal',\n      checklist: ['版本号已更新（package.json 与版本常量同步）', '构建通过', '全部测试通过', '变更记录已写'],\n    },\n  },\n  {\n    id: 'tpl-patrol',\n    name: '例行巡检',\n    task: {\n      title: '巡检：',\n      prompt: [\n        '例行巡检：检查依赖更新、失败测试、明显代码问题与未处理的告警。',\n        '发现的问题逐条列出（严重度/位置/建议），小问题直接修复，大问题只报告不动手。',\n        '输出巡检摘要（用 {{lastComments}} 可回看上次巡检结论）。',\n      ].join('\\n'),\n      urgency: 'relaxed',\n      execution: { mode: 'scheduled', cron: '0 9 * * 1' },\n    },\n  },\n]\n\n/** Mint a template id. */\nfunction newTemplateId(): string {\n  return `tpl-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`\n}\n\n/**\n * The template store. NOT thread-synchronized like the ledger (template\n * writes are rare, human-paced GUI operations; last-write-wins is fine).\n */\nexport class TemplateStore {\n  private templates: TaskTemplate[] | undefined\n  private loaded = false\n\n  /** @param file - absolute side-file path (next to the ledger). */\n  constructor(private readonly file: string) {}\n\n  /** Load once; a missing file seeds the built-ins; a corrupt file resets. */\n  private async ensure(): Promise<void> {\n    if (this.loaded) return\n    let parsed: TaskTemplate[] | undefined\n    try {\n      const raw = await readFile(this.file, 'utf8')\n      const value = JSON.parse(raw) as { templates?: unknown }\n      if (Array.isArray(value.templates)) {\n        parsed = value.templates.filter((t): t is TaskTemplate =>\n          typeof t === 'object' && t !== null && typeof (t as TaskTemplate).id === 'string'\n          && typeof (t as TaskTemplate).name === 'string' && typeof (t as TaskTemplate).task === 'object')\n      }\n    } catch { /* missing or corrupt → seed */ }\n    if (parsed === undefined) {\n      const now = Date.now()\n      parsed = BUILTIN_TEMPLATES.map((t, i) => ({ ...t, task: { ...t.task }, builtin: true, createdAt: now, updatedAt: now + i }))\n      try { await this.persist(parsed) } catch { /* best effort — the seed returns in-memory */ }\n    }\n    this.templates = parsed\n    this.loaded = true\n  }\n\n  /** Atomic persist (temp + fsync + rename — S10, same discipline as the ledger). */\n  private async persist(templates: TaskTemplate[]): Promise<void> {\n    const { mkdir, open, rename } = await import('node:fs/promises')\n    const { dirname, join } = await import('node:path')\n    await mkdir(dirname(this.file), { recursive: true })\n    const temp = join(dirname(this.file), `.${Math.random().toString(36).slice(2)}.tmp`)\n    const fh = await open(temp, 'w')\n    try {\n      await fh.writeFile(JSON.stringify({ templates }, null, 2), 'utf8')\n      await fh.sync()\n    } finally {\n      await fh.close()\n    }\n    await rename(temp, this.file)\n  }\n\n  /** All templates (oldest first). */\n  async list(): Promise<TaskTemplate[]> {\n    await this.ensure()\n    return (this.templates ?? []).slice()\n  }\n\n  /**\n   * Create or replace a template by id (a body without id creates).\n   * @returns the stored template.\n   */\n  async upsert(input: { id?: string; name: string; task: TaskTemplate['task'] }): Promise<TaskTemplate> {\n    await this.ensure()\n    const templates = this.templates ?? []\n    const name = input.name.trim()\n    if (name.length === 0 || name.length > 60) throw new Error('模板名必须 1..60 字符')\n    const now = Date.now()\n    const existing = input.id !== undefined ? templates.find(t => t.id === input.id) : undefined\n    // T12: built-ins are factory content — editable only by delete + recreate\n    // (deleting stays allowed), never silently overwritten in place.\n    if (existing?.builtin === true) throw new Error('内置模板不可覆盖；可删除后另建，或以新名称存为新模板')\n    const stored: TaskTemplate = existing !== undefined\n      ? { ...existing, name, task: input.task, updatedAt: now }\n      : { id: input.id ?? newTemplateId(), name, task: input.task, createdAt: now, updatedAt: now }\n    const index = existing !== undefined ? templates.indexOf(existing) : -1\n    if (index >= 0) templates[index] = stored\n    else templates.push(stored)\n    await this.persist(templates)\n    return stored\n  }\n\n  /** Delete a template by id; returns whether it existed. */\n  async remove(id: string): Promise<boolean> {\n    await this.ensure()\n    const templates = this.templates ?? []\n    const index = templates.findIndex(t => t.id === id)\n    if (index < 0) return false\n    templates.splice(index, 1)\n    await this.persist(templates)\n    return true\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"templates.js","names":[],"sources":["../../src/host/templates.ts"],"sourcesContent":["/**\n * Host-side task-template store (0.4.0): one JSON side file next to the\n * ledger, seeded with the built-in templates on first load, mutated through\n * the same atomic persist discipline as the ledger.\n *\n * Pure data, no Cordis deps — the routes layer owns it and tests drive it\n * directly against a temp dir.\n *\n * @module dsh-taskboard/host/templates\n */\nimport { readFile } from 'node:fs/promises'\nimport type { TaskTemplate } from '../shared/api.ts'\nimport { BUILTIN_TEMPLATE_CONTENT, BUILTIN_TEMPLATE_IDS, type BuiltinTemplateId } from '../shared/builtin-templates.ts'\nimport type { StorageQueue } from './storage-queue.ts'\n\n/**\n * The built-in templates seeded when the side file does not exist yet.\n * Seeded from the shared zh content (the side file is plain data; the client\n * resolves the active locale at render time — see shared/builtin-templates.ts).\n */\nexport const BUILTIN_TEMPLATES: ReadonlyArray<{ id: BuiltinTemplateId; name: string; task: TaskTemplate['task'] }> =\n  BUILTIN_TEMPLATE_IDS.map(id => ({ id, name: BUILTIN_TEMPLATE_CONTENT.zh[id].name, task: BUILTIN_TEMPLATE_CONTENT.zh[id].task }))\n\n/** Mint a template id. */\nfunction newTemplateId(): string {\n  return `tpl-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`\n}\n\n/**\n * The template store. NOT thread-synchronized like the ledger (template\n * writes are rare, human-paced GUI operations; last-write-wins is fine).\n */\nexport class TemplateStore {\n  private templates: TaskTemplate[] | undefined\n  private loaded = false\n  private file: string\n\n  /** @param file - absolute side-file path (next to the ledger). */\n  constructor(file: string, private readonly storageQueue?: StorageQueue) { this.file = file }\n\n  /** Current absolute template-file path. */\n  location(): string { return this.file }\n\n  /** Persist the loaded template set to another file without switching. */\n  async writeCopy(file: string): Promise<void> {\n    await this.ensure()\n    await this.persist(this.templates ?? [], file)\n  }\n\n  /** Switch future writes after a prepared migration commits. */\n  setLocation(file: string): void { this.file = file }\n\n  /** Load once; a missing file seeds the built-ins; a corrupt file resets. */\n  private async ensure(): Promise<void> {\n    if (this.loaded) return\n    let parsed: TaskTemplate[] | undefined\n    try {\n      const raw = await readFile(this.file, 'utf8')\n      const value = JSON.parse(raw) as { templates?: unknown }\n      if (Array.isArray(value.templates)) {\n        parsed = value.templates.filter((t): t is TaskTemplate =>\n          typeof t === 'object' && t !== null && typeof (t as TaskTemplate).id === 'string'\n          && typeof (t as TaskTemplate).name === 'string' && typeof (t as TaskTemplate).task === 'object')\n      }\n    } catch { /* missing or corrupt → seed */ }\n    if (parsed === undefined) {\n      const now = Date.now()\n      parsed = BUILTIN_TEMPLATES.map((t, i) => ({ ...t, task: { ...t.task }, builtin: true, createdAt: now, updatedAt: now + i }))\n      try { await this.persist(parsed) } catch { /* best effort — the seed returns in-memory */ }\n    }\n    this.templates = parsed\n    this.loaded = true\n  }\n\n  /** Atomic persist (temp + fsync + rename — S10, same discipline as the ledger). */\n  private async persist(templates: TaskTemplate[], file = this.file): Promise<void> {\n    const { mkdir, open, rename } = await import('node:fs/promises')\n    const { dirname, join } = await import('node:path')\n    await mkdir(dirname(file), { recursive: true })\n    const temp = join(dirname(file), `.${Math.random().toString(36).slice(2)}.tmp`)\n    const fh = await open(temp, 'w')\n    try {\n      await fh.writeFile(JSON.stringify({ templates }, null, 2), 'utf8')\n      await fh.sync()\n    } finally {\n      await fh.close()\n    }\n    await rename(temp, file)\n  }\n\n  /** All templates (oldest first). */\n  async list(): Promise<TaskTemplate[]> {\n    const run = async (): Promise<TaskTemplate[]> => {\n      await this.ensure()\n      return (this.templates ?? []).slice()\n    }\n    return this.storageQueue === undefined ? run() : this.storageQueue.run(run)\n  }\n\n  /**\n   * Create or replace a template by id (a body without id creates).\n   * @returns the stored template.\n   */\n  async upsert(input: { id?: string; name: string; task: TaskTemplate['task'] }): Promise<TaskTemplate> {\n    const run = async (): Promise<TaskTemplate> => {\n    await this.ensure()\n    const templates = this.templates ?? []\n    const name = input.name.trim()\n    if (name.length === 0 || name.length > 60) throw new Error('模板名必须 1..60 字符')\n    const now = Date.now()\n    const existing = input.id !== undefined ? templates.find(t => t.id === input.id) : undefined\n    // T12: built-ins are factory content — editable only by delete + recreate\n    // (deleting stays allowed), never silently overwritten in place.\n    if (existing?.builtin === true) throw new Error('内置模板不可覆盖；可删除后另建，或以新名称存为新模板')\n    const stored: TaskTemplate = existing !== undefined\n      ? { ...existing, name, task: input.task, updatedAt: now }\n      : { id: input.id ?? newTemplateId(), name, task: input.task, createdAt: now, updatedAt: now }\n    const index = existing !== undefined ? templates.indexOf(existing) : -1\n    if (index >= 0) templates[index] = stored\n    else templates.push(stored)\n    await this.persist(templates)\n    return stored\n    }\n    return this.storageQueue === undefined ? run() : this.storageQueue.run(run)\n  }\n\n  /** Delete a template by id; returns whether it existed. */\n  async remove(id: string): Promise<boolean> {\n    const run = async (): Promise<boolean> => {\n    await this.ensure()\n    const templates = this.templates ?? []\n    const index = templates.findIndex(t => t.id === id)\n    if (index < 0) return false\n    templates.splice(index, 1)\n    await this.persist(templates)\n    return true\n    }\n    return this.storageQueue === undefined ? run() : this.storageQueue.run(run)\n  }\n}\n"],"mappings":"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"}

package/lib/host/tools.js

@@ -1,5 +1,6 @@
 import { asIsolation, asStatus, asUrgency, canTransition, checklistFromTexts, defaultIsolationOf, effectivePrompt, isClaim, isClaimedBy, newCommentId, newTaskId, normalizeBody, normalizeExecution, normalizeExecutionReport, normalizeModel, normalizePrompt, normalizeTitle, summarize, syncClaim } from "../shared/protocol.js";
 import { defineTool } from "./sdk.js";
+import { archiveTaskSessions } from "./archive-sessions.js";
 //#region src/host/tools.ts
 /** Render side: one compact task line (id/status/version are load-bearing). */
 function taskLine(t) {
@@ -59,6 +60,7 @@ function taskDetail(t) {
 }
 /** Stable error codes surfaced at the head of tool error messages. */
 const ERR = {
+	notReady: "taskboard_not_ready",
 	notFound: "not_found",
 	versionConflict: "version_conflict",
 	workspaceMismatch: "workspace_mismatch",
@@ -96,7 +98,8 @@ function workspaceFace(registry) {
 			id: ws.id,
 			path: ws.path,
 			title: ws.title
-		}))
+		})),
+		...typeof registry.archiveSession === "function" ? { archiveSession: (sessionId) => registry.archiveSession(sessionId) } : {}
 	};
 }
 /** Validate a pinned model: structural check always, provider route when known. */
@@ -167,16 +170,17 @@ function registerTaskboardTools(ctx, deps) {
 	const disposers = [];
 	const { store, workspaces } = deps;
 	const register = (tool) => {
-		if (process.env.ATB_TRACE === "1" && typeof tool.execute === "function") {
+		if (typeof tool.execute === "function") {
 			const orig = tool.execute;
 			tool.execute = async (args, exec) => {
-				console.error(`[atb ▶] ${tool.name}`, JSON.stringify(args).slice(0, 300));
+				await deps.ready?.();
+				if (process.env.ATB_TRACE === "1") console.error(`[atb ▶] ${tool.name}`, JSON.stringify(args).slice(0, 300));
 				try {
 					const result = await orig(args, exec);
-					console.error(`[atb ✓] ${tool.name}`, JSON.stringify(result).slice(0, 300));
+					if (process.env.ATB_TRACE === "1") console.error(`[atb ✓] ${tool.name}`, JSON.stringify(result).slice(0, 300));
 					return result;
 				} catch (error) {
-					console.error(`[atb ✗] ${tool.name}`, String(error).slice(0, 400));
+					if (process.env.ATB_TRACE === "1") console.error(`[atb ✗] ${tool.name}`, String(error).slice(0, 400));
 					throw error;
 				}
 			};
@@ -490,15 +494,20 @@ function registerTaskboardTools(ctx, deps) {
 				type: "number",
 				required: true,
 				description: "Task version you read; fails on mismatch."
+			},
+			archiveSessions: {
+				type: "boolean",
+				description: "When moving to archived: whether to archive associated execution sessions as well. Defaults to false."
 			}
 		},
 		output: {
 			schema: JSON_OUT,
 			render: (_args, value) => {
-				const t = value.task;
+				const v = value;
+				const t = v.task;
 				return [{
 					type: "text",
-					text: t === void 0 ? "移动失败。" : `任务 ${t.id} 已移到 ${t.status}，当前 v${t.version}。`
+					text: t === void 0 ? "移动失败。" : `任务 ${t.id} 已移到 ${t.status}，当前 v${t.version}。${v.sessionArchive === void 0 ? "" : ` 会话归档结果：${JSON.stringify(v.sessionArchive)}`}`
 				}];
 			}
 		},
@@ -508,9 +517,11 @@ function registerTaskboardTools(ctx, deps) {
 				const to = asStatus(args.status);
 				const callerWsId = to === "in_progress" ? await callerWorkspace(deps, exec) : void 0;
 				let next;
+				let beforeTask;
 				await store.mutate("task-moved", (ledger) => {
 					const { index, task } = liveTaskAt(ledger, args.id);
 					versionGuard(task, args.ifVersion);
+					beforeTask = task;
 					if (to === "done") throw new ToolError(ERR.forbidden, "moving a task to done requires explicit user confirmation (GUI); agents cannot do it");
 					if (!canTransition(task.status, to)) throw new ToolError(ERR.invalidTransition, `illegal transition ${task.status} → ${to}`);
 					if (task.status === "in_progress" && task.claimedBy !== void 0 && task.claimedBy !== actor.sessionId) throw new ToolError(ERR.forbidden, `task is held by session ${task.claimedBy}; never take over another session's claim`);
@@ -525,7 +536,11 @@ function registerTaskboardTools(ctx, deps) {
 					ledger.tasks[index] = next;
 					return [next];
 				});
-				return json({ task: summarize(next) });
+				const sessionArchive = to === "archived" && args.archiveSessions === true ? await archiveTaskSessions(beforeTask ?? next, deps.workspaces.archiveSession) : void 0;
+				return json({
+					task: summarize(next),
+					...sessionArchive !== void 0 ? { sessionArchive } : {}
+				});
 			} catch (error) {
 				fail(error);
 			}