Skip to content

chore: refresh GHCR + Maven Central counts (2026-05-16)#658

Merged
amavashev merged 2 commits into
mainfrom
chore/refresh-ghcr-counts-20260516
May 16, 2026
Merged

chore: refresh GHCR + Maven Central counts (2026-05-16)#658
amavashev merged 2 commits into
mainfrom
chore/refresh-ghcr-counts-20260516

Conversation

@amavashev
Copy link
Copy Markdown
Contributor

@amavashev amavashev commented May 16, 2026

What

Refreshed both GHCR pull counts and Maven Central download stats in `.vitepress/theme/manual-package-counts.json`. Two commits on this branch — one for GHCR, one for Maven — both follow the file's existing convention.

GHCR pull counts (commit a6c4f8a)

Source: https://github.com/orgs/runcycles/packages and per-package pages.

Package Before After Delta Source page
cycles-server-admin 1290 1290 0 still 1.29K rounded
cycles-server 1030 1040 +10 1.04K rounded
cycles-dashboard 669 669 0 exact integer, no change
cycles-server-events 373 424 +51 exact integer
GHCR aggregate 3362 3423 +61

Maven Central counts (commit 25c92b4)

Source: Sonatype Central portal → Statistics → Downloads.

Metric Before After Delta
io.runcycles downloads 1589 1889 +300
Unique sources 225 253 +28
Companies 55 56 +1

`lastVerifiedAt` and `mavenLastVerifiedAt` both updated to 2026-05-16.

Why this matters

The GitHub REST API does not populate `download_count` for container packages (verified 2026-05-07 per the file's `_note`), and Maven Central has no public downloads API. So this manual file is the source of truth for both `ghPackages` and `maven` in installs-cache.json. The build-time loader takes both sums via HWM and rolls them into the displayed total.

Convention applied

  • GHCR: Per-package pages below ~1K show exact integers; recorded as integers. Above ~1K round (e.g. 1.04K → 1040); accuracy ±5.
  • Maven: `_mavenBreakdown` carries totals only this refresh (no monthly split captured).
  • Only the manual file is edited; `installs-cache.json` catches up on the next build via HWM.

Matches prior refresh chores like 986f905 (GHCR) and b3d417d (Maven).

Cache impact (corrected)

This PR's own contribution to the displayed total is +361. The cache happens to be further behind because the last write to `installs-cache.json` was the scheduled `update-github-counts.mjs` script on 2026-05-15, and that script doesn't read the manual file for `ghPackages` / `maven` (only the build-time loader does). So a separate +515 of catch-up to the prior manual file will land on the same build, regardless of this PR.

Source Old manual New manual (this PR) Cached Catch-up (independent of this PR) This PR Total cache lift
ghPackages 3362 3423 2959 +403 +61 +464
maven 1589 1889 1477 +112 +300 +412
Combined +515 +361 +876

So:

  • Without this PR, the next build would have lifted the displayed total by +515 (catch-up to the 2026-05-12 manual refresh that no build had picked up yet).
  • This PR adds +361 on top of that catch-up, taking the next-build cache lift to +876 in total.

Test plan

  • `npm run build` succeeds
  • After build, `installs-cache.json` shows `ghPackages: 3423`, `maven: 1889`, and a higher `total`
  • Homepage installs counter renders the new total

amavashev added 2 commits May 16, 2026 05:47
Peeked at https://github.com/orgs/runcycles/packages and the per-package
pages, and updated manual-package-counts.json:

  cycles-server-admin: 1290 -> 1290 (no change; still 1.29K on both org
                                     and per-package pages)
  cycles-server:       1030 -> 1040 (1.04K on both pages, +/- 5)
  cycles-dashboard:     669 ->  669 (exact integer, no change)
  cycles-server-events: 373 ->  424 (exact integer)

Aggregate ghPackages: 3362 -> 3423 (+61). The cached value in
installs-cache.json (2959) is below both old and new sums; the HWM
logic in installs.data.ts:498 takes the manual sum as ghPackages and
will refresh the cache on the next build.

Convention for these refreshes (per past chores like 986f905):
- Per-package pages below ~1K show exact integers; record as integers.
- Per-package pages above ~1K round (1.04K -> 1040); accuracy +/- 5.
- Only the manual file is edited here; the cache catches up on build.
- lastVerifiedAt updated to today.
From Sonatype Central portal Statistics:

  io.runcycles: 1589 -> 1889  (+300)
  Unique sources: 225 -> 253  (+28)
  Companies:      55 ->  56  (+1)

`_mavenBreakdown` carries totals only this refresh (no monthly split
captured). mavenLastVerifiedAt updated to today.

The cached `maven: 1477` in installs-cache.json is below both old (1589)
and new (1889) manual values; the HWM logic in installs.data.ts:487
(`Math.max(mavenFetched, cached.maven)`) lifts it to 1889 on the next
build, contributing to the displayed total alongside the +61 GHCR
update in the previous commit on this branch.
@amavashev amavashev changed the title chore: refresh GHCR pull counts (2026-05-16) chore: refresh GHCR + Maven Central counts (2026-05-16) May 16, 2026
@amavashev amavashev merged commit 3d038a2 into main May 16, 2026
5 checks passed
@amavashev amavashev deleted the chore/refresh-ghcr-counts-20260516 branch May 16, 2026 09:51
@amavashev amavashev restored the chore/refresh-ghcr-counts-20260516 branch May 16, 2026 11:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant