Files
knowledge-governance/internal/version/version_test.go
T
姚章浩 7a9d51cc70 fix(version): 正式构建核证据 + 预检分"建议/就绪" + CI 就绪按必需 context
按要求补三项(本轮不推、不打真实 tag、不部署;全部用临时仓库与假对象验):

1) 正式构建身份不能只认 --release:
   - 新增 release_evidence():核①完整 40 位 SHA ②**指向该提交的注释 tag** v<版本号>
     ③该提交里 CHANGELOG 顶部版本一致。缺任一条 ⇒ rc=2,身份退回 development 并把
     release_blocked 的原因写进 JSON(给机器读,也给人看)。
   - version.py --self-test:六条负例(有版本无 tag / unknown SHA / 短 SHA / tag 指错提交 /
     轻量 tag / 版本不一致)+ 证据齐正例,**tag 全部在 mktemp 临时仓库里创建**。
   - Go 侧新增 TestReleaseBuildRequiresEvidence:release 构建必须 CommitSHA 完整且
     v<ReleaseVersion> 是**注释 tag** 并指向该提交(独立于 Python 的二次复核)。

2) 发布预检区分"准备建议"与"发布就绪":
   - 新增纯函数 readiness(facts) → (是否就绪, 阻塞项, 建议);输出分两段。
   - **就绪要求候选版本已写进目标提交**(version_in_commit:查 git show <sha>:CHANGELOG.md,
     工作区写了没提交不算);首发按**显式指定版本**处理,**不把"记录里有这个版本"当已发布**
     (已发布的证据是 tag,不是记录条目)。
   - 预检**不执行、也不在输出里推荐自动发布路径**(正式发版由人按 docs/RELEASE_RUNBOOK.md)。

3) CI 就绪判据:必需 context 集合来自 .gitea/required-contexts.txt(缺失/为空 ⇒ 没有策略 ⇒
   阻断,不用观察到的状态顶替);**全部 success 才通过**,失败/缺项/pending/查询异常一律阻断。
   Release 查询加 release_state():**只有 HTTP 404 才算不存在**,403/5xx/超时算查询异常 ⇒ 阻断。

验证:version.py --self-test 绿;release_preflight --self-test 绿(就绪判定 19 个分支 +
临时仓库验证 git show 语义 + 五个 HTTP 码语义);go test 三态(未注入 SKIP / 开发 PASS /
自称正式 RED);反向夹具 83/0(含临时仓库 go test 六例、预检"记录未进提交"两态);
make verify 15/15 success。
2026-10-13 15:26:49 +08:00

136 lines
5.7 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package version
import (
"os"
"os/exec"
"path/filepath"
"regexp"
"strings"
"testing"
)
// changelogTopVersion 返回仓库根 CHANGELOG.md 顶部的已发布版本号;还没有正式版本时返回 ""。
func changelogTopVersion(t *testing.T) string {
t.Helper()
path := filepath.Join("..", "..", "CHANGELOG.md")
raw, err := os.ReadFile(path)
if err != nil {
t.Fatalf("读不到 %s:%v(版本号的唯一来源就在这里)", path, err)
}
m := regexp.MustCompile(`(?m)^##\s*\[(\d+\.\d+\.\d+)\]`).FindSubmatch(raw)
if m == nil {
return ""
}
return string(m[1])
}
// 版本契约:注入进二进制的**正式版本基线**,必须等于仓库根 CHANGELOG.md 顶部的已发布版本。
//
// 为什么要有这条断言:CHANGELOG.md 是版本号的**唯一来源**,而注入是构建期动作。
// 两者只要没人对账,就会出现"改了 CHANGELOG 没重新构建"(产物报旧号)或
// "构建时手填了一个号"(产物报的号 CHANGELOG 里根本没有)—— 两种都让
// "线上跑的是哪个提交/版本"这个问题失去答案,而症状是静默的。
//
// ⚠️ "还没有正式版本"不等于出错:那时 ReleaseVersion 必须是空,**不许**编一个基线出来。
//
// 未注入时(普通 `go test ./...`)本用例 Skip:本地跑全量测试不必先构建。
// 但 CI 必须带 -ldflags 跑它,**并断言没有 SKIP**(被跳过的断言等于没有断言)。
func TestNumberMatchesChangelog(t *testing.T) {
if !HasInjection() {
t.Skip("构建身份未注入(没有 -ldflags);CI 会注入后跑这条断言,并断言它没有 Skip")
}
want := changelogTopVersion(t)
if want == "" {
if ReleaseVersion != "" {
t.Fatalf("CHANGELOG.md 里还没有已发布版本,ReleaseVersion 却是 %q —— 不许编一个版本基线出来", ReleaseVersion)
}
} else if ReleaseVersion != want {
t.Fatalf("注入的 ReleaseVersion %q != CHANGELOG 顶部 %q。"+
"常见原因:改了 CHANGELOG 却没重新构建(产物还报旧号),"+
"或者构建时手填了一个 CHANGELOG 里没有的号", ReleaseVersion, want)
}
if Number != ReleaseVersion && Number != "dev" {
t.Fatalf("Number %q 既不是 ReleaseVersion %q 也不是 dev —— 注入口径不一致", Number, ReleaseVersion)
}
}
// 开发构建不许自称正式版:这是"用正式版号代表开发版"那个问题的守门断言。
//
// - `BuildKind=release` 只允许出现在**确实有正式版本基线**的构建上,且显示就是那个版本;
// - 开发构建的 DisplayVersion 必须带 `dev` 形状,**不允许**退化成只显示上一正式版本号。
func TestDevBuildDoesNotClaimRelease(t *testing.T) {
if !HasInjection() {
t.Skip("构建身份未注入(没有 -ldflags);CI 会带 -ldflags 跑它,并断言它没有 Skip")
}
want := changelogTopVersion(t)
disp := DisplayVersion()
if BuildKind == "release" {
if want == "" {
t.Fatalf("标成了发布构建(BuildKind=release),但 CHANGELOG.md 里没有任何已发布版本条目 —— "+
"发布构建必须基于正式版本记录(现在显示 %q)", disp)
}
if ReleaseVersion != want || !semver.MatchString(ReleaseVersion) {
t.Fatalf("发布构建的 ReleaseVersion %q 不是 CHANGELOG 顶部的正式版本 %q", ReleaseVersion, want)
}
if disp != ReleaseVersion {
t.Fatalf("发布构建 DisplayVersion %q 应等于 ReleaseVersion %q", disp, ReleaseVersion)
}
return
}
if BuildKind != "development" {
t.Fatalf("BuildKind %q 既不是 development 也不是 release", BuildKind)
}
if !strings.Contains(disp, "dev") {
t.Fatalf("开发构建的 DisplayVersion %q 没有 dev 标识 —— 开发构建不能只显示正式版本号", disp)
}
if strings.Contains(disp, "+g") && ShortSHA() == "" {
t.Fatalf("DisplayVersion %q 带了 +g 但 CommitSHA %q 不是有效 SHA", disp, CommitSHA)
}
switch {
case want != "" && ShortSHA() != "":
if want := want + "-dev+g" + ShortSHA(); disp != want {
t.Fatalf("开发构建 DisplayVersion %q,期望 %q", disp, want)
}
case want == "" && ShortSHA() != "":
if want := "dev+g" + ShortSHA(); disp != want {
t.Fatalf("无正式基线的开发构建 DisplayVersion %q,期望 %q", disp, want)
}
}
}
// 正式构建必须**有证据**:完整提交 SHA + 一个指向该提交的**注释 tag** `v<ReleaseVersion>`。
// 光有"CHANGELOG 顶部有版本号"不算 —— 那会把每个开发构建都说成正式版。
func TestReleaseBuildRequiresEvidence(t *testing.T) {
if !HasInjection() {
t.Skip("构建身份未注入(没有 -ldflags);CI 会带 -ldflags 跑它,并断言它没有 Skip")
}
if BuildKind != "release" {
return // 开发构建由 TestDevBuildDoesNotClaimRelease 管
}
if !fullSHA.MatchString(CommitSHA) {
t.Fatalf("标成了正式构建,但 CommitSHA=%q 不是完整 40 位 —— 没有准确提交就谈不上正式版", CommitSHA)
}
name := "v" + ReleaseVersion
out, err := exec.Command("git", "tag", "--points-at", CommitSHA).Output()
if err != nil {
t.Fatalf("跑 `git tag --points-at %s` 失败:%v(正式构建必须能核到 tag 证据)", CommitSHA[:12], err)
}
tags := strings.Fields(string(out))
found := false
for _, x := range tags {
if x == name {
found = true
}
}
if !found {
t.Fatalf("标成了正式构建(%s),但提交 %s 上没有 tag %s(现有指向该提交的 tag:%v)—— "+
"正式构建必须有指向该提交的合规 tag", ReleaseVersion, CommitSHA[:12], name, tags)
}
kind, err := exec.Command("git", "cat-file", "-t", "refs/tags/"+name).Output()
if err != nil || strings.TrimSpace(string(kind)) != "tag" {
t.Fatalf("tag %s 不是**注释 tag**(`git tag -a`)—— 轻量 tag 不算发布证据", name)
}
}