@claude-flow/cli 3.10.6 → 3.10.8

package/README.md

@@ -202,7 +202,7 @@ claude mcp add ruflo -- npx ruflo@latest mcp start
 | 📡 **Comms Layer** | Zero-trust federation — agents across machines/orgs discover, authenticate, and exchange work securely |
 | 🐝 **Swarm Coordination** | Hierarchical, mesh, and adaptive topologies with consensus |
 | 🧠 **Self-Learning** | SONA neural patterns, ReasoningBank, trajectory learning |
-| 💾 **Vector Memory** | HNSW-indexed AgentDB with 150x-12,500x faster search |
+| 💾 **Vector Memory** | HNSW-indexed AgentDB — measured ~1.9x faster at N=20k, ~3.2x–4.7x at N=5k vs brute force (recall@10 ~0.99); ANN wins above the crossover, ties/loses at small N. See [audit](docs/reviews/intelligence-system-audit-2026-05-29.md) + [`scripts/benchmark-intelligence.mjs`](scripts/benchmark-intelligence.mjs) |
 | ⚡ **Background Workers** | 12 auto-triggered workers (audit, optimize, testgaps, etc.) |
 | 🧩 **Plugin Marketplace** | 32 native Claude Code plugins + 21 npm plugins |
 | 🔌 **Multi-Provider** | Claude, GPT, Gemini, Cohere, Ollama with smart routing |
@@ -228,7 +228,7 @@ claude mcp add ruflo -- npx ruflo@latest mcp start
 | 🛠️ | **~210 tools, ready to call** | 5 server groups (Core, Intelligence, Agents, Memory, DevTools) plus an 18-tool gallery that runs entirely in your browser — works offline. |
 | 🔌 | **Bring your own MCP servers** | Click the **MCP (n)** pill in the chat input → *Add Server* and paste any MCP endpoint (HTTP, SSE, or stdio). Your tools join RuFlo's native ones in the same parallel-execution flow. Run a local MCP server on `localhost:3000` and it just works. |
 | ⚡ | **Tools run in parallel** | One model response can fire 4–6+ tools at the same time. The UI shows them as cards with a *Step 1 — 2 tools completed* badge so you can see exactly what ran. |
-| 💾 | **Memory that sticks** | Say *"remember my favorite color is indigo"* and ask weeks later — RuFlo recalls it. Backed by AgentDB + HNSW vector search (≥150× faster than brute force). |
+| 💾 | **Memory that sticks** | Say *"remember my favorite color is indigo"* and ask weeks later — RuFlo recalls it. Backed by AgentDB + HNSW vector search (measured ~1.9x–4.7x faster than brute force above the crossover, recall@10 ~0.99). |
 | 📘 | **Built-in capabilities tour** | Click the question-mark icon in the sidebar — a "RuFlo Capabilities" modal opens with the full tool list, model strengths, architecture, and keyboard shortcuts. |
 | 🏠 | **Self-hostable** | Web UI is shipped as Docker (`ruflo/src/ruvocal/Dockerfile`) with embedded Mongo. Deploy to your own Cloud Run / Fly / Kubernetes / docker-compose. The hosted [flo.ruv.io](https://flo.ruv.io/) demo is one option; running your own is fully supported. |
 | 🚀 | **Zero install to try** | Open the hosted URL, pick a model, type a question. That's the whole onboarding. |

package/dist/src/mcp-tools/hooks-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/hooks-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,YAAY,CAAC;AAsrBzD,eAAO,MAAM,YAAY,EAAE,OAwC1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OA+C3B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,OAqC7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,OAmD9B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,OAgLxB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAoE1B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,OA8CvB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAyF1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OAuK3B,CAAC;AAGF,eAAO,MAAM,YAAY,EAAE,OA4E1B,CAAC;AAGF,eAAO,MAAM,aAAa,EAAE,OAiJ3B,CAAC;AAGF,eAAO,MAAM,gBAAgB,EAAE,OAoE9B,CAAC;AAGF,eAAO,MAAM,aAAa,EAAE,OA+E3B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAuI/B,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,OAuF7B,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,OAyCjC,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,OA+BzB,CAAC;AAGF,eAAO,MAAM,SAAS,EAAE,OAsCvB,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAkI/B,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OAmEpC,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,OAyDlC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OAiEjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OAqJhC,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OA4E/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OAwGhC,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OAgNpC,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OAwEpC,CAAC;AAGF,eAAO,MAAM,0BAA0B,EAAE,OA8MxC,CAAC;AAgQF,eAAO,MAAM,eAAe,EAAE,OA8C7B,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,OAwIjC,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAuD/B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAkE/B,CAAC;AAiBF,eAAO,MAAM,eAAe,EAAE,OA4C7B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAgC/B,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,OAuB7B,CAAC;AAqBF,eAAO,MAAM,iBAAiB,EAAE,OA0C/B,CAAC;AAOF,eAAO,MAAM,iBAAiB,EAAE,OAwB/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OA4BhC,CAAC;AAGF,eAAO,MAAM,UAAU,EAAE,OAAO,EA0C/B,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"hooks-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/hooks-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,YAAY,CAAC;AAsrBzD,eAAO,MAAM,YAAY,EAAE,OAwC1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OA+C3B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,OAqC7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,OAmD9B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,OAgLxB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAoE1B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,OA8CvB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAyF1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OAuK3B,CAAC;AAGF,eAAO,MAAM,YAAY,EAAE,OA4E1B,CAAC;AAGF,eAAO,MAAM,aAAa,EAAE,OAiJ3B,CAAC;AAGF,eAAO,MAAM,gBAAgB,EAAE,OAoE9B,CAAC;AAGF,eAAO,MAAM,aAAa,EAAE,OA+E3B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAuI/B,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,OAuF7B,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,OAyCjC,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,OA+BzB,CAAC;AAGF,eAAO,MAAM,SAAS,EAAE,OAsCvB,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAkI/B,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OAmEpC,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,OAyDlC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OAiEjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OAuKhC,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OA4E/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OAwGhC,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OAgNpC,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OAiGpC,CAAC;AAGF,eAAO,MAAM,0BAA0B,EAAE,OA8MxC,CAAC;AAgQF,eAAO,MAAM,eAAe,EAAE,OA8C7B,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,OAwIjC,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAuD/B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAkE/B,CAAC;AAiBF,eAAO,MAAM,eAAe,EAAE,OA4C7B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAgC/B,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,OAuB7B,CAAC;AAqBF,eAAO,MAAM,iBAAiB,EAAE,OA0C/B,CAAC;AAOF,eAAO,MAAM,iBAAiB,EAAE,OAwB/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OA4BhC,CAAC;AAGF,eAAO,MAAM,UAAU,EAAE,OAAO,EA0C/B,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/src/mcp-tools/hooks-tools.js

@@ -2476,15 +2476,35 @@ export const hooksTrajectoryEnd = {
                 const ewc = await getEWCConsolidator();
                 if (ewc) {
                     try {
-                        // Record gradient sample for Fisher matrix update
-                        // Create a simple gradient from trajectory steps
-                        const gradients = new Array(384).fill(0).map((_, i) => Math.sin(i * 0.01) * (trajectory.steps.length / 10));
-                        ewc.recordGradient(`trajectory-${trajectoryId}`, gradients, success);
-                        const stats = ewc.getConsolidationStats();
-                        ewcResult = {
-                            consolidated: true,
-                            penalty: stats.avgPenalty,
-                        };
+                        // AUDIT FIX #4: derive a REAL gradient from the trajectory's
+                        // embedding (mirrors the DISTILL path, where step content is
+                        // embedded via generateEmbedding) instead of a synthetic sine
+                        // wave. The EWC library treats the embedding as the gradient
+                        // proxy (see recordPatternOutcome in ewc-consolidation.ts).
+                        let gradients = null;
+                        try {
+                            const { generateEmbedding } = await import('../memory/memory-initializer.js');
+                            // Embed the same summary that was persisted for semantic search,
+                            // so the Fisher update reflects the actual recorded trajectory.
+                            const summary = `Task: ${trajectory.task} | Agent: ${trajectory.agent} | Steps: ${trajectory.steps.map(s => `${s.action}=>${s.result}`).join('; ')}${feedback ? ` | Feedback: ${feedback}` : ''}`;
+                            const embeddingResult = await generateEmbedding(summary);
+                            if (embeddingResult?.embedding && embeddingResult.embedding.length > 0) {
+                                gradients = embeddingResult.embedding;
+                            }
+                        }
+                        catch {
+                            // Embedding generation unavailable — fall through and skip EWC
+                        }
+                        if (gradients) {
+                            ewc.recordGradient(`trajectory-${trajectoryId}`, gradients, success);
+                            const stats = ewc.getConsolidationStats();
+                            ewcResult = {
+                                consolidated: true,
+                                penalty: stats.avgPenalty,
+                            };
+                        }
+                        // If no real embedding-derived gradient is available, SKIP the EWC
+                        // update rather than feeding the Fisher matrix synthetic noise.
                     }
                     catch {
                         // EWC consolidation failed, continue without it
@@ -2929,7 +2949,27 @@ export const hooksIntelligenceLearn = {
     handler: async (params) => {
         const consolidate = params.consolidate !== false;
         const startTime = Date.now();
-        // Get SONA statistics
+        // AUDIT FIX #5: actually TRIGGER a learning/consolidation cycle instead of
+        // only reading and echoing stats. This calls the real DISTILL path
+        // (LoRA-style confidence updates with EWC++ consolidation protection) and
+        // the background learning pass, then reports the resulting stats.
+        let distill = null;
+        let distillTriggered = false;
+        try {
+            const intelligence = await import('../memory/intelligence.js');
+            // DISTILL + CONSOLIDATE: real LoRA update with EWC++ protection
+            distill = await intelligence.distillLearning();
+            distillTriggered = distill !== null;
+            // Run background learning (ruvllm) pass as well — best-effort
+            try {
+                await intelligence.runBackgroundLearning();
+            }
+            catch { /* best-effort */ }
+        }
+        catch {
+            // intelligence layer unavailable — fall back to stats-only reporting
+        }
+        // Get SONA statistics (AFTER triggering the cycle so they reflect the update)
         let sonaStats = {
             totalPatterns: 0,
             successfulRoutings: 0,
@@ -2948,7 +2988,7 @@ export const hooksIntelligenceLearn = {
                 avgConfidence: stats.avgConfidence,
             };
         }
-        // Get EWC++ statistics and optionally trigger consolidation
+        // Get EWC++ statistics after the consolidation cycle ran
         let ewcStats = {
             consolidation: false,
             fisherUpdated: false,
@@ -2963,16 +3003,20 @@ export const hooksIntelligenceLearn = {
                     consolidation: true,
                     fisherUpdated: stats.consolidationCount > 0,
                     forgettingPrevented: stats.highImportancePatterns,
-                    avgPenalty: stats.avgPenalty,
+                    avgPenalty: distill?.ewcPenalty ?? stats.avgPenalty,
                 };
             }
         }
         return {
-            learned: sonaStats.totalPatterns > 0,
+            // "learned" now reflects whether a real distill cycle actually ran
+            learned: distillTriggered || sonaStats.totalPatterns > 0,
+            cycleTriggered: distillTriggered,
+            patternsDistilled: distill?.patternsDistilled ?? 0,
             duration: Date.now() - startTime,
             updates: {
                 trajectoriesProcessed: sonaStats.trajectoriesProcessed,
                 patternsLearned: sonaStats.totalPatterns,
+                patternsDistilled: distill?.patternsDistilled ?? 0,
                 successRate: sonaStats.trajectoriesProcessed > 0
                     ? (sonaStats.successfulRoutings / (sonaStats.successfulRoutings + sonaStats.failedRoutings) * 100).toFixed(1) + '%'
                     : '0%',
@@ -2982,7 +3026,9 @@ export const hooksIntelligenceLearn = {
                 average: sonaStats.avgConfidence,
                 implementation: sona ? 'real-sona' : 'not-available',
             },
-            implementation: sona ? 'real-sona-learning' : 'placeholder',
+            implementation: distillTriggered
+                ? 'real-distill-consolidate'
+                : (sona ? 'real-sona-learning' : 'placeholder'),
         };
     },
 };