claude-flow 3.18.0 → 3.18.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.18.0",
+  "version": "3.18.2",
   "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",
@@ -116,7 +116,8 @@
     "ws": ">=8.21.0",
     "@grpc/grpc-js": ">=1.14.4",
     "form-data": ">=4.0.6",
-    "http-proxy-middleware": ">=3.0.7"
+    "http-proxy-middleware": ">=3.0.7",
+    "@ruvector/ruvllm": ">=2.5.7"
   },
   "devDependencies": {
     "@openai/codex": "^0.98.0",

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

@@ -451,17 +451,39 @@ const statusCommand = {
                     },
                     {
                         component: 'Contrastive Trainer',
-                        status: stats._contrastiveTrainer && stats._contrastiveTrainer !== 'unavailable' ? output.success('Active') : output.dim('Unavailable'),
-                        details: stats._contrastiveTrainer && stats._contrastiveTrainer !== 'unavailable'
+                        // #2549 — three states: live session (object with counts),
+                        // 'available' (module resolves, no in-process session — the
+                        // normal case for a read-only status process), 'unavailable'
+                        // (module genuinely does not resolve).
+                        status: typeof stats._contrastiveTrainer === 'object'
+                            ? output.success('Active')
+                            : stats._contrastiveTrainer === 'available'
+                                ? output.success('Available')
+                                : output.dim('Unavailable'),
+                        details: typeof stats._contrastiveTrainer === 'object'
                             ? `${stats._contrastiveTrainer.triplets ?? 0} triplets, ${stats._contrastiveTrainer.agents ?? 0} agents`
-                            : 'Install @ruvector/ruvllm',
+                            : stats._contrastiveTrainer === 'available'
+                                ? 'ready — trains in-process on demand'
+                                : 'Install @ruvector/ruvllm',
                     },
                     {
                         component: 'Training Pipeline',
-                        status: stats._trainingBackend === 'ruvllm' ? output.success('Active') : output.dim(stats._trainingBackend || 'Unavailable'),
+                        status: stats._trainingBackend === 'ruvllm' ? output.success('Available') : output.dim(stats._trainingBackend || 'Unavailable'),
+                        // Checkpoint capability is version-gated: saveCheckpoint(path)
+                        // was a silent no-op before @ruvector/ruvllm 2.5.7 (#2549).
                         details: stats._trainingBackend === 'ruvllm'
-                            ? 'ruvllm checkpoints enabled'
-                            : 'JS fallback (no checkpoints)',
+                            ? await (async () => {
+                                try {
+                                    const { nativeCheckpointsSupported } = await import('../ruvector/lora-adapter.js');
+                                    return nativeCheckpointsSupported()
+                                        ? 'native @ruvector/ruvllm pipeline + disk checkpoints'
+                                        : 'native @ruvector/ruvllm pipeline (checkpoints need >=2.5.7)';
+                                }
+                                catch {
+                                    return 'native @ruvector/ruvllm pipeline';
+                                }
+                            })()
+                            : 'JS fallback',
                     },
                     await (async () => {
                         try {

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

@@ -14,6 +14,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { createRequire } from 'node:module';
 import { join } from 'node:path';
+import { resolveTrainingBackend } from '../ruvector/lora-adapter.js';
 // ============================================================================
 // Persistence Configuration
 // ============================================================================
@@ -1006,15 +1007,29 @@ export function getIntelligenceStats() {
         loadRuvllmCoordinatorSync();
     }
     const ruvllmStats = ruvllmCoordinator?.stats?.() || null;
-    // Fetch cross-module stats for unified reporting
+    // Fetch cross-module stats for unified reporting.
+    //
+    // #2549 — two prior defects here: `trainingBackend` was declared and
+    // returned but never assigned (always 'unavailable'), and contrastive
+    // availability was read ONLY from an in-process global that a fresh
+    // read-only `neural status` process never populates. Both made the
+    // native @ruvector/ruvllm path invisible even when installed. Backend
+    // now comes from the lora-adapter's capability probe; the global still
+    // wins when present because it carries live in-process session counts.
     let contrastiveTrainer = 'unavailable';
     let trainingBackend = 'unavailable';
     try {
-        // Synchronous check — contrastiveTrainer is module-level in sona-optimizer
-        // We read it via the SONAOptimizer singleton if available
+        trainingBackend = resolveTrainingBackend();
+    }
+    catch { /* module absent — stay 'unavailable' */ }
+    try {
         const sonaModule = globalThis.__claudeFlowSonaStats;
-        if (sonaModule) {
-            contrastiveTrainer = sonaModule._contrastiveTrainer || 'unavailable';
+        if (sonaModule?._contrastiveTrainer) {
+            contrastiveTrainer = sonaModule._contrastiveTrainer;
+        }
+        else if (trainingBackend === 'ruvllm') {
+            // Module resolves but no in-process session — available, idle.
+            contrastiveTrainer = 'available';
         }
     }
     catch { /* not available */ }

package/v3/@claude-flow/cli/dist/src/ruvector/lora-adapter.d.ts

@@ -97,6 +97,23 @@ export interface LoRAStats {
     /** Training backend in use ('ruvllm' | 'js-fallback') */
     _trainingBackend?: string;
 }
+/**
+ * Which training backend a train call would use — WITHOUT loading the
+ * pipeline (#2549). Before this existed, status surfaces read module state
+ * that only a prior in-process train populates, so a fresh read-only
+ * process always reported 'js-fallback'/'unavailable' even with
+ * @ruvector/ruvllm installed. The pipeline stays lazy: this only probes
+ * module resolution.
+ */
+export declare function resolveTrainingBackend(): 'ruvllm' | 'js-fallback';
+/**
+ * Whether the resolved @ruvector/ruvllm persists checkpoints to disk.
+ * saveCheckpoint(path) was a silent no-op (private, void, wrote 0 bytes)
+ * before 2.5.7 — status surfaces must not advertise checkpoints against
+ * older versions. Reads the resolved package's version; the package does
+ * not export ./package.json, so walk up from the resolved entry instead.
+ */
+export declare function nativeCheckpointsSupported(): boolean;
 /**
  * Low-Rank Adaptation module for efficient embedding fine-tuning
  */

package/v3/@claude-flow/cli/dist/src/ruvector/lora-adapter.js

@@ -19,6 +19,7 @@
  */
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
 import { dirname, join } from 'path';
+import { createRequire } from 'module';
 // ============================================================================
 // Types & Constants
 // ============================================================================
@@ -57,6 +58,53 @@ const DEFAULT_CONFIG = {
 // ============================================================================
 let ruvllmPipeline = null;
 let pipelineLoaded = false;
+/**
+ * Which training backend a train call would use — WITHOUT loading the
+ * pipeline (#2549). Before this existed, status surfaces read module state
+ * that only a prior in-process train populates, so a fresh read-only
+ * process always reported 'js-fallback'/'unavailable' even with
+ * @ruvector/ruvllm installed. The pipeline stays lazy: this only probes
+ * module resolution.
+ */
+export function resolveTrainingBackend() {
+    if (pipelineLoaded)
+        return ruvllmPipeline ? 'ruvllm' : 'js-fallback';
+    try {
+        createRequire(import.meta.url).resolve('@ruvector/ruvllm');
+        return 'ruvllm';
+    }
+    catch {
+        return 'js-fallback';
+    }
+}
+/**
+ * Whether the resolved @ruvector/ruvllm persists checkpoints to disk.
+ * saveCheckpoint(path) was a silent no-op (private, void, wrote 0 bytes)
+ * before 2.5.7 — status surfaces must not advertise checkpoints against
+ * older versions. Reads the resolved package's version; the package does
+ * not export ./package.json, so walk up from the resolved entry instead.
+ */
+export function nativeCheckpointsSupported() {
+    try {
+        const req = createRequire(import.meta.url);
+        let dir = dirname(req.resolve('@ruvector/ruvllm'));
+        for (let i = 0; i < 5; i++) {
+            const pkgPath = join(dir, 'package.json');
+            if (existsSync(pkgPath)) {
+                const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+                if (pkg.name !== '@ruvector/ruvllm') {
+                    dir = dirname(dir);
+                    continue;
+                }
+                const [maj, min, pat] = String(pkg.version).split('.').map(Number);
+                return maj > 2 || (maj === 2 && (min > 5 || (min === 5 && pat >= 7)));
+            }
+            dir = dirname(dir);
+        }
+    }
+    catch { /* unresolved — no native checkpoints */ }
+    return false;
+}
 async function loadTrainingPipeline(adapter) {
     if (pipelineLoaded)
         return ruvllmPipeline;
@@ -295,9 +343,7 @@ export class LoRAAdapter {
                 ? this.adaptationNormSum / this.totalAdaptations
                 : 0,
             lastUpdate: this.lastUpdate,
-            _trainingBackend: pipelineLoaded
-                ? (ruvllmPipeline ? 'ruvllm' : 'js-fallback')
-                : 'js-fallback',
+            _trainingBackend: resolveTrainingBackend(),
         };
     }
     /**
@@ -390,11 +436,18 @@ export class LoRAAdapter {
      * Falls back to writing our own weight JSON if ruvllm is unavailable.
      */
     async saveCheckpoint(path) {
+        // Parent dir must exist for BOTH paths: ruvllm <2.5.7 never wrote a
+        // file at all, and the JS fallback's writeFileSync throws ENOENT on a
+        // missing dir — which the catch silently converted to `false` (#2549).
+        try {
+            mkdirSync(dirname(path), { recursive: true });
+        }
+        catch { /* fs errors surface on write below */ }
         const pipeline = await loadTrainingPipeline(this);
         if (pipeline) {
             try {
                 pipeline.saveCheckpoint(path);
-                // Verify ruvllm actually wrote the file (some versions are no-op)
+                // Verify ruvllm actually wrote the file (<2.5.7 is a silent no-op)
                 const fs = await import('fs');
                 if (fs.existsSync(path))
                     return true;

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

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