@claude-flow/cli 3.0.0-alpha.11 → 3.0.0-alpha.13

package/.agentic-flow/intelligence.json

@@ -1,8 +1,8 @@
 {
   "patterns": {
     "command:": {
-      "success": 0.9999999993650429,
-      "failure": -0.47092513149848
+      "success": 0.9999999999544168,
+      "failure": -0.4860935805278153
     }
   },
   "sequences": {},
@@ -10,8 +10,8 @@
   "dirPatterns": {},
   "errorPatterns": [],
   "metrics": {
-    "totalRoutes": 228,
-    "successfulRoutes": 201,
+    "totalRoutes": 260,
+    "successfulRoutes": 226,
     "routingHistory": []
   }
 }

package/.claude-flow/daemon-state.json

@@ -3,49 +3,49 @@
   "startedAt": "2026-01-07T03:07:50.010Z",
   "workers": {
     "map": {
-      "runCount": 15,
-      "successCount": 15,
+      "runCount": 20,
+      "successCount": 20,
       "failureCount": 0,
       "averageDurationMs": 0.4,
       "isRunning": false,
-      "nextRun": "2026-01-07T04:17:50.374Z",
-      "lastRun": "2026-01-07T04:17:50.375Z"
+      "nextRun": "2026-01-07T04:42:50.478Z",
+      "lastRun": "2026-01-07T04:42:50.578Z"
     },
     "audit": {
-      "runCount": 8,
-      "successCount": 8,
+      "runCount": 10,
+      "successCount": 10,
       "failureCount": 0,
-      "averageDurationMs": 0.25,
+      "averageDurationMs": 0.2,
       "isRunning": false,
-      "nextRun": "2026-01-07T04:27:50.290Z",
-      "lastRun": "2026-01-07T04:17:50.290Z"
+      "nextRun": "2026-01-07T04:47:50.291Z",
+      "lastRun": "2026-01-07T04:37:50.291Z"
     },
     "optimize": {
-      "runCount": 5,
-      "successCount": 5,
+      "runCount": 7,
+      "successCount": 7,
       "failureCount": 0,
-      "averageDurationMs": 0,
+      "averageDurationMs": 0.14285714285714285,
       "isRunning": false,
-      "nextRun": "2026-01-07T04:22:50.191Z",
-      "lastRun": "2026-01-07T04:07:50.190Z"
+      "nextRun": "2026-01-07T04:52:50.291Z",
+      "lastRun": "2026-01-07T04:37:50.291Z"
     },
     "consolidate": {
-      "runCount": 3,
-      "successCount": 3,
+      "runCount": 4,
+      "successCount": 4,
       "failureCount": 0,
-      "averageDurationMs": 0.6666666666666666,
+      "averageDurationMs": 0.5,
       "isRunning": false,
-      "nextRun": "2026-01-07T04:37:50.189Z",
-      "lastRun": "2026-01-07T04:07:50.189Z"
+      "nextRun": "2026-01-07T05:07:50.290Z",
+      "lastRun": "2026-01-07T04:37:50.290Z"
     },
     "testgaps": {
-      "runCount": 4,
-      "successCount": 4,
+      "runCount": 5,
+      "successCount": 5,
       "failureCount": 0,
       "averageDurationMs": 0,
       "isRunning": false,
-      "nextRun": "2026-01-07T04:27:50.190Z",
-      "lastRun": "2026-01-07T04:07:50.189Z"
+      "nextRun": "2026-01-07T04:47:50.290Z",
+      "lastRun": "2026-01-07T04:27:50.289Z"
     },
     "predict": {
       "runCount": 0,
@@ -119,5 +119,5 @@
       }
     ]
   },
-  "savedAt": "2026-01-07T04:17:50.375Z"
+  "savedAt": "2026-01-07T04:42:50.578Z"
 }

package/.claude-flow/metrics/codebase-map.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-01-07T04:17:50.375Z",
+  "timestamp": "2026-01-07T04:42:50.578Z",
   "projectRoot": "/workspaces/claude-flow/v3/@claude-flow/cli",
   "structure": {
     "hasPackageJson": true,
@@ -7,5 +7,5 @@
     "hasClaudeConfig": false,
     "hasClaudeFlow": true
   },
-  "scannedAt": 1767759470375
+  "scannedAt": 1767760970578
 }

package/.claude-flow/metrics/consolidation.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-01-07T04:07:50.189Z",
+  "timestamp": "2026-01-07T04:37:50.290Z",
   "patternsConsolidated": 0,
   "memoryCleaned": 0,
   "duplicatesRemoved": 0

package/.claude-flow/metrics/performance.json

@@ -1,7 +1,7 @@
 {
-  "startTime": 1767759061672,
-  "sessionId": "session-1767759061672",
-  "lastActivity": 1767759061672,
+  "startTime": 1767760962179,
+  "sessionId": "session-1767760962179",
+  "lastActivity": 1767760962179,
   "sessionDuration": 0,
   "totalTasks": 1,
   "successfulTasks": 1,

package/.claude-flow/metrics/security-audit.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-01-07T04:17:50.290Z",
+  "timestamp": "2026-01-07T04:37:50.291Z",
   "checks": {
     "envFilesProtected": true,
     "gitIgnoreExists": false,

package/.claude-flow/metrics/task-metrics.json

@@ -1,10 +1,10 @@
 [
   {
-    "id": "cmd-hooks-1767759061781",
+    "id": "cmd-hooks-1767760962290",
     "type": "hooks",
     "success": true,
-    "duration": 1.6949749999999995,
-    "timestamp": 1767759061782,
+    "duration": 1.611820000000023,
+    "timestamp": 1767760962292,
     "metadata": {}
   }
 ]

package/.claude-flow/metrics/test-gaps.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-01-07T04:07:50.189Z",
+  "timestamp": "2026-01-07T04:27:50.289Z",
   "hasTestDir": true,
   "estimatedCoverage": "unknown",
   "gaps": []

package/README.md

@@ -5,19 +5,20 @@
 [![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-14+-orange.svg)](https://github.com/ruvnet/claude-flow)
-[![Subcommands](https://img.shields.io/badge/Subcommands-92+-purple.svg)](https://github.com/ruvnet/claude-flow)
+[![Commands](https://img.shields.io/badge/Commands-26-orange.svg)](https://github.com/ruvnet/claude-flow)
+[![Subcommands](https://img.shields.io/badge/Subcommands-140+-purple.svg)](https://github.com/ruvnet/claude-flow)
 
-> Modern CLI module for Claude Flow V3 - comprehensive command-line interface with 14 commands, 92+ subcommands, interactive prompts, self-learning hooks, background workers, hive-mind coordination, and beautiful output formatting.
+> Modern CLI module for Claude Flow V3 - comprehensive command-line interface with 26 commands, 140+ subcommands, interactive prompts, self-learning hooks, background workers, hive-mind coordination, smart error suggestions, and beautiful output formatting.
 
 ## Features
 
 ### Core Capabilities
-- **14 Main Commands** - Complete CLI coverage for all Claude Flow operations
-- **92+ Subcommands** - Fine-grained control over every aspect of the system
+- **26 Main Commands** - Complete CLI coverage for all Claude Flow operations
+- **140+ 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
@@ -29,7 +30,8 @@
 ### Developer Experience
 - **Type-Safe** - Full TypeScript support with comprehensive type definitions
 - **Global Options** - Built-in `--help`, `--version`, `--verbose`, `--quiet`, `--format`
-- **Auto-Completion** - Shell completion support for commands and options
+- **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
@@ -87,6 +89,18 @@ claude-flow status --watch
 | `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` | 4 | Vector embeddings (embed, batch, search, init) - 75x faster with agentic-flow |
+| `claims` | 4 | Claims-based authorization (check, grant, revoke, list) |
+| `doctor` | 1 | System diagnostics with health checks and suggested fixes |
+| `completions` | 4 | Shell completions for bash, zsh, fish, and PowerShell |
 
 ---
 
@@ -954,6 +968,155 @@ claude-flow migrate rollback --backup-id backup-1704369600
 
 ---
 
+### `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.
+```
+
+---
+
+### `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 26 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:
@@ -1180,6 +1343,9 @@ The CLI is optimized for V3 performance targets:
 - [@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
 

package/agents/architect.yaml

@@ -8,4 +8,4 @@ capabilities:
 optimizations:
   - context-caching
   - memory-persistence
-createdAt: "2026-01-07T04:11:00.062Z"
+createdAt: "2026-01-07T04:38:55.779Z"

package/agents/coder.yaml

@@ -8,4 +8,4 @@ capabilities:
 optimizations:
   - flash-attention
   - token-reduction
-createdAt: "2026-01-07T04:11:00.062Z"
+createdAt: "2026-01-07T04:38:55.778Z"

package/agents/reviewer.yaml

@@ -7,4 +7,4 @@ capabilities:
   - best-practices
 optimizations:
   - incremental-analysis
-createdAt: "2026-01-07T04:11:00.063Z"
+createdAt: "2026-01-07T04:38:55.779Z"

package/agents/security-architect.yaml

@@ -7,4 +7,4 @@ capabilities:
   - security-review
 optimizations:
   - pattern-matching
-createdAt: "2026-01-07T04:11:00.062Z"
+createdAt: "2026-01-07T04:38:55.779Z"

package/agents/tester.yaml

@@ -7,4 +7,4 @@ capabilities:
   - coverage
 optimizations:
   - parallel-execution
-createdAt: "2026-01-07T04:11:00.062Z"
+createdAt: "2026-01-07T04:38:55.779Z"

package/dist/src/commands/completions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * V3 CLI Completions Command
+ * Shell completions for bash, zsh, fish, powershell
+ *
+ * Created with ruv.io
+ */
+import type { Command } from '../types.js';
+export declare const completionsCommand: Command;
+export default completionsCommand;
+//# sourceMappingURL=completions.d.ts.map

package/dist/src/commands/completions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completions.d.ts","sourceRoot":"","sources":["../../../src/commands/completions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,aAAa,CAAC;AAwf1E,eAAO,MAAM,kBAAkB,EAAE,OA4ChC,CAAC;AAEF,eAAe,kBAAkB,CAAC"}