releasecheck

command
v0.42.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 16, 2026 License: MIT Imports: 6 Imported by: 0

Documentation

Overview

Command releasecheck —— 发版纪律的机器判据(把散文变成门禁)。

四条纪律此前只写在 AGENTS.md「发版纪律」与 docs/AI-GUIDE.md §3.6 里, 全靠人手工核对。它们各自对应一种**只有下游才会发现**的残缺:

  1. **tag 快照里的 CHANGELOG 必须已含该 tag 自己那一段**。顺序反了(先打 tag 后生成)⇒ 下游 go mod download 拿到的模块里,发布说明缺自己那版。
  2. **CHANGELOG 不得含 U+FFFD**。源 commit message 带坏字节时生成器会忠实 复现,而坏字节在两侧都读不出原因。
  3. **一个提交只装一类内容**。「依赖文件 + 非依赖文件」混装会让行为变更落进 「依赖地板」段——下游扫 breaking 时根本看不见(2026-10-25 v0.13.0 实例)。
  4. **tag 必须是 annotated**。轻量 tag 承载不了发布说明,只剩一个指向。

判定面:只在 tag 快照上判

HEAD 没有 exact tag(普通提交 / PR 分支)⇒ **显式跳过并 exit 0**。故它可以 安全地挂在 make check 里:日常绿,打 tag 后 CI 的 tag 运行必然有 exact tag, 那时它才是硬判据。这条与「跳过必须显式、不许静默」一致——跳过时会打印原因。

为什么第 3 条带一张闭合的 legacy 清单

已发布的提交不可重写(改写公开历史会让下游按 commit 引用的校验失效)。故 历史上已发生的混装只能登记、不能修;清单**只减不增**,新增混装一律报红。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL