@claude-flow/cli 3.56.9 → 3.57.0

package/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/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/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/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/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
  */