@claude-flow/cli 3.28.0 → 3.30.0

package/.claude/commands/truth/start.md

@@ -1,143 +1,143 @@
-# 📊 Truth Command
-
-View truth scores and reliability metrics for your codebase and agent tasks.
-
-## Overview
-
-The `truth` command provides comprehensive insights into code quality, agent performance, and verification metrics.
-
-## Usage
-
-```bash
-claude-flow truth [options]
-```
-
-## Options
-
-- `--format <type>` - Output format: table (default), json, csv, html
-- `--period <time>` - Time period: 1h, 24h, 7d, 30d
-- `--agent <name>` - Filter by specific agent
-- `--threshold <0-1>` - Show only scores below threshold
-- `--export <file>` - Export metrics to file
-- `--watch` - Real-time monitoring mode
-
-## Metrics Displayed
-
-### Truth Scores
-- **Overall Score**: Aggregate truth score (0.0-1.0)
-- **File Scores**: Individual file truth ratings
-- **Agent Scores**: Per-agent reliability metrics
-- **Task Scores**: Task completion quality
-
-### Trends
-- **Improvement Rate**: Quality trend over time
-- **Regression Detection**: Identifies declining scores
-- **Agent Learning**: Shows agent improvement curves
-
-### Statistics
-- **Mean Score**: Average truth score
-- **Median Score**: Middle value of scores
-- **Standard Deviation**: Score consistency
-- **Confidence Interval**: Statistical reliability
-
-## Examples
-
-### Basic Usage
-```bash
-# View current truth scores
-claude-flow truth
-
-# View scores for last 7 days
-claude-flow truth --period 7d
-
-# Export to HTML report
-claude-flow truth --export report.html --format html
-```
-
-### Advanced Analysis
-```bash
-# Monitor real-time scores
-claude-flow truth --watch
-
-# Find problematic files
-claude-flow truth --threshold 0.8
-
-# Agent-specific metrics
-claude-flow truth --agent coder --period 24h
-
-# JSON for processing
-claude-flow truth --format json | jq '.overall_score'
-```
-
-## Dashboard View
-
-```
-📊 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"
-```
-
-## Integration
-
-### With CI/CD
-```yaml
-# GitHub Actions example
-- name: Check Truth Scores
-  run: |
-    claude-flow truth --format json > truth.json
-    score=$(jq '.overall_score' truth.json)
-    if (( $(echo "$score < 0.95" | bc -l) )); then
-      echo "Truth score too low: $score"
-      exit 1
-    fi
-```
-
-### With Monitoring
-```bash
-# Send to monitoring system
-claude-flow truth --format json | \
-  curl -X POST https://metrics.example.com/api/truth \
-  -H "Content-Type: application/json" \
-  -d @-
-```
-
-## Configuration
-
-Set truth display preferences in `.claude-flow/config.json`:
-
-```json
-{
-  "truth": {
-    "defaultFormat": "table",
-    "defaultPeriod": "24h",
-    "warningThreshold": 0.85,
-    "criticalThreshold": 0.75,
-    "autoExport": {
-      "enabled": true,
-      "path": ".claude-flow/metrics/truth-daily.json"
-    }
-  }
-}
-```
-
-## Related Commands
-
-- `verify` - Run verification checks
-- `pair` - Collaborative development with truth tracking
+# 📊 Truth Command
+
+View truth scores and reliability metrics for your codebase and agent tasks.
+
+## Overview
+
+The `truth` command provides comprehensive insights into code quality, agent performance, and verification metrics.
+
+## Usage
+
+```bash
+claude-flow truth [options]
+```
+
+## Options
+
+- `--format <type>` - Output format: table (default), json, csv, html
+- `--period <time>` - Time period: 1h, 24h, 7d, 30d
+- `--agent <name>` - Filter by specific agent
+- `--threshold <0-1>` - Show only scores below threshold
+- `--export <file>` - Export metrics to file
+- `--watch` - Real-time monitoring mode
+
+## Metrics Displayed
+
+### Truth Scores
+- **Overall Score**: Aggregate truth score (0.0-1.0)
+- **File Scores**: Individual file truth ratings
+- **Agent Scores**: Per-agent reliability metrics
+- **Task Scores**: Task completion quality
+
+### Trends
+- **Improvement Rate**: Quality trend over time
+- **Regression Detection**: Identifies declining scores
+- **Agent Learning**: Shows agent improvement curves
+
+### Statistics
+- **Mean Score**: Average truth score
+- **Median Score**: Middle value of scores
+- **Standard Deviation**: Score consistency
+- **Confidence Interval**: Statistical reliability
+
+## Examples
+
+### Basic Usage
+```bash
+# View current truth scores
+claude-flow truth
+
+# View scores for last 7 days
+claude-flow truth --period 7d
+
+# Export to HTML report
+claude-flow truth --export report.html --format html
+```
+
+### Advanced Analysis
+```bash
+# Monitor real-time scores
+claude-flow truth --watch
+
+# Find problematic files
+claude-flow truth --threshold 0.8
+
+# Agent-specific metrics
+claude-flow truth --agent coder --period 24h
+
+# JSON for processing
+claude-flow truth --format json | jq '.overall_score'
+```
+
+## Dashboard View
+
+```
+📊 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"
+```
+
+## Integration
+
+### With CI/CD
+```yaml
+# GitHub Actions example
+- name: Check Truth Scores
+  run: |
+    claude-flow truth --format json > truth.json
+    score=$(jq '.overall_score' truth.json)
+    if (( $(echo "$score < 0.95" | bc -l) )); then
+      echo "Truth score too low: $score"
+      exit 1
+    fi
+```
+
+### With Monitoring
+```bash
+# Send to monitoring system
+claude-flow truth --format json | \
+  curl -X POST https://metrics.example.com/api/truth \
+  -H "Content-Type: application/json" \
+  -d @-
+```
+
+## Configuration
+
+Set truth display preferences in `.claude-flow/config.json`:
+
+```json
+{
+  "truth": {
+    "defaultFormat": "table",
+    "defaultPeriod": "24h",
+    "warningThreshold": 0.85,
+    "criticalThreshold": 0.75,
+    "autoExport": {
+      "enabled": true,
+      "path": ".claude-flow/metrics/truth-daily.json"
+    }
+  }
+}
+```
+
+## Related Commands
+
+- `verify` - Run verification checks
+- `pair` - Collaborative development with truth tracking
 - `report` - Generate detailed reports

package/.claude/commands/verify/check.md

@@ -1,50 +1,50 @@
-# verify check
-
-Run verification checks on code, tasks, or agent outputs.
-
-## Usage
-
-```bash
-claude-flow verify check [options]
-```
-
-## Options
-
-- `--file <path>` - Verify specific file
-- `--task <id>` - Verify task output
-- `--directory <path>` - Verify entire directory
-- `--threshold <0-1>` - Override default threshold (0.95)
-- `--auto-fix` - Attempt automatic fixes
-- `--json` - Output results as JSON
-- `--verbose` - Show detailed verification steps
-
-## Examples
-
-```bash
-# Basic file verification
-claude-flow verify check --file src/app.js
-
-# Verify with higher threshold
-claude-flow verify check --file src/critical.js --threshold 0.99
-
-# Verify and auto-fix issues
-claude-flow verify check --directory src/ --auto-fix
-
-# Get JSON output for CI/CD
-claude-flow verify check --json > verification.json
-```
-
-## Truth Scoring
-
-The check command evaluates:
-- Code correctness
-- Best practices adherence
-- Security vulnerabilities
-- Performance implications
-- Documentation completeness
-
-## Exit Codes
-
-- `0` - Verification passed
-- `1` - Verification failed
+# verify check
+
+Run verification checks on code, tasks, or agent outputs.
+
+## Usage
+
+```bash
+claude-flow verify check [options]
+```
+
+## Options
+
+- `--file <path>` - Verify specific file
+- `--task <id>` - Verify task output
+- `--directory <path>` - Verify entire directory
+- `--threshold <0-1>` - Override default threshold (0.95)
+- `--auto-fix` - Attempt automatic fixes
+- `--json` - Output results as JSON
+- `--verbose` - Show detailed verification steps
+
+## Examples
+
+```bash
+# Basic file verification
+claude-flow verify check --file src/app.js
+
+# Verify with higher threshold
+claude-flow verify check --file src/critical.js --threshold 0.99
+
+# Verify and auto-fix issues
+claude-flow verify check --directory src/ --auto-fix
+
+# Get JSON output for CI/CD
+claude-flow verify check --json > verification.json
+```
+
+## Truth Scoring
+
+The check command evaluates:
+- Code correctness
+- Best practices adherence
+- Security vulnerabilities
+- Performance implications
+- Documentation completeness
+
+## Exit Codes
+
+- `0` - Verification passed
+- `1` - Verification failed
 - `2` - Error during verification

package/.claude/commands/verify/start.md

@@ -1,128 +1,128 @@
-# 🔍 Verification Commands
-
-Truth verification system for ensuring code quality and correctness with a 0.95 accuracy threshold.
-
-## Overview
-
-The verification system provides real-time truth checking and validation for all agent tasks, ensuring high-quality outputs and automatic rollback on failures.
-
-## Subcommands
-
-### `verify check`
-Run verification checks on current code or agent outputs.
-
-```bash
-claude-flow verify check --file src/app.js
-claude-flow verify check --task "task-123"
-claude-flow verify check --threshold 0.98
-```
-
-### `verify rollback`
-Automatically rollback changes that fail verification.
-
-```bash
-claude-flow verify rollback --to-commit abc123
-claude-flow verify rollback --last-good
-claude-flow verify rollback --interactive
-```
-
-### `verify report`
-Generate verification reports and metrics.
-
-```bash
-claude-flow verify report --format json
-claude-flow verify report --export metrics.html
-claude-flow verify report --period 7d
-```
-
-### `verify dashboard`
-Launch interactive verification dashboard.
-
-```bash
-claude-flow verify dashboard
-claude-flow verify dashboard --port 3000
-claude-flow verify dashboard --export
-```
-
-## Configuration
-
-Default threshold: **0.95** (95% accuracy required)
-
-Configure in `.claude-flow/config.json`:
-```json
-{
-  "verification": {
-    "threshold": 0.95,
-    "autoRollback": true,
-    "gitIntegration": true,
-    "hooks": {
-      "preCommit": true,
-      "preTask": true,
-      "postEdit": true
-    }
-  }
-}
-```
-
-## Integration
-
-### With Swarm Commands
-```bash
-claude-flow swarm --verify --threshold 0.98
-claude-flow hive-mind --verify
-```
-
-### With Training Pipeline
-```bash
-claude-flow train --verify --rollback-on-fail
-```
-
-### With Pair Programming
-```bash
-claude-flow pair --verify --real-time
-```
-
-## Metrics
-
-- **Truth Score**: 0.0 to 1.0 (higher is better)
-- **Confidence Level**: Statistical confidence in verification
-- **Rollback Rate**: Percentage of changes rolled back
-- **Quality Improvement**: Trend over time
-
-## Examples
-
-### Basic Verification
-```bash
-# Verify current directory
-claude-flow verify check
-
-# Verify with custom threshold
-claude-flow verify check --threshold 0.99
-
-# Verify and auto-fix
-claude-flow verify check --auto-fix
-```
-
-### Advanced Workflows
-```bash
-# Continuous verification during development
-claude-flow verify watch --directory src/
-
-# Batch verification
-claude-flow verify batch --files "*.js" --parallel
-
-# Integration testing
-claude-flow verify integration --test-suite full
-```
-
-## Performance
-
-- Verification latency: <100ms for most checks
-- Rollback time: <1s for git-based rollback
-- Dashboard refresh: Real-time via WebSocket
-
-## Related Commands
-
-- `truth` - View truth scores and metrics
-- `pair` - Collaborative development with verification
+# 🔍 Verification Commands
+
+Truth verification system for ensuring code quality and correctness with a 0.95 accuracy threshold.
+
+## Overview
+
+The verification system provides real-time truth checking and validation for all agent tasks, ensuring high-quality outputs and automatic rollback on failures.
+
+## Subcommands
+
+### `verify check`
+Run verification checks on current code or agent outputs.
+
+```bash
+claude-flow verify check --file src/app.js
+claude-flow verify check --task "task-123"
+claude-flow verify check --threshold 0.98
+```
+
+### `verify rollback`
+Automatically rollback changes that fail verification.
+
+```bash
+claude-flow verify rollback --to-commit abc123
+claude-flow verify rollback --last-good
+claude-flow verify rollback --interactive
+```
+
+### `verify report`
+Generate verification reports and metrics.
+
+```bash
+claude-flow verify report --format json
+claude-flow verify report --export metrics.html
+claude-flow verify report --period 7d
+```
+
+### `verify dashboard`
+Launch interactive verification dashboard.
+
+```bash
+claude-flow verify dashboard
+claude-flow verify dashboard --port 3000
+claude-flow verify dashboard --export
+```
+
+## Configuration
+
+Default threshold: **0.95** (95% accuracy required)
+
+Configure in `.claude-flow/config.json`:
+```json
+{
+  "verification": {
+    "threshold": 0.95,
+    "autoRollback": true,
+    "gitIntegration": true,
+    "hooks": {
+      "preCommit": true,
+      "preTask": true,
+      "postEdit": true
+    }
+  }
+}
+```
+
+## Integration
+
+### With Swarm Commands
+```bash
+claude-flow swarm --verify --threshold 0.98
+claude-flow hive-mind --verify
+```
+
+### With Training Pipeline
+```bash
+claude-flow train --verify --rollback-on-fail
+```
+
+### With Pair Programming
+```bash
+claude-flow pair --verify --real-time
+```
+
+## Metrics
+
+- **Truth Score**: 0.0 to 1.0 (higher is better)
+- **Confidence Level**: Statistical confidence in verification
+- **Rollback Rate**: Percentage of changes rolled back
+- **Quality Improvement**: Trend over time
+
+## Examples
+
+### Basic Verification
+```bash
+# Verify current directory
+claude-flow verify check
+
+# Verify with custom threshold
+claude-flow verify check --threshold 0.99
+
+# Verify and auto-fix
+claude-flow verify check --auto-fix
+```
+
+### Advanced Workflows
+```bash
+# Continuous verification during development
+claude-flow verify watch --directory src/
+
+# Batch verification
+claude-flow verify batch --files "*.js" --parallel
+
+# Integration testing
+claude-flow verify integration --test-suite full
+```
+
+## Performance
+
+- Verification latency: <100ms for most checks
+- Rollback time: <1s for git-based rollback
+- Dashboard refresh: Real-time via WebSocket
+
+## Related Commands
+
+- `truth` - View truth scores and metrics
+- `pair` - Collaborative development with verification
 - `train` - Training with verification feedback

package/.claude/commands/workflows/README.md

@@ -1,9 +1,9 @@
-# Workflows Commands
-
-Commands for workflows operations in Claude Flow.
-
-## Available Commands
-
-- [workflow-create](./workflow-create.md)
-- [workflow-execute](./workflow-execute.md)
-- [workflow-export](./workflow-export.md)
+# Workflows Commands
+
+Commands for workflows operations in Claude Flow.
+
+## Available Commands
+
+- [workflow-create](./workflow-create.md)
+- [workflow-execute](./workflow-execute.md)
+- [workflow-export](./workflow-export.md)