discussion framework migration

This commit is contained in:
2026-03-27 04:42:38 +00:00
parent a27ad45f91
commit 21030f5c08
4 changed files with 3 additions and 369 deletions
-47
View File
@@ -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`
-47
View File
@@ -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.