# WRK-0013 — estudo de caso Zelda 1

Inspeção estática UTC: 2026-11-17T10:52:10.801038+00:00

Projeto consultado em leitura: ports/nes/zelda-1. Work operacional desta auditoria: WRK-0013 do workspace Prometeu. Não retomar o desenvolvimento pausado do port.

## Proveniência

HEAD do port: `583c8811892977c266dffd3c500798791386632c`

Alterações preexistentes observadas na primeira inspeção (não produzidas nesta auditoria):
```text
M .ai-engineering/AGENTS.md
 M .ai-engineering/README.md
 M .ai-engineering/protocol.json
 M .ai-engineering/works/WRK-0001-planejar-proximo-recorte/work.md
 M AGENTS.md
?? .ai-engineering/works/WRK-0001-planejar-proximo-recorte/discussions/DSC-0005.md
```

## Fontes verificadas e hashes

- `ports/nes/zelda-1/AGENTS.md` — SHA-256 `9512fda817322f12eef8afa04a7c79c1cb5d6aa6e36e4dcf72df56a7759d4ad1`; 227 linhas.
- `ports/nes/zelda-1/prometeu.json` — SHA-256 `4f83a5cbeb406f756d238645b0bbb11846b962021560e0237ceb4577de271b20`; 10 linhas.
- `ports/nes/zelda-1/docs/scene-composition.md` — SHA-256 `2be5eb2ad53653a838dc884fdc528100da1d1505e2b0800457502f5ef2de44ad`; 74 linhas.
- `ports/nes/zelda-1/docs/prometeu-feedback.md` — SHA-256 `ad0761860c5b8e5efe9ea5d94f736a1555ec3f0bc8154d53e9f5d288dec24988`; 966 linhas.
- `ports/nes/zelda-1/docs/port-status.md` — SHA-256 `bf74916fe8e18fa488fc365d6a0dd48e30264f535877ec87c65ef3d5badf70a2`; 326 linhas.
- `ports/nes/zelda-1/src/main.pbs` — SHA-256 `2a25c1c1f556e4150312393ca37e20b3d38399f88375e69f4ca173099fefa7b6`; 15 linhas.
- `ports/nes/zelda-1/src/game/main.pbs` — SHA-256 `001da9f0c53c19fe02f7ebc550326f810f35c19c2d4712755bb4fd4934a6ec82`; 16 linhas.
- `ports/nes/zelda-1/src/game/flow.pbs` — SHA-256 `ce4e06df583823730c6d197da7201abb83187c267925ffdef65cb356d0f489c9`; 112 linhas.
- `ports/nes/zelda-1/src/scene/main.pbs` — SHA-256 `df480912990f126a61dc654056e36350ecf648083253dc18ad78bd82796d52e7`; 123 linhas.
- `ports/nes/zelda-1/src/stage/main.pbs` — SHA-256 `09654049bd0dda1636f8479bfead3486ec2f6eddbbed0f8e3166f6432baf46cd`; 143 linhas.
- `ports/nes/zelda-1/src/stage/flow.pbs` — SHA-256 `154e22c17f87d8a77b3335c863fecc8fcc71ff3fb9ac6f5eacecb773e21d6fae`; 140 linhas.
- `ports/nes/zelda-1/src/stages/cave_shop/main.pbs` — SHA-256 `110cdee50512db5f20559fda027bbc399ef30e860007672ac3ea8d6ff658c781`; 40 linhas.
- `ports/nes/zelda-1/src/shop/visit.pbs` — SHA-256 `0b0150e1753bdd8e12404ac2c4269bd11bb5e04684d610fd499e1b1ccaa9627c`; 23 linhas.
- `ports/nes/zelda-1/src/link/main.pbs` — SHA-256 `59a02dc91fbcbf281dc266afe2d7da92fb064ed2f8a4f5ef5c3ca66368487ec3`; 156 linhas.
- `ports/nes/zelda-1/src/enemies/octorok/main.pbs` — SHA-256 `d724a0e12dcc41ea41ea5686f219d230bd8512c4fa6d59dc1b39163b10bca827`; 171 linhas.
- `ports/nes/zelda-1/src/world/bombable_wall.pbs` — SHA-256 `bdf07469a74088df65e5959d495c4f0bc57c73dcfb35aedf8af1217cc8eb0405`; 12 linhas.
- `ports/nes/zelda-1/src/screens/inventory/main.pbs` — SHA-256 `7a5c089138883460861015df9da9d7f1307e093180ca8629b948e0f0e842ab2d`; 16 linhas.
- `ports/nes/zelda-1/tools/overworld_manifest.json` — SHA-256 `3e6aed03996a2445f6b4d33a9a286a69cde97ca388accb8f130de17a3e2ca68e`; 122 linhas.
- `ports/nes/zelda-1/tools/prepare_overworld.py` — SHA-256 `85b0628eea88352e29f4ffe5253ff7619645e2d982fb044465488e8553174fd0`; 141 linhas.
- `ports/nes/zelda-1/extracted/overworld/expansion/catalog.json` — SHA-256 `05b15a4d62e1c7607d2bd25c812afb2d223db7c3d802afb1448b1378a2ee13d1`; 684 linhas.
- `ports/nes/zelda-1/extracted/link/refactor-validation.json` — SHA-256 `ada45375086cc17485074eb7e6feac2cacc8bf4815ae318ac63dd353294e31b8`; 528 linhas.
- `ports/nes/zelda-1/extracted/supply_shop/save-validation.json` — SHA-256 `c92df7fece58be3db32eefbdf5d9963e33b60f6d4d4376d6d5386fef33b8ba5f`; 20 linhas.
- `ports/nes/zelda-1/assets/characters/link/asset.json` — SHA-256 `e5817d82fb4879f8831d3c5aec6a28670180ecf714ed556dd5ebbbd31d8d9f3f`; 220 linhas.
- `ports/nes/zelda-1/assets/tilesets/north/asset.json` — SHA-256 `3fa48c406577392a85b73090475690526552938a699b1bf0c668fb02a7183e1a`; 354 linhas.
- `ports/nes/zelda-1/assets/scenes/overworld_north/asset.json` — SHA-256 `0cce797804aea292411b8d8c283b13e2f249c78fd65e234f6b731b6f9dfbc23a`; 14 linhas.
- `ports/nes/zelda-1/assets/scenes/overworld_north_scroll/asset.json` — SHA-256 `2beda98435d8c2e9d8dad0c69e084662b3bbba05c3a548e0ff1b8dca9fe3a552`; 14 linhas.
- `ports/nes/zelda-1/assets/scenes/inventory/asset.json` — SHA-256 `74b3d3578a262ea06abb99ce13ea344baa8a02fd36bb77d48deec4f32547ebb8`; 14 linhas.
- `ports/nes/zelda-1/assets/ui/hud/asset.json` — SHA-256 `a196baddf16720114bb190dd8aaed7d0c0c9866b7eaa704854da4902bc381aaf`; 230 linhas.

## Dimensão observada

- src: 137 arquivos.
- assets: 1350 arquivos.
- tools: 85 arquivos.
- extracted: 2681 arquivos.
- Catálogo fonte: 13 salas do overworld.
- Catálogo gerado retido: 13 salas, 15 ligações bidirecionais; limites registrados {'actor_pool': 5, 'scene_slots': 16}.
- Resultado histórico de refactor retido: passed=58. Não executado nesta auditoria.

## Âncoras úteis

- `ports/nes/zelda-1/docs/scene-composition.md:4` — ROM. A organização gráfica deve aproveitar o Prometeu: uma scene com terreno
- `ports/nes/zelda-1/docs/scene-composition.md:73` — O inventário passou a 16 faixas dentro do slot 15. Stage ID 16 é um ID de
- `ports/nes/zelda-1/docs/prometeu-feedback.md:174` — ### ATR-08 Importação de bancos pelo agente exige edição de manifestos
- `ports/nes/zelda-1/docs/prometeu-feedback.md:312` — ### ATR-15 Compor elementos mutáveis sobre o terreno fixo
- `ports/nes/zelda-1/docs/prometeu-feedback.md:371` — ## Avaliação de interface ainda a fazer
- `ports/nes/zelda-1/docs/prometeu-feedback.md:390` — ### ATR-17 — Limite de bancos aparece como falha genérica no boot
- `ports/nes/zelda-1/docs/prometeu-feedback.md:814` — ### ATR-19 Validação visual nativa e serviço local de automação do Studio
- `ports/nes/zelda-1/docs/prometeu-feedback.md:899` — proposta ATR-19 acima: comparação estruturada de artefatos no Studio reduziria
- `ports/nes/zelda-1/docs/prometeu-feedback.md:911` — **Positivo / ATR-15:** quatro mapas e mais um interior foram integrados sem
- `ports/nes/zelda-1/docs/prometeu-feedback.md:917` — **Produção / ATR-08:** o gerador do port deixou buracos 28/29 no HUD ao derivar
- `ports/nes/zelda-1/docs/prometeu-feedback.md:934` — **ATR-19:** as 81 comparações exatas deste recorte ainda exigiram captura em
- `ports/nes/zelda-1/src/game/main.pbs:7` — declare service Game {
- `ports/nes/zelda-1/src/scene/main.pbs:19` — declare service Scene {
- `ports/nes/zelda-1/src/stage/main.pbs:14` — declare service Stage {
- `ports/nes/zelda-1/src/stage/main.pbs:106` — fn render() -> bool {
- `ports/nes/zelda-1/src/stage/main.pbs:111` — if Stage.scrolling() { let status = Composer.bind_scene(14); return status == 0; }
- `ports/nes/zelda-1/src/stages/cave_shop/main.pbs:35` — fn render() -> bool { let status=Composer.bind_scene(1); return status==0; }
- `ports/nes/zelda-1/src/link/main.pbs:5` — declare global state: LinkState = new LinkState(120, 133, 4, 0, 0, false, 0, 4, 0, 0, 0, 0, 1);
- `ports/nes/zelda-1/src/enemies/octorok/main.pbs:11` — declare global e0: Octorok = new Octorok(new Rock(0, 0, 0,0,0), 80, 93, 4, 0, 0, 0, 0, 0, 32, 1, 0, false,0,0,0,7);
- `ports/nes/zelda-1/tools/prepare_overworld.py:2` — """Generate room-owned stages, shared atlases, native foes and route tables."""
- `ports/nes/zelda-1/tools/prepare_overworld.py:80` — fn render() -> bool {{ let status=Composer.bind_scene(13); return status==0; }}
- `ports/nes/zelda-1/tools/prepare_overworld.py:87` — wrapper=shop_room.read_text().replace(' fn render()', ' fn can_enter(x: int,y: int,grid: int) -> bool { return x==112 && y==77 && grid==0; }\n fn render()')
- `ports/nes/zelda-1/tools/prepare_overworld.py:90` — supply_room.write_text(supply_room.read_text().replace(' fn render()', ' fn can_enter(x: int,y: int,grid: int) -> bool { return x==64 && y==77 && grid==0; }\n fn render()'))
- `ports/nes/zelda-1/tools/prepare_overworld.py:96` — source=source.replace(' fn render()', ' fn wall_opened() -> bool { return rock_wall.opened(); }\n fn finish_visit() -> void { wall_fresh=false; }\n fn blast(x: int,y: int) -> void { let opened=rock_wall.try_blast(x,y); if opened { wall_fresh=true; } }\n fn can_enter(x: int,y: int,grid: int) -> bool { let opened=rock_wall.opened(); return opened && x==112 && y==77 && grid==0; }\n fn draw_wall(dx: int,dy: int) -> void { if rock_wall.opened() { return; }\n'+''.join(f'  Scene.emit_sprite({glyph[t]},0,{112+x}+dx,{80+y}+dy,10,0);\n' for t,x,y in [(216,0,0),(218,8,0),(217,0,8),(219,8,8)])+' }\n fn render()')
- `ports/nes/zelda-1/tools/prepare_overworld.py:102` — marker_id=f'world-marker-{e["room"]:02x}';existing=next((a for a in hdoc['artifacts'] if a['artifact_id']==marker_id),None)
- `ports/nes/zelda-1/tools/prepare_overworld.py:107` — path=hud/f'world-marker-{e["room"]:02x}.png';im.save(path);hdoc['artifacts']=[a for a in hdoc['artifacts'] if a['index']!=idx and a['artifact_id']!=f'world-marker-{e["room"]:02x}']+[{'file':path.name,'index':idx,'artifact_id':path.stem,'fingerprint':hashlib.sha256(path.read_bytes()).hexdigest()}];hud_ids[e['stage']]=idx

## Comparação temporal com o Studio atual

- `studio/prometeu-app/src/main/resources/mcp/studio-tools-v1.json` — SHA-256 `644460877c87cdbe3bd1a77c7e6f764c24fe9b1c16c0eb237b48675e12e5126e`.
- `studio/prometeu-studio-api/src/main/java/p/studio/api/assets/AssetAuthoringService.java` — SHA-256 `1e54099ba43bdbb367f7c608072c4f74922890f4c353c866fcc2a7ca588e0c04`.
- `studio/prometeu-studio-api/src/main/java/p/studio/api/automation/EvidenceTools.java` — SHA-256 `4ec022b977c079c0af5e070e86e3b1493e2c25fa4b9fb7b97e48dc3722116ba3`.
- `studio/prometeu-studio-api/src/main/java/p/studio/api/automation/GuestTestTools.java` — SHA-256 `6d75a7c119bbb094e34ac63d68edc356770ade8d9164a002200859426a93843d`.
- studio_evidence_persist
- studio_evidence_import
- studio_evidence_compare
- studio_evidence_list
- studio_evidence_metadata
- studio_evidence_read
- studio_evidence_image
- studio_evidence_delete
- studio_tests_targets
- studio_tests_start
- studio_tests_get
- studio_tests_cancel
- studio_tests_transcript
- studio_tests_shutdown
- studio_assets_catalog
- studio_assets_artifacts
- studio_assets_revision
- studio_assets_dependencies
- studio_assets_budget
- studio_assets_preview
- studio_assets_preview_get
- studio_assets_commit
- studio_assets_result
- studio_assets_inspect

## Limites

- O relato de que o usuário não escreveu código e acompanhou a evolução é evidência humana desta conversa; não inferir autoria individual a partir de git/file metadata.
- Documentos e resultados retidos registram execuções anteriores. Nenhum teste, build, geração de assets, boot, MCP ou screenshot foi executado agora.
- Feedback do port declara que painéis do Studio ainda não foram avaliados visualmente; dificuldades do agente/compilador não são prova de defeito visual da GUI.
- Lacunas históricas de importação e comparação de imagens devem ser contrastadas com tools de autoria/evidência presentes no catálogo fonte atual. Não se verificou disponibilidade nem desempenho na instalação corrente.
- Sala/stage lógica, banco/atlas e slot runtime são identidades distintas. O módulo Scene do port é apresentação própria do jogo, não um contrato normativo de scene do Studio.
- Nenhum arquivo do port, incluindo feedback e sua AIE, foi alterado. As alterações preexistentes devem ser preservadas.
