claude-flow 2.7.0-alpha.1 → 2.7.0-alpha.11

package/README.md

@@ -1,86 +1,44 @@
-# 🌊 Claude-Flow v2.5.0 Alpha 140: AI Orchestration Platform
+# 🌊 Claude-Flow v2.7.0: Enterprise AI Orchestration Platform
 
 <div align="center">
 
 [![🌟 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)
-[![📦 Latest Release](https://img.shields.io/npm/v/claude-flow?style=for-the-badge&logo=npm&color=green&label=v2.5.0-alpha.140)](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=v2.7.0-alpha.10)](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)
-[![🐝 Hive-Mind](https://img.shields.io/badge/Hive--Mind-AI%20Coordination-purple?style=for-the-badge&logo=swarm)](https://github.com/ruvnet/claude-flow)
-[![🧠 Neural](https://img.shields.io/badge/Neural-87%20MCP%20Tools-blue?style=for-the-badge&logo=pytorch)](https://github.com/ruvnet/claude-flow)
 [![🛡️ MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge&logo=opensourceinitiative)](https://opensource.org/licenses/MIT)
 
 </div>
 
 ## 🌟 **Overview**
 
-**Claude-Flow v2 Alpha** is an enterprise-grade AI orchestration platform that reimagines how developers build with AI. By combining **hive-mind swarm intelligence**, **neural pattern recognition**, and **87 advanced MCP tools**, Claude-Flow enables unprecedented AI-powered development workflows.
+**Claude-Flow v2.7** is an enterprise-grade AI orchestration platform that combines **hive-mind swarm intelligence**, **persistent memory**, and **100+ advanced MCP tools** to revolutionize AI-powered development workflows.
 
 ### 🎯 **Key Features**
 
+- **🧠 ReasoningBank Memory**: Persistent SQLite storage with semantic search (2-3ms latency)
+- **🔍 Semantic Search**: Hash-based embeddings - works without API keys
 - **🐝 Hive-Mind Intelligence**: Queen-led AI coordination with specialized worker agents
-- **🧠 Neural Networks**: 27+ cognitive models with WASM SIMD acceleration
-- **🔧 87 MCP Tools**: Comprehensive toolkit for swarm orchestration, memory, and automation
+- **🔧 100 MCP Tools**: Comprehensive toolkit for swarm orchestration and automation
 - **🔄 Dynamic Agent Architecture (DAA)**: Self-organizing agents with fault tolerance
-- **💾 SQLite Memory System**: Persistent `.swarm/memory.db` with 12 specialized tables
+- **💾 Persistent Memory**: `.swarm/memory.db` with 30+ specialized patterns
 - **🪝 Advanced Hooks System**: Automated workflows with pre/post operation hooks
 - **📊 GitHub Integration**: 6 specialized modes for repository management
-- **🌐 Flow Nexus Cloud Platform**: E2B sandboxes, AI swarms, challenges, and marketplace integration
-- **🎯 PreToolUse Modification Hooks**: NEW - Claude Code v2.0.10+ intelligent input modification (safety, organization, optimization)
+- **🌐 Flow Nexus Cloud**: E2B sandboxes, AI swarms, challenges, and marketplace
 
 > 🔥 **Revolutionary AI Coordination**: Build faster, smarter, and more efficiently with AI-powered development orchestration
 
-## 🎯 **NEW: PreToolUse Modification Hooks Plugin** (v2.5.0-alpha.140)
 
-**First Claude Code plugin with intelligent tool input modification** - automatically enhances commands and files before execution.
-
-**Key Features:**
-- 🛡️ **Safety**: Auto-adds `-i` to `rm` commands, detects sensitive keywords
-- 📁 **Organization**: Auto-routes files (tests→`/tests/`, src→`/src/`)
-- ⚡ **Productivity**: Alias expansion (`ll`→`ls -lah`), conventional commits
-
-**Quick Start:**
-
-**Option 1: Direct Plugin Installation** (Recommended)
-```bash
-# In Claude Code, run:
-/plugin ruvnet/claude-flow
-```
-
-**Option 2: Via NPM**
-```bash
-npx claude-flow@alpha init --force  # Auto-configures .claude-plugin/hooks/hooks.json
-```
-
-**Examples:**
-```bash
-rm test.txt          → rm -i test.txt           # Safety
-test.js             → src/test.js              # Organization
-git commit -m "fix" → [fix] fix + co-author   # Commits
-```
-
-> 📚 **Docs**: [HOOKS-V2-MODIFICATION.md](./docs/HOOKS-V2-MODIFICATION.md) | **Plugin**: `.claude-plugin/` | **Composable** with `agent-booster`
-
-## 🌐 **Flow Nexus Cloud Platform**
-
-**NEW**: Claude-Flow v2.0.0 now includes **Flow Nexus integration** - a cloud-powered AI development platform featuring:
-
-- **E2B Sandboxes**: Secure isolated environments for Node.js, Python, React, Next.js
-- **AI Swarms**: Deploy multi-agent systems in cloud infrastructure  
-- **Neural Training**: Distributed machine learning with custom model deployment
-- **Challenges & Marketplace**: Coding challenges with rUv credit rewards and template marketplace
-- **Workflow Automation**: Event-driven automation with message queue processing
-
-> 📚 **Complete documentation**: Visit [flow-nexus.ruv.io](https://flow-nexus.ruv.io) for comprehensive guides, tutorials, and API reference. Also see issue # https://github.com/ruvnet/claude-flow/issues/732
+---
 
-## ⚡ **Try v2.0.0 Alpha in 4 Commands**
+## ⚡ **Quick Start**
 
 ### 📋 **Prerequisites**
 
 - **Node.js 18+** (LTS recommended)
 - **npm 9+** or equivalent package manager
-- **Windows users**: See [Windows Installation Guide](https://github.com/ruvnet/claude-code-flow/blob/main/docs/windows-installation.md) for special instructions
+- **Windows users**: See [Windows Installation Guide](./docs/windows-installation.md) for special instructions
 
 ⚠️ **IMPORTANT**: Claude Code must be installed first:
 
@@ -89,225 +47,266 @@ git commit -m "fix" → [fix] fix + co-author   # Commits
 npm install -g @anthropic-ai/claude-code
 
 # 2. (Optional) Skip permissions check for faster setup
-# Only use if you understand the security implications
 claude --dangerously-skip-permissions
 ```
 
-💡 **Windows Note**: If you encounter SQLite errors, Claude Flow will automatically use in-memory storage. For persistent storage options, see our [Windows guide](https://github.com/ruvnet/claude-code-flow/blob/main/docs/windows-installation.md).
-
-### 🎯 **Instant Alpha Testing**
+### 🚀 **Install Latest Alpha**
 
-
-NPX Installation** (For MCP server + CLI)
 ```bash
-# 1. Initialize Claude Flow with enhanced MCP setup (auto-configures permissions!)
+# NPX (recommended - always latest)
 npx claude-flow@alpha init --force
-
-# 2. Explore all revolutionary capabilities
 npx claude-flow@alpha --help
 
-# 3a. Quick AI coordination (recommended for most tasks)
-npx claude-flow@alpha swarm "build me a REST API" --claude
-
-# 3b. OR launch the full hive-mind system (for complex projects)
-npx claude-flow@alpha hive-mind wizard
-npx claude-flow@alpha hive-mind spawn "build enterprise system" --claude
+# Or install globally
+npm install -g claude-flow@alpha
+claude-flow --version
+# v2.7.0-alpha.10
 ```
 
-### 🚀 **Quick Start with Flow Nexus**
+---
 
-```bash
-# 1. Initialize Flow Nexus only (minimal setup)
-npx claude-flow init --flow-nexus
+## 🆕 **What's New in v2.7.0-alpha.10**
 
-# 2. Register and login (use MCP tools in Claude Code)
-mcp__flow-nexus__user_register({ email: "your@email.com", password: "secure" })
-mcp__flow-nexus__user_login({ email: "your@email.com", password: "secure" })
+### ✅ **Semantic Search Fixed**
+Critical bug fix for semantic search returning 0 results:
+- ✅ Fixed stale compiled code (dist-cjs/ now uses Node.js backend)
+- ✅ Fixed result mapping for `retrieveMemories()` flat structure
+- ✅ Fixed parameter mismatch (namespace vs domain)
+- ✅ 2-3ms query latency with hash embeddings
+- ✅ Works without API keys (deterministic 1024-dim embeddings)
 
-# 3. Deploy your first cloud swarm
-mcp__flow-nexus__swarm_init({ topology: "mesh", maxAgents: 5 })
-mcp__flow-nexus__sandbox_create({ template: "node", name: "api-dev" })
-```
+### 🧠 **ReasoningBank Integration (agentic-flow@1.5.13)**
+- **Node.js Backend**: Replaced WASM with SQLite + better-sqlite3
+- **Persistent Storage**: All memories saved to `.swarm/memory.db`
+- **Semantic Search**: MMR ranking with 4-factor scoring
+- **Database Tables**: patterns, embeddings, trajectories, links
+- **Performance**: 2ms queries, 400KB per pattern with embeddings
 
-### 🤔 **Swarm vs Hive-Mind: Which to Use?**
+```bash
+# Semantic search now fully functional
+npx claude-flow@alpha memory store test "API configuration" --namespace semantic --reasoningbank
+npx claude-flow@alpha memory query "configuration" --namespace semantic --reasoningbank
+# ✅ Found 3 results (semantic search) in 2ms
+```
 
-| Feature | `swarm` Command | `hive-mind` Command |
-|---------|----------------|-------------------|
-| **Best For** | Quick tasks, single objectives | Complex projects, persistent sessions |
-| **Setup** | Instant - no configuration needed | Interactive wizard setup |
-| **Session** | Temporary coordination | Persistent with resume capability |
-| **Memory** | Task-scoped | Project-wide with SQLite storage |
-| **Agents** | Auto-spawned for task | Manual control with specializations |
-| **Use When** | "Build X", "Fix Y", "Analyze Z" | Multi-feature projects, team coordination |
+📚 **Release Notes**: [v2.7.0-alpha.10](./docs/RELEASE-NOTES-v2.7.0-alpha.10.md)
 
-**Quick Rule:** Start with `swarm` for most tasks. Use `hive-mind` when you need persistent sessions or complex multi-agent coordination.
+## 🧠 **Memory System Commands**
 
-## 🎯 **Typical Workflows - Your "Happy Path" Guide**
+### **ReasoningBank (Persistent SQLite Memory)**
 
-### **New to Claude-Flow? Start Here!**
+```bash
+# Store memories with semantic search
+npx claude-flow@alpha memory store api_key "REST API configuration" \
+  --namespace backend --reasoningbank
+
+# Query with semantic search (2-3ms latency)
+npx claude-flow@alpha memory query "API config" \
+  --namespace backend --reasoningbank
+# ✅ Found 3 results (semantic search)
+
+# List all memories
+npx claude-flow@alpha memory list --namespace backend --reasoningbank
+
+# Check status and statistics
+npx claude-flow@alpha memory status --reasoningbank
+# ✅ Total memories: 30
+#    Embeddings: 30
+#    Storage: .swarm/memory.db
+```
 
-Confused about `.hive-mind` and `.swarm` directories? Not sure when to create new hives? Here are the most common workflow patterns:
+### **Features**
+- ✅ **No API Keys Required**: Hash-based embeddings (1024 dimensions)
+- ✅ **Persistent Storage**: SQLite database survives restarts
+- ✅ **Semantic Search**: MMR ranking with similarity scoring
+- ✅ **Namespace Isolation**: Organize memories by domain
+- ✅ **Fast Queries**: 2-3ms average latency
+- ✅ **Process Cleanup**: Automatic database closing
 
-#### **🚀 Pattern 1: Single Feature Development**
+### **Optional: Enhanced Embeddings**
 ```bash
-# Initialize once per feature/task
-npx claude-flow@alpha init --force
-npx claude-flow@alpha hive-mind spawn "Implement user authentication" --claude
-
-# Continue working on SAME feature (reuse existing hive)
-npx claude-flow@alpha hive-mind status
-npx claude-flow@alpha memory query "authentication" --recent
-npx claude-flow@alpha swarm "Add password reset functionality" --continue-session
+# For better semantic accuracy (requires API key)
+export OPENAI_API_KEY=$YOUR_API_KEY
+# Uses text-embedding-3-small (1536 dimensions)
 ```
 
-#### **🏗️ Pattern 2: Multi-Feature Project**
-```bash
-# Project-level initialization (once per project)
-npx claude-flow@alpha init --force --project-name "my-app"
+---
 
-# Feature 1: Authentication (new hive)
-npx claude-flow@alpha hive-mind spawn "auth-system" --namespace auth --claude
+## 🐝 **Swarm Orchestration**
 
-# Feature 2: User management (separate hive)  
-npx claude-flow@alpha hive-mind spawn "user-management" --namespace users --claude
+### **Quick Swarm Commands**
 
-# Resume Feature 1 later (use session ID from spawn output)
-npx claude-flow@alpha hive-mind resume session-xxxxx-xxxxx
+```bash
+# Quick task execution (recommended)
+npx claude-flow@alpha swarm "build REST API with authentication" --claude
+
+# Multi-agent coordination
+npx claude-flow@alpha swarm init --topology mesh --max-agents 5
+npx claude-flow@alpha swarm spawn researcher "analyze API patterns"
+npx claude-flow@alpha swarm spawn coder "implement endpoints"
+npx claude-flow@alpha swarm status
 ```
 
-#### **🔍 Pattern 3: Research & Analysis**
+### **Hive-Mind for Complex Projects**
+
 ```bash
-# Start research session
-npx claude-flow@alpha hive-mind spawn "Research microservices patterns" --agents researcher,analyst --claude
+# Initialize hive-mind system
+npx claude-flow@alpha hive-mind wizard
+npx claude-flow@alpha hive-mind spawn "build enterprise system" --claude
 
-# Continue research in SAME session
-npx claude-flow@alpha memory stats  # See what's been learned
-npx claude-flow@alpha swarm "Deep dive into API gateway patterns" --continue-session
+# Session management
+npx claude-flow@alpha hive-mind status
+npx claude-flow@alpha hive-mind resume session-xxxxx
 ```
 
-### **🤔 When Should I Create a New Hive?**
+**When to Use:**
+| Feature | `swarm` | `hive-mind` |
+|---------|---------|-------------|
+| **Best For** | Quick tasks | Complex projects |
+| **Setup** | Instant | Interactive wizard |
+| **Memory** | Task-scoped | Project-wide SQLite |
+| **Sessions** | Temporary | Persistent + resume |
 
-| Situation | Action | Command |
-|-----------|--------|---------|
-| **Same objective/feature** | Continue existing hive | `npx claude-flow@alpha hive-mind resume <session-id>` |
-| **New feature in same project** | Create new hive with namespace | `npx claude-flow@alpha hive-mind spawn "new-feature" --namespace feature-name` |
-| **Completely different project** | New directory + init | `mkdir new-project && cd new-project && npx claude-flow@alpha init` |
-| **Experimenting/testing** | Temporary hive | `npx claude-flow@alpha hive-mind spawn "experiment" --temp` |
+---
 
-### **📁 Understanding "Empty" Directories**
+## 🔧 **MCP Tools Integration**
 
-**Don't panic if directories seem empty!** Claude-Flow uses SQLite databases that may not show files in directory listings:
+### **Setup MCP Servers**
 
 ```bash
-# Check what's actually stored (even if directories look empty)
-npx claude-flow@alpha memory stats        # See memory data
-npx claude-flow@alpha memory list         # List all namespaces  
-npx claude-flow@alpha hive-mind status    # See active hives
-
-# Your project structure after initialization:
-# .hive-mind/     <- Contains config.json + SQLite session data
-# .swarm/         <- Contains memory.db (SQLite database)
-# memory/         <- Agent-specific memories (created when agents spawn)
-# coordination/   <- Active workflow files (created during tasks)
+# Add Claude Flow MCP server (required)
+claude mcp add claude-flow npx claude-flow@alpha mcp start
+
+# Optional: Enhanced coordination
+claude mcp add ruv-swarm npx ruv-swarm mcp start
+
+# Optional: Cloud features (requires registration)
+claude mcp add flow-nexus npx flow-nexus@latest mcp start
 ```
 
-### **🔄 Continuing Previous Work**
+### **Available MCP Tools (100 Total)**
 
-```bash
-# See what you were working on
-npx claude-flow@alpha hive-mind status
-npx claude-flow@alpha memory query --recent --limit 5
+**Core Tools:**
+- `swarm_init`, `agent_spawn`, `task_orchestrate`
+- `memory_usage`, `memory_search`
+- `neural_status`, `neural_train`, `neural_patterns`
 
-# List all sessions to find the one you want
-npx claude-flow@alpha hive-mind sessions
+**Memory Tools:**
+- `mcp__claude-flow__memory_usage` - Store/retrieve persistent memory
+- `mcp__claude-flow__memory_search` - Pattern-based search
 
-# Resume specific session by ID
-npx claude-flow@alpha hive-mind resume session-xxxxx-xxxxx
-```
+**GitHub Tools:**
+- `github_repo_analyze`, `github_pr_manage`, `github_issue_track`
+
+**Performance Tools:**
+- `benchmark_run`, `performance_report`, `bottleneck_analyze`
+
+📚 **Full Reference**: [MCP Tools Documentation](./docs/MCP-TOOLS.md)
 
 ---
 
 ## 🪝 **Advanced Hooks System**
 
 ### **Automated Workflow Enhancement**
-Claude-Flow v2.0.0 introduces a powerful hooks system that automates coordination and enhances every operation:
+
+Claude-Flow automatically configures hooks for enhanced operations:
 
 ```bash
-# Hooks automatically trigger on operations
-npx claude-flow@alpha init --force  # Auto-configures MCP servers & hooks
+# Auto-configures hooks during init
+npx claude-flow@alpha init --force
 ```
 
 ### **Available Hooks**
 
-#### **Pre-Operation Hooks**
-- **`pre-task`**: Auto-assigns agents based on task complexity
-- **`pre-search`**: Caches searches for improved performance  
-- **`pre-edit`**: Validates files and prepares resources
-- **`pre-command`**: Security validation before execution
-
-#### **Post-Operation Hooks**
-- **`post-edit`**: Auto-formats code using language-specific tools
-- **`post-task`**: Trains neural patterns from successful operations
-- **`post-command`**: Updates memory with operation context
-- **`notification`**: Real-time progress updates
-
-#### **Session Hooks**
-- **`session-start`**: Restores previous context automatically
-- **`session-end`**: Generates summaries and persists state
-- **`session-restore`**: Loads memory from previous sessions
-
-### **Hook Configuration**
-```json
-// .claude/settings.json (auto-configured)
-{
-  "hooks": {
-    "preEditHook": {
-      "command": "npx",
-      "args": ["claude-flow", "hooks", "pre-edit", "--file", "${file}", "--auto-assign-agents", "true"],
-      "alwaysRun": false
-    },
-    "postEditHook": {
-      "command": "npx", 
-      "args": ["claude-flow", "hooks", "post-edit", "--file", "${file}", "--format", "true"],
-      "alwaysRun": true
-    },
-    "sessionEndHook": {
-      "command": "npx",
-      "args": ["claude-flow", "hooks", "session-end", "--generate-summary", "true"],
-      "alwaysRun": true
-    }
-  }
-}
+**Pre-Operation:**
+- `pre-task`: Auto-assigns agents by complexity
+- `pre-edit`: Validates files and prepares resources
+- `pre-command`: Security validation
+
+**Post-Operation:**
+- `post-edit`: Auto-formats code
+- `post-task`: Trains neural patterns
+- `post-command`: Updates memory
+
+**Session Management:**
+- `session-start`: Restores previous context
+- `session-end`: Generates summaries
+- `session-restore`: Loads memory
+
+---
+
+## 🎯 **Common Workflows**
+
+### **Pattern 1: Single Feature Development**
+```bash
+# Initialize once per feature
+npx claude-flow@alpha init --force
+npx claude-flow@alpha hive-mind spawn "Implement authentication" --claude
+
+# Continue same feature (reuse hive)
+npx claude-flow@alpha memory query "auth" --recent
+npx claude-flow@alpha swarm "Add password reset" --continue-session
+```
+
+### **Pattern 2: Multi-Feature Project**
+```bash
+# Project initialization
+npx claude-flow@alpha init --force --project-name "my-app"
+
+# Feature 1: Authentication
+npx claude-flow@alpha hive-mind spawn "auth-system" --namespace auth --claude
+
+# Feature 2: User management
+npx claude-flow@alpha hive-mind spawn "user-mgmt" --namespace users --claude
+```
+
+### **Pattern 3: Research & Analysis**
+```bash
+# Start research session
+npx claude-flow@alpha hive-mind spawn "Research microservices" \
+  --agents researcher,analyst --claude
+
+# Check learned knowledge
+npx claude-flow@alpha memory stats
+npx claude-flow@alpha memory query "microservices patterns" --reasoningbank
 ```
 
 ---
 
-## 📚 **Complete Documentation**
+## 📊 **Performance & Stats**
+
+- **84.8% SWE-Bench solve rate** - Industry-leading problem-solving
+- **32.3% token reduction** - Efficient context management
+- **2.8-4.4x speed improvement** - Parallel coordination
+- **2-3ms query latency** - ReasoningBank semantic search
+- **64 specialized agents** - Complete development ecosystem
+- **100 MCP tools** - Comprehensive automation toolkit
+
+---
 
-For detailed information about all features, advanced usage, and comprehensive guides, visit our **[GitHub Wiki](https://github.com/ruvnet/claude-flow/wiki)**:
+## 📚 **Documentation**
 
-### 🤖 **Core Features**
-- **[Neural Module](https://github.com/ruvnet/claude-flow/wiki/Neural-Module)** - SAFLA self-learning systems with 4-tier memory architecture
-- **[Goal Module](https://github.com/ruvnet/claude-flow/wiki/Goal-Module)** - GOAP intelligent planning with A* pathfinding
-- **[Agent System Overview](https://github.com/ruvnet/claude-flow/wiki/Agent-System-Overview)** - Complete catalog of all 64 agents
-- **[Hive-Mind Intelligence](https://github.com/ruvnet/claude-flow/wiki/Hive-Mind-Intelligence)** - Queen-led AI coordination patterns
+### **Core Documentation**
+- **[Installation Guide](./docs/INSTALLATION.md)** - Setup instructions
+- **[Memory System Guide](./docs/MEMORY-SYSTEM.md)** - ReasoningBank usage
+- **[MCP Tools Reference](./docs/MCP-TOOLS.md)** - Complete tool catalog
+- **[Agent System](./docs/AGENT-SYSTEM.md)** - All 64 agents
 
-### ⚡ **Advanced Topics**
-- **[Memory System](https://github.com/ruvnet/claude-flow/wiki/Memory-System)** - SQLite-based persistent memory
-- **[MCP Tools Reference](https://github.com/ruvnet/claude-flow/wiki/MCP-Tools)** - Complete guide to all 87 tools
-- **[GitHub Integration](https://github.com/ruvnet/claude-flow/wiki/GitHub-Integration)** - Repository management automation
-- **[Performance Benchmarking](https://github.com/ruvnet/claude-flow/wiki/Performance-Benchmarking)** - Optimization strategies
+### **Release Notes**
+- **[v2.7.0-alpha.10](./docs/RELEASE-NOTES-v2.7.0-alpha.10.md)** - Semantic search fix
+- **[v2.7.0-alpha.9](./docs/RELEASE-NOTES-v2.7.0-alpha.9.md)** - Process cleanup
+- **[Changelog](./CHANGELOG.md)** - Full version history
 
-### 📋 **Configuration & Templates**
-- **[CLAUDE.md Templates](https://github.com/ruvnet/claude-flow/wiki/CLAUDE-MD-Templates)** - Project-specific configurations
-- **[SPARC Methodology](https://github.com/ruvnet/claude-flow/wiki/SPARC-Methodology)** - Test-driven development patterns
-- **[Development Patterns](https://github.com/ruvnet/claude-flow/wiki/Development-Patterns)** - Best practices
+### **Advanced Topics**
+- **[Neural Module](./docs/NEURAL-MODULE.md)** - SAFLA self-learning
+- **[Goal Module](./docs/GOAL-MODULE.md)** - GOAP intelligent planning
+- **[Hive-Mind Intelligence](./docs/HIVE-MIND.md)** - Queen-led coordination
+- **[GitHub Integration](./docs/GITHUB-INTEGRATION.md)** - Repository automation
 
-### 🛠️ **Setup & Troubleshooting**
-- **[Installation Guide](https://github.com/ruvnet/claude-flow/wiki/Installation-Guide)** - Detailed setup instructions
-- **[Windows Installation](https://github.com/ruvnet/claude-flow/wiki/Windows-Installation)** - Windows-specific setup
-- **[Troubleshooting](https://github.com/ruvnet/claude-flow/wiki/Troubleshooting)** - Common issues and solutions
-- **[Non-Interactive Mode](https://github.com/ruvnet/claude-flow/wiki/Non-Interactive-Mode)** - CI/CD automation
+### **Configuration**
+- **[CLAUDE.md Templates](./docs/CLAUDE-MD-TEMPLATES.md)** - Project configs
+- **[SPARC Methodology](./docs/SPARC.md)** - TDD patterns
+- **[Windows Installation](./docs/windows-installation.md)** - Windows setup
 
 ---
 
@@ -315,25 +314,30 @@ For detailed information about all features, advanced usage, and comprehensive g
 
 - **GitHub Issues**: [Report bugs or request features](https://github.com/ruvnet/claude-flow/issues)
 - **Discord**: [Join the Agentics Foundation community](https://discord.com/invite/dfxmpwkG2D)
-- **Wiki**: [Comprehensive documentation](https://github.com/ruvnet/claude-flow/wiki)
+- **Documentation**: [Complete guides and tutorials](https://github.com/ruvnet/claude-flow/wiki)
 - **Examples**: [Real-world usage patterns](https://github.com/ruvnet/claude-flow/tree/main/examples)
 
 ---
 
-## 📊 **Performance & Stats**
+## 🚀 **Roadmap & Targets**
 
-- **84.8% SWE-Bench solve rate** - Industry-leading problem-solving capability
-- **32.3% token reduction** - Efficient context management
-- **2.8-4.4x speed improvement** - Parallel coordination strategies
-- **64 specialized agents** - Complete development ecosystem
-- **87 MCP tools** - Comprehensive automation toolkit
+### **Immediate (Q4 2025)**
+- ✅ Semantic search fix (v2.7.0-alpha.10)
+- ✅ ReasoningBank Node.js backend
+- 🔄 Enhanced embedding models
+- 🔄 Multi-user collaboration features
 
----
+### **Q1 2026**
+- Advanced neural pattern recognition
+- Cloud swarm coordination
+- Real-time agent communication
+- Enterprise SSO integration
 
-### 📊 Targets (Month 12)
+### **Growth Targets**
 - 5K+ GitHub stars, 50K npm downloads/month
 - $25K MRR, 15 enterprise customers
-- 90%+ error prevention, 30+ min saved/dev/week
+- 90%+ error prevention
+- 30+ minutes saved per developer per week
 
 ---
 
@@ -349,8 +353,14 @@ For detailed information about all features, advanced usage, and comprehensive g
 
 ---
 
+## 📄 **License**
+
+MIT License - see [LICENSE](./LICENSE) for details
+
+---
+
 **Built with ❤️ by [rUv](https://github.com/ruvnet) | Powered by Revolutionary AI**
 
-*v2.5.0-alpha.140 - The Future of AI Orchestration with PreToolUse Modification Hooks*
+*v2.7.0-alpha.10 - Semantic Search Fixed + ReasoningBank Node.js Backend*
 
-</div>
+</div>

package/bin/claude-flow

@@ -1,7 +1,7 @@
 #!/bin/sh
 # Claude-Flow Smart Dispatcher - Detects and uses the best available runtime
 
-VERSION="2.7.0-alpha.1"
+VERSION="2.7.0-alpha.11"
 
 # Determine the correct path based on how the script is invoked
 if [ -L "$0" ]; then
@@ -48,16 +48,16 @@ for arg in "$@"; do
   fi
 done
 
-# Use Node.js with TypeScript support
+# Use Node.js with TypeScript support and WASM modules enabled
 if [ -f "$ROOT_DIR/src/cli/simple-cli.js" ]; then
-  # Use node for JavaScript version
-  exec node "$ROOT_DIR/src/cli/simple-cli.js" "$@"
+  # Use node for JavaScript version with WASM support
+  exec node --experimental-wasm-modules "$ROOT_DIR/src/cli/simple-cli.js" "$@"
 elif command -v tsx >/dev/null 2>&1 && [ -f "$ROOT_DIR/src/cli/simple-cli.ts" ]; then
-  # Use tsx for TypeScript functionality
-  exec tsx "$ROOT_DIR/src/cli/simple-cli.ts" "$@"
+  # Use tsx for TypeScript functionality with WASM support
+  exec tsx --experimental-wasm-modules "$ROOT_DIR/src/cli/simple-cli.ts" "$@"
 elif [ -f "$ROOT_DIR/src/cli/simple-cli.ts" ]; then
-  # Try to use npx tsx as fallback
-  exec npx tsx "$ROOT_DIR/src/cli/simple-cli.ts" "$@"
+  # Try to use npx tsx as fallback with WASM support
+  exec npx tsx --experimental-wasm-modules "$ROOT_DIR/src/cli/simple-cli.ts" "$@"
 else
   # No runtime available, show help
   echo "🧠 Claude-Flow v$VERSION - Advanced AI Agent Orchestration System"