Documentation
¶
Overview ¶
Command runner-adoption-snapshot collects the adoption evidence behind ADR-026 and writes a dated JSON artifact under docs/evidence/.
The primary metric is new forks bucketed into fixed-width windows. Unlike stars, total downloads, and fork counts, a bucketed fork rate is not cumulative, so it can fall — which is what makes it usable as an adoption time series. See ADR-026 for why the two obvious alternatives were rejected: stargazer timestamps are unavailable (the endpoint 404s for external repos) and per-release downloads-per-day is confounded by post-publication decay.
Classification judgments deliberately live in ADR-026, not here, so a future audit can refresh the data without inheriting today's judgment.
Usage:
go run ./scripts/runner-adoption-snapshot -out docs/evidence
Requires an authenticated `gh` CLI on PATH. Fork-window boundaries are found with binary search over newest-first pages and cached across windows, so even large repositories take tens of requests rather than hundreds.
Source Files