建立 Thinloop 正式版本、Tag 与 GitHub Release 链路

[mindcarver]

结果

建立并实际走通 Thinloop v0.16.0 的清单版本、Tag、GitHub Release 和发布证据链。

用户问题

Thinloop 0.15.0 没有 Git Tag、GitHub Release、Tag—版本一致性门或正式发布记录；当前能力、工程门和评测证据也没有集中到可审计的版本说明。

产品追溯

• 权威来源：当前对话确认的改进范围
• 已确认版本：2026-08-30
• 需求：不适用

项目协调

• Initiative：Initiative：把 Thinloop 产品化证据链推进到 CI、A/B、路由内核与正式发布 #72
• 节点：formal-release
• 图版本：2
• 依赖：重组 README 产品表面并增加三个 Before/After #77（readme-product-surface，已完成）
• 契约：APPROVED
• 当前图状态：DONE
• 通道资源：/Users/carver/workspace/mindcarver/.worktrees/thinloop-73，release/73-v0.16.0
• 清理所有者：父 scd-execute

范围内

• 以 .codex-plugin/plugin.json 为权威，校验全部插件、Marketplace、README badge 和安装说明的当前版本；
• 在普通 CI 与 Tag-only Release workflow 中执行同一套确定性工程门；
• 发布 job 只在 verify 成功后取得 contents: write，并从精确 Tag 发布说明创建 Release；
• 将下一版本提升到 0.16.0，同步全部版本承载面；
• 用 docs/releases/v0.16.0.md 集中记录真实范围、工程门、三臂 smoke、九平台能力和限制；
• 候选变更通过 PR、必需 CI 与独立验收后，由父 Execute 在远端 main 上打 Tag、观察真实 Release run、刷新安装并完成 Initiative 总验收。

范围外

• npm 或其他包注册表发布；
• 自动生产部署；
• 绕过或弱化 main 保护和 required checks；
• 候选 QuickDev 阶段提前打 Tag、创建 Release 或刷新本地安装；
• WorkBuddy、ZCode 的强制刷新或 UI 核验；
• 修改评测定义、路由内核或 README 产品内容。

已确认决策

• 不补打语义模糊的旧版本 Tag；
• 新增公共 CI、评测、路由与发布能力按 0.16.0 发布；
• check-version.mjs 只从 .codex-plugin/plugin.json 读取权威版本，不在实现中硬编码 0.16.0；
• --tag 显式值优先，Tag 形状的 GITHUB_REF_NAME 可作为环境输入；普通 main/PR ref 不被误判为版本 Tag；
• Tag 只能指向已通过 CI 和独立验收的远端 main；Release workflow 还会验证 Tag 提交属于 origin/main；
• Release job 只有 contents: write，不持有包注册表密钥；
• 建立 Thinloop 当前版本三臂整体价值 A/B 评测 #74 只有单 fixture、每臂一次且三臂均 PASS，因此发布说明明确记录“未观察到相对增益”，不生成效果百分比。

方案确认

• 需要确认：否
• 状态：默认免确认

失败与边界场景

• 任一插件、Marketplace 嵌套字段、README badge 或安装说明当前版本不一致时，检查非零退出；
• --tag / GITHUB_REF_NAME 与权威版本不一致或不符合 vX.Y.Z 时，检查非零退出；
• docs/releases/<tag>.md 缺失或标题不是精确 Tag 时，Release verify 失败；
• Tag 提交不属于远端 main、工程门失败或 Release 创建失败时保持 Issue 开放；
• Tag 已存在时不强制覆盖；
• 本地安装刷新只覆盖受支持且当前安装的平台，WorkBuddy 与 ZCode 保持 SKIP。

验收条件

• A1：所有版本承载文件共享一个非硬编码来源检查，Tag CI 会拒绝错配。
• A2：Release workflow 在目标 Tag 上等待测试通过并创建 GitHub Release。
• A3：目标版本 Tag 指向通过验收的远端 main 提交。
• A4：GitHub Release 包含范围、验证、A/B 证据、平台能力和已知限制。
• A5：本地受影响 Agent 刷新后，支持的自动验证平台版本、十二个 Skill 和 Hook 符合源码。
• A6：Initiative 的五项项目验收在发布版本上重新核对通过。

实施方案

• 新增 scripts/check-version.mjs，读取权威版本并检查 11 个版本承载面；按需校验显式 Tag、GitHub ref 和精确发布说明。
• 在 .github/workflows/ci.yml 增加普通版本面检查；新增 .github/workflows/release.yml，verify job 复现 CI 确定性门，release job 只负责精确 notes 的 gh release create --verify-tag。
• 机械提升四份插件清单、三份 Marketplace 版本字段、README badge 和安装说明；兼容性测试不再硬编码旧版本。
• 新增确定性测试覆盖正常路径、承载面错配、错 Tag、GITHUB_REF_NAME、缺发布说明、Tag-only trigger、权限边界和同构工程门。
• 候选 PR 不打 Tag、不创建 Release、不刷新安装；父 Execute 在合并与独立验收后完成真实发布和总验收。

实施任务

• T1：新增权威版本检查器，覆盖 11 个版本承载面、--tag、GITHUB_REF_NAME 和发布说明。
• T2：新增 Tag-only Release workflow，并把普通版本检查接入 Thinloop CI。
• T3：编写 docs/releases/v0.16.0.md，记录实际证据与限制。
• T4：把全部当前版本承载面机械提升为 0.16.0，不修改评测、路由或 README 产品内容。
• T5：增加确定性回归测试并运行完整同构工程门、插件严格校验和差异检查。
• T6：提交候选、推送分支并创建 Refs #73 PR。
• T7：父 Execute 完成独立验收、合并、Tag、真实 Release run、安装刷新和 Initiative 总验收。

验证

• A1 PASS：node scripts/check-version.mjs --tag v0.16.0 --require-release-notes → PASS version 0.16.0: 11 surfaces；真实 Tag workflow run 33304501787 复跑同一检查并通过。
• A2 PASS：真实 Thinloop Release run 33304501787 的 Verify release tag 与 Create GitHub Release 两个 job 均为 SUCCESS。
• A3 PASS：远端 v0.16.0^{} 解引用到 23b81511c02e9a91cf98c3fc7d434064b64d2b1a，与通过候选验收和 main CI 的远端 main 提交一致。
• A4 PASS：Thinloop v0.16.0 已发布且非 draft/prerelease；正文与精确 notes 一致，包含范围、199/199、建立 Thinloop 当前版本三臂整体价值 A/B 评测 #74 单 fixture无相对增益、5 PASS / 2 MANUAL / 2 SKIP 和限制。
• A5 PASS：Claude Code 插件已从 0.15.0 更新到 0.16.0；node scripts/verify-install.mjs --format json 为 5 PASS / 0 FAIL / 2 MANUAL / 2 SKIP，自动证据确认 0.16.0、十二 Skill 和适用 Hook。
• A6 PASS：最终全新上下文验收者在 main / v0.16.0 上重新核对 P1-P5，确认 CI、三臂评测、路由内核、README、Tag/Release、安装和清理全部成立。
• 完整同构门：node --test tests/*.test.mjs → 199/199 PASS；路由内核 8 routes / 4 surfaces；Discovery、Knowledge、Thinloop 三组定义 PASS；Knowledge 5 cases dry-run PASS；Thinloop 7 cases × 3 conditions dry-run PASS；README 图一致性 PASS；Claude plugin strict validate PASS。
• PR 发布 Thinloop v0.16.0 正式版本链路 #82 Thinloop CI：PASS，run 33304176246，job 99237655830。
• 远端保护只读核对：main required check 为严格模式 Thinloop CI，enforce_admins: true。
• git diff --check：PASS。

完成审计

验收闭合

• A1：PASS，候选与真实 Tag CI 均通过版本门。
• A2：PASS，真实 verify/release jobs 均成功。
• A3：PASS，Tag 与远端 main SHA 一致。
• A4：PASS，GitHub Release 已创建并核对正文。
• A5：PASS，Claude 更新和统一安装检查已完成。
• A6：PASS，最终 Initiative 新上下文验收已完成。

实施账目

• T1：DONE。
• T2：DONE。
• T3：DONE。
• T4：DONE。
• T5：DONE。
• T6：DONE，候选提交 f4e3d7b，PR 发布 Thinloop v0.16.0 正式版本链路 #82。
• T7：DONE，合并、Tag、Release workflow、安装刷新、最终验收与资源清理全部完成。

页面验收

• 页面变更：否
• 证据矩阵：不适用

交付状态

• 精确差异：候选差异仅包含版本承载面、版本/发布脚本与 workflow、发布说明、安装/验证说明和确定性测试；无评测、路由或 README 产品内容变更。
• 必需检查：候选本地同构门 PASS；PR 发布 Thinloop v0.16.0 正式版本链路 #82 必需 Thinloop CI PASS。
• 独立验收：合并前候选验收 PASS；最终全新上下文 Initiative 验收 PASS，P1-P5 与 A1-A6 均有直接证据。
• 合并版本：PR 发布 Thinloop v0.16.0 正式版本链路 #82 已合并为 23b81511c02e9a91cf98c3fc7d434064b64d2b1a；本地与远端 main 同步且 main CI run 33304476626 SUCCESS。
• Tag / Release：v0.16.0 已指向验收 main；GitHub Release 已由 run 33304501787 创建。
• 未知项：无。

清理状态

• 清理所有者：父 scd-execute
• main 同步：PASS，本地与远端 main 均为 23b81511c02e9a91cf98c3fc7d434064b64d2b1a
• 任务工作树：/Users/carver/workspace/mindcarver/.worktrees/thinloop-73，已删除并复核不存在
• 本地任务分支：release/73-v0.16.0，已删除并复核不存在
• 远端任务分支：release/73-v0.16.0，已删除并复核不存在
• 连续性状态：不适用

未知项

• 无。

[mindcarver]

合并前候选验收与最终 Initiative 新上下文验收均 PASS；v0.16.0 Tag/Release、199 项发布门、Claude 0.16.0 刷新、5 PASS / 0 FAIL / 2 MANUAL / 2 SKIP 安装证据和全部通道清理已闭合。