@william2000/dsh-nova-ui-task-board 0.3.0 → 0.3.1

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

@@ -1,78 +1,26 @@
-/**
- * 看板拖拽纯函数（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

@@ -1,16 +1,4 @@
-/**
- * 看板过滤纯函数（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';
 } | {
@@ -19,24 +7,14 @@ export type ProjectFilterValue = {
     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

@@ -1,54 +1,15 @@
-/**
- * 看板列内分组/排序纯函数（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

@@ -1,58 +1,20 @@
-/**
- * 浏览器 ↔ 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;
-/**
- * Host 业务拒绝（HTTP 4xx，§11.1）：与传输层错误区分——业务拒绝由操作修正，
- * 重试无意义；错误条据此**不显示「重试连接 Host」**，只对传输失败（网络/
- * 超时/解析）保留重试入口（board-controller 按 instanceof 判定 retryable）。
- */
 export declare class TaskBoardRequestError extends Error {
     readonly status: number;
     constructor(message: string, status: number);
 }
-/** 浏览器存储的读写面（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);
@@ -60,12 +22,6 @@ export declare class HttpTaskBoardHostTransport implements TaskBoardHostTranspor
     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

@@ -3,19 +3,10 @@ import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
 import { type NovaPluginsKey, type NovaTaskBoardKey } from './locales.ts';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {
-        /** Nova task-board surface copy. */
         'nova-task-board': NovaTaskBoardKey;
-        /** Locale copy of the "Nova 插件" settings section heading/lede. */
         'nova-plugins': NovaPluginsKey;
     }
     interface SlotMap {
-        /**
-         * The child slot the "Nova 插件" section declares. The dsh-nova-ui family
-         * plugins contribute their configuration cards here — NOT into the
-         * reference `web-ui.plugin.item` child of the "Web UI 插件" group, which
-         * `@linxin666/dsh-web-ui` owns (AGENTS.md D4). Spelled here with the same
-         * shape so this package can register without depending on the group plugin.
-         */
         'nova.plugin.item': {
             kind: 'list';
             scope: 'root';
@@ -23,27 +14,15 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
         };
     }
 }
-/** Owner share of a plugin card (the section supplies nothing). */
 export interface NovaPluginItemOwnerProps {
-    /** 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

@@ -1,28 +1,6 @@
-/**
- * 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

@@ -1,13 +1,3 @@
-/**
- * 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;
@@ -200,25 +190,13 @@ export declare const zh: {
     '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;
-/**
- * Locale dictionary for the "Nova 插件" settings section (the first-level nav
- * entry that hosts the dsh-nova-ui family plugin cards). Kept as its own
- * namespace (`nova-plugins`) so the section copy never collides with the
- * task-board card's `nova-task-board` namespace (AGENTS.md D4). Key set 以 zh 为准。
- */
 export declare const groupZh: {
     title: string;
     description: string;
 };
-/** en dictionary, complete against the groupZh key set. */
 export declare const groupEn: Record<keyof typeof groupZh, string>;
-/** The "Nova 插件" section dictionary key union. */
 export type NovaPluginsKey = keyof typeof groupZh;

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

@@ -1,20 +1,11 @@
-/**
- * 定时编辑器共享预设（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

@@ -1,54 +1,21 @@
-/**
- * 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

@@ -1,19 +1,3 @@
-/**
- * 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;

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

@@ -1,58 +1,19 @@
-/**
- * 上下文闭环与自动收集的纯函数（DSH-REQ-001 §14.3/§9.5，T010/P3）。
- *
- * 本模块只做「无副作用」的转换与判定，全部可脱离宿主单测：
- * - **清洗（§14.3 安全红线）**：`sanitizeCollectedText` 剥离控制字符、封顶长度；
- *   自动收集/评论内容一律先清洗再落账；
- * - **人工审核闸门（§14.3）**：`isAutoCollected` 判定自动收集来源
- *   （github_issue / bookmark_collector）；未 promote（仍在 backlog）前不可
- *   执行/不可定时（守卫落在 transitions 层，见 canRunTask / set-schedule /
- *   set-one-shot）；
- * - **收集映射**：GitHub Issue / 书签条目 → 标准化的 backlog `TaskRecord`
- *   （source/metadata 写入，供去重与追溯）；`collectorDedupKey`/`hasCollected`
- *   提供按 (source, metadata.url) 的幂等去重；
- * - **上下文注入（§14.3/§9.5，B5 调研落定）**：`composeInjectionContext` 只带
- *   摘要 + 必要片段（goal/lastAiSummary/latestUserFeedback/relatedLinks），
- *   `CONTEXT_INJECTION_BUDGET` 给出逐字段与总量 token 预算；`composePrompt`
- *   在有快照的任务 Prompt 尾部追加注入块——后续调用只使用摘要与必要片段，
- *   不再把全量历史/描述灌给 agent。
- *
- * 收集器的 I/O（GitHub API 拉取、书签文件读取）与账本落账在 host-automation.ts
- * / host-service.ts，本层只产出数据。
- */
 import type { AutomationRule, TaskRecord, TaskSource } from './model.ts';
-/** 自动收集来源（§14.3：只进 backlog，必须人工 promote 才可执行）。 */
 export declare const AUTO_COLLECTED_SOURCES: readonly TaskSource[];
-/** 是否自动收集来源（人工审核闸门的判据之一）。 */
 export declare function isAutoCollected(task: Pick<TaskRecord, 'source'>): boolean;
-/**
- * 清洗文本（§14.3）：剥离控制字符（保留 \n \t）、trim、长度封顶。
- * 用于自动收集的标题/描述、评论正文等一切外部输入。
- */
 export declare function sanitizeCollectedText(text: unknown, maxLength?: number): string;
-/** 收集去重键（§14.1/14.2）：同来源同 URL 视为同一条外部内容。 */
 export declare function collectorDedupKey(source: TaskSource, metadata: Record<string, string> | undefined): string | undefined;
-/** 账本中是否已存在同 (source, url) 的收集任务（去重判定，Host 落账前调用）。 */
 export declare function hasCollected(tasks: readonly TaskRecord[], source: TaskSource, metadata: Record<string, string> | undefined): boolean;
-/** GitHub 标签命中判定（§14.1 过滤器）：规则标签非空时，Issue 至少命中一个（大小写不敏感）。 */
 export declare function matchesGithubLabels(issueLabels: readonly string[] | undefined, ruleLabels: readonly string[]): boolean;
-/** 从 Issue 载荷/API 响应的 labels 提取标签名数组（string 或 {name} 两种形态）。 */
 export declare function issueLabelNames(issue: GithubIssueLike): string[];
-/** 收集任务的最小输入面（title/description 已清洗，metadata 已归置）。 */
 export interface CollectedTaskInput {
     title: string;
     description: string;
     source: TaskSource;
     metadata: Record<string, string>;
 }
-/**
- * 由收集输入构造一条标准的 backlog 任务（§14.3：只进 backlog；prompt 回退用
- * 标题——promote 到 todo 后执行即以标题为 Prompt；tags 默认 [] 待人工标注）。
- */
 export declare function newCollectedTask(input: CollectedTaskInput, id: string, now: number, order: number): TaskRecord;
-/** GitHub Issue 的最小结构面（webhook 载荷 / API 响应的共同子集）。 */
 export interface GithubIssueLike {
-    /** Issue 编号（webhook 恒有；API 恒有）。 */
     number?: number;
     title?: string;
     html_url?: string;
@@ -61,7 +22,6 @@ export interface GithubIssueLike {
         name?: string;
     } | string>;
 }
-/** GitHub webhook `issues` 事件载荷的最小结构面（§14.1）。 */
 export interface GithubWebhookIssuePayload {
     action?: string;
     issue?: GithubIssueLike;
@@ -69,60 +29,26 @@ export interface GithubWebhookIssuePayload {
         full_name?: string;
     };
 }
-/**
- * 严格解析 GitHub webhook `issues` 事件载荷（§14.1）：只消费已知字段、未知
- * 字段剥离（载荷为外部输入，永不被解释为任务字段）；结构非法返回 undefined。
- * 收集内容（标题/正文）在映射时经 sanitizeCollectedText 清洗（§14.3）。
- */
 export declare function parseGithubWebhookPayload(value: unknown): GithubWebhookIssuePayload | undefined;
-/**
- * GitHub Issue → 收集任务输入（§14.1）：标题/描述清洗、来源链接等写入
- * metadata（url/externalId/repo/labels），供去重与追溯。
- */
 export declare function githubIssueToCollectedTaskInput(issue: GithubIssueLike, repo: string | undefined): CollectedTaskInput;
-/** 书签收件箱条目（§14.2：JSONL 一行一条；浏览器书签导出/手动维护均可）。 */
 export interface BookmarkEntry {
     title?: string;
     url?: string;
     note?: string;
 }
-/** 书签条目 → 收集任务输入（§14.2）：URL 缺失丢弃；标题回退用 URL。 */
 export declare function bookmarkEntryToCollectedTaskInput(entry: BookmarkEntry): CollectedTaskInput | undefined;
-/** 解析书签收件箱文件（JSONL：每行一个 JSON 对象；空行/非法行跳过）。 */
 export declare function parseBookmarkEntries(content: string): BookmarkEntry[];
-/**
- * 注入 token 预算（B5 调研结论：Host 侧摘取 + 固定预算，避免把全量上下文灌给
- * agent）。逐字段上限 + 注入块总量上限（约 400 token，中文按 0.6 token/字）。
- */
 export declare const CONTEXT_INJECTION_BUDGET: {
-    /** goal 上限（字符）。 */
     readonly goalMax: 200;
-    /** lastAiSummary 上限（字符）。 */
     readonly summaryMax: 600;
-    /** latestUserFeedback 上限（字符）。 */
     readonly feedbackMax: 300;
-    /** relatedLinks 合计上限（字符）。 */
     readonly linksMax: 400;
-    /** 注入块总量上限（字符）。 */
     readonly totalMax: 1500;
 };
-/** 任务最近一条 user_feedback 评论的正文（供快照 latestUserFeedback）。 */
 export declare function latestUserFeedback(task: TaskRecord): string | undefined;
-/** 截断文本到上限（中文友好：按字符计）。 */
 export declare function truncateText(text: string, max: number): string;
-/**
- * 组合注入块（B5）：只带摘要与必要片段——goal / lastAiSummary /
- * latestUserFeedback / relatedLinks，逐字段按预算截断，总量再封顶。
- * 快照不存在或无可注入内容时返回 undefined（不追加注入）。
- */
 export declare function composeInjectionContext(task: TaskRecord): string | undefined;
-/**
- * 执行 Prompt 合成（B5 落定，runner.launch 使用）：基线为任务 Prompt（空则
- * 回退标题）；任务有上下文快照时在尾部追加注入块——后续调用只使用摘要与
- * 必要片段。无快照的任务行为与 T005 完全一致（不影响既有执行语义）。
- */
 export declare function composePrompt(task: TaskRecord): string;
-/** 快照字段可注入子集（service 结算时由 Host 合成更新，见 host-service.ts）。 */
 export interface ContextSnapshotPatch {
     goal?: string;
     keyDecisions?: string[];
@@ -131,9 +57,6 @@ export interface ContextSnapshotPatch {
     latestUserFeedback?: string;
     relatedLinks?: string[];
 }
-/** 从快照补丁构造 Host 侧结算后快照更新（B5：只覆盖可注入字段）。 */
 export declare function contextPatchFromSettle(task: TaskRecord, lastAiSummary: string | undefined): ContextSnapshotPatch;
-/** 上下文快照的数组字段归一化（跨模块共用：去空、去重、封顶）。 */
 export declare function normalizeSnapshotList(value: readonly string[] | undefined): string[];
-/** 从 AutomationRule 读取收集来源配置（带默认值）。 */
 export declare function ruleConfig(rule: AutomationRule, key: string, fallback?: string): string | undefined;