Initial publish v0.1.0: standalone workflow core (corpus + examples + guards)

core/checklists/release.md

@@ -0,0 +1,76 @@
+# Release 检查清单
+
+> 发版前自检。Release Manager 在 Phase 1 和 Phase 6 完整过一遍。
+
+> **维度命名空间（dimension namespace）**: 本清单中的维度代码（如 TST/BEH/GATE/REG）是**清单局部（checklist-local）**标识符，仅在本文档内唯一；其他清单可能对相同字母串绑定不同概念（如 code-review.md 的 TST=Test Quality、verification.md 的 TST=Test Suite Completeness、port.md 的 TST=Test Porting）。跨清单引用时必须带清单限定（如 code-review.md TST 5.8），不得使用裸代码。
+
+---
+
+## 1. 前置闸门（GATE — Pre-release Gates）
+
+| #   | 检查项                                   | 通过 | 不通过 | 备注 |
+| --- | ---------------------------------------- | ---- | ------ | ---- |
+| 1.1 | 工作区干净（`git status` 无未提交变更）  | ☐    | ☐      |      |
+| 1.2 | 在正确的发布分支上                       | ☐    | ☐      |      |
+| 1.3 | 构建通过                                 | ☐    | ☐      |      |
+| 1.4 | Typecheck + Lint 通过                    | ☐    | ☐      |      |
+| 1.5 | 测试全部通过                             | ☐    | ☐      |      |
+| 1.6 | 依赖审计已运行，无新增 HIGH/CRITICAL CVE | ☐    | ☐      |      |
+| 1.7 | 无未跟踪的敏感文件（.npmrc 含 token、.env、credentials、私钥等） | ☐ | ☐ | |
+
+> **注意 1.6**：若使用了无法访问公有 registry 的私有仓库（如自建 Gitea），`bun audit` / `npm audit` 可能报 404。此时无法获取 CVE 数据属于已知盲区，须在 release report 中明确标注「dependency audit: N/A (custom registry)」。
+
+---
+
+## 2. 版本号（VER — Version）
+
+| #   | 检查项                                      | 通过 | 不通过 | 备注 |
+| --- | ------------------------------------------- | ---- | ------ | ---- |
+| 2.1 | 已找到上一个 tag（或确认这是首个 tag）      | ☐    | ☐      |      |
+| 2.2 | 所有 commit 已按类型分类（BREAKING/feat/fix/other） | ☐ | ☐ |      |
+| 2.3 | 版本号遵循 semver（MAJOR.MINOR.PATCH）      | ☐    | ☐      |      |
+| 2.4 | 变更类型与 commit 内容一致                  | ☐    | ☐      |      |
+| 2.5 | 版本号大于上一个 tag                        | ☐    | ☐      |      |
+| 2.6 | 版本号已写入所有版本文件                    | ☐    | ☐      |      |
+
+---
+
+## 3. 变更日志（LOG — Changelog）
+
+| #   | 检查项                                       | 通过 | 不通过 | 备注 |
+| --- | -------------------------------------------- | ---- | ------ | ---- |
+| 3.1 | 自上一个 tag 以来的所有非 chore 提交均已收录 | ☐    | ☐      |      |
+| 3.2 | 条目分组正确（Added/Changed/Fixed/Breaking） | ☐    | ☐      |      |
+| 3.3 | Breaking change 有迁移说明                   | ☐    | ☐      |      |
+| 3.4 | 每个条目标注了对应的 commit hash             | ☐    | ☐      |      |
+| 3.5 | CHANGELOG.md 已更新（prepend 新版本段）      | ☐    | ☐      |      |
+
+---
+
+## 4. 标签（TAG — Git Tag）
+
+| #   | 检查项                                  | 通过 | 不通过 | 备注 |
+| --- | --------------------------------------- | ---- | ------ | ---- |
+| 4.1 | commit message 含版本号                 | ☐    | ☐      |      |
+| 4.2 | tag 已创建且指向正确 commit             | ☐    | ☐      |      |
+| 4.3 | tag 命名遵循项目约定（默认 v{version}） | ☐    | ☐      |      |
+
+---
+
+## 5. 回滚计划（ROLL — Rollback Plan）
+
+| #   | 检查项                                      | 通过 | 不通过 | 备注 |
+| --- | ------------------------------------------- | ---- | ------ | ---- |
+| 5.1 | Git 回退步骤已文档化                        | ☐    | ☐      |      |
+| 5.2 | 若有数据库迁移，down migration 存在且已测试 | ☐    | ☐      |      |
+| 5.3 | 回滚触发条件已明确（延迟/错误率/严重 Bug）  | ☐    | ☐      |      |
+
+---
+
+## 6. 冒烟测试（SMOKE — Post-release Smoke）
+
+| #   | 检查项                              | 通过 | 不通过 | 备注 |
+| --- | ----------------------------------- | ---- | ------ | ---- |
+| 6.1 | Tagged commit 可构建                | ☐    | ☐      |      |
+| 6.2 | 测试全部通过                        | ☐    | ☐      |      |
+| 6.3 | 回到了原始分支                      | ☐    | ☐      |      |