prometeu-studio/docs/pbs/pull-requests/PR-12.5-flow-expression-analyzer-regression-hardening-and-final-cleanup.md

PR-12.5 - Flow Expression Analyzer Regression Hardening and Final Cleanup

Briefing

As PRs anteriores reduzem a complexidade estrutural de PbsFlowExpressionAnalyzer. Esta PR fecha a trilha com consolidacao final, limpeza de duplicacao residual e endurecimento de regressao, sem alterar funcionalidade.

Motivation

Dor atual que esta PR resolve

1. Refactors estruturais em analise semantica podem preservar casos principais e ainda mudar detalhes finos de diagnostico.
2. Ao final da decomposicao, tendem a restar helpers redundantes ou caminhos duplicados.
3. O fechamento da trilha precisa garantir equivalencia observavel e uma fachada final pequena.

Target

Concluir a trilha de refactor:

1. limpeza estrutural final,
2. consolidacao dos helpers remanescentes,
3. cobertura de regressao para inferencia e diagnosticos.

Dependencies

Prerequisitos diretos:

1. PR-12.1
2. PR-12.2
3. PR-12.3
4. PR-12.4

Scope

1. Remover duplicacao residual apos as extracoes.
2. Garantir que PbsFlowExpressionAnalyzer fique reduzido a composicao/orquestracao.
3. Reforcar testes de regressao para call/member resolution, result flow, switch e handle.

Non-Goals

1. Nao alterar taxonomia de PbsSemanticsErrors.
2. Nao alterar TypeView, ExprResult ou PbsFlowTypeOps.
3. Nao introduzir novas regras semanticas.

Method

O que deve ser feito explicitamente

1. Fazer uma passada final de consolidacao.
2. Verificar equivalencia com foco em:
   • inferencia de tipos,
   • overload resolution,
   • access checks,
   • switch/handle exhaustiveness e matching,
   • diagnosticos emitidos.
3. Encerrar a trilha com uma fachada pequena e clara.

Acceptance Criteria

1. PbsFlowExpressionAnalyzer termina como orquestrador, nao como concentrador de toda a logica.
2. Nao ha mudanca funcional observavel em analise, tipos inferidos ou diagnosticos.
3. Suite do frontend PBS passa integralmente.

Tests

1. :prometeu-compiler:frontends:prometeu-frontend-pbs:test --tests *PbsSemanticsApplyResolutionTest*
2. :prometeu-compiler:frontends:prometeu-frontend-pbs:test --tests *PbsSemanticsResultFlowRulesTest*
3. :prometeu-compiler:frontends:prometeu-frontend-pbs:test --tests *PbsSemanticsOptionalResultTest*
4. :prometeu-compiler:frontends:prometeu-frontend-pbs:test --tests *PbsSemanticsControlFlowTest*
5. :prometeu-compiler:frontends:prometeu-frontend-pbs:test

Affected Documents

1. Nenhum documento normativo.

Open Questions

1. Nenhuma. A partir desta PR, qualquer mudanca adicional deve ser tratada como evolucao funcional separada.