Files
go-omni/reports/workspaceAcceptance.md

2.9 KiB
Raw Blame History

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:

  • 混合工作区报告:16 项检查通过,耗时 21.74 秒。远程 CLI 创建两类 module,完成显式/隐式类型识别、混合生成检查、真实 go.work race/构建、失败汇总与写入前预检。
  • 通用工程报告:30 项检查通过,耗时 25.69 秒,含真实进程退出、资源保留与手写代码保护。
  • 既有生成器报告:98 项检查、10 组消费者通过,耗时 108.92 秒。包含配置、HTTP 安全、国际化与 TypeScript;TypeScript 5.6.3 通过 npm exec 提供,未跳过。
  • 三组远程模块 checksum 一致:h1:tah8kFIFZMuPK/veNBu/AjB6bdmlp5DgN+fTuNNkQmA=。
  • 发布标签固定在代码提交 0d2c6040e2694795f203304148dbaec00318c608,标签对象 e0e483b2741f92c8e44a0e45e56d78a920cb3ebb。验收文档随后独立提交,发布标签不移动。