Skip to content

docs: sync all documentation to v3.8.24 + count-guard & wiki/prose CI - #3804

Merged
diegosouzapw merged 4 commits into
release/v3.8.26from
docs/sync-v3.8.24
Jun 15, 2026
Merged

diegosouzapw merged 4 commits into
release/v3.8.26from
docs/sync-v3.8.24

Conversation

@diegosouzapw

Copy link
Copy Markdown
Collaborator

Full documentation sync to the current v3.8.24 state across root docs, /docs, the :20128/docs site sources, and the GitHub wiki, plus CI guards to stop the drift recurring.

Canonical counts (validated against code)

Metric Was Now
Providers 177 / 232 / 160+ 226 (regen PROVIDER_REFERENCE found 3 new: gemini-business, lmarena, zenmux)
Unit test files 122 1,574
Test cases 4,690 15,000+ (~15,900)
Routing strategies 14 15
i18n locales 30 / 40 42
Auto-combo factors (AGENTS) 12 9

Propagated across README, AGENTS, CLAUDE, CONTRIBUTING, docs/README, ARCHITECTURE, REPOSITORY_MAP, CODEBASE_DOCUMENTATION, ACP, AGENTBRIDGE, PROVIDERS-GUIDE, I18N.

New docs (verified against real code; anti-hallucination gates clean)

  • frameworks/PLUGIN_MARKETPLACE, NOTION_CONTEXT, OBSIDIAN_CONTEXT
  • guides/FREE_PROVIDER_RANKINGS, COST_TRACKING; security/EGRESS_POLICY; reference/FEATURE_FLAGS
  • Fixed MCP-SERVER: 43→87 tools, dropped fabricated omniroute_notion_* names, added real Notion/Obsidian(22)/Gamification(8)/Plugin(8) tables + 30 scopes
  • Registered 4 orphaned docs in sidebars (meta.json)

CI / tooling

  • check:docs-counts: new STRICT provider + locale guards (now blocking via check:docs-all) + unit tests — closes the root cause of the count drift
  • wiki-sync workflow + sync-wiki-home.mjs (keeps wiki cover counts synced to code) + unit tests
  • docs-lint advisory job (markdownlint + Vale) with configs
  • regenerated openapi.generated.ts

Validation

  • npm run check:docs-all exit 0 (docs-sync, count-guard, env-doc-sync, doc-links PASS)
  • check:docs-symbols clean for all new docs; 14 new unit tests pass; eslint 0 errors
  • Wiki already re-synced (226/15/87/42) via direct push

Code bugs surfaced while documenting (NOT fixed here — follow-ups)

  • pluginMarketplaceUrl not persisted via PATCH /api/settings (key absent from schema)
  • CLI pricing defaults set → nonexistent PUT /api/pricing/defaults; usage budget set schema mismatch
  • TOTAL_MCP_TOOL_COUNT=87 double-counts 3 agent_skill tools (84 distinct registered)
  • stale category comments in featureFlagDefinitions.ts (Security (6)→7, Network (5)→6)

…e CI

Counts (canonical, validated against code):
- providers 177/232/160+→226 (regen PROVIDER_REFERENCE found 3 new: gemini-business, lmarena, zenmux)
- tests 122→1,574 unit; 4,690→15,000+ cases; strategies 14→15; locales 30/40→42; auto-combo factors 12→9
- propagated across README, AGENTS, CLAUDE, CONTRIBUTING, docs/README, ARCHITECTURE, REPOSITORY_MAP, CODEBASE, ACP, AGENTBRIDGE, PROVIDERS-GUIDE, I18N

New docs (verified against real code, anti-hallucination gates clean):
- frameworks/PLUGIN_MARKETPLACE, NOTION_CONTEXT, OBSIDIAN_CONTEXT
- guides/FREE_PROVIDER_RANKINGS, COST_TRACKING; security/EGRESS_POLICY; reference/FEATURE_FLAGS
- fix MCP-SERVER tool inventory: 43→87, real Notion names (drop fabricated omniroute_notion_*), +Obsidian(22)/Gamification(8)/Plugin(8), 30 scopes
- register 4 orphaned docs in sidebars (meta.json)

CI / tooling:
- check:docs-counts: add STRICT provider+locale guards (now blocking via check:docs-all) + tests
- wiki-sync workflow + sync-wiki-home.mjs (keeps wiki cover counts synced) + tests
- docs-lint advisory job (markdownlint + Vale) with configs
- regen openapi.generated.ts
@gemini-code-assist

Copy link
Copy Markdown
Contributor

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@github-actions

github-actions Bot commented Jun 14, 2026 •

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 changed the base branch from main to release/v3.8.25 June 14, 2026 01:07
@diegosouzapw
diegosouzapw changed the base branch from release/v3.8.25 to release/v3.8.26 June 15, 2026 07:23
diegosouzapw added a commit that referenced this pull request Jun 15, 2026
…ocs build passes

docs/ops/DOCUMENTATION_AUDIT_REPORT.md (added in #3804) was the only file
under docs/ops/ without a `title:` frontmatter block. Fumadocs scans docs/**
into the `docs` collection and fails the production build with
"Invalid input: expected string, received undefined" (title) — the same MDX
frontmatter class of break as the v3.8.25 SUPPLY_CHAIN.md incident (#3864).
Fast Quality Gates does not run `npm run build`, so it stayed green on the
release branch and would only explode at release->main sync. Added the
frontmatter matching the sibling docs/ops/*.md convention; full build now
passes (Next.js compiled 549/549 pages).
…v3.8.24

# Conflicts:
#	.github/workflows/wiki-sync.yml
#	README.md
#	docs/frameworks/AGENTBRIDGE.md
#	docs/frameworks/MCP-SERVER.md
#	docs/reference/PROVIDER_REFERENCE.md
@diegosouzapw
diegosouzapw merged commit e697538 into release/v3.8.26 Jun 15, 2026
2 checks passed
@diegosouzapw
diegosouzapw deleted the docs/sync-v3.8.24 branch June 17, 2026 00:51
tkgo11 pushed a commit to tkgo11/OmniRoute that referenced this pull request Sep 23, 2026
…ocs build passes

docs/ops/DOCUMENTATION_AUDIT_REPORT.md (added in cheaper-inference#3804) was the only file
under docs/ops/ without a `title:` frontmatter block. Fumadocs scans docs/**
into the `docs` collection and fails the production build with
"Invalid input: expected string, received undefined" (title) — the same MDX
frontmatter class of break as the v3.8.25 SUPPLY_CHAIN.md incident (cheaper-inference#3864).
Fast Quality Gates does not run `npm run build`, so it stayed green on the
release branch and would only explode at release->main sync. Added the
frontmatter matching the sibling docs/ops/*.md convention; full build now
passes (Next.js compiled 549/549 pages).
tkgo11 pushed a commit to tkgo11/OmniRoute that referenced this pull request Sep 23, 2026
…cheaper-inference#3804)

Integrated into release/v3.8.26 — reconciled: kept cheaper-inference#3900's superset wiki-sync, dropped the superseded sync-wiki-home; counts taken from the newer canonical release docs; net-new value = vale/markdownlint docs-lint infra + 7 new docs (Notion/Obsidian/Plugin-Marketplace/Cost-Tracking/Free-Provider-Rankings/Feature-Flags/Egress-Policy) + check-docs-counts-sync guard.
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