claude-flow 3.56.9 → 3.57.0

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

@@ -93,6 +93,8 @@ export interface SONAStats {
         agents: number;
     } | 'unavailable';
 }
+/** The routing gate in getRoutingSuggestion: confidence x matchRatio must reach this for a learned pattern to be used. */
+export declare const SONA_ROUTING_GATE = 0.6;
 /** Agent roles supported by the SONA routing optimizer. */
 export declare function isSupportedSonaAgent(agent: string): boolean;
 /**
@@ -101,6 +103,17 @@ export declare function isSupportedSonaAgent(agent: string): boolean;
  * Learns from past task outcomes to improve future routing decisions.
  * Integrates with Q-learning router for hybrid routing strategy.
  */
+/**
+ * How close a pattern's confidence is to the routing gate. `successesNeeded`
+ * assumes a perfect keyword match (matchRatio 1) and the 0.1 success increment;
+ * a partial match needs more.
+ */
+export declare function routingGateStatus(confidence: number): {
+    threshold: number;
+    confidence: number;
+    reached: boolean;
+    successesNeeded: number;
+};
 export declare class SONAOptimizer {
     private patterns;
     private trajectoriesProcessed;
@@ -140,6 +153,15 @@ export declare class SONAOptimizer {
         patternKey: string;
         confidence: number;
         keywordsExtracted: string[];
+        /** True when this trajectory reinforced an existing near-identical pattern instead of creating a new one (#4134). */
+        reinforcedNeighbour?: boolean;
+        /** How far the pattern is from influencing routing, so a user can see learning has not kicked in yet (#4134). */
+        routingGate?: {
+            threshold: number;
+            confidence: number;
+            reached: boolean;
+            successesNeeded: number;
+        };
     };
     /**
      * Get routing suggestion based on learned patterns.
@@ -202,6 +224,12 @@ export declare class SONAOptimizer {
      * Create a unique pattern key from keywords and agent
      */
     private createPatternKey;
+    /**
+     * The key of the existing pattern for `agent` whose keyword set overlaps
+     * `keywords` the most, if that overlap (Jaccard) reaches NEIGHBOUR_MIN_JACCARD.
+     * Ties go to the more confident pattern. Linear in the pattern count (<= 1000).
+     */
+    private findNeighbourPattern;
     /**
      * Find the best matching pattern for given keywords
      */

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

@@ -26,6 +26,10 @@ const CONFIDENCE_INCREMENT = 0.1;
 const CONFIDENCE_DECREMENT = 0.15;
 const DECAY_RATE = 0.01; // Per day
 const MAX_PATTERNS = 1000;
+/** #4134: a trajectory reinforces an existing pattern of the same agent whose keyword set overlaps at least this much (Jaccard). */
+const NEIGHBOUR_MIN_JACCARD = 0.6;
+/** The routing gate in getRoutingSuggestion: confidence x matchRatio must reach this for a learned pattern to be used. */
+export const SONA_ROUTING_GATE = 0.6;
 // ============================================================================
 // Contrastive Trainer (lazy-loaded from @ruvector/ruvllm)
 // ============================================================================
@@ -119,6 +123,18 @@ const KEYWORD_CATEGORIES = {
  * Learns from past task outcomes to improve future routing decisions.
  * Integrates with Q-learning router for hybrid routing strategy.
  */
+/**
+ * How close a pattern's confidence is to the routing gate. `successesNeeded`
+ * assumes a perfect keyword match (matchRatio 1) and the 0.1 success increment;
+ * a partial match needs more.
+ */
+export function routingGateStatus(confidence) {
+    const reached = confidence >= SONA_ROUTING_GATE;
+    const successesNeeded = reached || confidence >= MAX_CONFIDENCE
+        ? 0
+        : Math.ceil(Math.log((1 - SONA_ROUTING_GATE) / (1 - confidence)) / Math.log(1 - CONFIDENCE_INCREMENT));
+    return { threshold: SONA_ROUTING_GATE, confidence, reached, successesNeeded };
+}
 export class SONAOptimizer {
     patterns = new Map();
     trajectoriesProcessed = 0;
@@ -210,7 +226,18 @@ export class SONAOptimizer {
             };
         }
         // Create pattern key from sorted keywords
-        const patternKey = this.createPatternKey(keywords, agent);
+        let patternKey = this.createPatternKey(keywords, agent);
+        // #4134: near-identical tasks ("Verify the X plugin ..." / "Verify the Y plugin ...")
+        // used to create a separate pattern each at confidence 0.5, so none ever reached
+        // the routing gate. Reinforce the closest existing pattern of the same agent instead.
+        let reinforcedNeighbour = false;
+        if (!this.patterns.has(patternKey)) {
+            const neighbour = this.findNeighbourPattern(keywords, agent);
+            if (neighbour) {
+                patternKey = neighbour;
+                reinforcedNeighbour = true;
+            }
+        }
         // Get or create pattern
         let pattern = this.patterns.get(patternKey);
         if (!pattern) {
@@ -264,6 +291,8 @@ export class SONAOptimizer {
             patternKey,
             confidence: pattern.confidence,
             keywordsExtracted: keywords,
+            reinforcedNeighbour,
+            routingGate: routingGateStatus(pattern.confidence),
         };
     }
     /**
@@ -305,7 +334,7 @@ export class SONAOptimizer {
         const keywords = this.extractKeywords(task);
         // Priority 2: Try SONA learned pattern matching
         const sonaResult = this.findBestPatternMatch(keywords);
-        if (sonaResult && sonaResult.confidence >= 0.6) {
+        if (sonaResult && sonaResult.confidence >= SONA_ROUTING_GATE) {
             return {
                 agent: sonaResult.agent,
                 confidence: sonaResult.confidence,
@@ -532,6 +561,34 @@ export class SONAOptimizer {
         const sortedKeywords = [...keywords].sort();
         return `${agent}:${sortedKeywords.join('+')}`;
     }
+    /**
+     * The key of the existing pattern for `agent` whose keyword set overlaps
+     * `keywords` the most, if that overlap (Jaccard) reaches NEIGHBOUR_MIN_JACCARD.
+     * Ties go to the more confident pattern. Linear in the pattern count (<= 1000).
+     */
+    findNeighbourPattern(keywords, agent) {
+        const wanted = new Set(keywords);
+        let bestKey = null;
+        let bestJaccard = 0;
+        let bestConfidence = -1;
+        for (const [key, pattern] of this.patterns) {
+            if (pattern.agent !== agent)
+                continue;
+            let shared = 0;
+            for (const k of pattern.keywords)
+                if (wanted.has(k))
+                    shared++;
+            const union = wanted.size + pattern.keywords.length - shared;
+            const jaccard = union === 0 ? 0 : shared / union;
+            if (jaccard >= NEIGHBOUR_MIN_JACCARD &&
+                (jaccard > bestJaccard || (jaccard === bestJaccard && pattern.confidence > bestConfidence))) {
+                bestKey = key;
+                bestJaccard = jaccard;
+                bestConfidence = pattern.confidence;
+            }
+        }
+        return bestKey;
+    }
     /**
      * Find the best matching pattern for given keywords
      */

package/v3/@claude-flow/cli/dist/src/memory/stats-file-lock.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Serialize cooperating local writers without stealing a paused writer's lock.
+ * Abnormal termination can leave an orphan: recovery requires confirming that
+ * no writer still owns the directory before removing it. Never age-reap it.
+ */
+export declare function withStatsFileLock<T>(file: string, write: (canonicalFile: string) => T): T;
+//# sourceMappingURL=stats-file-lock.d.ts.map

package/v3/@claude-flow/cli/dist/src/memory/stats-file-lock.js

@@ -0,0 +1,53 @@
+import { mkdirSync, realpathSync, rmdirSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+/**
+ * Serialize cooperating local writers without stealing a paused writer's lock.
+ * Abnormal termination can leave an orphan: recovery requires confirming that
+ * no writer still owns the directory before removing it. Never age-reap it.
+ */
+export function withStatsFileLock(file, write) {
+    const canonicalFile = join(realpathSync(dirname(file)), basename(file));
+    const lock = `${canonicalFile}.lock`;
+    const deadline = performance.now() + 1000;
+    const sleeper = new Int32Array(new SharedArrayBuffer(4));
+    for (;;) {
+        try {
+            mkdirSync(lock, { mode: 0o700 });
+            break;
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST')
+                throw error;
+            const remaining = deadline - performance.now();
+            if (remaining <= 0) {
+                throw Object.assign(new Error('Learning stats lock is busy'), { code: 'ELOCKED', path: lock });
+            }
+            Atomics.wait(sleeper, 0, 0, Math.min(10, remaining));
+        }
+    }
+    const cleanup = () => {
+        // Only remove our empty directory. Never recursively remove foreign data.
+        rmdirSync(lock);
+    };
+    const onExit = () => {
+        try {
+            cleanup();
+        }
+        catch { /* abnormal exits may require deliberate recovery */ }
+    };
+    process.once('exit', onExit);
+    try {
+        return write(canonicalFile);
+    }
+    finally {
+        process.removeListener('exit', onExit);
+        try {
+            cleanup();
+        }
+        catch (error) {
+            const code = error.code || 'UNKNOWN';
+            console.warn(`[intelligence] Could not release learning stats lock at ${lock} (${code}); verify ownership before recovery`);
+        }
+    }
+}
+//# sourceMappingURL=stats-file-lock.js.map

package/v3/@claude-flow/cli/dist/src/mods/command-registry/schema.d.ts

@@ -63,19 +63,19 @@ export declare const commandDefinitionSchema: z.ZodEffects<z.ZodObject<{
         path: z.ZodString;
     }, "strict", z.ZodTypeAny, {
         path: string;
-        commit: string;
         repository: string;
+        commit: string;
     }, {
         path: string;
-        commit: string;
         repository: string;
+        commit: string;
     }>;
 }, "strict", z.ZodTypeAny, {
     id: string;
     source: {
         path: string;
-        commit: string;
         repository: string;
+        commit: string;
     };
     schemaVersion: 1;
     kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -100,8 +100,8 @@ export declare const commandDefinitionSchema: z.ZodEffects<z.ZodObject<{
     id: string;
     source: {
         path: string;
-        commit: string;
         repository: string;
+        commit: string;
     };
     schemaVersion: 1;
     kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -126,8 +126,8 @@ export declare const commandDefinitionSchema: z.ZodEffects<z.ZodObject<{
     id: string;
     source: {
         path: string;
-        commit: string;
         repository: string;
+        commit: string;
     };
     schemaVersion: 1;
     kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -152,8 +152,8 @@ export declare const commandDefinitionSchema: z.ZodEffects<z.ZodObject<{
     id: string;
     source: {
         path: string;
-        commit: string;
         repository: string;
+        commit: string;
     };
     schemaVersion: 1;
     kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -244,19 +244,19 @@ export declare const catalogEntrySchema: z.ZodObject<{
             path: z.ZodString;
         }, "strict", z.ZodTypeAny, {
             path: string;
-            commit: string;
             repository: string;
+            commit: string;
         }, {
             path: string;
-            commit: string;
             repository: string;
+            commit: string;
         }>;
     }, "strict", z.ZodTypeAny, {
         id: string;
         source: {
             path: string;
-            commit: string;
             repository: string;
+            commit: string;
         };
         schemaVersion: 1;
         kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -281,8 +281,8 @@ export declare const catalogEntrySchema: z.ZodObject<{
         id: string;
         source: {
             path: string;
-            commit: string;
             repository: string;
+            commit: string;
         };
         schemaVersion: 1;
         kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -307,8 +307,8 @@ export declare const catalogEntrySchema: z.ZodObject<{
         id: string;
         source: {
             path: string;
-            commit: string;
             repository: string;
+            commit: string;
         };
         schemaVersion: 1;
         kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -333,8 +333,8 @@ export declare const catalogEntrySchema: z.ZodObject<{
         id: string;
         source: {
             path: string;
-            commit: string;
             repository: string;
+            commit: string;
         };
         schemaVersion: 1;
         kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -404,8 +404,8 @@ export declare const catalogEntrySchema: z.ZodObject<{
         id: string;
         source: {
             path: string;
-            commit: string;
             repository: string;
+            commit: string;
         };
         schemaVersion: 1;
         kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -445,8 +445,8 @@ export declare const catalogEntrySchema: z.ZodObject<{
         id: string;
         source: {
             path: string;
-            commit: string;
             repository: string;
+            commit: string;
         };
         schemaVersion: 1;
         kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -510,19 +510,19 @@ export declare const commandCatalogSchema: z.ZodObject<{
                 path: z.ZodString;
             }, "strict", z.ZodTypeAny, {
                 path: string;
-                commit: string;
                 repository: string;
+                commit: string;
             }, {
                 path: string;
-                commit: string;
                 repository: string;
+                commit: string;
             }>;
         }, "strict", z.ZodTypeAny, {
             id: string;
             source: {
                 path: string;
-                commit: string;
                 repository: string;
+                commit: string;
             };
             schemaVersion: 1;
             kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -547,8 +547,8 @@ export declare const commandCatalogSchema: z.ZodObject<{
             id: string;
             source: {
                 path: string;
-                commit: string;
                 repository: string;
+                commit: string;
             };
             schemaVersion: 1;
             kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -573,8 +573,8 @@ export declare const commandCatalogSchema: z.ZodObject<{
             id: string;
             source: {
                 path: string;
-                commit: string;
                 repository: string;
+                commit: string;
             };
             schemaVersion: 1;
             kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -599,8 +599,8 @@ export declare const commandCatalogSchema: z.ZodObject<{
             id: string;
             source: {
                 path: string;
-                commit: string;
                 repository: string;
+                commit: string;
             };
             schemaVersion: 1;
             kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -670,8 +670,8 @@ export declare const commandCatalogSchema: z.ZodObject<{
             id: string;
             source: {
                 path: string;
-                commit: string;
                 repository: string;
+                commit: string;
             };
             schemaVersion: 1;
             kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -711,8 +711,8 @@ export declare const commandCatalogSchema: z.ZodObject<{
             id: string;
             source: {
                 path: string;
-                commit: string;
                 repository: string;
+                commit: string;
             };
             schemaVersion: 1;
             kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -754,8 +754,8 @@ export declare const commandCatalogSchema: z.ZodObject<{
             id: string;
             source: {
                 path: string;
-                commit: string;
                 repository: string;
+                commit: string;
             };
             schemaVersion: 1;
             kind: "help" | "query" | "prompt" | "workflow" | "mutation";
@@ -800,8 +800,8 @@ export declare const commandCatalogSchema: z.ZodObject<{
             id: string;
             source: {
                 path: string;
-                commit: string;
                 repository: string;
+                commit: string;
             };
             schemaVersion: 1;
             kind: "help" | "query" | "prompt" | "workflow" | "mutation";

package/v3/@claude-flow/cli/dist/src/ruvector/agent-wasm.d.ts

@@ -70,6 +70,16 @@ export interface ToolResult {
     success: boolean;
     output: string;
 }
+/** Shown wherever the optional @ruvector/rvagent-wasm package cannot be loaded. */
+export declare const AGENT_WASM_NOT_INSTALLED_MESSAGE: string;
+/**
+ * True when err is the module-resolution failure for @ruvector/rvagent-wasm itself.
+ * Decided by the error code OR its text, because wrappers (loaders, test harnesses)
+ * can drop `code` while keeping the message.
+ */
+export declare function isMissingAgentWasm(err: unknown): boolean;
+/** The error initAgentWasm() throws for a load failure: "not installed" with the fix, or a genuine init failure. */
+export declare function agentWasmLoadError(err: unknown): Error;
 /**
  * Check if @ruvector/rvagent-wasm is installed and loadable.
  */

package/v3/@claude-flow/cli/dist/src/ruvector/agent-wasm.js

@@ -14,6 +14,30 @@ import { readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 // ── WASM Module Detection & Init ─────────────────────────────
 let _wasmReady = false;
+/** Shown wherever the optional @ruvector/rvagent-wasm package cannot be loaded. */
+export const AGENT_WASM_NOT_INSTALLED_MESSAGE = '@ruvector/rvagent-wasm is not installed.\n' +
+    'Install it with: npm install @ruvector/rvagent-wasm (or npm install -g @ruvector/rvagent-wasm for a global ruflo)';
+/**
+ * True when err is the module-resolution failure for @ruvector/rvagent-wasm itself.
+ * Decided by the error code OR its text, because wrappers (loaders, test harnesses)
+ * can drop `code` while keeping the message.
+ */
+export function isMissingAgentWasm(err) {
+    const e = err;
+    const code = typeof e?.code === 'string' ? e.code : '';
+    const message = typeof e?.message === 'string' ? e.message : String(err);
+    if (!message.includes('@ruvector/rvagent-wasm'))
+        return false;
+    return (code === 'ERR_MODULE_NOT_FOUND' ||
+        code === 'MODULE_NOT_FOUND' ||
+        /ERR_MODULE_NOT_FOUND|MODULE_NOT_FOUND|Cannot find (package|module)/.test(message));
+}
+/** The error initAgentWasm() throws for a load failure: "not installed" with the fix, or a genuine init failure. */
+export function agentWasmLoadError(err) {
+    return isMissingAgentWasm(err)
+        ? new Error(AGENT_WASM_NOT_INSTALLED_MESSAGE)
+        : new Error(`Failed to initialize @ruvector/rvagent-wasm: ${err}`);
+}
 /**
  * Check if @ruvector/rvagent-wasm is installed and loadable.
  */
@@ -43,7 +67,9 @@ export async function initAgentWasm() {
         _wasmReady = true;
     }
     catch (err) {
-        throw new Error(`Failed to initialize @ruvector/rvagent-wasm: ${err}`);
+        // #3979 item 1: a missing optional package is "not installed", with the fix,
+        // not a raw ERR_MODULE_NOT_FOUND trace dressed up as an initialization failure.
+        throw agentWasmLoadError(err);
     }
 }
 // ── Agent Registry ───────────────────────────────────────────

package/v3/@claude-flow/cli/dist/src/ruvector/diff-classifier.d.ts

@@ -145,10 +145,8 @@ export declare function assessFileRisk(file: DiffFile): FileRisk;
  * Assess overall risk from files and file risks
  */
 export declare function assessOverallRisk(files: DiffFile[], fileRisks: FileRisk[]): OverallRisk;
-/**
- * Classify a diff based on files (uses singleton classifier)
- */
-export declare function classifyDiff(files: DiffFile[]): DiffClassification;
+/** Classify file metadata with the actual patch and, for one-commit ranges, its subject. */
+export declare function classifyDiff(files: DiffFile[], patch?: string, commitSubject?: string): DiffClassification;
 /**
  * Suggest reviewers based on files and risks
  */