@dp-bohrium/widget-cli 0.4.0 → 0.5.1

package/llms.txt

@@ -2,8 +2,8 @@
 
 > Widget 工程的本地创建、迁移、校验、开发、构建和打包工具；可由 Bohr CLI 桥接或调度。
 
-要求 Node.js >=20。CLI 发布包固定 SDK/compiler、contracts/Schema、校验器和模板，
-提供文档站地址，不再内置 skills。生成工程仍安装自己的精确版本依赖。
+要求 Node.js >=20；默认生成工程构建器要求 `^22.18.0 || >=24.11.0`。
+生成工程精确依赖 SDK 与构建器，类型、Schema 和工程命令均由 SDK 提供。
 
 先看全局帮助，再按命令查看参数、默认值、示例和必要提示：
 
@@ -19,14 +19,15 @@ pnpm exec bohr-widget --version --json
 `<命令路径> --help` 与 `help <命令路径>` 查看对应层级；例如 `dev -h`、`pack --help` 或
 `migrate dsh --help`。`-v` / `--version` 等价于 `version`，`--version --json` 等价于 `version --json`。
 帮助仅输出本地文本，不执行所选命令或联网获取文档。npm 的全局帮助用
-`npx --no-install bohr-widget --help`，其他命令同样替换前缀；未安装时可用
-新工程优先用 `pnpm dlx @dp-bohrium/widget-sdk --help`；本包入口在兼容期保持可用。
+`npx --no-install bohr-widget --help`，其他命令同样替换前缀。
+创建新工程可使用 `pnpm dlx @dp-bohrium/widget-sdk --help`；工具集成可使用
+`pnpm dlx @dp-bohrium/widget-cli --help`，并核对实际执行包的身份、版本与 SDK profile。
 
 ## Agent 入口
 
 - [Agent 使用说明](./AGENTS.md): 命令参数、执行顺序、错误恢复和安全边界。
 - [README](./README.md): 安装、模板和公开 core 出口。
-- [更新记录](./CHANGELOG.md): 当前 CLI 的使用者可感知变化；配套包职责与 npm 链接见 README。
+- [更新记录](./CHANGELOG.md): 版本与更新记录。
 - [文档站索引](https://dev.dp.tech/bohrium-widget-sdk/llms.txt): 先按任务选择教程或参考。
 - [完整文档](https://dev.dp.tech/bohrium-widget-sdk/llms-full.txt): 文档站自动生成的全文。
 - 自闭环范围：本包负责本地工程闭环；上传、平台预览、版本发布和 Agent 绑定不在本包内执行。
@@ -37,12 +38,12 @@ pnpm exec bohr-widget --version --json
 
 ## 本地闭环
 
-- `integration --json`: `interfaceVersion=2`，返回固定 profile、执行器位置、
-  `toolchain.formatVersion=2` 和 `documentation { url, quickStart, cli, llms, llmsFull }`，
+- `integration --json`: `interfaceVersion=3`，返回固定 profile、执行器位置、
+  `toolchain.formatVersion=3` 和 `documentation { url, quickStart, cli, llms, llmsFull }`，
   不返回 `skills`。已有工程加 `--project <目录>` 核对锁定，再读取对应参考。
-- `create`: 创建 vanilla 或 React 工程并写 `widget-toolchain.json`；工作区文件面板使用
-  `--panel-id workspace-files`。
-- `adopt`: 为旧工程显式写入工具链锁，先核对精确依赖、实际 SDK/contracts、Manifest 和 samples。
+- `create`: 创建 vanilla 或 React 工程并写 `widget-toolchain.json`；Panel ID 可自定义，
+  `--panel-id workspace-files` 是可选的文件浏览面板预设。
+- `adopt`: 为旧工程显式写入工具链锁，先核对精确依赖、实际 SDK 与内置协议摘要、Manifest 和 samples。
 - SDK 0.5.0 的任务 Panel 在 Manifest 声明 `capabilities.tasks.list`；需要观察单个任务时再声明
   `tasks.watch`。列表刷新遵守 grant 的 `minPollMs`，面板不可见后停止轮询；CLI 校验通过不代表
   目标 Host 已签发 grant，详见 AGENTS.md。
@@ -53,10 +54,11 @@ pnpm exec bohr-widget --version --json
   当前工作目录为根，找不到工程时返回 `WIDGET_CLI_NO_WIDGET_PROJECT`，不会静默通过。
 - `dev`: 启动本地开发服务器和 Host Bridge 连接；每轮重建检查锁定信息和实际依赖，失败时保留上一轮。
 - `build`: 委托工程自己的构建命令，并拒绝“退出 0 但仍有未解析依赖”的结果，写入构建 receipt。
-- `pack`: 生成可交给平台的 ZIP，并输出 SHA-256 digest、Manifest 摘要和 CLI/SDK/Contracts 版本。
+- `pack`: 生成可交给平台的 ZIP，并输出 SHA-256 digest、Manifest 摘要、执行器身份与版本、
+  SDK profile 和协议标识。
   `--no-build` 要求 `.widget-build-receipt.json` 的工具链、实际依赖、输入和产物摘要全部匹配。
   执行摘要仅含 `compiler`、`validators`、`schemas`、`templates`；文档站正文更新不影响
-  receipt，也不要求 CLI 发版。
+  receipt。
 - `doctor`: 输出 Node、固定 profile 和工程状态；始终核对候选 profile 的精确依赖，已有锁定时再核对
   profile，`ready` 还要求锁定、依赖和入口。
 - `schema`: 输出插件 Manifest Schema 路径。
@@ -68,8 +70,8 @@ pnpm exec bohr-widget --version --json
 
 `--host-compat <文件>` 接受平台 statement 与调用方 observation。状态 `unknown` 表示无声明，
 `snapshot` 表示匹配的快照或过期声明，`confirmed` 表示调用方报告在线取得、仍有效且匹配当前
-profile；它不代表发布成功。无效声明或不匹配 profile 会报错。当前完成 A、B 本地能力，平台在线
-发现接口和 Bohr 获取声明仍需后续接入。
+profile；它不代表发布成功。无效声明或不匹配 profile 会报错。
+CLI 不自动获取线上声明，调用方需提供目标 Host 的兼容证据。
 
 ## 平台侧动作
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dp-bohrium/widget-cli",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Bohrium Widget 插件工程的创建、校验、开发和打包工具。",
   "license": "MIT",
   "type": "module",
@@ -24,47 +24,43 @@
       "import": "./dist/cli.mjs"
     },
     "./core": {
-      "types": "./src/core.d.mts",
+      "types": "./dist/core.d.mts",
       "import": "./dist/core.mjs"
     },
     "./development-host": {
-      "types": "./src/development-host.d.mts"
+      "types": "./dist/development-host.d.mts"
     },
     "./package.json": "./package.json"
   },
   "files": [
     "dist",
     "assets",
-    "src/core.d.mts",
-    "src/development-host.d.mts",
     "README.md",
     "AGENTS.md",
     "llms.txt",
     "CHANGELOG.md",
     "LICENSE"
   ],
-  "publishConfig": {
-    "access": "public"
-  },
   "devDependencies": {
     "@biomejs/biome": "^2.2.0",
     "@types/node": "^22.15.0",
     "tsdown": "0.22.14",
     "typescript": "5.9.3",
-    "@dp-bohrium/widget-contract-testing": "0.1.0-alpha.0",
-    "@dp-bohrium/widget-contracts": "0.6.0",
-    "@dp-bohrium/widget-sdk": "0.6.0"
+    "@dp-bohrium/widget-sdk": "0.8.0"
   },
   "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
-    "build:assets": "node scripts/build-assets.mjs",
-    "build:inputs": "pnpm --filter @dp-bohrium/widget-sdk... run build && pnpm --filter @dp-bohrium/widget-contract-testing run build",
-    "build": "pnpm build:inputs && pnpm build:assets && tsdown && node --check dist/cli.mjs",
-    "typecheck": "node --check src/cli.mjs && node --check src/help.mjs && node --check src/core.mjs && node --check src/templates.mjs && node --check src/toolchain.mjs && node --check src/project-executor.mjs && node --check scripts/build-assets.mjs",
-    "test": "pnpm build:inputs && pnpm build:assets && node --test test/*.test.mjs",
+    "package:contents": "node ../../scripts/quality/check-widget-cli-package-contents.mjs ../../.artifacts/dp-bohrium-widget-cli-*.tgz",
+    "build": "node ../../scripts/build/widget-build.mjs cli",
+    "typecheck": "node --check src/cli.mjs && node --check src/help.mjs && node --check src/core.mjs && node --check src/templates.mjs && node --check src/toolchain.mjs && node --check src/project-executor.mjs && node --check scripts/build-assets.mjs && tsc --project tsconfig.project.json",
+    "test": "node ../../scripts/build/with-build.mjs all -- node --test test/*.test.mjs test/project/*.test.mjs",
     "lint": "biome check src test scripts",
     "format:check": "biome check --linter-enabled=false src test scripts",
-    "package:contents": "node ../../scripts/quality/check-widget-cli-package-contents.mjs ../../.artifacts/dp-bohrium-widget-cli-*.tgz",
-    "check": "pnpm --filter @dp-bohrium/widget-contracts build && pnpm --filter @dp-bohrium/widget-contract-testing build && pnpm --filter widget-project build && pnpm typecheck && pnpm test && pnpm lint && pnpm format:check && pnpm build"
+    "check": "pnpm typecheck && pnpm test && pnpm lint && pnpm format:check && pnpm build",
+    "test:coverage": "node ../../scripts/build/with-build.mjs all -- node --experimental-test-coverage --test-coverage-include=src/project/*.mjs --test-coverage-lines=80 --test-coverage-functions=80 --test-coverage-branches=70 --test test/project/*.test.mjs",
+    "build:tools": "node ../../scripts/build/widget-build.mjs tools"
   }
 }

package/assets/licenses/widget-contracts.LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 DP Technology
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/src/core.d.mts

@@ -1,58 +0,0 @@
-export interface WidgetTemplateContext {
-  readonly name: string;
-  readonly ui?: "vanilla" | "react" | string;
-}
-
-export interface WidgetTemplate {
-  readonly id: string;
-  readonly description?: string;
-  manifest(context: WidgetTemplateContext): Record<string, unknown>;
-  sample(context: WidgetTemplateContext): Record<string, unknown>;
-  readonly source: string | ((context: WidgetTemplateContext) => string);
-}
-
-export interface WidgetTemplateRegistry {
-  register(template: WidgetTemplate): WidgetTemplate;
-  get(id: string): WidgetTemplate | undefined;
-  list(): readonly WidgetTemplate[];
-}
-
-export declare function defineWidgetTemplate(
-  template: WidgetTemplate,
-): WidgetTemplate;
-export declare function createWidgetTemplateRegistry(
-  initialTemplates?: readonly WidgetTemplate[],
-): WidgetTemplateRegistry;
-
-export declare function compileAuthorManifest(
-  manifest: Record<string, unknown>,
-  options?: Record<string, unknown>,
-): Record<string, unknown>;
-export declare function checkWidgetProject(
-  projectRoot: string,
-  options?: Record<string, unknown>,
-): Promise<Record<string, unknown>>;
-export declare function resolveWidgetProjects(input: string): readonly string[];
-export declare function auditDshPlugin(
-  input: string,
-): Promise<Record<string, unknown>>;
-export declare function scaffoldDshWidget(
-  input: string,
-  output: string,
-  options?: Record<string, unknown>,
-): Promise<Record<string, unknown>>;
-export declare function buildWidgetPackage(
-  project: Record<string, unknown>,
-  options?: Record<string, unknown>,
-): Uint8Array;
-
-export declare const widgetCliCore: {
-  readonly buildWidgetPackage: typeof buildWidgetPackage;
-  readonly checkWidgetProject: typeof checkWidgetProject;
-  readonly compileAuthorManifest: typeof compileAuthorManifest;
-  readonly resolveWidgetProjects: typeof resolveWidgetProjects;
-  readonly createWidgetTemplateRegistry: typeof createWidgetTemplateRegistry;
-  readonly defineWidgetTemplate: typeof defineWidgetTemplate;
-  readonly auditDshPlugin: typeof auditDshPlugin;
-  readonly scaffoldDshWidget: typeof scaffoldDshWidget;
-};