[jonbeckman]

Requested by Jonathan · project thread

Summary

GitHub-hosted runners are always online, but their minutes cost money once the plan's included minutes are used up. This adds a built-in fallback check so a pool can skip GitHub-hosted runners when that happens and wait for its self-hosted runner instead.

• "github-minutes" passes while the organization's Actions usage this month has no net cost (it is still inside the included minutes).
• {"github-minutes": 10} passes while the paid part is at most $10.
• The check reads GET /organizations/{org}/settings/billing/usage/summary?product=actions&year=…&month=… and adds up netAmount for the Actions product. The route job reads it once per run.
• If the usage cannot be read (no token, no organization, missing permission, API error), the check fails and the router moves on to the next step.
• route.yml asks the App token for permission-organization-administration: read only when the config contains github-minutes. An empty permission input is ignored by create-github-app-token, so existing configs keep their narrow token.
• The README documents the check and the pattern of ending a chain on the primary:

{ "runs-on": "blacksmith-4vcpu-ubuntu-2404-arm", "when": { "var": "ROUTACT_BLACKSMITH_ENABLED" } },
{ "runs-on": "ubuntu-24.04-arm", "when": "github-minutes" },
{ "runs-on": "self-hosted,Linux,ARM64" }

Before using it

The solzero-routact App needs the organization permission Administration: Read. Until it has it, the token step fails for configs that use github-minutes.

Testing

• npm run all: lint, dist/ rebuild, and 102 Jest tests pass. New tests cover config validation, the check's pass and fail cases, a failed read, and the billing request.
• I did not run actionlint on route.yml; it could not be installed in this environment.
• Not tested against the live billing API. The endpoint is in public preview, and the response shape comes from GitHub's docs.

---

Generated by Claude Code