143 lines
3.2 KiB
Markdown
143 lines
3.2 KiB
Markdown
# 📊 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 |