Skip to content

docs(readme): list auto/subscription and auto/thrifty in the zero-config auto table - #15467

Merged
diegosouzapw merged 1 commit into
cheaper-inference:release/v3.8.52from
yourspraveen:docs/readme-auto-subscription-thrifty
Oct 6, 2026
Merged

diegosouzapw merged 1 commit into
cheaper-inference:release/v3.8.52from
yourspraveen:docs/readme-auto-subscription-thrifty

Conversation

@yourspraveen

Copy link
Copy Markdown
Contributor

⚠️ base-red inherited: #15306

What

The README's "Zero-config — just use auto" table lists auto/cheap, but not the two subscription-first ids added in #11146. Operators looking for "use the plan I already pay for" can't find them from the front page. Both ids are built in (open-sse/services/autoCombo/builtinCatalog.ts), advertised in /v1/models and the dashboard, and documented in docs/routing/SUBSCRIPTION_LADDER.md and docs/guides/TIERS.md. Only the README table was missing them.

This PR adds two rows right after auto/cheap, each with a one-line summary taken from the ladder guide and a link to it:

Model ID What it optimizes for
auto/subscription 🎟️ Only the subscription quota you already pay for. Fails closed, never a billable fallback
auto/thrifty 🪜 Plan quota first, then one rung at a time to the cheapest paid options. Back on the plan after it resets

How they differ from auto/cheap, which sorts by per-token price only: auto/thrifty uses plan-included quota first and only then escalates through paid rungs, and auto/subscription never escalates at all.

Scope

  • Root README.md only. The 66 docs/i18n/*/README.md mirrors are refreshed by the periodic i18n batch, as for other README additions (e.g. the auto/chaos docs in 866f9e3d97).
  • Changelog fragment: changelog.d/maintenance/readme-auto-subscription-thrifty.md.

Related

Validation

  • npm run check:docs-all passes: docs-sync, frontmatter, counts, env-doc, deprecated-versions, doc-links, and fabricated-docs (both ids resolve in source).
  • Prettier check is clean.
  • Local quality.yml fast-gate run against release/v3.8.52: 33 pass. The 3 failures (cycles, agent-skills-sync, workflows) occur identically on the untouched base or need actionlint/zizmor, which aren't installed locally. This PR changes only Markdown.

…fig auto table

The README's "Zero-config — just use auto" table lists auto/cheap but not
the two subscription-first ids added in cheaper-inference#11146, so operators looking for
"use the plan I already pay for" never find them from the front page.

Adds both rows after auto/cheap, with a one-line summary taken from
docs/routing/SUBSCRIPTION_LADDER.md and a link to it:
- auto/subscription: plan quota only, fails closed (never a billable fallback)
- auto/thrifty: plan quota first, then one rung at a time to the cheapest
  paid options, back on the plan after it resets

Root README only; the 66 locale mirrors are refreshed by the periodic
i18n batch, as for other README additions.
@yourspraveen

Copy link
Copy Markdown
Contributor Author

CI note for reviewers:

One red check is partly from this PR, and the rest are inherited from release/v3.8.52 (#15306):

Check Cause Source
Docs Sync (Strict) [i18n-check] drift detected: README.md and docs/architecture/QUALITY_GATES.md README.md is from this PR: the translated README mirrors need a refresh. QUALITY_GATES.md drift is on the base.
Gate / CI summary job: fails only on docs-sync-strict follows from the row above
Merge integrity check:agent-skills-sync exits 2 inherited (same on unrelated PRs #15577, #15579, #15580)
Gate / Quality summary job: fails only on merge-integrity inherited

I don't have access to the translation backend that npm run i18n:run uses, so I can't refresh the README mirrors myself. @diegosouzapw, should I leave that to your next translation run, or would you like me to handle it another way? The PR changes only README.md and a changelog fragment.

@diegosouzapw
diegosouzapw merged commit 2c910fd into cheaper-inference:release/v3.8.52 Oct 6, 2026
35 of 39 checks passed
diegosouzapw added a commit that referenced this pull request Oct 6, 2026
Follow-up da onda 6. Nenhum código de produto.

Tetos medidos no tip depois dos squashes:

- `open-sse/executors/opencode.ts` 1518 → 1519 (#15453)
- `tests/unit/combo/quota-weighted-strategy.test.ts` novo, congelado em 1217 (#15480)

O adopt de i18n grava o hash atual de `README.md` (#15541, #15467) e `docs/reference/ENVIRONMENT.md` (#15542). Não traduz.

File-size OK (171 congelados, 47 testes congelados). i18n drift PASS (sources=152, targets=10032).

⚠️ base-red inherited: #15306
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.

2 participants