assura

Assura é uma ferramenta de validação de linha de comando para projetos de software, escrita em Rust e distribuída sob licença dupla MIT/Apache-2.0. Seu objetivo é detectar desvios no projeto enquanto a correção ainda é simples, oferecendo uma camada de sinalização local rápida para estrutura de repositório, nomenclatura, limites de arquivos e seções, Markdown, referências, pressão de mudanças em branches e worktrees, além de políticas específicas do projeto. O projeto estrutura seu fluxo de trabalho como "Onboard once. Review while working. Explain when needed. Check before merge", separando a Revisão (descrita como o radar) da Verificação (descrita como o portão). As capacidades descritas no README incluem validação em nível de projeto de nomenclatura, posicionamento, caminhos obrigatórios ou proibidos, limites de arquivos e subdiretórios, Markdown, referências e limites de saída gerada dentro de uma política local; uma revisão compacta do projeto mostrando verificações configuradas, capacidades inativas, mudanças em branches/worktrees, diretórios críticos e próximas ações; saída em formatos de texto, JSON, YAML, conselhos, status e formatos para agentes com contexto específico por regra; onboarding pronto para agentes que estabelece uma base e instala orientações locais do projeto; camadas de políticas reutilizáveis que começam agnósticas à linguagem e adicionam regras de domínio conforme necessário; migração da configuração do LS-Lint 2.3; evidências de desempenho a frio e a quente; e validação local contínua que mantém uma política preparada ativa, consolida rajadas de edição e relata o escopo de cobertura. A instalação é oferecida via instalador shell público, arquivos de release pré-compilados para Linux, macOS e Windows (cada um contendo o assura e um companheiro interno assura-full que deve permanecer no mesmo diretório), ou compilação a partir do código-fonte via cargo. Um início típico orientado a agentes é mostrado como agent onboard, review, explain, watch, check; um início mínimo apenas de estrutura é init seguido de check. A configuração reside em .assura/config.yml, com blocos YAML para convenções de nomenclatura de arquivos e diretórios e globs de exclusão. O README afirma que o projeto está em fase pré-1.0: a v0.3.0 é a versão publicada mais recente, enquanto Review, Explain, onboarding, feedback de eventos e contratos de ativação de host gerenciado estão atribuídos a um candidato v0.4.0 que só se torna instalável publicamente após a tag passar pelo portão de lançamento. Uma tabela de suporte marca check e seus formatos de saída, init/status/migrate/hooks e relatórios de desempenho como suportados na v0.3.0 e no candidato v0.4.0, e marca review, doctor, explain, agent onboard, agent nudge, comandos de ciclo de vida de integração de agentes, verificações de Markdown/link/referência/orientação com pacotes de conteúdo/consulta/contexto locais, e watch/cache/daemon/sessions como superfícies do candidato v0.4.0. assura info, correções seguras de Markdown e famílias de políticas de extensões de primeira parte permanecem experimentais; painéis hospedados, reparo automático amplo, carregamento remoto de plugins, marketplaces de plugins e motores de validação por agente são explicitamente listados como superfícies não suportadas. Os lançamentos são orientados por tags: a versão e as notas são atualizadas, os portões de release-candidate são passados, uma tag v* anotada é enviada e o fluxo de trabalho de lançamento constrói arquivos para Linux, macOS e Windows com checksums. O desenvolvimento usa comandos cargo xtask em camadas (fast, pr, release-size, release-smoke, release-live, full), e as alegações de desempenho são rastreadas por benchmarks do cargo, incluindo uma comparação com o LS-Lint. Os links de documentação cobrem introdução, configuração, referência de CLI/API, política de suporte, notas de lançamento, contribuição e segurança.