4.3 KiB
id, ticket, title, status, created, resolved, decision, tags
| id | ticket | title | status | created | resolved | decision | tags |
|---|---|---|---|---|---|---|---|
| AGD-0005 | vm-owned-random-service | Agenda - VM-Owned Random Service | open | 2026-03-27 |
Agenda - VM-Owned Random Service
Problema
Precisamos de random como primeiro consumidor stateful VM-owned, mas sem fechar um contrato minimo o dominio pode nascer incoerente e nao deterministico.
Alvo da Discussao
Fechar o perfil minimo de random VM-owned em cima do core definido na decisao 006.
O Que Precisa Ser Definido
-
Surface minima do servico. Fechar operacoes como:
new(seed) -> rng_ref;next(rng_ref) -> int;destroy(rng_ref).
-
Determinismo e replay. Definir:
- seed explicita obrigatoria;
- regra de reproducao frame a frame;
- comportamento esperado em replay.
-
Lifecycle e validade. Definir:
- como lidar com
rng_refinvalido/stale; - relacao com GC;
- destruicao explicita vs cleanup por GC.
- como lidar com
-
Fault/status do dominio. Definir:
- quais erros sao
status; - quais casos viram
Trap; - inexistencia de
Panicoperacional.
- quais erros sao
-
Metadados e versionamento. Definir IDs/version das operacoes de random para garantir mapeamento 1:1 FE/backend/runtime.
Open Questions de Arquitetura
- O caminho determinístico aceita só seed explícita. Entropia de host, se um dia existir, é modo separado e fica fora da timeline automatizada?
nextretorna apenasintou precisamos variantes (u32,float) no mesmo ciclo?- precisamos de clone/split de gerador no MVP?
- destruicao explicita deve ser obrigatoria para certificacao/custo ou opcional?
- O primeiro oráculo de
AGD-0052pode provar determinismo com cartucho que não chama random, e qualquer cartucho que chame random espera o fechamento desta agenda?
Dependencias
- contexto histórico, já aposentado como decisão viva:
discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0008-historical-vm-core-and-assets.mdcita006-vm-owned-stateful-core-contract.md docs/vm-arch/ISA_CORE.mddocs/specs/runtime/16-host-abi-and-syscalls.mddocs/specs/runtime/16a-syscall-policies.mdAGD-0052/DSC-0049, como consumidor do contrato determinístico
Não há arquivo vivo em discussion/workflow/decisions/ para a decisão 006. Esta agenda não trata esse texto como contrato atual.
Fora de Escopo
- entropia não determinística como contrato base;
- PRNGs múltiplos no mesmo ciclo de fechamento;
- APIs de coleções stateful;
- window/app model;
- formato persistente de replay. Esta agenda define reprodução em memória: seed explícita mais sequência de
next. Arquivo, versão e timeline de input ficam para a agenda de replay citada porAGD-0052.
Criterio de Saida Desta Agenda
Pode virar decision quando houver definição escrita sobre:
- surface mínima de random VM-owned;
- contrato de determinismo: seed explícita, ausência de entropia implícita de host, reprodução da sequência;
- fault/status de random;
- IDs/versionamento e validações de verifier para as operações do domínio;
- o que um host automatizado precisa fixar (seeds iniciais) para que duas execuções coincidam.
Revalidação — 2026-09-22
Revalidada contra o código atual e contra AGD-0052. A agenda permanece aberta. Não existe serviço de random na VM. O scheduler declara ausência de randomness. prometeu-test-support oferece StdRng semeado para testes Rust; isso não é random de convidado.
Efeito da direção headless
AGD-0052 diz que random VM-owned usado em execução automatizada obedece ao contrato desta agenda, e que entropia implícita do host não entra no caminho determinístico. Isso reforça a pergunta 1 na direção de seed explícita como único modo determinístico.
O primeiro teste end-to-end headless pode usar um cartucho que não chama random. Esse teste prova input, frame e fault. Ele não prova random. Cartucho cujo resultado depende de random só serve como oráculo depois que esta agenda fechar seeds, sequência e faults.
Relógio de parede em telemetria (host_cpu_time_us, timestamp de certificação) não é fonte de random e não entra neste contrato.
Replay em arquivo continua fora daqui e fora do primeiro ciclo headless. O que esta agenda precisa deixar pronto é a reprodução em memória da sequência a partir das seeds.