star-milestone

What problem does it solve?

It prevents you from missing meaningful community traction by turning raw GitHub star count changes into a useful, context-rich milestone update that includes speed, trajectory, and what’s next.

Core Features & Use Cases

• Milestone crossing detection: Finds the highest star threshold reached (from a predefined list) for one repo or for all watched repos, while avoiding duplicate notifications.
• Velocity-shaped storytelling: Calculates recent growth (e.g., stars in the last 7/30 days), estimates baseline pace, projects the next milestone, and labels the growth shape (SPIKE/ORGANIC/MIGRATED/RECOVERY/TRICKLE/UNKNOWN).
• Anti-spam and trust gates: Suppresses alerts for bootstrap, stale/stagnation, suspected fake-star bursts, and for intermediate thresholds crossed in a single run; logs degraded runs when velocity data fails.
• Highlights from recent activity: Pulls up to three concrete highlights from recent daily logs (or falls back to commit messages) so the notification teaches something beyond the number.

Quick Start

Run star-milestone to check watched GitHub repos and post a milestone message when a repo crosses the next star-count threshold with velocity and highlight context.