gate: zero falsa auto-seleção na detecção de layout MQSeries/IDoc

[elson-vinicius-lopes]

Story pai

#213

Gate correspondente no consumidor

LayoutParser/LayoutParserReact#183.

Risco protegido

Retornar unique para o layout incorreto e permitir parse, edição ou transformação silenciosamente sobre uma equivalência falsa.

Critérios objetivos

• Corpus aprovado contém pelo menos 20 exemplos sintéticos/redigidos por layout habilitado para auto-seleção.
• Matriz negativa cruza cada documento contra todos os layouts da mesma família.
• Mutações cobrem marcador/segmento, largura, ordem, hierarquia, cardinalidade e discriminador.
• Precisão das auto-seleções é 100% e há zero falso unique; cobertura é medida separadamente e não precisa ser 100%.
• Colisões conhecidas continuam ambiguous; ausência de prova retorna not_found ou ambiguous.
• Concorrência, timeout, limites de arquivo/candidatos, cache e ausência de efeitos colaterais estão cobertos.
• Nenhum conteúdo documental aparece em logs; X-Correlation-ID é preservado na API e na futura tool MCP.
• Meta p95 é acordada e medida antes de Done.
• OpenAPI/README, testes e evidência de ambiente aplicável estão anexados sem dados sensíveis.

Regra de liberação

Qualquer falsa auto-seleção bloqueia a habilitação automática do layout afetado; o fallback manual permanece disponível.

Critérios adicionais — ranking e auditoria

• Top 5 é determinístico e reproduzível para o mesmo documento, algoritmo e catálogo.
• A lista tem no máximo cinco itens, ordenação esperada, empates explícitos, total e truncamento corretos.
• ambiguous contém somente compatíveis; sugestões de not_found são marcadas como não autoritativas.
• Nenhum resultado não único contém selectedLayout ou dispara parse.
• Seleção do 1º ao 5º colocado e override fora do Top 5 são testados contra adulteração, replay/expiração e troca de versão.
• Evento auditável preserva status original, origem, layout escolhido, rank/score apresentados, versões, correlationId e identificador de auditoria.
• Logs e evidências não contêm TXT/XML, e-mail ou identidade legível desnecessária.
• Qualquer falsa certeza, pré-seleção contratual ou escolha não auditável bloqueia a entrega.

[elson-vinicius-lopes]

Gate executado no PR #222: 12/12 testes específicos, 432/432 testes completos, MQSeries real ambiguous/top 5/override (59 linhas, 705 campos) e IDoc real unique Marelli (55 linhas, 263 campos). Catálogo incompleto bloqueia unicidade e override.

[elson-vinicius-lopes]

Concluída em desenvolvimento pelo PR #222 (commit 565d8f5). Build, 432 testes, segurança, publicação do serviço e smoke test do ambiente development aprovados. A promoção para master permanece fora deste fechamento.