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

rUvefbc121a2b2c
diff --git a/package-lock.json b/package-lock.json
index 10f59626f3..4e7f25486c 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "claude-flow-v3",
- "version": "3.0.0-alpha.42",
+ "version": "3.0.0-alpha.43",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "claude-flow-v3",
- "version": "3.0.0-alpha.42",
+ "version": "3.0.0-alpha.43",
"license": "MIT",
"dependencies": {
"agentdb": "alpha",
diff --git a/package.json b/package.json
index d7ea41bb87..209c19cf21 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "claude-flow",
- "version": "3.0.0-alpha.42",
+ "version": "3.0.0-alpha.43",
"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
deleted file mode 100644
index c0872ed5b1..0000000000
--- a/v3/@claude-flow/cli/README.md
+++ /dev/null
@@ -1,1713 +0,0 @@
-# @claude-flow/cli
-
-[![npm version](https://img.shields.io/npm/v/@claude-flow/cli.svg)](https://www.npmjs.com/package/@claude-flow/cli)
-[![npm downloads](https://img.shields.io/npm/dm/@claude-flow/cli.svg)](https://www.npmjs.com/package/@claude-flow/cli)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
-[![Node.js](https://img.shields.io/badge/Node.js-20+-green.svg)](https://nodejs.org/)
-[![Commands](https://img.shields.io/badge/Commands-29-orange.svg)](https://github.com/ruvnet/claude-flow)
-[![Subcommands](https://img.shields.io/badge/Subcommands-170+-purple.svg)](https://github.com/ruvnet/claude-flow)
-
-> Modern CLI module for Claude Flow V3 - comprehensive command-line interface with 29 commands, 170+ subcommands, interactive prompts, self-learning hooks, background workers, hive-mind coordination, Q-Learning agent routing, code analysis, collaborative issue claims, smart error suggestions, and beautiful output formatting.
-
-## Features
-
-### Core Capabilities
-- **29 Main Commands** - Complete CLI coverage for all Claude Flow operations
-- **170+ Subcommands** - Fine-grained control over every aspect of the system
-- **Advanced Argument Parsing** - Full support for flags, options, subcommands, and positional arguments
-- **Interactive Prompts** - Rich interactive mode with confirmations, selections, and input validation
-- **Beautiful Output** - Colored output, tables, progress bars, spinners, and multiple formats (text, JSON, table)
-- **Smart Error Suggestions** - Levenshtein distance-based typo detection with helpful corrections
-
-### V3-Specific Features
-- **Self-Learning Hooks** - 17 hook subcommands + 12 background workers with pattern learning and neural integration
-- **Hive-Mind Coordination** - Queen-led Byzantine fault-tolerant multi-agent consensus
-- **15-Agent Swarm** - V3 hierarchical mesh coordination with domain specialization
-- **AgentDB Integration** - 150x-12,500x faster vector search with HNSW indexing
-- **SONA Learning** - Sub-0.05ms adaptation with Mixture of Experts routing
-- **Q-Learning Routing** - Intelligent task-to-agent routing with reinforcement learning
-- **Code Analysis** - AST analysis, diff classification, complexity metrics, boundary detection
-- **Issue Claims (ADR-016)** - Collaborative human-agent issue management with work stealing
-
-### Developer Experience
-- **Type-Safe** - Full TypeScript support with comprehensive type definitions
-- **Global Options** - Built-in `--help`, `--version`, `--verbose`, `--quiet`, `--format`
-- **Shell Completions** - Full tab completion for bash, zsh, fish, and PowerShell
-- **Doctor Command** - System diagnostics with health checks and suggested fixes
-- **Migration Tools** - Built-in V2 to V3 migration with rollback support
-
-## Installation
-
-```bash
-npm install @claude-flow/cli
-```
-
-Or use globally:
-
-```bash
-npm install -g @claude-flow/cli
-claude-flow --version
-```
-
-## Quick Start
-
-```bash
-# Initialize a new project
-claude-flow init --wizard
-
-# Start MCP server
-claude-flow mcp start
-
-# Spawn an agent
-claude-flow agent spawn -t coder --name my-coder
-
-# Initialize a swarm
-claude-flow swarm init --v3-mode
-
-# Search memory
-claude-flow memory search -q "authentication patterns"
-
-# Route task to optimal agent (Q-Learning)
-claude-flow route task "Implement OAuth2 authentication"
-
-# Analyze code complexity
-claude-flow analyze complexity ./src
-
-# Claim an issue
-claude-flow issues claim ISSUE-123
-
-# Check system status
-claude-flow status --watch
-```
-
-## Complete Command Reference
-
-### Overview
-
-| Command | Subcommands | Description |
-|---------|-------------|-------------|
-| `init` | 4 | Project initialization with wizard, presets, and configuration |
-| `agent` | 8 | Agent lifecycle management (spawn, list, status, stop, metrics, pool, health, logs) |
-| `swarm` | 6 | Multi-agent swarm coordination and orchestration |
-| `memory` | 11 | AgentDB memory operations with vector search |
-| `mcp` | 9 | MCP server management and tool execution |
-| `task` | 6 | Task creation, assignment, and lifecycle management |
-| `session` | 7 | Session state management and persistence |
-| `config` | 7 | Configuration management and provider setup |
-| `status` | 3 | System status monitoring with watch mode |
-| `start` | 3 | Service startup and quick launch |
-| `workflow` | 6 | Workflow execution and template management |
-| `hooks` | 17 | Self-learning hooks with neural pattern recognition + 12 background workers |
-| `hive-mind` | 6 | Queen-led consensus-based multi-agent coordination |
-| `migrate` | 5 | V2 to V3 migration with rollback support |
-| `process` | 4 | Background process management and monitoring |
-| `daemon` | 5 | Node.js worker daemon (start, stop, status, trigger, enable) |
-| `neural` | 5 | Neural pattern training (train, status, patterns, predict, optimize) |
-| `security` | 6 | Security scanning (scan, audit, cve, threats, validate, report) |
-| `performance` | 5 | Performance profiling (benchmark, profile, metrics, optimize, report) |
-| `providers` | 5 | AI providers (list, add, remove, test, configure) |
-| `plugins` | 5 | Plugin management (list, install, uninstall, enable, disable) |
-| `deployment` | 5 | Deployment management (deploy, rollback, status, environments, release) |
-| `embeddings` | 13 | Vector embeddings with ONNX models, hyperbolic space, and neural substrate |
-| `claims` | 4 | Claims-based authorization (check, grant, revoke, list) |
-| `issues` | 10 | Collaborative issue claims with work stealing (ADR-016) |
-| `route` | 7 | Q-Learning agent routing with reinforcement learning |
-| `analyze` | 11 | Code analysis (AST, diff, complexity, boundaries, dependencies) |
-| `doctor` | 1 | System diagnostics with health checks and suggested fixes |
-| `completions` | 4 | Shell completions for bash, zsh, fish, and PowerShell |
-
----
-
-### `init` - Project Initialization
-
-Initialize Claude Flow V3 with interactive wizard or presets.
-
-```bash
-claude-flow init [subcommand] [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `wizard` | Interactive setup wizard with step-by-step configuration |
-| `check` | Validate current configuration and environment |
-| `skills` | List and manage available skills |
-| `hooks` | Configure and validate hooks integration |
-
-#### Options
-
-| Option | Short | Description | Default |
-|--------|-------|-------------|---------|
-| `--preset` | `-p` | Configuration preset (minimal, default, full, custom) | `default` |
-| `--force` | `-f` | Overwrite existing configuration | `false` |
-| `--skip-deps` | | Skip dependency installation | `false` |
-| `--topology` | `-t` | Swarm topology (hierarchical, mesh, hybrid) | `hierarchical` |
-| `--max-agents` | `-m` | Maximum concurrent agents | `15` |
-| `--memory-backend` | | Memory backend (agentdb, sqlite, hybrid) | `hybrid` |
-| `--enable-hnsw` | | Enable HNSW indexing (150x faster) | `true` |
-| `--enable-neural` | | Enable SONA neural learning | `true` |
-
-#### Examples
-
-```bash
-# Interactive wizard
-claude-flow init --wizard
-
-# Quick setup with defaults
-claude-flow init --preset default
-
-# Full V3 setup with all features
-claude-flow init --preset full --enable-hnsw --enable-neural
-
-# Validate configuration
-claude-flow init check
-```
-
----
-
-### `agent` - Agent Management
-
-Spawn, manage, and monitor AI agents with various specializations.
-
-```bash
-claude-flow agent <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Aliases | Description |
-|------------|---------|-------------|
-| `spawn` | | Spawn a new agent with specified type and configuration |
-| `list` | `ls` | List all active agents with filtering options |
-| `status` | | Show detailed status and metrics for an agent |
-| `stop` | `kill` | Stop a running agent (graceful or forced) |
-| `metrics` | | Show agent performance metrics over time |
-| `pool` | | Manage agent pool for auto-scaling |
-| `health` | | Show agent health and resource metrics |
-| `logs` | | View agent activity logs with filtering |
-
-#### Agent Types
-
-| Type | Description | Capabilities |
-|------|-------------|--------------|
-| `coder` | Code development with neural patterns | code-generation, refactoring, debugging, testing |
-| `researcher` | Research with web access and data analysis | web-search, data-analysis, summarization, citation |
-| `tester` | Comprehensive testing with automation | unit-testing, integration-testing, coverage-analysis |
-| `reviewer` | Code review with security and quality checks | code-review, security-audit, quality-check |
-| `architect` | System design with enterprise patterns | system-design, pattern-analysis, scalability |
-| `coordinator` | Multi-agent orchestration and workflow | task-orchestration, agent-management, workflow-control |
-| `security-architect` | Security architecture and threat modeling | threat-modeling, security-patterns, compliance |
-| `security-auditor` | CVE remediation and security testing | vulnerability-scan, penetration-testing |
-| `memory-specialist` | AgentDB unification (150x-12,500x faster) | vector-search, agentdb, caching, optimization |
-| `performance-engineer` | 2.49x-7.47x optimization targets | benchmarking, profiling, optimization |
-
-#### Spawn Options
-
-| Option | Short | Description | Default |
-|--------|-------|-------------|---------|
-| `--type` | `-t` | Agent type to spawn | required |
-| `--name` | `-n` | Agent name/identifier | auto-generated |
-| `--provider` | `-p` | LLM provider (anthropic, openrouter, ollama) | `anthropic` |
-| `--model` | `-m` | Model to use | provider default |
-| `--task` | | Initial task for the agent | none |
-| `--timeout` | | Agent timeout in seconds | `300` |
-| `--auto-tools` | | Enable automatic tool usage | `true` |
-
-#### Examples
-
-```bash
-# Spawn a coder agent
-claude-flow agent spawn -t coder --name my-coder
-
-# Spawn researcher with initial task
-claude-flow agent spawn -t researcher --task "Research React 19 features"
-
-# List all active agents
-claude-flow agent list
-
-# List agents by type
-claude-flow agent list -t coder
-
-# Get detailed agent status
-claude-flow agent status agent-001
-
-# Show agent metrics for 24 hours
-claude-flow agent metrics -p 24h
-
-# View agent logs
-claude-flow agent logs -i agent-001 -f
-
-# Configure agent pool
-claude-flow agent pool --size 5 --min 2 --max 15 --auto-scale
-
-# Health check with detailed metrics
-claude-flow agent health -d
-
-# Stop agent gracefully
-claude-flow agent stop agent-001
-
-# Force stop
-claude-flow agent stop agent-001 -f
-```
-
----
-
-### `swarm` - Swarm Coordination
-
-Multi-agent swarm initialization, coordination, and management.
-
-```bash
-claude-flow swarm <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `init` | Initialize a new swarm with specified topology |
-| `start` | Start swarm execution with objective and strategy |
-| `status` | Show swarm status, progress, and metrics |
-| `stop` | Stop swarm execution (with state save option) |
-| `scale` | Scale swarm agent count up or down |
-| `coordinate` | Execute V3 15-agent hierarchical mesh coordination |
-
-#### Topologies
-
-| Topology | Description | Best For |
-|----------|-------------|----------|
-| `hierarchical` | Queen-led coordination with worker agents | Structured tasks, clear authority |
-| `mesh` | Fully connected peer-to-peer network | Collaborative work, redundancy |
-| `ring` | Circular communication pattern | Sequential processing |
-| `star` | Central coordinator with spoke agents | Centralized control |
-| `hybrid` | Hierarchical mesh for maximum flexibility | Complex multi-domain tasks |
-
-#### Strategies
-
-| Strategy | Description | Agent Distribution |
-|----------|-------------|-------------------|
-| `research` | Distributed research and analysis | 1 coordinator, 4 researchers, 2 analysts |
-| `development` | Collaborative code development | 1 coordinator, 1 architect, 3 coders, 2 testers, 1 reviewer |
-| `testing` | Comprehensive test coverage | 1 test lead, 2 unit testers, 2 integration testers, 1 QA |
-| `optimization` | Performance optimization | 1 performance lead, 2 profilers, 2 optimizers |
-| `maintenance` | Codebase maintenance and refactoring | 1 coordinator, 2 refactorers, 1 documenter |
-| `analysis` | Code analysis and documentation | 1 analyst lead, 2 code analysts, 1 security analyst |
-
-#### Examples
-
-```bash
-# Initialize V3 swarm (recommended)
-claude-flow swarm init --v3-mode
-
-# Initialize with specific topology
-claude-flow swarm init -t mesh --max-agents 10
-
-# Start development swarm
-claude-flow swarm start -o "Build REST API with authentication" -s development
-
-# Parallel analysis swarm
-claude-flow swarm start -o "Analyze codebase for performance issues" --parallel
-
-# Check swarm status
-claude-flow swarm status swarm-123
-
-# Scale swarm
-claude-flow swarm scale swarm-123 --agents 20
-
-# V3 15-agent coordination
-claude-flow swarm coordinate --agents 15
-
-# Stop with state save
-claude-flow swarm stop swarm-123 --save-state
-```
-
----
-
-### `memory` - Memory Management
-
-AgentDB memory operations with vector search, caching, and optimization.
-
-```bash
-claude-flow memory <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Aliases | Description |
-|------------|---------|-------------|
-| `store` | | Store data in memory with optional vector embedding |
-| `retrieve` | `get` | Retrieve data from memory by key |
-| `search` | | Semantic/vector search with HNSW indexing |
-| `list` | `ls` | List memory entries with filtering |
-| `delete` | `rm` | Delete memory entry |
-| `stats` | | Show memory statistics and performance |
-| `configure` | `config` | Configure memory backend and HNSW parameters |
-| `cleanup` | | Clean up stale and expired entries |
-| `compress` | | Compress and optimize memory storage |
-| `export` | | Export memory to file (JSON, CSV, binary) |
-| `import` | | Import memory from file |
-
-#### Memory Backends
-
-| Backend | Description | Performance |
-|---------|-------------|-------------|
-| `agentdb` | Vector database with HNSW indexing | 150x-12,500x faster search |
-| `sqlite` | Lightweight local storage | Good for small datasets |
-| `hybrid` | SQLite + AgentDB (recommended) | Best of both worlds |
-| `memory` | In-memory (non-persistent) | Fastest, no persistence |
-
-#### Search Options
-
-| Option | Short | Description | Default |
-|--------|-------|-------------|---------|
-| `--query` | `-q` | Search query | required |
-| `--namespace` | `-n` | Memory namespace | all |
-| `--limit` | `-l` | Maximum results | `10` |
-| `--threshold` | | Similarity threshold (0-1) | `0.7` |
-| `--type` | `-t` | Search type (semantic, keyword, hybrid) | `semantic` |
-
-#### Examples
-
-```bash
-# Store text data
-claude-flow memory store -k "api/auth" -v "JWT implementation with refresh tokens"
-
-# Store as vector embedding
-claude-flow memory store -k "pattern/singleton" -v "Singleton pattern description" --vector
-
-# Semantic search
-claude-flow memory search -q "authentication patterns"
-
-# Keyword search
-claude-flow memory search -q "JWT" -t keyword
-
-# Hybrid search with threshold
-claude-flow memory search -q "security best practices" -t hybrid --threshold 0.8
-
-# List entries by namespace
-claude-flow memory list -n patterns
-
-# Show memory statistics
-claude-flow memory stats
-
-# Configure HNSW parameters
-claude-flow memory configure -b hybrid --hnsw-m 16 --hnsw-ef 200
-
-# Cleanup old entries
-claude-flow memory cleanup --older-than 30d
-
-# Cleanup expired TTL entries
-claude-flow memory cleanup --expired-only
-
-# Compress with quantization (32x memory reduction)
-claude-flow memory compress --quantize --bits 4
-
-# Export memory
-claude-flow memory export -o ./backup.json -f json
-
-# Import memory
-claude-flow memory import -i ./backup.json --merge
-```
-
----
-
-### `mcp` - MCP Server Management
-
-Model Context Protocol server control and tool execution.
-
-```bash
-claude-flow mcp <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `start` | Start MCP server with specified transport |
-| `stop` | Stop MCP server (graceful or forced) |
-| `status` | Show MCP server status and metrics |
-| `health` | Check MCP server health |
-| `restart` | Restart MCP server |
-| `tools` | List available MCP tools by category |
-| `toggle` | Enable or disable specific tools |
-| `exec` | Execute an MCP tool directly |
-| `logs` | Show MCP server logs |
-
-#### Transport Types
-
-| Transport | Description | Use Case |
-|-----------|-------------|----------|
-| `stdio` | Standard I/O (default) | Claude Code integration |
-| `http` | HTTP REST API | Web integrations, remote access |
-| `websocket` | WebSocket connection | Real-time bidirectional |
-
-#### Tool Categories
-
-| Category | Description | Tool Count |
-|----------|-------------|------------|
-| `agent` | Agent lifecycle management | 4 |
-| `swarm` | Swarm coordination | 3 |
-| `memory` | Memory operations | 3 |
-| `config` | Configuration | 3 |
-| `hooks` | Hook execution | 9 |
-| `system` | System operations | 3 |
-
-#### Examples
-
-```bash
-# Start with stdio (default)
-claude-flow mcp start
-
-# Start HTTP server on port 8080
-claude-flow mcp start -t http -p 8080
-
-# Start as background daemon
-claude-flow mcp start -d
-
-# Check server status
-claude-flow mcp status
-
-# Health check
-claude-flow mcp health
-
-# List all tools
-claude-flow mcp tools
-
-# List tools by category
-claude-flow mcp tools -c memory
-
-# Execute a tool
-claude-flow mcp exec -t swarm/init -p '{"topology":"mesh"}'
-
-# View logs
-claude-flow mcp logs -n 50 -f
-
-# Restart server
-claude-flow mcp restart
-
-# Stop server
-claude-flow mcp stop
-```
-
----
-
-### `task` - Task Management
-
-Create, assign, and manage tasks across agents.
-
-```bash
-claude-flow task <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `create` | Create a new task with priority and dependencies |
-| `list` | List tasks with status filtering |
-| `status` | Show detailed task status |
-| `cancel` | Cancel a pending or running task |
-| `assign` | Assign task to specific agent |
-| `retry` | Retry a failed task |
-
-#### Examples
-
-```bash
-# Create a task
-claude-flow task create "Implement user authentication" -p high
-
-# Create task with dependencies
-claude-flow task create "Write tests" --depends-on task-001
-
-# List all tasks
-claude-flow task list
-
-# List pending tasks
-claude-flow task list -s pending
-
-# Get task status
-claude-flow task status task-001
-
-# Assign to agent
-claude-flow task assign task-001 --agent coder-001
-
-# Cancel task
-claude-flow task cancel task-001
-
-# Retry failed task
-claude-flow task retry task-001
-```
-
----
-
-### `session` - Session Management
-
-Manage session state, persistence, and restoration.
-
-```bash
-claude-flow session <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `list` | List all sessions |
-| `save` | Save current session state |
-| `restore` | Restore a previous session |
-| `delete` | Delete a session |
-| `export` | Export session to file |
-| `import` | Import session from file |
-| `current` | Show current session info |
-
-#### Examples
-
-```bash
-# List all sessions
-claude-flow session list
-
-# Save current session
-claude-flow session save --name "feature-auth"
-
-# Restore session
-claude-flow session restore session-123
-
-# Export session
-claude-flow session export -o ./session-backup.json
-
-# Import session
-claude-flow session import -i ./session-backup.json
-
-# Show current session
-claude-flow session current
-
-# Delete old session
-claude-flow session delete session-123
-```
-
----
-
-### `config` - Configuration Management
-
-Manage configuration, providers, and settings.
-
-```bash
-claude-flow config <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `init` | Initialize configuration file |
-| `get` | Get configuration value |
-| `set` | Set configuration value |
-| `providers` | Manage LLM provider configurations |
-| `reset` | Reset configuration to defaults |
-| `export` | Export configuration |
-| `import` | Import configuration |
-
-#### Examples
-
-```bash
-# Initialize config
-claude-flow config init
-
-# Get a value
-claude-flow config get memory.backend
-
-# Set a value
-claude-flow config set swarm.topology mesh
-
-# Configure providers
-claude-flow config providers --add anthropic --api-key $ANTHROPIC_API_KEY
-
-# Reset to defaults
-claude-flow config reset --confirm
-
-# Export config
-claude-flow config export -o ./config-backup.json
-
-# Import config
-claude-flow config import -i ./config.json
-```
-
----
-
-### `status` - System Status
-
-Monitor system status with real-time updates.
-
-```bash
-claude-flow status [subcommand] [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `agents` | Show status of all agents |
-| `tasks` | Show status of all tasks |
-| `memory` | Show memory system status |
-
-#### Options
-
-| Option | Short | Description | Default |
-|--------|-------|-------------|---------|
-| `--watch` | `-w` | Watch mode with auto-refresh | `false` |
-| `--interval` | `-i` | Refresh interval in seconds | `5` |
-
-#### Examples
-
-```bash
-# Show all status
-claude-flow status
-
-# Watch mode with 2s refresh
-claude-flow status --watch -i 2
-
-# Agent status only
-claude-flow status agents
-
-# Task status
-claude-flow status tasks
-
-# Memory status
-claude-flow status memory
-```
-
----
-
-### `workflow` - Workflow Management
-
-Execute and manage automated workflows.
-
-```bash
-claude-flow workflow <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `run` | Execute a workflow |
-| `validate` | Validate workflow definition |
-| `list` | List available workflows |
-| `status` | Show workflow execution status |
-| `stop` | Stop running workflow |
-| `template` | Manage workflow templates (list, show, create) |
-
-#### Examples
-
-```bash
-# Run a workflow
-claude-flow workflow run ./workflows/deploy.yaml
-
-# Validate workflow
-claude-flow workflow validate ./workflows/deploy.yaml
-
-# List workflows
-claude-flow workflow list
-
-# Check workflow status
-claude-flow workflow status workflow-123
-
-# Stop workflow
-claude-flow workflow stop workflow-123
-
-# List templates
-claude-flow workflow template list
-
-# Create from template
-claude-flow workflow template create --from deploy-standard
-```
-
----
-
-### `hooks` - Self-Learning Hooks
-
-Advanced self-learning hooks with 17 subcommands for neural pattern recognition and background worker management.
-
-```bash
-claude-flow hooks <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `pre-edit` | Execute before file edit (get context, agent suggestions) |
-| `post-edit` | Execute after file edit (record outcome for learning) |
-| `pre-command` | Execute before command (risk assessment) |
-| `post-command` | Execute after command (record outcome) |
-| `pre-task` | Execute before task (setup, validation) |
-| `post-task` | Execute after task (cleanup, learning) |
-| `session-end` | Execute on session end (save state) |
-| `session-restore` | Execute on session restore (load state) |
-| `route` | Route task to optimal agent using learned patterns |
-| `explain` | Explain routing decision with transparency |
-| `pretrain` | Bootstrap intelligence from repository |
-| `build-agents` | Generate optimized agent configs from pretrain data |
-| `metrics` | View learning metrics dashboard |
-| `transfer` | Transfer patterns from another project |
-| `list` | List all registered hooks |
-| `intelligence` | RuVector intelligence (SONA, MoE, HNSW) |
-| `worker` | Background worker management (12 workers) |
-
-#### Learning Pipeline
-
-The hooks system implements a 4-step learning pipeline:
-
-1. **RETRIEVE** - Top-k memory injection with MMR diversity
-2. **JUDGE** - LLM-as-judge trajectory evaluation
-3. **DISTILL** - Extract strategy memories from trajectories
-4. **CONSOLIDATE** - Dedup, detect contradictions, prune old patterns
-
-#### Examples
-
-```bash
-# Pre-edit hook (get context and suggestions)
-claude-flow hooks pre-edit ./src/auth/login.ts
-
-# Post-edit hook (record success for learning)
-claude-flow hooks post-edit ./src/auth/login.ts --success true
-
-# Pre-command risk assessment
-claude-flow hooks pre-command "rm -rf ./node_modules"
-
-# Route task to optimal agent
-claude-flow hooks route "Implement OAuth2 authentication"
-
-# Explain routing decision
-claude-flow hooks explain "Implement OAuth2 authentication"
-
-# Bootstrap from repository
-claude-flow hooks pretrain
-
-# Build optimized agent configs
-claude-flow hooks build-agents --focus "security"
-
-# View learning metrics
-claude-flow hooks metrics
-
-# Transfer patterns from another project
-claude-flow hooks transfer ../other-project
-
-# View intelligence status (SONA, MoE, HNSW)
-claude-flow hooks intelligence
-```
-
-#### Worker Subcommands
-
-The `hooks worker` command manages 12 background workers for analysis and optimization tasks.
-
-| Worker | Priority | Est. Time | Description |
-|--------|----------|-----------|-------------|
-| `ultralearn` | normal | 60s | Deep knowledge acquisition and learning |
-| `optimize` | high | 30s | Performance optimization and tuning |
-| `consolidate` | low | 20s | Memory consolidation and cleanup |
-| `predict` | normal | 15s | Predictive preloading and anticipation |
-| `audit` | critical | 45s | Security analysis and vulnerability scanning |
-| `map` | normal | 30s | Codebase mapping and architecture analysis |
-| `preload` | low | 10s | Resource preloading and cache warming |
-| `deepdive` | normal | 60s | Deep code analysis and examination |
-| `document` | normal | 45s | Auto-documentation generation |
-| `refactor` | normal | 30s | Code refactoring suggestions |
-| `benchmark` | normal | 60s | Performance benchmarking |
-| `testgaps` | normal | 30s | Test coverage analysis |
-
-##### Worker Commands
-
-```bash
-# List all available workers
-claude-flow hooks worker list
-
-# Detect triggers from prompt text
-claude-flow hooks worker detect --prompt "optimize performance"
-
-# Auto-dispatch workers when triggers match (min confidence 0.6)
-claude-flow hooks worker detect --prompt "deep dive into auth" --auto-dispatch --min-confidence 0.6
-
-# Manually dispatch a worker
-claude-flow hooks worker dispatch --trigger refactor --context "auth module"
-
-# Check worker status
-claude-flow hooks worker status
-
-# Cancel a running worker
-claude-flow hooks worker cancel --id worker_refactor_1_abc123
-```
-
-##### Performance Targets
-
-| Metric | Target |
-|--------|--------|
-| Trigger detection | <5ms |
-| Worker spawn | <50ms |
-| Max concurrent | 10 |
-
-##### UserPromptSubmit Integration
-
-Workers are automatically triggered via the `UserPromptSubmit` hook when prompt patterns match worker triggers with confidence β‰₯0.6.
-
----
-
-### `hive-mind` - Consensus Coordination
-
-Queen-led Byzantine fault-tolerant multi-agent coordination.
-
-```bash
-claude-flow hive-mind <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `init` | Initialize hive-mind with topology and consensus strategy |
-| `spawn` | Spawn agents in the hive (queen, worker, specialist) |
-| `status` | Show hive-mind status with consensus health |
-| `task` | Submit task to hive-mind for collaborative execution |
-| `optimize-memory` | Optimize collective memory (distill, compress) |
-| `shutdown` | Gracefully shutdown hive-mind |
-
-#### Topologies
-
-| Topology | Description |
-|----------|-------------|
-| `hierarchical` | Queen controls workers directly |
-| `mesh` | Fully connected peer network |
-| `hierarchical-mesh` | Hybrid: Queen + mesh workers |
-| `adaptive` | Dynamic topology based on load |
-
-#### Consensus Strategies
-
-| Strategy | Description | Fault Tolerance |
-|----------|-------------|-----------------|
-| `byzantine` | Byzantine fault-tolerant (BFT) | Tolerates f < n/3 faulty nodes |
-| `raft` | Leader-based consensus | Tolerates f < n/2 failures |
-| `gossip` | Epidemic protocol for eventual consistency | High partition tolerance |
-| `crdt` | Conflict-free replicated data types | Strong eventual consistency |
-| `quorum` | Configurable quorum-based | Flexible fault tolerance |
-
-#### Examples
-
-```bash
-# Initialize with defaults
-claude-flow hive-mind init
-
-# Initialize with Byzantine consensus
-claude-flow hive-mind init -t hierarchical-mesh -c byzantine --agents 15
-
-# Spawn queen
-claude-flow hive-mind spawn --role queen --name hive-queen
-
-# Spawn workers
-claude-flow hive-mind spawn --role worker --count 5
-
-# Spawn specialist
-claude-flow hive-mind spawn --role specialist --specialty security
-
-# Submit task for collaborative execution
-claude-flow hive-mind task "Implement secure API endpoints" --consensus-required
-
-# Check hive status
-claude-flow hive-mind status --detailed
-
-# Optimize collective memory
-claude-flow hive-mind optimize-memory --distill --compress
-
-# Graceful shutdown
-claude-flow hive-mind shutdown --save-state
-```
-
----
-
-### `migrate` - V2 to V3 Migration
-
-Migration tools for transitioning from V2 to V3.
-
-```bash
-claude-flow migrate <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `status` | Check migration status and pending items |
-| `run` | Execute migration (with dry-run option) |
-| `verify` | Verify migration integrity |
-| `rollback` | Rollback to previous version |
-| `breaking` | Show V3 breaking changes |
-
-#### Migration Targets
-
-| Target | Description |
-|--------|-------------|
-| `config` | Migrate configuration files |
-| `memory` | Migrate memory/database content |
-| `agents` | Migrate agent configurations |
-| `hooks` | Migrate hook definitions |
-| `workflows` | Migrate workflow definitions |
-| `all` | Full migration |
-
-#### Examples
-
-```bash
-# Check migration status
-claude-flow migrate status
-
-# Preview migration (dry run)
-claude-flow migrate run --dry-run
-
-# Run full migration with backup
-claude-flow migrate run -t all --backup
-
-# Migrate specific component
-claude-flow migrate run -t memory
-
-# Verify migration
-claude-flow migrate verify
-
-# Auto-fix issues
-claude-flow migrate verify --fix
-
-# Show breaking changes
-claude-flow migrate breaking
-
-# Rollback
-claude-flow migrate rollback --backup-id backup-1704369600
-```
-
----
-
-### `embeddings` - Vector Embeddings
-
-ONNX-based embeddings with hyperbolic space (PoincarΓ© ball), semantic search, and neural substrate integration.
-
-```bash
-claude-flow embeddings <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `init` | Initialize ONNX model and hyperbolic configuration |
-| `generate` | Generate embeddings for text |
-| `search` | Semantic similarity search with HNSW |
-| `compare` | Compare similarity between texts |
-| `collections` | Manage embedding collections/namespaces |
-| `index` | Manage HNSW indexes (build, rebuild, optimize) |
-| `providers` | List available embedding providers |
-| `chunk` | Document chunking with configurable overlap |
-| `normalize` | L2/L1/minmax/zscore normalization |
-| `hyperbolic` | Hyperbolic embedding operations (PoincarΓ© ball) |
-| `neural` | Neural substrate features (drift, memory, swarm) |
-| `models` | List and download ONNX models |
-| `cache` | Manage persistent SQLite cache |
-
-#### Supported Models
-
-| Model | Dimensions | Size | Use Case |
-|-------|------------|------|----------|
-| `all-MiniLM-L6-v2` | 384 | 23MB | Fast, general purpose (default) |
-| `all-mpnet-base-v2` | 768 | 110MB | Higher quality, more compute |
-| `bge-small-en-v1.5` | 384 | 33MB | BGE family, good for retrieval |
-
-#### Hyperbolic Embeddings
-
-The PoincarΓ© ball model provides:
-- **Better hierarchical representation** - Exponential capacity in low dimensions
-- **Distance preservation** - Geodesic distance preserves hierarchy
-- **Use cases** - Taxonomies, org charts, file systems, knowledge graphs
-
-#### Examples
-
-```bash
-# Initialize embedding subsystem with defaults
-claude-flow embeddings init
-
-# Use larger model with custom curvature
-claude-flow embeddings init --model all-mpnet-base-v2 --curvature -0.5
-
-# Euclidean only (no hyperbolic)
-claude-flow embeddings init --no-hyperbolic
-
-# Generate embedding
-claude-flow embeddings generate -t "Implement OAuth2 authentication"
-
-# Semantic search
-claude-flow embeddings search -q "authentication patterns" --limit 10
-
-# Compare texts
-claude-flow embeddings compare --text1 "Hello" --text2 "Hi there"
-
-# Document chunking
-claude-flow embeddings chunk -t "Long document..." --max-size 512 --overlap 50
-
-# Hyperbolic operations
-claude-flow embeddings hyperbolic -a convert
-
-# Neural substrate (drift detection, memory physics)
-claude-flow embeddings neural --init
-claude-flow embeddings neural -f drift
-
-# Download model
-claude-flow embeddings models -d all-mpnet-base-v2
-
-# Cache stats
-claude-flow embeddings cache
-```
-
-#### Configuration File
-
-After `embeddings init`, configuration is stored in `.claude-flow/embeddings.json`:
-
-```json
-{
- "model": "all-MiniLM-L6-v2",
- "modelPath": ".claude-flow/models",
- "dimension": 384,
- "cacheSize": 256,
- "hyperbolic": {
- "enabled": true,
- "curvature": -1,
- "epsilon": 1e-15,
- "maxNorm": 0.99999
- },
- "neural": {
- "enabled": true,
- "driftThreshold": 0.3,
- "decayRate": 0.01
- }
-}
-```
-
----
-
-### `doctor` - System Diagnostics
-
-System health checks with automatic fix suggestions.
-
-```bash
-claude-flow doctor [options]
-```
-
-#### Health Checks
-
-| Check | Description | Auto-Fix |
-|-------|-------------|----------|
-| Node.js Version | Verify Node.js 20+ | nvm install 20 |
-| npm Version | Verify npm 9+ | npm install -g npm@latest |
-| Git | Check git installation | Install git |
-| Git Repository | Check if in git repo | git init |
-| Config File | Validate configuration | claude-flow config init |
-| Daemon Status | Check daemon running | claude-flow daemon start |
-| Memory Database | Check memory DB | claude-flow memory configure |
-| API Keys | Check for API keys | export ANTHROPIC_API_KEY=... |
-| MCP Servers | Check MCP configuration | claude mcp add claude-flow ... |
-| Disk Space | Check available space | Free up disk |
-| TypeScript | Check TypeScript install | npm install -D typescript |
-
-#### Options
-
-| Option | Short | Description | Default |
-|--------|-------|-------------|---------|
-| `--fix` | `-f` | Show fix commands for issues | `false` |
-| `--component` | `-c` | Check specific component | all |
-| `--verbose` | `-v` | Verbose output | `false` |
-
-#### Examples
-
-```bash
-# Run full health check
-claude-flow doctor
-
-# Show fixes for issues
-claude-flow doctor --fix
-
-# Check specific component
-claude-flow doctor -c daemon
-claude-flow doctor -c mcp
-claude-flow doctor -c memory
-```
-
-#### Output Example
-
-```
-Claude Flow Doctor
-System diagnostics and health check
-──────────────────────────────────────────────────
-
-βœ“ Node.js Version: v22.21.1 (>= 20 required)
-βœ“ npm Version: v10.9.4
-βœ“ Git: v2.52.0
-βœ“ Git Repository: In a git repository
-⚠ Config File: No config file (using defaults)
-⚠ Daemon Status: Not running
-⚠ Memory Database: Not initialized
-⚠ API Keys: No API keys found
-⚠ MCP Servers: No MCP config found
-βœ“ Disk Space: 73G available
-βœ“ TypeScript: v5.9.3
-
-──────────────────────────────────────────────────
-
-Summary: 6 passed, 5 warnings
-
-All checks passed with some warnings.
-```
-
----
-
-### `route` - Q-Learning Agent Router
-
-Intelligent task-to-agent routing using reinforcement learning.
-
-```bash
-claude-flow route <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `task` | Route a task to optimal agent using Q-Learning |
-| `list-agents` | List available agent types with capabilities |
-| `stats` | Show router statistics and learning metrics |
-| `feedback` | Provide routing feedback for continuous learning |
-| `reset` | Reset Q-Learning router state |
-| `export` | Export Q-table for persistence |
-| `import` | Import Q-table from file |
-
-#### Agent Types
-
-| Type | Description |
-|------|-------------|
-| `coder` | Code implementation and debugging |
-| `tester` | Testing and quality assurance |
-| `reviewer` | Code review and quality checks |
-| `architect` | System design and architecture |
-| `researcher` | Research and information gathering |
-| `optimizer` | Performance optimization |
-| `debugger` | Bug fixing and troubleshooting |
-| `documenter` | Documentation and comments |
-
-#### How It Works
-
-1. **State Encoding** - Analyzes task description using hash-based feature extraction
-2. **Q-Learning** - Uses Q-table to map (state, action) pairs to expected rewards
-3. **Epsilon-Greedy** - Balances exploration (try new agents) vs exploitation (use best known)
-4. **Feedback Loop** - Learns from success/failure outcomes to improve routing
-
-#### Examples
-
-```bash
-# Route a task to optimal agent
-claude-flow route task "Implement user authentication with JWT"
-
-# Route with verbose output showing decision process
-claude-flow route task "Fix memory leak in API handler" --verbose
-
-# List available agent types
-claude-flow route list-agents
-
-# View router statistics
-claude-flow route stats
-
-# Provide feedback (reward: -1 to 1)
-claude-flow route feedback --agent coder --reward 0.8 --task "auth implementation"
-
-# Export Q-table for backup
-claude-flow route export -o ./q-table.json
-
-# Import Q-table
-claude-flow route import -i ./q-table.json
-
-# Reset router (start fresh)
-claude-flow route reset --confirm
-```
-
----
-
-### `analyze` - Code Analysis
-
-Comprehensive code analysis with AST parsing, diff classification, complexity metrics, and dependency analysis.
-
-```bash
-claude-flow analyze <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description | Algorithm |
-|------------|-------------|-----------|
-| `ast` | AST analysis with symbol extraction | tree-sitter (regex fallback) |
-| `complexity` | Cyclomatic and cognitive complexity | McCabe + cognitive metrics |
-| `symbols` | Extract functions, classes, types | AST parsing |
-| `imports` | Import dependency analysis | Static analysis |
-| `diff` | Diff classification and risk assessment | Pattern matching |
-| `boundaries` | Code boundaries detection | MinCut algorithm |
-| `modules` | Module community detection | Louvain algorithm |
-| `dependencies` | Full dependency graph | Graph building |
-| `circular` | Circular dependency detection | Tarjan's SCC |
-| `deps` | Project dependency analysis | npm/yarn |
-| `code` | Static code quality analysis | Multi-metric |
-
-#### Diff Risk Levels
-
-| Risk | Color | Description |
-|------|-------|-------------|
-| `critical` | Red | Breaking changes, security-sensitive |
-| `high` | Orange | Core logic, API changes |
-| `medium` | Yellow | Feature additions, significant refactoring |
-| `low` | Green | Documentation, tests, formatting |
-
-#### Examples
-
-```bash
-# Analyze AST of a file
-claude-flow analyze ast ./src/auth/login.ts
-
-# Analyze with symbol extraction
-claude-flow analyze symbols ./src/services/ --recursive
-
-# Check cyclomatic complexity
-claude-flow analyze complexity ./src --threshold 10
-
-# Classify a git diff
-claude-flow analyze diff HEAD~1
-
-# Classify staged changes
-claude-flow analyze diff --staged
-
-# Find code boundaries (module splits)
-claude-flow analyze boundaries ./src --min-cut
-
-# Detect module communities
-claude-flow analyze modules ./src --algorithm louvain
-
-# Find circular dependencies
-claude-flow analyze circular ./src
-
-# Full dependency graph
-claude-flow analyze dependencies ./src -o ./deps.dot --format dot
-
-# Project dependency analysis
-claude-flow analyze deps --outdated
-```
-
----
-
-### `issues` - Collaborative Issue Claims (ADR-016)
-
-Human-agent collaborative issue management with work stealing, load balancing, and handoffs.
-
-```bash
-claude-flow issues <subcommand> [options]
-```
-
-#### Subcommands
-
-| Subcommand | Description |
-|------------|-------------|
-| `list` | List all active claims |
-| `claim` | Claim an issue for yourself or an agent |
-| `release` | Release a claim |
-| `handoff` | Request handoff to another agent/user |
-| `status` | Update claim status and progress |
-| `stealable` | List issues available for work stealing |
-| `steal` | Steal an issue from overloaded/stale claimant |
-| `load` | View agent load distribution |
-| `rebalance` | Rebalance claims across swarm |
-| `board` | Visual Kanban-style claim board |
-
-#### Claim Status
-
-| Status | Description |
-|--------|-------------|
-| `active` | Actively being worked on |
-| `paused` | Temporarily paused |
-| `blocked` | Blocked by dependency |
-| `stealable` | Available for work stealing |
-| `completed` | Work completed |
-| `handoff-pending` | Awaiting handoff acceptance |
-| `review-requested` | Needs review |
-
-#### Work Stealing
-
-Issues can be marked stealable when:
-- **Overloaded** - Claimant has too many active claims
-- **Stale** - No progress for extended period
-- **Blocked** - Blocked beyond timeout threshold
-- **Voluntary** - Claimant voluntarily releases
-
-#### Examples
-
-```bash
-# List all claims
-claude-flow issues list
-
-# List with status filter
-claude-flow issues list --status active
-
-# Claim an issue
-claude-flow issues claim ISSUE-123
-
-# Claim as agent
-claude-flow issues claim ISSUE-123 --as-agent --type coder
-
-# Update progress
-claude-flow issues status ISSUE-123 --progress 50
-
-# Mark as blocked
-claude-flow issues status ISSUE-123 --set blocked --note "Waiting for API"
-
-# Request handoff to another user
-claude-flow issues handoff ISSUE-123 --to user:alice:Alice
-
-# Request handoff to agent
-claude-flow issues handoff ISSUE-123 --to agent:coder:coder-001
-
-# View stealable issues
-claude-flow issues stealable
-
-# Steal an issue
-claude-flow issues steal ISSUE-123 --reason overloaded
-
-# View agent load
-claude-flow issues load
-
-# Rebalance swarm
-claude-flow issues rebalance --strategy even
-
-# Visual board view
-claude-flow issues board
-```
-
-#### Board View
-
-```
-πŸ“‹ Issue Claims Board
-────────────────────────────────────────────────────────────────
-
-ACTIVE (3) PAUSED (1) BLOCKED (1)
-──────────────── ──────────────── ────────────────
-β”‚ ISSUE-123 β”‚ β”‚ ISSUE-456 β”‚ β”‚ ISSUE-789 β”‚
-β”‚ πŸ€– coder β”‚ β”‚ πŸ‘€ alice β”‚ β”‚ πŸ€– tester β”‚
-β”‚ 75% β–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘β–‘ β”‚ β”‚ 30% β–ˆβ–ˆβ–‘β–‘β–‘β–‘β–‘ β”‚ β”‚ 50% β–ˆβ–ˆβ–ˆβ–‘β–‘β–‘β–‘ β”‚
-β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
-```
-
----
-
-### `completions` - Shell Completions
-
-Generate shell completion scripts for tab completion of commands.
-
-```bash
-claude-flow completions <shell>
-```
-
-#### Supported Shells
-
-| Shell | Installation | File Location |
-|-------|-------------|---------------|
-| `bash` | `claude-flow completions bash >> ~/.bashrc` | `~/.bash_completion.d/claude-flow` |
-| `zsh` | `claude-flow completions zsh > ~/.zfunc/_claude-flow` | `~/.zfunc/_claude-flow` |
-| `fish` | `claude-flow completions fish > ~/.config/fish/completions/claude-flow.fish` | `~/.config/fish/completions/` |
-| `powershell` | `claude-flow completions powershell >> $PROFILE` | PowerShell profile |
-
-#### Examples
-
-```bash
-# Install bash completions
-claude-flow completions bash > ~/.bash_completion.d/claude-flow
-source ~/.bash_completion.d/claude-flow
-
-# Install zsh completions
-mkdir -p ~/.zfunc
-claude-flow completions zsh > ~/.zfunc/_claude-flow
-# Add to .zshrc: fpath=(~/.zfunc $fpath); autoload -Uz compinit; compinit
-
-# Install fish completions
-claude-flow completions fish > ~/.config/fish/completions/claude-flow.fish
-
-# Install PowerShell completions
-claude-flow completions powershell >> $PROFILE
-```
-
-#### Completion Features
-
-- All 29 top-level commands
-- Full subcommand completion for each command
-- Flag and option completion
-- Dynamic suggestions based on context
-
----
-
-### Smart Error Suggestions
-
-When you mistype a command, the CLI provides helpful suggestions using Levenshtein distance matching.
-
-```bash
-$ claude-flow swram
-[ERROR] Unknown command: swram
- Did you mean one of these?
- - swarm
- - neural
- - start
-
-$ claude-flow memroy
-[ERROR] Unknown command: memroy
- Did you mean "memory"?
-
-$ claude-flow agnet
-[ERROR] Unknown command: agnet
- Did you mean "agent"?
-```
-
-The suggestion system:
-- Uses Levenshtein distance to find similar commands
-- Recognizes 40+ common typos (e.g., `memroy` β†’ `memory`, `swram` β†’ `swarm`)
-- Suggests up to 3 alternatives sorted by similarity
-- Boosts prefix matches for better suggestions
-
----
-
-## Global Options
-
-All commands support these global options:
-
-| Option | Short | Description | Default |
-|--------|-------|-------------|---------|
-| `--help` | `-h` | Show help information | |
-| `--version` | `-V` | Show version number | |
-| `--verbose` | `-v` | Enable verbose output | `false` |
-| `--quiet` | `-q` | Suppress non-essential output | `false` |
-| `--config` | `-c` | Path to configuration file | `./claude-flow.config.json` |
-| `--format` | `-f` | Output format (text, json, table) | `text` |
-| `--no-color` | | Disable colored output | `false` |
-| `--interactive` | `-i` | Enable interactive mode | `true` (if TTY) |
-
-## Programmatic API
-
-### CommandParser
-
-```typescript
-import { CommandParser, OutputFormatter } from '@claude-flow/cli';
-
-// Create a parser instance
-const parser = new CommandParser();
-
-// Register a command
-parser.registerCommand({
- name: 'mycommand',
- description: 'My custom command',
- options: [
- {
- name: 'type',
- short: 't',
- description: 'Operation type',
- type: 'string',
- choices: ['a', 'b', 'c'],
- default: 'a'
- }
- ],
- subcommands: [
- { name: 'sub1', description: 'First subcommand' },
- { name: 'sub2', description: 'Second subcommand' }
- ],
- action: async (ctx) => {
- // Command implementation
- return { success: true };
- }
-});
-
-// Parse arguments
-const result = parser.parse(process.argv.slice(2));
-
-// Validate flags
-const errors = parser.validateFlags(result.flags, result.command);
-
-// Get all registered commands
-const commands = parser.getAllCommands();
-```
-
-### Output Formatting
-
-```typescript
-import { OutputFormatter, output, Progress, Spinner } from '@claude-flow/cli';
-
-// Use the singleton instance
-output.printSuccess('Operation completed');
-output.printError('Something went wrong');
-output.printWarning('Proceed with caution');
-output.printInfo('FYI: This is informational');
-
-// Or create a custom formatter
-const formatter = new OutputFormatter({ color: true });
-
-// Color methods
-formatter.success('Green text');
-formatter.error('Red text');
-formatter.warning('Yellow text');
-formatter.bold('Bold text');
-formatter.dim('Dimmed text');
-formatter.highlight('Highlighted text');
-
-// Structured output
-output.printTable({
- columns: [
- { key: 'name', header: 'Name', width: 20 },
- { key: 'status', header: 'Status', width: 10, align: 'right' }
- ],
- data: [
- { name: 'Agent 1', status: 'active' },
- { name: 'Agent 2', status: 'idle' }
- ]
-});
-
-output.printJson({ key: 'value' });
-output.printList(['Item 1', 'Item 2', 'Item 3']);
-output.printBox('Content here', 'Title');
-output.progressBar(50, 100, 40); // 50% of 100, width 40
-
-// Progress indication
-const spinner = new Spinner('Loading...');
-spinner.start();
-// ... do work
-spinner.succeed('Completed');
-
-const progress = new Progress({ total: 100 });
-progress.update(50); // 50%
-progress.finish();
-```
-
-### Interactive Prompts
-
-```typescript
-import { text, select, confirm, input, multiSelect } from '@claude-flow/cli';
-
-// Text input
-const name = await text('Enter your name:');
-
-// Selection
-const choice = await select({
- message: 'Choose option:',
- options: [
- { label: 'Option A', value: 'A', hint: 'First option' },
- { label: 'Option B', value: 'B', hint: 'Second option' },
- ],
- default: 'A'
-});
-
-// Confirmation
-const confirmed = await confirm({
- message: 'Continue?',
- default: false
-});
-
-// Input with validation
-const email = await input({
- message: 'Enter email:',
- validate: (v) => v.includes('@') || 'Invalid email'
-});
-
-// Multi-select
-const features = await multiSelect({
- message: 'Select features:',
- options: [
- { label: 'Feature A', value: 'a' },
- { label: 'Feature B', value: 'b' },
- { label: 'Feature C', value: 'c' },
- ]
-});
-```
-
-## TypeScript Types
-
-```typescript
-import type {
- // Command types
- Command,
- CommandOption,
- CommandContext,
- CommandResult,
-
- // Parser types
- ParseResult,
- ParsedFlags,
- ParserOptions,
-
- // Config types
- V3Config,
- ProviderConfig,
- SwarmConfig,
- MemoryConfig,
-
- // Output types
- TableColumn,
- TableOptions,
- SpinnerOptions,
- ProgressOptions,
-
- // Prompt types
- SelectOption,
- InputOptions,
- ConfirmOptions,
-} from '@claude-flow/cli';
-```
-
-## Environment Variables
-
-```bash
-# Configuration
-CLAUDE_FLOW_CONFIG=./claude-flow.config.json
-CLAUDE_FLOW_LOG_LEVEL=info
-
-# Provider API Keys
-ANTHROPIC_API_KEY=sk-ant-...
-OPENAI_API_KEY=sk-...
-GOOGLE_API_KEY=...
-
-# MCP Server
-CLAUDE_FLOW_MCP_PORT=3000
-CLAUDE_FLOW_MCP_HOST=localhost
-CLAUDE_FLOW_MCP_TRANSPORT=stdio
-
-# Memory
-CLAUDE_FLOW_MEMORY_BACKEND=hybrid
-CLAUDE_FLOW_MEMORY_PATH=./data/memory
-```
-
-## Performance Targets
-
-The CLI is optimized for V3 performance targets:
-
-| Metric | Target | Description |
-|--------|--------|-------------|
-| Startup | <500ms | CLI initialization time |
-| Command parsing | <5ms | Argument parsing time |
-| MCP tool execution | <100ms | Tool call overhead |
-| Memory search | 150x-12,500x faster | With HNSW indexing |
-| SONA adaptation | <0.05ms | Neural learning overhead |
-
-## Related Packages
-
-- [@claude-flow/shared](../shared) - Shared types and utilities
-- [@claude-flow/swarm](../swarm) - Swarm coordination module
-- [@claude-flow/memory](../memory) - AgentDB memory system
-- [@claude-flow/mcp](../mcp) - MCP server implementation
-- [@claude-flow/hooks](../hooks) - Self-learning hooks system
-- [@claude-flow/neural](../neural) - SONA neural learning
-- [@claude-flow/embeddings](../embeddings) - Vector embeddings (75x faster with agentic-flow)
-- [@claude-flow/security](../security) - CVE remediation & security patterns
-- [@claude-flow/providers](../providers) - Multi-LLM provider system
-
-## License
-
-MIT
diff --git a/v3/@claude-flow/cli/README.md b/v3/@claude-flow/cli/README.md
new file mode 120000
index 0000000000..8a33348c7d
--- /dev/null
+++ b/v3/@claude-flow/cli/README.md
@@ -0,0 +1 @@
+../../../README.md
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.json
index ed770e928a..103fbacf65 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.91",
+ "version": "3.0.0-alpha.92",
"type": "module",
"description": "CLI module - command parsing, prompts, output formatting",
"main": "dist/src/index.js",
@@ -40,6 +40,7 @@
"test": "vitest run",
"test:plugin-store": "npx tsx src/plugins/tests/standalone-test.ts",
"test:pattern-store": "npx tsx src/transfer/store/tests/standalone-test.ts",
+ "prepublishOnly": "cp ../../../README.md ./README.md",
"release": "npm version prerelease --preid=alpha && npm run publish:all",
"publish:all": "./scripts/publish.sh"
},
diff --git a/v3/package-lock.json b/v3/package-lock.json
index 11151a0b63..0a6aec9248 100644
--- a/v3/package-lock.json
+++ b/v3/package-lock.json
@@ -925,7 +925,7 @@
}
},
"@claude-flow/cli": {
- "version": "3.0.0-alpha.91",
+ "version": "3.0.0-alpha.92",
"dependencies": {
"@claude-flow/aidefence": "^3.0.2",
"@claude-flow/embeddings": "^3.0.0-alpha.12",