@chenmk/superflow 0.5.5 → 0.5.7

package/INSTALL.en.md

@@ -8,7 +8,7 @@ aliases, scripts, rules, and handoff state for Claude Code and Codex.
 ## 1. Install
 
 ```bash
-npx --yes --package=@chenmk/superflow@latest superflow-install
+npx --yes --package=@chenmk/superflow@0.5.6 superflow-install
 ```
 
 > **Node.js requirement:** Node.js 20 or later is required. If `node -v` is older,

package/INSTALL.md

@@ -43,7 +43,7 @@ docs -> design -> implement -> verify -> archive
 ### 2.1 npm 全局安装（推荐给普通用户）
 
 ```bash
-npx --yes --package=@chenmk/superflow@latest superflow-install
+npx --yes --package=@chenmk/superflow@0.5.6 superflow-install
 superflow --version
 ```
 
@@ -51,7 +51,7 @@ superflow --version
 
 ```bash
 npm config set registry https://registry.npmmirror.com
-npx --yes --package=@chenmk/superflow@latest superflow-install
+npx --yes --package=@chenmk/superflow@0.5.6 superflow-install
 ```
 
 ### 2.2 从源码安装（贡献者或本地调试）
@@ -669,7 +669,7 @@ superflow pipeline --agent codex
 
 | 场景 | 命令 |
 |------|------|
-| 安装 CLI | `npx --yes --package=@chenmk/superflow@latest superflow-install` |
+| 安装 CLI | `npx --yes --package=@chenmk/superflow@0.5.6 superflow-install` |
 | 初始化并选择工具 | `superflow init` |
 | 非交互初始化两侧 | `superflow init --yes` |
 | 检查健康 | `superflow doctor` |

package/README.md

@@ -151,7 +151,7 @@ Each phase has a clear owner and an exit gate:
 ## Install
 
 ```bash
-npx --yes --package=@chenmk/superflow@latest superflow-install
+npx --yes --package=@chenmk/superflow@0.5.6 superflow-install
 ```
 
 > **Node.js requirement:** Node.js 20 or later is required. On an older runtime,
@@ -195,6 +195,17 @@ superflow pipeline "<prompt path, change directory, or task>" --managed \
   --project "<project root>" --supervisor current --executor peer
 ```
 
+For a prompt path or SDD change, also pass a Host-authored frozen acceptance
+contract. Its JSON declares business invariants, existing repository-relative
+source coverage, deliverables, verification, and exclusions; start fails closed
+without it.
+
+```bash
+superflow pipeline "<prompt path or change directory>" --managed \
+  --project "<project root>" --acceptance-contract ./acceptance-contract.json \
+  --supervisor current --executor peer
+```
+
 The selected language is frozen into the task contract and reused by Agent
 prompts, reviews, journals, reports, notifications, and resumed rounds.
 The first executor invocation runs continuously without a Superflow tool-turn
@@ -315,6 +326,7 @@ best-effort and does not block initialization.
 | `superflow scan --language en`                               | Regenerate project context templates in English                          |
 | `superflow pipeline`                                         | Check pipeline skill deployment                                          |
 | `superflow pipeline "<task>" --managed --project <path>`     | Run short-session execution with direct review by the current host agent |
+| `--acceptance-contract <file>`                                | Required frozen acceptance JSON for prompt/SDD starts                    |
 | `superflow docs [change]`                                    | Run the docs gate and check the phase skill                              |
 | `superflow design`                                           | Check design-phase skill deployment                                      |
 | `superflow implement [change]`                               | Create a current Coding Ready receipt before implementation              |

package/README.zh-CN.md

@@ -100,7 +100,7 @@ docs -> design -> implement -> verify -> archive
 ## 安装
 
 ```bash
-npx --yes --package=@chenmk/superflow@latest superflow-install
+npx --yes --package=@chenmk/superflow@0.5.6 superflow-install
 # 或本地源码：
 # git clone https://github.com/.../superflow-cli && cd superflow-cli && bash install.sh
 ```
@@ -112,7 +112,7 @@ npx --yes --package=@chenmk/superflow@latest superflow-install
 从源码执行 `bash install.sh` 时，会检测本机已有的 Codex、Claude，并一次完成
 CLI、Skills/Hooks 与对应托管 MCP 注册；安装后重启检测到的 Agent 即可。
 
-> **💡 装完即全局生效，无需逐项目 init**：`npx --yes --package=@chenmk/superflow@latest superflow-install`（或 `bash install.sh`）会自动把 superflow hooks 注册到 `~/.claude/settings.json`（全局），**本机上所有项目仓库**都获得 superflow 守门。钩子内部靠 `.sdd-enforced` 标记懒激活（没跑 `superflow clarify` 之前所有钩子静默放行，零干扰）。
+> **💡 装完即全局生效，无需逐项目 init**：`npx --yes --package=@chenmk/superflow@0.5.6 superflow-install`（或 `bash install.sh`）会自动把 superflow hooks 注册到 `~/.claude/settings.json`（全局），**本机上所有项目仓库**都获得 superflow 守门。钩子内部靠 `.sdd-enforced` 标记懒激活（没跑 `superflow clarify` 之前所有钩子静默放行，零干扰）。
 >
 > 只有需要项目级产物（OpenSpec change 目录 / `.sdd/` 任务文件 / 团队约定）时，才在项目根目录跑 `superflow init`。**绝大多数项目不需要这一步**——hooks 已经在全局生效了。
 
@@ -158,6 +158,15 @@ superflow pipeline "<prompt 路径、change 目录或任务>" --managed \
   --project "<项目根目录>" --supervisor current --executor peer
 ```
 
+Prompt 路径或 SDD change 启动还必须传入由 Host 编写的冻结验收合同：JSON 内声明业务不变量、
+启动时已存在的仓库内源码覆盖路径、交付物、验证和排除范围；缺失即失败关闭。
+
+```bash
+superflow pipeline "<prompt 路径或 change 目录>" --managed \
+  --project "<项目根目录>" --acceptance-contract ./acceptance-contract.json \
+  --supervisor current --executor peer
+```
+
 语言会冻结进任务合同；执行 Prompt、评审、账本、报告、通知和恢复轮次保持一致。
 执行 Agent 每轮使用全新短会话；当前 Host Agent 直接评审，不再由后台启动第二个同名
 CLI。首轮自动使用冻结任务 Prompt，后续每轮生成压缩交接包，因此旧会话或新会话均能从
@@ -258,6 +267,7 @@ MCP 是主 Agent 与本地托管状态机的通信通道，不会把 Superflow
 | `superflow implement [change]`                               | 生成当前 Coding Ready 凭证后进入实现阶段                    |
 | `superflow pipeline`                                         | 校验 SuperBridge Flow pipeline 阶段技能部署                 |
 | `superflow pipeline "<任务>" --managed --project <目录>`     | 执行 Agent 短会话开发，当前 Host Agent 直接评审             |
+| `--acceptance-contract <文件>`                                | Prompt/SDD 启动必填的冻结验收合同 JSON                      |
 | `superflow check <change> --level files\|docs\|coding-ready` | 分级检查文件、文档交付或可直接编码就绪度                    |
 | `superflow config <change> --review-mode <mode>`             | 设置代码审查强度（off/standard/thorough）                   |
 | `superflow config <change> --auto-transition <bool>`         | 控制阶段自动流转（true/false）                              |