teqo-backup/docs/plans/ops91-sweep-pos-cutover-forgejo-textos-vivos.md
Francisco Solla ae79eb507c chore(OPS89): variantes Vercel AI Gateway para a config global do opencode (Closes #836)
- opencode.json: removido provider.vercel inteiro — repo fica $schema + mcp.penpot
- docblock de OPENCODE_PRESET_MODEL e prosa de worktree-next-issue/SKILL.md apontam para ~/.config/opencode/opencode.jsonc
- Forgejo → GitHub na linha reescrita da skill (rastro pós-cutover)
- impl plan + changelog da entrega; débito OPS91 (#841) registrado com plano
2026-08-24 14:05:59 -03:00

52 lines
3 KiB
Markdown

# Sweep pós-cutover OPS76: textos vivos ainda apontam o tracker ao Forgejo
Status: rascunho
Atualizado em: 2026-08-24
Issue: registrada via `agent:register` (OPS91)
Priority: P2
Impeccable: A — N/A sem UI
Rascunho UI: N/A
Appetite: ~0,5 dia, só edição de texto/prosa
Responsável: —
## Intenção
O cutover GitHub (OPS71 + OPS76, 2026-08) tornou o GitHub o host único (Actions + tracker de Issues); o Forgejo ficou congelado e seu tracker inativo. O OPS76 atualizou AGENTS.md/AGENT-OPS e o OPS71 Fase 2 removeu os arquivos Forgejo-era, mas uma varredura de superfícies vivas (feita na sessão OPS89, #836) provou que vários textos vivos ainda instruem leitura/escrita no tracker do Forgejo — um agente novo que siga essas instruções erra o host.
## Evidência (grep da sessão OPS89)
- `.agents/rules/agent-pr-workflow.mdc:8` — "The ISSUE TRACKER stays on the Forgejo — GitHub is only the Actions host" (regra alwaysApply com a realidade invertida).
- `.agents/skills/work-issue/execution-pipeline.md:69,75-76` — diz que o flip pós-merge escreve "no Forgejo" via `FORGEJO_API_TOKEN`; o real (`scripts/issue-transition-on-merge.mjs`, OPS76) escreve na API do GitHub com `GITHUB_TOKEN`.
- `.agents/skills/project-status/SKILL.md:25` — "leia a Issue via API do Forgejo".
- `.agents/skills/engineering-audit/SKILL.md:69` — "leitura da Issue via API do Forgejo/MCP".
- `.agents/skills/plan-issue/SKILL.md:23` — "Nada no Forgejo antes do gate" (shorthand do tracker).
- `docs/roadmap.md:5` — ponteiro canônico de Issues para `git.solla.dev/fsolla/teqo/issues`.
## Objetivo e aceite
- Todos os textos vivos acima apontam para o GitHub (`github.com/fsolla/teqo/issues`) como tracker único.
- Nenhuma instrução viva manda usar `FORGEJO_API_TOKEN`/API do Forgejo para o fluxo atual.
- Menções históricas corretas permanecem intactas (ver Fora de escopo).
## Direção no codebase
Edição de prosa apenas — sem código, sem testes novos. Cada arquivo é dono da própria frase; corrigir in place.
## Fora de escopo / Explicitamente fora
- Rename de pureza `scripts/lib/agent-forgejo.mjs` (+~15 imports com nome "Forgejo") — score 1, churn alto, zero ganho funcional.
- Menções históricas CORRETAS: runbook de rollback (`docs/ops/teqo-1313-deploy.md`), backup mirror OPS76-FOLLOWUP, marcações "legado/removido/congelado" em AGENT-OPS/AGENT-pr-workflow (:60,:85), skill `agent-pool` dormente.
- Docs congelados (`docs/plans/*`, `docs/changelog/*`, `docs/CHANGELOG-AGENTS.md`).
## Rabbit holes
- Não reescrever histórico de decisões (OPS50/OPS64/OPS71 citados como história ficam).
- Não tocar nos scripts que já falam GitHub (`github-api.mjs`, `issue-transition-on-merge.mjs`) — já corretos.
## Já resolvido no simplify/critique (não reabrir)
- `worktree-next-issue/SKILL.md` ("a skill lê o resto do Forgejo" → GitHub) — corrigido na sessão OPS89 (#836), linha tocada pela entrega.
## Riscos
- Baixo: mudanças são prosa; gates de lint/format cobrem os `.md` versionados.