# Inventário do port e ponto de retomada **Pausado por pedido do usuário em 09/11/2026, após concluir o percurso oeste até a loja de bombas da $44.** Este documento registra o estado do port de Zelda 1 NES para Prometeu. O inventário original da pausa foi feito nos fontes e relatórios salvos. Na retomada, o Zora foi implementado e validado em novos builds e sessões headless; as evidências desse recorte estão em `extracted/zora`. O recorte atual permite iniciar uma partida sem espada, entrar na caverna, coletar a espada, explorar 13 telas do overworld e quatro cavernas, comprar nas lojas da $66 e $44, enfrentar Octoroks/Zora, obter drops, usar bombas, abrir o inventário, morrer/continuar e salvar/carregar um perfil no memcard. Ainda não permite completar o jogo. ## Ponto de pausa atual — 09/11/2026 O usuário pediu para parar por enquanto. Não há implementação em andamento. Última entrega: percurso oeste e loja da $44, descritos em [west-route.md](west-route.md). Estado jogável: **13 telas do overworld e quatro interiores**, duas lojas, combate com Octoroks/Zora, bombas, inventário e save/load. A lista aceita de quatro recortes foi concluída. - Último build/pack aprovado: `9a71c3be-7b87-4533-bfc0-cbfd36e30108`. - Fixtures removidas; `src/main.pbs` e Game restaurados. Studio em modo manual, sem sessão headless mantida pelo agente. Cartão do usuário preservado. - Smoke final: New Game, coleta/pose da espada, Continue com cartão descartável em leitura somente, quitação de débito, bomba 8→7 e inventário aberto/fechado. - Build e testes runtime passaram. LSP teve falhas intermitentes em três fontes; não registrar essas consultas como diagnostics vazios. Evidência e demais atritos em [prometeu-feedback.md](prometeu-feedback.md). - **Próximo recorte sugerido, ainda não iniciado nem escolhido pelo usuário:** uso da vela e um segredo queimável real, conferindo primeiro as regras e o local na ROM. Depois, considerar percurso rumo à primeira dungeon. - Vela azul já pode ser comprada, mas não produz fogo. Flechas já podem ser compradas, mas o uso de arco/flechas está pendente. Dungeons ainda pendentes. Ao retomar, ler este bloco, AGENTS.md e os documentos do recorte; conferir mudanças locais e obter o controle do Studio antes de editar/testar pelo agente. Não reutilizar taskId da sessão encerrada nem reativar bombas de teste no início. ## Como interpretar o inventário - **Portado no recorte:** implementado para as telas e os atores existentes; não significa que todo o sistema original esteja coberto. - **Parcial:** existe estrutura ou comportamento, mas falta conteúdo, integração ou parte das regras para representar o sistema completo. - **Pendente:** não há implementação jogável identificada no estado atual. - Assets extraídos, tabelas e ícones disponíveis não equivalem a gameplay portado. ## O que já foi portado | Á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` | | 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` | | Defesa e dano | Bloqueio frontal das pedras com escudo, ricochete, contato com inimigos/fogo, imunidade temporária e recuo. | `src/enemies/octorok/rock.pbs`, `src/link/vitals.pbs` | | Vida | Corações e fração nativa, capacidade, dano, cura, itens de vida e continuação com três corações; efeitos dos graus de anel nos cálculos/paleta. Aquisição de todos esses equipamentos pelo mapa ainda pendente. | `src/inventory/life.pbs`, `src/link/vitals.pbs` | | Bombas | Seleção no slot B, consumo, colocação, fusível, explosão e efeitos, limites de slots e dano aos inimigos existentes. Não acrescentar dano ao próprio Link por suposição. | `src/link/bomb.pbs`, `src/link/main.pbs` | | Paredes bombáveis | Mecanismo reutilizável: detonação, limiar nativo, flag persistente, cobertura visual, colisão e entrada coordenadas. Integrado ao segredo real da $67; outros locais continuam pendentes. | `src/world/bombable_wall.pbs`, `src/stages/overworld_start` | | Stages e colisões | Uma stage por tela, dados nativos e sondas compartilhadas de jogador/monstros. Transições horizontais/verticais e entrada/saída da caverna. | `src/stages`, `src/stage` | | Zora | Ator $11, bola de fogo $55, surgimento em água, estados nativos, vulnerabilidade, morte/drop e regra do escudo mágico; integrado à $65. | `src/enemies/zora`, [zora.md](zora.md) | | Octoroks | Tipos $07/$08/$09: vermelho lento, vermelho rápido e azul lento; animações, movimento, pedras, HP, reação a golpes, morte e drops. Pool de cinco atores atende às salas atuais. | `src/enemies/octorok` | | Nascimento de inimigos | Nuvens nas salas correspondentes e entrada pelas bordas nas quatro salas novas; cursor, timer, distância de segurança e ordem de slots orientados pela ROM. | `src/enemies/octorok/edge.pbs`, `src/overworld` | | Persistência entre visitas | Flags nativas do overworld, contagem de mortes registrada na saída e histórico de seis salas; respawn depende dessas regras, não é simplesmente proibido ao trocar de tela. | `src/world` | | Drops | Tabelas/grupos nativos, contadores de ajuda, bombas, rupias, corações e fada; tempo de vida, coleta por contato/espada e voo da fada. | `src/loot`, `src/combat_graphics` | | Inventário: dados | Bloco Items de 40 slots, classes/graus, contadores, fila de rupias e seleção B separada; flags de coletas não se confundem com posse. | `src/inventory`, `src/world` | | Inventário: tela | Abre/fecha com rolagem, pausa gameplay, mostra conteúdo e seleciona item B; HUD e fundo acompanham a sala ativa. | `src/screens/inventory` | | Caverna da espada | Entrada/saída, primeira aquisição, texto, velho, fogo e desaparecimento após a coleta. Objetos e letras agora são sprites sobre terreno fixo, inclusive durante a rolagem do inventário. | `src/stages/cave_start` | | Abertura e fluxo | Tela de título com brilho/cachoeira, New Game/Continue, abertura da área de jogo, morte, Game Over, Continue/Save/Retry e retorno ao título. | `src/game`, `src/screens/title`, `src/screens/continue_menu` | | Save/load | Um perfil no memcard, commit assíncrono, validação de payload, mensagens de erro/modo memória, restauração de Items e flags OW. Validado também manualmente pelo usuário. | `src/save`, `src/screens/save`, [save.md](save.md) | ## Conteúdo de mapa disponível São **13 telas do overworld e quatro cavernas jogáveis**. Os IDs internos não são os IDs nativos: preservar o mapeamento do catálogo. | Stage | Sala NES | Módulo em `src/stages` | Observação | |---|---|---|---| | 0 | $77 | `overworld_start` | Tela inicial; entrada da espada aberta; testes temporários desativados. | | 1 | Caverna ligada a $77 | `cave_start` | Espada coletável, velho/texto/fogo; terreno único com objetos separados. | | 2 | $67 | `overworld_north` | Octoroks e parede bombável que leva ao prêmio de 30 rupias. | | 3 | $66 | `overworld_northwest` | Rota oeste e entrada aberta da loja. | | 4 | $65 | `overworld_northwest_2` | Octoroks e Zora da flag nativa. | | 5 | $64 | `overworld_bomb_field` | Rota de obtenção de bombas por drops; não há garantia por morte. | | 6 | $57 | `overworld_north_upper` | Terreno, colisão e Octoroks pelas bordas; interiores/segredos pendentes. | | 7 | $58 | `overworld_northeast_upper` | Terreno, colisão e Octoroks pelas bordas; interiores/segredos pendentes. | | 8 | $68 | `overworld_east` | Terreno, colisão e Octoroks pelas bordas; interiores/segredos pendentes. | | 9 | $78 | `overworld_start_east` | Terreno, colisão e Octoroks pelas bordas; interiores/segredos pendentes. | | 10 | Caverna ligada a $67 | `cave_secret` | Moblin $7B, prêmio único de 30 rupias; retorno à sala norte. | | 11 | Caverna ligada a $66 | `cave_shop` | Loja $78: escudo mágico, chave e vela azul. | | 12 | $56 | `overworld_west_1` | Octoroks e Zora; segredo secundário pendente. | | 13 | $55 | `overworld_west_2` | Um Octorok e Zora. | | 14 | $54 | `overworld_west_3` | Octoroks, Zora e ligação ao campo de bombas. | | 15 | $44 | `overworld_shop_west` | Octoroks e entrada aberta da loja. | | 16 | Caverna ligada a $44 | `cave_supply_shop` | Loja $77: escudo mágico, quatro bombas e flechas. | Conexões implementadas, todas reversíveis: ```text $44 │ $54 ── $55 ── $56 ── $57 ── $58 │ │ │ $64 ── $65 ── $66 ── $67 ── $68 │ │ $77 ── $78 │ caverna da espada ``` No diagrama, a ligação caverna/$77 representa entrada/saída, não adjacência geográfica ao sul. Não há conexão direta $67→$57: a borda é sólida. As 15 conexões de overworld correspondem a 30 transições direcionadas. Catálogo: `tools/overworld_manifest.json`; detalhes em [overworld.md](overworld.md). ## O que está parcial ou ainda falta | Área | Pendência | |---|---| | Overworld completo | Restante das 128 posições de tela do mapa, conectividade, atributos, encontros e conteúdo específico; não abrir bordas sem portar o destino. | | Zora | Primeiro encontro da $65 implementado; ampliar regressões ao adicionar salas, armas e interações futuras. Ver [zora.md](zora.md). | Outros inimigos | Demais famílias do overworld e dungeons, com descritores, comportamento, dano, drops e regras de spawn próprios. | | Cavernas e NPCs | Outras cavernas/lojas além das quatro atuais; demais pagamentos, jogos e diálogos específicos. Entradas/segredos secundários das salas de expansão ainda estão pendentes. | | Texto e abertura | Revelação progressiva de diálogos e lógica de texto mais completa; história/demo automáticas do título ainda pendentes. A mensagem da espada aparece inteira. | | Segredos reais | Primeira parede/caverna da $67 integrada; ampliar aos outros locais da ROM; implementar árvores queimáveis, pedras/blocos movíveis e demais gatilhos nativos. Os demais locais e tipos de segredo ainda não estão integrados. | | Uso dos itens B | Bombas funcionam; há caminho de consumo/cura de poção no código, sem aquisição normal integrada neste recorte. Bumerangue, arco/flechas, vela, apito, comida, vara e demais usos ainda precisam de gameplay. Seleção/ícones/dados não bastam. | | Equipamentos e travessia | Locais e requisitos de espadas superiores, anéis, escudos/upgrades, escada, jangada e demais equipamentos; completar seus efeitos específicos e acesso ao mapa. | | Progressão | Aquisições e economia além do circuito atual, recipientes de coração no mapa, progressão de chaves, itens únicos e requisitos de acesso. | | Dungeons | Entradas, salas, portas/chaves, bloqueios, empurrar blocos, escadas/passagens, mapas/bússolas, itens e persistência de estado própria. Nenhuma dungeon jogável identificada. | | Chefes e Triforce | Chefes, fragmentos, progressão de dungeons, Ganon, resgate e encerramento. | | Perfis e segunda quest | Nome/seleção de três perfis, contador de mortes, segunda quest e suas diferenças de conteúdo. Save atual tem um perfil. | | Save futuro | Evoluir o schema quando existirem flags de dungeons, novos metadados e segunda quest; prever migração. Não mudar app_id para isso. | | Áudio | Música e efeitos ainda fora da primeira wave, conforme escopo combinado. | | Fidelidade integral | Expandir regressões por sistema/sala. Os oráculos atuais executam rotinas 6502 delimitadas; não existe validação lockstep do jogo inteiro. | ## Limites e decisões a preservar 1. **Fidelidade de comportamento e imagem à ROM**, com organização adequada ao Prometeu. Não é necessário reproduzir a organização gráfica interna do NES. 2. **Terreno fixo + elementos mutáveis separados.** NPCs, texto, itens e coberturas de paredes bombáveis devem ser sprites/glyphs independentes. Render, colisão e entrada de um segredo usam a mesma flag persistente. Referência: [scene-composition.md](scene-composition.md). 3. **Sem retorno dos testes temporários:** `ENABLE_TEMPORARY_BOMB` e `ENABLE_BOMBABLE_SWORD_TEST` estão false. Não recolocar pacote de bombas na tela inicial nem fechar a entrada da espada sem pedido explícito. 4. **Viewport 1:1 e módulos por responsabilidade:** Link em `src/link`, stage por tela, apresentação em `src/scene`, inventário/vida em `src/inventory`. 5. **Limite atual de 16 slots de scene:** slots 2/3 da caverna estão reservados para compatibilidade de IDs; gameplay usa scene 1 fixa. Atlas de salas, transições e inventário ficam em 13/14/15. Não adicionar slot 16 sem rever a organização/capacidade. O inventário mantém 16 faixas de composição. 6. **Save v1:** 180 bytes, header 12 + Items 40 + flags OW 128; `app_id=2137977836`, um slot/perfil. Histórico de visitas, posição, inimigos, projéteis, drops e timers não são salvos. Carregar retorna ao início com três corações e capacidade preservada; limpa Items[$15]. 7. **Proteger o cartão do usuário:** `.studio/memcard.pmc`; testes em imagens separadas ou memória. New Game não apaga imediatamente o save; Save explícito substitui o único perfil. Não tratar MEMORY ONLY como GAME SAVED. 8. **Fontes e documentação PBS:** consultar referências do Studio antes de recorrer a Java. Manter [prometeu-feedback.md](prometeu-feedback.md) com evidência concreta; escolhas do port não devem virar defeitos do runtime. ## Validação já registrada | Recorte | Evidência preservada | |---|---| | Expansão do overworld | 16.524 sondas de colisão nativas, 192 buscas de entrada pelas bordas, 18 transições direcionadas e 45 comparações visuais exatas. Relatórios em `extracted/overworld/expansion/`. | | Caverna com objetos separados | Dez comparações visuais exatas, 2.573 sondas nativas; coleta, flag, posse, piscadas, timer, pausa e revisita. `extracted/cave/start/composition-validation/`. | | Save | Payloads, checksum, reopen, leitura somente, modo memória, dados inválidos e fluxo de UI; evidências em `extracted/save/`, com detalhes em [save.md](save.md). Teste manual aprovado pelo usuário. | | Demais sistemas | Fixtures e validadores de Link, vida, inventário, combate, drops, bombas, paredes, gráficos, HUD e fluxo em `tools/`; relatórios/capturas em `extracted/`. Não assumir que todos os scripts antigos foram reexecutados após cada mudança. | Build de produção anterior à retomada: `5e713d48-8d9c-480d-9d35-a9aa112751a8`, após a refatoração da caverna. Diagnostics vazios nas cinco fontes consultadas naquela entrega. Teste por input normal: New Game → caverna → coleta/pose da espada → desaparecimento do velho → inventário. A entrada atual `src/main.pbs` chama Game.boot/Game.frame e MemcardBoot; não contém a fixture. O Studio foi devolvido ao modo manual na última entrega. Na pausa não houve alteração de gameplay; na retomada foi acrescentado o Zora. ## Retomada sugerida 1. Ler este inventário e `AGENTS.md`; conferir mudanças feitas durante a pausa. 2. Obter controle pelo Studio quando autorizado, compilar fontes salvas e conferir diagnostics. O build histórico acima não substitui essa checagem. 3. Ao retomar um novo recorte, fazer um smoke com cartão de teste: iniciar sem espada, coletar na caverna, abrir/fechar inventário, sair, combater um Octorok, salvar e carregar. 4. **Lista aceita na retomada:** Zora da $65 → segredo bombável real → loja → expansão de um percurso com objetivo. O Zora é o primeiro recorte; os seguintes são concluídos por recorte, com evidências abaixo. 5. Ao adicionar conteúdo, extrair da ROM mapa, atributos, lista de inimigos, entradas e flags; atualizar o catálogo e reutilizar os atlas existentes. 6. Regenerar caverna com `tools/prepare_cave.py` quando necessário e finalizar a recomposição compartilhada com `tools/prepare_overworld.py`. Consultar os documentos específicos antes de regenerar outros bancos. 7. Executar verificações apropriadas ao recorte; usar fixtures isoladas e restaurar main/barrels/fontes auxiliares antes do build final de produção. 8. Atualizar este inventário e o feedback com o que mudou e os limites restantes. A pausa anterior foi encerrada pelo usuário e a lista aceita foi executada. O ponto de pausa atual está no início deste documento. ## Retomada: primeiro recorte concluído — Zora A lacuna da $65 foi fechada: ciclo e disparo, arte, vulnerabilidade, dano/morte/drop, bloqueio por escudo mágico e reinício por visita. Duas sequências foram comparadas no guest com 388 ticks de UpdateZora da ROM; o cálculo angular teve 1.369 pares conferidos. Sete comparações de assets e doze de composição runtime foram exatas. Asserts de integração cobrem água, lotação, submersão, bomba, morte sem reaparição na visita, nova visita, relógio e escudos. O encontro com Octoroks, abertura/fechamento do inventário e saída para a sala vizinha foi exercitado com Game.frame e uma entrada de teste isolada. As nove salas mantiveram as 16.524 sondas nativas de colisão aprovadas. A entrada de produção foi restaurada. Não foram reativados os testes temporários de bombas, adicionados slots de scene ou alterados app_id/schema do save. Lista restante: **segredo bombável real → loja → expansão de percurso com objetivo**. Build final do recorte Zora: `dee2921c-11fd-4b45-9287-f24a3f87e9f0`. Compilação/pack aprovados e diagnostics vazios nas seis fontes centrais consultadas. Boot e New Game revalidados sem fixtures, em memory_fresh. ## Segundo recorte concluído — segredo bombável real Sala $67: parede nativa em (112,80), entrada (112,77), caverna Moblin $7B com prêmio único de 30 rupias. Stage própria cave_secret (10); terrain scene compartilhada com objetos mutáveis separados. Abertura, colisão, entrada, retorno, crédito e persistência implementados. Sem bomba de teste no início. Ver [real-secret.md](real-secret.md). Foram conferidos 121 contatos nativos, 4.352 pixels de suporte da máscara de porta, oito recortes visuais exatos, o ciclo de bomba/consumo/entrada/saída/revisita e gravação/reabertura de um cartão descartável. Payload v1 contém flags $91 na sala $67, 30 rupias e 3 bombas, com checksum válido. O cartão do usuário não foi alterado. Regressão no build normal: caverna da espada com coleta e saída; Continue de save de teste e caminhada da tela inicial até a caverna secreta já coletada. Build final do recorte: `dc681b23-7485-4a72-bcfc-7a29f3ac376b`. Lista restante: **loja → expansão de percurso com objetivo**. Regressão adicional do segundo recorte: 18 transições do overworld, 45 comparações visuais e seis capturas intermediárias da cobertura da parede reexecutadas e aprovadas, além das 16.524 sondas e 192 buscas de borda. Build/pack final aprovados; diagnostics vazios nas sete fontes consultadas. Entrada de produção restaurada; nenhum helper de fixture ficou em src. ## Terceiro recorte concluído — loja da $66 Stage 11 `cave_shop`, tipo nativo $78: escudo mágico por 160, chave por 100 e vela azul por 60 rupias. Entrada aberta (112,77), compra por contato, pose de aquisição de 128 ticks e saída para a própria $66. Uma compra por visita; estoque reposto na próxima entrada, inclusive após load, apesar do bit de item coletado persistente. Débito passa por Items[$27], sem alterar schema/app_id do memcard. Ver [shop.md](shop.md). Nove salas OW e **três interiores**: espada (1), segredo (10), loja (11). A loja compartilha a scene de terreno 1; vendedor, texto, preços e produtos são sprites. Nenhum slot de scene adicionado. Preços continuam visíveis após comprar; os demais objetos seguem o desaparecimento nativo por visita. Validação: 150 casos de aquisição/débito com rotinas da ROM, 13 comparações exatas de composição/poses e asserts de entrada, saldo insuficiente, compra única, saída, revisita e menu. Save durável em cartão descartável reaberto: Items preservados e débito pendente de 60 liquidado após load. Cartão do usuário não alterado. As 16.524 sondas de colisão e 192 casos de borda passaram. **Limites:** compra/posse/seleção da vela implementadas; fogo da vela e árvores queimáveis pendentes. Chaves acumulam, mas portas de dungeon ainda pendentes. Texto aparece inteiro, como nas cavernas anteriores. Demais lojas pendentes. Próximo recorte da lista aceita: **expansão de um percurso com objetivo**. Integração adicional via Game.frame com inicialização isolada na entrada da $66 confirmou a loja e abertura do submenu. O smoke de produção confirmou New Game, coleta da espada, saída e transição até a $66; o trajeto longo terminou em morte antes da loja. Ver limites e evidência em docs/shop.md. Todas as entradas/helpers temporários foram restaurados antes do build final. Build/pack final da loja: `ee40b41e-bd92-4648-bd2b-386e62c9bc00`. Diagnostics vazios nas oito fontes consultadas; build final sem diagnósticos. Boot/New Game revalidados após restauração, em memory_fresh. ## Quarto recorte concluído — percurso oeste com loja de bombas Quatro salas ($56/$55/$54/$44), seis novas ligações reversíveis e interior próprio da loja $77. O percurso $58→$57→$56→$55→$54→$44 tem aquisição concreta: quatro bombas por 20 rupias; a loja também vende escudo por 130 e flechas por 80. Atalhos nativos ligam $55↔$65 e $54↔$64. Ver [west-route.md](west-route.md). Agora são 13 salas OW e quatro interiores, sem novos slots de scene. Zora nas três salas novas que possuem a flag; encontros preservam listas e quantidades. Compra/visita compartilhada em src/shop; arte, dados e render por stage. Inventário recomposto em 16 faixas. IDs antigos do HUD/caverna preservados. Validação: 23.868 sondas e 384 buscas nativas, 30 transições, 116 checkpoints verdes, 69 comparações visuais do overworld e 12 da loja. Foram executados 400 casos nativos da loja nova e 150 da anterior, com Game.frame para entrada, menu, compra, saída e reposição. Save durável e reabertura confirmaram oito bombas, flechas, escudo e quitação do débito pendente. Cartão do usuário intacto. Os limites de infraestrutura e da fixture estão descritos no documento do recorte. A lista aceita na retomada foi concluída por estes quatro recortes. Próximas opções úteis: uso da vela e um segredo queimável real; depois ampliar um trajeto rumo à primeira dungeon com as famílias de inimigos correspondentes. Flechas já podem ser compradas, mas o uso de arco/flechas continua pendente. Build/pack final: `9a71c3be-7b87-4533-bfc0-cbfd36e30108`, sem diagnósticos. Fixtures removidas; main e máquina Game restaurados. Smoke normal: New Game, coleta/pose da espada e Continue pelo menu com cartão descartável em leitura somente; quitação do débito, uso de bomba (8→7) e inventário aberto/fechado. Diagnostics vazios em ShopVisit, StageFlow e Stage; três outras consultas de fontes retornaram INFRASTRUCTURE_FAILURE do LSP, registradas no feedback. O build e as verificações runtime passaram; não contar falha de LSP como vazio.