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