Progress Tracker

Tracks and reports progress across autonomous coding sessions with metrics, visualization, and completion estimation.

Quick Start

Get Progress Metrics

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

report = tracker.generate_report(format="markdown")
print(report)

Visualize Progress

visualization = tracker.visualize_progress()
print(visualization)
# ████████████░░░░░░░░ 60% (30/50)

Progress Dashboard

┌─────────────────────────────────────────────────────────────┐
│                    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