teqo-backup/docs/changelog/2026-09-17-ops126.md
Francisco Solla 1ebae91428 fix(OPS126): auto-unblock honra o proxy do homeserver e resolve o opencode fora do PATH
Duas causas independentes mantinham o agente de desbloqueio (OPS106) sem
entregar:

1. `fetch failed` no launcher: o homeserver só alcança o GitHub pelo proxy
   CONNECT local (github-tunnel + http-proxy-socks) e o `fetch` global do Node
   ignora HTTP(S)_PROXY sem `NODE_USE_ENV_PROXY` (Node >= 24). O launcher
   morria lendo os jobs do run (run 35171293357) e nenhum token era criado.
   `scripts/auto-unblock.sh` passa a exportar `NODE_USE_ENV_PROXY=1` quando há
   proxy no env; o agente destacado herda.

2. exit 127 do agente: o serviço do runner não carrega o profile interativo,
   então `~/.opencode/bin` fica fora do PATH e o `timeout ... opencode` morria
   com *No such file or directory* (log unblock-35101121310.log), deixando o
   token `blocked` sem PR. Novo `resolveOpenCodeBinary` (OPENCODE_BIN → argv0
   com path → `$HOME/.opencode/bin` → PATH) usado pelo wrapper, pelo `--check`
   e por um gate fail-closed no launcher (token blocked, sem provisionar
   worktree).

Runbook + changelog OPS126; unit tests do resolver. Token órfão #1089 fechado
no replay. Flakiness de e2e full segue na #1124.
2026-09-17 02:07:18 -03:00

2.2 KiB

OPS126 — auto-unblock volta a despachar de verdade no homeserver: fetch honra o proxy e o opencode é resolvido fora do PATH (2026-09-17): duas causas independentes mantinham o agente de desbloqueio (OPS106) sem entregar nada. (1) fetch failed no launcher: o homeserver só alcança o GitHub pelo proxy CONNECT local (github-tunnel + http-proxy-socks, ~/actions-runner/.env com HTTPS_PROXY/HTTP_PROXY=127.0.0.1:1081); o fetch global do Node ignora HTTP(S)_PROXY a menos que NODE_USE_ENV_PROXY seja definido antes do processo subir (Node ≥24), então a leitura dos jobs do run caía em conexão direta e falhava de forma intermitente (run 35171293357: 4/4 fetch failed e nenhum token criado). scripts/auto-unblock.sh passa a exportar NODE_USE_ENV_PROXY=1 quando há proxy configurado — o agente destacado herda. (2) exit 127 do agente: o serviço do runner não carrega o profile interativo, então ~/.opencode/bin não está no PATH e o timeout ... opencode morria com No such file or directory (log unblock-35101121310.log), deixando o token blocked sem PR. Novo helper puro resolveOpenCodeBinary (OPENCODE_BIN → argv0 com path → $HOME/.opencode/bin/<argv0> → PATH) é usado pelo wrapper e pelo --check (que agora acusa o binário ausente em vez de passar), e o launcher falha fechado antes de provisionar o worktree quando o binário não existe. Sem schema, sem UI, sem migration. Verificação: pnpm vitest run tests/unit/autoUnblock.unit.spec.ts tests/unit/autoUnblockWorkflow.unit.spec.ts, bash -n scripts/auto-unblock.sh; smoke no homeserver (NODE_USE_ENV_PROXY=1 node -e fetch → 200 estável). Bootstrap OPS106 §1 concluído no homeserver em 2026-09-17: opencode 1.18.31 instalado em ~/.opencode/bin (mesmo binário da workstation, via --binary) e ~/.local/share/opencode/auth.json (chmod 600) replicado — opencode run --model deepseek/deepseek-flash responde pelo proxy. Antes disso, qualquer token nascia blocked. Token auto-unblock #1089 (órfão blocked de run superado) fechado no replay. Runs vermelhos de referência: 35170301963, 35166706444 (flakiness de e2e segue na Issue #1124).