prometeu-studio/docs/pbs/pull-requests/PR-039-pbs-frontend-irbackend-v2-lowering.md
2026-03-24 13:42:24 +00:00

38 lines
1.4 KiB
Markdown

# PR-039 - PBS Frontend Lowering to IRBackend v2
## Briefing
Atualizar o frontend PBS para emitir `IRBackend` v2 executavel, incluindo corpo lowerable e classificacao de chamadas conforme contrato normativo da agenda 18.1.
## Target
- Atualizar `PbsFrontendCompiler` e servicos correlatos para emitir IR v2.
- Materializar callsites classificados no lowering frontend.
- Preservar ancoras de fonte por instrucao/callsite para diagnostico backend.
## Method
- Extrair do AST/semantica as operacoes necessarias ao corpo lowerable.
- Mapear chamadas para `CALL_FUNC`/`CALL_HOST`/`CALL_INTRINSIC`.
- Anexar metadado canonico de host/intrinsic por callsite com validacao de coerencia.
- Preservar fail-fast dependency-scoped ja existente na agregacao.
## Acceptance Criteria
1. Frontend PBS produz `IRBackend` v2 para modulos executaveis.
2. Chamadas host/intrinsic saem classificadas e com metadado canonico.
3. Diagnosticos permanecem deterministicos e com atribuicao de fonte.
4. SDK interface continua sem emissao de corpo executavel quando aplicavel.
## Tests
1. Testes de frontend para classificacao correta de callsites.
2. Testes negativos para metadado reservado invalido.
3. Testes de regressao para fail-fast em modulos dependentes.
## Affected Documents
- `docs/pbs/specs/13. Lowering IRBackend Specification.md`
- `docs/general/specs/13. Conformance Test Specification.md`