# 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.