clean up and update docs (agenda, decisions, PRs, learn and specs)
This commit is contained in:
@@ -1,26 +0,0 @@
|
||||
# Agenda 011 - VM-Owned Stateful Core (Fechada)
|
||||
|
||||
## Status
|
||||
|
||||
Fechada pela decisao:
|
||||
|
||||
- `../decisions/006-vm-owned-stateful-core-contract.md`
|
||||
|
||||
## O Que Foi Fechado
|
||||
|
||||
1. Modelo canonico com `HeapRef<TBuiltinState>` e regra anti-stale por generation.
|
||||
2. Lifecycle minimo (`create/read-update/destroy`) para servicos stateful.
|
||||
3. Manutencao do caminho `INTRINSIC <id_final>` sem tabela adicional.
|
||||
4. Metadata obrigatoria por operacao (`arg_slots`, `ret_slots`, efeito, determinismo, custo).
|
||||
5. Fronteira de fault (`status` operacional, `Trap` estrutural, `Panic` interno).
|
||||
6. Direcao de verifier/disasm/compatibilidade binaria para intrinsic stateful.
|
||||
|
||||
## Efeito Pratico
|
||||
|
||||
- Agenda `012` passa a consumir essa base para fechar random.
|
||||
- Implementacoes VM-owned stateful devem seguir a decisao `006` como contrato.
|
||||
|
||||
## Follow-up
|
||||
|
||||
- consolidar implementacao de identity/registry de intrinsic no frontend/backend/runtime;
|
||||
- fechar random em `012-vm-owned-random-service.md`.
|
||||
@@ -1,29 +0,0 @@
|
||||
# Agenda 024 - `assets.pa` Preload and Asset Table ID-based Contract (Fechada)
|
||||
|
||||
## Status
|
||||
|
||||
Fechada pela decisao:
|
||||
|
||||
- `../decisions/012-assets-preload-asset-id-contract.md`
|
||||
|
||||
## O Que Foi Fechado
|
||||
|
||||
1. `PreloadEntry` deixa de usar `asset_name` e passa a ser normativamente `{ asset_id, slot }`.
|
||||
2. `asset_id` passa a ser o identificador operacional de preload com semantica de `java int`.
|
||||
3. `asset_name` permanece apenas como metadata descritiva/debug e nao participa do preload.
|
||||
4. `preload` deve ser validado contra a `asset_table` do proprio `assets.pa` durante o bootstrap.
|
||||
5. `asset_id` ausente da `asset_table` e clash de slot por tipo caracterizam erro estrutural de formacao do cart.
|
||||
6. Nao existe compatibilidade normativa para preload legado por `asset_name`.
|
||||
|
||||
## Efeito Pratico
|
||||
|
||||
- `spec 15` passa a precisar explicitar o shape normativo de `PreloadEntry` e a validacao estrutural de preload.
|
||||
- loader, parser de `assets.pa` e `AssetManager` passam a consumir preload por `asset_id`.
|
||||
- a modelagem atual em codigo baseada em `u32` para `asset_id` precisa ser revisitada onde o contrato exposto ainda assume unsigned.
|
||||
|
||||
## Follow-up
|
||||
|
||||
- propagar a decisao em `specs 13/15`;
|
||||
- criar suporte de parse/validacao estrutural para preload por `asset_id`;
|
||||
- remover o preload por `asset_name` do runtime e dos testes;
|
||||
- manter `asset.load(name, kind, slot)` inalterado ate decisao futura sobre a superficie VM-facing.
|
||||
Reference in New Issue
Block a user