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

PROMETEU Runtime Specs

Este diretório reúne as specs da maquina PROMETEU no nível de sistema, hardware virtual, firmware, cartridge e ABI de host.

PROMETEU não é apenas a VM. A VM é um subsistema da fantasy handheld / fantasy console. As specs aqui descrevem a maquina maior e sua superfície técnica.

Princípios desta organização:

• estrutura plana;
• sem pasta topics/;
• sem navegação embutida Back / Next / Summary;
• nomes de arquivos semânticos;
• cada capítulo deve poder ser aberto isoladamente.

Arquivos atuais:

• 01-time-model-and-cycles.md
• 02-vm-instruction-set.md
• 02a-vm-values-and-calling-convention.md
• 02b-vm-function-values-and-closures.md
• 03-memory-stack-heap-and-allocation.md
• 04-gfx-peripheral.md
• 05-audio-peripheral.md
• 06-input-peripheral.md
• 07-touch-peripheral.md
• 08-save-memory-and-memcard.md
• 09-events-and-concurrency.md
• 09a-coroutines-and-cooperative-scheduling.md
• 10-debug-inspection-and-profiling.md
• 11-portability-and-cross-platform-execution.md
• 12-firmware-pos-and-prometeuhub.md
• 13-cartridge.md
• 14-boot-profiles.md
• 15-asset-management.md
• 16-host-abi-and-syscalls.md
• 16a-syscall-policies.md

Relação com outros docs:

• ../virtual-machine/ARCHITECTURE.md define as invariantes canônicas da VM/runtime.
• ../virtual-machine/ISA_CORE.md define a ISA no nível de bytecode.
• As specs deste diretório podem aprofundar o modelo da máquina, mas não devem contradizer as invariantes canônicas da VM/runtime quando tratarem dessa camada.

Critério para novos capítulos:

• o nome do arquivo deve comunicar o domínio;
• o capítulo deve ser legível sem depender de trilha de navegação;
• links internos devem ser usados apenas quando agregarem contexto real, não como mecanismo obrigatório de leitura sequencial.