Skip to content

docs: bind routing numbers to the published artifact#35

Merged
VickyXAI merged 1 commit into
mainfrom
feat/brand-numbers-sync
Jul 26, 2026
Merged

docs: bind routing numbers to the published artifact#35
VickyXAI merged 1 commit into
mainfrom
feat/brand-numbers-sync

Conversation

@VickyXAI

Copy link
Copy Markdown
Contributor

Consumes blockrun#288's /brand/numbers.json.

What was wrong

Claim Was Now
Savings 92% 87%
Scoring dimensions 14 15
Free tier 9 models 8

The savings figure was an unqualified "up to" against no stated baseline. The replacement is computed from a published workload mix against pinning Claude Opus 5 for every request, so it can be recomputed and checked.

The dimension count was wrong across the whole org: the code comments in ClawRouter said 14, but the scorer builds a 14-entry array and then pushes the agentic dimension — 15 are actually scored. Corrected at the source in ClawRouter#220.

CI

The check is its own job rather than a step in the existing test job, so it does not run three times across the Python 3.9 / 3.11 / 3.12 matrix.

--check is offline: it reads the committed brand-numbers.json and never fetches, so a blockrun.ai deploy in progress cannot fail this repo's CI.

Left alone deliberately

The free-tier row still names specific models (GLM-4.7, Llama 4, …). Which models are in the free tier is a catalog question rather than a numbers one — the artifact owns the count, not the roster — and it deserves its own pass.

@VickyXAI

Copy link
Copy Markdown
Contributor Author

CI here is red for an unrelated, pre-existing reason — it is not this PR.

This diff touches no Python at all:

.github/workflows/ci.yml
README.md
brand-numbers.json          (new)
scripts/sync-brand-numbers.mjs  (new)

The Lint step fails because ruff is installed as ruff>=0.1.0, so CI resolves whatever is newest. ruff 0.16.0 reports 1903 errors on main — 0.14.11 on the same tree is clean. Every branch in this repo has been red since 2026-07-21 for this reason.

Fixed in #36, which is green. Merge that first and this goes green on a rebase.

Note that the new brand-numbers job already passes — it is the test matrix's lint step that fails.

Three numbers in the routing section were stale and each was maintained by
hand: 92% savings against no stated baseline, 14 scoring dimensions, and a free
tier described as 9 models. The catalog publishes 8 visible free models, the
scorer runs 15 dimensions, and the savings figure is 87% against pinning Claude
Opus 5 for every request.

They now regenerate from blockrun.ai/brand/numbers.json, checked offline in CI
against the committed snapshot. The check is its own job rather than a step, so
it does not run three times across the Python matrix.

Left alone: the free row still names specific models (GLM-4.7, Llama 4, …).
Which models are in the free tier is a catalog question, not a numbers one, and
worth its own pass — the count is what this artifact owns.
@VickyXAI
VickyXAI force-pushed the feat/brand-numbers-sync branch from 752c87a to ab99647 Compare July 26, 2026 05:20
@VickyXAI
VickyXAI merged commit fb26607 into main Jul 26, 2026
4 checks passed
@VickyXAI
VickyXAI deleted the feat/brand-numbers-sync branch July 26, 2026 05:22
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