Files
prometeu-runtime/discussion/workflow/agendas/AGD-0005-vm-owned-random-service.md
T
bquarkz e0c08c8b00
Intrepid/Prometeu/Runtime/pipeline/pr-master This commit looks good
Intrepid/Prometeu/Runtime/pipeline/head This commit looks good
add headless automation
2026-09-22 13:28:31 +01:00

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

  1. Surface minima do servico. Fechar operacoes como:

    • new(seed) -> rng_ref;
    • next(rng_ref) -> int;
    • destroy(rng_ref).
  2. Determinismo e replay. Definir:

    • seed explicita obrigatoria;
    • regra de reproducao frame a frame;
    • comportamento esperado em replay.
  3. Lifecycle e validade. Definir:

    • como lidar com rng_ref invalido/stale;
    • relacao com GC;
    • destruicao explicita vs cleanup por GC.
  4. Fault/status do dominio. Definir:

    • quais erros sao status;
    • quais casos viram Trap;
    • inexistencia de Panic operacional.
  5. Metadados e versionamento. Definir IDs/version das operacoes de random para garantir mapeamento 1:1 FE/backend/runtime.

Open Questions de Arquitetura

  1. O caminho determinístico aceita só seed explícita. Entropia de host, se um dia existir, é modo separado e fica fora da timeline automatizada?
  2. next retorna apenas int ou precisamos variantes (u32, float) no mesmo ciclo?
  3. precisamos de clone/split de gerador no MVP?
  4. destruicao explicita deve ser obrigatoria para certificacao/custo ou opcional?
  5. O primeiro oráculo de AGD-0052 pode 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.md cita 006-vm-owned-stateful-core-contract.md
  • docs/vm-arch/ISA_CORE.md
  • docs/specs/runtime/16-host-abi-and-syscalls.md
  • docs/specs/runtime/16a-syscall-policies.md
  • AGD-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 por AGD-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.