diff --git a/.ai-engineering/works/.sequence.yaml b/.ai-engineering/works/.sequence.yaml index 7f7b116..4ebeb6e 100644 --- a/.ai-engineering/works/.sequence.yaml +++ b/.ai-engineering/works/.sequence.yaml @@ -1,3 +1,3 @@ --- -schemaVersion: 1 -lastWork: 1 +schemaVersion: 2 +lastWork: "0002" diff --git a/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/artifacts/evidence/ART-0001/artifact.yaml b/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/artifacts/evidence/ART-0001/artifact.yaml new file mode 100644 index 0000000..a0a643a --- /dev/null +++ b/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/artifacts/evidence/ART-0001/artifact.yaml @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "ART-0001" +workId: "WRK-0002" +origin: "zelda-center-evidence.zip" +purpose: "Programa recompilado e assets empacotados preservados;cinco capturas reais640x360\ + \ centralizadas192,60;bordas/margens/semfault/RAMsave;limite do empacotamento isolado\ + \ explicitado." +path: "artifacts/evidence/ART-0001/payload" +sha256: "56ba1c4beb8238a05404e4ca794f9fc14c8d27efe682c339a19bbcd54820130a" +size: 46066 +author: "Codex" +createdAt: "2026-11-20T11:46:23.318379Z" diff --git a/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/artifacts/evidence/ART-0001/payload b/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/artifacts/evidence/ART-0001/payload new file mode 100644 index 0000000..853df4f Binary files /dev/null and b/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/artifacts/evidence/ART-0001/payload differ diff --git a/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/discussions/DSC-0001.md b/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/discussions/DSC-0001.md new file mode 100644 index 0000000..51d9ced --- /dev/null +++ b/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/discussions/DSC-0001.md @@ -0,0 +1,31 @@ +--- +schemaVersion: 1 +id: "DSC-0001" +workId: "WRK-0002" +discussionId: "main" +kind: "CONCLUSION" +author: "Codex" +createdAt: "2026-11-20T11:46:23.769974Z" +respondsTo: null +documentVersion: 2 +--- + +# Centralização do Zelda 1 em 640×360 + +Pedido humano: ajustar somente a centralização do port. Modo DIRECT escolhido explicitamente nesta conversa. Registro exclusivo no AIE do Zelda, WRK-0002; o WRK-0001 de planejamento do próximo recorte permanece separado. + +Alteração de código: apenas SCREEN_W=640 e SCREEN_H=360 em src/scene/main.pbs. A área NES continua 256×240, escala1:1. VIEW_X/VIEW_Y passam a192/60; câmera, sprites, HUD, inventário e moldura já usam essas mesmas constantes. + +Validação executada: + +- Compilação atual via API pública Shipper.prepare, em cópia temporária de src/manifesto/assets. Bytecode produzido com sucesso. +- Limite do harness: o caminho de empacotamento isolado produziu asset_table vazia, mesmo após abrir ProjectSession; isso gerou imagens internas pretas e não foi aceito como validação do jogo. A causa não foi investigada e não deve ser atribuída à UI. +- Para validar somente a apresentação sem migrar assets, o cartucho temporário combinou o bytecode recém-compilado com manifest, assets.pa, asset_table, metadata e preload já existentes no build do jogo. A identidade/capabilities/app_id/memcard_slots dos manifestos coincidem; os recursos foram copiados sem modificar bytes. São30preloads existentes. +- Runtime atual640×360: inicialização, abertura, seleção de New Game, overworld, abertura/fechamento do inventário, retorno ao overworld. Cinco capturas com conteúdo real, sem fault. +- Cada captura exige640×360/stride640/RGBA8888, áreaNES256×240 em192/60, todos os1052pixels da borda externa e160768pixels externos com as cores esperadas; conteúdo com mais de duas cores. Abertura, overworld e inventário também inspecionados visualmente. +- A moldura externa fica em184/52, tamanho272×256, com8pixels de margem interna. Margens da imagem:192px nos lados e60px acima/abaixo. +- Boot em memory_fresh, sem montar/ler/gravar .studio/memcard.pmc. Encerramento da sessão de teste concluído. Nenhum save do usuário foi usado. + +Entrega incremental: atualizar apenas build/program.pbx com o bytecode validado; manter os recursos empacotados existentes. Fontes de gameplay, dados NES, assets, app_id e formato de save não foram alterados. Nenhuma fixture foi instalada em src/main.pbs. Sem commits ou push neste ajuste. + +Notas de apresentação/feedback atualizadas nos documentos do port. Resultado pronto para revisão humana; não registrar aceite de entrega por inferência. diff --git a/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/discussions/DSC-0002.md b/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/discussions/DSC-0002.md new file mode 100644 index 0000000..df7492a --- /dev/null +++ b/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/discussions/DSC-0002.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0002" +workId: "WRK-0002" +discussionId: "main" +kind: "NOTE" +author: "Codex" +createdAt: "2026-11-20T11:59:54.458715Z" +respondsTo: null +documentVersion: 2 +--- + +Autorização humana explícita após apresentação do resultado e das cinco capturas: "commit e push do zelda-1". Publicar o ajuste de centralização, as notas e as evidências no próprio repositório Zelda. Este registro atesta autorização de commit/push; não altera o planejamento do WRK-0001 nem inventa outro aceite. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/work.md b/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/work.md new file mode 100644 index 0000000..e6c1132 --- /dev/null +++ b/.ai-engineering/works/WRK-0002-centralizar-zelda-1-no-framebuffer-640x360/work.md @@ -0,0 +1,50 @@ +--- +schemaVersion: 1 +id: "WRK-0002" +title: "Centralizar Zelda 1 no framebuffer 640x360" +description: "Ajuste pontual solicitado pelo humano: somente centralizar o port no\ + \ novo target; atualizar SCREEN_W/SCREEN_H em src/scene/main.pbs, do qual câmera/sprites/HUD/moldura\ + \ já derivam VIEW_X/VIEW_Y. Validar build e captura atual, preservando gameplay\ + \ e cartão do usuário." +goal: "Manter a área NES 256x240 em escala1:1 centralizada em640x360, origem192,60." +motivation: "" +constraints: +- "Preservar256x240,escala1:1,assets,mecânicas,app_id e save; não retomar os recortes\ + \ pendentes do WRK-0001 nem fazer commits/push sem pedido específico." +acceptanceCriteria: +- "Código de apresentação usa640x360 e calculaVIEW_X192/VIEW_Y60 para imagemNES256x240." +- "Build/captura atuais conferidos e resultado registrado; cartão do usuário não usado\ + \ em escrita." +status: "OPEN" +createdAt: "2026-11-20T10:45:49.384818Z" +updatedAt: "2026-11-20T11:59:54.467987Z" +author: "Codex" +repositories: [] +discussions: +- "DSC-0001" +- "DSC-0002" +decisions: [] +artifacts: +- "ART-0001" +plans: [] +completions: [] +events: [] +archived: false +topics: [] +surveys: [] +dispositions: [] +agentRuns: [] +epic: false +guidance: + mode: "DIRECT" + approvalPolicy: "REQUIRED" + history: + - mode: "DIRECT" + approvalPolicy: "REQUIRED" + by: "Codex" + reason: "Escolha explícita do humano nesta conversa: DIRECT — ajustar e validar\ + \ a centralização (recomendado)." + at: "2026-11-20T10:45:49.376202Z" + humanApproved: true + decisionRequests: [] +--- diff --git a/docs/port-status.md b/docs/port-status.md index 6521cb5..af32cb4 100644 --- a/docs/port-status.md +++ b/docs/port-status.md @@ -54,7 +54,7 @@ Não reutilizar taskId da sessão encerrada nem reativar bombas de teste no iní | Área | Estado e comportamento disponível | Fontes principais | |---|---|---| | Assets NES | Extração de patterns, paletas, mapas e descritores utilizados no recorte; PNGs e dados rastreáveis à ROM local verificada. Não é certificação de extração de todo o conteúdo do jogo. | `tools/extract_graphics.py`, `tools/extract_start_room.py`, `tools/nes_object_graphics.py`, `assets/`, `extracted/` | -| Apresentação | Área NES de 256×240, escala 1:1, centralizada numa caixa; terreno, atores e HUD compostos separadamente. HUD na camada 2, atores na 1. | `src/scene`, `src/hud` | +| Apresentação | Área NES de 256×240, escala 1:1, centralizada em (192,60) no framebuffer 640×360; terreno, atores e HUD compostos separadamente. HUD na camada 2, atores na 1. | `src/scene`, `src/hud` | | Link: movimento | Quatro direções, animação, alinhamento à grade e movimento fracionário orientados pela ROM; escolha de direção conforme posição na grade, não uma prioridade vertical global inventada. | `src/link/movement.pbs`, `src/link/controller.pbs` | | Link: espada | Ataque direcional, animação e alcance; começa sem espada; coleta da primeira espada com pose de erguer o item. Graus de espada tratados nos dados/dano, sem todos os locais de aquisição. | `src/link/sword.pbs`, `src/link/render.pbs`, `src/inventory` | | Projétil de espada | Disparo condicionado à vida cheia, slot único e dispersão; colisão com os inimigos existentes. | `src/link/beam.pbs` | diff --git a/docs/prometeu-feedback.md b/docs/prometeu-feedback.md index 3d50ae9..51b1fe4 100644 --- a/docs/prometeu-feedback.md +++ b/docs/prometeu-feedback.md @@ -257,7 +257,7 @@ com localização no fonte e manter o LSP funcional mesmo quando o lowering falh **P2 · Lacuna na superfície de autoria consultada; solução local validada.** -O port mantém a área NES de 256×240 dentro do framebuffer 480×270. A referência +Na validação original, o port mantinha a área NES de 256×240 dentro do framebuffer 480×270. A referência `@sdk:composer` consultada expõe câmera, vínculo de cena e emissão de sprites, sem parâmetros de retângulo de viewport, clipping ou escala de apresentação. A especificação GFX documenta resolução base fixa e escala pelo host. @@ -276,6 +276,17 @@ Melhoria: oferecer uma configuração documentada para área lógica, encaixe 1: clipping e, futuramente, escala inteira no host. Preservar a imagem canônica do runtime e tornar explícita a diferença entre área de jogo e apresentação. +Atualização de 20/11/2026: a área NES está centralizada no framebuffer +640×360 em (192,60), preservando 256×240 e escala 1:1. Bastou atualizar as +duas constantes de tela em `src/scene/main.pbs`; câmera, HUD, sprites e moldura +já compartilhavam a origem. Cinco capturas atuais (abertura, menu inicial, +overworld, inventário e retorno) conferiram moldura e margens; três também +foram inspecionadas visualmente. O programa foi recompilado e validado com +os assets empacotados existentes, preservados byte a byte, e save em RAM. +O harness de build isolado gerou uma tabela de assets vazia: a causa não foi +investigada, e esse resultado não foi aceito como captura válida do jogo. +Isso delimita o caminho de validação; não é diagnóstico visual da UI. + ### ATR-13 Reset headless retornou sucesso, mas a sessão ficou terminada **P2 · Uma ocorrência observada; causa pendente.** diff --git a/src/scene/main.pbs b/src/scene/main.pbs index 9d56f0b..98db7ca 100644 --- a/src/scene/main.pbs +++ b/src/scene/main.pbs @@ -5,8 +5,8 @@ import { Gfx } from @sdk:gfx; import { Stage } from @zelda1:stage; // Presentation only: every NES pixel remains one Prometeu framebuffer pixel. -declare const SCREEN_W: int = 480; -declare const SCREEN_H: int = 270; +declare const SCREEN_W: int = 640; +declare const SCREEN_H: int = 360; declare const VIEW_W: int = 256; declare const VIEW_H: int = 240; declare const VIEW_X: int = (SCREEN_W - VIEW_W) / 2;