Progress Tracker
Tracks and reports progress across autonomous coding sessions with metrics, visualization, and completion estimation.
Quick Start
Get Progress Metrics
python
from scripts.progress_tracker import ProgressTracker
tracker = ProgressTracker(project_dir)
metrics = tracker.get_progress()
print(f"Features: {metrics.passing}/{metrics.total}")
print(f"Progress: {metrics.percentage:.1f}%")
Generate Report
python
report = tracker.generate_report(format="markdown") print(report)
Visualize Progress
python
visualization = tracker.visualize_progress() print(visualization) # ████████████░░░░░░░░ 60% (30/50)
Progress Dashboard
code
┌─────────────────────────────────────────────────────────────┐ │ PROGRESS DASHBOARD │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Overall Progress │ │ ████████████████░░░░░░░░░░░░░░░░░░░░ 45% │ │ │ │ Features: 45/100 passing │ │ Sessions: 12 completed │ │ Commits: 87 made │ │ │ │ By Category │ │ ├─ auth: ████████████████████ 100% (5/5) │ │ ├─ crud: ██████████████░░░░░░ 70% (14/20) │ │ ├─ ui: ████████░░░░░░░░░░░░ 40% (12/30) │ │ ├─ api: ██████████████████░░ 90% (9/10) │ │ ├─ testing: ██░░░░░░░░░░░░░░░░░░ 10% (2/20) │ │ └─ other: ██████░░░░░░░░░░░░░░ 30% (3/10) │ │ │ │ Estimated Completion │ │ ├─ At current rate: ~15 sessions remaining │ │ ├─ Time estimate: ~7.5 hours │ │ └─ Sessions per day: 3 │ │ │ └─────────────────────────────────────────────────────────────┘
Metrics Tracked
| Metric | Description |
|---|---|
| Features | Passing/total feature count |
| Progress % | Completion percentage |
| Sessions | Number of sessions completed |
| Commits | Number of git commits |
| Velocity | Features per session |
| ETA | Estimated sessions to completion |
Integration Points
- •context-state-tracker: Reads feature and progress data
- •coding-agent: Tracks feature completion
- •autonomous-loop: Uses metrics for continuation decisions
References
- •
references/METRICS.md- Detailed metrics documentation - •
references/REPORT-FORMATS.md- Report format options
Scripts
- •
scripts/progress_tracker.py- Core ProgressTracker class - •
scripts/metrics_calculator.py- Metrics calculations - •
scripts/report_generator.py- Report generation - •
scripts/visualization.py- ASCII visualization