Supercov

Visão Geral

O Supercov executa o comando de teste do próprio projeto na máquina do usuário e reporta a cobertura de linha, branch e MC/DC por teste. Ele não altera o código-fonte, os testes ou a configuração. Essa habilidade usa esse relatório para selecionar uma peça de código não testada por vez e escrever um teste focado para ela.

Funciona com projetos JavaScript, TypeScript, Python, Ruby, Rust, Go, Java e Kotlin.

Quando Usar Esta Habilidade

• Use quando o usuário pedir para adicionar ou melhorar testes.
• Use quando o usuário perguntar qual código não foi testado, ou pedir para aumentar a cobertura.
• Use quando o usuário perguntar qual arquivo refatorar primeiro e concordou com uma verificação de qualidade (veja "Verificação de Qualidade").

Pré-requisitos

• Node.js 22 ou mais recente. Se estiver faltando, informe o usuário. Não instale software sem a aprovação do usuário.
• O comando de teste do projeto, por exemplo npm test, pytest ou cargo test. Pergunte se não for óbvio pelo repositório.
• Sempre execute a versão fixada, npx supercov@3.0.4. A primeira execução baixa essa release do npm, então obtenha a aprovação do usuário antes.

Como Funciona

Etapa 1: Medir o Conjunto de Testes

Execute o comando de teste completo sob o Supercov. A cobertura é medida localmente e nada é enviado pela rede.

npx supercov@3.0.4 -- npm test

Etapa 2: Selecionar um Alvo

Liste o código não testado, selecione um item e leia-o em contexto.

npx supercov@3.0.4 runs latest gaps --limit 5
npx supercov@3.0.4 runs latest file src/session.js

Etapa 3: Escrever um Teste Focado

Escreva um teste para o alvo escolhido. Altere apenas os arquivos de teste, a menos que o usuário peça o contrário.

Etapa 4: Reexecutar e Relatar

Reexecute o comando da etapa 1. Relate o teste que você adicionou e a cobertura antes e depois.

Para qualquer coisa não mostrada aqui, npx supercov@3.0.4 docs <topic> imprime o guia para essa versão. Tópicos: agent-loop, quality, supported-suites, troubleshooting.

Exemplos

Exemplo 1: Adicionar um teste para código não testado

npx supercov@3.0.4 -- npm test
npx supercov@3.0.4 runs latest gaps --limit 5
# add one test for the first gap, then:
npx supercov@3.0.4 -- npm test

Exemplo 2: Outras linguagens

npx supercov@3.0.4 -- pytest
npx supercov@3.0.4 -- cargo test
npx supercov@3.0.4 -- go test ./...
npx supercov@3.0.4 -- ./gradlew test

Verificação de Qualidade

npx supercov@3.0.4 quality classifica arquivos por "code smells" (cheiros de código), e npx supercov@3.0.4 quality patch relata o que uma alteração introduziu.

• Esses dois comandos enviam os arquivos-fonte do projeto para a API da TypeSafe para análise. Execute-os apenas quando o usuário solicitar uma verificação de qualidade e informe o usuário antes de executar que seus arquivos-fonte serão enviados para a TypeSafe.
• Eles precisam da TYPESAFE_API_KEY do próprio usuário no ambiente. Nunca peça ao usuário para colar uma chave na conversa, e nunca crie, leia ou imprima uma.
• Se a chave estiver faltando, informe ao usuário que a verificação precisa dela, depois responda com base na leitura do código e diga que o Supercov não a verificou.

Melhores Práticas

• ✅ Meça o conjunto de testes completo primeiro, para que as lacunas reflitam todos os testes.
• ✅ Adicione um teste por lacuna e reexecute antes de selecionar o próximo.
• ✅ Relate a cobertura antes e depois com os números que o Supercov imprimiu.
• ❌ Não altere o código da aplicação para aumentar a cobertura, a menos que o usuário peça.
• ❌ Não execute os comandos de qualidade sem a solicitação e o consentimento do usuário.

Limitações

• A cobertura mostra qual código foi executado sob um teste. Ela não mostra que o teste verificou o resultado.
• O Supercov mede os conjuntos de testes listados em npx supercov@3.0.4 docs supported-suites. Outros executores não são medidos.
• O comando de teste é executado como o projeto o define. Se o conjunto de testes precisar de serviços, credenciais ou acesso à rede, essas necessidades ainda se aplicam.
• Esta habilidade não substitui validação específica do ambiente, testes ou revisão de especialistas.
• Pare e peça esclarecimentos se os inputs, permissões ou limites de segurança necessários estiverem faltando.

Notas de Segurança e Proteção

• A habilidade executa o comando de teste do próprio projeto e escreve arquivos de teste no repositório do usuário. Execute-a apenas em um repositório que o usuário autorizou e mantenha as alterações nos arquivos de teste, a menos que o usuário peça o contrário.
• O Supercov escreve seus dados de execução em um diretório .supercov no projeto. Ele não edita o código-fonte, testes ou configuração.
• npx supercov@3.0.4 baixa uma release fixada do registro npm. Obtenha a aprovação do usuário antes da primeira execução. Atualizar a fixação requer uma nova revisão.

…