claude-flow 3.18.0 → 3.18.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.18.0",
+  "version": "3.18.1",
   "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/dist/src/commands/neural.js

@@ -451,17 +451,27 @@ 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'),
                         details: stats._trainingBackend === 'ruvllm'
-                            ? 'ruvllm checkpoints enabled'
-                            : 'JS fallback (no checkpoints)',
+                            ? '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,15 @@ 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';
 /**
  * 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,25 @@ 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';
+    }
+}
 async function loadTrainingPipeline(adapter) {
     if (pipelineLoaded)
         return ruvllmPipeline;
@@ -295,9 +315,7 @@ export class LoRAAdapter {
                 ? this.adaptationNormSum / this.totalAdaptations
                 : 0,
             lastUpdate: this.lastUpdate,
-            _trainingBackend: pipelineLoaded
-                ? (ruvllmPipeline ? 'ruvllm' : 'js-fallback')
-                : 'js-fallback',
+            _trainingBackend: resolveTrainingBackend(),
         };
     }
     /**

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

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