prometeu-runtime/docs/runtime/agendas/011-input-frame-semantics-and-portability.md

Agenda 011 - Input Frame Semantics and Portability (Fechada no v1)

Status

Fechada para v1 pela decisao:

• ../decisions/005-v1-vm-owned-input-intrinsics-and-language-agnostic-surface.md

O Que Foi Fechado

1. A amostragem de input ocorre antes do frame logico.
2. O estado observado pelo guest fica congelado durante todo o frame.
3. Semantica de button:
   • pressed no frame de transicao up -> down
   • released no frame de transicao down -> up
   • down enquanto pressionado
   • hold contando frames pressionado
4. touch e single-point no perfil handheld v1, com coordenadas (x, y) e persistencia do ultimo estado no snapshot vigente.
5. pad e touch sao obrigatorios como elementos do contrato de plataforma.
6. Leitura de input nao participa de capability gate de syscall nem de scoring de certificacao por syscall.

Efeito Pratico

• O runtime deve expor input como leitura deterministica de snapshot VM-owned.
• O host deve fornecer os sinais necessarios para pad/touch a cada frame.

Risco Residual

• Nenhum bloqueador de bytecode v1 permanece nesta agenda.
• Edge cases de app model/window system ficam para agendas futuras (fora de input v1).

Follow-up

• Manter 06-input-peripheral.md e 07-touch-peripheral.md alinhadas com esta semantica.
• Cobrir no runtime testes de regressao para determinismo por frame.