claude-flow 3.38.3 → 3.38.4

package/package.json

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

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

@@ -1,8 +1,6 @@
 <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/)
@@ -58,7 +56,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 | **No** (`memory_store`, `swarm_init`, etc. unavailable to Claude) | Yes |
+| MCP server registered | Only if `ruflo-core` is installed (it ships its own `.mcp.json`) — most other plugins don't | 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 |
 
@@ -75,7 +73,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 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.
+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.
 
 <details>
 <summary><strong>🔌 All 35 plugins</strong></summary>
@@ -189,24 +187,10 @@ npm install -g ruflo@latest
 ### MCP Server
 
 ```bash
-# Add Ruflo as an MCP server in Claude Code (canonical form, matches USERGUIDE.md)
-claude mcp add ruflo -- npx ruflo@latest mcp start
+# Add Ruflo as an MCP server in Claude Code
+claude mcp add claude-flow -- 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-07-29T19:49:43.000Z",
-  "gitSha": "bbfbb0a6",
+  "generatedAt": "2026-08-12T18:43:20.202Z",
+  "gitSha": "d41af6e4",
   "catalog": {
     "agents": 164,
     "tools": 397,

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

@@ -496,8 +496,16 @@ const initClaudeAction = async (ctx) => {
     const force = ctx.flags.force;
     const minimal = ctx.flags.minimal;
     const full = ctx.flags.full;
-    const skipClaude = ctx.flags['skip-claude'];
-    const onlyClaude = ctx.flags['only-claude'];
+    // #2952 — every long-flag write path in the parser goes through
+    // normalizeKey() (parser.ts:399-402), which converts kebab-case to
+    // camelCase before storing. `--skip-claude`/`--only-claude`/
+    // `--all-agents`/`--cloud-mcp` land as `flags.skipClaude`/`flags.onlyClaude`/
+    // `flags.allAgents`/`flags.cloudMcp` — there is no code path that ever
+    // stores the literal kebab-case key. Reading `ctx.flags['skip-claude']`
+    // etc. was always undefined, so all four flags were silent no-ops. Same
+    // bug class as #2098A below, just never applied to these siblings.
+    const skipClaude = ctx.flags.skipClaude;
+    const onlyClaude = ctx.flags.onlyClaude;
     // #2098A — the parser handles `--no-foo` by stripping the prefix and
     // storing `flags.foo = false` (parser.ts:291-294), not by storing
     // `flags['no-foo'] = true`. So `--no-global` lands as
@@ -505,8 +513,8 @@ const initClaudeAction = async (ctx) => {
     // was always undefined and silently no-op'd — every user with the flag
     // set still got `~/.claude/CLAUDE.md` modified. Read the real key.
     const noGlobal = ctx.flags['no-global'] === true || ctx.flags['global'] === false;
-    const allAgents = ctx.flags['all-agents'];
-    const cloudMcp = ctx.flags['cloud-mcp'];
+    const allAgents = ctx.flags.allAgents;
+    const cloudMcp = ctx.flags.cloudMcp;
     const cwd = ctx.cwd;
     // Check if already initialized
     const initialized = isInitialized(cwd);

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

@@ -1377,26 +1377,36 @@ export const hooksPostTask = {
         catch {
             // Intelligence module not available — non-fatal
         }
-        // ADR-130 Phase 3: fire-and-forget "reinforced-by" edge on task success
+        // ADR-130 Phase 3: "reinforced-by" edge on task success.
         // Writes: context node → task pattern node (relation: "reinforced-by")
+        //
+        // #2961 — this used to be fire-and-forget (no `await` on the IIFE). That
+        // was invisible from the long-running MCP server, where the process
+        // stays alive long enough for the detached write to finish in the
+        // background. But `hooks post-task` (CLI) is the exact same handler
+        // invoked from a one-shot process that calls `process.exit(0)`
+        // immediately after this action resolves (bin/cli.js, #1552) — the
+        // still-pending dynamic `import(...)` + `insertGraphEdge()` call was
+        // killed before its first tick, so the CLI form dropped this edge on
+        // every single success, not intermittently. Await it — this is a
+        // single fast DB write, not worth losing correctness on one call site
+        // to save latency on the other.
         if (success) {
-            (async () => {
-                try {
-                    const { insertGraphEdge } = await import('../memory/graph-edge-writer.js');
-                    const sessionCtxId = `task:${taskId}`;
-                    const patternId = `pattern:${taskId}`;
-                    await insertGraphEdge({
-                        sourceId: sessionCtxId,
-                        targetId: patternId,
-                        relation: 'reinforced-by',
-                        weight: quality,
-                        confidence: quality,
-                        lastReinforced: new Date().toISOString(),
-                        metadata: { success, agent, taskId },
-                    });
-                }
-                catch { /* non-fatal */ }
-            })().catch(() => { });
+            try {
+                const { insertGraphEdge } = await import('../memory/graph-edge-writer.js');
+                const sessionCtxId = `task:${taskId}`;
+                const patternId = `pattern:${taskId}`;
+                await insertGraphEdge({
+                    sourceId: sessionCtxId,
+                    targetId: patternId,
+                    relation: 'reinforced-by',
+                    weight: quality,
+                    confidence: quality,
+                    lastReinforced: new Date().toISOString(),
+                    metadata: { success, agent, taskId },
+                });
+            }
+            catch { /* non-fatal */ }
         }
         // Persist routing outcome for runtime learning (file-based, always reliable)
         const taskText = params.task || '';

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

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