prometeu-runtime/docs/runtime/learn/portability-and-cross-platform.md

Portability and Cross-Platform Execution

Status: pedagogical Companion spec: ../specs/11-portability-and-cross-platform-execution.md

PROMETEU trata portabilidade como propriedade arquitetural da máquina, não como adaptação posterior.

Core Idea

O ponto principal é simples:

• a máquina define a semântica;
• o host realiza apresentação e integração física;
• o cartridge não negocia comportamento com o sistema operacional.

Isso evita a noção comum de que cada plataforma “tem sua versão” da lógica do jogo.

Why This Matters

Quando tempo, memória, input, áudio e gráficos são definidos pela máquina, ficam mais fáceis:

• replay determinístico;
• certification reproduzível;
• execução em desktop, mobile e hardware DIY;
• separação limpa entre semântica e adaptação.

Practical Separation

Uma forma útil de pensar é:

• cartridge carrega programa e assets;
• a VM/runtime executa a lógica;
• o host mostra pixels, entrega áudio e coleta input físico;
• o host não redefine as regras do jogo.

What Portability Does Not Mean

PROMETEU não promete:

• a mesma latência física;
• o mesmo consumo energético;
• o mesmo throughput bruto do host.

Ele promete consistência lógica. Isso é o que importa para a identidade da máquina.

Teaching Value

Esse modelo ajuda a ensinar:

• diferença entre lógica e apresentação;
• por que engines modernas frequentemente perdem determinismo;
• como projetar software portátil sem depender de sorte.