73 lines
2.5 KiB
Markdown
73 lines
2.5 KiB
Markdown
# 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.
|