55 lines
3.0 KiB
Markdown
55 lines
3.0 KiB
Markdown
# 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:
|
|
|
|
- `025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md`
|
|
- origem: `../agendas/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md`
|
|
- foco: remover `entrypoint` do contrato do cartucho e endurecer o boot em `func_id = 0`.
|
|
- execucao: PR `025` + PR `026`
|
|
|
|
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`
|