@linxin666/dsh-client-ui-task-board 0.1.16 → 0.1.18

package/lib/index.js

@@ -5,7 +5,7 @@ import z from "schemastery";
 const SECTION_ORDER = 200;
 const inject = ["systemPrompt"];
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
-const TASK_BOARD_GUIDANCE = "本机已安装 dsh-task-board 插件（DSH Web GUI 的任务看板）：侧边栏「任务看板」入口；在 dsh-web-ui 插件全家桶仓库（packages/dsh-task-board）统一维护，经聚合包 web-ui-all 一键安装。能力：多列看板管理任务；任务可真实执行（驱动 agent 会话）；任务支持 5 段 cron 定时执行（如 0 23 * * *）；数据存浏览器 localStorage（键 dsh.taskBoard.v1）。限制：定时调度在浏览器端，需 GUI 标签页打开，错过即跳过；执行消耗 API 额度。用户提到「任务看板 / 看板 / 定时任务」时即指本插件，请据此协作。";
+const TASK_BOARD_GUIDANCE = "本机已安装 dsh-task-board 插件（DSH Web GUI 的任务看板）：侧边栏「任务看板」入口；在 dsh-web-ui 插件全家桶仓库（packages/dsh-task-board）统一维护，经聚合包 web-ui-all 一键安装。能力：多列看板管理任务；任务可真实执行（驱动 agent 会话）；任务可钉住执行目标——工作区 / 模式（agent 预设）/ 权限（read-only / workspace-write / danger-full-access），缺省用运行时默认；任务支持 5 段 cron 定时执行（如 0 23 * * *）；数据存浏览器 localStorage（键 dsh.taskBoard.v1）。限制：定时调度在浏览器端，需 GUI 标签页打开，错过即跳过；执行消耗 API 额度。用户提到「任务看板 / 看板 / 定时任务」时即指本插件，请据此协作。";
 /**
 * Settings namespace of the board's announcement capability — the section the
 * web settings surface edits. Spelled here rather than imported: the browser

package/lib/types/client/PluginSettingsCard.d.ts

@@ -28,6 +28,17 @@ export interface PluginSettingsCardProps<TKey extends string = string> {
     onSave: () => void;
     /** Drop every staged edit. */
     onDiscard: () => void;
+    /**
+     * Render the controls expanded on arrival (still collapsible). Defaults to
+     * true: promoted first-level sections show their settings immediately.
+     */
+    defaultOpen?: boolean;
+    /**
+     * Render without the collapse affordance: a static header and an always
+     * visible body. Used by first-level settings sections whose nav entry
+     * already provides the selection.
+     */
+    alwaysOpen?: boolean;
     /** The plugin's controls. */
     children: ReactNode;
 }

package/lib/types/client/locales.d.ts

@@ -13,6 +13,10 @@ export declare const zh: {
     'board.search': string;
     'board.empty': string;
     'board.filterAll': string;
+    'board.archive': string;
+    'board.archiveView': string;
+    'board.backToBoard': string;
+    'archive.empty': string;
     'board.status': string;
     'board.status.backlog': string;
     'board.status.todo': string;
@@ -40,6 +44,9 @@ export declare const zh: {
     'detail.run': string;
     'detail.rerun': string;
     'detail.delete': string;
+    'detail.archive': string;
+    'detail.restore': string;
+    'detail.archivedAt': string;
     'detail.viewSession': string;
     'detail.noSession': string;
     'detail.executionStarted': string;
@@ -72,6 +79,20 @@ export declare const zh: {
     'detail.schedule.notScheduled': string;
     'detail.schedule.dueSoon': string;
     'card.scheduled': string;
+    'new.workspace': string;
+    'new.mode': string;
+    'new.permission': string;
+    'exec.workspace.recent': string;
+    'exec.mode.default': string;
+    'exec.mode.defaultSuffix': string;
+    'exec.mode.brokenSuffix': string;
+    'exec.mode.removed': string;
+    'exec.permission.default': string;
+    'exec.permission.read-only': string;
+    'exec.permission.workspace-write': string;
+    'exec.permission.danger-full-access': string;
+    'detail.executionSettings': string;
+    'exec.hint': string;
     'settings.title': string;
     'settings.description': string;
     'settings.enabled': string;

package/lib/types/client/schedule-presets.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared scheduled-run presets for the schedule editors (the new-task dialog
+ * and the task detail panel): cron expression → locale label.
+ */
+import type { TaskBoardKey } from './locales.ts';
+/** Common scheduled-run presets (cron → locale label). */
+export declare const SCHEDULE_PRESETS: ReadonlyArray<{
+    cron: string;
+    label: TaskBoardKey;
+}>;

package/lib/types/core/controller.d.ts

@@ -16,6 +16,7 @@
 import { ExecutionService } from './execution.ts';
 import type { TaskStore } from './store.ts';
 import { type NewTaskInput, type TaskRecord, type TaskStatus } from './tasks.ts';
+import { type TaskUpdatePatch } from './use-cases/task-update.ts';
 /** The sessions face the controller needs for navigation awareness. */
 export interface SessionsControllerFace {
     list: {
@@ -39,11 +40,35 @@ export interface ControllerDeps {
     /** Debounce (ms) for session-list-changed reconciles; defaults to 350. */
     reconcileDebounceMs?: number;
 }
+/** One workspace option the execution-target pickers offer. */
+export interface ExecutionWorkspaceOption {
+    workspaceId: string;
+    /** Display label (workspace title; the wiring falls back to the path). */
+    title: string;
+}
+/** One agent-preset option the execution-target pickers offer. */
+export interface ExecutionPresetOption {
+    id: string;
+    name?: string;
+    description?: string;
+    /** Why this preset cannot compose a session; the pickers disable it. */
+    broken?: string;
+    isDefault: boolean;
+}
+/** The execution-target option sets the UI feeds into the controller. */
+export interface ExecutionOptionsSnapshot {
+    workspaces: readonly ExecutionWorkspaceOption[];
+    presets: readonly ExecutionPresetOption[];
+}
 /** Immutable controller snapshot for UI subscriptions. */
 export interface ControllerSnapshot {
     tasks: readonly TaskRecord[];
     boardOpen: boolean;
+    /** True when the board shows the archive view instead of the columns. */
+    archiveView: boolean;
     selectedTaskId: string | undefined;
+    /** Picker option sets (workspace list + agent-preset roster). */
+    executionOptions: ExecutionOptionsSnapshot;
 }
 /** The selected task (resolved from the ledger), or undefined. */
 export declare function selectedTaskOf(snapshot: ControllerSnapshot): TaskRecord | undefined;
@@ -55,7 +80,9 @@ export declare class BoardController {
     private readonly deps;
     private tasks;
     private boardOpen;
+    private archiveView;
     private selectedTaskId;
+    private executionOptions;
     private listeners;
     private disposers;
     private readonly now;
@@ -71,12 +98,32 @@ export declare class BoardController {
     openBoard(): void;
     closeBoard(): void;
     toggleBoard(): void;
+    /**
+     * Switch between the kanban columns and the archive view. Leaving the
+     * archive view with an archived task still selected closes the selection —
+     * the detail overlay must not linger over a task that is off-board.
+     */
+    toggleArchiveView(): void;
     openTask(id: string): void;
     closeTask(): void;
     createTask(input: NewTaskInput): TaskRecord | undefined;
-    updateTask(id: string, patch: Partial<Pick<TaskRecord, 'title' | 'description' | 'prompt'>>): void;
+    updateTask(id: string, patch: TaskUpdatePatch): void;
+    /**
+     * Replace (a part of) the picker option sets the UI feeds (workspace list
+     * and agent-preset roster come from the runtime, not the ledger).
+     */
+    setExecutionOptions(patch: Partial<ExecutionOptionsSnapshot>): void;
     moveTask(id: string, status: TaskStatus): void;
     deleteTask(id: string): void;
+    /**
+     * Archive a settled task (done/failed). Running or on-board-unsettled
+     * tasks are refused so the runner keeps exclusive ownership of their
+     * lifecycle.
+     * @returns true when applied.
+     */
+    archiveTask(id: string): boolean;
+    /** Restore an archived task back onto the board (same status column). */
+    restoreTask(id: string): boolean;
     /**
      * Update a task's schedule rule. A blank or invalid cron expression is
      * rejected (returns false, state untouched). When the rule ends up enabled
@@ -96,6 +143,15 @@ export declare class BoardController {
      * schedule rule (it was deleted mid-tick, for example).
      */
     applyScheduleNextRun(id: string, nextRunAt: number | undefined, lastTriggeredAt: number | undefined): void;
+    /**
+     * Reload the ledger from the persisted store without notifying subscribers.
+     * The scheduler calls this before every tick so a task deleted in another
+     * tab (or a stale in-memory copy) can never be fired from this tab: the
+     * fire decision and the subsequent roll-forward both run on the freshest
+     * persisted truth. Deliberately silent — same-origin external changes still
+     * reach subscribers through the storage-event subscription.
+     */
+    reloadFromStore(): void;
     /**
      * Jump to an execution's session transcript. Selecting the session changes
      * `current`, which closes the board (the conversation view takes over).

package/lib/types/core/execution.d.ts

@@ -14,22 +14,40 @@
  * so tests drive it with plain fakes.
  */
 import type { ExecutionRecord, TaskRecord } from './tasks.ts';
+/** One list-row summary the execution service reads (the narrow slice of a SessionSummary). */
+export interface ExecutionSessionSummary {
+    running: boolean;
+    completed?: boolean;
+    /** Empty-log bit: the preset can only be recomposed while the session is blank. */
+    blank?: boolean;
+    /** The preset the session currently runs (absent on deployments without presets). */
+    agentPreset?: string;
+}
 /** The narrow sessions face the service needs. */
 export interface SessionsExecutionFace {
     list: {
         getSnapshot(): {
             /** Baseline arrival lifecycle — 'pending' until the host list has loaded. */
             phase: 'pending' | 'ready';
-            byId: Record<string, {
-                running: boolean;
-                completed?: boolean;
-            }>;
+            byId: Record<string, ExecutionSessionSummary>;
         };
         subscribe(fn: () => void): () => void;
     };
     binding(id: string): {
         session: SessionDriver;
     } | undefined;
+    /** Record a host-confirmed preset switch so the list label moves immediately. */
+    noteAgentPreset?(sessionId: string, agentPreset: string): void;
+}
+/** The narrow agent-preset wire face the service needs (`agentPreset.select`). */
+export interface PresetsExecutionFace {
+    /** Recompose a blank session's agent from a preset. */
+    select(sessionId: string, agentPreset: string): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: unknown;
+    }>;
 }
 /** The narrow workspaces face the service needs. */
 export interface WorkspacesExecutionFace {
@@ -63,6 +81,18 @@ export interface SessionDriver {
         ok: false;
         error: unknown;
     }>;
+    /**
+     * Admit one slash-command line against the session's agent (the
+     * `/permission <id>` mechanism). `matched` reports whether a command
+     * claimed the line.
+     */
+    command(line: string): Promise<{
+        ok: true;
+        matched: boolean;
+    } | {
+        ok: false;
+        error: unknown;
+    }>;
     getSnapshot(): {
         running: boolean;
         lastAgentError: string | null;
@@ -74,6 +104,8 @@ export interface SessionDriver {
 export interface ExecutionEnvironment {
     sessions: SessionsExecutionFace;
     workspaces: WorkspacesExecutionFace;
+    /** Agent-preset wire face; absent on deployments without preset support. */
+    presets?: PresetsExecutionFace;
     /** Raw-history reader for failure detection of never-opened sessions. */
     history?: HistoryExecutionFace;
 }
@@ -101,9 +133,38 @@ export type ExecutionEvent = {
  */
 export declare class ExecutionService {
     private readonly env;
+    /**
+     * In-flight preset switches keyed by `sessionId\u0000mode`. The session
+     * list mirror can lag behind a just-applied switch, so concurrent runs
+     * against one blank session would otherwise each issue the same select
+     * RPC (an amplified storm); sharing one in-flight call keeps the wire to
+     * a single request. The settled entry is forgotten so a later run can
+     * switch again.
+     */
+    private readonly presetSwitches;
     /** @param env - the runtime faces (real or fake). */
     constructor(env: ExecutionEnvironment);
     run(task: TaskRecord, execution: ExecutionRecord, onEvent: (event: ExecutionEvent) => void): Promise<void>;
+    /**
+     * Recompose the execution session's agent from the task-pinned preset.
+     * No-op when the task pins none or the session already runs it; fails the
+     * run when the session is no longer blank, the preset face is missing, or
+     * the wire refuses.
+     */
+    private applyMode;
+    /**
+     * One in-flight `select` per (session, preset): concurrent runs against
+     * the same blank session share the same wire call instead of each issuing
+     * a duplicate RPC. The entry is removed once the call settles, so a later
+     * run (after a shared failure, say) issues a fresh switch.
+     */
+    private switchPreset;
+    /**
+     * Apply the task-pinned permission preset through the `/permission <id>`
+     * slash command. No-op when the task pins none; fails the run when the
+     * admission is rejected or no command claimed the line.
+     */
+    private applyPermission;
     /**
      * Inspect a reloaded/background task that was left 'running' and emit a
      * settled event when its session already finished.

package/lib/types/core/scheduler.d.ts

@@ -3,6 +3,13 @@ import type { TaskRecord } from './tasks.ts';
 export interface SchedulerDeps {
     /** Read the current task ledger (the controller snapshot). */
     tasks(): readonly TaskRecord[];
+    /**
+     * Re-sync the task ledger from its persisted source before the tick decides
+     * what is due. The wiring passes the controller's store reload so a task
+     * deleted elsewhere can never be fired from a stale in-memory copy.
+     * Optional: absent in pure in-memory harnesses.
+     */
+    refresh?: () => void;
     /** Clock; defaults to Date.now in the controller wiring. */
     now(): number;
     /** Trigger one task's real execution (the controller's runTask); resolves

package/lib/types/core/store.d.ts

@@ -1,4 +1,4 @@
-import type { TaskRecord } from './tasks.ts';
+import { type TaskRecord } from './tasks.ts';
 /** Persistence seam for the task ledger. */
 export interface TaskStore {
     /** Read the persisted ledger (empty when nothing is stored yet). */

package/lib/types/core/tasks.d.ts

@@ -60,12 +60,55 @@ export interface TaskRecord {
     executions: ExecutionRecord[];
     /** Optional scheduled-run rule (absent on tasks without a schedule). */
     schedule?: ScheduleRule;
+    /**
+     * Workspace the execution must run in (a workspace-list id); absent means
+     * the recent-workspace fallback at execution time.
+     */
+    workspaceId?: string;
+    /**
+     * Agent preset the execution session must be composed from (an
+     * `agentPreset.list` id); absent means the deployment default.
+     */
+    mode?: string;
+    /**
+     * Permission preset applied to the execution session through the
+     * `/permission <id>` slash command; absent leaves the session default.
+     */
+    permission?: TaskPermission;
+    /**
+     * When the task was archived (ms epoch). Archived tasks keep their status
+     * and execution history but leave the main board; absent means on-board.
+     */
+    archivedAt?: number;
 }
+/** Statuses a settled task may be archived from. */
+export declare const ARCHIVABLE_STATUSES: readonly TaskStatus[];
+/** Permission presets a task may pin on its execution session (the `/permission <id>` ids). */
+export declare const TASK_PERMISSIONS: readonly ["read-only", "workspace-write", "danger-full-access"];
+/** One permission preset id. */
+export type TaskPermission = typeof TASK_PERMISSIONS[number];
+/** Whether an unknown value is a known permission preset id. */
+export declare function isTaskPermission(value: unknown): value is TaskPermission;
 /** Input for creating a task. */
 export interface NewTaskInput {
     title: string;
     description: string;
     prompt: string;
+    /** Workspace the execution must run in; empty/absent = the recent workspace. */
+    workspaceId?: string;
+    /** Agent preset the execution session must be composed from; empty/absent = deployment default. */
+    mode?: string;
+    /** Permission preset applied to the execution session; absent = session default. */
+    permission?: TaskPermission;
+    /**
+     * Optional scheduled-run rule requested at creation time (the new-task
+     * dialog): an enable flag plus a 5-field cron expression. The create use
+     * case arms it only when enabled and the expression is valid.
+     */
+    schedule?: {
+        enabled: boolean;
+        cron: string;
+    };
 }
 /** The five kanban columns, in display order. */
 export declare const COLUMNS: readonly {

package/lib/types/core/use-cases/task-archive.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Archive/restore task use case: move a settled (done/failed) task off the
+ * main board and back. Purely a marker transition — the task keeps its
+ * status, execution history and transcript references, so archiving never
+ * loses traceability and restoring lands it in the exact column it left.
+ */
+import type { TaskRecord } from '../tasks.ts';
+/** Result of an archive transition. */
+export interface ArchiveTaskResult {
+    /** The next ledger. */
+    tasks: readonly TaskRecord[];
+    /** Whether the archive was applied (false = unknown task / not archivable). */
+    archived: boolean;
+}
+/**
+ * Archive one task: only settled statuses (done/failed) can be archived;
+ * a running or not-yet-settled task stays on the board (its runner still
+ * owns its lifecycle). Already-archived tasks are a no-op.
+ */
+export declare function applyArchiveTask(tasks: readonly TaskRecord[], id: string, now: number): ArchiveTaskResult;
+/** Restore one task back onto the main board (clears the archive marker). */
+export declare function applyRestoreTask(tasks: readonly TaskRecord[], id: string, now: number): ArchiveTaskResult;

package/lib/types/core/use-cases/task-create.d.ts

@@ -1,8 +1,3 @@
-/**
- * Create-task use case: mint a new task from user input, rejecting a blank
- * title. Pure ledger transition (no persistence or notify — the controller
- * orchestrates those), so it is unit-testable without any runtime face.
- */
 import { type NewTaskInput, type TaskRecord } from '../tasks.ts';
 /** Result of a create transition: the new task (when accepted) + the next ledger. */
 export interface CreateTaskResult {
@@ -15,7 +10,7 @@ export interface CreateTaskResult {
  * Apply a create against the current ledger. Returns the new task and the
  * appended ledger, or the unchanged ledger when the title is blank.
  * @param tasks - current ledger.
- * @param input - raw user input (title/description/prompt).
+ * @param input - raw user input (title/description/prompt + optional schedule).
  * @param now - clock instant (ms epoch).
  * @param id - minted task id.
  */

package/lib/types/core/use-cases/task-update.d.ts

@@ -1,11 +1,16 @@
 /**
  * Update-task use case: apply an editable-field patch (title/description/
- * prompt) with a fresh updatedAt. Pure ledger transition (no persistence or
- * notify — the controller orchestrates those).
+ * prompt plus the execution targets workspaceId/mode/permission) with a
+ * fresh updatedAt. Pure ledger transition (no persistence or notify — the
+ * controller orchestrates those).
+ *
+ * An explicit `undefined` in the patch clears the field (the task falls
+ * back to the runtime default); an unknown permission string is ignored so
+ * stale UI can never persist a value the execution service rejects.
  */
-import type { TaskRecord } from '../tasks.ts';
+import { type TaskRecord } from '../tasks.ts';
 /** Editable fields on a task (the update patch surface). */
-export type TaskUpdatePatch = Partial<Pick<TaskRecord, 'title' | 'description' | 'prompt'>>;
+export type TaskUpdatePatch = Partial<Pick<TaskRecord, 'title' | 'description' | 'prompt' | 'workspaceId' | 'mode' | 'permission'>>;
 /**
  * Apply an update across the ledger. Tasks that do not match the id are left
  * untouched; the matched task receives the patch plus a fresh updatedAt.

package/lib/types/index.d.ts

@@ -14,7 +14,7 @@ import type { Context } from '@deepseek-ai/cordis';
 import z from 'schemastery';
 export declare const inject: string[];
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
-export declare const TASK_BOARD_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-task-board \u63D2\u4EF6\uFF08DSH Web GUI \u7684\u4EFB\u52A1\u770B\u677F\uFF09\uFF1A\u4FA7\u8FB9\u680F\u300C\u4EFB\u52A1\u770B\u677F\u300D\u5165\u53E3\uFF1B\u5728 dsh-web-ui \u63D2\u4EF6\u5168\u5BB6\u6876\u4ED3\u5E93\uFF08packages/dsh-task-board\uFF09\u7EDF\u4E00\u7EF4\u62A4\uFF0C\u7ECF\u805A\u5408\u5305 web-ui-all \u4E00\u952E\u5B89\u88C5\u3002\u80FD\u529B\uFF1A\u591A\u5217\u770B\u677F\u7BA1\u7406\u4EFB\u52A1\uFF1B\u4EFB\u52A1\u53EF\u771F\u5B9E\u6267\u884C\uFF08\u9A71\u52A8 agent \u4F1A\u8BDD\uFF09\uFF1B\u4EFB\u52A1\u652F\u6301 5 \u6BB5 cron \u5B9A\u65F6\u6267\u884C\uFF08\u5982 0 23 * * *\uFF09\uFF1B\u6570\u636E\u5B58\u6D4F\u89C8\u5668 localStorage\uFF08\u952E dsh.taskBoard.v1\uFF09\u3002\u9650\u5236\uFF1A\u5B9A\u65F6\u8C03\u5EA6\u5728\u6D4F\u89C8\u5668\u7AEF\uFF0C\u9700 GUI \u6807\u7B7E\u9875\u6253\u5F00\uFF0C\u9519\u8FC7\u5373\u8DF3\u8FC7\uFF1B\u6267\u884C\u6D88\u8017 API \u989D\u5EA6\u3002\u7528\u6237\u63D0\u5230\u300C\u4EFB\u52A1\u770B\u677F / \u770B\u677F / \u5B9A\u65F6\u4EFB\u52A1\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\uFF0C\u8BF7\u636E\u6B64\u534F\u4F5C\u3002";
+export declare const TASK_BOARD_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-task-board \u63D2\u4EF6\uFF08DSH Web GUI \u7684\u4EFB\u52A1\u770B\u677F\uFF09\uFF1A\u4FA7\u8FB9\u680F\u300C\u4EFB\u52A1\u770B\u677F\u300D\u5165\u53E3\uFF1B\u5728 dsh-web-ui \u63D2\u4EF6\u5168\u5BB6\u6876\u4ED3\u5E93\uFF08packages/dsh-task-board\uFF09\u7EDF\u4E00\u7EF4\u62A4\uFF0C\u7ECF\u805A\u5408\u5305 web-ui-all \u4E00\u952E\u5B89\u88C5\u3002\u80FD\u529B\uFF1A\u591A\u5217\u770B\u677F\u7BA1\u7406\u4EFB\u52A1\uFF1B\u4EFB\u52A1\u53EF\u771F\u5B9E\u6267\u884C\uFF08\u9A71\u52A8 agent \u4F1A\u8BDD\uFF09\uFF1B\u4EFB\u52A1\u53EF\u9489\u4F4F\u6267\u884C\u76EE\u6807\u2014\u2014\u5DE5\u4F5C\u533A / \u6A21\u5F0F\uFF08agent \u9884\u8BBE\uFF09/ \u6743\u9650\uFF08read-only / workspace-write / danger-full-access\uFF09\uFF0C\u7F3A\u7701\u7528\u8FD0\u884C\u65F6\u9ED8\u8BA4\uFF1B\u4EFB\u52A1\u652F\u6301 5 \u6BB5 cron \u5B9A\u65F6\u6267\u884C\uFF08\u5982 0 23 * * *\uFF09\uFF1B\u6570\u636E\u5B58\u6D4F\u89C8\u5668 localStorage\uFF08\u952E dsh.taskBoard.v1\uFF09\u3002\u9650\u5236\uFF1A\u5B9A\u65F6\u8C03\u5EA6\u5728\u6D4F\u89C8\u5668\u7AEF\uFF0C\u9700 GUI \u6807\u7B7E\u9875\u6253\u5F00\uFF0C\u9519\u8FC7\u5373\u8DF3\u8FC7\uFF1B\u6267\u884C\u6D88\u8017 API \u989D\u5EA6\u3002\u7528\u6237\u63D0\u5230\u300C\u4EFB\u52A1\u770B\u677F / \u770B\u677F / \u5B9A\u65F6\u4EFB\u52A1\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\uFF0C\u8BF7\u636E\u6B64\u534F\u4F5C\u3002";
 /**
  * Settings namespace of the board's announcement capability — the section the
  * web settings surface edits. Spelled here rather than imported: the browser

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linxin666/dsh-client-ui-task-board",
   "description": "Task board for the dsh web GUI: a sidebar entry plus a multi-column kanban view with local persistence, task details, and real execution through dsh sessions (session.prompt). Hot-pluggable — mounted via ~/.dsh/cordis.patch.yml + a profile node_modules symlink, no dsh source changes.",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",

package/src/client/PluginSettingsCard.tsx

@@ -45,6 +45,17 @@ export interface PluginSettingsCardProps<TKey extends string = string> {
   onSave: () => void
   /** Drop every staged edit. */
   onDiscard: () => void
+  /**
+   * Render the controls expanded on arrival (still collapsible). Defaults to
+   * true: promoted first-level sections show their settings immediately.
+   */
+  defaultOpen?: boolean
+  /**
+   * Render without the collapse affordance: a static header and an always
+   * visible body. Used by first-level settings sections whose nav entry
+   * already provides the selection.
+   */
+  alwaysOpen?: boolean
   /** The plugin's controls. */
   children: ReactNode
 }
@@ -55,57 +66,27 @@ export interface PluginSettingsCardProps<TKey extends string = string> {
  * @returns the card, or nothing while the namespace is still loading.
  */
 export function PluginSettingsCard<TKey extends string = string>(props: PluginSettingsCardProps<TKey>) {
-  const [open, setOpen] = useState(false)
-  const { state } = props
+  const [open, setOpen] = useState(props.defaultOpen ?? true)
+  const { state, alwaysOpen } = props
   if (!state.available) return null
   const title = props.t(props.titleKey)
   const description = props.t(props.descriptionKey)
   const blocked = !state.dirty || state.invalid || state.saving
-  const cardClass = open ? `${css.cardOpen} ${css.card}` : css.card
-  // The namespace exists but the Host does not serve it to this client (the
-  // official settings allowlist omits third-party namespaces): show a card
-  // that explains the gap instead of vanishing, so a missing card never
-  // reads as a missing plugin.
-  if (!state.exposed) {
-    return (
-      <li className={cardClass}>
-        <button
-          type="button"
-          className={css.header}
-          aria-expanded={open}
-          aria-label={`${props.t(open ? 'settings.collapse' : 'settings.expand')}: ${title}`}
-          onClick={() => { setOpen(!open) }}
-        >
-          <span className={css.headText}>
-            <span className={css.name} title={title}>{title}</span>
-            <span className={css.description} title={description}>{description}</span>
-          </span>
-          <svg
-            width="14"
-            height="14"
-            viewBox="0 0 14 14"
-            fill="none"
-            xmlns="http://www.w3.org/2000/svg"
-            className={open ? `${css.chevron} ${css.chevronOpen}` : css.chevron}
-          >
-            <path
-              d="M11.8486 5.5L11.4238 5.92383L8.69727 8.65137C8.44157 8.90706 8.21562 9.13382 8.01172 9.29785C7.79912 9.46883 7.55595 9.61756 7.25 9.66602C7.08435 9.69222 6.91565 9.69222 6.75 9.66602C6.44405 9.61756 6.20088 9.46883 5.98828 9.29785C5.78438 9.13382 5.55843 8.90706 5.30273 8.65137L2.57617 5.92383L2.15137 5.5L3 4.65137L3.42383 5.07617L6.15137 7.80273C6.42595 8.07732 6.59876 8.24849 6.74023 8.3623C6.87291 8.46904 6.92272 8.47813 6.9375 8.48047C6.97895 8.48703 7.02105 8.48703 7.0625 8.48047C7.07728 8.47813 7.12709 8.46904 7.25977 8.3623C7.40124 8.24849 7.57405 8.07732 7.84863 7.80273L10.5762 5.07617L11 4.65137L11.8486 5.5Z"
-              fill="currentColor"
-            />
-          </svg>
-        </button>
-        {open
-          ? (
-            <div className={css.body}>
-              <p className={css.notExposed} role="status">{props.t('settings.notExposed')}</p>
-            </div>
-          )
-          : null}
-      </li>
+  const expanded = alwaysOpen === true || open
+  const cardClass = expanded ? `${css.cardOpen} ${css.card}` : css.card
+  // With alwaysOpen the nav entry already provides the selection, so the
+  // header is a static title row instead of a disclosure button.
+  const header = alwaysOpen === true
+    ? (
+      <div className={css.headerStatic}>
+        <span className={css.headText}>
+          <span className={css.name} title={title}>{title}</span>
+          <span className={css.description} title={description}>{description}</span>
+        </span>
+        {state.dirty ? <span className={css.pending} title={props.t('settings.unsaved')}>{props.t('settings.unsaved')}</span> : null}
+      </div>
     )
-  }
-  return (
-    <li className={cardClass}>
+    : (
       <button
         type="button"
         className={css.header}
@@ -132,7 +113,29 @@ export function PluginSettingsCard<TKey extends string = string>(props: PluginSe
           />
         </svg>
       </button>
-      {open
+    )
+  // The namespace exists but the Host does not serve it to this client (the
+  // official settings allowlist omits third-party namespaces): show a card
+  // that explains the gap instead of vanishing, so a missing card never
+  // reads as a missing plugin.
+  if (!state.exposed) {
+    return (
+      <li className={cardClass}>
+        {header}
+        {expanded
+          ? (
+            <div className={css.body}>
+              <p className={css.notExposed} role="status">{props.t('settings.notExposed')}</p>
+            </div>
+          )
+          : null}
+      </li>
+    )
+  }
+  return (
+    <li className={cardClass}>
+      {header}
+      {expanded
         ? (
           <div className={css.body}>
             {!state.writable ? <p className={css.readOnly} role="status">{props.t('settings.readOnly')}</p> : null}