implements PLN-0125
Intrepid/Prometeu/Studio/pipeline/head This commit looks good
JaCoCo Coverage #### Project Overview
No changes detected, that affect the code coverage.
* Line Coverage: 61.95% (17766/28676)
* Branch Coverage: 52.69% (6860/13019)
* Lines of Code: 28676
* Cyclomatic Complexity: 11490
#### Quality Gates Summary
Output truncated.
Test / Build skipped: 15, passed: 643
Intrepid/Prometeu/Studio/pipeline/pr-master This commit looks good
Intrepid/Prometeu/Studio/pipeline/head This commit looks good
JaCoCo Coverage #### Project Overview
No changes detected, that affect the code coverage.
* Line Coverage: 61.95% (17766/28676)
* Branch Coverage: 52.69% (6860/13019)
* Lines of Code: 28676
* Cyclomatic Complexity: 11490
#### Quality Gates Summary
Output truncated.
Test / Build skipped: 15, passed: 643
Intrepid/Prometeu/Studio/pipeline/pr-master This commit looks good
Move lifecycle assembly out of the PBS frontend into a common AssembleLifecyclePipelineStage. PBS emits a typed IRLifecycleDeclaration; the assembler owns wrappers, boot guard, and single project-init execution. Housekeep DSC-0059 with LSN-0062, and include the DSC-0062 PVM/PBX neutrality spec and lesson already present on this branch.
This commit is contained in:
@@ -1,77 +0,0 @@
|
||||
---
|
||||
id: AGD-0062
|
||||
ticket: multi-frontend-common-lifecycle
|
||||
title: Extrair lifecycle comum das responsabilidades do frontend PBS
|
||||
status: open
|
||||
created: 2026-07-15
|
||||
resolved:
|
||||
decision:
|
||||
tags: [compiler, compiler-general, compiler-pbs, lifecycle, backend, multi-frontend]
|
||||
---
|
||||
|
||||
# Agenda - Extrair o lifecycle do frontend PBS
|
||||
|
||||
## Objetivo
|
||||
|
||||
Domain owner: `compiler/general`, com impacto em `compiler/pbs`.
|
||||
|
||||
Separar declaracao de lifecycle feita por uma linguagem da montagem comum de init, frame, module initializers e entrypoint publicado.
|
||||
|
||||
## Contexto atual
|
||||
|
||||
As lessons e specs antigas indicam que PBS ja trata lifecycle e wrapper/entrypoint. O alinhamento pede que `PBSFrontendPhaseService` deixe de conter regras universais da plataforma.
|
||||
|
||||
## Escopo
|
||||
|
||||
- Localizar onde PBS sintetiza ou valida lifecycle.
|
||||
- Definir contrato comum de `LifecycleDeclaration` ou equivalente.
|
||||
- Planejar servico comum para validar, ordenar e montar entrypoint.
|
||||
|
||||
## Fora de escopo
|
||||
|
||||
- Alterar sintaxe PBS.
|
||||
- Mudar comportamento observavel de projetos existentes.
|
||||
- Refatorar todo o backend junto da extracao.
|
||||
|
||||
## Arquivos e componentes a inspecionar
|
||||
|
||||
- `prometeu-compiler/frontends/prometeu-frontend-pbs/...PBSFrontendPhaseService...`
|
||||
- `prometeu-compiler/prometeu-build-pipeline/src/main/java/p/studio/compiler/backend/irvm/LowerToIRVMService.java`
|
||||
- `docs/specs/compiler/16. Runtime Execution and Initialization Specification.md`
|
||||
- `docs/specs/compiler/20. IRBackend to IRVM Lowering Specification.md`
|
||||
- `docs/specs/compiler-languages/pbs/13. Lowering IRBackend Specification.md`
|
||||
|
||||
## Alteracoes propostas
|
||||
|
||||
Opcao A: frontend PBS emite declaracoes neutras de lifecycle e backend/common assembler monta o entrypoint.
|
||||
|
||||
Opcao B: manter montagem no PBS por enquanto, mas isolar regras comuns em um servico compartilhado chamado pelo PBS.
|
||||
|
||||
Recomendacao inicial: extrair primeiro o servico comum com testes de caracterizacao, depois migrar o PBS para produzir apenas declaracoes.
|
||||
|
||||
## Estrategia de implementacao
|
||||
|
||||
Identificar fixture positiva atual, proteger com teste, criar contrato comum minimo, mover validacoes universais e manter mensagens PBS onde forem sintaxe/semantica da linguagem.
|
||||
|
||||
## Testes necessarios
|
||||
|
||||
- Lifecycle valido PBS continua gerando mesmo PBX/IRVM.
|
||||
- Lifecycle ausente ou frame invalido falha no nivel comum quando aplicavel.
|
||||
- Teste de IR comum com lifecycle sem parser PBS.
|
||||
|
||||
## Criterios de aceitacao
|
||||
|
||||
- PBS traduz a forma da linguagem para declaracoes neutras.
|
||||
- Servico comum valida e monta lifecycle da plataforma.
|
||||
|
||||
## Riscos
|
||||
|
||||
- Mover validacoes PBS-especificas para camada comum por engano.
|
||||
- Alterar ordem de inicializadores sem perceber.
|
||||
|
||||
## Decisoes que devem ser registradas
|
||||
|
||||
- Nome e ownership do servico comum.
|
||||
- Forma canonica das declaracoes de lifecycle.
|
||||
- Separacao entre erro de linguagem e erro de plataforma.
|
||||
|
||||
@@ -1,78 +0,0 @@
|
||||
---
|
||||
id: AGD-0065
|
||||
ticket: multi-frontend-pvm-neutrality
|
||||
title: Neutralidade da PVM e identificacao PBX independente de PBS
|
||||
status: open
|
||||
created: 2026-07-15
|
||||
resolved:
|
||||
decision:
|
||||
tags: [vm-arch, runtime, pvm, pbx, compiler, multi-frontend]
|
||||
---
|
||||
|
||||
# Agenda - Manter a PVM neutra
|
||||
|
||||
## Objetivo
|
||||
|
||||
Domain owner: `vm-arch`, com impacto em `compiler/general`.
|
||||
|
||||
Garantir que a PVM conheca apenas PBX/IRVM e conceitos runtime neutros, incluindo identificacao correta do formato como `PBX`/`PBX\0`, nao `PBS`.
|
||||
|
||||
## Contexto atual
|
||||
|
||||
O documento e focado no Studio, mas runtime neutrality e uma fronteira transversal. A PVM nao deve conhecer `PBS service`, `PBS struct`, `PBS optional` ou qualquer conceito de linguagem.
|
||||
|
||||
## Escopo
|
||||
|
||||
- Auditar nomenclatura e imports runtime/PVM disponiveis no repo.
|
||||
- Verificar magic/header de PBX quando o codigo estiver no workspace.
|
||||
- Confirmar que linguagem e convertida antes da execucao.
|
||||
|
||||
## Fora de escopo
|
||||
|
||||
- Modificar a PVM se o acoplamento estiver apenas no Studio ou compiler.
|
||||
- Alterar ISA sem necessidade.
|
||||
- Adicionar suporte a qualquer linguagem nova.
|
||||
|
||||
## Arquivos e componentes a inspecionar
|
||||
|
||||
- `docs/vm-arch/ARCHITECTURE.md`
|
||||
- `docs/vm-arch/ISA_CORE.md`
|
||||
- `docs/specs/compiler/15. Bytecode and PBX Mapping Specification.md`
|
||||
- `prometeu-compiler/prometeu-build-pipeline/src/main/java/p/studio/compiler/backend/bytecode/...`
|
||||
- runtime/PVM em repositorio ou modulo relacionado, quando presente
|
||||
|
||||
## Alteracoes propostas
|
||||
|
||||
Opcao A: auditoria documental e de codigo para nomes PBS indevidos em runtime/bytecode.
|
||||
|
||||
Opcao B: corrigir imediatamente apenas identificacao `PBS` vs `PBX` se houver bug confirmado e isolado.
|
||||
|
||||
Recomendacao inicial: auditar primeiro; corrigir somente caso a fronteira esteja claramente violada e a mudanca seja pequena.
|
||||
|
||||
## Estrategia de implementacao
|
||||
|
||||
Buscar termos PBS no runtime, bytecode e specs VM; classificar ocorrencias validas de docs historicas vs erros de contrato.
|
||||
|
||||
## Testes necessarios
|
||||
|
||||
- Teste de magic/header PBX.
|
||||
- Teste arquitetural impedindo imports PBS no runtime/PVM.
|
||||
- Teste de carregamento/verificacao de programa sem dependencia de linguagem.
|
||||
|
||||
## Criterios de aceitacao
|
||||
|
||||
- PVM nao depende de conceitos PBS.
|
||||
- Formato executavel e tratado como PBX.
|
||||
- Qualquer correcao runtime necessaria fica separada de refactors Studio/compiler.
|
||||
|
||||
## Riscos
|
||||
|
||||
- Confundir nomenclatura documental antiga com acoplamento real.
|
||||
- Expandir escopo para VM quando o problema pertence ao compiler.
|
||||
|
||||
## Decisoes que devem ser registradas
|
||||
|
||||
- Lista de conceitos permitidos na PVM.
|
||||
- Politica de nomenclatura PBX/PBS.
|
||||
- Onde ficam testes de neutralidade runtime.
|
||||
|
||||
Reference in New Issue
Block a user