@chenmk/superflow 0.5.2 → 0.5.4

package/INSTALL.en.md

@@ -8,7 +8,7 @@ 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,

package/INSTALL.md

@@ -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,7 +151,7 @@ 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,

package/README.zh-CN.md

@@ -100,7 +100,7 @@ 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
 ```
@@ -112,7 +112,7 @@ npm install -g @chenmk/superflow
 从源码执行 `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,68 @@
+#!/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 use --delete-prefix 20 --silent || true`,
+    `nvm install `,
+    `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.2",
+  "version": "0.5.4",
   "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

@@ -23,12 +23,12 @@ export function buildNodeVersionMessage(version, language) {
     return [
       `[Superflow] 需要 Node.js ${MIN_NODE_MAJOR} 或更高版本，当前检测到 ${version}。`,
       '',
-      '请先升级到 Node.js 20；Superflow 不会自动修改你的系统 Node。',
+      '请先升级到 Node.js 20；请改用一键安装器；它会自动安装并设定 Node.js 20。',
       '若已安装 nvm，请运行：',
       commands,
       '',
       '完成后重新打开终端，再运行：',
-      '  npm install -g @chenmk/superflow',
+      '  npx --yes --package=@chenmk/superflow@latest superflow-install',
       '未安装 nvm 时，请用系统包管理器或 https://nodejs.org 安装 Node.js 20。',
     ].join('\n');
   }
@@ -36,12 +36,12 @@ export function buildNodeVersionMessage(version, language) {
   return [
     `[Superflow] Node.js ${MIN_NODE_MAJOR} or later is required; detected ${version}.`,
     '',
-    'Install Node.js 20 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',
+    '  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');
 }