Pular para o conteúdo
ReviewRamble

A newsletter semanal

IA, analisada, na sua caixa de entrada.

  • Novas análises de ferramentas, modelos, servidores MCP e repositórios, com o veredicto logo no início
  • Preços e notas reconferidos quando algo muda
  • Novos artigos de análise assim que são publicados

Modelos, agentes, servidores MCP e as ferramentas que realmente valem seu tempo.

Um e-mail por semana. Cancele pelo link em qualquer edição. Como usamos seu e-mail

landmines

Regras do Oxlint que barram os atalhos que agentes de código usam para deixar testes verdes: mock do que é testado, esperas fixas, retentativas e timeouts maiores.

Análise de ReviewRamble editors · Atualizado

Ver no GitHub Código aberto

Compartilhe esta página:XLinkedInFacebookRedditWhatsAppE-mail

Nossa nota

3.7/5

landmines coloca atrás de um erro de lint os truques que agentes de código usam para burlar testes, o que é barato e útil, mas ele fiscaliza como um teste espera e simula, não se ele verifica alguma coisa.

O que é landmines?

landmines é um conjunto de plugins do Oxlint da Interfere, publicado no npm como @interfere/landmines. As regras de teste miram os jeitos pelos quais um agente consegue fazer uma suíte Vitest passar sem o código funcionar: trocar dependências por mocks de módulo ou implementações de `vi.fn`, iniciar o MSW sem falhar em requisições não tratadas, esperar um atraso fixo, consultar o estado de um spy em vez de aguardar um evento e adicionar retentativas ou timeouts maiores. A mensagem de cada regra diz qual é a correção honesta, para que o agente que a disparou corrija o rumo no mesmo ciclo.

A configuração recomendada também liga mais seis regras opinativas de estilo, estrutura e tipos: nada de comentários em prosa, testes ao lado do que testam, nomes fixos para arquivos de teste, exports de pacote explícitos e nada de tipos de retorno anotados. O repositório foi criado em 28 de outubro de 2026, tem 690 estrelas e licença MIT; a 0.1.0 saiu em 17 de novembro e a 0.1.1 um dia depois. Exige Oxlint 1.81 ou mais recente e Node 22.18 ou mais recente.

landmines vale a pena?

Um agente de código instruído a deixar o CI verde muitas vezes faz exatamente isso. Ele faz mock do módulo que deveria testar, adiciona uma espera fixa até uma condição de corrida costumar se resolver ou embrulha um teste instável em retentativas. Tudo isso passa numa revisão rápida. landmines transforma esses truques em falhas de lint, e isso importa porque o lint roda a cada edição e o agente lê a saída.

As cinco regras de teste são o motivo para instalar. `no-test-doubles` permite spies que só observam, mas rejeita comportamento substituído e leva você a implementações reais e ao MSW para a rede; `strict-msw` depois faz o MSW falhar em qualquer requisição sem mock. `no-fixed-sleep` também pega esperas dentro de callbacks de `act`, `waitFor` e `.then`, e `no-flake-masking` lê `retry`, `testTimeout` e `hookTimeout` na configuração do Vitest e também em cada teste. Na nossa leitura do changelog, a 0.1.1 fechou várias das brechas fáceis, como callbacks de timer com corpo em bloco.

A adoção em código antigo é bem resolvida. Três regras aceitam uma cota por arquivo com contagem exata, e a regra avisa quando um arquivo tem menos violações do que o permitido, então a lista só pode encolher.

O porém: nenhuma regra julga a qualidade das asserções, então um teste que afirma `true` ou só confere que uma função foi chamada continua passando. As regras foram escritas em torno de Vitest e MSW; suítes de Jest, Mocha ou Playwright Test ganham pouco. A configuração recomendada é opinativa para além dos testes: proibir comentários em prosa e tipos de retorno anotados vai bater de frente com as convenções de muitas equipes, então a maioria vai registrar só o plugin de teste. E o projeto tem três semanas, está na 0.1.x e vem de uma única empresa.

Nossa opinião: para uma equipe TypeScript que já usa Oxlint e Vitest, o plugin de teste é uma dependência pequena que fecha os jeitos mais baratos de um agente mentir, e combina bem com uma pessoa que continua lendo as asserções.

Onde ele se destaca

  • Um engenheiro de plataforma em uma empresa SaaS de 20 pessoas

    Barrar pull requests de agentes que passam no CI fazendo mock do código testado

    Registre só `landmines-testing` em `.oxlintrc.json` e rode o Oxlint no ciclo do agente e no CI; `no-test-doubles` reprova a mudança e a mensagem aponta o agente para a implementação real mais o MSW.

  • Um tech lead com uma suíte Vitest antiga e instável

    Adotar as regras sem consertar centenas de testes de uma vez

    Configure `no-flake-masking` e `no-fixed-sleep` com um bloco `allow` listando as contagens atuais por arquivo. Arquivos novos precisam estar limpos, e cada cota precisa cair conforme os testes antigos são corrigidos.

Antes de decidir

Configuração
`bun add -d oxlint @interfere/landmines` (ou o equivalente no npm) e depois estenda `./node_modules/@interfere/landmines/configs/recommended.json` em `.oxlintrc.json`, ou liste plugins e regras avulsos. Exige Oxlint 1.81+ e Node 22.18+.
Integrações
Plugins JS do Oxlint; as regras entendem as APIs e a configuração do Vitest, MSW 2 e 3 e callbacks do React Testing Library. O README sugere combinar com o anti-slop para regras de nível de tipo.
Dados e privacidade
Roda localmente como linter, sem acesso à rede nem telemetria descritos. Publicado no npm com proveniência. Licença MIT.
Custo em escala
Gratuito. O custo é tempo de engenharia: implementações reais e handlers do MSW no lugar de mocks levam mais tempo para escrever do que os atalhos que substituem.
Limites
Dez regras na 0.1.1, todas como erro na configuração recomendada. Não verifica a força das asserções. As regras de estilo e de tipos são opinativas e podem conflitar com convenções existentes.

O que é bom

  • Pega sujeitos com mock, esperas fixas, retentativas e timeouts maiores
  • As mensagens de erro dizem ao agente o que fazer no lugar
  • Cotas por arquivo que só diminuem, para código existente
  • Os plugins podem ser registrados um a um

O que não é

  • Não detecta asserções fracas ou vazias
  • Feito para Vitest e MSW; pouco para outros runners
  • A configuração recomendada proíbe comentários e tipos de retorno
  • Projeto novo, na 0.1.x, de uma única empresa

Ideal para

Equipes TypeScript com Oxlint e Vitest que deixam agentes de código escrever ou consertar testes e querem bloquear automaticamente os atalhos de sempre.

Alternativas ao landmines

landmines: perguntas frequentes

landmines vale a pena?
landmines coloca atrás de um erro de lint os truques que agentes de código usam para burlar testes, o que é barato e útil, mas ele fiscaliza como um teste espera e simula, não se ele verifica alguma coisa. Damos nota 3.7 de 5.
Quanto custa landmines?
Gratuito e de código aberto (MIT).
Quais são as desvantagens de landmines?
Não detecta asserções fracas ou vazias; feito para Vitest e MSW; pouco para outros runners; a configuração recomendada proíbe comentários e tipos de retorno; projeto novo, na 0.1.x, de uma única empresa.
Para quem landmines é indicado?
Equipes TypeScript com Oxlint e Vitest que deixam agentes de código escrever ou consertar testes e querem bloquear automaticamente os atalhos de sempre.
Quanto custa landmines para uma equipe ou em produção?
Gratuito. O custo é tempo de engenharia: implementações reais e handlers do MSW no lugar de mocks levam mais tempo para escrever do que os atalhos que substituem.
landmines é seguro para dados da empresa?
Roda localmente como linter, sem acesso à rede nem telemetria descritos. Publicado no npm com proveniência. Licença MIT.
Quais são as melhores alternativas ao landmines?
As alternativas mais próximas que analisamos são Superpowers, ast-grep e CC Safety Net.

Respostas verificadas em 20 de nov. de 2026.