npm - monomind - Versions diffs - 1.6.0 → 1.6.1 - Mend

monomind 1.6.0 → 1.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1234) hide show

package/.claude/skills/verification-quality/SKILL.md DELETED Viewed

@@ -1,674 +0,0 @@
----
-name: "Verification & Quality Assurance"
-description: |
-  Comprehensive truth scoring, code quality verification, and automatic rollback system with 0.95 accuracy threshold for ensuring high-quality agent outputs and codebase reliability.
----
-# Verification & Quality Assurance Skill
-## What This Skill Does
-This skill provides a comprehensive verification and quality assurance system that ensures code quality and correctness through:
-- **Truth Scoring**: Real-time reliability metrics (0.0-1.0 scale) for code, agents, and tasks
-- **Verification Checks**: Automated code correctness, security, and best practices validation
-- **Automatic Rollback**: Instant reversion of changes that fail verification (default threshold: 0.95)
-- **Quality Metrics**: Statistical analysis with trends, confidence intervals, and improvement tracking
-- **CI/CD Integration**: Export capabilities for continuous integration pipelines
-- **Real-time Monitoring**: Live dashboards and watch modes for ongoing verification
-## Prerequisites
-- Monomind installed (`npx monomind@alpha`)
-- Git repository (for rollback features)
-- Node.js 18+ (for dashboard features)
-## Quick Start
-```bash
-# View current truth scores
-npx monomind@alpha truth
-# Run verification check
-npx monomind@alpha verify check
-# Verify specific file with custom threshold
-npx monomind@alpha verify check --file src/app.js --threshold 0.98
-# Rollback last failed verification
-npx monomind@alpha verify rollback --last-good
-```
----
-## Complete Guide
-### Truth Scoring System
-#### View Truth Metrics
-Display comprehensive quality and reliability metrics for your codebase and agent tasks.
-**Basic Usage:**
-```bash
-# View current truth scores (default: table format)
-npx monomind@alpha truth
-# View scores for specific time period
-npx monomind@alpha truth --period 7d
-# View scores for specific agent
-npx monomind@alpha truth --agent coder --period 24h
-# Find files/tasks below threshold
-npx monomind@alpha truth --threshold 0.8
-```
-**Output Formats:**
-```bash
-# Table format (default)
-npx monomind@alpha truth --format table
-# JSON for programmatic access
-npx monomind@alpha truth --format json
-# CSV for spreadsheet analysis
-npx monomind@alpha truth --format csv
-# HTML report with visualizations
-npx monomind@alpha truth --format html --export report.html
-```
-**Real-time Monitoring:**
-```bash
-# Watch mode with live updates
-npx monomind@alpha truth --watch
-# Export metrics automatically
-npx monomind@alpha truth --export .monomind/metrics/truth-$(date +%Y%m%d).json
-```
-#### Truth Score Dashboard
-Example dashboard output:
-```
-📊 Truth Metrics Dashboard
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Overall Truth Score: 0.947 ✅
-Trend: ↗️ +2.3% (7d)
-Top Performers:
-  verification-agent   0.982 ⭐
-  code-analyzer       0.971 ⭐
-  test-generator      0.958 ✅
-Needs Attention:
-  refactor-agent      0.821 ⚠️
-  docs-generator      0.794 ⚠️
-Recent Tasks:
-  task-456  0.991 ✅  "Implement auth"
-  task-455  0.967 ✅  "Add tests"
-  task-454  0.743 ❌  "Refactor API"
-```
-#### Metrics Explained
-**Truth Scores (0.0-1.0):**
-- `1.0-0.95`: Excellent ⭐ (production-ready)
-- `0.94-0.85`: Good ✅ (acceptable quality)
-- `0.84-0.75`: Warning ⚠️ (needs attention)
-- `<0.75`: Critical ❌ (requires immediate action)
-**Trend Indicators:**
-- ↗️ Improving (positive trend)
-- → Stable (consistent performance)
-- ↘️ Declining (quality regression detected)
-**Statistics:**
-- **Mean Score**: Average truth score across all measurements
-- **Median Score**: Middle value (less affected by outliers)
-- **Standard Deviation**: Consistency of scores (lower = more consistent)
-- **Confidence Interval**: Statistical reliability of measurements
-### Verification Checks
-#### Run Verification
-Execute comprehensive verification checks on code, tasks, or agent outputs.
-**File Verification:**
-```bash
-# Verify single file
-npx monomind@alpha verify check --file src/app.js
-# Verify directory recursively
-npx monomind@alpha verify check --directory src/
-# Verify with auto-fix enabled
-npx monomind@alpha verify check --file src/utils.js --auto-fix
-# Verify current working directory
-npx monomind@alpha verify check
-```
-**Task Verification:**
-```bash
-# Verify specific task output
-npx monomind@alpha verify check --task task-123
-# Verify with custom threshold
-npx monomind@alpha verify check --task task-456 --threshold 0.99
-# Verbose output for debugging
-npx monomind@alpha verify check --task task-789 --verbose
-```
-**Batch Verification:**
-```bash
-# Verify multiple files in parallel
-npx monomind@alpha verify batch --files "*.js" --parallel
-# Verify with pattern matching
-npx monomind@alpha verify batch --pattern "src/**/*.ts"
-# Integration test suite
-npx monomind@alpha verify integration --test-suite full
-```
-#### Verification Criteria
-The verification system evaluates:
-1. **Code Correctness**
-   - Syntax validation
-   - Type checking (TypeScript)
-   - Logic flow analysis
-   - Error handling completeness
-2. **Best Practices**
-   - Code style adherence
-   - SOLID principles
-   - Design patterns usage
-   - Modularity and reusability
-3. **Security**
-   - Vulnerability scanning
-   - Secret detection
-   - Input validation
-   - Authentication/authorization checks
-4. **Performance**
-   - Algorithmic complexity
-   - Memory usage patterns
-   - Database query optimization
-   - Bundle size impact
-5. **Documentation**
-   - JSDoc/TypeDoc completeness
-   - README accuracy
-   - API documentation
-   - Code comments quality
-#### JSON Output for CI/CD
-```bash
-# Get structured JSON output
-npx monomind@alpha verify check --json > verification.json
-# Example JSON structure:
-{
-  "overallScore": 0.947,
-  "passed": true,
-  "threshold": 0.95,
-  "checks": [
-    {
-      "name": "code-correctness",
-      "score": 0.98,
-      "passed": true
-    },
-    {
-      "name": "security",
-      "score": 0.91,
-      "passed": false,
-      "issues": [...]
-    }
-  ]
-}
-```
-### Automatic Rollback
-#### Rollback Failed Changes
-Automatically revert changes that fail verification checks.
-**Basic Rollback:**
-```bash
-# Rollback to last known good state
-npx monomind@alpha verify rollback --last-good
-# Rollback to specific commit
-npx monomind@alpha verify rollback --to-commit abc123
-# Interactive rollback with preview
-npx monomind@alpha verify rollback --interactive
-```
-**Smart Rollback:**
-```bash
-# Rollback only failed files (preserve good changes)
-npx monomind@alpha verify rollback --selective
-# Rollback with automatic backup
-npx monomind@alpha verify rollback --backup-first
-# Dry-run mode (preview without executing)
-npx monomind@alpha verify rollback --dry-run
-```
-**Rollback Performance:**
-- Git-based rollback: <1 second
-- Selective file rollback: <500ms
-- Backup creation: Automatic before rollback
-### Verification Reports
-#### Generate Reports
-Create detailed verification reports with metrics and visualizations.
-**Report Formats:**
-```bash
-# JSON report
-npx monomind@alpha verify report --format json
-# HTML report with charts
-npx monomind@alpha verify report --export metrics.html --format html
-# CSV for data analysis
-npx monomind@alpha verify report --format csv --export metrics.csv
-# Markdown summary
-npx monomind@alpha verify report --format markdown
-```
-**Time-based Reports:**
-```bash
-# Last 24 hours
-npx monomind@alpha verify report --period 24h
-# Last 7 days
-npx monomind@alpha verify report --period 7d
-# Last 30 days with trends
-npx monomind@alpha verify report --period 30d --include-trends
-# Custom date range
-npx monomind@alpha verify report --from 2025-01-01 --to 2025-01-31
-```
-**Report Content:**
-- Overall truth scores
-- Per-agent performance metrics
-- Task completion quality
-- Verification pass/fail rates
-- Rollback frequency
-- Quality improvement trends
-- Statistical confidence intervals
-### Interactive Dashboard
-#### Launch Dashboard
-Run interactive web-based verification dashboard with real-time updates.
-```bash
-# Launch dashboard on default port (3000)
-npx monomind@alpha verify dashboard
-# Custom port
-npx monomind@alpha verify dashboard --port 8080
-# Export dashboard data
-npx monomind@alpha verify dashboard --export
-# Dashboard with auto-refresh
-npx monomind@alpha verify dashboard --refresh 5s
-```
-**Dashboard Features:**
-- Real-time truth score updates (WebSocket)
-- Interactive charts and graphs
-- Agent performance comparison
-- Task history timeline
-- Rollback history viewer
-- Export to PDF/HTML
-- Filter by time period/agent/score
-### Configuration
-#### Default Configuration
-Set verification preferences in `.monomind/config.json`:
-```json
-{
-  "verification": {
-    "threshold": 0.95,
-    "autoRollback": true,
-    "gitIntegration": true,
-    "hooks": {
-      "preCommit": true,
-      "preTask": true,
-      "postEdit": true
-    },
-    "checks": {
-      "codeCorrectness": true,
-      "security": true,
-      "performance": true,
-      "documentation": true,
-      "bestPractices": true
-    }
-  },
-  "truth": {
-    "defaultFormat": "table",
-    "defaultPeriod": "24h",
-    "warningThreshold": 0.85,
-    "criticalThreshold": 0.75,
-    "autoExport": {
-      "enabled": true,
-      "path": ".monomind/metrics/truth-daily.json"
-    }
-  }
-}
-```
-#### Threshold Configuration
-**Adjust verification strictness:**
-```bash
-# Strict mode (99% accuracy required)
-npx monomind@alpha verify check --threshold 0.99
-# Lenient mode (90% acceptable)
-npx monomind@alpha verify check --threshold 0.90
-# Set default threshold
-npx monomind@alpha config set verification.threshold 0.98
-```
-**Per-environment thresholds:**
-```json
-{
-  "verification": {
-    "thresholds": {
-      "production": 0.99,
-      "staging": 0.95,
-      "development": 0.9
-    }
-  }
-}
-```
-### Integration Examples
-#### CI/CD Integration
-**GitHub Actions:**
-```yaml
-name: Quality Verification
-on: [push, pull_request]
-jobs:
-  verify:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v1
-      - name: Install Dependencies
-        run: npm install
-      - name: Run Verification
-        run: |
-          npx monomind@alpha verify check --json > verification.json
-      - name: Check Truth Score
-        run: |
-          score=$(jq '.overallScore' verification.json)
-          if (( $(echo "$score < 0.95" | bc -l) )); then
-            echo "Truth score too low: $score"
-            exit 1
-          fi
-      - name: Upload Report
-        uses: actions/upload-artifact@v1
-        with:
-          name: verification-report
-          path: verification.json
-```
-**GitLab CI:**
-```yaml
-verify:
-  stage: test
-  script:
-    - npx monomind@alpha verify check --threshold 0.95 --json > verification.json
-    - |
-      score=$(jq '.overallScore' verification.json)
-      if [ $(echo "$score < 0.95" | bc) -eq 1 ]; then
-        echo "Verification failed with score: $score"
-        exit 1
-      fi
-  artifacts:
-    paths:
-      - verification.json
-    reports:
-      junit: verification.json
-```
-#### Swarm Integration
-Run verification automatically during swarm operations:
-```bash
-# Swarm with verification enabled
-npx monomind@alpha swarm --verify --threshold 0.98
-# Hive Mind with auto-rollback
-npx monomind@alpha hive-mind --verify --rollback-on-fail
-# Training pipeline with verification
-npx monomind@alpha train --verify --threshold 0.99
-```
-#### Pair Programming Integration
-Enable real-time verification during collaborative development:
-```bash
-# Pair with verification
-npx monomind@alpha pair --verify --real-time
-# Pair with custom threshold
-npx monomind@alpha pair --verify --threshold 0.97 --auto-fix
-```
-### Advanced Workflows
-#### Continuous Verification
-Monitor codebase continuously during development:
-```bash
-# Watch directory for changes
-npx monomind@alpha verify watch --directory src/
-# Watch with auto-fix
-npx monomind@alpha verify watch --directory src/ --auto-fix
-# Watch with notifications
-npx monomind@alpha verify watch --notify --threshold 0.95
-```
-#### Monitoring Integration
-Send metrics to external monitoring systems:
-```bash
-# Export to Prometheus
-npx monomind@alpha truth --format json | \
-  curl -X POST https://pushgateway.example.com/metrics/job/monomind \
-  -d @-
-# Send to DataDog
-npx monomind@alpha verify report --format json | \
-  curl -X POST "https://api.datadoghq.com/api/v1/series?api_key=${DD_API_KEY}" \
-  -H "Content-Type: application/json" \
-  -d @-
-# Custom webhook
-npx monomind@alpha truth --format json | \
-  curl -X POST https://metrics.example.com/api/truth \
-  -H "Content-Type: application/json" \
-  -d @-
-```
-#### Pre-commit Hooks
-Automatically verify before commits:
-```bash
-# Install pre-commit hook
-npx monomind@alpha verify install-hook --pre-commit
-# .git/hooks/pre-commit example:
-#!/bin/bash
-npx monomind@alpha verify check --threshold 0.95 --json > /tmp/verify.json
-score=$(jq '.overallScore' /tmp/verify.json)
-if (( $(echo "$score < 0.95" | bc -l) )); then
-  echo "❌ Verification failed with score: $score"
-  echo "Run 'npx monomind@alpha verify check --verbose' for details"
-  exit 1
-fi
-echo "✅ Verification passed with score: $score"
-```
-### Performance Metrics
-**Verification Speed:**
-- Single file check: <100ms
-- Directory scan: <500ms (per 100 files)
-- Full codebase analysis: <5s (typical project)
-- Truth score calculation: <50ms
-**Rollback Speed:**
-- Git-based rollback: <1s
-- Selective file rollback: <500ms
-- Backup creation: <2s
-**Dashboard Performance:**
-- Initial load: <1s
-- Real-time updates: <100ms latency (WebSocket)
-- Chart rendering: 60 FPS
-### Troubleshooting
-#### Common Issues
-**Low Truth Scores:**
-```bash
-# Get detailed breakdown
-npx monomind@alpha truth --verbose --threshold 0.0
-# Check specific criteria
-npx monomind@alpha verify check --verbose
-# View agent-specific issues
-npx monomind@alpha truth --agent <agent-name> --format json
-```
-**Rollback Failures:**
-```bash
-# Check git status
-git status
-# View rollback history
-npx monomind@alpha verify rollback --history
-# Manual rollback
-git reset --hard HEAD~1
-```
-**Verification Timeouts:**
-```bash
-# Increase timeout
-npx monomind@alpha verify check --timeout 60s
-# Verify in batches
-npx monomind@alpha verify batch --batch-size 10
-```
-### Exit Codes
-Verification commands return standard exit codes:
-- `0`: Verification passed (score ≥ threshold)
-- `1`: Verification failed (score < threshold)
-- `2`: Error during verification (invalid input, system error)
-### Related Commands
-- `npx monomind@alpha pair` - Collaborative development with verification
-- `npx monomind@alpha train` - Training with verification feedback
-- `npx monomind@alpha swarm` - Multi-agent coordination with quality checks
-- `npx monomind@alpha report` - Generate comprehensive project reports
-### Best Practices
-1. **Set Appropriate Thresholds**: Use 0.99 for critical code, 0.95 for standard, 0.90 for experimental
-2. **Enable Auto-rollback**: Prevent bad code from persisting
-3. **Monitor Trends**: Track improvement over time, not just current scores
-4. **Integrate with CI/CD**: Make verification part of your pipeline
-5. **Use Watch Mode**: Get immediate feedback during development
-6. **Export Metrics**: Track quality metrics in your monitoring system
-7. **Review Rollbacks**: Understand why changes were rejected
-8. **Train Agents**: Use verification feedback to improve agent performance
-### Additional Resources
-- Truth Scoring Algorithm: See `/docs/truth-scoring.md`
-- Verification Criteria: See `/docs/verification-criteria.md`
-- Integration Examples: See `/examples/verification/`
-- API Reference: See `/docs/api/verification.md`