improvements agendas and decisions

This commit is contained in:
2026-03-24 13:40:50 +00:00
parent 9f402de894
commit 38d551fe01
4 changed files with 113 additions and 72 deletions
@@ -1,62 +0,0 @@
# Agenda - Gfx Fault Semantics and Command Contract
## Problema
`gfx` parece dominio command-style com pouca necessidade de status, mas a politica concreta entre `Trap`, no-op deterministico e fallback ainda nao esta consolidada.
Exemplos atuais:
- `GfxSetSprite` usa fallback estavel quando asset nao e encontrado;
- indices fora da faixa podem virar no-op em vez de fault;
- argumentos ausentes ainda sobem como `Panic` por detalhe de helper.
## Dor
- a surface de `gfx` pode ficar inconsistente entre comandos;
- detalhes acidentais de implementacao podem ser confundidos com politica de dominio;
- `Panic` pode vazar para o app em casos que sao apenas erro de comando ou comando ignoravel.
## Hotspots Atuais
- [dispatch.rs](/Users/niltonconstantino/personal/workspace.personal/intrepid/prometeu/runtime/crates/console/prometeu-system/src/virtual_machine_runtime/dispatch.rs#L178)
- [dispatch.rs](/Users/niltonconstantino/personal/workspace.personal/intrepid/prometeu/runtime/crates/console/prometeu-system/src/virtual_machine_runtime/dispatch.rs#L213)
- [dispatch.rs](/Users/niltonconstantino/personal/workspace.personal/intrepid/prometeu/runtime/crates/console/prometeu-system/src/virtual_machine_runtime/dispatch.rs#L227)
## Alvo da Discussao
Fixar a politica de fault de `gfx` como dominio de comando.
## O Que Precisa Ser Definido
1. Erros estruturais.
Confirmar o que continua `Trap`:
- tipo invalido;
- aridade invalida;
- capability ausente.
2. Parametros fora da faixa.
Decidir por comando:
- clamp;
- no-op;
- `Trap`.
3. Asset/sprite name ausente em `set_sprite`.
Decidir se fallback atual vira contrato oficial.
4. Indices fora da faixa.
Decidir se sprite index invalido e no-op ou `Trap`.
5. Panic cleanup.
Remover `Panic` acidental por argumento ausente/helper onde isso nao representa falha estrutural do runtime.
## Dependencias
- `../specs/16a-syscall-policies.md`
## Critério de Saida Desta Agenda
Pode virar PR quando houver decisao escrita sobre:
- matriz de `Trap`/no-op/fallback para `gfx`;
- politica de `set_sprite`;
- reducao de `Panic` acidental no dominio.
+8 -10
View File
@@ -10,7 +10,6 @@ Objetivo:
As agendas atuais são:
- `004-gfx-fault-semantics-and-command-contract.md`
- `005-audio-fault-semantics-and-surface.md`
- `006-asset-fault-semantics-and-surface.md`
- `007-runtime-edge-test-plan.md`
@@ -28,13 +27,12 @@ Ordem sugerida para discussão e futura execução:
1. `012-vm-owned-random-service.md`
2. `013-game-memcard-slots-surface-and-semantics.md`
3. `014-app-home-filesystem-surface-and-semantics.md`
4. `004-gfx-fault-semantics-and-command-contract.md`
5. `005-audio-fault-semantics-and-surface.md`
6. `006-asset-fault-semantics-and-surface.md`
7. `007-runtime-edge-test-plan.md`
8. `008-packed-cartridge-loader-pmc.md`
9. `009-system-run-cart.md`
10. `010-system-fault-semantics-and-control-surface.md`
4. `005-audio-fault-semantics-and-surface.md`
5. `006-asset-fault-semantics-and-surface.md`
6. `007-runtime-edge-test-plan.md`
7. `008-packed-cartridge-loader-pmc.md`
8. `009-system-run-cart.md`
9. `010-system-fault-semantics-and-control-surface.md`
Justificativa curta:
@@ -43,7 +41,8 @@ Justificativa curta:
- `013` fecha o contrato de memcard para jogos (`32 x 32KB`, ownership, identidade e copia fora do jogo).
- `014` fecha o contrato de `home` para apps sem abrir FS global.
- a decisao `007` fixa o nucleo de fault policy de `fs`; os detalhes ficam distribuidos em `013` e `014`.
- `004`, `005` e `006` consolidam fault semantics por dominio com base em `16a`.
- a decisao `008` fixa o contrato status-first de `gfx`.
- `005` e `006` consolidam fault semantics por dominio com base em `16a`.
- a agenda `007` vem depois para transformar as decisoes em cobertura de regressao na borda do runtime.
- `008` e importante, mas nao bloqueia bytecode/backend agora.
- `009` e `010` ficam no fim porque `run_cart` nao e objetivo do ciclo atual.
@@ -53,7 +52,6 @@ Dependências principais:
- `012` depende da decisao `006` e de `16`/`16a`
- `013` depende das decisoes `003`/`007`, de `16a`, de `08` (memcard), de `12` (Hub/OS) e de `13` (`app_mode`)
- `014` depende das decisoes `003`/`007`, de `16a`, de `12` (Hub/OS) e de `13` (`app_mode`)
- `004` depende de `16a`
- `005` depende de `16a`
- `006` depende de `16a`
- `007` depende da estabilizacao minima das agendas de superficie/fault por dominio