[GATE] Garantir zero falsa auto-seleção em MQSeries e IDoc

[elson-vinicius-lopes]

PBI pai

#178

Risco protegido

Layout incorreto selecionado silenciosamente e usado para editar/transformar um documento.

Gate

• corpus com pelo menos 20 exemplos redigidos/sintéticos por layout aprovado;
• matriz cruzada contra todos os layouts da mesma família;
• mutações de marcador, largura, ordem, cardinalidade e discriminador;
• zero falsas auto-seleções; ambiguidades conhecidas permanecem ambiguous;
• p95 acordado para detecção + parse;
• E2E desktop/mobile cobre unique, ambiguous, not_found e override;
• correlationId chega à API e ao MCP;
• npm run quality e deployments development/production verdes antes de Done.

Bloqueio

Depende de implementação API + front e de corpus autorizado sem payload sensível.

Extensão do gate — Top 5 e override

• para cada caso não único, o ranking contém no máximo cinco itens e corresponde à ordenação determinística esperada;
• evidências, conflitos, limitações, empates, total e truncamento são validados no contrato;
• ambiguous e not_found jamais retornam layout selecionado nem disparam parse;
• E2E comprova que nenhum item vem pré-selecionado em desktop, mobile, teclado e leitor de tela;
• E2E cobre escolha do 1º ao 5º colocado e seleção fora do Top 5 pelo catálogo completo;
• auditoria diferencia ranked_candidate e manual_override e preserva rank/score apresentados, versões e correlationId;
• alteração do algoritmo ou catálogo exige reexecução da matriz e não pode reclassificar falsa equivalência como certeza.

[elson-vinicius-lopes]

Gate fornecedor vinculado: LayoutParser/LayoutParserApi#215. O gate do front continua responsável pelo fluxo do consumidor e E2E; o gate da API prova matcher, corpus, matriz negativa, limites e zero falso unique.

[elson-vinicius-lopes]

Gate local aprovado no PR #186: npm run quality, 250 testes front, 69 BFF, contrato 13/13, Playwright 18/18, MQSeries real 8/8 e IDoc real unique. Nenhuma fixture privada foi versionada.

[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.