teqo/docs/changelog/2026-08-18-ops61.md
Francisco Solla 4f7de670f5
Some checks are pending
CI (PR) / scope (pull_request) Successful in 35s
CI (PR) / lint (pull_request) Successful in 45s
CI (PR) / docs-guards (pull_request) Successful in 8s
CI (PR) / plans-only-closes (pull_request) Successful in 7s
CI (PR) / format (pull_request) Successful in 54s
CI (PR) / typecheck (pull_request) Successful in 31s
CI (PR) / knip (pull_request) Successful in 32s
CI (PR) / cycles (pull_request) Successful in 32s
CI (PR) / unit (pull_request) Successful in 55s
CI (PR) / int (pull_request) Successful in 2m46s
CI (PR) / build (pull_request) Has been skipped
CI (PR) / e2e (1) (pull_request) Has been skipped
CI (PR) / e2e (2) (pull_request) Has been skipped
CI (PR) / checks (pull_request) Successful in 1s
CI / deploy homeserver (teqo-1313) (push) Blocked by required conditions
CI / static (push) Waiting to run
CI / int (push) Waiting to run
CI / build (push) Waiting to run
CI / e2e (1) (push) Waiting to run
CI / e2e (2) (push) Waiting to run
CI / checks (push) Blocked by required conditions
PR Ready + auto-merge / ready-automerge (pull_request) Successful in 21m31s
Main merge flips claimed issues to done + in-prod / issue-done (pull_request) Successful in 12s
Promote plan-issue Related on main merge / plan-issue-ready (pull_request) Has been skipped
Agent pool supervisor / tick (pull_request) Successful in 28s
fix(OPS61): merge do safety net com FORGEJO_API_TOKEN — 409 PushRejected do hook pre-receive
O merge POST faz um push para main; o hook pre-receive do Forgejo rejeita o
push quando o usuário do token não tem write no repo — o GITHUB_TOKEN nativo
age como o usuário sistema do Actions. Por isso nenhum auto-merge funcionou
(o CLI morria no 409; runs 'success' eram leituras de PR já mergeada
manualmente). O workflow do safety net agora injeta o mesmo PAT dos pós-merge.
2026-08-18 18:07:55 -03:00

3.7 KiB

Recently resolved (2026-08-18): OPS61 — contratos de merge/flip do Forgejo consertados. (S1) Os workflows pós-merge (issue-done-on-main-merge.yml, plan-issue-ready-on-main-merge.yml) rodavam com o GITHUB_TOKEN nativo, que 403 em escrita de Issues — o flip Closes #N → done+in-prod (PRs #42/#48) quebrava em silêncio (o script engolia o 403 e o job terminava success; flip manual necessário). Agora injetam FORGEJO_API_TOKEN (o PAT que o pool já usa para o mesmo tipo de escrita) via env: no job, e o forgejo-issue-transition.mjs sai exit 1 se qualquer flip falhar — o job vermelha em vez de mentir. Fork guard nos dois workflows (head.repo.full_name == github.repository, a mesma classe do agent-pr-ready-automerge): PR de fork mergeada faria checkout do script do fork rodando com o PAT do repo (RCE). (S3) A branch protection de main não existia no servidor (0 regras no GET /branch_protections — o pnpm configure:branch-protection era passo humano pendente do OPS50 e nunca rodou; as docs diziam "aplicado" e mentiam), e o valor checks do script nunca casaria os contextos reais do Forgejo (casamento por glob contra CI (PR) / checks (pull_request) — o sufixo (evento) faz parte do contexto; literal checks = todo merge bloqueado). Script corrigido: contexto CI (PR) / checks*, idempotente (GET → POST/PATCH/no-op, verifica após aplicar, dry-run honesto) com decisão pura em scripts/lib/branch-protection.mjs + spec nova. (2b — achado ao vivo na própria entrega, PR #67) O safety net tinha dois bloqueios independentes. (1) O gate antigo do waitForChecks (pending.length === 0) era insatisfazível: o Forgejo posta o status do próprio job do safety net como pending durante o run inteiro. (2) O merge POST faz um push do branch rebaseado para main e o hook pre-receive do Forgejo rejeita esse push quando o usuário do token não tem write no repo — o GITHUB_TOKEN nativo age como o usuário sistema do Actions (o mesmo que 403 em Issues), então o merge do CLI morria com 409 "User permission denied for writing" (confirmado na fonte 9.0.3: o hook cai no AssertCanWriteCode antes do caminho de merge). Resultado: o CLI nunca auto-mergeou nenhuma PR — todo merge Forgejo até aqui foi manual (merged_by do dono), inclusive o da PR #52 com o CI vermelho (a narrativa da "raça do snapshot" da intenção estava errada: o merge vermelho foi manual; e runs que "exitaram 0" eram leituras de PR já mergeada). Gate novo: espera o rollup CI (PR) / checks presente+verde (único contexto que só existe quando a cascata inteira do ci-pr assentou) e ignora o próprio contexto do safety net; mergeable === false só conta como conflito após a cascata assentar; timeouts sobem (CLI 30→45 min, workflow 40→55 min); e o workflow do safety net agora injeta FORGEJO_API_TOKEN (mesmo PAT dos pós-merge) — o merge com o PAT (admin) passa no hook. A regra no servidor é o gate real para todo mundo: o merge POST é bloqueado com 405 enquanto o contexto exigido não estiver verde — inclusive merges manuais via API (a PR #52 não teria entrado vermelha). Validação ao vivo na própria entrega: a regra foi criada e verificada no servidor (re-run = no-op), e a PR #67 (Closes #53) mergeou pelo novo gate do rollup com a regra aplicada; o issue-done flipou a #53 para done+in-prod com o PAT. Sem migration/access/Consent/UI. Testes: forgejoApi.unit.spec.ts (rollup não-posto continua poll, rollup failure lança, próprio status do safety net não bloqueia, mergeable pré-settle — fixtures dos waitForChecks/autoMerge existentes atualizados para o contexto real), branchProtection.unit.spec.ts nova (create/update/noop, glob casa o contexto observado).