create-windy 0.2.34 → 0.3.1

package/README.md

@@ -19,8 +19,9 @@ yarn dlx create-windy@latest my-dashboard
 pnpm dlx create-windy@latest my-dashboard
 ```
 
-无论使用哪种启动方式，生成项目都固定使用 Bun；本机需要 Bun 1.3.14 或更高
-版本。创建器默认安装依赖、初始化 Git `main` 分支并尝试创建
+这些入口只负责下载同一个 npm artifact；安装出的 `create-windy` bin 固定由 Bun
+执行，本机需要 Bun 1.3.14 或更高版本。生成项目也固定使用 Bun。创建器默认安装依赖、
+初始化 Git `main` 分支并尝试创建
 `chore: initialize project` 首次提交。
 
 不带参数运行时会在同一个列表中交互选择平台模块和 Oxc 基础设施，再选择项目法律
@@ -129,12 +130,34 @@ bun run windy sync-docker
 bun run windy update --check
 bun run windy update --dry-run
 bun run windy update
+bun run windy reconcile --to <精确目标版本>
 ```
 
 更新器要求 Git 工作区干净，从 npm 历史 artifact 重建 Base，并以
 Base/Ours/Theirs 合并共享脚手架。`package.json` 使用字段级合并；已发布 migration
 只允许追加；冲突发生时不写项目，验证失败则从 `.windy/backups/` 自动回滚。项目锁定
-的 CLI 检测到新版后，会委托给目标版本生成完整更新计划。
+的 CLI 检测到新版后，会委托给目标版本生成完整更新计划。受管清单 schema v3 用不含
+hash 的 missing tombstone 记住客户删除的 `project-owned` 路径；后续版本不会把它
+当作首次新增而重建，客户自行恢复文件后则采纳客户实际正文基线。既有 schema v1/v2
+仍可读取，未知或损坏状态会 fail closed。
+
+当发布说明明确指出历史受管清单与确定性格式化结果不一致时，可使用
+`reconcile --to <精确目标版本>`。该命令默认只演练；显式增加 `--apply` 后也只更新
+`.windy/files.json` 和无正文报告，不修改项目源码或推进 Project Lock。来源/目标均
+校验公网 npm artifact identity 与 integrity，只有内置不可变 proof 完整命中的
+`windy-managed` 文件可以对账；`shared-scaffold` 也必须精确命中内置 proof，
+`project-owned` 和未知语义差异保持未决。执行前同样要求 Git 工作区干净；中断仍
+通过 `doctor --repair` 恢复事务。
+
+公网 `0.3.0` 的默认 Git + Oxc 项目需要先运行
+`create-windy@0.3.1 reconcile --to 0.3.0`，确认后增加 `--apply`，提交生成的清单和
+报告，再运行 `create-windy@0.3.1 update --to 0.3.1`。这里的同版本目标是为了同时
+校验来源与目标均为同一个不可变 `0.3.0` artifact，不会把 Project Lock 提前推进。
+
+公网 `0.2.34` 的默认推荐模块项目也先对账到 `0.3.0`。该 profile 只有在 Project
+Lock、Oxfmt 配置、manifest 与来源 artifact 哈希全部精确命中时才启用专属 proof；
+未知 formatter 输出继续保持未决。真实两个默认项目名均为 12 个可证明、0 个未决，
+而非默认的 sharp-sword 仍为 5 个可证明、2 个未决。
 
 本地 Web 默认使用 8746；如果该端口属于其它服务，会自动尝试 8747、8748 等端口。
 如果检测到同一个项目已启动，则直接复用现有地址。