@claude-flow/cli 3.27.4 → 3.29.0

package/.claude/commands/agents/health.md

@@ -1,139 +1,139 @@
----
-name: health
-description: Show agent health and metrics
-type: command
----
-
-# Agent Health Command
-
-Monitor agent health status, resource usage, and detect issues.
-
-## Usage
-
-```bash
-npx claude-flow agent health [agent-id] [options]
-```
-
-## Options
-
-| Option | Short | Description | Default |
-|--------|-------|-------------|---------|
-| `--watch` | `-w` | Continuous monitoring | false |
-| `--interval` | `-i` | Watch interval in seconds | 5 |
-| `--format` | | Output format (table, json) | table |
-
-## Examples
-
-```bash
-# Overall health check
-npx claude-flow agent health
-
-# Specific agent health
-npx claude-flow agent health coder-lx7m9k2
-
-# Continuous monitoring
-npx claude-flow agent health --watch
-
-# Custom interval
-npx claude-flow agent health -w -i 10
-
-# JSON output
-npx claude-flow agent health --format json
-```
-
-## Output
-
-```
-Agent Health Status
-
-Overall: HEALTHY
-
-+--------------------+---------+--------+--------+---------+
-| Agent              | Status  | Memory | CPU    | Tasks   |
-+--------------------+---------+--------+--------+---------+
-| coder-lx7m9k2      | healthy | 45MB   | 2.3%   | 5/5     |
-| researcher-abc123  | healthy | 38MB   | 1.8%   | 3/3     |
-| tester-def456      | warning | 120MB  | 8.5%   | 12/14   |
-+--------------------+---------+--------+--------+---------+
-
-Alerts
-  - tester-def456: High memory usage (120MB > 100MB threshold)
-  - tester-def456: Task failure rate above threshold (14.3%)
-
-Recommendations
-  - Consider restarting tester-def456
-  - Review failed tasks for error patterns
-```
-
-## Health Status Values
-
-| Status | Description |
-|--------|-------------|
-| `healthy` | All metrics within normal range |
-| `warning` | Some metrics approaching thresholds |
-| `critical` | Metrics exceeded critical thresholds |
-| `unknown` | Unable to determine health |
-
-## Health Checks
-
-### Resource Checks
-- Memory usage vs threshold
-- CPU utilization
-- Active connections
-- Queue depth
-
-### Performance Checks
-- Response time
-- Task success rate
-- Error frequency
-- Throughput
-
-### Connectivity Checks
-- MCP server connection
-- Memory backend
-- Neural services
-- Swarm coordination
-
-## Watch Mode
-
-Continuous monitoring with real-time updates:
-
-```bash
-npx claude-flow agent health --watch
-
-# Output updates every 5 seconds:
-# [10:30:15] Agent Health: 3 healthy, 0 warning, 0 critical
-# [10:30:20] Agent Health: 3 healthy, 0 warning, 0 critical
-# [10:30:25] Agent Health: 2 healthy, 1 warning, 0 critical
-#   - tester-def456: Memory usage increased to 115MB
-```
-
-Press `Ctrl+C` to stop watching.
-
-## JSON Output
-
-```json
-{
-  "overall": "healthy",
-  "agents": [
-    {
-      "id": "coder-lx7m9k2",
-      "status": "healthy",
-      "metrics": {
-        "memoryMB": 45,
-        "cpuPercent": 2.3,
-        "tasksCompleted": 5,
-        "tasksTotal": 5
-      }
-    }
-  ],
-  "alerts": [],
-  "recommendations": []
-}
-```
-
-## Related Commands
-
-- `npx claude-flow agent status` - Detailed agent info
-- `npx claude-flow agent metrics` - Performance metrics
-- `npx claude-flow doctor` - System-wide health
+---
+name: health
+description: Show agent health and metrics
+type: command
+---
+
+# Agent Health Command
+
+Monitor agent health status, resource usage, and detect issues.
+
+## Usage
+
+```bash
+npx claude-flow agent health [agent-id] [options]
+```
+
+## Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--watch` | `-w` | Continuous monitoring | false |
+| `--interval` | `-i` | Watch interval in seconds | 5 |
+| `--format` | | Output format (table, json) | table |
+
+## Examples
+
+```bash
+# Overall health check
+npx claude-flow agent health
+
+# Specific agent health
+npx claude-flow agent health coder-lx7m9k2
+
+# Continuous monitoring
+npx claude-flow agent health --watch
+
+# Custom interval
+npx claude-flow agent health -w -i 10
+
+# JSON output
+npx claude-flow agent health --format json
+```
+
+## Output
+
+```
+Agent Health Status
+
+Overall: HEALTHY
+
++--------------------+---------+--------+--------+---------+
+| Agent              | Status  | Memory | CPU    | Tasks   |
++--------------------+---------+--------+--------+---------+
+| coder-lx7m9k2      | healthy | 45MB   | 2.3%   | 5/5     |
+| researcher-abc123  | healthy | 38MB   | 1.8%   | 3/3     |
+| tester-def456      | warning | 120MB  | 8.5%   | 12/14   |
++--------------------+---------+--------+--------+---------+
+
+Alerts
+  - tester-def456: High memory usage (120MB > 100MB threshold)
+  - tester-def456: Task failure rate above threshold (14.3%)
+
+Recommendations
+  - Consider restarting tester-def456
+  - Review failed tasks for error patterns
+```
+
+## Health Status Values
+
+| Status | Description |
+|--------|-------------|
+| `healthy` | All metrics within normal range |
+| `warning` | Some metrics approaching thresholds |
+| `critical` | Metrics exceeded critical thresholds |
+| `unknown` | Unable to determine health |
+
+## Health Checks
+
+### Resource Checks
+- Memory usage vs threshold
+- CPU utilization
+- Active connections
+- Queue depth
+
+### Performance Checks
+- Response time
+- Task success rate
+- Error frequency
+- Throughput
+
+### Connectivity Checks
+- MCP server connection
+- Memory backend
+- Neural services
+- Swarm coordination
+
+## Watch Mode
+
+Continuous monitoring with real-time updates:
+
+```bash
+npx claude-flow agent health --watch
+
+# Output updates every 5 seconds:
+# [10:30:15] Agent Health: 3 healthy, 0 warning, 0 critical
+# [10:30:20] Agent Health: 3 healthy, 0 warning, 0 critical
+# [10:30:25] Agent Health: 2 healthy, 1 warning, 0 critical
+#   - tester-def456: Memory usage increased to 115MB
+```
+
+Press `Ctrl+C` to stop watching.
+
+## JSON Output
+
+```json
+{
+  "overall": "healthy",
+  "agents": [
+    {
+      "id": "coder-lx7m9k2",
+      "status": "healthy",
+      "metrics": {
+        "memoryMB": 45,
+        "cpuPercent": 2.3,
+        "tasksCompleted": 5,
+        "tasksTotal": 5
+      }
+    }
+  ],
+  "alerts": [],
+  "recommendations": []
+}
+```
+
+## Related Commands
+
+- `npx claude-flow agent status` - Detailed agent info
+- `npx claude-flow agent metrics` - Performance metrics
+- `npx claude-flow doctor` - System-wide health

package/.claude/commands/agents/list.md

@@ -1,100 +1,100 @@
----
-name: list
-description: List all active agents
-aliases: [ls]
-type: command
----
-
-# Agent List Command
-
-List all active agents in the Claude Flow system with filtering options.
-
-## Usage
-
-```bash
-npx claude-flow agent list [options]
-npx claude-flow agent ls [options]  # Alias
-```
-
-## Options
-
-| Option | Short | Description | Default |
-|--------|-------|-------------|---------|
-| `--all` | `-a` | Include inactive/terminated agents | false |
-| `--type` | `-t` | Filter by agent type | All |
-| `--status` | `-s` | Filter by status (active, idle, terminated) | active |
-| `--format` | | Output format (table, json) | table |
-
-## Examples
-
-```bash
-# List all active agents
-npx claude-flow agent list
-
-# List all agents including inactive
-npx claude-flow agent list --all
-
-# Filter by type
-npx claude-flow agent list -t coder
-
-# Filter by status
-npx claude-flow agent list -s idle
-
-# JSON output for scripting
-npx claude-flow agent list --format json
-
-# Combined filters
-npx claude-flow agent list -t researcher -s active
-```
-
-## Output
-
-```
-Active Agents
-
-+--------------------+-----------+--------+----------+---------------+
-| ID                 | Type      | Status | Created  | Last Activity |
-+--------------------+-----------+--------+----------+---------------+
-| coder-lx7m9k2      | coder     | active | 10:30:15 | 10:45:23      |
-| researcher-abc123  | researcher| idle   | 09:15:00 | 10:20:45      |
-| tester-def456      | tester    | active | 11:00:00 | 11:12:30      |
-+--------------------+-----------+--------+----------+---------------+
-
-Total: 3 agents
-```
-
-## JSON Output
-
-```json
-{
-  "agents": [
-    {
-      "id": "coder-lx7m9k2",
-      "agentType": "coder",
-      "status": "active",
-      "createdAt": "2026-01-08T10:30:15.000Z",
-      "lastActivityAt": "2026-01-08T10:45:23.000Z"
-    }
-  ],
-  "total": 3
-}
-```
-
-## Status Values
-
-| Status | Description |
-|--------|-------------|
-| `active` | Agent is currently executing tasks |
-| `idle` | Agent is waiting for tasks |
-| `terminated` | Agent has been stopped |
-
-## Agent Type Categories
-
-Use `--type` with any of the 87 agent types:
-
-- Core: `coder`, `reviewer`, `tester`, `planner`, `researcher`
-- V3: `security-architect`, `memory-specialist`, `performance-engineer`
-- Swarm: `hierarchical-coordinator`, `mesh-coordinator`, `adaptive-coordinator`
-- Consensus: `byzantine-coordinator`, `raft-manager`, `gossip-coordinator`
-- GitHub: `pr-manager`, `code-review-swarm`, `release-manager`
-- SPARC: `sparc-coordinator`, `specification`, `architecture`
+---
+name: list
+description: List all active agents
+aliases: [ls]
+type: command
+---
+
+# Agent List Command
+
+List all active agents in the Claude Flow system with filtering options.
+
+## Usage
+
+```bash
+npx claude-flow agent list [options]
+npx claude-flow agent ls [options]  # Alias
+```
+
+## Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--all` | `-a` | Include inactive/terminated agents | false |
+| `--type` | `-t` | Filter by agent type | All |
+| `--status` | `-s` | Filter by status (active, idle, terminated) | active |
+| `--format` | | Output format (table, json) | table |
+
+## Examples
+
+```bash
+# List all active agents
+npx claude-flow agent list
+
+# List all agents including inactive
+npx claude-flow agent list --all
+
+# Filter by type
+npx claude-flow agent list -t coder
+
+# Filter by status
+npx claude-flow agent list -s idle
+
+# JSON output for scripting
+npx claude-flow agent list --format json
+
+# Combined filters
+npx claude-flow agent list -t researcher -s active
+```
+
+## Output
+
+```
+Active Agents
+
++--------------------+-----------+--------+----------+---------------+
+| ID                 | Type      | Status | Created  | Last Activity |
++--------------------+-----------+--------+----------+---------------+
+| coder-lx7m9k2      | coder     | active | 10:30:15 | 10:45:23      |
+| researcher-abc123  | researcher| idle   | 09:15:00 | 10:20:45      |
+| tester-def456      | tester    | active | 11:00:00 | 11:12:30      |
++--------------------+-----------+--------+----------+---------------+
+
+Total: 3 agents
+```
+
+## JSON Output
+
+```json
+{
+  "agents": [
+    {
+      "id": "coder-lx7m9k2",
+      "agentType": "coder",
+      "status": "active",
+      "createdAt": "2026-01-08T10:30:15.000Z",
+      "lastActivityAt": "2026-01-08T10:45:23.000Z"
+    }
+  ],
+  "total": 3
+}
+```
+
+## Status Values
+
+| Status | Description |
+|--------|-------------|
+| `active` | Agent is currently executing tasks |
+| `idle` | Agent is waiting for tasks |
+| `terminated` | Agent has been stopped |
+
+## Agent Type Categories
+
+Use `--type` with any of the 87 agent types:
+
+- Core: `coder`, `reviewer`, `tester`, `planner`, `researcher`
+- V3: `security-architect`, `memory-specialist`, `performance-engineer`
+- Swarm: `hierarchical-coordinator`, `mesh-coordinator`, `adaptive-coordinator`
+- Consensus: `byzantine-coordinator`, `raft-manager`, `gossip-coordinator`
+- GitHub: `pr-manager`, `code-review-swarm`, `release-manager`
+- SPARC: `sparc-coordinator`, `specification`, `architecture`