teqo-backup/docs/plans/ops72-e2e-local-afetado-ci-sem-full.md

146 lines
6.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
id: OPS72
depends: [OPS71]
serializes: ['ci-pr.yml', '.agents/skills/work-issue/']
priority: P1
model: composer-2.5
---
# E2E local apenas para os testes afetados — CI de PR sem e2e full
Status: rascunho
Atualizado em: 2026-08-19
Issue: #98
Priority: P1
Model: composer-2.5
Impeccable: A — N/A (sem UI)
Rascunho UI: N/A — sem UI
Appetite: ~0,5–1 dia eng; um outcome verificável (skill work-issue exige e2e afetado local; CI de PR não roda e2e full)
Responsável: —
## Intenção
O e2e é a etapa mais cara do CI de PR (build `.next-e2e` + playwright +
suíte inteira). Com o CI voltando para o GitHub Actions (OPS71), o custo por
PR deixa de ser a CPU da workstation — mas o tempo de veredito por PR continua
importando: e2e full é a maior fatia do job único `checks` (OPS62), e a
política de hoje (OPS59: "e2e roda UMA vez, no CI; local opcional") significa
que cada PR paga a suíte e2e inteira, inclusive specs em superfícies que o PR
não tocou.
Queremos: **e2e no CI de PR apenas para os testes afetados** (novos testes
criados + specs da mesma superfície trabalhada — a mecânica `e2e selected` já
existe via `ci-scope.mjs`/manifest do OPS59), e o **restante da cobertura e2e
roda localmente** — também apenas nos afetados — como passo do fluxo do agente
antes do PR (atualizar a skill `work-issue` para exigir isso). O e2e **full**
fica para o **deploy manual** (workflow_dispatch do OPS71) e para o verificador
de main — como rede de segurança antes de publicar — sem nunca rodar full por
PR.
**Decisão do gate (2026-08-19):** o CI de PR **continua rodando o e2e das
áreas afetadas** (modo `selected`) — confirmado pelo usuário; o e2e local
afetado é o passo da skill; o full fica no deploy/verificador de main.
## Persona e fluxo
- **Persona / contexto:** o agente (humano no worktree ou worker do pool) que
implementa uma Issue e abre o PR; o dono da máquina que não quer o CI
ocupando o runner por 40+ min por PR.
- **Job principal:** saber que os testes novos/afetados do seu PR passam,
com custo mínimo de CI e feedback local rápido.
- **Fluxo desejado:**
1. Agente implementa; roda os gates locais de sempre (`pnpm gate:push`).
2. **Novo passo obrigatório:** roda `pnpm test:e2e:affected` (ou o modo
selecionado equivalente) — cobre os novos testes criados + specs da
mesma superfície trabalhada.
3. CI de PR roda a cascata **sem e2e full**: apenas o conjunto afetado
(modo `selected` — já suportado pelo classifier; decisão do gate).
4. Deploy manual (OPS71) e verificador de main rodam e2e **full** antes de
publicar — a rede de segurança final inegociável.
- **Anti-goals de produto:** NÃO remover o e2e do deploy/verificador de main;
NÃO deixar o agente pular o e2e local sem justificativa; NÃO reintroduzir
"e2e é só no CI" (OPS59 era isso e custa caro por PR).
## Objetivo e aceite
- Skill `work-issue` (e `execution-pipeline.md`, `agent-work-issue` onde
aplicável) passam a exigir, antes do `pnpm push`/PR: **e2e local afetado**
(`pnpm test:e2e:affected`), com o critério "novos testes + mesma superfície"
documentado.
- CI de PR: e2e roda em modo `selected` (manifest afetado) — nunca `full`. O
classificador de escopo (`ci-scope.mjs`) é a fonte da decisão.
- Deploy manual e verificador de main: e2e **full** preservado (rede de
segurança pré-deploy/pré-publicação).
- A skill `work-issue` documenta a limitação da #72 (e2e local com `--no-deps`
- projetos paralelos colide no `seedTestUser` — usar `--workers=1` ou a
cadeia padrão de projetos).
- Gate local (`pnpm gate:push`) intocado — e2e continua fora do pre-push; o
e2e local é passo **explícito do fluxo da skill**, não do hook.
## Dados (intenção)
- **Vou apresentar dados?** Não.
- **Decisões desbloqueadas:** o agente decide o conjunto afetado com base no
diff da superfície — critério documentado na skill, não métrica nova.
## Direção no codebase (hipótese)
- **Áreas prováveis:**
- `.agents/skills/work-issue/SKILL.md` e `execution-pipeline.md` — novo
passo "e2e local afetado" antes do push; delta para `agent-work-issue`
quando fizer sentido.
- `.forgejo/workflows/ci-pr.yml` → (OPS71) `.github/workflows/ci-pr.yml` —
etapa e2e apenas `selected`; remover `full` do modo PR.
- `.github/workflows/ci.yml` (verificador de main) e `deploy.yml` (dispatch
manual) — e2e `full` preservado neles.
- `docs/AGENT-OPS.md`, `AGENTS.md` (política "e2e = CI" do OPS59 vira
"e2e afetado = local + CI selected; full = deploy/verificador de main").
- **Precedente a olhar:** `docs/plans/ops59-gate-local-sem-e2e.md` (política
atual), `ci-scope.mjs` (modos `full/selected/none`), `e2e-affected-manifest.mjs`,
`docs/plans/ops62-ci-fail-fast-forgejo.md`.
- **Risco de acoplamento:** toca a mesma superfície do OPS71 (workflows + a
skill work-issue é citada pelo fluxo de PR) — por isso `depends: [OPS71]` e
serialização explícita (OPS71 serializa `ci-pr.yml` e `work-issue`).
## Dependências
- OPS71 (CI no GitHub) — este item edita o `ci-pr.yml` novo e a skill que o
OPS71 já aponta para o GitHub; `depends: [OPS71]`.
- #72 (S3-FOLLOWUP) — citada como limitação documentada; não é duplicada nem
absorvida (fica na fila).
## Fora de escopo
- Mudar a mecânica do classifier/manifest (`ci-scope.mjs`,
`e2e-affected-manifest.mjs`) — funciona; só muda onde/em que modo roda.
- Implementar o fix da #72.
- Remover o e2e do deploy manual / verificador de main.
## Rabbit holes de produto
- **"Se é afetado, nem precisa do CI e2e".** O CI selected é a rede de
segurança quando o agente erra o critério (esqueceu um spec da mesma
superfície) — e é o que o usuário pediu para manter. **Corte:** CI selected
permanece; local é complementar, não substituto.
- **"Full só no deploy cria gap de regressão".** Aceito e deliberado: o full
gateia a publicação (deploy manual) e o verificador de main; PRs afetados
cobrem a superfície do diff. **Corte:** não reintroduzir full por PR.
## Questões em aberto (produto)
- **CI de PR: e2e selected ou nenhum e2e?** **Decidido no gate (2026-08-19):**
e2e **selected** (manifest afetado) no CI de PR — o usuário confirmou
("O CI PR deve continuar fazendo o e2e das áreas afetadas").
- **O e2e local afetado vale também para o pool (`agent-work-issue`)?**
**Opções:** A) sim, mesmo passo obrigatório; B) pool roda só o CI selected
(workers Cloud sem worktree local com browsers instalados).
**Recomendação:** A quando o worktree local tiver browser; senão B com
justificativa registrada. _(assumido — validar)_
## Referências
- GitHub Issue: #98 (OPS72)
- Rascunho UI (gate): N/A
- `.agents/skills/work-issue/SKILL.md`, `.agents/skills/work-issue/execution-pipeline.md`,
`scripts/ci-scope.mjs`, `scripts/lib/e2e-affected-manifest.mjs`,
`docs/plans/ops59-gate-local-sem-e2e.md`, `docs/plans/ops62-ci-fail-fast-forgejo.md`