agentic-flow 3.0.0 → 3.1.0

package/README.md

@@ -1050,16 +1050,16 @@ The `init` command sets up your project with the full Agentic-Flow infrastructur
 
 ```bash
 # Initialize project with full agent library
-npx agentic-flow@alpha init
+npx agentic-flow@3.1.0 init
 
 # Force reinitialize (overwrite existing)
-npx agentic-flow@alpha init --force
+npx agentic-flow@3.1.0 init --force
 
 # Minimal setup (empty directories only)
-npx agentic-flow@alpha init --minimal
+npx agentic-flow@3.1.0 init --minimal
 
 # Verbose output showing all files
-npx agentic-flow@alpha init --verbose
+npx agentic-flow@3.1.0 init --verbose
 ```
 
 ### What Gets Created
@@ -1103,7 +1103,7 @@ The generated `settings.json` includes:
   "mcpServers": {
     "claude-flow": {
       "command": "npx",
-      "args": ["agentic-flow@alpha", "mcp", "start"]
+      "args": ["agentic-flow@3.1.0", "mcp", "start"]
     }
   }
 }
@@ -1115,13 +1115,13 @@ After initialization:
 
 ```bash
 # 1. Start the MCP server
-npx agentic-flow@alpha mcp start
+npx agentic-flow@3.1.0 mcp start
 
 # 2. Bootstrap intelligence from your codebase
-npx agentic-flow@alpha hooks pretrain
+npx agentic-flow@3.1.0 hooks pretrain
 
 # 3. Generate optimized agent configurations
-npx agentic-flow@alpha hooks build-agents
+npx agentic-flow@3.1.0 hooks build-agents
 
 # 4. Start using Claude Code
 claude
@@ -1155,14 +1155,14 @@ Agentic-Flow v2 includes a powerful **self-learning hooks system** powered by Ru
 Get context and agent suggestions before editing a file:
 
 ```bash
-npx agentic-flow@alpha hooks pre-edit <filePath> [options]
+npx agentic-flow@3.1.0 hooks pre-edit <filePath> [options]
 
 Options:
   -t, --task <task>   Task description
   -j, --json          Output as JSON
 
 # Example
-npx agentic-flow@alpha hooks pre-edit src/api/users.ts --task "Add validation"
+npx agentic-flow@3.1.0 hooks pre-edit src/api/users.ts --task "Add validation"
 # Output:
 # 🎯 Suggested Agent: backend-dev
 # 📊 Confidence: 94.2%
@@ -1177,7 +1177,7 @@ npx agentic-flow@alpha hooks pre-edit src/api/users.ts --task "Add validation"
 Record edit outcome for learning:
 
 ```bash
-npx agentic-flow@alpha hooks post-edit <filePath> [options]
+npx agentic-flow@3.1.0 hooks post-edit <filePath> [options]
 
 Options:
   -s, --success           Mark as successful edit
@@ -1188,10 +1188,10 @@ Options:
   -j, --json              Output as JSON
 
 # Example (success)
-npx agentic-flow@alpha hooks post-edit src/api/users.ts --success --agent coder
+npx agentic-flow@3.1.0 hooks post-edit src/api/users.ts --success --agent coder
 
 # Example (failure)
-npx agentic-flow@alpha hooks post-edit src/api/users.ts --fail --error "Type error"
+npx agentic-flow@3.1.0 hooks post-edit src/api/users.ts --fail --error "Type error"
 ```
 
 #### Pre-Command Hook
@@ -1199,13 +1199,13 @@ npx agentic-flow@alpha hooks post-edit src/api/users.ts --fail --error "Type err
 Assess command risk before execution:
 
 ```bash
-npx agentic-flow@alpha hooks pre-command "<command>" [options]
+npx agentic-flow@3.1.0 hooks pre-command "<command>" [options]
 
 Options:
   -j, --json    Output as JSON
 
 # Example
-npx agentic-flow@alpha hooks pre-command "rm -rf node_modules"
+npx agentic-flow@3.1.0 hooks pre-command "rm -rf node_modules"
 # Output:
 # ⚠️ Risk Level: CAUTION (65%)
 # ✅ Command APPROVED
@@ -1218,7 +1218,7 @@ npx agentic-flow@alpha hooks pre-command "rm -rf node_modules"
 Route task to optimal agent using learned patterns:
 
 ```bash
-npx agentic-flow@alpha hooks route "<task>" [options]
+npx agentic-flow@3.1.0 hooks route "<task>" [options]
 
 Options:
   -f, --file <filePath>   Context file path
@@ -1226,7 +1226,7 @@ Options:
   -j, --json              Output as JSON
 
 # Example
-npx agentic-flow@alpha hooks route "Fix authentication bug in login flow"
+npx agentic-flow@3.1.0 hooks route "Fix authentication bug in login flow"
 # Output:
 # 🎯 Recommended Agent: backend-dev
 # 📊 Confidence: 91.5%
@@ -1245,14 +1245,14 @@ npx agentic-flow@alpha hooks route "Fix authentication bug in login flow"
 Explain routing decision with full transparency:
 
 ```bash
-npx agentic-flow@alpha hooks explain "<task>" [options]
+npx agentic-flow@3.1.0 hooks explain "<task>" [options]
 
 Options:
   -f, --file <filePath>   Context file path
   -j, --json              Output as JSON
 
 # Example
-npx agentic-flow@alpha hooks explain "Implement caching layer"
+npx agentic-flow@3.1.0 hooks explain "Implement caching layer"
 # Output:
 # 📝 Summary: Task involves performance optimization and data caching
 # 🎯 Recommended: perf-analyzer
@@ -1273,7 +1273,7 @@ npx agentic-flow@alpha hooks explain "Implement caching layer"
 Analyze repository to bootstrap intelligence:
 
 ```bash
-npx agentic-flow@alpha hooks pretrain [options]
+npx agentic-flow@3.1.0 hooks pretrain [options]
 
 Options:
   -d, --depth <n>     Git history depth (default: 50)
@@ -1282,7 +1282,7 @@ Options:
   -j, --json          Output as JSON
 
 # Example
-npx agentic-flow@alpha hooks pretrain --depth 100
+npx agentic-flow@3.1.0 hooks pretrain --depth 100
 # Output:
 # 🧠 Analyzing repository...
 # 📊 Pretrain Complete!
@@ -1299,7 +1299,7 @@ npx agentic-flow@alpha hooks pretrain --depth 100
 Generate optimized agent configurations from pretrain data:
 
 ```bash
-npx agentic-flow@alpha hooks build-agents [options]
+npx agentic-flow@3.1.0 hooks build-agents [options]
 
 Options:
   -f, --focus <mode>    Focus: quality|speed|security|testing|fullstack
@@ -1309,7 +1309,7 @@ Options:
   -j, --json            Output as JSON
 
 # Example
-npx agentic-flow@alpha hooks build-agents --focus security
+npx agentic-flow@3.1.0 hooks build-agents --focus security
 # Output:
 # ✅ Agents Generated!
 #    📦 Total: 12
@@ -1327,7 +1327,7 @@ npx agentic-flow@alpha hooks build-agents --focus security
 View learning metrics and performance dashboard:
 
 ```bash
-npx agentic-flow@alpha hooks metrics [options]
+npx agentic-flow@3.1.0 hooks metrics [options]
 
 Options:
   -t, --timeframe <period>   Timeframe: 1h|24h|7d|30d (default: 24h)
@@ -1335,7 +1335,7 @@ Options:
   -j, --json                 Output as JSON
 
 # Example
-npx agentic-flow@alpha hooks metrics --timeframe 7d --detailed
+npx agentic-flow@3.1.0 hooks metrics --timeframe 7d --detailed
 # Output:
 # 📊 Learning Metrics (7d)
 #
@@ -1357,7 +1357,7 @@ npx agentic-flow@alpha hooks metrics --timeframe 7d --detailed
 Transfer learned patterns from another project:
 
 ```bash
-npx agentic-flow@alpha hooks transfer <sourceProject> [options]
+npx agentic-flow@3.1.0 hooks transfer <sourceProject> [options]
 
 Options:
   -c, --min-confidence <n>   Minimum confidence threshold (default: 0.7)
@@ -1366,7 +1366,7 @@ Options:
   -j, --json                 Output as JSON
 
 # Example
-npx agentic-flow@alpha hooks transfer ../other-project --mode merge
+npx agentic-flow@3.1.0 hooks transfer ../other-project --mode merge
 # Output:
 # ✅ Transfer Complete!
 #    📥 Patterns transferred: 45
@@ -1384,7 +1384,7 @@ The `intelligence` (alias: `intel`) subcommand provides access to the full RuVec
 Route task using SONA + MoE + HNSW (150x faster than brute force):
 
 ```bash
-npx agentic-flow@alpha hooks intelligence route "<task>" [options]
+npx agentic-flow@3.1.0 hooks intelligence route "<task>" [options]
 
 Options:
   -f, --file <path>       File context
@@ -1393,7 +1393,7 @@ Options:
   -j, --json              Output as JSON
 
 # Example
-npx agentic-flow@alpha hooks intel route "Optimize database queries" --top-k 3
+npx agentic-flow@3.1.0 hooks intel route "Optimize database queries" --top-k 3
 # Output:
 # ⚡ RuVector Intelligence Route
 # 🎯 Agent: perf-analyzer
@@ -1409,15 +1409,15 @@ Track reinforcement learning trajectories for agent improvement:
 
 ```bash
 # Start a trajectory
-npx agentic-flow@alpha hooks intel trajectory-start "<task>" -a <agent>
+npx agentic-flow@3.1.0 hooks intel trajectory-start "<task>" -a <agent>
 # Output: 🎬 Trajectory Started - ID: 42
 
 # Record steps
-npx agentic-flow@alpha hooks intel trajectory-step 42 -a "edit file" -r 0.8
-npx agentic-flow@alpha hooks intel trajectory-step 42 -a "run tests" -r 1.0 --test-passed
+npx agentic-flow@3.1.0 hooks intel trajectory-step 42 -a "edit file" -r 0.8
+npx agentic-flow@3.1.0 hooks intel trajectory-step 42 -a "run tests" -r 1.0 --test-passed
 
 # End trajectory
-npx agentic-flow@alpha hooks intel trajectory-end 42 --success --quality 0.95
+npx agentic-flow@3.1.0 hooks intel trajectory-end 42 --success --quality 0.95
 # Output: 🏁 Trajectory Completed - Learning: EWC++ consolidation applied
 ```
 
@@ -1427,13 +1427,13 @@ Store and search patterns using HNSW-indexed ReasoningBank:
 
 ```bash
 # Store a pattern
-npx agentic-flow@alpha hooks intel pattern-store \
+npx agentic-flow@3.1.0 hooks intel pattern-store \
   --task "Fix React hydration error" \
   --resolution "Use useEffect with empty deps for client-only code" \
   --score 0.95
 
 # Search patterns (150x faster with HNSW)
-npx agentic-flow@alpha hooks intel pattern-search "hydration mismatch"
+npx agentic-flow@3.1.0 hooks intel pattern-search "hydration mismatch"
 # Output:
 # 🔍 Pattern Search Results
 #    Query: "hydration mismatch"
@@ -1449,7 +1449,7 @@ npx agentic-flow@alpha hooks intel pattern-search "hydration mismatch"
 Get RuVector intelligence layer statistics:
 
 ```bash
-npx agentic-flow@alpha hooks intelligence stats
+npx agentic-flow@3.1.0 hooks intelligence stats
 # Output:
 # 📊 RuVector Intelligence Stats
 #
@@ -1490,7 +1490,7 @@ The `init` command automatically configures hooks in `.claude/settings.json`:
         "hooks": [
           {
             "type": "command",
-            "command": "npx agentic-flow@alpha hooks pre-edit \"$TOOL_INPUT_file_path\""
+            "command": "npx agentic-flow@3.1.0 hooks pre-edit \"$TOOL_INPUT_file_path\""
           }
         ]
       },
@@ -1499,7 +1499,7 @@ The `init` command automatically configures hooks in `.claude/settings.json`:
         "hooks": [
           {
             "type": "command",
-            "command": "npx agentic-flow@alpha hooks pre-command \"$TOOL_INPUT_command\""
+            "command": "npx agentic-flow@3.1.0 hooks pre-command \"$TOOL_INPUT_command\""
           }
         ]
       }
@@ -1510,7 +1510,7 @@ The `init` command automatically configures hooks in `.claude/settings.json`:
         "hooks": [
           {
             "type": "command",
-            "command": "npx agentic-flow@alpha hooks post-edit \"$TOOL_INPUT_file_path\" --success"
+            "command": "npx agentic-flow@3.1.0 hooks post-edit \"$TOOL_INPUT_file_path\" --success"
           }
         ]
       }
@@ -1521,7 +1521,7 @@ The `init` command automatically configures hooks in `.claude/settings.json`:
         "hooks": [
           {
             "type": "command",
-            "command": "npx agentic-flow@alpha hooks post-edit \"$TOOL_INPUT_file_path\" --fail --error \"$ERROR_MESSAGE\""
+            "command": "npx agentic-flow@3.1.0 hooks post-edit \"$TOOL_INPUT_file_path\" --fail --error \"$ERROR_MESSAGE\""
           }
         ]
       }
@@ -1531,7 +1531,7 @@ The `init` command automatically configures hooks in `.claude/settings.json`:
         "hooks": [
           {
             "type": "command",
-            "command": "npx agentic-flow@alpha hooks intelligence stats --json"
+            "command": "npx agentic-flow@3.1.0 hooks intelligence stats --json"
           }
         ]
       }
@@ -1542,7 +1542,7 @@ The `init` command automatically configures hooks in `.claude/settings.json`:
           {
             "type": "command",
             "timeout": 3000,
-            "command": "npx agentic-flow@alpha hooks route \"$USER_PROMPT\" --json"
+            "command": "npx agentic-flow@3.1.0 hooks route \"$USER_PROMPT\" --json"
           }
         ]
       }
@@ -1608,10 +1608,10 @@ Workers are automatically dispatched when trigger keywords are detected in promp
 Detect triggers in prompt and dispatch background workers:
 
 ```bash
-npx agentic-flow@alpha workers dispatch "<prompt>"
+npx agentic-flow@3.1.0 workers dispatch "<prompt>"
 
 # Example
-npx agentic-flow@alpha workers dispatch "ultralearn how authentication works"
+npx agentic-flow@3.1.0 workers dispatch "ultralearn how authentication works"
 # Output:
 # ⚡ Background Workers Spawned:
 #   • ultralearn: worker-1234
@@ -1624,7 +1624,7 @@ npx agentic-flow@alpha workers dispatch "ultralearn how authentication works"
 Get worker status and progress:
 
 ```bash
-npx agentic-flow@alpha workers status [workerId]
+npx agentic-flow@3.1.0 workers status [workerId]
 
 Options:
   -s, --session <id>   Filter by session
@@ -1632,7 +1632,7 @@ Options:
   -j, --json           Output as JSON
 
 # Example - Dashboard view
-npx agentic-flow@alpha workers status
+npx agentic-flow@3.1.0 workers status
 # Output:
 # ┌─ Background Workers Dashboard ────────────┐
 # │ ✅ ultralearn: complete                    │
@@ -1650,7 +1650,7 @@ npx agentic-flow@alpha workers status
 View worker analysis results:
 
 ```bash
-npx agentic-flow@alpha workers results [workerId]
+npx agentic-flow@3.1.0 workers results [workerId]
 
 Options:
   -s, --session <id>    Filter by session
@@ -1658,7 +1658,7 @@ Options:
   -j, --json            Output as JSON
 
 # Example
-npx agentic-flow@alpha workers results
+npx agentic-flow@3.1.0 workers results
 # Output:
 # 📊 Worker Analysis Results
 #   • ultralearn "authentication":
@@ -1674,7 +1674,7 @@ npx agentic-flow@alpha workers results
 List all available trigger keywords:
 
 ```bash
-npx agentic-flow@alpha workers triggers
+npx agentic-flow@3.1.0 workers triggers
 # Output:
 # ⚡ Available Background Worker Triggers:
 # ┌──────────────┬──────────┬────────────────────────────────────────┐
@@ -1692,14 +1692,14 @@ npx agentic-flow@alpha workers triggers
 Get worker statistics:
 
 ```bash
-npx agentic-flow@alpha workers stats [options]
+npx agentic-flow@3.1.0 workers stats [options]
 
 Options:
   -t, --timeframe <period>   Timeframe: 1h, 24h, 7d (default: 24h)
   -j, --json                 Output as JSON
 
 # Example
-npx agentic-flow@alpha workers stats --timeframe 7d
+npx agentic-flow@3.1.0 workers stats --timeframe 7d
 # Output:
 # ⚡ Worker Statistics (7d)
 # Total Workers: 45
@@ -1723,14 +1723,14 @@ Create and manage custom workers with specific analysis phases:
 #### List Presets
 
 ```bash
-npx agentic-flow@alpha workers presets
+npx agentic-flow@3.1.0 workers presets
 # Shows available worker presets: quick-scan, deep-analysis, security-audit, etc.
 ```
 
 #### Create Custom Worker
 
 ```bash
-npx agentic-flow@alpha workers create <name> [options]
+npx agentic-flow@3.1.0 workers create <name> [options]
 
 Options:
   -p, --preset <preset>     Preset to use (default: quick-scan)
@@ -1738,13 +1738,13 @@ Options:
   -d, --description <desc>  Worker description
 
 # Example
-npx agentic-flow@alpha workers create security-check --preset security-audit --triggers "security,vuln"
+npx agentic-flow@3.1.0 workers create security-check --preset security-audit --triggers "security,vuln"
 ```
 
 #### Run Custom Worker
 
 ```bash
-npx agentic-flow@alpha workers run <nameOrTrigger> [options]
+npx agentic-flow@3.1.0 workers run <nameOrTrigger> [options]
 
 Options:
   -t, --topic <topic>    Topic to analyze
@@ -1752,7 +1752,7 @@ Options:
   -j, --json             Output as JSON
 
 # Example
-npx agentic-flow@alpha workers run security-check --topic "authentication flow"
+npx agentic-flow@3.1.0 workers run security-check --topic "authentication flow"
 ```
 
 ### Native RuVector Workers
@@ -1760,7 +1760,7 @@ npx agentic-flow@alpha workers run security-check --topic "authentication flow"
 Run native RuVector workers for advanced analysis:
 
 ```bash
-npx agentic-flow@alpha workers native <type> [options]
+npx agentic-flow@3.1.0 workers native <type> [options]
 
 Types:
   security   - Run security vulnerability scan
@@ -1769,7 +1769,7 @@ Types:
   phases     - List available native phases
 
 # Example
-npx agentic-flow@alpha workers native security
+npx agentic-flow@3.1.0 workers native security
 # Output:
 # ⚡ Native Worker: security
 # ══════════════════════════════════════════════════
@@ -1796,7 +1796,7 @@ npx agentic-flow@alpha workers native security
 Run performance benchmarks on the worker system:
 
 ```bash
-npx agentic-flow@alpha workers benchmark [options]
+npx agentic-flow@3.1.0 workers benchmark [options]
 
 Options:
   -t, --type <type>         Benchmark type: all, trigger-detection, registry,
@@ -1805,7 +1805,7 @@ Options:
   -j, --json                Output as JSON
 
 # Example
-npx agentic-flow@alpha workers benchmark --type trigger-detection
+npx agentic-flow@3.1.0 workers benchmark --type trigger-detection
 # Output:
 # ✅ Trigger Detection Benchmark
 #    Operation: detect triggers in prompts
@@ -1820,7 +1820,7 @@ npx agentic-flow@alpha workers benchmark --type trigger-detection
 View worker-agent integration statistics:
 
 ```bash
-npx agentic-flow@alpha workers integration
+npx agentic-flow@3.1.0 workers integration
 # Output:
 # ⚡ Worker-Agent Integration Stats
 # ════════════════════════════════════════
@@ -1841,10 +1841,10 @@ npx agentic-flow@alpha workers integration
 Get recommended agents for a worker trigger:
 
 ```bash
-npx agentic-flow@alpha workers agents <trigger>
+npx agentic-flow@3.1.0 workers agents <trigger>
 
 # Example
-npx agentic-flow@alpha workers agents ultralearn
+npx agentic-flow@3.1.0 workers agents ultralearn
 # Output:
 # ⚡ Agent Recommendations for "ultralearn"
 #
@@ -1873,7 +1873,7 @@ Workers are automatically configured in `.claude/settings.json` via hooks:
             "type": "command",
             "timeout": 5000,
             "background": true,
-            "command": "npx agentic-flow@alpha workers dispatch-prompt \"$USER_PROMPT\" --session \"$SESSION_ID\" --json"
+            "command": "npx agentic-flow@3.1.0 workers dispatch-prompt \"$USER_PROMPT\" --session \"$SESSION_ID\" --json"
           }
         ]
       }
@@ -1883,7 +1883,7 @@ Workers are automatically configured in `.claude/settings.json` via hooks:
         "hooks": [
           {
             "type": "command",
-            "command": "npx agentic-flow@alpha workers cleanup --age 24"
+            "command": "npx agentic-flow@3.1.0 workers cleanup --age 24"
           }
         ]
       }
@@ -1905,11 +1905,8 @@ Workers are automatically configured in `.claude/settings.json` via hooks:
 ### Install from npm
 
 ```bash
-# Install latest alpha version
-npm install agentic-flow@alpha
-
-# Or install specific version
-npm install agentic-flow@2.0.0-alpha
+# Install the current release
+npm install agentic-flow@3.1.0
 ```
 
 ### Install from Source
@@ -2229,7 +2226,7 @@ MIT License - see [LICENSE](LICENSE) file for details.
 **Install now and experience the future of AI agents:**
 
 ```bash
-npm install agentic-flow@alpha
+npm install agentic-flow@3.1.0
 ```
 
 **Made with ❤️ by [@ruvnet](https://github.com/ruvnet)**