Bloco gerado versionado custa mais do que entrega: 57 de 66 conflitos em um dia

[rubenmarcus]

O número

Em 21–22/08 resolvi conflito em sete PRs (#400, #375, #372, #399, #413, #407, #408). Contagem dos arquivos em conflito:

	arquivos
gerados (README, STATUS, ARCH.generated, docs/, tools/eval/ARCH.md, *_check.json)	57
código de verdade	9

86% do trabalho de resolução de conflito deste repositório é mecânico.

Por que se repete

Duas causas somadas, e as duas são estruturais:

1. Todo release reescreve os contadores. Foram 9 chore(release) em 20 horas. Cada um reescreve README, STATUS, ARCH.generated e docs/, e reabre conflito em todo PR aberto ao mesmo tempo. Enquanto eu resolvia quatro PRs, o alpha.173 entrou e reabriu os quatro.

2. Dois PRs que acrescentam régua conflitam entre si por construção. O bloco gerado carrega contagens (N scripts em tools/eval/, N linhas de jogo, N citações). Qualquer PR que acrescente uma régua muda o contador; dois PRs assim divergem do ancestral comum no mesmo lugar. Isso não se resolve mergeando — depois de resolver e empurrar, o conflito volta na tentativa seguinte, porque o número da branch reflete a branch e o da main reflete a main. Só o squash final resolve.

Medido agora no #408: mergeei a main, regenerei, empurrei — e ele voltou a conflitar nos mesmos 8 arquivos.

O que já foi feito

O #414 (fase 5 da avaliação de bots) faz o autofix trazer a base e resolver conflito de arquivo gerado sozinho, abortando quando sobra código. Cobre os 86%. Está aberto, empilhado no #408.

O que esta issue propõe discutir

O #414 automatiza o custo, mas não o elimina. Vale decidir se o bloco gerado precisa continuar versionado:

1. Gerar no build em vez de commitar, e o portão passa a conferir que o gerador roda — o conflito deixa de existir;
2. Tirar as contagens voláteis dos blocos versionados (o número de scripts muda toda semana; a descrição da zona, não);
3. Manter como está e aceitar o custo, agora que o feat(ci): autofix resolve conflito de arquivo gerado e para no de código #414 o paga automaticamente.

Dado adicional, da outra sessão: sete re-derivações de bloco gerado em cinco PRs numa sessão, duas delas só por ter rodado npm run docs antes do git add.

(Número levantado durante a avaliação de bots e pipeline; a sugestão de abrir veio da sessão que trabalhou em VRAM/meshopt.)

🤖 Generated with Claude Code