Skip to content

fix(docs): validate aggregate provider counts across published surfaces - #16762

Merged
diegosouzapw merged 1 commit into
release/v3.8.52from
fix/13205-provider-count-docs-1015
Oct 16, 2026
Merged

diegosouzapw merged 1 commit into
release/v3.8.52from
fix/13205-provider-count-docs-1015

Conversation

@diegosouzapw

@diegosouzapw diegosouzapw commented Oct 15, 2026 •

Copy link
Copy Markdown
Collaborator

Provider-count claims drifted across the README, secondary documentation, generated skill descriptions and llm.txt mirrors. This updates aggregate claims to the 372 unique provider IDs measured on the validated base and extends the documentation gate to reject mixed current/stale aggregate counts. Explicit historical snapshots, approximate counts and distinct subset denominators remain intact.

Refs #13205.

Validation

Candidate c36f8d2bb903f93d92fae0bbb24295015ada8142, based on 6a1437e6e262db43b50d4bc8cb7b1d658b2e6308:

  • Ten new behavioral regressions pass after recorded failing probes; all 17 provider-count surfaces pass.
  • Formatting, ESLint, file size, changelog, test discovery, core/dashboard TypeScript and both complexity ratchets passed in the original exact-lockfile validation.
  • On 2026-10-16 UTC, repeated the documentation checks in an isolated worktree on the validation host, using Node24.21.0 and 2,524 audited packages with zero version mismatches. npm run check:docs-all passed in45.98s. All146 related tests passed in146.81s, with zero failures/skips. The previous runtime-facts timeout is no longer an unresolved candidate check. No deadline or test was relaxed.
ℹ tests 146
ℹ pass 146
ℹ fail 0
ℹ skipped 0

The current release merge result still needs validation. Draft remains for review/explicit operator approval of protected instruction surfaces (skills/**/SKILL.md, llm.txt and mirrors). Their changes update factual provider counts only; they do not add commands or operational instructions. No deployment is claimed.

@diegosouzapw
diegosouzapw marked this pull request as ready for review October 16, 2026 03:37
@diegosouzapw
diegosouzapw merged commit 3e704ce into release/v3.8.52 Oct 16, 2026
43 of 79 checks passed
diegosouzapw added a commit that referenced this pull request Oct 16, 2026
Companion of #16762 (merge-gates §8). That gate landed on `release/v3.8.52`, where the catalog total is **372**. This PR ports the same validator onto `main`, where `docs/reference/PROVIDER_REFERENCE.md` still records **358**. It does not copy 372 onto main.

What changed:

- `makeProviderCountValidator` in `scripts/check/check-docs-counts-sync.mjs`, required on `README.md`, `AGENTS.md`, and `llm.txt`, and optional on the secondary docs and skill surfaces.
- Aggregate claims the checker flagged now say 358. The versioned snapshot “351 registered providers in OmniRoute v3.8.0” and the chat-model registry denominator stay exempt.
- Strict `llm.txt` mirrors (`docs/i18n/*/llm.txt`) get the same `352-provider` → `358-provider` token so `check:docs-sync` stays green.
- Other locale mirrors were not retranslated. `.i18n-state.json` records the new English source hashes only. Locale hashes stay on the previous source, so `i18n:check` keeps those as non-blocking stale warnings.
- Skill surfaces covered by the new check move 327 → 358: `src/shared/constants/agentSkills.ts`, `skills/README.md`, `skills/omni-auth/SKILL.md`, `skills/omni-providers/SKILL.md`. Prettier also realigned existing tables in `docs/architecture/REPOSITORY_MAP.md` and `docs/frameworks/AGENTBRIDGE.md`.
- The regression fixture uses `**349** LLM providers` because 358 is the live total on this branch.

Checked locally on this branch: provider-count unit test 10/10, `check-docs-counts-sync` exit 0 with no strict drift, `i18n:check` PASS, `check:docs-sync` PASS.

Already at `origin/main` (`fd95f823`). CI was still queued at merge time. Local gates on this branch passed.
@github-actions

Copy link
Copy Markdown
Contributor

CI Coverage Report

  • Coverage job: skipped
  • PR test policy: success

Coverage artifact was not available for this run.

@diegosouzapw
diegosouzapw deleted the fix/13205-provider-count-docs-1015 branch October 18, 2026 23:48
arashashrafii pushed a commit to arashashrafii/OmniRoute that referenced this pull request Oct 24, 2026
…nce#16809)

Companion of cheaper-inference#16762 (merge-gates §8). That gate landed on `release/v3.8.52`, where the catalog total is **372**. This PR ports the same validator onto `main`, where `docs/reference/PROVIDER_REFERENCE.md` still records **358**. It does not copy 372 onto main.

What changed:

- `makeProviderCountValidator` in `scripts/check/check-docs-counts-sync.mjs`, required on `README.md`, `AGENTS.md`, and `llm.txt`, and optional on the secondary docs and skill surfaces.
- Aggregate claims the checker flagged now say 358. The versioned snapshot “351 registered providers in OmniRoute v3.8.0” and the chat-model registry denominator stay exempt.
- Strict `llm.txt` mirrors (`docs/i18n/*/llm.txt`) get the same `352-provider` → `358-provider` token so `check:docs-sync` stays green.
- Other locale mirrors were not retranslated. `.i18n-state.json` records the new English source hashes only. Locale hashes stay on the previous source, so `i18n:check` keeps those as non-blocking stale warnings.
- Skill surfaces covered by the new check move 327 → 358: `src/shared/constants/agentSkills.ts`, `skills/README.md`, `skills/omni-auth/SKILL.md`, `skills/omni-providers/SKILL.md`. Prettier also realigned existing tables in `docs/architecture/REPOSITORY_MAP.md` and `docs/frameworks/AGENTBRIDGE.md`.
- The regression fixture uses `**349** LLM providers` because 358 is the live total on this branch.

Checked locally on this branch: provider-count unit test 10/10, `check-docs-counts-sync` exit 0 with no strict drift, `i18n:check` PASS, `check:docs-sync` PASS.

Already at `origin/main` (`fd95f823`). CI was still queued at merge time. Local gates on this branch passed.

(cherry picked from commit f295b2e)
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