[PBI] Identificar automaticamente layouts MQSeries e IDoc

[elson-vinicius-lopes]

Epic pai

#177

Problema/oportunidade

Hoje o front exige um layout escolhido manualmente, baixa seu XML descriptografado e envia layout + documento para o parse. O detector da API identifica apenas a família física, não o layoutGuid.

Hipótese de valor

Um matcher determinístico e sem efeitos colaterais pode auto-selecionar quando restar exatamente um candidato provado e falhar fechado em colisões.

Critérios de aceite

• unique existe somente com um candidato após todos os gates duros.
• ambiguous nunca pré-seleciona silenciosamente.
• not_found informa conflitos sanitizados e oferece modo manual.
• API mantém o XML do layout fora do navegador.
• Resposta inclui correlationId, versão do algoritmo/catálogo e evidências estáveis.
• MQSeries e IDoc possuem matriz cruzada positiva/negativa.
• Zero falsas auto-seleções no corpus aprovado.

Dependências

Contrato e implementação pertencem primeiro ao LayoutParserApi; front inicia integração somente após aceite de @lp-contract-qa.

Refinamento de escopo — ranking assistido

• ambiguous devolve de 2 a 5 candidatos compatíveis ordenados por equivalência.
• not_found pode devolver de 0 a 5 layouts mais próximos como sugestões não autoritativas; zero só é válido quando não existe candidato comparável.
• A resposta informa quantidade total avaliada/compatível e se a lista foi truncada.
• Cada item contém identificador estável do layout, posição no ranking, score/componentes, evidências favoráveis, conflitos e limitações, sem expor conteúdo do documento.
• O ranking é determinístico para o mesmo documento, catálogo e versão do algoritmo; empates permanecem explícitos.
• Ranking não autoriza unique, parse, edição ou transformação sem escolha do usuário.
• Nenhum candidato não autoritativo é pré-selecionado no contrato ou na interface.
• Seleção entre os Top 5 ou busca manual gera proveniência auditável distinguindo auto_unique, ranked_candidate e manual_override.

[elson-vinicius-lopes]

Sub-issues registradas:

• [TASK] Contrato: validar fingerprint e probe autoritativo da API #179 — fingerprint/probe/contrato na API (P0, bloqueio externo);
• [STORY] Anexar somente o documento e receber o layout identificado #180 — Story do fluxo arquivo-primeiro;
• [GATE] Garantir zero falsa auto-seleção em MQSeries e IDoc #183 — gate de zero falsa auto-seleção;
• [TASK] Expor detect_layout no MCP após estabilizar contrato da API #184 — tool MCP tipada após estabilização do endpoint.

A Story #180 contém as Tasks #181 (front) e #182 (UX).