Um fabricante que publica os próprios defeitos

Existe um gênero de documentação técnica que praticamente desapareceu: a lista de defeitos conhecidos. Notas de versão de software antigo tinham isso; catálogo de modelo de IA, quase nunca. O que se publica hoje é benchmark favorável e exemplo bem escolhido.

A TypeSafe mantém, para o jev-1.13, uma página chamada jaggedness — algo como “irregularidade” — com nove modos de falha conhecidos, cada um com o que fazer no lugar. A página declara ter sido revisada em 17 de setembro de 2026 e diz, em uma frase, que muitos desses itens devem ser corrigidos em versões posteriores.

Vale comentar o que isso significa, além do conteúdo em si. A tradução item a item, com o remédio de cada um, está em limites do Jev.

O que a lista diz, em linguagem de quem integra

Os nove itens se separam em três grupos, e a separação é mais útil que a ordem original.

Coisas que o produto não se propõe a fazer. Geração de texto, matemática e contagem, comparação de datas. Não são bugs: são a fronteira da categoria. O modelo devolve decisão tipada; quem soma, conta e compara datas é o seu código. O texto oficial é direto — “Jev não é uma calculadora” — e recomenda extrair as partes de uma data com perguntas fechadas e montar a data no código.

Coisas que dependem de como você escreve. Leitura literal, indireção, instruções e critérios contraditórios. Aqui a falha é reparável, e o remédio é sempre o mesmo: escrever a condição exata, reduzir saltos de raciocínio, apontar as partes do state pelo nome e alinhar a instrução com os critérios. A frase mais útil da página inteira está neste grupo: quando você olha uma resposta errada e se pega explicando o que realmente queria dizer, essa explicação é a metade que faltava na instrução.

Coisas que exigem defesa na arquitetura. State grande com detalhe irrelevante, conteúdo adversarial e invariantes estruturais. O primeiro tem nome próprio, context rot, e página nossa em context rot. O segundo é o aviso de que o state não é tratado como hostil por padrão — o que importa muito em moderação e em caixa de entrada pública. O terceiro é o mais sutil, e merece parágrafo.

O item que mais gente vai tropeçar

O oitavo modo de falha chama-se “invariantes estruturais de senso comum”, e a documentação o ilustra com números.

A mesma pergunta — “o cliente está pedindo reembolso?” — feita como Noul e como Choice de sim e não, sobre o mesmo ticket, devolveu noul 0,22 de um lado e, do outro, 0,01 para sim, 0,99 para não e confiança 0,97. E dois Nouls opostos sobre outro ticket somaram 1,19, não 1.

A explicação oficial é conceitual: um Choice é relativo — resolve qual opção vence — e cada Noul é absoluto, podendo ser baixo para todas. A consequência prática é que um limiar calibrado em uma primitiva não se transporta para a outra. Esse é o tipo de armadilha que custa uma investigação inteira quando ninguém avisa, e está detalhada em Noul ou Choice de sim e não.

Por que publicar isso é uma decisão de produto

Há um cálculo por trás. Um fornecedor que promete tudo vende mais rápido e perde o cliente na terceira semana, quando o produto encontra o caso que ele não faz. Um fornecedor que publica a fronteira filtra a venda e economiza o tempo de quem fica.

Para o time que integra, a lista funciona como checklist de viabilidade antes do código. É possível ler os nove itens em dez minutos e saber, antes de pedir uma chave, se o seu caso está dentro ou fora. Foi com base nela que escrevemos quando não usar o Jev, que é a página que mais recomendamos a quem está avaliando.

Há também um efeito menos óbvio. Uma lista de falhas versionada — ela é explicitamente sobre o jev-1.13, não sobre “o Jev” — cria uma expectativa verificável para a próxima versão. Quando sair a 1.14, dá para comparar o que saiu da lista. Isso é mais informação do que qualquer número de benchmark.

O que ela não resolve

Seria injusto tratar a lista como se fosse um contrato de qualidade.

Ela não quantifica. Diz que a contagem é pouco confiável e que o erro cresce com o tamanho; não diz quanto. Diz que a acurácia cai com state grande; não diz a partir de quando.

Ela não cobre idioma. Nenhum dos nove itens fala de português, e a declaração oficial sobre idioma está em outra página, sem números. Foi essa lacuna que gerou a nossa seção de português.

Ela não substitui teste. A própria página termina convidando quem encontrar um modo de falha novo a reportar. Ou seja: é uma lista viva e incompleta, e assume isso.

O que fazer com ela

Três usos práticos, em ordem.

Antes de integrar, leia os nove itens e classifique o seu caso: dentro, fora, ou dentro com defesa. Isso economiza a primeira semana.

Ao desenhar as perguntas, use o grupo do meio como revisão de redação. A maioria das respostas ruins que vimos cai em leitura literal ou em critério contraditório, e as duas se consertam reescrevendo texto.

Ao investigar um erro, comece pela lista antes de culpar o modelo. Contagem errada, data comparada, state inflado e instrução ambígua respondem por boa parte dos casos, e todos têm remédio conhecido.

O índice do blog está em blog, e a tradução completa dos nove itens em limites do Jev.