claude-flow 3.7.0-alpha.5 → 3.7.0-alpha.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.7.0-alpha.5",
+  "version": "3.7.0-alpha.7",
   "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/mcp-tools/hooks-tools.js

@@ -66,11 +66,12 @@ async function getEWCConsolidator() {
     return ewcConsolidator;
 }
 // MoE Router - lazy loaded
+// #1773 item 4 — moe-router migrated to @claude-flow/neural
 let moeRouter = null;
 async function getMoERouter() {
     if (!moeRouter) {
         try {
-            const { getMoERouter: getMoE } = await import('../ruvector/moe-router.js');
+            const { getMoERouter: getMoE } = await import('@claude-flow/neural');
             moeRouter = await getMoE();
         }
         catch {
@@ -336,11 +337,12 @@ function getRouterBackendInfo() {
     }
 }
 // Flash Attention - lazy loaded
+// #1773 item 4 — flash-attention migrated to @claude-flow/neural
 let flashAttention = null;
 async function getFlashAttention() {
     if (!flashAttention) {
         try {
-            const { getFlashAttention: getFlash } = await import('../ruvector/flash-attention.js');
+            const { getFlashAttention: getFlash } = await import('@claude-flow/neural');
             flashAttention = await getFlash();
         }
         catch {

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

@@ -668,7 +668,8 @@ export const neuralTools = [
                     // The two surfaces now agree on a single source of truth.
                     flashAttention: await (async () => {
                         try {
-                            const { getFlashAttention } = await import('../ruvector/flash-attention.js');
+                            // #1773 item 4 — flash-attention now lives in @claude-flow/neural
+                            const { getFlashAttention } = await import('@claude-flow/neural');
                             return getFlashAttention() !== null;
                         }
                         catch {

package/v3/@claude-flow/cli/dist/src/memory/neural-package-bridge.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Bridge to @claude-flow/neural — Phase 1 convergence (#1773).
+ *
+ * The cli has historically reimplemented SONA / ReasoningBank / PatternLearner
+ * locally in `intelligence.ts`. The dedicated `@claude-flow/neural` package
+ * (3.0.0-alpha.7+) ships the canonical implementations plus 7 RL algorithms
+ * (PPO/DQN/A2C/Decision Transformer/Q-Learning/SARSA/Curiosity), 5 SONA
+ * modes (RealTime/Balanced/Research/Edge/Batch), and an event listener
+ * system that the cli's local impl doesn't have.
+ *
+ * This bridge lazy-loads `NeuralLearningSystem` from the package and exposes
+ * a stable accessor for cli code that wants to use the richer surface. The
+ * existing local LocalSonaCoordinator + LocalReasoningBank in intelligence.ts
+ * stay intact for now — Phase 1 just proves the wiring works without
+ * breaking the 769 cli tests. Phase 2+ migrates functions one at a time.
+ *
+ * Why lazy: instantiating NeuralLearningSystem pulls in @ruvector/sona and
+ * a few transitive WASM modules — not free at process startup. The bridge
+ * defers until something actually asks for it.
+ */
+import type { NeuralLearningSystem, SONAMode } from '@claude-flow/neural';
+/**
+ * Lazy-load + initialize the @claude-flow/neural NeuralLearningSystem. Returns
+ * null if the package isn't resolvable (defensive — the package is in cli's
+ * regular dependencies, but environments with --ignore-scripts or pnpm prune
+ * can leave it unavailable). Idempotent across calls.
+ */
+export declare function getNeuralPackage(mode?: SONAMode): Promise<NeuralLearningSystem | null>;
+/**
+ * Quick "is the package available?" probe without forcing initialization.
+ * Returns true if a previous getNeuralPackage() call succeeded; null if
+ * never tried or failed. Useful for dashboards that want to surface package
+ * status without triggering load.
+ */
+export declare function isNeuralPackageLoaded(): boolean;
+/**
+ * Get aggregated stats from the neural package alongside cli's local stats.
+ * Returns null if the package isn't loaded — caller should fall back to
+ * local-only stats. The return shape mirrors the package's NeuralLearningSystem
+ * .getStats() output: { sona, reasoningBank, patternLearner }.
+ */
+export declare function getNeuralPackageStats(): Promise<ReturnType<NeuralLearningSystem['getStats']> | null>;
+/**
+ * Reset the bridge (mainly for tests). Drops the cached instance and
+ * forgets any prior init failure so the next getNeuralPackage() retries.
+ */
+export declare function resetNeuralPackageBridge(): void;
+//# sourceMappingURL=neural-package-bridge.d.ts.map

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

@@ -0,0 +1,87 @@
+/**
+ * Bridge to @claude-flow/neural — Phase 1 convergence (#1773).
+ *
+ * The cli has historically reimplemented SONA / ReasoningBank / PatternLearner
+ * locally in `intelligence.ts`. The dedicated `@claude-flow/neural` package
+ * (3.0.0-alpha.7+) ships the canonical implementations plus 7 RL algorithms
+ * (PPO/DQN/A2C/Decision Transformer/Q-Learning/SARSA/Curiosity), 5 SONA
+ * modes (RealTime/Balanced/Research/Edge/Batch), and an event listener
+ * system that the cli's local impl doesn't have.
+ *
+ * This bridge lazy-loads `NeuralLearningSystem` from the package and exposes
+ * a stable accessor for cli code that wants to use the richer surface. The
+ * existing local LocalSonaCoordinator + LocalReasoningBank in intelligence.ts
+ * stay intact for now — Phase 1 just proves the wiring works without
+ * breaking the 769 cli tests. Phase 2+ migrates functions one at a time.
+ *
+ * Why lazy: instantiating NeuralLearningSystem pulls in @ruvector/sona and
+ * a few transitive WASM modules — not free at process startup. The bridge
+ * defers until something actually asks for it.
+ */
+let pkgInstance = null;
+let pkgInitPromise = null;
+let pkgInitFailed = false;
+/**
+ * Lazy-load + initialize the @claude-flow/neural NeuralLearningSystem. Returns
+ * null if the package isn't resolvable (defensive — the package is in cli's
+ * regular dependencies, but environments with --ignore-scripts or pnpm prune
+ * can leave it unavailable). Idempotent across calls.
+ */
+export async function getNeuralPackage(mode = 'balanced') {
+    if (pkgInstance)
+        return pkgInstance;
+    if (pkgInitFailed)
+        return null;
+    if (pkgInitPromise)
+        return pkgInitPromise;
+    pkgInitPromise = (async () => {
+        try {
+            const m = await import('@claude-flow/neural');
+            const sys = m.createNeuralLearningSystem(mode);
+            await sys.initialize();
+            pkgInstance = sys;
+            return sys;
+        }
+        catch (err) {
+            // CLAUDE_FLOW_DEBUG-gated log so future regressions of this shape
+            // don't disappear silently — same convention as the ruvllm coordinator
+            // bridge (#1770).
+            if (process.env.CLAUDE_FLOW_DEBUG) {
+                // eslint-disable-next-line no-console
+                console.error('[neural-package] @claude-flow/neural load failed:', err.message);
+            }
+            pkgInitFailed = true;
+            return null;
+        }
+    })();
+    return pkgInitPromise;
+}
+/**
+ * Quick "is the package available?" probe without forcing initialization.
+ * Returns true if a previous getNeuralPackage() call succeeded; null if
+ * never tried or failed. Useful for dashboards that want to surface package
+ * status without triggering load.
+ */
+export function isNeuralPackageLoaded() {
+    return pkgInstance !== null;
+}
+/**
+ * Get aggregated stats from the neural package alongside cli's local stats.
+ * Returns null if the package isn't loaded — caller should fall back to
+ * local-only stats. The return shape mirrors the package's NeuralLearningSystem
+ * .getStats() output: { sona, reasoningBank, patternLearner }.
+ */
+export async function getNeuralPackageStats() {
+    const sys = await getNeuralPackage();
+    return sys ? sys.getStats() : null;
+}
+/**
+ * Reset the bridge (mainly for tests). Drops the cached instance and
+ * forgets any prior init failure so the next getNeuralPackage() retries.
+ */
+export function resetNeuralPackageBridge() {
+    pkgInstance = null;
+    pkgInitPromise = null;
+    pkgInitFailed = false;
+}
+//# sourceMappingURL=neural-package-bridge.js.map

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

@@ -13,13 +13,11 @@
  * @module @claude-flow/cli/ruvector
  */
 export { QLearningRouter, createQLearningRouter, type QLearningRouterConfig, type RouteDecision } from './q-learning-router.js';
-export { MoERouter, getMoERouter, resetMoERouter, createMoERouter, EXPERT_NAMES, NUM_EXPERTS, INPUT_DIM, HIDDEN_DIM, type ExpertType, type MoERouterConfig, type RoutingResult, type LoadBalanceStats, } from './moe-router.js';
 export { ASTAnalyzer, createASTAnalyzer, type ASTAnalysis, type ASTNode, type ASTAnalyzerConfig } from './ast-analyzer.js';
 export { DiffClassifier, createDiffClassifier, analyzeDiff, analyzeDiffSync, assessFileRisk, assessOverallRisk, classifyDiff, suggestReviewers, getGitDiffNumstat, getGitDiffNumstatAsync, clearDiffCache, clearAllDiffCaches, type DiffClassification, type DiffHunk, type DiffChange, type FileDiff, type DiffAnalysis, type DiffClassifierConfig, type DiffFile, type RiskLevel, type FileRisk, type OverallRisk, type DiffAnalysisResult, } from './diff-classifier.js';
 export { CoverageRouter, createCoverageRouter, coverageRoute, coverageSuggest, coverageGaps, clearCoverageCache, getCoverageCacheStats, type CoverageRouterConfig, type FileCoverage, type CoverageReport, type CoverageRouteResult, type CoverageSuggestResult, type CoverageGapsResult, type CoverageRouteOptions, type CoverageSuggestOptions, type CoverageGapsOptions, } from './coverage-router.js';
 export { coverageRouterTools, hooksCoverageRoute, hooksCoverageSuggest, hooksCoverageGaps } from './coverage-tools.js';
 export { buildDependencyGraph, analyzeGraph, analyzeMinCutBoundaries, analyzeModuleCommunities, detectCircularDependencies, exportToDot, loadRuVector, fallbackMinCut, fallbackLouvain, clearGraphCaches, getGraphCacheStats, type GraphNode, type GraphEdge, type DependencyGraph, type MinCutBoundary, type ModuleCommunity, type CircularDependency, type GraphAnalysisResult, } from './graph-analyzer.js';
-export { FlashAttention, getFlashAttention, resetFlashAttention, computeAttention, benchmarkFlashAttention, getFlashAttentionSpeedup, type FlashAttentionConfig, type AttentionResult, type BenchmarkResult, } from './flash-attention.js';
 export { LoRAAdapter, getLoRAAdapter, resetLoRAAdapter, createLoRAAdapter, adaptEmbedding, trainLoRA, getLoRAStats, DEFAULT_RANK, DEFAULT_ALPHA, INPUT_DIM as LORA_INPUT_DIM, OUTPUT_DIM as LORA_OUTPUT_DIM, type LoRAConfig, type LoRAWeights, type AdaptationResult, type LoRAStats, } from './lora-adapter.js';
 export { ModelRouter, getModelRouter, resetModelRouter, createModelRouter, routeToModel, routeToModelFull, analyzeTaskComplexity, getModelRouterStats, recordModelOutcome, MODEL_CAPABILITIES, COMPLEXITY_INDICATORS, type ClaudeModel, type ModelRouterConfig, type ModelRoutingResult, type ComplexityAnalysis, } from './model-router.js';
 export { SemanticRouter, createSemanticRouter, type Intent, type RouteResult, type RouterConfig, } from './semantic-router.js';

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

@@ -13,7 +13,10 @@
  * @module @claude-flow/cli/ruvector
  */
 export { QLearningRouter, createQLearningRouter } from './q-learning-router.js';
-export { MoERouter, getMoERouter, resetMoERouter, createMoERouter, EXPERT_NAMES, NUM_EXPERTS, INPUT_DIM, HIDDEN_DIM, } from './moe-router.js';
+// #1773 item 4 — moe-router migrated to @claude-flow/neural. Direct
+// consumers (hooks-tools.ts) import from '@claude-flow/neural' explicitly;
+// re-exporting through this barrel would force vitest to resolve the
+// neural pkg's transitive @ruvector/sona dep eagerly. Keep imports direct.
 export { ASTAnalyzer, createASTAnalyzer } from './ast-analyzer.js';
 export { DiffClassifier, createDiffClassifier, 
 // MCP tool exports
@@ -29,7 +32,10 @@ export { coverageRouterTools, hooksCoverageRoute, hooksCoverageSuggest, hooksCov
 export { buildDependencyGraph, analyzeGraph, analyzeMinCutBoundaries, analyzeModuleCommunities, detectCircularDependencies, exportToDot, loadRuVector, fallbackMinCut, fallbackLouvain, 
 // Cache utilities (NEW)
 clearGraphCaches, getGraphCacheStats, } from './graph-analyzer.js';
-export { FlashAttention, getFlashAttention, resetFlashAttention, computeAttention, benchmarkFlashAttention, getFlashAttentionSpeedup, } from './flash-attention.js';
+// #1773 item 4 — flash-attention migrated to @claude-flow/neural. Direct
+// consumers (hooks-tools.ts, neural-tools.ts) import from '@claude-flow/neural'
+// explicitly; re-exporting through this barrel pulls the package's
+// transitive @ruvector/sona dep into vitest's eager resolution.
 export { LoRAAdapter, getLoRAAdapter, resetLoRAAdapter, createLoRAAdapter, adaptEmbedding, trainLoRA, getLoRAStats, DEFAULT_RANK, DEFAULT_ALPHA, INPUT_DIM as LORA_INPUT_DIM, OUTPUT_DIM as LORA_OUTPUT_DIM, } from './lora-adapter.js';
 export { ModelRouter, getModelRouter, resetModelRouter, createModelRouter, routeToModel, routeToModelFull, analyzeTaskComplexity, getModelRouterStats, recordModelOutcome, MODEL_CAPABILITIES, COMPLEXITY_INDICATORS, } from './model-router.js';
 export { SemanticRouter, createSemanticRouter, } from './semantic-router.js';

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

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/cli",
-  "version": "3.7.0-alpha.5",
+  "version": "3.7.0-alpha.7",
   "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",
@@ -97,6 +97,7 @@
   "dependencies": {
     "@claude-flow/cli-core": "^3.7.0-alpha.5",
     "@claude-flow/mcp": "^3.0.0-alpha.8",
+    "@claude-flow/neural": "^3.0.0-alpha.8",
     "@claude-flow/shared": "^3.0.0-alpha.7",
     "@noble/ed25519": "^2.1.0",
     "@ruvector/rabitq-wasm": "^0.1.0",