teqo-backup/docs/changelog/2026-08-19-ops68.md
Francisco Solla 3ca2cbd438 docs(OPS68): reescreve docs canônicos da era GitHub/Vercel para Forgejo/homeserver
Parte 2 do OPS50 (fechamento): AGENT-OPS, README, roadmap (ponteiro),
AGENTS.md (refs Neon/job gate), rule agent-pr-workflow e 8 skills de
operação sem comandos gh (API/MCP + safety net) nem secrets Vercel —
fonte canônica única: git.solla.dev/fsolla/teqo.
2026-08-19 13:33:05 +00:00

2.6 KiB
Raw Permalink Blame History

Recently resolved (2026-08-19): OPS68 — fechamento da parte 2 do OPS50: reescrita dos docs canônicos operacionais que ainda descreviam a era GitHub/Vercel. 12 arquivos, 78+/82−, edições linha-a-linha: docs/AGENT-OPS.md (norte "só Forgejo + Cursor"; fonte canônica = Issues do Forgejo; fluxo do agente e Contrato de PR sem gh — criação via API/MCP + merge pelo safety net agent-pr-ready-automerge.yml, o único que espera o rollup CI (PR) / checks; "Só humano" = envs de ~/stack/teqo-1313.env + branch protection + runbook; tabela de secrets sem POOL_GITHUB_TOKEN (legado — o script o ignora) e com nota de pool dormente; linha archive-cursor-agent.yml na tabela CI; "smoke Neon stage" → sem smoke stage), README.md (cheatsheet de 5 linhas reescrito: claim → push → PR via API/MCP → safety net mergea → ci.yml em janela de 30 min + deploy homeserver; Neon → homeserver Postgres; PROD_DATABASE_URL = DATABASE_URL de ~/stack/teqo-1313.env; migrações no deploy via teqo-1313-migrate; "GitHub mirror" → Forgejo Actions; papéis coordinator/advisor/leader/candidate; "electoral nuclei" → municípios; Issues → link Forgejo), docs/roadmap.md (só o ponteiro da fonte canônica — o stub continua congelado), AGENTS.md (refs Neon → homeserver teqo_1313; job do gate check→gate, key real do YAML; "Vercel preview" → host genérico na rationale do WebAuthn), .agents/rules/agent-pr-workflow.mdc (comandos gh pr create/merge/checks morrem — gh não existe em nenhuma máquina (OPS50); regra descreve API/MCP + safety net; "There is no deploy from CI" corrigido — OPS53 colocou o deploy no ci.yml), e as skills work-issue (SKILL + execution-pipeline), plan-issue (frontmatter, gate "nada no Forgejo", dedup via pnpm issue all), project-status, capture-review-debts, engineering-audit (gh issue list → pnpm issue all/API; issue-done-on-stage-merge.yml→on-main; merge stage→main), worktree-next-issue ("resto do Forgejo") e agent-pool (descrição Forgejo Actions; workflow marcado removido OPS65; estado em pool-state.json, não mais variables). Mantido como registro histórico (exclusões explícitas do plano): menções de Vercel/Neon/POOL_GITHUB que documentam remoções (AGENTS.md L15/L105/L167, AGENT-OPS L94/L98, "Vercel/Git-integration deploy gate" como guardrail no rule). Fonte canônica única: git.solla.dev/fsolla/teqo. Sem migration/access/Consent/UI. Gate: grep de saída zero nas classes gh pr/gh issue/github.com/fsolla/GitHub Issues/GitHub mirror/POOL_GITHUB/Neon-em-uso; docs-only → CI roda os docs-guards.