claude-flow 3.38.2 → 3.38.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.38.2",
+  "version": "3.38.3",
   "workspaces": [
     "v3/@claude-flow/codex",
     "v3/@claude-flow/plugin-agent-federation",

package/v3/@claude-flow/cli/README.md

@@ -1,6 +1,8 @@
 <div align="center">
 
 [![Ruflo Banner](ruflo/assets/ruflo-small.jpeg)](https://cognitum.one/agentic-engineering)
+[![Agentics Foundation Banner](docs/assets/sv-summit.png)](https://agentics.org/siliconvalley/?UTM=GH-RuFlo-SV)
+
 
 <!-- Try Ruflo — the 4 badges first-time visitors actually act on -->
 [![Try the UI Beta — flo.ruv.io](https://img.shields.io/badge/_Try_the_UI_Beta-flo.ruv.io-6366f1?style=for-the-badge&logoColor=white&logo=svelte)](https://flo.ruv.io/)
@@ -56,7 +58,7 @@ There are **two different install paths** with very different surface areas. Pic
 |---|---|---|
 | What it gives you | Slash commands + a few skills + agent definitions per-plugin | Full Ruflo loop — 98 agents, 60+ commands, 30 skills, MCP server, hooks, daemon |
 | Files in your workspace | **Zero** | `.claude/`, `.claude-flow/`, `CLAUDE.md`, helpers, settings |
-| MCP server registered | Only if `ruflo-core` is installed (it ships its own `.mcp.json`) — most other plugins don't | Yes |
+| MCP server registered | **No** (`memory_store`, `swarm_init`, etc. unavailable to Claude) | Yes |
 | Hooks installed | No | Yes |
 | Best for | Try a single plugin's commands without committing to the full install | Production use — everything works as documented |
 
@@ -73,7 +75,7 @@ There are **two different install paths** with very different surface areas. Pic
 /plugin install ruflo-neural-trader@ruflo
 ```
 
-This adds slash commands and agent definitions. `ruflo-core` (installed above) does register its own MCP server on install — its tools are callable as `mcp__plugin_ruflo-core_ruflo__*` (e.g. `mcp__plugin_ruflo-core_ruflo__memory_store`), not the bare `memory_store`/`swarm_init`/`agent_spawn` names the CLI-track scaffold uses. Other plugins generally don't ship their own MCP server. For the full loop with the CLI-track tool names, use Path B below.
+This adds slash commands and agent definitions only. The Ruflo MCP server is NOT registered, so `memory_store`, `swarm_init`, `agent_spawn`, etc. won't be callable from Claude. For the full loop, use Path B below.
 
 <details>
 <summary><strong>🔌 All 35 plugins</strong></summary>
@@ -187,10 +189,24 @@ npm install -g ruflo@latest
 ### MCP Server
 
 ```bash
-# Add Ruflo as an MCP server in Claude Code
-claude mcp add claude-flow -- npx ruflo@latest mcp start
+# Add Ruflo as an MCP server in Claude Code (canonical form, matches USERGUIDE.md)
+claude mcp add ruflo -- npx ruflo@latest mcp start
 ```
 
+Small-context backends can advertise only the tool categories they need:
+
+```bash
+CLAUDE_FLOW_MCP_TOOLS=memory,swarm,agent,hooks \
+  npx ruflo@latest mcp start
+
+# Optional: lets `ruflo doctor -c mcp-overhead` compare the live schema
+# estimate with the backend's real context limit.
+CLAUDE_FLOW_CONTEXT_WINDOW_TOKENS=32000 ruflo doctor -c mcp-overhead
+```
+
+The default remains `all` for backwards compatibility. Selectors accept
+categories, namespace prefixes, or exact tool names.
+
 ---
 
 ## What You Get

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

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "generation": 4,
-  "generatedAt": "2026-08-12T15:41:12.144Z",
-  "gitSha": "87f4f8ab",
+  "generatedAt": "2026-07-29T19:49:43.000Z",
+  "gitSha": "bbfbb0a6",
   "catalog": {
     "agents": 164,
     "tools": 397,

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

@@ -2194,7 +2194,12 @@ const intelligenceCommand = {
                     tokenReduction: 'N/A',
                     sweBenchScore: 'N/A',
                 },
-                lastTrainingMs: lastAdaptation ? Date.now() - lastAdaptation : undefined,
+                // #2940: a training cycle that actually ran this invocation is "now"
+                // — reading the pre-call `lastAdaptation` here would still show the
+                // stale age (the exact "aged instead of reset" symptom reported).
+                lastTrainingMs: mcpResult?.training?.trained
+                    ? 0
+                    : (lastAdaptation ? Date.now() - lastAdaptation : undefined),
                 persistence: {
                     dataDir: persistence.dataDir,
                     patternsFile: persistence.patternsFile,
@@ -2206,10 +2211,34 @@ const intelligenceCommand = {
                     trajectoriesFromDisk,
                 },
             };
+            // #2940: this block used to be a cosmetic 500ms sleep followed by an
+            // unconditional "Training cycle completed" — no training ever ran and
+            // `lastAdaptation` never moved, so `--status` could never report a
+            // training cycle as recent no matter how many times `--train` was
+            // invoked. `hooks_intelligence` now actually distills when asked
+            // (see mcp-tools/hooks-tools.ts); report what it actually did instead
+            // of a canned success message.
+            const trainingResult = mcpResult?.training;
             if (forceTraining) {
-                spinner.setText('Running training cycle...');
-                await new Promise(resolve => setTimeout(resolve, 500));
-                spinner.succeed('Training cycle completed');
+                if (trainingResult?.trained && trainingResult.patternsDistilled) {
+                    spinner.succeed(`Training cycle completed — distilled ${trainingResult.patternsDistilled} pattern${trainingResult.patternsDistilled === 1 ? '' : 's'}`);
+                }
+                else if (trainingResult?.trained) {
+                    // Ran (SONA/EWC++ distillation pass executed, lastAdaptation
+                    // moved) but found zero new patterns — deliberately NOT the same
+                    // message as a real distillation, or this is exactly the "success
+                    // report with no state change behind it" the issue describes.
+                    spinner.stop();
+                    output.printWarning(`Training cycle ran — 0 new patterns to distill (${trainingResult.reason || 'nothing new since the last cycle'})`);
+                }
+                else if (trainingResult?.attempted) {
+                    spinner.stop();
+                    output.printWarning(`Training cycle ran with nothing to do — ${trainingResult.reason || 'no new trajectories to distill'}`);
+                }
+                else {
+                    spinner.stop();
+                    output.printWarning('Training cycle could not run — intelligence MCP tool unavailable');
+                }
             }
             else {
                 spinner.succeed(hasLocalData ? 'Intelligence system active (local data loaded)' : 'Intelligence system active');

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

@@ -2360,7 +2360,39 @@ export const hooksIntelligence = {
         const flashAvailable = (await getFlashAttention()) !== null;
         const ewcAvailable = (await getEWCConsolidator()) !== null;
         const loraAvailable = (await getLoRAAdapter()) !== null;
+        // #2940: `forceTraining` (CLI `hooks intelligence --train`) was declared
+        // on this tool's input schema but never read — the handler always
+        // returned the same read-only status dashboard, so `lastAdaptation`
+        // (what `--status` reports as "Last Training") could never move no
+        // matter how many times `--train` ran. Actually distill when asked,
+        // and report honestly rather than always implying success:
+        // `attempted: false` (flag not passed), `trained: true` (real work
+        // happened, lastAdaptation now current), or `trained: false` with a
+        // reason (nothing new to distill, or distillation unavailable).
+        const training = { attempted: false, trained: false };
+        if (params.forceTraining) {
+            training.attempted = true;
+            try {
+                const { distillLearning } = await import('../memory/intelligence.js');
+                const result = await distillLearning();
+                if (result) {
+                    training.trained = true;
+                    training.patternsDistilled = result.patternsDistilled;
+                    training.ewcPenalty = result.ewcPenalty;
+                    if (result.patternsDistilled === 0) {
+                        training.reason = 'no new trajectories to distill since the last training cycle';
+                    }
+                }
+                else {
+                    training.reason = 'intelligence system unavailable — could not initialize SONA/ReasoningBank';
+                }
+            }
+            catch (error) {
+                training.reason = `distillation failed: ${error instanceof Error ? error.message : String(error)}`;
+            }
+        }
         return {
+            training,
             mode,
             status: 'active',
             components: {

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

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