Superflow v0.6.2

Superflow 0.6.2

升级内容：0.6.1 → 0.6.2

升级摘要

安装公共 npm 包后，通过简短的初始化与更新命令选择工具和范围，减少手工参数与漏配 MCP 的情况。

主要更新

• superflow init 提供语言、Claude Code/Codex、安装范围和执行确认，自动完成 MCP 注册。
• superflow update 在交互终端提供完整更新、资产刷新和计划预览；取消和预览不写入配置。
• 初始化失败给出保留原选项的恢复命令；更新后识别旧 PATH 入口遮蔽，避免误报成功。
• 同步中英文首页和安装指南，常规 npm 安装无需显式 registry；脚本显式参数用法保留。

验证结果

• 111 个测试文件、1048 项测试通过，含 14 项真实 POSIX 终端交互测试。
• Lint、构建、设计门禁、严格 Skill 审计和 npm 打包检查通过。
• 实际 tarball 在隔离 consumer 中安装并验证版本及命令入口；Windows 安装脚本已静态核查，未进行 Windows 实机验证。

升级方式

从 0.6.1 升级：

npm install -g @chenmk/superflow@latest
superflow update

首次使用进入项目根目录运行 superflow init。完成后重启对应 Agent 并执行 superflow doctor --agent both；只使用单端时改为 codex 或 claude。

Superflow v0.6.1

Superflow 0.6.1：加强源码调查与验证隔离

升级摘要

升级内容：0.6.0 → 0.6.1。

让需求转实施前的源码调查更可追溯，减少文档形式通过却遗漏真实调用链的风险；同时收紧外部验证与CLI分发边界，并完善统一入口的上手说明。

主要更新

• 源码调查加入可定位片段、复用依据及独立证伪记录；未知事实保持待查，哈希匹配不能替代理解与评审。
• 补强任务正文、字段值来源、显式字段容量及任务引用检查，避免代码块、缩进或注释中的示例任务冒充完成；保留已有合同与实施期证据的兼容边界。
• 验收规范覆盖完整用户操作链、合法空响应消费及异常回补；占位值判断必须有合同依据，模拟与真实验证分别报告。
• 外部项目默认只验证既有实现，案例原文、业务源码与依赖留在仓外；通用模板及测试命名去业务化，中英文与Codex/Claude同步。
• 重整中英文首页和安装指引，围绕统一入口提供完整上手步骤与明确升级方式。

验证结果

• 冻结发布快照完整测试通过：109个测试文件、1026项测试，无失败。
• 构建、TypeScript编译、ESLint及全局/托管设计门禁通过。
• Skill Registry严格审计通过：16/16，英文镜像缺口为0。
• npm打包预览通过；双宿主、双语言规范分发回归通过。

升级方式

使用现有完整升级入口刷新CLI、Skills、Hooks与MCP：

superflow update --with-package --agent both --scope global --language zh

只使用单一宿主时，将both替换为codex或claude。完成后重启当前宿主会话，再运行superflow doctor核对。

Superflow v0.6.0

Superflow 0.6.0：统一入口，让用户描述目标即可开始

升级内容：0.5.22 → 0.6.0。本次包含技能名称与 Prompt 路径的破坏性调整，不保留旧名称别名。

升级摘要

Superflow 现在统一从 $superflow（Codex）或 /superflow（Claude Code）开始。用户无需先判断 SDD/OpenSpec、开发阶段或任务规模，直接描述目标即可由总路由选择流程。

主要更新

• 统一全部 16 个技能为 superflow 命名空间，菜单明确标注总入口、阶段、分流和专项能力。
• 将交付合同、研发交接和代码实现分别命名为 superflow-contracts、superflow-handoff 和 superflow-build，减少职责混淆。
• 合并 SDD 与纯 OpenSpec 归档入口，自动选择流程；纯 OpenSpec 使用原生校验，SDD 状态缺失仍会阻断。
• Claude 菜单隐藏内部技能；Codex 保留显式访问并关闭内部技能的隐式触发，Prompt 菜单从 7 个收敛为 1 个。
• 接口变更标注纳入统一安装、更新与技能注册表，消除独立复制入口。
• 升级识别历史项目安装，按全部 24 个已发布标签的资产指纹备份移出原版旧技能；修改过、来源未知或符号链接资产保留并提示人工核对。

验证结果

• 107 个测试文件、973 项测试全部通过。
• Lint、构建、全局与托管设计门禁、严格技能审计通过（16/16，中英文镜像完整）。
• 32 份技能文件校验通过；0.5.20/0.5.21 真实资产的 16 个双语、双宿主、双作用域迁移场景通过。
• 隔离纯 OpenSpec 变更通过真实 Hook 与原生 CLI 归档，完成规格合并和目录搬迁；打包预览确认不含旧技能入口。

升级方式

npm install -g @chenmk/superflow@0.6.0 --registry https://registry.npmjs.org
superflow update --agent codex --scope global --language zh
# 使用 Claude Code 的用户选择：
superflow update --agent claude --scope global --language zh

项目级用户将 --scope global 改为 --scope project。更新后重启 Codex/Claude Code，加载新技能和 MCP；此前的旧技能名称及阶段 Prompt 不再支持。旧资产备份位于宿主目录的 .superflow-retired-assets，自定义资产需按提示人工核对。

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。

Superflow v0.5.21

Superflow 0.5.21

升级内容：0.5.20 → 0.5.21

升级摘要

让任务适用的工程规范贯穿技术详设、研发执行与独立评审，并提前识别数据量增长带来的处理成本风险。

主要更新

• Host 通过现有规则和技能发现机制实际阅读适用内容，把任务相关约束冻结到已有工程规则交接；Executor 与 Reviewer 使用相同规则，减少规范在跨会话交付时丢失。
• 技术详设、实现模板与评审清单补充数据规模、增长边界、处理成本、方案取舍和验证证据，验证深度与风险匹配，简单任务无需统一性能基准。
• 执行者和评审者发现源码存在明显规模风险但设计遗漏时，交回 Host 补齐并重新冻结合同，避免自行发明另一套方案。
• 同步中英文技能与模板；复用现有上下文清单、handoff 和托管合同，不新增状态机或个人目录扫描。

验证结果

• 全量回归 103 个测试文件、753 项测试通过，覆盖冻结合同、Executor/Reviewer 提示、实际 handoff 生成和既有流程兼容。
• TypeScript 构建、ESLint、全局设计与托管宪章门禁通过。
• 严格技能审计 16/16，通过中英文镜像检查；npm pack --dry-run 通过，402 个文件。
• 上述验证属于自动化提示生成、协议与流程测试；本版本未运行真实模型任务，不把静态测试视作模型行为保证。

升级方式

运行：superflow update --with-package --scope global --agent both
升级会刷新 CLI、Skills、Hooks、规则与托管 MCP；完成后重启 Codex/Claude 加载新技能与运行时。

发布产物核对补充

• npm 0.5.21 的指定版本与 latest 已确认，dist.shasum 为 53df60eed5c78bb2cdaf4f08d9799563f6a1ab7c。
• 最后交互式发布期间存在并发提交 9121983，实际 npm 包也包含“移除快速开发的三文件数量限制，保留风险检查”的变更。
• v0.5.21 已公开的标签仍指向 1ab92cc，不重写该标签；用户已确认保留实际发布包中的附加改动，0.5.22 等待更多功能统一发布。

Superflow v0.5.20

发布 Superflow 0.5.20

升级摘要

从 0.5.19 升级内容：修复独立 SQL 提交被交付检查误拦截的问题，让独立 SQL 变更可正常提交，同时保留运行时代码和活跃 SDD 文档的报告要求。

主要更新

• 独立 SQL 文件变更不再被错误要求提供 SDD test-report。
• 运行时代码变更，以及 SQL 与活跃 SDD 文档共同变更时，仍要求提交当前任务报告。
• 增加对应回归用例，覆盖放行与继续拦截的场景。

验证结果

• 全量测试通过：103 个测试文件、753 项测试。
• 构建、Lint、设计原则门禁和托管设计门禁通过。
• npm pack --dry-run 通过，产物包含 402 个文件。

升级方式

• npm install -g @chenmk/superflow@0.5.20

Superflow v0.5.19

Superflow 0.5.19：隔离 Git 回归夹具的宿主环境

升级摘要

升级内容：0.5.18 → 0.5.19。修正测试夹具读取真实宿主 Hook 和 Git 配置的问题，使维护验证可重复；生产证据门禁继续拒绝漏字段伪 PASS。

主要更新

• Git 初始化、配置、暂存、旧基线与后续提交统一使用隔离环境，阻止宿主 HOME、全局配置、仓库和索引变量泄漏。
• 进程内 Git Hook 审计限定同一测试环境并自动恢复；Codex/Claude 覆盖当前门禁、自定义脚本和未安装状态。
• 匿名 MyBatis/MySQL 回放同步隔离全部 Git 调用；保留自定义资产和原有生产断言。

验证结果

• 原五文件从 59 通过/1 失败恢复为 64 项通过；外部 Git 配置污染回归 8 项通过，独立复审通过。
• 完整测试 103 文件、750 项通过；Lint、构建、两项设计门禁及严格 Skill 审计 16/16、0 英文镜像缺口通过。
• 真实匿名 MySQL/Git 两宿主均旧基线退出 0、漏字段提交退出 1、正确 SQL 写入提交退出 0。
• npm pack dry-run 与正式包 402 文件；隔离安装、双语双宿主四次更新与自定义资产保留通过。

升级方式

• npm install -g @chenmk/superflow@0.5.19 --registry https://registry.npmjs.org
• superflow update --agent both --scope global；重启宿主加载资产。

English summary

Upgrade from 0.5.18 to 0.5.19. Isolate Git fixture HOME, XDG and inherited Git configuration/repository/index overrides across setup, staging, commits and synchronous audits. Both hosts cover current, custom and absent assets. Production evidence gates remain unchanged. Full suite: 103 files/750 passes; lint/build/design gates/strict audit and package installation passed. Real anonymous MySQL/Git rejects omitted writes (exit 1) and accepts correct SQL (exit 0). Receipt authenticity and semantic sufficiency still require independent review.

Superflow v0.5.18

Superflow 0.5.18：数据库测试分层与旧Git入口修复

升级内容：0.5.17 → 0.5.18

升级摘要

让数据库改动的验收按层级、生产SQL与真实引擎落实，并把旧项目Git提交接到当前校验链。

主要更新

• 保留Mock单测的逻辑隔离价值；分别冻结SQL生成/绑定、真实DB集成、HTTP入口，必要MySQL不能由Mock/H2/SQLite替代。
• 既有coverage/receipt扩展引擎版本、schema、生产statement、mock边界与行快照；严格区分JSON布尔和数字，历史证据绑定其已验证源码版本。
• 已知旧SDD脚本备份后仅委托当前规范门禁；未知/自定义/符号链接保留，skip-existing保持。doctor核对当前包内容、执行位、实际Git Hook与core.hooksPath。
• 根报告假PASS不再降为warning；tracked receipt/raw/build/source/schema依赖对账实际Git index，暂存删除不能冒充私有新证据。私有未跟踪日志不强制入Git。

验证结果

• 103个测试文件，746项通过；Lint、构建、设计门禁及strict Skill审计16/16、0英文缺口通过。
• 原创匿名MyBatis/MySQL8.0.36：Mock绿但漏字段XML更新1行后仍NULL，原始断言失败；正式Git两宿主均拒绝伪PASS，完整SQL写入证据允许提交。
• 定向与整分支独立复审发现并关闭快照、JSON类型、index依赖、暂存删除、悬空文件/注册、标准路由识别问题。
• 包内资产检查及安装回放覆盖双宿主、中英文、重复更新、自定义保留及旧入口实际执行。

升级方式

npm install -g @chenmk/superflow@0.5.18 --registry https://registry.npmjs.org
superflow update --scope global --agent both
superflow doctor <项目目录>

升级后重启宿主。未知自定义入口保留并交owner核验；若项目实际引用未知旧脚本，doctor会诊断，不能只以同名/日期声称已自动接入。SQL/测试充分性仍由独立Agent语义审查，结构/hash不是防伪或业务正确性保证。

Upgrade Summary

Changes since 0.5.17: layered database evidence and current Git gate integration in 0.5.18.

Highlights

• Keep Mock logic tests; freeze SQL binding, same-engine database and HTTP obligations separately. Required MySQL proof cannot use substitute Mock/H2/SQLite.
• Extend existing coverage/receipts with engine/schema/statement/mock boundaries and keyed row observations. Historical evidence retains its verified source/build scope.
• Back up known legacy scripts and delegate to canonical gates. Preserve unknown/custom/symlink entries; diagnose effective Git routing, execution and package-content drift.
• Reject root false PASS and index/dependency mismatch, including staged deletion. Private untracked evidence remains local.

Validation

• 746 tests in 103 files, lint/build/design gates and 16/16 strict Skill contracts passed.
• Actual anonymous MyBatis/MySQL and Git positive/negative replay covered both hosts; independent findings were fixed and re-reviewed.
• Package closure and repeated bilingual host installation preserve custom entries.

Upgrade

Install @chenmk/superflow@0.5.18 from the official registry, run superflow update for installed hosts and doctor for projects, then restart the host. Unknown entries require owner review. CLI facts and hashes do not replace semantic review.

Superflow v0.5.17

Superflow 0.5.17：逐入口执行证据与持久化验收修复

升级内容：0.5.16 → 0.5.17

升级摘要

修复测试报告有文件就通过、不同服务入口替代、零执行成功和历史汇总误判，让完整 SDD 交付可按用例复核。

主要更新

• 每个 PASS 绑定本地执行凭证、原始输出、服务与路由、命令退出码和实际执行数；空文件、远端链接、SKIP 与入口错配不能交付。
• 源码、构建产物与运行目标使用同一指纹；原始日志上下文不一致或同构建 ID 成败冲突会拒绝。
• 持久化字段冻结同业务 ID 调用前后值及预期断言；结构存在、mock 参数与全 NULL 不再替代写入证据。精确 Mapper 与业务语义仍由独立评审核验。
• 保留 PARTIAL 历史，以最终一致汇总决定完整交付；轻量文档不强加数据库要求。CLI、托管最终检查、Codex/Claude 安装脚本同源，更新记录正确版本并保留自定义状态。

验证结果

• 98 个测试文件、690 项测试全部通过；Lint、构建、全局与托管设计门禁通过。
• 严格 Skill 审计 16/16 合同、0 英文镜像缺口；npm 包内容检查通过。
• 匿名双入口 HTTP + 临时 SQLite 回放：完整写入通过，漏写与入口替代拒绝；临时服务清理完成。
• 隔离包安装：Codex/Claude × 中英文，4 次重复更新，自定义资产保留；安装版本正式 CLI 与 guard 正反例通过。

升级方式

npm install -g @chenmk/superflow@0.5.17 --registry https://registry.npmjs.org
superflow update --scope global --agent both

旧完整报告缺执行凭证时保留 PARTIAL，按冻结合同补齐受影响证据。更新后重启宿主会话加载新 Skill/Hook/MCP；哈希只证明身份，不保证日志防伪或业务正确性。

Upgrade Summary

Changes since 0.5.16: per-entry replayable evidence and persistence acceptance fixes in 0.5.17.

Highlights

• Bind each PASS to raw execution, service/route, command exit/count and current source/build/runtime identity. Reject empty files, remote links, skipped or substituted entries.
• Compare frozen persistence expectations with before/after values for the same business ID. Retain partial history without promoting incomplete delivery.
• Use current-installation scripts across CLI, managed gates, Codex and Claude. Refresh deployment version metadata while preserving custom state.

Validation

• 690 tests in 98 files, lint/build/design gates and 16/16 strict Skill contracts passed.
• Anonymous HTTP/SQLite replay and repeated bilingual dual-host package installation covered successful and failing evidence, custom preservation and installed CLI/guard behavior.

Upgrade

Install @chenmk/superflow@0.5.17 from the official npm registry and run superflow update for the installed hosts. Restart the host to load updated Skills/Hooks/MCP. Legacy receipts remain partial until affected evidence is completed. Independent review still owns code semantics and evidence sufficiency.

Superflow v0.5.16

Superflow 0.5.16：安装更新自动清理旧全局 Hook

升级内容：v0.5.15 → v0.5.16。

升级摘要

将 0.5.15 的手动全局旧 Hook 迁移接入标准安装和更新闭环，避免其他用户在项目缺少旧 scripts/hooks 脚本时继续遇到 Hook 127。

主要更新

• npm 全局安装的 postinstall 自动清理白名单内旧全局相对路径 Hook，修改前备份 Codex 与 Claude 配置，保留未知及自定义注册。
• superflow init、恢复安装与 update 自动执行同一迁移；项目级操作也处理会在项目中触发的全局旧注册，重复执行不改写。
• 配置损坏或迁移失败时安装/更新失败关闭；doctor 将残留的已知旧全局 Hook 标为失败并提供修复命令。

验证结果

• 96 个测试文件、666 个用例通过；构建、ESLint、设计门禁与 skill-audit --strict 通过。
• 隔离 HOME 的真实 npm 全局 tarball 安装自动清理两宿主旧 stop-compile-check.sh，保留自定义 Hook，各生成一次备份，CLI 返回 0.5.16。
• 全局/项目安装、恢复、全局/项目更新、重复更新、no-hooks 和损坏配置回归通过；npm pack --dry-run 含 postinstall 与迁移实现。

升级方式

运行 npm install -g @chenmk/superflow@0.5.16，再执行 superflow init 或 superflow update --agent both --scope global 同步完整 Skill、Hook 与 MCP 资产。普通 npm 全局安装会在 postinstall 自动迁移已知旧全局注册；使用 --ignore-scripts 的安装需随后运行 init/update。配置备份留在原文件同目录；重启 Codex 与 Claude 使当前进程重新读取 Hook。