housekeeping agenda 025

This commit is contained in:
bQUARKz 2026-03-23 00:00:40 +00:00
parent 0ff4909079
commit 6fc0bf129c
Signed by: bquarkz
SSH Key Fingerprint: SHA256:Z7dgqoglWwoK6j6u4QC87OveEq74WOhFN+gitsxtkf8
7 changed files with 32 additions and 16 deletions

View File

@ -24,8 +24,11 @@ As agendas atuais são:
- `020-perf-host-debug-overlay-isolation.md`
- `021-perf-vm-allocation-and-copy-pressure.md`
- `022-perf-cartridge-boot-and-program-ownership.md`
- `025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md`
- `024-asset-entry-metadata-normalization-contract.md`
Agendas encerradas recentemente:
- `025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md` -> `../decisions/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md`
## Sequenciamento Recomendado [PERF]
Ordem sugerida para discussao das agendas de performance:

View File

@ -1,8 +1,11 @@
# 025-cartridge-manifest-entrypoint-removal-and-runtime-protocol
Status: Accepted
Status: Implemented
Date: 2026-03-22
Origin: [`../agendas/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md`](../agendas/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md)
Implementation:
- spec propagation: [`../pull-requests/025-spec-cartridge-entrypoint-removal-and-boot-protocol.md`](../pull-requests/025-spec-cartridge-entrypoint-removal-and-boot-protocol.md), commit `e2f0904`
- runtime propagation: [`../pull-requests/026-runtime-cartridge-entrypoint-removal-and-boot-protocol-propagation.md`](../pull-requests/026-runtime-cartridge-entrypoint-removal-and-boot-protocol-propagation.md), commit `a30ac16`
## Contexto
@ -91,8 +94,11 @@ Com o boot fixado no proprio artefato compilado, `manifest.json` volta a ser met
## Propagacao Necessaria
- abrir `PR/plan` derivada desta decision separando:
- propagacao editorial em spec;
- propagacao de codigo em loader, system, VM e tooling auxiliar;
- atualizar `spec 13` antes ou em paralelo ao codigo para evitar contrato dividido;
- apos publicacao de spec e codigo, consolidar o modelo final em `learn` se esta decisao se somar a outras de cartridge/boot.
Concluida neste ciclo:
- PR `025` publicou o contrato normativo sem `entrypoint` e com boot em `func_id = 0`;
- PR `026` removeu `entrypoint` de loader/system/VM e ajustou testes e stress tooling local.
Follow-up residual:
- consolidar este modelo em `learn` se ele for agrupado com outras decisoes de cartridge/boot.

View File

@ -16,9 +16,14 @@ Regra de uso:
Decisoes ativas:
Nenhuma no momento.
Decisoes implementadas:
- `025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md`
- origem: `../agendas/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md`
- foco: remover `entrypoint` do contrato do cartucho e endurecer o boot em `func_id = 0`.
- execucao: PR `025` + PR `026`
Decisoes implementadas e aposentadas (migradas para `learn/`):

View File

@ -1,5 +1,9 @@
# 025-spec-cartridge-entrypoint-removal-and-boot-protocol
Status: Completed
Decision: [`../decisions/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md`](../decisions/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md)
Commit: `e2f0904`
## Briefing
Propagar a [`decision 025`](../decisions/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md) para o contrato normativo de cartridge, removendo `entrypoint` de `manifest.json` e publicando boot fixo em `func_id = 0`.
@ -54,4 +58,3 @@ Atualizar as specs que ainda descrevem `entrypoint` como parte do contrato do ca
- remover `entrypoint` da spec sem linguagem normativa suficientemente explicita sobre `func_id = 0` pode deixar lacuna contratual;
- editar apenas `spec 13` e esquecer referencias em firmware/boot pode preservar ambiguidade documental;
- misturar guidance transitoria de tooling com texto normativo de runtime pode enfraquecer o contrato final.

View File

@ -1,5 +1,9 @@
# 026-runtime-cartridge-entrypoint-removal-and-boot-protocol-propagation
Status: Completed
Decision: [`../decisions/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md`](../decisions/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md)
Commit: `a30ac16`
## Briefing
Executar a propagacao de codigo da [`decision 025`](../decisions/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md) no runtime, removendo `entrypoint` do loader e do estado de cartridge, endurecendo o boot da VM em `func_id = 0` e ajustando testes e tooling local necessario para manter o stress path funcional.
@ -61,4 +65,3 @@ Propagar o protocolo de boot fixo em `func_id = 0` para `prometeu-hal`, `promete
- mudar `VirtualMachine::initialize(...)` sem revisar o caminho de `tick()` pode deixar boot sem prepare inicial coerente;
- deixar `prepare_call()` parcialmente textual sem delimitar seu papel pode gerar confusao futuras, embora isso nao bloqueie esta PR;
- tooling local que ainda grave `entrypoint` pode mascarar regressao se nao for atualizado no mesmo ciclo.

View File

@ -36,15 +36,12 @@ Uma PR deste diretório deve:
## Roadmap Atual
- `025-spec-cartridge-entrypoint-removal-and-boot-protocol.md`
- origem: `decision 025`
- foco: propagar o contrato normativo sem `entrypoint` e publicar boot em `func_id = 0`.
- `026-runtime-cartridge-entrypoint-removal-and-boot-protocol-propagation.md`
- origem: `decision 025`
- foco: remover `entrypoint` de loader/system/VM e ajustar testes e stress tooling local.
Nenhuma PR em aberto no momento.
## PRs Finalizadas
- `025-spec-cartridge-entrypoint-removal-and-boot-protocol.md`: concluída. Contrato normativo de cartridge publicado sem `entrypoint` e com boot em `func_id = 0`. Commit `e2f0904`.
- `026-runtime-cartridge-entrypoint-removal-and-boot-protocol-propagation.md`: concluída. Loader, system, VM e stress tooling local propagados para o protocolo fixo de boot. Commit `a30ac16`.
- `012-assets-preload-asset-id-propagation.md`: concluída. Propagação de ID-based preload concluída em specs e prometeu-hal.
- `013-tile-bank-runtime-contract-alignment.md`: concluída. Contrato normativo de `tile bank` v1 alinhado entre `specs/04` e `specs/15`.
- `014-tile-bank-loader-packed-nibbles-and-palette-boundary.md`: concluída. Loader/runtime atualizado para consumir payload serializado `4bpp` packed com `64` paletas por bank.

View File

@ -5,6 +5,5 @@
"title": "Stress Console",
"app_version": "0.1.0",
"app_mode": "Game",
"entrypoint": "main",
"capabilities": ["gfx", "log"]
}