@dp-bohrium/widget-sdk 0.7.0 → 0.9.0

package/AGENTS.md

@@ -40,3 +40,31 @@ SDK 的 Node 命令与浏览器 Runtime 使用独立构建入口；不要从根
 
 当前执行器采用 integration v3、toolchain v3、工程锁 v2 和 receipt v2。SDK 自包含协议与声明，
 `protocol` 记录固定协议字段版本及 Schema 内容摘要；旧锁或 receipt 必须显式迁移或重新构建。
+
+## 协议事实源
+
+`schemas/` 是协议的唯一事实源，`src/protocol/generated-*.ts` 由根目录
+`pnpm generate:types` 生成；`src/validation/generated-*-schema.ts` 中的嵌入 Schema 同步由该命令生成，不手工维护副本。
+完整协议通过 `/contracts` 导出，conformance 正反语料在 `conformance/`，协议测试在
+`test/protocol/`。协议模块不得依赖 Runtime 初始化、CLI、Node 文件系统或 Host 实现。
+
+包 SemVer、`schemaVersion` / `hostApiVersion` 和能力 domain 版本各自表达不同约束；
+合包不改变协议字段版本，不为类型名添加版本后缀，也不放宽非法输入的拒绝条件。
+
+纯 Manifest 编译实现位于 `src/manifest.ts`，根入口的 `compileWidgetPluginManifest`
+绑定当前 SDK 版本；CLI 工程模块直接复用该实现，不另存一份编译算法。
+
+## 内部校验与测试支持
+
+Widget 作者通过 `bohr-widget check/build/pack` 校验工程，CLI 复用内部 `src/validation`
+模块中的同源 Schema 校验实现。校验器与 AJV 内嵌在 Node 命令中，不提供公开校验子入口，
+普通 SDK 根、`/runtime`、`/contracts`、`/testing` 不加载这些实现。内部独立编译产物
+只供仓库构建与测试使用，不进入 SDK tarball。校验通过不代表 Host 已授予权限或网络安全策略已通过。
+
+仓库维护构建由中央准备器分为运行库、Node 工具与分发组装；私有编译器和校验器生成到
+`.build/tooling`，最终 `dist` 只存分发产物。SDK 组装复用同一份 Node 命令及其 chunks，
+不会调用 CLI 完整构建；开发者运行包的 `build` 可准备完整 SDK。
+
+`/testing` 保留 MockWidgetHost、MemoryTransport。仓库专用 fixture 名称、Node 文件加载器、
+兼容场景目录与 conformance runner 位于 `test/support/`，不公开导出或打包；公开协议语料仍在
+`conformance/`，测试支持直接引用该事实源，不复制语料。

package/CHANGELOG.md

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

package/README.md

@@ -48,6 +48,20 @@ pnpm exec bohr-widget check .
 在自己的 `package.json` 里钉死精确 SemVer，不要用 `^` 或裸 `latest`。SDK 运行时会从已安装
 包自身读取版本，插件源码和 Manifest 不需要再次填写 SDK 版本。
 
+## 校验工程
+
+使用 SDK 自带的命令检查 Widget 工程：
+
+```bash
+pnpm exec bohr-widget build .
+pnpm exec bohr-widget check .
+pnpm exec bohr-widget pack . --out widget.zip
+```
+
+命令复用同一份协议 Schema 校验 Manifest 与样例，并检查入口、资源和打包要求。
+校验实现供内部工具使用，不提供独立公开子入口，普通 SDK 导入不加载校验器或 AJV。
+校验通过只表示本地工程符合检查要求，Host 仍负责实际权限、网络策略与运行隔离。
+
 ## 快速开始
 
 ```ts