@mfjjs/ruflo-setup 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [0.1.6](https://gitlab.mfj.local:8022/mario/ruflo-setup/compare/v0.1.5...v0.1.6) (2026-03-11)
+
+### [0.1.5](https://gitlab.mfj.local:8022/mario/ruflo-setup/compare/v0.1.4...v0.1.5) (2026-03-11)
+
+
+### Features
+
+* **cli:** update commands to use pnpm instead of npx for installation and initialization ([5d7e482](https://gitlab.mfj.local:8022/mario/ruflo-setup/commit/5d7e482beaae9b3adfdf2a4c6ea478e8cf6774cb))
+* **setup:** enhance pnpm installation instructions and ensure availability checks ([b89cccc](https://gitlab.mfj.local:8022/mario/ruflo-setup/commit/b89cccc978b7e439c6544195c7d480bb95ef07af))
+
 ### [0.1.4](https://gitlab.mfj.local:8022/mario/ruflo-setup/compare/v0.1.3...v0.1.4) (2026-03-11)
 
 

package/README.md

@@ -4,12 +4,37 @@ Cross-platform npm CLI to bootstrap a project with Ruflo on Windows and Linux.
 
 ## What this project is
 
-`@mfjjs/ruflo-setup` replaces the old PowerShell-only bootstrap script with a Node-based CLI command:
+`@mfjjs/ruflo-setup` implements the setup with a Node-based CLI command:
 
 - Package name: `@mfjjs/ruflo-setup`
 - Command name: `ruflo-setup`
 - Platform support: Windows and Linux (plus macOS by default)
 
+## Requirements
+
+- Node.js 20+
+- pnpm 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
+```
+
 ## Project structure
 
 - `package.json`: npm metadata, scripts, and `bin` mapping
@@ -45,7 +70,7 @@ Flow:
 3. `bin/ruflo-setup.js` forwards args to `runCli(...)`.
 4. `src/cli.js` parses command and flags.
 5. `src/setup.js` runs setup steps:
-	 - optional `npx ruflo@latest init --full`
+	 - optional `pnpm add -g ruflo@latest` then `ruflo init --full`
 	 - writes platform-aware `.mcp.json`
 	 - copies `templates/CLAUDE.md`
 	 - installs global SessionStart hook (unless skipped)
@@ -114,7 +139,3 @@ This tests exactly what users get from a package install.
 - `claude-hooks/check-ruflo.cjs`
 
 It merges into existing global settings instead of replacing them, and creates a backup of the settings file before writing.
-
-## Legacy note
-
-`setup-ruflo.ps1` remains in the repository as historical reference, but the npm CLI is now the primary path.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mfjjs/ruflo-setup",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Cross-platform setup CLI for Ruflo + Claude Flow projects",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -26,7 +26,7 @@ Options:
   --dry-run        Show actions without making changes
   --yes, -y        Non-interactive yes for prompts
   --no-hooks       Skip global hook installation during setup
-  --skip-init      Skip 'npx ruflo@latest init --full'
+  --skip-init      Skip 'pnpm add -g ruflo@latest && ruflo init --full'
   --version, -v    Print version and exit
   --verbose        Extra output
 

package/src/setup.js

@@ -8,25 +8,88 @@ function logLine(message) {
   process.stdout.write(`${message}\n`);
 }
 
-function runNpxInit({ force, cwd, dryRun }) {
-  const args = ['ruflo@latest', 'init', '--full'];
+function getPnpmInstallSuggestions(platform) {
+  if (platform === 'win32') {
+    return [
+      'winget install -e --id pnpm.pnpm',
+      'corepack enable && corepack prepare pnpm@latest --activate',
+      'npm install -g pnpm'
+    ];
+  }
+
+  if (platform === 'darwin') {
+    return [
+      'brew install pnpm',
+      'corepack enable && corepack prepare pnpm@latest --activate',
+      'npm install -g pnpm'
+    ];
+  }
+
+  return [
+    'curl -fsSL https://get.pnpm.io/install.sh | sh -',
+    'corepack enable && corepack prepare pnpm@latest --activate',
+    'npm install -g pnpm'
+  ];
+}
+
+function ensurePnpmAvailable() {
+  const check = spawnSync('pnpm', ['--version'], {
+    stdio: 'ignore',
+    shell: process.platform === 'win32'
+  });
+
+  if (check.status === 0 && !check.error) {
+    return;
+  }
+
+  const platformLabel = process.platform === 'win32'
+    ? 'Windows'
+    : process.platform === 'darwin'
+      ? 'macOS'
+      : 'Linux';
+  const suggestions = getPnpmInstallSuggestions(process.platform)
+    .map((command) => `  - ${command}`)
+    .join('\n');
+
+  throw new Error(
+    `pnpm is required but was not found in PATH.\n` +
+    `Install pnpm, then re-run ruflo-setup.\n` +
+    `Quick install options for ${platformLabel}:\n${suggestions}`
+  );
+}
+
+function runPnpmInit({ force, cwd, dryRun }) {
+  const initArgs = ['init', '--full'];
   if (force) {
-    args.push('--force');
+    initArgs.push('--force');
   }
 
   if (dryRun) {
-    logLine(`  [DRY RUN] Would run: npx ${args.join(' ')}`);
+    logLine(`  [DRY RUN] Would run: pnpm add -g ruflo@latest`);
+    logLine(`  [DRY RUN] Would run: ruflo ${initArgs.join(' ')}`);
     return;
   }
 
-  const result = spawnSync('npx', args, {
+  ensurePnpmAvailable();
+
+  const install = spawnSync('pnpm', ['add', '-g', 'ruflo@latest'], {
+    cwd,
+    stdio: 'inherit',
+    shell: process.platform === 'win32'
+  });
+
+  if (install.status !== 0) {
+    throw new Error(`pnpm add -g ruflo@latest failed with exit code ${install.status}`);
+  }
+
+  const run = spawnSync('ruflo', initArgs, {
     cwd,
     stdio: 'inherit',
     shell: process.platform === 'win32'
   });
 
-  if (result.status !== 0) {
-    throw new Error(`ruflo init failed with exit code ${result.status}`);
+  if (run.status !== 0) {
+    throw new Error(`ruflo init failed with exit code ${run.status}`);
   }
 }
 
@@ -89,8 +152,8 @@ export async function runSetup({
   }
 
   if (!skipInit) {
-    logLine('Step 1: Running npx ruflo@latest init --full ...');
-    runNpxInit({ force, cwd, dryRun });
+    logLine('Step 1: Running pnpm add -g ruflo@latest && ruflo init --full ...');
+    runPnpmInit({ force, cwd, dryRun });
     if (!dryRun) {
       logLine('  ruflo init completed.');
     }

package/src/utils.js

@@ -72,14 +72,11 @@ export function parseArgs(argv) {
 
 export function toPlatformMcpConfig(platform) {
   const isWindows = platform === 'win32';
-  const command = isWindows ? 'cmd' : 'npx';
-  const npxArgs = ['-y'];
+  const command = isWindows ? 'cmd' : 'pnpm';
+  const pnpmArgs = isWindows ? ['/c', 'pnpm', 'dlx'] : ['dlx'];
 
   const makeArgs = (pkg, extraArgs) => {
-    if (isWindows) {
-      return ['/c', 'npx', ...npxArgs, pkg, ...extraArgs];
-    }
-    return [...npxArgs, pkg, ...extraArgs];
+    return [...pnpmArgs, pkg, ...extraArgs];
   };
 
   return {

package/templates/ruflo-setup.md

@@ -2,11 +2,36 @@
 
 Set up Ruflo + Claude Flow V3 in the current project directory.
 
+## Requirements
+
+- Node.js 20+
+- pnpm 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 `npx @mfjjs/ruflo-setup` which:
+Runs `pnpm add -g @mfjjs/ruflo-setup` then `ruflo-setup` which:
 
-1. Runs `npx ruflo@latest init --full` to install:
+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
@@ -23,6 +48,7 @@ When the user runs /ruflo-setup:
 2. Check if `.mcp.json` already exists — if so, warn and ask before overwriting
 3. Run the setup CLI:
    ```bash
-   npx @mfjjs/ruflo-setup
+   pnpm add -g @mfjjs/ruflo-setup
+   ruflo-setup
    ```
 4. Report what was installed and remind the user to restart Claude Code to load the new MCP servers