@dp-bohrium/widget-cli 0.5.0 → 0.6.0

package/AGENTS.md

@@ -61,7 +61,7 @@ bohr-widget help [<命令路径>]
 ## 执行顺序
 
 1. `create` 创建工程后检查返回的 `projectRoot`、`manifestPath`、`packagePath`、`profile`、`name` 和可选
-   `panelId`；工作区文件面板固定使用 `--panel-id workspace-files`，CLI 会补齐三项只读文件能力。
+   `panelId`。Panel ID 可自定义；如需文件浏览面板预设，可使用 `--panel-id workspace-files`，CLI 会补齐三项只读文件能力。
    `warnings` 说明目录名不是合法标识符时 `manifest.name` 已回退为 `widget-<hash>`。
    将 `widget-toolchain.json` 与包管理器 lockfile 一起提交；不手改 profile 绕过版本检查。
    `--extensions` 只用于 file-preview，填写不带前导点的小写扩展名；`--tool` 将默认激活信号替换为
@@ -140,8 +140,8 @@ bohr-widget help [<命令路径>]
 
 ## 在 Panel 中编辑工作区文件
 
-用户要在文件树面板里直接保存时，用 `create --template panel --panel-id workspace-files` 创建工程，
-再在作者 Manifest 的 `capabilities.files` 中加上 `write: true`（模板默认只有 list/metadata/read）。
+开发文件树面板时，可用 `create --template panel --panel-id workspace-files` 选择文件浏览预设。
+需要保存文件时，在作者 Manifest 的 `capabilities.files` 中加上 `write: true`（模板默认只有 list/metadata/read），并确认目标工作台支持写入。
 
 - 文件引用只取自 `content.data.root` 和 `files.list` 结果中 `kind: "file"` 的项；不拼路径，不自造 id。
 - 运行时没有 `files.write` grant 时保持只读并说明原因；较早的 Host 只向 file-preview 签发写权限。
@@ -173,8 +173,8 @@ profile。`ready` 在此基础上还要求
 旧工程直接声明 contracts 或 CLI 时会失败；先在独立候选中改用 SDK 出口并移除旧包，
 重新安装、构建和验收。锁和 receipt 为 v2，integration 与 toolchain 为 v3；不自动回选旧执行器。
 保留已有作者源码、跨 profile 升级或准备候选工程时，先读[准备迁移候选](https://dev.dp.tech/bohrium-widget-sdk/guides/migration)，按指南完成候选审阅、plan/apply 和后续验收。
-Host 或控制面可使用 `@dp-bohrium/widget-contracts`，也可使用 SDK 的协议、Schema 和 conformance
-入口；固定与目标 SDK 配套的精确版本，不混用不同版本的协议资产。
+Host 或控制面统一使用 SDK 的 `/contracts`、Schema 和 conformance 入口；固定与目标 SDK 配套的
+精确版本，不混用不同版本的协议资产。
 
 ## 宿主兼容声明
 
@@ -227,6 +227,14 @@ SDK package.json 或 `unknown` 解释为线上平台已兼容。
 `/core` 是模板、compiler、校验和打包的底层 API；直接调用它时，调用方负责工程锁定、实际依赖
 和宿主兼容策略。完整预检由上述命令提供。`sdkVersion` 不能用来伪造另一代 compiler 的版本。
 
+仓库内部的工程发现、检查、资源收集、ZIP 与摘要实现在 `src/project/`，供命令、维护脚本和
+Demo 服务端复用；纯 Manifest 编译由 SDK 维护。Gallery 路由、展示状态和 Render 投影归 Demo，
+不进入通用工程模块；Demo 浏览器通过服务端导出 ZIP，不导入 Node 工程实现。
+
+仓库构建由中央准备器生成私有 SDK 工具输入和共享 Node 产物，再组装 CLI 的 `dist/assets`。
+CLI 完整构建不调用 SDK 完整构建，也不要求 SDK 最终 `dist` 已存在。SDK 内嵌命令与 CLI
+共用 Node 实现，但各自读取安装位置的工具链身份；私有 `.build` 不进入发布物。
+
 `--open` 优先协商 Widget Development Host v1，旧宿主才回落 legacy profile 并告警。
 legacy profile 已废弃，目标 Host 应升级到当前协议。
 descriptor、status、events、control、一次性 claim 和 session token 都通过命令返回的 URL

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # `@dp-bohrium/widget-cli` 变更记录
 
+## 0.6.0
+
+### Minor Changes
+
+- 2c4cac6: 新增标准开发诊断、类型化恢复规则目录与显式协商的开发扩展合同，复用现有错误和 Schema。
+  恢复计划区分修复与原样重试，缺少证据或操作结果未知时先排查，并提供构建、刷新及场景复验步骤。
+  旧握手和终态错误语义保持不变；仅在协商后发送标准诊断与渲染结果，开发 Host 提供受保护的诊断收集与已构建产物刷新，不自动执行作者脚本或修复。
+
+### Patch Changes
+
+- 99fee61: 修复工作区声明构建被陈旧 SDK 分发文件干扰的问题，直接复用当前源码的协议类型，无需手动删除既有分发目录。
+
+## 0.5.2
+
+### Patch Changes
+
+- de9e8a5: 在 Widget 工程和本地作者索引中提供尺寸指引。文件预览示例的内容区随宿主分配的 iframe 高度伸缩。
+- 42fb8c1: `bohr-widget dev --no-build` 支持通过 `--listen-fd` 复用宿主已监听的 `127.0.0.1` TCP socket，避免预览服务另行绑定端口。
+
+## 0.5.1
+
+### Patch Changes
+
+- 75c4148: 创建 Panel 时不再将自定义 ID 作为警告，成功输出明确说明 ID 可自定义。同步帮助和 Agent 指引，将 `workspace-files` 说明为可选的文件浏览面板预设。
+- 0578f90: 破坏性变更：将独立 Contracts 包合入 SDK，统一通过 SDK 的 `/contracts`、`/schemas/*.json` 和
+  `/conformance/*` 入口提供协议类型、Schema 与校验语料，不再独立发行 Contracts。
+- 75c4148: 创建 Widget 工程时生成简短的 AGENTS.md，并在 README 与命令输出中直接提供固定 SDK 版本、公开文档、Agent 阅读入口和后续命令。开发前先确认目标工作台能力，安装依赖后使用工程内命令构建、校验和打包，再完成真实 Host 验收。
+
 ## 0.5.0
 
 ### Minor Changes