Skip to content

chore(brand): refresh the snapshot — the markers were rendering a stale catalog - #232

Merged
VickyXAI merged 2 commits into
mainfrom
chore/refresh-brand-numbers
Aug 5, 2026
Merged

chore(brand): refresh the snapshot — the markers were rendering a stale catalog#232
VickyXAI merged 2 commits into
mainfrom
chore/refresh-brand-numbers

Conversation

@VickyXAI

@VickyXAI VickyXAI commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

brand-numbers.json in this repo was a catalog generation behind, so every br: marker here rendered a stale number.

The markers worked correctly — they rendered the input they had. Nothing refreshes that input. sync-brand-numbers.mjs reads the local snapshot and only re-fetches under --refresh; --check is offline by design so PR CI stays deterministic. The script header defers freshness to a fan-out job that was never built, so all 15 consumers have been validating markers against their own stale copies and reporting green.

Measured across the org on 2026-08-05: 14 of 15 consumers stale, most at 66/86/8, ClawRouter at 65/85/7. Truth is 71 chat / 92 total / 6 free. Only ClawRouter-Hermes was current.

Produced by node scripts/sync-brand-numbers.mjs --refresh — no hand-edited digits.

The mirror (BlockRunAI/awesome-blockrun#34) is refreshed first, since it is what every other repo falls back to. The fan-out job itself follows in BlockRunAI/blockrun.

Summary by CodeRabbit

  • Documentation
    • Updated model catalog references from 65 to 71 across product documentation.
    • Updated availability details to reflect six free models and nine image-generation models.
    • Removed the discontinued free model from catalog examples and FAQs.
    • Synchronized model counts across guides, comparisons, pricing information, package details, and integration resources.
    • Refreshed catalog visibility and fallback statistics to match current offerings.

…le catalog

brand-numbers.json here was a catalog generation behind, so every br: marker in
this repo rendered a number that has not been true for some time.

The markers did their job — they rendered the input they were given. Nothing
refreshes that input: sync-brand-numbers.mjs reads the local snapshot and only
re-fetches under --refresh, and --check is offline on purpose so PR CI stays
deterministic. Its header defers freshness to a fan-out job that was never built,
so every consumer validated markers against its own stale copy and reported green.

Produced by --refresh, not by hand.
@coderabbitai

coderabbitai Bot commented Aug 5, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: fbcf1ab8-e2b3-4c68-993b-1e7c8aa8ac82

📥 Commits

Reviewing files that changed from the base of the PR and between 7157b72 and 5518df1.

📒 Files selected for processing (3)
  • README.md
  • package.json
  • skills/clawrouter/SKILL.md

📝 Walkthrough

Walkthrough

This PR updates model counts across the shared numeric source, README, package metadata, product documentation, repository guidance, and skill documentation. It also removes free/seed-oss-36b from free-model references.

Changes

Catalog count updates

Layer / File(s) Summary
Shared count values
brand-numbers.json
Updated chat-visible, total-visible, free, free-withheld, image, and fallback-related model counts.
Documentation and skill sync
README.md, CLAUDE.md, docs/..., skills/clawrouter/SKILL.md
Updated references to 71 models, 6 free models, and 9 image models. Removed seed-oss-36b from free-model examples and listings.
Package metadata sync
package.json
Updated the package description to state support for 71 models, including 6 free models.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Suggested reviewers: 1bcmax, 0xcheetah1

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly describes the main change: refreshing a stale brand catalog snapshot by updating model count documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/refresh-brand-numbers

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
brand-numbers.json (1)

5-9: 📐 Maintainability & Code Quality | 🔵 Trivial | 🏗️ Heavy lift

Add an automated freshness guard for the generated snapshot.

brand-numbers.json is the shared count source. The PR states that --check is offline and the fan-out job is not built. Add CI or fan-out validation that checks every br: reference and hard-coded count claim against this file. This prevents future documentation drift.

Also applies to: 14-15

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@brand-numbers.json` around lines 5 - 9, Update the CI or fan-out validation
around brand-numbers.json to automatically verify every br: reference and
hard-coded count claim against the generated snapshot, using the documented
offline --check flow where applicable. Ensure the validation fails when
documentation counts drift from the shared values in brand-numbers.json.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Line 394: Synchronize every count and free-model reference with
brand-numbers.json by updating the README.md summary and the listed docs/skills
sites together: keep README.md’s chatVisible/free summary at 71 and 6, replace
the seven FREE rows with the current six free models, change the stale 41+ AI
Models and FREE (9 free) text in docs/anthropic-cost-savings.md to current
values or mark it historical, update
docs/anthropic-third-party-harness-changes.md to 6 free models, update
docs/clawrouter-cuts-llm-api-costs-500x.md to 71, update
docs/clawrouter-vs-openrouter-llm-routing-comparison.md to 6, and regenerate the
six-name free-model list in skills/clawrouter/SKILL.md.

---

Nitpick comments:
In `@brand-numbers.json`:
- Around line 5-9: Update the CI or fan-out validation around brand-numbers.json
to automatically verify every br: reference and hard-coded count claim against
the generated snapshot, using the documented offline --check flow where
applicable. Ensure the validation fails when documentation counts drift from the
shared values in brand-numbers.json.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 3d039eb2-dbce-4cfa-9664-78ce66fc49eb

📥 Commits

Reviewing files that changed from the base of the PR and between f305afc and 7157b72.

📒 Files selected for processing (8)
  • CLAUDE.md
  • README.md
  • brand-numbers.json
  • docs/anthropic-cost-savings.md
  • docs/anthropic-third-party-harness-changes.md
  • docs/clawrouter-cuts-llm-api-costs-500x.md
  • docs/clawrouter-vs-openrouter-llm-routing-comparison.md
  • skills/clawrouter/SKILL.md

Comment thread README.md
## Models & Pricing

<!-- br:models.chatVisible -->65<!-- /br:models.chatVisible --> models across 9 providers, one wallet. **<!-- br:models.free -->7<!-- /br:models.free --> models are $0 — paid models start at fractions of a cent.**
<!-- br:models.chatVisible -->71<!-- /br:models.chatVisible --> models across 9 providers, one wallet. **<!-- br:models.free -->6<!-- /br:models.free --> models are $0 — paid models start at fractions of a cent.**

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win

Synchronize all count claims from brand-numbers.json.

models.chatVisible is 71 and models.free is 6. The changed references are not fully propagated.

  • README.md#L394-L394: Keep the summary at 6 and replace the seven FREE rows at Lines 402-408 with the six current free models.
  • docs/anthropic-cost-savings.md#L53-L53: Change 41+ AI Models and FREE (9 free) to the current values, or label the diagram as historical.
  • docs/anthropic-third-party-harness-changes.md#L34-L34: Change 9 free models at Line 82 to 6.
  • docs/clawrouter-cuts-llm-api-costs-500x.md#L138-L138: Change the stale 66 marker at Line 147 to 71.
  • docs/clawrouter-vs-openrouter-llm-routing-comparison.md#L243-L243: Change including 9 free models to 6.
  • skills/clawrouter/SKILL.md#L144-L144: Regenerate the seven-name free-model list as six current names.
📍 Affects 6 files
  • README.md#L394-L394 (this comment)
  • docs/anthropic-cost-savings.md#L53-L53
  • docs/anthropic-third-party-harness-changes.md#L34-L34
  • docs/clawrouter-cuts-llm-api-costs-500x.md#L138-L138
  • docs/clawrouter-vs-openrouter-llm-routing-comparison.md#L243-L243
  • skills/clawrouter/SKILL.md#L144-L144
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.md` at line 394, Synchronize every count and free-model reference with
brand-numbers.json by updating the README.md summary and the listed docs/skills
sites together: keep README.md’s chatVisible/free summary at 71 and 6, replace
the seven FREE rows with the current six free models, change the stale 41+ AI
Models and FREE (9 free) text in docs/anthropic-cost-savings.md to current
values or mark it historical, update
docs/anthropic-third-party-harness-changes.md to 6 free models, update
docs/clawrouter-cuts-llm-api-costs-500x.md to 71, update
docs/clawrouter-vs-openrouter-llm-routing-comparison.md to 6, and regenerate the
six-name free-model list in skills/clawrouter/SKILL.md.

…free model

The snapshot refresh moved brand-numbers.json to 71/92/6, and this repo's own
brand-numbers.test.ts immediately failed — correctly. Four of the numbers it
guards live in surfaces a br: marker cannot reach: a package.json description, a
shields badge URL and its alt text, and a skill's YAML frontmatter, where a
marker is not inert because it becomes part of the string. Those hold literals
and are asserted by test instead, which is exactly what caught this.

They were two generations stale, not one — 65 models and 7 free, against a real
71 and 6.

The free count moved 7 -> 6 because nvidia/seed-oss-36b 410'd upstream on
2026-08-03. Changing the digit alone would have left the model named in four
places as something a caller can still use, so it is removed from the SKILL.md
enumeration, the README model table, the pricing prose, and the /model
suggestion line. Verified against the live catalog: six free models, and
seed-oss is not among them.

src/router/brand-numbers.test.ts: 22 passed.
@VickyXAI
VickyXAI merged commit 92f9631 into main Aug 5, 2026
3 of 4 checks passed
@VickyXAI
VickyXAI deleted the chore/refresh-brand-numbers branch August 5, 2026 15:01
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