@claude-flow/cli 3.1.0-alpha.51 → 3.1.0-alpha.53

package/README.md

@@ -1017,6 +1017,85 @@ flowchart LR
 
 </details>
 
+<details>
+<summary>🧠 <strong>AgentDB v3 Controllers</strong> — 20+ intelligent memory controllers</summary>
+
+Claude Flow V3 integrates AgentDB v3 (3.0.0-alpha.9) providing 20+ memory controllers accessible via MCP tools and the CLI.
+
+**Core Memory:**
+
+| Controller | MCP Tool | Description |
+|-----------|----------|-------------|
+| HierarchicalMemory | `agentdb_hierarchical-store/recall` | Working → short-term → long-term memory tiers with automatic promotion and retention decay |
+| MemoryConsolidation | `agentdb_consolidate` | Automatic clustering and merging of related memories into semantic summaries |
+| BatchOperations | `agentdb_batch` | Bulk insert/update/delete operations for high-throughput memory management |
+| ReasoningBank | `agentdb_pattern-store/search` | Pattern storage with BM25+semantic hybrid search |
+
+**Intelligence:**
+
+| Controller | MCP Tool | Description |
+|-----------|----------|-------------|
+| SemanticRouter | `agentdb_semantic-route` | Route tasks to agents using vector similarity instead of manual rules |
+| ContextSynthesizer | `agentdb_context-synthesize` | Auto-generate context summaries from memory entries |
+| GNNService | — | Graph neural network for intent classification and skill recommendation |
+| SonaTrajectoryService | — | Record and predict learning trajectories for agents |
+| GraphTransformerService | — | Sublinear attention, causal attention, Granger causality extraction |
+
+**Causal & Explainable:**
+
+| Controller | MCP Tool | Description |
+|-----------|----------|-------------|
+| CausalRecall | `agentdb_causal-edge` | Recall with causal re-ranking and utility scoring |
+| ExplainableRecall | — | Certificates proving *why* a memory was recalled |
+| CausalMemoryGraph | — | Directed causal relationships between memory entries |
+| MMRDiversityRanker | — | Maximal Marginal Relevance for diverse search results |
+
+**Security & Integrity:**
+
+| Controller | MCP Tool | Description |
+|-----------|----------|-------------|
+| GuardedVectorBackend | — | Cryptographic proof-of-work before vector insert/search |
+| MutationGuard | — | Token-validated mutations with cryptographic proofs |
+| AttestationLog | — | Immutable audit trail of all memory operations |
+| RVFOptimizer | — | 4-bit adaptive quantization and progressive compression |
+
+**MCP Tool Examples:**
+```bash
+# Store to hierarchical memory
+agentdb_hierarchical-store --key "auth-pattern" --value "JWT refresh" --tier "longTerm"
+
+# Recall from memory tiers
+agentdb_hierarchical-recall --query "authentication" --topK 5
+
+# Run memory consolidation
+agentdb_consolidate
+
+# Batch insert
+agentdb_batch --operation insert --entries '[{"key":"k1","value":"v1"}]'
+
+# Synthesize context
+agentdb_context-synthesize --query "error handling patterns"
+
+# Semantic routing
+agentdb_semantic-route --input "fix auth bug in login"
+```
+
+**Hierarchical Memory Tiers:**
+```
+┌─────────────────────────────────────────────┐
+│  Working Memory (capacity: 7±2 items)       │  ← Active context, fast access
+│  TTL: ~30 seconds, auto-evict oldest        │
+├─────────────────────────────────────────────┤
+│  Short-Term Memory                          │  ← Recent patterns, moderate retention
+│  Rehearsal strengthens, decay weakens       │
+├─────────────────────────────────────────────┤
+│  Long-Term Memory                           │  ← Consolidated knowledge, persistent
+│  Promoted from short-term via consolidation │
+└─────────────────────────────────────────────┘
+```
+
+</details>
+
 <details>
 <summary>🐝 <strong>Swarm Topology</strong> — Multi-agent coordination patterns</summary>
 
@@ -2395,85 +2474,83 @@ npx ruflo hive-mind status                                  # Check status
 <details>
 <summary>📊 <strong>V3 Statusline</strong> — Real-time development status for Claude Code</summary>
 
-Real-time development status display for Claude Code integration showing DDD progress, swarm activity, security status, and system metrics.
+Real-time development status display integrated directly into Claude Code's status bar. Shows DDD progress, swarm activity, security status, AgentDB metrics, and live session data (model, context usage, cost).
+
+**How It Works:**
+
+Claude Code pipes JSON session data via **stdin** to the statusline script after each assistant message (debounced ~300ms). The script reads this data and combines it with local project metrics to produce a single-line status output.
 
 **Output Format:**
 ```
-▊ Ruflo V3 ● ruvnet  │  ⎇ v3  │  Opus 4.5
-─────────────────────────────────────────────────────
-🏗️  DDD Domains    [●●●●●]  5/5    ⚡ 1.0x → 2.49x-7.47x
-🤖 Swarm  ◉ [58/15]  👥 0    🟢 CVE 3/3    💾 22282MB    📂  47%    🧠  10%
-🔧 Architecture    DDD ● 98%  │  Security ●CLEAN  │  Memory ●AgentDB  │  Integration ●
+▊ Claude Flow V3 ● ruvnet  │  ⎇ main  │  Opus 4.6  | ●42% ctx  | $0.15
+🏗️ DDD [●●●●○] 4/5  ⚡ HNSW 150x  🤖 ◉ [12/8]  👥 3  🟢 CVE 3/3  💾 512MB  🧠 15%  📦 AgentDB ●1.2K vectors
 ```
 
-| Indicator | Description | Values |
+| Indicator | Description | Source |
 |-----------|-------------|--------|
-| `▊ Ruflo V3` | Project header | Always shown |
-| `● ruvnet` | GitHub user (via `gh` CLI) | Dynamic |
-| `⎇ v3` | Current git branch | Dynamic |
-| `Opus 4.5` | Claude model name | From Claude Code |
-| `[●●●●●]` | DDD domain progress bar | 0-5 domains |
-| `⚡ 1.0x → 2.49x-7.47x` | Performance speedup target | Current → Target |
-| `◉/○` | Swarm coordination status | Active/Inactive |
-| `[58/15]` | Active agents / max agents | Process count |
-| `👥 0` | Sub-agents spawned | Task tool agents |
-| `🟢 CVE 3/3` | Security CVE remediation | Fixed/Total |
-| `💾 22282MB` | Memory usage (Node.js processes) | Real-time |
-| `📂 47%` | Context window usage | From Claude Code |
-| `🧠 10%` | Intelligence score (patterns learned) | 0-100% |
-| `DDD ● 98%` | Domain-Driven Design progress | Percentage |
-| `Security ●CLEAN` | Security audit status | CLEAN/PENDING/FAILED |
-| `Memory ●AgentDB` | Memory backend in use | AgentDB/SQLite/Hybrid |
-| `Integration ●` | agentic-flow integration status | Active/Inactive |
-
-**Usage:**
-```bash
-# Default: Safe multi-line (avoids Claude Code collision zone)
-npx ruflo@v3alpha hooks statusline
-
-# Single-line mode (completely avoids collision)
-npx ruflo@v3alpha hooks statusline --single
+| `▊ Claude Flow V3` | Project header | Always shown |
+| `● ruvnet` | GitHub user | `gh api user` CLI |
+| `⎇ main` | Current git branch | `git branch --show-current` |
+| `Opus 4.6` | Claude model name | Stdin JSON `model.display_name` |
+| `●42% ctx` | Context window usage | Stdin JSON `context_window.used_percentage` |
+| `$0.15` | Session cost | Stdin JSON `cost.total_cost_usd` |
+| `[●●●●○]` | DDD domain progress bar | `.claude-flow/metrics/v3-progress.json` |
+| `⚡ HNSW 150x` | HNSW search speedup | AgentDB file stats |
+| `◉/○` | Swarm coordination status | Process detection |
+| `[12/8]` | Active agents / max agents | `ps aux` process count |
+| `👥 3` | Sub-agents spawned | Task tool agent count |
+| `🟢 CVE 3/3` | Security CVE remediation | `.claude-flow/security/audit-status.json` |
+| `💾 512MB` | Memory usage | Node.js process RSS |
+| `🧠 15%` | Intelligence score | Pattern count from AgentDB |
+| `📦 AgentDB ●1.2K` | AgentDB vector count | File size estimate (`size / 2KB`) |
+
+**Setup (Automatic):**
+
+Run `npx claude-flow@v3alpha init` — this generates `.claude/settings.json` with the correct statusline config and creates the helper script at `.claude/helpers/statusline.cjs`.
+
+The generated config uses a **fast local script** (no `npx` cold-start):
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "node .claude/helpers/statusline.cjs"
+  }
+}
+```
 
-# Legacy multi-line (original behavior, may have bleeding)
-npx ruflo@v3alpha hooks statusline --legacy
+> **Note:** Only `type`, `command`, and `padding` are valid statusLine fields. Do not add `refreshMs`, `enabled`, or other fields — Claude Code will ignore them.
 
-# JSON output for scripting
-npx ruflo@v3alpha hooks statusline --json
+**For Existing Users:**
 
-# Compact JSON (single line)
-npx ruflo@v3alpha hooks statusline --compact
+If your statusline is not updating, run the upgrade command to regenerate helpers and fix the config:
+```bash
+npx claude-flow@v3alpha init --update --settings
 ```
 
-**Collision Zone Fix (Issue #985):**
+This removes invalid config fields and regenerates the statusline helper with stdin support.
 
-Claude Code writes internal status (e.g., `7s • 1p`) at absolute terminal coordinates (columns 15-25 on the second-to-last line). The safe mode pads the collision line with spaces to push content past column 25, preventing character bleeding.
-
-| Option | Description |
-|--------|-------------|
-| (default) | Safe multi-line with collision zone avoidance |
-| `--single` | Single-line output (complete collision avoidance) |
-| `--legacy` | Original multi-line (may cause bleeding) |
-| `--json` | JSON output with pretty printing |
-| `--compact` | JSON output without formatting |
+**Stdin JSON Protocol:**
 
-**Claude Code Integration:**
-
-Add to `.claude/settings.json`:
+Claude Code provides session data via stdin in this format:
 ```json
 {
-  "statusLine": {
-    "type": "command",
-    "command": "npx ruflo@v3alpha hooks statusline --single"
-  }
+  "model": { "display_name": "Opus 4.6" },
+  "context_window": { "used_percentage": 42, "remaining_percentage": 58 },
+  "cost": { "total_cost_usd": 0.15, "total_duration_ms": 45000 },
+  "workspace": { "current_dir": "/path/to/project" },
+  "session_id": "abc-123"
 }
 ```
 
+The statusline script reads stdin synchronously, falls back to local detection when run manually (TTY mode).
+
 **Data Sources:**
-- `.ruflo/metrics/v3-progress.json` - DDD domain progress
-- `.ruflo/metrics/swarm-activity.json` - Active agent counts
-- `.ruflo/security/audit-status.json` - CVE remediation status
-- `.ruflo/learning/patterns.db` - Intelligence score (pattern count)
-- Process detection via `ps aux` - Real-time memory and agent counts
+- **Stdin JSON** — Model name, context %, cost, duration (from Claude Code)
+- `.claude-flow/metrics/v3-progress.json` — DDD domain progress
+- `.claude-flow/metrics/swarm-activity.json` — Active agent counts
+- `.claude-flow/security/audit-status.json` — CVE remediation status
+- **AgentDB files** — Vector count (estimated from file size), HNSW index status
+- Process detection via `ps aux` — Real-time memory and agent counts
 - Git branch via `git branch --show-current`
 - GitHub user via `gh api user`
 

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

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,aAAa,CAAC;AAyzI1E,eAAO,MAAM,YAAY,EAAE,OAyG1B,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,aAAa,CAAC;AA6zI1E,eAAO,MAAM,YAAY,EAAE,OAyG1B,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/src/commands/hooks.js

@@ -915,13 +915,14 @@ const metricsCommand = {
                 ]
             });
             if (v3Dashboard && result.performance) {
+                const p = result.performance;
                 output.writeln();
                 output.writeln(output.bold('🚀 V3 Performance Gains'));
                 output.printList([
-                    `Flash Attention: ${output.success(result.performance.flashAttention)}`,
-                    `Memory Reduction: ${output.success(result.performance.memoryReduction)}`,
-                    `Search Improvement: ${output.success(result.performance.searchImprovement)}`,
-                    `Token Reduction: ${output.success(result.performance.tokenReduction)}`
+                    `Flash Attention: ${output.success(p.flashAttention ?? 'N/A')}`,
+                    `Memory Reduction: ${output.success(p.memoryReduction ?? 'N/A')}`,
+                    `Search Improvement: ${output.success(p.searchImprovement ?? 'N/A')}`,
+                    `Token Reduction: ${output.success(p.tokenReduction ?? 'N/A')}`
                 ]);
             }
             return { success: true, data: result };
@@ -1719,15 +1720,18 @@ const intelligenceCommand = {
                 output.writeln(output.dim('  Not initialized'));
             }
             // V3 Performance
-            output.writeln();
-            output.writeln(output.bold('🚀 V3 Performance Gains'));
-            output.printList([
-                `Flash Attention: ${output.success(result.performance.flashAttention)}`,
-                `Memory Reduction: ${output.success(result.performance.memoryReduction)}`,
-                `Search Improvement: ${output.success(result.performance.searchImprovement)}`,
-                `Token Reduction: ${output.success(result.performance.tokenReduction)}`,
-                `SWE-Bench Score: ${output.success(result.performance.sweBenchScore)}`
-            ]);
+            const perf = result.performance;
+            if (perf) {
+                output.writeln();
+                output.writeln(output.bold('🚀 V3 Performance Gains'));
+                output.printList([
+                    `Flash Attention: ${output.success(perf.flashAttention ?? 'N/A')}`,
+                    `Memory Reduction: ${output.success(perf.memoryReduction ?? 'N/A')}`,
+                    `Search Improvement: ${output.success(perf.searchImprovement ?? 'N/A')}`,
+                    `Token Reduction: ${output.success(perf.tokenReduction ?? 'N/A')}`,
+                    `SWE-Bench Score: ${output.success(perf.sweBenchScore ?? 'N/A')}`
+                ]);
+            }
             return { success: true, data: result };
         }
         catch (error) {