implements PLN-0128
Intrepid/Prometeu/Studio/pipeline/pr-master Build started...
JaCoCo Coverage #### Project Overview
No changes detected, that affect the code coverage.
* Line Coverage: 62.10% (17811/28682)
* Branch Coverage: 52.81% (6878/13025)
* Lines of Code: 28682
* Cyclomatic Complexity: 11494
#### Quality Gates Summary
Output truncated.
Test / Build skipped: 15, passed: 653
Intrepid/Prometeu/Studio/pipeline/head This commit looks good
Intrepid/Prometeu/Studio/pipeline/pr-master Build started...
JaCoCo Coverage #### Project Overview
No changes detected, that affect the code coverage.
* Line Coverage: 62.10% (17811/28682)
* Branch Coverage: 52.81% (6878/13025)
* Lines of Code: 28682
* Cyclomatic Complexity: 11494
#### Quality Gates Summary
Output truncated.
Test / Build skipped: 15, passed: 653
Intrepid/Prometeu/Studio/pipeline/head This commit looks good
Add a test-only synth FrontendProvider that traverses compile() to verified bytecode without PBS. Expose register/unregister on the static registry and lock the obligation in specs 23 and 22. Housekeep DSC-0063 with LSN-0065.
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
{"type":"meta","next_id":{"DSC":66,"AGD":69,"DEC":49,"PLN":128,"LSN":65,"CLSN":1}}
|
||||
{"type":"meta","next_id":{"DSC":66,"AGD":69,"DEC":50,"PLN":129,"LSN":66,"CLSN":1}}
|
||||
{"type":"discussion","id":"DSC-0065","status":"open","ticket":"multi-frontend-avoid-premature-abstractions","title":"Evitar abstracoes prematuras na preparacao multi-frontend","created_at":"2026-07-15","updated_at":"2026-07-15","tags":["compiler","compiler-general","studio","frontend","architecture","multi-frontend","simplicity"],"agendas":[{"id":"AGD-0068","file":"AGD-0068-multi-frontend-avoid-premature-abstractions.md","status":"open","created_at":"2026-07-15","updated_at":"2026-07-15"}],"decisions":[],"plans":[],"lessons":[]}
|
||||
{"type":"discussion","id":"DSC-0064","status":"open","ticket":"multi-frontend-architectural-tests","title":"Testes arquiteturais para fronteiras multi-frontend","created_at":"2026-07-15","updated_at":"2026-07-15","tags":["compiler","compiler-general","studio","frontend","architecture","tests","multi-frontend"],"agendas":[{"id":"AGD-0067","file":"AGD-0067-multi-frontend-architectural-tests.md","status":"open","created_at":"2026-07-15","updated_at":"2026-07-15"}],"decisions":[],"plans":[],"lessons":[]}
|
||||
{"type":"discussion","id":"DSC-0063","status":"open","ticket":"multi-frontend-synthetic-test-frontend","title":"Frontend sintetico de teste para provar neutralidade do pipeline","created_at":"2026-07-15","updated_at":"2026-07-15","tags":["compiler","compiler-general","frontend","tests","backend","multi-frontend"],"agendas":[{"id":"AGD-0066","file":"AGD-0066-multi-frontend-synthetic-test-frontend.md","status":"open","created_at":"2026-07-15","updated_at":"2026-07-15"}],"decisions":[],"plans":[],"lessons":[]}
|
||||
{"type":"discussion","id":"DSC-0063","status":"done","ticket":"multi-frontend-synthetic-test-frontend","title":"Frontend sintetico de teste para provar neutralidade do pipeline","created_at":"2026-07-15","updated_at":"2026-09-19","tags":["compiler","compiler-general","frontend","tests","backend","multi-frontend"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0065","file":"discussion/lessons/DSC-0063-multi-frontend-synthetic-test-frontend/LSN-0065-synthetic-test-frontend-proves-pipeline-neutrality.md","status":"done","created_at":"2026-09-19","updated_at":"2026-09-19"}]}
|
||||
{"type":"discussion","id":"DSC-0062","status":"done","ticket":"multi-frontend-pvm-neutrality","title":"Neutralidade da PVM e identificacao PBX independente de PBS","created_at":"2026-07-15","updated_at":"2026-09-18","tags":["vm-arch","runtime","pvm","pbx","compiler","multi-frontend"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0061","file":"discussion/lessons/DSC-0062-multi-frontend-pvm-neutrality/LSN-0061-pbx-runtime-boundary.md","status":"done","created_at":"2026-09-18","updated_at":"2026-09-18"}]}
|
||||
{"type":"discussion","id":"DSC-0061","status":"done","ticket":"multi-frontend-sdk-canonical-definition","title":"Auditoria e centralizacao gradual da definicao canonica do SDK","created_at":"2026-07-15","updated_at":"2026-09-19","tags":["compiler","compiler-general","sdk","stdlib","hostcalls","intrinsics","multi-frontend"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0064","file":"discussion/lessons/DSC-0061-multi-frontend-sdk-canonical-definition/LSN-0064-runtime-owns-console-abi-pbs-is-delivery.md","status":"done","created_at":"2026-09-19","updated_at":"2026-09-19"}]}
|
||||
{"type":"discussion","id":"DSC-0060","status":"done","ticket":"multi-frontend-validation-boundaries","title":"Separar validacoes de linguagem e validacoes de plataforma","created_at":"2026-07-15","updated_at":"2026-09-19","tags":["compiler","compiler-general","compiler-pbs","backend","validation","multi-frontend"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0063","file":"discussion/lessons/DSC-0060-multi-frontend-validation-boundaries/LSN-0063-language-vs-platform-validation-ownership.md","status":"done","created_at":"2026-09-19","updated_at":"2026-09-19"}]}
|
||||
|
||||
+148
@@ -0,0 +1,148 @@
|
||||
---
|
||||
id: LSN-0065
|
||||
ticket: multi-frontend-synthetic-test-frontend
|
||||
title: Synthetic test frontend proves common pipeline neutrality
|
||||
created: 2026-09-19
|
||||
tags: [compiler, compiler-general, frontend, tests, backend, multi-frontend]
|
||||
---
|
||||
|
||||
# Synthetic test frontend proves common pipeline neutrality
|
||||
|
||||
## Original Problem
|
||||
|
||||
The common pipeline already had `FrontendProvider`, `IRBackend` as the
|
||||
executable handoff, common lifecycle assembly, and `IRBackend -> IRVM -> PBX`.
|
||||
Direct construction tests proved the backend could lower a handmade
|
||||
`IRBackend`. Import guards proved common backend code did not depend on PBS
|
||||
packages.
|
||||
|
||||
That was not enough. Nothing proved that a second provider, resolved by
|
||||
`languageId`, could enter through `DiscoverPhase` and
|
||||
`FrontendPhasePipelineStage`, assemble lifecycle, and finish
|
||||
`BuilderPipelineService.compile()` at verified bytecode without instantiating
|
||||
PBS, reading `.pbs` files, or loading PBS stdlib.
|
||||
|
||||
`CompileOnlyFrontendProvider` already existed as a local test double. It was
|
||||
not registered, returned an empty `IRBackend`, and never called the pipeline.
|
||||
It did not close this gap.
|
||||
|
||||
## Consolidated Decision
|
||||
|
||||
Pipeline neutrality is proved by a **test-only** compile-only
|
||||
`FrontendProvider`, not by a second product language and not by injecting IR
|
||||
into compile stages.
|
||||
|
||||
Locked shape (former Option A):
|
||||
|
||||
- `languageId` is `synth`.
|
||||
- The provider and `FrontendPhaseService` live only in
|
||||
`prometeu-build-pipeline` test sources.
|
||||
- `languageService()` is empty. There is no parser, grammar, semantic
|
||||
presentation, or stdlib catalog.
|
||||
- `sourceRoots` is `src`. `allowedExtensions` must not collide with `pbs` /
|
||||
`barrel`. The fixture must **not** create a source file of that extension.
|
||||
An empty `src/` directory must still exist because `WireProjectsPhase`
|
||||
resolves `toRealPath()`.
|
||||
- The compiler ignores source text and emits one module, one `frame` body
|
||||
that is a single `RET`, and an `IRLifecycleDeclaration` with exactly one
|
||||
`FRAME_ROOT` whose origin span is filled.
|
||||
- The handoff must not declare `FILE_INIT_FRAGMENT` or `PROJECT_INIT`, and
|
||||
must not pre-materialize wrappers, module-init, or `BOOT_GUARD`. The common
|
||||
assembler produces `__prometeu.lifecycle.frame_wrapper$mN` and the boot
|
||||
guard.
|
||||
- The IR must not contain host bindings, capabilities, intrinsics, PBS types,
|
||||
PBS stdlib, or `__pbs.` names.
|
||||
|
||||
The acceptance path is `compile()` through `VerifyBytecode`. Writing
|
||||
`program.pbx` is not the criterion. `build()` only adds disk I/O.
|
||||
|
||||
Registration stays on the existing static `FrontendRegistryService`.
|
||||
`register` and `unregister` are public. `unregister` refuses to remove the
|
||||
default PBS provider and is a no-op for unknown ids. Tests register `synth`
|
||||
for the duration of the run and unregister in `try/finally`.
|
||||
`bootstrapDefaults()`, `AppContainer`, and the Studio language catalog must
|
||||
not register `synth`.
|
||||
|
||||
Do not inject a `Registry` into the pipeline, add a `frontends/synth` module,
|
||||
scan the classpath, or treat a dummy on-disk extension as a language. Do not
|
||||
replace `LifecycleAssemblerServiceTest`, `LowerToIRVMServiceTest`, or
|
||||
`IRBackendExecutableContractTest` with this fixture.
|
||||
|
||||
A blank `prometeu.json` `language` field still defaults to PBS. The synthetic
|
||||
project must set `language: synth` explicitly.
|
||||
|
||||
## Final Implementation
|
||||
|
||||
`FrontendRegistryService.register(FrontendProvider)` is the explicit
|
||||
registration API. `unregister(String languageId)` removes a non-PBS provider
|
||||
or no-ops if the id is absent. Duplicate `register` still fails.
|
||||
`bootstrapDefaults()` still registers only PBS.
|
||||
|
||||
The test fixture is:
|
||||
|
||||
- `p.studio.compiler.synth.SyntheticFrontendProvider`
|
||||
- `p.studio.compiler.synth.SyntheticFrontendPhaseService`
|
||||
|
||||
`SyntheticFrontendPipelineTest` writes a temporary project
|
||||
(`language: synth`, `target: Game`, numeric `stdlib`, empty `src/`),
|
||||
registers the provider, calls `BuilderPipelineService.compile()`, and
|
||||
asserts:
|
||||
|
||||
- the synthetic compiler ran;
|
||||
- resolved `languageId` is `synth`, not `pbs`;
|
||||
- diagnostics have no errors;
|
||||
- in-memory bytecode is non-empty and verified;
|
||||
- assembled entrypoint is `__prometeu.lifecycle.frame_wrapper$m0`;
|
||||
- a hidden boot guard is present;
|
||||
- no `__pbs.` names;
|
||||
- no `.pbs` / `.barrel` sources were required;
|
||||
- after `unregister`, `listProviders()` is PBS-only.
|
||||
|
||||
Spec 23 section 8.3 records that a compile-only registered provider is a
|
||||
valid pipeline participant and that the common pipeline must not require PBS
|
||||
types, PBS sources, or PBS stdlib to emit verified bytecode. Spec 22 row
|
||||
`G23-8.3` binds that obligation to the synthetic pipeline test.
|
||||
|
||||
PBS production code, Studio, and `AppContainer` were not changed.
|
||||
|
||||
## Examples
|
||||
|
||||
Good:
|
||||
|
||||
- register `synth`, compile a temp project with empty `src/`, unregister;
|
||||
- `FRAME_ROOT` with `FileId(0)` and a non-none span, even with no source file
|
||||
in `FileTable`;
|
||||
- assert the synthetic compiler was invoked instead of importing
|
||||
`PBSFrontendPhaseService` from build-pipeline tests.
|
||||
|
||||
Bad:
|
||||
|
||||
- omitting `language` in the manifest so discovery silently uses PBS;
|
||||
- creating `main.dummy` and calling that a second frontend;
|
||||
- putting the provider under `prometeu-compiler/frontends/`;
|
||||
- leaving `synth` registered after the test so later tests see two providers;
|
||||
- using this pipeline test as a substitute for assembler or IRVM unit tests.
|
||||
|
||||
## Pitfalls
|
||||
|
||||
- `WireProjectsPhase` still needs `src/` on disk. Empty is not the same as
|
||||
missing.
|
||||
- Origin span `Span.none()` is rejected by the assembler. Use a real
|
||||
`FileId` even when no file was loaded.
|
||||
- `unregister("pbs")` must fail. A cleanup path that blindly unregisters the
|
||||
resolved language would delete the product default.
|
||||
- `listProviders()` feeds the Studio catalog. A leaked test registration
|
||||
would show `synth` as a new-project language.
|
||||
- Direct `IRBackend` construction tests still own backend-only proofs. The
|
||||
synthetic frontend owns the registry-plus-pipeline proof. Keep both.
|
||||
|
||||
## References
|
||||
|
||||
- Decision: `DEC-0049`
|
||||
- Plan: `PLN-0128`
|
||||
- Related lessons: `LSN-0055`, `LSN-0056`, `LSN-0059`, `LSN-0062`, `LSN-0061`
|
||||
- `docs/specs/compiler/23. Compiler Pipeline Entry Points Specification.md`
|
||||
- `docs/specs/compiler/22. Backend Spec-to-Test Conformance Matrix.md`
|
||||
- `prometeu-compiler/prometeu-frontend-registry/src/main/java/p/studio/compiler/FrontendRegistryService.java`
|
||||
- `prometeu-compiler/prometeu-build-pipeline/src/test/java/p/studio/compiler/synth/SyntheticFrontendProvider.java`
|
||||
- `prometeu-compiler/prometeu-build-pipeline/src/test/java/p/studio/compiler/integration/SyntheticFrontendPipelineTest.java`
|
||||
@@ -1,77 +0,0 @@
|
||||
---
|
||||
id: AGD-0066
|
||||
ticket: multi-frontend-synthetic-test-frontend
|
||||
title: Frontend sintetico de teste para provar neutralidade do pipeline
|
||||
status: open
|
||||
created: 2026-07-15
|
||||
resolved:
|
||||
decision:
|
||||
tags: [compiler, compiler-general, frontend, tests, backend, multi-frontend]
|
||||
---
|
||||
|
||||
# Agenda - Criar um frontend sintetico de teste
|
||||
|
||||
## Objetivo
|
||||
|
||||
Domain owner: `compiler/general`.
|
||||
|
||||
Discutir um frontend exclusivo de testes que prove que o pipeline comum nao depende implicitamente do PBS.
|
||||
|
||||
## Contexto atual
|
||||
|
||||
O criterio arquitetural final exige que um frontend sintetico implemente contratos equivalentes a `FrontendProvider`, `FrontendSpec` e `FrontendCompiler`, produza IR comum minima e passe pelo backend ate PBX/verifier.
|
||||
|
||||
## Escopo
|
||||
|
||||
- Escolher entre frontend totalmente sintetico ou extensao ficticia.
|
||||
- Definir fixture de IR minima com `frame` vazio.
|
||||
- Garantir isolamento em testes.
|
||||
|
||||
## Fora de escopo
|
||||
|
||||
- Expor frontend sintetico no Studio.
|
||||
- Criar segunda linguagem real.
|
||||
- Criar parser completo ou grammar dummy complexa.
|
||||
|
||||
## Arquivos e componentes a inspecionar
|
||||
|
||||
- `prometeu-compiler/prometeu-frontend-registry/...`
|
||||
- `prometeu-compiler/prometeu-build-pipeline/...`
|
||||
- testes do build pipeline e backend
|
||||
- `prometeu-studio/src/main/java/p/studio/projects/...` apenas se a selecao por extensao for exercitada
|
||||
|
||||
## Alteracoes propostas
|
||||
|
||||
Opcao A: provider sintetico que ignora arquivos e retorna IR minima diretamente.
|
||||
|
||||
Opcao B: extensao `.dummy` reconhecida em fixture, com conteudo ignorado ou trivial.
|
||||
|
||||
Recomendacao inicial: preferir Opcao A para provar neutralidade do pipeline sem criar outra superficie de linguagem.
|
||||
|
||||
## Estrategia de implementacao
|
||||
|
||||
Esperar provider/IR/lifecycle estarem suficientemente definidos, entao adicionar fixture de teste que registra provider sintetico e executa pipeline comum sem PBS.
|
||||
|
||||
## Testes necessarios
|
||||
|
||||
- Provider registrado e resolvido por `languageId`.
|
||||
- Extensao/source handling testado se a opcao B for escolhida.
|
||||
- IR comum produzida, lifecycle montado, IRVM gerado, PBX emitido e verificado.
|
||||
|
||||
## Criterios de aceitacao
|
||||
|
||||
- Teste falha se pipeline comum instanciar PBS implicitamente.
|
||||
- Synthetic frontend existe apenas em test fixtures.
|
||||
- PBS nao e afetado.
|
||||
|
||||
## Riscos
|
||||
|
||||
- Fixture sintetica exercitar caminho feliz pequeno demais e nao proteger acoplamentos reais.
|
||||
- Virar uma segunda linguagem informal.
|
||||
|
||||
## Decisoes que devem ser registradas
|
||||
|
||||
- Forma do frontend sintetico.
|
||||
- Escopo minimo da IR fixture.
|
||||
- Onde o provider de teste pode ser registrado.
|
||||
|
||||
Reference in New Issue
Block a user