prometeu-runtime/docs/runtime/decisions/README.md

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:

• 003-vm-owned-byte-transfer-protocol.md
• 006-vm-owned-stateful-core-contract.md
• 007-filesystem-fault-core-policy.md

Decisoes implementadas e aposentadas (migradas para learn/):

• 008-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
• 009-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
• 010-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
• 011-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

Racional historico (nao normativo):

• ../learn/retired-decisions-004-005-history.md