Causa raiz (medida com o binário 1.58.2, config real): commander parseia posicionais e -g/--list funcionam; o que arrastava a suíte era o closure de dependências do dev mode (setup<-campaign<-frontend<-admin): filtrar um spec do frontend puxava campaign(160)+setup(2). run-e2e-affected.mjs agora gera test:e2e <passthrough verbatim> --no-deps -- <paths> via helpers puros em scripts/lib/playwright-e2e-args.mjs (unit-pinned); passthrough corrigido (pnpm consome o -- e o path era descartado); run-e2e-affected.mjs entrou em HIGH_RISK_EXACT. Docs: receitas de filtro no playwright.config.ts, AGENTS.md, changelog.
9.4 KiB
Impl: S6-FOLLOWUP — CLI Playwright ignora filtros; test:e2e:affected roda a suíte completa
Status: em execução Atualizado em: 2026-08-18 Issue: #58 (S6-FOLLOWUP, depends S6) Intenção: docs/plans/s6-followup-playwright-filtros-cli-ignorados.md Appetite restante: ~0,5 dia (herdado)
Leitura da intenção
- Outcome:
pnpm test:e2e:affectedroda SÓ os specs afetados (contagem verificada); comandos de iteração locais documentados e funcionando. - O que NÃO negociar: não mudar specs, CI (
--shardok),gate:cinem trocar de runner. - O que reavaliar: a hipótese de mecanismo do plano de intenção está errada — evidência empírica nova desta sessão (mesmo binário 1.58.2, config real e config mínima):
| Invocação (config REAL do repo) | Resultado medido |
|---|---|
--list admin / --list frontend / --list campaign |
180 / 177 / 162 (frontend 15 + closure campaign 160 + setup 2; admin 180 = suíte toda) |
--list campaignHomeActions |
20 (arquivo 18 + setup 2) |
--list pwa |
3 (campaign-pwa 1 + setup 2) |
--list seedParity |
1 (arquivo, sem setup) |
--list zzz_nonexistente |
0 ("No tests found" — filtro aplicado) |
--list frontend --no-deps (dev) |
15 (só o arquivo!) |
CI=1 --list frontend (prod mode) |
15 (só o arquivo!) |
- Causa raiz (não é o parse de args): o commander entrega os posicionais corretamente (
POSITIONALS: ['admin']— probe) e o matcher de arquivo funciona (probe viaRegExp.prototype.test:/frontend/gicasa sófrontend.e2e.spec.ts). O que arrasta a suíte é o closure de dependências entre projects no dev mode (setup ← campaign ← frontend ← adminemplaywright.config.ts):collectProjectsAndTestFilesfiltra os arquivos por project, masbuildProjectsClosurerepõe TODOS os arquivos de cada project-dependência. Filtrar um spec dofrontendpuxacampaign(160) +setup(2) — 177 no total com o próprio arquivo (15); filtraradminpuxa a suíte inteira. Em prod mode (CI=1/E2E_PROD=1) os projects não têmdependencies→ filtro funciona (é por isso que o CI selecionado funciona). -ge--listNÃO estão quebrados (evidência do plano desatualizada):-g alphafiltra por título (verificado em config mínima);--listrespeita posicionais e-g(verificado:zzz→ 0). A "quebra" era o closure arrastando o resto. Sem pin/upgrade upstream necessário.
Abordagem recomendada
flowchart LR
A[run-e2e-affected.mjs] --> B[buildPlaywrightE2eArgs<br/>scripts/lib/playwright-e2e-args.mjs]
B --> C[test:e2e --no-deps<br/>flags antes do --<br/>-- paths posicionais]
C --> D[playwright 1.58.2 dev mode<br/>closure desligado]
D --> E[só os specs afetados rodam]
Opções consideradas: A (inserir -- antes dos paths — a correção do plano) | B (--no-deps + -- + correção do passthrough; builder puro em scripts/lib/ com unit test) | C (forçar prod mode CI=1 no local) | D (remover dependencies do config dev)
Recomendação: B — ataca a causa real (closure) com o mecanismo oficial do playwright (--no-deps, exatamente o workaround que o plano já apontava), mantém a cadeia de prewarm do dev mode para a suíte completa, e segue o padrão do repo (lógica pura derivada em scripts/lib/ unit-testada, como test-affected-core.mjs).
Rejeitadas:
- A — o
--não muda nada no config real: commander já parseia posicionais sem--; a evidência do plano (11 testes com--) foi medida em config mínima. Só--não corrige o sintoma de 173 testes. - C —
CI=1mudawebServerparapnpm start(exige build),forbidOnly,retriese o budget do servidor; é uma semântica de ambiente diferente, não um filtro. - D — remove a garantia de ordenação de cold-compile do dev mode (comentário OPS34 no config); afeta a suíte completa dev, não só seleção.
Componentes / mudanças
buildPlaywrightE2eArgs+parsePassthroughArgs(scripts/lib/playwright-e2e-args.mjs, novo): puros e síncronos.parsePassthroughArgs(argv)remove só um--líder (pnpm já consumiu o dele; invocação direta pode deixar um) e repassa o resto verbatim — valores de flag como-g gradenão são reclassificados.buildPlaywrightE2eArgs({ scopeSpecPaths, passthroughArgs })→['test:e2e', ...passthroughArgs]+--no-depsquando o run é filtrado (paths de escopo, positional no passthrough ou flag de filtro--project/-g/--grep/--grep-invert) +-- <scopeSpecPaths>quando há paths de escopo.--no-depscondicional: suíte completa mantém a cadeia OPS34.run-e2e-affected.mjs: (1) corrige o parse do passthrough — hojepnpm test:e2e:affected -- tests/x.spec.tsperde o path (pnpm consome o--, argv fica sem--epassthroughIndex === -1→ args descartados); novo contrato viaparsePassthroughArgs. (2) usa o builder (remove o loop manual de paths).tests/unit/playwrightE2eArgs.unit.spec.ts(novo): pina o parse (invocação nua, pnpm--,--direto, flags+valores) e a forma dos args —--no-depssó em runs filtrados (path de escopo, positional ou flag de filtro), flags de runner (--shard,--reporter) preservam a cadeia, sem duplicar--no-depsexplícito.test-affected-core.mjs:scripts/run-e2e-affected.mjsentra emHIGH_RISK_EXACT(+ invariant emciSkipInvariants.unit.spec.ts) — é o espelho local do job e2e; um PR só de runner hoje escaparia do e2e (modenone).- Migration: sem migration (nenhum schema/collection).
- Access / Consent: nenhum.
- UI: nenhuma.
Dados → forma
N/A (sem dados novos).
Fases verificáveis
- Tracer (builder + wiring) — criar
scripts/lib/playwright-e2e-args.mjs, unit spec, ligar emrun-e2e-affected.mjs. Verificação: unit green; forma final confirmada com--listdireto no binário do repo (já medida:--no-deps→ 15/18). - Docs — comentário em
playwright.config.ts(mecanismo do closure no dev mode + receitas de filtro: path posicional exige--no-deps;--project=<família> --no-deps;-g/--listfuncionam, mas o closure arrasta dependências); header dorun-e2e-affected.mjs(contrato de invocação corrigido); bullet curto emAGENTS.md(seção OPS59/test:e2e:affected);docs/changelog/2026-08-18-s6-followup.md+pnpm changelog:build. - Gates —
pnpm gate:fast(lint, typecheck, test:unit); CI do PR roda e2e completo (o diff tocaplaywright.config.tsescripts/run-e2e-affected.mjs— ambos emHIGH_RISK_EXACT; o runner entrou no set nesta entrega).
Rabbit holes / Não escopo (engenharia)
- Não investigar o hang do
pnpm test:e2eneste worktree (invocação via pnpm congela após a fase de install do pnpm; o binário direto com a mesmaNODE_OPTIONSfunciona e é o veículo de verificação local — pré-existente, ambiente, não o bug). Verificação de contagem local via binário direto + unit; CI é o verifier. - Não reescrever o parse do commander do playwright, não fazer pin/upgrade de versão (
-g/--listfuncionam; evidenciado). - Não tocar
.forgejo/workflows/*nemgate-ci.mjs. - Não "consertar" a evidência do plano de intenção retroativamente (a tabela do plano fica como está — docs histórica; o impl plan registra a divergência).
Riscos e mitigação
- Dev mode sem prewarm do setup em runs selecionados (o
--no-depspula o spec de setup): cold-compile mais lento do primeiro spec em máquina carregada. Mitigação: prod mode (CI) já roda sem prewarm e é o caminho gateado; budget de 60s/240s do webServer permanece. - Flag com valor separado por espaço no passthrough (
-g grade): resolvido na implementação — passthrough verbatim (sem reclassificação flag/posicional);-g gradechega intacto ao playwright. Só sobra o caso do usuário passar um--interior explícito junto com paths de escopo gerados (o--no-deps/--gerados caem depois do--do usuário e viram padrão de arquivo → "No tests found", falha ruidosa; pnpm nunca produz isso). - Regression na suíte completa dev: o
--no-depssó entra nos args gerados pelo builder;pnpm test:e2epuro (sem args) não muda — a cadeia de deps dev permanece intacta.
Aceite de engenharia
- Aceite de produto da intenção ainda coberto:
run-e2e-affectedroda só os specs afetados (unit +--listdo binário com a forma final); comandos de iteração documentados;--project=<família> --no-depsdocumentado como receita manual. - Invariantes AGENTS/engineering-standards: script puro em
scripts/lib/(padrão test-affected-core); sem tocar CI/gate:ci/specs; identificadores em inglês, copy pt-BR. - Testes de domínio previstos: unit do builder (args), nada de access/write path muda.