prometeu-runtime/docs/runtime/pull-requests

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

• 025-spec-cartridge-entrypoint-removal-and-boot-protocol.md
  • origem: decision 025
  • foco: propagar o contrato normativo sem entrypoint e publicar boot em func_id = 0.
• 026-runtime-cartridge-entrypoint-removal-and-boot-protocol-propagation.md
  • origem: decision 025
  • foco: remover entrypoint de loader/system/VM e ajustar testes e stress tooling local.

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.
• 016-asset-codec-none-runtime-and-tests.md: concluída. Runtime e fixtures migrados para NONE, preservando RAW apenas como alias legado temporário.