@chenmk/superflow 0.2.3 → 0.2.4

package/README.md

@@ -81,6 +81,16 @@ state, and dependency guards for Claude Code, Codex, and OpenCode.
   required: `> use SuperFlow to handle this requirement` triggers clarify →
   docs → design → implement → verify → archive. Phase progression, guards,
   hashes, and hooks are flow-enforced, not user-discipline.
+- **`superflow check` audits document completeness.** Runs against a 13-item
+  required-file checklist per change. Missing a required doc? Exit 1. No more
+  surprises at the implement phase — the gate catches gaps while you're still
+  in docs.
+- **`superflow config` tunes review depth per change.** `--review-mode
+  off|standard|thorough` controls code-review intensity; `--auto-transition`
+  controls automatic phase progression. Match the rigor to the risk.
+- **Startup version check.** Every superflow command silently compares your
+  installed version against the npm registry. A new version triggers a
+  non-blocking upgrade hint on stderr.
 
 ## Workflow
 
@@ -165,6 +175,11 @@ best-effort and does not block initialization.
 | `superflow implement` | Check implement-phase skill deployment |
 | `superflow verify` | Check verify-phase skill deployment |
 | `superflow archive` | Check archive-phase skill deployment |
+| `superflow check <change>` | Audit 13-file SDD document completeness |
+| `superflow config <change> --review-mode <mode>` | Set review depth (off/standard/thorough) |
+| `superflow config <change> --auto-transition <bool>` | Toggle automatic phase progression |
+| `superflow status` | List active changes with phase, tasks, and doc gaps |
+| `superflow update --with-package` | Update superflow, OpenSpec, and Superpowers |
 
 ## Agent Usage
 

package/README.zh-CN.md

@@ -50,6 +50,9 @@ CLI 会把 SuperBridge Flow 技能、配套 hook/command 脚本整合为单一 n
 - **5 个阶段 × 5+ 门禁脚本硬阻断。** `superflow-guard.sh` + `superflow-hook-guard.sh` + `superflow-contract-hooks.sh` + `superflow-sql-sync-hook.py` + `superflow-test-report-lint.py` + `superflow-verify-integration.sh`。没有 handoff hash 不进实现，没有真实入口证据不写"通过"。
 - **用 handoff + state + sha256 治上下文漂移。** 长会话压缩、切 agent、并行 worktree——`.sdd/handoff/sdd-context.{md,json}` + sha256 + `.sdd/state.yaml` 让 Worker / Tester / Reviewer 始终基于同一份上下文，hash 对不上的旧 prompt 自动被 guard 拒绝。
 - **用户只说一句话，流水线跑 9 步。** 不用写复杂 prompt：`> 用 SuperFlow 处理这个需求` 触发 clarify → docs → design → implement → verify → archive。阶段推进、guard、hash、hook 全是流程强制，不靠用户自觉。
+- **`superflow check` 一键诊断文档缺口。** 对照 13 项必备 SDD 文件逐项核验，缺失即 exit 1。再也不会进了 implement 才发现 proposal 没写——check 在 docs 阶段就拦住你。
+- **`superflow config` 按需调整审查强度。** `--review-mode off|standard|thorough` 控制代码审查深度；`--auto-transition` 控制阶段自动流转。不同改动匹配不同强度，省 token 不省质量。
+- **启动自动检查新版本。** 每次执行 superflow 命令，后台静默对比 npm registry。发现新版本时 stderr 输出升级提示，不阻塞、不拖慢。
 
 ## 工作流
 
@@ -141,6 +144,11 @@ superflow init
 | `superflow design [change]` | 校验 SuperBridge Flow design 阶段技能部署 |
 | `superflow implement [task]` | 校验 SuperBridge Flow implement 阶段技能部署 |
 | `superflow pipeline` | 校验 SuperBridge Flow pipeline 阶段技能部署 |
+| `superflow check <change>` | 对照 13 项必备文件清单检查文档完整性 |
+| `superflow config <change> --review-mode <mode>` | 设置代码审查强度（off/standard/thorough） |
+| `superflow config <change> --auto-transition <bool>` | 控制阶段自动流转（true/false） |
+| `superflow status` | 展示所有 active change 的阶段、任务、文档缺口 |
+| `superflow update --with-package` | 更新 superflow 自身和 openspec/superpowers 依赖 |
 
 ## 系统支持
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chenmk/superflow",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "SuperBridge Flow workflow CLI for Claude Code, Codex, and OpenCode",
   "license": "MIT",
   "type": "module",
@@ -27,6 +27,7 @@
   },
   "files": [
     "dist",
+    "scripts",
     "assets",
     "README.md",
     "README.zh-CN.md",
@@ -36,6 +37,7 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsx watch src/cli/index.ts",
+    "postinstall": "node scripts/postinstall.js",
     "prepack": "npm run build",
     "prepublishOnly": "npm test && npm run build",
     "test": "vitest run",

package/scripts/postinstall.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { readFileSync } from 'fs';
+import { fileURLToPath, pathToFileURL } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pkgPath = join(__dirname, '..', 'package.json');
+const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+
+const LANGUAGE_ZH = 'zh';
+const LANGUAGE_EN = 'en';
+
+export function isGlobalInstall(env = process.env) {
+  return env.npm_config_global === 'true';
+}
+
+export function resolveInstallLanguage(env = process.env) {
+  const lang = env.SUPERFLOW_LANG || env.LC_ALL || env.LANG || '';
+  const normalized = lang.toLowerCase();
+  if (normalized.includes('zh') || normalized.includes('cn')) return LANGUAGE_ZH;
+  if (normalized.includes('en')) return LANGUAGE_EN;
+  return LANGUAGE_ZH;
+}
+
+export function buildInstallMessage(version, language) {
+  if (language === LANGUAGE_ZH) {
+    return [
+      `✅ @chenmk/superflow v${version} 安装成功`,
+      '',
+      '   快速开始：',
+      '     superflow init              # 在当前项目初始化',
+      '     superflow --help            # 查看全部命令',
+    ].join('\n');
+  }
+  return [
+    `✅ @chenmk/superflow v${version} installed successfully`,
+    '',
+    '   Quick start:',
+    '     superflow init              # Initialize in current project',
+    '     superflow --help            # Show all commands',
+  ].join('\n');
+}
+
+function printInstallMessage(version, language) {
+  console.log(buildInstallMessage(version, language));
+}
+
+export function runPostinstall(env = process.env) {
+  if (!isGlobalInstall(env)) return;
+  printInstallMessage(pkg.version, resolveInstallLanguage(env));
+}
+
+if (import.meta.url === pathToFileURL(process.argv[1]).href) {
+  runPostinstall();
+}