diff --git a/docs/runtime/agendas/README.md b/docs/runtime/agendas/README.md index b57a690c..c72f8fd7 100644 --- a/docs/runtime/agendas/README.md +++ b/docs/runtime/agendas/README.md @@ -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: diff --git a/docs/runtime/decisions/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md b/docs/runtime/decisions/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md index be66dbd0..ef28bac7 100644 --- a/docs/runtime/decisions/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md +++ b/docs/runtime/decisions/025-cartridge-manifest-entrypoint-removal-and-runtime-protocol.md @@ -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. diff --git a/docs/runtime/decisions/README.md b/docs/runtime/decisions/README.md index d2667672..3a45fe58 100644 --- a/docs/runtime/decisions/README.md +++ b/docs/runtime/decisions/README.md @@ -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/`): diff --git a/docs/runtime/pull-requests/025-spec-cartridge-entrypoint-removal-and-boot-protocol.md b/docs/runtime/pull-requests/025-spec-cartridge-entrypoint-removal-and-boot-protocol.md index 22ec4056..263dce2e 100644 --- a/docs/runtime/pull-requests/025-spec-cartridge-entrypoint-removal-and-boot-protocol.md +++ b/docs/runtime/pull-requests/025-spec-cartridge-entrypoint-removal-and-boot-protocol.md @@ -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. - diff --git a/docs/runtime/pull-requests/026-runtime-cartridge-entrypoint-removal-and-boot-protocol-propagation.md b/docs/runtime/pull-requests/026-runtime-cartridge-entrypoint-removal-and-boot-protocol-propagation.md index a4f0306b..b139f50e 100644 --- a/docs/runtime/pull-requests/026-runtime-cartridge-entrypoint-removal-and-boot-protocol-propagation.md +++ b/docs/runtime/pull-requests/026-runtime-cartridge-entrypoint-removal-and-boot-protocol-propagation.md @@ -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. - diff --git a/docs/runtime/pull-requests/README.md b/docs/runtime/pull-requests/README.md index b5a487b4..3e1b9697 100644 --- a/docs/runtime/pull-requests/README.md +++ b/docs/runtime/pull-requests/README.md @@ -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. diff --git a/test-cartridges/stress-console/manifest.json b/test-cartridges/stress-console/manifest.json index dbde1fc3..d3d34606 100644 --- a/test-cartridges/stress-console/manifest.json +++ b/test-cartridges/stress-console/manifest.json @@ -5,6 +5,5 @@ "title": "Stress Console", "app_version": "0.1.0", "app_mode": "Game", - "entrypoint": "main", "capabilities": ["gfx", "log"] }