@claude-flow/cli 3.28.0 → 3.30.0

package/.claude/commands/agents/status.md

@@ -1,115 +1,115 @@
----
-name: status
-description: Show detailed status of an agent
-type: command
----
-
-# Agent Status Command
-
-Display comprehensive status information for a specific agent including metrics, configuration, and activity.
-
-## Usage
-
-```bash
-npx claude-flow agent status <agent-id>
-npx claude-flow agent status --id <agent-id>
-```
-
-## Options
-
-| Option | Description | Default |
-|--------|-------------|---------|
-| `--id` | Agent ID (alternative to positional arg) | Required |
-| `--format` | Output format (table, json) | table |
-
-## Examples
-
-```bash
-# Get status by ID
-npx claude-flow agent status coder-lx7m9k2
-
-# Using --id flag
-npx claude-flow agent status --id researcher-abc123
-
-# JSON output
-npx claude-flow agent status coder-lx7m9k2 --format json
-```
-
-## Output
-
-```
-+--------------------------------------------------+
-|              Agent: coder-lx7m9k2                |
-+--------------------------------------------------+
-| Type: coder                                      |
-| Status: active                                   |
-| Created: 1/8/2026, 10:30:15 AM                   |
-| Last Activity: 1/8/2026, 10:45:23 AM             |
-+--------------------------------------------------+
-
-Metrics
-+-------------------------+----------+
-| Metric                  |    Value |
-+-------------------------+----------+
-| Tasks Completed         |       12 |
-| Tasks In Progress       |        1 |
-| Tasks Failed            |        0 |
-| Avg Execution Time      |  245.5ms |
-| Uptime                  |   15.3m  |
-+-------------------------+----------+
-```
-
-## Detailed Information
-
-The status command provides:
-
-### Basic Info
-- Agent ID and type
-- Current status (active/idle/terminated)
-- Creation timestamp
-- Last activity timestamp
-
-### Performance Metrics
-- Tasks completed successfully
-- Tasks currently in progress
-- Failed task count
-- Average execution time
-- Total uptime
-
-### Configuration (when applicable)
-- Provider and model
-- Timeout settings
-- Auto-tools enabled
-- Custom capabilities
-
-## JSON Output
-
-```json
-{
-  "id": "coder-lx7m9k2",
-  "agentType": "coder",
-  "status": "active",
-  "createdAt": "2026-01-08T10:30:15.000Z",
-  "lastActivityAt": "2026-01-08T10:45:23.000Z",
-  "config": {
-    "provider": "anthropic",
-    "model": "claude-3-5-sonnet-20241022",
-    "timeout": 300,
-    "autoTools": true
-  },
-  "metrics": {
-    "tasksCompleted": 12,
-    "tasksInProgress": 1,
-    "tasksFailed": 0,
-    "averageExecutionTime": 245.5,
-    "uptime": 918000
-  }
-}
-```
-
-## Related Commands
-
-- `npx claude-flow agent list` - Find agent IDs
-- `npx claude-flow agent metrics` - Aggregate metrics
-- `npx claude-flow agent health` - Health check
-- `npx claude-flow agent logs <id>` - Activity logs
+---
+name: status
+description: Show detailed status of an agent
+type: command
+---
+
+# Agent Status Command
+
+Display comprehensive status information for a specific agent including metrics, configuration, and activity.
+
+## Usage
+
+```bash
+npx claude-flow agent status <agent-id>
+npx claude-flow agent status --id <agent-id>
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--id` | Agent ID (alternative to positional arg) | Required |
+| `--format` | Output format (table, json) | table |
+
+## Examples
+
+```bash
+# Get status by ID
+npx claude-flow agent status coder-lx7m9k2
+
+# Using --id flag
+npx claude-flow agent status --id researcher-abc123
+
+# JSON output
+npx claude-flow agent status coder-lx7m9k2 --format json
+```
+
+## Output
+
+```
++--------------------------------------------------+
+|              Agent: coder-lx7m9k2                |
++--------------------------------------------------+
+| Type: coder                                      |
+| Status: active                                   |
+| Created: 1/8/2026, 10:30:15 AM                   |
+| Last Activity: 1/8/2026, 10:45:23 AM             |
++--------------------------------------------------+
+
+Metrics
++-------------------------+----------+
+| Metric                  |    Value |
++-------------------------+----------+
+| Tasks Completed         |       12 |
+| Tasks In Progress       |        1 |
+| Tasks Failed            |        0 |
+| Avg Execution Time      |  245.5ms |
+| Uptime                  |   15.3m  |
++-------------------------+----------+
+```
+
+## Detailed Information
+
+The status command provides:
+
+### Basic Info
+- Agent ID and type
+- Current status (active/idle/terminated)
+- Creation timestamp
+- Last activity timestamp
+
+### Performance Metrics
+- Tasks completed successfully
+- Tasks currently in progress
+- Failed task count
+- Average execution time
+- Total uptime
+
+### Configuration (when applicable)
+- Provider and model
+- Timeout settings
+- Auto-tools enabled
+- Custom capabilities
+
+## JSON Output
+
+```json
+{
+  "id": "coder-lx7m9k2",
+  "agentType": "coder",
+  "status": "active",
+  "createdAt": "2026-01-08T10:30:15.000Z",
+  "lastActivityAt": "2026-01-08T10:45:23.000Z",
+  "config": {
+    "provider": "anthropic",
+    "model": "claude-3-5-sonnet-20241022",
+    "timeout": 300,
+    "autoTools": true
+  },
+  "metrics": {
+    "tasksCompleted": 12,
+    "tasksInProgress": 1,
+    "tasksFailed": 0,
+    "averageExecutionTime": 245.5,
+    "uptime": 918000
+  }
+}
+```
+
+## Related Commands
+
+- `npx claude-flow agent list` - Find agent IDs
+- `npx claude-flow agent metrics` - Aggregate metrics
+- `npx claude-flow agent health` - Health check
+- `npx claude-flow agent logs <id>` - Activity logs

package/.claude/commands/agents/stop.md

@@ -1,102 +1,102 @@
----
-name: stop
-description: Stop a running agent
-aliases: [kill]
-type: command
----
-
-# Agent Stop Command
-
-Stop a running agent with graceful or forced shutdown options.
-
-## Usage
-
-```bash
-npx claude-flow agent stop <agent-id> [options]
-npx claude-flow agent kill <agent-id> [options]  # Alias
-```
-
-## Options
-
-| Option | Short | Description | Default |
-|--------|-------|-------------|---------|
-| `--force` | `-f` | Force stop without graceful shutdown | false |
-| `--timeout` | | Graceful shutdown timeout in seconds | 30 |
-
-## Examples
-
-```bash
-# Graceful stop (completes current task)
-npx claude-flow agent stop coder-lx7m9k2
-
-# Force stop (immediate termination)
-npx claude-flow agent stop coder-lx7m9k2 --force
-
-# Custom shutdown timeout
-npx claude-flow agent stop coder-lx7m9k2 --timeout 60
-
-# Using kill alias
-npx claude-flow agent kill researcher-abc123 -f
-```
-
-## Graceful vs Force Stop
-
-### Graceful Shutdown (Default)
-1. Completes current task
-2. Saves agent state to memory
-3. Releases resources cleanly
-4. Notifies swarm coordinator
-
-```bash
-npx claude-flow agent stop coder-lx7m9k2
-
-# Output:
-# Stopping agent coder-lx7m9k2...
-#   Completing current task...
-#   Saving state...
-#   Releasing resources...
-# Agent coder-lx7m9k2 stopped successfully
-```
-
-### Force Stop
-1. Immediate termination
-2. No state preservation
-3. May leave tasks incomplete
-
-```bash
-npx claude-flow agent stop coder-lx7m9k2 --force
-
-# Output:
-# Stopping agent coder-lx7m9k2...
-# Agent coder-lx7m9k2 stopped successfully
-```
-
-## Interactive Confirmation
-
-Without `--force`, you'll be prompted to confirm:
-
-```
-? Are you sure you want to stop agent coder-lx7m9k2? (y/N)
-```
-
-## Batch Operations
-
-To stop multiple agents:
-
-```bash
-# Stop all agents of a type
-npx claude-flow agent list -t coder --format json | \
-  jq -r '.agents[].id' | \
-  xargs -I {} npx claude-flow agent stop {} -f
-
-# Stop all idle agents
-npx claude-flow agent list -s idle --format json | \
-  jq -r '.agents[].id' | \
-  xargs -I {} npx claude-flow agent stop {}
-```
-
-## Related Commands
-
-- `npx claude-flow agent list` - Find agent IDs
-- `npx claude-flow agent status` - Check status before stopping
-- `npx claude-flow swarm destroy` - Stop all agents in swarm
+---
+name: stop
+description: Stop a running agent
+aliases: [kill]
+type: command
+---
+
+# Agent Stop Command
+
+Stop a running agent with graceful or forced shutdown options.
+
+## Usage
+
+```bash
+npx claude-flow agent stop <agent-id> [options]
+npx claude-flow agent kill <agent-id> [options]  # Alias
+```
+
+## Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--force` | `-f` | Force stop without graceful shutdown | false |
+| `--timeout` | | Graceful shutdown timeout in seconds | 30 |
+
+## Examples
+
+```bash
+# Graceful stop (completes current task)
+npx claude-flow agent stop coder-lx7m9k2
+
+# Force stop (immediate termination)
+npx claude-flow agent stop coder-lx7m9k2 --force
+
+# Custom shutdown timeout
+npx claude-flow agent stop coder-lx7m9k2 --timeout 60
+
+# Using kill alias
+npx claude-flow agent kill researcher-abc123 -f
+```
+
+## Graceful vs Force Stop
+
+### Graceful Shutdown (Default)
+1. Completes current task
+2. Saves agent state to memory
+3. Releases resources cleanly
+4. Notifies swarm coordinator
+
+```bash
+npx claude-flow agent stop coder-lx7m9k2
+
+# Output:
+# Stopping agent coder-lx7m9k2...
+#   Completing current task...
+#   Saving state...
+#   Releasing resources...
+# Agent coder-lx7m9k2 stopped successfully
+```
+
+### Force Stop
+1. Immediate termination
+2. No state preservation
+3. May leave tasks incomplete
+
+```bash
+npx claude-flow agent stop coder-lx7m9k2 --force
+
+# Output:
+# Stopping agent coder-lx7m9k2...
+# Agent coder-lx7m9k2 stopped successfully
+```
+
+## Interactive Confirmation
+
+Without `--force`, you'll be prompted to confirm:
+
+```
+? Are you sure you want to stop agent coder-lx7m9k2? (y/N)
+```
+
+## Batch Operations
+
+To stop multiple agents:
+
+```bash
+# Stop all agents of a type
+npx claude-flow agent list -t coder --format json | \
+  jq -r '.agents[].id' | \
+  xargs -I {} npx claude-flow agent stop {} -f
+
+# Stop all idle agents
+npx claude-flow agent list -s idle --format json | \
+  jq -r '.agents[].id' | \
+  xargs -I {} npx claude-flow agent stop {}
+```
+
+## Related Commands
+
+- `npx claude-flow agent list` - Find agent IDs
+- `npx claude-flow agent status` - Check status before stopping
+- `npx claude-flow swarm destroy` - Stop all agents in swarm

package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md

@@ -1,54 +1,54 @@
-# Analysis Commands Compliance Report
-
-## Overview
-Reviewed all command files in `.claude/commands/analysis/` directory to ensure proper usage of:
-- `mcp__claude-flow__*` tools (preferred)
-- `npx claude-flow` commands (as fallback)
-- No direct implementation calls
-
-## Files Reviewed
-
-### 1. token-efficiency.md
-**Status**: ✅ Updated
-**Changes Made**:
-- Replaced `npx ruv-swarm hook session-end --export-metrics` with proper MCP tool call
-- Updated to: `Tool: mcp__claude-flow__token_usage` with appropriate parameters
-- Maintained result format and context
-
-**Before**:
-```bash
-npx ruv-swarm hook session-end --export-metrics
-```
-
-**After**:
-```
-Tool: mcp__claude-flow__token_usage
-Parameters: {"operation": "session", "timeframe": "24h"}
-```
-
-### 2. performance-bottlenecks.md
-**Status**: ✅ Compliant (No changes needed)
-**Reason**: Already uses proper `mcp__claude-flow__task_results` tool format
-
-## Summary
-
-- **Total files reviewed**: 2
-- **Files updated**: 1
-- **Files already compliant**: 1
-- **Compliance rate after updates**: 100%
-
-## Compliance Patterns Enforced
-
-1. **MCP Tool Usage**: All direct tool calls now use `mcp__claude-flow__*` format
-2. **Parameter Format**: JSON parameters properly structured
-3. **Command Context**: Preserved original functionality and expected results
-4. **Documentation**: Maintained clarity and examples
-
-## Recommendations
-
-1. All analysis commands now follow the proper pattern
-2. No direct bash commands or implementation calls remain
-3. Token usage analysis properly integrated with MCP tools
-4. Performance analysis already using correct tool format
-
+# Analysis Commands Compliance Report
+
+## Overview
+Reviewed all command files in `.claude/commands/analysis/` directory to ensure proper usage of:
+- `mcp__claude-flow__*` tools (preferred)
+- `npx claude-flow` commands (as fallback)
+- No direct implementation calls
+
+## Files Reviewed
+
+### 1. token-efficiency.md
+**Status**: ✅ Updated
+**Changes Made**:
+- Replaced `npx ruv-swarm hook session-end --export-metrics` with proper MCP tool call
+- Updated to: `Tool: mcp__claude-flow__token_usage` with appropriate parameters
+- Maintained result format and context
+
+**Before**:
+```bash
+npx ruv-swarm hook session-end --export-metrics
+```
+
+**After**:
+```
+Tool: mcp__claude-flow__token_usage
+Parameters: {"operation": "session", "timeframe": "24h"}
+```
+
+### 2. performance-bottlenecks.md
+**Status**: ✅ Compliant (No changes needed)
+**Reason**: Already uses proper `mcp__claude-flow__task_results` tool format
+
+## Summary
+
+- **Total files reviewed**: 2
+- **Files updated**: 1
+- **Files already compliant**: 1
+- **Compliance rate after updates**: 100%
+
+## Compliance Patterns Enforced
+
+1. **MCP Tool Usage**: All direct tool calls now use `mcp__claude-flow__*` format
+2. **Parameter Format**: JSON parameters properly structured
+3. **Command Context**: Preserved original functionality and expected results
+4. **Documentation**: Maintained clarity and examples
+
+## Recommendations
+
+1. All analysis commands now follow the proper pattern
+2. No direct bash commands or implementation calls remain
+3. Token usage analysis properly integrated with MCP tools
+4. Performance analysis already using correct tool format
+
 The analysis directory is now fully compliant with the Claude Flow command standards.

package/.claude/commands/analysis/README.md

@@ -1,9 +1,9 @@
-# Analysis Commands
-
-Commands for analysis operations in Claude Flow.
-
-## Available Commands
-
-- [bottleneck-detect](./bottleneck-detect.md)
-- [token-usage](./token-usage.md)
-- [performance-report](./performance-report.md)
+# Analysis Commands
+
+Commands for analysis operations in Claude Flow.
+
+## Available Commands
+
+- [bottleneck-detect](./bottleneck-detect.md)
+- [token-usage](./token-usage.md)
+- [performance-report](./performance-report.md)