prometeu-studio/docs/compiler/pbs/pull-requests/INDEX.md

PBS Frontend PR Sequence

Este indice organiza uma sequencia de PRs atomicas para levar frontends/pbs ao contrato das specs.

1. PR-001-pbs-lexer-core-syntax-alignment.md
2. PR-002-pbs-ast-contract-v1.md
3. PR-003-pbs-parser-declarations-and-types.md
4. PR-004-pbs-parser-statements-and-control-flow.md
5. PR-005-pbs-parser-expressions-optional-result-apply.md
6. PR-006-pbs-barrel-and-module-visibility.md
7. PR-006.2-pbs-parser-ast-syntax-hardening.md
8. PR-006.3-pbs-syntax-completeness-and-module-hygiene.md
9. PR-007-pbs-static-semantics-declaration-validation.md
10. PR-008-pbs-static-semantics-call-resolution-and-flow.md
11. PR-009-pbs-diagnostics-contract-v1.md
12. PR-010-pbs-irbackend-lowering-contract.md
13. PR-011-pbs-gate-u-conformance-fixtures.md

Cada documento e auto contido e inclui: Briefing, Target, Method, Acceptance Criteria e Tests.

Non-Conformance Remediation PRs

14. PR-012-pbs-byte-offset-spans.md
15. PR-013-pbs-import-unresolved-diagnostics.md
16. PR-014-pbs-switch-wildcard-rules.md
17. PR-015-pbs-this-self-context-validation.md
18. PR-016-pbs-assignment-target-and-field-access-semantics.md
19. PR-017-pbs-const-evaluation-and-dependency-rules.md
20. PR-018-pbs-result-flow-ok-err-handle-rules.md
21. PR-019-pbs-non-unit-fallthrough-diagnostics.md
22. PR-020-pbs-lowering-admission-gates.md
23. PR-021-pbs-handle-aware-fallthrough-completion.md
24. PR-022-pbs-source-kind-and-module-origin-pipeline.md
25. PR-023-pbs-stdlib-environment-resolver-and-loader.md
26. PR-024-pbs-parser-ast-interface-module-mode.md
27. PR-025-pbs-interface-module-semantics-and-linking.md
28. PR-026-pbs-sdk-minimal-core-color-and-gfx.md
29. PR-027-pbs-builtin-metadata-extraction-and-ir-lowering-admission.md
30. PR-028-pbs-gate-u-sdk-interface-module-fixtures.md
31. PR-029-pbs-builtin-slot-inference-and-layout-semantics.md
32. PR-030-pbs-host-admission-capability-gating.md
33. PR-031-pbs-dependency-scoped-fail-fast-admission.md

Backend VM Pipeline PR Sequence (Agenda 18)

Esta sequencia organiza implementacao atomica para IRBackend -> IRVM -> OptimizeIRVM -> EmitBytecode, com trilha de montagem do output para o input (bytecode ate IRBackend).

34. PR-032-backend-bytecode-module-serializer-baseline.md
35. PR-033-backend-bytecode-function-layout-and-debug-minimum.md
36. PR-034-backend-emitter-hostcall-sysc-contract.md
37. PR-035-backend-emit-stage-pipeline-wiring.md
38. PR-036-backend-irvm-core-model-and-validator.md
39. PR-037-backend-optimize-irvm-noop-stage-and-guards.md
40. PR-038-irbackend-v2-executable-contract-model.md
41. PR-039-pbs-frontend-irbackend-v2-lowering.md
42. PR-040-backend-lower-to-irvm-stage-implementation.md
43. PR-041-backend-gate-i-runtime-compat-integration-fixtures.md

JVM-Grade Remediation Waves (Execution Plan)

Esta trilha organiza as PRs por ondas para execucao incremental com rollback simples por item.

Onda O1 - Conformance and Correctness Hardening

1. PR-O1.1-backend-diagnostics-taxonomy-and-attribution.md
2. PR-O1.2-irbackend-executable-contract-hardening.md
3. PR-O1.3-pbs-executable-lowering-fidelity.md
4. PR-O1.4-lower-to-irvm-callsite-prechecks.md
5. PR-O1.5-bytecode-debug-minimum-completeness.md
6. PR-O1.6-gate-su-safety-matrix-completion.md

Onda O2 - JVM-Inspired Verification and Linking Boundaries

1. PR-O2.1-bytecode-link-precheck-stage.md
2. PR-O2.2-bytecode-preload-verifier.md
3. PR-O2.3-optimize-irvm-pass-manager-and-equivalence.md
4. PR-O2.4-gate-i-runtime-backed-compat-harness.md

Onda O3 - Evolution and Scale

1. PR-O3.1-irvm-control-flow-lowering-label-resolution.md
2. PR-O3.2-bytecode-constpool-symbol-interning-determinism.md
3. PR-O3.3-irvm-profile-evolution-and-feature-gates.md

Onda O4 - JVM-Grade Uplift

1. PR-O4.1-callable-signature-identity-and-dense-symbol-table.md
2. PR-O4.2-global-intrinsic-table-and-reindexing.md
3. PR-O4.3-semantic-lowering-cfg-and-stack-analysis.md
4. PR-O4.4-irvm-program-single-source-of-truth.md
5. PR-O4.5-vm-profile-end-to-end-pipeline.md
6. PR-O4.6-strict-bytecode-precheck-unknown-opcode-rejection.md
7. PR-O4.7-gate-i-runtime-backed-execution-adapter.md
8. PR-O4.8-jvm-grade-regression-matrix-and-golden-artifacts.md

Onda O5.0 - Dense Table Identity Foundation (Pre-O5)

1. PR-05.0.1-frontend-phase-shared-name-table-context.md
2. PR-05.0.2-module-identity-dense-table-and-moduleid-wiring.md
3. PR-05.0.3-irbackend-typed-callable-and-intrinsic-ids.md
4. PR-05.0.4-callable-shape-and-signature-interning.md
5. PR-05.0.5-synthetic-stdlib-fileid-via-filetable.md
6. PR-05.0.6-host-binding-key-interning-and-capability-identity.md

Onda O5 - JVM-Grade Score Evolution (5.6 -> 8.5+)

Prerequisito de execucao: concluir a Onda O5.0.

1. PR-05.1-pbs-frontend-semantic-executable-lowering-cfg.md
2. PR-05.2-irbackend-callsite-classification-by-semantic-identity.md
3. PR-05.3-irvm-deterministic-function-id-and-entrypoint-policy.md
4. PR-05.4-irvm-program-coherence-without-bypass.md
5. PR-05.5-irvm-validator-real-stack-effects-hostcall-intrinsic.md
6. PR-05.6-optimize-irvm-real-deterministic-passes.md
7. PR-05.7-gate-i-runtime-backed-mandatory-in-ci.md
8. PR-05.8-backend-spec-to-test-conformance-matrix.md

Onda O6 - JVM-Grade Score Evolution (8.0 -> 9.0+)

Foco: fechar partial/deferred relevantes da matriz normativa e endurecer evidencia de conformidade.

1. PR-06.1-source-attribution-and-diagnostics-evidence-hardening.md
2. PR-06.2-optimize-irvm-semantic-equivalence-harness.md
3. PR-06.3-irvm-ext-contract-and-elimination-fixtures.md
4. PR-06.4-gate-i-runtime-line-repeatability-ci.md
5. PR-06.5-conformance-matrix-hard-gate-policy.md
6. PR-06.6-spawn-yield-v1-or-claim-rescope.md

Onda O7 - Partial Closure Before IDE Focus

Foco: eliminar os dois partial remanescentes na matriz backend antes de mover foco principal para IDE.

1. PR-07.1-optimize-irvm-span-source-hook-preservation.md
2. PR-07.2-pbs-callsite-category-no-textual-heuristics-regression.md
3. PR-07.3-irvm-entrypoint-export-emission-for-runtime-loader.md

Onda O8 - Canonical Identity and Dense Addressing Hardening

Foco: fechar lacunas estruturais em identidade canonica de intrinsic/modulo/entrypoint e remover riscos de ambiguidade no handoff FE->BE.

1. PR-08.1-intrinsic-resolution-canonical-identity-keying.md
2. PR-08.2-irbackend-moduleid-contract-and-modulepool.md
3. PR-08.3-qualified-entrypoint-identity-contract.md
4. PR-08.4-call-func-callee-module-identity-correctness.md
5. PR-08.5-intrinsic-registry-single-source-sync-with-runtime.md

Onda O9 - ModuleId-Only Contract Cutover

Foco: remover definitivamente moduleKey textual do contrato estrutural FE->BE, endurecer entrypoint qualificado e alinhar specs/matriz com o modelo ModuleId-only.

1. PR-09.1-irbackend-modulekey-hard-removal-from-contract.md
2. PR-09.2-pbs-frontend-moduleid-only-lowering-and-import-surfaces.md
3. PR-09.3-lower-to-irvm-moduleid-only-ordering-and-strict-qualified-entrypoint.md
4. PR-09.4-specs-refresh-moduleid-only-entrypointref-and-bytecode-alignment.md
5. PR-09.5-hard-gates-no-modulekey-regression-and-migration-cleanup.md
6. PR-09.6-isa-intrinsic-registry-single-source-artifact.md
7. PR-09.7-compiler-normalization-to-isa-registry-artifact.md

Onda O10 - Parser Maintainability Refactor (No Functional Change)

Foco: reduzir complexidade estrutural de PbsParser sem alterar gramatica, AST, spans ou contrato de diagnosticos observavel.

1. PR-10.1-pbs-parser-shared-context-and-safe-delegation.md
2. PR-10.2-pbs-parser-attribute-and-type-subparsers.md
3. PR-10.3-pbs-parser-top-level-declaration-decomposition.md
4. PR-10.4-pbs-parser-block-and-statement-decomposition.md
5. PR-10.5-pbs-parser-recovery-utilities-and-regression-hardening.md

Onda O11 - Expression Parser Maintainability Refactor (No Functional Change)

Foco: reduzir complexidade estrutural de PbsExprParser sem alterar precedence, AST, spans, recovery ou diagnosticos observaveis.

1. PR-11.1-pbs-expr-parser-shared-context-and-precedence-spine.md
2. PR-11.2-pbs-expr-parser-control-flow-subparsers.md
3. PR-11.3-pbs-expr-parser-postfix-primary-and-construction-decomposition.md
4. PR-11.4-pbs-expr-parser-literals-patterns-and-shared-token-utilities.md
5. PR-11.5-pbs-expr-parser-regression-hardening-and-final-cleanup.md

Onda O12 - Flow Expression Analyzer Maintainability Refactor (No Functional Change)

Foco: reduzir complexidade estrutural de PbsFlowExpressionAnalyzer sem alterar inferencia, diagnosticos, matching de tipos ou comportamento observavel da analise semantica.

1. PR-12.1-flow-expression-analyzer-context-and-dispatch-foundation.md
2. PR-12.2-flow-expression-analyzer-literal-and-structural-expression-splitting.md
3. PR-12.3-flow-expression-analyzer-call-and-member-resolution-decomposition.md
4. PR-12.4-flow-expression-analyzer-switch-and-handle-decomposition.md
5. PR-12.5-flow-expression-analyzer-regression-hardening-and-final-cleanup.md

Onda O13 - Flow Body Analyzer Maintainability Refactor (No Functional Change)

Foco: reduzir complexidade estrutural de PbsFlowBodyAnalyzer sem alterar regras de flow, completion, assignment checking ou diagnosticos observaveis.

1. PR-13.1-flow-body-analyzer-context-and-entrypoint-foundation.md
2. PR-13.2-flow-body-analyzer-callable-body-and-completion-decomposition.md
3. PR-13.3-flow-body-analyzer-statement-analysis-splitting.md
4. PR-13.4-flow-body-analyzer-assignment-target-resolution-decomposition.md
5. PR-13.5-flow-body-analyzer-regression-hardening-and-final-cleanup.md