Testes

Testes são pedaços de código que usam o app sozinhos e conferem se o resultado está certo. Com eles, uma mudança do agente que quebra algo antigo aparece na hora, e não semanas depois, quando um cliente reclama.

O Faundr mostra quais testes o projeto tem, se passam, quais estão pulados ou instáveis, quanto do código eles cobrem e, se você quiser ir além, se eles realmente pegam defeitos.

Em que linguagens

O Faundr usa os executores de teste que o projeto já tem, sem instalar nada:

Para rodar só um deles: !faundr tests-run --runner <nome> (vitest, jest, playwright, node, pytest, flutter, dart, phpunit, pest, go, maven, gradle, dotnet, cargo, ctest, make ou karma). A tabela completa está em Linguagens suportadas.

Os testes nunca rodam sozinhos

No início de cada sessão, o Faundr só faz o inventário: quais executores o projeto usa, quantos arquivos e testes existem e o resultado que já estiver no disco. Ele não roda nada. Os testes rodam quando você ou o agente pedem:

!faundr tests-run

Opções úteis:

• --changed: só o que mudou desde o último commit;
• --coverage: mede também a cobertura (veja abaixo);
• --files <arquivos>: só alguns arquivos.

Projeto sem testes

Se o projeto ainda não tem testes, a Visão geral explica o que são e traz o pedido para o agente criar os primeiros: /faundr:tests. O agente:

1. pergunta o que não pode quebrar (o pagamento? o cadastro?);
2. liga cada funcionalidade aos testes que a protegem;
3. escreve os testes que faltam, um de cada vez, testando como quem usa o app, com o resultado esperado escrito à mão e os casos de erro, de vazio e de limite;
4. vê cada teste novo falhar uma vez antes de confiar nele (um teste que nunca falha pode não estar testando nada).

Abas

Visão geral

• O card de estado: "N testes falhando" ou "Todos os testes passaram", quantos arquivos e testes existem, os contadores (Passaram, Falhando, Instáveis, Pulados) e a última rodada de cada executor, com data e commit.
• Funcionalidades e testes: uma linha por funcionalidade, com a etiqueta Protegida, Em parte ou Sem testes. As marcadas como "não pode quebrar" sem testes ficam em destaque.
• Os grupos Falhando, Instáveis (passam e falham sem o código mudar), Testes que precisam de atenção (problemas de testes encontrados pela Qualidade) e Mais lentos.

Testes

Todos os testes, com os filtros Falhando, Instáveis, Pulados e Todos. Cada linha mostra as últimas 10 rodadas em quadradinhos: branco passou, contorno claro falhou, apagado foi pulado.

O detalhe mostra o que deu errado (a mensagem da falha) e o botão Consertar com a IA (/faundr:tests-fix). O agente explica a falha em português, descobre se o erro está no código ou no teste e conserta a causa. Ele nunca apaga, pula ou afrouxa um teste só para passar. Se não der para saber qual comportamento é o certo, ele pergunta a você.

O que mudou

A pergunta que importa a cada sessão: o que o agente mudou tem teste? Mostra a porcentagem das linhas novas ou mudadas que têm teste e compara com o resto do projeto. A meta é simples: não piorar.

Abaixo, os arquivos da sessão com mais linhas sem teste primeiro, e os arquivos que perderam cobertura sem ninguém mexer neles, o que costuma indicar um teste apagado ou quebrado.

Cobertura

Quanto do projeto tem teste: a porcentagem total e a lista de arquivos, os com mais linhas sem teste primeiro. O detalhe de um arquivo mostra as linhas sem teste e o pedido para o agente escrever os testes.

A cobertura é medida com !faundr tests-run --coverage. Cada linguagem usa a ferramenta de medição dela, que precisa estar no projeto: @vitest/coverage-v8 no Vitest, pytest-cov no pytest, Xdebug ou PCOV no PHP, coverlet.collector no .NET, cargo-llvm-cov no Rust, gcovr no C/C++ e o plugin JaCoCo no Gradle. Jest, node --test, Flutter, Go e Maven medem sem nada a mais.

Mutação

O teste de mutação responde se os testes pegam defeitos de verdade. O Faundr estraga o código de propósito, um pouco de cada vez (troca um > por >=, apaga uma linha), só nos trechos que a sessão mudou, e vê se algum teste percebe. Cada estrago que passa despercebido vira um T-n, descrito em linguagem simples, como "ninguém testou a compra de exatamente R$ 100".

• O card mostra "Os testes pegaram N de M defeitos plantados", a nota geral e a nota onde existe teste.
• O detalhe de um T-n mostra o código, o estrago e o botão Escrever o teste com a IA (/faundr:tests T-n).
• Ignorar aceita três motivos: o estrago é equivalente (não muda o que o app faz, então nenhum teste consegue pegar), alarme falso ou deixar para depois.

O teste de mutação é opcional e só roda quando pedido: !faundr tests-mutation. Ele precisa do Stryker no projeto e dos testes passando, e tem tempo limitado (5 minutos por padrão). Funciona com testes de JavaScript e TypeScript (Vitest, Jest, node --test).

Achados de outras skills

Se você já usa uma skill de testes que não é do Faundr (de cobertura, TDD, avaliação de testes…), dá para conectá-la ao painel com /faundr:skills. Toda vez que ela roda, no fim da resposta o agente registra o que ela achou:

• cada falta de teste vira um T-n na aba Mutação, com a etiqueta via /nome, e conta no Lançamento e no Impacto como os outros;
• quando ela roda de novo e o problema sumiu, ele fecha sozinho;
• cada skill só fecha os próprios achados, e só nos arquivos que olhou.

Veja como conectar em Workflows.

Erros e testes

Um teste que falha numa rodada do agente também aparece em Erros. Quando o teste volta a passar, o erro fecha sozinho.

Comandos