implements PR009
This commit is contained in:
@@ -1,36 +0,0 @@
|
||||
# PR-009 - PBS Diagnostics Contract V1
|
||||
|
||||
## Briefing
|
||||
O modelo atual de `Diagnostic` nao contem fase, template id nem placeholders estaveis, o que impede conformidade com o contrato de diagnosticos da spec.
|
||||
Este PR eleva o contrato de diagnosticos para v1 sem acoplar a UI.
|
||||
|
||||
## Target
|
||||
- Specs:
|
||||
- `docs/pbs/specs/12. Diagnostics Specification.md` (secoes 6, 7, 8, 9, 10)
|
||||
- `docs/pbs/specs/13. Lowering IRBackend Specification.md` (secao 7)
|
||||
- Codigo:
|
||||
- `prometeu-compiler/prometeu-compiler-core/src/main/java/p/studio/compiler/source/diagnostics/Diagnostic.java`
|
||||
- `prometeu-compiler/prometeu-compiler-core/src/main/java/p/studio/compiler/source/diagnostics/DiagnosticSink.java`
|
||||
- emissores de diagnostico no frontend PBS.
|
||||
|
||||
## Method
|
||||
1. Estender `Diagnostic` com `phase`, `templateId` e `placeholders` nomeados.
|
||||
2. Definir taxonomia minima de fases externas: `syntax`, `static-semantics`, `manifest-import-resolution`, `linking`, `host-admission`, `load-facing-rejection`.
|
||||
3. Preservar `code`, `severity`, `span` e `related spans` como identidade estavel.
|
||||
4. Introduzir helpers para emissao padronizada por fase/template.
|
||||
5. Mapear erros atuais de lexer/parser/frontend para o novo contrato.
|
||||
|
||||
## Acceptance Criteria
|
||||
- Todo diagnostico PBS emitido tem `code`, `severity`, `phase`, `templateId`, `primary span` e mensagem renderizada.
|
||||
- Duplicatas/conflitos incluem ao menos um `related span` quando aplicavel.
|
||||
- Identidade de diagnostico independe do texto localizado.
|
||||
- Nenhuma fase obrigatoria e colapsada de forma opaca para o usuario.
|
||||
- Chamadas legadas continuam compilando com caminho de migracao claro.
|
||||
|
||||
## Tests
|
||||
- `DiagnosticSinkTest` e novos testes de contrato para:
|
||||
- presenca obrigatoria de campos;
|
||||
- estabilidade de `templateId/placeholders`;
|
||||
- caso com `related span`;
|
||||
- serializacao/`toString` com fase e codigo.
|
||||
- Testes de integracao no frontend PBS garantindo fase correta por erro.
|
||||
@@ -1,35 +0,0 @@
|
||||
# PR-010 - PBS IRBackend Lowering Contract Alignment
|
||||
|
||||
## Briefing
|
||||
O lowering atual reduz tudo a `IRFunction(name, arity, hasReturnType)` e perde informacao exigida pela spec de lowering.
|
||||
Este PR alinha o frontend boundary para preservar identidade, superficie de retorno e atribuicao de origem.
|
||||
|
||||
## Target
|
||||
- Specs:
|
||||
- `docs/pbs/specs/13. Lowering IRBackend Specification.md` (secoes 5, 6, 7, 8)
|
||||
- `docs/pbs/specs/11. AST Specification.md` (metadados obrigatorios)
|
||||
- Codigo:
|
||||
- `prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsFrontendCompiler.java`
|
||||
- `prometeu-compiler/prometeu-frontend-api/src/main/java/p/studio/compiler/models/IRFunction.java`
|
||||
- `prometeu-compiler/prometeu-frontend-api/src/main/java/p/studio/compiler/models/IRBackend*.java`
|
||||
|
||||
## Method
|
||||
1. Expandir modelos de IR para preservar categoria de callable e superficie de retorno.
|
||||
2. Propagar atribuicao de origem estavel (`file + span`) de forma obrigatoria.
|
||||
3. Diferenciar rejeicao de forma nao suportada vs erro interno.
|
||||
4. Garantir determinismo de ordem de emissao conforme ordem de fonte.
|
||||
5. Manter bridge de compatibilidade para consumidores atuais de IR.
|
||||
|
||||
## Acceptance Criteria
|
||||
- IRBackend preserva identidade e aridade de callables sem perda de categoria.
|
||||
- Retorno (unit/plain/result) e mantido no boundary de frontend.
|
||||
- Diagnosticos de lowering seguem contrato estavel (code/phase/template/span).
|
||||
- Formas nao suportadas nao degradam silenciosamente para comportamento valido alternativo.
|
||||
- Testes existentes de lowering continuam passando com adaptacao minima.
|
||||
|
||||
## Tests
|
||||
- `PbsFrontendCompilerTest` ampliado para:
|
||||
- preservacao de metadata no IR;
|
||||
- ordem deterministica de callables;
|
||||
- casos de rejeicao de lowering com diagnostico estavel.
|
||||
- Novos testes para serializacao/debug de `IRBackend`.
|
||||
@@ -1,35 +0,0 @@
|
||||
# PR-011 - PBS Gate U Conformance Fixtures
|
||||
|
||||
## Briefing
|
||||
A spec exige evidencia de conformidade (Gate U), mas o frontend ainda tem poucos testes unitarios sem fixture matrix.
|
||||
Este PR cria a infraestrutura e a bateria minima de fixtures para validar lexer, parser, semantica, diagnosticos e lowering.
|
||||
|
||||
## Target
|
||||
- Specs:
|
||||
- `docs/pbs/specs/11. AST Specification.md` (secao 12)
|
||||
- `docs/pbs/specs/13. Lowering IRBackend Specification.md` (secao 8)
|
||||
- `docs/general/specs/13. Conformance Test Specification.md`
|
||||
- Codigo:
|
||||
- novo pacote de teste/fixtures em `prometeu-compiler/frontends/prometeu-frontend-pbs/src/test/`.
|
||||
|
||||
## Method
|
||||
1. Introduzir harness de fixture com entrada `.pbs/.barrel` + expectativa estruturada.
|
||||
2. Cobrir casos validos das familias obrigatorias de AST e fluxo de parse.
|
||||
3. Cobrir casos invalidos obrigatorios (missing closer, non-assoc chains, formas fora de slice).
|
||||
4. Adicionar asserts de spans e identidade de diagnostico (code/phase/template).
|
||||
5. Integrar suite no gradle test da frontend PBS.
|
||||
|
||||
## Acceptance Criteria
|
||||
- Existe fixture matrix positiva e negativa para lexer/parser/semantica/lowering.
|
||||
- Gate U cobre familias obrigatorias de declaracao, statement e expressao.
|
||||
- Casos de recovery garantem AST coerente mesmo com erro.
|
||||
- Conformidade e verificavel de forma reproduzivel em CI.
|
||||
- Falhas mostram diff util entre esperado e obtido.
|
||||
|
||||
## Tests
|
||||
- `PbsConformanceFixtureTest` novo com subconjuntos:
|
||||
- `valid/` para parse e lowering;
|
||||
- `invalid/syntax/`;
|
||||
- `invalid/static-semantics/`;
|
||||
- `invalid/lowering/`.
|
||||
- Execucao via `./gradlew :prometeu-compiler:frontends:prometeu-frontend-pbs:test`.
|
||||
Reference in New Issue
Block a user