fix(platform): make the PR-data marker readable on touch and keyboard

[cpenaforte-clickbus]

Contexto e Motivação

A revisão final das correções de plataforma (#292) apontou o que ainda dependia de passar o mouse: quem usa toque ou teclado não via quais passos da leitura falharam, nem na comparação nem no badge da página do repositório, porque essa informação estava só no title. O ponto âmbar tinha contraste de cerca de 2,2:1 sobre fundo claro, abaixo dos 3:1 do WCAG 1.4.11 para o único indicador da linha. E o tooltip dizia que a merge strategy não é classificada quando o enriquecimento falha, o que, com a degradação por estado do engine, só vale para os PRs mergeados.

Refs #236

Mudanças

• Os passos que falharam aparecem como texto visível, traduzido, na linha da tabela de comparação, no card do celular — numa linha própria, para não espremer o nome do repositório — e ao lado do badge da página do repositório. O leitor de tela ouve uma frase só por layout, sem repetição; o badge perde o title que repetia os passos.
• O ponto passa a bg-amber-600 no tema claro, que dá cerca de 3,2:1 sobre o card, com variante escura própria; o card do celular perde um espaçamento dobrado.
• O tooltip passa a dizer "quando o enriquecimento dos PRs mergeados falha" e cita as métricas de ciclo de vida do PR e de PRs abertos entre as que podem faltar ou sair distorcidas, espelhando o aviso do engine.
• O rótulo do passo fetch passa a "leitura inteira" / "entire read": antes a frase dizia "A leitura de PRs desta execução falhou em: leitura de PRs" — achado numa verificação manual de ponta a ponta.
• O motivo do cast nas linhas do resumo fica ao lado do próprio cast.
• Um teste de renderização fixa o marcador, os passos visíveis e o texto para leitor de tela na comparação.

Plano de Teste

• npx vitest run — inclusive o teste de renderização da comparação: passos visíveis nos dois layouts, uma única frase para leitor de tela por layout, passos fora da linha do nome no celular — rodado em 8e83ca4: 431 passed
• npm run lint, npx tsc --noEmit, npm run test:coverage, npm run build — os passos do job platform do CI — rodado em 4911e6d: lint 0 erros, tsc ok, test:coverage 431 passed, build ok; depois da correção do rótulo, em 8e83ca4: vitest 431, tsc e lint de novo, e o CI verde
• Manual: navegar a comparação só com teclado e num celular, e abrir a página de um repositório degradado; conferir os passos sem passar o mouse — verificado de ponta a ponta em 4911e6d, com o rótulo corrigido conferido depois em 8e83ca4: plataforma rodando sobre as migrações reais e um PostgREST, com payloads do engine em sete cenários de falha, no Playwright em desktop, celular (390 px), só teclado, leitor de tela, tema escuro, pt-BR, en-US e es-ES; os passos ficam visíveis sem mouse, o leitor de tela ouve uma frase por linha e o rótulo corrigido de fetch ("leitura inteira") foi conferido no navegador

A verificação roda fora da máquina de quem construiu: o job platform do CI (RFC 0029, PM-4).

Impacto e Risco

• Áreas afetadas: comparação, badge da página do repositório e strings de tradução.
• Compatibilidade: sem o campo no payload, nada aparece, como antes.
• Performance: nenhuma mudança.
• Segurança: nenhuma superfície nova; os passos continuam passando pela lista de valores permitidos.
• Acessibilidade: é o objetivo deste PR — informação sem depender de cor nem de title, contraste de pelo menos 3:1 e uma única leitura por layout no leitor de tela.
• Custo AWS: N/A.

Tamanho (RFC 0028 §2.4): 247 linhas, faixa 51–250.

Plano de Rollback

git revert do merge. Volta o comportamento do #292; nada a migrar.

Referências

• Issue: [DEBT] PR enrichment degrades silently when the GraphQL step fails; the report carries no signal #236
• Depends on fix(platform): make the PR-data query opt-in and localize its steps #292 — PR empilhado: a base é a branch dele
• RFC 0025, RFC 0028, RFC 0029 PM-4

Autoria Assistida

• Agente: Claude Code — Claude Opus 5.5 nos commits, na orquestração e nas revisões finais; Claude Sonnet 5.5 numa das re-revisões
• Escopo da assistência: achados da revisão final e implementação guiada por testes
• Revisão humana: pendente — o autor revisa antes do merge

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
clickbus-iris	Ready	Preview	Oct 8, 2026 1:09pm UTC