discussion framework migration
This commit is contained in:
@@ -1,47 +0,0 @@
|
||||
# Runtime Decisions
|
||||
|
||||
Este diretório reúne decision records do runtime.
|
||||
|
||||
Objetivo:
|
||||
|
||||
- registrar decisoes arquiteturais ja tomadas;
|
||||
- servir como referencia normativa para agendas derivadas;
|
||||
- evitar reabrir discussoes que ja foram fechadas.
|
||||
|
||||
Regra de uso:
|
||||
|
||||
- agendas existem para discutir e fechar ambiguidade;
|
||||
- decision records existem para registrar o que foi decidido;
|
||||
- quando uma agenda for resolvida, ela deve sair de `agendas/` e virar decision record aqui.
|
||||
|
||||
Decisoes ativas:
|
||||
|
||||
Nenhuma no momento.
|
||||
|
||||
Decisoes implementadas e aposentadas (migradas para `learn/`):
|
||||
|
||||
- `historical-vm-core-and-assets.md`
|
||||
- decisions: `003`, `006`, `007`, `011`, `012`
|
||||
- rationales: VM-owned stateful core, byte transfer protocol, FS fault policy, assets.pa contract and ID-based preload.
|
||||
- `historical-gfx-status-first-fault-and-return-contract.md`
|
||||
- spec: `../specs/04-gfx-peripheral.md`
|
||||
- impl: `crates/console/prometeu-system/src/virtual_machine_runtime/dispatch.rs`, `crates/console/prometeu-hal/src/syscalls/domains/gfx.rs`
|
||||
- `historical-audio-status-first-fault-and-return-contract.md`
|
||||
- spec: `../specs/05-audio-peripheral.md`
|
||||
- impl: `crates/console/prometeu-system/src/virtual_machine_runtime/dispatch.rs`, `crates/console/prometeu-hal/src/syscalls/domains/audio.rs`, `crates/console/prometeu-hal/src/audio_bridge.rs`, `crates/console/prometeu-drivers/src/audio.rs`
|
||||
- `historical-asset-status-first-fault-and-return-contract.md`
|
||||
- spec: `../specs/15-asset-management.md`
|
||||
- impl: `crates/console/prometeu-system/src/virtual_machine_runtime/dispatch.rs`, `crates/console/prometeu-hal/src/syscalls/domains/asset.rs`, `crates/console/prometeu-hal/src/asset_bridge.rs`, `crates/console/prometeu-drivers/src/asset.rs`
|
||||
- `historical-game-memcard-slots-surface-and-semantics.md`
|
||||
- spec: `../specs/08-save-memory-and-memcard.md`, `../specs/16-host-abi-and-syscalls.md`, `../specs/16a-syscall-policies.md`
|
||||
- impl: `crates/console/prometeu-system/src/services/memcard.rs`, `crates/console/prometeu-system/src/virtual_machine_runtime/dispatch.rs`, `crates/console/prometeu-hal/src/syscalls/domains/fs.rs`
|
||||
|
||||
Decisoes aposentadas que ja viraram spec:
|
||||
|
||||
- `004-host-fault-taxonomy.md` -> `../specs/16a-syscall-policies.md`
|
||||
- `005-v1-vm-owned-input-intrinsics-and-language-agnostic-surface.md` -> `../specs/06-input-peripheral.md`, `../specs/16-host-abi-and-syscalls.md`, `../specs/16a-syscall-policies.md`
|
||||
- `013-asset-codec-none-vs-raw.md` -> `../specs/15-asset-management.md`, `../learn/mental-model-asset-management.md`, `crates/console/prometeu-drivers/src/asset.rs`, `crates/console/prometeu-hal/src/asset.rs`
|
||||
|
||||
Racional historico (nao normativo):
|
||||
|
||||
- `../learn/historical-retired-fault-and-input-decisions.md`
|
||||
@@ -1,47 +0,0 @@
|
||||
# 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
|
||||
|
||||
Nenhuma PR em aberto no momento.
|
||||
|
||||
## 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.
|
||||
Reference in New Issue
Block a user