[schaubh]

• Review: By commit
• Merge strategy: Merge (no squash)

Description

Adds a cumulative Recorded wheel download requests box above the usage plots, with coverage dates and the number of observed days. The BSK wheels plot shows seven-day trailing means of the same daily counts.

Both count requests for known BSK filenames ending in .whl from all clients, including pip, uv, browsers, Poetry, scripts, and unidentified clients. Identified mirrors and repository caches are excluded. Source archives, metadata files, signatures, and records without filenames are excluded.

The collector stores wheel requests separately in CSV and schema-version-4 JSON. Older CSV formats and summary versions 1–3 remain supported. Successful collection backfills available historical counts; missing observations remain unknown rather than becoming zero. Overlapping observations are replaced without double-counting. Broader distribution and installer totals remain available in the data artifacts.

These are recorded requests, not verified full-file transfers, completed installations, or unique users. Repeat, automated, and partial requests may count. Incomplete historical filename coverage means the total is not presented as a complete lifetime count.

Verification

• All 45 usage-metrics tests passed.
• Tests exercise SQL filtering for browser, Poetry, unidentified, custom-client, and mirror requests, including metadata, source archives, and missing filenames.
• Added coverage for cumulative wheel totals, plotted values, missing versus zero counts, legacy-history migration, historical backfill, repeated collection, and source failures.
• Validated the live ClickPy query and independently reconciled 26,843 recorded wheel requests through October 16, 2026 with the client breakdown.
• Built the usage documentation with Sphinx warnings treated as errors and visually inspected the rendered note, download box, and plot.
• git diff --check passed.

Documentation

Updated the note above the usage figure to explain the shared wheel-only counting rule, included clients, mirror exclusions, coverage, and interpretation limits.

Updated the usage-metrics documentation, generated README, schema documentation, and release-note snippet. Historical wheel counts remain unavailable until backfilled; broader distribution or installer totals are never substituted.

Reviewers should check the rendered usage page and generated SVG, README, CSV, and JSON summary for consistent labels and counting rules.

Future work

None

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-10-17T15:41:51.817618Z	75c3838	PR opened

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.