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

1.4 KiB

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