Skip to content

city: reconcile GitHub's commit count for repo and org cities, in numbers - #12

Merged
azank1 merged 1 commit into
mainfrom
city/landed-reconciliation
Oct 13, 2026
Merged

azank1 merged 1 commit into
mainfrom
city/landed-reconciliation

Conversation

@azank1

@azank1 azank1 commented Oct 13, 2026

Copy link
Copy Markdown
Owner

A developer who checks a repo city against GitHub finds a gap the page never explains. For golang/go, the city draws 3,491 commits where GitHub's history counts 3,748 since the same day. The panel says "Buildings show every non-merge commit on the default branch since 2025-10-13". A reader takes "since" to mean landed since, which would be 3,716, but the city goes by the day a commit was written.

Audit (golang/go against GitHub's GraphQL history, every commit fetched):

commits
GitHub's history(since: 2025-10-13), by landing day 3,748
non-merge, written since 2025-10-13: the buildings, exactly 3,491
merges 32
written before 2025-10-13 and landed since (Gerrit changes in review; the oldest from 2016) 225

Change. The finish step already has GitHub's count for each repo: discovery's history(since), by landing day. Each record holds every commit with its merge flag and author minute. For repo and org cities, the payload now carries totals.landed: GitHub's count for the drawn repos, and the merges written in the window. The panel then reads (rendered from golang/go's production payload with the count this change computes):

GitHub counts 3,748 commits on the default branch since 2025-10-13, by the day each landed. Buildings show the 3,491 written since then. Not drawn: 32 merges and 225 commits written before 2025-10-13.

The split appears only where it adds up exactly:

  • every drawn repo has GitHub's count
  • no record is approximate or cut at its 20,000-commit cap
  • the count is not below the buildings plus merges

Otherwise the panel says what it draws, without the ambiguity: "every non-merge commit written since …". The same holds for older payloads and for the Python CLI, which doesn't compute the count (a follow-up if wanted).

Tests. bundle() gets a real replayed record with one commit made a merge and one written before the window; it checks the split and each case where it is withheld. The finish step asserts the org count. The Python parity test is unchanged and passes; inputs without the count produce identical payloads. Suite: 50 tests, 44 pass, 6 live tests skipped, 0 fail; typecheck clean. Viewer rebuilt: app.021aac7758.js, live bundle unchanged.

After merge. Repo and org cities show the reconciliation once rebuilt; the gallery rebuild after #10 and #11 covers that.

…bers

A repo city's panel said "Buildings show every non-merge commit on the default branch
since 2025-10-13", and for golang/go drew 3,491 where GitHub counts 3,748 since that day.
A reader takes "since" as "landed since", which would be 3,716; the city goes by the day a
commit was written. An audit of golang/go against GitHub's own history accounts for every
commit: 3,748 = 3,491 non-merge commits written since the window start (the buildings,
exactly) + 32 merges + 225 commits written earlier and landed since (Gerrit changes sit in
review, one since 2016).

The finish step already has GitHub's count for each repo (discovery's history(since), by
landing day), and each record holds every commit with its merge flag and author minute.
For repo and org cities the payload now carries totals.landed: GitHub's count for the
drawn repos and the merges written in the window. The panel reads:

  GitHub counts 3,748 commits on the default branch since 2025-10-13, by the day each
  landed. Buildings show the 3,491 written since then. Not drawn: 32 merges and 225
  commits written before 2025-10-13.

The split is given only where it adds up exactly: every drawn repo has GitHub's count, no
record is approximate or cut at its 20,000-commit cap, and the count is not below the
buildings and merges. Otherwise, and for payloads from before this or from the Python CLI,
the panel says what it draws without the ambiguity: every non-merge commit written since
the window start.
@vercel

vercel Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
commit-city Ready Ready Preview Oct 13, 2026 1:02pm UTC

@azank1
azank1 marked this pull request as ready for review October 13, 2026 13:07
@azank1
azank1 merged commit 1a8c7a8 into main Oct 13, 2026
5 checks passed

This branch was successfully deployed

1 active deployment
Preview — 07baaa5d Deployed Oct 13, 2026 by vercel[bot]
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