prometeu-studio/docs/compiler/pbs/pull-requests/PR-06.1-source-attribution-and-diagnostics-evidence-hardening.md

PR-06.1 - Source Attribution and Diagnostics Evidence Hardening

Briefing

Ha cobertura parcial para preservacao de source attribution em rejeicoes backend e no handoff executavel.

Esta PR fecha os gaps de evidencia para requisitos de atribuicao de origem e estabilidade de diagnostico.

Motivation

Dor atual que esta PR resolve

1. Falta de prova forte de que erros backend preservam file/start/end quando acionaveis pelo usuario.
2. Parte da matriz marca partial para requisitos de atribuicao (G20-11.3, PBS13-12.1.4).
3. Revisao de regressao de spans depende de inspeccao manual.

Target

Cobertura automatizada para atribuicao de origem em diagnosticos de falha backend e no contrato executavel.

Dependencies

Prerequisitos recomendados:

1. PR-05.5 (stack effects reais host/intrinsic).
2. PR-05.8 (matriz de conformidade existente).

Scope

1. Testes de atribuicao de origem para falhas deterministicas no LowerToIRVM.
2. Testes de atribuicao para falhas de pipeline (BACKEND_LOWER_IRVM e BACKEND_EMIT_BYTECODE) quando aplicavel.
3. Atualizacao da matriz para migrar G20-11.3 e PBS13-12.1.4 de partial para pass se houver cobertura completa.

Non-Goals

1. Nao altera semantica de linguagem.
2. Nao introduz novas classes de diagnostico.

Method

O que deve ser feito explicitamente

1. Criar fixtures negativas onde erro e claramente source-actionable e verificar:
   • code estavel,
   • phase estavel,
   • file/start/end presentes e coerentes.
2. Garantir que spans de instrucoes/callsites sejam propagadas ativamente para as mensagens de falha.
3. Atualizar a matriz com referencias exatas de teste.

Acceptance Criteria

1. Falhas source-actionable do backend expõem atribuicao de origem valida.
2. Requisitos G20-11.3 e PBS13-12.1.4 saem de partial se cobertura completa for atingida.
3. Nenhuma regressao em testes existentes de taxonomia de erro.

Tests

1. Novos testes unitarios/integracao para spans em diagnosticos de falha.
2. Reexecucao obrigatoria:
   • :prometeu-compiler:prometeu-build-pipeline:test
   • :prometeu-compiler:prometeu-frontend-api:test

Affected Documents

1. docs/general/specs/19. Verification and Safety Checks Specification.md
2. docs/general/specs/20. IRBackend to IRVM Lowering Specification.md
3. docs/general/specs/22. Backend Spec-to-Test Conformance Matrix.md
4. docs/pbs/specs/13. Lowering IRBackend Specification.md

Open Questions

Sem bloqueios arquiteturais.