claude-flow 3.6.10 → 3.6.12

package/.claude/settings.json

@@ -1,5 +1,5 @@
 {
-  "model": "claude-opus-4-6",
+  "model": "claude-opus-4-7",
   "customInstructions": "Follow the project's CLAUDE.md guidelines. Use concurrent execution for all operations. Prioritize v3 implementation with security-first development, 15-agent swarm coordination, phased performance optimization, and cross-platform helper automation.",
   "env": {
     "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
@@ -144,29 +144,7 @@
         ]
       }
     ],
-    "SubagentStart": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs\" status",
-            "timeout": 3000
-          }
-        ]
-      }
-    ],
-    "TeammateIdle": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs\" post-task",
-            "timeout": 5000
-          }
-        ]
-      }
-    ],
-    "TaskCompleted": [
+    "SubagentStop": [
       {
         "hooks": [
           {
@@ -179,14 +157,14 @@
     ]
   },
   "attribution": {
-    "commit": "Co-Authored-By: claude-flow <ruv@ruv.net>",
-    "pr": "\ud83e\udd16 Generated with [claude-flow](https://github.com/ruvnet/claude-flow)"
+    "commit": "Co-Authored-By: RuFlo <ruv@ruv.net>",
+    "pr": "\ud83e\udd16 Generated with [RuFlo](https://github.com/ruvnet/ruflo)"
   },
   "claudeFlow": {
-    "version": "3.5.2",
+    "version": "3.6.11",
     "enabled": true,
     "modelPreferences": {
-      "default": "claude-opus-4-6",
+      "default": "claude-opus-4-7",
       "routing": "claude-haiku-4-5-20251001"
     },
     "agentTeams": {
@@ -286,20 +264,20 @@
   },
   "statusLine": {
     "type": "command",
-    "command": "node \"$CLAUDE_PROJECT_DIR/.claude/helpers/statusline.cjs\""
+    "command": "sh -c 'exec node \"${CLAUDE_PROJECT_DIR:-.}/.claude/helpers/statusline.cjs\"'"
   },
   "mcpServers": {
     "claude-flow": {
-      "command": "node",
+      "command": "npx",
       "args": [
-        "/workspaces/claude-flow/v3/@claude-flow/cli/bin/cli.js",
+        "-y",
+        "ruflo@latest",
         "mcp",
         "start"
       ]
     }
   },
   "enabledMcpjsonServers": [
-    "claude-flow",
-    "ruv-swarm"
+    "claude-flow"
   ]
 }

package/README.md

@@ -34,6 +34,8 @@ User --> Ruflo (CLI/MCP) --> Router --> Swarm --> Agents --> Memory --> LLM Prov
 
 ---
 
+![Ruflo Plugins](./ruflo-plugins.gif)
+
 ## Quick Start
 
 ### Claude Code Plugin (Recommended)
@@ -52,31 +54,84 @@ Install Ruflo as a native Claude Code plugin -- adds skills, commands, agents, a
 ```
 
 <details>
-<summary><strong>All 21 plugins</strong></summary>
+<summary><strong>All 32 plugins</strong></summary>
+
+#### Core & Orchestration
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-core** | Foundation — server, health checks, plugin discovery |
+| **ruflo-swarm** | Coordinate multiple agents as a team |
+| **ruflo-autopilot** | Let agents run autonomously in a loop |
+| **ruflo-loop-workers** | Schedule background tasks on a timer |
+| **ruflo-workflows** | Reusable multi-step task templates |
+| **ruflo-federation** | Agents on different machines collaborate securely |
+
+#### Memory & Knowledge
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-agentdb** | Fast vector database for agent memory |
+| **ruflo-rag-memory** | Smart retrieval — hybrid search, graph hops, diversity ranking |
+| **ruflo-rvf** | Save and restore agent memory across sessions |
+| **ruflo-ruvector** | [`ruvector`](https://npmjs.com/package/ruvector) — GPU-accelerated search, Graph RAG, 103 tools |
+| **ruflo-knowledge-graph** | Build and traverse entity relationship maps |
+
+#### Intelligence & Learning
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-intelligence** | Agents learn from past successes and get smarter |
+| **ruflo-daa** | Dynamic agent behavior and cognitive patterns |
+| **ruflo-ruvllm** | Run local LLMs (Ollama, etc.) with smart routing |
+| **ruflo-goals** | Break big goals into plans and track progress |
+
+#### Code Quality & Testing
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-testgen** | Find missing tests and generate them automatically |
+| **ruflo-browser** | Automate browser testing with Playwright |
+| **ruflo-jujutsu** | Analyze git diffs, score risk, suggest reviewers |
+| **ruflo-docs** | Generate and maintain documentation automatically |
+
+#### Security & Compliance
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-security-audit** | Scan for vulnerabilities and CVEs |
+| **ruflo-aidefence** | Block prompt injection, detect PII, safety scanning |
+
+#### Architecture & Methodology
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-adr** | Track architecture decisions with a living record |
+| **ruflo-ddd** | Scaffold domain-driven design — contexts, aggregates, events |
+| **ruflo-sparc** | Guided 5-phase development methodology with quality gates |
+
+#### DevOps & Observability
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-migrations** | Manage database schema changes safely |
+| **ruflo-observability** | Structured logs, traces, and metrics in one place |
+| **ruflo-cost-tracker** | Track token usage, set budgets, get cost alerts |
+
+#### Extensibility
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-wasm** | Run sandboxed WebAssembly agents |
+| **ruflo-plugin-creator** | Scaffold, validate, and publish your own plugins |
+
+#### Domain-Specific
 
-| Plugin | What it adds |
+| Plugin | What it does |
 |--------|-------------|
-| **ruflo-core** | MCP server, `/status`, `/doctor`, plugin discovery, base agents |
-| **ruflo-swarm** | Swarm coordination, Monitor streams, worktree isolation |
-| **ruflo-autopilot** | Autonomous `/loop` completion with learning and prediction |
-| **ruflo-intelligence** | Self-learning SONA patterns, trajectory learning, model routing |
-| **ruflo-agentdb** | AgentDB controllers, HNSW vector search, RuVector embeddings |
-| **ruflo-aidefence** | AI safety scanning, PII detection, prompt injection defense |
-| **ruflo-browser** | Playwright browser automation for testing and scraping |
-| **ruflo-jujutsu** | Git diff analysis, risk scoring, reviewer recommendations |
-| **ruflo-wasm** | Sandboxed WASM agent creation and gallery sharing |
-| **ruflo-workflows** | Workflow templates, orchestration, lifecycle management |
-| **ruflo-daa** | Dynamic Agentic Architecture, cognitive patterns |
-| **ruflo-ruvllm** | Local LLM inference, MicroLoRA, multi-provider chat |
-| **ruflo-rvf** | RVF portable memory, session persistence, transfer |
-| **ruflo-loop-workers** | Background `/loop` workers, CronCreate scheduling |
-| **ruflo-security-audit** | Security scanning, CVE checks, dependency audit |
-| **ruflo-rag-memory** | Memory bridge, simple store/search/recall interface |
-| **ruflo-testgen** | Test gap detection, TDD workflow, tester agent |
-| **ruflo-docs** | Doc generation, drift detection, docs-writer agent |
-| **ruflo-plugin-creator** | Scaffold, validate, and publish new plugins |
-| **ruflo-federation** | Zero-trust agent federation, PII pipeline, cross-installation comms |
-| **ruflo-goals** | GOAP planning, deep research, long-horizon tracking |
+| **ruflo-iot-cognitum** | IoT device management — trust scoring, anomaly detection, fleets |
+| **ruflo-neural-trader** | [`neural-trader`](https://npmjs.com/package/neural-trader) — AI trading with 4 agents, backtesting, 112+ tools |
+| **ruflo-market-data** | Ingest market data, vectorize OHLCV, detect patterns |
 
 </details>
 
@@ -112,7 +167,7 @@ claude mcp add ruflo -- npx -y @claude-flow/cli@latest
 | 🧠 **Self-Learning** | SONA neural patterns, ReasoningBank, trajectory learning |
 | 💾 **Vector Memory** | HNSW-indexed AgentDB with 150x-12,500x faster search |
 | ⚡ **Background Workers** | 12 auto-triggered workers (audit, optimize, testgaps, etc.) |
-| 🧩 **Plugin Marketplace** | 21 native Claude Code plugins + 21 npm plugins |
+| 🧩 **Plugin Marketplace** | 32 native Claude Code plugins + 21 npm plugins |
 | 🔌 **Multi-Provider** | Claude, GPT, Gemini, Cohere, Ollama with smart routing |
 | 🛡️ **Security** | AIDefence, input validation, CVE remediation, path traversal prevention |
 | 🌐 **Agent Federation** | Cross-installation agent collaboration with zero-trust security 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.6.10",
+  "version": "3.6.12",
   "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/README.md

@@ -34,6 +34,8 @@ User --> Ruflo (CLI/MCP) --> Router --> Swarm --> Agents --> Memory --> LLM Prov
 
 ---
 
+![Ruflo Plugins](./ruflo-plugins.gif)
+
 ## Quick Start
 
 ### Claude Code Plugin (Recommended)
@@ -52,31 +54,84 @@ Install Ruflo as a native Claude Code plugin -- adds skills, commands, agents, a
 ```
 
 <details>
-<summary><strong>All 21 plugins</strong></summary>
+<summary><strong>All 32 plugins</strong></summary>
+
+#### Core & Orchestration
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-core** | Foundation — server, health checks, plugin discovery |
+| **ruflo-swarm** | Coordinate multiple agents as a team |
+| **ruflo-autopilot** | Let agents run autonomously in a loop |
+| **ruflo-loop-workers** | Schedule background tasks on a timer |
+| **ruflo-workflows** | Reusable multi-step task templates |
+| **ruflo-federation** | Agents on different machines collaborate securely |
+
+#### Memory & Knowledge
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-agentdb** | Fast vector database for agent memory |
+| **ruflo-rag-memory** | Smart retrieval — hybrid search, graph hops, diversity ranking |
+| **ruflo-rvf** | Save and restore agent memory across sessions |
+| **ruflo-ruvector** | [`ruvector`](https://npmjs.com/package/ruvector) — GPU-accelerated search, Graph RAG, 103 tools |
+| **ruflo-knowledge-graph** | Build and traverse entity relationship maps |
+
+#### Intelligence & Learning
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-intelligence** | Agents learn from past successes and get smarter |
+| **ruflo-daa** | Dynamic agent behavior and cognitive patterns |
+| **ruflo-ruvllm** | Run local LLMs (Ollama, etc.) with smart routing |
+| **ruflo-goals** | Break big goals into plans and track progress |
+
+#### Code Quality & Testing
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-testgen** | Find missing tests and generate them automatically |
+| **ruflo-browser** | Automate browser testing with Playwright |
+| **ruflo-jujutsu** | Analyze git diffs, score risk, suggest reviewers |
+| **ruflo-docs** | Generate and maintain documentation automatically |
+
+#### Security & Compliance
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-security-audit** | Scan for vulnerabilities and CVEs |
+| **ruflo-aidefence** | Block prompt injection, detect PII, safety scanning |
+
+#### Architecture & Methodology
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-adr** | Track architecture decisions with a living record |
+| **ruflo-ddd** | Scaffold domain-driven design — contexts, aggregates, events |
+| **ruflo-sparc** | Guided 5-phase development methodology with quality gates |
+
+#### DevOps & Observability
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-migrations** | Manage database schema changes safely |
+| **ruflo-observability** | Structured logs, traces, and metrics in one place |
+| **ruflo-cost-tracker** | Track token usage, set budgets, get cost alerts |
+
+#### Extensibility
+
+| Plugin | What it does |
+|--------|-------------|
+| **ruflo-wasm** | Run sandboxed WebAssembly agents |
+| **ruflo-plugin-creator** | Scaffold, validate, and publish your own plugins |
+
+#### Domain-Specific
 
-| Plugin | What it adds |
+| Plugin | What it does |
 |--------|-------------|
-| **ruflo-core** | MCP server, `/status`, `/doctor`, plugin discovery, base agents |
-| **ruflo-swarm** | Swarm coordination, Monitor streams, worktree isolation |
-| **ruflo-autopilot** | Autonomous `/loop` completion with learning and prediction |
-| **ruflo-intelligence** | Self-learning SONA patterns, trajectory learning, model routing |
-| **ruflo-agentdb** | AgentDB controllers, HNSW vector search, RuVector embeddings |
-| **ruflo-aidefence** | AI safety scanning, PII detection, prompt injection defense |
-| **ruflo-browser** | Playwright browser automation for testing and scraping |
-| **ruflo-jujutsu** | Git diff analysis, risk scoring, reviewer recommendations |
-| **ruflo-wasm** | Sandboxed WASM agent creation and gallery sharing |
-| **ruflo-workflows** | Workflow templates, orchestration, lifecycle management |
-| **ruflo-daa** | Dynamic Agentic Architecture, cognitive patterns |
-| **ruflo-ruvllm** | Local LLM inference, MicroLoRA, multi-provider chat |
-| **ruflo-rvf** | RVF portable memory, session persistence, transfer |
-| **ruflo-loop-workers** | Background `/loop` workers, CronCreate scheduling |
-| **ruflo-security-audit** | Security scanning, CVE checks, dependency audit |
-| **ruflo-rag-memory** | Memory bridge, simple store/search/recall interface |
-| **ruflo-testgen** | Test gap detection, TDD workflow, tester agent |
-| **ruflo-docs** | Doc generation, drift detection, docs-writer agent |
-| **ruflo-plugin-creator** | Scaffold, validate, and publish new plugins |
-| **ruflo-federation** | Zero-trust agent federation, PII pipeline, cross-installation comms |
-| **ruflo-goals** | GOAP planning, deep research, long-horizon tracking |
+| **ruflo-iot-cognitum** | IoT device management — trust scoring, anomaly detection, fleets |
+| **ruflo-neural-trader** | [`neural-trader`](https://npmjs.com/package/neural-trader) — AI trading with 4 agents, backtesting, 112+ tools |
+| **ruflo-market-data** | Ingest market data, vectorize OHLCV, detect patterns |
 
 </details>
 
@@ -112,7 +167,7 @@ claude mcp add ruflo -- npx -y @claude-flow/cli@latest
 | 🧠 **Self-Learning** | SONA neural patterns, ReasoningBank, trajectory learning |
 | 💾 **Vector Memory** | HNSW-indexed AgentDB with 150x-12,500x faster search |
 | ⚡ **Background Workers** | 12 auto-triggered workers (audit, optimize, testgaps, etc.) |
-| 🧩 **Plugin Marketplace** | 21 native Claude Code plugins + 21 npm plugins |
+| 🧩 **Plugin Marketplace** | 32 native Claude Code plugins + 21 npm plugins |
 | 🔌 **Multi-Provider** | Claude, GPT, Gemini, Cohere, Ollama with smart routing |
 | 🛡️ **Security** | AIDefence, input validation, CVE remediation, path traversal prevention |
 | 🌐 **Agent Federation** | Cross-installation agent collaboration with zero-trust security 

package/v3/@claude-flow/cli/bin/cli.js

@@ -47,17 +47,28 @@ if (isMCPMode) {
 
     for (const line of lines) {
       if (line.trim()) {
+        let message;
+        try {
+          message = JSON.parse(line);
+        } catch {
+          console.log(JSON.stringify({
+            jsonrpc: '2.0',
+            id: null,
+            error: { code: -32700, message: 'Parse error' },
+          }));
+          continue;
+        }
         try {
-          const message = JSON.parse(line);
           const response = await handleMessage(message);
           if (response) {
             console.log(JSON.stringify(response));
           }
         } catch (error) {
+          // #1606: Return proper internal error instead of parse error
           console.log(JSON.stringify({
             jsonrpc: '2.0',
-            id: null,
-            error: { code: -32700, message: 'Parse error' },
+            id: message.id ?? null,
+            error: { code: -32603, message: error instanceof Error ? error.message : 'Internal error' },
           }));
         }
       }

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

@@ -252,12 +252,20 @@ const searchCommand = {
             description: 'Build/rebuild HNSW index before searching (enables 150x-12,500x speedup)',
             type: 'boolean',
             default: false
+        },
+        {
+            name: 'smart',
+            short: 's',
+            description: 'Use SmartRetrieval pipeline (query expansion, RRF, MMR, recency)',
+            type: 'boolean',
+            default: false
         }
     ],
     examples: [
         { command: 'claude-flow memory search -q "authentication patterns"', description: 'Semantic search' },
         { command: 'claude-flow memory search -q "JWT" -t keyword', description: 'Keyword search' },
-        { command: 'claude-flow memory search -q "test" --build-hnsw', description: 'Build HNSW index and search' }
+        { command: 'claude-flow memory search -q "test" --build-hnsw', description: 'Build HNSW index and search' },
+        { command: 'claude-flow memory search -q "auth patterns" --smart', description: 'SmartRetrieval with RRF + MMR' }
     ],
     action: async (ctx) => {
         const query = ctx.flags.query || ctx.args[0];
@@ -300,28 +308,76 @@ const searchCommand = {
         // Use direct sql.js search with vector similarity
         try {
             const { searchEntries } = await import('../memory/memory-initializer.js');
-            const searchResult = await searchEntries({
-                query,
-                namespace,
-                limit,
-                threshold
-            });
-            if (!searchResult.success) {
-                output.printError(searchResult.error || 'Search failed');
-                return { success: false, exitCode: 1 };
+            const useSmart = (ctx.flags.smart || ctx.flags.s);
+            let results;
+            let searchTimeMs;
+            let smartStats;
+            let backendLabel = 'HNSW + sql.js';
+            if (useSmart) {
+                const { smartSearch } = await import('@claude-flow/memory');
+                // Adapt searchEntries to the SearchFn interface
+                const rawSearch = async (req) => {
+                    const r = await searchEntries({
+                        query: req.query,
+                        namespace: req.namespace || namespace,
+                        limit: req.limit || limit * 3,
+                        threshold: req.threshold ?? threshold,
+                    });
+                    return {
+                        results: r.results.map(e => ({
+                            id: e.id,
+                            key: e.key,
+                            content: e.content,
+                            score: e.score,
+                            namespace: e.namespace,
+                        })),
+                    };
+                };
+                const smartResult = await smartSearch(rawSearch, {
+                    query,
+                    namespace,
+                    limit,
+                    threshold,
+                });
+                results = smartResult.results.map(r => ({
+                    key: r.key,
+                    score: r.score,
+                    namespace: r.namespace,
+                    preview: r.content,
+                }));
+                searchTimeMs = smartResult.stats.durationMs;
+                smartStats = smartResult.stats;
+                backendLabel = 'SmartRetrieval (RRF + MMR + Recency)';
+            }
+            else {
+                const searchResult = await searchEntries({
+                    query,
+                    namespace,
+                    limit,
+                    threshold
+                });
+                if (!searchResult.success) {
+                    output.printError(searchResult.error || 'Search failed');
+                    return { success: false, exitCode: 1 };
+                }
+                results = searchResult.results.map(r => ({
+                    key: r.key,
+                    score: r.score,
+                    namespace: r.namespace,
+                    preview: r.content
+                }));
+                searchTimeMs = searchResult.searchTime;
             }
-            const results = searchResult.results.map(r => ({
-                key: r.key,
-                score: r.score,
-                namespace: r.namespace,
-                preview: r.content
-            }));
             if (ctx.flags.format === 'json') {
-                output.printJson({ query, searchType, results, searchTime: `${searchResult.searchTime}ms` });
+                output.printJson({ query, searchType, results, searchTime: `${searchTimeMs}ms`, ...(smartStats ? { stats: smartStats } : {}) });
                 return { success: true, data: results };
             }
             // Performance stats
-            output.writeln(output.dim(`  Search time: ${searchResult.searchTime}ms`));
+            output.writeln(output.dim(`  Search time: ${searchTimeMs}ms`));
+            if (useSmart && smartStats) {
+                output.writeln(output.dim(`  Backend: ${backendLabel}`));
+                output.writeln(output.dim(`  Variants: ${smartStats.variantCount}, Raw candidates: ${smartStats.rawCandidateCount}`));
+            }
             output.writeln();
             if (results.length === 0) {
                 output.printWarning('No results found');

package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.d.ts

@@ -1,22 +1,13 @@
 /**
  * CLAUDE.md Generator
- * Generates enforceable, analyzer-optimized Claude Code configuration
- * with template variants for different usage patterns.
+ * Generates lean, enforceable Claude Code configuration optimized for token efficiency.
  *
  * Templates: minimal | standard | full | security | performance | solo
- * All templates use bullet-format rules with imperative keywords for enforceability.
+ * All templates use imperative rules and agent comms-first coordination.
  */
 import type { InitOptions, ClaudeMdTemplate } from './types.js';
-/**
- * Generate CLAUDE.md content based on init options and template.
- * Template is determined by: options.runtime.claudeMdTemplate > explicit param > 'standard'
- */
 export declare function generateClaudeMd(options: InitOptions, template?: ClaudeMdTemplate): string;
-/**
- * Generate minimal CLAUDE.md content (backward-compatible alias).
- */
 export declare function generateMinimalClaudeMd(options: InitOptions): string;
-/** Available template names for CLI wizard */
 export declare const CLAUDE_MD_TEMPLATES: Array<{
     name: ClaudeMdTemplate;
     description: string;