# 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`。验收文档随后独立提交，发布标签不移动。