Repository navigation
docs(audit): align every published number with the code and harden check:docs-counts - #12200
Merged
Merged
Conversation
…eck:docs-counts Fase 2 of the 2026-08-31 code-vs-docs audit (fase 1 report: _tasks/research/2026-08-31-auditoria-readme-docs-vs-codigo-v3851.md). README/llm.txt (+42 mirrors)/SVGs/mmds and 25+ docs updated to the measured counts (352 providers, 167 migrations, 110 MCP tools/33 scopes, 45 canonical, 15 factors, 6 mode packs, 19 strategies, 12 engines, 122 db modules, 446 free-tier entries/38 pools/53 free-forever/152 hasFree, 6 A2A skills, 4 cloud agents, 5 embedded services, 15 ACP agents, 43 locales, v3.8.51). Semantic fixes: the provider breaker tables now describe the runtime wiring (circuitBreakerThreshold 8/12/2 + DEGRADED state; providerFailureThreshold is documented as having no runtime consumer), webhooks docs drop 3 phantom events and stop denying the webhook_deliveries table, ROUTE_GUARD_TIERS mirrors the full 42-prefix/4-pattern/6-always-protected sets, API_REFERENCE drops 7 phantom endpoints, REASONING_REPLAY cache is 200 (not 2000). check:docs-counts hardened: version-prose check (README footer + llm.txt vs package.json), rewritten free-forever/N-tool/SQL-migration-files patterns, catalog entries + recurring pools claims, llm.txt/mcp-server README/omni-mcp SKILL/tier-flow SVGs added to the gated surface; +5 regression tests.
Contributor
|
Parabens, vamos continuar evoluindo assim cada vez mais, Otimo PR |
…remaining surfaces The Merge-integrity job caught skills/omni-mcp/SKILL.md being edited by hand: it is generated from src/shared/constants/agentSkills.ts, which still said 107 tools / 32 scopes. Fix the source (generator now reproduces the corrected output verbatim — 46/46 unchanged) and sweep the same stale family from the surfaces the audit partition missed: skills/README.md, CONTRIBUTING.md, docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md, docs/guides/SETUP_GUIDE.md, the Copilot driver system prompt (37 -> 110) and the omni-mcp description string in 39 locale files (37/107 -> 110, 16/32 -> 33).
This was referenced Aug 31, 2026
muhamadgalihsaputra
pushed a commit
to niyatna/NiyatnaRoute
that referenced
this pull request
Sep 27, 2026
…eck:docs-counts (cheaper-inference#12200) Fase 2 da auditoria código×docs 2026-08-31: ~90 divergências corrigidas em README/llm.txt(+42 espelhos)/SVGs/AGENTS.md/25+ docs; correções semânticas (breaker 8/12/2 + DEGRADED, webhooks sem eventos fantasma, ROUTE_GUARD_TIERS completo, API_REFERENCE sem fantasmas, reasoning 200); gate check:docs-counts endurecido (versão em prosa, patterns anti-evasão, superfície +llm.txt/mcp-server/omni-mcp/tier-flow) +5 testes; fonte do gerador de agent-skills corrigida (107/32 → 110/33) e mesma família varrida do Copilot prompt, 39 locales, skills/README, CONTRIBUTING e 2 guias.
This was referenced Oct 8, 2026
Closed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
O que é
Fase 2 (execução) da auditoria profunda código × documentação de 2026-08-31 — fase 1 (levantamento, ~90 divergências com arquivo:linha) está em
_tasks/research/2026-08-31-auditoria-readme-docs-vs-codigo-v3851.md.Docs-only + gate: nenhuma mudança de comportamento de runtime.
Números alinhados ao código medido
352 providers · 167 migrations · 110 MCP tools / 33 scopes (45 canonical) · 15 factors · 6 mode packs · 7 auto-variants · 19 strategies · 12 engines · 122 db modules · 446 free-tier entries / 38 pools / 53 free-forever / 152 hasFree · 6 A2A skills · 4 cloud agents (+cursor-cloud) · 5 embedded services (+dario) · 15 ACP agents · 43 locales · versão 3.8.51 — em README, llm.txt (+42 espelhos re-sincronizados), 10 SVGs/mmds (incl.
tier-flow-*.svgservidos no onboarding), AGENTS.md e 25+ docs.Correções semânticas (não só número)
resilience-layers.svgagora descrevem o wiring real (circuitBreakerThreshold8/12/2 + estadoDEGRADED);providerFailureThreshold(10/15/2) é documentado como sem consumidor no runtime — decidir remover/ligar fica para um PR de código.provider.error/provider.recovered/combo.switched); o doc parava de negar a tabelawebhook_deliveries(migração 069) e ganha as rotas/kinds reais.openapi.yaml.[1, 200].promise-pillars.svgda raiz removido (nenhuma referência; a cópia canônica vive emdocs/diagrams/).Gate endurecido (
check:docs-counts)Novas regras STRICT: versão em prosa (rodapé do README +
llm.txtvspackage.json), formas reescritas que evadiam os patterns (N recurring/keyless free-forever,N-tool,N versioned SQL migration files), claims novos de catálogo (446 entries / 38 recurring pools com skip do subset positivo) e superfície ampliada (llm.txt,open-sse/mcp-server/README.md,skills/omni-mcp/SKILL.md,public/images/tier-flow-*.svg). +5 testes de regressão emtests/unit/check-docs-counts-sync.test.ts(33/33 verdes).Validação
check:docs-counts✅ (com as regras novas) ·docs-sync✅ ·doc-links✅ ·fabricated-docs✅ ·env-doc-sync✅ ·api-docs-refs✅ ·docs-symbols✅node --import tsx/esm --test tests/unit/check-docs-counts-sync.test.ts→ 33 pass / 0 failrelease/v3.8.51).