prometeu-runtime/docs/runtime/decisions

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