@william2000/dsh-nova-ui-task-board 0.1.0

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

@@ -0,0 +1,17 @@
+import type { SettingsScope } from '@deepseek-ai/dsh-client-runtime/client';
+/** The task-board fields this card edits (the namespace's full schema). */
+export interface NovaTaskBoardSettings {
+    /** Master switch for the plugin. */
+    enabled?: boolean;
+    /** Whether the board announces itself in every agent's system prompt. */
+    announceToAgent?: boolean;
+    /** Prevent host idle sleep while sessions run or schedules are armed. */
+    preventIdleSleep?: boolean;
+}
+/**
+ * The settings card component, bound to the `nova-task-board` scope.
+ * @param props - the bound scope for the card's namespace.
+ */
+export declare function NovaTaskBoardSettingsCard(props: {
+    scope: SettingsScope<NovaTaskBoardSettings>;
+}): JSX.Element | null;

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

@@ -0,0 +1,9 @@
+/**
+ * T001 占位看板视图：脚手架阶段只渲染标题与占位说明；业务看板 UI
+ * （五列、卡片、详情、新建、归档等）由 T004 实现。
+ */
+import type { PlaceholderBoardController } from './board-controller.ts';
+/** Placeholder board body for the scaffold milestone. */
+export declare function PlaceholderBoard(_props: {
+    controller: PlaceholderBoardController;
+}): JSX.Element;

package/lib/types/client/apply-guard.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Cross-module-instance apply guard for the nova task-board client bundle.
+ *
+ * The client factory can run more than once in a single page lifetime (for
+ * example when a stale bundle is mixed with a rebuilt one while `dsh web` is
+ * restarted). Without a guard, every factory run mounts its own sidebar entry
+ * and board view, so the shell ends up showing two "task board" rows.
+ *
+ * The flag lives on globalThis so separate module instances (independent
+ * factory runs) still share one guard. First claim wins; later claims become
+ * no-ops until the claim is released (fiber unload / hot-reload) or the page
+ * reloads.
+ */
+declare global {
+    var __dshNovaTaskBoardApplied: boolean | undefined;
+}
+/** Claims the plugin apply slot. Returns true when this call won the slot. */
+export declare function claimNovaTaskBoardApply(): boolean;
+/**
+ * Releases the claim. Called from the client fiber cleanup so that a
+ * hot-reloaded bundle (the loader unloads the old plugin fiber and invokes
+ * the rebuilt one in the same page) can claim again instead of being
+ * silently dropped.
+ */
+export declare function releaseNovaTaskBoardApply(): void;

package/lib/types/client/board/ConfirmDialog.d.ts

@@ -0,0 +1,12 @@
+/** Confirm overlay props. */
+export interface ConfirmDialogProps {
+    title: string;
+    message: string;
+    confirmLabel: string;
+    /** Render the confirm button in the danger style. */
+    danger?: boolean;
+    onCancel: () => void;
+    onConfirm: () => void;
+}
+/** Small confirm overlay. */
+export declare function ConfirmDialog({ title, message, confirmLabel, danger, onCancel, onConfirm }: ConfirmDialogProps): import("react").JSX.Element;

package/lib/types/client/board/ConfirmTaskDialog.d.ts

@@ -0,0 +1,8 @@
+import type { TaskRecord } from '../../core/model.ts';
+import type { BoardController } from '../board-controller.ts';
+/** 确认对话框浮层。 */
+export declare function ConfirmTaskDialog({ controller, task, onClose }: {
+    controller: BoardController;
+    task: TaskRecord;
+    onClose: () => void;
+}): import("react").JSX.Element;

package/lib/types/client/board/ConvertTaskModal.d.ts

@@ -0,0 +1,17 @@
+import type { BoardController } from '../board-controller.ts';
+/** 转任务表单的预填内容（由 chat-integration 从消息提取）。 */
+export interface ConvertTaskPrefill {
+    title: string;
+    description: string;
+    prompt: string;
+    /** 来源会话 id（propose 时写入 metadata，可跳回对话）。 */
+    sourceConversationId?: string;
+    /** 来源消息 id（propose 时写入 metadata）。 */
+    sourceMessageId?: string;
+}
+/** 转为任务表单浮层。 */
+export declare function ConvertTaskModal({ controller, prefill, onClose }: {
+    controller: BoardController;
+    prefill: ConvertTaskPrefill;
+    onClose: () => void;
+}): import("react").JSX.Element;

package/lib/types/client/board/NewTaskModal.d.ts

@@ -0,0 +1,6 @@
+import type { BoardController } from '../board-controller.ts';
+/** 新建任务表单浮层。 */
+export declare function NewTaskModal({ controller, onClose }: {
+    controller: BoardController;
+    onClose: () => void;
+}): import("react").JSX.Element;

package/lib/types/client/board/RequirementSplitModal.d.ts

@@ -0,0 +1,14 @@
+import type { BoardController } from '../board-controller.ts';
+/** 递归拆分的预填（从任务详情发起；§12.9「对任一任务可再次发起拆分」）。 */
+export interface RequirementSplitPrefill {
+    /** 需求标题（父任务「需求：<标题>」）。 */
+    title?: string;
+    /** 递归拆分：新父需求任务挂到该任务下。 */
+    parentTaskId?: string;
+}
+/** 需求拆分对话框浮层。 */
+export declare function RequirementSplitModal({ controller, prefill, onClose }: {
+    controller: BoardController;
+    prefill?: RequirementSplitPrefill;
+    onClose: () => void;
+}): import("react").JSX.Element;

package/lib/types/client/board/SplitConfirmDialog.d.ts

@@ -0,0 +1,9 @@
+import type { TaskRecord } from '../../core/model.ts';
+import type { BoardController } from '../board-controller.ts';
+/** 批量确认对话框浮层。 */
+export declare function SplitConfirmDialog({ controller, tasks, onClose }: {
+    controller: BoardController;
+    /** 待确认列中的候选任务（含父需求任务；快照传入，行编辑不影响账本）。 */
+    tasks: readonly TaskRecord[];
+    onClose: () => void;
+}): import("react").JSX.Element;

package/lib/types/client/board/TagEditor.d.ts

@@ -0,0 +1,6 @@
+export declare function TagEditor({ tags, suggestions, disabled, onChange }: {
+    tags: readonly string[];
+    suggestions: readonly string[];
+    disabled: boolean;
+    onChange: (tags: string[]) => void;
+}): import("react").JSX.Element;

package/lib/types/client/board/TaskBoard.d.ts

@@ -0,0 +1,9 @@
+import { type BoardController } from '../board-controller.ts';
+/**
+ * 看板组件；订阅控制器快照渲染。拖拽状态（drag/hover/pending/dragError）为
+ * 组件内会话级状态：drag = 拖拽来源、hover = 当前落点（指示条）、pending =
+ * 提交在途的本地占位渲染（Host 确认后清除）、dragError = 非法落点提示。
+ */
+export declare function TaskBoard({ controller }: {
+    controller: BoardController;
+}): import("react").JSX.Element;

package/lib/types/client/board/TaskCard.d.ts

@@ -0,0 +1,52 @@
+import type { DragEvent } from 'react';
+import type { ExecutionRecord, ScheduleRule, TaskRecord, TaskSource } from '../../core/model.ts';
+import { type NovaTaskBoardKey } from '../locales.ts';
+/** 任务来源 → 文案键；无专用文案返回 undefined（卡片不渲染来源标记）。 */
+export declare function sourceKey(source: TaskSource): NovaTaskBoardKey | undefined;
+/** 绝对时间标签（Host 时区）。 */
+export declare function formatHostTimestamp(ms: number, timeZone?: string): string;
+/** 相对时间（<1m 刚刚；<1h 分钟；<24h 小时；更早回退到 Host 时区日期）。 */
+export declare function formatTime(ms: number, timeZone?: string): string;
+/** 执行结果标签（详情/卡片共用）。 */
+export declare function executionLabel(execution: ExecutionRecord): string;
+/** 定时徽标的数据驱动占位（T006/T007 启用编辑能力，展示自 T004 起）。 */
+export declare function scheduleBadge(schedule: ScheduleRule | undefined): {
+    label: string;
+    at?: number;
+} | undefined;
+/** 卡片标签 chips 的最大展示数（§12.8：默认最多 3 个，溢出显示 +N）。 */
+export declare const CARD_TAG_CHIP_LIMIT = 3;
+/**
+ * 列内卡片（memo 化内层）。T009：可拖拽卡片上报 dragstart/dragover/drop/dragend。
+ * T011：proposed 候选卡片展示「待确认」角标 + 来源标记（§12.2/§14.4）。
+ * T012：确认后的子任务（parentId 存在）展示所属需求（父任务）徽标，可跳转
+ * （§12.9/§12.3 父子互跳）。徽标用 span 而非 button——卡片根元素是 button，
+ * 避免嵌套交互元素（点击经 stopPropagation 转发 onOpenParent）。
+ */
+declare function TaskCardInner({ task, pending, timeZone, onClick, draggable, dragging, onDragStart, onDragEnd, onDragOverCard, onDropCard, parentId, parentTitle, onOpenParent }: {
+    task: TaskRecord;
+    pending: boolean;
+    timeZone?: string;
+    onClick: () => void;
+    /** 是否可拖拽（T009：非归档、非 running/proposed；归档视图不参与拖拽）。 */
+    draggable: boolean;
+    /** 是否正处于拖拽中（视觉高亮来源卡片）。 */
+    dragging: boolean;
+    /** 拖动启动（看板记录拖拽来源；卡片不直接提交任何动作）。 */
+    onDragStart: (task: TaskRecord) => void;
+    /** 拖动结束（看板清理拖拽状态）。 */
+    onDragEnd: () => void;
+    /** 悬停落点（卡片内按鼠标 Y 位置判定 before/after）。 */
+    onDragOverCard: (task: TaskRecord, event: DragEvent<HTMLElement>) => void;
+    /** 松手落点（看板据此提交 move/reorder；卡片不直接提交任何动作）。 */
+    onDropCard: (task: TaskRecord, event: DragEvent<HTMLElement>) => void;
+    /** 父需求任务 id（T012；确认后的子任务展示父徽标）。 */
+    parentId?: string;
+    /** 父需求任务标题（徽标文案；父任务缺失时展示占位文案）。 */
+    parentTitle?: string;
+    /** 父徽标点击：跳转父任务详情（stopPropagation，不触卡片的 open）。 */
+    onOpenParent?: (id: string) => void;
+}): import("react").JSX.Element;
+/** Memoized card: re-renders only when the card's own props change. */
+export declare const TaskCard: import("react").MemoExoticComponent<typeof TaskCardInner>;
+export {};

package/lib/types/client/board/TaskDetail.d.ts

@@ -0,0 +1,7 @@
+import type { TaskRecord } from '../../core/model.ts';
+import type { BoardController } from '../board-controller.ts';
+/** 任务详情浮层。 */
+export declare function TaskDetail({ controller, task }: {
+    controller: BoardController;
+    task: TaskRecord;
+}): import("react").JSX.Element;

package/lib/types/client/board/status-key.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 任务状态 → 文案键（列标题与详情徽标）。
+ * proposed（待确认）属 T011；本表为其预留键，T004 的五列不渲染该列。
+ */
+import type { TaskStatus } from '../../core/model.ts';
+import type { NovaTaskBoardKey } from '../locales.ts';
+/** Task status → locale key. */
+export declare const STATUS_KEY: Record<TaskStatus, NovaTaskBoardKey>;

package/lib/types/client/board-controller.d.ts

@@ -0,0 +1,274 @@
+/**
+ * 看板控制器（T004）：Host 账本的浏览器投影 + 视图状态 + 实时同步。
+ *
+ * 设计要点（DSH-REQ-001 §4-7/§8/§17）：
+ * - **浏览器 = 异步视图，Host = 唯一事实源**：所有变更经 `{requestId, action}`
+ *   信封提交（T003 协议），UI 只认 Host 确认后的快照；`pendingTaskIds` 只做
+ *   展示（spinner/禁用），不先写未确认状态（§4-7/§17 一致性）；
+ * - **实时同步（§11.1）**：SSE 帧 `{revision, scheduler, power}`——revision
+ *   与当前一致时仅就地更新 scheduler/power（不触碰任务列表），否则重拉全量
+ *   state；页面重新可见/断线重连（传输层 onopen）同样触发重拉；
+ * - **按任务 memo 化的前提**：`acceptRemote` 对快照做「身份保持合并」——同账本
+ *   代数（ledgerId）+ 非倒退 revision 下，JSON 未变化的任务行保留对象引用，
+ *   兄弟卡片状态变化只替换变化的那张，memo 边界（TaskCard）因此真正生效；
+ * - **会话导航**：打开看板时基线化当前会话，会话列表 current 变化即自动关闭
+ *   看板（§12.1：点击会话/工作区/搜索结果行回到会话）；详情页「查看会话」经
+ *   sessions.open 跳转 transcript；
+ * - **执行选项**：工作区列表与 agent 预设来自运行时（非账本），控制器只转发；
+ * - **能力门**：`executionCapable`（run/rerun 是否已接线）。T004 基线为 false
+ *   （协议 run/rerun 归 T005），详情页据此禁用执行按钮并提示；T005 起恒 true
+ *   （协议已并入 run/rerun，Host 端 runner 恒接线）。
+ * - **排序/分组视图（T009 §12.10）**：`groupMode` 视图状态（手动顺序/按项目分组/
+ *   按标签分组，会话级记忆、刷新重置，不落账）；`reorderTask` 提交列内排序/分组
+ *   落位（status 一致性 + order 重算由 Host 守卫）、`moveTask` 扩展可选 order
+ *   （跨列拖拽落位，缺省追加目标列末尾）。拖拽采用「本地 pending 渲染 + Host 确认
+ *   落定、失败回滚」——控制器仍不先写未确认状态，pending 位置由 UI 层以快照为基
+ *   础做展示（§17 一致性：以 Host 确认的 order 为准）。
+ * - **对话候选流转（T011 §11.2/§14.4，P3.1）**：`proposeTask`（对话提取/手动转
+ *   任务 → proposed 候选，输入带来源会话/消息引用）、`confirmTask`（确认候选 →
+ *   落 backlog/todo，confirm 是唯一 promote 路径）、`dismissTask`（拒绝/忽略删除）；
+ *   `proposedCountOf` 提供入口未确认角标计数（§12.7）。
+ * - **需求拆分（T012 §11.2/§12.9/§14.5，P3.2）**：`startRequirementSplit`（提交
+ *   需求文本/文件路径 → Host 启动独立拆分会话，结算后父需求任务 + 批量候选进
+ *   「待确认」列，source=requirement、children parentId 指向父任务、递归拆分挂
+ *   到原任务下）；批量确认/拒绝复用 `confirmTask`/`dismissTask`（T011 闸门）。
+ *
+ * 框架无关（结构面注入 transport/sessions/时钟/uuid），整段编排可脱离宿主单测。
+ */
+import type { NewTaskInput, ProposeTaskInput, SchedulerSnapshot, SplitRequestInput, TaskRecord, TaskStatus, TaskUpdatePatch } from '../core/model.ts';
+import type { GroupMode } from './grouping.ts';
+import type { TaskBoardAction, TaskBoardEventPayload, TaskBoardPowerSnapshot, TaskBoardSnapshot } from '../protocol.ts';
+/** 浏览器 ↔ Host 传输面（见 host-api.ts 的 HttpTaskBoardHostTransport）。 */
+export interface TaskBoardTransport {
+    bootstrap(legacy: readonly TaskRecord[]): Promise<TaskBoardSnapshot>;
+    state(): Promise<TaskBoardSnapshot>;
+    action(action: TaskBoardAction): Promise<TaskBoardSnapshot>;
+    subscribe(listener: (event?: TaskBoardEventPayload) => void): () => void;
+}
+/** 会话列表的读取面（结构面：只读 current + 订阅）。 */
+export interface SessionsListFace {
+    getSnapshot(): {
+        current: string | undefined;
+    };
+    subscribe(listener: () => void): () => void;
+}
+/** 会话导航面：打开一个会话即切回对话视图（同时关闭看板）。 */
+export interface SessionsFace {
+    list: SessionsListFace;
+    open(id: string): void;
+}
+/** 工作区下拉选项（运行时事实）。 */
+export interface ExecutionWorkspaceOption {
+    workspaceId: string;
+    /** 展示名（工作区标题；无标题时回退路径）。 */
+    title: string;
+}
+/** agent 预设下拉选项（运行时事实）。 */
+export interface ExecutionPresetOption {
+    id: string;
+    name?: string;
+    description?: string;
+    /** 该预设为何不能组装会话（下拉禁用并展示）。 */
+    broken?: string;
+    isDefault: boolean;
+}
+/** 执行目标三件套（工作区/模式/权限）的选项集。 */
+export interface ExecutionOptionsSnapshot {
+    workspaces: readonly ExecutionWorkspaceOption[];
+    presets: readonly ExecutionPresetOption[];
+}
+/** 控制器对外快照（UI 只读；订阅后整体替换）。 */
+export interface BoardSnapshot {
+    tasks: readonly TaskRecord[];
+    boardOpen: boolean;
+    /** true = 归档视图（单列），false = 五列主看板。 */
+    archiveView: boolean;
+    /** 列内排序视图模式（T009 §12.10）：手动顺序/按项目分组/按标签分组；会话级记忆、刷新重置。 */
+    groupMode: GroupMode;
+    selectedTaskId?: string;
+    executionOptions: ExecutionOptionsSnapshot;
+    /** 已提交、等待 Host 确认的任务 id（只做展示，不先写状态）。 */
+    pendingTaskIds: readonly string[];
+    transportError?: string;
+    /** Host 元信息：revision + scheduler（时区）+ power。 */
+    host?: {
+        revision: number;
+        scheduler: SchedulerSnapshot;
+        power: TaskBoardPowerSnapshot;
+    };
+    /** run/rerun 是否已接线（T005 前恒 false；详情页据此禁用执行按钮）。 */
+    executionCapable: boolean;
+}
+/** 当前选中的任务（按 selectedTaskId 从账本解析），无则 undefined。 */
+export declare function selectedTaskOf(snapshot: BoardSnapshot): TaskRecord | undefined;
+/** 未确认候选任务数（T011 §12.7 入口角标：proposed 且未归档）。 */
+export declare function proposedCountOf(snapshot: BoardSnapshot): number;
+/** 控制器依赖（全部结构面，测试可注入 fake）。 */
+export interface BoardControllerDeps {
+    transport: TaskBoardTransport;
+    sessions: SessionsFace;
+    /** 时钟（测试注入）。 */
+    now?: () => number;
+    /** id 铸造（测试注入）。 */
+    uuid?: () => string;
+    /**
+     * v1 只读回退数据的惰性读取（§12 范围项 8）：bootstrap 时传入 transport 做
+     * 一次性迁移。缺省不读（测试/无 v1 环境）。生产接线读 localStorage。
+     */
+    legacy?: () => readonly TaskRecord[];
+}
+/**
+ * 看板控制器（见模块注释）。所有变更 bump 快照并通知订阅者；UI 与 DOM 挂载
+ * 通过订阅重渲染。生产路径恒为 Host 背书（transport 必传）。
+ */
+export declare class BoardController {
+    private readonly deps;
+    private tasks;
+    private boardOpen;
+    private archiveView;
+    private groupMode;
+    private selectedTaskId;
+    private executionOptions;
+    private readonly listeners;
+    private readonly disposers;
+    private readonly now;
+    private readonly uuid;
+    private readonly pendingTaskIds;
+    private readonly taskQueues;
+    private transportError;
+    private hostState;
+    private remoteSubscribed;
+    private remoteInitialization;
+    private started;
+    private lastCurrent;
+    /** @param deps - 传输、会话导航面、时钟与 id 铸造。 */
+    constructor(deps: BoardControllerDeps);
+    /** 启动：初始化 Host 同步 + 订阅 SSE + 会话导航。幂等。 */
+    start(): void;
+    /** 停止全部订阅并释放状态（幂等）。 */
+    dispose(): void;
+    getSnapshot(): BoardSnapshot;
+    subscribe(listener: () => void): () => void;
+    /** 生产变更是否由 Host 传输确认（T004 恒 true；保留语义供测试/回退判断）。 */
+    isHostBacked(): boolean;
+    /** 显式重试与 Host 的首次/全量同步（错误条「重试」按钮）。 */
+    retryHostSync(): Promise<boolean>;
+    openBoard(): void;
+    closeBoard(): void;
+    toggleBoard(): void;
+    /**
+     * 切换主看板/归档视图。离开归档视图时若选中任务仍是归档任务则清除选中
+     * ——详情不得悬停在已离开看板的任务上。
+     */
+    toggleArchiveView(): void;
+    /**
+     * 切换列内排序视图模式（T009 §12.10）：手动顺序/按项目分组/按标签分组。
+     * 分组是视图层能力，不改底层 order 与归属数据；模式仅会话级记忆（刷新重置）。
+     */
+    setGroupMode(mode: GroupMode): void;
+    openTask(id: string): void;
+    closeTask(): void;
+    /**
+     * 经 Host 创建任务；**只有 Host 确认后**才在账本可见并返回任务（NewTaskModal
+     * 据此决定关闭/重试）。失败返回 undefined 并置 transportError。
+     */
+    createTaskConfirmed(input: NewTaskInput): Promise<TaskRecord | undefined>;
+    /**
+     * propose（T011 §11.2/§14.4）：对话提取/手动转任务 → 创建 proposed 候选任务。
+     * 输入沿用 NewTaskInput + sourceConversationId/sourceMessageId（来源引用写入
+     * metadata，可跳回对话）；清洗与命令字段拒绝在 Host（transitions/protocol）。
+     * 只有 Host 确认后才在账本可见并返回候选；失败返回 undefined 并置 transportError。
+     */
+    proposeTask(input: ProposeTaskInput): Promise<TaskRecord | undefined>;
+    /**
+     * confirm（T011 §10.2/§11.2）：确认候选任务 → 落所选列（backlog/todo）。
+     * confirm 是候选进入正式看板的唯一路径（防注入闸门）。返回 Host 是否确认。
+     */
+    confirmTask(id: string, target: 'backlog' | 'todo'): Promise<boolean>;
+    /** dismiss（T011 §10.2/§11.2）：拒绝/忽略候选任务（删除）。 */
+    dismissTask(id: string): void;
+    /**
+     * start-split（T012 §11.2/§12.9/§14.5）：需求文档自动拆分。提交需求（标题 +
+     * 粘贴文本或工作区文件路径）后，Host 启动独立拆分会话驱动 agent 按 §14.5
+     * 方法论拆分；结算后父需求任务 + 批量候选进入「待确认」列（source=requirement，
+     * 人工确认闸门复用 T011——confirm 仍是唯一 promote 路径）。返回 Host 是否确认
+     * 受理（受理后拆分异步进行，SSE revision 变化时批量候选到达待确认列）。
+     */
+    startRequirementSplit(input: SplitRequestInput): Promise<boolean>;
+    updateTask(id: string, patch: TaskUpdatePatch): void;
+    /**
+     * 跨列移动（§10.2/§11.2 + T009 order 扩展）：backlog/todo 互移、done/failed
+     * 拖回 backlog/todo 为重开（仅改状态不触发执行，区别于 rerun）。`order` 可选
+     * = 目标列落位下标（0-based，缺省追加目标列末尾）；同列拖拽排序请用
+     * `reorderTask`。返回 Host 是否确认。
+     */
+    moveTask(id: string, status: TaskStatus, order?: number): Promise<boolean>;
+    /**
+     * 列内排序/分组落位（T009 §11.2 reorder）：调整列内 order（`status` 须与任务
+     * 当前状态一致，Host 防竞态校验）；`order` = 0-based 落位下标（Host 重算同列
+     * 唯一）。分组视图跨组落位可携带归属变更 `ownership`（`project` 空串清除 /
+     * `tags` 整体替换），与 order 原子落账。返回 Host 是否确认。
+     */
+    reorderTask(id: string, status: TaskStatus, order: number, ownership?: {
+        project?: string;
+        tags?: string[];
+    }): Promise<boolean>;
+    deleteTask(id: string): void;
+    /** 归档已结算任务（done/failed）。Host 守卫拒绝非法归档并置错误条。 */
+    archiveTask(id: string): void;
+    /** 恢复归档任务回原列。确认后关闭详情（任务已离开归档视图）。 */
+    restoreTask(id: string): void;
+    /**
+     * 执行任务（T005 §13.2）：协议 `run` 开执行记录，Host 端 runner 异步创建
+     * 会话并发送 Prompt；本方法只提交，结算由 Host 轮询完成。
+     */
+    runTask(id: string): Promise<boolean>;
+    /** 重新执行（§13.2）：协议 `rerun`，Host 侧先落回 todo 再开启执行。 */
+    rerunTask(id: string): Promise<void>;
+    /**
+     * 设定/修改/关闭任务的 cron 周期定时（T006 §11.2 set-schedule）。patch 只含
+     * enabled/cron；nextRunAt/lastTriggeredAt 由 Host 调度器维护（浏览器不可写，
+     * §9.4）。Host 拒绝（非法 cron / 归档 / proposed 等）→ transportError，账本不变。
+     */
+    setSchedule(id: string, patch: {
+        enabled?: boolean;
+        cron?: string;
+    }): void;
+    /**
+     * 设定/修改/清除任务的一次性计划（T007 §11.2 set-one-shot）。patch 只含
+     * runAt（缺省或 0 = 取消）；firedAt 由 Host 调度器维护（浏览器不可写，
+     * §9.4）。设定自动清除 cron 分支、反之亦然（互斥 D6）。Host 拒绝（非有限
+     * runAt / 归档 / proposed 等）→ transportError，账本不变。
+     */
+    setOneShot(id: string, patch: {
+        runAt?: number;
+    }): void;
+    /** 替换执行选项集的一部分（工作区列表/预设名册来自运行时，非账本）。 */
+    setExecutionOptions(patch: Partial<ExecutionOptionsSnapshot>): void;
+    /** 跳转执行会话 transcript（选择会话 → current 变化 → 看板自动关闭）。 */
+    openSession(sessionId: string): void;
+    private onSessionsChanged;
+    /**
+     * 提交远程动作：按任务串行化（同任务并发动作排队，防竞态）；提交期间任务
+     * 进入 pendingTaskIds（只做展示）。Host 拒绝 → transportError，状态不变。
+     * @returns Host 是否确认（快照已应用）。
+     */
+    private commitRemote;
+    private performRemote;
+    private initializeRemote;
+    private doInitializeRemote;
+    /**
+     * SSE 帧处理（§11.1）：revision 与已应用的一致 → 就地更新 scheduler/power
+     * （不动任务列表，memo 边界保持）；否则（帧不完整/新 revision/同步信号）重拉
+     * 全量 state。
+     */
+    private onRemoteEvent;
+    private refreshRemote;
+    /**
+     * 应用 Host 快照。同账本代数且 revision 非倒退 → 身份保持合并（memo 前提）；
+     * 代数变化（迁移/重建）→ 整体替换。选中任务被删除/归档（非归档视图）时清除
+     * 选中。返回快照是否被接受。
+     */
+    private acceptRemote;
+    private notify;
+}

package/lib/types/client/board-mount.d.ts

@@ -0,0 +1,10 @@
+import type { BoardController } from './board-controller.ts';
+/** The injected board container (kept in the DOM, hidden when inactive). */
+export declare const BOARD_VIEW_SELECTOR = "[data-dsh-nova-taskboard-view]";
+/**
+ * Mount the board React tree into the center column and bind its
+ * visibility to the controller's boardOpen state.
+ * @param controller - the board controller driving the view.
+ * @returns disposer unmounting the tree and restoring the column.
+ */
+export declare function mountBoard(controller: BoardController): () => void;

package/lib/types/client/chat-integration.d.ts

@@ -0,0 +1,99 @@
+/**
+ * 对话候选任务提取集成（T011 §12.7/§14.4，B7 调研定案）。
+ *
+ * 两条提取入口：
+ * 1. **Agent 建议（半自动）**：订阅当前会话的对话快照（sessions.binding →
+ *    SessionFace 的 ObservableSnapshot<ConversationSnapshot>），扫描已结算的
+ *    assistant 节点文本块中的结构化候选标记 `⟦task-board:propose⟧ 标题 | 描述 |
+ *    prompt`，逐条经 `propose` action 创建 proposed 候选（source=conversation
+ *    + 来源会话/消息引用）；按 (sessionId, messageId|seq, 序号) 去重，避免会话
+ *    快照重放/重订阅重复建候选。标记格式由 announceToAgent 系统提示播报指引
+ *    agent 输出（§12.5/§14.4）。
+ * 2. **用户手动（兜底）**：向会话消息行（DOM 行 `[data-chat-anchor-key]`，键格式
+ *    为 DSH `conversationContextKey` 的 `${len}:${kind}${id}`）注入 hover「转为
+ *    任务」按钮；点击打开 ConvertTaskModal（预填消息正文，可编辑），提交为候选或
+ *    直接选择落列创建。注入自愈：MutationObserver 持续扫描，React 重渲染重建的
+ *    行会被重新注入（与 sidebar-entry 同机制，永不破坏宿主 DOM）。
+ *
+ * DSH 消息结构（B7 调研）：
+ * - 消息节点：`ConversationNode` 判别联合（user/assistant/steering/context/…）；
+ *   user 节点 `content: ContentBlock[]`（type='text' 取文本）、assistant 节点
+ *   `blocks: AssistantBlock[]`（kind='text' 取文本）+ `messageId?`/`seq`；
+ * - 节点上下文键：`conversationContextKey(kind, id)` = `${kind.length}:${kind}${id}`；
+ *   输入消息（user/steering）的 kind 为 `input-message`，id 为消息 id——DOM 行
+ *   `data-chat-anchor-key` 据此识别「可转为任务」的行。
+ */
+import type { AssistantMessageNode, ConversationSnapshot, UserMessageNode } from '@deepseek-ai/dsh-client-runtime/client';
+import type { BoardController } from './board-controller.ts';
+import { type ConvertTaskPrefill } from './board/ConvertTaskModal.tsx';
+/** 候选标记（B7 定案：系统提示指引 agent 输出的结构化标记）。 */
+export declare const PROPOSE_MARKER = "\u27E6task-board:propose\u27E7";
+/** 输入消息节点定义 kind（user/steering 共用；DOM 行据此识别「转为任务」）。 */
+export declare const INPUT_MESSAGE_KIND = "input-message";
+/** 解析出的一条候选标记内容。 */
+export interface ProposeMarkerContent {
+    title: string;
+    description: string;
+    prompt: string;
+}
+/**
+ * 解析文本中的候选标记（B7 定案格式 `⟦task-board:propose⟧ 标题 | 描述 | prompt`）。
+ * 一条文本可含多个标记（全局扫描，每个标记占据所在行）；标记内容按 `|` 分段：
+ * 首段 = 标题（空则整条丢弃）、次段 = 描述、其余拼接为 prompt。纯函数，可脱离
+ * 宿主单测。
+ */
+export declare function parseProposeMarkers(text: string): ProposeMarkerContent[];
+/**
+ * 解析会话节点上下文键（B7：`${len}:${kind}${id}`，conversationContextKey 格式）。
+ * 长度前缀不匹配 / 结构非法返回 undefined。
+ */
+export declare function parseContextKey(key: string): {
+    kind: string;
+    id: string;
+} | undefined;
+/** 从 user 节点内容块提取文本（ContentBlock type='text'）。 */
+export declare function userMessageText(node: UserMessageNode): string;
+/** 从 assistant 节点块提取文本（AssistantBlock kind='text'）。 */
+export declare function assistantMessageText(node: AssistantMessageNode): string;
+/** 会话列表 + 会话绑定的最小结构面（生产传 ctx.sessions，测试注入 fake）。 */
+export interface ChatSessionsFace {
+    list: {
+        getSnapshot(): {
+            current?: string;
+        };
+        subscribe(listener: () => void): () => void;
+    };
+    binding(id: string): {
+        session: ChatSessionFace;
+    } | undefined;
+}
+/** 会话快照订阅面（生产 = SessionFace 的 ObservableSnapshot 半边）。 */
+export interface ChatSessionFace {
+    getSnapshot(): ConversationSnapshot;
+    subscribe(listener: () => void): () => void;
+}
+/**
+ * 订阅当前会话，扫描 assistant 文本中的候选标记并自动 propose（§12.7 入口 1）。
+ * 去重键 = `${sessionId}:${messageId ?? seq}:${序号}`——会话快照重放/切换会话
+ * 重订阅不会重复建候选；同一 assistant 消息重复出现同一标记（如重发）视为新
+ * 候选（用户可 dismiss）。
+ * @returns disposer。
+ */
+export declare function mountChatToTaskBoard(controller: BoardController, sessions: ChatSessionsFace): () => void;
+/**
+ * 由消息文本派生预填：标题 = 首行（封顶 120 字）、描述 = 全文（封顶 4000），
+ * prompt 留空（由确认/编辑时填写）。
+ */
+export declare function prefillFromText(text: string, messageId?: string): ConvertTaskPrefill;
+/**
+ * 向会话消息行注入 hover「转为任务」按钮（§12.7 入口 2，B7 定案）。
+ *
+ * - 扫描 `[data-conversation-scroll]` 容器内的 `[data-chat-anchor-key]` 行；
+ * - 键解析出 kind = `input-message`（user/steering）的行才注入（注入按钮的
+ *   稳定标识 data-dsh-nova-taskboard-convert 幂等）；
+ * - 自愈：MutationObserver 持续扫描——React 重渲染重建的行重新注入，被宿主
+ *   移除的按钮随行消失（不破坏宿主 DOM）；
+ * - 点击：取当前会话快照的节点文本（回退行文本）打开 ConvertTaskModal。
+ * @returns disposer。
+ */
+export declare function mountMessageConvertButton(controller: BoardController, sessions: ChatSessionsFace): () => void;