Lint e Validação

Quando Usar

Use após mudanças de comportamento ou configuração quando um repositório tiver verificações de lint ou de tipo relevantes. Leia primeiro as instruções do repositório e os scripts do pacote. Execute verificações focadas durante o desenvolvimento e as verificações necessárias antes da conclusão.

Procedimento

1. Identifique as linguagens alteradas, os comandos configurados e as ferramentas instaladas. Inspecione os scripts do pacote antes de executá-los: um script chamado lint pode modificar arquivos ou executar código arbitrário do projeto.
2. Execute os comandos de lint/verificação de tipo somente leitura do projeto. Para projetos Node, prefira scripts declarados como npm run lint e npm run typecheck. Não use npx para buscar silenciosamente um verificador ausente.
3. Para Python, use ferramentas configuradas e já instaladas como ruff check . ou mypy .. Não assuma que todo pyproject.toml configura ambos. Nunca adicione --fix sem inspecionar as alterações propostas e a autorização da tarefa.
4. Corrija falhas relevantes sem excluir trabalho do usuário, enfraquecer regras ou aumentar timeouts apenas para passar. Se uma ferramenta necessária estiver indisponível, relate a verificação exata que não foi executada.
5. Relate comandos, resultados de saída, escopo e limitações restantes. Passar no lint não prova a ausência de defeitos de tempo de execução ou de segurança.

Exemplo

Após corrigir um comportamento do TypeScript, inspecione package.json, execute o teste de regressão focado configurado, depois npm run lint e npm run typecheck se esses scripts existirem. Se o TypeScript estiver declarado, mas não instalado, relate o verificador local ausente; não substitua um pacote baixado nem chame o resultado de sucesso.

Utilitários Empacotados

• python scripts/lint_runner.py /absolute/project: executa um conjunto conservador de verificações candidatas. Verificadores de fallback Node devem existir em node_modules/.bin local; candidatos Python devem estar instalados. Inspecione os scripts do projeto primeiro. Um comando ausente ou uma verificação falha sai com código 1; nenhuma verificação configurada ou metadados de projeto inválidos sai com código 2. Saída 0 significa que as verificações invocadas passaram, não que todas as verificações necessárias foram descobertas. A detecção Python é heurística e pode sugerir comandos Ruff/MyPy não configurados.
• python scripts/type_coverage.py /absolute/project: inventário de anotações somente leitura, apesar de seu nome de arquivo de compatibilidade retido. Amostra no máximo 30 arquivos por linguagem, pula diretórios de links e de compilação/dependência, e limita a leitura de arquivos. Python usa nós AST para evitar contagem dupla de funções. TypeScript relata ocorrências lexicais de : any, incluindo possíveis comentários e strings. Nenhuma porcentagem de qualidade ou limite de aprovação/reprovação é inferido. Saída 2 significa que não há arquivos aplicáveis; erros de análise/leitura saem com código 1.

Limitações

O executor executa comandos confiáveis do projeto, que podem modificar arquivos ou acessar a rede. Ele não instala dependências, detecta todas as configurações de monorepo ou substitui o contrato de CI do projeto. O inventário é uma amostra de origem limitada, não cobertura de tipo semântica; tipos inferidos, genéricos, comportamento de decorador e correção exigem o verificador de tipo real. Não rotule verificações não executadas como bem-sucedidas.