@swarmdo/cli 1.4.8

package/.claude/commands/sDo/agents/pool.md

@@ -0,0 +1,127 @@
+---
+name: pool
+description: Manage agent pool for scaling
+type: command
+---
+
+# Agent Pool Command
+
+Manage the agent pool for automatic scaling and resource optimization.
+
+## Usage
+
+```bash
+npx swarmdo agent pool [options]
+```
+
+## Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--size` | `-s` | Set pool size | Current |
+| `--min` | | Minimum pool size | 1 |
+| `--max` | | Maximum pool size | 10 |
+| `--auto-scale` | | Enable auto-scaling | true |
+| `--warmup` | | Pre-warm agents | false |
+
+## Examples
+
+```bash
+# View current pool status
+npx swarmdo agent pool
+
+# Set pool size
+npx swarmdo agent pool --size 5
+
+# Configure auto-scaling
+npx swarmdo agent pool --min 2 --max 15 --auto-scale
+
+# Pre-warm agents for fast response
+npx swarmdo agent pool --warmup
+
+# Disable auto-scaling
+npx swarmdo agent pool --auto-scale false
+```
+
+## Output
+
+```
+Agent Pool Configuration
+
++----------------+----------+
+| Setting        | Value    |
++----------------+----------+
+| Current Size   | 3        |
+| Min Size       | 1        |
+| Max Size       | 10       |
+| Auto-Scale     | enabled  |
+| Warmup         | disabled |
++----------------+----------+
+
+Pool Status
++------------+--------+------+-------+
+| Type       | Active | Idle | Total |
++------------+--------+------+-------+
+| coder      | 1      | 1    | 2     |
+| researcher | 1      | 0    | 1     |
++------------+--------+------+-------+
+
+Auto-Scale Rules
+  - Scale up when: Queue > 5 tasks
+  - Scale down when: Idle > 5 minutes
+  - Cooldown: 60 seconds
+```
+
+## Auto-Scaling Behavior
+
+### Scale Up Triggers
+- Task queue exceeds threshold
+- Response time increases
+- Error rate increases
+
+### Scale Down Triggers
+- Agents idle for extended period
+- Task queue empty
+- Resource pressure
+
+## Pre-Warming
+
+Pre-warm agents to reduce cold-start latency:
+
+```bash
+npx swarmdo agent pool --warmup
+
+# Pre-warms default agent types:
+# - coder (2 instances)
+# - researcher (1 instance)
+# - tester (1 instance)
+```
+
+## Pool Configuration File
+
+Configure in `.swarmdo/config.yaml`:
+
+```yaml
+agent:
+  pool:
+    minSize: 2
+    maxSize: 15
+    autoScale: true
+    warmup:
+      enabled: true
+      types:
+        - type: coder
+          count: 2
+        - type: researcher
+          count: 1
+    scaleRules:
+      scaleUpThreshold: 5
+      scaleDownIdleTime: 300
+      cooldownPeriod: 60
+```
+
+## Related Commands
+
+- `npx swarmdo agent spawn` - Manual agent spawning
+- `npx swarmdo agent list` - View active agents
+- `npx swarmdo swarm scale` - Swarm-level scaling

package/.claude/commands/sDo/agents/spawn.md

@@ -0,0 +1,140 @@
+---
+name: spawn
+description: Spawn a new agent with V3 capabilities
+type: command
+---
+
+# Agent Spawn Command
+
+Spawn a new agent with full V3 capabilities including neural patterns, memory integration, and swarm coordination.
+
+## Usage
+
+```bash
+npx swarmdo agent spawn [options]
+```
+
+## Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--type` | `-t` | Agent type to spawn | Required |
+| `--name` | `-n` | Agent name/identifier | Auto-generated |
+| `--provider` | `-p` | AI provider (anthropic, openrouter, ollama) | anthropic |
+| `--model` | `-m` | Model to use | Provider default |
+| `--task` | | Initial task for the agent | None |
+| `--timeout` | | Agent timeout in seconds | 300 |
+| `--auto-tools` | | Enable automatic tool usage | true |
+
+## Agent Types (87 Available)
+
+### Core Development
+```bash
+npx swarmdo agent spawn -t coder      # Code implementation
+npx swarmdo agent spawn -t reviewer   # Code review
+npx swarmdo agent spawn -t tester     # Testing
+npx swarmdo agent spawn -t planner    # Planning
+npx swarmdo agent spawn -t researcher # Research
+```
+
+### V3 Specialized
+```bash
+npx swarmdo agent spawn -t security-architect     # Security design
+npx swarmdo agent spawn -t security-auditor       # CVE remediation
+npx swarmdo agent spawn -t memory-specialist      # AgentDB (~1.9x-4.7x measured faster)
+npx swarmdo agent spawn -t performance-engineer   # unverified (no benchmark) optimization
+npx swarmdo agent spawn -t core-architect         # DDD design
+```
+
+### Swarm Coordination
+```bash
+npx swarmdo agent spawn -t hierarchical-coordinator  # Queen-led
+npx swarmdo agent spawn -t mesh-coordinator          # P2P network
+npx swarmdo agent spawn -t adaptive-coordinator      # Dynamic topology
+npx swarmdo agent spawn -t collective-intelligence-coordinator
+```
+
+### Consensus Agents
+```bash
+npx swarmdo agent spawn -t byzantine-coordinator  # BFT consensus
+npx swarmdo agent spawn -t raft-manager          # Leader-based
+npx swarmdo agent spawn -t gossip-coordinator    # Eventual consistency
+npx swarmdo agent spawn -t crdt-synchronizer     # CRDT replication
+npx swarmdo agent spawn -t quorum-manager        # Quorum-based
+```
+
+### GitHub Integration
+```bash
+npx swarmdo agent spawn -t pr-manager           # PR lifecycle
+npx swarmdo agent spawn -t code-review-swarm    # Multi-agent review
+npx swarmdo agent spawn -t issue-tracker        # Issue management
+npx swarmdo agent spawn -t release-manager      # Release coordination
+npx swarmdo agent spawn -t workflow-automation  # CI/CD automation
+```
+
+### SPARC Methodology
+```bash
+npx swarmdo agent spawn -t sparc-coordinator    # SPARC orchestration
+npx swarmdo agent spawn -t specification        # Requirements
+npx swarmdo agent spawn -t pseudocode          # Algorithm design
+npx swarmdo agent spawn -t architecture        # System design
+npx swarmdo agent spawn -t refinement          # Iterative improvement
+```
+
+## Examples
+
+```bash
+# Spawn with custom name
+npx swarmdo agent spawn -t coder --name feature-bot
+
+# Spawn with initial task
+npx swarmdo agent spawn -t researcher --task "Research React 19 features"
+
+# Spawn with specific model
+npx swarmdo agent spawn -t architect -m claude-3-opus-20240229
+
+# Spawn with custom timeout
+npx swarmdo agent spawn -t tester --timeout 600
+
+# Spawn using OpenRouter
+npx swarmdo agent spawn -t coder -p openrouter -m anthropic/claude-3.5-sonnet
+```
+
+## Using Claude Code's Task Tool
+
+For actual execution, always use Claude Code's Task tool:
+
+```javascript
+// Spawn ALL agents in ONE message for parallel execution
+Task("Coder", "Implement authentication feature", "coder")
+Task("Tester", "Write unit tests for auth", "tester")
+Task("Reviewer", "Review auth implementation", "reviewer")
+```
+
+## MCP Coordination (Optional)
+
+Use MCP tools only for swarm coordination setup:
+
+```javascript
+mcp__swarmdo__swarm_init({ topology: "hierarchical", maxAgents: 15 })
+mcp__swarmdo__agent_spawn({ type: "coordinator", name: "queen" })
+```
+
+## Output
+
+```
+Spawning coder agent: feature-bot
+
++-----------+----------------------------------+
+| Property  | Value                            |
++-----------+----------------------------------+
+| ID        | coder-lx7m9k2                    |
+| Type      | coder                            |
+| Name      | feature-bot                      |
+| Status    | active                           |
+| Created   | 2026-01-08T03:30:00.000Z         |
+| Capabilities | code, debug, refactor, test   |
++-----------+----------------------------------+
+
+Agent feature-bot spawned successfully
+```

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

@@ -0,0 +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 swarmdo agent status <agent-id>
+npx swarmdo 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 swarmdo agent status coder-lx7m9k2
+
+# Using --id flag
+npx swarmdo agent status --id researcher-abc123
+
+# JSON output
+npx swarmdo 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 swarmdo agent list` - Find agent IDs
+- `npx swarmdo agent metrics` - Aggregate metrics
+- `npx swarmdo agent health` - Health check
+- `npx swarmdo agent logs <id>` - Activity logs

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

@@ -0,0 +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 swarmdo agent stop <agent-id> [options]
+npx swarmdo 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 swarmdo agent stop coder-lx7m9k2
+
+# Force stop (immediate termination)
+npx swarmdo agent stop coder-lx7m9k2 --force
+
+# Custom shutdown timeout
+npx swarmdo agent stop coder-lx7m9k2 --timeout 60
+
+# Using kill alias
+npx swarmdo 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 swarmdo 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 swarmdo 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 swarmdo agent list -t coder --format json | \
+  jq -r '.agents[].id' | \
+  xargs -I {} npx swarmdo agent stop {} -f
+
+# Stop all idle agents
+npx swarmdo agent list -s idle --format json | \
+  jq -r '.agents[].id' | \
+  xargs -I {} npx swarmdo agent stop {}
+```
+
+## Related Commands
+
+- `npx swarmdo agent list` - Find agent IDs
+- `npx swarmdo agent status` - Check status before stopping
+- `npx swarmdo swarm destroy` - Stop all agents in swarm

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

@@ -0,0 +1,54 @@
+# Analysis Commands Compliance Report
+
+## Overview
+Reviewed all command files in `.claude/commands/analysis/` directory to ensure proper usage of:
+- `mcp__swarmdo__*` tools (preferred)
+- `npx swarmdo` commands (as fallback)
+- No direct implementation calls
+
+## Files Reviewed
+
+### 1. token-efficiency.md
+**Status**: ✅ Updated
+**Changes Made**:
+- Replaced `npx swarmdo-swarm hook session-end --export-metrics` with proper MCP tool call
+- Updated to: `Tool: mcp__swarmdo__token_usage` with appropriate parameters
+- Maintained result format and context
+
+**Before**:
+```bash
+npx swarmdo-swarm hook session-end --export-metrics
+```
+
+**After**:
+```
+Tool: mcp__swarmdo__token_usage
+Parameters: {"operation": "session", "timeframe": "24h"}
+```
+
+### 2. performance-bottlenecks.md
+**Status**: ✅ Compliant (No changes needed)
+**Reason**: Already uses proper `mcp__swarmdo__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__swarmdo__*` 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 Swarmdo command standards.

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

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

package/.claude/commands/sDo/analysis/bottleneck-detect.md

@@ -0,0 +1,162 @@
+# bottleneck detect
+
+Analyze performance bottlenecks in swarm operations and suggest optimizations.
+
+## Usage
+
+```bash
+npx swarmdo bottleneck detect [options]
+```
+
+## Options
+
+- `--swarm-id, -s <id>` - Analyze specific swarm (default: current)
+- `--time-range, -t <range>` - Analysis period: 1h, 24h, 7d, all (default: 1h)
+- `--threshold <percent>` - Bottleneck threshold percentage (default: 20)
+- `--export, -e <file>` - Export analysis to file
+- `--fix` - Apply automatic optimizations
+
+## Examples
+
+### Basic bottleneck detection
+
+```bash
+npx swarmdo bottleneck detect
+```
+
+### Analyze specific swarm
+
+```bash
+npx swarmdo bottleneck detect --swarm-id swarm-123
+```
+
+### Last 24 hours with export
+
+```bash
+npx swarmdo bottleneck detect -t 24h -e bottlenecks.json
+```
+
+### Auto-fix detected issues
+
+```bash
+npx swarmdo bottleneck detect --fix --threshold 15
+```
+
+## Metrics Analyzed
+
+### Communication Bottlenecks
+
+- Message queue delays
+- Agent response times
+- Coordination overhead
+- Memory access patterns
+
+### Processing Bottlenecks
+
+- Task completion times
+- Agent utilization rates
+- Parallel execution efficiency
+- Resource contention
+
+### Memory Bottlenecks
+
+- Cache hit rates
+- Memory access patterns
+- Storage I/O performance
+- Neural pattern loading
+
+### Network Bottlenecks
+
+- API call latency
+- MCP communication delays
+- External service timeouts
+- Concurrent request limits
+
+## Output Format
+
+```
+🔍 Bottleneck Analysis Report
+━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Summary
+├── Time Range: Last 1 hour
+├── Agents Analyzed: 6
+├── Tasks Processed: 42
+└── Critical Issues: 2
+
+🚨 Critical Bottlenecks
+1. Agent Communication (35% impact)
+   └── coordinator → coder-1 messages delayed by 2.3s avg
+
+2. Memory Access (28% impact)
+   └── Neural pattern loading taking 1.8s per access
+
+⚠️ Warning Bottlenecks
+1. Task Queue (18% impact)
+   └── 5 tasks waiting > 10s for assignment
+
+💡 Recommendations
+1. Switch to hierarchical topology (est. 40% improvement)
+2. Enable memory caching (est. 25% improvement)
+3. Increase agent concurrency to 8 (est. 20% improvement)
+
+✅ Quick Fixes Available
+Run with --fix to apply:
+- Enable smart caching
+- Optimize message routing
+- Adjust agent priorities
+```
+
+## Automatic Fixes
+
+When using `--fix`, the following optimizations may be applied:
+
+1. **Topology Optimization**
+
+   - Switch to more efficient topology
+   - Adjust communication patterns
+   - Reduce coordination overhead
+
+2. **Caching Enhancement**
+
+   - Enable memory caching
+   - Optimize cache strategies
+   - Preload common patterns
+
+3. **Concurrency Tuning**
+
+   - Adjust agent counts
+   - Optimize parallel execution
+   - Balance workload distribution
+
+4. **Priority Adjustment**
+   - Reorder task queues
+   - Prioritize critical paths
+   - Reduce wait times
+
+## Performance Impact
+
+Typical improvements after bottleneck resolution:
+
+- **Communication**: 30-50% faster message delivery
+- **Processing**: 20-40% reduced task completion time
+- **Memory**: 40-60% fewer cache misses
+- **Overall**: 25-45% performance improvement
+
+## Integration with Claude Code
+
+```javascript
+// Check for bottlenecks in Claude Code
+mcp__swarmdo__bottleneck_detect {
+  timeRange: "1h",
+  threshold: 20,
+  autoFix: false
+}
+```
+
+## See Also
+
+- `performance report` - Detailed performance analysis
+- `token usage` - Token optimization analysis
+- `swarm monitor` - Real-time monitoring
+- `cache manage` - Cache optimization