@claude-flow/cli 3.1.0-alpha.50 → 3.1.0-alpha.52

package/README.md

@@ -2395,85 +2395,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;AAizI1E,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 };
@@ -1634,19 +1635,20 @@ const intelligenceCommand = {
             // SONA Component
             output.writeln();
             output.writeln(output.bold('🧠 SONA (Sub-0.05ms Learning)'));
-            if (result.components.sona.enabled) {
+            const sona = result.components?.sona;
+            if (sona?.enabled) {
                 output.printTable({
                     columns: [
                         { key: 'metric', header: 'Metric', width: 25 },
                         { key: 'value', header: 'Value', width: 20, align: 'right' }
                     ],
                     data: [
-                        { metric: 'Status', value: formatIntelligenceStatus(result.components.sona.status) },
-                        { metric: 'Learning Time', value: `${result.components.sona.learningTimeMs.toFixed(3)}ms` },
-                        { metric: 'Adaptation Time', value: `${result.components.sona.adaptationTimeMs.toFixed(3)}ms` },
-                        { metric: 'Trajectories', value: result.components.sona.trajectoriesRecorded },
-                        { metric: 'Patterns Learned', value: result.components.sona.patternsLearned },
-                        { metric: 'Avg Quality', value: `${(result.components.sona.avgQuality * 100).toFixed(1)}%` }
+                        { metric: 'Status', value: formatIntelligenceStatus(sona.status) },
+                        { metric: 'Learning Time', value: `${(sona.learningTimeMs ?? 0).toFixed(3)}ms` },
+                        { metric: 'Adaptation Time', value: `${(sona.adaptationTimeMs ?? 0).toFixed(3)}ms` },
+                        { metric: 'Trajectories', value: sona.trajectoriesRecorded ?? 0 },
+                        { metric: 'Patterns Learned', value: sona.patternsLearned ?? 0 },
+                        { metric: 'Avg Quality', value: `${((sona.avgQuality ?? 0) * 100).toFixed(1)}%` }
                     ]
                 });
             }
@@ -1656,17 +1658,18 @@ const intelligenceCommand = {
             // MoE Component
             output.writeln();
             output.writeln(output.bold('🔀 Mixture of Experts (MoE)'));
-            if (result.components.moe.enabled) {
+            const moe = result.components?.moe;
+            if (moe?.enabled) {
                 output.printTable({
                     columns: [
                         { key: 'metric', header: 'Metric', width: 25 },
                         { key: 'value', header: 'Value', width: 20, align: 'right' }
                     ],
                     data: [
-                        { metric: 'Status', value: formatIntelligenceStatus(result.components.moe.status) },
-                        { metric: 'Active Experts', value: result.components.moe.expertsActive },
-                        { metric: 'Routing Accuracy', value: `${(result.components.moe.routingAccuracy * 100).toFixed(1)}%` },
-                        { metric: 'Load Balance', value: `${(result.components.moe.loadBalance * 100).toFixed(1)}%` }
+                        { metric: 'Status', value: formatIntelligenceStatus(moe.status) },
+                        { metric: 'Active Experts', value: moe.expertsActive ?? 0 },
+                        { metric: 'Routing Accuracy', value: `${((moe.routingAccuracy ?? 0) * 100).toFixed(1)}%` },
+                        { metric: 'Load Balance', value: `${((moe.loadBalance ?? 0) * 100).toFixed(1)}%` }
                     ]
                 });
             }
@@ -1676,18 +1679,19 @@ const intelligenceCommand = {
             // HNSW Component
             output.writeln();
             output.writeln(output.bold('🔍 HNSW (150x Faster Search)'));
-            if (result.components.hnsw.enabled) {
+            const hnsw = result.components?.hnsw;
+            if (hnsw?.enabled) {
                 output.printTable({
                     columns: [
                         { key: 'metric', header: 'Metric', width: 25 },
                         { key: 'value', header: 'Value', width: 20, align: 'right' }
                     ],
                     data: [
-                        { metric: 'Status', value: formatIntelligenceStatus(result.components.hnsw.status) },
-                        { metric: 'Index Size', value: result.components.hnsw.indexSize.toLocaleString() },
-                        { metric: 'Search Speedup', value: output.success(result.components.hnsw.searchSpeedup) },
-                        { metric: 'Memory Usage', value: result.components.hnsw.memoryUsage },
-                        { metric: 'Dimension', value: result.components.hnsw.dimension }
+                        { metric: 'Status', value: formatIntelligenceStatus(hnsw.status) },
+                        { metric: 'Index Size', value: (hnsw.indexSize ?? 0).toLocaleString() },
+                        { metric: 'Search Speedup', value: output.success(hnsw.searchSpeedup ?? 'N/A') },
+                        { metric: 'Memory Usage', value: hnsw.memoryUsage ?? 'N/A' },
+                        { metric: 'Dimension', value: hnsw.dimension ?? 384 }
                     ]
                 });
             }
@@ -1697,28 +1701,37 @@ const intelligenceCommand = {
             // Embeddings
             output.writeln();
             output.writeln(output.bold('📦 Embeddings (ONNX)'));
-            output.printTable({
-                columns: [
-                    { key: 'metric', header: 'Metric', width: 25 },
-                    { key: 'value', header: 'Value', width: 20, align: 'right' }
-                ],
-                data: [
-                    { metric: 'Provider', value: result.components.embeddings.provider },
-                    { metric: 'Model', value: result.components.embeddings.model },
-                    { metric: 'Dimension', value: result.components.embeddings.dimension },
-                    { metric: 'Cache Hit Rate', value: `${(result.components.embeddings.cacheHitRate * 100).toFixed(1)}%` }
-                ]
-            });
+            const emb = result.components?.embeddings;
+            if (emb) {
+                output.printTable({
+                    columns: [
+                        { key: 'metric', header: 'Metric', width: 25 },
+                        { key: 'value', header: 'Value', width: 20, align: 'right' }
+                    ],
+                    data: [
+                        { metric: 'Provider', value: emb.provider ?? 'N/A' },
+                        { metric: 'Model', value: emb.model ?? 'N/A' },
+                        { metric: 'Dimension', value: emb.dimension ?? 384 },
+                        { metric: 'Cache Hit Rate', value: `${((emb.cacheHitRate ?? 0) * 100).toFixed(1)}%` }
+                    ]
+                });
+            }
+            else {
+                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) {