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

package/lib/types/index.d.ts

@@ -1,90 +1,29 @@
-/**
- * Host loader entry for the dsh-nova-ui-task-board plugin.
- *
- * T001 脚手架：插件配置项、设置命名空间（nova-task-board）、agent 播报；
- * T003 起加载协议控制面：Host 权威账本（T002 HostLedger）+ 状态机 +
- * `/api/nova-task-board/{state,action,events}` 三端点（安全栅栏 + 幂等）；
- * T005 接入真实执行：HostExecutionRunner 经 `ctx.apiProxy` 创建独立 DSH 会话
- * （钉住工作区/agent 预设，权限经宿主 commands 注册表的 `/permission` 命令
- * 应用），5s 轮询结算；调度（T006/T007）后续接入同一账本。
- *
- * 命名空间取 `nova-task-board` 而非参考实现的 `task-board`：参考实现
- * @linxin666/dsh-client-ui-task-board 已在本机同一宿主注册 `task-board`
- * 命名空间（dsh-settings 对重复注册直接 throw，插件加载失败），本项目与
- * 其共存（AGENTS.md D2/D3），因此所有宿主侧标识均带 nova- 前缀；API 前缀
- * 同理取 `/api/nova-task-board`（参考实现已占用 `/api/task-board`）。
- */
 import type { Context } from '@deepseek-ai/cordis';
 import z from 'schemastery';
-/** Default environment variable holding the authenticated proxy token. */
 export declare const DEFAULT_PROXY_TOKEN_ENV = "DSH_TASK_BOARD_PROXY_TOKEN";
-/** Default environment variable holding the GitHub Webhook HMAC secret. */
 export declare const DEFAULT_GITHUB_WEBHOOK_SECRET_ENV = "DSH_TASK_BOARD_GITHUB_WEBHOOK_SECRET";
-/** Default environment variable holding the GitHub API token (issue polling). */
 export declare const DEFAULT_GITHUB_TOKEN_ENV = "DSH_TASK_BOARD_GITHUB_TOKEN";
-/** Required services (the announcement section needs the system-prompt seam; the control plane registers on the webServer; execution uses the apiProxy + agent/command registries). */
 export declare const inject: readonly ["systemPrompt", "webServer", "apiProxy", "agents", "commands"];
-/**
- * Settings namespace of the board — the section the web settings surface
- * edits. Spelled here rather than imported: the browser half spells the same
- * value and must not depend on a Host package.
- */
 export declare const NOVA_TASK_BOARD_SETTINGS_NAMESPACE: import("@deepseek-ai/dsh-settings").SettingsNamespace;
-/** Model-facing announcement: plugin presence, capabilities, and limits. */
 export declare const TASK_BOARD_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-nova-ui-task-board \u63D2\u4EF6\uFF08DSH Web GUI \u7684 Nova \u4EFB\u52A1\u770B\u677F\uFF0C\u533A\u522B\u4E8E\u53C2\u8003\u5B9E\u73B0\u300C\u4EFB\u52A1\u770B\u677F\u300D\uFF09\uFF1A\u4FA7\u8FB9\u680F\u300CNova \u4EFB\u52A1\u770B\u677F\u300D\u5165\u53E3\u3002\u80FD\u529B\uFF1A\u591A\u5217\u770B\u677F\u7BA1\u7406\u4EFB\u52A1\uFF1BHost \u6743\u5A01\u8D26\u672C\uFF1B\u5173\u95ED\u6D4F\u89C8\u5668\u540E\u4ECD\u7531 Host \u6267\u884C\u548C\u7ED3\u7B97\uFF1B\u4EFB\u52A1\u53EF\u9489\u4F4F\u5DE5\u4F5C\u533A\u3001agent \u9884\u8BBE\u548C\u6743\u9650\uFF1B\u652F\u6301 Host \u672C\u5730\u65F6\u533A\u7684 5 \u6BB5 cron\uFF0C\u9519\u8FC7\u7684\u89E6\u53D1\u70B9\u4E0D\u8865\u8DD1\uFF1B\u53EF\u9009\u4E14\u9ED8\u8BA4\u5173\u95ED\u7684\u7A7A\u95F2\u7CFB\u7EDF\u7761\u7720\u4FDD\u62A4\u3002\u5BF9\u8BDD\u5019\u9009\u4EFB\u52A1\u6D41\u8F6C\uFF08P3.1\uFF09\uFF1A\u7528\u6237\u8981\u6C42\u300C\u505A\u67D0\u4E8B\u300D\u300C\u8BB0\u4E0B\u6765\u300D\u300C\u540E\u7EED\u8981\u5904\u7406\u300D\u7B49\u660E\u786E\u4EFB\u52A1\u610F\u56FE\u65F6\uFF0C\u5728\u56DE\u590D\u672B\u5C3E\u8F93\u51FA\u4E00\u884C\u7ED3\u6784\u5316\u5019\u9009\u6807\u8BB0 `\u27E6task-board:propose\u27E7 \u6807\u9898 | \u63CF\u8FF0 | prompt`\uFF08\u63CF\u8FF0\u53EF\u4E3A\u7A7A\uFF0Cprompt \u4E3A\u6267\u884C\u65F6\u53D1\u9001\u7ED9 agent \u7684\u5B8C\u6574\u6307\u4EE4\u3001\u53EF\u7701\u7565\uFF09\uFF0C\u524D\u7AEF\u89E3\u6790\u540E\u8FDB\u5165\u770B\u677F\u300C\u5F85\u786E\u8BA4\u300D\u5217\uFF0C\u7ECF\u7528\u6237\u786E\u8BA4\u540E\u65B9\u53EF\u6267\u884C\u3002\u7528\u6237\u63D0\u5230\u300C\u4EFB\u52A1\u770B\u677F / Nova \u4EFB\u52A1\u770B\u677F / \u770B\u677F / \u5B9A\u65F6\u4EFB\u52A1 / \u5019\u9009\u4EFB\u52A1\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\uFF08\u82E5\u540C\u65F6\u88C5\u6709\u53C2\u8003\u5B9E\u73B0\u300C\u4EFB\u52A1\u770B\u677F\u300D\uFF0C\u8BF7\u4F18\u5148\u4F7F\u7528\u672C\u63D2\u4EF6\u7684\u300CNova \u4EFB\u52A1\u770B\u677F\u300D\uFF09\uFF0C\u8BF7\u636E\u6B64\u534F\u4F5C\u3002";
-/** Plugin config, validated by the same-named schemastery schema. */
 export interface Config {
-    /**
-     * When true (default), a system-prompt section announces the board to every
-     * agent. Set false to keep the board silent in prompts; agents then learn
-     * about it only when the user mentions it.
-     */
     announceToAgent?: boolean;
-    /** Master switch for the plugin (browser half + host announcement). */
     enabled?: boolean;
-    /** Prevent idle system sleep while sessions run or schedules are armed. */
     preventIdleSleep?: boolean;
-    /** Canonical reverse-proxy Host authorities admitted with a server-side token. */
     trustedProxyHosts?: string[];
-    /** Environment variable whose value the authenticated proxy injects upstream. */
     proxyTokenEnv?: string;
-    /**
-     * Environment variable holding the GitHub Webhook HMAC secret
-     * (`DSH_TASK_BOARD_GITHUB_WEBHOOK_SECRET`); when unset the webhook endpoint
-     * answers 503 (T010 §14.1).
-     */
     githubWebhookSecretEnv?: string;
-    /**
-     * Environment variable holding the GitHub API token used by the issue
-     * polling collector (`DSH_TASK_BOARD_GITHUB_TOKEN`); when unset the poller
-     * runs anonymously (rate-limited).
-     */
     githubTokenEnv?: string;
 }
 export declare const Config: z<Config>;
-/** Resolve proxy access without ever placing the token value in plugin config. */
 export declare function resolveProxyAccess(config: Config | undefined, env?: NodeJS.ProcessEnv): {
     trustedProxyHosts: string[];
     proxyToken?: string;
 };
-/**
- * Resolve T010 automation secrets from environment variables (never placed in
- * plugin config or the ledger). Empty/absent env values resolve to undefined:
- * - webhookSecret 缺省 → GitHub Webhook 端点 503（未配置）；
- * - githubToken 缺省 → Issue 轮询走匿名（GitHub 限速）。
- */
 export declare function resolveAutomationSecrets(config: Config | undefined, env?: NodeJS.ProcessEnv): {
     webhookSecret?: string;
     githubToken?: string;
 };
-/**
- * Register the board's announcement section, gated on the composition entry's
- * `announceToAgent` (and the live settings value once the web settings
- * surface is served). The section is re-registered whenever the source
- * changes, so a settings edit takes effect without a restart.
- * @param ctx - the plugin context (systemPrompt injected).
- * @param config - resolved plugin config (schema defaults applied by the loader).
- */
 export declare const apply: typeof applyImpl;
 declare function applyImpl(ctx: Context, config?: Config): void;
 export {};

package/lib/types/loopback.d.ts

@@ -1,23 +1,5 @@
-/**
- * 回环信任栅栏（DSH-REQ-001 §16.1）：socket 地址、Host 头、浏览器同源标记。
- *
- * 语义（对齐参考实现的共享 loopback 模块，本插件自持一份）：
- * - RFC 5735 IPv4 127/8、`::1`、IPv4-mapped `::ffff:127/8` 视为回环地址；
- * - `localhost` / `[::1]` / 127/8 主机名视为回环 authority；
- * - 请求级信任 = 回环 socket 地址 AND 回环 Host 头 AND 浏览器同源标记
- *   （`sec-fetch-site` 与 `Origin`）；socket 地址为权威依据，
- *   `X-Forwarded-For` 永不信任。
- */
 import type { IncomingMessage } from 'node:http';
-/** IPv4 127/8 谓词（四个十进制八位组、首段 == 127）。 */
 export declare function isIPv4Loopback(v4: string): boolean;
-/** socket 远端地址是否属于回环范围（127/8、::1、IPv4-mapped）。 */
 export declare function isLoopbackAddress(address: string | undefined): boolean;
-/** 归一化 URL 主机名是否为回环 authority（localhost、[::1]、127/8）。 */
 export declare function isLoopbackHostname(hostname: string): boolean;
-/**
- * 请求级信任栅栏：回环 socket 地址 AND 回环 Host 头，加上浏览器同源标记。
- * socket 地址权威；`X-Forwarded-For` 永不信任。Origin 缺省时仅接受
- * `sec-fetch-site: same-origin` 的显式标记。
- */
 export declare function isLoopbackRequest(request: IncomingMessage): boolean;

package/lib/types/mount-once.d.ts

@@ -1,9 +1 @@
-/**
- * Wrap a cordis plugin apply so the package runs at most once per process.
- * The first mount registers normally and unmarks when its fiber disposes;
- * any later mount of the same package name is a no-op.
- * @param packageName - npm package identity shared by every install source.
- * @param fn - the original plugin apply.
- * @returns an apply of the same shape.
- */
 export declare function mountOnce<T extends (...args: any[]) => unknown>(packageName: string, fn: T): T;

package/lib/types/protocol.d.ts

@@ -1,86 +1,30 @@
-/**
- * 协议层（DSH-REQ-001 §11）：严格版本化 Action 判别联合、全量快照与 SSE 事件
- * 帧类型、幂等信封解析。T003 交付协议基线：
- *
- * - 端点前缀 `/api/nova-task-board`（AGENTS.md D2：参考实现已占用
- *   `/api/task-board`，本插件必须使用 nova- 前缀）；
- * - Action 判别联合基线：`import / create / update / delete / move / archive /
- *   restore`；T005 扩展 `run / rerun`（真实执行，§13.2）；T006 扩展
- *   `set-schedule`（cron 周期定时，§9.4/§11.2：enabled/cron patch，nextRunAt/
- *   lastTriggeredAt 浏览器不可写）；T007 扩展 `set-one-shot`（一次性计划，
- *   §11.2：runAt 缺省或 0 = 取消，与 set-schedule 互斥 D6）；T008 扩展
- *   `create.input`/`update.patch` 支持 project/tags（§9.2/§12.8）；T009 扩展
- *   `reorder`（列内排序/分组落位，§11.2：status 须与当前状态一致、order 有限
- *   数字、可携带 project/tags 归属变更）与 `move.order`（跨列拖拽落位，缺省
- *   追加目标列末尾）；T011 扩展 `propose`（对话提取/手动转任务 → proposed
- *   候选，§11.2/§14.4：输入沿用 NewTaskInput 校验 + sourceConversationId/
- *   sourceMessageId 来源引用，命令类字段递归拒绝 §16.7）、`confirm`（确认候选
- *   → 落 backlog/todo，确认是唯一 promote 路径）、`dismiss`（拒绝/忽略删除）；
- *   T012 扩展 `propose-batch`（批量候选，§11.2/§14.5：items 逐条沿用 propose
- *   校验 + parentId 引用校验，整批原子落账、单 revision、幂等指纹按整批计算、
- *   载荷上限对齐 import 2 MiB）与 `start-split`（需求拆分驱动，§11.2/§12.9/
- *   §14.5：提交需求文本/文件路径，Host 启动独立拆分会话并在结算时落账）；
- * - 严格校验：exact keys、类型、枚举、cron 合法性、有限时间戳；未知字段/未知
- *   action 一律拒绝；import 载荷递归拒绝 `args/command/executable/powershell/
- *   shell` 字段（防注入，§16.2/§19-9）；
- * - 幂等（§11.3）：requestId + SHA-256 action 指纹，缓存判定复用 T002
- *   HostLedger 的持久化 recentRequests（本层负责信封解析，指纹由账本层计算）。
- *
- * T010 扩展（§9.5/§11.2/§14，P3 自动化与闭环）：
- * - `add-comment`（评论，author/body/type）、`add-artifact`（产物，
- *   type/title/url/contentRef）、`update-context`（上下文快照部分补丁，空串/
- *   空数组 = 清除，updatedAt 浏览器不可写）；
- * - `upsert-automation`（自动化规则创建/替换；nextRunAt/lastTriggeredAt 为
- *   Host 独占字段，浏览器不可写）、`delete-automation`、`run-automation`
- *   （手动触发一次收集）；
- * - snapshot 新增 `automationRules`（§9.5 automation_rules 集合）。
- *
- * 分层说明：import 的任务行做「字段级严格校验 + 未知字段剥离」——v1 迁移数据
- * 可能携带 `priority` 等历史字段（§9.5 列入 P4 metadata），整行拒绝会阻断迁移，
- * 但命令类字段（禁止集）与类型/枚举/时间戳错误整行拒绝；envelope/action 层则
- * 是 exact-keys 严格拒绝。
- */
 import type { AutomationRule, ArtifactType, BatchProposeItem, CommentType, NewTaskInput, ProposeTaskInput, SchedulerSnapshot, SplitRequestInput, TaskRecord, TaskStatus, TaskUpdatePatch } from './core/model.ts';
 import { LEDGER_SCHEMA_VERSION } from './core/model.ts';
 import type { AutomationRuleInput, ContextSnapshotPatch } from './core/transitions.ts';
-/** 本项目 API 前缀（AGENTS.md D2，2026-08-22 定值；参考实现占用 /api/task-board）。 */
 export declare const TASK_BOARD_API_PREFIX = "/api/nova-task-board";
-/** 电源保护阶段（§11.1 snapshot 的 power 字段；保护实现随后续任务，本期仅类型+基础值）。 */
 export type PowerPhase = 'disabled' | 'idle' | 'acquiring' | 'active' | 'error' | 'unsupported';
-/** 电源保护对外快照（对齐参考实现形状，保证 T004 UI 的类型契约稳定）。 */
 export interface TaskBoardPowerSnapshot {
-    /** 宿主平台。 */
     platform: string;
-    /** 电源保护阶段。 */
     phase: PowerPhase;
-    /** 保护是否启用（enabled 配置 + 平台支持）。 */
     enabled: boolean;
-    /** 正在运行的执行数。 */
     runningSessions: number;
-    /** 已武装的计划数。 */
     armedSchedules: number;
-    /** 会话状态是否已知（T005 起由 5s 会话轮询驱动；轮询失败降级 false）。 */
     sessionStateKnown: boolean;
-    /** 最近可见错误。 */
     lastError?: string;
 }
-/** 全量状态快照（§11.1 `GET /state`）。 */
 export interface TaskBoardSnapshot {
     schemaVersion: typeof LEDGER_SCHEMA_VERSION;
     revision: number;
     tasks: TaskRecord[];
     scheduler: SchedulerSnapshot;
     power: TaskBoardPowerSnapshot;
-    /** 自动化收集规则（T010，§9.5 automation_rules）。 */
     automationRules: AutomationRule[];
 }
-/** SSE 事件帧（§11.1 `GET /events`）：只推 revision/scheduler/power，绝不携带任务列表。 */
 export interface TaskBoardEventPayload {
     revision: number;
     scheduler: SchedulerSnapshot;
     power: TaskBoardPowerSnapshot;
 }
-/** Action 判别联合（§11.2 基线 + T005 执行扩展 + T006 定时扩展 + T009 排序/拖拽扩展 + T011 候选流转扩展）。 */
 export type TaskBoardAction = {
     kind: 'import';
     sourceId: string;
@@ -187,28 +131,9 @@ export type TaskBoardAction = {
     kind: 'run-automation';
     ruleId: string;
 };
-/** 幂等 action 信封（§11.3）：requestId 浏览器 uuid。 */
 export interface TaskBoardActionEnvelope {
     requestId: string;
     action: TaskBoardAction;
 }
-/**
- * 载荷是否含命令类字段（§16.2/§19-9）：对键名递归检查
- * `args/command/executable/powershell/shell`（大小写不敏感）。import 与
- * GitHub Webhook 外部载荷共用（T010 §14.3：自动收集内容不携带命令结构）。
- */
 export declare function hasForbiddenCommandFields(value: unknown): boolean;
-/**
- * 解析幂等 action 信封（§11.2/§11.3）。任何结构/类型/枚举/时间戳/cron/未知
- * 字段/未知 action 问题 → undefined（路由层 400 invalid-action）。返回的 action
- * 为规范化对象（import 任务行经严格校验与字段剥离）。
- *
- * T009（§11.2/D10）：
- * - `reorder`：`order` 必填有限数字（浏览器提交的落位下标，0-based；Host 重算
- *   同列唯一，不信任浏览器序号——见 transitions.applyReorderTask）；`status` 须
- *   为合法状态且与任务当前状态一致（防竞态，状态机层校验）；`project` 可选字符串
- *   （空串 = 清除归属，沿用 update 语义）；`tags` 可选字符串数组（整体替换，
- *   沿用 update 的 normalizeTags 语义）。
- * - `move`：新增可选 `order`（有限数字 = 目标列落位下标，缺省追加目标列末尾）。
- */
 export declare function parseActionEnvelope(value: unknown): TaskBoardActionEnvelope | undefined;

package/package.json

@@ -1,7 +1,16 @@
 {
   "name": "@william2000/dsh-nova-ui-task-board",
-  "description": "Host-authoritative task board for the DSH Web GUI with real session execution, Host cron/one-shot scheduling, sorting/grouping/drag-drop, tag & project filtering; mounted without DSH source changes. Nova 系列核心功能包（任务看板插件本体：Host 服务 + 浏览器 UI）。",
-  "version": "0.2.1",
+  "description": "Task board plugin for the DeepSeek Harness (DSH) Web GUI: real session execution, cron & one-shot scheduling, tags & projects, drag-and-drop, and conversation task capture.",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "nova-ui",
+    "task-board",
+    "taskboard",
+    "kanban",
+    "plugin"
+  ],
+  "version": "0.3.1",
   "type": "module",
   "engines": {
     "node": ">=20"
@@ -17,7 +26,6 @@
       "types": "./lib/types/client/index.d.ts",
       "default": "./lib/client.js"
     },
-    "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
   "dsh": {
@@ -70,7 +78,7 @@
     "vitest": "^3.0.0"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && tsdown",
+    "build": "rm -rf lib && tsc -p tsconfig.build.json && tsdown",
     "bundle": "tsdown",
     "watch": "tsdown --watch",
     "typecheck": "tsc --noEmit",
@@ -78,9 +86,12 @@
     "test:watch": "vitest"
   },
   "license": "Apache-2.0",
+  "author": "william2000",
+  "homepage": "https://gitee.com/xyoc/dsh-nova-ui",
   "files": [
     "lib",
-    "cordis.patch.yml"
+    "cordis.patch.yml",
+    "!lib/*.map"
   ],
   "repository": {
     "type": "git",