prometeu-studio/docs/pbs/pull-requests/PR-O1.1-backend-diagnostics-taxonomy-and-attribution.md

PR-O1.1 - Backend Diagnostics Taxonomy and Attribution

Briefing

Fechar lacunas de consistencia diagnostica no backend executavel, padronizando familias de erro (MARSHAL_FORMAT_*, MARSHAL_LINKAGE_*, MARSHAL_VERIFY_PRECHECK_*) e regras minimas de atribuicao de fonte quando o erro for acionavel pelo usuario.

Target

• prometeu-compiler/prometeu-build-pipeline (stages e servicos de lowering/optimize/emit).
• Contratos de excecao/codigos de erro no backend.
• Mapeamento de falhas para mensagens estaveis no pipeline.

Method

• Consolidar codigos de erro de backend em taxonomia unica e estavel.
• Garantir que erros source-atribuiveis propaguem fileId/span quando disponivel no IRBackend.
• Alinhar mensagens de stage para manter determinismo de identificacao entre execucoes.

Acceptance Criteria

• Falhas de backend relevantes caem em uma das 3 familias normativas.
• O mesmo input gera o mesmo error code e mesma fase reportada.
• Erros source-atribuiveis carregam ancora primaria de fonte.
• Gate de build nao mascara codigo original do erro backend.

Tests

• Unit tests para mapeamento de excecoes em cada stage (LowerToIRVM, OptimizeIRVM, EmitBytecode).
• Fixtures negativos garantindo estabilidade de code/fase/mensagem base.
• Caso com span disponivel validando atribuicao no diagnostico final.