claude-flow 3.7.0-alpha.17 → 3.7.0-alpha.19

package/.claude/scheduled_tasks.lock

@@ -1 +1 @@
-{"sessionId":"7c6134bf-6c84-4145-9232-421e80ca3692","pid":85190,"procStart":"Fri May  8 13:13:24 2026","acquiredAt":1778246373999}
+{"sessionId":"e8acbe6b-1513-4c00-ac30-2b486317c5b1","pid":7565,"procStart":"Sat May  9 13:35:07 2026","acquiredAt":1778338395740}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.7.0-alpha.17",
+  "version": "3.7.0-alpha.19",
   "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/bin/cli.js

@@ -39,9 +39,22 @@ console.log = (...args) => {
 // Conditions:
 //   1. stdin is being piped AND no CLI arguments provided (auto-detect)
 //   2. stdin is being piped AND args are "mcp start" (explicit, e.g. npx claude-flow@alpha mcp start)
+//   3. EXCEPT — if the user explicitly passed --transport <non-stdio>
+//      (e.g. -t http), defer to the parser. Without this, every smoke
+//      test or non-TTY caller of `mcp start -t http` got force-routed
+//      into stdio mode and never hit the HTTP server (#1874 follow-up).
 const cliArgs = process.argv.slice(2);
 const isExplicitMCP = cliArgs.length >= 1 && cliArgs[0] === 'mcp' && (cliArgs.length === 1 || cliArgs[1] === 'start');
-const isMCPMode = !process.stdin.isTTY && (process.argv.length === 2 || isExplicitMCP);
+const explicitNonStdioTransport = cliArgs.some((a, i) => {
+  // -t <value> | --transport <value>
+  if ((a === '-t' || a === '--transport') && cliArgs[i + 1] && cliArgs[i + 1] !== 'stdio') return true;
+  // --transport=<value>
+  if (/^--transport=/.test(a) && !/^--transport=stdio$/.test(a)) return true;
+  return false;
+});
+const isMCPMode = !process.stdin.isTTY
+  && !explicitNonStdioTransport
+  && (process.argv.length === 2 || isExplicitMCP);
 
 if (isMCPMode) {
   // Run MCP server mode

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

@@ -270,7 +270,7 @@ const preEditCommand = {
     ],
     action: async (ctx) => {
         // Default file to 'unknown' for backward compatibility (env var may be empty)
-        const filePath = ctx.args[0] || ctx.flags.file || 'unknown';
+        const filePath = ctx.flags.file || ctx.args[0] || 'unknown';
         const operation = ctx.flags.operation || 'update';
         output.printInfo(`Analyzing context for: ${output.highlight(filePath)}`);
         try {
@@ -375,7 +375,7 @@ const postEditCommand = {
     ],
     action: async (ctx) => {
         // Default file to 'unknown' for backward compatibility (env var may be empty)
-        const filePath = ctx.args[0] || ctx.flags.file || 'unknown';
+        const filePath = ctx.flags.file || ctx.args[0] || 'unknown';
         // Default success to true for backward compatibility (PostToolUse = success, PostToolUseFailure = failure)
         const success = ctx.flags.success !== undefined ? ctx.flags.success : true;
         output.printInfo(`Recording outcome for: ${output.highlight(filePath)}`);
@@ -458,7 +458,7 @@ const preCommandCommand = {
         { command: 'claude-flow hooks pre-command -c "npm install lodash"', description: 'Check package install' }
     ],
     action: async (ctx) => {
-        const command = ctx.args[0] || ctx.flags.command;
+        const command = ctx.flags.command || ctx.args[0];
         if (!command) {
             output.printError('Command is required. Use --command or -c flag.');
             return { success: false, exitCode: 1 };
@@ -567,7 +567,7 @@ const postCommandCommand = {
         { command: 'claude-flow hooks post-command -c "npm build" --success false -e 1', description: 'Record failed build' }
     ],
     action: async (ctx) => {
-        const command = ctx.args[0] || ctx.flags.command;
+        const command = ctx.flags.command || ctx.args[0];
         // Default success to true for backward compatibility
         const success = ctx.flags.success !== undefined ? ctx.flags.success : true;
         if (!command) {
@@ -639,7 +639,7 @@ const routeCommand = {
         { command: 'claude-flow hooks route -t "Optimize database queries" -K 5', description: 'Get top 5 suggestions' }
     ],
     action: async (ctx) => {
-        const task = ctx.args[0] || ctx.flags.task;
+        const task = ctx.flags.task || ctx.args[0];
         const topK = ctx.flags.topK || 3;
         if (!task) {
             output.printError('Task description is required. Use --task or -t flag.');
@@ -751,7 +751,7 @@ const explainCommand = {
         { command: 'claude-flow hooks explain -t "Optimize queries" -a coder --verbose', description: 'Verbose explanation for specific agent' }
     ],
     action: async (ctx) => {
-        const task = ctx.args[0] || ctx.flags.task;
+        const task = ctx.flags.task || ctx.args[0];
         if (!task) {
             output.printError('Task description is required. Use --task or -t flag.');
             return { success: false, exitCode: 1 };
@@ -1224,7 +1224,7 @@ const transferFromProjectCommand = {
         { command: 'claude-flow hooks transfer from-project -s ../prod --filter security -m 0.9', description: 'Transfer high-confidence security patterns' }
     ],
     action: async (ctx) => {
-        const sourcePath = ctx.args[0] || ctx.flags.source;
+        const sourcePath = ctx.flags.source || ctx.args[0];
         const minConfidence = ctx.flags.minConfidence || 0.7;
         if (!sourcePath) {
             output.printError('Source project path is required. Use --source or -s flag.');
@@ -1422,7 +1422,7 @@ const preTaskCommand = {
     ],
     action: async (ctx) => {
         const taskId = ctx.flags.taskId || `task-${Date.now().toString(36)}`;
-        const description = ctx.args[0] || ctx.flags.description;
+        const description = ctx.flags.description || ctx.args[0];
         if (!description) {
             output.printError('Description is required: --description "your task"');
             return { success: false, exitCode: 1 };
@@ -1707,7 +1707,7 @@ const sessionRestoreCommand = {
         { command: 'claude-flow hooks session-restore -i session-12345', description: 'Restore specific session' }
     ],
     action: async (ctx) => {
-        const sessionId = ctx.args[0] || ctx.flags.sessionId || 'latest';
+        const sessionId = ctx.flags.sessionId || ctx.args[0] || 'latest';
         output.printInfo(`Restoring session: ${output.highlight(sessionId)}`);
         try {
             const result = await callMCPTool('hooks_session-restore', {
@@ -2519,7 +2519,7 @@ const coverageRouteCommand = {
         { command: 'claude-flow hooks coverage-route -t "add tests" --threshold 90', description: 'Route with custom threshold' }
     ],
     action: async (ctx) => {
-        const task = ctx.args[0] || ctx.flags.task;
+        const task = ctx.flags.task || ctx.args[0];
         const threshold = ctx.flags.threshold || 80;
         const useRuvector = !ctx.flags['no-ruvector'];
         if (!task) {
@@ -2739,7 +2739,7 @@ const coverageSuggestCommand = {
         { command: 'claude-flow hooks coverage-suggest -p src/services --threshold 90', description: 'Stricter threshold' }
     ],
     action: async (ctx) => {
-        const targetPath = ctx.args[0] || ctx.flags.path;
+        const targetPath = ctx.flags.path || ctx.args[0];
         const threshold = ctx.flags.threshold || 80;
         const limit = ctx.flags.limit || 20;
         if (!targetPath) {
@@ -3977,7 +3977,7 @@ const modelRouteCommand = {
         { command: 'claude-flow hooks model-route -t "architect auth system"', description: 'Route complex task (likely opus)' },
     ],
     action: async (ctx) => {
-        const task = ctx.args[0] || ctx.flags.task;
+        const task = ctx.flags.task || ctx.args[0];
         if (!task) {
             output.printError('Task description required. Use --task or -t flag.');
             return { success: false, exitCode: 1 };
@@ -4285,7 +4285,7 @@ const taskCompletedCommand = {
         { command: 'claude-flow hooks task-completed -i task-456 --notify-lead --quality 0.95', description: 'Complete with quality score' }
     ],
     action: async (ctx) => {
-        const taskId = ctx.args[0] || ctx.flags.taskId;
+        const taskId = ctx.flags.taskId || ctx.args[0];
         const trainPatterns = ctx.flags.trainPatterns !== false;
         const notifyLead = ctx.flags.notifyLead !== false;
         const success = ctx.flags.success !== false;
@@ -4363,7 +4363,7 @@ const notifyCommand = {
         { command: 'claude-flow hooks notify -m "Test failed" -l error', description: 'Send error notification' },
     ],
     action: async (ctx) => {
-        const message = ctx.args[0] || ctx.flags.message;
+        const message = ctx.flags.message || ctx.args[0];
         const level = ctx.flags.level || 'info';
         if (!message) {
             output.printError('Message is required: --message "your message"');

package/v3/@claude-flow/cli/dist/src/memory/sona-optimizer.js

@@ -137,6 +137,9 @@ export class SONAOptimizer {
         if (this.sonaEngine !== undefined)
             return; // already attempted
         try {
+            // @ts-ignore — @ruvector/sona is in optionalDependencies and ships
+            // no .d.ts. Runtime is gated by try/catch; TS errors here on hosts
+            // without the module resolved (e.g. CI before postinstall).
             const sona = await import('@ruvector/sona');
             const EngineCtor = sona.SonaEngine || sona.default?.SonaEngine;
             if (EngineCtor) {

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

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/cli",
-  "version": "3.7.0-alpha.17",
+  "version": "3.7.0-alpha.19",
   "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",

package/v3/@claude-flow/shared/dist/events/event-store.js

@@ -16,6 +16,7 @@
  */
 import { EventEmitter } from 'node:events';
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
 import initSqlJs from 'sql.js';
 const DEFAULT_CONFIG = {
     databasePath: ':memory:',
@@ -45,11 +46,21 @@ export class EventStore extends EventEmitter {
         if (this.initialized)
             return;
         // Load sql.js WASM
-        this.SQL = await initSqlJs({
-            locateFile: this.config.wasmPath
-                ? () => this.config.wasmPath
-                : (file) => `https://sql.js.org/dist/${file}`,
-        });
+        let wasmLocator;
+        if (this.config.wasmPath) {
+            wasmLocator = () => this.config.wasmPath;
+        }
+        else {
+            try {
+                const req = createRequire(import.meta.url);
+                const sqlJsPath = req.resolve('sql.js/dist/sql-wasm.wasm');
+                wasmLocator = () => sqlJsPath;
+            }
+            catch {
+                wasmLocator = (file) => `https://sql.js.org/dist/${file}`;
+            }
+        }
+        this.SQL = await initSqlJs({ locateFile: wasmLocator });
         // Load existing database if exists
         if (this.config.databasePath !== ':memory:' && existsSync(this.config.databasePath)) {
             const buffer = readFileSync(this.config.databasePath);
@@ -237,7 +248,7 @@ export class EventStore extends EventEmitter {
      */
     async *replay(fromVersion = 0) {
         this.ensureInitialized();
-        const stmt = this.db.prepare('SELECT * FROM events WHERE version >= ? ORDER BY version ASC');
+        const stmt = this.db.prepare('SELECT * FROM events WHERE rowid >= ? ORDER BY rowid ASC');
         stmt.bind([fromVersion]);
         while (stmt.step()) {
             const row = stmt.getAsObject();
@@ -290,7 +301,7 @@ export class EventStore extends EventEmitter {
         this.ensureInitialized();
         // Total events
         const totalStmt = this.db.prepare('SELECT COUNT(*) as count FROM events');
-        const totalRow = totalStmt.getAsObject();
+        const totalRow = totalStmt.getAsObject([]);
         totalStmt.free();
         const totalEvents = totalRow.count || 0;
         // Events by type
@@ -311,11 +322,11 @@ export class EventStore extends EventEmitter {
         aggStmt.free();
         // Timestamp range
         const rangeStmt = this.db.prepare('SELECT MIN(timestamp) as oldest, MAX(timestamp) as newest FROM events');
-        const rangeRow = rangeStmt.getAsObject();
+        const rangeRow = rangeStmt.getAsObject([]);
         rangeStmt.free();
         // Snapshot count
         const snapshotStmt = this.db.prepare('SELECT COUNT(*) as count FROM snapshots');
-        const snapshotRow = snapshotStmt.getAsObject();
+        const snapshotRow = snapshotStmt.getAsObject([]);
         snapshotStmt.free();
         return {
             totalEvents,

package/v3/@claude-flow/shared/dist/hooks/executor.js

@@ -205,6 +205,8 @@ export class HookExecutor {
         const results = [];
         let currentContext = { ...initialContext };
         let totalExecutionTime = 0;
+        let totalHooksExecuted = 0;
+        let totalHooksFailed = 0;
         let aborted = false;
         for (const event of events) {
             if (aborted) {
@@ -213,6 +215,8 @@ export class HookExecutor {
             const result = await this.execute(event, currentContext, options);
             results.push(...result.results);
             totalExecutionTime += result.totalExecutionTime;
+            totalHooksExecuted += result.hooksExecuted;
+            totalHooksFailed += result.hooksFailed;
             // Merge context for next event
             if (result.finalContext) {
                 currentContext = { ...currentContext, ...result.finalContext };
@@ -222,13 +226,12 @@ export class HookExecutor {
                 break;
             }
         }
-        const hooksFailed = results.filter(r => !r.success).length;
         return {
-            success: hooksFailed === 0 && !aborted,
+            success: totalHooksFailed === 0 && !aborted,
             results: options.collectResults ? results : [],
             totalExecutionTime,
-            hooksExecuted: results.length,
-            hooksFailed,
+            hooksExecuted: totalHooksExecuted,
+            hooksFailed: totalHooksFailed,
             aborted,
             finalContext: currentContext,
         };

package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.js

@@ -22,8 +22,8 @@ describe('Hooks Module Exports', () => {
     it('should export types (type-only imports)', () => {
         expect(true).toBe(true);
     });
-    it('should create instances from exported factories', () => {
-        const { createHookRegistry, createHookExecutor } = require('./index.js');
+    it('should create instances from exported factories', async () => {
+        const { createHookRegistry, createHookExecutor } = await import('./index.js');
         const registry = createHookRegistry();
         expect(registry).toBeDefined();
         expect(typeof registry.register).toBe('function');
@@ -32,8 +32,8 @@ describe('Hooks Module Exports', () => {
         expect(executor).toBeDefined();
         expect(typeof executor.execute).toBe('function');
     });
-    it('should have all 26 hook events defined', () => {
-        const { HookEvent } = require('./index.js');
+    it('should have all 26 hook events defined', async () => {
+        const { HookEvent } = await import('./index.js');
         const expectedEvents = [
             'PreToolUse',
             'PostToolUse',
@@ -68,8 +68,8 @@ describe('Hooks Module Exports', () => {
             expect(HookEvent[event]).toBeDefined();
         }
     });
-    it('should have all 5 priority levels defined', () => {
-        const { HookPriority } = require('./index.js');
+    it('should have all 5 priority levels defined', async () => {
+        const { HookPriority } = await import('./index.js');
         expect(HookPriority.Critical).toBe(1000);
         expect(HookPriority.High).toBe(500);
         expect(HookPriority.Normal).toBe(0);

package/v3/@claude-flow/shared/dist/mcp/server.js

@@ -59,12 +59,9 @@ export class MCPServer extends EventEmitter {
         name: 'Claude-Flow MCP Server V3',
         version: '3.0.0',
     };
-    // Protocol version
-    protocolVersion = {
-        major: 2024,
-        minor: 11,
-        patch: 5,
-    };
+    // MCP protocol version — spec-required YYYY-MM-DD date string (#1874).
+    // Claude Code's Zod validator rejects any other shape.
+    protocolVersion = '2024-11-05';
     // Server capabilities
     capabilities = {
         logging: { level: 'info' },

package/v3/@claude-flow/shared/dist/mcp/types.d.ts

@@ -17,13 +17,11 @@
  */
 export type JsonRpcVersion = '2.0';
 /**
- * MCP Protocol Version
+ * MCP Protocol Version. Per the [MCP spec](https://spec.modelcontextprotocol.io/specification/basic/lifecycle/#initialization)
+ * this must be a `YYYY-MM-DD` date string (e.g. `'2024-11-05'`, `'2025-06-18'`).
+ * Claude Code's Zod validator rejects any other shape (#1874).
  */
-export interface MCPProtocolVersion {
-    major: number;
-    minor: number;
-    patch: number;
-}
+export type MCPProtocolVersion = string;
 /**
  * MCP Request ID (can be string, number, or null)
  */

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

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/shared",
-  "version": "3.0.0-alpha.7",
+  "version": "3.0.0-alpha.8",
   "type": "module",
   "description": "Shared module - common types, events, utilities, core interfaces",
   "main": "dist/index.js",