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

package/lib/types/client/drag-utils.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 看板拖拽纯函数（T009 §12.10，D10）。
+ *
+ * - 合法性（§10.2/§11.2）：running 不可作为拖拽来源/目标；跨列拖拽 = move，
+ *   目标仅限 backlog/todo（backlog↔todo 互移、done/failed 拖回 backlog/todo 为
+ *   重开）；同列拖拽 = reorder（各列均可列内排序）；拖到 running 等非法目标被
+ *   拒绝并提示；
+ * - 落位下标语义（与 Host transitions.applyReposition 一致）：浏览器提交的
+ *   `order` = 0-based 插入下标，基准是**剔除拖拽卡片后的目标列**（按 order 稳定
+ *   升序）——锚定卡片（before/after）或组尾/列尾（end）换算成该列表的下标；
+ *   过滤状态下「列尾」按可见列表最后一张卡在基准列表中的位置定位（先过滤后排序
+ *   /分组展示，§12.10）；
+ * - action 构建：同列 → `reorder`（分组视图跨组落位携带归属变更：项目模式
+ *   project=组名/''（清除）；标签模式 tags 使目标标签成为首选或移除首选）；
+ *   跨列 → `move`（可选 order 落位，done/failed 重开由状态机守卫）；
+ * - 全部为纯函数，可脱离宿主单测（验收 3）。
+ */
+import type { TaskRecord, TaskStatus } from '../core/model.ts';
+import type { TaskBoardAction } from '../protocol.ts';
+import { type GroupMode } from './grouping.ts';
+/** 拖拽提交的 action 判别联合（buildDropAction 只产出 reorder/move 两种）。 */
+export type DropAction = Extract<TaskBoardAction, {
+    kind: 'reorder';
+}> | Extract<TaskBoardAction, {
+    kind: 'move';
+}>;
+/** 拖拽来源（dragstart 时记录；分组视图记录起始组 key 以判定跨组）。 */
+export interface DragOrigin {
+    taskId: string;
+    fromStatus: TaskStatus;
+    fromTags: readonly string[];
+    /** 分组视图下起始组的 key（'' = 未分类）；手动模式 undefined。 */
+    fromGroupKey?: string;
+}
+/** 落位方式：锚定卡片之前/之后，或组尾/列尾。 */
+export type DropPosition = 'before' | 'after' | 'end';
+/** 拖拽目标（dragover/drop 时计算）。 */
+export interface DropTarget {
+    /** 目标列。 */
+    status: TaskStatus;
+    /** 分组视图目标组的 key（'' = 未分类）；手动模式 undefined。 */
+    groupKey?: string;
+    /** 锚定卡片 id（落在卡片上时）；否则为组尾/列尾。 */
+    anchorId?: string;
+    /** 落位方式：锚定卡片存在时 before/after；否则 end。 */
+    position: DropPosition;
+}
+/**
+ * 拖拽合法性（§10.2/§11.2）：running 不可作目标；同列 = 列内排序；跨列目标仅限
+ * backlog/todo（done/failed 拖回为重开）。proposed/归档不可作为来源由调用方
+ * （卡片 draggable=false）保证。
+ */
+export declare function isLegalDrop(origin: DragOrigin, targetStatus: TaskStatus): boolean;
+/**
+ * 计算落位下标（0-based，基准 = 剔除拖拽卡片后的目标列，按 order 稳定升序；
+ * 与 Host applyReposition 的 insert 基准一致）：
+ * - 锚定卡片：卡片下标（after +1）；
+ * - 分组视图组尾：目标组最后一张卡下标 +1（组空回退列尾）；
+ * - 列尾：可见列表最后一张卡下标 +1（过滤定位；无可见卡则列尾）。
+ */
+export declare function computeDropIndex(restColumn: readonly TaskRecord[], target: DropTarget, mode: GroupMode, lastVisibleId?: string): number;
+/**
+ * 可见列表内的落位下标（拖拽 pending 渲染用；list = 目标列/目标组的可见列表，
+ * **已剔除拖拽卡片**）：锚定卡片 before/after，否则列表尾。
+ */
+export declare function visibleDropIndex(list: readonly TaskRecord[], target: DropTarget): number;
+/**
+ * 构建拖拽提交的 action（§11.2/D10）：
+ * - 同列 → `reorder`（status 与来源一致；分组视图跨组落位携带归属变更——
+ *   项目模式 project = 组名 / ''（清除）；标签模式 tags 使目标标签成为首选或
+ *   移除首选（未分类））；
+ * - 跨列 → `move`（status 为目标列 + 落位下标，缺省语义由 Host 追加末尾；
+ *   done/failed 重开不触发执行）。
+ * 非法目标/拖到自己返回 undefined（调用方提示拒绝）。
+ */
+export declare function buildDropAction(origin: DragOrigin, target: DropTarget, mode: GroupMode, tasks: readonly TaskRecord[], lastVisibleId?: string): DropAction | undefined;
+/** 拖拽目标组的归属变换后的行（pending 渲染预览，与提交的 reorder 补丁一致）。 */
+export declare function pendingTaskView(task: TaskRecord, target: DropTarget, mode: GroupMode): TaskRecord;

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

@@ -0,0 +1,42 @@
+/**
+ * 看板过滤纯函数（T008 §12.8，D9）。
+ *
+ * - 过滤维度：文本搜索（标题/描述，大小写不敏感）+ 项目（单选）+ 标签（多选）；
+ * - 语义：多条件（文本/项目/标签）之间 AND；同一条件内标签为 OR（命中任一
+ *   标签即通过）；项目为单选精确匹配（`none` = 仅无项目任务）；
+ * - 过滤跨列生效（主看板/归档视图由调用方先筛视图再调本函数）；过滤状态仅
+ *   会话级记忆（刷新重置，不做持久化，P4 再考虑）；
+ * - 全部为纯函数（无 fs、无 DOM、无运行时依赖），可脱离宿主单测
+ *   （验收 3：过滤逻辑纯函数）。
+ */
+import type { TaskRecord } from '../core/model.ts';
+/** 项目过滤值：`all` = 不限；`none` = 仅无项目任务；`name` = 精确项目名。 */
+export type ProjectFilterValue = {
+    kind: 'all';
+} | {
+    kind: 'none';
+} | {
+    kind: 'name';
+    name: string;
+};
+/** 过滤状态（会话级记忆；刷新重置，不做持久化）。 */
+export interface TaskFilter {
+    /** 文本搜索（标题/描述，大小写不敏感；空 = 不限制）。 */
+    query: string;
+    /** 项目过滤（缺省/`all` = 不限）。 */
+    project: ProjectFilterValue;
+    /** 标签过滤：空数组 = 不限；非空 = 命中任一标签（同一条件内 OR）。 */
+    tags: readonly string[];
+}
+/** 空过滤（看板初始状态）。 */
+export declare const EMPTY_FILTER: TaskFilter;
+/** 单条任务是否命中过滤（多条件 AND、标签内 OR）。 */
+export declare function matchesFilter(task: TaskRecord, filter: TaskFilter): boolean;
+/** 对任务集执行过滤（保持入参顺序与对象引用，memo 边界不受影响）。 */
+export declare function filterTasks(tasks: readonly TaskRecord[], filter: TaskFilter): TaskRecord[];
+/** 过滤是否处于激活状态（任一维度有约束；用于「清除全部」显隐与命中计数）。 */
+export declare function isFilterActive(filter: TaskFilter): boolean;
+/** 从任务集推导去重后的项目名列表（过滤下拉选项），按 zh locale 排序。 */
+export declare function distinctProjects(tasks: readonly TaskRecord[]): string[];
+/** 从任务集推导去重后的标签列表（多选 chips 选项），按 zh locale 排序。 */
+export declare function distinctTags(tasks: readonly TaskRecord[]): string[];

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

@@ -0,0 +1,54 @@
+/**
+ * 看板列内分组/排序纯函数（T009 §12.10，D10）。
+ *
+ * - 排序视图模式（看板顶部切换，会话级记忆、刷新重置）：手动顺序（默认，完全按
+ *   order）/ 按项目分组 / 按标签分组；
+ * - 分组是视图层能力，不改底层 order 与归属数据（归属变更经 reorder/update 落账）；
+ * - 按项目分组：组头 = 项目名，无 `project` 的任务归「未分类」组，组内按 order
+ *   升序；按标签分组：组头 = 标签，任务按全部 `tags` 多归组展示（一个任务可出现
+ *   在多个标签组），无标签任务归「未分类」组，组内按 order 升序；
+ * - 排序必须与 Host 端 transitions.byOrderStable 完全一致（order 升序，
+ *   createdAt/id 决胜），否则浏览器计算的落位下标与 Host 重算不一致；
+ * - 全部为纯函数（无 fs、无 DOM、无运行时依赖），可脱离宿主单测
+ *   （验收 3：分组视图过滤/归组逻辑）。
+ */
+import type { TaskRecord } from '../core/model.ts';
+/** 排序视图模式（§12.10：看板顶部切换，会话级记忆、刷新重置）。 */
+export type GroupMode = 'manual' | 'project' | 'tag';
+/** 全部模式（顶部切换按钮按此顺序渲染）。 */
+export declare const GROUP_MODES: readonly GroupMode[];
+/**
+ * 「未分类」组的哨兵 key。项目名/标签经 trim 后非空（normalizeOptionalString /
+ * normalizeTags 丢弃空白项），空串不可能与真实归属冲突，安全用作哨兵。
+ */
+export declare const UNGROUPED = "";
+/** 一个分组（组头 = label；组内任务按 order 升序）。 */
+export interface TaskGroup {
+    /** 稳定 key：项目名 / 标签名 / UNGROUPED（未分类）。 */
+    key: string;
+    /** 展示名（未分类由调用方渲染为「未分类」文案）。 */
+    label: string;
+    tasks: TaskRecord[];
+}
+/** 与 Host transitions.byOrderStable 一致的列内排序（order 升序，createdAt/id 决胜）。 */
+export declare function byOrderStable(a: TaskRecord, b: TaskRecord): number;
+/** 列内任务按 order 升序排序（原数组不改动）。 */
+export declare function sortByOrder(tasks: readonly TaskRecord[]): TaskRecord[];
+/** 任务在给定视图模式下的组 key（手动模式无组概念，返回 undefined）。 */
+export declare function groupKeyOf(task: TaskRecord, mode: GroupMode): string | undefined;
+/** 任务是否属于某个组（按模式解释 key：项目精确匹配 / 标签命中 / 未分类无归属）。 */
+export declare function groupContains(task: TaskRecord, groupKey: string, mode: GroupMode): boolean;
+/**
+ * 拖拽目标组的归属变换（视图层预览用，与提交的 reorder 归属补丁一致，§12.10）：
+ * - 按项目分组：拖到组 G → project = G；拖到「未分类」→ 清除 project；
+ * - 按标签分组：拖到组 G → G 成为首选标签（tags[0]，G 已含于 tags 时仅调整顺序）；
+ *   拖到「未分类」→ 移除首选标签（tags.shift()，若 tags 为空则归「未分类」）；
+ * - 手动模式或非组落位 → 原样返回。
+ */
+export declare function applyOwnershipTransform(task: TaskRecord, groupKey: string | undefined, mode: GroupMode): TaskRecord;
+/**
+ * 分组（§12.10）：项目/标签模式下的归组展示，组内按 order 升序；标签模式多归组
+ * （一个任务可出现在其全部标签组），无标签归「未分类」；未分类组恒在最后。
+ * 手动模式不分组（调用方直接 sortByOrder）。
+ */
+export declare function groupTasks(tasks: readonly TaskRecord[], mode: Exclude<GroupMode, 'manual'>): TaskGroup[];

package/lib/types/client/host-api.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 浏览器 ↔ Host 的同源传输层（T004 §11.1/§11.3/§12 实时同步）。
+ *
+ * 三个端点（与 T003 host-routes 一一对应）：
+ * - `GET  /api/nova-task-board/state`  全量快照（含 tasks），`no-store` 防缓存；
+ * - `POST /api/nova-task-board/action` 幂等信封 `{requestId, action}`，返回新快照；
+ * - `GET  /api/nova-task-board/events` SSE 只推 `{revision, scheduler, power}`
+ *   （15s 心跳），revision 变化才由控制器重拉 state。
+ *
+ * 同步契约（§17 一致性）：浏览器不先写未确认状态——本层只是传输，动作是否生效
+ * 以 Host 返回的快照为准；SSE 连接中断时浏览器 EventSource 自动重连，重连成功
+ * （onopen）与页面重新可见（visibilitychange → visible）都会触发一次全量重拉。
+ *
+ * v1 迁移（§11.2 import / §9.5）：首次加载若本地仍有 v1 回退数据且尚未导入
+ * 本项目账本（按 ledgerId 记 marker），则用一次性 sourceId/requestId 提交
+ * `import` action；marker 只在 Host 确认（返回快照）后写入，原 v1 值永不删除。
+ * 迁移键用本项目专属前缀 `dsh.novaTaskBoard.*`，避免与参考实现自己的
+ * `dsh.taskBoard.v2.*` 迁移标记互踩（AGENTS.md D2/D3）。
+ */
+import type { TaskRecord } from '../core/model.ts';
+import { type TaskBoardAction, type TaskBoardEventPayload, type TaskBoardSnapshot } from '../protocol.ts';
+/** 单次 Host 请求超时（§17 性能边界；超时按传输错误暴露，可重试）。 */
+export declare const REQUEST_TIMEOUT_MS = 15000;
+/** 浏览器存储的读写面（localStorage；测试注入 fake）。 */
+export interface MarkerStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+/** 传输层对外契约：控制器只依赖这四个方法（结构面，测试可注入 fake）。 */
+export interface TaskBoardHostTransport {
+    /** 首次同步：先拉全量 state，必要时顺带做一次 v1 一次性迁移（§11.2 import）。 */
+    bootstrap(legacy: readonly TaskRecord[]): Promise<TaskBoardSnapshot>;
+    /** 全量快照。 */
+    state(): Promise<TaskBoardSnapshot>;
+    /** 提交幂等动作，返回 Host 确认后的新快照（不先写未确认状态）。 */
+    action(action: TaskBoardAction): Promise<TaskBoardSnapshot>;
+    /**
+     * 订阅实时事件。listener 带载荷 = SSE 帧（revision/scheduler/power）；不带
+     * 载荷 = 同步信号（重连成功/页面重新可见），控制器据此重拉全量。
+     */
+    subscribe(listener: (event?: TaskBoardEventPayload) => void): () => void;
+}
+/**
+ * 真实 HTTP + SSE 传输（同源 `/api/nova-task-board/*`）。
+ * @param markers - 迁移标记存储（缺省用全局 localStorage）。
+ */
+export declare class HttpTaskBoardHostTransport implements TaskBoardHostTransport {
+    private readonly markers;
+    constructor(markers?: MarkerStorage | undefined);
+    bootstrap(legacy: readonly TaskRecord[]): Promise<TaskBoardSnapshot>;
+    state(): Promise<TaskBoardSnapshot>;
+    action(action: TaskBoardAction): Promise<TaskBoardSnapshot>;
+    private post;
+    /** 同源 fetch，带超时（超时按传输错误抛，控制器转为可重试的错误条）。 */
+    private request;
+    /**
+     * SSE 订阅：消息帧解析为 `{revision, scheduler, power}`（解析失败按同步信号
+     * 处理，重拉兜底）；`onopen`（含断线重连成功）与页面重新可见 → 同步信号，
+     * 控制器据此重拉全量 state。
+     */
+    subscribe(listener: (event?: TaskBoardEventPayload) => void): () => void;
+}

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

@@ -0,0 +1,46 @@
+import type { SettingsScope, SettingsScopeSpec } from '@deepseek-ai/dsh-client-runtime/client';
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type NovaTaskBoardKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Nova task-board surface copy. */
+        'nova-task-board': NovaTaskBoardKey;
+    }
+    interface SlotMap {
+        /**
+         * The child slot the Web UI plugin group declares; this card registers
+         * into the group instead of the top-level `settings.section` list.
+         * Spelled here with the same shape so this package can register without
+         * depending on the sibling UI package.
+         */
+        'web-ui.plugin.item': {
+            kind: 'list';
+            scope: 'root';
+            owner: WebUiPluginItemOwnerProps;
+        };
+    }
+}
+/** Owner share of a plugin card (the section supplies nothing). */
+export interface WebUiPluginItemOwnerProps {
+    /** Marker field: card owner props are intentionally empty. */
+    children?: never;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /**
+         * Optional rc.6 compatibility binder provided by dsh-web-ui-settings;
+         * absent when that group plugin is not installed, so callers fall back to
+         * the official settings scope.
+         */
+        webUiSettings?: {
+            bind<S>(spec: SettingsScopeSpec<S>): SettingsScope<S>;
+        };
+    }
+}
+/** Required services (fiber inject waiting — the runtime must be up first). */
+export declare const inject: readonly ["slots", "sessions", "workspaces", "connection", "settingsScope", "locale", "remote"];
+/**
+ * Mount the nova task board (T004 真实看板).
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;

package/lib/types/client/legacy-store.d.ts

@@ -0,0 +1,28 @@
+/**
+ * v1 只读回退数据读取（T004 §12 范围项 8：UI 层对 v1 只读回退数据可正常展示）。
+ *
+ * 参考实现的旧浏览器账本写在 localStorage `dsh.taskBoard.v1`（键名由其
+ * `DEFAULT_STORAGE_KEY` 定义，与宿主/参考实现共享同一浏览器源）。本项目与其
+ * 共存（AGENTS.md D3）：读取该键做一次性迁移，但**绝不删除原值**——迁移后它
+ * 仍是只读回退副本；迁移经 Host 的 `import` action 落进本项目自己的账本
+ * （`$DSH_HOME/nova-ui/task-board/`，AGENTS.md D2），写入方只有 Host。
+ *
+ * 行解析走本项目 core/model 的 `normalizeTask`（宽松归一化：未知字段剥离、
+ * 状态回退 todo、坏 schedule 修复或丢弃、不丢行），单条坏行被丢弃而不阻断
+ * 整批——Host 侧 `import` 是严格逐行校验，任何坏行都会让整批 import 被拒，
+ * 所以浏览器侧先做一次宽松过滤，保证一条陈旧坏数据不阻断迁移。
+ */
+import type { TaskRecord } from '../core/model.ts';
+/** 参考实现的 v1 浏览器账本键（只读来源；其内部键名 `dsh.taskBoard.v1`）。 */
+export declare const LEGACY_V1_STORAGE_KEY = "dsh.taskBoard.v1";
+/** 浏览器 localStorage 的读取面（测试注入 fake）。 */
+export interface LegacyStorage {
+    getItem(key: string): string | null;
+}
+/**
+ * 读取并宽松归一化 v1 回退数据。存储缺失/损坏/非数组 → []（降级为空账本，
+ * 绝不抛错拖垮看板启动）；数组内逐行 normalizeTask，坏行丢弃。
+ * @param storage - 存储面（缺省用全局 localStorage；非浏览器环境为 undefined → []）。
+ * @param key - 覆盖存储键（测试用）。
+ */
+export declare function readLegacyV1Tasks(storage?: LegacyStorage | undefined, key?: string): TaskRecord[];

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

@@ -0,0 +1,202 @@
+/**
+ * Nova task-board copy: zh-first dictionaries with an English fallback,
+ * selected by the document language. Kept dependency-free (no dsh locale
+ * service) so the DOM-injected entry row and the standalone board tree share
+ * one tiny lookup. Key set 以 zh 为准，en 对齐（对齐参考实现的组织方式）。
+ *
+ * T004 补全看板/详情/新建/状态/执行设置文案；定时编辑器（T006/T007）与
+ * 待确认列（T011）的编辑/确认文案随对应任务补充。
+ */
+/** zh dictionary (key-set source of truth). */
+export declare const zh: {
+    'entry.label': string;
+    'board.title': string;
+    'board.close': string;
+    'board.new': string;
+    'board.search': string;
+    'board.empty': string;
+    'board.archive': string;
+    'board.archiveView': string;
+    'board.backToBoard': string;
+    'archive.empty': string;
+    'board.status': string;
+    'board.status.proposed': string;
+    'board.status.backlog': string;
+    'board.status.todo': string;
+    'board.status.running': string;
+    'board.status.done': string;
+    'board.status.failed': string;
+    'board.runs': string;
+    'board.pending': string;
+    'board.updated': string;
+    'board.created': string;
+    'board.hostError': string;
+    'board.retryHost': string;
+    'board.hostMeta': string;
+    'new.title': string;
+    'new.titlePlaceholder': string;
+    'new.description': string;
+    'new.descriptionPlaceholder': string;
+    'new.prompt': string;
+    'new.promptPlaceholder': string;
+    'new.submit': string;
+    'new.cancel': string;
+    'new.required': string;
+    'detail.title': string;
+    'detail.close': string;
+    'detail.prompt': string;
+    'detail.description': string;
+    'detail.execution': string;
+    'detail.noExecution': string;
+    'detail.run': string;
+    'detail.rerun': string;
+    'detail.delete': string;
+    'detail.archive': string;
+    'detail.restore': string;
+    'detail.archivedAt': string;
+    'detail.viewSession': string;
+    'detail.executionStarted': string;
+    'detail.executionEnded': string;
+    'detail.result.succeeded': string;
+    'detail.result.failed': string;
+    'detail.result.cancelled': string;
+    'detail.result.running': string;
+    'delete.title': string;
+    'delete.confirm': string;
+    'delete.ok': string;
+    'delete.cancel': string;
+    'status.move.backlog': string;
+    'status.move.todo': string;
+    'time.justNow': string;
+    'card.scheduled': string;
+    'card.oneShot': string;
+    'detail.schedule': string;
+    'detail.schedule.nextRun': string;
+    'detail.schedule.lastTriggered': string;
+    'detail.schedule.notScheduled': string;
+    'detail.schedule.dueSoon': string;
+    'detail.schedule.enable': string;
+    'detail.schedule.cron': string;
+    'detail.schedule.invalid': string;
+    'detail.schedule.presets': string;
+    'detail.schedule.preset.daily9': string;
+    'detail.schedule.preset.hourly': string;
+    'detail.schedule.preset.tenMin': string;
+    'detail.schedule.preset.weeklyMon9': string;
+    'detail.schedule.modeCron': string;
+    'detail.schedule.modeOneShot': string;
+    'detail.oneShot.runAt': string;
+    'detail.oneShot.remaining': string;
+    'detail.oneShot.cancel': string;
+    'detail.oneShot.executed': string;
+    'detail.oneShot.skipped': string;
+    'detail.oneShot.reschedule': string;
+    'detail.oneShot.invalid': string;
+    'detail.oneShot.dueSoon': string;
+    'detail.oneShot.preset.tenMin': string;
+    'detail.oneShot.preset.tonight21': string;
+    'detail.oneShot.preset.tomorrow9': string;
+    'detail.executionSettings': string;
+    'exec.hint': 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;
+    'filter.project': string;
+    'filter.projectAll': string;
+    'filter.projectNone': string;
+    'filter.tags': string;
+    'filter.clearAll': string;
+    'filter.hits': string;
+    'filter.removeTag': string;
+    'board.group.label': string;
+    'board.group.manual': string;
+    'board.group.project': string;
+    'board.group.tag': string;
+    'board.group.ungrouped': string;
+    'board.dragRejected': string;
+    'detail.projectTags': string;
+    'detail.projectPlaceholder': string;
+    'new.tagsPlaceholder': string;
+    'confirm.title': string;
+    'confirm.subtitle': string;
+    'confirm.target': string;
+    'confirm.toBacklog': string;
+    'confirm.toTodo': string;
+    'confirm.submit': string;
+    'confirm.dismiss': string;
+    'confirm.dismissTitle': string;
+    'confirm.dismissMessage': string;
+    'card.proposedBadge': string;
+    'card.source': string;
+    'source.conversation': string;
+    'source.requirement': string;
+    'entry.proposedCount': string;
+    'convert.title': string;
+    'convert.fromConversation': string;
+    'convert.submitProposed': string;
+    'convert.submitDirect': string;
+    'convert.directTarget': string;
+    'convert.directBacklog': string;
+    'convert.directTodo': string;
+    'convert.proposedHint': string;
+    'chat.extractedHint': string;
+    'detail.jumpToConversation': string;
+    'detail.sourceConversation': string;
+    'split.entry': string;
+    'split.subtitle': string;
+    'split.recursiveTitle': string;
+    'split.recursiveHint': string;
+    'split.requirementTitle': string;
+    'split.requirementTitlePlaceholder': string;
+    'split.source': string;
+    'split.sourceText': string;
+    'split.sourceFile': string;
+    'split.text': string;
+    'split.textPlaceholder': string;
+    'split.file': string;
+    'split.filePlaceholder': string;
+    'split.required': string;
+    'split.submit': string;
+    'split.asyncHint': string;
+    'split.batchButton': string;
+    'split.batchTitle': string;
+    'split.batchSubtitle': string;
+    'split.addItem': string;
+    'split.added': string;
+    'split.removeItem': string;
+    'split.confirmAll': string;
+    'split.dismissAll': string;
+    'split.dismissAllTitle': string;
+    'split.dismissAllMessage': string;
+    'split.dismissItemTitle': string;
+    'split.dismissItemMessage': string;
+    'split.empty': string;
+    'split.parentOf': string;
+    'split.parentMissing': string;
+    'split.children': string;
+    'settings.title': string;
+    'settings.description': string;
+    'settings.enabled': string;
+    'settings.enabledHint': string;
+    'settings.announceToAgent': string;
+    'settings.announceToAgentHint': string;
+    'settings.notExposed': string;
+    'settings.readOnly': string;
+};
+/** en dictionary, complete against the zh key set. */
+export declare const en: Record<keyof typeof zh, string>;
+/** The dictionary key union. */
+export type NovaTaskBoardKey = keyof typeof zh;
+/** Active dictionary, picked by the document language at call time. */
+export declare function dictionary(): Record<NovaTaskBoardKey, string>;
+/** Translate a key with optional {name} template params. */
+export declare function t(key: NovaTaskBoardKey, params?: Record<string, string>): string;

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

@@ -0,0 +1,20 @@
+/**
+ * 定时编辑器共享预设（T006 §12.3 cron 周期定时「预设」下拉 + T007 §12.3 一次性
+ * 计划「快捷预设」）：cron 表达式 → locale 文案键；one-shot 快捷预设 → 相对
+ * 当前时刻的计算函数（Host 本地时区）。详情页定时编辑器共用。
+ */
+import type { NovaTaskBoardKey } from './locales.ts';
+/** 常用 cron 定时预设（cron → locale label）。 */
+export declare const SCHEDULE_PRESETS: ReadonlyArray<{
+    cron: string;
+    label: NovaTaskBoardKey;
+}>;
+/** 一次性计划快捷预设（T007 §12.3：label → 相对 now 的 runAt 计算）。 */
+export declare const ONE_SHOT_PRESETS: ReadonlyArray<{
+    label: NovaTaskBoardKey;
+    at: (now: number) => number;
+}>;
+/** 本地毫秒时间戳 → `datetime-local` 输入值（YYYY-MM-DDTHH:mm，Host 本地时区）。 */
+export declare function toLocalInputValue(ms: number): string;
+/** `datetime-local` 输入值 → 本地毫秒时间戳（解析失败返回 undefined）。 */
+export declare function fromLocalInputValue(value: string): number | undefined;

package/lib/types/client/sidebar-entry-core.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Nova sidebar entry injection core (adapted from the reference dsh-web-ui
+ * shared/client/sidebar-entry-core.ts; mechanism identical, attributes
+ * namespaced to data-dsh-nova-* for coexistence, AGENTS.md D3).
+ *
+ * dsh's sidebar shell exposes no slot an external plugin can register into,
+ * so the entry row is injected between the shell's New Session button and the
+ * workspace browser. The injection self-heals: a MutationObserver watches the
+ * sidebar root and re-inserts the row whenever a React re-render displaces it
+ * (re-insertion happens in the same frame, before paint, so no flicker).
+ *
+ * The row is plain DOM (no React tree) so it can never disturb the shell's
+ * reconciliation; the view it toggles is a separate root owned by the caller.
+ */
+/** Per-package configuration for one sidebar entry row. */
+export interface NovaSidebarEntryOptions {
+    /** Full attribute name identifying the injected row (idempotency key). */
+    rowAttribute: string;
+    /** CSS selector matching the injected row. */
+    rowSelector: string;
+    /** L2 semantic-attribute plugin id (data-dsh-plugin value). */
+    plugin?: string;
+    /** Inline icon markup (matches the shell's 16px nav-icon look). */
+    icon: string;
+    /** CSS module class names for the row and its two spans (entry / entryIcon / entryLabel). */
+    css: Record<string, string>;
+    /** Localized row label (aria-label + visible text). */
+    label(): string;
+    /** Optional localized tooltip (title attribute). */
+    tooltip?(): string;
+    /** Click action (open/toggle the owning panel). */
+    onToggle(): void;
+    /** Family-block position: 'before' inserts ahead of sibling plugin rows, 'after' behind them. */
+    position: 'before' | 'after';
+    /** Selectors of the sibling plugin entry rows this package orders against (its own row included). */
+    familySelectors: readonly string[];
+    /** Optional active-state bridge; highlights the row while the panel is open. */
+    active?: {
+        subscribe(listener: () => void): () => void;
+        isOpen(): boolean;
+    };
+    /** Optional numeric badge (T011 §12.7 未确认候选数角标); hidden at 0. */
+    badge?: {
+        subscribe(listener: () => void): () => void;
+        count(): number;
+    };
+}
+/**
+ * Mount the sidebar entry, waiting for the shell to render and self-healing
+ * on later React re-renders.
+ * @param options - the row's attribute/icon/copy/action/ordering configuration.
+ * @returns disposer removing the entry and its observers.
+ */
+export declare function mountSidebarEntry(options: NovaSidebarEntryOptions): () => void;

package/lib/types/client/sidebar-entry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Sidebar entry injection — package-specific wiring over the shared core.
+ *
+ * The entry row is injected between the shell's New Session button and the
+ * workspace browser (data-dsh-nova-taskboard-entry, nova- 前缀与参考实现
+ * data-dsh-taskboard-entry 区分，见 AGENTS.md D3）。The row is plain DOM (no
+ * React tree); the board view it toggles is a separate React root mounted in
+ * the center column (see board-mount.tsx).
+ */
+import type { BoardController } from './board-controller.ts';
+/** Stable data attribute identifying the injected entry row. */
+export declare const ENTRY_SELECTOR = "[data-dsh-nova-taskboard-entry]";
+/**
+ * Mount the sidebar entry, waiting for the shell to render and self-healing
+ * on later React re-renders.
+ * @param controller - the board controller the entry toggles.
+ * @returns disposer removing the entry and its observers.
+ */
+export declare function mountSidebarEntry(controller: BoardController): () => void;