fix(harness): hook que sai cedo deixa de dar EPIPE em quem escreve o payload

[GabrielAderaldo]

Corrige o vermelho que barrou o #1031. Parecia flake de CI; era corrida.

O que aconteceu

O typecheck + format + lint + test do #1031 falhou em post-compact-rules-reminder.test.ts:201:

Error: spawnSync bash EPIPE
  status: 0, signal: null, code: 'EPIPE'

status: 0 é a pista: o hook terminou com sucesso, e ainda assim o execFileSync lançou.

Causa

Quem invoca um hook escreve o payload JSON no stdin dele. O post-compact-rules-reminder.sh tinha o exit 0 da falta do log antes do payload=$(cat) — saía sem consumir o stdin, e o escritor levava EPIPE.

O sintoma é intermitente porque o buffer do pipe (64 KB) absorve a escrita quando o payload é pequeno e o processo sai rápido. Medido:

payload	resultado
~60 B, ~1 KB	5 de 5 OK
~70 KB, ~500 KB	5 de 5 EPIPE

O teste usa ~60 bytes e passava em toda máquina de desenvolvimento. No CI o runner deixou o script sair antes de a escrita completar.

A régua não estava num lugar só

Dos 4 hooks que leem stdin, 3 saíam antes de drenar:

• post-compact-rules-reminder.sh (o que o CI pegou)
• logbook.sh
• log-instructions-loaded.sh

Nos três, a leitura passa para antes de qualquer exit — inclusive antes do cd, que também pode falhar e sair. Varredura depois: nenhum.

O gate, e o erro que ele cometeu primeiro

tests/cleanup/hooks-drain-stdin.test.ts, com payload de 128 KB — acima do buffer, que é o que o torna determinístico. Payload pequeno aprovaria os hooks defeituosos.

⚠️ A primeira versão deste gate passou 4 de 4 com o logbook.sh revertido ao padrão defeituoso. Ela usava um cenário só — CLAUDE_PROJECT_DIR num diretório vazio —, e nele o cd do logbook.sh funciona, então o hook não sai cedo e o defeito não aparece. Media a fronteira errada para dois dos três. O gate roda dois cenários:

cenário	cd	post-compact	logbook · log-instructions
diretório vazio	funciona	EPIPE	ok (não sai cedo)
diretório inexistente	falha	EPIPE	EPIPE

Provado invertido: revertendo o logbook.sh, o gate acusa logbook.sh — projeto inexistente, e só esse caso.

Gate

typecheck ✅ · format:check ✅ · lint ✅ · 11973 testes, fail 0, 20 skipped.

Desbloqueia o #1031.

Assisted-by: Claude-Code:claude-opus-5

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.