2.3 KiB
2.3 KiB
PR-014 [QUALITY]: Stabilize Workspace Formatting
Briefing
O workspace ja tem uma trilha clara de qualidade com fmt-check, clippy e test no fluxo de CI. Hoje, porem, a barra minima de formatacao nao esta fechando: cargo fmt -- --check falha por divergencias de ordenacao de imports e estilo em arquivos ja versionados.
Esta PR trata esse problema como higiene de base. O objetivo nao e "embelezar codigo", e sim restaurar o contrato de estilo para que a arvore volte a ter um estado formatado, previsivel e mecanico.
Problema
cargo fmt -- --checkfalha no estado atual do workspace;- ha arquivos versionados que divergem do estilo canonical do
rustfmt; - enquanto isso existir, o target
cideixa de ser confiavel como gate minimo de merge; - a equipe perde sinal: falhas de estilo misturam ruido de higiene com problemas reais de implementacao.
Alvo
- workspace Rust inteiro;
- arquivos tocados pelo
rustfmtque hoje geram diff; - fluxo
fmt-checkdefinido noMakefile.
Escopo
- Rodar
cargo fmtno workspace e revisar o diff gerado. - Confirmar que as mudancas sao estritamente de formatacao, sem alteracao semantica.
- Restaurar
cargo fmt -- --checkpara estado verde. - Se necessario, ajustar qualquer arquivo novo ou recente que tenha escapado do padrao.
Fora de Escopo
- Refatorar APIs.
- Renomear modulos.
- Resolver warnings de
clippy. - Alterar comportamento de testes ou runtime.
Abordagem
- Identificar exatamente quais arquivos fazem
fmt-checkfalhar. - Aplicar
cargo fmtno workspace. - Revisar diff para garantir ausencia de mudanca comportamental.
- Revalidar com
cargo fmt -- --check.
Criterios de Aceite
cargo fmt -- --checkpassa no workspace.- O diff da PR e apenas de formatacao.
- Nenhuma logica, assinatura publica ou comportamento de teste muda por causa desta PR.
- O target
fmt-checkdoMakefilevolta a ser um gate confiavel.
Tests
- Rodar
cargo fmt -- --check. - Rodar ao menos
cargo test --workspace --all-targets --all-features --no-fail-fastse a PR tocar arquivos em crates com testes relevantes, apenas para confirmar ausencia de regressao acidental.
Risco
Baixo. O risco principal e misturar formatacao com mudanca semantica no mesmo diff. A revisao deve ser severa: qualquer alteracao nao mecanica deve sair desta PR.