35 lines
2.9 KiB
Markdown
35 lines
2.9 KiB
Markdown
# v0.28.1 混合工作区验收
|
||
|
||
2026-09-30，macOS arm64。范围为 CLI 工程识别与命令分发，不改变运行时接口、生成模板归属或业务规则。
|
||
|
||
## 发布前回归
|
||
|
||
- `GO_OMNI_SCAFFOLD_INTEGRATION=1 go test -race -count=1 ./...`：56 个测试包通过，包含实际生成消费者。
|
||
- `GOTOOLCHAIN=go1.22.12 GO_OMNI_SCAFFOLD_INTEGRATION=1 go test -count=1 ./cmd/go-omni/...`：5 个 CLI 包通过，含 API 与通用工程消费者。
|
||
- `go vet ./...`、`go build ./...`、`git diff --check`：通过。
|
||
|
||
## 行为覆盖
|
||
|
||
- 显式 kind 与按清单自动识别，两类工程混合及纯通用工程工作区。
|
||
- 原有无 kind 的 API 清单、首次生成时显式 api 入口保持兼容。
|
||
- 未知类型、类型与已有清单冲突、两种清单并存、project 携带 api、错误 module、损坏清单、重复 JSON 键、越界/重叠路径与符号链接均拒绝。
|
||
- check 汇总两个工程的生成漂移，也在一个工程身份错误时继续检查其他工程；失败与成功均不写文件。
|
||
- format 对通用工程显示 SKIP，即使它的 Go 文件存在漂移也不修改；API 格式化规则保持。
|
||
- 任意一类工程预检失败时，另一类工程的待补生成文件不被提前写入；所有预检通过后可补回缺失产物。
|
||
- 手写文件、go.work、go.work.sum、各 module 的 go.mod/go.sum 保持。
|
||
- 原有显式共享 Go 错误目录提供方在加入通用工程后仍可生成、检查，失败不改项目文件。
|
||
- 真实 CLI 创建两个独立 module，执行混合 format/generate/check，然后用 Go 原生 go.work 完成 race 测试与多模块构建。
|
||
- 真实 CLI 遇到两个工程漂移时汇总输出，退出码 1；失败生成保持原工作区内容，修复后可恢复生成与检查。
|
||
|
||
检查只涉及生成产物，不替代业务测试。显式 errorCatalogs 仍执行受信任的 Go 导出函数；生成事务按单个工程提交，不保证跨模块的崩溃原子性。
|
||
|
||
## 远程发布验收
|
||
|
||
三个独立空模块缓存安装固定远程 v0.28.1-preview，均未使用本地 replace：
|
||
|
||
- [混合工作区报告](workspaceRemote.json)：16 项检查通过，耗时 21.74 秒。远程 CLI 创建两类 module，完成显式/隐式类型识别、混合生成检查、真实 go.work race/构建、失败汇总与写入前预检。
|
||
- [通用工程报告](workspaceProgramRemote.json)：30 项检查通过，耗时 25.69 秒，含真实进程退出、资源保留与手写代码保护。
|
||
- [既有生成器报告](workspaceManagedRemote.json)：98 项检查、10 组消费者通过，耗时 108.92 秒。包含配置、HTTP 安全、国际化与 TypeScript；TypeScript 5.6.3 通过 npm exec 提供，未跳过。
|
||
- 三组远程模块 checksum 一致：`h1:tah8kFIFZMuPK/veNBu/AjB6bdmlp5DgN+fTuNNkQmA=`。
|
||
- 发布标签固定在代码提交 `0d2c6040e2694795f203304148dbaec00318c608`，标签对象 `e0e483b2741f92c8e44a0e45e56d78a920cb3ebb`。验收文档随后独立提交，发布标签不移动。
|