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

36 lines
1.3 KiB
Markdown

# 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.