@monoes/monomindcli 1.8.0 → 1.9.0

package/.claude/commands/github/workflow-automation.md

@@ -1,468 +0,0 @@
-# Workflow Automation - GitHub Actions Integration
-
-## Overview
-
-Integrate AI swarms with GitHub Actions to create intelligent, self-organizing CI/CD pipelines that adapt to your codebase.
-
-## Core Features
-
-### 1. Swarm-Powered Actions
-
-```yaml
-# .github/workflows/swarm-ci.yml
-name: Intelligent CI with Swarms
-on: [push, pull_request]
-
-jobs:
-  swarm-analysis:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v1
-
-      - name: Initialize Swarm
-        uses: nokhodian/swarm-action@v1
-        with:
-          topology: mesh
-          max-agents: 6
-
-      - name: Analyze Changes
-        run: |
-          npx ruv-swarm actions analyze \
-            --commit ${{ github.sha }} \
-            --suggest-tests \
-            --optimize-pipeline
-```
-
-### 2. Dynamic Workflow Generation
-
-```bash
-# Generate workflows based on code analysis
-npx ruv-swarm actions generate-workflow \
-  --analyze-codebase \
-  --detect-languages \
-  --create-optimal-pipeline
-```
-
-### 3. Intelligent Test Selection
-
-```yaml
-# Smart test runner
-- name: Swarm Test Selection
-  run: |
-    npx ruv-swarm actions smart-test \
-      --changed-files ${{ steps.files.outputs.all }} \
-      --impact-analysis \
-      --parallel-safe
-```
-
-## Workflow Templates
-
-### Multi-Language Detection
-
-```yaml
-# .github/workflows/polyglot-swarm.yml
-name: Polyglot Project Handler
-on: push
-
-jobs:
-  detect-and-build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v1
-
-      - name: Detect Languages
-        id: detect
-        run: |
-          npx ruv-swarm actions detect-stack \
-            --output json > stack.json
-
-      - name: Dynamic Build Matrix
-        run: |
-          npx ruv-swarm actions create-matrix \
-            --from stack.json \
-            --parallel-builds
-```
-
-### Adaptive Security Scanning
-
-```yaml
-# .github/workflows/security-swarm.yml
-name: Intelligent Security Scan
-on:
-  schedule:
-    - cron: "0 0 * * *"
-  workflow_dispatch:
-
-jobs:
-  security-swarm:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Security Analysis Swarm
-        run: |
-          # Use gh CLI for issue creation
-          SECURITY_ISSUES=$(npx ruv-swarm actions security \
-            --deep-scan \
-            --format json)
-
-          # Create issues for complex security problems
-          echo "$SECURITY_ISSUES" | jq -r '.issues[]? | @base64' | while read -r issue; do
-            _jq() {
-              echo ${issue} | base64 --decode | jq -r ${1}
-            }
-            gh issue create \
-              --title "$(_jq '.title')" \
-              --body "$(_jq '.body')" \
-              --label "security,critical"
-          done
-```
-
-## Action Commands
-
-### Pipeline Optimization
-
-```bash
-# Optimize existing workflows
-npx ruv-swarm actions optimize \
-  --workflow ".github/workflows/ci.yml" \
-  --suggest-parallelization \
-  --reduce-redundancy \
-  --estimate-savings
-```
-
-### Failure Analysis
-
-```bash
-# Analyze failed runs using gh CLI
-gh run view ${{ github.run_id }} --json jobs,conclusion | \
-  npx ruv-swarm actions analyze-failure \
-    --suggest-fixes \
-    --auto-retry-flaky
-
-# Create issue for persistent failures
-if [ $? -ne 0 ]; then
-  gh issue create \
-    --title "CI Failure: Run ${{ github.run_id }}" \
-    --body "Automated analysis detected persistent failures" \
-    --label "ci-failure"
-fi
-```
-
-### Resource Management
-
-```bash
-# Optimize resource usage
-npx ruv-swarm actions resources \
-  --analyze-usage \
-  --suggest-runners \
-  --cost-optimize
-```
-
-## Advanced Workflows
-
-### 1. Self-Healing CI/CD
-
-```yaml
-# Auto-fix common CI failures
-name: Self-Healing Pipeline
-on: workflow_run
-
-jobs:
-  heal-pipeline:
-    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
-    runs-on: ubuntu-latest
-    steps:
-      - name: Diagnose and Fix
-        run: |
-          npx ruv-swarm actions self-heal \
-            --run-id ${{ github.event.workflow_run.id }} \
-            --auto-fix-common \
-            --create-pr-complex
-```
-
-### 2. Progressive Deployment
-
-```yaml
-# Intelligent deployment strategy
-name: Smart Deployment
-on:
-  push:
-    branches: [main]
-
-jobs:
-  progressive-deploy:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Analyze Risk
-        id: risk
-        run: |
-          npx ruv-swarm actions deploy-risk \
-            --changes ${{ github.sha }} \
-            --history 30d
-
-      - name: Choose Strategy
-        run: |
-          npx ruv-swarm actions deploy-strategy \
-            --risk ${{ steps.risk.outputs.level }} \
-            --auto-execute
-```
-
-### 3. Performance Regression Detection
-
-```yaml
-# Automatic performance testing
-name: Performance Guard
-on: pull_request
-
-jobs:
-  perf-swarm:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Performance Analysis
-        run: |
-          npx ruv-swarm actions perf-test \
-            --baseline main \
-            --threshold 10% \
-            --auto-profile-regression
-```
-
-## Custom Actions
-
-### Swarm Action Development
-
-```javascript
-// action.yml
-name: "Swarm Custom Action";
-description: "Custom swarm-powered action";
-inputs: task: description: "Task for swarm";
-required: true;
-runs: using: "node16";
-main: "dist/index.js";
-
-// index.js
-const { SwarmAction } = require("ruv-swarm");
-
-async function run() {
-  const swarm = new SwarmAction({
-    topology: "mesh",
-    agents: ["analyzer", "optimizer"],
-  });
-
-  await swarm.execute(core.getInput("task"));
-}
-```
-
-## Matrix Strategies
-
-### Dynamic Test Matrix
-
-```yaml
-# Generate test matrix from code analysis
-jobs:
-  generate-matrix:
-    outputs:
-      matrix: ${{ steps.set-matrix.outputs.matrix }}
-    steps:
-      - id: set-matrix
-        run: |
-          MATRIX=$(npx ruv-swarm actions test-matrix \
-            --detect-frameworks \
-            --optimize-coverage)
-          echo "matrix=${MATRIX}" >> $GITHUB_OUTPUT
-
-  test:
-    needs: generate-matrix
-    strategy:
-      matrix: ${{fromJson(needs.generate-matrix.outputs.matrix)}}
-```
-
-### Intelligent Parallelization
-
-```bash
-# Determine optimal parallelization
-npx ruv-swarm actions parallel-strategy \
-  --analyze-dependencies \
-  --time-estimates \
-  --cost-aware
-```
-
-## Monitoring & Insights
-
-### Workflow Analytics
-
-```bash
-# Analyze workflow performance
-npx ruv-swarm actions analytics \
-  --workflow "ci.yml" \
-  --period 30d \
-  --identify-bottlenecks \
-  --suggest-improvements
-```
-
-### Cost Optimization
-
-```bash
-# Optimize GitHub Actions costs
-npx ruv-swarm actions cost-optimize \
-  --analyze-usage \
-  --suggest-caching \
-  --recommend-self-hosted
-```
-
-### Failure Patterns
-
-```bash
-# Identify failure patterns
-npx ruv-swarm actions failure-patterns \
-  --period 90d \
-  --classify-failures \
-  --suggest-preventions
-```
-
-## Integration Examples
-
-### 1. PR Validation Swarm
-
-```yaml
-name: PR Validation Swarm
-on: pull_request
-
-jobs:
-  validate:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Multi-Agent Validation
-        run: |
-          # Get PR details using gh CLI
-          PR_DATA=$(gh pr view ${{ github.event.pull_request.number }} --json files,labels)
-
-          # Run validation with swarm
-          RESULTS=$(npx ruv-swarm actions pr-validate \
-            --spawn-agents "linter,tester,security,docs" \
-            --parallel \
-            --pr-data "$PR_DATA")
-
-          # Post results as PR comment
-          gh pr comment ${{ github.event.pull_request.number }} \
-            --body "$RESULTS"
-```
-
-### 2. Release Automation
-
-```yaml
-name: Intelligent Release
-on:
-  push:
-    tags: ["v*"]
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Release Swarm
-        run: |
-          npx ruv-swarm actions release \
-            --analyze-changes \
-            --generate-notes \
-            --create-artifacts \
-            --publish-smart
-```
-
-### 3. Documentation Updates
-
-```yaml
-name: Auto Documentation
-on:
-  push:
-    paths: ["src/**"]
-
-jobs:
-  docs:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Documentation Swarm
-        run: |
-          npx ruv-swarm actions update-docs \
-            --analyze-changes \
-            --update-api-docs \
-            --check-examples
-```
-
-## Best Practices
-
-### 1. Workflow Organization
-
-- Use reusable workflows for swarm operations
-- Implement proper caching strategies
-- Set appropriate timeouts
-- Use workflow dependencies wisely
-
-### 2. Security
-
-- Store swarm configs in secrets
-- Use OIDC for authentication
-- Implement least-privilege principles
-- Audit swarm operations
-
-### 3. Performance
-
-- Cache swarm dependencies
-- Use appropriate runner sizes
-- Implement early termination
-- Optimize parallel execution
-
-## Advanced Features
-
-### Predictive Failures
-
-```bash
-# Predict potential failures
-npx ruv-swarm actions predict \
-  --analyze-history \
-  --identify-risks \
-  --suggest-preventive
-```
-
-### Workflow Recommendations
-
-```bash
-# Get workflow recommendations
-npx ruv-swarm actions recommend \
-  --analyze-repo \
-  --suggest-workflows \
-  --industry-best-practices
-```
-
-### Automated Optimization
-
-```bash
-# Continuously optimize workflows
-npx ruv-swarm actions auto-optimize \
-  --monitor-performance \
-  --apply-improvements \
-  --track-savings
-```
-
-## Debugging & Troubleshooting
-
-### Debug Mode
-
-```yaml
-- name: Debug Swarm
-  run: |
-    npx ruv-swarm actions debug \
-      --verbose \
-      --trace-agents \
-      --export-logs
-```
-
-### Performance Profiling
-
-```bash
-# Profile workflow performance
-npx ruv-swarm actions profile \
-  --workflow "ci.yml" \
-  --identify-slow-steps \
-  --suggest-optimizations
-```
-
-See also: [swarm-pr.md](./swarm-pr.md), [release-swarm.md](./release-swarm.md)

package/.claude/commands/hive-mind/hive-mind-metrics.md

@@ -1,8 +0,0 @@
-# hive-mind-metrics
-
-Command documentation for hive-mind-metrics in category hive-mind.
-
-Usage:
-```bash
-npx monomind hive-mind hive-mind-metrics [options]
-```

package/.claude/commands/hive-mind/hive-mind-resume.md

@@ -1,8 +0,0 @@
-# hive-mind-resume
-
-Command documentation for hive-mind-resume in category hive-mind.
-
-Usage:
-```bash
-npx monomind hive-mind hive-mind-resume [options]
-```

package/.claude/commands/hive-mind/hive-mind-sessions.md

@@ -1,8 +0,0 @@
-# hive-mind-sessions
-
-Command documentation for hive-mind-sessions in category hive-mind.
-
-Usage:
-```bash
-npx monomind hive-mind hive-mind-sessions [options]
-```

package/.claude/commands/hive-mind/hive-mind-wizard.md

@@ -1,8 +0,0 @@
-# hive-mind-wizard
-
-Command documentation for hive-mind-wizard in category hive-mind.
-
-Usage:
-```bash
-npx monomind hive-mind hive-mind-wizard [options]
-```

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

@@ -1,17 +0,0 @@
----
-description: List all available extras specialist agents, optionally filtered by category.
----
-
-List all extras specialist agents from the non-dev agent registry.
-
-**Usage:** `/list-agents` or `/list-agents <category>`
-
-**Categories:** academic, design, marketing, paid-media, product, project-management, sales, specialized, support
-
-Run this immediately:
-
-```bash
-node "${CLAUDE_PROJECT_DIR:-/Users/morteza/Desktop/tools/monomind}/.claude/helpers/hook-handler.cjs" list-extras $ARGUMENTS
-```
-
-After running, show the output to the user as a formatted list grouped by category. Mention they can activate any agent with `/use-agent <slug>`.

package/.claude/commands/memory/memory-persist.md

@@ -1,25 +0,0 @@
-# memory-persist
-
-Persist memory across sessions.
-
-## Usage
-```bash
-npx monomind memory persist [options]
-```
-
-## Options
-- `--export <file>` - Export to file
-- `--import <file>` - Import from file
-- `--compress` - Compress memory data
-
-## Examples
-```bash
-# Export memory
-npx monomind memory persist --export memory-backup.json
-
-# Import memory
-npx monomind memory persist --import memory-backup.json
-
-# Compressed export
-npx monomind memory persist --export memory.gz --compress
-```

package/.claude/commands/memory/memory-usage.md

@@ -1,25 +0,0 @@
-# memory-usage
-
-Manage persistent memory storage.
-
-## Usage
-```bash
-npx monomind memory usage [options]
-```
-
-## Options
-- `--action <type>` - Action (store, retrieve, list, clear)
-- `--key <key>` - Memory key
-- `--value <data>` - Data to store (JSON)
-
-## Examples
-```bash
-# Store memory
-npx monomind memory usage --action store --key "project-config" --value '{"api": "v2"}'
-
-# Retrieve memory
-npx monomind memory usage --action retrieve --key "project-config"
-
-# List all keys
-npx monomind memory usage --action list
-```

package/.claude/commands/memory/neural.md

@@ -1,47 +0,0 @@
-# Neural Pattern Training
-
-## 🎯 Key Principle
-**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
-
-## MCP Tool Usage in Claude Code
-
-**Tool:** `mcp__monomind__neural_train`
-
-## Parameters
-```json
-{
-  "pattern_type": "coordination",
-  "training_data": "task decomposition patterns",
-  "epochs": 50
-}
-```
-
-## Description
-Improve coordination patterns through neural network training
-
-## Details
-Training improves:
-- Task breakdown effectiveness
-- Coordination pattern selection
-- Resource allocation strategies
-- Overall coordination efficiency
-
-## Example Usage
-
-**In Claude Code:**
-1. Train coordination patterns: Use tool `mcp__monomind__neural_train` with parameters `{"pattern_type": "coordination", "training_data": "successful task patterns", "epochs": 50}`
-2. Train optimization patterns: Use tool `mcp__monomind__neural_train` with parameters `{"pattern_type": "optimization", "training_data": "performance metrics", "epochs": 30}`
-3. Check training status: Use tool `mcp__monomind__neural_status`
-4. Analyze patterns: Use tool `mcp__monomind__neural_patterns` with parameters `{"action": "analyze"}`
-
-## Important Reminders
-- ✅ This tool provides coordination and structure
-- ✅ Claude Code performs all actual implementation
-- ❌ The tool does NOT write code
-- ❌ The tool does NOT access files directly
-- ❌ The tool does NOT execute commands
-
-## See Also
-- Main documentation: /CLAUDE.md
-- Other commands in this category
-- Workflow examples in /workflows/

package/.claude/commands/metrics.md

@@ -1,11 +0,0 @@
-Show the full Monomind system metrics dashboard: statusline panel + today's token usage breakdown.
-
-Run these two shell commands immediately without asking for confirmation:
-
-```bash
-node "${CLAUDE_PROJECT_DIR:-/Users/morteza/Desktop/tools/monomind}/.claude/helpers/statusline.cjs"
-echo ""
-node "${CLAUDE_PROJECT_DIR:-/Users/morteza/Desktop/tools/monomind}/.claude/helpers/token-tracker.cjs" report today
-```
-
-Show the full output verbatim. No other commentary needed.

package/.claude/commands/monitoring/real-time-view.md

@@ -1,25 +0,0 @@
-# real-time-view
-
-Real-time view of swarm activity.
-
-## Usage
-```bash
-npx monomind monitoring real-time-view [options]
-```
-
-## Options
-- `--filter <type>` - Filter view
-- `--highlight <pattern>` - Highlight pattern
-- `--tail <n>` - Show last N events
-
-## Examples
-```bash
-# Start real-time view
-npx monomind monitoring real-time-view
-
-# Filter errors
-npx monomind monitoring real-time-view --filter errors
-
-# Highlight pattern
-npx monomind monitoring real-time-view --highlight "API"
-```

package/.claude/commands/monitoring/swarm-monitor.md

@@ -1,25 +0,0 @@
-# swarm-monitor
-
-Real-time swarm monitoring.
-
-## Usage
-```bash
-npx monomind swarm monitor [options]
-```
-
-## Options
-- `--interval <ms>` - Update interval
-- `--metrics` - Show detailed metrics
-- `--export` - Export monitoring data
-
-## Examples
-```bash
-# Start monitoring
-npx monomind swarm monitor
-
-# Custom interval
-npx monomind swarm monitor --interval 5000
-
-# With metrics
-npx monomind swarm monitor --metrics
-```