backend-infra-engineer: Release v0.3.2 snapshot

assets/agent/oracle_of_secrets_labels.yaml

@@ -0,0 +1,158 @@
+# Oracle of Secrets Project Labels for z3ed Agent
+# Version: 1.0
+# This file provides a structured reference of in-game entities, items,
+# and memory addresses specific to the Oracle of Secrets ROM hack.
+
+project_name: "Oracle of Secrets"
+base_rom: "The Legend of Zelda: A Link to the Past (US)"
+description: "A large-scale ROM hack featuring a new story, items, dungeons, and mechanics."
+
+# --- Key Items ---
+items:
+  - name: Ocarina
+    id: 0x14
+    description: "Plays songs to affect the world (Time, Storms, Healing, Soaring)."
+  - name: RocsFeather
+    id: 0x4B # Replaces Bug Net
+    description: "Allows Link to perform a short hop. Replaces Bug Net."
+  - name: Goldstar
+    description: "Hookshot upgrade. Functions as a powerful morning star weapon."
+  - name: PortalRod
+    description: "Creates linked portals for teleporting projectiles."
+  - name: FishingRod
+    description: "Initiates a fishing minigame."
+  - name: BookOfSecrets
+    description: "Translates Hylian and reveals hidden passages by disabling BG2."
+  - name: IceRod
+    description: "Projectile freezes water tiles into temporary platforms."
+  - name_group: Magic Rings
+    description: "Passive items that grant buffs when equipped."
+    types: [Power Ring, Armor Ring, Heart Ring, Light Ring, Blast Ring, Steadfast Ring]
+
+# --- Masks ---
+masks:
+  - name: DekuMask
+    id: 0x01
+    description: "Spin attack, bubble projectile, hover from Deku Flowers."
+  - name: ZoraMask
+    id: 0x02
+    description: "Allows diving and fast swimming."
+  - name: WolfMask
+    id: 0x03
+    description: "Allows digging without a shovel."
+  - name: BunnyHood
+    id: 0x04
+    description: "Increases movement speed."
+  - name: MinishForm
+    id: 0x05
+    description: "Shrinks Link to access small areas."
+  - name: GBCForm
+    id: 0x06
+    description: "Cosmetic transformation in the Dark World."
+  - name: MooshForm
+    id: 0x07
+    description: "Hover dash ability."
+
+# --- Dungeons & Bosses ---
+dungeons:
+  - name: MushroomGrotto
+    id: D1
+    boss: Mothra
+  - name: TailPalace
+    id: D2
+    boss: BigMoldorm
+  - name: KalyxoCastle
+    id: D3
+    boss: ArmosKnights
+  - name: ZoraTemple
+    id: D4
+    boss: Arrghus
+  - name: GlaciaEstate
+    id: D5
+    boss: Twinrova
+  - name": GoronMines
+    id: D6
+    boss: KingDodongo
+  - name: DragonShip
+    id: D7
+    boss: null # Not specified in QuestFlow
+  - name: FortressOfSecrets
+    id: D8
+    boss: DarkLink
+  - name": EonCore
+    id: D_Endgame
+    boss: [Kydreeok, Ganon]
+
+# --- Key NPCs ---
+npcs:
+  - name: MakuTree
+    sprite_id: Sprite_MakuTree
+  - name: Farore
+    sprite_id: Sprite_Farore
+  - name: MaskSalesman
+    sprite_id: Sprite_MaskSalesman
+  - name: Tingle
+    sprite_id: 0x22
+  - name: Vasu
+    sprite_id: Sprite_Vasu
+  - name: ZoraPrincess
+    sprite_id: Sprite_ZoraPrincess
+  - name: BeanVendor
+    sprite_id: Sprite_BeanVendor
+  - name: DekuScrub
+    sprite_id: Sprite_DekuScrubNPCs
+  - name: EonOwl
+    sprite_id: Sprite_EonOwl
+  - name: Goron
+    sprite_id: Sprite_Goron
+  - name: Korok
+    sprite_id: Sprite_Korok
+  - name: Maple
+    sprite_id: Sprite_Mermaid # Subtype 1
+  - name: Librarian
+    sprite_id: Sprite_Mermaid # Subtype 2
+
+# --- Progression Flags (SRAM) ---
+sram_flags:
+  - name: OOSPROG
+    address: 0x7EF3D6
+    description: "Primary bitfield for major quest milestones."
+  - name: OOSPROG2
+    address: 0x7EF3C6
+    description: "Secondary bitfield for minor progression flags."
+  - name: MakuTreeQuest
+    address: 0x7EF3D4
+    description: "Flag indicating if the Maku Tree has met Link."
+  - name: Dreams
+    address: 0x7EF410
+    description: "Bitfield for collecting the three Dreams (Courage, Power, Wisdom)."
+  - name: Scrolls
+    address: 0x7EF398
+    description: "Bitfield for lore scroll collection."
+  - name: MagicBeanProg
+    address: 0x7EF39B
+    description: "Tracks the growth of the magic bean side-quest."
+  - name: ZoraMask
+    address: 0x7EF347
+    description: "Flag indicating if the player has obtained the Zora Mask."
+  - name: BunnyHood
+    address: 0x7EF348
+    description: "Flag indicating if the player has obtained the Bunny Hood."
+  - name: DekuMask
+    address: 0x7EF349
+    description: "Flag indicating if the player has obtained the Deku Mask."
+
+# --- Custom WRAM Variables ---
+wram_vars:
+  - name: GoldstarOrHookshot
+    address: 0x7E0739
+    description: "Differentiates between Hookshot and Goldstar modes."
+  - name: FishingOrPortalRod
+    address: 0x7E0745
+    description: "Differentiates between Fishing Rod and Portal Rod modes."
+  - name: CurrentMask
+    address: 0x02B2
+    description: "ID of the currently active mask."
+  - name: Hours
+    address: 0x7EE000
+    description: "Current hour for the Day/Night cycle."