53 lines
2.2 KiB
Markdown
53 lines
2.2 KiB
Markdown
# 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.
|