Skip to content

feat(scaling): snapshot schema v2 with ladder, ceilings and guardrails - #194

Merged
mw2000 merged 5 commits into
mainfrom
feat/scaling-schema-v2
Oct 16, 2026
Merged

mw2000 merged 5 commits into
mainfrom
feat/scaling-schema-v2

Conversation

@0x00101010

@0x00101010 0x00101010 commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Why

The scorecard snapshot's headline row cannot express what the scaling page needs to show next: where mainnet runs today against its operating point, configured limit and the highest rate a qualified run has sustained, each with its own confidence. Progress entries also have no place for a realized effect or the evidence behind it.

What

  • schemaVersion: 2: headline becomes ladder (observed p50/p99, operating point, configured limit, qualified), each a rung with a measured / modeled / estimated / not-measured / not-modeled / not-established tag; values are null under the three non-measured tags, never 0.
  • translations (gasPerPayment, gasPerSwap) and new work fields area, expected, realized, evidence, linear; realized requires evidence, linear.progress must be in [0, 1].
  • Version 1 files are rejected with a message naming the migration; isStale(collectedAt, now, days = 10) is exported and drives the page's stale banner.
  • app/scaling/fixtures/synthetic.v2.json: invented values covering every tag, used by the tests and by npm run scaling:check.
  • The page maps the four ladder rungs into the existing headline cards and shows expected / realized impact with the evidence link on work cards; no new UI.

Notes

  • The stale banner threshold moves from 7 to 10 days to match the shared helper's default.
  • help strings (short explanations per rung) are stored but not rendered yet.

Screenshots

/scaling on the internal build, rendering app/scaling/fixtures/synthetic.v2.json (invented values):

scaling

Test plan

  • npm test, npm run typecheck, npm run lint, npm run build, npm run build:internal, npm run llms -- --check
  • npm run scaling:check -- app/scaling/fixtures/synthetic.v2.json passes; a schemaVersion: 1 file fails with the migration message
  • /scaling rendered from the fixture on the internal build

Consolidated

This PR now also carries #195 (ceilings, deriveBinding, guardrails, stricter validator rules). Commits are unchanged; review them in order.

0x00101010 and others added 2 commits October 15, 2026 22:22
Co-authored-by: Toshi <toshi-noreply@coinbase.com>
Co-authored-by: Toshi <toshi-noreply@coinbase.com>
@cb-heimdall

cb-heimdall commented Oct 16, 2026 •

Copy link
Copy Markdown
Collaborator

✅ Heimdall Review Status

Requirement Status More Info
Reviews ✅ 1/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@vercel

vercel Bot commented Oct 16, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
omni-ui Ready Ready Preview Oct 16, 2026 1:32pm UTC

Request Review

Co-authored-by: Toshi <toshi-noreply@coinbase.com>
0x00101010 and others added 2 commits October 15, 2026 22:31
Co-authored-by: Toshi <toshi-noreply@coinbase.com>
…g the numbers

Co-authored-by: Toshi <toshi-noreply@coinbase.com>
@mw2000
mw2000 added this pull request to the merge queue Oct 16, 2026
Merged via the queue into main with commit db0580f Oct 16, 2026
19 checks passed
@mw2000
mw2000 deleted the feat/scaling-schema-v2 branch October 16, 2026 16:55

This branch was successfully deployed

1 active deployment
Preview — 28630833 Deployed Oct 16, 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.

3 participants