implements PR024
This commit is contained in:
@@ -1,55 +0,0 @@
|
||||
# PR-022 - PBS Source Kind and Module Origin in Frontend Pipeline
|
||||
|
||||
## Briefing
|
||||
|
||||
O pipeline atual trata todo `.pbs` como fonte ordinaria de projeto.
|
||||
As specs exigem distincao entre source ordinario e interface-module de SDK/stdlib.
|
||||
|
||||
Esta PR introduz classificacao explicita de origem de fonte no frontend para permitir regras diferentes por contexto.
|
||||
|
||||
## Motivation
|
||||
|
||||
Sem classificacao de origem, o parser e os validadores nao conseguem aplicar corretamente:
|
||||
|
||||
- rejeicao de forms reservadas em projeto ordinario,
|
||||
- admissao de forms reservadas em interface modules,
|
||||
- e ownership correto de diagnosticos de resolucao/import.
|
||||
|
||||
## Target
|
||||
|
||||
- `FrontendPhaseContext` e dados de projeto consumidos pelo frontend PBS.
|
||||
- `PBSFrontendPhaseService` e fluxo de descoberta/roteamento de fontes.
|
||||
|
||||
## Scope
|
||||
|
||||
- Introduzir `SourceKind`/`ModuleOrigin` no pipeline (`PROJECT`, `SDK_INTERFACE`).
|
||||
- Preservar comportamento atual para fontes ordinarias.
|
||||
- Nao alterar ainda parser/semantica de forms reservadas (vem nas PRs seguintes).
|
||||
|
||||
## Method
|
||||
|
||||
- Adicionar modelagem de origem por unidade de modulo no frontend phase.
|
||||
- Classificar modulo pelo project space (`@core:*`, `@sdk:*` vs projetos ordinarios), conforme specs de resolucao.
|
||||
- Propagar `SourceKind` ate o ponto de parsing/validacao para habilitar gating por contexto nas PRs seguintes.
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- Cada arquivo `.pbs` processado pelo frontend possui `SourceKind` deterministico.
|
||||
- Modulos ordinarios continuam no caminho atual sem regressao.
|
||||
- Modulos reservados ficam marcados para fluxo de interface-module.
|
||||
|
||||
## Tests
|
||||
|
||||
- Testes unitarios para classificacao de origem de modulo por project space.
|
||||
- Testes de nao regressao em projeto ordinario sem stdlib.
|
||||
|
||||
## Non-Goals
|
||||
|
||||
- Implementar stdlib loader completo.
|
||||
- Alterar AST ou parser de forms reservadas.
|
||||
|
||||
## Affected Documents
|
||||
|
||||
- `docs/pbs/specs/3. Core Syntax Specification.md`
|
||||
- `docs/pbs/specs/5. Manifest, Stdlib, and SDK Resolution Specification.md`
|
||||
- `docs/pbs/specs/8. Stdlib Environment Packaging and Loading Specification.md`
|
||||
@@ -1,53 +0,0 @@
|
||||
# PR-023 - PBS Stdlib Environment Resolver and Interface Loader
|
||||
|
||||
## Briefing
|
||||
|
||||
Para suportar interface modules reais, o frontend precisa resolver project spaces reservados (`@core:*`, `@sdk:*`) fora da trilha de dependencias ordinarias.
|
||||
|
||||
Esta PR introduz o loader/resolver de stdlib environment com fronteiras explicitas.
|
||||
|
||||
## Motivation
|
||||
|
||||
As specs definem que stdlib e import ordinario possuem resolucoes distintas e sem fallback cruzado.
|
||||
Sem essa separacao, interface modules nao podem ser montados de forma normativa.
|
||||
|
||||
## Target
|
||||
|
||||
- Abstracoes de stdlib no frontend/compiler pipeline.
|
||||
- Fluxo de import para project spaces reservados.
|
||||
|
||||
## Scope
|
||||
|
||||
- Introduzir `StdlibEnvironment`, `StdlibModuleResolver`, `StdlibModuleSource`, `InterfaceModuleLoader`.
|
||||
- Integrar roteamento no `PBSFrontendPhaseService` para imports reservados.
|
||||
- Manter resolucao ordinaria inalterada para `@project:*` nao reservado.
|
||||
|
||||
## Method
|
||||
|
||||
- Implementar resolucao por linha de stdlib selecionada no root manifest.
|
||||
- Carregar modulo reservado como fonte PBS real (nao tabela hardcoded).
|
||||
- Emitir erro deterministico quando modulo reservado nao for encontrado/carregado.
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- Imports reservados nao passam por resolver ordinario.
|
||||
- Imports ordinarios nao passam por stdlib resolver.
|
||||
- Falha de resolucao reservada gera diagnostico deterministico e atribuivel.
|
||||
|
||||
## Tests
|
||||
|
||||
- Fixture: import reservado resolvido via stdlib resolver.
|
||||
- Fixture: modulo reservado inexistente com erro deterministico.
|
||||
- Fixture: tentativa de resolver reservado via trilha ordinaria rejeitada.
|
||||
|
||||
## Non-Goals
|
||||
|
||||
- Validacao semantica de forms reservadas dentro do modulo carregado.
|
||||
- Extracao de metadata de builtins/host para lowering.
|
||||
|
||||
## Affected Documents
|
||||
|
||||
- `docs/pbs/specs/5. Manifest, Stdlib, and SDK Resolution Specification.md`
|
||||
- `docs/pbs/specs/8. Stdlib Environment Packaging and Loading Specification.md`
|
||||
- `docs/pbs/specs/12. Diagnostics Specification.md`
|
||||
|
||||
@@ -1,55 +0,0 @@
|
||||
# PR-024 - PBS Parser and AST Support for Interface-Module Mode
|
||||
|
||||
## Briefing
|
||||
|
||||
Hoje o parser rejeita atributos no topo e `declare host`/`declare builtin type` sempre.
|
||||
Em interface-module mode, essas forms reservadas devem ser parseadas e representadas no AST.
|
||||
|
||||
## Motivation
|
||||
|
||||
Sem AST/parser para forms reservadas:
|
||||
|
||||
- nao ha como validar semantica de SDK/stdlib,
|
||||
- nao ha como extrair metadata (`Host`, `BuiltinType`, `Slot`, `IntrinsicCall`),
|
||||
- e nao ha base para linking/lowering dessas surfaces.
|
||||
|
||||
## Target
|
||||
|
||||
- `PbsAst` (novos nodes de declaracao e metadata de atributo).
|
||||
- `PbsParser` com `SourceKind`/mode-aware parsing.
|
||||
|
||||
## Scope
|
||||
|
||||
- Adicionar no AST: `HostDecl`, `BuiltinTypeDecl`, shapes de atributo e anexacao por posicao valida.
|
||||
- Em modo `PROJECT`: manter rejeicao de forms reservadas e atributos fora de regras.
|
||||
- Em modo `SDK_INTERFACE`: parsear forms reservadas e attributes permitidas.
|
||||
|
||||
## Method
|
||||
|
||||
- Tornar parser mode-aware (`ORDINARY`, `INTERFACE_MODULE`).
|
||||
- Substituir rejeicao hardcoded por gating por mode.
|
||||
- Preservar spans, recovery e diagnosticos deterministicos.
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- Modulo ordinario continua rejeitando `declare host`/`declare builtin type` e usos invalidos de atributos.
|
||||
- Interface module aceita as forms reservadas sintaticamente previstas.
|
||||
- AST exposto inclui metadata necessaria para fases seguintes.
|
||||
|
||||
## Tests
|
||||
|
||||
- Parser tests para ordinario vs interface-module com mesmos tokens.
|
||||
- Tests de recovery e spans nas novas declaracoes.
|
||||
- Tests negativos para formas reservadas malformadas.
|
||||
|
||||
## Non-Goals
|
||||
|
||||
- Julgamento semantico completo das attributes reservadas.
|
||||
- Resolucao de imports reservados (ja coberta em PR anterior).
|
||||
|
||||
## Affected Documents
|
||||
|
||||
- `docs/pbs/specs/3. Core Syntax Specification.md`
|
||||
- `docs/pbs/specs/11. AST Specification.md`
|
||||
- `docs/pbs/specs/12. Diagnostics Specification.md`
|
||||
|
||||
Reference in New Issue
Block a user