docs: map guard.rs, fix dependency graph, update coverage & ADR refs - #75
Merged
Conversation
…33/0034) Validação linha-a-linha de toda a documentação (dados/, diagramas/, mapeamentos/, referencia/, README) contra o código-fonte real. As Partes já reconciliadas nos próprios commits de ADR (referencia/, dados/10-13, diagramas/) foram confirmadas exatas; as correções abaixo cobrem o que ficou defasado após as Ondas 1-5 do roadmap e os ADRs 0033/0034. Histórico preservado (itens removidos permanecem documentados como removidos/RESOLVIDO com o ADR). - README: contagem .ts/.tsx 160 → 165 (btv-web cresceu nas Ondas 1-3; metodologia repo-inteiro, coerente com .rs=137 e .py=86). - dados/14: adiciona campo `Commands::Experiment.format` (--format, VerifyFormat). - dados/15: documenta `btv-server/src/guard.rs` (guarda de Origin/Host, ADR 0015, extraída de lib.rs na C2); corrige "17 rotas de API" → 16 (+ /dev aninhado). - dados/17: adiciona `lib/screenComponents.tsx` e `hooks/useAsyncAction.ts` (fontes reais do btv-web antes não listadas). - mapeamentos/00: job `coverage` do CI agora existe (não-bloqueante); comando de cobertura Python alinhado ao CI. - mapeamentos/01: corrige o grafo de dependências — aresta btv-llm → btv-schemas; inverte as setas de btv-golden (é dev-dep de server/cli, não o contrário); aresta dev-dep btv-store → btv-contract; btv-cli 11 crates (não ~12). - mapeamentos/06: estende a linha do tempo/tabela de schema até ADR 0033 (max_autonomy_level removido) e 0034 (RPCs mortos do CoreService removidos). - diagramas/09 e referencia/10: harmoniza a contagem de deps do btv-cli (~12 → 11 internos + btv-golden em dev) com mapeamentos/01. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MmhBQpFPubmAohuDwoqFYY
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
2 participants
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.
Summary
Documentation updates across architecture mapping and reference guides to reflect recent code changes and clarifications:
Key changes
docs/documentacao/dados/15-rust-server-e-outros.md
crates/btv-server/src/guard.rswith data flow table coveringrequire_local_origin,origin_allowed,trusted_origin_hosts, andBTV_TRUSTED_ORIGINSenv vardocs/documentacao/mapeamentos/01-dependencias-build-features.md
LLM → SCH(btv-llm now depends on btv-schemas)STORE -. dev-dep .-> CONTRACT,SERVER -. dev-dep .-> GOLD,CLI -. dev-dep .-> GOLDdocs/documentacao/dados/17-typescript-e-html.md
screenComponents.tsxandhooks/useAsyncAction.tsto utilities sectionSCREEN_COMPONENTSconfig map andAsyncState<T>union withuseAsyncActionhookdocs/documentacao/mapeamentos/06-migracao-de-schema.md
squad.protomax_autonomy_levelremoval (reserved field) andcore.protoRPC cleanup (AppendLedger/Recall/Remember)docs/documentacao/diagramas/09-analise-critica.md
docs/documentacao/mapeamentos/00-como-usar.md
coverage(non-blocking, artifact); Python coverage command corrected touv run --with pytest-cov pytest --cov=packagesdocs/documentacao/README.md
docs/documentacao/referencia/10-rust-crates.md
docs/documentacao/dados/14-rust-cli.md
Commands::Experiment.formatfield documentation (VerifyFormat enum for Human vs Json output)Notes
All changes are documentation-only; no source code modifications. Updates align with recent refactoring of guard middleware, dependency clarifications, and ADR progression through Phase 7.
https://claude.ai/code/session_01MmhBQpFPubmAohuDwoqFYY