dsh-taskboard 0.4.4 → 0.5.0

package/src/client/styles.ts

@@ -689,6 +689,10 @@ html[data-dsh-atb-active] .dsh-atb-view { display: flex; flex-direction: column;
 .dsh-atb-imp-row-status { font-size: 10.5px; color: var(--dsw-alias-label-tertiary, gray); flex-shrink: 0; }
 .dsh-atb-imp-result { font-size: 12px; color: var(--dsw-alias-state-success-primary, #30a46c); margin-top: 10px; }
 .dsh-atb-badge[data-kind="checklist"] { color: var(--dsw-alias-label-secondary, inherit); }
+/* ---------- 0.5.0 board settings ---------- */
+.dsh-atb-set { max-width: 460px; width: min(460px, 92vw); }
+.dsh-atb-set .dsh-atb-mode-picker { margin-top: 8px; }
+.dsh-atb-set .dsh-atb-isolation-note { margin-top: 10px; }
 `
 
 /** Style element id (stable since 0.1.x: hook for tests and debugging). */

package/src/host/routes.ts

@@ -16,11 +16,13 @@ import type { Context } from '@deepseek-ai/cordis'
 // Type-only: pulls the webServer Context merge (ctx.webServer).
 import type {} from '@deepseek-ai/dsh-host-webserver'
 import {
+  asBoardSettings,
   asIsolation,
   asStatus,
   asUrgency,
   canTransition,
   checklistFromTexts,
+  defaultIsolationOf,
   newCommentId,
   newTaskId,
   normalizeBody,
@@ -355,6 +357,13 @@ export function registerTaskboardRoutes(ctx: Context, options: TaskboardRoutesOp
           return
         }
 
+        // Board settings (0.5.0): absent fields follow factory defaults.
+        if (pathname === `${ROUTE_PREFIX}/settings`) {
+          await store.load()
+          json(res, { ok: true, value: store.snapshot().settings ?? {} })
+          return
+        }
+
         const taskMatch = pathname.match(new RegExp(`^${ROUTE_PREFIX}/tasks/([^/]+)$`))
         if (taskMatch !== null) {
           const task = store.get(taskMatch[1]!)
@@ -397,7 +406,10 @@ export function registerTaskboardRoutes(ctx: Context, options: TaskboardRoutesOp
           const execution = normalizeExecution((body.execution as { mode?: string; cron?: string } | undefined) ?? {}, options.now())
           const model = body.model === undefined ? undefined : checkModel(body.model, options.modelProviders)
           const isolationRaw = str(body, 'isolation')
-          const isolation = isolationRaw === null ? undefined : asIsolation(isolationRaw)
+          // 0.5.0: an omitted isolation is MATERIALIZED from the board
+          // setting (看板设置) at creation, so later setting changes never
+          // rewrite existing tasks.
+          const isolation = isolationRaw === null ? defaultIsolationOf(store.snapshot().settings) : asIsolation(isolationRaw)
           const presetId = normalizePresetId(str(body, 'presetId'))
           let checklist: TaskRecord['checklist'] = undefined
           if (body.checklist !== undefined) {
@@ -419,7 +431,7 @@ export function registerTaskboardRoutes(ctx: Context, options: TaskboardRoutesOp
             blocked: false,
             execution,
             model,
-            ...(isolation !== undefined ? { isolation } : {}),
+            isolation,
             ...(presetId !== undefined ? { presetId } : {}),
             ...(checklist !== undefined ? { checklist } : {}),
             version: 1,
@@ -818,6 +830,10 @@ export function registerTaskboardRoutes(ctx: Context, options: TaskboardRoutesOp
             if (mode === 'replace') {
               replacedTotal = ledger.tasks.length
               ledger.tasks = structuredClone(imported)
+              // Replace is a whole-ledger swap (0.5.0): board settings ride
+              // along when the file carries them; merge keeps the live ones.
+              if (plan.settings !== undefined) ledger.settings = structuredClone(plan.settings)
+              else delete ledger.settings
               return ledger.tasks
             }
             const byId = new Map(ledger.tasks.map(t => [t.id, t]))
@@ -872,6 +888,24 @@ export function registerTaskboardRoutes(ctx: Context, options: TaskboardRoutesOp
         return
       }
 
+      // ------------------------------------------ POST /settings/update
+      // (0.5.0) Whole-object replace semantics: omitted fields fall back to
+      // their factory defaults. Affects only tasks created AFTER the change.
+      if (pathname === `${ROUTE_PREFIX}/settings/update`) {
+        try {
+          const next = asBoardSettings(body)
+          await store.mutate('settings-updated', ledger => {
+            ledger.settings = next
+            return []
+          })
+          json(res, { ok: true, value: next })
+        } catch (error) {
+          const f = toFail(error)
+          json(res, f.res, f.status)
+        }
+        return
+      }
+
       res.writeHead(404)
       res.end()
     } catch (error) {

package/src/host/store.ts

@@ -23,7 +23,7 @@ export interface LedgerChange {
   /** The mutated tasks, if any (a comment purge may touch none). */
   tasks: readonly TaskRecord[]
   /** What kind of mutation this was (for SSE event naming later). */
-  kind: 'task-created' | 'task-updated' | 'task-moved' | 'task-deleted' | 'comment-added' | 'execution-recorded'
+  kind: 'task-created' | 'task-updated' | 'task-moved' | 'task-deleted' | 'comment-added' | 'execution-recorded' | 'settings-updated'
 }
 
 /** Options for {@link TaskStore}. */

package/src/host/tools.ts

@@ -29,6 +29,7 @@ import {
   asUrgency,
   canTransition,
   checklistFromTexts,
+  defaultIsolationOf,
   effectivePrompt,
   isClaim,
   isClaimedBy,
@@ -373,7 +374,7 @@ export function registerTaskboardTools(ctx: ToolContextFace, deps: ToolDeps): Ar
       },
       isolation: {
         type: 'string',
-        description: 'Code isolation for executions: "worktree" (default — each run gets a fresh git worktree on branch task/<标题>+<taskId>) or "none" (run in the project directory, zero git interaction).',
+        description: 'Code isolation for executions: "worktree" (each run gets a fresh git worktree on branch task/<标题>+<taskId>) or "none" (run in the project directory, zero git interaction). Omitted → the board default (看板设置 → 默认执行隔离; factory default "none").',
       },
       presetId: {
         type: 'string',
@@ -419,7 +420,10 @@ export function registerTaskboardTools(ctx: ToolContextFace, deps: ToolDeps): Ar
         }
         const execution = normalizeExecution(args.execution ?? {}, deps.now())
         const model = args.model !== undefined ? checkModel(deps, args.model) : undefined
-        const isolation = args.isolation === undefined ? undefined : asIsolation(args.isolation)
+        // 0.5.0: an omitted isolation is MATERIALIZED from the board setting
+        // (看板设置) at creation, so later setting changes never rewrite
+        // existing tasks.
+        const isolation = args.isolation === undefined ? defaultIsolationOf(store.snapshot().settings) : asIsolation(args.isolation)
         const presetId = args.presetId?.trim() || undefined
         const checklist = args.checklist !== undefined ? checklistFromTexts(args.checklist) : undefined
         const now = deps.now()
@@ -434,7 +438,7 @@ export function registerTaskboardTools(ctx: ToolContextFace, deps: ToolDeps): Ar
           blocked: false,
           execution,
           model,
-          ...(isolation !== undefined ? { isolation } : {}),
+          isolation,
           ...(presetId !== undefined ? { presetId } : {}),
           ...(checklist !== undefined ? { checklist } : {}),
           version: 1,

package/src/shared/api.ts

@@ -5,7 +5,7 @@
  *
  * @module dsh-taskboard/shared/api
  */
-import type { TaskLedger, TaskRecord, TaskSummary } from './protocol.ts'
+import type { BoardSettings, TaskLedger, TaskRecord, TaskSummary } from './protocol.ts'
 
 export type { TaskRecord }
 
@@ -151,6 +151,15 @@ export type TaskTemplate = {
 /** Templates listing response. */
 export type TemplatesResponse = { templates: TaskTemplate[] }
 
+/** Board-settings response (0.5.0; absent fields follow factory defaults). */
+export type SettingsResponse = BoardSettings
+
+/** Update-board-settings request body (0.5.0; whole-object replace semantics). */
+export type UpdateSettingsBody = {
+  /** Default code isolation for NEW tasks ('worktree' | 'none'). */
+  defaultIsolation?: string
+}
+
 /** Import dry-run response (0.4.0): every task classified, nothing written. */
 export type ImportPreviewResponse = {
   plan: {

package/src/shared/protocol.ts

@@ -107,11 +107,20 @@ export const URGENCY_COLOR: Readonly<Record<Urgency, string>> = {
  * - `worktree`: each execution runs in a fresh `git worktree` on a dedicated
  *   task branch (`task/<标题>+<taskId>`) under `<workspace>/.dsh-worktrees/`.
  * - `none`: run in the workspace directory as before, zero git interaction.
- * Omitted = the default `worktree`; non-git projects auto-degrade at run
- * time (the execution record carries an `isolationNote` explaining why).
+ * Omitted = {@link DEFAULT_ISOLATION}; since 0.5.0 creation materializes the
+ * board default onto the record (看板设置 → 执行隔离), and non-git projects
+ * still auto-degrade at run time (the execution record carries an
+ * `isolationNote` explaining why).
  */
 export type IsolationMode = 'worktree' | 'none'
 
+/**
+ * Factory-default isolation (0.5.0): 原目录执行. Applies when neither the
+ * task record nor the board setting (`BoardSettings.defaultIsolation`)
+ * says otherwise. Before 0.5.0 the implicit default was 'worktree'.
+ */
+export const DEFAULT_ISOLATION: IsolationMode = 'none'
+
 /** Validate an isolation value. */
 export function asIsolation(raw: string): IsolationMode {
   if (raw !== 'worktree' && raw !== 'none') {
@@ -120,9 +129,39 @@ export function asIsolation(raw: string): IsolationMode {
   return raw
 }
 
-/** Resolve a task's effective isolation (omitted → the worktree default). */
+/** Resolve a task's effective isolation (omitted → the factory default). */
 export function effectiveIsolation(task: Pick<TaskRecord, 'isolation'>): IsolationMode {
-  return task.isolation === undefined ? 'worktree' : task.isolation
+  return task.isolation === undefined ? DEFAULT_ISOLATION : task.isolation
+}
+
+/**
+ * Board-level settings persisted with the ledger (0.5.0). Only fields the
+ * user explicitly set are present; absent fields follow factory defaults.
+ */
+export type BoardSettings = {
+  /** Default code isolation applied when a NEW task is created without an explicit choice. */
+  defaultIsolation?: IsolationMode
+}
+
+/** Validate raw input into sanitized {@link BoardSettings} (unknown fields dropped). */
+export function asBoardSettings(raw: unknown): BoardSettings {
+  if (typeof raw !== 'object' || raw === null) {
+    throw new Error('board settings must be an object')
+  }
+  const e = raw as Record<string, unknown>
+  const out: BoardSettings = {}
+  if (e.defaultIsolation !== undefined) {
+    if (typeof e.defaultIsolation !== 'string') {
+      throw new Error("defaultIsolation must be 'worktree' or 'none'")
+    }
+    out.defaultIsolation = asIsolation(e.defaultIsolation)
+  }
+  return out
+}
+
+/** The effective default isolation for NEW tasks (board setting → factory default). */
+export function defaultIsolationOf(settings?: BoardSettings): IsolationMode {
+  return settings?.defaultIsolation ?? DEFAULT_ISOLATION
 }
 
 /** How a task may run. */
@@ -419,6 +458,8 @@ export type TaskLedger = {
   /** Global monotonic revision; every mutation bumps it. */
   revision: number
   tasks: TaskRecord[]
+  /** Board-level settings (0.5.0); absent on ledgers never touched by 设置. */
+  settings?: BoardSettings
 }
 
 /** Current ledger format version. */
@@ -740,6 +781,8 @@ export type ImportPlan = {
   overwrite: TaskRecord[]
   /** Invalid entries with a human-readable reason (never imported). */
   invalid: Array<{ id?: string; reason: string }>
+  /** The file's board settings (0.5.0); replace-mode swaps them, merge keeps the live ones. */
+  settings?: BoardSettings
 }
 
 /** One unknown-value read helper: string fields with defaults. */
@@ -882,7 +925,7 @@ export function validateLedgerImport(raw: unknown, knownIds: ReadonlySet<string>
     throw new Error(`不支持的 schemaVersion ${String(e.schemaVersion)}（当前支持 ${LEDGER_SCHEMA_VERSION}）`)
   }
   if (!Array.isArray(e.tasks)) throw new Error('导入文件的 tasks 不是数组')
-  const plan: ImportPlan = { create: [], overwrite: [], invalid: [] }
+  const plan: ImportPlan = { create: [], overwrite: [], invalid: [], ...(e.settings !== undefined ? { settings: asBoardSettings(e.settings) } : {}) }
   const seen = new Set<string>()
   for (const entry of e.tasks) {
     const id = typeof (entry as { id?: unknown })?.id === 'string' ? (entry as { id: string }).id : undefined

package/src/shared/version.ts

@@ -6,4 +6,4 @@
  */
 
 /** The package version (must equal package.json "version"). */
-export const PLUGIN_VERSION = '0.4.4'
+export const PLUGIN_VERSION = '0.5.0'