[TASK] UX: tratar unique, ambiguous e not_found com fallback manual

[elson-vinicius-lopes]

Story pai

#180

Entrega UX/a11y

Fluxo arquivo-primeiro com estado de análise, chip Layout identificado, seletor de candidatos ambíguos, diagnóstico sem candidato e ação Trocar manualmente.

Definition of Done

• aria-live anuncia análise e resultado sem roubar foco;
• ambiguidade não usa candidato pré-selecionado;
• evidências são compreensíveis e não expõem conteúdo do arquivo;
• fallback manual funciona por teclado, toque e leitor de tela;
• desktop/mobile seguem o mesmo modelo mental.

Bloqueio

Aguardando shape final de candidatos/evidências.

Definition of Done adicional — ranking explicável

• a lista mostra no máximo cinco opções e diferencia “compatível” de “mais próximo”;
• cada opção apresenta nome, equivalência e resumo compreensível de correspondências/conflitos, sem sugerir certeza indevida;
• nenhuma opção recebe checked, foco ou destaque de recomendação por padrão;
• empates têm tratamento visual e textual neutro;
• a ação primária permanece desabilitada até seleção e confirmação explícitas;
• total/truncamento e acesso ao catálogo completo são perceptíveis por teclado, leitor de tela, toque e mobile;
• após confirmação, a interface exibe referência auditável sem expor dados sensíveis.

[elson-vinicius-lopes]

UX implementada no PR #186: estados loading/unique/ambiguous/not_found/error, top 5 explicável, score descrito como índice, teclado/aria-live/reduced-motion e responsividade desktop/mobile.

[elson-vinicius-lopes]

Concluída em desenvolvimento pelo PR #186 (commit 54b3f39). CI/CD, CodeQL, suíte completa e gate E2E real MQSeries aprovados no ambiente development. A promoção para main permanece fora deste fechamento e deve seguir o fluxo develop → main.