claude-flow 3.32.13 → 3.32.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.32.13",
+  "version": "3.32.14",
   "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/catalog-manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "generation": 1,
-  "generatedAt": "2026-07-27T00:32:05.924Z",
-  "gitSha": "a17a597b",
+  "generatedAt": "2026-07-27T02:19:54.128Z",
+  "gitSha": "8a884a06",
   "catalog": {
     "agents": 164,
     "tools": 387,

package/v3/@claude-flow/cli/dist/src/commands/hooks.js

@@ -659,17 +659,26 @@ const routeCommand = {
             default: 'single',
         },
         {
-            // #2778 — deliberately NOT `parallel` (short 'p'). Both swarm.ts and
-            // workflow.ts declare `--parallel` as a BOOLEAN, and the parser's
-            // global boolean-flag registry pollutes subcommand-scoped numeric
-            // flags with the same name (parseFlag then treats `--parallel 7` as
-            // `parallel:true` and drops the value). Using a distinct name avoids
-            // the collision without touching parser semantics that other
-            // subcommands rely on.
-            name: 'moa-parallel',
+            // #2778 canonical fanout-width flag. Restored to `--parallel` in
+            // v3.32.14 after the parser scoping fix landed (subcommand's
+            // non-boolean declaration now overrides the global boolean set,
+            // so `--parallel 7` on `hooks route` no longer collides with the
+            // boolean `--parallel` on `swarm start` / `workflow run`).
+            // NOTE: no `default:` here — default is resolved in the action so
+            // we can distinguish "user explicitly passed --parallel" from
+            // "user passed --moa-parallel (the v3.32.13 compat alias)". Without
+            // this, the parser's applied default would shadow the alias.
+            name: 'parallel',
+            short: 'p',
             description: 'MoA fanout width (N parallel calls at Haiku tier; only meaningful when --mode=moa)',
             type: 'number',
-            default: 3,
+        },
+        {
+            // v3.32.13 compat alias — kept so any users who upgraded to that
+            // release keep working. Prefer `--parallel` going forward.
+            name: 'moa-parallel',
+            description: 'DEPRECATED alias for --parallel (kept for v3.32.13 backward compat)',
+            type: 'number',
         },
         {
             name: 'consensus',
@@ -682,15 +691,20 @@ const routeCommand = {
     examples: [
         { command: 'claude-flow hooks route -t "Fix authentication bug"', description: 'Route task to optimal agent (single mode)' },
         { command: 'claude-flow hooks route -t "Optimize database queries" -K 5', description: 'Get top 5 suggestions' },
-        { command: 'claude-flow hooks route -t "Design payment webhook" --mode moa --moa-parallel 3', description: 'MoA fanout: 3× Haiku + consensus (dream-cycle #2778)' },
+        { command: 'claude-flow hooks route -t "Design payment webhook" --mode moa --parallel 3', description: 'MoA fanout: 3× Haiku + consensus (dream-cycle #2778)' },
     ],
     action: async (ctx) => {
         const task = ctx.flags.task || ctx.args[0];
         const topK = ctx.flags.topK || 3;
         const mode = ctx.flags.mode || 'single';
-        // #2778 — flag is --moa-parallel (parser normalizes to camelCase moaParallel)
-        // to avoid collision with the boolean --parallel from swarm/workflow.
-        const parallel = Math.max(2, ctx.flags.moaParallel || 3);
+        // #2778: prefer canonical --parallel; fall back to --moa-parallel
+        // (v3.32.13 compat alias). Nullish coalescing so an explicit 0 still
+        // falls through to the alias / default, and neither flag being set
+        // resolves to 3 (the ACL 2026 SRW paper's baseline fanout width).
+        const parallelRaw = ctx.flags.parallel
+            ?? ctx.flags.moaParallel
+            ?? 3;
+        const parallel = Math.max(2, parallelRaw);
         const consensus = ctx.flags.consensus || 'majority-vote';
         if (!task) {
             output.printError('Task description is required. Use --task or -t flag.');

package/v3/@claude-flow/cli/dist/src/parser.d.ts

@@ -78,6 +78,20 @@ export declare class CommandParser {
     private buildScopedAliases;
     /**
      * Get boolean flags scoped to a specific command/subcommand.
+     *
+     * `getBooleanFlags()` walks EVERY command + subcommand in the registry
+     * and adds their boolean options into one flat set. That's convenient
+     * for the common case but causes cross-subcommand pollution: if `swarm
+     * start --parallel` is boolean AND `hooks route --parallel` is numeric,
+     * the flat set marks `parallel` as boolean, and `hooks route --parallel 7`
+     * drops the `7` as a positional (parseFlag treats booleanFlags-hit as
+     * "consume no value"). This is the exact bug that forced the
+     * --moa-parallel rename in the 2026-07-26 dream-cycle #2778 fix.
+     *
+     * Fix: if the resolved subcommand declares the flag as a non-boolean
+     * type, REMOVE it from the boolean set. Narrowest scope wins.
+     * (Documented via in-tree comment in commands/hooks.ts and the #2778
+     * commit message.)
      */
     private getScopedBooleanFlags;
     private getBooleanFlags;

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

@@ -406,13 +406,34 @@ export class CommandParser {
     }
     /**
      * Get boolean flags scoped to a specific command/subcommand.
+     *
+     * `getBooleanFlags()` walks EVERY command + subcommand in the registry
+     * and adds their boolean options into one flat set. That's convenient
+     * for the common case but causes cross-subcommand pollution: if `swarm
+     * start --parallel` is boolean AND `hooks route --parallel` is numeric,
+     * the flat set marks `parallel` as boolean, and `hooks route --parallel 7`
+     * drops the `7` as a positional (parseFlag treats booleanFlags-hit as
+     * "consume no value"). This is the exact bug that forced the
+     * --moa-parallel rename in the 2026-07-26 dream-cycle #2778 fix.
+     *
+     * Fix: if the resolved subcommand declares the flag as a non-boolean
+     * type, REMOVE it from the boolean set. Narrowest scope wins.
+     * (Documented via in-tree comment in commands/hooks.ts and the #2778
+     * commit message.)
      */
     getScopedBooleanFlags(resolvedCmd) {
         const flags = this.getBooleanFlags();
         if (resolvedCmd?.options) {
             for (const opt of resolvedCmd.options) {
+                const key = this.normalizeKey(opt.name);
                 if (opt.type === 'boolean') {
-                    flags.add(this.normalizeKey(opt.name));
+                    flags.add(key);
+                }
+                else if (opt.type) {
+                    // Subcommand explicitly re-declares this flag as a non-boolean
+                    // type (string/number/array) — narrowest scope wins, so drop
+                    // it from the boolean set to override any global pollution.
+                    flags.delete(key);
                 }
             }
         }

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

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/cli",
-  "version": "3.32.13",
+  "version": "3.32.14",
   "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",