Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 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

Checkpoint: File edits

rUv6eb9e16a4a30
diff --git a/agents/architect.yaml b/agents/architect.yaml
index 14b47429d4..646f311ca5 100644
--- a/agents/architect.yaml
+++ b/agents/architect.yaml
@@ -8,4 +8,4 @@ capabilities:
optimizations:
- context-caching
- memory-persistence
-createdAt: "2026-01-20T22:39:42.113Z"
+createdAt: "2026-01-21T01:31:40.797Z"
diff --git a/agents/coder.yaml b/agents/coder.yaml
index 91cdecd6c7..fe6ffbfd28 100644
--- a/agents/coder.yaml
+++ b/agents/coder.yaml
@@ -8,4 +8,4 @@ capabilities:
optimizations:
- flash-attention
- token-reduction
-createdAt: "2026-01-20T22:39:42.113Z"
+createdAt: "2026-01-21T01:31:40.797Z"
diff --git a/agents/reviewer.yaml b/agents/reviewer.yaml
index 8183ac25a0..3f31afd1df 100644
--- a/agents/reviewer.yaml
+++ b/agents/reviewer.yaml
@@ -7,4 +7,4 @@ capabilities:
- best-practices
optimizations:
- incremental-analysis
-createdAt: "2026-01-20T22:39:42.114Z"
+createdAt: "2026-01-21T01:31:40.797Z"
diff --git a/agents/security-architect.yaml b/agents/security-architect.yaml
index 9680ab842c..2c8acd4d30 100644
--- a/agents/security-architect.yaml
+++ b/agents/security-architect.yaml
@@ -7,4 +7,4 @@ capabilities:
- security-review
optimizations:
- pattern-matching
-createdAt: "2026-01-20T22:39:42.114Z"
+createdAt: "2026-01-21T01:31:40.797Z"
diff --git a/agents/tester.yaml b/agents/tester.yaml
index 4deeeeda15..f7fa74e59b 100644
--- a/agents/tester.yaml
+++ b/agents/tester.yaml
@@ -7,4 +7,4 @@ capabilities:
- coverage
optimizations:
- parallel-execution
-createdAt: "2026-01-20T22:39:42.114Z"
+createdAt: "2026-01-21T01:31:40.797Z"
diff --git a/package-lock.json b/package-lock.json
index a4089c4b71..47ff5016c9 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "claude-flow",
- "version": "3.0.0-alpha.149",
+ "version": "3.0.0-alpha.151",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "claude-flow",
- "version": "3.0.0-alpha.149",
+ "version": "3.0.0-alpha.151",
"license": "MIT",
"dependencies": {
"agentdb": "2.0.0-alpha.3.4",
diff --git a/package.json b/package.json
index 9ba4e3a67b..9d76cb8af3 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "claude-flow",
- "version": "3.0.0-alpha.149",
+ "version": "3.0.0-alpha.151",
"description": "Claude Flow V3 - Domain-Driven Design Architecture with 15-Agent Swarm Coordination",
"main": "dist/index.js",
"type": "module",
diff --git a/v3/@claude-flow/cli/README.md b/v3/@claude-flow/cli/README.md
index eb685ab3ba..f6c7d97050 100644
--- a/v3/@claude-flow/cli/README.md
+++ b/v3/@claude-flow/cli/README.md
@@ -4,12 +4,15 @@
[![Star on GitHub](https://img.shields.io/github/stars/ruvnet/claude-flow?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/claude-flow)
-[![Downloads](https://img.shields.io/npm/dt/claude-flow?style=for-the-badge&logo=npm&color=blue&label=Downloads)](https://www.npmjs.com/package/claude-flow)
+[![Monthly Downloads](https://img.shields.io/npm/dm/claude-flow?style=for-the-badge&logo=npm&color=blue&label=Monthly%20Downloads)](https://www.npmjs.com/package/claude-flow)
+[![Total Downloads](https://img.shields.io/npm/dt/claude-flow?style=for-the-badge&logo=npm&color=cyan&label=Total%20Downloads)](https://www.npmjs.com/package/claude-flow)
[![Latest Release](https://img.shields.io/npm/v/claude-flow/alpha?style=for-the-badge&logo=npm&color=green&label=v3.0.0-alpha)](https://www.npmjs.com/package/claude-flow)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-SDK%20Integrated-green?style=for-the-badge&logo=anthropic)](https://github.com/ruvnet/claude-flow)
[![Agentics Foundation](https://img.shields.io/badge/Agentics-Foundation-crimson?style=for-the-badge&logo=openai)](https://discord.com/invite/dfxmpwkG2D)
[![ruv.io](https://img.shields.io/badge/ruv.io-AI%20Platform-purple?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0xMiAyQzYuNDggMiAyIDYuNDggMiAxMnM0LjQ4IDEwIDEwIDEwIDEwLTQuNDggMTAtMTBTMTcuNTIgMiAxMiAyem0wIDE4Yy00LjQyIDAtOC0zLjU4LTgtOHMzLjU4LTggOC04IDggMy41OCA4IDgtMy41OCA4LTggOHoiLz48L3N2Zz4=)](https://ruv.io)
[![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge&logo=opensourceinitiative)](https://opensource.org/licenses/MIT)
+[![RuVector](https://img.shields.io/npm/v/ruvector?style=for-the-badge&logo=rust&color=orange&label=RuVector)](https://www.npmjs.com/package/ruvector)
+[![Agentic-Flow](https://img.shields.io/npm/v/agentic-flow?style=for-the-badge&logo=typescript&color=3178c6&label=Agentic-Flow)](https://www.npmjs.com/package/agentic-flow)
**Production-ready multi-agent AI orchestration for Claude Code**
@@ -168,6 +171,8 @@ npx claude-flow@v3alpha init
<details open>
<summary>πŸ”„ <strong>Core Flow</strong> β€” How requests move through the system</summary>
+Every request flows through four layers: from your CLI or Claude Code interface, through intelligent routing, to specialized agents, and finally to LLM providers for reasoning.
+
| Layer | Components | What It Does |
|-------|------------|--------------|
| User | Claude Code, CLI | Your interface to control and run commands |
@@ -180,6 +185,8 @@ npx claude-flow@v3alpha init
<details>
<summary>🐝 <strong>Swarm Coordination</strong> β€” How agents work together</summary>
+Agents organize into swarms led by queens that coordinate work, prevent drift, and reach consensus on decisionsβ€”even when some agents fail.
+
| Layer | Components | What It Does |
|-------|------------|--------------|
| Coordination | Queen, Swarm, Consensus | Manages agent teams (Raft, Byzantine, Gossip) |
@@ -199,6 +206,8 @@ npx claude-flow@v3alpha init
<details>
<summary>🧠 <strong>Intelligence & Memory</strong> β€” How the system learns and remembers</summary>
+The system stores successful patterns in vector memory, learns from outcomes via neural networks, and adapts routing based on what works best.
+
| Layer | Components | What It Does |
|-------|------------|--------------|
| Memory | HNSW, AgentDB, Cache | Stores and retrieves patterns 150x faster |
@@ -211,6 +220,8 @@ npx claude-flow@v3alpha init
<details>
<summary>⚑ <strong>Optimization</strong> β€” How to reduce cost and latency</summary>
+Skip expensive LLM calls for simple tasks using WebAssembly transforms, and compress tokens to reduce API costs by 30-50%.
+
| Layer | Components | What It Does |
|-------|------------|--------------|
| Agent Booster | WASM, AST analysis | Skips LLM for simple edits (<1ms) |
@@ -221,6 +232,8 @@ npx claude-flow@v3alpha init
<details>
<summary>πŸ”§ <strong>Operations</strong> β€” Background services and integrations</summary>
+Background daemons handle security audits, performance optimization, and session persistence automatically while you work.
+
| Layer | Components | What It Does |
|-------|------------|--------------|
| Background | Daemon, 12 Workers | Auto-runs audits, optimization, learning |
@@ -333,7 +346,7 @@ Once added, Claude Code can use all 175+ claude-flow tools directly:
- And 170+ more tools...
-<summary><h3>πŸ†š Why Claude-Flow v3? </h3></summary>
+<summary>πŸ†š <strong>Why Claude-Flow v3?</strong></summary>
Claude-Flow v3 introduces **self-learning neural capabilities** that no other agent orchestration framework offers. While competitors require manual agent configuration and static routing, Claude-Flow learns from every task execution, prevents catastrophic forgetting of successful patterns, and intelligently routes work to specialized experts.
@@ -683,8 +696,12 @@ flowchart TB
---
+## πŸ”Œ Setup & Configuration
+
+Connect Claude-Flow to your development environment.
+
<details>
-<summary><h2>πŸ”Œ MCP Setup β€” Connect Claude-Flow to Any AI Environment</h2></summary>
+<summary>πŸ”Œ <strong>MCP Setup</strong> β€” Connect Claude-Flow to Any AI Environment</summary>
Claude-Flow runs as an MCP (Model Context Protocol) server, allowing you to connect it to any MCP-compatible AI client. This means you can use Claude-Flow's 54+ agents, swarm coordination, and self-learning capabilities from Claude Desktop, VS Code, Cursor, Windsurf, ChatGPT, and more.
@@ -695,8 +712,6 @@ Claude-Flow runs as an MCP (Model Context Protocol) server, allowing you to conn
npx claude-flow@v3alpha mcp start
```
----
-
<details open>
<summary>πŸ–₯️ <strong>Claude Desktop</strong></summary>
@@ -965,8 +980,12 @@ echo "ANTHROPIC_API_KEY=sk-ant-..." >> .env
---
+## πŸ“¦ Core Features
+
+Comprehensive capabilities for enterprise-grade AI agent orchestration.
+
<details>
-<summary><h2>πŸ“¦ Features β€” 54+ Agents, Swarm Topologies, MCP Tools & Security</h2></summary>
+<summary>πŸ“¦ <strong>Features</strong> β€” 54+ Agents, Swarm Topologies, MCP Tools & Security</summary>
Comprehensive feature set for enterprise-grade AI agent orchestration.
@@ -1355,7 +1374,7 @@ npx claude-flow@v3alpha worker status
| `init` | 4 | Project initialization (wizard, check, skills, hooks) |
| `agent` | 8 | Agent lifecycle (spawn, list, status, stop, metrics, pool, health, logs) |
| `swarm` | 6 | Swarm coordination (init, start, status, stop, scale, coordinate) |
-| `memory` | 11 | Memory operations (store, retrieve, search, list, delete, stats, configure, cleanup, compress, export, import) |
+| `memory` | 12 | Memory operations (init, store, retrieve, search --build-hnsw, list, delete, stats, configure, cleanup, compress, export, import) |
| `mcp` | 9 | MCP server (start, stop, status, health, restart, tools, toggle, exec, logs) |
| `task` | 6 | Task management (create, list, status, cancel, assign, retry) |
| `session` | 7 | Session management (list, save, restore, delete, export, import, current) |
@@ -1893,8 +1912,12 @@ Shell-based daemons for monitoring (Linux/macOS only):
---
+## 🎯 Use Cases & Workflows
+
+Real-world scenarios and pre-built workflows for common tasks.
+
<details>
-<summary><h2>🎯 Use Cases β€” Real-world scenarios and how to solve them</h2></summary>
+<summary>🎯 <strong>Use Cases</strong> β€” Real-world scenarios and how to solve them</summary>
### πŸ‘¨β€πŸ’» Development & Code Quality
@@ -1958,8 +1981,12 @@ Shell-based daemons for monitoring (Linux/macOS only):
---
+## 🧠 Intelligence & Learning
+
+Self-learning hooks, pattern recognition, and intelligent task routing.
+
<details>
-<summary><h2>πŸͺHooks, Event Hooks, Workers & Pattern Intelligence</h2></summary>
+<summary>πŸͺ <strong>Hooks, Event Hooks, Workers & Pattern Intelligence</strong></summary>
### What Are Hooks?
@@ -2155,7 +2182,7 @@ npx claude-flow@v3alpha hooks worker dispatch --trigger audit
---
<details>
-<summary><h2>πŸ“¦ Pattern Store & Export β€” Share Patterns, Import Config </h2></summary>
+<summary>πŸ“¦ <strong>Pattern Store & Export</strong> β€” Share Patterns, Import Config</summary>
Share learned patterns across projects, teams, and the community via the decentralized pattern marketplace.
@@ -2291,8 +2318,12 @@ npx claude-flow@v3alpha transfer-store download --id "security-essentials" --app
---
+## πŸ› οΈ Development Tools
+
+Scripts, coordination systems, and collaborative development features.
+
<details>
-<summary><h2>πŸ› οΈ Helper Scripts β€” 30+ Development Automation Tools</h2></summary>
+<summary>πŸ› οΈ <strong>Helper Scripts</strong> β€” 30+ Development Automation Tools</summary>
The `.claude/helpers/` directory contains **30+ automation scripts** for development, monitoring, learning, and swarm coordination. These scripts integrate with hooks and can be called directly or via the V3 master tool.
@@ -2431,7 +2462,7 @@ Helpers are configured in `.claude/settings.json`:
---
<details>
-<summary><h2>πŸŽ“ Skills System β€” 42 Pre-Built Workflows for Any Task</h2></summary>
+<summary>πŸŽ“ <strong>Skills System</strong> β€” 42 Pre-Built Workflows for Any Task</summary>
Skills are **reusable workflows** that combine agents, hooks, and patterns into ready-to-use solutions. Think of them as "recipes" for common development tasks.
@@ -2614,7 +2645,7 @@ Skills are defined in YAML with:
---
<details>
-<summary><h2>🎫 Claims & Work Coordination β€” Human-Agent Task Management</h2></summary>
+<summary>🎫 <strong>Claims & Work Coordination</strong> β€” Human-Agent Task Management</summary>
The Claims system manages **who is working on what** β€” whether human or agent. It prevents conflicts, enables handoffs, and balances work across your team.
@@ -2736,7 +2767,7 @@ npx claude-flow@v3alpha issues rebalance
---
<details>
-<summary><h2>🧭 Intelligent Routing β€” Q-Learning Task Assignment</h2></summary>
+<summary>🧭 <strong>Intelligent Routing</strong> β€” Q-Learning Task Assignment</summary>
The Route system uses **Q-Learning** to automatically assign tasks to the best agent based on learned performance patterns.
@@ -2840,8 +2871,12 @@ The system **remembers** what works and applies it to future similar tasks.
---
+## πŸ’» Programmatic Usage
+
+Use Claude-Flow packages directly in your applications.
+
<details>
-<summary><h2>πŸ’» Programmatic SDK β€” Use Claude-Flow in Your Code</h2></summary>
+<summary>πŸ’» <strong>Programmatic SDK</strong> β€” Use Claude-Flow in Your Code</summary>
Use Claude-Flow packages directly in your TypeScript/JavaScript applications.
@@ -2886,6 +2921,26 @@ console.log(results);
// [{ key: 'auth-pattern', similarity: 0.92, content: '...' }]
```
+**CLI Commands:**
+```bash
+# Initialize memory database
+npx claude-flow@alpha memory init --force
+
+# Store patterns
+npx claude-flow@alpha memory store --key "pattern-auth" --value "JWT authentication with refresh tokens"
+npx claude-flow@alpha memory store --key "pattern-cache" --value "Redis caching for API responses"
+
+# Build HNSW index for 150x-12,500x faster search
+npx claude-flow@alpha memory search --query "authentication" --build-hnsw
+
+# Semantic search (uses HNSW if built)
+npx claude-flow@alpha memory search --query "how to cache data" --limit 5
+
+# List and manage entries
+npx claude-flow@alpha memory list --namespace patterns
+npx claude-flow@alpha memory stats
+```
+
</details>
<details>
@@ -3210,8 +3265,12 @@ await hooks.endTrajectory(trajectory, { success: true });
---
+## πŸ”— Ecosystem & Integrations
+
+Core infrastructure packages powering Claude-Flow's intelligence layer.
+
<details>
-<summary><h2>⚑ Agentic-Flow Integration β€” Core AI Infrastructure</h2></summary>
+<summary>⚑ <strong>Agentic-Flow Integration</strong> β€” Core AI Infrastructure</summary>
[![npm version](https://img.shields.io/npm/v/agentic-flow?color=blue&label=npm)](https://www.npmjs.com/package/agentic-flow)
[![npm downloads](https://img.shields.io/npm/dm/agentic-flow?color=green)](https://www.npmjs.com/package/agentic-flow)
@@ -3531,7 +3590,7 @@ const config = optimizer.getOptimalConfig(agentCount);
---
<details>
-<summary><h2>πŸ₯‹ Agentic-Jujutsu β€” Quantum-Ready AI Version Control</h2></summary>
+<summary>πŸ₯‹ <strong>Agentic-Jujutsu</strong> β€” Quantum-Ready AI Version Control</summary>
[![npm version](https://img.shields.io/npm/v/agentic-jujutsu?color=blue&label=npm)](https://www.npmjs.com/package/agentic-jujutsu)
[![npm downloads](https://img.shields.io/npm/dm/agentic-jujutsu?color=green)](https://www.npmjs.com/package/agentic-jujutsu)
@@ -3765,14 +3824,36 @@ npx agentic-jujutsu examples # Show usage examples
---
<details>
-<summary><h2>πŸ¦€ RuVector β€” High-Performance Rust/WASM Intelligence</h2></summary>
+<summary>πŸ¦€ <strong>RuVector</strong> β€” High-Performance Rust/WASM Intelligence</summary>
[![npm version](https://img.shields.io/npm/v/ruvector?color=blue&label=npm)](https://www.npmjs.com/package/ruvector)
[![npm downloads](https://img.shields.io/npm/dm/ruvector?color=green)](https://www.npmjs.com/package/ruvector)
[![GitHub](https://img.shields.io/badge/GitHub-ruvnet%2Fruvector-blue?logo=github)](https://github.com/ruvnet/ruvector)
[![Docker](https://img.shields.io/badge/Docker-ruvector--postgres-blue?logo=docker)](https://hub.docker.com/r/ruvnet/ruvector-postgres)
-**RuVector** is a high-performance vector database and neural computing library written in Rust with Node.js/WASM bindings. It powers Claude-Flow'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 Claude-Flow's intelligence layer with native speed.
+
+### Key Capabilities
+
+| Capability | Description | Performance |
+|------------|-------------|-------------|
+| **Vector Search** | HNSW indexing with SIMD acceleration | **~61Β΅s latency, 16,400 QPS** |
+| **Graph Queries** | Full Cypher syntax (MATCH, WHERE, CREATE) | Native graph traversal |
+| **Self-Learning** | GNN layers that improve search over time | Automatic optimization |
+| **Distributed** | Raft consensus, multi-master replication | Auto-sharding |
+| **Compression** | Adaptive tiered (hot/warm/cool/cold) | **2-32x memory reduction** |
+| **39 Attention Types** | Flash, linear, sparse, graph, hyperbolic | GPU-accelerated SQL |
+
+### Performance Benchmarks
+
+| Operation | Latency | Throughput |
+|-----------|---------|------------|
+| HNSW Search (k=10, 384-dim) | **61Β΅s** | 16,400 QPS |
+| HNSW Search (k=100) | 164Β΅s | 6,100 QPS |
+| Cosine Distance (1536-dim) | 143ns | 7M ops/sec |
+| Dot Product (384-dim) | 33ns | 30M ops/sec |
+| Batch Distance (1000 vectors) | 237Β΅s | 4.2M/sec |
+| Memory (1M vectors with PQ8) | - | **200MB** |
### Quick Start
@@ -3787,16 +3868,44 @@ npx ruvector --help
docker run -d -p 5432:5432 ruvnet/ruvector-postgres
```
+### Basic Usage
+
+```javascript
+import ruvector from 'ruvector';
+
+// Initialize vector database
+const db = new ruvector.VectorDB(384); // 384 dimensions
+
+// Insert vectors
+await db.insert('doc1', embedding1);
+await db.insert('doc2', embedding2);
+
+// Search (returns top-k similar)
+const results = await db.search(queryEmbedding, 10);
+
+// Graph queries with Cypher
+await db.execute("CREATE (a:Person {name: 'Alice'})-[:KNOWS]->(b:Person {name: 'Bob'})");
+const friends = await db.execute("MATCH (p:Person)-[:KNOWS]->(friend) RETURN friend.name");
+
+// GNN-enhanced search (self-learning)
+const layer = new ruvector.GNNLayer(384, 256, 4);
+const enhanced = layer.forward(query, neighbors, weights);
+
+// Compression (2-32x memory reduction)
+const compressed = ruvector.compress(embedding, 0.3); // 30% quality threshold
+```
+
### Package Ecosystem
| Package | Description | Performance |
|---------|-------------|-------------|
-| **[ruvector](https://www.npmjs.com/package/ruvector)** | Core vector database with HNSW | 150x-12,500x faster search |
+| **[ruvector](https://www.npmjs.com/package/ruvector)** | Core vector database with HNSW | **~61Β΅s search, 16,400 QPS** |
| **[@ruvector/attention](https://www.npmjs.com/package/@ruvector/attention)** | Flash Attention mechanisms | 2.49x-7.47x speedup |
| **[@ruvector/sona](https://www.npmjs.com/package/@ruvector/sona)** | SONA adaptive learning (LoRA, EWC++) | <0.05ms adaptation |
-| **[@ruvector/gnn](https://www.npmjs.com/package/@ruvector/gnn)** | Graph Neural Networks | Native NAPI bindings |
+| **[@ruvector/gnn](https://www.npmjs.com/package/@ruvector/gnn)** | Graph Neural Networks (15 layer types) | Native NAPI bindings |
| **[@ruvector/graph-node](https://www.npmjs.com/package/@ruvector/graph-node)** | Graph DB with Cypher queries | 10x faster than WASM |
| **[@ruvector/rvlite](https://www.npmjs.com/package/@ruvector/rvlite)** | Standalone DB (SQL, SPARQL, Cypher) | All-in-one solution |
+| **[ruvector-wasm](https://www.npmjs.com/package/ruvector-wasm)** | Browser/Edge WASM build | Works everywhere |
### 🐘 RuVector PostgreSQL β€” Enterprise Vector Database
@@ -4029,8 +4138,12 @@ ruvector-postgres/
---
+## ☁️ Cloud & Deployment
+
+Cloud platform integration and deployment tools.
+
<details>
-<summary><h2>☁️ Flow Nexus β€” Cloud Platform Integration</h2></summary>
+<summary>☁️ <strong>Flow Nexus</strong> β€” Cloud Platform Integration</summary>
Flow Nexus is a **cloud platform** for deploying and scaling Claude-Flow beyond your local machine.
@@ -4140,7 +4253,7 @@ npx claude-flow@v3alpha nexus swarm deploy
---
<details>
-<summary><h2>πŸ”— Stream-Chain β€” Multi-Agent Pipelines</h2></summary>
+<summary>πŸ”— <strong>Stream-Chain</strong> β€” Multi-Agent Pipelines</summary>
Stream-Chain enables **sequential processing** where the output of one agent becomes the input of the next.
@@ -4229,7 +4342,7 @@ npx claude-flow@v3alpha stream-chain status feature-pipeline
---
<details>
-<summary><h2>πŸ‘₯ Pair Programming β€” Collaborative AI Development</h2></summary>
+<summary>πŸ‘₯ <strong>Pair Programming</strong> β€” Collaborative AI Development</summary>
The Pair Programming skill provides **human-AI collaborative coding** with role switching, TDD support, and real-time verification.
@@ -4308,8 +4421,12 @@ npx claude-flow@v3alpha pair end
---
+## πŸ›‘οΈ Security
+
+AI manipulation defense, threat detection, and input validation.
+
<details>
-<summary><h2>πŸ›‘οΈ AIDefence Security β€” Threat Detection, PII Scanning </h2></summary>
+<summary>πŸ›‘οΈ <strong>AIDefence Security</strong> β€” Threat Detection, PII Scanning</summary>
**AI Manipulation Defense System (AIMDS)** β€” Protect AI applications from prompt injection, jailbreaks, and data exposure with sub-millisecond detection.
@@ -4487,8 +4604,12 @@ const consensus = calculateSecurityConsensus(assessments);
---
+## πŸ—οΈ Architecture & Modules
+
+Domain-driven design, performance benchmarks, and testing framework.
+
<details>
-<summary><h2>πŸ—οΈ Architecture β€” DDD Modules, Topology Benchmarks & Metrics</h2></summary>
+<summary>πŸ—οΈ <strong>Architecture</strong> β€” DDD Modules, Topology Benchmarks & Metrics</summary>
Domain-Driven Design with bounded contexts, clean architecture, and measured performance across all topologies.
@@ -4634,7 +4755,7 @@ const template = getWorkflow('login-basic');
---
<details>
-<summary><h2>πŸ“¦ Release Management β€” @claude-flow/deployment</h2></summary>
+<summary>πŸ“¦ <strong>Release Management</strong> β€” @claude-flow/deployment</summary>
Automated release management, versioning, and CI/CD for Claude Flow packages.
@@ -4773,7 +4894,7 @@ npx @claude-flow/deployment release --version 2.0.0 --dry-run
---
<details>
-<summary><h2>πŸ“Š Performance Benchmarking β€” @claude-flow/performance</h2></summary>
+<summary>πŸ“Š <strong>Performance Benchmarking</strong> β€” @claude-flow/performance</summary>
Statistical benchmarking, memory tracking, regression detection, and V3 performance target validation.
@@ -4961,7 +5082,7 @@ npx claude-flow@v3alpha performance benchmark --suite memory
---
<details>
-<summary><h2>πŸ§ͺ Testing Framework β€” @claude-flow/testing</h2></summary>
+<summary>πŸ§ͺ <strong>Testing Framework</strong> β€” @claude-flow/testing</summary>
Comprehensive TDD framework implementing **London School** patterns with behavior verification, shared fixtures, and mock services.
@@ -5227,8 +5348,12 @@ console.log(TEST_CONFIG.AGENTDB_SEARCH_IMPROVEMENT_MAX); // 12500
---
+## βš™οΈ Configuration & Reference
+
+Environment setup, configuration options, and platform support.
+
<details>
-<summary><h2>πŸ’» Cross-Platform Support </h2></summary>
+<summary>πŸ’» <strong>Cross-Platform Support</strong></summary>
### Windows (PowerShell)
@@ -5257,7 +5382,7 @@ export CLAUDE_FLOW_MEMORY_PATH="./data"
---
<details>
-<summary><h2>βš™οΈ Environment Variables </h2></summary>
+<summary>βš™οΈ <strong>Environment Variables</strong></summary>
### Core Configuration
@@ -5397,7 +5522,7 @@ CLAUDE_FLOW_HNSW_EF=200
---
<details>
-<summary><h2>πŸ“„ Configuration Reference </h2></summary>
+<summary>πŸ“„ <strong>Configuration Reference</strong></summary>
### Configuration File Location
@@ -5651,8 +5776,12 @@ npx claude-flow@v3alpha init --wizard
---
+## πŸ“– Help & Resources
+
+Troubleshooting, migration guides, and documentation links.
+
<details>
-<summary><h2>πŸ”§ Troubleshooting </h2></summary>
+<summary>πŸ”§ <strong>Troubleshooting</strong></summary>
### Common Issues
@@ -5712,7 +5841,7 @@ export CLAUDE_FLOW_HNSW_EF=100
---
<details>
-<summary><h2>πŸ”„ Migration Guide (V2 β†’ V3) </h2></summary>
+<summary>πŸ”„ <strong>Migration Guide (V2 β†’ V3)</strong></summary>
### Why Migrate to V3?
@@ -5862,7 +5991,7 @@ cp -r ./data-backup-v2 ./data
---
<details>
-<summary><h2>πŸ“š Documentation </h2></summary>
+<summary>πŸ“š <strong>Documentation</strong></summary>
### V3 Module Documentation
diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.json
index d0c438d4cb..51cfce6635 100644
--- a/v3/@claude-flow/cli/package.json
+++ b/v3/@claude-flow/cli/package.json
@@ -1,6 +1,6 @@
{
"name": "@claude-flow/cli",
- "version": "3.0.0-alpha.148",
+ "version": "3.0.0-alpha.151",
"type": "module",
"description": "CLI module - command parsing, prompts, output formatting",
"main": "dist/src/index.js",
diff --git a/v3/@claude-flow/cli/src/init/executor.ts b/v3/@claude-flow/cli/src/init/executor.ts
index 0cb43d97ce..371a383c6a 100644
--- a/v3/@claude-flow/cli/src/init/executor.ts
+++ b/v3/@claude-flow/cli/src/init/executor.ts
@@ -410,6 +410,14 @@ export async function executeUpgradeWithMissing(targetDir: string): Promise<Upgr
const sourceAgentsDir = findSourceDir('agents');
const sourceCommandsDir = findSourceDir('commands');
+ // Debug: Log source directories found
+ if (process.env.DEBUG || process.env.CLAUDE_FLOW_DEBUG) {
+ console.log('[DEBUG] Source directories:');
+ console.log(` Skills: ${sourceSkillsDir || 'NOT FOUND'}`);
+ console.log(` Agents: ${sourceAgentsDir || 'NOT FOUND'}`);
+ console.log(` Commands: ${sourceCommandsDir || 'NOT FOUND'}`);
+ }
+
// Add missing skills
if (sourceSkillsDir) {
const allSkills = Object.values(SKILLS_MAP).flat();
diff --git a/v3/package-lock.json b/v3/package-lock.json
index 7bbefc6e21..154cff0cb4 100644
--- a/v3/package-lock.json
+++ b/v3/package-lock.json
@@ -1789,7 +1789,7 @@
}
},
"@claude-flow/cli": {
- "version": "3.0.0-alpha.148",
+ "version": "3.0.0-alpha.151",
"dependencies": {
"@claude-flow/aidefence": "^3.0.2",
"@claude-flow/embeddings": "^3.0.0-alpha.12",