claude-flow 3.32.12 → 3.32.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.32.12",
+  "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:21:28.157Z",
-  "gitSha": "13a3421f",
+  "generatedAt": "2026-07-27T02:19:54.128Z",
+  "gitSha": "8a884a06",
   "catalog": {
     "agents": 164,
     "tools": 387,

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

@@ -644,15 +644,68 @@ const routeCommand = {
             description: 'Number of top agent suggestions',
             type: 'number',
             default: 3
-        }
+        },
+        {
+            // #2778 dream-cycle — Mixture-of-Agents test-time scaling.
+            // When `--mode moa` is set AND the router would have chosen a
+            // Tier-3 model (Sonnet/Opus), swap to N parallel Tier-2 (Haiku)
+            // calls + majority-vote consensus. Grade-A ACL 2026 SRW evidence
+            // (arXiv 2605.01566): +2.7pp accuracy at equal-cost when parallel
+            // generations exceed sequential aggregations.
+            name: 'mode',
+            description: 'Routing mode: single (default) or moa (mixture-of-agents fanout, #2778)',
+            type: 'string',
+            choices: ['single', 'moa'],
+            default: 'single',
+        },
+        {
+            // #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',
+        },
+        {
+            // 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',
+            description: 'MoA consensus strategy: majority-vote (default) or best-confidence',
+            type: 'string',
+            choices: ['majority-vote', 'best-confidence'],
+            default: 'majority-vote',
+        },
     ],
     examples: [
-        { command: 'claude-flow hooks route -t "Fix authentication bug"', description: 'Route task to optimal agent' },
-        { command: 'claude-flow hooks route -t "Optimize database queries" -K 5', description: 'Get top 5 suggestions' }
+        { 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 --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: 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.');
             return { success: false, exitCode: 1 };
@@ -666,6 +719,35 @@ const routeCommand = {
                 topK,
                 includeEstimates: true,
             });
+            // #2778 — compute the MoA plan BEFORE the JSON output branch so
+            // programmatic callers see `moaPlan` in the JSON result too.
+            let moaPlan = null;
+            if (mode === 'moa') {
+                const complexity = result.estimatedMetrics?.complexity ?? 'medium';
+                const wouldTier3 = complexity === 'high';
+                const primaryAgent = result.primaryAgent.type;
+                const agents = Array.from({ length: parallel }, (_, i) => ({
+                    name: `moa-${primaryAgent}-${i + 1}`,
+                    model: 'haiku',
+                    role: primaryAgent,
+                }));
+                moaPlan = {
+                    mode: 'moa',
+                    parallel,
+                    tier: 'tier2-haiku',
+                    consensus,
+                    rationale: wouldTier3
+                        ? `Complexity=${complexity} would tier-3 (Sonnet/Opus). MoA fanout — ${parallel}× Haiku is typically <1× Sonnet cost (arXiv 2605.01566: +2.7pp at equal cost).`
+                        : `Complexity=${complexity} — MoA still available as a diversity mechanism, but the single-agent path is usually the cost-optimal choice below Tier-3.`,
+                    agents,
+                    synthesizer: {
+                        name: `moa-synth-${primaryAgent}`,
+                        model: 'haiku',
+                        role: 'synthesizer',
+                    },
+                };
+                result.moaPlan = moaPlan;
+            }
             if (ctx.flags.format === 'json') {
                 output.printJson(result);
                 return { success: true, data: result };
@@ -719,6 +801,23 @@ const routeCommand = {
                     `Complexity: ${result.estimatedMetrics.complexity.toUpperCase()}`
                 ]);
             }
+            // #2778 dream-cycle — render the MoA plan to text output. moaPlan
+            // was already spliced into the result above so JSON consumers see it.
+            if (mode === 'moa' && moaPlan) {
+                const primaryAgent = result.primaryAgent.type;
+                output.writeln();
+                output.writeln(output.bold('Mixture-of-Agents Plan (#2778)'));
+                output.printList([
+                    `Mode: moa`,
+                    `Fanout: ${parallel} parallel ${primaryAgent} × Haiku`,
+                    `Consensus: ${consensus}`,
+                    `Synthesizer: 1 Haiku agent (${consensus} over ${parallel} verdicts)`,
+                ]);
+                output.writeln();
+                output.printBox(`Spawn ${parallel} background Task calls with model="haiku" and subagent_type="${primaryAgent}"\n` +
+                    `then a synthesizer Task ("moa-synth-${primaryAgent}") that reads all ${parallel} results and picks the ${consensus === 'majority-vote' ? 'majority answer' : 'highest-confidence answer'}.\n\n` +
+                    `Cost note: ${parallel}× Haiku is typically <1× Sonnet on comparable complexity — see arXiv 2605.01566 for the ACL 2026 evidence.`, 'MoA Execution Directive');
+            }
             return { success: true, data: result };
         }
         catch (error) {

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.12",
+  "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",