π The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
Checkpoint: File edits
rUvc1ecaf72fda5
diff --git a/README.md b/README.mdindex 4307b247a4..9ea20b201d 100644--- a/README.md+++ b/README.md@@ -1,14 +1,14 @@-# π RuvFlow v3: Enterprise AI Orchestration Platform+# π Ruflo v3: Enterprise AI Orchestration Platform<div align="center">-+[](https://github.com/ruvnet/claude-flow)-[](https://www.npmjs.com/package/ruvflow)-[](https://www.npmjs.com/package/ruvflow)+[](https://www.npmjs.com/package/ruflo)+[](https://www.npmjs.com/package/ruflo)[](https://ruv.io)[](https://discord.com/invite/dfxmpwkG2D)[](https://github.com/ruvnet/claude-flow)@@ -25,12 +25,12 @@## Getting into the Flow-RuvFlow is a comprehensive AI agent orchestration framework that transforms Claude Code into a powerful multi-agent development platform. It enables teams to deploy, coordinate, and optimize specialized AI agents working together on complex software engineering tasks.+Ruflo is a comprehensive AI agent orchestration framework that transforms Claude Code into a powerful multi-agent development platform. It enables teams to deploy, coordinate, and optimize specialized AI agents working together on complex software engineering tasks.### Self-Learning/Self-Optimizing Agent Architecture```-User β RuvFlow (CLI/MCP) β Router β Swarm β Agents β Memory β LLM Providers+User β Ruflo (CLI/MCP) β Router β Swarm β Agents β Memory β LLM Providersβ ββββββ Learning Loop ββββββββ```@@ -141,8 +141,8 @@ flowchart TB# Install RuVector standalonenpx ruvector-# Or use via RuvFlow-npx ruvflow@v3alpha hooks intelligence --status+# Or use via Ruflo+npx ruflo@v3alpha hooks intelligence --status```</details>@@ -157,7 +157,7 @@ curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/claude-flow@main/scripts/install.scurl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/claude-flow@main/scripts/install.sh | bash -s -- --full# Or via npx-npx ruvflow@alpha init --wizard+npx ruflo@alpha init --wizard```---@@ -171,7 +171,7 @@ npx ruvflow@alpha init --wizardπ **Works With Any LLM** - Switch between Claude, GPT, Gemini, Cohere, or local models like Llama. Automatic failover if one provider is unavailable. Smart routing picks the cheapest option that meets quality requirements.-β‘ **Plugs Into Claude Code** - Native integration via MCP (Model Context Protocol). Use ruvflow commands directly in your Claude Code sessions with full tool access.+β‘ **Plugs Into Claude Code** - Native integration via MCP (Model Context Protocol). Use ruflo commands directly in your Claude Code sessions with full tool access.π **Production-Ready Security** - Built-in protection against prompt injection, input validation, path traversal prevention, command injection blocking, and safe credential handling.@@ -349,7 +349,7 @@ const config = optimizer.getOptimalConfig(agentCount);<details><summary>π‘οΈ <strong>Anti-Drift Swarm Configuration</strong> β Prevent goal drift in multi-agent work</summary>-Complex swarms can drift from their original goals. RuvFlow V3 includes anti-drift defaults that prevent agents from going off-task.+Complex swarms can drift from their original goals. Ruflo V3 includes anti-drift defaults that prevent agents from going off-task.**Recommended Configuration:**@@ -391,9 +391,9 @@ swarm_init({</details>-### Claude Code: With vs Without RuvFlow+### Claude Code: With vs Without Ruflo-| Capability | Claude Code Alone | Claude Code + RuvFlow |+| Capability | Claude Code Alone | Claude Code + Ruflo ||------------|-------------------|---------------------------|| **Agent Collaboration** | Agents work in isolation, no shared context | Agents collaborate via swarms with shared memory and consensus || **Coordination** | Manual orchestration between tasks | Queen-led hierarchy with 5 consensus algorithms (Raft, Byzantine, Gossip) |@@ -480,14 +480,14 @@ curl ... | bash -s -- --full```bash# Quick start (no install needed)-npx ruvflow@alpha init+npx ruflo@alpha init# Or install globally-npm install -g ruvflow@alpha-ruvflow init+npm install -g ruflo@alpha+ruflo init# With Bun (faster)-bunx ruvflow@alpha init+bunx ruflo@alpha init```#### Install Profiles@@ -499,25 +499,25 @@ bunx ruvflow@alpha init```bash# Minimal install (skip ML/embeddings)-npm install -g ruvflow@alpha --omit=optional+npm install -g ruflo@alpha --omit=optional```<details><summary>π€ <strong>OpenAI Codex CLI Support</strong> β Full Codex integration with self-learning</summary>-RuvFlow supports both **Claude Code** and **OpenAI Codex CLI** via the [@claude-flow/codex](https://www.npmjs.com/package/@claude-flow/codex) package, following the [Agentics Foundation](https://agentics.org) standard.+Ruflo supports both **Claude Code** and **OpenAI Codex CLI** via the [@claude-flow/codex](https://www.npmjs.com/package/@claude-flow/codex) package, following the [Agentics Foundation](https://agentics.org) standard.### Quick Start for Codex```bash# Initialize for Codex CLI (creates AGENTS.md instead of CLAUDE.md)-npx ruvflow@alpha init --codex+npx ruflo@alpha init --codex# Full Codex setup with all 137+ skills-npx ruvflow@alpha init --codex --full+npx ruflo@alpha init --codex --full# Initialize for both platforms (dual mode)-npx ruvflow@alpha init --dual+npx ruflo@alpha init --dual```### Platform Comparison@@ -575,16 +575,16 @@ wait # Wait for all to complete```bash# List collaboration templates-npx ruvflow-codex dual templates+npx ruflo-codex dual templates# Run feature development swarm (architect β coder β tester β reviewer)-npx ruvflow-codex dual run --template feature --task "Add user auth"+npx ruflo-codex dual run --template feature --task "Add user auth"# Run security audit swarm (scanner β analyzer β fixer)-npx ruvflow-codex dual run --template security --task "src/auth/"+npx ruflo-codex dual run --template security --task "src/auth/"# Run refactoring swarm (analyzer β planner β refactorer β validator)-npx ruvflow-codex dual run --template refactor --task "src/legacy/"+npx ruflo-codex dual run --template refactor --task "src/legacy/"```### Pre-Built Collaboration Templates@@ -604,7 +604,7 @@ When you run `init --codex`, the MCP server is automatically registered:codex mcp list# If not present, add manually:-codex mcp add ruvflow -- npx ruvflow mcp start+codex mcp add ruflo -- npx ruflo mcp start```### Self-Learning Workflow@@ -653,43 +653,43 @@ codex mcp add ruvflow -- npx ruvflow mcp start```bash# Initialize project-npx ruvflow@alpha init+npx ruflo@alpha init# Start MCP server for Claude Code integration-npx ruvflow@alpha mcp start+npx ruflo@alpha mcp start# Run a task with agents-npx ruvflow@alpha --agent coder --task "Implement user authentication"+npx ruflo@alpha --agent coder --task "Implement user authentication"# List available agents-npx ruvflow@alpha --list+npx ruflo@alpha --list```### Upgrading```bash# Update helpers and statusline (preserves your data)-npx ruvflow@v3alpha init upgrade+npx ruflo@v3alpha init upgrade# Update AND add any missing skills/agents/commands-npx ruvflow@v3alpha init upgrade --add-missing+npx ruflo@v3alpha init upgrade --add-missing```The `--add-missing` flag automatically detects and installs new skills, agents, and commands that were added in newer versions, without overwriting your existing customizations.### Claude Code MCP Integration-Add ruvflow as an MCP server for seamless integration:+Add ruflo as an MCP server for seamless integration:```bash-# Add ruvflow MCP server to Claude Code-claude mcp add ruvflow -- npx -y ruvflow@latest mcp start+# Add ruflo MCP server to Claude Code+claude mcp add ruflo -- npx -y ruflo@latest mcp start# Verify installationclaude mcp list```-Once added, Claude Code can use all 175+ ruvflow MCP tools directly:+Once added, Claude Code can use all 175+ ruflo MCP tools directly:- `swarm_init` - Initialize agent swarms- `agent_spawn` - Spawn specialized agents- `memory_search` - Search patterns with HNSW (150x faster)@@ -700,13 +700,13 @@ Once added, Claude Code can use all 175+ ruvflow MCP tools directly:## What is it exactly? Agents that learn, build and work perpetually.<details>-<summary>π <strong>Why RuvFlow v3?</strong></summary>+<summary>π <strong>Why Ruflo v3?</strong></summary>-RuvFlow v3 introduces **self-learning neural capabilities** that no other agent orchestration framework offers. While competitors require manual agent configuration and static routing, RuvFlow learns from every task execution, prevents catastrophic forgetting of successful patterns, and intelligently routes work to specialized experts.+Ruflo v3 introduces **self-learning neural capabilities** that no other agent orchestration framework offers. While competitors require manual agent configuration and static routing, Ruflo learns from every task execution, prevents catastrophic forgetting of successful patterns, and intelligently routes work to specialized experts.#### π§ Neural & Learning-| Feature | RuvFlow v3 | CrewAI | LangGraph | AutoGen | Manus |+| Feature | Ruflo v3 | CrewAI | LangGraph | AutoGen | Manus ||---------|----------------|--------|-----------|---------|-------|| **Self-Learning** | β SONA + EWC++ | β | β | β | β || **Prevents Forgetting** | β EWC++ consolidation | β | β | β | β |@@ -717,7 +717,7 @@ RuvFlow v3 introduces **self-learning neural capabilities** that no other agent#### πΎ Memory & Embeddings-| Feature | RuvFlow v3 | CrewAI | LangGraph | AutoGen | Manus |+| Feature | Ruflo v3 | CrewAI | LangGraph | AutoGen | Manus ||---------|----------------|--------|-----------|---------|-------|| **Vector Memory** | β HNSW (150x faster) | β | Via plugins | β | β || **Knowledge Graph** | β PageRank + communities | β | β | β | β |@@ -732,7 +732,7 @@ RuvFlow v3 introduces **self-learning neural capabilities** that no other agent#### π Swarm & Coordination-| Feature | RuvFlow v3 | CrewAI | LangGraph | AutoGen | Manus |+| Feature | Ruflo v3 | CrewAI | LangGraph | AutoGen | Manus ||---------|----------------|--------|-----------|---------|-------|| **Swarm Topologies** | β 4 types | 1 | 1 | 1 | 1 || **Consensus Protocols** | β 5 (Raft, BFT, etc.) | β | β | β | β |@@ -742,7 +742,7 @@ RuvFlow v3 introduces **self-learning neural capabilities** that no other agent#### π§ Developer Experience-| Feature | RuvFlow v3 | CrewAI | LangGraph | AutoGen | Manus |+| Feature | Ruflo v3 | CrewAI | LangGraph | AutoGen | Manus ||---------|----------------|--------|-----------|---------|-------|| **MCP Integration** | β Native (170+ tools) | β | β | β | β || **Skills System** | β 42+ pre-built | β | β | β | Limited |@@ -752,7 +752,7 @@ RuvFlow v3 introduces **self-learning neural capabilities** that no other agent#### π‘οΈ Security & Platform-| Feature | RuvFlow v3 | CrewAI | LangGraph | AutoGen | Manus |+| Feature | Ruflo v3 | CrewAI | LangGraph | AutoGen | Manus ||---------|----------------|--------|-----------|---------|-------|| **Threat Detection** | β AIDefence (<10ms) | β | β | β | β || **Cloud Platform** | β Flow Nexus | β | β | β | β |@@ -766,7 +766,7 @@ RuvFlow v3 introduces **self-learning neural capabilities** that no other agent<details><summary>π <strong>Key Differentiators</strong> β Self-learning, memory optimization, fault tolerance</summary>-What makes RuvFlow different from other agent frameworks? These 10 capabilities work together to create a system that learns from experience, runs efficiently on any hardware, and keeps working even when things go wrong.+What makes Ruflo different from other agent frameworks? These 10 capabilities work together to create a system that learns from experience, runs efficiently on any hardware, and keeps working even when things go wrong.| | Feature | What It Does | Technical Details ||---|---------|--------------|-------------------|@@ -786,7 +786,7 @@ What makes RuvFlow different from other agent frameworks? These 10 capabilities<details><summary>π° <strong>Intelligent 3-Tier Model Routing</strong> β Save 75% on API costs, extend Claude Max 2.5x</summary>-Not every task needs the most powerful (and expensive) model. RuvFlow analyzes each request and automatically routes it to the cheapest handler that can do the job well. Simple code transforms skip the LLM entirely using WebAssembly. Medium tasks use faster, cheaper models. Only complex architecture decisions use Opus.+Not every task needs the most powerful (and expensive) model. Ruflo analyzes each request and automatically routes it to the cheapest handler that can do the job well. Simple code transforms skip the LLM entirely using WebAssembly. Medium tasks use faster, cheaper models. Only complex architecture decisions use Opus.**Cost & Usage Benefits:**@@ -812,7 +812,7 @@ Not every task needs the most powerful (and expensive) model. RuvFlow analyzes e<details><summary>π <strong>Spec-Driven Development</strong> β Build complete specs, implement without drift</summary>-Complex projects fail when implementation drifts from the original plan. RuvFlow solves this with a spec-first approach: define your architecture through ADRs (Architecture Decision Records), organize code into DDD bounded contexts, and let the system enforce compliance as agents work. The result is implementations that match specifications β even across multi-agent swarms working in parallel.+Complex projects fail when implementation drifts from the original plan. Ruflo solves this with a spec-first approach: define your architecture through ADRs (Architecture Decision Records), organize code into DDD bounded contexts, and let the system enforce compliance as agents work. The result is implementations that match specifications β even across multi-agent swarms working in parallel.**How It Prevents Drift:**@@ -1078,18 +1078,18 @@ flowchart TB## π Setup & Configuration-Connect RuvFlow to your development environment.+Connect Ruflo to your development environment.<details>-<summary>π <strong>MCP Setup</strong> β Connect RuvFlow to Any AI Environment</summary>+<summary>π <strong>MCP Setup</strong> β Connect Ruflo to Any AI Environment</summary>-RuvFlow runs as an MCP (Model Context Protocol) server, allowing you to connect it to any MCP-compatible AI client. This means you can use RuvFlow's 60+ agents, swarm coordination, and self-learning capabilities from Claude Desktop, VS Code, Cursor, Windsurf, ChatGPT, and more.+Ruflo runs as an MCP (Model Context Protocol) server, allowing you to connect it to any MCP-compatible AI client. This means you can use Ruflo's 60+ agents, swarm coordination, and self-learning capabilities from Claude Desktop, VS Code, Cursor, Windsurf, ChatGPT, and more.### Quick Add Command```bash-# Start RuvFlow MCP server in any environment-npx ruvflow@v3alpha mcp start+# Start Ruflo MCP server in any environment+npx ruflo@v3alpha mcp start```<details open>@@ -1104,9 +1104,9 @@ npx ruvflow@v3alpha mcp start```json{"mcpServers": {- "ruvflow": {+ "ruflo": {"command": "npx",- "args": ["ruvflow@v3alpha", "mcp", "start"],+ "args": ["ruflo@v3alpha", "mcp", "start"],"env": {"ANTHROPIC_API_KEY": "sk-ant-..."}@@ -1126,12 +1126,12 @@ Restart Claude Desktop after saving. Look for the MCP indicator (hammer icon) in```bash# Add via CLI (recommended)-claude mcp add ruvflow -- npx ruvflow@v3alpha mcp start+claude mcp add ruflo -- npx ruflo@v3alpha mcp start# Or add with environment variables-claude mcp add ruvflow \+claude mcp add ruflo \--env ANTHROPIC_API_KEY=sk-ant-... \- -- npx ruvflow@v3alpha mcp start+ -- npx ruflo@v3alpha mcp start# Verify installationclaude mcp list@@ -1158,9 +1158,9 @@ Create `.vscode/mcp.json` in your project:```json{"mcpServers": {- "ruvflow": {+ "ruflo": {"command": "npx",- "args": ["ruvflow@v3alpha", "mcp", "start"],+ "args": ["ruflo@v3alpha", "mcp", "start"],"env": {"ANTHROPIC_API_KEY": "sk-ant-..."}@@ -1185,9 +1185,9 @@ Create `.cursor/mcp.json` in your project (or global config):```json{"mcpServers": {- "ruvflow": {+ "ruflo": {"command": "npx",- "args": ["ruvflow@v3alpha", "mcp", "start"],+ "args": ["ruflo@v3alpha", "mcp", "start"],"env": {"ANTHROPIC_API_KEY": "sk-ant-..."}@@ -1212,9 +1212,9 @@ Create `.cursor/mcp.json` in your project (or global config):```json{"mcpServers": {- "ruvflow": {+ "ruflo": {"command": "npx",- "args": ["ruvflow@v3alpha", "mcp", "start"],+ "args": ["ruflo@v3alpha", "mcp", "start"],"env": {"ANTHROPIC_API_KEY": "sk-ant-..."}@@ -1241,11 +1241,11 @@ Click **Refresh** in the MCP settings to connect. Windsurf supports up to 100 MC**Remote Server Setup:**-For ChatGPT, you need a remote MCP server (not local stdio). Deploy ruvflow to a server with HTTP transport:+For ChatGPT, you need a remote MCP server (not local stdio). Deploy ruflo to a server with HTTP transport:```bash# Start with HTTP transport-npx ruvflow@v3alpha mcp start --transport http --port 3000+npx ruflo@v3alpha mcp start --transport http --port 3000```Then add the server URL in ChatGPT Connectors settings.@@ -1261,7 +1261,7 @@ Google AI Studio supports MCP natively since May 2025, with managed MCP servers**Using MCP SuperAssistant Extension:**1. Install [MCP SuperAssistant](https://chrome.google.com/webstore) Chrome extension-2. Configure your ruvflow MCP server+2. Configure your ruflo MCP server3. Use with Google AI Studio, Gemini, and other AI platforms**Native SDK Integration:**@@ -1274,9 +1274,9 @@ const ai = new GoogleGenAI({ apiKey: 'YOUR_API_KEY' });// MCP definitions are natively supported in the Gen AI SDKconst mcpConfig = {servers: [{- name: 'ruvflow',+ name: 'ruflo',command: 'npx',- args: ['ruvflow@v3alpha', 'mcp', 'start']+ args: ['ruflo@v3alpha', 'mcp', 'start']}]};```@@ -1297,9 +1297,9 @@ JetBrains AI Assistant supports MCP for IntelliJ IDEA, PyCharm, WebStorm, and ot```json{- "name": "ruvflow",+ "name": "ruflo","command": "npx",- "args": ["ruvflow@v3alpha", "mcp", "start"]+ "args": ["ruflo@v3alpha", "mcp", "start"]}```@@ -1529,13 +1529,13 @@ The Hive Mind system implements queen-led hierarchical coordination where strate**CLI Commands:**```bash-npx ruvflow hive-mind init # Initialize hive mind-npx ruvflow hive-mind spawn "Build API" # Spawn with objective-npx ruvflow hive-mind spawn "..." --queen-type strategic --consensus byzantine-npx ruvflow hive-mind status # Check status-npx ruvflow hive-mind metrics # Performance metrics-npx ruvflow hive-mind memory # Collective memory stats-npx ruvflow hive-mind sessions # List active sessions+npx ruflo hive-mind init # Initialize hive mind+npx ruflo hive-mind spawn "Build API" # Spawn with objective+npx ruflo hive-mind spawn "..." --queen-type strategic --consensus byzantine+npx ruflo hive-mind status # Check status+npx ruflo hive-mind metrics # Performance metrics+npx ruflo hive-mind memory # Collective memory stats+npx ruflo hive-mind sessions # List active sessions```**Performance:** 10-20x faster batch spawning, 2.8-4.4x speed improvement, 84.8% SWE-Bench solve rate@@ -1549,8 +1549,8 @@ Native integration with Claude Code's experimental Agent Teams feature for spawn**Enable Agent Teams:**```bash-# Automatically enabled with ruvflow init-npx ruvflow@latest init+# Automatically enabled with ruflo init+npx ruflo@latest init# Or manually add to .claude/settings.json{@@ -1602,10 +1602,10 @@ TeamDelete()```bash# Handle idle teammate-npx ruvflow@latest hooks teammate-idle --auto-assign true+npx ruflo@latest hooks teammate-idle --auto-assign true# Handle task completion-npx ruvflow@latest hooks task-completed --task-id <id> --train-patterns+npx ruflo@latest hooks task-completed --task-id <id> --train-patterns```**Display Modes:** `auto` (default), `in-process`, `tmux` (split-pane)@@ -1682,14 +1682,14 @@ Build custom plugins with the fluent builder API. Create MCP tools, hooks, worke### π¦ Available Optional Plugins-Install these optional plugins to extend RuvFlow capabilities:+Install these optional plugins to extend Ruflo capabilities:| Plugin | Version | Description | Install Command ||--------|---------|-------------|-----------------|| **@claude-flow/plugin-agentic-qe** | 3.0.0-alpha.2 | Quality Engineering with 58 AI agents across 12 DDD contexts. TDD, coverage analysis, security scanning, chaos engineering, accessibility testing. | `npm install @claude-flow/plugin-agentic-qe` || **@claude-flow/plugin-prime-radiant** | 0.1.4 | Mathematical AI interpretability with 6 engines: sheaf cohomology, spectral analysis, causal inference, quantum topology, category theory, HoTT proofs. | `npm install @claude-flow/plugin-prime-radiant` |-| **@claude-flow/plugin-gastown-bridge** | 0.1.0 | Gas Town orchestrator integration with WASM-accelerated formula parsing (352x faster), Beads sync, convoy management, and graph analysis. 20 MCP tools. | `npx ruvflow@latest plugins install -n @claude-flow/plugin-gastown-bridge` |-| **@claude-flow/teammate-plugin** | 1.0.0-alpha.1 | Native TeammateTool integration for Claude Code v2.1.19+. BMSSP WASM acceleration, rate limiting, circuit breaker, semantic routing. 21 MCP tools. | `npx ruvflow@latest plugins install -n @claude-flow/teammate-plugin` |+| **@claude-flow/plugin-gastown-bridge** | 0.1.0 | Gas Town orchestrator integration with WASM-accelerated formula parsing (352x faster), Beads sync, convoy management, and graph analysis. 20 MCP tools. | `npx ruflo@latest plugins install -n @claude-flow/plugin-gastown-bridge` |+| **@claude-flow/teammate-plugin** | 1.0.0-alpha.1 | Native TeammateTool integration for Claude Code v2.1.19+. BMSSP WASM acceleration, rate limiting, circuit breaker, semantic routing. 21 MCP tools. | `npx ruflo@latest plugins install -n @claude-flow/teammate-plugin` |#### π₯ Domain-Specific Plugins@@ -1759,7 +1759,7 @@ npm install @claude-flow/plugin-agentic-qenpm install @claude-flow/plugin-prime-radiant# Install Gas Town Bridge plugin (WASM-accelerated orchestration)-npx ruvflow@latest plugins install -n @claude-flow/plugin-gastown-bridge+npx ruflo@latest plugins install -n @claude-flow/plugin-gastown-bridge# Install domain-specific pluginsnpm install @claude-flow/plugin-healthcare-clinical@@ -1778,7 +1778,7 @@ npm install @claude-flow/plugin-quantum-optimizernpm install @claude-flow/plugin-hyperbolic-reasoning# List all installed plugins-npx ruvflow plugins list --installed+npx ruflo plugins list --installed```</details>@@ -1947,8 +1947,8 @@ Workers run automatically based on context, or dispatch manually via MCP tools.| **TestGaps** | `testgaps` | Test coverage analysis | Code changes without tests |```bash-npx ruvflow@v3alpha worker dispatch --trigger audit --context "./src"-npx ruvflow@v3alpha worker status+npx ruflo@v3alpha worker dispatch --trigger audit --context "./src"+npx ruflo@v3alpha worker status```</details>@@ -2172,7 +2172,7 @@ npx ruvflow@v3alpha worker status| Feature | Description | Performance ||---------|-------------|-------------|| **Multi-Provider** | Agentic-Flow (ONNX), OpenAI, Transformers.js, Mock | 4 providers |-| **Auto-Install** | `ruvflow embeddings init` or `createEmbeddingServiceAsync()` | Zero config |+| **Auto-Install** | `ruflo embeddings init` or `createEmbeddingServiceAsync()` | Zero config || **75x Faster** | Agentic-flow ONNX SIMD vs Transformers.js | 3ms vs 230ms || **Hyperbolic Space** | PoincarΓ© ball model for hierarchical data | Exponential capacity || **Dimensions** | 384 to 3072 configurable | Quality vs speed tradeoff |@@ -2182,13 +2182,13 @@ npx ruvflow@v3alpha worker status```bash# Initialize ONNX embeddings with hyperbolic config-ruvflow embeddings init+ruflo embeddings init# Use larger model for higher quality-ruvflow embeddings init --model all-mpnet-base-v2+ruflo embeddings init --model all-mpnet-base-v2# Semantic search-ruvflow embeddings search -q "authentication patterns"+ruflo embeddings search -q "authentication patterns"```| Mode | Adaptation | Quality | Memory | Use Case |@@ -2225,22 +2225,22 @@ ruvflow embeddings search -q "authentication patterns"```bash# Initialize RuVector in PostgreSQL-ruvflow ruvector init --database mydb --user admin+ruflo ruvector init --database mydb --user admin# Check connection and schema status-ruvflow ruvector status --verbose+ruflo ruvector status --verbose# Run pending migrations-ruvflow ruvector migrate --up+ruflo ruvector migrate --up# Performance benchmark-ruvflow ruvector benchmark --iterations 1000+ruflo ruvector benchmark --iterations 1000# Optimize indices and vacuum-ruvflow ruvector optimize --analyze+ruflo ruvector optimize --analyze# Backup vector data-ruvflow ruvector backup --output ./backup.sql+ruflo ruvector backup --output ./backup.sql```| Migration | Purpose | Features |@@ -2272,13 +2272,13 @@ ruvflow ruvector backup --output ./backup.sql**Quick Commands:**```bash-npx ruvflow hive-mind init # Initialize-npx ruvflow hive-mind spawn "Build API" --queen-type tactical # Spawn swarm-npx ruvflow hive-mind spawn "Research AI" --consensus byzantine --claude-npx ruvflow hive-mind status # Check status+npx ruflo hive-mind init # Initialize+npx ruflo hive-mind spawn "Build API" --queen-type tactical # Spawn swarm+npx ruflo hive-mind spawn "Research AI" --consensus byzantine --claude+npx ruflo hive-mind status # Check status```-**RuvFlow Skill:** `/hive-mind-advanced` β Full hive mind orchestration+**Ruflo Skill:** `/hive-mind-advanced` β Full hive mind orchestration**Performance:** 10-20x faster batch spawning, 84.8% SWE-Bench solve rate, 32.3% token reduction@@ -2390,7 +2390,7 @@ Real-time development status display for Claude Code integration showing DDD pro**Output Format:**```-β RuvFlow V3 β ruvnet β β v3 β Opus 4.5+β Ruflo V3 β ruvnet β β v3 β Opus 4.5βββββββββββββββββββββββββββββββββββββββββββββββββββββποΈ DDD Domains [βββββ] 5/5 β‘ 1.0x β 2.49x-7.47xπ€ Swarm β [58/15] π₯ 0 π’ CVE 3/3 πΎ 22282MB π 47% π§ 10%@@ -2399,7 +2399,7 @@ Real-time development status display for Claude Code integration showing DDD pro| Indicator | Description | Values ||-----------|-------------|--------|-| `β RuvFlow V3` | Project header | Always shown |+| `β Ruflo V3` | Project header | Always shown || `β ruvnet` | GitHub user (via `gh` CLI) | Dynamic || `β v3` | Current git branch | Dynamic || `Opus 4.5` | Claude model name | From Claude Code |@@ -2420,19 +2420,19 @@ Real-time development status display for Claude Code integration showing DDD pro**Usage:**```bash# Default: Safe multi-line (avoids Claude Code collision zone)-npx ruvflow@v3alpha hooks statusline+npx ruflo@v3alpha hooks statusline# Single-line mode (completely avoids collision)-npx ruvflow@v3alpha hooks statusline --single+npx ruflo@v3alpha hooks statusline --single# Legacy multi-line (original behavior, may have bleeding)-npx ruvflow@v3alpha hooks statusline --legacy+npx ruflo@v3alpha hooks statusline --legacy# JSON output for scripting-npx ruvflow@v3alpha hooks statusline --json+npx ruflo@v3alpha hooks statusline --json# Compact JSON (single line)-npx ruvflow@v3alpha hooks statusline --compact+npx ruflo@v3alpha hooks statusline --compact```**Collision Zone Fix (Issue #985):**@@ -2454,16 +2454,16 @@ Add to `.claude/settings.json`:{"statusLine": {"type": "command",- "command": "npx ruvflow@v3alpha hooks statusline --single"+ "command": "npx ruflo@v3alpha hooks statusline --single"}}```**Data Sources:**-- `.ruvflow/metrics/v3-progress.json` - DDD domain progress-- `.ruvflow/metrics/swarm-activity.json` - Active agent counts-- `.ruvflow/security/audit-status.json` - CVE remediation status-- `.ruvflow/learning/patterns.db` - Intelligence score (pattern count)+- `.ruflo/metrics/v3-progress.json` - DDD domain progress+- `.ruflo/metrics/swarm-activity.json` - Active agent counts+- `.ruflo/security/audit-status.json` - CVE remediation status+- `.ruflo/learning/patterns.db` - Intelligence score (pattern count)- Process detection via `ps aux` - Real-time memory and agent counts- Git branch via `git branch --show-current`- GitHub user via `gh api user`@@ -2488,19 +2488,19 @@ Cross-platform TypeScript-based daemon service with auto-scheduling:**Commands:**```bash# Start daemon (auto-runs on SessionStart hooks)-npx ruvflow@v3alpha daemon start+npx ruflo@v3alpha daemon start# Check status with worker history-npx ruvflow@v3alpha daemon status+npx ruflo@v3alpha daemon status# Manually trigger a worker-npx ruvflow@v3alpha daemon trigger map+npx ruflo@v3alpha daemon trigger map# Enable/disable workers-npx ruvflow@v3alpha daemon enable map audit optimize+npx ruflo@v3alpha daemon enable map audit optimize# Stop daemon-npx ruvflow@v3alpha daemon stop+npx ruflo@v3alpha daemon stop```**Daemon Status Output:**@@ -2574,7 +2574,7 @@ Shell-based daemons for monitoring (Linux/macOS only):<details><summary>β¨οΈ <strong>V3 CLI Commands</strong> β 26 commands with 140+ subcommands</summary>-Complete command-line interface for all RuvFlow operations.+Complete command-line interface for all Ruflo operations.**Core Commands:**@@ -2616,25 +2616,25 @@ Complete command-line interface for all RuvFlow operations.```bash# Initialize project with wizard-npx ruvflow@v3alpha init --wizard+npx ruflo@v3alpha init --wizard# Start daemon with background workers-npx ruvflow@v3alpha daemon start+npx ruflo@v3alpha daemon start# Spawn an agent with specific type-npx ruvflow@v3alpha agent spawn -t coder --name my-coder+npx ruflo@v3alpha agent spawn -t coder --name my-coder# Initialize swarm with V3 mode-npx ruvflow@v3alpha swarm init --v3-mode+npx ruflo@v3alpha swarm init --v3-mode# Search memory (HNSW-indexed, 150x faster)-npx ruvflow@v3alpha memory search -q "authentication patterns"+npx ruflo@v3alpha memory search -q "authentication patterns"# Run security scan-npx ruvflow@v3alpha security scan --depth full+npx ruflo@v3alpha security scan --depth full# Performance benchmark-npx ruvflow@v3alpha performance benchmark --suite all+npx ruflo@v3alpha performance benchmark --suite all```</details>@@ -2642,7 +2642,7 @@ npx ruvflow@v3alpha performance benchmark --suite all<details><summary>π©Ί <strong>Doctor Health Checks</strong> β System diagnostics with auto-fix</summary>-Run `npx ruvflow@v3alpha doctor` to diagnose and fix common issues.+Run `npx ruflo@v3alpha doctor` to diagnose and fix common issues.**Health Checks Performed:**@@ -2663,22 +2663,22 @@ Run `npx ruvflow@v3alpha doctor` to diagnose and fix common issues.```bash# Run full diagnostics-npx ruvflow@v3alpha doctor+npx ruflo@v3alpha doctor# Run diagnostics with auto-fix-npx ruvflow@v3alpha doctor --fix+npx ruflo@v3alpha doctor --fix# Check specific component-npx ruvflow@v3alpha doctor --component memory+npx ruflo@v3alpha doctor --component memory# Verbose output-npx ruvflow@v3alpha doctor --verbose+npx ruflo@v3alpha doctor --verbose```**Output Example:**```-π©Ί RuvFlow Doctor v3.0.0-alpha+π©Ί Ruflo Doctor v3.0.0-alphaβ Node.js 20.11.0 (required: 20+)β npm 10.2.4 (required: 9+)@@ -2722,16 +2722,16 @@ The embeddings package (v3.0.0-alpha.12) provides high-performance vector embedd```bash# Initialize embeddings system-npx ruvflow@v3alpha embeddings init+npx ruflo@v3alpha embeddings init# Generate embedding for text-npx ruvflow@v3alpha embeddings embed "authentication patterns"+npx ruflo@v3alpha embeddings embed "authentication patterns"# Batch embed multiple texts-npx ruvflow@v3alpha embeddings batch --file texts.txt+npx ruflo@v3alpha embeddings batch --file texts.txt# Search with semantic similarity-npx ruvflow@v3alpha embeddings search "login flow" --top-k 5+npx ruflo@v3alpha embeddings search "login flow" --top-k 5```**Programmatic:**@@ -2768,59 +2768,59 @@ Real-world scenarios and pre-built workflows for common tasks.| Scenario | What It Solves | How To Do It ||----------|----------------|--------------|-| **Code Review** | Get thorough reviews with security, performance, and style checks | `npx ruvflow@v3alpha --agent reviewer --task "Review PR #123"` |-| **Test Generation** | Auto-generate unit, integration, and e2e tests for existing code | `npx ruvflow@v3alpha --agent tester --task "Write tests for auth module"` |-| **Refactoring** | Safely restructure code while maintaining behavior | `npx ruvflow@v3alpha --agent coder --task "Refactor user service to use repository pattern"` |-| **Bug Fixing** | Diagnose and fix bugs with full context analysis | `npx ruvflow@v3alpha --agent coder --task "Fix race condition in checkout flow"` |+| **Code Review** | Get thorough reviews with security, performance, and style checks | `npx ruflo@v3alpha --agent reviewer --task "Review PR #123"` |+| **Test Generation** | Auto-generate unit, integration, and e2e tests for existing code | `npx ruflo@v3alpha --agent tester --task "Write tests for auth module"` |+| **Refactoring** | Safely restructure code while maintaining behavior | `npx ruflo@v3alpha --agent coder --task "Refactor user service to use repository pattern"` |+| **Bug Fixing** | Diagnose and fix bugs with full context analysis | `npx ruflo@v3alpha --agent coder --task "Fix race condition in checkout flow"` |### π Security & Compliance| Scenario | What It Solves | How To Do It ||----------|----------------|--------------|-| **Security Audit** | Find vulnerabilities before attackers do | `npx ruvflow@v3alpha --agent security-architect --task "Audit for OWASP Top 10"` |-| **Dependency Scan** | Identify vulnerable packages and suggest upgrades | `npx ruvflow@v3alpha security scan --depth full` |-| **Compliance Check** | Ensure code meets security standards | `npx ruvflow@v3alpha --agent security-architect --task "Check PCI-DSS compliance"` |+| **Security Audit** | Find vulnerabilities before attackers do | `npx ruflo@v3alpha --agent security-architect --task "Audit for OWASP Top 10"` |+| **Dependency Scan** | Identify vulnerable packages and suggest upgrades | `npx ruflo@v3alpha security scan --depth full` |+| **Compliance Check** | Ensure code meets security standards | `npx ruflo@v3alpha --agent security-architect --task "Check PCI-DSS compliance"` |### π Multi-Agent Swarms| Scenario | What It Solves | How To Do It ||----------|----------------|--------------|-| **Feature Development** | Coordinate multiple agents on complex features | `npx ruvflow@v3alpha swarm init --topology hierarchical && npx ruvflow@v3alpha task orchestrate "Build user dashboard"` |-| **Large Refactors** | Parallel refactoring across many files without conflicts | `npx ruvflow@v3alpha swarm init --topology mesh --max-agents 8` |-| **Codebase Migration** | Migrate frameworks, languages, or patterns systematically | `npx ruvflow@v3alpha task orchestrate "Migrate from Express to Fastify" --strategy adaptive` |+| **Feature Development** | Coordinate multiple agents on complex features | `npx ruflo@v3alpha swarm init --topology hierarchical && npx ruflo@v3alpha task orchestrate "Build user dashboard"` |+| **Large Refactors** | Parallel refactoring across many files without conflicts | `npx ruflo@v3alpha swarm init --topology mesh --max-agents 8` |+| **Codebase Migration** | Migrate frameworks, languages, or patterns systematically | `npx ruflo@v3alpha task orchestrate "Migrate from Express to Fastify" --strategy adaptive` |### π Performance & Optimization| Scenario | What It Solves | How To Do It ||----------|----------------|--------------|-| **Performance Profiling** | Find and fix bottlenecks in your application | `npx ruvflow@v3alpha --agent perf-analyzer --task "Profile API endpoints"` |-| **Query Optimization** | Speed up slow database queries | `npx ruvflow@v3alpha hooks route "Optimize database queries"` |-| **Memory Analysis** | Reduce memory usage and fix leaks | `npx ruvflow@v3alpha --agent perf-analyzer --task "Analyze memory usage patterns"` |+| **Performance Profiling** | Find and fix bottlenecks in your application | `npx ruflo@v3alpha --agent perf-analyzer --task "Profile API endpoints"` |+| **Query Optimization** | Speed up slow database queries | `npx ruflo@v3alpha hooks route "Optimize database queries"` |+| **Memory Analysis** | Reduce memory usage and fix leaks | `npx ruflo@v3alpha --agent perf-analyzer --task "Analyze memory usage patterns"` |### π GitHub & DevOps| Scenario | What It Solves | How To Do It ||----------|----------------|--------------|-| **PR Management** | Review, approve, and merge PRs efficiently | `npx ruvflow@v3alpha --agent pr-manager --task "Review open PRs"` |-| **Issue Triage** | Categorize, prioritize, and assign issues automatically | `npx ruvflow@v3alpha --agent issue-tracker --task "Triage new issues"` |-| **Release Management** | Coordinate releases with changelogs and versioning | `npx ruvflow@v3alpha --agent release-manager --task "Prepare v2.0 release"` |-| **CI/CD Optimization** | Speed up pipelines and reduce flaky tests | `npx ruvflow@v3alpha --agent cicd-engineer --task "Optimize GitHub Actions workflow"` |+| **PR Management** | Review, approve, and merge PRs efficiently | `npx ruflo@v3alpha --agent pr-manager --task "Review open PRs"` |+| **Issue Triage** | Categorize, prioritize, and assign issues automatically | `npx ruflo@v3alpha --agent issue-tracker --task "Triage new issues"` |+| **Release Management** | Coordinate releases with changelogs and versioning | `npx ruflo@v3alpha --agent release-manager --task "Prepare v2.0 release"` |+| **CI/CD Optimization** | Speed up pipelines and reduce flaky tests | `npx ruflo@v3alpha --agent cicd-engineer --task "Optimize GitHub Actions workflow"` |### π Spec-Driven Development| Scenario | What It Solves | How To Do It ||----------|----------------|--------------|-| **Generate Specs** | Create complete specifications before coding | `npx ruvflow@v3alpha --agent architect --task "Create ADR for authentication system"` |-| **Validate Implementation** | Ensure code matches specifications | `npx ruvflow@v3alpha hooks progress --detailed` |-| **Track Compliance** | Monitor spec adherence across the team | `npx ruvflow@v3alpha progress sync` |+| **Generate Specs** | Create complete specifications before coding | `npx ruflo@v3alpha --agent architect --task "Create ADR for authentication system"` |+| **Validate Implementation** | Ensure code matches specifications | `npx ruflo@v3alpha hooks progress --detailed` |+| **Track Compliance** | Monitor spec adherence across the team | `npx ruflo@v3alpha progress sync` |### π§ Learning & Intelligence| Scenario | What It Solves | How To Do It ||----------|----------------|--------------|-| **Bootstrap Intelligence** | Train the system on your codebase patterns | `npx ruvflow@v3alpha hooks pretrain --depth deep` |-| **Optimize Routing** | Improve task-to-agent matching over time | `npx ruvflow@v3alpha hooks route "<task>" --include-explanation` |-| **Transfer Learning** | Apply patterns learned from other projects | `npx ruvflow@v3alpha hooks transfer <sourceProject>` |+| **Bootstrap Intelligence** | Train the system on your codebase patterns | `npx ruflo@v3alpha hooks pretrain --depth deep` |+| **Optimize Routing** | Improve task-to-agent matching over time | `npx ruflo@v3alpha hooks route "<task>" --include-explanation` |+| **Transfer Learning** | Apply patterns learned from other projects | `npx ruflo@v3alpha hooks transfer <sourceProject>` |</details>@@ -2878,7 +2878,7 @@ When hooks run, they emit signals that guide routing decisions. Watch for these**Example Hook Output:**```bash-$ npx ruvflow@v3alpha hooks pre-task --description "convert var to const in utils.ts"+$ npx ruflo@v3alpha hooks pre-task --description "convert var to const in utils.ts"[AGENT_BOOSTER_AVAILABLE] Intent: var-to-constRecommendation: Use Edit tool directly@@ -2901,8 +2901,8 @@ Cost: $0```bash# Example: Edit with pattern learning-npx ruvflow@v3alpha hooks pre-edit ./src/auth.ts-npx ruvflow@v3alpha hooks post-edit ./src/auth.ts --success true --train-patterns+npx ruflo@v3alpha hooks pre-edit ./src/auth.ts+npx ruflo@v3alpha hooks post-edit ./src/auth.ts --success true --train-patterns```#### π§ Intelligence & Routing Hooks (8 hooks)@@ -2920,10 +2920,10 @@ npx ruvflow@v3alpha hooks post-edit ./src/auth.ts --success true --train-pattern```bash# Route a task with explanation-npx ruvflow@v3alpha hooks route "refactor authentication to use JWT" --include-explanation+npx ruflo@v3alpha hooks route "refactor authentication to use JWT" --include-explanation# Bootstrap intelligence from your codebase-npx ruvflow@v3alpha hooks pretrain --depth deep --model-type moe+npx ruflo@v3alpha hooks pretrain --depth deep --model-type moe```#### π Session Management Hooks (4 hooks)@@ -2937,10 +2937,10 @@ npx ruvflow@v3alpha hooks pretrain --depth deep --model-type moe```bash# Start session with auto-daemon-npx ruvflow@v3alpha hooks session-start --session-id "feature-auth" --start-daemon+npx ruflo@v3alpha hooks session-start --session-id "feature-auth" --start-daemon# End session and export learnings-npx ruvflow@v3alpha hooks session-end --export-metrics --persist-patterns+npx ruflo@v3alpha hooks session-end --export-metrics --persist-patterns```#### π€ Intelligence System Hooks (9 hooks)@@ -2959,13 +2959,13 @@ npx ruvflow@v3alpha hooks session-end --export-metrics --persist-patterns```bash# Start trajectory for complex task-npx ruvflow@v3alpha hooks intelligence trajectory-start --task "implement OAuth2"+npx ruflo@v3alpha hooks intelligence trajectory-start --task "implement OAuth2"# Record successful action-npx ruvflow@v3alpha hooks intelligence trajectory-step --action "created token service" --quality 0.9+npx ruflo@v3alpha hooks intelligence trajectory-step --action "created token service" --quality 0.9# End trajectory and trigger learning-npx ruvflow@v3alpha hooks intelligence trajectory-end --success true+npx ruflo@v3alpha hooks intelligence trajectory-end --success true```### 12 Background Workers (Auto-Triggered)@@ -2989,13 +2989,13 @@ Workers run automatically based on context, or dispatch manually.```bash# List all workers-npx ruvflow@v3alpha hooks worker list+npx ruflo@v3alpha hooks worker list# Manually dispatch security audit-npx ruvflow@v3alpha hooks worker dispatch --trigger audit --context "./src/auth"+npx ruflo@v3alpha hooks worker dispatch --trigger audit --context "./src/auth"# Check worker status-npx ruvflow@v3alpha hooks worker status+npx ruflo@v3alpha hooks worker status```### Model Routing Hooks (3 hooks)@@ -3010,10 +3010,10 @@ Automatically selects haiku/sonnet/opus based on task complexity.```bash# Get model recommendation-npx ruvflow@v3alpha hooks model-route --task "fix typo in README"+npx ruflo@v3alpha hooks model-route --task "fix typo in README"# β Recommends: haiku (simple task, low complexity)-npx ruvflow@v3alpha hooks model-route --task "design distributed consensus system"+npx ruflo@v3alpha hooks model-route --task "design distributed consensus system"# β Recommends: opus (complex architecture, high reasoning)```@@ -3034,21 +3034,21 @@ npx ruvflow@v3alpha hooks model-route --task "design distributed consensus syste# ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ# Route task to best agent-npx ruvflow@v3alpha hooks route "<task>" --include-explanation+npx ruflo@v3alpha hooks route "<task>" --include-explanation# Start/end session with learning-npx ruvflow@v3alpha hooks session-start --start-daemon-npx ruvflow@v3alpha hooks session-end --persist-patterns+npx ruflo@v3alpha hooks session-start --start-daemon+npx ruflo@v3alpha hooks session-end --persist-patterns# View what the system has learned-npx ruvflow@v3alpha hooks metrics-npx ruvflow@v3alpha hooks intelligence stats+npx ruflo@v3alpha hooks metrics+npx ruflo@v3alpha hooks intelligence stats# Bootstrap on new project-npx ruvflow@v3alpha hooks pretrain --depth deep+npx ruflo@v3alpha hooks pretrain --depth deep# Dispatch background worker-npx ruvflow@v3alpha hooks worker dispatch --trigger audit+npx ruflo@v3alpha hooks worker dispatch --trigger audit```</details>@@ -3074,38 +3074,38 @@ Share learned patterns across projects, teams, and the community via the decentr```bash# Export learned patterns to file-npx ruvflow@v3alpha memory export --format json --output ./patterns.json+npx ruflo@v3alpha memory export --format json --output ./patterns.json# Export specific namespace-npx ruvflow@v3alpha memory export --namespace "security" --output ./security-patterns.json+npx ruflo@v3alpha memory export --namespace "security" --output ./security-patterns.json# Export with embeddings (larger file, faster import)-npx ruvflow@v3alpha memory export --include-embeddings --output ./full-export.json+npx ruflo@v3alpha memory export --include-embeddings --output ./full-export.json# Export agent configurations-npx ruvflow@v3alpha config export --scope project --output ./agent-configs.json+npx ruflo@v3alpha config export --scope project --output ./agent-configs.json# Export session state-npx ruvflow@v3alpha session export --session-id "my-session" --output ./session.json+npx ruflo@v3alpha session export --session-id "my-session" --output ./session.json```### Import Commands```bash# Import patterns from file-npx ruvflow@v3alpha memory import --input ./patterns.json+npx ruflo@v3alpha memory import --input ./patterns.json# Import and merge with existing (don't overwrite)-npx ruvflow@v3alpha memory import --input ./patterns.json --merge+npx ruflo@v3alpha memory import --input ./patterns.json --merge# Import from another project-npx ruvflow@v3alpha hooks transfer --source-path ../other-project+npx ruflo@v3alpha hooks transfer --source-path ../other-project# Import agent configurations-npx ruvflow@v3alpha config import --input ./agent-configs.json --scope project+npx ruflo@v3alpha config import --input ./agent-configs.json --scope project# Restore session-npx ruvflow@v3alpha session restore --session-id "my-session"+npx ruflo@v3alpha session restore --session-id "my-session"```### Pattern Store (IPFS Marketplace)@@ -3123,13 +3123,13 @@ Decentralized pattern marketplace for sharing and discovering community patterns```bash# Search for authentication patterns-npx ruvflow@v3alpha transfer-store search --query "authentication" --min-rating 4.0+npx ruflo@v3alpha transfer-store search --query "authentication" --min-rating 4.0# Download a pattern-npx ruvflow@v3alpha transfer-store download --id "auth-jwt-patterns-v2" --verify+npx ruflo@v3alpha transfer-store download --id "auth-jwt-patterns-v2" --verify# Publish your patterns-npx ruvflow@v3alpha transfer-store publish --input ./my-patterns.json --category "security"+npx ruflo@v3alpha transfer-store publish --input ./my-patterns.json --category "security"```### Plugin Store@@ -3147,22 +3147,22 @@ Discover and install community plugins from the **live IPFS registry** with 19 o```bash# List plugins with live ratings from Cloud Function-npx ruvflow@v3alpha plugins list+npx ruflo@v3alpha plugins list# Filter by type-npx ruvflow@v3alpha plugins list --type integration+npx ruflo@v3alpha plugins list --type integration# Rate a plugin-npx ruvflow@v3alpha plugins rate --name @claude-flow/embeddings --rating 5+npx ruflo@v3alpha plugins rate --name @claude-flow/embeddings --rating 5# Search for MCP tool plugins-npx ruvflow@v3alpha transfer plugin-search --type "mcp-tool" --verified+npx ruflo@v3alpha transfer plugin-search --type "mcp-tool" --verified# Get plugin info-npx ruvflow@v3alpha transfer plugin-info --name "semantic-code-search"+npx ruflo@v3alpha transfer plugin-info --name "semantic-code-search"# List official plugins-npx ruvflow@v3alpha transfer plugin-official+npx ruflo@v3alpha transfer plugin-official```#### Live IPFS Plugin Registry@@ -3195,10 +3195,10 @@ Patterns and models are distributed via IPFS for decentralization and integrity.```bash# Resolve IPNS name to CID-npx ruvflow@v3alpha transfer ipfs-resolve --name "/ipns/patterns.ruvflow.io"+npx ruflo@v3alpha transfer ipfs-resolve --name "/ipns/patterns.ruflo.io"# Detect PII before publishing-npx ruvflow@v3alpha transfer detect-pii --content "$(cat ./patterns.json)"+npx ruflo@v3alpha transfer detect-pii --content "$(cat ./patterns.json)"```### Model & Learning Pattern Import/Export@@ -3221,7 +3221,7 @@ curl -X POST "https://api.pinata.cloud/pinning/pinJSONToIPFS" \"name": "my-patterns","patterns": [...]},- "pinataMetadata": {"name": "ruvflow-learning-pattern"}+ "pinataMetadata": {"name": "ruflo-learning-pattern"}}'# Import a pattern from IPFS CID@@ -3263,13 +3263,13 @@ Import pre-trained learning patterns for common tasks. **90.5% average accuracy*curl -s "https://gateway.pinata.cloud/ipfs/QmNr1yYMKi7YBaL8JSztQyuB5ZUaTdRMLxJC1pBpGbjsTc" | jq '.models[].name'# Import all models-npx ruvflow@v3alpha transfer import --cid QmNr1yYMKi7YBaL8JSztQyuB5ZUaTdRMLxJC1pBpGbjsTc+npx ruflo@v3alpha transfer import --cid QmNr1yYMKi7YBaL8JSztQyuB5ZUaTdRMLxJC1pBpGbjsTc# Import specific category-npx ruvflow@v3alpha neural import --model security-review-patterns --source ipfs+npx ruflo@v3alpha neural import --model security-review-patterns --source ipfs# Use patterns in routing-npx ruvflow@v3alpha hooks route --task "review authentication code" --use-patterns+npx ruflo@v3alpha hooks route --task "review authentication code" --use-patterns```#### Benefits vs Fresh Install@@ -3294,7 +3294,7 @@ npx ruvflow@v3alpha hooks route --task "review authentication code" --use-patter```bash# Install a pattern pack-npx ruvflow@v3alpha transfer-store download --id "security-essentials" --apply+npx ruflo@v3alpha transfer-store download --id "security-essentials" --apply```### RuVector WASM Neural Training@@ -3312,25 +3312,25 @@ Real WASM-accelerated neural training using `@ruvector/learning-wasm` and `@ruve```bash# List available pre-trained models from IPFS registry-npx ruvflow@v3alpha neural list+npx ruflo@v3alpha neural list# List models by category-npx ruvflow@v3alpha neural list --category security+npx ruflo@v3alpha neural list --category security# Train with WASM acceleration-npx ruvflow@v3alpha neural train -p coordination -e 100 --wasm --flash --contrastive+npx ruflo@v3alpha neural train -p coordination -e 100 --wasm --flash --contrastive# Train security patterns-npx ruvflow@v3alpha neural train -p security --wasm --contrastive+npx ruflo@v3alpha neural train -p security --wasm --contrastive# Benchmark WASM performance-npx ruvflow@v3alpha neural benchmark -d 256 -i 1000+npx ruflo@v3alpha neural benchmark -d 256 -i 1000# Import pre-trained models-npx ruvflow@v3alpha neural import --cid QmNr1yYMKi7YBaL8JSztQyuB5ZUaTdRMLxJC1pBpGbjsTc+npx ruflo@v3alpha neural import --cid QmNr1yYMKi7YBaL8JSztQyuB5ZUaTdRMLxJC1pBpGbjsTc# Export trained patterns to IPFS-npx ruvflow@v3alpha neural export --ipfs --sign+npx ruflo@v3alpha neural export --ipfs --sign```#### Benchmark Results@@ -3669,9 +3669,9 @@ Skills are **reusable workflows** that combine agents, hooks, and patterns into/v3-security-overhaul# Via CLI-npx ruvflow@v3alpha skill run github-code-review-npx ruvflow@v3alpha skill list-npx ruvflow@v3alpha skill info sparc-methodology+npx ruflo@v3alpha skill run github-code-review+npx ruflo@v3alpha skill list+npx ruflo@v3alpha skill info sparc-methodology```### Creating Custom Skills@@ -3728,21 +3728,21 @@ The Claims system manages **who is working on what** β whether human or agent.| Command | What It Does | Example ||---------|--------------|---------|-| `issues list` | See all issues and their status | `npx ruvflow@v3alpha issues list` |-| `issues claim` | Claim an issue for yourself/agent | `npx ruvflow@v3alpha issues claim #123 --as coder-1` |-| `issues release` | Release your claim | `npx ruvflow@v3alpha issues release #123` |-| `issues handoff` | Hand off to another worker | `npx ruvflow@v3alpha issues handoff #123 --to reviewer` |-| `issues status` | Update progress on claimed work | `npx ruvflow@v3alpha issues status #123 --progress 75` |-| `issues stealable` | List abandoned/stuck issues | `npx ruvflow@v3alpha issues stealable` |-| `issues steal` | Take over stealable issue | `npx ruvflow@v3alpha issues steal #123` |-| `issues load` | View agent workloads | `npx ruvflow@v3alpha issues load` |-| `issues rebalance` | Redistribute work evenly | `npx ruvflow@v3alpha issues rebalance --dry-run` |-| `issues board` | Visual board view | `npx ruvflow@v3alpha issues board` |+| `issues list` | See all issues and their status | `npx ruflo@v3alpha issues list` |+| `issues claim` | Claim an issue for yourself/agent | `npx ruflo@v3alpha issues claim #123 --as coder-1` |+| `issues release` | Release your claim | `npx ruflo@v3alpha issues release #123` |+| `issues handoff` | Hand off to another worker | `npx ruflo@v3alpha issues handoff #123 --to reviewer` |+| `issues status` | Update progress on claimed work | `npx ruflo@v3alpha issues status #123 --progress 75` |+| `issues stealable` | List abandoned/stuck issues | `npx ruflo@v3alpha issues stealable` |+| `issues steal` | Take over stealable issue | `npx ruflo@v3alpha issues steal #123` |+| `issues load` | View agent workloads | `npx ruflo@v3alpha issues load` |+| `issues rebalance` | Redistribute work evenly | `npx ruflo@v3alpha issues rebalance --dry-run` |+| `issues board` | Visual board view | `npx ruflo@v3alpha issues board` |### Visual Board View```bash-npx ruvflow@v3alpha issues board+npx ruflo@v3alpha issues board``````@@ -3764,13 +3764,13 @@ When you need to pass work to someone else:```bash# 1. Request handoff with context-npx ruvflow@v3alpha issues handoff #123 \+npx ruflo@v3alpha issues handoff #123 \--to security-architect \--reason "Needs security review" \--progress 80# 2. Target accepts handoff-npx ruvflow@v3alpha issues accept #123 --as security-architect+npx ruflo@v3alpha issues accept #123 --as security-architect# 3. Work continues with full context```@@ -3779,7 +3779,7 @@ npx ruvflow@v3alpha issues accept #123 --as security-architect```bash# View current load-npx ruvflow@v3alpha issues load+npx ruflo@v3alpha issues load# Output:# Agent | Claims | Load | Status@@ -3790,7 +3790,7 @@ npx ruvflow@v3alpha issues load# security-arch | 0 | 0% | π’ Available# Auto-rebalance-npx ruvflow@v3alpha issues rebalance+npx ruflo@v3alpha issues rebalance```### MCP Tools@@ -3851,14 +3851,14 @@ The Route system uses **Q-Learning** to automatically assign tasks to the best a| Command | What It Does | Example ||---------|--------------|---------|-| `route task` | Get agent recommendation | `npx ruvflow@v3alpha route task "implement OAuth2"` |-| `route explain` | Understand routing decision | `npx ruvflow@v3alpha route explain "task"` |-| `route coverage` | Route based on test coverage | `npx ruvflow@v3alpha route coverage` |+| `route task` | Get agent recommendation | `npx ruflo@v3alpha route task "implement OAuth2"` |+| `route explain` | Understand routing decision | `npx ruflo@v3alpha route explain "task"` |+| `route coverage` | Route based on test coverage | `npx ruflo@v3alpha route coverage` |### Example: Route a Task```bash-npx ruvflow@v3alpha route task "refactor authentication to use JWT"+npx ruflo@v3alpha route task "refactor authentication to use JWT"# Output:# ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ@@ -3885,7 +3885,7 @@ npx ruvflow@v3alpha route task "refactor authentication to use JWT"Routes tasks to agents based on **test coverage gaps**:```bash-npx ruvflow@v3alpha route coverage+npx ruflo@v3alpha route coverage# Finds untested code and routes to tester agent:# β’ src/auth/jwt.ts - 23% coverage β tester@@ -3897,10 +3897,10 @@ npx ruvflow@v3alpha route coverage```bash# Route via hooks (preferred)-npx ruvflow@v3alpha hooks route "implement caching layer" --include-explanation+npx ruflo@v3alpha hooks route "implement caching layer" --include-explanation# Record outcome for learning-npx ruvflow@v3alpha hooks post-task --task-id "task-123" --success true --agent coder+npx ruflo@v3alpha hooks post-task --task-id "task-123" --success true --agent coder```### How Q-Learning Improves Over Time@@ -3920,12 +3920,12 @@ The system **remembers** what works and applies it to future similar tasks.## π» Programmatic Usage-Use RuvFlow packages directly in your applications.+Use Ruflo packages directly in your applications.<details>-<summary>π» <strong>Programmatic SDK</strong> β Use RuvFlow in Your Code</summary>+<summary>π» <strong>Programmatic SDK</strong> β Use Ruflo in Your Code</summary>-Use RuvFlow packages directly in your TypeScript/JavaScript applications.+Use Ruflo packages directly in your TypeScript/JavaScript applications.### Installation@@ -3934,7 +3934,7 @@ Use RuvFlow packages directly in your TypeScript/JavaScript applications.npm install @claude-flow/cli @claude-flow/memory @claude-flow/swarm# Or install everything-npm install ruvflow@v3alpha+npm install ruflo@v3alpha```### Quick Examples@@ -3971,21 +3971,21 @@ console.log(results);**CLI Commands:**```bash# Initialize memory database-npx ruvflow@alpha memory init --force+npx ruflo@alpha memory init --force# Store patterns-npx ruvflow@alpha memory store --key "pattern-auth" --value "JWT authentication with refresh tokens"-npx ruvflow@alpha memory store --key "pattern-cache" --value "Redis caching for API responses"+npx ruflo@alpha memory store --key "pattern-auth" --value "JWT authentication with refresh tokens"+npx ruflo@alpha memory store --key "pattern-cache" --value "Redis caching for API responses"# Build HNSW index for 150x-12,500x faster search-npx ruvflow@alpha memory search --query "authentication" --build-hnsw+npx ruflo@alpha memory search --query "authentication" --build-hnsw# Semantic search (uses HNSW if built)-npx ruvflow@alpha memory search --query "how to cache data" --limit 5+npx ruflo@alpha memory search --query "how to cache data" --limit 5# List and manage entries-npx ruvflow@alpha memory list --namespace patterns-npx ruvflow@alpha memory stats+npx ruflo@alpha memory list --namespace patterns+npx ruflo@alpha memory stats```</details>@@ -4219,35 +4219,35 @@ console.log(`Hit rate: ${(stats.hitRate * 100).toFixed(1)}%`);```bash# Generate embedding-ruvflow embeddings embed "Your text here"+ruflo embeddings embed "Your text here"# Batch embed from file-ruvflow embeddings batch documents.txt -o embeddings.json+ruflo embeddings batch documents.txt -o embeddings.json# Similarity search-ruvflow embeddings search "query" --index ./vectors+ruflo embeddings search "query" --index ./vectors# Document chunking-ruvflow embeddings chunk document.txt --strategy sentence --max-size 512+ruflo embeddings chunk document.txt --strategy sentence --max-size 512# Normalize embeddings-ruvflow embeddings normalize embeddings.json --type l2 -o normalized.json+ruflo embeddings normalize embeddings.json --type l2 -o normalized.json# Convert to hyperbolic-ruvflow embeddings hyperbolic embeddings.json -o poincare.json+ruflo embeddings hyperbolic embeddings.json -o poincare.json# Neural operations-ruvflow embeddings neural drift --baseline "context" --input "check"-ruvflow embeddings neural store --id mem-1 --content "data"-ruvflow embeddings neural recall "query" --top-k 5+ruflo embeddings neural drift --baseline "context" --input "check"+ruflo embeddings neural store --id mem-1 --content "data"+ruflo embeddings neural recall "query" --top-k 5# Model management-ruvflow embeddings models list-ruvflow embeddings models download all-MiniLM-L6-v2+ruflo embeddings models list+ruflo embeddings models download all-MiniLM-L6-v2# Cache management-ruvflow embeddings cache stats-ruvflow embeddings cache clear --older-than 7d+ruflo embeddings cache stats+ruflo embeddings cache clear --older-than 7d```### Available Models@@ -4314,7 +4314,7 @@ await hooks.endTrajectory(trajectory, { success: true });## π Ecosystem & Integrations-Core infrastructure packages powering RuvFlow's intelligence layer.+Core infrastructure packages powering Ruflo's intelligence layer.<details><summary>β‘ <strong>Agentic-Flow Integration</strong> β Core AI Infrastructure</summary>@@ -4323,7 +4323,7 @@ Core infrastructure packages powering RuvFlow's intelligence layer.[](https://www.npmjs.com/package/agentic-flow)[](https://github.com/ruvnet/agentic-flow)-RuvFlow v3 is built on top of **[agentic-flow](https://github.com/ruvnet/agentic-flow)**, a production-ready AI agent orchestration platform. This deep integration provides 352x faster code transformations, learning memory, and geometric intelligence.+Ruflo v3 is built on top of **[agentic-flow](https://github.com/ruvnet/agentic-flow)**, a production-ready AI agent orchestration platform. This deep integration provides 352x faster code transformations, learning memory, and geometric intelligence.### Quick Start@@ -4604,9 +4604,9 @@ claude mcp add agentic-flow -- npx agentic-flow mcp start</details>-### Integration with RuvFlow+### Integration with Ruflo-RuvFlow automatically leverages agentic-flow for:+Ruflo automatically leverages agentic-flow for:| Feature | How It's Used ||---------|---------------|@@ -4617,7 +4617,7 @@ RuvFlow automatically leverages agentic-flow for:| **Embedding Search** | HNSW-indexed vector search (150x faster) |```typescript-// RuvFlow automatically uses agentic-flow optimizations+// Ruflo automatically uses agentic-flow optimizationsimport { getTokenOptimizer } from '@claude-flow/integration';const optimizer = await getTokenOptimizer();@@ -4793,9 +4793,9 @@ jj.enableEncryption(key);</details>-### RuvFlow Skill+### Ruflo Skill-RuvFlow includes a dedicated `/agentic-jujutsu` skill for AI-powered version control:+Ruflo includes a dedicated `/agentic-jujutsu` skill for AI-powered version control:```bash# Invoke the skill@@ -4878,7 +4878,7 @@ npx agentic-jujutsu examples # Show usage examples[](https://github.com/ruvnet/ruvector)[](https://hub.docker.com/r/ruvnet/ruvector-postgres)-**RuVector** is a high-performance distributed vector database combining vector search, graph queries, and self-learning neural networks. Written in Rust with Node.js/WASM bindings, it powers RuvFlow's intelligence layer with native speed.+**RuVector** is a high-performance distributed vector database combining vector search, graph queries, and self-learning neural networks. Written in Rust with Node.js/WASM bindings, it powers Ruflo's intelligence layer with native speed.### Key Capabilities@@ -4960,7 +4960,7 @@ const compressed = ruvector.compress(embedding, 0.3); // 30% quality threshold```bash# Quick setup with CLI (recommended)-npx ruvflow ruvector setup --output ./my-ruvector+npx ruflo ruvector setup --output ./my-ruvectorcd my-ruvector && docker-compose up -d# Or pull directly from Docker Hub@@ -4968,12 +4968,12 @@ docker run -d \--name ruvector-postgres \-p 5432:5432 \-e POSTGRES_USER=claude \- -e POSTGRES_PASSWORD=ruvflow-test \+ -e POSTGRES_PASSWORD=ruflo-test \-e POSTGRES_DB=claude_flow \ruvnet/ruvector-postgres# Migrate existing memory to PostgreSQL-npx ruvflow ruvector import --input memory-export.json+npx ruflo ruvector import --input memory-export.json```**RuVector PostgreSQL vs pgvector:**@@ -5130,12 +5130,12 @@ await db.createHyperedge(['agent-1', 'agent-2', 'agent-3'], {</details>-### Integration with RuvFlow+### Integration with Ruflo-RuvFlow automatically uses RuVector when available:+Ruflo automatically uses RuVector when available:```typescript-// RuvFlow detects and uses native ruvector+// Ruflo detects and uses native ruvectorimport { getVectorStore } from '@claude-flow/memory';const store = await getVectorStore();@@ -5153,19 +5153,19 @@ const similarity = attention.attention(queries, keys, values);```bash# RuVector PostgreSQL Setup (generates Docker files + SQL)-npx ruvflow ruvector setup # Output to ./ruvector-postgres-npx ruvflow ruvector setup --output ./mydir # Custom directory-npx ruvflow ruvector setup --print # Preview files+npx ruflo ruvector setup # Output to ./ruvector-postgres+npx ruflo ruvector setup --output ./mydir # Custom directory+npx ruflo ruvector setup --print # Preview files# Import from sql.js/JSON to PostgreSQL-npx ruvflow ruvector import --input data.json # Direct import-npx ruvflow ruvector import --input data.json --output sql # Dry-run (generate SQL)+npx ruflo ruvector import --input data.json # Direct import+npx ruflo ruvector import --input data.json --output sql # Dry-run (generate SQL)# Other RuVector commands-npx ruvflow ruvector status --verbose # Check connection-npx ruvflow ruvector benchmark --vectors 10000 # Performance test-npx ruvflow ruvector optimize --analyze # Optimization suggestions-npx ruvflow ruvector backup --output backup.sql # Backup data+npx ruflo ruvector status --verbose # Check connection+npx ruflo ruvector benchmark --vectors 10000 # Performance test+npx ruflo ruvector optimize --analyze # Optimization suggestions+npx ruflo ruvector backup --output backup.sql # Backup data# Native ruvector CLInpx ruvector status # Check installation@@ -5192,11 +5192,11 @@ Cloud platform integration and deployment tools.<details><summary>βοΈ <strong>Flow Nexus</strong> β Cloud Platform Integration</summary>-Flow Nexus is a **cloud platform** for deploying and scaling RuvFlow beyond your local machine.+Flow Nexus is a **cloud platform** for deploying and scaling Ruflo beyond your local machine.### What Flow Nexus Provides-| Feature | Local RuvFlow | + Flow Nexus |+| Feature | Local Ruflo | + Flow Nexus ||---------|-------------------|--------------|| **Swarm Scale** | 15 agents (local resources) | 100+ agents (cloud resources) || **Neural Training** | Limited by local GPU/CPU | Distributed GPU clusters |@@ -5245,7 +5245,7 @@ Flow Nexus is a **cloud platform** for deploying and scaling RuvFlow beyond your/flow-nexus-swarm# Or via CLI-npx ruvflow@v3alpha nexus swarm deploy \+npx ruflo@v3alpha nexus swarm deploy \--topology hierarchical \--max-agents 50 \--region us-east-1@@ -5257,13 +5257,13 @@ Isolated execution environments for running untrusted code:```bash# Create sandbox-npx ruvflow@v3alpha nexus sandbox create --language python+npx ruflo@v3alpha nexus sandbox create --language python# Execute code safely-npx ruvflow@v3alpha nexus sandbox exec --code "print('Hello')"+npx ruflo@v3alpha nexus sandbox exec --code "print('Hello')"# Cleanup-npx ruvflow@v3alpha nexus sandbox destroy+npx ruflo@v3alpha nexus sandbox destroy```### Event-Driven Workflows@@ -5289,10 +5289,10 @@ steps:# 1. Sign up at flow-nexus.io# 2. Get API key# 3. Configure-npx ruvflow@v3alpha nexus configure --api-key <key>+npx ruflo@v3alpha nexus configure --api-key <key># 4. Deploy-npx ruvflow@v3alpha nexus swarm deploy+npx ruflo@v3alpha nexus swarm deploy```</details>@@ -5326,7 +5326,7 @@ Stream-Chain enables **sequential processing** where the output of one agent bec/stream-chain# Define pipeline-npx ruvflow@v3alpha stream-chain create \+npx ruflo@v3alpha stream-chain create \--name "feature-pipeline" \--stages "researcher,architect,coder,tester,reviewer"```@@ -5368,11 +5368,11 @@ stages:```bash# Run the pipeline-npx ruvflow@v3alpha stream-chain run feature-pipeline \+npx ruflo@v3alpha stream-chain run feature-pipeline \--input '{"requirements": "Add user dashboard with analytics"}'# Monitor progress-npx ruvflow@v3alpha stream-chain status feature-pipeline+npx ruflo@v3alpha stream-chain status feature-pipeline```### Use Cases@@ -5412,7 +5412,7 @@ The Pair Programming skill provides **human-AI collaborative coding** with role/pair-programming --mode tdd# Via CLI-npx ruvflow@v3alpha pair start --mode navigator+npx ruflo@v3alpha pair start --mode navigator```### TDD Mode Workflow@@ -5452,16 +5452,16 @@ npx ruvflow@v3alpha pair start --mode navigator```bash# Switch roles mid-session-npx ruvflow@v3alpha pair switch+npx ruflo@v3alpha pair switch# Get AI explanation-npx ruvflow@v3alpha pair explain+npx ruflo@v3alpha pair explain# Run tests-npx ruvflow@v3alpha pair test+npx ruflo@v3alpha pair test# End session with summary-npx ruvflow@v3alpha pair end+npx ruflo@v3alpha pair end```</details>@@ -5518,22 +5518,22 @@ Detection Time: 0.04ms | 50+ Patterns | Self-Learning | HNSW Vector Search```bash# Basic threat scan-npx ruvflow@v3alpha security defend -i "ignore previous instructions"+npx ruflo@v3alpha security defend -i "ignore previous instructions"# Scan a file-npx ruvflow@v3alpha security defend -f ./user-prompts.txt+npx ruflo@v3alpha security defend -f ./user-prompts.txt# Quick scan (faster)-npx ruvflow@v3alpha security defend -i "some text" --quick+npx ruflo@v3alpha security defend -i "some text" --quick# JSON output-npx ruvflow@v3alpha security defend -i "test" -o json+npx ruflo@v3alpha security defend -i "test" -o json# View statistics-npx ruvflow@v3alpha security defend --stats+npx ruflo@v3alpha security defend --stats# Full security audit-npx ruvflow@v3alpha security scan --depth full+npx ruflo@v3alpha security scan --depth full```### MCP Tools@@ -5725,7 +5725,7 @@ Domain-Driven Design with bounded contexts, clean architecture, and measured per[](https://www.npmjs.com/package/@claude-flow/browser)-AI-optimized browser automation integrating [agent-browser](https://github.com/AugmentCode/agent-browser) with ruvflow for intelligent web automation, trajectory learning, and multi-agent browser coordination.+AI-optimized browser automation integrating [agent-browser](https://github.com/AugmentCode/agent-browser) with ruflo for intelligent web automation, trajectory learning, and multi-agent browser coordination.### Installation@@ -5810,7 +5810,7 @@ const template = getWorkflow('login-basic');<details><summary>π¦ <strong>Release Management</strong> β @claude-flow/deployment</summary>-Automated release management, versioning, and CI/CD for RuvFlow packages.+Automated release management, versioning, and CI/CD for Ruflo packages.### Features@@ -6124,10 +6124,10 @@ npm run bench:attentionnpm run bench:startup# Performance report-npx ruvflow@v3alpha performance report+npx ruflo@v3alpha performance report# Benchmark specific suite-npx ruvflow@v3alpha performance benchmark --suite memory+npx ruflo@v3alpha performance benchmark --suite memory```</details>@@ -6508,7 +6508,7 @@ export CLAUDE_FLOW_MEMORY_PATH="./data"| `GCS_PROJECT_ID` | GCS project ID | Optional || `GOOGLE_CLOUD_PROJECT` | Alternative project ID variable | Optional || `GOOGLE_APPLICATION_CREDENTIALS` | Path to GCS service account JSON | Optional |-| `GCS_PREFIX` | Prefix for stored files | `ruvflow-patterns` |+| `GCS_PREFIX` | Prefix for stored files | `ruflo-patterns` |### Auto-Update System@@ -6579,9 +6579,9 @@ CLAUDE_FLOW_HNSW_EF=200### Configuration File Location-RuvFlow looks for configuration in this order:+Ruflo looks for configuration in this order:1. `./claude-flow.config.json` (project root)-2. `~/.config/ruvflow/config.json` (user config)+2. `~/.config/ruflo/config.json` (user config)3. Environment variables (override any file config)### Complete Configuration Schema@@ -6681,7 +6681,7 @@ RuvFlow looks for configuration in this order:"level": "info","format": "json","destination": "console",- "filePath": "./logs/ruvflow.log",+ "filePath": "./logs/ruflo.log","maxFileSize": "100MB","maxFiles": 10},@@ -6748,7 +6748,7 @@ RuvFlow looks for configuration in this order:"version": "3.0.0","memory": {"type": "hybrid",- "path": "/var/lib/ruvflow/data",+ "path": "/var/lib/ruflo/data","encryption": { "enabled": true, "algorithm": "aes-256-gcm" }},"swarm": { "topology": "hierarchical", "maxAgents": 15 },@@ -6760,7 +6760,7 @@ RuvFlow looks for configuration in this order:"level": "warn","format": "json","destination": "file",- "filePath": "/var/log/ruvflow/production.log"+ "filePath": "/var/log/ruflo/production.log"},"monitoring": { "enabled": true, "metricsInterval": 30000 }}@@ -6804,25 +6804,25 @@ RuvFlow looks for configuration in this order:```bash# View current configuration-npx ruvflow@v3alpha config list+npx ruflo@v3alpha config list# Get specific value-npx ruvflow@v3alpha config get --key memory.type+npx ruflo@v3alpha config get --key memory.type# Set configuration value-npx ruvflow@v3alpha config set --key swarm.maxAgents --value 10+npx ruflo@v3alpha config set --key swarm.maxAgents --value 10# Export configuration-npx ruvflow@v3alpha config export > my-config.json+npx ruflo@v3alpha config export > my-config.json# Import configuration-npx ruvflow@v3alpha config import --file my-config.json+npx ruflo@v3alpha config import --file my-config.json# Reset to defaults-npx ruvflow@v3alpha config reset --key swarm+npx ruflo@v3alpha config reset --key swarm# Initialize with wizard-npx ruvflow@v3alpha init --wizard+npx ruflo@v3alpha init --wizard```</details>@@ -6846,7 +6846,7 @@ lsof -i :3000# Kill existing processkill -9 <PID># Restart MCP server-npx ruvflow@v3alpha mcp start+npx ruflo@v3alpha mcp start```**Agent spawn failures**@@ -6860,9 +6860,9 @@ export CLAUDE_FLOW_MAX_AGENTS=5**Pattern search returning no results**```bash# Verify patterns are stored-npx ruvflow@v3alpha hooks metrics+npx ruflo@v3alpha hooks metrics# Re-run pretraining if empty-npx ruvflow@v3alpha hooks pretrain+npx ruflo@v3alpha hooks pretrain```**Windows path issues**@@ -6870,7 +6870,7 @@ npx ruvflow@v3alpha hooks pretrain# Use forward slashes or escape backslashes$env:CLAUDE_FLOW_MEMORY_PATH = "./data"# Or use absolute path-$env:CLAUDE_FLOW_MEMORY_PATH = "C:/Users/name/ruvflow/data"+$env:CLAUDE_FLOW_MEMORY_PATH = "C:/Users/name/ruflo/data"```**Permission denied errors**@@ -6883,7 +6883,7 @@ sudo chown -R $(whoami) ~/.npm**High memory usage**```bash# Enable garbage collection-node --expose-gc node_modules/.bin/ruvflow+node --expose-gc node_modules/.bin/ruflo# Reduce HNSW parameters for lower memoryexport CLAUDE_FLOW_HNSW_M=8export CLAUDE_FLOW_HNSW_EF=100@@ -6915,45 +6915,45 @@ export CLAUDE_FLOW_HNSW_EF=100| Change | V2 | V3 | Impact ||--------|----|----|--------|-| **Package Structure** | `ruvflow` | `@claude-flow/*` (scoped) | Update imports |+| **Package Structure** | `ruflo` | `@claude-flow/*` (scoped) | Update imports || **Memory Backend** | JSON files | AgentDB + HNSW | Faster search || **Hooks System** | Basic patterns | ReasoningBank + SONA | Self-learning || **Security** | Manual validation | Automatic strict mode | More secure || **CLI Commands** | Flat structure | Nested subcommands | New syntax |-| **Config Format** | `.ruvflow/config.json` | `claude-flow.config.json` | Update path |+| **Config Format** | `.ruflo/config.json` | `claude-flow.config.json` | Update path |### Step-by-Step Migration```bash# STEP 1: Backup existing data (CRITICAL)cp -r ./data ./data-backup-v2-cp -r ./.ruvflow ./.ruvflow-backup-v2+cp -r ./.ruflo ./.ruflo-backup-v2# STEP 2: Check migration status-npx ruvflow@v3alpha migrate status+npx ruflo@v3alpha migrate status# STEP 3: Run migration with dry-run first-npx ruvflow@v3alpha migrate run --dry-run+npx ruflo@v3alpha migrate run --dry-run# STEP 4: Execute migration-npx ruvflow@v3alpha migrate run --from v2+npx ruflo@v3alpha migrate run --from v2# STEP 5: Verify migration-npx ruvflow@v3alpha migrate verify+npx ruflo@v3alpha migrate verify# STEP 6: Initialize V3 learning-npx ruvflow@v3alpha hooks pretrain-npx ruvflow@v3alpha doctor --fix+npx ruflo@v3alpha hooks pretrain+npx ruflo@v3alpha doctor --fix```### Command Changes Reference| V2 Command | V3 Command | Notes ||------------|------------|-------|-| `ruvflow start` | `ruvflow mcp start` | MCP is explicit |-| `ruvflow init` | `ruvflow init --wizard` | Interactive mode |-| `ruvflow spawn <type>` | `ruvflow agent spawn -t <type>` | Nested under `agent` |-| `ruvflow swarm create` | `ruvflow swarm init --topology mesh` | Explicit topology |+| `ruflo start` | `ruflo mcp start` | MCP is explicit |+| `ruflo init` | `ruflo init --wizard` | Interactive mode |+| `ruflo spawn <type>` | `ruflo agent spawn -t <type>` | Nested under `agent` |+| `ruflo swarm create` | `ruflo swarm init --topology mesh` | Explicit topology || `--pattern-store path` | `--memory-backend agentdb` | Backend selection || `hooks record` | `hooks post-edit --success true` | Explicit success flag || `memory get <key>` | `memory retrieve --key <key>` | Explicit flag |@@ -6963,7 +6963,7 @@ npx ruvflow@v3alpha doctor --fix### Configuration Migration-**V2 Config (`.ruvflow/config.json`)**:+**V2 Config (`.ruflo/config.json`)**:```json{"mode": "basic",@@ -6995,7 +6995,7 @@ npx ruvflow@v3alpha doctor --fix```typescript// V2 (deprecated)-import { ClaudeFlow, Agent, Memory } from 'ruvflow';+import { ClaudeFlow, Agent, Memory } from 'ruflo';// V3 (new)import { ClaudeFlowClient } from '@claude-flow/cli';@@ -7010,10 +7010,10 @@ If migration fails, you can rollback:```bash# Check rollback options-npx ruvflow@v3alpha migrate rollback --list+npx ruflo@v3alpha migrate rollback --list# Rollback to V2-npx ruvflow@v3alpha migrate rollback --to v2+npx ruflo@v3alpha migrate rollback --to v2# Restore backup manually if neededrm -rf ./data@@ -7022,12 +7022,12 @@ cp -r ./data-backup-v2 ./data### Post-Migration Checklist-- [ ] Verify all agents spawn correctly: `npx ruvflow@v3alpha agent list`-- [ ] Check memory search works: `npx ruvflow@v3alpha memory search -q "test"`-- [ ] Confirm MCP server starts: `npx ruvflow@v3alpha mcp start`-- [ ] Run doctor diagnostics: `npx ruvflow@v3alpha doctor`-- [ ] Test a simple swarm: `npx ruvflow@v3alpha swarm init --topology mesh`-- [ ] Bootstrap learning: `npx ruvflow@v3alpha hooks pretrain`+- [ ] Verify all agents spawn correctly: `npx ruflo@v3alpha agent list`+- [ ] Check memory search works: `npx ruflo@v3alpha memory search -q "test"`+- [ ] Confirm MCP server starts: `npx ruflo@v3alpha mcp start`+- [ ] Run doctor diagnostics: `npx ruflo@v3alpha doctor`+- [ ] Test a simple swarm: `npx ruflo@v3alpha swarm init --topology mesh`+- [ ] Bootstrap learning: `npx ruflo@v3alpha hooks pretrain`### Common Migration Issuesdiff --git a/scripts/install.sh b/scripts/install.shindex 45bd6928da..50b52f583d 100755--- a/scripts/install.sh+++ b/scripts/install.sh@@ -1,6 +1,6 @@#!/usr/bin/env bash#-# RuvFlow Installer+# Ruflo Installer# https://github.com/ruvnet/claude-flow## Usage:@@ -78,7 +78,7 @@ while [[ $# -gt 0 ]]; doshift;;--help|-h)- echo "RuvFlow Installer"+ echo "Ruflo Installer"echo ""echo "Usage: curl -fsSL .../install.sh | bash -s -- [OPTIONS]"echo ""@@ -99,7 +99,7 @@ while [[ $# -gt 0 ]]; doesacdone-PACKAGE="ruvflow@${VERSION}"+PACKAGE="ruflo@${VERSION}"# Progress animationSPINNER_CHARS="β β β Ήβ Έβ Όβ ΄β ¦β §β β "@@ -113,7 +113,7 @@ spinner() {print_banner() {echo ""echo -e "${CYAN}βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"- echo -e "${CYAN}β${NC} ${BOLD}π RuvFlow${NC} - Enterprise AI Agent Orchestration ${CYAN}β${NC}"+ echo -e "${CYAN}β${NC} ${BOLD}π Ruflo${NC} - Enterprise AI Agent Orchestration ${CYAN}β${NC}"echo -e "${CYAN}βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"echo ""}@@ -254,10 +254,10 @@ verify_installation() {local VERSION_OUTPUTif [ "$GLOBAL" = "1" ]; then- VERSION_OUTPUT=$(ruvflow --version 2>/dev/null || echo "")+ VERSION_OUTPUT=$(ruflo --version 2>/dev/null || echo "")if [ -z "$VERSION_OUTPUT" ]; thenprint_warning "Global command not found in PATH"- print_substep "Try: ${BOLD}npm install -g ruvflow@${VERSION}${NC}"+ print_substep "Try: ${BOLD}npm install -g ruflo@${VERSION}${NC}"return 0 # Don't fail - npm might need PATH refreshfielse@@ -283,22 +283,22 @@ show_quickstart() {if [ "$GLOBAL" = "1" ]; thenecho -e " ${DIM}# Initialize project${NC}"- echo -e " ${BOLD}ruvflow init --wizard${NC}"+ echo -e " ${BOLD}ruflo init --wizard${NC}"echo ""echo -e " ${DIM}# Run system diagnostics${NC}"- echo -e " ${BOLD}ruvflow doctor${NC}"+ echo -e " ${BOLD}ruflo doctor${NC}"echo ""echo -e " ${DIM}# Add as MCP server to Claude Code${NC}"- echo -e " ${BOLD}claude mcp add ruvflow -- ruvflow mcp start${NC}"+ echo -e " ${BOLD}claude mcp add ruflo -- ruflo mcp start${NC}"elseecho -e " ${DIM}# Initialize project${NC}"- echo -e " ${BOLD}npx ruvflow@alpha init --wizard${NC}"+ echo -e " ${BOLD}npx ruflo@alpha init --wizard${NC}"echo ""echo -e " ${DIM}# Run system diagnostics${NC}"- echo -e " ${BOLD}npx ruvflow@alpha doctor${NC}"+ echo -e " ${BOLD}npx ruflo@alpha doctor${NC}"echo ""echo -e " ${DIM}# Add as MCP server to Claude Code${NC}"- echo -e " ${BOLD}claude mcp add ruvflow -- npx -y ruvflow@alpha mcp start${NC}"+ echo -e " ${BOLD}claude mcp add ruflo -- npx -y ruflo@alpha mcp start${NC}"fiecho ""@@ -320,20 +320,20 @@ setup_mcp_server() {fi# Check if already configured- if claude mcp list 2>/dev/null | grep -q "ruvflow"; then+ if claude mcp list 2>/dev/null | grep -q "ruflo"; thenprint_substep "MCP server already configured β"return 0fi# Add MCP serverif [ "$GLOBAL" = "1" ]; then- claude mcp add ruvflow -- ruvflow mcp start 2>/dev/null && \+ claude mcp add ruflo -- ruflo mcp start 2>/dev/null && \print_substep "MCP server configured β" || \- print_warning "MCP setup failed - run manually: claude mcp add ruvflow -- ruvflow mcp start"+ print_warning "MCP setup failed - run manually: claude mcp add ruflo -- ruflo mcp start"else- claude mcp add ruvflow -- npx -y ruvflow@${VERSION} mcp start 2>/dev/null && \+ claude mcp add ruflo -- npx -y ruflo@${VERSION} mcp start 2>/dev/null && \print_substep "MCP server configured β" || \- print_warning "MCP setup failed - run manually: claude mcp add ruvflow -- npx -y ruvflow@alpha mcp start"+ print_warning "MCP setup failed - run manually: claude mcp add ruflo -- npx -y ruflo@alpha mcp start"fiecho ""}@@ -347,9 +347,9 @@ run_doctor() {echo ""if [ "$GLOBAL" = "1" ]; then- ruvflow doctor 2>&1 || true+ ruflo doctor 2>&1 || trueelse- npx ruvflow@${VERSION} doctor 2>&1 || true+ npx ruflo@${VERSION} doctor 2>&1 || truefiecho ""}@@ -363,9 +363,9 @@ run_init() {echo ""if [ "$GLOBAL" = "1" ]; then- ruvflow init --yes 2>&1 || true+ ruflo init --yes 2>&1 || trueelse- npx ruvflow@${VERSION} init --yes 2>&1 || true+ npx ruflo@${VERSION} init --yes 2>&1 || truefiecho ""}@@ -382,7 +382,7 @@ main() {run_initshow_quickstart- print_success "${BOLD}RuvFlow is ready!${NC} π"+ print_success "${BOLD}Ruflo is ready!${NC} π"echo ""}diff --git a/v3/@claude-flow/cli/agents/architect.yaml b/v3/@claude-flow/cli/agents/architect.yamlindex 4881b94e5d..6621bdc70d 100644--- a/v3/@claude-flow/cli/agents/architect.yaml+++ b/v3/@claude-flow/cli/agents/architect.yaml@@ -8,4 +8,4 @@ capabilities:optimizations:- context-caching- memory-persistence-createdAt: "2026-02-07T23:03:34.451Z"+createdAt: "2026-02-08T17:23:45.195Z"diff --git a/v3/@claude-flow/cli/agents/coder.yaml b/v3/@claude-flow/cli/agents/coder.yamlindex d83e92fa36..51a651978a 100644--- a/v3/@claude-flow/cli/agents/coder.yaml+++ b/v3/@claude-flow/cli/agents/coder.yaml@@ -8,4 +8,4 @@ capabilities:optimizations:- flash-attention- token-reduction-createdAt: "2026-02-07T23:03:34.451Z"+createdAt: "2026-02-08T17:23:45.195Z"diff --git a/v3/@claude-flow/cli/agents/reviewer.yaml b/v3/@claude-flow/cli/agents/reviewer.yamlindex 2cff911e08..c308b80922 100644--- a/v3/@claude-flow/cli/agents/reviewer.yaml+++ b/v3/@claude-flow/cli/agents/reviewer.yaml@@ -7,4 +7,4 @@ capabilities:- best-practicesoptimizations:- incremental-analysis-createdAt: "2026-02-07T23:03:34.451Z"+createdAt: "2026-02-08T17:23:45.196Z"diff --git a/v3/@claude-flow/cli/agents/security-architect.yaml b/v3/@claude-flow/cli/agents/security-architect.yamlindex 5ce71767c4..f87267ea3e 100644--- a/v3/@claude-flow/cli/agents/security-architect.yaml+++ b/v3/@claude-flow/cli/agents/security-architect.yaml@@ -7,4 +7,4 @@ capabilities:- security-reviewoptimizations:- pattern-matching-createdAt: "2026-02-07T23:03:34.451Z"+createdAt: "2026-02-08T17:23:45.196Z"diff --git a/v3/@claude-flow/cli/agents/tester.yaml b/v3/@claude-flow/cli/agents/tester.yamlindex b6b357d5b5..c6c4778089 100644--- a/v3/@claude-flow/cli/agents/tester.yaml+++ b/v3/@claude-flow/cli/agents/tester.yaml@@ -7,4 +7,4 @@ capabilities:- coverageoptimizations:- parallel-execution-createdAt: "2026-02-07T23:03:34.451Z"+createdAt: "2026-02-08T17:23:45.195Z"diff --git a/v3/@claude-flow/memory/package.json b/v3/@claude-flow/memory/package.jsonindex 06275e42dc..3889372c39 100644--- a/v3/@claude-flow/memory/package.json+++ b/v3/@claude-flow/memory/package.json@@ -1,6 +1,6 @@{"name": "@claude-flow/memory",- "version": "3.0.0-alpha.6",+ "version": "3.0.0-alpha.7","type": "module","description": "Memory module - AgentDB unification, HNSW indexing, vector search, hybrid SQLite+AgentDB backend (ADR-009)","main": "dist/index.js",