@chenmk/superflow 0.5.1 → 0.5.3

package/INSTALL.en.md

@@ -8,12 +8,12 @@ aliases, scripts, rules, and handoff state for Claude Code and Codex.
 ## 1. Install
 
 ```bash
-npm install -g @chenmk/superflow
+npx --yes --package=@chenmk/superflow@latest superflow-install
 ```
 
 > **Node.js requirement:** Node.js 20 or later is required. If `node -v` is older,
 > installation stops before command aliases are created. With nvm, run
-> `nvm install 22 && nvm use 22 && nvm alias default 22`, open a new terminal, and reinstall.
+> `nvm install 20 && nvm use 20 && nvm alias default 20`, open a new terminal, and reinstall.
 
 The repository `install.sh` and `install.ps1` scripts detect the Codex/Claude
 Hosts actually installed and register their managed MCP entries together with

package/INSTALL.md

@@ -29,7 +29,7 @@ docs -> design -> implement -> verify -> archive
 | Python | hook 中的 Python 脚本需要 | `python3 --version` |
 
 > **Node 版本不足：** 安装会在创建命令前停止。若已安装 nvm，运行
-> `nvm install 22 && nvm use 22 && nvm alias default 22`，重新打开终端后再安装。
+> `nvm install 20 && nvm use 20 && nvm alias default 20`，重新打开终端后再安装。
 
 支持系统：
 
@@ -43,7 +43,7 @@ docs -> design -> implement -> verify -> archive
 ### 2.1 npm 全局安装（推荐给普通用户）
 
 ```bash
-npm install -g @chenmk/superflow
+npx --yes --package=@chenmk/superflow@latest superflow-install
 superflow --version
 ```
 
@@ -51,7 +51,7 @@ superflow --version
 
 ```bash
 npm config set registry https://registry.npmmirror.com
-npm install -g @chenmk/superflow
+npx --yes --package=@chenmk/superflow@latest superflow-install
 ```
 
 ### 2.2 从源码安装（贡献者或本地调试）
@@ -669,7 +669,7 @@ superflow pipeline --agent codex
 
 | 场景 | 命令 |
 |------|------|
-| 安装 CLI | `npm install -g @chenmk/superflow` |
+| 安装 CLI | `npx --yes --package=@chenmk/superflow@latest superflow-install` |
 | 初始化并选择工具 | `superflow init` |
 | 非交互初始化两侧 | `superflow init --yes` |
 | 检查健康 | `superflow doctor` |

package/README.md

@@ -151,11 +151,11 @@ Each phase has a clear owner and an exit gate:
 ## Install
 
 ```bash
-npm install -g @chenmk/superflow
+npx --yes --package=@chenmk/superflow@latest superflow-install
 ```
 
 > **Node.js requirement:** Node.js 20 or later is required. On an older runtime,
-> installation stops before command aliases are created and prints Node 22 upgrade instructions.
+> installation stops before command aliases are created and prints Node 20 upgrade instructions.
 
 For a source checkout, `bash install.sh` detects installed Codex, Claude, and
 Codex and Claude Hosts and installs CLI, Skills/Hooks, and their managed MCP registrations

package/README.zh-CN.md

@@ -100,19 +100,19 @@ docs -> design -> implement -> verify -> archive
 ## 安装
 
 ```bash
-npm install -g @chenmk/superflow
+npx --yes --package=@chenmk/superflow@latest superflow-install
 # 或本地源码：
 # git clone https://github.com/.../superflow-cli && cd superflow-cli && bash install.sh
 ```
 
-> **Node.js 要求：** 需要 Node.js 20+。版本不足时，安装会在创建命令前停止，并打印 Node 22 的升级和重装指引。
+> **Node.js 要求：** 需要 Node.js 20+。版本不足时，安装会在创建命令前停止，并打印 Node 20 的升级和重装指引。
 
 完整安装、初始化和日常使用教程见 [INSTALL.md](./INSTALL.md)。
 
 从源码执行 `bash install.sh` 时，会检测本机已有的 Codex、Claude，并一次完成
 CLI、Skills/Hooks 与对应托管 MCP 注册；安装后重启检测到的 Agent 即可。
 
-> **💡 装完即全局生效，无需逐项目 init**：`npm install -g @chenmk/superflow`（或 `bash install.sh`）会自动把 superflow hooks 注册到 `~/.claude/settings.json`（全局），**本机上所有项目仓库**都获得 superflow 守门。钩子内部靠 `.sdd-enforced` 标记懒激活（没跑 `superflow clarify` 之前所有钩子静默放行，零干扰）。
+> **💡 装完即全局生效，无需逐项目 init**：`npx --yes --package=@chenmk/superflow@latest superflow-install`（或 `bash install.sh`）会自动把 superflow hooks 注册到 `~/.claude/settings.json`（全局），**本机上所有项目仓库**都获得 superflow 守门。钩子内部靠 `.sdd-enforced` 标记懒激活（没跑 `superflow clarify` 之前所有钩子静默放行，零干扰）。
 >
 > 只有需要项目级产物（OpenSpec change 目录 / `.sdd/` 任务文件 / 团队约定）时，才在项目根目录跑 `superflow init`。**绝大多数项目不需要这一步**——hooks 已经在全局生效了。
 

package/installer/bin/superflow-installer.cjs

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawnSync } = require('child_process');
+const { existsSync } = require('fs');
+const { join } = require('path');
+
+const NODE_MIN = 20;
+const MAIN = '@chenmk/superflow@latest';
+const NVM_URL = 'https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.7/install.sh';
+
+function run(command, args, options) {
+  const result = spawnSync(command, args, { stdio: 'inherit', ...options });
+  if (result.error) throw result.error;
+  if (result.status !== 0) throw new Error(`${command} failed with ${result.status}`);
+}
+
+function major(version) {
+  const match = String(version || '').match(/^v?(\d+)/);
+  return match ? Number(match[1]) : 0;
+}
+
+function main() {
+  console.log('[Superflow] Starting one-command installation...');
+  if (major(process.version) >= NODE_MIN) {
+    run(process.platform === 'win32' ? 'npm.cmd' : 'npm', ['install', '-g', MAIN,
+      '--registry', 'https://registry.npmjs.org']);
+    return;
+  }
+  if (process.platform === 'win32') {
+    run('winget', ['install', '--id', 'OpenJS.NodeJS', '--exact', '--source', 'winget',
+      '--accept-package-agreements', '--accept-source-agreements']);
+    const npm = join(process.env.ProgramFiles || 'C:\\Program Files', 'nodejs', 'npm.cmd');
+    if (!existsSync(npm)) throw new Error('Node installed; reopen terminal and rerun this command.');
+    run(npm, ['install', '-g', MAIN, '--registry', 'https://registry.npmjs.org']);
+    return;
+  }
+  const home = process.env.HOME;
+  if (!home) throw new Error('HOME is required to install Node.js.');
+  const nvm = process.env.NVM_DIR || join(home, '.nvm');
+  const script = [
+    'set -e',
+    'export NVM_DIR="$SUPERFLOW_NVM_DIR"',
+    'if [ ! -s "$NVM_DIR/nvm.sh" ]; then',
+    `  curl -fsSL "${NVM_URL}" | bash`,
+    'fi',
+    '. "$NVM_DIR/nvm.sh"',
+    `nvm install ${NODE_MIN}`,
+    `nvm use --delete-prefix ${NODE_MIN}`,
+    `nvm alias default ${NODE_MIN}`,
+    `npm install -g "${MAIN}" --registry https://registry.npmjs.org`,
+    'superflow --version',
+  ].join('\n');
+  run('bash', ['-lc', script], { env: { ...process.env, SUPERFLOW_NVM_DIR: nvm } });
+}
+
+if (require.main === module) {
+try {
+  main();
+  console.log('[Superflow] Installation complete. Restart your terminal before using Superflow.');
+} catch (error) {
+  console.error(`[Superflow] Installation failed: ${error.message}`);
+  process.exitCode = 1;
+}
+
+}
+module.exports = { major };

package/installer/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@chenmk/superflow-installer",
+  "version": "0.1.0",
+  "description": "One-command Node and Superflow installer",
+  "license": "MIT",
+  "main": "bin/superflow-installer.js",
+  "bin": {
+    "superflow-installer": "bin/superflow-installer.js"
+  },
+  "files": ["bin", "README.md"],
+  "engines": { "node": ">=14" },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chenmk/superflow",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "SuperBridge Flow workflow CLI for Claude Code and Codex",
   "license": "MIT",
   "type": "module",
@@ -23,10 +23,12 @@
   },
   "bin": {
     "superflow": "dist/app/cli.js",
-    "superflow-mcp": "dist/mcp/server.js"
+    "superflow-mcp": "dist/mcp/server.js",
+    "superflow-install": "installer/bin/superflow-installer.cjs"
   },
   "files": [
     "dist",
+    "installer",
     "scripts",
     "assets",
     "README.md",
@@ -40,7 +42,6 @@
     "prebuild": "npm run check:design-principles && npm run check:managed-design",
     "build": "node scripts/clean-dist.js && tsc && node scripts/ensure-bin-modes.js",
     "dev": "tsx watch src/cli/index.ts",
-    "preinstall": "node scripts/preinstall.js",
     "postinstall": "node scripts/postinstall.js",
     "prepack": "npm run build",
     "prepublishOnly": "npm run release:check && npm test && npm run build",

package/scripts/preinstall.js

@@ -14,35 +14,35 @@ export function isSupportedNode(version) {
 
 export function buildNodeVersionMessage(version, language) {
   const commands = [
-    '  nvm install 22',
-    '  nvm use 22',
-    '  nvm alias default 22',
+    '  nvm install 20',
+    '  nvm use 20',
+    '  nvm alias default 20',
   ].join('\n');
 
   if (language === 'zh') {
     return [
       `[Superflow] 需要 Node.js ${MIN_NODE_MAJOR} 或更高版本，当前检测到 ${version}。`,
       '',
-      '请先升级到 Node.js 22 LTS；Superflow 不会自动修改你的系统 Node。',
+      '请先升级到 Node.js 20；请改用一键安装器；它会自动安装并设定 Node.js 20。',
       '若已安装 nvm，请运行：',
       commands,
       '',
       '完成后重新打开终端，再运行：',
-      '  npm install -g @chenmk/superflow',
-      '未安装 nvm 时，请用系统包管理器或 https://nodejs.org 安装 Node.js 22 LTS。',
+      '  npx --yes --package=@chenmk/superflow@latest superflow-install',
+      '未安装 nvm 时，请用系统包管理器或 https://nodejs.org 安装 Node.js 20。',
     ].join('\n');
   }
 
   return [
     `[Superflow] Node.js ${MIN_NODE_MAJOR} or later is required; detected ${version}.`,
     '',
-    'Install Node.js 22 LTS first. Superflow never changes your system Node automatically.',
+    'Install Node.js 20 first. Use the one-command installer to install and set Node.js 20 automatically.',
     'If nvm is already installed, run:',
     commands,
     '',
     'Open a new terminal, then rerun:',
-    '  npm install -g @chenmk/superflow',
-    'Without nvm, use your system package manager or https://nodejs.org to install Node.js 22 LTS.',
+    '  npx --yes --package=@chenmk/superflow@latest superflow-install',
+    'Without nvm, use your system package manager or https://nodejs.org to install Node.js 20.',
   ].join('\n');
 }