prometeu-studio/docs/compiler/pbs/pull-requests/PR-19.9-pbs-conformance-fixtures-diagnostics-and-gate-closure.md

74 lines
2.2 KiB
Markdown

# PR-19.9 - PBS Conformance Fixtures, Diagnostics, and Gate Closure for Topic 19
## Briefing
Depois da propagacao normativa, da superficie parser/AST, da semantica e do lowering com wrapper, a familia `19` precisa de uma PR final de fechamento operacional:
1. consolidar fixtures,
2. endurecer diagnostics observaveis,
3. fechar gates de conformance,
4. e provar a linha end-to-end.
`learn` permanece fora desta PR e sera tratado depois, quando a implementacao ja estiver estavel.
## Target
Fechar a evidencia executavel e o gate de aceitacao da familia `19`.
## Dependencies
Prerequisitos diretos:
1. `PR-19.1`
2. `PR-19.4`
3. `PR-19.5`
4. `PR-19.6`
5. `PR-19.7`
6. `PR-19.8`
## Scope
1. Consolidar fixtures positivas da linha `19`.
2. Consolidar fixtures negativas de frontend/static semantics.
3. Consolidar fixtures negativas de lowering/structural validation.
4. Ligar a matrix/gates para evitar regressao.
5. Verificar integracao com runtime protocol ja alinhado.
## Non-Goals
1. Nao reabrir semantics ou lowering.
2. Nao alterar arquitetura.
3. Nao produzir ainda `learn`.
## Method
1. Seguir exatamente a matriz aceita em `Diagnostics, Manifest Propagation, and Conformance Coverage Decision.md`.
2. Preferir fixtures pequenas e isoladas por failure mode.
3. Tornar obrigatorios os checks estruturais da linha `19`.
## Acceptance Criteria
1. Existe fixture positiva cobrindo globals + file `[Init]` + project `[Init]` + `[Frame]`.
2. Existe cobertura negativa para os diagnostics obrigatorios da familia `19`.
3. Existe cobertura negativa para wrapper ausente, entrypoint fora de `0`, boot guard ausente e origin metadata ausente.
4. A linha de gates/conformance falha em regressao real desses contratos.
5. O resultado deixa a familia `19` pronta para `learn`.
## Tests
1. Suite de frontend semantics relevante para globals/lifecycle.
2. Suite de lowering/artifact relevante para wrapper/entrypoint.
3. Gate/spec-to-test/conformance harness aplicavel no repo.
4. Integracao compiler/runtime quando o harness local existir.
## Affected Artifacts
1. testes de frontend
2. testes de lowering
3. fixtures de artifact/conformance
4. gates CI/conformance relevantes
## Open Questions
1. Nenhuma. Esta PR e de fechamento e endurecimento.