D12 (#641): strict-mode violation (2 triggers idênticos) só em runs
completos sob carga. Estado estável tem 1 match (verificado em browser);
o 2º match é duplicação transitória RSC-pending, mesma classe de cd469857.
Mesmo alvo em campaignActivity:52 (único outro uso do label em e2e).
6.5 KiB
6.5 KiB
Impl: E2E — flake do getByLabel('Atividade relacionada') (strict mode) sob carga
Status: aprovado Atualizado em: 2026-08-11 Issue: #641 (D12) Intenção: docs/plans/e2e-combobox-label-strict-mode-flake.md Appetite restante: herdado (P3, kind: defect, sem nova superfície)
Leitura da intenção
- Outcome:
campaignRegisterDemandverde em run completo e isolado; sem mudança de DOM/labels no estado fechado que afete outros specs. - O que NÃO negociar: copy visível e comportamento da combobox intactos; nenhuma regressão de a11y do dialog.
- O que reavaliar: a hipótese "o conteúdo do CommandDialog fica sempre montado" da intenção não se sustenta — ver caracterização abaixo.
Caracterização (completada na sessão, browser real + código)
- Estado estável (fechado): exatamente 1 match. O trigger (
aria-label="Atividade relacionada: Nenhuma atividade") é o único nó. OCommandDialogusaDialogPortalsemforceMount(src/components/ui/dialog.tsx): o conteúdo (incl.CommandInputcomaria-label={label}) só monta comopenou na animação de saída (~200ms,duration-200). - Dialog aberto: 2 matches — trigger +
CommandInput(role="combobox",aria-label="Atividade relacionada"). Medido ao vivo. - O sr-only
DialogHeader(título + descrição) fica montado permanentemente — é filho direto deDialog.Root(render inline, fora da porta). O snapshot pós-falha do D11 ("título + descrição no DOM com o dialog fechado") é o estado normal da página, não evidência de dialog montado. - O teste que flakava (linha 38) nunca abre o dialog — logo o segundo match não pode ser o
CommandInputpor interação do próprio teste. - A intenção registra o segundo match como "ambos botões" com o mesmo
aria-labeldo trigger → duplicação transitória de instância (2 comboboxes idênticos no DOM por um instante), a classe já tratada emcd469857(2026-08-09): "transient RSC-pending duplication … strict-mode flake on loaded machines" → fix estabelecido no repo:.first()nos asserts. - Navegação dura (
page.goto) medida ao vivo: 0→1 sem janela de 2 matches na máquina local; a duplicação é dependente de carga (máquina do pool, compiles de 6–27s).
Abordagem recomendada
flowchart LR
A[Flake strict-mode 2 matches] --> B{2º match é...}
B -->|"CommandInput do dialog"| C[Descartado: teste nunca abre o dialog]
B -->|"2º trigger idêntico"| D[Duplicação transitória de instância<br/>classe cd469857]
D --> E["Fix: .first() no assert<br/>precedente do repo"]
Opções consideradas: A (spec .first()) | B (spec getByRole('button', …)) | C (componente: remover label do CommandInput / aria-hidden no fechado)
Recomendação: A — .first() nos asserts de getByLabel('Atividade relacionada') dos dois specs que usam o label (campaignRegisterDemand.e2e.spec.ts:38 e campaignActivity.e2e.spec.ts:52), com comentário citando o precedente cd469857.
Rejeitadas:
- B —
getByRole('button', { name: /Atividade relacionada:/ })resolve a duplicação trigger+input (input érole=combobox), mas não resolve o caso reportado ("ambos botões" = duplicação de instância): 2 triggers de mesmoaria-label→ mesma strict violation. - C — o portal não está montado no fechado (medido): remover
aria-labeldoCommandInputnão muda o estado estável e degradaria a a11y do input de busca (o dialog precisa de label próprio);aria-hiddenno fechado não tem alvo (nada montado). Não atinge a duplicação transitória, que é artefato de render do framework (Next/React), não do componente. - (descartada na análise) "esperar o dialog abrir/fechar": o teste não interage com o dialog.
Componentes / mudanças
tests/e2e/campaignRegisterDemand.e2e.spec.ts:38:page.getByLabel(CAMPAIGN_DEMAND_ACTIVITY_LABEL)→.first(). Semântica preservada: o teste quer provar que o campo está presente/visível; qualquer uma das instâncias transitórias é o mesmo trigger.tests/e2e/campaignActivity.e2e.spec.ts:52: idem (mesmo label, mesma classe de flake — página da atividade também montaAsyncSearchComboboxviaDemandFields).- Migration: sem migration. Access/Consent: não toca. UI/componente: nenhuma mudança (aceite "sem mudança de DOM/labels").
- Comentário nos dois asserts no estilo
cd469857(classe + motivo, não reescrever o histórico).
Fases verificáveis
- Baseline (reprodução) — run completo do e2e em dev (em andamento, máquina com load real 11–22): registrar se o flake reproduz localmente. O D11 já provou pré-existência em main via stash (3/4 runs falharam no pool); a reprodução local é bônus, não gate.
- Fix —
.first()nos 2 asserts. - Gates —
campaignRegisterDemandisolado (dev) +campaignActivityisolado; run completo do e2e verde;pnpm gate:fast(tsc, lint, format, unit+int) epnpm check:cycles; knip.
Rabbit holes / Não escopo (engenharia)
- Não investigar o mecanismo exato da duplicação transitória do Next/React (bug upstream, dependente de carga; o repo já decidiu a resposta pragmática em
cd469857). - Não mexer no
AsyncSearchCombobox/CommandDialog(a11y do dialog é correta; portal não monta no fechado). - Não trocar
getByLabelporgetByRolenos outros ~100 usos do arquivo (fora do escopo do label em questão).
Riscos e mitigação
- Flake não reproduz na máquina local (condições do pool diferentes) → mitigação: validação = mecanismo caracterizado ao vivo (estado estável 1 match; 2 matches só em instância duplicada/open) + fix idêntico ao precedente aprovado
cd469857+ runs completos verdes pós-fix (1+). .first()mascarar regressão real (ex.: 2 instâncias ESTÁVEIS) → mitigação: assert continua verificando visibilidade do campo; se um dia houver duplicação estável, os outros asserts do spec (contagem 0/1 em linhas vizinhas) pegam.- Aceite "grep getByLabel em e2e" → verificado: os únicos usos do label
Atividade relacionadasão os 2 pontos alterados; nenhum outro spec depende do estado fechado da combobox.
Aceite de engenharia
- Aceite da intenção coberto (spec verde isolado e em run completo; DOM/labels fechados intactos)
- Invariantes AGENTS/engineering-standards (sem migration/access/transação; identificadores em inglês; precedente
cd469857) - Testes: run completo e2e dev verde + specs alterados isolados; gates completos no fechamento