dsh-taskboard 0.7.1 → 0.7.4

package/package.json

@@ -1,92 +1,91 @@
-{
-  "name": "dsh-taskboard",
-  "description": "Agent-first task board for the DSH web GUI: host-authoritative task ledger with taskboard_* agent tools, project (= workspace) claim boundaries, per-task model execution in fresh sessions, optional per-task git-worktree isolation (dedicated task branches, commit evidence, one-click merge), host-side cron scheduling, and a live SSE kanban view. Mounts via the official dsh plugin system — no DSH source changes.",
-  "version": "0.7.1",
-  "type": "module",
-  "main": "lib/index.js",
-  "exports": {
-    ".": "./lib/index.js",
-    "./invariant": "./lib/invariant.js",
-    "./client": "./lib/client.js",
-    "./package.json": "./package.json"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [],
-      "platform": "web"
-    },
-    "compatibility": {
-      "dshReleases": {
-        "0.1.0-rc.8": "unknown",
-        "0.1.1-rc.1": "unknown",
-        "0.1.1-rc.2": "compatible",
-        "0.1.2-alpha.2": "compatible",
-        "0.1.2-alpha.3": "compatible",
-        "0.1.2-alpha.4": "compatible",
+{
+  "name": "dsh-taskboard",
+  "description": "Agent-first task board for the DSH web GUI: host-authoritative task ledger with taskboard_* agent tools, project (= workspace) claim boundaries, per-task model execution in fresh sessions, optional per-task git-worktree isolation (dedicated task branches, commit evidence, one-click merge), host-side cron scheduling, and a live SSE kanban view. Mounts via the official dsh plugin system — no DSH source changes.",
+  "version": "0.7.4",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./invariant": "./lib/invariant.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [],
+      "platform": "web"
+    },
+    "compatibility": {
+      "dshReleases": {
+        "0.1.0-rc.8": "unknown",
+        "0.1.1-rc.1": "unknown",
+        "0.1.1-rc.2": "compatible",
+        "0.1.2-alpha.2": "compatible",
+        "0.1.2-alpha.3": "compatible",
+        "0.1.2-alpha.4": "compatible",
         "0.1.2-alpha.5": "compatible",
         "0.1.2-rc.1": "compatible",
         "0.1.5-rc.1": "compatible"
-      }
-    }
-  },
-  "files": [
-    "lib/**/*.js",
-    "lib/**/*.js.map",
-    "src",
-    "cordis.patch.yml",
-    "LICENSE"
-  ],
-  "license": "Apache-2.0",
-  "engines": {
-    "node": ">=22"
-  },
-  "author": "cloader",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/cloader/dsh-taskboard.git"
-  },
-  "bugs": {
-    "url": "https://github.com/cloader/dsh-taskboard/issues"
-  },
-  "homepage": "https://github.com/cloader/dsh-taskboard#readme",
-  "keywords": [
-    "dsh",
-    "deepseek-harness",
-    "dsh-plugin",
-    "taskboard",
-    "kanban",
-    "agent"
-  ],
-  "scripts": {
-    "build": "node scripts/clean-lib.mjs && npm run build:host && npm run build:client",
-    "build:host": "tsdown -c tsdown.host.config.ts",
-    "build:client": "tsdown -c tsdown.client.config.ts && node scripts/wrap-client.mjs",
-    "watch": "tsdown -c tsdown.host.config.ts --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-home-paths": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-workspace": "^0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.2",
-    "@types/node": "^22.20.1",
-    "@types/react": "~18.3.1",
-    "@types/react-dom": "^18.3.7",
-    "jsdom": "^25.0.1",
-    "puppeteer-core": "^25.8.0",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "tsdown": "0.22.2",
-    "typescript": "~5.7.2",
-    "vitest": "^3.0.0"
-  }
-}
-
+      }
+    }
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.js.map",
+    "src",
+    "cordis.patch.yml",
+    "LICENSE"
+  ],
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22"
+  },
+  "author": "cloader",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cloader/dsh-taskboard.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cloader/dsh-taskboard/issues"
+  },
+  "homepage": "https://github.com/cloader/dsh-taskboard#readme",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "dsh-plugin",
+    "taskboard",
+    "kanban",
+    "agent"
+  ],
+  "scripts": {
+    "build": "node scripts/clean-lib.mjs && npm run build:host && npm run build:client",
+    "build:host": "tsdown -c tsdown.host.config.ts",
+    "build:client": "tsdown -c tsdown.client.config.ts && node scripts/wrap-client.mjs",
+    "watch": "tsdown -c tsdown.host.config.ts --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-home-paths": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-workspace": "^0.1.5-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "@types/node": "^22.20.1",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "^18.3.7",
+    "jsdom": "^25.0.1",
+    "puppeteer-core": "^25.8.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsdown": "0.22.2",
+    "typescript": "~5.7.2",
+    "vitest": "^3.0.0"
+  }
+}

package/src/client/board/TaskFormModal.tsx

@@ -178,8 +178,20 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
   const [prompt, setPrompt] = useState(task?.prompt ?? prefill?.prompt ?? '')
   const [workspaceId, setWorkspaceId] = useState(task?.workspaceId ?? state.filters.workspaceId ?? state.workspaces[0]?.id ?? '')
   const [urgency, setUrgency] = useState<Urgency>(task?.urgency ?? (prefill?.urgency === 'urgent' || prefill?.urgency === 'relaxed' ? prefill.urgency : 'normal'))
-  const [mode, setMode] = useState<'claim' | 'scheduled'>(task?.execution.mode === 'scheduled' || prefill?.execution?.mode === 'scheduled' ? 'scheduled' : 'claim')
+  const initExec = task?.execution ?? prefill?.execution
+  const [mode, setMode] = useState<'claim' | 'once' | 'periodic'>(
+    initExec?.mode === 'scheduled' ? (initExec.cron !== undefined ? 'periodic' : 'once') : 'claim',
+  )
   const [cron, setCron] = useState(task?.execution.cron ?? prefill?.execution?.cron ?? '0 9 * * *')
+  // One-shot trigger (定时执行): datetime-local string; '' = unset.
+  const initRunAt = initExec?.mode === 'scheduled' && initExec.runAt !== undefined ? initExec.runAt : undefined
+  const [runAt, setRunAt] = useState(() => {
+    if (initRunAt === undefined) return ''
+    const d = new Date(initRunAt)
+    if (Number.isNaN(d.getTime())) return ''
+    const pad = (n: number): string => String(n).padStart(2, '0')
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}`
+  })
   const [catalog, setCatalog] = useState<CatalogModel[]>([])
 
   // Model & reasoning effort selection:
@@ -245,10 +257,19 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
   }, [controller, editing, task?.presetId, initialPreset])
 
   // Live cron validation + next-run preview (same math as the host).
-  const cronMatch = mode === 'scheduled' ? parseCron(cron.trim()) : null
+  const cronMatch = mode === 'periodic' ? parseCron(cron.trim()) : null
   const nextRun = cronMatch !== null ? nextCronTime(cronMatch, Date.now()) : null
-  const cronBad = mode === 'scheduled' && (cronMatch === null || nextRun === null)
-  const valid = title.trim().length > 0 && workspaceId !== '' && !cronBad
+  const cronBad = mode === 'periodic' && (cronMatch === null || nextRun === null)
+  const runAtMs = mode === 'once' && runAt !== '' ? new Date(runAt).getTime() : NaN
+  const runAtBad = mode === 'once' && (runAt === '' || Number.isNaN(runAtMs) || runAtMs <= Date.now())
+  const valid = title.trim().length > 0 && workspaceId !== '' && !cronBad && !runAtBad
+
+  /** Execution payload for submit: claim | periodic (cron) | one-shot (runAt ISO). */
+  const executionPayload = (): { mode: 'claim' | 'scheduled'; cron?: string; runAt?: string } => {
+    if (mode === 'periodic') return { mode: 'scheduled', cron: cron.trim() }
+    if (mode === 'once') return { mode: 'scheduled', runAt: new Date(runAt).toISOString() }
+    return { mode: 'claim' }
+  }
 
   // A task already in progress cannot be run again (host rejects it).
   const runBlocked = editing && task.status === 'in_progress'
@@ -309,7 +330,7 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
         prompt,
         urgency,
         workspaceId,
-        execution: mode === 'scheduled' ? { mode, cron: cron.trim() } : { mode },
+        execution: executionPayload(),
         // '' in edit mode clears the pinned model back to the default.
         model: picked ?? null,
         ...(isolationOut !== undefined && !isolationLocked ? { isolation: isolationOut } : {}),
@@ -324,7 +345,7 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
         urgency,
         description: description.length > 0 ? description : undefined,
         prompt: prompt.length > 0 ? prompt : undefined,
-        execution: mode === 'scheduled' ? { mode, cron: cron.trim() } : { mode },
+        execution: executionPayload(),
         model: picked,
         ...(isolationOut !== undefined ? { isolation: isolationOut } : {}),
         ...(presetOut !== undefined ? { presetId: presetOut } : {}),
@@ -351,7 +372,7 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
           prompt,
           urgency,
           workspaceId,
-          execution: mode === 'scheduled' ? { mode, cron: cron.trim() } : { mode },
+          execution: executionPayload(),
           model: picked ?? null,
           ...(isolationOut !== undefined && !isolationLocked ? { isolation: isolationOut } : {}),
           presetId: presetOut ?? null,
@@ -366,7 +387,7 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
           urgency,
           description: description.length > 0 ? description : undefined,
           prompt: prompt.length > 0 ? prompt : undefined,
-          execution: mode === 'scheduled' ? { mode, cron: cron.trim() } : { mode },
+          execution: executionPayload(),
           model: picked,
           ...(isolationOut !== undefined ? { isolation: isolationOut } : {}),
           ...(presetOut !== undefined ? { presetId: presetOut } : {}),
@@ -379,9 +400,15 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
   }
 
   const hint = !valid
-    ? (title.trim().length === 0 ? t('form.hint.needTitle') : workspaceId === '' ? t('form.hint.needProject') : t('form.hint.cronBad'))
-    : mode === 'scheduled' && nextRun !== null
+    ? (title.trim().length === 0
+        ? t('form.hint.needTitle')
+        : workspaceId === ''
+          ? t('form.hint.needProject')
+          : runAtBad ? t('form.hint.runAtBad') : t('form.hint.cronBad'))
+    : mode === 'periodic' && nextRun !== null
       ? t('form.hint.nextRun', { time: fmtTime(nextRun) })
+      : mode === 'once' && !Number.isNaN(runAtMs)
+        ? t('form.hint.onceAt', { time: fmtTime(runAtMs) })
       : editing
         ? t('form.hint.saveVersion', { v: task.version, next: task.version + 1 })
         : t('form.hint.createClaim')
@@ -516,19 +543,35 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
             </Field>
 
             <Field label={t('form.field.mode')} full>
-              <div className="dsh-atb-mode-picker">
+              <div className="dsh-atb-mode-picker" data-exec="true">
                 <button type="button" className="dsh-atb-mode-opt" data-on={mode === 'claim'} onClick={() => setMode('claim')}>
                   <span className="dsh-atb-mode-name">{t('form.mode.claim')}</span>
                   <span className="dsh-atb-mode-hint">{t('form.mode.claimHint')}</span>
                 </button>
-                <button type="button" className="dsh-atb-mode-opt" data-on={mode === 'scheduled'} onClick={() => setMode('scheduled')}>
-                  <span className="dsh-atb-mode-name">{t('form.mode.scheduled')}</span>
-                  <span className="dsh-atb-mode-hint">{t('form.mode.scheduledHint')}</span>
+                <button type="button" className="dsh-atb-mode-opt" data-on={mode === 'once'} onClick={() => setMode('once')}>
+                  <span className="dsh-atb-mode-name">{t('form.mode.once')}</span>
+                  <span className="dsh-atb-mode-hint">{t('form.mode.onceHint')}</span>
+                </button>
+                <button type="button" className="dsh-atb-mode-opt" data-on={mode === 'periodic'} onClick={() => setMode('periodic')}>
+                  <span className="dsh-atb-mode-name">{t('form.mode.periodic')}</span>
+                  <span className="dsh-atb-mode-hint">{t('form.mode.periodicHint')}</span>
                 </button>
               </div>
             </Field>
 
-            {mode === 'scheduled' && (
+            {mode === 'once' && (
+              <Field label={t('form.field.runAt')} required full>
+                <input
+                  type="datetime-local"
+                  className={runAtBad ? 'dsh-atb-input-bad' : undefined}
+                  value={runAt}
+                  onChange={e => setRunAt(e.target.value)}
+                  spellCheck={false}
+                />
+              </Field>
+            )}
+
+            {mode === 'periodic' && (
               <Field label={t('form.field.cron')} required full>
                 <input
                   className={cronBad ? 'dsh-atb-input-bad' : undefined}
@@ -653,7 +696,7 @@ interface TaskRecordLike {
   prompt: string
   workspaceId: string
   urgency: Urgency
-  execution: { mode: 'claim' | 'scheduled'; cron?: string }
+  execution: { mode: 'claim' | 'scheduled'; cron?: string; runAt?: number }
   model?: { provider: string; model: string; reasoningEffort?: string }
   isolation?: IsolationMode
   presetId?: string

package/src/client/controller.ts

@@ -693,7 +693,9 @@ export class BoardController {
         prompt: task.prompt.length > 0 ? task.prompt : undefined,
         execution: task.execution.mode === 'scheduled' && task.execution.cron !== undefined
           ? { mode: 'scheduled', cron: task.execution.cron }
-          : { mode: 'claim' },
+          : task.execution.mode === 'scheduled' && task.execution.runAt !== undefined && task.execution.runAt > Date.now()
+            ? { mode: 'scheduled', runAt: new Date(task.execution.runAt).toISOString() }
+            : { mode: 'claim' },
         model: task.model,
         isolation: task.isolation,
         ...(task.presetId !== undefined ? { presetId: task.presetId } : {}),
@@ -766,7 +768,9 @@ export class BoardController {
         urgency: task.urgency,
         execution: task.execution.mode === 'scheduled' && task.execution.cron !== undefined
           ? { mode: 'scheduled', cron: task.execution.cron }
-          : { mode: 'claim' },
+          : task.execution.mode === 'scheduled' && task.execution.runAt !== undefined
+            ? { mode: 'scheduled', runAt: new Date(task.execution.runAt).toISOString() }
+            : { mode: 'claim' },
         model: task.model,
         isolation: task.isolation,
         ...(task.presetId !== undefined ? { presetId: task.presetId } : {}),

package/src/client/i18n/en.ts

@@ -280,6 +280,11 @@ export const en: TaskboardDict = {
   'form.field.mode': 'Execution mode',
   'form.mode.claim': '🤝 Claim-based',
   'form.mode.claimHint': 'Sessions in the project claim it',
+  'form.mode.once': '⏰ One-shot',
+  'form.mode.onceHint': 'Runs once at a set time',
+  'form.mode.periodic': '🔁 Periodic',
+  'form.mode.periodicHint': 'Repeats on a cron schedule',
+  'form.field.runAt': 'Trigger time',
   'form.mode.scheduled': '⏰ Scheduled',
   'form.mode.scheduledHint': 'Starts automatically on schedule',
   'form.field.cron': 'Cron expression',
@@ -314,7 +319,9 @@ export const en: TaskboardDict = {
   'form.hint.needTitle': 'Enter a title',
   'form.hint.needProject': 'Select a project',
   'form.hint.cronBad': 'Invalid cron expression (min hour day month weekday)',
+  'form.hint.runAtBad': 'Pick a future trigger time',
   'form.hint.nextRun': 'Next run {time}',
+  'form.hint.onceAt': 'Fires once at {time}',
   'form.hint.saveVersion': 'On save: v{v} → v{next}',
   'form.hint.createClaim': 'After creation, sessions in the project can claim and run it',
   'form.action.runBlockedTitle': 'The task is running; cannot start another',
@@ -488,6 +495,9 @@ export const en: TaskboardDict = {
   'sys.sessionError': '[System] Session execution error: {error}; the task was returned to todo.',
   'sys.sessionDone': '[System] The session finished; automatically moved to in review.',
   'sys.cronDead': '[System] The cron expression {cron} has no trigger time within 4 years; scheduling disabled — fix the cron and re-enable.',
+  'sys.periodicHandoff': '[System] Periodic run finished; the schedule now continues on the new todo card {nextTaskId}. Review this card, then accept.',
+  'sys.spawnedFrom': '[System] The previous periodic run finished (execution {executionId}); this card carries the schedule onward. See {sourceId} for the finished round.',
+  'sys.runAtMissed': '[System] The one-shot trigger time was missed (host was down); it will not re-fire. Run manually or reschedule.',
   'sys.mergeSingle': '[System] Branch {branch} merged into the main worktree (--no-ff).',
   'sys.mergeMulti': '[System] Branches merged per repo (--no-ff): {summary}',
 }

package/src/client/i18n/zh.ts

@@ -282,6 +282,11 @@ export const zh = {
   'form.field.mode': '执行方式',
   'form.mode.claim': '🤝 认领制',
   'form.mode.claimHint': '项目内会话认领',
+  'form.mode.once': '⏰ 定时执行',
+  'form.mode.onceHint': '指定时间只跑一次',
+  'form.mode.periodic': '🔁 定期执行',
+  'form.mode.periodicHint': '按 cron 到点重复开跑',
+  'form.field.runAt': '触发时间',
   'form.mode.scheduled': '⏰ 定时执行',
   'form.mode.scheduledHint': '到点自动开跑',
   'form.field.cron': 'Cron 表达式',
@@ -316,7 +321,9 @@ export const zh = {
   'form.hint.needTitle': '请填写标题',
   'form.hint.needProject': '请选择项目',
   'form.hint.cronBad': 'Cron 表达式无效（分 时 日 月 周）',
+  'form.hint.runAtBad': '请选择未来的触发时间',
   'form.hint.nextRun': '下次运行 {time}',
+  'form.hint.onceAt': '将于 {time} 触发一次',
   'form.hint.saveVersion': '保存后版本 v{v} → v{next}',
   'form.hint.createClaim': '创建后项目内会话可认领执行',
   'form.action.runBlockedTitle': '任务正在执行中，不能重复发起',
@@ -490,6 +497,9 @@ export const zh = {
   'sys.sessionError': '[系统] 会话执行异常：{error}；任务已退回待办。',
   'sys.sessionDone': '[系统] 会话执行完毕，已自动进入待验收。',
   'sys.cronDead': '[系统] 定时表达式 {cron} 在 4 年内没有可触发时间，已停用定时；请修正 cron 后重新开启。',
+  'sys.periodicHandoff': '[系统] 定期任务本轮执行完毕，定时已由新待办卡 {nextTaskId} 承接，请审查本卡后验收。',
+  'sys.spawnedFrom': '[系统] 定期任务上一轮执行完毕（执行 {executionId}），本卡承接定时继续下一轮；上一轮成果见 {sourceId} 的待验收。',
+  'sys.runAtMissed': '[系统] 定时执行错过触发时间（主机当时未运行），本次不再补跑；可手动执行或修改定时。',
   'sys.mergeSingle': '[系统] 分支 {branch} 已合并到主工作区（--no-ff）。',
   'sys.mergeMulti': '[系统] 分支已按仓库合并（--no-ff）：{summary}',
 } as const

package/src/client/styles.ts

@@ -609,6 +609,11 @@ button.dsh-atb-chip2.dsh-atb-chip-btn:hover {
 .dsh-atb-urgency-opt[data-on="true"][data-urgency="relaxed"] { border-color: rgba(62,99,221,.65); background: rgba(62,99,221,.1); }
 
 .dsh-atb-mode-picker { display: grid; grid-template-columns: 1fr 1fr; gap: 7px; }
+/* Execution mode has THREE options (认领 / 定时 / 定期): keep them on one row. */
+.dsh-atb-mode-picker[data-exec="true"] { grid-template-columns: repeat(3, 1fr); }
+.dsh-atb-mode-picker[data-exec="true"] .dsh-atb-mode-opt { padding: 7px 8px; }
+.dsh-atb-mode-picker[data-exec="true"] .dsh-atb-mode-name { font-size: 12px; }
+.dsh-atb-mode-picker[data-exec="true"] .dsh-atb-mode-hint { font-size: 10px; }
 .dsh-atb-mode-opt {
   display: flex; flex-direction: column; align-items: flex-start; gap: 3px;
   padding: 8px 10px; border-radius: 9px; cursor: pointer;