dsh-taskboard 0.4.5 → 0.5.1

package/src/client/board/TaskBoard.tsx

@@ -9,48 +9,16 @@ import type { BoardController, ControllerState } from '../controller.ts'
 import type { TaskRecord, TaskStatus, Urgency } from '../../shared/protocol.ts'
 import { MAIN_STATUSES, canTransition } from '../../shared/protocol.ts'
 import { PLUGIN_VERSION } from '../../shared/version.ts'
+import { COLUMN_LABELS, URGENCY_LABEL } from './labels.ts'
+import { fmtTime, isStaleClaim } from './format.ts'
 import { DRAG_TYPE, TaskCard } from './TaskCard.tsx'
 import { TaskDetail } from './TaskDetail.tsx'
 import { TaskFormModal } from './TaskFormModal.tsx'
+import { SettingsModal } from './SettingsModal.tsx'
 import { ImportModal } from './ImportModal.tsx'
 import { TemplateManager } from './TemplateManager.tsx'
 import { useAlert } from './AlertModal.tsx'
 
-/** Column labels. */
-const COLUMN_LABELS: Readonly<Record<TaskStatus, string>> = {
-  backlog: '待规划',
-  todo: '待办',
-  in_progress: '进行中',
-  in_review: '待验收',
-  done: '已完成',
-  canceled: '已取消',
-  archived: '已归档',
-}
-
-
-/** Urgency chip labels. */
-const URGENCY_LABELS: Readonly<Record<Urgency, string>> = {
-  urgent: '紧急',
-  normal: '一般',
-  relaxed: '不急',
-}
-
-/** Format an epoch ms as a short local stamp. */
-export function fmtTime(ms: number | undefined): string {
-  if (ms === undefined) return ''
-  const d = new Date(ms)
-  const pad = (n: number) => String(n).padStart(2, '0')
-  return `${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`
-}
-
-/** A claim idle for longer than this is highlighted as stale (ms). */
-export const STALE_CLAIM_MS = 30 * 60_000
-
-/** Whether the task's claim is stale (in_progress, held, idle too long). */
-export function isStaleClaim(task: TaskRecord, now: number): boolean {
-  return task.status === 'in_progress' && task.claimedAt !== undefined && now - task.claimedAt > STALE_CLAIM_MS
-}
-
 /** Urgency sort rank (urgent first). */
 const URGENCY_RANK: Record<Urgency, number> = { urgent: 0, normal: 1, relaxed: 2 }
 
@@ -90,6 +58,9 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
   // + 新建任务 ▼ dropdown (0.4.0): blank / templates / manage / import.
   const [newMenuOpen, setNewMenuOpen] = useState(false)
   const closeMenu = (): void => setNewMenuOpen(false)
+  // ⬇ 导出 ▼ dropdown (0.5.1): whole-ledger JSON backup or task-list CSV.
+  const [exportOpen, setExportOpen] = useState(false)
+  const closeExport = (): void => setExportOpen(false)
 
   return (
     <div className="dsh-atb-board">
@@ -122,7 +93,7 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
                     title={t.task.description !== undefined && t.task.description.length > 0 ? t.task.description.slice(0, 120) : t.name}
                     onClick={() => { closeMenu(); controller.newFromTemplate(t.task) }}
                   >
-                    {t.name}{t.builtin === true ? '' : ''}
+                    {t.name}
                   </button>
                 ))}
                 <div className="dsh-atb-newmenu-sep" />
@@ -168,16 +139,48 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
             onClick={() => controller.toggleUrgency(u)}
           >
             <span className="dsh-atb-dot" data-urgency={u} />
-            {URGENCY_LABELS[u]}
+            {URGENCY_LABEL[u]}
           </button>
         ))}
         <button type="button" className="dsh-atb-btn" onClick={() => controller.toggleSecondary()}>
           {state.secondaryOpen ? '返回看板' : '其它任务'}
         </button>
+        <button type="button" className="dsh-atb-btn" title="看板设置：新建任务的默认执行隔离等" onClick={() => controller.openSettings()}>🛠 设置</button>
         <button type="button" className="dsh-atb-btn" title="健康诊断：遗留 worktree、台账基本项" onClick={() => controller.openDiagnostics()}>⚙ 诊断</button>
         <button type="button" className="dsh-atb-btn" title="从 JSON 备份文件导入台账（预览后合并或整册替换）" onClick={() => controller.openImport()}>⬆ 导入</button>
-        <button type="button" className="dsh-atb-btn" title="下载完整台账备份（JSON）" onClick={() => controller.exportJson()}>⬇ JSON</button>
-        <button type="button" className="dsh-atb-btn" title="下载任务清单（CSV）" onClick={() => controller.exportCsv()}>⬇ CSV</button>
+        <div className="dsh-atb-newmenu">
+          <button
+            type="button"
+            className="dsh-atb-btn"
+            title="导出台账：完整 JSON 备份或任务清单 CSV"
+            onClick={() => setExportOpen(!exportOpen)}
+          >
+            ⬇ 导出 ▼
+          </button>
+          {exportOpen && (
+            <>
+              <div className="dsh-atb-newmenu-backdrop" onClick={closeExport} />
+              <div className="dsh-atb-newmenu-list">
+                <button
+                  type="button"
+                  className="dsh-atb-newmenu-opt"
+                  title="完整台账备份（含执行历史与看板设置），可用于导入恢复"
+                  onClick={() => { closeExport(); controller.exportJson() }}
+                >
+                  完整台账（JSON）
+                </button>
+                <button
+                  type="button"
+                  className="dsh-atb-newmenu-opt"
+                  title="任务清单表格（Excel 可直接打开，中文已加 BOM）"
+                  onClick={() => { closeExport(); controller.exportCsv() }}
+                >
+                  任务清单（CSV）
+                </button>
+              </div>
+            </>
+          )}
+        </div>
         <a
           className="dsh-atb-ver"
           href="https://github.com/cloader/dsh-taskboard"
@@ -248,7 +251,9 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
 
       {selected !== undefined && (
         <div className="dsh-atb-detailpanel">
-          <TaskDetail task={selected} controller={controller} now={now} />
+          {/* key: remount per task — without it, confirm states and comment
+              drafts leak across task switches (review P0). */}
+          <TaskDetail key={selected.id} task={selected} controller={controller} now={now} />
         </div>
       )}
 
@@ -261,6 +266,8 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
 
       {state.diagOpen && <DiagnosticsPanel controller={controller} />}
 
+      {state.settingsOpen && <SettingsModal controller={controller} />}
+
       {state.importOpen && <ImportModal controller={controller} />}
 
       {state.tplManagerOpen && <TemplateManager controller={controller} />}

package/src/client/board/TaskCard.tsx

@@ -14,10 +14,8 @@
 import { useState } from 'react'
 import type { BoardController } from '../controller.ts'
 import type { TaskRecord } from '../../shared/protocol.ts'
-import { fmtTime, isStaleClaim } from './TaskBoard.tsx'
-
-const URGENCY_LABEL: Record<TaskRecord['urgency'], string> = { urgent: '紧急', normal: '一般', relaxed: '不急' }
-const OUTCOME_LABEL: Record<string, string> = { running: '执行中', succeeded: '成功', failed: '失败', cancelled: '已取消' }
+import { fmtTime, isStaleClaim } from './format.ts'
+import { OUTCOME_LABEL, URGENCY_LABEL } from './labels.ts'
 
 /** dataTransfer type carrying the dragged task id. */
 export const DRAG_TYPE = 'application/x-dsh-atb-task'
@@ -57,7 +55,7 @@ export function TaskCard({ task, controller, draggable = false, now, onAlert }:
         // Block drag if a session is still executing this task
         if (running !== undefined) {
           e.preventDefault()
-          const msg = `该任务正在由【${task.title}】会话执行，不能拖动`
+          const msg = `该任务正由会话执行中（${task.title}），不能拖动`
           if (onAlert !== undefined) onAlert(msg)
           else alert(msg)
           return

package/src/client/board/TaskDetail.tsx

@@ -12,7 +12,8 @@ import type { BoardController } from '../controller.ts'
 import type { ExecutionRecord, TaskRecord } from '../../shared/protocol.ts'
 import { canTransition, checklistProgress } from '../../shared/protocol.ts'
 import { useAlert } from './AlertModal.tsx'
-import { fmtTime, isStaleClaim } from './TaskBoard.tsx'
+import { fmtTime, isStaleClaim } from './format.ts'
+import { MOVE_LABEL, OUTCOME_LABEL, STATUS_LABEL, URGENCY_LABEL } from './labels.ts'
 
 /** Statuses a user may move this task to, per the state machine. */
 function moveTargets(task: TaskRecord): TaskRecord['status'][] {
@@ -20,14 +21,6 @@ function moveTargets(task: TaskRecord): TaskRecord['status'][] {
   return all.filter(to => canTransition(task.status, to))
 }
 
-const MOVE_LABEL: Record<string, string> = {
-  backlog: '待规划', todo: '待办', in_progress: '进行中', in_review: '待验收',
-  done: '完成', canceled: '取消', archived: '归档',
-}
-const STATUS_LABEL: Record<string, string> = { ...MOVE_LABEL }
-const URGENCY_LABEL: Record<string, string> = { urgent: '紧急', normal: '一般', relaxed: '不急' }
-const OUTCOME_LABEL: Record<string, string> = { running: '执行中', succeeded: '成功', failed: '失败', cancelled: '已取消' }
-
 /** Compact session-id display (execution sessions carry the taskboard infix). */
 function shortId(id: string | undefined): string {
   if (id === undefined) return ''
@@ -374,6 +367,10 @@ export function TaskDetail({ task, controller, now }: { task: TaskRecord; contro
   const [confirmDone, setConfirmDone] = useState(false)
   const [confirmPurge, setConfirmPurge] = useState(false)
   const [confirmCancel, setConfirmCancel] = useState(false)
+  // Top action buttons (duplicate / save-as-template / run / reuse-run)
+  // share one in-flight guard: a double click used to fire duplicate runs or
+  // copies while the first round-trip was still pending (review P0).
+  const [actionBusy, setActionBusy] = useState(false)
   const { alert: showAlert, el: alertEl } = useAlert()
   const ws = controller.getSnapshot().workspaces.find(w => w.id === task.workspaceId)
   const canRun = task.status !== 'in_progress' && task.status !== 'done' && task.status !== 'archived'
@@ -382,6 +379,13 @@ export function TaskDetail({ task, controller, now }: { task: TaskRecord; contro
   const stale = now !== undefined && isStaleClaim(task, now)
   const unchecked = (task.checklist ?? []).filter(i => !i.checked).length
 
+  /** Fire one top action under the shared busy guard; re-enable on settle. */
+  const runAction = (action: () => Promise<unknown>): void => {
+    if (actionBusy) return
+    setActionBusy(true)
+    void action().catch(() => undefined).finally(() => setActionBusy(false))
+  }
+
   /** Jump to an execution's session; prompt precisely when it cannot open. */
   const jumpToSession = (sessionId: string): void => {
     void controller.openSession(sessionId).then(result => {
@@ -426,7 +430,7 @@ export function TaskDetail({ task, controller, now }: { task: TaskRecord; contro
             <Chip>v{task.version}</Chip>
           </div>
           <div className="dsh-atb-detail-sub">
-            更新 {fmtTime(task.updatedAt)} · 最近操作 {task.updatedBy.kind === 'agent' ? `🤖 ${shortId(task.updatedBy.sessionId)}` : '👤 用户'}
+            更新 {fmtTime(task.updatedAt)} · 最近操作 {task.updatedBy.kind === 'agent' ? `🤖 ${shortId(task.updatedBy.sessionId)}` : task.updatedBy.kind === 'system' ? '⚙️ 系统' : '👤 用户'}
           </div>
         </div>
         <div className="dsh-atb-detail-topbtns">
@@ -435,7 +439,8 @@ export function TaskDetail({ task, controller, now }: { task: TaskRecord; contro
             type="button"
             className="dsh-atb-detail-edit"
             title="复制此任务的全部配置为一张新卡（待办列）"
-            onClick={() => void controller.duplicate(task)}
+            disabled={actionBusy}
+            onClick={() => runAction(() => controller.duplicate(task))}
           >
             ⧉ 复制
           </button>
@@ -443,11 +448,11 @@ export function TaskDetail({ task, controller, now }: { task: TaskRecord; contro
             type="button"
             className="dsh-atb-detail-edit"
             title="把此任务的配置（含清单）保存为模板，新建任务时可用"
-            onClick={() => {
-              void controller.saveAsTemplate(task).then(ok => {
-                if (ok) showAlert('已存为模板（新建任务 ▼ 下拉可用，可在模板管理中改名）')
-              })
-            }}
+            disabled={actionBusy}
+            onClick={() => runAction(async () => {
+              const ok = await controller.saveAsTemplate(task)
+              if (ok) showAlert('已存为模板（新建任务 ▼ 下拉可用，可在模板管理中改名）')
+            })}
           >
             ⌗ 存为模板
           </button>
@@ -456,7 +461,8 @@ export function TaskDetail({ task, controller, now }: { task: TaskRecord; contro
               type="button"
               className="dsh-atb-detail-run"
               title="续跑：保留现有 worktree 与分支（上次的改动和提交都在原处），在其上继续执行；默认「立即执行」会重置为全新基线"
-              onClick={() => void controller.run(task.id, true)}
+              disabled={actionBusy}
+              onClick={() => runAction(() => controller.run(task.id, true))}
             >
               ↻ 续跑
             </button>
@@ -466,7 +472,8 @@ export function TaskDetail({ task, controller, now }: { task: TaskRecord; contro
               type="button"
               className="dsh-atb-detail-run"
               title={task.model !== undefined ? `新会话执行（${task.model.model}）` : '新会话执行（默认模型）'}
-              onClick={() => void controller.run(task.id)}
+              disabled={actionBusy}
+              onClick={() => runAction(() => controller.run(task.id))}
             >
               ▶ 立即执行
             </button>
@@ -578,8 +585,8 @@ export function TaskDetail({ task, controller, now }: { task: TaskRecord; contro
             onChange={e => setComment(e.target.value)}
             onKeyDown={e => {
               if ((e.ctrlKey || e.metaKey) && e.key === 'Enter' && comment.trim().length > 0) {
-                void controller.comment(task.id, comment)
-                setComment('')
+                // T13: keep the draft when the post fails (reject 表单同样保留).
+                void controller.comment(task.id, comment).then(ok => { if (ok) setComment('') })
               }
             }}
           />
@@ -587,7 +594,9 @@ export function TaskDetail({ task, controller, now }: { task: TaskRecord; contro
             type="button"
             className="dsh-atb-composer-send"
             disabled={comment.trim().length === 0}
-            onClick={() => { void controller.comment(task.id, comment); setComment('') }}
+            onClick={() => {
+              void controller.comment(task.id, comment).then(ok => { if (ok) setComment('') })
+            }}
           >
             发表
           </button>

package/src/client/board/TaskFormModal.tsx

@@ -10,11 +10,10 @@
  */
 import { useEffect, useRef, useState, type ReactNode } from 'react'
 import type { BoardController } from '../controller.ts'
-import { loadDefaultIsolation, saveDefaultIsolation } from '../controller.ts'
 import type { TaskTemplateSpec } from '../../shared/api.ts'
 import type { ChecklistItem, IsolationMode, Urgency } from '../../shared/protocol.ts'
-import { MAX_CHECKLIST_ITEMS, nextCronTime, parseCron } from '../../shared/protocol.ts'
-import { fmtTime } from './TaskBoard.tsx'
+import { MAX_CHECKLIST_ITEMS, defaultIsolationOf, nextCronTime, parseCron } from '../../shared/protocol.ts'
+import { fmtTime } from './format.ts'
 
 /** One row of the configured model catalog (from llm.models). */
 export interface CatalogModel { provider: string; model: string; name?: string }
@@ -134,10 +133,10 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
   const [presetId, setPresetId] = useState(initialPreset)
   const [presets, setPresets] = useState<Array<{ id: string; name?: string }>>([])
   const [presetDefault, setPresetDefault] = useState<string | undefined>(undefined)
-  // Isolation toggle: create mode starts from the remembered choice (default
-  // on) or the template's choice; edit mode starts from the task and locks
-  // once execution began.
-  const [isolation, setIsolation] = useState<IsolationMode>(task?.isolation ?? (prefill?.isolation === 'none' ? 'none' : prefill?.isolation === 'worktree' ? 'worktree' : loadDefaultIsolation()))
+  // Isolation toggle: create mode starts from the board setting (0.5.0
+  // 看板设置 → 默认执行隔离) or the template's choice; edit mode starts from
+  // the task and locks once execution began.
+  const [isolation, setIsolation] = useState<IsolationMode>(task?.isolation ?? (prefill?.isolation === 'none' ? 'none' : prefill?.isolation === 'worktree' ? 'worktree' : defaultIsolationOf(state.ledger.settings)))
   // Checklist (0.4.0): create = template texts / blank rows; edit = live items.
   const [checkRows, setCheckRows] = useState<CheckRow[]>(
     task?.checklist !== undefined && task.checklist.length > 0
@@ -145,6 +144,10 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
       : (prefill?.checklist ?? []).map(text => ({ text, checked: false })),
   )
   const titleRef = useRef<HTMLInputElement>(null)
+  // One in-flight write at a time: the foot buttons disable while a
+  // create/update/run round-trip is pending — a double click used to fire
+  // duplicate creates (and runs) before the first one returned (review P0).
+  const [busy, setBusy] = useState(false)
 
   // Focus the title and close on Esc while the dialog is open.
   useEffect(() => {
@@ -156,9 +159,9 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
     return () => document.removeEventListener('keydown', onKey)
   }, [controller])
 
-  // Model catalog: the plugin face provides it when the runtime is up.
+  // Model catalog: the controller exposes the installed face when the runtime is up.
   useEffect(() => {
-    const face = (controller as unknown as { modelCatalog?: () => Promise<CatalogModel[]> }).modelCatalog
+    const face = controller.modelCatalog
     if (face === undefined) return
     void face().then(setCatalog).catch(() => setCatalog([]))
   }, [controller])
@@ -167,14 +170,18 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
   // create mode (unless a template pinned one) so executions run with a
   // real tool set out of the box.
   useEffect(() => {
-    const face = (controller as unknown as { presetCatalog?: () => Promise<{ presets: Array<{ id: string; name?: string }>; defaultId?: string }> }).presetCatalog
+    const face = controller.presetCatalog
     if (face === undefined) return
     void face().then(roster => {
       setPresets(roster.presets)
       setPresetDefault(roster.defaultId)
-      if (task?.presetId === undefined && initialPreset === '' && roster.defaultId !== undefined) setPresetId(roster.defaultId)
+      // CREATE mode only (review P1): pre-selecting in edit mode would
+      // silently pin the deployment default onto tasks that deliberately
+      // follow it. In create mode `task` is undefined, so checking
+      // `initialPreset` (template pin) alone is sufficient.
+      if (!editing && initialPreset === '' && roster.defaultId !== undefined) setPresetId(roster.defaultId)
     }).catch(() => setPresets([]))
-  }, [controller, task?.presetId, initialPreset])
+  }, [controller, editing, task?.presetId, initialPreset])
 
   // Live cron validation + next-run preview (same math as the host).
   const cronMatch = mode === 'scheduled' ? parseCron(cron.trim()) : null
@@ -193,10 +200,12 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
   // default (runtime auto-degrades with a note) instead of persisting 'none'.
   const isolationDisabled = isolationLocked || !gitOk
 
-  /** Isolation payload for submit: undefined keeps the default (degrades naturally). */
+  /**
+   * Isolation payload for submit: undefined lets the HOST materialize the
+   * current board default at creation (non-git projects degrade naturally).
+   */
   const isolationPayload = (): string | undefined => {
     if (!gitOk) return undefined
-    if (!editing) saveDefaultIsolation(isolation)
     return isolation
   }
 
@@ -207,13 +216,14 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
   const filledRows = (): CheckRow[] => checkRows.map(r => ({ ...r, text: r.text.trim() })).filter(r => r.text.length > 0)
 
   const submit = (): void => {
-    if (!valid) return
+    if (!valid || busy) return
     const picked = model !== '' ? (JSON.parse(model) as { provider: string; model: string }) : undefined
     const isolationOut = isolationPayload()
     const presetOut = presetPayload()
     const rows = filledRows()
-    if (editing) {
-      void controller.update(task.id, task.version, {
+    setBusy(true)
+    const action = editing
+      ? controller.update(task.id, task.version, {
         title,
         description,
         prompt,
@@ -227,8 +237,7 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
         // [] clears the checklist (host deletes the field on empty).
         checklist: rows.length > 0 ? rows : null,
       })
-    } else {
-      void controller.create({
+      : controller.create({
         title,
         workspaceId,
         urgency,
@@ -240,18 +249,19 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
         ...(presetOut !== undefined ? { presetId: presetOut } : {}),
         ...(rows.length > 0 ? { checklist: rows.map(r => r.text) } : {}),
       })
-    }
+    void action.catch(() => undefined).finally(() => setBusy(false))
   }
 
   /** Save the form, then immediately trigger a manual run of the task. */
   const submitAndRun = (): void => {
-    if (!valid || runBlocked) return
+    if (!valid || runBlocked || busy) return
     const picked = model !== '' ? (JSON.parse(model) as { provider: string; model: string }) : undefined
     const isolationOut = isolationPayload()
     const presetOut = presetPayload()
     const rows = filledRows()
-    if (editing) {
-      void (async () => {
+    setBusy(true)
+    void (async () => {
+      if (editing) {
         const saved = await controller.update(task.id, task.version, {
           title,
           description,
@@ -265,9 +275,7 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
           checklist: rows.length > 0 ? rows : null,
         })
         if (saved) await controller.run(task.id)
-      })()
-    } else {
-      void (async () => {
+      } else {
         const id = await controller.create({
           title,
           workspaceId,
@@ -281,8 +289,8 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
           ...(rows.length > 0 ? { checklist: rows.map(r => r.text) } : {}),
         })
         if (id !== undefined) await controller.run(id)
-      })()
-    }
+      }
+    })().catch(() => undefined).finally(() => setBusy(false))
   }
 
   const hint = !valid
@@ -449,13 +457,13 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
             <button
               type="button"
               className="dsh-atb-btn"
-              disabled={!valid || runBlocked}
-              title={runBlocked ? '任务正在执行中，不能重复发起' : '保存后立即发起执行（新会话）'}
+              disabled={!valid || runBlocked || busy}
+              title={runBlocked ? '任务正在执行中，不能重复发起' : busy ? '正在提交…' : '保存后立即发起执行（新会话）'}
               onClick={submitAndRun}
             >
               ⚡ 立即执行
             </button>
-            <button type="button" className="dsh-atb-btn" data-primary="true" disabled={!valid} onClick={submit}>
+            <button type="button" className="dsh-atb-btn" data-primary="true" disabled={!valid || busy} onClick={submit}>
               {editing ? '保存修改' : '创建任务'}
             </button>
           </span>

package/src/client/board/format.ts

@@ -0,0 +1,26 @@
+/**
+ * Pure display helpers shared by the board components.
+ *
+ * Review P2: these lived in TaskBoard.tsx and were imported back out by
+ * TaskCard/TaskDetail/TaskFormModal, forming import cycles with the view
+ * root. They have no component dependencies — they belong here.
+ *
+ * @module dsh-taskboard/client/board/format
+ */
+import type { TaskRecord } from '../../shared/protocol.ts'
+
+/** Format an epoch ms as a short local stamp. */
+export function fmtTime(ms: number | undefined): string {
+  if (ms === undefined) return ''
+  const d = new Date(ms)
+  const pad = (n: number) => String(n).padStart(2, '0')
+  return `${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`
+}
+
+/** A claim idle for longer than this is highlighted as stale (ms). */
+export const STALE_CLAIM_MS = 30 * 60_000
+
+/** Whether the task's claim is stale (in_progress, held, idle too long). */
+export function isStaleClaim(task: TaskRecord, now: number): boolean {
+  return task.status === 'in_progress' && task.claimedAt !== undefined && now - task.claimedAt > STALE_CLAIM_MS
+}

package/src/client/board/labels.ts

@@ -0,0 +1,44 @@
+/**
+ * Centralized zh-CN display labels for the board UI.
+ *
+ * Review P2: the same status/urgency/outcome text used to live in three
+ * components (TaskBoard / TaskCard / TaskDetail) and drifted — adding a
+ * status meant three edits, missing one leaked the raw English key.
+ *
+ * @module dsh-taskboard/client/board/labels
+ */
+import type { TaskStatus, Urgency } from '../../shared/protocol.ts'
+
+/** Column headers on the five-column main board (+ secondary tab). */
+export const COLUMN_LABELS: Readonly<Record<TaskStatus, string>> = {
+  backlog: '待规划',
+  todo: '待办',
+  in_progress: '进行中',
+  in_review: '待验收',
+  done: '已完成',
+  canceled: '已取消',
+  archived: '已归档',
+}
+
+/** Status pill text (detail pane) — historical wording kept verbatim:
+ *  terminal states read short here, the column headers carry the full forms. */
+export const STATUS_LABEL: Readonly<Record<TaskStatus, string>> = {
+  backlog: '待规划', todo: '待办', in_progress: '进行中', in_review: '待验收',
+  done: '完成', canceled: '取消', archived: '归档',
+}
+
+/** Move-button verbs (shorter than the pill text). */
+export const MOVE_LABEL: Readonly<Record<TaskStatus, string>> = {
+  backlog: '待规划', todo: '待办', in_progress: '进行中', in_review: '待验收',
+  done: '完成', canceled: '取消', archived: '归档',
+}
+
+/** Urgency chip labels. */
+export const URGENCY_LABEL: Readonly<Record<Urgency, string>> = {
+  urgent: '紧急', normal: '一般', relaxed: '不急',
+}
+
+/** Execution outcome labels. */
+export const OUTCOME_LABEL: Readonly<Record<string, string>> = {
+  running: '执行中', succeeded: '成功', failed: '失败', cancelled: '已取消',
+}