@dp-bohrium/widget-cli 0.2.0 → 0.4.0

package/dist/core.mjs

@@ -1,4 +1,4 @@
-import { c as resolveWidgetProjects, l as compileAuthorManifest, n as scaffoldDshWidget, r as buildWidgetPackage, s as checkWidgetProject, t as auditDshPlugin } from "./dsh-BzxDpEcZ.mjs";
+import { c as resolveWidgetProjects, l as compileAuthorManifest, n as scaffoldDshWidget, r as buildWidgetPackage, s as checkWidgetProject, t as auditDshPlugin } from "./dsh-BvnlfCRX.mjs";
 //#region src/core.mjs
 /** Validate a community template before registering it in a custom CLI. */
 function defineWidgetTemplate(template) {

package/dist/{dsh-BzxDpEcZ.mjs → dsh-BvnlfCRX.mjs}

@@ -95,9 +95,9 @@ function collectReferencedFileIds(request) {
 	return referenced;
 }
 //#endregion
-//#region ../widget-sdk/dist/runtime-RyAEhkyn.js
+//#region ../widget-sdk/dist/runtime-D7KxTtdu.js
 /** 从当前安装的 SDK package.json 读取版本，插件作者不需要重复填写。 */
-const WIDGET_SDK_VERSION = "0.4.1";
+const WIDGET_SDK_VERSION = "0.6.0";
 //#endregion
 //#region ../widget-sdk/dist/index.js
 function compiledContribution(contribution) {
@@ -6824,7 +6824,7 @@ var require_json_schema_2020_12 = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.default = addMetaSchema2020;
 }));
 //#endregion
-//#region ../contract-testing/dist/manifest-validator-DCdGSuVM.js
+//#region ../contract-testing/dist/manifest-validator-DUzSsw8D.js
 var import__2020 = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.MissingRefError = exports.ValidationError = exports.CodeGen = exports.Name = exports.nil = exports.stringify = exports.str = exports._ = exports.KeywordCxt = exports.Ajv2020 = void 0;
@@ -7036,12 +7036,15 @@ const widgetManifestSchema = {
 			} }
 		},
 		"TasksCapabilityRequest": {
-			"description": "任务观察能力的申请；watch 固定为 true。",
+			"description": "任务发现与观察能力的申请；list / watch 至少显式申请一项，已申请项固定为 true。",
 			"title": "TasksCapabilityRequest",
 			"type": "object",
 			"additionalProperties": false,
-			"required": ["watch"],
-			"properties": { "watch": { "const": true } }
+			"minProperties": 1,
+			"properties": {
+				"list": { "const": true },
+				"watch": { "const": true }
+			}
 		},
 		"StateCapabilityRequest": {
 			"description": "受限 UI 状态读写能力的申请；read / write 分别声明。",
@@ -7471,6 +7474,9 @@ const widgetRuntimeContractsSchema = {
 		"taskObservationSnapshot": { "$ref": "#/$defs/TaskObservationSnapshot" },
 		"taskObservationEvent": { "$ref": "#/$defs/TaskObservationEvent" },
 		"taskObservationBatch": { "$ref": "#/$defs/TaskObservationBatch" },
+		"taskListField": { "$ref": "#/$defs/TaskListField" },
+		"taskListItem": { "$ref": "#/$defs/TaskListItem" },
+		"taskListPage": { "$ref": "#/$defs/TaskListPage" },
 		"toolResultEnvelope": { "$ref": "#/$defs/ToolResultEnvelope" },
 		"uiStateResult": { "$ref": "#/$defs/UiStateResult" },
 		"uiStateWriteResult": { "$ref": "#/$defs/UiStateWriteResult" },
@@ -7861,6 +7867,18 @@ const widgetRuntimeContractsSchema = {
 				"cancelled"
 			] } }
 		},
+		"TaskStatus": {
+			"description": "Host 投影给 Widget 的统一任务状态。",
+			"title": "TaskStatus",
+			"enum": [
+				"queued",
+				"running",
+				"succeeded",
+				"failed",
+				"cancelled",
+				"expired"
+			]
+		},
 		"TaskObservationSnapshot": {
 			"description": "任务观察的当前快照：taskId、status 与 updatedAt；progress、message 可选。",
 			"title": "TaskObservationSnapshot",
@@ -7877,14 +7895,7 @@ const widgetRuntimeContractsSchema = {
 					"minLength": 1,
 					"maxLength": 256
 				},
-				"status": { "enum": [
-					"queued",
-					"running",
-					"succeeded",
-					"failed",
-					"cancelled",
-					"expired"
-				] },
+				"status": { "$ref": "#/$defs/TaskStatus" },
 				"progress": {
 					"type": "number",
 					"minimum": 0,
@@ -7968,6 +7979,110 @@ const widgetRuntimeContractsSchema = {
 				}
 			}
 		},
+		"TaskListField": {
+			"description": "任务列表中的受限展示字段；key 是稳定机器键，value 是 Host 裁剪后的展示文本。",
+			"title": "TaskListField",
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["key", "value"],
+			"properties": {
+				"key": {
+					"description": "展示字段的稳定机器键，例如 machine 或 command。",
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 64,
+					"pattern": "^[A-Za-z][A-Za-z0-9_.:-]*$"
+				},
+				"value": {
+					"description": "Host 完成授权与裁剪后的展示文本。",
+					"type": "string",
+					"maxLength": 16384
+				}
+			}
+		},
+		"TaskListItem": {
+			"description": "Host 已授权发现的任务摘要；taskId 是可继续传给 tasks.watch 的不透明引用。",
+			"title": "TaskListItem",
+			"type": "object",
+			"additionalProperties": false,
+			"required": [
+				"taskId",
+				"kind",
+				"name",
+				"status",
+				"updatedAt",
+				"fields"
+			],
+			"properties": {
+				"taskId": {
+					"description": "可继续传给 tasks.watch 的 Host 不透明任务引用。",
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 256
+				},
+				"kind": {
+					"description": "任务来源类型的稳定机器键。",
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 64,
+					"pattern": "^[A-Za-z][A-Za-z0-9_.:-]*$"
+				},
+				"name": {
+					"description": "任务的安全展示名称。",
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 256
+				},
+				"status": { "$ref": "#/$defs/TaskStatus" },
+				"progress": {
+					"description": "可选执行进度，取值范围为 0 到 1。",
+					"type": "number",
+					"minimum": 0,
+					"maximum": 1
+				},
+				"message": {
+					"description": "Host 裁剪后的可选状态说明。",
+					"type": "string",
+					"maxLength": 1024
+				},
+				"updatedAt": {
+					"description": "任务摘要最后更新时间，使用 UTC ISO 8601 字符串。",
+					"type": "string",
+					"pattern": "^\\d{4}-\\d{2}-\\d{2}T[^ ]+Z$"
+				},
+				"fields": {
+					"description": "任务面板可展示的受限附加字段。",
+					"type": "array",
+					"maxItems": 32,
+					"items": { "$ref": "#/$defs/TaskListField" }
+				}
+			}
+		},
+		"TaskListPage": {
+			"description": "Host 已授权任务摘要的一页结果；nextCursor 缺失表示当前页已到末尾。",
+			"title": "TaskListPage",
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["schemaVersion", "tasks"],
+			"properties": {
+				"schemaVersion": {
+					"description": "任务列表页结构版本，当前固定为 1。",
+					"const": 1
+				},
+				"tasks": {
+					"description": "当前页中 Host 已授权的任务摘要。",
+					"type": "array",
+					"maxItems": 100,
+					"items": { "$ref": "#/$defs/TaskListItem" }
+				},
+				"nextCursor": {
+					"description": "下一页的不透明游标；缺失表示当前列表已到末尾。",
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 512
+				}
+			}
+		},
 		"ToolResultMetric": {
 			"description": "工具结果中的单个指标。",
 			"title": "ToolResultMetric",
@@ -8346,6 +8461,40 @@ const widgetRuntimeContractsSchema = {
 						}
 					}
 				},
+				{
+					"type": "object",
+					"additionalProperties": false,
+					"required": ["name", "limits"],
+					"properties": {
+						"name": { "const": "tasks.list" },
+						"limits": {
+							"type": "object",
+							"additionalProperties": false,
+							"required": [
+								"callsPerMinute",
+								"pageSize",
+								"minPollMs"
+							],
+							"properties": {
+								"callsPerMinute": {
+									"type": "integer",
+									"minimum": 1,
+									"maximum": 9007199254740991
+								},
+								"pageSize": {
+									"type": "integer",
+									"minimum": 1,
+									"maximum": 100
+								},
+								"minPollMs": {
+									"type": "integer",
+									"minimum": 1e3,
+									"maximum": 6e4
+								}
+							}
+						}
+					}
+				},
 				{
 					"type": "object",
 					"additionalProperties": false,
@@ -8831,6 +8980,30 @@ const widgetRuntimeContractsSchema = {
 						}
 					}
 				},
+				{
+					"type": "object",
+					"additionalProperties": false,
+					"required": ["operation", "input"],
+					"properties": {
+						"operation": { "const": "tasks.list" },
+						"input": {
+							"type": "object",
+							"additionalProperties": false,
+							"properties": {
+								"cursor": {
+									"type": "string",
+									"minLength": 1,
+									"maxLength": 512
+								},
+								"limit": {
+									"type": "integer",
+									"minimum": 1,
+									"maximum": 100
+								}
+							}
+						}
+					}
+				},
 				{
 					"type": "object",
 					"additionalProperties": false,
@@ -11265,9 +11438,9 @@ function activate(context: WidgetContext) {
 
 export { activate };
 `;
-function projectFiles({ name, displayName, data, source = panelSource, capabilities, placement, sdkVersion, contractsVersion }) {
+function projectFiles({ name, displayName, data, source = panelSource, capabilities, placement, sdkVersion }) {
 	const manifest = {
-		$schema: "@dp-bohrium/widget-contracts/schemas/widget-plugin-manifest.schema.json",
+		$schema: "@dp-bohrium/widget-sdk/schemas/widget-plugin-manifest.schema.json",
 		name,
 		version: "0.1.0",
 		displayName,
@@ -11344,10 +11517,13 @@ function projectFiles({ name, displayName, data, source = panelSource, capabilit
 			name: `@dp-bohrium/${name}`,
 			private: true,
 			type: "module",
-			scripts: { build: "tsc --noEmit && tsdown && node scripts/rename-iife.mjs" },
+			scripts: {
+				build: "tsc --noEmit && tsdown && node scripts/rename-iife.mjs",
+				check: "bohr-widget check .",
+				"widget:pack": "bohr-widget pack ."
+			},
 			dependencies: { "@dp-bohrium/widget-sdk": sdkVersion },
 			devDependencies: {
-				"@dp-bohrium/widget-contracts": contractsVersion,
 				tsdown: "0.22.14",
 				typescript: "5.9.3"
 			}
@@ -11404,7 +11580,6 @@ const DSH_RECIPES = [
 				mode: "replace"
 			} },
 			sdkVersion: options.sdkVersion,
-			contractsVersion: options.contractsVersion,
 			data: {
 				source: "dsh-better-sidebar",
 				behavior: "session-scoped right rail replacement shell",
@@ -11430,7 +11605,6 @@ const DSH_RECIPES = [
 			name: "dsh-tool-calculator-widget",
 			displayName: "DSH Calculator · Bohrium Widget",
 			sdkVersion: options.sdkVersion,
-			contractsVersion: options.contractsVersion,
 			data: {
 				source: "@deepseek-ai/dsh-tool-calculator",
 				behavior: "safe expression evaluation",
@@ -11456,7 +11630,6 @@ const DSH_RECIPES = [
 			name: "dsh-plugin-academic-writing-widget",
 			displayName: "Academic Writing · Bohrium Widget",
 			sdkVersion: options.sdkVersion,
-			contractsVersion: options.contractsVersion,
 			data: {
 				source: "dsh-plugin-academic-writing",
 				behavior: "outline/title/abstract/citation/checklist",
@@ -11477,7 +11650,6 @@ const DSH_RECIPES = [
 			name: "dsh-academic-research-widget",
 			displayName: "Academic Research · Bohrium Widget",
 			sdkVersion: options.sdkVersion,
-			contractsVersion: options.contractsVersion,
 			data: {
 				source: "@onpeople/dsh-academic-research",
 				behavior: "Crossref/OpenAlex evidence records",

package/llms.txt

@@ -1,6 +1,6 @@
 # @dp-bohrium/widget-cli
 
-> Widget 工程的本地创建、校验、开发、构建和打包工具；可由 Bohr CLI 桥接或调度。
+> Widget 工程的本地创建、迁移、校验、开发、构建和打包工具；可由 Bohr CLI 桥接或调度。
 
 要求 Node.js >=20。CLI 发布包固定 SDK/compiler、contracts/Schema、校验器和模板，
 提供文档站地址，不再内置 skills。生成工程仍安装自己的精确版本依赖。
@@ -20,7 +20,7 @@ pnpm exec bohr-widget --version --json
 `migrate dsh --help`。`-v` / `--version` 等价于 `version`，`--version --json` 等价于 `version --json`。
 帮助仅输出本地文本，不执行所选命令或联网获取文档。npm 的全局帮助用
 `npx --no-install bohr-widget --help`，其他命令同样替换前缀；未安装时可用
-`pnpm dlx @dp-bohrium/widget-cli --help` 查看入口。
+新工程优先用 `pnpm dlx @dp-bohrium/widget-sdk --help`；本包入口在兼容期保持可用。
 
 ## Agent 入口
 
@@ -31,6 +31,10 @@ pnpm exec bohr-widget --version --json
 - [完整文档](https://dev.dp.tech/bohrium-widget-sdk/llms-full.txt): 文档站自动生成的全文。
 - 自闭环范围：本包负责本地工程闭环；上传、平台预览、版本发布和 Agent 绑定不在本包内执行。
 
+## 准备迁移候选
+
+保留已有源码、跨 profile 升级或准备候选工程时，先读[准备迁移候选](https://dev.dp.tech/bohrium-widget-sdk/guides/migration)，由该指南维护准备、应用与验收边界。
+
 ## 本地闭环
 
 - `integration --json`: `interfaceVersion=2`，返回固定 profile、执行器位置、
@@ -39,7 +43,10 @@ pnpm exec bohr-widget --version --json
 - `create`: 创建 vanilla 或 React 工程并写 `widget-toolchain.json`；工作区文件面板使用
   `--panel-id workspace-files`。
 - `adopt`: 为旧工程显式写入工具链锁，先核对精确依赖、实际 SDK/contracts、Manifest 和 samples。
-- SDK 0.4.0 文件读写按需在 Manifest 声明 `capabilities.files.read/write`，再实现
+- SDK 0.5.0 的任务 Panel 在 Manifest 声明 `capabilities.tasks.list`；需要观察单个任务时再声明
+  `tasks.watch`。列表刷新遵守 grant 的 `minPollMs`，面板不可见后停止轮询；CLI 校验通过不代表
+  目标 Host 已签发 grant，详见 AGENTS.md。
+- SDK 0.5.0 文件读写按需在 Manifest 声明 `capabilities.files.read/write`，再实现
   `context.files.read/write`；创建命令和模板保持原样。保存使用读取回执的内容版本与 mutationId，
   缺授权、版本或完整性证据时只读；冲突/未知结果保留草稿且不自动重试，详见 AGENTS.md。
 - `check` / `validate`: 校验作者清单、Manifest、entry、samples 和 fixtures；`check all` 以

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dp-bohrium/widget-cli",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Bohrium Widget 插件工程的创建、校验、开发和打包工具。",
   "license": "MIT",
   "type": "module",
@@ -52,8 +52,8 @@
     "tsdown": "0.22.14",
     "typescript": "5.9.3",
     "@dp-bohrium/widget-contract-testing": "0.1.0-alpha.0",
-    "@dp-bohrium/widget-sdk": "0.4.1",
-    "@dp-bohrium/widget-contracts": "0.4.1"
+    "@dp-bohrium/widget-contracts": "0.6.0",
+    "@dp-bohrium/widget-sdk": "0.6.0"
   },
   "sideEffects": false,
   "scripts": {