What problem does it solve?
It turns raw GitHub star-count changes into meaningful milestone updates by adding velocity, trajectory shape, and highlights so readers learn why growth happened and what’s next.
Core Features & Use Cases
- Detect milestone crossings: Watches one repo (or a configured watchlist) and triggers only when a higher star threshold is crossed.
- Add velocity-shaped context: Computes recent star velocity (v7, v30), baseline pace, days to milestone, and a trajectory label (e.g., SPIKE, ORGANIC, TRICKLE).
- Anti-spam and trust safeguards: Suppresses notifications for bootstrap/stale/deferred scenarios and flags suspected fake-star bursts for manual review.
- Highlight reel from recent activity: Extracts 1–3 concrete, shipped-value highlights from recent logs (or falls back to recent commit messages) for a tight narrative.
- Stateful tracking: Records milestones in memory so the same milestone is never announced twice.
Quick Start
Run star-milestone for owner/repo by setting var to owner/repo and letting it notify the configured channels when a milestone threshold is crossed.