Regua

Como se escreve uma régua aqui

Irmã da bug-hunt: aquela ensina a achar o defeito, esta ensina a escrever o instrumento. Nada abaixo é "escreva testes" — é o que este repositório aprendeu errando, com o caso e o número que comprou cada regra.

Se você seguir só uma linha:

Régua que não pode ficar vermelha não é régua. É decoração que dá confiança.

As cinco perguntas, antes de escrever a primeira linha

1. Qual defeito esta régua PREMIA?

Toda régua tem um estado ruim que aumenta o número dela. Ache-o antes de comemorar.

Caso: a graffiti-census mede "quanto da parede tem tinta". Uma peça de grafite flutuando no ar não derruba esse número — ela o melhora, porque cobre a placa que está atrás dela. A régua foi de 12,7% a 87% enquanto 698 peças ficavam penduradas no vazio, com o portão verde, até o dono ver e reclamar.

Se existir esse estado, escreva a régua irmã antes de declarar vitória. (graffiti-census ↔ graffiti-audit)

2. Ela mede no MESMO mundo em que o jogo roda?

Caso: decal-probe roda em node, onde nenhum GLB carrega. Jurava 334 decalques na Quebrada; no navegador havia 96. O dono contou "10-15% de arte" e estava certo por três dias contra um portão verde.

Se o que você mede depende de asset carregado, a régua precisa de navegador (playwright + npm run eval:serve, ver graffiti-census.mjs). Régua em node é mais rápida e mede outro jogo.

3. Qual o limiar, e quem MAIS usa esse limiar?

Caso: a passada de grafite aceitava 1 amostra vazia de 5 (20% de buraco); a auditoria reprovava acima de 2 de 15 (13%). Peça nascia aprovada num lado e reprovada no outro, e dois consertos seguidos não moveram o número (451 → 445 → 445). Alinhar os limiares — só isso — levou de 688 para 272.

Duas coisas que medem o mesmo conceito compartilham o limiar, de preferência a função. Quando não der, o relatório diz contra qual limiar mediu.

4. Como ela FALHA quando não sabe medir?

Não saber tem que custar o mesmo que estar errado.

Caso: gen-docs não reconheceu o LICENSE novo, devolveu null e seguiu em frente — publicou "0 ocorrências de null em 0 das 8 superfícies" e a doc publicada passou a dizer MIT num repositório AGPL.

null com cara de fato é pior que exceção. Se a régua não consegue medir, ela fica vermelha, não silenciosa.

5. Ela cabe no orçamento de quem vai rodá-la?

Régua que ninguém roda não serve. Orçamento desta base: portão rápido em minutos, build de mapa em milissegundos.

Caso: a auditoria de grafite nasceu com >10 min porque atirava 48 mil raios contra a lista inteira de malhas. Com prefiltro espacial (gradeEspacial, exportada de graffiti_pass.js e compartilhada, não copiada) virou minutos, com resultado idêntico — prefiltro geométrico não é aproximação.

Se não couber, ou você prefiltra, ou assa o resultado (ver graffiti_layout.js) e transforma "resultado velho" em item de régua.

A mutação, que é o teste do teste

Régua entra com uma mutação que a faz ficar vermelha. Sem isso você não sabe se ela mede — sabe que ela imprime.

1. rode a régua no estado bom            -> tem que dar VERDE
2. quebre de propósito o que ela cobre   -> tem que dar VERMELHO, com a mensagem certa
3. restaure                              -> tem que voltar a VERDE

E a mutação tem que falhar se não aplicou. Caso real: plantei **MIT License** num arquivo com um replace que não casou (o texto já tinha mudado), o check deu verde, e por um instante isso pareceu "o guarda funciona". Sempre:

n = s.replace(velho, novo)
assert n != s, 'MUTANTE NAO APLICOU'

Mutação decorativa é pior que nenhuma: ela dá confiança falsa por escrito.