@mfjjs/ruflo-setup 0.2.6 → 0.2.8

package/src/status.js

@@ -40,12 +40,11 @@ function fileExists(p) {
   }
 }
 
-// Flatten npm/pnpm --json list result into a name->version map (1 level deep).
+// Flatten pnpm --json list result into a name->version map (1 level deep).
 function buildPkgMap(jsonText) {
   const map = {};
   try {
     const parsed = JSON.parse(jsonText || '{}');
-    // npm list -g returns an array with one element, pnpm returns an object
     const root = Array.isArray(parsed) ? parsed[0] : parsed;
     const deps = root?.dependencies ?? {};
     for (const [name, info] of Object.entries(deps)) {
@@ -60,13 +59,7 @@ function buildPkgMap(jsonText) {
   return map;
 }
 
-// Tries npm list -g first, falls back to pnpm list -g.
 function getGlobalPkgMap() {
-  const npmRes = spawn('npm', ['list', '-g', '--depth=1', '--json']);
-  if (npmRes.status === 0 && npmRes.stdout) {
-    const m = buildPkgMap(npmRes.stdout);
-    if (Object.keys(m).length > 0) return m;
-  }
   const pnpmRes = spawn('pnpm', ['list', '-g', '--depth=1', '--json']);
   if (pnpmRes.status === 0 && pnpmRes.stdout) {
     return buildPkgMap(pnpmRes.stdout);
@@ -95,7 +88,7 @@ function checkLayer0() {
     const ver = (claudeRes.stdout || '').trim();
     lines.push(`  ${OK} Claude Code CLI${ver ? `  ${ver}` : ''}`); ok += 1;
   } else {
-    lines.push(`  ${MISS} Claude Code CLI  (install: npm install -g @anthropic-ai/claude-code)`);
+    lines.push(`  ${MISS} Claude Code CLI  (install: pnpm add -g @anthropic-ai/claude-code)`);
   }
 
   if (process.env.ANTHROPIC_API_KEY) {
@@ -113,7 +106,7 @@ function checkLayer1(pkgMap) {
   for (const name of ['ruflo', '@mfjjs/ruflo-setup']) {
     const ver = pkgMap[name];
     if (ver) { lines.push(`  ${OK} ${name}${typeof ver === 'string' ? `@${ver}` : ''}`); ok += 1; }
-    else { lines.push(`  ${MISS} ${name}  (install: npm install -g ${name})`); }
+    else { lines.push(`  ${MISS} ${name}  (install: pnpm add -g ${name})`); }
   }
   return { lines, ok, total: 2 };
 }
@@ -268,7 +261,7 @@ export async function runStatus({ cwd, packageRoot }) {
 
     const layers = [
       { title: 'Layer 0: Prerequisites', result: checkLayer0() },
-      { title: 'Layer 1: Global npm Packages', result: checkLayer1(pkgMap) },
+      { title: 'Layer 1: Global Packages', result: checkLayer1(pkgMap) },
       { title: 'Layer 2: Optional Packages (WASM/ML)  — enables AI features', result: checkLayer2(pkgMap) },
       { title: 'Layer 3: MCP Servers (.mcp.json)', result: checkLayer3(mcpJson) },
       { title: 'Layer 4: MCP Tool Groups', result: checkLayer4(mcpJson) },

package/src/utils.js

@@ -1,120 +1,120 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import readline from 'node:readline';
-
-export function pathExists(filePath) {
-  return fs.existsSync(filePath);
-}
-
-export function readJsonSafe(filePath, fallbackValue = {}) {
-  if (!pathExists(filePath)) {
-    return fallbackValue;
-  }
-  try {
-    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
-  } catch {
-    return fallbackValue;
-  }
-}
-
-export function writeJson(filePath, value) {
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
-}
-
-export function copyFileSync(src, dest) {
-  fs.mkdirSync(path.dirname(dest), { recursive: true });
-  fs.copyFileSync(src, dest);
-}
-
-export async function confirm(question) {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-
-  const answer = await new Promise((resolve) => {
-    rl.question(question, resolve);
-  });
-
-  rl.close();
-  return /^[Yy]$/.test((answer || '').trim());
-}
-
-export function parseArgs(argv) {
-  const flags = {
-    force: false,
-    dryRun: false,
-    yes: false,
-    noHooks: false,
-    skipInit: false,
-    verbose: false,
-    command: 'setup'
-  };
-
-  const positional = [];
-  for (const item of argv) {
-    if (item === '--force' || item === '-f') flags.force = true;
-    else if (item === '--dry-run') flags.dryRun = true;
-    else if (item === '--yes' || item === '-y') flags.yes = true;
-    else if (item === '--no-hooks') flags.noHooks = true;
-    else if (item === '--skip-init') flags.skipInit = true;
-    else if (item === '--verbose') flags.verbose = true;
-    else positional.push(item);
-  }
-
-  if (positional.length > 0) {
-    flags.command = positional[0];
-  }
-
-  return flags;
-}
-
-export function toPlatformMcpConfig(platform) {
-  const isWindows = platform === 'win32';
-  const command = isWindows ? 'cmd' : 'pnpm';
-  const pnpmArgs = isWindows ? ['/c', 'pnpm', 'dlx'] : ['dlx'];
-
-  const makeArgs = (pkg, extraArgs) => {
-    return [...pnpmArgs, pkg, ...extraArgs];
-  };
-
-  return {
-    mcpServers: {
-      'claude-flow': {
-        command,
-        args: makeArgs('@claude-flow/cli@latest', ['mcp', 'start']),
-        env: {
-          npm_config_update_notifier: 'false',
-          CLAUDE_FLOW_MODE: 'v3',
-          CLAUDE_FLOW_HOOKS_ENABLED: 'true',
-          CLAUDE_FLOW_TOPOLOGY: 'hierarchical-mesh',
-          CLAUDE_FLOW_MAX_AGENTS: '15',
-          CLAUDE_FLOW_MEMORY_BACKEND: 'hybrid',
-          MCP_GROUP_SECURITY: 'true',
-          MCP_GROUP_BROWSER: 'true',
-          MCP_GROUP_NEURAL: 'true',
-          MCP_GROUP_AGENTIC_FLOW: 'true'
-        },
-        autoStart: false
-      },
-      'ruv-swarm': {
-        command,
-        args: makeArgs('ruv-swarm', ['mcp', 'start']),
-        env: {
-          npm_config_update_notifier: 'false'
-        },
-        optional: true
-      },
-      'flow-nexus': {
-        command,
-        args: makeArgs('flow-nexus@latest', ['mcp', 'start']),
-        env: {
-          npm_config_update_notifier: 'false'
-        },
-        optional: true,
-        requiresAuth: true
-      }
-    }
-  };
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import readline from 'node:readline';
+
+export function pathExists(filePath) {
+  return fs.existsSync(filePath);
+}
+
+export function readJsonSafe(filePath, fallbackValue = {}) {
+  if (!pathExists(filePath)) {
+    return fallbackValue;
+  }
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  } catch {
+    return fallbackValue;
+  }
+}
+
+export function writeJson(filePath, value) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+}
+
+export function copyFileSync(src, dest) {
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.copyFileSync(src, dest);
+}
+
+export async function confirm(question) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  const answer = await new Promise((resolve) => {
+    rl.question(question, resolve);
+  });
+
+  rl.close();
+  return /^[Yy]$/.test((answer || '').trim());
+}
+
+export function parseArgs(argv) {
+  const flags = {
+    force: false,
+    dryRun: false,
+    yes: false,
+    noHooks: false,
+    skipInit: false,
+    verbose: false,
+    command: 'setup'
+  };
+
+  const positional = [];
+  for (const item of argv) {
+    if (item === '--force' || item === '-f') flags.force = true;
+    else if (item === '--dry-run') flags.dryRun = true;
+    else if (item === '--yes' || item === '-y') flags.yes = true;
+    else if (item === '--no-hooks') flags.noHooks = true;
+    else if (item === '--skip-init') flags.skipInit = true;
+    else if (item === '--verbose') flags.verbose = true;
+    else positional.push(item);
+  }
+
+  if (positional.length > 0) {
+    flags.command = positional[0];
+  }
+
+  return flags;
+}
+
+export function toPlatformMcpConfig(platform) {
+  const isWindows = platform === 'win32';
+  const command = isWindows ? 'cmd' : 'npx';
+  const npxArgs = isWindows ? ['/c', 'npx', '-y'] : ['-y'];
+
+  const makeArgs = (pkg, extraArgs) => {
+    return [...npxArgs, pkg, ...extraArgs];
+  };
+
+  return {
+    mcpServers: {
+      'claude-flow': {
+        command,
+        args: makeArgs('@claude-flow/cli@latest', ['mcp', 'start']),
+        env: {
+          npm_config_update_notifier: 'false',
+          CLAUDE_FLOW_MODE: 'v3',
+          CLAUDE_FLOW_HOOKS_ENABLED: 'true',
+          CLAUDE_FLOW_TOPOLOGY: 'hierarchical-mesh',
+          CLAUDE_FLOW_MAX_AGENTS: '15',
+          CLAUDE_FLOW_MEMORY_BACKEND: 'hybrid',
+          MCP_GROUP_SECURITY: 'true',
+          MCP_GROUP_BROWSER: 'true',
+          MCP_GROUP_NEURAL: 'true',
+          MCP_GROUP_AGENTIC_FLOW: 'true'
+        },
+        autoStart: false
+      },
+      'ruv-swarm': {
+        command,
+        args: makeArgs('ruv-swarm', ['mcp', 'start']),
+        env: {
+          npm_config_update_notifier: 'false'
+        },
+        optional: true
+      },
+      'flow-nexus': {
+        command,
+        args: makeArgs('flow-nexus@latest', ['mcp', 'start']),
+        env: {
+          npm_config_update_notifier: 'false'
+        },
+        optional: true,
+        requiresAuth: true
+      }
+    }
+  };
+}

package/templates/ruflo-setup.md

@@ -1,90 +1,92 @@
-# /ruflo-setup
-
-Set up Ruflo + Claude Flow V3 in the current project directory.
-
-## Requirements
-
-- Node.js 20+
-- pnpm 10.32.1+ installed and available on PATH
-
-Quickest pnpm install by platform:
-
-```bash
-# Windows (recommended)
-winget install -e --id pnpm.pnpm
-
-# macOS (recommended)
-brew install pnpm
-
-# Linux (recommended)
-curl -fsSL https://get.pnpm.io/install.sh | sh -
-```
-
-Alternative (all platforms with recent Node.js):
-
-```bash
-corepack enable
-corepack prepare pnpm@latest --activate
-```
-
-## What this does
-
-Runs `pnpm add -g @mfjjs/ruflo-setup` then `ruflo-setup` which:
-
-1. Runs `pnpm add -g ruflo@latest` then `ruflo init --full` to install:
-   - `.claude/settings.json` with hooks, permissions, and Claude Flow config
-   - `.claude/helpers/` — hook-handler, statusline, auto-memory scripts
-   - `.claude/agents/` — 120+ agent definitions
-   - `.claude/skills/` — 30+ skill definitions
-   - `.claude/commands/` — slash commands
-2. Writes a platform-aware `.mcp.json` (MCP server registration for claude-flow, ruv-swarm, flow-nexus)
-3. Installs a global `SessionStart` hook in `~/.claude/settings.json` that warns when Ruflo is not configured
-4. May refresh `~/.claude/commands/ruflo-setup.md` from the latest packaged template when differences are detected
-
-## Options
-
-### cleanup
-
-Removes all Ruflo-related packages from the **npm** global registry (does not touch pnpm globals).
-
-Packages removed: `ruflo`, `@mfjjs/ruflo-setup`, `ruflo-setup`, `claude-flow`, `@claude-flow/cli`, `ruv-swarm`
-
-## Instructions for Claude
-
-When the user runs /ruflo-setup:
-
-### Default (no arguments) — install
-
-1. Confirm the current working directory with the user
-2. Check if `.mcp.json` already exists — if so, warn and ask before overwriting
-3. Check pnpm version is at least 10.32.1:
-   ```bash
-   pnpm --version
-   ```
-   If the version is lower than 10.32.1, stop and tell the user to upgrade pnpm before continuing.
-4. Run the setup CLI and capture output to detect whether pnpm modified anything:
-   ```bash
-   pnpm add -g @mfjjs/ruflo-setup
-   pnpm add -g ruflo@latest 2>&1 | tee /tmp/ruflo-pnpm-add.log
-   ```
-   After the `pnpm add -g ruflo@latest` step, inspect the output. If pnpm installed or updated any packages (i.e. the output does NOT contain "Already up to date" or an equivalent no-change message), run:
-   ```bash
-   pnpm approve-builds -g --all
-   ```
-   Skip `approve-builds` if nothing changed.
-5. Run the setup tool:
-   ```bash
-   ruflo-setup
-   ```
-6. Report what was installed and remind the user to restart Claude Code to load the new MCP servers
-
-### cleanup
-
-When the user runs `/ruflo-setup cleanup`:
-
-1. Warn the user that this will remove Ruflo packages from the **npm** global registry and ask for confirmation
-2. On confirmation, run:
-   ```bash
-   ruflo-setup cleanup
-   ```
-3. Report which packages were removed and which were not found (not found is fine — it means they were already clean)
+# /ruflo-setup
+
+Set up Ruflo + Claude Flow V3 in the current project directory.
+
+## Requirements
+
+- Node.js 20+
+- pnpm 10.32.1+ installed and available on PATH
+
+Quickest pnpm install by platform:
+
+```bash
+# Windows (recommended)
+winget install -e --id pnpm.pnpm
+
+# macOS (recommended)
+brew install pnpm
+
+# Linux (recommended)
+curl -fsSL https://get.pnpm.io/install.sh | sh -
+```
+
+Alternative (all platforms with recent Node.js):
+
+```bash
+corepack enable
+corepack prepare pnpm@latest --activate
+```
+
+## What this does
+
+Runs `pnpm add -g @mfjjs/ruflo-setup` then `ruflo-setup` which:
+
+1. Runs `pnpm add -g ruflo@latest` then `ruflo init --full` to install:
+   - `.claude/settings.json` with hooks, permissions, and Claude Flow config
+   - `.claude/helpers/` — hook-handler, statusline, auto-memory scripts
+   - `.claude/agents/` — 120+ agent definitions
+   - `.claude/skills/` — 30+ skill definitions
+   - `.claude/commands/` — slash commands
+2. Writes a platform-aware `.mcp.json` (MCP server registration for claude-flow, ruv-swarm, flow-nexus; servers invoked via `npx` for cross-platform compatibility)
+3. Adds `.mcp.json` and `.claude/settings.json` to the project's `.gitignore`
+4. Installs a global `SessionStart` hook in `~/.claude/settings.json` that warns when Ruflo is not configured
+5. May refresh `~/.claude/commands/ruflo-setup.md` from the latest packaged template when differences are detected
+
+## Options
+
+### cleanup
+
+Removes all Ruflo-related packages from the **npm** global registry (does not touch pnpm globals).
+
+Packages removed: `ruflo`, `@mfjjs/ruflo-setup`, `ruflo-setup`, `claude-flow`, `@claude-flow/cli`, `ruv-swarm`
+
+## Instructions for Claude
+
+When the user runs /ruflo-setup:
+
+### Default (no arguments) — install
+
+1. Confirm the current working directory with the user
+2. Check if `.mcp.json` already exists — if so, warn and ask before overwriting
+3. Check pnpm version is at least 10.32.1:
+   ```bash
+   pnpm --version
+   ```
+   If the version is lower than 10.32.1, stop and tell the user to upgrade pnpm before continuing.
+4. Run the setup CLI and capture output to detect whether pnpm modified anything:
+   ```bash
+   pnpm add -g @mfjjs/ruflo-setup
+   pnpm add -g ruflo@latest 2>&1 | tee /tmp/ruflo-pnpm-add.log
+   ```
+   After the `pnpm add -g ruflo@latest` step, inspect the output. If pnpm installed or updated any packages (i.e. the output does NOT contain "Already up to date" or an equivalent no-change message), run:
+   ```bash
+   pnpm approve-builds -g --all
+   ```
+   Skip `approve-builds` if nothing changed.
+5. Run the setup tool:
+   ```bash
+   ruflo-setup
+   ```
+6. Ensure `.mcp.json` and `.claude/settings.json` are in the project's `.gitignore` (ruflo-setup does this automatically, but verify if using `--skip-init`)
+7. Report what was installed and remind the user to restart Claude Code to load the new MCP servers
+
+### cleanup
+
+When the user runs `/ruflo-setup cleanup`:
+
+1. Warn the user that this will remove Ruflo packages from the **npm** global registry and ask for confirmation
+2. On confirmation, run:
+   ```bash
+   ruflo-setup cleanup
+   ```
+3. Report which packages were removed and which were not found (not found is fine — it means they were already clean)