mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-17 21:03:06 +00:00
146 lines
6.9 KiB
Markdown
146 lines
6.9 KiB
Markdown
---
|
||
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`
|