Superflow v0.5.22

Superflow 0.5.22

升级内容：0.5.21 → 0.5.22

升级摘要

让测试证据、独立评审、归档恢复与升级后的运行时衔接更可靠，减少假绿、误阻断和无效重试。

主要更新

• 测试合同区分隔离逻辑、生产 SQL、真实数据库与 HTTP 入口；必要的落库验证不会被 Mock 代替。调用环境可与执行证据绑定，环境变化后不沿用旧通过结论。
• 统一安全、性能、正确性、可维护性、架构五维评审；按实际影响选择深度，隔离评审上下文，由主 Agent 复核并合并 findings。
• 报告与关闭门禁共用 Markdown 正文解析，示例中的 PASS/TODO 不参与裁决；最新 FAIL、未知结果和真正的中英冲突仍阻断，兼容中文通过与就绪。
• 修复目录已移动后的归档恢复，并让带 SDD 状态的 OpenSpec 归档统一回到 Superflow 收口，避免绕过验证或留下一半状态。
• 统一永久用量耗尽与临时限流分类；保留失败调用用量，累计未知不再冒充完整总量。Claude 重试按序列去重并隔离会话。
• 升级指纹覆盖包与技能脚本资产；增加启动构建来源诊断。后台服务核验进程身份，并在真正就绪后才确认启动成功。
• 单平台更新不再因登记项目扩大到另一宿主；新增仓库维护差异验证助手，未知或共享影响执行全量，发布门禁保持完整。

验证结果

• 最终全量：107 个测试文件、968 项测试通过。
• TypeScript、ESLint、全局设计与托管门禁、严格技能审计通过；16/16 合同、英文镜像缺口 0。
• npm pack --dry-run、隔离安装、实际 MCP 过期检测与后台服务启动/复用回查通过。
• 独立复审发现的启动确认、中文兼容和历史 Blocked 豁免问题已修复并复核。
• 这些结果属于框架与隔离进程验证；本版未运行真实外部模型或业务数据库，不宣称 Windows 实机或真实研发成功率得到证明。

升级方式

运行：superflow update --with-package
也可用 --agent codex / claude / both 选择宿主；选择范围同时约束登记项目与 MCP 刷新。
完成后重启 Host，加载新技能与 MCP 进程。历史后台服务如果仍存活且缺少身份记录，会安全拒绝自动停止：先核对 PID、命令、启动时间并确认任务已停，再停止已确认的旧服务，重启 Host 后恢复。单独重启 Host 不保证旧后台服务退出。

旧版本单宿主升级补充

旧 CLI 可能在读取已登记项目时扩大所选平台。首次升级到 0.5.22 且希望只刷新 Codex 时，先安装新 CLI，再由新版本执行完整的定向刷新：

npm install -g @chenmk/superflow@0.5.22 --ignore-scripts --registry https://registry.npmjs.org
superflow update --agent codex --scope global --with-dependencies

--ignore-scripts 仅跳过第一步安装期间的全局迁移；第二步由新版本完成所选平台的依赖、Skills、Hooks、规则、脚本及 MCP 刷新。Claude 单侧升级将第二步改为 --agent claude。完成后重启相应 Host。