teqo-backup/docs/changelog/2026-09-12-ops102.md

1.3 KiB

OPS102 — Deploy manual roda até o fim mesmo com main à frente (2026-09-12): o guard de stale run nasceu na era automática (OPS53): scripts/deploy-homeserver.sh comparava git ls-remote … refs/heads/main com o SHA do job (pré e pós-flock) e abortava com fatal "stale run". Desde a OPS71 o publish é um workflow_dispatch deliberado — se alguém mergeasse em main durante os ~50 min do verify, o job deploy morria mesmo com o dispatch legítimo. O fix remove os dois blocos (o flock e o guard "already deployed" ficam; o único verde sem build segue sendo o que prova que o container já roda o SHA) e realinha o registro vivo: comentários do script e do deploy.yml, fluxo e tabela "Falhas conhecidas" do runbook (docs/ops/teqo-1313-deploy.md — a linha do antigo "stale run" vira o risco aceito de dispatch fora de ordem, com gatilho de revisita) e docs/AGENT-OPS.md. tests/unit/deployScript.unit.spec.ts passa a pinar o contrato novo: ausência de git ls-remote/refs/heads/main/stale run (pins de ausência com RED comprovado contra o script anterior), único exit 0 = "already deployed" (anti-falso-verde #953) e flock preservado. Sem migration, sem UI, sem access/Consent. Verificação: pnpm gate:fast verde; e2e não afetado (diff sem superfície runtime). Aceite final humano pós-merge: dispatch manual do deploy.yml.