dsh-taskboard 0.6.6 → 0.6.7

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
@@ -162,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. */
@@ -178,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]) }
+      : {}),
   }
 }
 
@@ -411,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 读取。` }]
       },
@@ -501,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}]。` }]
       },
@@ -554,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)
@@ -575,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') {
@@ -607,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)
@@ -929,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.6'
+/**
+ * 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'