claude-flow 3.10.0 → 3.10.1

package/.claude-plugin/hooks/hooks.json

@@ -1,5 +1,7 @@
 {
   "_note": "#1921 — hook commands invoke scripts/ruflo-hook.sh (resilient shim): prefers a locally-installed `ruflo`/`claude-flow` binary, falls back to `npx --prefer-offline`, and always exits 0 so a CLI/install failure (e.g. arborist `Invalid Version` on npm 10.8.x) never surfaces an error in Claude Code or blocks a turn. The trailing `|| true` guards the case where $CLAUDE_PLUGIN_ROOT is unset (older Claude Code) — the hook then no-ops silently. DO NOT revert to a bare `npx <pkg>@alpha hooks …` per fire.",
+  "_platform": "posix",
+  "_platform_note": "#2132 — This hooks.json uses /bin/bash, POSIX pipelines (jq, xargs, tr), and .sh scripts. It is intentionally POSIX-only (Mac/Linux). On Windows, ruflo init writes a .claude/settings.json that overrides these entries with node-based equivalents via plugins/ruflo-core/scripts/ruflo-hook.cjs. The audit exempts files with _platform:posix from the cross-platform check.",
   "hooks": {
     "PreToolUse": [
       {

package/.claude-plugin/scripts/ruflo-hook.cjs

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+/**
+ * ruflo-hook.cjs — cross-platform Node.js port of ruflo-hook.sh (#2132)
+ *
+ * The bash shim (ruflo-hook.sh) works on Mac/Linux but fails on native
+ * Windows (exit 126 — "cannot execute binary file"). This .cjs shim
+ * provides identical behaviour via Node.js child_process so Windows users
+ * get working hooks without WSL or Git Bash.
+ *
+ * Mac/Linux continue to use ruflo-hook.sh via the plugin hooks.json files
+ * (unchanged). On Windows, ruflo init writes a .claude/settings.json that
+ * overrides those entries with node-based equivalents pointing here.
+ *
+ * Behaviour mirrors ruflo-hook.sh:
+ *   1. Reads hook JSON payload from stdin.
+ *   2. Prefers a locally installed `ruflo` or `claude-flow` binary.
+ *   3. Falls back to `npx --prefer-offline ruflo@latest`.
+ *   4. Always exits 0 — hook subcommands are best-effort telemetry.
+ *   5. Swallows all stderr — nothing should surface to Claude Code.
+ *
+ * Usage: node ruflo-hook.cjs <hook-subcommand> [args...]
+ *   e.g. node ruflo-hook.cjs post-edit --file "x.ts" --train-patterns
+ */
+
+'use strict';
+
+const { spawnSync, execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+/** Exit 0 unconditionally — hooks must never block a turn */
+function done() {
+  process.exit(0);
+}
+
+/** Resolve stdin to a JSON object, or null if not parseable */
+function readStdinJson() {
+  try {
+    let buf = '';
+    // Read synchronously — hooks fire synchronously in Claude Code
+    const fd = fs.openSync('/dev/stdin', 'r');
+    const chunk = Buffer.alloc(64 * 1024);
+    let bytesRead;
+    while ((bytesRead = fs.readSync(fd, chunk, 0, chunk.length, null)) > 0) {
+      buf += chunk.slice(0, bytesRead).toString('utf8');
+    }
+    fs.closeSync(fd);
+    return buf.trim() ? JSON.parse(buf) : null;
+  } catch {
+    return null;
+  }
+}
+
+/** Read stdin via process.stdin in sync mode (Windows-safe alternative) */
+function readStdinSync() {
+  try {
+    // On Windows /dev/stdin doesn't exist; use fd 0 directly
+    const chunk = Buffer.alloc(64 * 1024);
+    let buf = '';
+    let bytesRead;
+    while (true) {
+      try {
+        bytesRead = fs.readSync(0 /* STDIN_FILENO */, chunk, 0, chunk.length, null);
+        if (bytesRead === 0) break;
+        buf += chunk.slice(0, bytesRead).toString('utf8');
+      } catch {
+        break;
+      }
+    }
+    return buf.trim() ? JSON.parse(buf) : null;
+  } catch {
+    return null;
+  }
+}
+
+/** Check if a binary is available on PATH */
+function commandExists(cmd) {
+  try {
+    const result = execSync(
+      process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`,
+      { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }
+    );
+    return result.trim().length > 0;
+  } catch {
+    return false;
+  }
+}
+
+/** Build the argv for the ruflo/claude-flow/npx invocation */
+function buildArgs(subcommand, extraArgs) {
+  // The `hooks` word is prepended here, matching ruflo-hook.sh convention.
+  return ['hooks', subcommand, ...extraArgs];
+}
+
+/**
+ * Spawn the CLI with the hook subcommand.
+ * Passes the raw stdin payload as the child's stdin so the CLI can read
+ * the hook event JSON if needed (same as the bash pipe).
+ *
+ * Returns true on success (exit 0), false otherwise.
+ */
+function invokeHook(bin, binArgs, hookArgs, stdinData) {
+  const args = [...binArgs, ...hookArgs];
+
+  // On Windows, shell: true is needed to resolve .cmd shims in node_modules
+  const useShell = process.platform === 'win32';
+
+  const result = spawnSync(bin, args, {
+    shell: useShell,
+    input: stdinData || '',
+    encoding: 'utf8',
+    stdio: ['pipe', 'ignore', 'ignore'],  // swallow all output
+    timeout: 30_000,
+  });
+
+  return result.status === 0;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  if (args.length === 0) {
+    // No subcommand — no-op, same as bash version
+    done();
+  }
+
+  const [subcommand, ...rest] = args;
+
+  // Read stdin (the hook event payload) — best effort
+  let stdinData = '';
+  try {
+    stdinData = fs.readFileSync(0 /* fd 0 = stdin */, 'utf8');
+  } catch {
+    // stdin may not be available when invoked directly for testing
+    stdinData = '';
+  }
+
+  const hookArgs = buildArgs(subcommand, rest);
+
+  // Priority 1: locally installed ruflo binary
+  if (commandExists('ruflo')) {
+    invokeHook('ruflo', [], hookArgs, stdinData);
+    done();
+  }
+
+  // Priority 2: locally installed claude-flow binary
+  if (commandExists('claude-flow')) {
+    invokeHook('claude-flow', [], hookArgs, stdinData);
+    done();
+  }
+
+  // Priority 3: npx --prefer-offline fallback (avoids cold registry resolve).
+  //
+  // SKIP this when RUFLO_HOOK_SKIP_NPX=1 — used by CI smokes that test
+  // the shim's *control flow* without exercising npm install network paths.
+  // Without the skip, npx can take 30+s on a cold runner (no warm cache,
+  // no offline tarball), exceeding the smoke's 15s timeout and producing
+  // a spurious failure even though the shim itself works correctly.
+  // The bash version doesn't hit this because it backgrounded the work.
+  if (process.env.RUFLO_HOOK_SKIP_NPX !== '1') {
+    invokeHook('npx', ['--prefer-offline', '--yes', 'ruflo@latest'], hookArgs, stdinData);
+  }
+
+  done();
+}
+
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.10.0",
+  "version": "3.10.1",
   "description": "Ruflo - Enterprise AI agent orchestration for Claude Code. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
   "main": "dist/index.js",
   "type": "module",

package/v3/@claude-flow/cli/dist/src/init/executor.js

@@ -14,7 +14,7 @@ import { detectPlatform, DEFAULT_INIT_OPTIONS } from './types.js';
 import { generateSettingsJson, generateSettings } from './settings-generator.js';
 import { generateMCPJson } from './mcp-generator.js';
 import { generateStatuslineScript } from './statusline-generator.js';
-import { generatePreCommitHook, generatePostCommitHook, generateSessionManager, generateAgentRouter, generateMemoryHelper, generateHookHandler, generateIntelligenceStub, generateAutoMemoryHook, } from './helpers-generator.js';
+import { generatePreCommitHook, generatePostCommitHook, generateSessionManager, generateAgentRouter, generateMemoryHelper, generateHookHandler, generateIntelligenceStub, generateAutoMemoryHook, generateRufloHookCjs, } from './helpers-generator.js';
 import { generateClaudeMd } from './claudemd-generator.js';
 /**
  * Skills to copy based on configuration
@@ -1057,6 +1057,11 @@ async function writeHelpers(targetDir, options, result) {
     const helpersDir = path.join(targetDir, '.claude', 'helpers');
     // Find source helpers directory (works for npm package and local dev)
     const sourceHelpersDir = findSourceHelpersDir(options.sourceBaseDir);
+    // On Windows: emit a notice before writing helpers — the settings.json
+    // hooks will use node-based commands instead of bash shims (#2132).
+    if (process.platform === 'win32') {
+        console.log('Detected Windows — adding cross-platform hook overrides to .claude/settings.json (#2132)');
+    }
     // Try to copy existing helpers from source first
     if (sourceHelpersDir && fs.existsSync(sourceHelpersDir)) {
         const helperFiles = fs.readdirSync(sourceHelpersDir);
@@ -1080,6 +1085,18 @@ async function writeHelpers(targetDir, options, result) {
                 result.skipped.push(`.claude/helpers/${file}`);
             }
         }
+        // #2132: Always generate ruflo-hook.cjs regardless of source copy path.
+        // The source helpers dir may not contain this file (it lives in
+        // plugins/ruflo-core/scripts/, not .claude/helpers/), but it must
+        // always be present so Windows users can use the node-based shim.
+        const rufloHookDest = path.join(helpersDir, 'ruflo-hook.cjs');
+        if (!fs.existsSync(rufloHookDest) || options.force) {
+            fs.writeFileSync(rufloHookDest, generateRufloHookCjs(), 'utf-8');
+            result.created.files.push('.claude/helpers/ruflo-hook.cjs');
+        }
+        else {
+            result.skipped.push('.claude/helpers/ruflo-hook.cjs');
+        }
         if (copiedCount > 0) {
             return; // Skip generating if we copied from source
         }
@@ -1094,6 +1111,10 @@ async function writeHelpers(targetDir, options, result) {
         'hook-handler.cjs': generateHookHandler(),
         'intelligence.cjs': generateIntelligenceStub(),
         'auto-memory-hook.mjs': generateAutoMemoryHook(),
+        // #2132: cross-platform Node.js port of ruflo-hook.sh — always deployed so
+        // Windows users have a working shim even if the plugin's hooks.json bash
+        // commands are overridden via settings.json.
+        'ruflo-hook.cjs': generateRufloHookCjs(),
     };
     for (const [name, content] of Object.entries(helpers)) {
         const filePath = path.join(helpersDir, name);

package/v3/@claude-flow/cli/dist/src/init/helpers-generator.d.ts

@@ -58,4 +58,14 @@ export declare function generateCrossPlatformSessionManager(): string;
  * Generate all helper files
  */
 export declare function generateHelpers(options: InitOptions): Record<string, string>;
+/**
+ * Generate cross-platform Node.js port of ruflo-hook.sh (#2132).
+ *
+ * The bash shim works on Mac/Linux but fails on native Windows (exit 126).
+ * This .cjs version is always deployed to .claude/helpers/ so:
+ *   - Windows: settings.json overrides plugin bash hooks with node-based cmds
+ *   - Mac/Linux: plugin hooks.json still uses .sh (faster, battle-tested)
+ *   - Both: .claude/helpers/ruflo-hook.cjs available as a canonical cross-platform shim
+ */
+export declare function generateRufloHookCjs(): string;
 //# sourceMappingURL=helpers-generator.d.ts.map

package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js

@@ -1195,4 +1195,75 @@ export function generateHelpers(options) {
     }
     return helpers;
 }
+/**
+ * Generate cross-platform Node.js port of ruflo-hook.sh (#2132).
+ *
+ * The bash shim works on Mac/Linux but fails on native Windows (exit 126).
+ * This .cjs version is always deployed to .claude/helpers/ so:
+ *   - Windows: settings.json overrides plugin bash hooks with node-based cmds
+ *   - Mac/Linux: plugin hooks.json still uses .sh (faster, battle-tested)
+ *   - Both: .claude/helpers/ruflo-hook.cjs available as a canonical cross-platform shim
+ */
+export function generateRufloHookCjs() {
+    return `#!/usr/bin/env node
+/**
+ * ruflo-hook.cjs — cross-platform Node.js port of ruflo-hook.sh (#2132)
+ *
+ * Deployed to .claude/helpers/ during ruflo init. On Windows, the
+ * generated .claude/settings.json hooks point here instead of the
+ * plugin's bash-only ruflo-hook.sh.
+ *
+ * Always exits 0 — hook subcommands are best-effort telemetry and must
+ * never block a Claude Code turn.
+ */
+
+'use strict';
+
+const { spawnSync, execSync } = require('child_process');
+const fs = require('fs');
+
+function done() { process.exit(0); }
+
+function commandExists(cmd) {
+  try {
+    const r = execSync(
+      process.platform === 'win32' ? 'where ' + cmd : 'command -v ' + cmd,
+      { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }
+    );
+    return r.trim().length > 0;
+  } catch { return false; }
+}
+
+function invokeHook(bin, binArgs, hookArgs, stdinData) {
+  const args = [...binArgs, ...hookArgs];
+  const result = spawnSync(bin, args, {
+    shell: process.platform === 'win32',
+    input: stdinData || '',
+    encoding: 'utf8',
+    stdio: ['pipe', 'ignore', 'ignore'],
+    timeout: 30_000,
+  });
+  return result.status === 0;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  if (args.length === 0) done();
+
+  const [subcommand, ...rest] = args;
+
+  let stdinData = '';
+  try { stdinData = fs.readFileSync(0, 'utf8'); } catch { stdinData = ''; }
+
+  const hookArgs = ['hooks', subcommand, ...rest];
+
+  if (commandExists('ruflo')) { invokeHook('ruflo', [], hookArgs, stdinData); done(); }
+  if (commandExists('claude-flow')) { invokeHook('claude-flow', [], hookArgs, stdinData); done(); }
+  invokeHook('npx', ['--prefer-offline', '--yes', 'ruflo@latest'], hookArgs, stdinData);
+  done();
+}
+
+main();
+`;
+}
 //# sourceMappingURL=helpers-generator.js.map

package/v3/@claude-flow/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/cli",
-  "version": "3.10.0",
+  "version": "3.10.1",
   "type": "module",
   "description": "Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",