Arturo Sprint Velocity¶

Overview¶

Sprint Velocity tracks team delivery cadence across all tracked repositories using GitLab metrics. It captures weekly ISO snapshots of merged MRs, closed issues, and commits per repository, providing trend analysis and anomaly detection.

Metrics Captured¶

Each weekly snapshot records per-repository: - Merged MR count - Closed issue count - Commit count

Trend Analysis¶

Velocity trends are classified as rising, stable, or declining based on the rolling weekly comparison. Anomaly detection flags unusual spikes or drops.

Key Code Paths¶

File	Purpose
`src/services/sprint_velocity_service.py`	Sprint metrics, snapshot capture, trend calculation
`src/handlers/sprint_command_handler.py`	`/arturo sprint` Slack commands

Slack Commands¶

/arturo sprint -- Live GitLab data + quest velocity summary
/arturo sprint velocity [N] -- Historical trend (default 4 weeks)
/arturo sprint snapshot -- Persist current week snapshot

API Endpoints¶

GET /api/v1/sprint/velocity -- Sprint velocity report
GET /api/v1/sprint/current -- Current sprint snapshot
POST /api/v1/sprint/snapshot -- Capture new snapshot