prometeu-runtime/docs/runtime/learn/mental-model-time-and-cycles.md

Time Model and Cycles

Status: pedagogical Companion spec: ../specs/01-time-model-and-cycles.md

PROMETEU trata tempo como parte explícita da máquina.

Core Idea

Nada acontece “de graça” ou “instantaneamente”. O programador deve pensar em:

• ritmo da máquina;
• custo por frame;
• distribuição de trabalho ao longo do tempo;
• impacto arquitetural de quando cada sistema roda.

Why Cycles Instead of Milliseconds

Milissegundos variam com plataforma, jitter e hardware real. Cycles dão uma métrica de custo que pertence à máquina PROMETEU, não ao host.

Isso torna mais fácil comparar soluções, ensinar custo e raciocinar sobre performance sem esconder a conta atrás do sistema operacional.

Temporal Distribution As Design

Uma das intuições mais importantes em PROMETEU é: otimização não é só “fazer menos”, é decidir quando fazer.

Exemplos úteis:

• IA em 30 Hz;
• pathfinding em 15 Hz;
• timers dirigidos por frame count;
• separação entre atualização pesada e apresentação.

Why CAP Fits Here

O CAP reforça essa leitura de tempo como evidência técnica. Ele não existe para bloquear execução, e sim para tornar visíveis:

• picos;
• gargalos;
• distribuição de custo;
• decisões de arquitetura temporal.

Teaching Value

Esse modelo ajuda a ensinar:

• planejamento de execução;
• trade-offs técnicos;
• leitura de perfil real;
• organização temporal como ferramenta arquitetural.