0003 · Ferramentas em Rust

• Status: aceita
• Data: 2026-10-17
• Decisores: Rogério Figueiredo

Contexto

O repositório precisa de ferramentas para validar o modelo, gerar a documentação e calcular a pontuação. O próximo passo é um coletor que chama as APIs do Azure DevOps e roda em pipelines de várias organizações, onde instalar um runtime e dependências é atrito.

Decisão

As ferramentas são uma única CLI em Rust, governanca, no crate ferramentas/. O modelo é desserializado com tipos estritos (campos desconhecidos são rejeitados) e a pontuação usa aritmética inteira.

Consequências

• Um binário estático, sem runtime, fácil de distribuir para agentes de pipeline.
• Erros de estrutura do modelo são pegos na leitura, antes das regras de consistência.
• O coletor futuro entra como novo subcomando da mesma CLI, reaproveitando o modelo tipado.
• O livro usa o mdBook, gerador do ecossistema Rust; a própria CLI é o pré-processador que ajusta os links.
• Contribuir com código exige toolchain Rust; contribuir com conteúdo continua exigindo só Markdown e YAML.