burhan-mop 0.1.0

package/.claude/commands/agents/agent-types.md

@@ -0,0 +1,216 @@
+---
+name: agent-types
+description: Complete guide to all 87 available agent types in Claude Flow V3
+type: reference
+---
+
+# Agent Types Reference
+
+Complete guide to all 87 available agent types in Claude Flow V3.
+
+## Core Development (5)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `coder` | Code implementation with neural patterns | Feature development, bug fixes |
+| `reviewer` | Code quality assurance | PR reviews, security checks |
+| `tester` | Testing with automation | Unit tests, integration tests |
+| `planner` | Strategic task planning | Project planning, roadmaps |
+| `researcher` | Information gathering | Requirements, documentation |
+
+## V3 Specialized (12)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `security-architect` | Security architecture | Threat modeling, design |
+| `security-auditor` | CVE remediation | Vulnerability scanning |
+| `memory-specialist` | AgentDB unification | 150x-12,500x search |
+| `performance-engineer` | Optimization targets | 2.49x-7.47x speedup |
+| `core-architect` | DDD restructure | Domain modeling |
+| `adr-architect` | Architecture decisions | ADR documentation |
+| `claims-authorizer` | Access control | Claims-based auth |
+| `ddd-domain-expert` | Domain design | Bounded contexts |
+| `reasoningbank-learner` | Pattern learning | Self-improvement |
+| `sona-learning-optimizer` | Neural optimization | SONA adaptation |
+| `sparc-orchestrator` | SPARC methodology | Development workflow |
+| `v3-integration-architect` | V3 integration | System integration |
+
+## Swarm Coordination (6)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `hierarchical-coordinator` | Queen-led coordination | Complex projects |
+| `mesh-coordinator` | P2P peer networks | Research tasks |
+| `adaptive-coordinator` | Dynamic topology | Unknown workloads |
+| `collective-intelligence-coordinator` | Consensus decisions | Group decisions |
+| `swarm-memory-manager` | Distributed memory | Data sharing |
+| `coordinator-swarm-init` | Swarm initialization | Setup |
+
+## Consensus Agents (7)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `byzantine-coordinator` | BFT consensus | Fault tolerance |
+| `raft-manager` | Leader-based consensus | Consistent state |
+| `gossip-coordinator` | Eventual consistency | Scalability |
+| `crdt-synchronizer` | CRDT replication | Conflict-free sync |
+| `quorum-manager` | Quorum consensus | Voting systems |
+| `security-manager` | Consensus security | Secure coordination |
+| `consensus-coordinator` | General consensus | Distributed systems |
+
+## GitHub Integration (14)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `pr-manager` | PR lifecycle | Pull requests |
+| `code-review-swarm` | Multi-agent review | Comprehensive reviews |
+| `issue-tracker` | Issue management | Bug tracking |
+| `release-manager` | Release coordination | Versioning |
+| `workflow-automation` | CI/CD automation | GitHub Actions |
+| `github-modes` | GitHub operations | Multi-mode GitHub |
+| `multi-repo-swarm` | Cross-repo sync | Monorepo management |
+| `project-board-sync` | Project boards | Kanban/Projects |
+| `release-swarm` | Release automation | Deployments |
+| `repo-architect` | Repository structure | Architecture |
+| `swarm-issue` | Issue-based swarms | Task decomposition |
+| `swarm-pr` | PR-based swarms | Review workflows |
+| `sync-coordinator` | Multi-repo sync | Version alignment |
+| `github-pr-manager` | PR management template | PR workflows |
+
+## SPARC Methodology (5)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `sparc-coordinator` | SPARC orchestration | Full SPARC cycle |
+| `specification` | Requirements phase | Specs writing |
+| `pseudocode` | Algorithm design | Logic design |
+| `architecture` | System design | Architecture |
+| `refinement` | Iteration phase | Improvements |
+
+## Optimization (6)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `topology-optimizer` | Swarm topology | Network optimization |
+| `load-balancer` | Task distribution | Workload balancing |
+| `resource-allocator` | Resource management | Capacity planning |
+| `performance-monitor` | Metrics tracking | Observability |
+| `benchmark-suite` | Performance testing | Benchmarks |
+| `performance-analyzer` | Analysis | Bottleneck detection |
+
+## Sublinear Algorithms (5)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `matrix-optimizer` | Matrix analysis | Linear systems |
+| `pagerank-analyzer` | Graph analysis | Network influence |
+| `performance-optimizer` | System optimization | Resource efficiency |
+| `trading-predictor` | Market analysis | Financial predictions |
+| `consensus-coordinator` | Fast consensus | Distributed coordination |
+
+## Analysis (2)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `analyze-code-quality` | Code quality | Static analysis |
+| `code-analyzer` | Code analysis | Pattern detection |
+
+## Architecture (1)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `arch-system-design` | System design | High-level architecture |
+
+## Data & ML (1)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `data-ml-model` | ML models | Machine learning |
+
+## Development (1)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `dev-backend-api` | Backend APIs | REST/GraphQL |
+
+## DevOps (1)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `ops-cicd-github` | CI/CD pipelines | GitHub Actions |
+
+## Documentation (1)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `docs-api-openapi` | API documentation | OpenAPI specs |
+
+## Flow Nexus (9)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `app-store` | App marketplace | App publishing |
+| `authentication` | User auth | Login/registration |
+| `challenges` | Coding challenges | Gamification |
+| `neural-network` | Neural training | ML deployment |
+| `payments` | Payment processing | Credits/billing |
+| `sandbox` | E2B sandboxes | Isolated execution |
+| `swarm` | Cloud swarms | Cloud coordination |
+| `user-tools` | User management | Profile/storage |
+| `workflow` | Workflow automation | Event-driven |
+
+## Goal Planning (2)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `goal-planner` | GOAP planning | Goal achievement |
+| `agent` | General goal agent | Multi-purpose |
+
+## Payments (1)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `agentic-payments` | AI commerce | Autonomous payments |
+
+## Specialized (1)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `spec-mobile-react-native` | React Native | Mobile development |
+
+## Templates (8)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `automation-smart-agent` | Smart automation | Auto-spawning |
+| `coordinator-swarm-init` | Swarm setup | Initialization |
+| `github-pr-manager` | PR workflows | GitHub PRs |
+| `implementer-sparc-coder` | SPARC coding | Implementation |
+| `memory-coordinator` | Memory management | State coordination |
+| `orchestrator-task` | Task orchestration | Workflow management |
+| `performance-analyzer` | Performance | Analysis |
+| `sparc-coordinator` | SPARC | Methodology |
+
+## Testing (3)
+
+| Agent | Description | Best For |
+|-------|-------------|----------|
+| `tdd-london-swarm` | TDD London School | Mock-first TDD |
+| `production-validator` | Deployment validation | Pre-deploy checks |
+| `test-long-runner` | Long-running tests | Complex test suites |
+
+## Quick Reference
+
+```bash
+# List all agent types
+npx claude-flow agent spawn --help
+
+# Spawn any agent
+npx claude-flow agent spawn -t <agent-type>
+```
+
+## See Also
+
+- [agent-capabilities](./agent-capabilities.md) - Capability matrix
+- [agent-coordination](./agent-coordination.md) - Coordination patterns
+- [spawn](./spawn.md) - Spawn command details

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

@@ -0,0 +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

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

@@ -0,0 +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`

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

@@ -0,0 +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

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

@@ -0,0 +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