prometeu-runtime/docs/runtime/pull-requests/README.md

Pull Requests

Este diretório armazena propostas de PRs arquiteturais e de implementação para o runtime.

Padrão

Toda PR neste diretório deve ser autocontida.

Cada documento deve incluir, no mínimo:

• Briefing
• Alvo
• Critérios de Aceite
• Tests, quando necessário

Barra de Qualidade

O padrão esperado é JVM-grade.

Isso implica:

• arquitetura vem antes de implementação;
• decisões arquiteturais não devem ser tomadas durante a fase de implementação;
• quando a implementação encontrar dúvida arquitetural, a PR deve voltar para discussão de arquitetura;
• diante de ambiguidade estrutural, é preferível interromper a execução da PR e levantar um questionamento severo do que cristalizar uma decisão errada no código.

Condução

Uma PR deste diretório deve:

• definir claramente o problema;
• delimitar o alvo da mudança;
• explicitar o que está fora de escopo quando houver risco de expansão;
• estabelecer critérios objetivos de aceite;
• definir a estratégia de teste proporcional ao risco da mudança.

Roadmap Atual

• 016-asset-codec-none-runtime-and-tests.md

PRs Finalizadas

• 012-assets-preload-asset-id-propagation.md: concluída. Propagação de ID-based preload concluída em specs e prometeu-hal.
• 013-tile-bank-runtime-contract-alignment.md: concluída. Contrato normativo de tile bank v1 alinhado entre specs/04 e specs/15.
• 014-tile-bank-loader-packed-nibbles-and-palette-boundary.md: concluída. Loader/runtime atualizado para consumir payload serializado 4bpp packed com 64 paletas por bank.
• 015-asset-codec-none-canonicalization-in-specs.md: concluída. NONE publicado como valor canonico de ausencia de codec adicional nas specs.