@claude-flow/cli 3.28.0 → 3.30.0

package/.claude/commands/agents/logs.md

@@ -1,130 +1,130 @@
----
-name: logs
-description: Show agent activity logs
-type: command
----
-
-# Agent Logs Command
-
-View activity logs and history for agents.
-
-## Usage
-
-```bash
-npx claude-flow agent logs <agent-id> [options]
-```
-
-## Options
-
-| Option | Short | Description | Default |
-|--------|-------|-------------|---------|
-| `--lines` | `-n` | Number of lines to show | 50 |
-| `--follow` | `-f` | Follow log output | false |
-| `--level` | `-l` | Log level filter (debug, info, warn, error) | info |
-| `--since` | | Show logs since timestamp/duration | - |
-| `--format` | | Output format (text, json) | text |
-
-## Examples
-
-```bash
-# View last 50 lines
-npx claude-flow agent logs coder-lx7m9k2
-
-# View last 100 lines
-npx claude-flow agent logs coder-lx7m9k2 -n 100
-
-# Follow logs (live)
-npx claude-flow agent logs coder-lx7m9k2 --follow
-
-# Filter by level
-npx claude-flow agent logs coder-lx7m9k2 -l error
-
-# Logs since time
-npx claude-flow agent logs coder-lx7m9k2 --since "1h"
-npx claude-flow agent logs coder-lx7m9k2 --since "2026-01-08T10:00:00"
-
-# JSON output
-npx claude-flow agent logs coder-lx7m9k2 --format json
-```
-
-## Output
-
-```
-Logs for coder-lx7m9k2
-
-2026-01-08 10:30:15 [INFO]  Agent spawned: type=coder, name=coder-lx7m9k2
-2026-01-08 10:30:16 [INFO]  Connected to swarm: topology=hierarchical
-2026-01-08 10:30:17 [INFO]  Task received: implement-auth-feature
-2026-01-08 10:30:18 [DEBUG] Loading context from memory
-2026-01-08 10:32:45 [INFO]  Task completed: implement-auth-feature (success)
-2026-01-08 10:32:46 [INFO]  Metrics updated: tasks=1, success_rate=100%
-2026-01-08 10:33:00 [INFO]  Task received: write-auth-tests
-2026-01-08 10:35:23 [INFO]  Task completed: write-auth-tests (success)
-2026-01-08 10:35:24 [WARN]  Memory usage approaching threshold: 85MB/100MB
-```
-
-## Log Levels
-
-| Level | Description |
-|-------|-------------|
-| `debug` | Detailed debugging information |
-| `info` | General operational messages |
-| `warn` | Warning conditions |
-| `error` | Error conditions |
-
-## Follow Mode
-
-Real-time log streaming:
-
-```bash
-npx claude-flow agent logs coder-lx7m9k2 --follow
-
-# New logs appear as they occur:
-# 2026-01-08 10:40:15 [INFO]  Task received: refactor-auth
-# 2026-01-08 10:42:30 [INFO]  Code changes: 3 files modified
-# ...
-```
-
-Press `Ctrl+C` to stop following.
-
-## Time Filters
-
-```bash
-# Last hour
-npx claude-flow agent logs coder-lx7m9k2 --since "1h"
-
-# Last 30 minutes
-npx claude-flow agent logs coder-lx7m9k2 --since "30m"
-
-# Specific timestamp
-npx claude-flow agent logs coder-lx7m9k2 --since "2026-01-08T09:00:00"
-
-# Today's logs
-npx claude-flow agent logs coder-lx7m9k2 --since "today"
-```
-
-## JSON Output
-
-```json
-{
-  "agentId": "coder-lx7m9k2",
-  "logs": [
-    {
-      "timestamp": "2026-01-08T10:30:15.000Z",
-      "level": "info",
-      "message": "Agent spawned",
-      "metadata": {
-        "type": "coder",
-        "name": "coder-lx7m9k2"
-      }
-    }
-  ],
-  "total": 50
-}
-```
-
-## Related Commands
-
-- `npx claude-flow agent status` - Current agent status
-- `npx claude-flow agent health` - Health monitoring
-- `npx claude-flow agent metrics` - Performance metrics
+---
+name: logs
+description: Show agent activity logs
+type: command
+---
+
+# Agent Logs Command
+
+View activity logs and history for agents.
+
+## Usage
+
+```bash
+npx claude-flow agent logs <agent-id> [options]
+```
+
+## Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--lines` | `-n` | Number of lines to show | 50 |
+| `--follow` | `-f` | Follow log output | false |
+| `--level` | `-l` | Log level filter (debug, info, warn, error) | info |
+| `--since` | | Show logs since timestamp/duration | - |
+| `--format` | | Output format (text, json) | text |
+
+## Examples
+
+```bash
+# View last 50 lines
+npx claude-flow agent logs coder-lx7m9k2
+
+# View last 100 lines
+npx claude-flow agent logs coder-lx7m9k2 -n 100
+
+# Follow logs (live)
+npx claude-flow agent logs coder-lx7m9k2 --follow
+
+# Filter by level
+npx claude-flow agent logs coder-lx7m9k2 -l error
+
+# Logs since time
+npx claude-flow agent logs coder-lx7m9k2 --since "1h"
+npx claude-flow agent logs coder-lx7m9k2 --since "2026-01-08T10:00:00"
+
+# JSON output
+npx claude-flow agent logs coder-lx7m9k2 --format json
+```
+
+## Output
+
+```
+Logs for coder-lx7m9k2
+
+2026-01-08 10:30:15 [INFO]  Agent spawned: type=coder, name=coder-lx7m9k2
+2026-01-08 10:30:16 [INFO]  Connected to swarm: topology=hierarchical
+2026-01-08 10:30:17 [INFO]  Task received: implement-auth-feature
+2026-01-08 10:30:18 [DEBUG] Loading context from memory
+2026-01-08 10:32:45 [INFO]  Task completed: implement-auth-feature (success)
+2026-01-08 10:32:46 [INFO]  Metrics updated: tasks=1, success_rate=100%
+2026-01-08 10:33:00 [INFO]  Task received: write-auth-tests
+2026-01-08 10:35:23 [INFO]  Task completed: write-auth-tests (success)
+2026-01-08 10:35:24 [WARN]  Memory usage approaching threshold: 85MB/100MB
+```
+
+## Log Levels
+
+| Level | Description |
+|-------|-------------|
+| `debug` | Detailed debugging information |
+| `info` | General operational messages |
+| `warn` | Warning conditions |
+| `error` | Error conditions |
+
+## Follow Mode
+
+Real-time log streaming:
+
+```bash
+npx claude-flow agent logs coder-lx7m9k2 --follow
+
+# New logs appear as they occur:
+# 2026-01-08 10:40:15 [INFO]  Task received: refactor-auth
+# 2026-01-08 10:42:30 [INFO]  Code changes: 3 files modified
+# ...
+```
+
+Press `Ctrl+C` to stop following.
+
+## Time Filters
+
+```bash
+# Last hour
+npx claude-flow agent logs coder-lx7m9k2 --since "1h"
+
+# Last 30 minutes
+npx claude-flow agent logs coder-lx7m9k2 --since "30m"
+
+# Specific timestamp
+npx claude-flow agent logs coder-lx7m9k2 --since "2026-01-08T09:00:00"
+
+# Today's logs
+npx claude-flow agent logs coder-lx7m9k2 --since "today"
+```
+
+## JSON Output
+
+```json
+{
+  "agentId": "coder-lx7m9k2",
+  "logs": [
+    {
+      "timestamp": "2026-01-08T10:30:15.000Z",
+      "level": "info",
+      "message": "Agent spawned",
+      "metadata": {
+        "type": "coder",
+        "name": "coder-lx7m9k2"
+      }
+    }
+  ],
+  "total": 50
+}
+```
+
+## Related Commands
+
+- `npx claude-flow agent status` - Current agent status
+- `npx claude-flow agent health` - Health monitoring
+- `npx claude-flow agent metrics` - Performance metrics

package/.claude/commands/agents/metrics.md

@@ -1,122 +1,122 @@
----
-name: metrics
-description: Show agent performance metrics
-type: command
----
-
-# Agent Metrics Command
-
-Display comprehensive performance metrics for agents including V3 performance gains.
-
-## Usage
-
-```bash
-npx claude-flow agent metrics [agent-id] [options]
-```
-
-## Options
-
-| Option | Short | Description | Default |
-|--------|-------|-------------|---------|
-| `--period` | `-p` | Time period (1h, 24h, 7d, 30d) | 24h |
-| `--format` | | Output format (table, json) | table |
-
-## Examples
-
-```bash
-# Overall metrics for last 24 hours
-npx claude-flow agent metrics
-
-# Metrics for specific agent
-npx claude-flow agent metrics coder-lx7m9k2
-
-# Last hour
-npx claude-flow agent metrics -p 1h
-
-# Last 7 days
-npx claude-flow agent metrics --period 7d
-
-# JSON output
-npx claude-flow agent metrics --format json
-```
-
-## Output
-
-```
-Agent Metrics (24h)
-
-+--------------------+----------+
-| Metric             |    Value |
-+--------------------+----------+
-| Total Agents       |        4 |
-| Active Agents      |        3 |
-| Tasks Completed    |      127 |
-| Success Rate       |    96.2% |
-| Total Tokens       | 1,234,567|
-| Avg Response Time  |    1.45s |
-+--------------------+----------+
-
-By Agent Type
-+------------+-------+-------+---------+
-| Type       | Count | Tasks | Success |
-+------------+-------+-------+---------+
-| coder      |     2 |    45 |     97% |
-| researcher |     1 |    32 |     95% |
-| tester     |     1 |    50 |     98% |
-+------------+-------+-------+---------+
-
-V3 Performance Gains
-  - Flash Attention: 2.8x speedup
-  - Memory Reduction: 52%
-  - Search: 150x faster
-```
-
-## Metrics Explained
-
-### Summary Metrics
-| Metric | Description |
-|--------|-------------|
-| Total Agents | All agents spawned in period |
-| Active Agents | Currently running agents |
-| Tasks Completed | Successfully completed tasks |
-| Success Rate | Percentage of successful tasks |
-| Total Tokens | Token usage across all agents |
-| Avg Response Time | Mean task completion time |
-
-### V3 Performance Gains
-| Metric | Target | Description |
-|--------|--------|-------------|
-| Flash Attention | 2.49x-7.47x | Neural attention speedup |
-| Memory Reduction | 50-75% | Quantization savings |
-| HNSW Search | 150x-12,500x | Vector search improvement |
-| SONA Adaptation | <0.05ms | Real-time learning |
-
-## JSON Output
-
-```json
-{
-  "period": "24h",
-  "summary": {
-    "totalAgents": 4,
-    "activeAgents": 3,
-    "tasksCompleted": 127,
-    "avgSuccessRate": "96.2%",
-    "totalTokens": 1234567,
-    "avgResponseTime": "1.45s"
-  },
-  "byType": [
-    { "type": "coder", "count": 2, "tasks": 45, "successRate": "97%" }
-  ],
-  "performance": {
-    "flashAttention": "2.8x speedup",
-    "memoryReduction": "52%",
-    "searchImprovement": "150x faster"
-  }
-}
-```
-
-## Related Commands
-
-- `npx claude-flow agent status` - Individual agent metrics
-- `npx claude-flow performance benchmark` - Full performance suite
-- `npx claude-flow status` - System-wide status
+---
+name: metrics
+description: Show agent performance metrics
+type: command
+---
+
+# Agent Metrics Command
+
+Display comprehensive performance metrics for agents including V3 performance gains.
+
+## Usage
+
+```bash
+npx claude-flow agent metrics [agent-id] [options]
+```
+
+## Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--period` | `-p` | Time period (1h, 24h, 7d, 30d) | 24h |
+| `--format` | | Output format (table, json) | table |
+
+## Examples
+
+```bash
+# Overall metrics for last 24 hours
+npx claude-flow agent metrics
+
+# Metrics for specific agent
+npx claude-flow agent metrics coder-lx7m9k2
+
+# Last hour
+npx claude-flow agent metrics -p 1h
+
+# Last 7 days
+npx claude-flow agent metrics --period 7d
+
+# JSON output
+npx claude-flow agent metrics --format json
+```
+
+## Output
+
+```
+Agent Metrics (24h)
+
++--------------------+----------+
+| Metric             |    Value |
++--------------------+----------+
+| Total Agents       |        4 |
+| Active Agents      |        3 |
+| Tasks Completed    |      127 |
+| Success Rate       |    96.2% |
+| Total Tokens       | 1,234,567|
+| Avg Response Time  |    1.45s |
++--------------------+----------+
+
+By Agent Type
++------------+-------+-------+---------+
+| Type       | Count | Tasks | Success |
++------------+-------+-------+---------+
+| coder      |     2 |    45 |     97% |
+| researcher |     1 |    32 |     95% |
+| tester     |     1 |    50 |     98% |
++------------+-------+-------+---------+
+
+V3 Performance Gains
+  - Flash Attention: 2.8x speedup
+  - Memory Reduction: 52%
+  - Search: 150x faster
+```
+
+## Metrics Explained
+
+### Summary Metrics
+| Metric | Description |
+|--------|-------------|
+| Total Agents | All agents spawned in period |
+| Active Agents | Currently running agents |
+| Tasks Completed | Successfully completed tasks |
+| Success Rate | Percentage of successful tasks |
+| Total Tokens | Token usage across all agents |
+| Avg Response Time | Mean task completion time |
+
+### V3 Performance Gains
+| Metric | Target | Description |
+|--------|--------|-------------|
+| Flash Attention | 2.49x-7.47x | Neural attention speedup |
+| Memory Reduction | 50-75% | Quantization savings |
+| HNSW Search | 150x-12,500x | Vector search improvement |
+| SONA Adaptation | <0.05ms | Real-time learning |
+
+## JSON Output
+
+```json
+{
+  "period": "24h",
+  "summary": {
+    "totalAgents": 4,
+    "activeAgents": 3,
+    "tasksCompleted": 127,
+    "avgSuccessRate": "96.2%",
+    "totalTokens": 1234567,
+    "avgResponseTime": "1.45s"
+  },
+  "byType": [
+    { "type": "coder", "count": 2, "tasks": 45, "successRate": "97%" }
+  ],
+  "performance": {
+    "flashAttention": "2.8x speedup",
+    "memoryReduction": "52%",
+    "searchImprovement": "150x faster"
+  }
+}
+```
+
+## Related Commands
+
+- `npx claude-flow agent status` - Individual agent metrics
+- `npx claude-flow performance benchmark` - Full performance suite
+- `npx claude-flow status` - System-wide status