dsh-taskboard 0.6.5 → 0.6.7

package/src/host/routes.ts

@@ -1,3 +1,4 @@
+import { archiveTaskSessions } from './archive-sessions.ts'
 /**
  * /dsh-taskboard routes on the shared DSH webserver: a JSON API for the
  * GUI's human operations (create/update/move/comment/delete — actor `user`,
@@ -40,10 +41,12 @@ import {
   type TaskLedger,
   type TaskModel,
   type TaskRecord,
+  type SystemCommentRow,
 } from '../shared/protocol.ts'
 import { WORKTREE_DIR, worktreePathOf, type GitFace } from './git.ts'
 import { removeMirror, repoMainPath } from './isolation.ts'
 import { createRepoScanner, type RepoScanner } from './repos.ts'
+import { activeHostLocale } from './locale.ts'
 import type { CatalogModelItem, CatalogPresetItem, MergeRepoResult, TaskTemplate } from '../shared/api.ts'
 import type { TemplateStore } from './templates.ts'
 import { ROUTE_PREFIX, SSE_PATH, type ApiFail, type ApiResult } from '../shared/api.ts'
@@ -316,10 +319,15 @@ export function registerTaskboardRoutes(ctx: Context, options: TaskboardRoutesOp
     } catch { /* fail-soft → false */ }
     // gitignore 建议 (plan §3.2): suggest (never write) ignoring our
     // worktree directory, once per workspace per host run. Root repos only.
+    // The line is localized from the DSH locale preference (see host/locale.ts).
     if (rootRepo && !gitHinted.has(path)) {
       gitHinted.add(path)
       if (await gitignoreMissing(path)) {
-        console.info(`[dsh-taskboard] 建议在 ${path}/.gitignore 加入一行 ${WORKTREE_DIR}/ 以隐藏任务 worktree 目录（不会自动修改）`)
+        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}`)
       }
     }
     // The nested scan always runs: repoCount needs it even when the root
@@ -372,7 +380,7 @@ export function registerTaskboardRoutes(ctx: Context, options: TaskboardRoutesOp
       if (req.method === 'GET') {
         if (pathname === `${ROUTE_PREFIX}/state`) {
           await store.load()
-          json(res, { ok: true, value: store.snapshot() })
+          json(res, { ok: true, value: { ...store.snapshot(), capabilities: { archiveSessions: typeof workspaces.archiveSession === 'function' } } })
           return
         }
         if (pathname === `${ROUTE_PREFIX}/workspaces`) {
@@ -615,6 +623,12 @@ export function registerTaskboardRoutes(ctx: Context, options: TaskboardRoutesOp
         try {
           const task = store.get(id)
           if (task === undefined) throw new Error('Error: not_found: no such task')
+          if (action === 'archive-sessions') {
+            if (task.trashedAt !== undefined || task.status !== 'archived') throw new Error('Error: invalid_transition: only archived live tasks can retry session archiving')
+            const result = await archiveTaskSessions(task, workspaces.archiveSession)
+            json(res, { ok: true, value: result })
+            return
+          }
           if (action === 'update') {
             const ifVersion = num(body, 'ifVersion')
             if (ifVersion === undefined || ifVersion === null) throw new Error('Error: version_conflict: ifVersion required')
@@ -678,13 +692,16 @@ export function registerTaskboardRoutes(ctx: Context, options: TaskboardRoutesOp
           if (action === 'move') {
             const ifVersion = num(body, 'ifVersion')
             const status = str(body, 'status') ?? ''
+            const archiveSessions = body.archiveSessions === true
             if (ifVersion === undefined || ifVersion === null) throw new Error('Error: version_conflict: ifVersion required')
             const to = asStatus(status)
             let next: TaskRecord | undefined
+            let beforeTask: TaskRecord | undefined
             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
@@ -696,7 +713,10 @@ export function registerTaskboardRoutes(ctx: Context, options: TaskboardRoutesOp
               ledger.tasks[index] = next
               return [next]
             })
-            json(res, { ok: true, value: summarize(next!) })
+            const sessionArchive = to === 'archived' && archiveSessions
+              ? await archiveTaskSessions(beforeTask ?? next!, workspaces.archiveSession)
+              : undefined
+            json(res, { ok: true, value: { ...summarize(next!), ...(sessionArchive !== undefined ? { sessionArchive } : {}) } })
             return
           }
           if (action === 'reject') {
@@ -909,11 +929,21 @@ export function registerTaskboardRoutes(ctx: Context, options: TaskboardRoutesOp
             }
             // R1: the git merges above are slow — re-find the FRESH task inside
             // the mutation so a concurrent comment is never overwritten.
-            const pushComment = (body: string): Promise<void> =>
+            const pushComment = (body: string, system?: { key: string; params?: Record<string, string>; rows?: SystemCommentRow[] }): Promise<void> =>
               store.mutate('comment-added', ledger => {
                 const { index, task: fresh } = liveTaskAt(ledger, id)
                 const next = structuredClone(fresh)
-                next.comments.push({ id: newCommentId(), body: normalizeBody(body), version: 1, createdAt: options.now() })
+                next.comments.push({
+                  id: newCommentId(),
+                  body: normalizeBody(body),
+                  ...(system !== undefined ? {
+                    systemKey: system.key,
+                    ...(system.params !== undefined ? { systemParams: system.params } : {}),
+                    ...(system.rows !== undefined ? { systemRows: system.rows } : {}),
+                  } : {}),
+                  version: 1,
+                  createdAt: options.now(),
+                })
                 next.version = fresh.version + 1
                 next.updatedAt = options.now()
                 ledger.tasks[index] = next
@@ -930,7 +960,7 @@ export function registerTaskboardRoutes(ctx: Context, options: TaskboardRoutesOp
               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: { merged: true, branch: root.branch } })
               return
             }
@@ -942,7 +972,10 @@ export function registerTaskboardRoutes(ctx: Context, options: TaskboardRoutesOp
                 ? `${labelOf(r.repo)} ✓ 已合并`
                 : r.outcome === 'noop' ? `${labelOf(r.repo)} ⟲ 无新提交` : `${labelOf(r.repo)} ✗ ${(r.error ?? '合并失败').slice(0, 150)}`)
               .join('；')
-            await pushComment(`[系统] 分支已按仓库合并（--no-ff）：${summary}`)
+            await pushComment(`[系统] 分支已按仓库合并（--no-ff）：${summary}`, {
+              key: 'sys.mergeMulti',
+              rows: results.map(r => ({ repo: r.repo, outcome: r.outcome, ...(r.error !== undefined ? { error: r.error.slice(0, 150) } : {}) })),
+            })
             json(res, {
               ok: true,
               value: {

package/src/host/scheduler.ts

@@ -136,6 +136,8 @@ export class SchedulerService {
         task.comments.push({
           id: newCommentId(),
           body: normalizeBody(`[系统] 定时表达式 ${deadCron} 在 4 年内没有可触发时间，已停用定时；请修正 cron 后重新开启。`),
+          systemKey: 'sys.cronDead',
+          systemParams: { cron: deadCron },
           version: 1,
           createdAt: now,
         })

package/src/host/session-sync.ts

@@ -213,7 +213,7 @@ export class ExternalSessionSyncService {
 
   constructor(private readonly deps: SessionSyncDeps) {
     this.unsubscribe = deps.events.onSessionEvent((sessionId, event, sessionMeta) => {
-      void this.handleSessionEvent(sessionId, event, sessionMeta)
+      return this.handleSessionEvent(sessionId, event, sessionMeta)
     })
 
     const interval = deps.scanIntervalMs ?? DEFAULT_SCAN_INTERVAL_MS
@@ -628,6 +628,8 @@ export class ExternalSessionSyncService {
           task.comments.push({
             id: newCommentId(),
             body: normalizeBody(`[系统] 会话执行异常：${errorMessage.slice(0, 300)}；任务已退回待办。`),
+            systemKey: 'sys.sessionError',
+            systemParams: { error: errorMessage.slice(0, 300) },
             version: 1,
             createdAt: now,
           })
@@ -639,6 +641,7 @@ export class ExternalSessionSyncService {
           task.comments.push({
             id: newCommentId(),
             body: normalizeBody('[系统] 会话执行完毕，已自动进入待验收。'),
+            systemKey: 'sys.sessionDone',
             version: 1,
             createdAt: now,
           })

package/src/host/templates.ts

@@ -10,66 +10,15 @@
  */
 import { readFile } from 'node:fs/promises'
 import type { TaskTemplate } from '../shared/api.ts'
+import { BUILTIN_TEMPLATE_CONTENT, BUILTIN_TEMPLATE_IDS, type BuiltinTemplateId } from '../shared/builtin-templates.ts'
 
-/** The built-in templates seeded when the side file does not exist yet. */
-export const BUILTIN_TEMPLATES: ReadonlyArray<{ id: string; name: string; task: TaskTemplate['task'] }> = [
-  {
-    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).
+ */
+export const BUILTIN_TEMPLATES: ReadonlyArray<{ id: BuiltinTemplateId; name: string; task: TaskTemplate['task'] }> =
+  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(): string {

package/src/host/tools.ts

@@ -1,3 +1,5 @@
+import type { SessionArchiveResult } from '../shared/api.ts'
+import { archiveTaskSessions } from './archive-sessions.ts'
 /**
  * The ten `taskboard_*` agent tools. All writes require a calling agent
  * session (ownership audit), carry optimistic-version checks, and enforce
@@ -98,11 +100,15 @@ function taskDetail(t: TaskRecord & { effectivePrompt?: string }): string {
   if (t.checklist !== undefined && t.checklist.length > 0) {
     const done = t.checklist.filter(i => i.checked).length
     lines.push(`验收清单 (${done}/${t.checklist.length}):`)
-    for (const item of t.checklist) {
+    for (const [index, item] of t.checklist.entries()) {
       const mark = item.checked ? '☑' : '☐'
       const who = item.checkedBy === undefined ? '' : item.checkedBy === 'user' ? ' ·用户勾选' : ` ·agent ${String(item.checkedBy).slice(0, 24)}勾选`
       const note = item.note !== undefined ? ` ·证据: ${item.note}` : ''
-      lines.push(`  ${mark} ${item.text}${who}${note}`)
+      // Carry the checklist item id so `taskboard_checklist check/uncheck` can
+      // address it without guessing — a terse render starves the agent (render
+      // is fed to the model as result.content). Mirrors the index+id carried
+      // by the taskboard_checklist tool output.
+      lines.push(`  ${mark} [${index + 1}] ${item.text}${who}${note} id=${item.id}`)
     }
   }
   if (t.comments.length > 0) {
@@ -158,6 +164,8 @@ export interface WorkspaceFace {
   get(id: string): { id: string; path: string; title: string } | undefined
   /** List all workspaces. */
   list(): Array<{ id: string; path: string; title: string }>
+  /** Archive one session durably (when supported by runtime workspaceRegistry). */
+  archiveSession?(sessionId: string): Promise<void>
 }
 
 /** Adapt the real registry to the narrow face. */
@@ -174,6 +182,9 @@ export function workspaceFace(registry: WorkspaceRegistry): WorkspaceFace {
       return ws === undefined ? undefined : { id: ws.id, path: ws.path, title: ws.title }
     },
     list: () => registry.list().map(ws => ({ id: ws.id, path: ws.path, title: ws.title })),
+    ...(typeof registry.archiveSession === 'function'
+      ? { archiveSession: (sessionId: string) => registry.archiveSession(sessionId as Parameters<WorkspaceRegistry['archiveSession']>[0]) }
+      : {}),
   }
 }
 
@@ -407,7 +418,7 @@ export function registerTaskboardTools(ctx: ToolContextFace, deps: ToolDeps): Ar
     output: {
       schema: JSON_OUT,
       render: (_args, value) => {
-        const v = value as { task?: { id?: string; status?: string; version?: number } }
+        const v = value as { task?: { id?: string; status?: string; version?: number }; sessionArchive?: SessionArchiveResult }
         const t = v.task
         return [{ type: 'text', text: t === undefined ? '创建失败。' : `已创建任务 ${t.id} [${t.status}] v${t.version}。写入前先 taskboard_get 读取。` }]
       },
@@ -497,7 +508,7 @@ export function registerTaskboardTools(ctx: ToolContextFace, deps: ToolDeps): Ar
     output: {
       schema: JSON_OUT,
       render: (_args, value) => {
-        const v = value as { task?: { id?: string; status?: string; version?: number } }
+        const v = value as { task?: { id?: string; status?: string; version?: number }; sessionArchive?: SessionArchiveResult }
         const t = v.task
         return [{ type: 'text', text: t === undefined ? '更新失败。' : `已更新任务 ${t.id}，当前 v${t.version} [${t.status}]。` }]
       },
@@ -550,16 +561,17 @@ export function registerTaskboardTools(ctx: ToolContextFace, deps: ToolDeps): Ar
       id: { type: 'string', required: true, description: 'Task id.' },
       status: { type: 'string', required: true, description: 'Target status.' },
       ifVersion: { 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 v = value as { task?: { id?: string; status?: string; version?: number } }
+        const v = value as { task?: { id?: string; status?: string; version?: number }; sessionArchive?: SessionArchiveResult }
         const t = v.task
-        return [{ type: 'text', text: t === undefined ? '移动失败。' : `任务 ${t.id} 已移到 ${t.status}，当前 v${t.version}。` }]
+        return [{ type: 'text', text: t === undefined ? '移动失败。' : `任务 ${t.id} 已移到 ${t.status}，当前 v${t.version}。${v.sessionArchive === undefined ? '' : ` 会话归档结果：${JSON.stringify(v.sessionArchive)}`}` }]
       },
     },
-    async execute(args: { id: string; status: string; ifVersion: number }, exec: unknown) {
+    async execute(args: { id: string; status: string; ifVersion: number; archiveSessions?: boolean }, exec: unknown) {
       try {
         const { actor } = caller(exec as ToolRunContext)
         const to = asStatus(args.status)
@@ -571,9 +583,11 @@ export function registerTaskboardTools(ctx: ToolContextFace, deps: ToolDeps): Ar
           : undefined
         // R1: every state guard + the write itself run inside the mutation.
         let next: TaskRecord | undefined
+        let beforeTask: TaskRecord | undefined
         await store.mutate('task-moved', ledger => {
           const { index, task } = liveTaskAt(ledger, args.id)
           versionGuard(task, args.ifVersion)
+          beforeTask = task
 
           // Code-level gate: agents never complete a task.
           if (to === 'done') {
@@ -603,7 +617,10 @@ export function registerTaskboardTools(ctx: ToolContextFace, deps: ToolDeps): Ar
           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)
+          : undefined
+        return json({ task: summarize(next!), ...(sessionArchive !== undefined ? { sessionArchive } : {}) })
       } catch (error) { fail(error) }
     },
   })) as () => void)
@@ -925,4 +942,4 @@ export function registerTaskboardTools(ctx: ToolContextFace, deps: ToolDeps): Ar
   })) as () => void)
 
   return disposers
-}
+}

package/src/shared/api.ts

@@ -38,7 +38,7 @@ export type ApiResult<T> = ApiOk<T> | ApiFail
 // ---------------------------------------------------------------------------
 
 /** Full-state response (the reconnect baseline after an SSE gap). */
-export type StateResponse = TaskLedger
+export type StateResponse = TaskLedger & { capabilities?: { archiveSessions: boolean } }
 
 /**
  * Workspace listing for the UI pickers. `repoCount` (0.6.3): how many repos a
@@ -89,7 +89,10 @@ export type UpdateTaskBody = {
 }
 
 /** Move-task request body (ifVersion mandatory; the user MAY move to done). */
-export type MoveTaskBody = { ifVersion: number; status: string }
+export type MoveTaskBody = { ifVersion: number; status: string; archiveSessions?: boolean }
+
+export type SessionArchiveResult = { archived: string[]; failed: Array<{ sessionId: string; error: string }>; unsupported: string[] }
+export type MoveTaskResponse = TaskSummary & { sessionArchive?: SessionArchiveResult }
 
 /**
  * Quick-reject request body (card ✗ button): move back to todo plus an
@@ -270,4 +273,4 @@ export type ChangeEvent = {
   revision: number
   kind: 'task-created' | 'task-updated' | 'task-moved' | 'task-deleted' | 'comment-added' | 'execution-recorded' | 'settings-updated' | 'ledger-replaced'
   tasks: TaskSummary[]
-}
+}

package/src/shared/builtin-templates.ts

@@ -0,0 +1,153 @@
+/**
+ * Built-in task-template content (0.6.4): the four factory templates seeded
+ * into the template side file, in both shipped locales. The host seeds the zh
+ * copy as the persisted fallback (the side file is plain data); the client
+ * resolves the ACTIVE locale's copy at render / prefill time via
+ * {@link builtinTemplateContent}, so an English GUI shows English template
+ * text without ever re-seeding the side file.
+ *
+ * Kept in shared/ (not the client i18n dictionaries) because the content is
+ * structured task DATA — a checklist is an array and the prompt is multi-line
+ * — rather than UI-chrome strings, and because the host needs the same seed
+ * content to write the side file.
+ *
+ * @module dsh-taskboard/shared/builtin-templates
+ */
+import type { TaskTemplateSpec } from './api.ts'
+
+/** Shipped built-in template locales (mirrors the client i18n LocaleId). */
+export type BuiltinTemplateLocale = 'zh' | 'en'
+
+/** One built-in template's localized name + task spec. */
+export interface BuiltinTemplateContent {
+  name: string
+  task: TaskTemplateSpec
+}
+
+/** Stable ids of the factory templates (persisted in the side file). */
+export const BUILTIN_TEMPLATE_IDS = ['tpl-feature', 'tpl-bugfix', 'tpl-release', 'tpl-patrol'] as const
+
+export type BuiltinTemplateId = (typeof BUILTIN_TEMPLATE_IDS)[number]
+
+/** Built-in template content per locale (name + prefilled task spec). */
+export const BUILTIN_TEMPLATE_CONTENT: Readonly<Record<BuiltinTemplateLocale, Readonly<Record<BuiltinTemplateId, BuiltinTemplateContent>>>> = {
+  zh: {
+    'tpl-feature': {
+      name: '新增功能',
+      task: {
+        title: '新增：',
+        prompt: [
+          '实现以上新功能并按序交接：',
+          '1. 明确需求边界与验收标准，列出实现要点',
+          '2. 实现功能（含类型定义与错误处理）',
+          '3. 补充测试（单测/回归）',
+          '4. 运行相关测试套件确认通过',
+        ].join('\n'),
+        urgency: 'normal',
+        checklist: ['实现要点已明确（需求边界与验收标准）', '功能已实现并补充测试', '相关测试套件通过'],
+      },
+    },
+    'tpl-bugfix': {
+      name: 'Bug 修复',
+      task: {
+        title: '修复：',
+        prompt: [
+          '修复以上问题并按序交接：',
+          '1. 复现问题（写最小复现步骤或测试）',
+          '2. 定位根因，说明为什么会发生',
+          '3. 修复并补回归测试',
+          '4. 运行相关测试套件确认无回归',
+        ].join('\n'),
+        urgency: 'urgent',
+        checklist: ['已复现并定位根因', '修复已提交到任务分支', '回归测试通过'],
+      },
+    },
+    'tpl-release': {
+      name: '发布检查',
+      task: {
+        title: '发布：',
+        prompt: '执行发布流程：版本号更新、构建、测试、变更记录，完成后按序交接（不要实际推送/发布，等用户确认）。',
+        urgency: 'normal',
+        checklist: ['版本号已更新（package.json 与版本常量同步）', '构建通过', '全部测试通过', '变更记录已写'],
+      },
+    },
+    'tpl-patrol': {
+      name: '例行巡检',
+      task: {
+        title: '巡检：',
+        prompt: [
+          '例行巡检：检查依赖更新、失败测试、明显代码问题与未处理的告警。',
+          '发现的问题逐条列出（严重度/位置/建议），小问题直接修复，大问题只报告不动手。',
+          '输出巡检摘要（用 {{lastComments}} 可回看上次巡检结论）。',
+        ].join('\n'),
+        urgency: 'relaxed',
+        execution: { mode: 'scheduled', cron: '0 9 * * 1' },
+      },
+    },
+  },
+  en: {
+    'tpl-feature': {
+      name: 'New feature',
+      task: {
+        title: 'New feature:',
+        prompt: [
+          'Implement the new feature above and hand off in order:',
+          '1. Clarify the requirement boundaries and acceptance criteria; list the implementation points',
+          '2. Implement the feature (including type definitions and error handling)',
+          '3. Add tests (unit / regression)',
+          '4. Run the relevant test suites and confirm they pass',
+        ].join('\n'),
+        urgency: 'normal',
+        checklist: ['Implementation points clarified (requirement boundaries and acceptance criteria)', 'Feature implemented with tests added', 'Relevant test suites pass'],
+      },
+    },
+    'tpl-bugfix': {
+      name: 'Bug fix',
+      task: {
+        title: 'Fix:',
+        prompt: [
+          'Fix the issue above and hand off in order:',
+          '1. Reproduce the issue (write minimal reproduction steps or a test)',
+          '2. Locate the root cause and explain why it happens',
+          '3. Fix it and add regression tests',
+          '4. Run the relevant test suites and confirm there are no regressions',
+        ].join('\n'),
+        urgency: 'urgent',
+        checklist: ['Issue reproduced and root cause located', 'Fix committed to the task branch', 'Regression tests pass'],
+      },
+    },
+    'tpl-release': {
+      name: 'Release check',
+      task: {
+        title: 'Release:',
+        prompt: 'Run the release process: bump the version, build, test, and update the changelog, then hand off in order (do not actually push / publish — wait for user confirmation).',
+        urgency: 'normal',
+        checklist: ['Version bumped (package.json and version constants in sync)', 'Build passes', 'All tests pass', 'Changelog written'],
+      },
+    },
+    'tpl-patrol': {
+      name: 'Routine patrol',
+      task: {
+        title: 'Patrol:',
+        prompt: [
+          'Routine patrol: check dependency updates, failing tests, obvious code issues, and unhandled alerts.',
+          'List each finding (severity / location / suggestion); fix small issues directly, and only report (do not touch) large ones.',
+          'Output a patrol summary (use {{lastComments}} to review the last patrol\u2019s conclusions).',
+        ].join('\n'),
+        urgency: 'relaxed',
+        execution: { mode: 'scheduled', cron: '0 9 * * 1' },
+      },
+    },
+  },
+}
+
+/**
+ * Resolve one built-in template's localized content.
+ * @param id - the template id.
+ * @param locale - the requested locale.
+ * @returns the content, or undefined when `id` is not a built-in template id.
+ */
+export function builtinTemplateContent(id: string, locale: BuiltinTemplateLocale): BuiltinTemplateContent | undefined {
+  if (!(BUILTIN_TEMPLATE_IDS as readonly string[]).includes(id)) return undefined
+  return BUILTIN_TEMPLATE_CONTENT[locale][id as BuiltinTemplateId]
+}

package/src/shared/protocol.ts

@@ -335,6 +335,15 @@ export type Actor =
   | { kind: 'agent'; sessionId: string }
   | { kind: 'system' }
 
+/** Structured row of a multi-repo merge system comment (0.6.4). */
+export type SystemCommentRow = {
+  /** Repo path relative to the workspace ('' = the workspace root repo). */
+  repo: string
+  outcome: 'merged' | 'noop' | 'failed'
+  /** Failure reason (verbatim) when outcome = 'failed'. */
+  error?: string
+}
+
 /** A progress/report comment on a task. */
 export type CommentRecord = {
   id: string
@@ -345,6 +354,16 @@ export type CommentRecord = {
   createdAt: number
   /** The session that wrote this comment; absent for user-written ones. */
   threadId?: string
+  /**
+   * i18n key of a host-generated system message (0.6.4). The GUI localizes it
+   * at render time; `body` stays a zh fallback for agent tools / CSV / raw
+   * JSON views.
+   */
+  systemKey?: string
+  /** Flat {name} interpolation params for the system message. */
+  systemParams?: Record<string, string>
+  /** Structured per-repo rows for the multi-repo merge summary (0.6.4). */
+  systemRows?: SystemCommentRow[]
 }
 
 /** One commit produced by an isolated execution (hash + subject). */
@@ -756,6 +775,36 @@ export function syncClaim(task: TaskRecord, to: TaskStatus, now: number, holder?
   }
 }
 
+/**
+ * Collect unique execution session IDs associated with a task:
+ * - executions with a non-empty `sessionId`
+ * Creator and claim sessions may serve other tasks and are never included.
+ * @param task - the task record to inspect.
+ * @returns an array of distinct session IDs in stable discovery order.
+ */
+export function taskAssociatedSessionIds(task: TaskRecord): string[] {
+  const seen = new Set<string>()
+  const result: string[] = []
+  const push = (raw: unknown) => {
+    if (typeof raw === 'string') {
+      const trimmed = raw.trim()
+      if (trimmed.length > 0 && !seen.has(trimmed)) {
+        seen.add(trimmed)
+        result.push(trimmed)
+      }
+    }
+  }
+
+  if (Array.isArray(task.executions)) {
+    for (const ex of task.executions) {
+      if (ex !== null && typeof ex === 'object') {
+        push((ex as { sessionId?: unknown }).sessionId)
+      }
+    }
+  }
+  return result
+}
+
 /**
  * Validate and normalize a pinned model: `{ provider, model, reasoningEffort? }`,
  * provider and model must be non-empty trimmed strings.
@@ -1020,6 +1069,21 @@ export function validateImportedTask(raw: unknown, now: number): { ok: true; tas
           version: numOr(ce, 'version', 1),
           createdAt: numOr(ce, 'createdAt', now),
           ...(typeof ce.threadId === 'string' ? { threadId: ce.threadId } : {}),
+          ...(typeof ce.systemKey === 'string' && /^sys\.[A-Za-z0-9]+$/.test(ce.systemKey) && ce.systemKey.length <= 100
+            ? {
+                systemKey: ce.systemKey,
+                ...(typeof ce.systemParams === 'object' && ce.systemParams !== null && !Array.isArray(ce.systemParams)
+                  ? { systemParams: Object.fromEntries(Object.entries(ce.systemParams).filter(([key, value]) => key.length <= 100 && typeof value === 'string' && value.length <= 4000).slice(0, 20)) as Record<string, string> }
+                  : {}),
+                ...(Array.isArray(ce.systemRows)
+                  ? { systemRows: ce.systemRows.filter((row): row is SystemCommentRow => typeof row === 'object' && row !== null
+                      && typeof row.repo === 'string' && (row.repo === '' || isValidRelRepoPath(row.repo))
+                      && ['merged', 'noop', 'failed'].includes(row.outcome)
+                      && (row.error === undefined || typeof row.error === 'string'))
+                    .slice(0, MAX_MIRROR_REPOS).map(row => ({ repo: row.repo, outcome: row.outcome, ...(row.error !== undefined ? { error: row.error.slice(0, 4000) } : {}) })) }
+                  : {}),
+              }
+            : {}),
         })
       }
     } else return fail('comments must be an array')

package/src/shared/version.ts

@@ -1,9 +1,9 @@
-/**
- * The plugin package version shown in the board UI. Kept in sync with
- * package.json by a regression test (tests lock drift).
- *
- * @module dsh-taskboard/shared/version
- */
-
-/** The package version (must equal package.json "version"). */
-export const PLUGIN_VERSION = '0.6.5'
+/**
+ * The plugin package version shown in the board UI. Kept in sync with
+ * package.json by a regression test (tests lock drift).
+ *
+ * @module dsh-taskboard/shared/version
+ */
+
+/** The package version (must equal package.json "version"). */
+export const PLUGIN_VERSION = '0.6.7'