output

src/puzzles/class-specific-ritual.md

@@ -0,0 +1,299 @@
+# Class-Specific Ritual Challenge
+
+**Information Architecture**: Player discovers ritual/competition structure through NPC dialogue; solution path diverges fundamentally based on character class. Each class receives distinct mechanical challenge (combat, magic, stealth) to solve identical narrative obstacle.
+
+**Player Action Pattern**:
+1. Learn ritual exists and has requirements (NPC dialogue)
+2. Complete prerequisite tasks to gain entry (varies by class)
+3. Enter ritual sequence — receive class-specific challenges
+4. Execute class-appropriate mechanics to complete each trial
+5. Alternative solutions available but may cost honor/points
+
+**Core Mechanic**: The same story-level puzzle is instantiated through different mechanical lenses depending on class, ensuring parity of completion while rewarding specialization.
+
+---
+
+## Variations
+
+| Type | Class Divergence | Convergence Point | Example |
+|------|------------------|-------------------|---------|
+| **Ritual Trials** | Each class faces entirely different trial mechanics | Same narrative reward after completion | Simbani Warrior Initiation |
+| **Dueling Styles** | Combat vs. magic vs. stealth approach to same obstacle | Enemy defeated, path cleared | Shaman Wizard Duel |
+| **Access Methods** | Physical strength, spell, or sneaking past | Entry granted to restricted area | Various door obstacles |
+
+---
+
+## Game Examples
+
+### Quest for Glory III: Simbani Warrior Initiation (QFG3)
+
+**Setup**: Fighter class must compete in traditional Simbani warrior trials against Yesufu to become a recognized warrior. Only after initiation can the fighter marry Johari (the Leopard Lady) and receive the Magic Drum from the Laibon. The trials consist of five sequential events, each testing different physical abilities.
+
+<small>Source: qfg3-gamefaqs-cyricz.txt, lines 2149-2173 — "You'll start by running off to the Twisted Tree... Grab a vine off the tree and you'll tie it to the spear... Throw the spear at the ring, and you'll win this event"</small>
+
+<small>Source: qfg3-gamefaqs-cyricz.txt, lines 2159-2161 — "Next, you'll run to the Circle of Thorns... push the nearby log onto the circle. Run into the middle and you'll grab the ring"</small>
+
+```
+WARRIOR INITIATION SEQUENCE (Fighter/Paladin):
+
+EVENT 1: Twisted Tree Ring Retrieval
+Location: Twisted Tree area in savanna
+Challenge: Ring hanging from high branch
+Standard Method (Yesufu): Throw spears repeatedly to knock ring down
+Clever Solution: Grab vine from tree, tie it to spear, throw spear at ring
+              → Vine reels ring down, event won instantly
+Outcome: Ring secured, win over Yesufu
+
+EVENT 2: Circle of Thorns
+Location: Thorn maze area
+Challenge: Retrieve ring from center without getting stuck in thorns
+Standard Method (Yesufu): Stab at thorns with spear blindly, slowly advance
+Clever Solution: Push nearby log onto thorns to bridge across
+              → Walk safely through middle, grab ring immediately
+Outcome: Ring secured, win over Yesufu
+
+EVENT 3: Trap Rescue
+Location: Path back to village
+Challenge: Yesufu caught in bear trap
+Required Action: Help him regardless of competition outcome
+Solution: Use character's strength/agility to free trapped leg
+Outcome: Honor points earned (8); demonstrates true warrior virtue
+
+EVENT 4: Spear Throwing Contest
+Location: Spear throwing area
+Challenge: Out-throw Yesufu at targets
+Phase 1: Stationary target — use best throwing technique
+Phase 2: Moving target — timing and lead calculation required
+Solution: Maximize Throwing skill, maintain focus on target movement pattern
+Outcome: Higher score wins event (5 points)
+
+EVENT 5: Wrestling Bridge Duel
+Location: Wrestling Bridge in Simbani Village
+Challenge: Unseat Yesufu three times using bridge combat mechanics
+Mechanics Learned Earlier:
+  - Opponent jumps → Player ducks
+  - Opponent ducks → Player jumps
+  - Opponent dodges left → Player dodges left (mirror response)
+Solution: Respond correctly to each of Yesufu's moves; repeat until 3 wins
+Outcome: Contest victory, named Warrior (10 points if player wins)
+
+WHY IT'S CLASS-SPECIFIC RITUAL (Not Pattern Learning):
+
+COMPLETE MECHANICAL DIVERGENCE BY CLASS:
+Fighter/Paladin experience: Physical trials requiring strength, agility, combat skills Wizard/Thief experience: Entirely different pathway—no warrior initiation required
+
+WIZARD ALTERNATIVE (Shaman Duel):
+Rather than physical trials, Wizard engages in magical duel with Leopardman Shaman:
+  - Summon Staff (counters opponent's anti-staff spell)
+  - Cast Reversal (reflects hostile magic)
+  - Cast Calm (dispels Wall of Flames)
+  - Cast Open (escapes Cage of Thorns)
+  - Cast Juggling Lights (illuminates darkened area)
+  - Cast Dazzle (reveals illusion snake)
+  - Cast Levitate (escapes pit trap)
+  - Final: Attack Shaman directly OR cast Dispel Potion (honor choice)
+
+This is NOT pattern learning because:
+1. Wizard never sees or participates in warrior trials
+2. Each class has entirely different puzzle sequence for same outcome
+3. No shared rule system learned and applied—pure mechanical divergence
+
+PARALLEL NARRATIVE, DIVERGENT PLAY:
+Both Fighter and Wizard achieve "acceptance by Leopardmen" through completely different gameplay experiences, but both receive Spear of Death as reward.
+```
+
+---
+
+### Quest for Glory III: The Shaman's Magical Duel (Wizard)
+
+**Setup**: Wizard class must defend the Simbani cause against Leopardman aggression. Rather than physical combat trials, the Wizard challenges the Leopardman Shaman to a magical duel. Takes place in Leopardman Village after marrying Johari.
+
+<small>Source: qfg3-gamefaqs-cyricz.txt, lines 2601-2614 — "First, Summon your Staff... cast Reversal to flip back the staff-burning spell... Cast Calm... Cast Open on the cage... Cast Juggling Lights... Cast Dazzle to dispel the illusion... Cast Levitate to rise out of it"</small>
+
+```
+WIZARD'S DUEL SEQUENCE (Counter-Spell Reactive Puzzle):
+
+INITIAL CONDITION: Must each take turns with spells; cannot attack directly until final phase
+
+EXCHANGE 1: Shaman's Staff-Burning Spell
+Threat: Magical fire spell aimed at player's summoned staff
+Required Counter: Summon Staff FIRST (prevents destruction)
+         Then cast Reversal to reflect magic back at caster
+Points: 4+4=8
+
+EXCHANGE 2: Wall of Flames
+Threat: Fire barrier traps Wizard in enclosed space
+Required Counter: Cast Calm → extinguishes flames peacefully
+Points: 4
+
+EXCHANGE 3: Cage of Thorns
+Threat: Magical thorn prison, locked from outside
+Required Counter: Cast Open on cage door
+Points: 4
+
+EXCHANGE 4: Darkness Spell
+Threat: Area becomes pitch black; visibility and targeting impossible
+Required Counter: Cast Juggling Lights → creates illumination field
+Points: 4
+
+EXCHANGE 5: Illusion Snake
+Threat: Black serpent illusion attacks player (not real, but distracting)
+Required Counter: Cast Dazzle → reveals illusion, causes it to vanish
+Points: 4
+
+EXCHANGE 6: Pit Trap
+Threat: Floor opens beneath Wizard; falling damage/death risk
+Required Counter: Cast Levitate → rise above pit safely
+Points: 4
+
+FINAL PHASE: Shaman's Demon Summoning
+Condition: "All bets are off now"—rules of no direct attack lifted
+Options:
+  A) Kill the Shaman (combat approach) = 5 points, less honorable
+  B) Use Dispel Potion on possession = 8 points, maintains peace narrative
+Either way: Win the Wizard's Duel (10 points total for victory)
+
+WHY IT'S CLASS-SPECIFIC RITUAL:
+
+MIRROR OF FIGHTER INITIATION:
+- Same number of stages (~5-6 sequential challenges)
+- Each stage presents threat requiring specific counter-action
+- Final phase offers moral choice affecting honor/points
+- Identical narrative reward: Acceptance by Leopardmen, Spear of Death gained
+
+BUT COMPLETELY DIFFERENT MECHANICS:
+- Fighter uses physical skills; Wizard uses spell selection
+- Fighter competes against Yesufu directly; Wizard counters Shaman's spells
+- No overlap in required player knowledge or actions
+```
+
+---
+
+### Quest for Glory IV: Dark One Cave Escape Sequence (QFG4)
+
+**Setup**: After collecting each of the seven Dark One Rituals, the player must escape from progressively dangerous caves. Each cave presents the same narrative obstacle (escape the collapsing chamber) but with mechanically distinct solutions by class.
+
+<small>Source: qfg4-gamefaqs-sac.txt, lines 2701-2750 — Fighter blood cave: "push the boulder into the gap"; Wizard: "cast Frost Bite twice to freeze the blood flow"</small>
+
+```
+BLOOD CAVE ESCAPE (After Blood Ritual):
+Fighter Push boulder to block acid flow through chamber
+Wizard Cast Frost Bite twice, freeze path across blood pool
+Thief   Use Acrobatics skill to leap between narrowing platforms
+
+BREATH CAVE ESCAPE (After Breath Ritual):
+Fighter Grab lung tendril, run when thrown across chamber
+Wizard Cast Calm on valve mechanism, then Open spell to release pressure
+Thief   Climb invisible glass wall using stealth detection
+
+SENSE CAVE NAVIGATION (Progressive Sense Restoration):
+Common to all: Click Hand icon repeatedly to restore senses in order
+Touch → Smell → Hearing → Sight
+Fighter/Thief Navigate using restored physical perception abilities
+Wizard     Use magic detection to find sense-restoration points
+
+SENSE CAVE ESCAPE (Electrical Hazard Chamber):
+Fighter Time dendrite clusters, use grapnel swings across live wires
+Wizard   Cast Resistance spell, then Lightning Ball to short-circuit barrier
+Thief    Multiple grapnel swings; precise timing over electricity
+
+BONE CAVE CAGE ESCAPE (Collapsing Prison):
+Fighter Attack bone cage structure directly until it shatters
+Wizard   Alternating Flame Dart / Frost Bite spells to brittle bones → Force Bolt
+Thief    Use Acrobatics before cage fully closes, slip through gaps
+
+ESSENCE CAVE FINAL BATTLE (Ad Avis Confrontation):
+Common Step: Tell Ultimate Joke to stun the Dark Master
+Fighter Erana's Staff transforms to spear, throw at Ad Avis through portal
+Wizard  Cast Force Bolt → Summon Staff to crystal in other realm → final attack  
+Thief   Use stake from dungeon OR Acrobatics jump through dimensional rift
+
+WHY IT'S CLASS-SPECIFIC RITUAL:
+
+MECHANICAL DIVERGENCE WITH NARRATIVE CONVERGENCE:
+Each escape presents identical story goal (survive the cave gauntlet)
+but requires fundamentally different player skills:
+- Fighter = physical strength, timing, combat
+- Wizard  = spell selection, mana management, magical solutions
+- Thief   = stealth mechanics, acrobatics, precision movement
+
+NO OVERLAP IN REQUIRED ACTIONS:
+Player never sees other class's solution method during their playthrough.
+Each class experiences entirely different gameplay for same narrative beat.
+
+COMPARISON TO QFG3 INITIATION:Similar to Simbani Warrior Trials (QFG3) in structurebut expanded from single ritual to gauntlet of 6 sequential escapes
+```
+
+<small>Cited from: qfg4-gamefaqs-sac.txt:2701-2850, qfg4-gamefaqs-anonymous.txt:1110-1198</small>
+
+---
+
+### Quest for Glory IV: Monster Combat Solutions (QFG4)
+
+**Setup**: Common combat encounters resolved differently by class specialization. Some monsters only approachable by specific class abilities.
+
+<small>Source: qfg4-gamefaqs-cyricz.txt, lines 1716-1730 — "Wraith will continue to suck life out of you in combat unless you have some kind of protection, like the Aura Spell or Undead Amulet"</small>
+
+```
+WRAITH COMBAT (Life-Sucking Undead):
+Fighter/Thief Must obtain Undead Amulet from Gypsy camp first
+            Then approach while dodging cold touch, hack repeatedly
+Wizard     Requires Aura Spell to create protective field
+            Can then attack directly without life drain
+
+CHERNOVY WIZARD COMBAT (Magic-Reflecting Cultists):
+Fighter/Thief Approach only when not casting; melee attacks work
+Wizard     Must watch for Reversal spell indication
+            Switch to Frost Bite (physical damage) during reversal period
+
+NECROTAUR COMBAT (High-Difficulty Charge Attack):
+Fighter  Pin against wall, repeat strikes while dodging charge
+Thief    Use daggers at range; kiting strategy
+Wizard   Spells only - must maintain distance with Frost Bite / Force Bolt
+
+WHY IT'S CLASS-SPECIFIC RITUAL:Combat is fundamental game mechanic, but each class has distinct encounter structure
+Some enemies require class-specific preparation (pre-combat acquisition)
+Solution paths diverge at multiple decision points within same encounter
+```
+
+<small>Cited from: qfg4-gamefaqs-sac.txt:1638-1730</small>
+
+---
+
+### Quest for Glory IV: Entry Method Divergence (Multiple Puzzles) (QFG4)
+
+**Setup**: Multiple location access puzzles solved through class-specific approaches. Same destination, different entry mechanics.
+
+<small>Source: qfg4-gamefaqs-anonymous.txt, lines 702-718 — monastery entry; crystalshard.txt:398-399 — Borgov tomb entry</small>
+
+```
+MONASTERY ENTRY:
+All classes Use Dark One Sign on door (universal solution)
+Fighter/Thief Climb through window with sufficient skill level
+Wizard        Cast Levitate to reach window ledge
+
+BORGOV TOMB CRYPT:
+All classes Obtain key from Igor after Gypsy rescue quest
+Wizard        Cast Open spell on locked door
+Thief         Pick lock with Lockpick tool (from Thieves' Guild)
+
+ELDERBURY BUSH BERRIES:
+Fighter/Thief Throw rocks to dislodge berries, then sneak collection
+Wizard        Force Bolt knocks berries off → Fetch spell collects them
+
+WHY IT'S CLASS-SPECITAL RITUAL:Primary narrative outcome identical (area access / item acquisition)
+but solution path determined by character design choices.
+Class mechanics gate different approach availability.
+```
+
+<small>Cited from: qfg4-gamefaqs-sac.txt:2259-2270, qfg4-gamefaqs-anonymous.txt:937-1010</small>
+
+---
+
+## Related Types
+
+| Type | Similarity | Distinction |
+|------|------------|-------------|
+| Pattern Learning | Both require mastering mechanics early for later payoff | PL = same system reused; CSR = different classes get entirely different systems |
+| Multi-Faceted Plan | Both have multiple requirements to satisfy | MFP = gather all requirements in any order; CSR = class determines which set applies |
+| Observation Replay | Both involve learned sequences | OR = reproduce exact sequence seen once; CSR = learn rule application, not memorization |

src/puzzles/comedy-based-persuasion.md

@@ -0,0 +1,230 @@
+# Comedy-Based NPC Persuasion
+
+**Information Architecture**: Dialogue trees include absurdity/humor options alongside standard inquiry/negotiation choices. Successful persuasion doesn't rely on logical argument, evidence presentation, or information exchange—it relies on comedic timing, escalating absurdity, or matching the NPC's own irrational worldview through joke-based dialogue selection.
+
+**Player Action Pattern**: 
+1. Approach blocking NPC with conventional goals (passage, information, item)
+2. Standard dialogue options available (polite request, threat, bribe, query)
+3. Humor/absurdity options present but marked as "risky" or clearly unconventional
+4. Selecting comedy path succeeds or fails based on tone-matching with NPC character
+5. Success grants goal AND advances comedic narrative; failure provides funny rejection
+
+**Core Mechanic**: The talk tree implements a "tonal compatibility" check where humor style must match character personality—not what you argue matters, but whether the joke lands within that character's comedic worldview.
+
+---
+
+## Variations
+
+| Type | Comedy Approach | Success Condition | Example |
+|------|-----------------|-------------------|---------|
+| **Escalating Absurdity** | Each response increases ridiculousness | NPC joins in or gives up from confusion | Arguing with bureaucrat until they surrender |
+| **Tone-Matching** | Mirror NPC's own humor style | Recognition of shared comedic frequency | Joke-for-joke exchange leading to alliance |
+| **Self-Deprecating Deflection** | Mock self rather than confront | Disarms hostility through humility/humor | Guards laugh instead of arresting player |
+| **Non-Sequitur Overload** | Deliberately illogical responses | Confuses NPC into cooperative state | Absurd claims accepted as legitimate |
+
+---
+
+## Game Examples
+
+### Sam & Max Hit the Road: Cone of Tragedy Claim Ticket Acquisition (SMHTR)
+
+**Problem**: After riding the "Cone of Tragedy" carnival ride, player discovers most inventory items have fallen out. Need to retrieve them, but no obvious recovery method exists. Must interact with carnival worker nearby to find solution.
+
+<small>Source: adventuregamers_walkthrough.html, embedded walkthrough lines 156-164 — "Walk over to the Cone of Tragedy and talk to the man. Ask about the Cone of Tragedy. After leaving the Cone of Tragedy, check the inventory to find that most of the items have fallen out. Talk to the man and ask him about the inventory. He will give you a claim ticket."</small>
+
+<small>Source: abandonwaredos_solution.html, lines 253-260 — "talk with the guy sitting there -> Click at Cone of Tragedy Icon -> After looking at the inventory talk again with the guy -> Ask for your Inventory -> You'll get a ticket for the Lost & Found"</small>
+
+```
+DIALOGUE TREE STRUCTURE:
+
+Location: Carnival, near Cone of Tragedy ride (3.3)
+NPC: Unnamed carnival worker sitting by ride exit
+
+INITIAL CONTACT - Comedy Setup:
+1. Ride completes, comedic inventory loss occurs
+2. Worker NPC visible nearby for interaction
+3. First conversation topic: "Cone of Tragedy" itself
+   - Worker explains ride (humorous description of item-loss mechanic)
+   - Establishes worker as carnival employee, potentially helpful
+   
+CRITICAL PERSUASION MOMENT:
+4. Player checks inventory → discovers catastrophic item loss
+5. Return to NPC for SECOND conversation
+6. Dialogue option available: "Ask about Inventory"
+
+7. [COMEDY MECHANIC]: Instead of demanding items back or threatening
+   Worker responds in kind with COMedic framing:
+   - Acknowledges tragedy absurdly
+   - Provides claim ticket as carnival-appropriate response
+   - Establishes Lost & Found location humorously
+   
+8. Claim ticket received → enables Lost & Found visit
+
+RESPONSE ANALYSIS:
+
+Why This is Comedy-Based Persuasion:
+- Player option frames problem comedically ("inventory?" as joke) not seriously
+- Worker's response matches comedic tone—doesn't dismiss or refuse
+- Transaction (claim ticket) treats absurd loss as mundane carnival bureaucracy
+- The "puzzle" is recognizing worker CAN help through proper tonal approach
+
+What Would Fail (Hypothetical, Based on Game Design):
+- Threatening worker → likely hostile/refusal response  
+- Demanding compensation → formal complaint process, not comedy-friendly
+- Ignoring and exploring → possible but claims ticket path is themed solution
+```
+
+**Why It's Comedy-Based Persuasion (Not Information Brokerage)**:
+1. **No Trade Exchange**: Player gives nothing of material value to worker—only asks comedically
+2. **Tone Determines Outcome, Not Logic**: Worker provides ticket because the situation was framed within carnival's absurdist context, not because player offered valuable information or items
+3. **Humor is Primary Interaction Mode**: The joke is on PLAYER (ridiculous inventory loss); successful persuasion acknowledges and participates in that joke
+
+**Distinction from Sensory Exploitation**: Worker has no perceptual vulnerability to exploit. Player doesn't deceive worker—they collaboratively acknowledge the absurdity, and worker's response follows comedic world rules.
+
+---
+
+### Sam & Max Hit the Road: Mole Man Candy-for-Crowbar Exchange (SMHTR)
+
+**Problem**: Inside Tunnel of Love hidden room, Doug the Mole Man holds critical information (Bruno the Sasquatch location, Twine Ball destination) and an item needed to progress (crowbar for trailer door). Standard conversation reveals he wants something but initial offers don't work.
+
+<small>Source: adventuregamers_walkthrough.html, embedded walkthrough lines 195-201 — "Talk to Doug, and ask him about the bigfoot. The location of the largest ball of twine will appear on the map. Give Doug the candy, and he will give you a crowbar."</small>
+
+<small>Source: abandonwaredos_solution.html, lines 278-283 — "Talk to the Mole Man -> You'll get many informations about Bruno the Sasquatch, during the conversation you'll have to give him the candys -> You'll get a crowbar for the candys and a new location (5)"</small>
+
+```
+PERSUASION THROUGH CHARACTER-TONAL MATCHING:
+
+Location: Tunnel of Love Hidden Room (3.7)
+NPC: Doug, "Mole Man" living in carnival attraction tunnels
+Character Profile: Subterranean dweller with childlike/simple preferences
+
+INITIAL INFORMATION GATHERING:
+1. Enter room via hidden door (beard pull puzzle)
+2. Approach Mole Man—easily approachable character, no hostility
+3. Dialogue option: "Ask about Bigfoot"
+4. Mole Man willingly discusses Bruno, provides Twine Ball location marker
+
+CRITICAL EXCHANGE MOMENT:
+5. Crowbar needed but not offered in conversation
+6. Player must discover what Mole Man VALUES
+7. [COMEDY PERSUASION MECHANIC]: Offer candy (acquired earlier at Snuckey's)
+
+8. Response Analysis:
+   - Mole Man accepts immediately—no haggling, no debate
+   - Exchange framed as simple "swapping treasures" not transactional trade
+   - Comedic element: Mole Man's treasure = children's candy
+   
+9. Outcomes:
+   - Crowbar received
+   - Friendship/alliance established with character
+   - Tonal consistency: weird carnival worker values weird items
+
+WHY THIS IS COMEDY PERSUASION (versus Information Brokerage):
+
+TONE-MATCHING ELEMENTS:
+- Mole Man character type: whimsical, childlike, underground dweller stereotype
+- Candy as treasure fits his CHARACTER LOGIC despite being absurd to adult NPCs
+- Exchange has no serious economic logic (what IS the crowbar worth versus candy?)
+
+INFORMATION BROKERAGE COMPARISON:
+If this were pure Information Brokerage:
+- Player would learn Mole Man wants X through explicit demand
+- X would have clear value to him within world economy  
+- Trading network would be logical (even if absurd items)
+
+Actual Comedy-Based Approach:
+- Discovery comes from trying INVENTORY ITEMS as conversation responses
+- Success depends on tonal fit (weird person wants weird thing), not logic
+- Joke is the MISALIGNMENT: adult tools for children's candy
+
+PERSUASION STRUCTURE:
+Not "I'll give you X if you give me Y" negotiation
+But "Here's something I know you'd like" comedic gift-giving
+```
+
+**Why It's Comedy-Based Persuasion**: The puzzle isn't mapping an exchange network. The puzzle is recognizing this character exists in a comedic register where childlike treasures make sense. Successful persuasion demonstrates world-knowledge about character TYPE, not logical deduction about needs/wants.
+
+---
+
+### Sam & Max Hit the Road: Sasquatch Chief Rasping (SMHTR)
+
+**Problem**: At Savage Jungle Inn, player encounters Bigfoot/Sasquatch chief with a dental complaint (raspy teeth/gum problem). Direct dialogue doesn't progress plot—must provide correct item in comedic fashion.
+
+<small>Source: adventuregamers_walkthrough.html, embedded walkthrough lines 635-637 — "Enter the Savage Jungle Inn. Talk to Evelyn Morris... Give the rasp to the bigfoot."</small>
+
+<small>Source: abandonwaredos_solution.html, lines 438-440 — "Give the Rasp to the Sasquatch"</small>
+
+```
+PHYSICAL COMEDY ITEM MATCHING:
+
+Location: Savage Jungle Inn (10.2)
+NPC: Sasquatch Chief with dental discomfort
+Item Needed: Rasp (unexpected tool in player inventory from earlier horse encounter at Snuckey's)
+
+SETUP CHAIN:
+1. Earlier at Snuckey's bathroom incident (lines 137-147):
+   - Max borrows bathroom key temporarily
+   - Returns with rasp attached to key  
+   - Player acquires rasp as incidental item, NO stated purpose
+2. Long gameplay gap between acquisition and use
+3. At Inn: Chief mentioned but problem not explicitly stated
+
+COMEDY PERSUASION MOMENT:
+4. Observe/talk to chief → dental discomfort implied (character acting, not explicit dialogue)
+5. Player must recognize Rasp as SOLUTION despite no logical path
+   
+6. Use Rasp on Sasquatch/Chief teeth
+7. Chief gratified—comedy resolution through physical problem/comedic tool match
+
+WHY COMEDY-BASED:
+- Tool purpose mismatch: Rasp is woodworking/metalworking, not dental equipment
+- Absurd connection player must make
+- Success comes from accepting "rasp solves tooth problems" as cartoon logic
+
+PHYSICAL COMEDY PERSUASION SUBTYPE:
+This represents a variation where persuasion through comedy applies to PHYSICAL interaction, not just dialogue. Item choice demonstrates comedic understanding of character's problem.
+```
+
+**Why It's Comedy-Based Persuasion**: Success depends on recognizing the character TYPE (Sasquatch) + their implied PROBLEM state (teeth roughness/hairiness) + absurd ITEM that comedically fits. The rasp isn't a logical dental tool—it's a joke solution for a hairy creature with rough teeth.
+
+---
+
+## Related Types
+
+| Type | Similarity | Distinction |
+|------|------------|-------------|
+| **Information Brokerage Chain** | Both involve NPC wants/needs | IB = explicit trade network; CBP = tonal comedy matching |
+| **Sensory Exploitation** | Both bypass standard interaction | SE = perception weakness; CBP = humor register alignment |
+| **Multi-Faceted Plan** | Both may require multiple items/information | MFP = parallel requirements synthesis; CBP = single comedic recognition moment |
+
+---
+
+## Design Considerations
+
+**When to Use**: Games where humor is central mechanic; NPCs defined by comedic traits rather than serious goals; situations where logic-based solutions would undermine tone.
+
+**Key Design Principle**: Comedy persuasion must feel character-appropriate, not random. Mole Man wants candy (character consistent); guard accepting absurd explanation only works if established as gullible/absurd themselves.
+
+**Risks**:
+- Players may miss comedic options hidden among serious dialogue choices
+- Solutions can seem arbitrary without strong tonal framing
+- May undermine player agency if ONLY humor works in serious situations
+
+### Simon the Sorcerer: Troll Bridge Whistle Negotiation (SIMON)
+
+**Problem**: The Troll blocks bridge passage on "strike"—refusing to negotiate logically or accept standard trade. Dialogue attempts at bargaining fail. Only by recognizing the comedic nature of both characters and providing a prop that matches the absurdity can progress occur.
+
+<small>Source: walkthroughs/simon1/simon1.txt, lines 98-102 — "Talk to the troll, and it is interested in Simon's whistle..."</small>
+
+#### Comedic Context Setup:
+The Troll explicitly declares a labor strike over unfair treatment by goats (Billy Goats Gruff reference). This establishes him as having bureaucratic/union-complaint humor rather than monster-hostility. 
+
+**Tonal Matching Required**: Player must recognize the Troll wants COMEDIC SATISFACTION not logical passage—offering something that creates funny situation works where direct requests fail.
+
+The Whistle (from Barbarian) triggers a comedic cascade: Troll blows it → absurd noise → Barbarian attacks Troll = "the strike gets violent resolution through musical instrument." This is the joke-based solution matching the NPC's established humor profile (cartoon villain with labor grievance rather than traditional monster).
+
+**Why It's Comedy-Based Persuasion**: The dialogue succeeds not because of logical argument or trade value, but because providing a WHISTLE creates the scenario where Troll's own action triggers his defeat. Comedic irony is the persuasion mechanism—Troll becomes participant in his own downfall via toy he was curious about.
+
+---
+
+**Best Practice**: Establish character comedy profiles early. Signal acceptable interaction style through introduction scenes or other NPC interactions with similar personality types.

src/puzzles/corporate-infiltration.md

@@ -0,0 +1,383 @@
+# Corporate Espionage / Multi-Layer Infiltration Puzzle
+
+**Information Architecture**: Player must bypass multiple security systems, each requiring different approach strategies. Access control is layered (perimeter → interior → restricted zones), and requires gathering authentication items (keycard, disguise, visual credentials) from different locations within facility. Security personnel actively patrol interior spaces with conditional response behaviors.
+
+**Player Action Pattern**:
+1. Breach perimeter using temporary concealment/stealth item
+2. Acquire uniform/disguise from accessible storage
+3. Perform mandatory maintenance tasks to avoid suspicion during patrols
+4. Observe authority figure patterns to identify absence windows
+5. Steal authentication credentials during vulnerability window
+6. Bypass final electronic door controls with collected items
+
+**Core Mechanic**: Multiple independent security barriers exist within a single facility, requiring the player to adapt behavior based on location context—steath for entry, disguise and maintenance for interior patrols, opportunistic theft for credentials, technical authentication for final barrier.
+
+## Variations
+
+| Variation | Security Layers | Player Adaptation Required | Example |
+|-----------|-----------------|---------------------------|---------|
+| **Disguise + Maintenance** | Visual ID check + behavioral monitoring | Must perform role actions correctly | SQ3 janitor infiltration |
+| **Pure Stealth** | Active pursers, sensors | Avoid detection entirely | Classic stealth games |
+| **Credential Stack** | Multiple door types requiring cards/keycodes | Collect all credentials in any order | Some sci-fi adventures |
+
+---
+
+## Game Examples
+
+### SpaceQuest III: ScummSoft Headquarters Infiltration (Pestulon) (SQ3)
+
+**Problem**: Roger reaches Pestulon where ScummSoft is holding two Andromeda citizens captive behind an "impenetrable force field." Infiltrating the company headquarters requires bypassing guards, security doors, and eventually confronting corporate boss Elmo. Security personnel patrol hallways and will kill intruders unless disguised as staff.
+
+<small>Source: gamefaqs-tricrokra-archive.html, lines 534-539 — "Wear the invisibility belt = Turn on the belt = Enter ScumSoft"</small>
+
+<small>Source: the-spoiler-walkthrough.html, lines 131-148 — Complete infiltration sequence</small>
+
+```
+LAYER 1 - PERIMETER BREACH (Invisibility Belt):
+
+PREREQUISITE: INVISIBILITY BELT in inventory (captured from Arnold on Phleebhut)
+LOCATION: Ship → South to ScummSoft building entrance
+
+Action Sequence:
+- WEAR belt → TURN ON belt (become invisible to guards)
+- PUSH BUTTON at door control panel
+- ENTER door while invisible
+
+BELT FAILURE MECHANIC:
+Citation: gamefaqs-tricrokra-archive.html, lines 542-544 — "The invisibility belt will get broken. Great."
+Outcome: Belt breaks immediately upon entering; player now vulnerable inside and must acquire disguise quickly.
+
+
+PHASE A - DISGUISE ACQUISITION (Becoming Staff):
+
+LOCATION: South from entry → First door left (janitor closet)
+Action Sequence:
+- GET CLOVERES → Automatic costume change to janitor uniform
+
+ITEMS GRANTED WITH UNIFORM:
+- VAPORIZER (waste disposal tool, multi-purpose)
+- Janitorial appearance (guards no longer kill on sight)
+
+
+PHASE B - MANDATORY MAINTENANCE TASK (Behavioral Stealth):
+
+SECURITY MECHANIC: Guards and sensors check trash can contents throughout facility. If any can is left full while player passes as janitor → immediate death for "not doing job properly."
+
+SOLUTION PATTERN:
+- Every room visited must have all visible trashcans emptied
+- Command: USE VAPORIZER on each can until empty
+
+
+LAYER 2 - AUTHENTICATION ACQUISITION (Photocopy Substitution):
+
+SUB-PUZZLE: Boss Elmo's office security door requires facial recognition
+
+INFORMATION FLOW:
+1. Navigate maze hallways, vaporizing cans throughout
+2. Reach first western room after entry area
+3. Observe picture of Elmo's face on wall (not in boss's office yet)
+4. TAKE PICTURE from wall
+5. Use nearby photocopier: COPY picture
+6. PUT PICTURE back on original location (avoid raising alarm if inspected)
+
+Citation: gamefaqs-tricrokra-archive.html, lines 557-563 — "= Get the picture = Use the copier to copy the picture = Put the picture back where you found it."
+
+OUTPUT ITEM: COPIED PHOTO of Elmo's face
+PURPOSE: Will fool facial recognition scanner at restricted area
+
+
+LAYER 3 - AUTHORITY FIGURE SURVEILLANCE (Wait for Absence):
+
+LOCATION: Continue north through offices to boss's office window
+OBSERVATION REQUIRED: Wait until Elmo leaves his office through east door
+
+Citation: gamefaqs-tricrokra-archive.html, lines 577-580 — "Now the boss is gone... Enter his office"
+
+STRATEGY: Player monitors from hallway. When Elmo exits east, opportunity window opens to enter office without confrontation.
+
+
+LAYER 4 - CREDENTIAL THEFT (Keycard Acquisition):
+
+WINDOW OF OPPORTUNITY: Only after Elmo leaves office
+LOCATION: Elmo's private office (east side of building)
+Action: GET KEYCARD from desk
+
+Citation: gamefaqs-tricrokra-archive.html, line 580 — "steal the keycard from his desk and exit south"
+
+
+LAYER 5 - RESTRICTED AREA ACCESS (Multi-Authentication Door):
+
+LOCATION: Exit ScummSoft building (walk south out to main hall) → First door right on south side
+SECURITY SYSTEMS TO BYPASS: Two-part electronic lock
+
+AUTHENTICATION SEQUENCE:
+
+STEP A - Insert Keycard
+Prerequisite: KEYCARD in inventory (stolen from Elmo's office)
+Command: USE keycard → put in slot reader
+
+
+STEP B - Facial Recognition Scanner  
+Prerequisite: COPIED PHOTO of Elmo's face in inventory
+Command: Hold copy → SHOW picture/COPIED photo to scanner
+
+Citation: gamefaqs-tricrokra-archive.html, lines 592-596 — "= Go south and stop at the first door on the right = Use the keycard = Show the picture to fool the face scanner"
+
+
+STEP C - Enter Restricted Area (Prison Cell Zone)
+Door opens after BOTH authentications succeed
+Two captured Andromedan citizens visible inside force field cell
+
+
+
+LAYER 6 - CAPTIVE RESCUE:
+
+LOCATION: Inside restricted room with prison cells
+ACTION SEQUENCE:
+- PRESS BUTTON at wall panel → Creates bridge to cells
+- Walk to center platform
+- USE VAPORIZER on each captive (dissolves their energy field restraints)
+
+Citation: gamefaqs-tricrokra-archive.html, lines 597-601 — "= TYPE PRESS BUTTON to create a bridge = Go to the center = Use the vaporizer to free Mark and Scott"
+
+
+LAYER 7 - FINAL CONFRONTATION SEQUENCE:
+
+TRIGGER MECHANIC: After freeing captives, wait for Elmo to return. He challenges Roger to combat.
+COMBAT PHASES: Two sequential encounters (robot boxing match → space battle)
+
+Citation: gamefaqs-tricrokra-archive.html, lines 603-610 — "wait for the boss to pop up and he challenges you to a fight... For the space battle goes..."
+
+
+```
+
+**Why It's Multi-Layer Infiltration (Distinct from Simple Sensory Exploitation)**:
+This puzzle contains multiple sub-puzzle types in sequence:
+1. **Sensory Exploitation**: Invisibility belt fools guard visual detection (but breaks)
+2. **Disguise Mechanic**: Janitor uniform provides social camouflage
+3. **Conditional Behavior Enforcement**: Janitor MUST empty cans—behavioral role play, not just wearing clothes
+4. **Meta-Construction**: Picture copied then keycard stolen to combine at final door
+5. **Timed Opportunity Window**: Stealing keycard requires Elmo's absence
+
+Unlike pure sensory exploitation (one sense vulnerability), this is a multi-barrier infiltration where each layer requires different solutions from different mechanics. The challenge is managing all sub-puzzles in correct sequence: belt→disguise→copy picture→wait for boss→steal card→escape building→combine authentications→rescue captives.
+
+**Key Distinction from Information Brokerage**: IB gathers items through NPC trade chains (A wants X, give Y to A, get Z). Here, no social exchange exists—purely mechanical barriers requiring collected items. The "intelligence" gathering (copying picture) is environmental observation, not NPC negotiation.
+
+
+**Comparison to Multi-Faceted Plan**: MFP gathers parallel requirements from different NPC dialogues/situations. This infiltration has SEQUENTIAL dependencies: cannot copy picture before obtaining janitor access; cannot steal keycard before boss leaves office; vaporizing cans happens continuously during passage, not as discrete "gather this item" objective.
+
+
+**Security Design Pattern Analysis**:
+- **Redundant Authentication**: Final door requires BOTH card AND face scan—even stealing Elmo's identity isn't enough without his physical card
+- **Behavioral Enforcement**: Not just wearing disguise—must perform janitorial duties correctly or guards recognize fraud
+- **Temporal Windows**: Boss absence creates single opportunity for credential theft
+
+---
+
+### Quest for Glory III: Thief Espionage Routes (QFG3)
+
+**Setup**: In QFG3, the Thief class has unique infiltration mechanics available throughout the war/siege narrative. Unlike the Fighter's diplomatic routes or Wizard's magical solutions, the Thief can steal critical items through stealth-based penetration of enemy territory at night. These are parallel to—rather than replacements for—the main diplomatic quest lines.
+
+<small>Source: qfg3-gamefaqs-cyricz.txt, lines 2963-2970 — "Wait until nighttime and return to the Laibon's hut... Go outside the hut and go back inside. You're supposed to climb in through a crack in the wall."</small>
+
+<small>Source: qfg3-gamefaqs-cyricz.txt, lines 2996-2998 — "Infiltrate the Chief's Hut by crawling under it... The panther is outside the door. It'll be easier if you feed it some meat first (5), but you can also just dodge and jump through tightrope."</small>
+
+```
+THIEF INFILTRATION ROUTE A: Laibon's Hut - Steal Magic Drum
+
+OBJECTIVE: Obtain Magic Drum without diplomatic acquisition (Fighter receives it from Laibon after Warrior Initiation)
+
+PHASE 1 - TIMING WINDOW IDENTIFICATION:
+Requirement: Wait until NIGHTTIME in game clock cycle
+Action: Monitor sun position (Special icon → hourglass menu)
+Constraint: Must be night; daytime infiltration fails immediately
+
+PHASE 2 - PERIMETER BREACH (Crack Exploitation):
+Location: Laibon's Hut exterior, Simbani Village
+Obstacle: Normal door guarded/patrolled during night hours
+Sensory Exploitation: Crack in wall visible but requires Fine Dagger to widen
+Action Sequence:
+- Exit hut area → Walk around building to find crack in mud-brick wall
+- USE Fine Dagger on crack → creates entry point sized for Thief character model only
+- CRAWL through crack while SNEAK mode active (Stealth stat checked)
+
+PHASE 3 - INTERIOR NAVIGATION (Hidden Compartment Access):
+Interior State: Laibon sleeping; Magic Drum displayed in locked compartment
+Action Sequence:
+- Move silently through hut interior (Sneak verb must remain active)
+- APPROACH shelf/altar where Drum is stored (no key needed—compartment is unlocked for narrative reason: Laibon trusts it's safe)
+- TAKE Magic Drum → Item added to inventory without triggering alarm
+
+PHASE 4 - EGRESS (Reverse Entry):
+Exit Method: Same crawl-out through crack in wall
+Risk Assessment: If awakened during exit → immediate combat failure state
+Result: Possession of Magic Drum via theft rather than gift
+
+
+THIEF INFILTRATION ROUTE B: Leopardmen Chief's Hut - Steal Spear of Death
+
+OBJECTIVE: Obtain Spear of Death by stealth instead of peaceful exchange after returning Magic Drum
+
+PHASE 1 - ACCESS GAIN (Nighttime Village Entry):
+Prerequisite: Already know path to Leopardmen Village (via Johari guidance or Wizard/Fighter route)
+Timing: Must be night; panther guard less active
+Constraint: If discovered → combat with Chief or panther
+
+
+PHASE 2 - PANTHER GUARD BYPASS:
+Obstacle: Panther blocks hut entrance door
+Sensory Exploitation Options:
+
+OPTION A (Preferred - Safer): Feed Meat to Panther
+- Prerequisite: Carry raw meat in inventory
+- Action: USE Meat on ground at panther feet
+- Result: Panther distracted eating; guard effectively removed for ~30 seconds
+- Points: +5 puzzle points demonstrated
+   
+OPTION B (Risky - Stealth Check): Dodge/Past Through Timing Window
+- Requirement: High Agility and Stealth stats
+- Pattern: Panther patrol has predictable left-right movement cycle
+- Action: Time movement between patrols using tightrope mechanics
+- Failure State: Attack initiated if caught in middle of crossing
+
+
+PHASE 3 - INTERIOR THREATS (Monkey Distraction System):
+
+THREAT A: Noise-Making Monkey Inside Hut
+Discovery: Upon entering, player hears monkey squeaking/movements
+Mechanical Effect: If monkey continues making noise → wakes sleeping Chief → combat/failure
+
+Solution Pattern (Sensory Exploitation):
+- Locate food items on shelves (Fruit)
+- USE Fruit to feed monkey → monkey occupied eating for extended duration
+- Additional points (+5) for freeing monkey into jungle after taking spear
+
+THREAT B: Chief's Sleeping Position Blocks Spear Access
+Observation: Chief sprawled across floor directly beneath hanging spear
+Solution Sequence:
+- Crawl under hut entrance (Thief-specific action not available to other classes)
+- Move around Chief without stepping on floorboards that creak
+- Approach wall where Spear of Death mounted
+
+
+PHASE 4 - TARGET ACQUISITION:
+
+Action: TAKE Spear of Death from wall mount
+Points Awarded: +10 for successful theft WITHOUT waking Chief
+Risk: If Chief awakens during theft attempt → immediate combat initiated with unfavorable odds
+
+
+CRITICAL DISTINCTION FROM FIGHTER ROUTE:
+
+Fighter's Approach (Diplomatic Exchange):
+- Complete Warrior Initiation trials
+- Marry Johari through bride-price ceremony  
+- Return Magic Drum to Leopardmen Chief in person
+- Negotiate peaceful return of Spear of Death
+- Points earned honorably; maintains narrative of preventing war
+
+Thief's Approach (Espionage Operations):
+- Infiltrate Laibon's Hut at night → steal Magic Drum first
+- Enter Leopardmen Village under cover of darkness
+- Defeat panther guard through sensory exploitation (meat distraction)
+- Bypass monkey security by feeding fruit
+- Steal Spear of Death from Chief's hut with Stealth checks
+- Points earned through skill demonstration, not honor
+
+BOTH PATHS ACHIEVE SAME NARRATIVE OUTCOME: Peace conference possible because both artifacts recovered. The Thief simply demonstrates class-specific mechanics (stealth, lockpicking, timing windows) rather than Fighter's combat/trials or Wizard's magical solutions.
+
+WHY IT'S CORPORATE INFILTRATION (NOT SIMPLE STEALTH PUZZLE):
+
+MULTIPLE LAYERS OF SECURITY:
+- Layer 1: Temporal restriction (nighttime only—guards/monsters different behavior patterns)
+- Layer 2: Physical barrier exploitation (crack in wall requires Thief-size model + tool use)
+- Layer 3: Interior guard AI (panther with detectable patrol cycles, exploitable via feeding)
+- Layer 4: Secondary threat system (monkey noise alert mechanism)
+- Layer 5: Target accessibility (requires navigating around sleeping NPC without triggering awareness)
+
+
+BEHAVIORAL ROLE-PLAY REQUIREMENT (THIEF IDENTITY):
+Must maintain Sneak verb active throughout entire sequence. Unlike SQ3's janitor disguise where player PERFORMS duties, Thief infiltration requires PLAYER TO NEVER ACT like a non-thief—continuous stealth mode demonstrates class specialization as core mechanic.
+
+
+TEMPORAL WINDOW DEPENDENCIES:
+- Laibon's Hut theft must occur at night but BEFORE Magic Drum given back diplomatically (inventory conflict)
+- Chief's Hut infiltration has dual constraints: nighttime requirement + panther patrol cycle timing
+- Monkey feeding creates extended window but still time-bound before natural awakening
+
+
+PARALLEL TO SQ3 ARCHITECTURE:
+
+Shared Pattern with SpaceQuest III:
+- SQ3: Invisibility belt → Janitor disguise → Maintain by vaporizing cans → Photocopy credentials → Steal keycard during absence → Combine authentications at final door
+- QFG3 Thief: Nighttime entry → Crack wall infiltration → Feed panther for access window → Distract monkey with fruit → Navigate sleeping guard room → Extract target item
+
+Both use multi-stage barriers where each layer requires different solution (temporal + physical + behavioral avoidance + sensory exploitation). The core mechanic of "bypass security not through confrontation but through systematic barrier removal" is identical despite vastly different narrative contexts.
+```
+
+<small>Source: qfg3-gamefaqs-cyricz.txt, lines 2958-2971 — Thief Laibon's Hut infiltration sequence</small>
+
+<small>Source: qfg3-gamefaqs-cyricz.txt, lines 2991-3004 — Leopardmen Chief hut stealth entry with panther and monkey obstacles</small>
+
+---
+
+### INDY1: Corridor Guard Disguise System (Servant/Officer Uniforms)
+<small>Source: walkthrough-king.txt, lines 161-188</small>
+
+**Setup**: Castle Brunwald contains multiple Nazi guards patrolling corridors on the ground floor and 2nd floor. Each guard presents a blocking condition that can be bypassed through three distinct methods: direct combat (violence path), dialogue negotiation (persuasion path), or wearing appropriate disguise uniforms. Two uniform types exist in circulation: servant uniform (access to lower-security areas) and officer's uniform (grants high-level access, requires brass key to unlock).
+
+**Blocking Condition - Multi-Layer Security**: Guards patrol corridors on two floors with conditional detection behaviors based on player appearance:
+- Ground floor corridor: Drunk guard + patrolling guard + armored closet area
+- 2nd Floor: West corridor guard (patrols east-west), additional guards at doorways
+- Each guard responds differently depending on whether Indy wears no uniform, servant clothes, or officer's attire
+
+<small>Source: walkthrough-king.txt, lines 166-169 — "There is another guard in the corridor to the west, and there are 3 ways to deal with him. Dressed as Indy, you can talk to him (1, 2, 2)... or... change into the servant's uniform, then talk to him (1, 1, 3, 2)"</small>
+
+**Solution Chain — Uniform Acquisition Sequence**:
+
+PHASE A - SERVENT UNIFORM (Ground Floor, Lines 161-164):
+1. Navigate past initial guard via combat or dialogue negotiation
+2. Enter closet room on east side of green carpet area
+3. TAKE servant uniform from unlocked storage (officer's uniform locked here—requires key)
+4. CHANGE INTO servant costume at closet or any accessible wardrobe
+5. Return to corridor, approach guards wearing servant disguise
+6. Guards accept lower-priority dialogue tree (different conversation options available)
+
+PHASE B - OFFICER'S UNIFORM REQUIREMENTS (2nd Floor Loop, Lines 174-183):
+1. Ascend to 2nd floor, follow corridor east, enter northern room
+2. Take 50 Marks from chest in this room
+3. Return south, navigate through west-patrolling guard (now bypassable as servant)
+4. Enter western door when corridor turns north
+5. Open chest → find OFFICER UNIFORM package inside
+
+<small>Source: walkthrough-king.txt, lines 179-180 — "Open the chest and look inside to get a uniform. Look at it to find a brass key."</small>
+
+6. INSPECT uniform in inventory → discover BRASS KEY hidden inside (essential item for unlocking)
+7. Return downstairs to ground floor closet where officer's uniform was originally locked
+8. USE brass key on closet lock
+9. TAKE officer's uniform (now unlocked) into inventory
+
+PHASE C - DISGUISE ACTIVATION (2nd Floor Activation, Lines 183-184):
+10. Ascend back to 2nd floor room containing 50 Marks chest (has change wardrobe option)
+11. CHANGE INTO officer's uniform at this location
+12. Exit through alternate door in same room
+
+PHASE D - HIGH-LEVEL ACCESS GRANTED (Lines 184-187):
+13. Encounter guard past exit door—new dialogue options available as officer: TALK (option 2, 2, 3) vs combat
+14. Continue north and east through previously inaccessible passages
+15. Enter northern office door—guard allows access based on officer status recognition
+
+<small>Source: walkthrough-king.txt, lines 186-187 — "Dressed as an officer, talk to this guy (2, 2, 3)... If you were dressed as an officer, this conversation will help you later on."</small>
+
+16. Navigate past guards who would have blocked combat/required payment when wearing civilian clothes
+17. Maintain officer disguise through security zones (guards defer to authority rather than challenge)
+
+**Why It's Corporate Infiltration Disguise Layering**: Unlike simple Sensory Exploitation (single vulnerability attack like "feed dog boar"), this puzzle implements MULTI-STAGE AUTHENTICATION where each disguise tier unlocks progressively access patterns:
+- **Tier 1 (No uniform)**: Guards respond with hostility—requires combat or monetary payment (15+ marks per guard)
+- **Tier 2 (Servant uniform)**: Guards recognize lower status—different dialogue, no payment required, but limited zone entry
+- **Tier 3 (Officer uniform)**: Guards recognize authority—complete corridor access, privileged conversations that advance plot
+
+The locked uniform requiring brass key demonstrates REDUNDANT AUTHENTICATION similar to SQ3's final door (keycard + photo scan). Player must acquire ITEM FROM LOCATION A (brass key in officer's package) → unlock RESTRICTION AT LOCATION B (ground floor closet lock) → obtain ITEM C (officer's uniform) → activate at LOCATION D (2nd floor wardrobe) → gain ACCESS PATTERN E (corridor passages previously blocked by guards).
+
+**Behavior Verification Mechanic**: Unlike SQ3 where vaporizing cans continuously tests whether you're "really a janitor," the disguise system here uses CONTEXTUAL DIALOGUE VERIFICATION. Guards don't periodically check if you're a "real officer"—instead, they recognize uniform type at first encounter and modify their response accordingly. The verification happens through available conversation trees (officer gets options 2-2-3, servant gets options 1-1-3-2), not behavioral performance checks.
+

src/puzzles/cross-realm-logistics.md

@@ -0,0 +1,467 @@
+# Cross-Realm Logistics Puzzle
+
+## Mechanic Definition
+
+The player must manage items across multiple locations/worlds/states—transporting items between places, combining ingredients from different sources, or ensuring items survive transitions. The puzzle tests spatial and temporal thinking about inventory: what to carry, what to acquire, and when.
+
+"Realms" can be literal (dimensions, afterlife, parallel worlds) or figurative (factions, time periods, game states).
+
+## Information Architecture
+
+**Conveyance Method**: Requirement discovery through exploration
+- Player learns what ingredients are needed through books, dialogue, or failed attempts
+- Player must discover where each ingredient is located across different realms
+- Player must determine how to transport/combine items appropriately
+
+**Player Action Pattern**:
+1. Learn what's needed (through text or failed attempts)
+2. Determine where each component is located
+3. Travel to each location and acquire items
+4. Transport items to combination point
+5. Execute combination → solution achieved
+
+**Core Mechanic**: The puzzle tests forward planning and spatial awareness. Players must remember what they'll need in future locations while managing limited inventory space.
+
+## Design Rationale
+
+- Rewards planning—thinking ahead about future requirements
+- Creates world interconnection—realms feel connected through items flowing between them
+- Adds strategic depth—inventory management becomes meaningful
+- Enables payoff moments—items from early exploration save you later
+
+## Why It's Effective
+
+The satisfaction comes from "just in time" inventory management—having the right item when you need it because you planned ahead. This rewards thorough exploration without punishing missed content.
+
+## Mechanic Variations
+
+| Variation | Realm Type | Logistics Challenge |
+|-----------|-----------|-------------------|
+| Dimensional | Parallel worlds | Items may not exist in all realms |
+| Temporal | Time travel | Items must be retrieved before they're "taken" |
+| Faction-based | Political states | Items must be traded between hostile groups |
+| State-based | Game states | Items only available in certain conditions |
+
+## Generic Example Structure
+
+**Goal**: Complete [Crafting/Activation] requiring [Ingredients]
+
+**Information Flow**:
+- Player learns through text: "The spell requires coal, egg, and hair"
+- Player discovers locations: Coal at [Location A], Egg at [Location B], Hair at [Location C]
+- Player must travel to each location and collect items
+- Player must transport items to [Location D] for combination
+- Player executes combination → spell complete
+
+**The puzzle**: Managing items across locations with limited inventory space and no explicit tracking of what's needed.
+
+## Adventure Game Implementation
+
+The limited action set creates specific challenges:
+- WALK between realms—travel has cost/time
+- Inventory management—limited space forces decisions
+- USE items in correct sequence/location
+- The puzzle rewards players who explore thoroughly early
+
+This puzzle tests: "Can I think spatially about where items are and plan my inventory accordingly?"
+
+---
+
+## Game Examples
+
+### Indiana Jones: Fate of Atlantis - Orichalcum Bead Management (INDY2)
+
+**Problem**: Throughout the game, Indy must collect nine orichalcum beads from multiple geographically dispersed locations. Beads are required for various puzzles but also vulnerable to being lost through path-dependent events. Additionally, some puzzle solutions (the golden box, Nur-Ab-Sal's necklace) REQUIRE specific bead counts at exact moments, forcing precise inventory tracking across the entire playthrough.
+
+<small>Source: walkthroughking_ashley_walkthrough.html — "Pick up the shiny bead" (Tikal), "put the orichalcum bead in the eel's head to free it from the ice" (Iceland), and multiple later references including "put the two orichalcum beads in the box and close the lid."</small>
+
+**Beac Acquisition Path (Multiple Locations)**:
+```
+BEAD 1-2: Iceland + Tikal (early game, guaranteed)
+BEAD 3: Monte Carlo sunstone puzzle (all paths converge here)
+BEAD 4-5: Atlantis golden box retrieval (mid-game)
+BEAD 6-7: Labyrinth exploration (varies by path—Team/Wits get them different ways)
+BEAD 8: Fists path exclusive combat encounters OR Wits/Team puzzle solution
+BEAD 9: Very late game, often requires backtracking with specific inventory setup
+
+<small>Source: walkthroughking_ashley_walkthrough.html — "Pick up the worldstone and Sternhart's staff...put the two orichalcum beads in the box" (Atlantis section)</small>
+```
+
+**Critical Inventory Management Moments**:
+
+1. **Golden Box Loading**: In Atlantis, player must place beads into golden box:
+   - If too few beads collected → Cannot complete puzzle
+   - If ALL beads used earlier → Irrecoverable failure state possible
+   
+2. **Orichalcum Detector Calibration**: The amber fish detector points toward orichalcum:
+   - Player must hide ONE bead in gold box + close lid (detector then ignores inventory)
+   - This allows detector to locate HIDDEN beads in environment
+   - WRONG ORDER (use detector before hiding bead) → Detector points at player, fails
+
+<small>Source: walkthroughking_ashley_walkthrough.html — "put the two orichalcum beads in the box and close the lid...Use the fish and it will point at Sophia's necklace"</small>
+
+3. **Path-Dependent Loss**: Wits path uses bead to charge statue for truck escape:
+   - Consumes one bead permanently
+   - Team/Fists paths have alternative solutions without bead cost
+   - Player must know which path's bead economy they're on
+
+**Why It's Cross-Realm Logistics**:
+1. **Multiple Geographic Realms**: Beads sourced from Iceland, Tikal, Monte Carlo, Crete, Atlantis—each realm requires separate journey
+2. **Inventory Planning Required**: Nine beads scattered across 6+ distinct locations; player must track acquisition state without explicit progress indicator
+3. **Consumption vs. Preservation Trade-offs**: Some puzzles consume beads (Wits path statue charge), others require bead storage (golden box, detector calibration)
+4. **Backtracking Penalties**: Forgetting to collect bead at Location A = potentially impossible late-game puzzle without re-visiting with correct inventory setup
+
+**Distinction from Multi-Faceted Plan**: MFP is about parallel requirement discovery for single immediate solution. Here, beads are collected INDEPENDENTLY across hundreds of gameplay minutes, then SYNTHESIZED in multiple separate puzzles (golden box, final machine operation) at the end—true long-term logistics.
+
+---
+
+### King's Quest VII: Crystal of Sunlight Multi-Chapter Transport Chain (KQVII)
+
+**Problem**: Lady Ceres requires "crystal of purest sunlight" to complete transformation spell in Chapter 6. However, obtaining and activating this crystal requires traveling through multiple distinct game chapters and realms over extensive playtime, with the item itself being useless until the very final step.
+
+<small>Source: walkthroughking_kq7.html:95-98</small>
+
+**Item Acquisition Chain (Chapters 3-5)**:
+```
+PHASE 1 - Crystal Retrieval (Chapter 4/5 transition):
+Starting Position: Etheria realm (reached via Horseman's fife after Chapter 4)
+
+Step 1: Return from Etheria to Malicia's house area:
+        - South → west from Etheria mountain peak
+        - Jump down bottom-left rainbow → returns to desert area
+        
+Step 2: Infiltrate Malicia's house (stealth timing puzzle):
+        - Back of house, examine green vine for hidden hole
+        - Timing requirement: walk away if dog barks, wait for silence window
+        - Enter during quiet period when patrol absent
+        
+Step 3: Navigate house interior to lamp room:
+        - Climb up into house from basement entry
+        - Malicia/dog return pattern must be timed (listen for cues)
+        - Go back down when they approach, up again when they leave
+        
+Step 4: Collect crystal from lamp fixture in bottom right of room:
+        - Crystal appears as generic item initially
+        - No indication yet that it needs sunlight exposure
+        
+Phase 2: Exit sequence requires fife use + rainbow transport (timing critical)
+```
+
+**PHASE 3 - Sunlight Activation (Chapter 5/6 transition)**:
+```
+Step 5: From Malicia's house, blow Horseman's fife → escape to desert via rainbow transport
+        - Jump down top-left rainbow specifically (different from entry rainbow!)
+        
+Step 6: Navigate沙漠 back to temple building:
+        - North twice from desert spawn point
+        - Enter door of ancient structure
+        
+Step 7: Find beam of sunlight streaming through upper window:
+        - Environmental clue: bright spot on floor indicating light source position
+        
+Step 8: Hold crystal IN the beam of sunlight (inventory use action):
+        - Crystal transforms/activates during this step
+        - Now becomes "charged" version usable for Maab rescue puzzle
+        
+PHASE 4 - Final Application (Chapter 6):
+Step 9: Transport now-activated crystal back through realms via fife/rainbow/harp travel
+Step 10: Access Isle of Dreams cave where Lady Maab imprisoned in ice
+Step 11: Use activated crystal on ice block → Maab freed, puzzle resolved
+```
+
+**Why It's Cross-Realm Logistics**:
+1. **Extended Geographic Spread**: Crystal journey spans at least 4 distinct zones:
+   - Etheria (starting point after Chapter 4)
+   - Malicia's house (infiltration area near starting desert)
+   - Desert temple building (sunlight activation zone)
+   - Isle of Dreams cave (final application in late game)
+
+2. **Long-Term Item Maintenance**: Crystal must be:
+   - Collected during Chapters 4-5 transition
+   - Maintained in inventory through Chapter 5 completion
+   - Transported to proper realm for final use
+   - NOT consumed or lost to other puzzles (no backup crystals exist)
+
+3. **Multi-Transport System Dependency**: Requires mastery of three separate transportation mechanics:
+   - Horseman's fife (immediate realm shift via magic instrument)
+   - Rainbow bridges (specific directional jumps between rainbow types)
+   - Harp transportation (Etheria → Fates travel, potentially needed for repositioning)
+
+4. **Temporal Span**: Crystal obtained potentially 3-5 chapters before activation, 6+ chapters before final use in Maab rescue. Player must remember:
+   - Item exists and wasn't used elsewhere
+   - Item has hidden potential (sunlight charging not obvious from description)
+   - Activation requires specific environmental condition (sunbeam location)
+
+**Backtracking Failure State**: If player somehow loses crystal or uses it prematurely before sunlight activation, puzzle becomes impossible without save/reload. No second crystal exists anywhere in game world. This makes inventory management CRITICAL rather than optional.
+
+**Connection to Other Puzzles**: The Horseman's fife itself is obtained from Chapter 4 Horseman puzzle chain—the same transport item needed for crystal logistics comes from a separate meta-puzzle construction, creating cross-dependency between puzzle types.
+
+---
+
+### King's Quest VII: Werebeast Salve Ingredient Maintenance (KQVII)
+
+**Problem**: Jackalope fur collected in Chapter 1 must be preserved across 3+ chapters until were-beast salve can be crafted in Chapter 5. Represents inventory logistics where early-game item only becomes functional through mid-game synthesis.
+
+<small>Source: walkthroughking_kq7.html:67, 91-92</small>
+
+**Logistics Chain**:
+```
+CHAPTER 1 - Initial Acquisition (Desert):
+- During hunting horn rabbit hole sequence (same as glasses puzzle)
+- Collect jackalope fur from cactus near animated rabbit burrow  
+- Item stored in inventory with no immediate puzzle solution requiring it
+- Multiple other items collected during same exploration (glasses, later traded to mouse)
+
+INTERCHAPTERS 2-4 - Inventory Maintenance:
+- Fur remains in inventory through transformation cure sequence (Chapter 2)
+- Maintained through Chapter 3 town puzzles (bird/mask/trades with Fernando and Ersatz)
+- Carried through Chapter 4 graveyard sequences without consumption
+
+CHAPTER 5 - Item Activation and Application:
+Step 1: From mirror maze, obtained magic statuette in Chapter 3
+        - Statuette maintained through Chapters 3-4 while completing other puzzles
+        
+Step 2: Visit snake merchant with magic statuette
+        - Trade statuette for were-beast salve liquid (consumes statuette permanently)
+        
+Step 3: Combine jackalope fur + werebeast salve in inventory
+        - Creates functional werebeast potion
+        - Jackalope fur was CRITICAL component; without it, trade with merchant useless
+        
+Step 4: Use combined potion on self before running through weed monster territory
+        - Transforms player temporarily to outrun vegetation threat
+```
+
+**Why It's Cross-Realm Logistics (Simple Form)**:
+1. **Extended Temporal Separation**: Fur collected in Chapter 1 ≈15+ minutes of gameplay, used in Chapter 5 final puzzle sequence = potentially 30-45 minutes later in playtime
+2. **Zero Immediate Feedback**: No indication when collecting fur that it matters. Player discovers its value only when encountering snake merchant much later
+3. **Permanent Consumption Risk**: If player deletes or loses inventory during Chapters 2-4 (via death, intentional reset, confusion), puzzle becomes impossible—no second jackalope location
+4. **No Progress Marker**: Game provides no hint that "jackalope fur = required" until Chapter 5 trade opportunity appears
+
+**Distinction from Long-Term Multi-Faceted Plan**: While both span time, this emphasizes LOGISTICS (item maintenance across boundaries) over discovery synthesis. Player isn't combining multiple independently-discovered pieces in one location—they're maintaining a single piece across multiple gameplay contexts until synthesis opportunity arises.
+
+---
+
+### SpaceQuest IV: Multi-Time-Period Item Transport (SQ4)
+
+**Problem**: Roger must travel through four different Space Quest game worlds (XII, X, I, and back to XII) collecting items in each that are only usable in other time periods. The game requires remembering what to grab where across a 60+ minute playthrough spanning multiple distinct gameplay environments with no inventory transfer warnings or guidance.
+
+<small>Source: gamefaqs-tricrokra-archive.html, lines 720-775 — Full item list documentation shows cross-period dependencies</small>
+
+<small>Source: gamerwalkthroughs.html — Walkthrough emphasizes multi-world navigation and item carry-through requirements</small>
+
+```
+TIME PERIOD VISIT SEQUENCE WITH INVENTORY MANAGEMENT:
+
+PERIOD 1 - SpaceQuest XII (Future/Xenon): [Initial Acquisitions]
+
+
+Location: Future Xenon wasteland, first area encountered
+Items Collected Here (Critical for LATER periods):
+  A. Rope → Used immediately to catch bunny, NOT carried forward
+  B. Battery (from bunny) → CRITICAL: Must keep in inventory until FINAL XII return
+     - Purpose: Power PocketPal later at Vohaul's base
+     - Risk: Players might discard if it seems useless early game
+  C. Jar of Green Acid → CRITICAL: Required when returning to XII for laser tunnel door
+     
+Items "Optional" Collectibles:
+  D. Unstable Ordnance (nitroglycerin cylinder) → Must return to tank, not carried
+
+KEY LOGISTICS DECISION: Both Battery and Acid must SURVIVE multiple time period transitions without consumption or discard. No gameplay feedback confirms these are important before XII return.
+
+
+PERIOD 2 - SpaceQuest X (Estros Planet): [Information Gathering]
+Location: Strange pre-human alien world with giant bird nests
+
+Items/Info Collected:
+  A. Gum Wrapper Code Fragments → Physical item carrying data, not consumable
+     - Contains 3 symbols needed for time pod navigation code
+     - Must be remembered/examined later in Mall sequence
+     - Combined with hint book data = complete Ulence Flats destination
+
+Critical Decision: This is INFORMATION, not an "inventory item" per se. Player must mentally retain the symbol data through subsequent locations.
+
+
+PERIOD 3 - SpaceQuest X (Galaxy Galleria Mall): [Multi-Requirement Acquisition]
+Location: Massive shopping mall with multiple stores and minigames
+
+Items Collected (Complex Logistics):
+  A. Cigar → CRITICAL: Needed in XII for laser visibility smoke
+     
+    - Obtained when fired from burger job (must remember to retrieve!)
+    - Walkthrough explicitly warns: Cannot get beyond this point
+  
+  B. Matches → ERROR CORRECTION: Actually collected in SQ I, not Mall
+     - This shows player confusion potential—different walkthroughs may misplace items
+  
+  C. Hint Book (Space Quest IV manual) → Physical item with embedded data
+     
+    - Page 4: Ulence Flats time pod code (completes gum wrapper info)
+    - Page 7: Supercomputer access code "6965847669" for final door
+     - Must be consulted/referenced across multiple subsequent periods
+  
+  D. PocketPal Connector → CRITICAL technical component
+     - Bought at Electronics store (Hz. So Good/Radio Shock)
+     - Must be SPECIFIC plug type matching XII computer room socket
+     - Combined with Battery (from period 1) + PocketPal device = functional terminal
+   
+Time Pressure Element: Must lure police away from time pod through Skate-O-Rama roof escape before accessing pod—police arrival triggered by buying connector.
+
+
+PERIOD 4 - SpaceQuest I (Ulence Flats): [Critical Item Recovery]
+Location: Retro-styled alien planet recreation of original SQ1 setting
+
+Items Collected:
+  A. Matches from bar counter → CRITICAL for XII laser puzzle
+     - Requires clearing biker gang first (mini-chase sequence)
+     - Used with Cigar at laser tube to reveal invisible beams
+     - Classic cross-period dependency: Item in I for use in XII
+  
+
+PERIOD 5 - SpaceQuest XII Return (Final Confrontation): [Synthesis Phase]
+
+Location: Back at Vohaul's base, previously visited environment now fully unlockable
+
+INVENTORY SYNTHESIS REQUIRED (All items must still be held):
+  
+  ✓ Green Acid (from Period 1): Unlock laser tunnel door
+  
+  ✓ Cigar + Matches: Combined to create smoke → reveal lasers
+  
+  ✓ Battery + PocketPal + Connector: Power computer terminal, map droid locations
+  
+  ✓ Hint Book Page 7 Code: Enter supercomputer access code ("6965847669")
+  
+  ✓ Mental Retention of laser degree codes: From visible angles after smoke
+
+
+SUCCESS CONDITION: All cross-period items maintained through complete playthrough. FAILURE STATES include discarding "seemingly useless" battery/acid early, or forgetting cigar collection point during mall chaos.
+
+
+WHY IT'S CROSS-REALM LOGISTICS:
+
+1. **Temporal Span**: Items collected at start of game (0-5 minutes) used at end (60+ minutes), through THREE intervening completely-different game worlds
+  
+2. **No Progress Tracking**: Game provides NO "you need X items for future" checklist. Pure player memory and forward planning
+  
+3. **Multiple Realm Transitions**: Four distinct Space Quest titles' aesthetics/rules—item must survive all transitions
+  
+4. **Critical Path Items Appear "Optional"**: Green acid jar, cigar butt, and battery have no immediate purpose when first obtained, making their importance unclear
+  
+5. **Combination at End Requires All Parts**: Final sequence is pure synthesis: items from period 1 + info from period 2 + gear from period 3 + tools from period 4 = completion
+  
+6. **No Retry Mechanism for Forgotten Items**: Unlike inventory management puzzles where you can revisit old areas, this is STRICTLY LINEAR progression with one-time collection points. Miss the cigar in the mall? Cannot return to get it later.
+```
+
+**Distinction from Multi-Faceted Plan**: MFP gathers items for ONE location's puzzle. Cross-Realm Logistics requires maintaining items across ENTIRE PLAYTHROUGH through multiple environments, each providing critical components only usable elsewhere. The "Mall Sequence" (period 3) WITHIN SQ4 IS an MFP—but the OVERALL game structure is Cross-Realm Logistics spanning ALL four time periods.
+
+---
+
+## Related Types
+
+- **Multi-Faceted Plan**: MFP gathers requirements for one immediate solution; Cross-Realm spreads acquisition over extensive gameplay
+- **Meta-Puzzle Construction**: MPC creates strict sequential chains; Cross-Realm Logistics allows parallel collection across space/time
+
+---
+
+### Legend of Kyrandia: Darm's Scroll Dual Application (LK1)
+
+**Problem**: Darm gives Brandon a single scroll with icy magic that must be used TWICE in completely separate game worlds, for unrelated puzzle types. The scroll represents classic cross-realm logistics where one item bridges multiple geographic domains and serves non-obvious future purposes beyond its immediate acquisition context.
+
+<small>Source: classicgamesparadise_walkthrough.html, lines 112, 183, 245 — Scroll received from Darm after quill trade; used at volcanic river AND burning branch in Faeriewood</small>
+
+<small>Source: bonny_ploeg_walkthrough.html, line 113 — "Scroll With Icy Power - Received from Darm after you've given him the quill. Used twice: at the volcanic river and at the fiery bush."</small>
+
+```
+ITEM ACQUISITION PHASE (Timbermist Woods):
+
+Step 1 - Quill Collection Chain:
+- Explore Timbermist Woods, find injured songbird near nesting area
+- Songbird won't give quill until healed
+- Heal bird using yellow gem (healing power from Deadwood Glade puzzle)
+- Bird drops quill as reward
+
+Step 2 - Scroll Exchange:
+- Return to Darm's shack with quill in inventory
+- Give quill to Darm → dialogue exchange about "stones and the altar"
+- Darm writes and gives FREEZE SCROLL to Brandon
+- Scroll description indicates icy/freezing magic properties
+
+
+CROSS-REALM APPLICATION #1: Volcanic River Crossing (Serpent's Grotto)
+
+Location: Cave system after Darkmouth area, before Iron Key chamber
+
+Problem State:
+- Volcanic river blocks path forward, lava too hot to cross directly  
+- Iron Key visible on opposite bank but unreachable
+- No bridge or alternate route available
+
+Scroll Application:
+- Use Darm's scroll on volcanic river surface
+- Icy magic freezes lava into solid traversable path
+- Walk across frozen river, collect Iron Key
+- Path remains frozen for duration sufficient to complete crossing
+
+Critical Decision Point - Inventory Management:
+<small>Source: classicgamesparadise_walkthrough.html, line 183 — "Make sure you don't throw away the scroll just yet; it will come in handy again later"</small>
+<small>Source: bonny_ploeg_walkthrough.html, line 63 — "Now you can drop the scroll to save space" (given AFTER Faeriewood use)</small>
+
+Player MUST recognize scroll remains CONSUMABLE-ONCE but still usable AGAIN in different context. Common player mistake: discard scroll after lava crossing due to "item used" assumption or inventory pressure.
+
+
+CROSS-REALM APPLICATION #2: Burning Branch Extinguishment (Faeriewood)
+
+Location: Faeriewood realm - separate magical dimension accessed through cave system
+
+Problem State:
+- Malcolm steals one of Zanthia's crystal balls, ruins alchemy fountain
+- Missing crystal ball hidden inside burning branch/fire bush in western Faeriewood
+- Flames prevent direct interaction; cannot grab ball without extinguishing fire first
+
+Scroll Application (Second Use):
+- Navigate to burning branch location (requires Faeriewood exploration)
+- Use Darm's scroll on flames → icy magic extinguishes fire
+- Burnt bush now accessible, missing crystal ball can be collected
+- Return ball to fountain, restore Zanthia's laboratory
+
+
+WHY IT'S CROSS-REALM LOGISTICS:
+
+1. GEOGRAPHIC SEPARATION: Two applications span distinct game zones:
+   - Acquisition: Timbermist Woods (opening game area)
+   - Application 1: Serpent's Grotto volcanic cave (mid-game dungeon)  
+   - Application 2: Faeriewood magical realm (separate dimension, late mid-game)
+   
+2. TEMPORAL SPREAD: Scroll received early (~5-10 minutes into game), used potentially 30+ minutes later across multiple world transitions
+
+3. NO IMMEDIATE PURPOSE INDICATION: When Darm gives scroll with "stones and altar" hint, player cannot predict:
+   - Lava crossing requirement (Serpent's Grotto not yet visited)
+   - Faeriewood fire puzzle (completely separate dimension)
+   
+4. INVENTORY PRESERVATION CRITICAL: Scroll must be maintained in inventory through entire mid-game section. Discarding after first use = IMPOSSIBLE to retrieve crystal ball without save/reload.
+
+5. MULTIPLE SOLUTION DOMAIN TYPES: 
+   - River crossing = navigation/obstacle puzzle
+   
+   - Branch fire = item retrieval/lockout puzzle
+   Same item solves two mechanically distinct problem types across different spatial contexts.
+
+
+DISTINCTION FROM META-CONSTRUCTION:
+Not sequential because scroll doesn't NEED volcanic river application first, then enable Faeriewood use. Both applications would function independently if player visited zones in opposite order (theoretically). The "logistics" is maintaining one item through multiple game states until BOTH unrelated puzzles present themselves.
+
+
+POTENTIAL PLAYER FAILURE MODES:
+- Discard scroll after lava freezing ("used up" assumption) → blocked from Faeriewood crystal ball
+- Forget scroll exists during Faeriewood exploration → stuck on burning branch puzzle
+- Use scroll incorrectly (e.g., on wrong fire source) → may consume scroll without solving intended puzzle
+
+
+RELATIONSHIP TO OTHER LK1 MECHANICS:
+Darm's scroll represents one of several "carry-through" items in Kyrandia I. Others include:
+- Amulet gems (activated through meta-construction, used across multiple puzzles)
+- Iron Key (obtained via scroll application #1, used later for castle gate)
+```
+
+---

src/puzzles/cross-temporal-causality.md

@@ -0,0 +1,453 @@
+# Cross-Temporal Causality Puzzle
+
+**Information Architecture**: Player actions performed in one time period create immediate, often irreversible consequences in another time period. The causal link may be explicit (direct environmental change) or implicit (historical precedent altering future state). Information about the consequence only becomes available after switching to the other time period's character.
+
+**Player Action Pattern**:
+1. Identify puzzle blocking condition in Time Period A
+2. Discover that changing conditions in Time Period B could resolve it
+3. Analyze what historical event/environmental factor in Period B causes Period A state
+4. Switch to Period B, perform causal action
+5. Return to Period A, verify consequence has manifested
+
+**Core Mechanic**: The puzzle exploits TIME AS AN INVENTORY VARIABLE where actions are NOT constrained to the present moment—changes cascade deterministically from past→present→future (or vice versa for time-sensitive objects flushing), creating solutions that require understanding HISTORICAL CAUSALITY rather than just spatial navigation or item combination.
+
+---
+
+## Variations
+
+| Type | Causality Pattern | Direction | Example |
+|------|-------------------|-----------|---------|
+| **Environmental Destruction** | Object/terrain in past removed → disappears in future | Past→Future | Cherry tree cut down |
+| **Historical Document Alteration** | Written content modified → changes how history records event/direction | Past→Future | Constitution text, contract signature |
+| **Statue/Monument Modification** | Physical form of historical figure changed in past → alters memorial statue | Past→Present | George Washington's pose |
+| **Flushing Mechanism** | Object flushed down toilet sent to different time period → enables item progression | Any→Any | Chron-O-John inventory transfer |
+| **Identity/Reputation Legacy** | Character's historical action becomes their defining trait → referenced in future | Past→Future | Edison family legacy |
+
+---
+
+## Game Examples
+
+### Day of the Tentacle: Freeing Laverne via Tree Destruction (Environmental Destruction)
+
+**Problem**: Laverne is stuck hanging from a kumquat tree two hundred years in the future. The tentacles guarding her won't let anyone approach the tree directly, and she cannot get down herself. No items in Bernard's or Hoagie's inventory can cut ropes or knock her down safely. The blocking condition appears unsolvable within the future timeline alone.
+
+<small>Source: swords_and_software_walkthrough.html, lines 965-973 — "John Hancock is freezing and has a nice blanket. He thinks the others would build a fire for George Washington if he were cold."</small>
+
+```
+SPATIAL/TEMPORAL CONFIGURATION:
+
+FUTURE (2020s - Bernard & Laverne):
+- Laverne's Chron-O-John crashed into tree top, she trapped hanging ~10 feet up
+- Tentacle mansion guards control all ground-level access points  
+- Tree appears as mature kumquat tree (citrus fruit visible)
+
+PAST (1795 - Hoagie):
+- Same mansion location during Constitutional Convention
+- Kumquat tree grows outside near outhouses
+- George Washington present at inn, known for cherry tree chopping legend
+- Thomas Jefferson mentions "cherry trees" as Washington's favorite to chop
+
+CAUSALITY CHAIN ANALYSIS:
+The key insight is that the SAME TREE exists in both time periods. Destroying it in the past means it cannot exist in the future—the kumquat tree Hoagie sees IS the ancestor of the tree Laverne hangs from.
+
+THE CRITICAL CLUE (Metaphor-Literal Application):
+<small>Source: swords_and_software_walkthrough.html, lines 965-987 — "George Washington likes to chop cherry trees."</small>
+
+Historical reference + visual trickery: The kumquat tree in 1795 must BECOME a cherry tree for George Washington to recognize and cut it down.
+```
+
+**Solution Chain**:
+<small>Source: swords_and_software_walkthrough.html, lines 1032-1108</small>
+
+PHASE 1 - DISCOVERY (Hoagie):
+1. Hoagie explores attic in past, finds bucket of red paint
+2. Returns to kumquat tree near outhouses
+
+
+PHASE 2 - METAPHOR-LITERAL BRIDGE:
+3. Use red paint on kumquat tree → tree bark appears crimson/wood-like
+4. Return to main hall, tell George Washington about "cherry tree" outside  
+5. Washington's historical compulsion activates: "I cannot lie—I chopped that cherry tree"
+
+PHASE 3 - CROSS-TEMPORAL CAUSALITY TRIGGERED:
+6. Washington cuts down the "cherry" (painted kumquat) tree with axe
+7. **IMMEDIATE CUTSCENE SWITCHES TO FUTURE**: Laverne's tree VANISHES mid-scene
+8. Laverne and Chron-O-John fall to ground—she is now free to control
+
+```
+CROSS-TEMPORAL MANIFESTATION VISUALIZED:
+
+[1795 - PAST]                          [2026 - FUTURE]
+Hoagie finds red paint                 Laverne hanging, blocked
+    
+↓                                      ↓
+Paints tree RED                        Tree visible in future
+    
+↓                                      ↓
+Convinces Washington                   Tentacle guards watch  
+"cherry tree!"                         waiting for rescue
+    
+↓ [CAUSAL ACTION]                      ↓ [CONSEQUENCE - INSTANT]
+Washington cuts tree TREE FALLS      TREE DISAPPEARS → Laverne falls free
+    
+↓                                      ↓
+History changes:                       Puzzle resolved:
+"Washington chopped cherry tree"       Laverne now controllable character
+```
+
+**Why It's Cross-Temporal Causality**:
+1. **Action Separation**: The SOLUTION (cutting tree) occurs 200+ years before the BLOCKED STATE appears
+2. **Irreversible Change**: Once tree is cut, it cannot be grown back—future state permanently altered
+3. **Causal Chain Discovery Required**: Player must understand that destroying an object's HISTORICAL PRESENCE removes its FUTURE EXISTENCE—not just "get item A, use on B"
+
+**Distinction from Multi-Character Coordination**:
+While two characters are involved (Hoagie acts, Laverne benefits), the CORE mechanic is TEMPORAL CAUSALITY not spatial coordination. In MCC, both characters act simultaneously in separated locations. Here, Hoagie's action COMPLETES before the benefit manifests—the connection is HISTORICAL not SIMULTANEOUS.
+
+**Distinction from Meta-Puzzle Construction**:
+Meta-Construction requires sequential item production (Step A output → Step B input). This puzzle has NO intermediate items—the tree cutting directly alters the game world state across time via WORLD STATE MUTATION rather than CRAFTING.
+
+---
+
+### Day of the Tentacle: Flag Disguise for Laverne (Historical Document Alteration)
+
+**Problem**: Laverne needs to disguise herself as a tentacle to roam freely in the future, but guard tentacles catch any humans attempting to leave designated areas. She explicitly states "I wish I had some sort of tentacle disguise" but no disguise item exists in any character's inventory. The flag on the mansion roof appears tentacle-shaped but she cannot lower it without a crank.
+
+<small>Source: swords_and_software_walkthrough.html, lines 1289-1304 — "Laverne wishes she had some sort of tentacle disguise... Back in the kennel, ask to go to the bathroom, and once you're outside, give the tentacle chart to Hoagie."</small>
+
+```
+BLOCKING CONDITION ANALYSIS:
+
+FUTURE CONSTRAINTS:
+- Laverne flagged as "human" by guard tentacles → immediately captured if roaming
+- Flag on roof has tentacle shape (visually confirmed) but inaccessible
+- Crank needed to lower flag exists in present-day mansion attic, NOT future
+
+PAST OPPORTUNITIES:
+- Betsy Ross sews American flag patterns at inn upstairs
+- She accepts "design changes" from founding fathers placed on table
+- Tentacle Chart (medical diagram of tentacle species) exists as item Hoagie can obtain
+
+CAUSAL PATH:
+The flag Laverne sees in the future IS the result of 1795 design decisions. Changing the historical pattern SPECIFICATION alters what gets manufactured centuries later.
+```
+
+**Solution Chain**:
+<small>Source: swords_and_software_walkthrough.html, lines 1306-1389</small>
+
+PHASE 1 - INFORMATION DISCOVERY (Laverne):
+1. Talk to guard tentacle → get taken to kennel for "human" violation
+2. Express desire for "tentacle disguise"
+3. Ask to use bathroom → exit to outside area momentarily
+4. Give item to Hoagie in past: **Tentacle Chart**
+
+PHASE 2 - HISTORICAL ALTERATION (Hoagie):
+5. Go upstairs to Betsy Ross's room at inn
+6. Place Tentacle Chart among flag pattern designs on table
+7. Betsy Ross accepts chart as "new design from fickle founding fathers"
+
+PHASE 3 - CROSS-TEMPORAL EFFECT MANIFESTS:
+8. **FUTURE FLAG VISUALLY CHANGES** from standard shape to tentacle silhouette
+9. Switch to Bernard in PRESENT time
+10. Access attic, obtain crank from present-day version of mansion
+11. Give crank to Laverne
+
+PHASE 4 - DISGUISE COMPLETION (Laverne):
+12. Return to rooftop via fireplace/chimney
+13. Use crank on flagpole mechanism
+14. Lower now-tentacle-shaped flag
+15. Put on flag as clothing → disguise activates
+16. Laverne now classified as "tentacle appearance" → can roam freely
+
+```
+HISTORICAL DOCUMENT ALTERATION VISUALIZED:
+
+[1795 - PAST - Hoagie]              [2026 - FUTURE - Laverne]
+
+Tentacle Chart exists               Flag visible on mansion roof
+(medical diagram)                   (normal American flag shape)
+                                    
+↓                                    ↓
+Chart placed with Betsy's patterns  Flag still normal at this point                                    
+("fickle founding fathers")    
+                                    
+↓ [DESIGN DECISION ALTERED]         ↓ [VISUAL MANIFESTATION]
+Pattern modified to tentacle        Future flag now tentacle-shaped!  
+shape for historical record         (only visible after chart given)
+                                    
+↓                                    ↓                                   
+History changes:                     Physical access enabled:      
+"Tentacle was early flag design"     Flag can be lowered + worn
+                                      as disguise
+```
+
+**Why It's Cross-Temporal Causality**:
+1. **Document-Based Legacy**: The solution requires modifying a HISTORICAL DOCUMENT (flag pattern) that influences future world state—not just item crafting but CANON ALTERATION
+2. **Two-Stage Completion**: Chart creation (past) + Crank retrieval (present) + Flag lowering (future) spans THREE TIME PERIODS, not one character's timeline
+3. **Information Bridge Required**: Player must understand that Betsy Ross's work DIRECTLY becomes future historical artifact
+
+**Distinction from Environmental Destruction**:  
+Tree puzzle destroys a physical object; flag puzzle CREATES a different historical precedent. One is NEGATIVE CAUSALITY (removing something), this is POSITIVE (adding new design to history). Both are cross-temporal but opposite causal directions.
+
+---
+
+### Day of the Tentacle: Contract for Diamond Money (Historical Document Completion)
+
+**Problem**: Bernard needs a diamond to repair the time machine, but Dr. Fred reveals he cannot afford one—he earned millions from a TV show about the Edison family but forgot to sign the royalty contract before the deadline. The unsigned contract is locked in his safe upstairs; he dreams of opening it but hasn't slept in two years due to nightmares about forgetting the combination (which relates to when he last opened it—while sleepwalking).
+
+<small>Source: swords_and_software_walkthrough.html, lines 1342-1350 — "Dr. Fred can't afford a new diamond because he's broke... forgot to sign the royalty contract in time... He hasn't slept in two years"</small>
+
+```
+THREE-TIME-PERIOD PUZZLE STRUCTURE:
+
+PAST (1795 - Hoagie):  
+- Benjamin Franklin present, working on electricity experiments
+- Lab coat belongs to Franklin's historical wardrobe
+- Founding Fathers drafting Constitution in main hall
+
+PRESENT (1993 - Bernard):
+- Dr. Fred owns safe with contract inside
+- Safe combination forgotten; linked to sleepwalking incident 2 years ago
+- Dr. Fred stays awake via excessive coffee consumption  
+- Cannot afford diamond without signed contract royalties
+
+FUTURE (2026 - Laverne/Tentacles):
+- Statues of historical figures in convention hall
+- George Washington statue holds sword in one hand, other gesture
+- Statue's pose based on his historically documented position during "critical moment"
+
+CAUSAL REQUIREMENT:
+Contract must be signed in PAST for PRESENT royalties to exist. The signer's physical stance when signing determines the historical statue pose in FUTURE, which indirectly reveals safe combination digits through visual clues about Washington's posture at signing time.
+```
+
+**Solution Chain (Abridged - Full version involves more steps)**:
+<small>Source: swords_and_software_walkthrough.html, lines 2080-2140</small>
+
+KEY CAUSAL MOMENTS SPANNING TIME PERIODS:
+
+PHASE A - SLEEP DETERMINATION (Bernard):
+1. Learn Dr. Fred needs decaf coffee to finally sleep
+2. Acquire decaf from future tentacle cafeteria  
+3. Replace Fred's caffeinated coffee with decaf
+4. **Fred falls asleep for first time in 2 years**
+
+PHASE B - SLEEPWALKING CAPTURE (Past → Present):
+5. Fred sleepwalks to safe, enters combination while unconscious
+6. Bernard observes/sketches safe dial positions during sleepwalking event
+7. Combination derived from hand positions
+
+PHASE C - CONTRACT SIGNING ALTERATION (Hoagie - PAST):
+8. Obtain Benjamin Franklin's lab coat in past
+9. Present unsigned contract to historical figures at Constitutional Convention
+10. Convince founders to sign the "constitution" (which is actually Fred's contract)
+11. **CRITICAL CAUSAL ACTION**: George Washington's stance while signing becomes HISTORICAL RECORD
+
+PHASE D - STATUE MANIFESTATION (Future):
+12. In future, Washington statue reflects his exact pose during 1795 signing moment
+13. Statue's sword position = clue to digits Fred used for safe combination  
+14. The statue CHANGE reflects the CONTRACT SIGNING EVENT that just occurred in past
+
+PHASE E - RESOLUTION (Bernard):
+15. Use derived combination on safe
+16. Retrieve signed contract with millions in royalties
+17. Call TV diamond advertisement, purchase real diamond
+18. Install diamond in time machine → endgame accessible
+
+```
+CONTRACT SIGNING CAUSALITY CHAIN:
+
+[1795]                             [1993]                              [2026]
+PAST                               PRESENT                            FUTURE
+
+Franklin's lab coat obtained       Fred sleepwalks                    Convention hall statues
+↓                                  ↓                                  ↓
+Contract presented as              Fred opens safe,                   Washington statue shows
+"Constitution amendment"           Bernard watches hand               pose from signing moment
+                                   positions (combination)
+↓ [SIGNING EVENT]                  ↓                                  ↓ [HISTORICAL RECORD]
+Founders sign document             Safe combination known             Statue's sword position = 
+Washington takes specific          → Fred can open                    digits needed for safe pose
+stance while signing               safely, gets royalties            ← Clue back to combo
+
+      ╰──────────────────┬──────────────────────╯
+                          ↓
+              Historical event created:
+              "Washington's legendary pose"
+              becomes physical clue across time
+
+```
+
+**Why It's Cross-Temporal Causality**:
+1. **Document Legacy Across Eras**: Contract unsigned in 1795 → Fred broke in 1993 → Diamond unobtainable. Signed contract creates entirely different present future.
+2. **Statue as Historical Echo**: Future statue doesn't just commemorate—it ENCODS information about past action physically through pose
+3. **Circular Clue Structure**: Combination discovered via sleepwalking (PRESENT) relates to statue pose (FUTURE) which reflects signing stance (PAST)—player must navigate CAUSAL LOOP not linear progression
+
+**Distinction from Memo Chain**:  
+Memo Chain puzzles scatter FRAGMENTS of a single solution across locations in ONE timeline. This uses DOCUMENT ALTERATION where the ENTIRE SOLUTION's existence depends on whether historical event occurs—not gathering pieces but CREATING the historical precedent itself.
+
+---
+
+## Chron-O-John Flushing Mechanic (Special Inventory Transfer Variation)
+
+**Problem**: Items cannot be physically carried between time periods. Characters are stuck in separated eras and need inventory items that only exist in other timelines. Standard item transfer mechanisms (pick up, carry, give to NPC) don't work across centuries.
+
+<small>Source: swords_and_software_walkthrough.html, lines 792-804 — "Dr. Fred explains that using the Time-Flux Hydraulic Vortex Chamber you can flush small, inanimate objects to each other through time!"</small>
+
+**Core Mechanic Subtype**: The Chron-O-John (time-period connected toilet) functions as a BIDIRECTIONAL FLUSHING NETWORK between all three time periods. Items flushed from any era arrive at ALL OTHER eras' toilets simultaneously. This creates unique logistical puzzles where the SAME ITEM can be transferred across centuries instantly, functioning as **TEMPORAL INVENTORY SHARING** rather than traditional carrying.
+
+```
+FLUSHING MECHANICS:
+
+ITEM FLOW DIAGRAM:
+                    ┌──────────────┐
+                    │   PAST       │
+                    │  (1795)      │
+                    │  Hoagie's    │
+                    │  Outhouse    │
+                    └──────┬───────┘
+                           │ FLUSH
+                           ↓
+        ┌──────────────────┼──────────────────┐
+        ↓                  ↓                  ↓
+┌──────────────┐   ┌──────────────┐   ┌──────────────┐
+│  PRESENT     │   │   ITEM       │   │  FUTURE      │
+│  (1993)      ├──►│ TRAVELS      │──►│  (2026)      │
+│  Bernard's   │   │ THROUGH TIME │   │  Laverne's   │
+│  Chron-O-John│   │ INSTANTLY    │   │  Chron-O-John│
+└──────────────┘   └──────────────┘   └──────────────┘
+
+KEY FEATURES:
+- All three toilets connected to same temporal stream
+- Flushing from ANY endpoint sends item to ALL other endpoints
+- Small inanimate objects only (no characters or large items)
+- Bi-directional flow (can flush back from future→past!)
+```
+
+**Why It's Related but Distinct**:
+While flushing enables cross-temporal item movement, it is a GAMEPLAY MECHANIC not a puzzle TYPE itself. However, many Cross-Temporal Causality puzzles REQUIRE using the flushing network to transfer the causal agent (contract, tentacle chart, battery plans, etc.) between eras. It's the **TRANSPORT LAYER** that enables cross-temporal puzzles but does not define their SOLUTION LOGIC.
+
+---
+
+## Related Types
+
+| Type | Similarity to Cross-Temporal Causality | Distinction |
+|------|---------------------------------------|-------------|
+| **Multi-Character Coordination** | Both can require actions from separated characters | MCC = spatial separation; CTC = TEMPORAL separation as primary blocker |
+| **Meta-Puzzle Construction** | Both involve sequential multi-step solutions | MPC = item output chains; CTC = WORLD STATE changes across eras |
+| **Memo Chain** | Both reference historical documents | Memo = fragment gathering; CTC = HISTORICAL EVENT CREATION |
+| **Environmental Destruction** | Both alter game world permanently | EnvDestruction is single-timeline only; CTC specifically MULTI-ERA |
+
+---
+
+## Design Considerations
+
+**Implementation Requirements**:
+1. **Temporal Tracking System**: Game must maintain separate world states per time period but allow causal linkage between them (object existence flags, document state tracking)
+2. **Character Switch + Time Jump Interface**: Player needs intuitive way to switch between eras to verify consequences immediately after action
+3. **Visual Feedback Cues**: Environmental changes should be VISUALLY OBVIOUS when they manifest across time (tree vanishing animation, flag shape shift cutscene)
+
+**Best Practices**:
+- Provide explicit hints about temporal connection ("That looks like the tree I saw back home!")
+- Use iconic historical moments or recognizable figures for past period to make causality intuitive (Washington=cherry trees logic accessible without deep history knowledge)
+- Ensure consequence manifests IMMEDIATELY after causal action—delayed feedback frustrates player's ability to learn temporal mechanics
+
+**Common Pitfalls**:
+- Players don't check other time periods after making changes (solution: prompt auto-cutscene to show effect)
+- Insufficient clue that past and future locations are connected (solution: distinctive landmarks visible in both eras)
+- Overly subtle consequence—if Laverne just falls silently, player may miss tree's destruction mattered (solution: comedic/obvious reaction cutscene)
+
+---
+
+## When to Use This Type
+
+Document a puzzle as Cross-Temporal Causality when:
+1. ✓ Actions in one time PERIOD directly alter world state in DIFFERENT time period
+2. ✓ Player must consciously switch between timelines to solve the puzzle (not just visit sequentially)  
+3. ✓ The solution involves understanding HISTORICAL OR CAUSAL connection between eras, not just item use
+4. ✓ At least one consequence is PERMANENT or SIGNIFICANTLY alters future game state
+
+DO NOT use this classification if:
+- Time period switching is just flavor—same solution possible in single timeline (use standard puzzle type instead)
+- Only one direction of travel required with no feedback loop to origin time
+- "Time" mechanics are really just sequential chapters without causal linkage (narrative progression not CTC)
+
+---
+
+## TLJ Variation: Cross-Realm Spatial Causality
+
+**The Longest Journey** implements a dimensional variant where actions in Stark affect Arcadia and vice versa, though the core mechanic is **CROSS-REALM** rather than cross-temporal. This represents spatial causality across parallel dimensions rather than historical causality through time periods.
+
+### The Longest Journey: Phone Alignment Puzzle (Chapter 8 - Reunification)
+
+<small>Source: 04_gameboomers_k_daleng.txt, lines 235-241 — "Go inside the cave (the mouth) in the big statue to see the symbol that belongs to each phone. Now you're going to set up the phones so that they will wake up the giant Q'man...set up the phones in a special way so that the mouth on the phone by the tree hits the ear of the phone on the cliff...from there turn the mouth so that it hits the mouth of the statue so that your voice goes all over the island."</small>
+
+```
+CROSS-LOCATION SIGNAL PROPAGATION CHAIN:
+
+FOUR PHONE LOCATIONS ISLAND-WIDE:
+1. Tree Phone (starting point - near Branchmen treehouse)
+2. Cliff Phone (accessed through village, past suffering crab)
+3. Ruins Phone (lower level cave accessible via rope descent from beach)
+4. Giant Statue Phone (built into Q'man's statue mouth in central plaza)
+
+SIGNAL FLOW REQUIREMENT:
+Voice spoken at Tree Phone must propagate through chain to reach Statue Phone:
+
+TREE [MOUTH OUT] → CLIFF [EAR IN, MOUTH OUT angled correctly]  
+     ↓ voice signal travels across distance
+     
+CLIFF [MOUTH OUT] → RUINS [EAR IN, MOUTH OUT angled up]
+     ↓ voice continues along chain
+     
+RUINS [MOUTH OUT] → STATUE [MOUTH IN/receiving]
+     ↓ Final propagation through island's acoustic network
+     
+RESULT: Voice amplified across entire island → Q'man awakens from slumber
+
+
+SOLUTION CHAIN DETAIL:
+
+Step A → Locate first phone at tree; speak into it, learn that mouth/ear orientation matters
+         <small>Source: 04_gameboomers_k_daleng.txt, line 239 — "the trick here is to set up the phones in a special way"</small>
+
+Step B → Visit each phone location, examine mouth and ear rotation controls
+         - Key obtained from ruins cave pile of rocks used to rotate orientations
+         - Turning key one way rotates MOUTH; opposite direction rotates EAR
+        
+Step C → Establish chain by orienting:
+         Phone #1 (Tree): Mouth pointing toward cliff location
+         Phone #2 (Cliff): Ear receiving from tree, mouth pointing toward ruins  
+         Phone #3 (Ruins): Ear receiving from cliff, mouth pointing upward/at statue
+         Phone #4 (Statue): Positioned to receive amplified signal
+
+WHY IT'S CROSS-REALM SPATIAL CAUSALITY:
+While NOT temporal like DOTT's puzzles, this represents a SPATIAL variant where actions at Location A (phone rotation) create effects at remote Locations B, C, D through SIGNAL PROPAGATION. The puzzle requires understanding causality across SPACE rather than time—the acoustic chain connecting distant points functions identically to DOTT's historical document legacy connecting past→future events.
+
+
+DISTINCTION FROM MULTI-CHARACTER COORDINATION:
+All four phone locations controlled by single character (April). Puzzle is about spatial signal routing, not multiple characters acting simultaneously in separated locations.
+
+
+RELATIONSHIP TO CROSS-REALM LOGISTICS:
+Unlike Cross-Realm Logistics where player carries items across worlds (e.g., shift travel with inventory), this puzzle's "cross-realm" aspect is metaphorical—the phones span the physical island but require UNDERSTANDING CAUSAL CONNECTIONS between separated points rather than item transport.
+
+
+CROSS-REALM DIMENSION VARIANT:
+True Cross-Realm Causality in TLJ appears when actions in Stark create consequences in Arcadia (and vice versa):
+
+Example - Shift Travel Consequences:
+→ Items acquired in one dimension usable only after travel to other dimension  
+→ Information learned in Arcadia (e.g., Cortez's true identity) changes player's access/dialogue options back in Stark
+→ This represents CROSS-DIMENSIONAL rather than cross-temporal causality but shares same mechanical principle: ACTION IN SEPARATED SPACE → CONSEQUENCE MANIFESTS AT DISTANCE
+```
+
+---
+
+## Related Types (Updated Reference Table for TLJ Puzzles)
+
+| Type | Similarity to Cross-Temporal Causality | Distinction | TLJ Example Matches This? |
+|------|---------------------------------------|-------------|---------------------------|
+| **Multi-Character Coordination** | Both can require actions from separated characters | MCC = spatial separation; CTC = TEMPORAL separation | No - all single-character puzzles in TLJ |
+| **Meta-Puzzle Construction** | Both involve sequential multi-step solutions | MPC = item output chains; CTC = WORLD STATE changes across eras | Plumbing, Shadow Puppet ARE Meta-Construction |
+| **Memo Chain** | Both reference historical documents | Memo = fragment gathering; CTC = HISTORICAL EVENT CREATION | No memo-chain puzzles identified in TLJ |
+| **Environmental Destruction** | Both alter game world permanently | EnvDestruction is single-timeline only; CTC specifically MULTI-ERA | Phone puzzle alters world state across location |
+| **Cross-Realm Logistics** | Both involve separated space/era item transfer | Cross-Realm = carry-through; CTC = Causal action changes remote state without transport | Shift mechanics = Cross-Realm, not CTC |

src/puzzles/distraction-physics.md

@@ -0,0 +1,370 @@
+# NPC Distraction Physics
+
+**Information Architecture**: NPC follows patrol/behavior pattern that blocks access to location or item. Blocking condition is *physical/spatial* rather than dialogue-based: line-of-sight, proximity triggers, or path obstruction. Solution requires manipulating environment to break the blocking condition without direct confrontation.
+
+**Player Action Pattern**: Observe NPC behavior loop. Identify environmental object/action that can exploit timing, physics, or AI limitations. Execute action to divert/obstruct/block NPC's attention or movement. Access previously blocked element during distraction window.
+
+**Core Mechanic**: Spatial/temporal manipulation creates opportunity window. Unlike Sensory Exploitation (direct vulnerability attack like tickle/sleep), DNP exploits *environment* + *NPC pathfinding/routine*. Player becomes environmental engineer, creating puzzle in 3D space using standard actions.
+
+**Variations**:
+- Pull lever/activate object that NPC must investigate, breaking patrol pattern
+- Create physical obstruction (object on tracks, blocking door)
+- Redirect NPC attention via object manipulation (pull totem nose → monkey hangs there → NPC path rerouted)
+- Timing puzzle: wait for patrol cycle gap + execute grab action in short window
+
+**Adventure Game Implementation**:
+- LOOK at environment to spot interaction point that affects NPC behavior
+- Standard WALK/USE/PULL/PUSH actions on environmental objects
+- Observe NPC AI pattern (patrol route, reaction triggers)
+- Trigger environmental change → NPC reroutes or becomes occupied → access granted
+
+**Example Structure**:
+
+```
+Blockage Phase:
+→ Target [ITEM] protected by [NPC_GUARD] with patrol loop to [OBJECT]
+→ Direct theft impossible ("Can't steal while watched!")
+
+Solution Phase:
+→ Examine [ENVIRONMENTAL_OBJECT] within guard's patrol path/range
+→ Realize action will divert NPC attention or alter movement pattern:
+  - USE object on [TRIGGER_POINT] creates distraction
+  - PULL [OBJECT] physically obstructs NPC path
+  - TIME window when NPC is investigating/occupies alternate location
+
+Execution Phase:
+→ Activate environment while NPC distracted → Access [ITEM] during vulnerability window
+→ Distraction must be sustained or timed precisely
+```
+
+**King's Quest VI Parallel**: None identified in walkthrough.
+
+**Monkey Island Example**:
+- **Totem Pole / Monkey Blockade**: 
+  - Goal: Enter Giant Monkey Head interior (blocked)
+  - Problem: Monkey guards it, standing on totem pole nose
+  - Solution: Pull Nose down → Monkey follows and hangs from pulled-down nose → Monkey physically occupies space away from gate → Access granted
+  - Distraction + spatial displacement = access
+
+---
+
+### Indiana Jones: Fate of Atlantis - Submarine Guard Distraction (Team Path, INDY2)
+
+**Setup**: After reaching the Nazi submarine via hot air balloon crash, Indy and Sophia are separated—Sophia is imprisoned in a cell while Nazi guards patrol the corridors. Indy needs to reach the emergency rudder controls to guide the sub into the airlock. A guard stands watch near the rudder control room with no direct combat option available (Team path focuses on cooperation over violence).
+
+<small>Source: walkthroughking_ashley_walkthrough.html, lines 89 — "Get her to distract the guard, and then walk around behind him."</small>
+
+**Blocking Condition**: Guard stands stationary at fixed position blocking access to emergency rudder control. Cannot pass, cannot fight (on Team path), must create opportunity through environmental/social manipulation.
+
+**Physical/Spatial Solution Chain**:
+1. Sophia is in adjacent cell with wall opening allowing voice communication
+2. Use Intercom/communicate with Sophia → coordinate distraction plan
+3. Sophia shouts about "bucket" or "pail"—creates noise distraction audible to guard
+4- Guard turns toward sound source (Sophia's cell), turning back away from rudder corridor
+5. While guard faces distraction: Walk Indy around behind him, through previously-blocked passage
+6. Access emergency rudder controls unimpeded
+
+<small>Source: gamefaqs_darth_maul_walkthrough.html, lines 981-987 — "Head for the right and open the trap door that leads to the strong box...Sophia will pick up a bucket and knock it over. The guard will hear the noise and run to Sophia's cell. While he is distracted, use the key to unlock the rudder controls."</small>
+
+**Environmental Manipulation**: The distraction isn't an object thrown or lever pulled—it uses SOCIAL ENVIRONMENT (two separated allies coordinating) + AUDITORY TRIGGER (bucket noise). Guard's AI prioritizes unexpected sounds near prisoner cells as security threats.
+
+**Why It's Distraction Physics**: Player doesn't confront guard directly. Instead, they manipulate the environment (Sophia's bucket, communication between rooms, acoustic propagation) to create temporal opportunity window. Guard reroutes from patrol position due to environmental stimulus outside his blocking role.
+
+**Alternative Solution Paths**: Each path type has different approach:
+- **Wits Path**: Create fire in torpedo tube using rag + wires → guard responds to emergency evacuation (environmental hazard distraction)
+- **Fists Path**: Direct combat defeats guard (not distraction—different path specialization)
+
+---
+
+### Gabriel Knight 1: Mime Distraction for Cop Radio Access (GK1)
+
+**Setup**: Gabriel needs to learn the location of a crime scene from police radio broadcasts. A cop stands guard at his motorcycle with an active radio in Jackson Square. The cop will not let Gabriel near the radio and has no dialogue option revealing the information.
+
+<small>Source: mysterymanor_mbday630_walkthrough.html, lines 77-78 — "Go to park. Get mime to follow you to cop and use motorcycle when cop chases mime."</small>
+
+<small>Source: justadventure_walkthrough.html, lines 540-557 — "(iii) Ergo – He must somehow get the cop to leave his bike for a while. (iv) Get the mime to annoy him so that the cop will chase him away... The mime will now start mocking the cop who will try to catch him and run after him away from his motor bike in so doing."</small>
+
+**Blocking Condition**: Cop occupies fixed position next to motorcycle radio. Direct approach = refused access. Radio broadcasts contain vital intel (crime scene at Lake Pontchartrain). A mime wanders Jackson Square, following and mockingly copying anyone he approaches.
+
+**Environmental/Spatial Solution Chain**:
+1. Approach mime near top of screen → mime begins following Gabriel
+2. Walk Gabriel toward right side of screen, then diagonally through center area
+3. Position themselves so mime ends up standing close to cop
+4. Mime begins mocking gestures → cop becomes annoyed
+5. Cop abandons motorcycle post and chases mime away from radio
+6. Window opens: Use motorcycle radio while cop is absent (2 points)
+7. Radio broadcast reveals crime scene location: Lake Pontchartrain
+
+<small>Source: justadventure_walkthrough.html, lines 547-548 — "Whilst the cop is absent, QUICKLY use his radio. You will hear the location of the crime scene – it is at Lake Pontchartrain [+ 2 points]"</small>
+
+**Environmental Manipulation**: The mime acts as a natural NPC-following entity built into Jackson Square's simulation. Player doesn't control the mime directly—instead manipulates spatial positioning so mime's inherent annoying behavior triggers cop's departure. Environmental chain-reaction, not direct item use.
+
+**Why It's Distraction Physics (Not Sensory Exploitation)**: Cop has no perceptual weakness or specific vulnerability. Instead, player uses a third NPC's programmed following/mocking behavior to ALTER THE COP'S PHYSICAL POSITION in space. The cop willingly leaves because of social irritation, not because his senses were deceived or exploited.
+
+---
+
+### Broken Sword: Shadow of the Templars - Baphomet Key Swap (Chapter 6)
+
+**Problem**: Guard retains real Baphomet key while wearing protective gloves that prevent theft. Must replace real key with fake using environmental manipulation chain to create opportunity window when guard removes gloves temporarily.
+
+<small>Source: broken-sword-1/4_agh_peter_christiansen_walkthrough.html, lines 469-498</small>
+<small>Source: broken-sword-1/1_walkthroughking_broken_sword.html, lines 178-185</small>
+
+**Environmental Manipulation Chain**:
+```
+PHASE 1 - Initial Blockage Discovery:
+→ Approach guard at Baphomet temple/tomb entrance  
+→ Guard holds real key but wears protective gloves at all times
+→ Direct theft attempt fails ("Can't take key while guard wears gloves")
+→ Fake key crafted earlier in inventory (prerequisite from prior puzzle)
+
+PHASE 2 - Distraction Setup (Painter Room Adjacency):
+→ Locate painter working in adjacent chamber/room
+→ Painter creates noise or activity that can be leveraged
+→ Phone line accessible in player's location for remote communication
+
+PHASE 3 - Environmental Trigger Sequence:
+Step 1 → Adjust thermostat in shared temperature-control area
+         - Creates discomfort condition for painter (too hot/cold)
+         
+Step 2 → Painter seeks relief, moves to different location/uses phone
+         - Environmental change breaks normal work pattern
+         
+Step 3 → Phone call initiated by painter OR player calls painter
+         - Painter engaged in conversation at distance from guard room
+
+PHASE 4 - Guard Distraction Window:
+→ Guard's attention drawn to noise/activity from painter room
+→ During distraction period, guard removes gloves (temperature/comfort reason)
+→ CRITICAL TIMING WINDOW opens when gloves off and attention diverted
+
+PHASE 5 - Key Swap Execution:
+→ While guard distracted AND gloveless → Use fake key ON real key location
+→ Real key replaced with duplicate in inventory
+→ Original now accessible without confrontation or timing failure
+
+WHY IT'S DISTRACTION PHYSICS: Multiple environmental elements (thermostat control, phone communication, painter's behavior) chain together to create opportunity window. Player manipulates 3D space using standard actions, creates puzzle where NPC reroutes attention due to external stimulus. NOT Sensory Exploitation because guard has no specific vulnerability being attacked—player engineers DISTRACTION CONDITIONS through environmental controls, not direct exploitation of perceptual weakness.
+```
+
+---
+
+### Broken Sword II: The Smoking Mirror - Ketch's Landing Cat/Flagpole Surveyor Distraction (Chapter 5)
+
+**Problem**: George needs access to the museum where Captain Ketch's treasure information is hidden, but cannot enter directly. Bronson the surveyor blocks the area and guards his equipment. The cat at the museum creates environmental distraction opportunities that can be exploited to bypass both obstacles without confrontation.
+
+<small>Source: 2_the_spoiler_tom_hayes_walkthrough.html, lines 262-271 — "Use the inner tube with the tree. Use the red ball with the inner tube. Use the ladder, to leave Bronson hanging from the flagpole. Get the marker."</small>
+
+<small>Source: 4_kasagaming_walkthrough.html, lines 359-362 — "Go up to the museum. Use the ladder to extend it. Climb the ladder, attach the inner tube to the middle window flagpole, then descend the ladder. Attach the fish to the inner tube..."</small>
+
+```
+PHASE 1 - BLOCKING CONDITION DISCOVERY:
+
+→ Arrive at Ketch's Landing Museum area
+→ Bronson stands near ladder/flagpoles, guarding survey equipment and plans
+→ Museum door locked; Ketch sisters appear during certain dialogue cycles
+→ Direct entry impossible while Bronson occupies the space
+
+ENVIRONMENTAL OPPORTUNITY IDENTIFIED:
+→ Cat roams museum porch area (unrelated NPC)
+→ Flagpole with sensor/target sits on elevated platform
+→ Red ball accessible via cat baiting sequence
+
+
+PHASE 2 - DISTRACTION CHAIN SETUP:
+
+Step 1 → Trade worm/quilt/lipstick to Rio for fish 
+         <small>Source: kasagaming_walkthrough, line 359 — "Offer the quill pen to the cat. It will shred it to pieces."</small>
+         
+Step 2 → Place fish on museum porch where cat can access  
+Step 3 → Cat distracted by fish → allows player movement through area
+
+STEP 4 → Climb ladder, extend flagpole rope system with inner tube
+Step 5 → Lower ball to ground level via tube mechanism
+
+PHASE 3 - PHYSICAL DISTRACTION DEPLOYMENT:
+
+Step 6 → Place red ball in tree-based sling/catapult mechanism
+         <small>Source: tom_hayes_walkthrough, line 267 — "Use the inner tube with the tree. Use the red ball with the inner tube."</small>
+         
+Step 7 → Launch ball at flagpole sensor/target → sensor knocked from pole
+Step 8 → Bronson climbs ladder to investigate/repair damaged survey equipment
+
+CRITICAL DISTRACTION WINDOW:
+→ Bronson hangs from upper flagpole (stuck/investigating)
+   <small>Source: kasagaming_walkthrough, line 360 — "Use the ladder, to leave Bronson hanging from the flagpole."</small>
+
+Step 9 → While Bronson occupied above: retrieve survey marker/equipment freely
+         - Physical obstruction removed by environmental consequence
+         
+Step 10 → Collect plans and theodolite from beach area (Bronson's abandoned items)
+Step 11 → Return to museum, present plans to Ketch sisters → gain entrance
+
+ENVIRONMENTAL MANIPULATION SUMMARY:
+- Cat → food distraction creates access window for item placement
+- Ball/sling mechanism → physical projectile knocks sensor off pole  
+- Sensor damage → triggers Bronson's investigation response (AI reactivity)
+- Bronson stuck above → ground-level items now unprotected
+```
+
+**Why It's Distraction Physics**: Player never confronts Bronson directly. Instead, manipulates environment (cat food placement, ball sling launch, sensor destruction) to create cascading physical consequences that remove the blocking condition. Bronson's distraction is not an explicit "distracted state"—he climbs to repair equipment because sensor was destroyed and ends up physically occupying elevated space away from his items. This differs from Sensory Exploitation (no direct attack on NPC perception) and differs from pure Observation Replay (player creates conditions rather than waits for natural cycle).
+
+
+**Distinction from Information Brokerage**: While Rio provides fish through trade, the core mechanic is PHYSICAL DISTRACTION of Bronson, not network navigation. Fish collection enables ball/cat actions but doesn't follow NPC→NPC information flow pattern.
+
+
+---
+
+## Related Types
+
+- **Sensory Exploitation**: Attacks NPC directly via vulnerability (tickle/sleep/food); DNP attacks NPC indirectly via environmental change that reroutes their behavior
+- **Timed Consequence**: Both use timing windows, but TC is about narrative urgency without mechanical deadline; DNP creates player's own temporary opportunity through active manipulation  
+- **Multi-Faceted Plan**: DNP often simpler "one action breaks blockage" vs MFP's multi-requirement synthesis from disparate sources
+- **Observation Replay**: Related when exploiting NPC behavior cycles, but OR waits for natural timing while DNP CREATES distraction conditions proactively rather than passively observing existing patterns
+
+### Simon the Sorcerer: Pub Barman Beeswax Beer Scheme (SIMON)
+
+**Problem**: The pub barman controls access to a barrel of beer and a brewery voucher needed for the Dwarf Mine plot. Direct theft or trade fails—barman only abandons these items after believing the barrel is damaged/leaking. Exploiting his diagnostic behavior creates the opportunity window.
+
+<small>Source: walkthroughs/simon1/simon1.txt, lines 614-620 — "When you have the wax, go to the pub and ask the bartender for a drink. While he looks for ingredients, use the wax on the beer barrel to plug it up. This tricks him into thinking the barrel is empty... The bartender puts the barrel of beer outside, and he gives Simon a brochure containing a free beer voucher."</small>
+
+<small>Source: walkthroughs/simon1/simon1_2.txt, lines 196-203 — "Enter the bar and talk to the barman. Say Mix me a Wet Wizard, barkeep. Quickly use the wax on the beer barrel behind the bar to get a beer voucher. Exit the bar and get the beer barrel."</small>
+
+```
+BLOCKING CONDITION ANALYSIS:
+
+LOCATION: Drunken Druid Pub (Village)
+GOAL: Acquire BARREL OF BEER + VOUCHER LEAFLET from barman's inventory
+OBSTACLE: Barman actively guards both items, no dialogue trade option available
+
+NPC BEHAVIOR PATTERN IDENTIFIED:
+- When asked to make a drink, barman consistently: 
+  - Turns away from counter
+  - Looks behind bar for "ingredients"
+  - Returns to front with completed beverage
+  
+This animation loop creates ~3-5 second window where his attention is diverted  
+from the beer barrel directly behind him.
+
+
+ENVIRONMENTAL MANIPULATION CHAIN:
+
+PHASE 1 - DISTRACTION INITIATION:
+→ Enter pub, navigate to bar counter  
+→ TALK to barman, select dialogue option: "Mix me a Wet Wizard, barkeep"
+→ Barman animation triggers (back turned, searching behind counter)
+
+
+PHASE 2 - TIMED INTERVENTION WINDOW:
+→ [CRITICAL TIMING]: Use WAX on beer barrel spigot while barman distracted
+  
+Why This Works: Wax plugs the spigot—barrel appears non-functional (no liquid flows when pressed)
+The intervention must occur during distraction window, or barman notices player tampering.
+
+
+PHASE 3 - NPC DIAGNOSTIC RESPONSE BEHAVIOR:
+→ Barman returns, attempts to serve from now-plugged barrel  
+→ Dialogue indicates: "Barrel's gone dry / broken—what a shame"
+→ BARREL DISPLACED OUTSIDE PUB (barman removes it from premises)
+  
+
+
+PHASE 4 - ITEM ACQUISITION WINDOW:
+→ VOUCHER given to player as compensation ("free drink coupon for another time")
+→ Exit pub immediately → BARREL now available for collection (outside door)
+
+Why Both Items Become Available Simultaneously: The barman's diagnostic conclusion 
+("barrel is broken/empty") triggers BOTH actions: discarding barrel AND compensating customer.
+
+
+WHY IT'S DISTRACTION PHYSICS:
+
+NPC ATTENTION REROUTE THROUGH ENVIRONMENTAL SETUP:
+Player doesn't distract barman with an object thrown elsewhere (like pulling totem nose). 
+Instead, creates CONDITIONS for item acquisition by exploiting NPC's built-in behavior loop. 
+
+The key distinction: Barman's "looking for ingredients" animation is NATURAL BEHAVIOR, not 
+something player FORCED him to do via environmental manipulation. Player TIMED their intervention
+(to use wax) during this naturally-occurring attention shift window.
+
+
+TEMPORARY OPPORTUNITY CREATION:
+Once wax applied, barman discovers problem and creates NEW opportunity state (barrel outside = accessible).
+This is distinct from Observation Replay where player watches NPC perform then waits for them to leave.
+Here player ACTIVELY CHANGES the barrel's physical state during window, which THEN triggers 
+new behavior chain from NPC.
+
+
+TIMING MECHANIC AS DISTRACTION CORE:
+Walkthrough emphasizes "Quickly use the wax" or timing language—underscores narrow window where
+barman's back is turned. This isn't about creating a lasting diversion (like knocking over object that he then investigates for 30 seconds). It's about EXECUTING THE CRITICAL ACTION during brief attention gap in his pattern.
+
+
+COMIC DELIVERY:
+Absurdity derives from wax-plugged-spigot = "empty/barrel-broken" conclusion. No logical person 
+would think a beer barrel is empty because one spigot fails—but the game's internal causality accepts this as valid barman reasoning. Barman never suspects foul play, only mechanical failure.
+
+
+FAILURE MODE:
+If player attempts to use wax while barman faces counter (no distraction active), interaction blocked:
+"Barman notices you tampering with his supplies and kicks you out."
+
+This demonstrates the timing requirement—the environmental exploit works ONLY during attention window.
+```
+
+**Why It's Distraction Physics**: The puzzle requires exploiting the barman's existing behavior pattern (turned away to find ingredients) rather than creating a new distraction from scratch. Environmental manipulation (wax on spigot) occurs DURING naturally-occurring attention gap, triggering consequences (abandoned barrel outside). This differs from creating external noise or pulling levers—player hijacks NPC's routine moment of vulnerability through precise timing.
+
+---
+
+## Game Examples
+
+### INDY1: Roast Boar Distraction via Fireplace Smoke
+<small>Source: walkthrough-king.txt, lines 154-158</small>
+
+**Setup**: Nazi Colonel Vogel's office at Castle Brunwald is guarded by his dog. Indy needs to pass through the office to access items in the drawers, but the dog will attack if he enters without distraction. The kitchen upstairs has a roast boar being prepared and a fireplace with burning coals.
+
+**Blocking Condition**: Dog stands guard in front of Vogel's office door. Cannot enter or take items from desk while dog is present. Direct combat possible but suboptimal (violence-heavy playstyle, loses puzzle points).
+
+**Solution Chain**:
+1. Go upstairs to kitchen area on 2nd floor
+2. Take empty stein from counter, fill it from ale keg spigot
+3. Go to fireplace adjacent to where roast boar hangs
+4. Pour first stein of ale onto burning coals → creates thick smoke that fills room
+5. Wait for smoke to clear enough to see/grab roast boar
+6. Take roast boar (dog's food) into inventory, refill stein one more time
+7. Return downstairs through guard corridors with boar in inventory
+8. Approach Vogel's office and GIVE roast boar to dog sitting at door
+
+<small>Source: walkthrough-king.txt, lines 209-210 — "Enter the first door to the west to find Vogel's office. Give the roast boar to the dog, then open the right drawer in"</small>
+
+9. Dog becomes occupied eating the boar → attention diverted from doorway
+10. Enter office while dog distracted by food, access desk drawers freely
+
+**Environmental Manipulation**: Fireplace coals convert liquid ale into smoke—physical transformation that temporarily reduces visibility enough to safely retrieve hanging meat. The ale creates a sensory barrier (smoke/ash) that protects Indy from thermal damage while accessing the otherwise unreachable item. Dog's behavior is not "hacked" through AI weakness—instead, player physically brings the object dog naturally wants to its location.
+
+**Why It's Distraction Physics**: Unlike Sensory Exploitation which attacks an NPC's direct vulnerability (feeding monkey fruit because monkeys like fruit), this puzzle requires MANIPULATING THE PHYSICAL ENVIRONMENT FIRST (ale→smoke conversion) before accessing the distraction item itself. The fireplace acts as a transformative medium: without creating smoke barrier, Indy cannot retrieve the boar due to proximity to burning coals. Once boar acquired, giving it to dog is straightforward—the complex puzzle was getting the boar, not convincing the dog. Environmental engineering (heat + liquid → temporary visibility reduction) creates opportunity window for item acquisition.
+
+### INDY1: Security Console Ale Short-Circuit
+
+**Setup**: Nazi security control room at Castle Brunwald contains an alarm system that will trigger during escape sequence unless disabled. The room is guarded by a Nazi soldier patrolling outside the door, but can be bypassed via combat or Mein Kampf book trade. Inside, the security console has ventilation grating on its side panel.
+
+<small>Source: walkthrough-king.txt, lines 190-192</small>
+
+**Blocking Condition**: Alarm system is active and functional. If triggered during escape, it will lead to confrontation with Donovan or fail Henry's rescue entirely. Cannot disable through normal "use console" interaction (no dialogue/options for deactivation). Physical short-circuiting required.
+
+**Solution Chain**:
+1. Acquire stein of ale from earlier kitchen sequence (carried throughout castle infiltration)
+2. Navigate to security control room on ground floor corridor
+3. Deal with guard outside door: either GIVE Mein Kampf book OR fight him
+4. Enter security room past the neutralized guard
+5. Locate grating/ventilation panel on SIDE of alarm console
+6. USE stein ON grating → Pour ale into electrical components
+7. Ale conducts electricity, short-circuiting the alarm system
+8. Alarm disabled—will not trigger during escape sequence
+
+<small>Source: walkthrough-king.txt, lines 191-192 — "Once done, pour your stein of ale into the grating on the side of the security console to disable the alarm system."</small>
+
+**Environmental Manipulation**: Liquid ale is conductive when poured onto exposed electrical contacts. The grating design exposes internal components without requiring tool-based disassembly. Indy exploits the console's poor industrial design (open ventilation near sensitive circuitry) to achieve what hacking or sabotage cannot—pure physical destruction through fluid dynamics. This is not "breaking the alarm"—it's repurposing a beverage container into a conductive fluid delivery mechanism.
+
+**Why It's Distraction Physics**: The puzzle uses environmental PHYSICS rather than NPC manipulation, but follows same pattern: observe system behavior (alarm triggers on escape) → identify exploitable interaction point (grating exposes internals) → use available item in unconventional way (ale as conductive destruction agent) → create window of opportunity (disabled alarm = safe route for Henry). The ale's dual-use nature mirrors other DNP items (wax barrel plug, thrown bucket)—everyday object repurposed through understanding of environmental rules. Unlike simple "break console" solution, player must recognize that liquid + exposed electronics = failure mode they can engineer intentionally.
+
+---

src/puzzles/environmental-storytelling.md

@@ -0,0 +1,253 @@
+# Environmental Storytelling Discovery
+
+## Mechanic Definition
+
+The puzzle solution is knowledge, not items. Information is hidden within the game environment—through object examination, eavesdropping, spatial observation, or noticing changes between visits. The player must actively seek information rather than receive it through dialogue.
+
+## Information Architecture
+
+**Conveyance Method**: Environmental traces
+- Objects contain hints when examined closely
+- Eavesdropping reveals hidden conversations
+- Spatial patterns across locations reveal connections
+- Changes in environment between visits indicate time passage
+
+**Player Action Pattern**:
+1. Notice something worth examining (LOOK, EXAMINE)
+2. Discover information through close inspection
+3. Synthesize information with other discovered facts
+4. Use synthesized knowledge to determine next action
+
+**Core Mechanic**: The puzzle is about finding information the game doesn't explicitly tell you. There's no dialogue that says "the password is X"—you must discover it through environmental interaction.
+
+## Design Rationale
+
+- Rewards observation—players who examine carefully are rewarded
+- Creates detective feel—the player becomes an investigator
+- Integrates story and gameplay—learning the story IS the puzzle
+- Avoids exposition dumps—information emerges organically
+
+## Why It's Effective
+
+The satisfaction comes from "stumbling" onto information. Finding something unexpected feels like discovery, not task completion. The world feels "lived in"—containing traces of what happened before the player arrived.
+
+## Mechanic Variations
+
+| Variation | Information Location | Discovery Method |
+|-----------|---------------------|-------------------|
+| Object-based | Items, furniture, documents | Close examination |
+| Eavesdrop-based | Through walls, behind doors | Hidden conversation listening |
+| Spatial | Pattern of locations, accessible routes | Mapping environment |
+| Temporal | Changes between visits | Returning at different times |
+| Synthesis | Multiple sources | Combining partial facts |
+
+## Generic Example Structure
+
+**Goal**: Learn [Information]
+
+**Information Flow**:
+- Player notices locked door with no visible mechanism
+- Player searches environment for how door might open
+- Player finds secret passage through unusual interaction (examining object)
+- In passage, player can eavesdrop on guards discussing half the information
+- Player finds different location containing second half through examination
+- Player synthesizes: [Half 1] + [Half 2] = [Complete Information]
+
+**The puzzle**: Information is never given explicitly—always discovered through environmental interaction.
+
+## Adventure Game Implementation
+
+The limited action set drives this puzzle entirely:
+- LOOK/EXAMINE objects to find hidden information
+- LISTEN for overheard conversations
+- The puzzle exists in the environmental interaction, not in UI
+- Player must remember what they found—external note-taking often required
+
+This puzzle tests: "Can I find information the game doesn't explicitly tell me?"
+
+---
+
+### Quest for Glory 1: Brigand Meeting Note & Archery Range Spy (QFG1)
+
+**Problem**: The brigands are planning something at an undisclosed location, but no NPC will openly discuss their base or meeting schedule. Player must discover both the timing ("midday") AND location (archery range) through environmental clues that are NOT explicitly explained by dialogue.
+
+<small>Source: qfg1-fandom-wiki.md, lines 35-36 — "Enter the tavern and pick up the note that is next to the middle barstool." Later at line 145: "Go to town, and enter the tavern. Pick up the new note."</small>
+
+**Environmental Discovery Chain**:
+```
+CLUE 1: Tavern Note (Week 2+)  
+Location: Aces & Eights Tavern, Spielburg tavern interior
+Discovery Method: LOOK at middle barstool area, use pickup action on floor
+
+Information Content (Second Note): "B- meet at target range at noon, urgent -B"
+Critical Decoded Data: 
+  - "target range" = archery practice location  
+  - "noon" = specific meeting time (midday)
+
+CLUE 2: Archery Range Surveillance Location
+From Healer's hut: South twice, then West = archery training area
+<small>Source: qfg1-loudking-gamefaqs.md, line 126 — "Go to side of archery range (south twice from healer then west) at midday."</small>
+
+Discovery Method: Travel to coordinates, wait for specified time window
+Environmental Observation Opportunity: Bruno and Brutus (traitor brigands) appear at noon
+Eavesdrop Result: Dialogue reveals secret password "Hiden Goseke" used for cave entrance
+```
+
+<small>Source: qfg1-loudking-gamefaqs.md, lines 124-128 — "Spy on traitor brigands → learn secret key location and password: 'Hiden Goseke'."</small>
+
+**Synthesis Phase**:
+1. EXAMINE barstool in tavern → note found (no NPC mentions this exists)
+2. READ note provides abstract clue: "meet at target range at noon"  
+3. Player must INTERPRET "target range" = archery/training area (environmental vocabulary mapping)
+4. Travel to described location, WAIT for midday time window
+5. Overhear dialogue during position-based eavesdropping → password revealed
+
+**Why It's Environmental Storytelling**:
+- **No Explicit NPC Guidance**: No character says "go to archery range at noon and listen"—information exists ONLY in environmental documents (notes found on floor)
+- **LOOK/EXAMINE Action Critical**: Finding the note requires examining barstools, not dialogue choice or menu option
+- **Temporal Layer**: Second note only appears after game clock advances—environment changes based on time passage, teaching player that returning later reveals new information
+- **Eavesdropping as Core Discovery Mechanism**: Password learned by PHYSICAL POSITIONING and listening, not through selectable dialogue trees
+
+**Distinction from Memo Chain (MI1)**:
+While both involve written documents, MI1's memo chain requires SYNTHESIZING multiple fragments into a larger narrative. Here, EACH note is self-contained actionable intelligence—"meet at target range at noon" is complete data, just hidden in environment rather than dialogued.
+
+**Distinction from Information Brokerage**:
+No NPC exchange network exists here. Player doesn't ask "who knows where brigands meet?" The notes are PHYSICAL OBJECTS discovered through examination, not knowledge obtained through dialogue trades. Tavern owner never mentions notes exist—they're pure environmental traces without social mediation.
+
+---
+
+### Quest for Glory IV: Hotel Mordavia Exercise Machine & Weight Training (QFG4)
+
+**Setup**: In the player's hotel room at Hotel Mordavia, an exercise machine sits unused. Through reading its manual and progressive use over multiple days, the player can increase Strength stat—not through quest reward, but through environmental interaction discovery.
+
+<small>Source: qfg4-gamefaqs-sac.txt lines 2187-2194 — "Read exercise manual add weights progressively over days for maximum strength gain"</small>
+
+```
+ENVIRONMENTAL DISCOVERY PHASE - Object Examination:
+Step 1 → Enter Hotel Mordavia room (automatically purchased upon first hotel visit)
+         Room contains: bed, chest, exercise machine in corner
+        
+Step 2 → EXAMINE exercise machine or USE it directly
+         Initial feedback: Machine exists but effectiveness unclear
+
+INFORMATION ACQUISITION - Manual Reading:
+Step 3 → READ instruction manual for exercise equipment
+         (Manual may be found on/next to machine via LOOK action)
+         
+         Information revealed:
+         - Machine requires progressive weight increases for optimal results
+         - Weights are stored in room or can be added incrementally
+         - Daily usage limits apply (body needs rest between sessions)
+
+ENVIRONMENTAL INTERACTION SEQUENCE - Progressive Training:
+Step 4 → Day 1: Use machine with starting weights
+         Result: Some strength increase, feedback about "need more resistance"
+         
+Step 5 → Add additional weight plate to machine (environmental object manipulation)
+         
+Step 6 → Day 2+: Return after night cycle has passed
+         Game-enforced rest period: Cannot overtrain in single day
+
+Step 7 → Repeat: Use machine → add more weight → sleep → return next day
+         Progressive strength gains track with weight increases
+
+ENVIRONMENTAL FEEDBACK LOOP - Physical Limit Detection:
+Step 8 → Eventually receive feedback: "You've reached maximum for today" or similar
+         Mechanic reveals: Daily usage cap exists, must wait 24 hours (in-game)
+
+Step 9 → Continue cycling through available weight plates until all added
+         Final reward: Maximum Strength increase achievable through this method
+
+ENVIRONMENTAL STORYTELLING ELEMENTS:INFORMATION HIDDEN IN PHYSICAL SPACE:
+Strength training isn't offered through quest NPCs—player must DISCOVER it by examining room contents.
+
+PROGRESSIVE ENVIRONMENTAL CHANGES:Machine configuration changes as player adds weights.
+This visible modification teaches the progression system (more weight = more benefit).
+
+TEMPORAL LAYER - Day/Night Cycle Matters:Cannot brute-force strength in hours; environment enforces realistic rest periods.
+Teaches player that some environmental interactions are time-gated by world mechanics.
+
+WHY IT'S ENVIRONMENTAL STORYTELLING:KNOWLEDGE NOT CONVEYED THROUGH DIALOGUE:No NPC offers "go exercise at hotel" quest.
+Information exists ONLY in physical space (machine + manual).
+
+EXAMINATION-DRIVE DISCOVERY:Player must actively LOOK/USE objects to uncover training mechanic.
+World contains hidden depth—environment is richer than surface exploration suggests.
+
+SPATIAL ANCHORING - Location-Specific Training:Exercise machine location matters; hotel room becomes "training ground" through discovery.
+This contrasts with generic "go to gym" quests—here, the puzzle IS noticing the existing environmental feature.
+
+COMPARISON TO QFG1 BRIGAND NOTE:Both use PHYSICAL DOCUMENTS as information sources rather than NPC dialogue.
+QFG1 = stolen note with meeting time/location
+QFG4 = manual with training instructions  
+Both rewards LOOK/EXAMINE actions; both teach players that environment contains untapped knowledge.
+
+This puzzle exemplifies subtle Environmental Storytelling: it's optional, low-stakes, but demonstrates
+that environmental examination pays off—training player to look more carefully in high-stakes situations too.
+```
+
+<small>Cited from: qfg4-gamefaqs-sac.txt:2187-2194</small>
+
+---
+
+### Quest for Glory IV: Olga & Boris Estranged Couple Reconciliation (QFG4)
+
+**Setup**: Gatekeeper Boris Stovich and shopkeeper Olga share the same last name. Environmental clues (name matching, NPC dialogue about estrangement) reveal they're a separated couple that the player can reconcile through messenger roleplay. Purely honor-based with no puzzle mechanic lock, but excellent environmental storytelling.
+
+<small>Source: qfg4-gamefaqs-sac.txt lines 2343-2350 — "Tell Olga about Boris... tell him about Olga... bouncing back and forth until the two agree to get back together"</small>
+
+```
+ENVIRONMENTAL CLUE DISCOVERY - Name Observation:
+Step 1 → Speak to Boris Stovich at town gates (gatekeeper)
+         Player learns his full name: "Boris Stovich"
+         
+Step 2 → Visit General Store, speak to Olga the shopkeeper  
+         Player learns her full name: "Olga Stovich" (same last name!)
+
+ENVIRONMENTAL STORYTELLING - Dialogue Context Clues:
+Step 3 → Mention Boris's name to Olga during conversation
+         Environmental emotional trigger: Olga becomes "snippy" or defensive
+        
+Dialogue Revealed:"My estranged husband" comment from Olga confirms relationship.
+Information not explicitly stated as puzzle; emerges through casual environmental dialogue.
+
+PLAYER AS MESSENGER - Facilitating Environmental Reconciliation:
+Step 4 → Report to Boris that Olga was asked about him
+         Result: Boris shows interest, asks to send message back
+
+Step 5 → Return to Olga with Boris's "greetings" (player-selected dialogue)
+         Each exchange reveals more emotional context from both sides
+        
+Step 6 → Repeat messenger exchanges ~3-5 times
+         Environment changes: NPC attitudes soften, dialogue becomes warmer
+
+ENVIRONMENTAL RESOLUTION - Natural Convergence:
+Step 7 → Eventually NPCs independently agree to reconcile
+         Triggered by player's message-passing but resolution is NPC-driven
+
+Step 8 → Boris and Olga reunite; may see them together later in game
+         OR hear confirmation from other town NPCs about reconciliation
+
+ENVIRONMENTAL STORYTELLING ELEMENTS:INFORMATION EMERGES FROM DIALOGUE CONTEXT:
+Player isn't given "reconcile couple" quest explicitly.
+Clue exists in environment (shared last name) + emotional dialogue responses.
+
+SPATIAL ANCHORING - Two Locations, One Story:Boris at gates, Olga in store—player connects them through repeated WALK actions.
+Physical traversal between locations mirrors narrative bridging of estrangement.
+
+PROGRESSIVE ENVIRONMENTAL CHANGE - NPC Attitudes Shift:World FEELS different after reconciliation; NPCs reference the restored relationship.
+This is environmental storytelling because the WORLD STATE changed, not just player inventory/flag.
+
+WHY IT'S ENVIRONMENTAL STORYTELLING (NOT INFORMATION BROKERAGE):NO EXPLICIT PUZZLE STRUCTURE:No "I'll give you X if you do Y" exchange network.
+Information brokerage requires NPC trade logic; this is organic relationship evolution facilitated by player observation.
+
+OBSERVATION OVER MECHANIC:Success depends on NOTICING name similarity and being curious enough to bridge the connection.
+Not a requirement-based puzzle but a world-enrichment discovery.
+
+HONOR-BASED REWARD (Non-Mechanical):Puzzle Points? None. Key item? Nothing tangible.
+Reward is WORLD IMPROVEMENT: estranged couple reunited, NPCs happier, player Honor stat increases.
+
+This exemplifies "soft" Environmental Storytelling—no gates locked until solved, but the world feels more complete
+when environmental clues are noticed and acted upon. Teaches players that exploration has narrative value beyond item acquisition.
+```
+
+<small>Cited from: qfg4-gamefaqs-sac.txt:2343-2350</small>

src/puzzles/escalating-combat-progression.md

@@ -0,0 +1,302 @@
+# Escalating Combat Progression / RPG-in-Adventure Hybrid
+
+**Information Architecture**: Game establishes combat encounters within linear progression context where each victory yields weapon upgrades that enable defeating stronger opponents. Unlike Pattern Learning (where same rules apply to new targets), Combative Progression uses INCREASINGLY DIFFICULT enemies that require SPECIFIC counter-weapons obtained from previous victories. Player cannot skip ahead without proper equipment; sequence is enforced through combat stats rather than door locks.
+
+**Player Action Pattern**:
+1. Enter arena location with limited traversal (cannot proceed without defeating gatekeepers)
+2. Challenge weakest opponent with available weapons (bare fists/feet initially)
+3. Victory rewards item: defeated enemy's weapon dropped as loot
+4. New weapon has different attack profile (damage, speed, special effects)
+5. Identify next opponent's specific weakness/exploit through experimentation or observation
+6. Select appropriate weapon counter; defeat → repeat until progression unlocked
+
+**Core Mechanic**: Sequential combat encounters form linear gauntlet where each victory produces resource needed to overcome next challenge; cannot reorder sequence without grinding/replay.
+
+---
+
+## Variations
+
+| Type | Enemy Scaling | Weapon Acquisition | Traversal Impact | Example |
+|------|---------------|-------------------|------------------|---------|
+| **Linear Gauntlet** | Each enemy stronger than last | Defeated opponent drops weapon | Must clear all to proceed | FT Mine Road biker fights |
+| **Optional Side Arena** | Fixed difficulty, no scaling | Single prize upon completion | Rewards not required for main path | DOTT time-based combat events |
+| **Resource Hoarding Required** | Enemies weak individually | Weapons found elsewhere, not drops | Must gather specific counters before entry | Traditional RPG dungeons |
+
+---
+
+## Adventure Game Implementation
+
+### Standard Actions Applied:
+- **CLICK/INTERACT with opponent** = Initiate combat sequence (real-time mini-game)
+- **SELECT WEAPON from inventory** = Choose attack method before engagement
+- **TIME ATTACKS in real-time window** = Execute strikes within enemy cooldown periods
+- **OBSERVE ENEMY PATTERNS** = Learn attack timing to avoid damage
+
+### Key Distinctions from Pattern Learning:
+1. **Weapon Gating**: Cannot defeat Enemy B with fists—even if rules understood, stats insufficient
+2. **Progressive Enhancement**: Player gets STRONGER (equipment upgrade) rather than WISER (rule mastery)
+3. **Single Linear Sequence**: No "apply learned system to new domain"—only one correct path forward
+4. **Failure = Restart Attempt** not "try different rule application"
+
+### Key Distinctions from Mini-Game Integration:
+1. **Narrative Progression Locked**: Cannot proceed in story without combat resolution
+2. **In-Universe Justification**: Weapons are inventory items, not abstract UI selections
+3. **Persistent Equipment**: Acquired weapons carried across multiple encounters, not one-off tools
+
+---
+
+## Example Structure: Full Throttle Mine Road Gauntlet
+
+### Setup (Post-Bridge Destruction):
+
+<small>
+Source: lparchive_opendork_fullthrottle_combined.txt, lines 1806-1812 — "B: It blew up. F: Ooooh! Sorry I missed that! Well... You could jump it, like Ricky Myran. Cavefish got his ramp in their hideout..."
+</small>
+
+```
+LOCATION: Mine Road (single narrow path with no branches)
+OBSTACLE: 8 hostile bikers positioned sequentially along route
+PLAYER STATE: Bare fists/feet + tire iron (obtained earlier from gas station pillow)
+GOAL: Reach Cavefish leader to obtain night-vision specs → ramp access → gorge jump
+
+PROGRESSION GATING:
+- Cannot bypass bikers via alternate route (no path exists)
+- Cannot talk/negotiate past enemies (hostile faction)
+- Must defeat each biker individually in sequence encountered
+```
+
+### Sequential Combat Chain:
+
+<small>Source: lparchive_opendork_fullthrottle_combined.txt, lines 1824-1865 — Complete mine road opponent documentation with weapon drop details</small>
+
+**PHASE 1 - Baseline Opponent (Tutorial)**:
+```
+Opponent #1: Returning antagonist from game's first chapter
+Weapon: None (fists only)
+Difficulty: Wuss (lowest tier)
+Player Equipment: Fist/Feet + Tire Iron
+
+RESOLUTION: Simple victory with any attack method
+REWARD: None (teaches combat exists, no loot drop)
+```
+
+**PHASE 2 - First Weapon Acquisition**:
+```
+Opponent #2: Rottwheeler gang member
+Weapon: Chain
+Difficulty: Slightly tougher than baseline
+
+STRATEGY DISCOVERY: Chain has moderate damage; tire iron counters effectively
+RESOLUTION: Victory with tire iron preferred (fists too weak)
+REWARD: CHAIN dropped as inventory item
+
+NEW PLAYER STATE: Fists + Tire Iron + CHAIN
+```
+
+**PHASE 3 - Weapon Tier Advancement**:
+```
+Opponent #3: Female biker
+Weapon: None
+Difficulty: Minimal (token enemy)
+
+RESOLUTION: Trivial battle; reinforces combat mechanic
+REWARD: Fuel canister (needed for later bike modification, not combat)
+```
+
+**PHASE 4 - Escalating Threat**:
+```
+Opponent #4: Rottwheeler with skull-mace
+Weapon: Skull-mace (powered-up chain variant)
+Difficulty: Moderate
+
+STRATEGY DISCOVERY: Skull-mace stronger than basic chain; player's chain now viable counter
+RESOLUTION: Use acquired chain weapon → victory possible
+REWARD: SKULL-MACE dropped (chain upgrade)
+
+CRITICAL DESIGN ELEMENT: Player can lose chain in certain puzzle uses. 
+If chain lost, must fight remaining opponents with weaker options or backtrack to acquire replacement.
+```
+
+**PHASE 5 - Evasion Counterplay**:
+```
+Opponent #5: Fast retreat biker
+Weapon: Escape attempt (immediate flight)
+Difficulty: Low but time-sensitive
+
+STRATEGY DISCOVERY: Enemy attempts instant retreat; chain can restrain before escape
+RESOLUTION: Use chain IMMEDIATELY on fight initiation → enemy immobilized, bike captured
+REWARD: Fuel + bike parts (not combat weapon)
+
+SPECIAL CASE: This opponent doesn't drop a weapon—demonstrates not all fights follow same pattern.
+```
+
+**PHASE 6 - Elemental Weakness Introduction**:
+```
+Opponent #6: Chainsaw wielder (gender-ambiguous rider)
+Weapon: CHAINSAW (insta-kill for player if hit)
+Difficulty: Highest pre-boss tier
+
+PROBLEM STATEMENT: Standard weapons chain/skull-mace insufficient; hitting enemy = instant loss
+SOLUTION DISCOVERY: Fertilizer bag (from earlier farming puzzle) blinds chainsaw operator
+RESOLUTION: Throw fertilizer → chainsawer incapacitated → victory
+REWARD: CHAINSAW added to inventory (strongest single-hit weapon)
+
+MECHANIC EXPANSION: First opponent requiring SPECIFIC non-combat counter rather than better weapon.
+Introduces "rock-paper-scissors" element where brute force fails against specialized threat.
+```
+
+**PHASE 7 - Damage Sponge**:
+```
+Opponent #7: Heavy armor Rottwheeler
+Weapon: 2x4 (most powerful melee weapon)
+Difficulty: High HP, high damage output
+
+STRATEGY DISCOVERY: Standard weapons chip health slowly; chainsaw can defeat in reasonable time
+RESOLUTION: Use CHAINSAW → enemy defeated with minimal player damage taken
+REWARD: 2x4 (longest reach weapon, needed for final fight)
+
+DESIGN SIGNIFICANCE: Introduces "appropriate tool" concept—chainsaw IS strongest DPS but 2x4 
+has special utility value needed for progression.
+```
+
+**PHASE 8 - Boss Fight with Positional Requirements**:
+```
+Opponent #8: Cavefish leader (final gatekeeper)
+Weapon: Oil slick (area denial, not direct attack)
+Difficulty: Special conditions required for victory
+
+COMPLEX CONSTRAINTS:
+1. Enemy positioned VERY LOW on bike (below normal hitboxes)
+2. Only 2x4 has sufficient REACH to strike at this height
+3. Enemy uses oil slick when player approaches → causes fall/reset
+4. Must wait for bumpy terrain section → enemy rises slightly, becomes hittable
+
+RESOLUTION CHAIN:
+- Wait for road bump animation (enemy sits up)
+- STRIKE with 2x4 ONLY (no other weapon has reach)
+- Land multiple hits before enemy retreats to low position
+- Repeat until KO
+
+FAILURE STATE: Forcing fight without 2x4 = impossible (hitbox unreachable)
+FAILURE STATE #2: Using terrain trick improperly → enemy blows up bike (specs lost forever)
+OPTIMAL RESOLUTION: KO with 2x4 on bumpy ground → Cavefish specs intact
+```
+
+**PHASE 9 - Progression Unlocked**:
+```
+REWARD FROM BOSS DEFEAT: Cavefish night-vision spectacles
+
+APPLICATION OF LOOT:
+- Use specs to reveal hidden cave entrance (forcefield disabled when viewed through them)
+- Enter Cavefish hideout → ramp access available
+- Complete gorge jump → Mine Road cleared → story progression resumes
+```
+
+---
+
+## Why This Is Escalating Combat Progression
+
+### Distinction from Pattern Learning:
+- **PL**: "I learned swordfight rules in Domain A, apply same rules to Sword Master"
+- **FCP**: "I acquired tire iron, then chain, then skull-mace, then chainsaw, then 2x4—each weapon REQUIRED for next opponent"
+
+The player could theoretically understand ALL combat mechanics from Opponent #1—but without the 2x4, Boss Fight is IMPOSSIBLE regardless of skill. This is RPG progression logic (equipment gating) applied to adventure game traversal.
+
+### Distinction from Mini-Game Integration:
+Combat isn't optional side activity—**linear progression is locked until all encounters resolved**. The mine road has NO alternative path; player MUST fight, not talk/steal/smart-way around enemies. This integrates combat as CORE traversal mechanic rather than bonus content.
+
+### Distinction from Traditional RPGs:
+1. **No XP System**: Player strength comes ONLY from equipment drops, not level advancement
+2. **Fixed Sequence**: Cannot grind weaker enemies for stats; exactly 8 opponents in set order
+3. **Short Duration**: Entire gauntlet takes 10-15 minutes, not hours of adventuring
+
+---
+
+## Design Considerations for Escalating Combat Progres sion
+
+### Implementation Patterns:
+1. **Clear Visual Weapon Hierarchy**: Player should see chain ≠ chainsaw (power differential obvious)
+2. **Reach/Range Differentiation**: Not all power = damage; some weapons have special hitbox properties (FT's 2x4 reach requirement)
+3. **Backtracking Prevention**: If player loses key weapon, either allow acquisition of replacement OR implement save state
+4. **Counterplay Variety**: Mix pure combat (chain vs skull-mace) with puzzle elements (fertilizer blinds chainsawer)
+
+### Best Practices:
+1. **First Fight as Tutorial**: Opponent #1 should be trivial—teaches mechanic, not tests it
+2. **Escalation Pacing**: 2-3 weak enemies → 1 medium → 1 strong requires specific counter → boss with multiple conditions
+3. **Weapon Utility Overlap**: Later weapons should replace earlier ones functionally (chainsaw > skull-mace for DPS) but some retain unique value (2x4 reach)
+4. **Fail Forward Option**: If player screws up boss fight, provide alternative path or soft reset rather than game-breaking state
+
+### Common Pitfalls:
+- **Weapon Loss Without Recovery**: If player loses chain on puzzle with no replacement available → combat gauntlet becomes impossible
+- **Unclear Enemy Weaknesses**: Player shouldn't need walkthrough to know "fertilizer stops chainsawer"
+- **Hitbox Ambiguity**: "Only 2x4 can reach low rider" needs visual telegraphing, not obscure collision rules
+
+---
+
+## Related Types
+
+| Type | Similarity to Combat Progression | Distinction |
+|------|----------------------------------|-------------|
+| **Pattern Learning** | Both teach systems through sequential encounters | PL = same power, new applications; CP = increasing power requirements |
+| **Meta-Puzzle Construction** | Both require sequential step completion | MPC = item A produces item B; CP = victory over enemy B produces weapon B |
+| **Timed Con sequence / Permadeath** | Both can create "get this right now" pressure | Timed = single critical moment; CP = sustained series of escalating moments |
+
+---
+
+## Game Examples
+
+### Full Throttle: Mine Road Combat Gauntlet (FT) - Main Example
+
+See complete solution chain documented in "Example Structure" section above.
+
+**Why It's Escalating Combat Progression**: This is the DEFINITIVE example—8 sequential opponents, each requiring specific weapon tier or counter-strategy obtained from previous victories. The entire sequence forms a single traversal obstacle where progression is EQUIPMENT-DEPENDENT rather than KNOWLEDGE-DEPENDENT. Even if player understood all combat tactics from opponent #1, they physically cannot defeat opponent #8 (Cavefish leader) without the 2x4 dropped by opponent #7.
+
+<small>
+Source: lparchive_opendork_fullthrottle_combined.txt, lines 1704, 1824-1865 — Tire iron acquisition and complete enemy progression documentation
+</small>
+
+---
+
+### Full Throttle: Gang Social Recognition (FT, Pattern Identification)
+
+A secondary pattern system exists in Full Throttle's biker gang identification mechanic. The game features three distinct motorcycle gangs—the Polecats (Ben's gang), the Rottwheelers (hostile bikers on mine road), and the Cavefish (cult-like environmentalists). Each gang has visual identifiers that must be recognized for social interactions to succeed.
+
+<small>
+Source: lparchive_opendork_fullthrottle_combined.txt — Multiple references to "Rottwheeler" identification and gang affiliation recognition
+</small>
+
+**Identification Pattern**:
+```
+POLECATS (Ben's allies):
+- Visual: Skull patches, specific vest designs
+- Behavior: Willing to talk/trade with Ben
+- Location: Corley Motors headquarters area
+
+ROTTWHEELERS (Mine Road enemies):
+- Visual: Distinct skull variations (rebel alliance tatoo mentioned)
+- Behavior: Hostile, will not negotiate, must fight
+- Location: Mine Road gauntlet exclusively
+
+CAVEFISH (Environmental cultists):
+- Visual: Bug-eating behavior, cave-dwelling appearance
+- Special: Use infrared night-vision; cannot see without specs
+- Behavior: Religious devotion to Ricky Myran ("spirit" reverence)
+```
+
+**Why This Is Pattern Recognition (NOT Social Engineering)**:
+Player doesn't learn a "social interaction system"—they simply identify WHICH gang is present at each location, then use appropriate approach. This is environmental context recognition rather than active social manipulation. Unlike Comedy-Based Persuasion (MI1), there's no "insult-inspect" discovery process; gang affiliations are immediately apparent through dialogue and appearance.
+
+---
+
+## When to Document as Escalating Combat Progression
+
+Document a puzzle sequence as this type when:
+1. ✓ Player must defeat multiple opponents in FIXED SEQUENCE
+2. ✓ Each victory awards WEAPON/ITEM required (or helpful) for next opponent
+3. ✓ Cannot reorder sequence or skip opponents via alternate methods
+4. ✓ Progression is EQUIPMENT-GATED rather than knowledge-gated
+
+DO NOT classify as this type if:
+- Opponents can be bypassed entirely (optional side content = Mini-Game Integration instead)
+- All enemies defeated with same abilities, no upgrades required (Pattern Learning instead)
+- Single combat encounter without progression chain (Simple Combat Puzzle)

src/puzzles/memo-chain.md

@@ -0,0 +1,113 @@
+# Environmental Memo Chain
+
+**Information Architecture**: Written fragments (notes, memos, signs) distributed across multiple locations in the game world. Each fragment contains piece of larger narrative or set of instructions. Information is presented as background "worldbuilding" but collectively encodes puzzle solution.
+
+**Player Action Pattern**: Collect scattered written items through exploration. Read/compare contents mentally or against notes taken while exploring. Synthesize connections between seemingly unrelated memos to deduce location, character motive, or required item/action.
+
+**Core Mechanic**: Distributed text fragments → player-assembling narrative → puzzle answer revealed through reading comprehension + spatial mapping. No single memo contains full solution; meaning emerges from combination.
+
+**Variations**:
+- Comic interoffice memos between game characters (complaints about each other)
+- Trail notes left by previous adventurers
+- Scattered diary pages out of chronological order
+- Cryptic signs/inscriptions requiring reordering or cross-referencing
+
+**Adventure Game Implementation**:
+- LOOK at scattered items across world (piles of paper, bulletin boards, ground litter)
+- Text is collected as inventory or viewed in situ and remembered
+- Player must map memo locations + connect content themes
+- Standard exploration actions; puzzle is in reading comprehension + memory
+
+**Example Structure**:
+
+```
+Discovery Phase:
+→ Explore Location A: LOOK at note → "Don't leave key here - [CHAR_B] will find it"
+→ Explore Location B (unrelated): LOOK at memo → "[CHAR_A], I stole your backdoor entrance!"
+→ Explore Location C: LOUK at sign → "Restricted area: Monkey Head Base"
+
+Synthesis Phase:
+→ Compare all fragments mentally
+→ Deduce relationship between characters, location hierarchy, item flow
+→ Solution emerges: [KEY] was hidden in [MONKEY_HEAD] by [CHAR_A] to hide from [CHAR_B]
+```
+
+**King's Quest VI Parallel**: None identified in walkthrough.
+
+**Monkey Island Example**:
+- **LeChuck Base Discovery**: Three memos scattered across different screens:
+  - Beach memo: "Please return our key to the Monkey Head" (Cannibals warning)
+  - River Fork memo: Complaint about LeChuck's noisy activities in Sacred Monkey Head area, saw him taking woman with scarf there
+  - Pond memo: LeChuck warns Cannibals not to enter Monkey Head, calls it his "secret base of operations"
+  - **Synthesis**: Monkey Island = LeChuck's hideout; must investigate the Giant Monkey Head interior
+
+---
+
+## Game Examples
+
+### SpaceQuest IV: Time Pod Code Synthesis (SQ4)
+
+**Problem**: Roger needs to travel to SpaceQuest I's location (Ulence Flats), but the time pod requires a six-digit destination code. The complete code is split across THREE separate sources in different game worlds, acquired at different play times. No single source provides complete navigation data.
+
+<small>Source: gamefaqs-tricrokra-archive.html, lines 436-438 — "Unfold this rag and you'll see the part of a time-pod code you need later."</small>
+
+<small>Source: gamefaqs-tricrokra-archive.html, lines 497-503 — "You get the first three digits of the code to get in a new time sector, the three on the rag are the last three"</small>
+
+<small>Source: adventuredoor-walkthrough.html, lines 458-459 — "Read the Space Quest IV hint book, page four about where to go with time pods. Check the wad of used chewing gum to complete the destination code."</small>
+
+```
+MEMO COLLECTION PHASE:
+
+SOURCE 1 - Gum Wrapper (SpaceQuest X, Strange Planet):
+Location: Nest, after dead Sequel Police drops from sky
+Action: Search body → find "rag of paper" (gum wrapper)
+Discovery: Unfolding reveals THREE SYMBOLS (last half of code)
+Acquisition time: Early game, before mall sequence
+
+SOURCE 2 - Hint Book Page 4 (SpaceQuest X, Galaxy Galleria Mall):
+Location: Software Store, bargain bin purchase required  
+Cost: Must earn money first (burger minigame) to afford
+Discovery: Page 4 contains multiple time pod destinations
+Critical data: THREE SYMBOLS for "Ulence Flats" destination
+Acquisition time: Mid-game mall sequence (mandatory disguise/money puzzles first)
+
+SOURCE 3 - Arcade Time Pod Display (SpaceQuest X):
+Location: Game arcade, arrives with Sequel Police officers
+Discovery: Current location encoding displayed on pod screen
+Critical action: Must WRITE DOWN before leaving (game explicitly warns)
+Consequence: Without this code, cannot return to mall after leaving
+
+SYNTHESIS PHASE:
+1. Player has gum wrapper (3 symbols) from SQX Planet
+2. Player buys hint book, reads page 4 (3 more symbols for Ulence Flats)
+3. Combined total = 6-symbol complete code
+4. Player locates accessible time pod with displayed interface
+5. Enter all six symbols in correct order → destination unlocked
+
+
+WHY IT'S A MEMO CHAIN:
+
+1. DISTRIBUTED FRAGMENTS: Code split across gum wrapper (physical note), hint book (documented text), and memory requirement (pod display text)
+
+2. NO SINGLE SOURCE IS COMPLETE: 
+   - Gum = 3/6 symbols
+   - Hint Book = different 3/6 symbols  
+   - Display = interface location reference
+   
+3. SYNTHESIS REQUIRED: Player must mentally combine "first three from book" + "last three from rag" into ordered six-symbol sequence
+
+4. WORLD-BUILDING DISGUISE: Fragments presented as environmental details — gum wrapper felt optional, hint book seemed like easter egg
+```
+
+**Distinction from Multi-Faceted Plan**: MFP = gather independent ITEMS for synthesis. Memo Chain = gather INFORMATION fragments that collectively encode a solution. Here the code numbers are data, not physical components to combine.
+
+---
+
+## Related Types
+
+| Type | Similarity | Distinction |
+|------|------------|-------------|
+| Multi-Faceted Plan | Both gather across sources | MFP collects items/actions; Memo Chain collects text fragments synthesizing into encoded solution |
+| Environmental Storytelling | Info hidden in world details | Environmental Storytelling reveals lore; Memo Chain reveals puzzle solutions |
+| Information Brokerage | All involve knowledge transfer | Brokerage = NPC exchanges; Memo Chain = environment-to-player data only |
+

src/puzzles/metaphor-literal.md

@@ -0,0 +1,215 @@
+# Metaphor-to-Literal Translation
+
+## Mechanic Definition
+
+The game presents abstract language—idioms, metaphors, poetic descriptions, or symbolic phrases—as puzzle instructions. The player must interpret figurative language as literal game mechanics: what would this phrase look like if it could physically exist in the game world?
+
+## Information Architecture
+
+**Conveyance Method**: Text-based symbolic language
+- Phrases appear in dialogue, item descriptions, book text, or environmental signage
+- The solution requires "translating" the metaphor into concrete game objects/actions
+- No explicit instruction—the player must recognize the symbolic nature
+
+**Player Action Pattern**:
+1. Encounter metaphorical phrase in text
+2. Identify what the phrase would mean if taken literally
+3. Locate or create the literal equivalent in the game world
+4. Execute literal action → solution achieved
+
+**Core Mechanic**: The puzzle tests linguistic creativity—can the player imagine what "wallflowers" literally looks like in a game with flowers?
+
+## Design Rationale
+
+- Creates world coherence—language manifests physically, making the world feel internally consistent
+- Rewards literary thinking—players who engage carefully with text are advantaged
+- Generates memorable moments—literalized metaphors become distinctive visual/cognitive landmarks
+- Avoids generic solutions—each phrase has unique literal translation
+
+## Why It's Effective
+
+The "aha" moment is distinct: recognizing that a phrase is symbolic rather than descriptive. This requires active reading rather than passive scanning—a skill that distinguishes engaged players.
+
+## Mechanic Variations
+
+| Variation | Text Type | Literal Translation Approach |
+|-----------|-----------|------------------------------|
+| Idiom | Common sayings | Identify physical objects that represent the idiom's meaning |
+| Poetic | Descriptive verse | Visualize the imagery as actual game elements |
+| Symbolic | Heraldic/mythic language | Map symbols to game objects through cultural knowledge |
+| Invented | Game-specific phrases | Learn the game's symbolic vocabulary through context |
+
+## Generic Example Structure
+
+**Puzzle Text**: "You will need salt water not from the sea to complete the binding."
+
+**Information Flow**:
+- Player reads text → recognizes metaphorical instruction
+- Player asks: "What could 'salt water not from the sea' literally be?"
+- Options: tears (salty), magical solution, mineral water
+- Player examines game world: Are there crying things? Plants with "tears"?
+- Player discovers: A patch of "baby's tears" plants that can be made to cry
+- Player finds: A way to make them cry (give milk to one, others cry in sympathy)
+- Player collects: The literal "tears"
+
+**The puzzle**: Translating "salt water not from the sea" → "plant tears" through symbolic interpretation.
+
+## Adventure Game Implementation
+
+The limited action set maps directly to this puzzle:
+- LOOK at text contexts (signs, books, dialogue) where phrases appear
+- EXAMINE objects referenced in phrases—do they have literal counterparts?
+- USE items that match the literal interpretation
+- The puzzle is fundamentally about mapping text to world
+
+## Game Examples
+
+### Monkey Island I: Troll's Red Herring Riddle
+
+**Metaphor**: "I want something that will attract attention but have no real importance"
+
+**Literal Translation Chain**:
+1. Player reads riddle as abstract requirement
+2. Interprets: "What object is literally known for 'attracting attention' yet being 'unimportant'?"
+3. Identifies idiom: "red herring" — distracting but irrelevant detail in storytelling/mystery
+4. Searches inventory: What's a literal RED HERRING? → Fish (which are often painted red as decoration)
+5. Execute: Give the Fish to Troll
+6. Troll's confirmation: "Ah! A red herring!" reveals the idiom was intentionally chosen
+
+**Design Elegance**: The phrase exists simultaneously as genuine puzzle instruction AND as a common English metaphor—the player wins by recognizing both layers.
+
+### SpaceQuest II: Shaman Word Activation (SQ2)
+
+**Metaphor**: After Roger frees a trapped alien, he encounters small aliens who thank him through their shaman. The shaman speaks an unknown word/syllable via the dialect translator. This foreign language word is the KEY to moving a boulder blocking progress—but the player must understand that this single verbal utterance triggers the mechanical action.
+
+<small>Source: gamefaqs-tricrokra-archive.html, lines 459-462 — "Hear out the shaman who will thank you for saving one of his tribe... SAY THE WORD (the aliens will move the rock)"</small>
+
+**Literal Translation Chain**:
+1. Roger saves trapped alien earlier (independent puzzle) → establishes goodwill connection
+2. Player encounters little aliens in valley after falling through dark cave  
+3- Aliens lead Roger to "village" room shaman appears
+4. Shaman speaks strange word via dialect translator device in inventory: **"SHSR"** (exact syllable unclear what this means, but walkthrough notes it's the alien language equivalent of something significant)
+
+
+5- PLAYER REALIZATION: The phrase/syllable isn't description—it IS the action command itself
+6. Execute: Type "SAY THE WORD" at village → game accepts verbatim foreign syllable
+7. Result: Aliens move boulder, revealing underground passage to next area
+
+**Why It's Metaphor-to-Literal (Edge Case)**:  
+This is a borderline case—the metaphor isn't poetic language but FOREIGN LANGUAGE AS INTERFACE. The "translation" required is:
+
+Metaphorical understanding: Shamans speak words of POWER that trigger events
+Literal game implementation: Type exact syllable heard → word becomes command trigger
+
+**Distinction from Standard Metaphor**: Unlike Troll's Red Herring (common idiom decoded), this uses LITERAL foreign language—the player doesn't decode symbolism, they REPEAT what they heard. However, the core mechanic remains: spoken language = mechanical action trigger, making it a simplified variant of metaphor-to-literal translation.
+
+**Alternative Classification**: This could also be Observation Replay ("memorize word, say it later") but the puzzle's weight comes from understanding that the WORD ITSELF is the key—not where/say/when. The "translation" is accepting that dialogue can directly enable actions.
+
+---
+
+### Monkey Island II: Bone Maze Navigation Song
+
+**Metaphor (from dream sequence)**:
+```
+The HEAD bone is connected to the RIB bone.
+The RIB bone is connected to the LEG bone.  
+The LEG bone is connected to the HIP bone.
+```
+
+**Literal Translation Chain**:
+1. Player experiences bizarre song during near-death dream state
+2. Later faces maze of "Ugly Bone Things" — wall panels with different bone carvings
+3. Recognizes: Song lyrics describe physical connections between bones
+4. Translation rule emerges: Each verse maps to one passage; push the FIRST three bones mentioned (fourth is irrelevant noise)
+5. Execute sequence: HEAD → RIB → LEG passages, ignoring HIP each time
+6. Result: Passageway opens, progress granted
+
+**Key Distinction**: This is metaphor-to-literal because the song (poetic/abstract encoding) describes a PHYSICAL system (bone maze walls). Not "learn pattern" but "decode artistic encoding into mechanical solution."
+
+---
+
+## Common Misidentifications
+
+| Apparent Metaphor | Why It's Different |
+|------------------|--------------------|
+| Dance map = navigation instructions (MI1 fake map) | These are LITERAL dance moves applied as path choices, not metaphorical language | Pattern Learning / Code Translation |
+| Voodoo doll categories ("something of the Thread") | Categories are literal requirements, not symbolic phrases being decoded | Multi-Faceted Plan |
+
+**Test**: Is the text *figurative* (requires linguistic creativity to interpret) or *literal instructions in disguised form* (requires pattern recognition)? Metaphor-to-Literal requires the former.
+
+## Adventure Game Implementation
+
+The limited action set maps directly to this puzzle:
+- LOOK at text contexts (signs, books, dialogue) where phrases appear
+- EXAMINE objects referenced in phrases—do they have literal counterparts?
+- USE items that match the literal interpretation
+- The puzzle is fundamentally about mapping text to world
+
+---
+
+### Loom: Gravestone Prophecy Translation
+
+**Abstract Text (from mother's gravestone)**:
+```
+Destiny shall draw the lightning
+Down from heaven; roll its thunder
+Far across the sea to where I
+Wait upon the Shore of Wonder
+On the day the sky is opened
+And the tree is split asunder
+```
+
+<small>
+Source: the-spoiler_gamecat.html, lines 116-122 — "Destiny shall draw the lightning Down from heaven; roll its thunder Far across the sea to where I Wait upon the Shore of Wonder On the day the sky is opened And the tree is split asunder"
+
+Source: strategywiki_loom_walkthrough.html, lines 658-659 — "Read the up front tombstone. It belongs to Cygna Threadbare, which is (in case you missed it), Bobbin's mother."
+</small>
+
+**Metaphor-to-Literal Translation Chain**:
+1. Player reads prophecy as poetic narrative describing future events
+2. Key metaphorical phrases identified:
+   - "sky is opened" → What could OPEN SKY literally look like?
+   - "tree is split asunder" → The tree must BE SPLIT somehow
+3. Earlier game: Player learned OPEN draft from egg (mechanically, "opening" is a known action)
+4. Hypothesis formation: "What if I cast OPEN on the SKY?" — literal interpretation of sky-opening metaphor
+5. Test execution: Return to opening location (Hillpeak), click stars/sky, cast OPEN draft
+6. Literal result: Lightning strikes, TREE SPLIT in half
+7. Split tree falls into water → becomes boat for sea crossing
+
+<small>
+Source: walkthrough-king_bennett.html, lines 68 — "Leave the village again and return to the mountain where you started. Cast Open on the sky, then return towards the village and go to the dock just left of the village."
+
+Source: gamefaqs_t_hayes_archived.html, lines 301-304 — "Walk right along the path to return to the top of the mountain. Cast Open on the sky, which causes a boat to sail to the dock."
+</small>
+
+**Second Layer: Scrying Sphere Visions (Symbolic Imagery → Future Events)**:
+
+The glassmaker's sphere shows symbolic scenes that translate to literal future events:
+
+1. **First viewing**: Shows cave with dragon on fire (seemingly abstract apocalyptic vision)
+2. **Translation discovery**: Player later learns GOLD-TO-STRAW draft, turns dragon's treasure to straw
+3. **Application**: Cast SLEEP on dragon → dragon breathes fire while sleeping → STRAW IGNITES → CAVE ON FIRE matches sphere vision exactly
+4. **Reward**: Fire reveals previously hidden cave exit (exactly as foretold)
+
+<small>
+Source: gamefaqs_tricrokra_archived.html, lines 518-530 — "Use the Terror draft on them and they'll flee... Examine the sphere you revealed 3 times to get all the hints from it and once again the 'Transendence' draft."
+
+Source: strategywiki_loom_walkthrough.html, lines 696 — "Now make sure that you empty the pool with the EMPTY draft, then look at the sphere three times; a few things happen:"
+</small>
+
+**Why It's Metaphor-to-Literal Translation**:
+1. **Poetic language requires symbolic interpretation**: Prophecy isn't instruction manual—it uses figurative phrases ("sky is opened") that must be reimagined as physical game actions
+2. **Visual symbolism becomes mechanical reality**: Sphere shows DRAGON CAVE ON FIRE as abstract image → player later ENACTS that exact scene through spell combinations
+3. **Linguistic creativity required**: Player can't just follow instructions—must ask "What would 'opening the sky' mean in THIS game world where OPEN is a specific castable draft?"
+
+**Distinction from Observation Replay**:
+Prophecy isn't a sequence to memorize and replay—it's ABSTRACT LANGUAGE requiring creative translation into concrete actions. The solution ("CLICK SKY + CAST OPEN") doesn't appear anywhere as explicit instruction; it emerges from metaphorical interpretation applied within the game's mechanical context.
+
+---
+
+## Related Types
+
+- **Pattern Learning**: Both involve understanding systems, but Metaphor-to-Literal requires linguistic translation before mechanical application
+- **Environmental Storytelling**: Both include narrative text, but this type centers on ACTIVE TRANSLATION of phrases into actions
+
+This puzzle type tests: "Can I imagine what this phrase would look like if the game world took it literally?"

src/puzzles/multi-character-coordination.md

@@ -0,0 +1,662 @@
+# Multi-Character Coordination Puzzle
+
+**Information Architecture**: Game requires two or more characters to perform simultaneous actions at separated locations. Success depends on character switching and timing, NOT just sequential progression or individual character competence. Single-character attempts physically impossible regardless of inventory or knowledge.
+
+**Player Action Pattern**: 
+1. Identify that puzzle has spatially-separated components
+2. Determine which character has required capability (strength, skill, inventory item)
+3. Position each character at their designated location/action point  
+4. Execute actions in tight sequence using character-switch mechanic
+5. All sub-actions complete before narrative urgency timeout
+
+**Core Mechanic**: The puzzle exploits the MULTI-CHARACTER party system to create actions that NO SINGLE character could accomplish alone, regardless of knowledge or items—forcing player coordination and action sequencing across separated spatial contexts.
+
+---
+
+## Variations
+
+| Type | Coordination Pattern | Urgency Level | Example |
+|------|---------------------|---------------|---------|
+| **Simultaneous Dual-Action** | Two characters act at once in different rooms | High (narrative consequence) | Pool reactor: drain & refill |
+| **Sequential Handoff** | Character A creates opportunity → B captures it | Medium | Circuit breaker: off → fix wires → on |
+| **Position Lock + Action** | One character HOLDS state while other acts | Variable | Holding door open, maintaining power OFF |
+| **Character-Skill Complement** | Different abilities required from each character | Low-Medium | Strength to open + skill to manipulate |
+
+---
+
+## Game Examples
+
+### Maniac Mansion: Pool Reactor Meltdown (Dual-Action Simultaneous)
+
+**Problem**: Swimming pool contains two critical items (Glowing Key for dungeon/padlock access, Radio needed later). Pool water functions as atomic reactor coolant located at pool bottom. Draining reveals items but initiates meltdown countdown that destroys mansion if not reversed—killing all characters permanently. Single character physically incapable due to distance/speed constraints between valve location and pool ladder.
+
+<small>Source: syntax2000_walkthrough.txt, lines 219-226 — "NOTE 4:- there is an atomic reactor at the bottom of the swimming pool, the water keeps it from over heating and exploding. To get the radio and the glowing key you must first empty the pool, and then afterwards refill it. A single character can not complete the task alone in the time before the reactor overheats. One character must go under the house to the water valve and another to the pool side."</small>
+
+```
+CHARACTER DISTRIBUTION REQUIREMENTS:
+- HUNK STRENGTH CHARACTER (Dave after Hunk-O-Matic machine, or Bernard)
+  → Task: Open front yard grate, access crawl space, control water valve
+  
+- SECOND CHARACTER (any of remaining two party members, e.g., Syd/Razor/Michael)  
+  → Task: Position at pool ladder, descend during drain window, retrieve items
+
+SPATIAL CONFIGURATION (creates impossibility for single character):
+Location A: Front yard grate → crawl space under house → water valve handle
+Location B: Pool area with descending ladder → pool bottom where items sit
+Distance: Walkable but takes 15-30+ seconds per traversal
+Meltdown Window: Narrative state implies ~45-60 second safe window MAXIMUM
+
+IMPOSSIBILITY PROOF (Why one character fails):
+To complete alone, single character would need to:
+1. Turn ON valve → pool begins draining (Location A start)
+2. Walk from crawl space to outside → to pool area (Location A→B transition)  
+3. Descend ladder as water level drops (timing critical!)
+4. Retrieve TWO items from pool bottom (Glowing Key + Radio)
+5. ASCEND ladder before explosion
+6. Walk back toward crawl space entrance...
+7. ...open grate, descend again (second traversal B→A)
+8. Turn valve OFF to refill pool (before meltdown completes)
+
+Even in ideal conditions with PERFECT timing:
+- Step 2 alone exceeds travel time budget  
+- Steps 6-7 adds another full round-trip cost
+- Total minimum actions = 7 physical movements + item retrievals
+- Safe window likely only covers ~3-4 of these comfortably
+
+TWO-CHARACTER SOLUTION SEQUENCE:
+<small>Source: syntax2000_walkthrough.txt, lines 96-101 — "DAVE:- turn on water valve... SYD:- down into empty pool, get radio, get glowing key, up out of pool. DAVE:- turn off water valve."</small>
+
+PREPARATION PHASE:
+1. Hunk character opens front yard grate (requires strength)
+2. Hunk positions in crawl space near valve handle  
+3. Second character positions at pool ladder waiting position
+
+EXECUTION PHASE (Character switching required):
+4. [Switch to VALVE CHARACTER] Activate water valve → MELTDOWN INITIATED
+   - Pool begins draining rapidly
+   - Reactor exposed, overheating process started
+   
+5. [QUICK CHARACTER SWITCH TO POOL CHARACTER]  
+   - Second character descends immediate as water recedes (no travel time needed!)
+   - Grab Radio from pool bottom
+   - Grab Glowing Key from same location
+   - Ascend ladder back to pool surface level
+
+6. [SWITCH BACK TO VALVE CHARACTER] Turn water valve OFF → Refill initiated
+   - Pool refills, reactor coolant restored  
+   - Meltdown sequence aborted
+    
+7. STORY CONTINUES: Both items obtained, all characters survive, no game-over consequence
+
+CHARACTER SWITCH MECHANIC (SCUMM Engine Feature):
+- Player uses "New Kid" command to cycle between active party members
+- Each character maintains separate position, inventory, actions-in-progress
+- Switching takes negligible time (instantaneous in-game)
+- This mechanic ENABLES coordination puzzles by allowing rapid action sequencing
+```
+
+**Why It's Multi-Character Coordination**:
+1. **Physical Impossibility for Single Actor**: Puzzle design explicitly states "A single character can not complete the task alone" via distance/timing constraints—not lack of knowledge or tools
+   
+2. **Exploits Game's Character-Switch System**: Solution REQUIRES using the "New Kid" command mechanic as core puzzle interaction, not just convenient navigation
+
+3. **Spatial + Temporal Dual Constraint**: Puzzle would be trivial if:
+   - Valve was adjacent to pool (single traversal = one character possible)
+   - Meltdown window was infinite (time pressure removed = sequential same-character action works)
+   Both constraints must exist for coordination requirement
+   
+4. **Parallel Action Architecture**: Successful solution has two characters completing their respective roles in PARALLEL time, not sequentially
+
+**Distinction from Timed Consequence**: 
+While pool puzzle HAS narrative urgency (reactor meltdown), the Timed Consequence classification describes WHAT makes it urgent. Multi-Character Coordination describes HOW it must be solved. Most timed puzzles can be single-character if fast enough—this one is impossible for one character even with perfect timing due to SPATIAL constraints.
+
+**Distinction from Meta-Puzzle Construction**:  
+No sequential item chain here—the two actions (open valve, get items) are COMPLEMENTARY not DEPENDENT. One does not produce an output that enables the next; both must complete within same time window for mutual success. The "production" is coordinated survival, not item crafting.
+
+---
+
+### Maniac Mansion: Circuit Breaker Power Restoration (Sequential Handoff)
+
+**Problem**: Meteor Mess arcade game (on second floor past exam room in Games Room area) displays high score that unlocks Secret Laboratory access code. However, power to games room is cut due to broken electrical wires in attic/observatory space. Restoring power requires simultaneous circuit breaker manipulation AND wire repair—actions separated by floors and requiring different character inventories/tools.
+
+<small>Source: syntax2000_walkthrough.txt, lines 227-233 — "NOTE 5:- a particular arcade game in the games room will give you vital information, but unfortunately the power line has broken in the attic. This is another two character job, one must stand by the circuit breakers in the basement whilst the other must take the tools to the attic. Only when the electric power to the whole house has been turned off can the broken wires be repaired."</small>
+
+```
+SEPARATE REQUIREMENTS (Character Skill/Item Distribution):
+
+CHARACTER A (Circuit Breaker Handler):
+- Location: Basement fuse box (ground floor)
+- Required Action: Toggle circuit breakers OFF during repair window
+- Inventory needed: NONE (just presence and timing)
+- Critical behavior: Must be PRESENT at breaker panel when switch occurs
+
+CHARACTER B (Wire Repair Specialist):  
+- Location: Attic/observatory wiring area (third floor, behind secret door revealed by paint remover)
+- Required Action: Fix broken wires with tools
+- Inventory needed: Tool box from garage + flashlight with working batteries
+- Critical state: Can only work when power is DEACTIVATED
+
+BLOCKING CONDITION ANALYSIS:
+- Broken wires prevent electricity from reaching second-floor game room
+- Arcade meter/game display remains dark/inactive without power  
+- High score code unavailable = laboratory door permanently locked
+- No alternative power source exists in mansion (central breaker only)
+- Attempting to work on live wires = invalid action or electrocution failure
+
+SEQUENTIAL HANDOFF SOLUTION:
+<small>Source: syntax2000_walkthrough.txt, lines 144-151 — "SYD:- ...turn off circuit breakers... DAVE:- turn on flashlight, use tools to fix broken wires... SYD:- turn on circuit breakers"</small>
+
+PHASE 1 - PREPARATION (can occur before power failure discovery):
+1. Character A: Access basement via gargoyle door push → locate fuse box panel
+2. Character B: 
+   - Obtain tool box from garage (yellow key required to open car trunk)
+   - Access plant room, use paint remover on wall blotch → reveals secret door
+   - Enter attic space with broken wires
+   - Open radio found in attic → extract batteries
+   - Install batteries in flashlight
+
+PHASE 2 - COORDINATED EXECUTION (character switching essential):
+3. [Switch to Character A at basement] Open fuse box, prepare for breaker toggle
+   
+4. [SWITCH: Circuit Breakers OFF] Flip circuit breakers to OFF position
+   - ENTIRE MANSION goes dark (cutscene/dialogue confirms power loss)
+   - Attic wire repair window NOW ACTIVE
+   
+5. [IMMEDIATE SWITCH TO Character B in attic] Activate flashlight
+   - Use tool box on broken wires → Repair animation completes
+   - Power restoration enabled (wires now intact and safe for electricity)
+   
+6. [SWITCH BACK TO Character A at basement] Flip circuit breakers back ON
+   - Electricity restored to full mansion including second-floor game room
+   - Arcade meter activates, high score visible
+
+PHASE 3 - ARCADO SEQUENCE NOW UNLOCKED:
+7. Obtain quarter from Edna's sealed envelope (microwave steam puzzle)
+8. Access Meteor Mess arcade machine in now-powered games room  
+9. Insert quarter → High score number displayed = laboratory door code
+10. Use Glowing Key on dungeon double-padlocks, enter numeric code
+11. Secret Laboratory accessible → proceed to final Meteor weapon sequence
+
+URGENCY LEVEL ANALYSIS:
+- NO narrative timer present (unlike pool reactor meltdown)
+- Power can remain OFF indefinitely without consequence
+- HOWEVER, leaving power off too long increases probability of Purple Tentacle encounter when refitting circuit breakers
+  <small>Source: syntax2000_walkthrough.txt, line 151 — "the chances are that the purple tentacle will throw you into the dungeon"</small>
+  
+This creates SOFT URGENCY (danger probability increases) rather than HARD URGENCY (meltdown certainty), making this puzzle more forgiving than Pool Reactor variation.
+
+MULTI-CHARACTER REQUIREMENT PROOF:
+Single character could theoretically complete IF:
+- Travel time from basement to attic < "power OFF" maintenance window (which is infinite!)
+BUT practical constraints make it unwieldy:
+- Must manually carry tools UP multiple flights during execution
+- Flashlight operation while walking + tool usage = clunky single-character flow
+- Design INTENT clearly signals dual approach through narrative setup
+
+The "two character job" explicitly mentioned in walkthrough NOTE 5 confirms this is DESIGNED as coordination puzzle, not just optionally easier with two actors.
+```
+
+**Why It's Multi-Character Coordination**:
+1. **Complementary Resource Distribution**: One character holds location/control (breaker panel), other holds tools/skill—neither can independently complete both halves
+
+2. **Sequential State Management**: Power OFF state is TEMPORARY and must be TRANSITIONED between two locations; holding it requires one actor while the other benefits from it
+
+3. **Intended Design Pattern**: Walkthrough explicitly documents "This is another two character job" confirming design intent, not emergent optimization opportunity
+
+**Distinction from Pool Reactor Variation**:  
+Circuit breaker uses SEQUENTIAL handoff (power off → repair complete → power on) while pool reactor uses TRUE parallelism (drain and retrieve happening in same time window). Both are Multi-Character Coordination but with different temporal patterns.
+
+---
+
+## Design Considerations
+
+**Implementation Patterns**:
+- **Travel Time Budgeting**: Distance between character locations must exceed single-character safe window
+- **Inventory Segmentation**: Required items/tools physically distributed so no one character starts with complete set  
+- **Action Blocking**: Certain locations/actions unavailable until state change occurs (power off, water drained)
+- **Soft vs Hard Deadlines**: Decide if coordination failure has permanent consequence or just requires retry
+
+**Best Practices**:
+1. Make character-switch mechanic quick and intuitive—coordination frustration from clunky switching overshadows puzzle logic
+2. Provide clear visual/auditory feedback when one character's action completes (circuit "click" sound, valve turn animation, pool drain progress)
+3. Consider offering hint about multi-character nature (environmental clue like nearby sign saying "Caution: Reactor—two-person operation required")
+
+**Common Pitfalls**:
+- Players may not check all floors/areas for second character positioning options
+- Ambiguous success/failure feedback leaves players unsure if coordination succeeded or was unnecessary  
+- Overly tight timing windows create frustration rather than cleverness perception
+
+---
+
+## Related Types
+
+| Type | Similarity to Multi-Character Coordination | Distinction |
+|------|-------------------------------------------|-------------|
+| **Timed Consequence** | Both involve urgency and potential failure consequences | TC focuses on WHEN; MCC focuses on WHO/WHERE (can combine) |
+| **Meta-Puzzle Construction** | Both require multi-step completion | MPC has sequential DEPENDENCIES; MCC has synchronized INDEPENDENCE |
+| **Multi-Faceted Plan Puzzle** | Both gather requirements from multiple sources | MFP synthesizes separately-found info; MCC physically requires multiple actors |
+
+---
+
+## When to Use This Type
+
+Document a puzzle as Multi-Character Coordination when:
+1. ✓ Single character literally CANNOT complete it regardless of knowledge/inventory (design constraint, not player limitation)
+2. ✓ Solution REQUIRES using character-switch mechanic at critical action points
+3. ✓ Spatial separation between required actions is intentional design choice
+4. ✓ Both characters perform MEANINGFUL work (not just "wait here" filler roles)
+
+DO NOT use this classification if:
+- Single character COULD solve it with more patience/time (just less efficient = not MCC, standard efficiency optimization)
+- One character passively waits while other does all work (solo puzzle in disguise)
+- Puzzle is really about sequential dependency chain (use Meta-Puzzle Construction instead)
+
+---
+
+## Variations Extended
+
+| Type | Coordination Pattern | Urgency Level | Example |
+|------|---------------------|---------------|-------------|
+| **Single-Character Substitution** | Disguise/skin swap as mechanical workaround for blocking condition | Medium | Loom: Reflect draft enters forge as Rusty |
+
+---
+
+### Loom: Forge Entry via Reflection Substitution (Single-Character Substitution)
+
+**Problem**: Blacksmith's Guild entrance requires a Blacksmith's identity—Bobbin Threadbare as a Weaver is physically blocked from entry by the doorman guard with no dialogue options available to convince him otherwise. However, Bobbin just encountered Wellwrought "Rusty" Nailbender, a legitimate Blacksmith who can enter freely. The REFLECT draft enables appearance substitution, mechanically functioning as a single-character workaround for what appears to be a multi-character requirement.
+
+```
+BLOCKING CONDITION ANALYSIS:
+
+Standard Entry (Impossible):
+- Bobbin approaches guild door → doorman blocks access
+- No TALK/USE OPTIONS available to doorman while standing at gate  
+- Inventory contains distaff only—no items that would convince guard
+- Design intent: Weavers and Smiths are hostile guilds; no peaceful entry as Bobbin
+
+
+SINGLE-CHARACTER SUBSTITUTION SOLUTION:
+<small>Source: walkthrough-king_bennett.html, line 76 — "Cast the REFLECTION on RUSTY. You change appearances."
+
+Source: strategywiki_loom_walkthrough.html, line 694 — "Cast the REFLECTION on RUSTY. You change appearances."
+
+Source: the-spoiler_gamecat.html, lines 305-306 — "use the REFLECT spell on Rusty and you'll swap images. Now walk down to the Blacksmiths' Guild..."
+</small>
+```
+
+**Preparation Phase (Forest Gravestone)**:
+1. After escaping dragon's cave maze, arrive at Blacksmith's cemetery
+2. Wake sleeping boy Wellwrought "Rusty" Nailbender using WAKE draft
+3. Rusty introduces himself as Blacksmith, explains role in firewood gathering
+4. Learn that he works for guild Bobbin needs to enter (unavailable directly)
+
+**Reflection Execution**:
+5. Cast REFLECT draft on Rusty's sleeping form → appearance swap animation plays
+6. Player character now APPEARS AS Rusty visually (skin/substitution not disguise item equipped)
+7. Walk to Blacksmith's Guild entrance
+8. Doorman recognizes "Rusty" as legitimate guild member → allows entry without question
+9. Bobbin enters forge chamber while maintaining Rusty's appearance
+
+**Why It's Single-Character Substitution Variation**:
+
+The REFLECT draft creates a mechanical equivalent of multi-character coordination using ONLY ONE character through identity substitution:
+
+1. **Physical Blocking Workaround**: Doorman's blocking script checks for Blacksmith identity, not specific character sprite. By swapping appearance via magical means, Bobbin bypasses gatekeeper without fighting or dialogue
+2. **Not True Multi-Character**: Unlike MM pool puzzle (two actors at separated locations simultaneously), this is ONE actor playing a different role—the "coordination" comes from having encountered Rusty earlier
+3. **Identity-Based Access Control**: The guard checks VISUAL IDENTITY rather than physical presence—this is key to why single character succeeds where it would normally fail
+
+**Distinction from Sensory Exploitation**:
+- Sensory Exploitation tricks the GUARD'S PERCEPTION (they see something different)
+- Reflection changes THE PLAYER'S APPEARANCE (doorman genuinely sees "Rusty")
+- SE: Guard is fooled; Reflect: Player IS (visually) someone else
+
+**Distinction from Stealth/Disguise Items**:
+In most adventure games, disguise items are inventory objects that player EQUIPS. In Loom, the appearance change is a CASTABLE SPELL with no ongoing inventory tracking—the transformation itself IS the puzzle solution, not an item application step.
+
+---
+
+### Zak McKracken: Pyramid Escape (Position Lock + Inventory Distribution)
+
+(continuing next...)
+
+
+
+**Problem**: Final pyramid tomb in Cairo contains White Crystal needed to complete the alien communication machine. Golden key opens chest but activates timed escape sequence. Three characters must coordinate at sarcophagus, chest/stairs, and exterior—each holding unique inventory items required for successful exit.
+
+<small>
+Source: textfiles-com-solution.txt, lines 287-301 — "Switch to Leslie! Find door and walk to Sarcophagus' feet and push them. Switch to Zak! Walk to stairs. Switch to Melissa! Walk to stairs too. Switch to Leslie! Walk away from feet... Use golden key on box. Push button. Switch to Zak! (quickly) Get white crystal"
+</small>
+
+**Coordination Requirements**:
+
+```
+INVENTORY DISTRIBUTION:
+- Melissa: Golden Key (obtained Mars chamber via ankh force-field bypass)
+- Leslie: Broom Alien (clears sand blocking pyramid exterior entrance)
+- Zak: Bobby Pin Sign (unlocks tomb interior door), Duct-taped fishbowl helmet + wetsuit
+
+SPATIAL BLOCKING CONSTRAINT:
+Position A: Sarcophagus feet pushing point
+Position B: Staircase passage (appears after feet pushed, but physically blocked by character sprite)
+Position C: Upper chamber with golden key box/chest
+Position D: Pyramid exterior entrance (sand pile)
+
+COORDINATION SEQUENCE:
+1. [LESLIE] Push sarcophagus feet → hidden staircase appears BUT she blocks passage
+2. [LESLIE] Walk away from feet area entirely → clears path  
+3. [ZAK & MELISSA] Now can ascend to upper chamber
+4. [MELISSA] Insert golden key in box, push button → TIMER ACTIVATES
+5. [IMMEDIATE SWITCH TO ZAK] Grab white crystal within ~10 second window
+
+ESCAPE PHASE (all three characters):
+6. [LESLIE outside] Use broom alien on sand pile → exterior entrance clears
+7. [ZAK] Use bobby pin sign in keyhole → interior door unlocks  
+8. [All three coordinate through maze to tram exit]
+```
+
+**Why It's Multi-Character Coordination**:
+1. **Physical Blocking**: Leslie's sprite occupies staircase passage; requires character switch + repositioning before others can ascend
+2. **Resource Segmentation**: Golden key (Melissa), broom alien (Leslie), bobby pin sign (Zak) = no single person has complete toolset
+3. **Sequential Dependency Pipeline**: Each actor must complete their role before next can progress
+
+**Distinction from Timed Consequence**: Has urgency (crystal grab window), but PRIMARY mechanic is coordinating three actors through blocking states with distributed inventory—not just speed. TC applies to sub-puzzle; overall pyramid escape is MCC.
+
+---
+
+### Indiana Jones: Fate of Atlantis - Team Path Multi-Character Coordination (IJOA)
+
+**Problem**: On the Team path, players control both Indiana Jones and Sophia Hapgood with character-switching capability. Multiple puzzles require transferring control between characters to access separated locations or leverage unique knowledge/abilities each character possesses. Indy's Team path uses SEQUENTIAL handoff coordination rather than MM-style true parallel action.
+
+<small>Source: walkthroughking_ashley_walkthrough.html — "Let Sophia talk to Costa and then try it yourself." (Initial coordination pattern)</small>
+
+**Coordination Pattern Examples**:
+
+Example A - Sternhart Distraction (Tikal):
+```
+STEP 1 [INDY AT TIKAL]:  
+- Meet Dr. Sternhart blocking pyramid entrance
+- Direct confrontation fails; dialogue doesn't progress goal  
+
+STEP 2 [TRANSFER TO SOPHIA]:
+- Switch character control to Sophia at same location
+- Talk to Sternhart → he's fascinated by her psychic insights, distracted
+
+STEP 3 [RETURN TO INDY]:  
+- Transfer control back to Indiana Jones
+- While Sternhart occupied talking to Sophia → Indy sneaks behind him
+- Steal lantern from unattended position
+
+RESULT: SEPARATION OF ATTENTION enables theft impossible for single character alone
+```
+
+<small>Source: walkthroughking_ashley_walkthrough.html — "Get Sophia to keep him busy, while you go and steal his lantern."</small>
+
+Example B - Nazi Submarine Guard Elimination (Team Path Finale):
+```
+STEP 1 [SOPHIA IN ADJACENT CELL]:
+- Use intercom to communicate with Sophia through shared cell wall  
+- Sophia agrees to create diversion
+
+STEP 2 [COORDINATED DISTRACTION]:
+- Sophia makes noise → guards walk toward her position (out of patrol pattern)
+- Guard now exposed in vulnerable spot between cells
+
+STEP 3 [INDY EXPLOITS POSITIONING]:
+- Walk Indy around behind distracted guard  
+- After Sophia knocks him out with thrown object → Indy collects key items
+
+RESULT: PHYSICAL SEPARATION enables flanking hit that single character's positioning cannot achieve
+```
+
+<small>Source: walkthroughking_ashley_walkthrough.html — "Get her to distract the guard, and then walk around behind him. After she knocks him out..."</small>
+
+Example C - Gold Box Bead Puzzle (Atlantis):
+```
+STEP 1 [INDY GATHERS PRE-REQUISITES]:
+- Collect two orichalcum beads from game progression
+- Acquire golden box mechanism  
+- Obtain fish-shaped orichalcum detector item
+
+STEP 2 [TRANSFER TO SOPHIA FOR PHYSICAL POSITIONING]:  
+- Convence Sophia to crawl through narrow hole (smaller character model required)
+- Sophia positioned behind gate/barrier Indy cannot pass alone
+
+STEP 3 [INDY PROVIDES INVENTORY + DETECTOR FEEDBACK]:
+- Give Sophia gold box containing beads
+- Use orichalcum fish detector → points at Sophia (has hidden bead in necklace)
+- Convence her to place hidden bead into box, close lid
+
+RESULT: CHARACTER-SPECIFIC PHYSICAL CONSTRAINTS (size difference enabling passage through small aperture) + SHARED INVENTORY TRANSFER = solution impossible for solo character
+```
+
+<small>Source: walkthroughking_ashley_walkthrough.html — "Convince her to crawl through the hole... Use the fish and it will point at Sophia's necklace, convince her to put it in the gold box."</small>
+
+**Why It's Multi-Character Coordination**:
+1. **Physical Impossibility For Single Actor某些**: Guard flanking requires simultaneous positioning of attacker (Indy) and distraction-source (Sophia) in separated spatial contexts. Single character would need to walk BOTH approaches simultaneously—requiring sequential handoff mechanism  
+2. **Character-Switching as Core Mechanic**: Puzzle uses the control-transfer command strategically, not just for navigation
+3. **Sequential Handoff Pattern (vs MM Parallel)**: Unlike Maniac Mansion's true parallel control, Indy's Team path uses SEQUENTIAL switching—player controls ONE character at a time, but must alternate between them to maintain coordinated positions/attention states
+
+**Distinction from Multi-Faceted Plan**: MFP gathers independent requirements into synthesis; MCC requires simultaneous spatial occupation or sequential handoff for PHYSICALLY impossible actions. The core challenge is CHARACTER COORDINATION, not information synthesis.
+
+**Distinction from Information Brokerage**: While characters exchange items here, the PRIMARY mechanic is SPATIAL SEPARATION + CONTROL TRANSFER—brokerage focuses on NPC trade mapping regardless of physical positioning. MCC's core question: "how do two separated locations coordinate?" not "who trades what?"
+
+---
+
+### Day of the Tentacle: Super-Battery Construction (Cross-Time Sequential Handoff)
+
+**Problem**: Hoagie needs a super-battery to power his Chron-O-John in 1795, but the battery requires three ingredients (oil, vinegar, gold flakes) and Red Edison's help. These materials are scattered across THREE DIFFERENT time periods—oil and vinegar from past NPCs, gold flakes obtained by flushing through Bernard's present timeline. The battery assembly itself requires Hoagie to distract Red Edison while simultaneously being in two places at once: watching the construction AND stealing the finished product before Red can claim it.
+
+<small>Source: swords_and_software_walkthrough.html, lines 940-948 — "Give the patent application to Red Edison, who asks you to bring him oil, vinegar and gold for the super-battery."</small>
+
+```
+INVENTORY DISTRIBUTION ACROSS TIME PERIODS:
+
+[1795 - PAST / Hoagie's timeline]:
+- Oil: Must convince Benjamin Franklin to give lab coat, then use with kite to generate lightning → collect oil residue from ground after strike? [VERIFY]
+- Vinegar: From Ben Franklin's wine bottle? (needs verification of exact source)
+- Red Edison's Lab: Where battery assembly occurs
+  
+[1993 - PRESENT / Bernard's timeline]:  
+- Gold flakes: Flushed through time from present (possibly from TV show gold or casino win?)
+- Battery plans: Initially taken by Bernard, then flushed back to past
+
+[2026 - FUTURE / Laverne's timeline]:
+- Ingredients possibly gathered here as well (needs walkthrough verification)
+
+MULTI-CHARACTER REQUIREMENTS:
+1. Item gathering across separated timelines (requires character switching + flushing network)
+2. Simultaneous assembly AND theft during distractor window  
+3. Hoagie must be positioned to watch construction complete AND grab battery before Red notices
+```
+
+**Why It's Multi-Character Coordination**:
+While primarily a Cross-Temporal Causality puzzle for ingredient gathering, the FINAL ASSEMBLY requires HOAGIE + RED EDISON coordination—keeping Red distracted while battery finishes cooking, then stealing it. The three-character flushing network (Bernard→Hoagie items) enables the gathering phase which is multi-timeline coordination through the Chron-O-John system rather than traditional spatial separation.
+
+**Distinction from Cross-Temporal Causality**:  
+The super-battery puzzle uses time travel as LOGISTICAL ENABLEMENT (moving ingredients between eras to one assembly point). CTC puzzles have actions that alter WORLD STATE across timelines (tree destruction, document changes). Here the battery is crafted in ONE location using MULTISOURCE inputs—the temporal dimension aids collection not causality.
+
+---
+
+### Day of the Tentacle: Human Show Championship (DOTT, Multi-Character Item Assembly)
+
+**Problem**: Laverne needs to win the "Humanity Show" contest with her mummy entry against rival contestant Harrold. The mummy starts as just a skeleton display—it lacks hair, teeth, and laugh capability needed to compete in all three categories (Best Hair, Best Smile, Best Laugh). Each item can only be obtained by a different character in a separated location/time period. Laverne alone CANNOT complete the entry regardless of her actions or dialogue choices.
+
+<small>Source: gamefaqs_tricrokra_walkthrough.txt, lines 398-427 — "Laverne can't do this on her own, so let's get the help from the boys."</small>
+
+```
+MULTI-CHARACTER REQUIREMENT ANALYSIS:
+
+BEFORE ASSEMBLY (Item Distribution Across Characters):
+- Laverne (Future/2026): Has mummy base entry + nametag for contest registration
+  Cannot obtain any enhancement items in her timeline alone
+  
+- Bernard (Present/1993): Can access Oozo the Clown's laugh box, Dr. Fred's office
+  Items: Fake barf (to disqualify Harrold), laugh box (for Best Laugh category)
+
+- Hoagie (Past/1795): Can access Betsy Ross's room, horse in stables
+  Items: Spaghetti for mummy hair, horse teeth for smile enhancement
+  
+SINGLE-CHARACTER IMPOSSIBILITY PROOF:
+Laverne is spatially isolated from all item sources. Even if she could travel, 
+she cannot perform Bernard's actions (cut clown with scalpel) or Hoagie's actions 
+(read textbook to horse until asleep). Each character has UNIQUE CAPABILITIES required.
+
+COORDINATION SOLUTION CHAIN:
+```
+
+<small>Source: gamefaqs_tricrokra_walkthrough.txt, lines 398-428</small>
+
+```
+PHASE 1 - ITEM GATHERING (Parallel Actions Across Characters):
+
+BERNARD ACQUIRES LAUGH BOX (Present):
+1. Use Laverne's scalpel on Oozo the Clown → clown collapses  
+2. Pick up laugh box from clown inventory
+3. Give/send laugh box to Laverne via Chron-O-John flushing network
+
+BERNARD ACQUIRES BARF DISQUALIFICATION ITEM:
+4. Push speaker box in Green Tentacle's room, turn on stereo
+5. Fake barf dispenses below (munching machine failure)
+6. Send barf to Laverne
+  
+HOAGIE ACQUIRES MUMMY HAIR MATERIAL (Past):
+7. Give spaghetti to Laverne (via item transfer)
+
+BERNARD SENDS TEXTBOOK FOR TEETH EXTRACTION:
+8. Give textbook from Dr. Fred's office to Hoagie
+9. Hoagie reads textbook to horse → horse falls asleep, teeth exposed
+10. Extract horse teeth, send to Laverne
+
+
+PHASE 2 - ENTRY ASSEMBLY (Laverne as Coordinator):
+
+11. Laverne applies fake barf in front of Harrold → disqualification achieved
+12. Apply horse teeth to mummy → Best Smile entry complete
+13. Apply soggy noodles (formerly spaghetti) to mummy head → "hair" created  
+14. Use fork (sent by Bernard) on noodles → combs them into hair-like appearance
+15. Insert laugh box into mummy's pocket → triggers when judges approach
+  
+PHASE 3 - JUDGING:
+16. Talk to judges for ALL categories with enhanced mummy entry
+17. Mummy wins Best Hair (noodles+fork), Best Smile (horse teeth), Best Laugh (box)
+18. Laverne receives dinner coupon prize → enables kennel guard bribery later
+```
+
+**Why It's Multi-Character Coordination**:
+
+1. **Spatial/Temporal Separation of Requirements**: Each character must physically be in their specific time period to obtain items—Laverne cannot get Bernard's laugh box without his presence in the present, cannot get horse teeth without Hoagie reading textbook in past
+  
+2. **Chron-O-John Flushing Network as Coordination Enabler**: Item transfer across timelines requires using the game's unique three-era flushing system—Bernard flushes to Laverne/Laverne flushes to Hoagie creates bidirectional pipeline
+
+3. **Character-Specific Actions Required**: 
+   - Only Bernard can use scalpel on clown
+   - Only Hoagie can read horse to sleep with textbook
+   - Only Laverne can assemble entry and present to judges
+   
+4. **Synthesis at Single Point (Mummy Entry)**: All parallel item gathering converges on single object that Laverne must complete
+
+**Distinction from Cross-Temporal Causality**: While items travel across time, the puzzle does NOT alter world state through historical changes. The laughing box in 1993 is same as in 2026—no causal alteration, only LOGISTICAL TRANSFER. CTC changes HISTORY (tree cut → disappears); this moves INVENTORY.
+
+**Distinction from Meta-Puzzle Construction**: The gathering phase IS parallel (Bernard can get laugh box AND barf in any order; Hoagie's spaghetti/teeth are independent). Only the assembly phase has sequence, but that's minimal. Core requirement is MULTI-CHARACTER not sequential crafting.
+
+---
+
+## The Dig Character-Coordination Patterns (Four Aliens, Shared Inventory)
+
+### The Dig: Crew Task Distribution via Radio Communication (TD)
+
+**Problem**: After arriving on the alien planet, crew members split up and explore different locations independently. Unlike traditional multi-character games with explicit character-switching mechanics, The Dig uses a hybrid system: player controls Boston (protagonist) directly while coordinating with Maggie and Brink through radio communication (Penultimate device). Character abilities are specialized—Maggie's linguistic expertise can interpret alien symbols, Brink's archaeology knowledge identifies artifacts—but they are physically SEPARATED by the game world. Coordination occurs through INFORMATION SHARING rather than simultaneous action.
+
+<small>
+Source: mogelpower_morgana_walkthrough.txt, lines 1-25 — "Maggie ... renowned journalist and linguistic expert"; "Ludger Brink (noted geologist and archaeologist)"
+
+Source: spoiler_paul_greunke_walkthrough.txt, multiple instances of "talk to Maggie about" and "talk to Brink about" as information exchange points
+</small>
+
+**Distribution Requirements**:
+```
+CHARACTER SPECIALIZATIONS:
+- Boston Low (player-controlled): Physical actions, inventory management, exploration
+- Maggie Robbins (linguist): Can interpret alien language symbols when shown artifacts
+- Ludger Brink (archaeologist/geologist): Expert knowledge of ancient technologies, burial chambers, artifacts
+
+INVENTORY SHARING LIMITATION:
+Unlike MM or DOTT where each character has separate inventory, The Dig uses a SINGLE SHARED INVENTORY managed by Boston. However, items must be physically carried TO separated locations where other characters can examine them via TALK/SHOW interactions.
+
+COORDINATION PATTERN ASYNCRONOUS (not simultaneous):
+1. Player/Boston collects artifact at Location A
+2. Travel to Location B where Maggie/Brink positioned
+3. SHOW item → character provides domain-specific insight
+4. Apply knowledge gained when returning puzzle context
+```
+
+**Information Exchange Solution Pattern**:
+
+[Source: mogelpower_morgana_walkthrough.txt, lines 1120-1137]
+
+Example - Glowing Crystals and Life Restoration:
+```
+DISCOVERY PHASE (Boston/Museum):
+→ Boston collects GLOWING CRYSTALS from museum floor
+→ Exhibits show skeleton transformation imagery but no explicit explanation
+
+COORDINATION PHASE (Maggie/Library):  
+→ Boston radios Maggie via Penultimate device
+→ SHOWS crystals to Maggie over radio
+→ Dialogue reveals: "the dead could be raised" via crystal display interpretation
+→ Maggie's linguistic knowledge decodes the museum display meaning
+
+APPLICATION PHASE (Boston/Nexus):
+→ Boston returns to Brink's body with crystals
+→ USEs crystals on body → Brink resurrected as undead being
+```
+
+**Why It's NOT Traditional Multi-Character Coordination**:
+1. **No Simultaneous Actions**: Characters never act in PARALLEL—no character switching for synchronized tasks
+2. **Single Actor Physicality**: All physical actions performed by Boston alone; Maggie and Brink are advisors not doers
+3. **Information Transfer, Not Spatial Coordination**: Puzzle resolution comes from Maggie's KNOWLEDGE being applied to Boston's ITEMS
+
+**Correct Classification**: This is more accurately **Information Brokerage** where NPCs (separated party members) provide expert interpretation. The "multi-character" aspect is narrative framing only—mechanically it's NPC expertise acquisition.
+
+---
+
+### The Dig: Weak Door Opening Requires Crew Member Strength (TD, Positional Coordination)
+
+**Problem**: On the Museum Spire, a WEAKENED DOOR cannot be opened by Boston alone despite being unlocked. It requires TWO crew members to apply force simultaneously—one character pushes while the other assists. This is a physical constraint based on character positioning rather than inventory or knowledge distribution.
+
+<small>
+Source: spoiler_paul_greunke_walkthrough.txt, lines 184-186 — "try to open weakened door (can't open it yet)"
+
+Source: mogelpower_morgana_walkthrough.txt, lines 1052-1053, 1187-1192 — "I couldn't OPEN the WEAKENED DOOR without help... Brink followed me back through... he did help me OPEN the WEAKENED DOOR"
+</small>
+
+**Coordination Requirements**:
+```
+PHYSICAL CONSTRAINT:
+Door mechanism functional but requires combined strength of two characters
+
+CHARACTER DISTRIBUTION:
+- Boston (Player): Positioned at door initially
+- Brink (NPC): Must be physically present at SAME location
+
+NOT INVENTORY DEPENDENT: Cannot solve through items alone—requires crew positioning
+
+SOLUTION SEQUENCE:
+1. [Boston]: Opens doors to Museum Spire, finds weakened door cannot be opened solo
+2. [Boston]: Resurrects Brink using glowing crystals at Nexus
+3. [Both Characters Together]: Enter tram together (Brink follows Boston on-screen)  
+4. [Both at Weak Door]: With BOTH characters present in scene → door can now be OPENED
+5. [Result]: Life crystal chamber revealed, additional crystals can be collected
+```
+
+**Why It's Multi-Character Coordination (Minimal Form)**:
+1. **Physical Presence Requirement**: Puzzle explicitly requires TWO bodies at same location—single character attempt fails with clear feedback ("can't open it yet")
+2. **Not Inventory or Knowledge Based**: No item makes Boston stronger; no conversation provides "how to pry door open"
+3. **Simplified Coordination Pattern**: Unlike MM's complex spatial separation + timing, this is simple PRESENCE DEPENDENCY—two characters adjacent = action possible
+
+**Distinction from Standard MCC**: This is the MINIMAL form of Multi-Character Coordination requiring:
+- Only two characters (not three)
+- No simultaneous actions across separated locations
+- Simple adjacency requirement for unlock condition
+
+It demonstrates that not all multi-character puzzles require MM's dual-location parallel execution—some merely need character stacking at single locus. The "coordination" is simplified to ensuring BOTH characters arrive BEFORE attempting action, rather than sequencing actions DURING puzzle resolution.

src/puzzles/multi-faction-diplomacy.md

@@ -0,0 +1,233 @@
+# Multi-Faction Diplomacy Puzzle
+
+**Information Architecture**: Player discovers existence of multiple warring groups; each faction provides conflicting accounts of events. Player must gather intelligence from all sides to understand underlying cause of conflict before facilitating resolution.
+
+**Player Action Pattern**:
+1. Learn two+ factions are in conflict (narrative setup)
+2. Meet representatives from both factions who blame each other
+3. Gain trust/access to one faction through class-specific means
+4. Extract truth about stolen/missing item causing conflict
+5. Return the contested item, revealing true antagonist behind dispute
+6. Facilitate peace meeting (often disrupted by third party reveal)
+
+**Core Mechanic**: Multi-stage negotiation where each faction must be independently satisfied with player's actions before a unified resolution can occur; the truth only becomes evident when juxtaposing information from opposing sides.
+
+---
+
+## Variations
+
+| Type | Factions Involved | Player Intermediary Role | Example |
+|------|-------------------|--------------------------|---------|
+| **Stolen Trellis Artifact** | Two rival tribes over cultural relic | Recover item, prove theft was false flag | Simbani/Leopardmen: Spear of Death |
+| **Peace Conference Setup** | Three+ groups including government mediating | Earn credentials with all parties | Tarna King, Simbani Laibon, Leopardmen Chief |
+| **Espionage Reveal** | One faction divided by hidden corruption | Expose traitor/infiltrator to restore unity | Thief helps Harami return home |
+
+---
+
+## Game Examples
+
+### Quest for Glory III: The Stolen Spear of Death (QFG3)
+
+**Setup**: Simbani tribe and Leopardmen are on brink of war over the sacred Spear of Death. Laibon claims Leopardmen stole it during peace mission. One survivor (Khatib) claims attack was unprovoked. Player must determine truth and resolve conflict to prevent war, which is actually being stoked by demonic forces seeking to generate deaths for portal-opening ritual.
+
+<small>Source: qfg3-gamefaqs-cyricz.txt, lines 1478-1490 — Storyteller description</small>
+
+<small>Source: qfg3-gamefaqs-cyricz.txt, lines 1875-1886 — "The Hero and his Liontaur friend Rakeesh are summoned to the Kingdom of Tarna to prevent a war from occurring."</small>
+
+```
+MULTI-FACTION DIPLOMACY STRUCTURE:
+
+FACTION 1: SIMBANI VILLAGE
+Goal: Recover Spear of Death, punish Leopardmen for theft
+Representative: Laibon Mkubwa (elder/chieftain)
+Allies to Gain: Uhura (warrior), Yesufu (Laibon's son)
+Player Access Method:
+  - Fighter/Paladin: Complete Warrior Initiation trials
+  - Wizard: Not required at Simbani; bypass via Leopardman route
+  - Thief: No special requirements; can infiltrate later
+
+Key Information Gained:
+  - Spear was on peace mission to Leopardmen (line 1879-1882)
+  - Peace mission attacked, everyone killed except Khatib
+  - Laibon believes this is grounds for war against Leopardmen
+  
+FACTION 2: LEOPARDMEN VILLAGE  
+Goal: Recover Drum of Magic, maintain neutrality/isolation
+Representative: Chief & Shaman
+Allies to Gain: Johari (Chief's daughter), Shaman
+Player Access Method:
+  - All classes: Must marry/free Johari who acts as guide
+  - Requires dispelling her with potion first
+
+Key Information Gained:
+  - Drum of Magic was STOLEN from them (lines 1506-1508, 2963-2970)
+  - They seek drum's return, not Simbani destruction
+  - Chief offers Spear of Death in exchange for drum
+
+PARALLEL TRACKS BY CLASS:
+
+FIGHTER/PALADIN ROUTE (Diplomatic):
+
+PHASE 1: Build Alliance with Simbani
+Action: Complete Warrior Initiation against Yesufu
+Reward: Recognition as Warrior, permission to pursue peace
+
+PHASE 2: Rescue Johari  
+Action: Use Dispel Potion on Leopardman prisoner
+Discovery: It's Johari, seeking marriage/better life
+
+PHASE 3: Win Bride (Simbani requirement)
+Prerequisites: Give Laibon Dinosaur Horn for rites
+Gifts Required: Fine Robe, Fine Spear, 5 Zebra Skins
+Result: Legal "marriage" to Johari authorized
+
+PHASE 4: Win Trust of Johari
+Gifts Required: Beads, Wooden Leopard carving, Fine Dagger
+Action: Open her cage; she escapes peacefully
+
+PHASE 5: Visit Leopardmen Village (with Johari)
+Critical Dialogue Sequence:
+  - Tell about Romance (win her trust, 3 pts)
+  - Show Magic Drum OR Tell about Drum  
+Result: Johari agrees to guide player to village
+
+PHASE 6: Negotiate with Leopardman Chief
+Action: Give Drum of Magic back (20 pts)
+Query: Ask about Spear of Death
+Reward: Chief returns Simbani Spear peacefully (lines 2210-2211)
+
+THIEF ROUTE (Espionage-Influenced):
+
+PHASES 1-3: Same as Fighter (build trust, rescue Johari)
+
+PHASE 4: STEAL the Drum instead of diplomatic acquisition
+Location: Laibon's Hut at night
+Method: Use Fine Dagger on crack in wall while sneaking
+        Enter hidden compartment area
+Result: Possession of Magic Drum illegally (lines 2963-2970)
+
+PHASE 5: Infiltrate Leopardman Village
+Obstacle: Panther blocking Chief's hut entrance
+Solution Options:
+  - Distract with Meat (safer, +5 pts)
+  - Dodge/jump across tightrope without feeding (risky)
+
+Additional Thief Challenge Inside Chief's Hut:
+  - Monkey making noise will wake Chief
+  - Feed monkey Fruit first (5 pts), then free it (5 pts)
+  - Otherwise must maintain stealth while working around it
+
+Action: Steal Spear of Death from wall (10 pts, lines 2996-2998)
+Alternative: Picklock chest for extra items/cash
+
+PHASE 6: Return BOTH Items (not just drum)
+Action: Give Drum to Chief (20 pts)
+          Present Spear to Simbani Laibon (20 pts)
+Critical Difference: Thief gets EXTRA points for spear recovery
+          because it was stolen by their methods, not given back
+
+WIZARD ROUTE (Supernatural Diplomat):
+
+PHASE 1-4: Setup through Johari courtship (same as Fighter/Thief)
+
+PHASE 5: Magical Duel with Shaman replaces physical negotiation
+Unlike Fighter's trials or Thief's stealth, Wizard engages in spell duel:
+  - Each stage presents magic that must be countered
+  - See class-specific-ritual.md for full duel sequence
+  
+FINAL PHASE (All Classes): Use Dispel Potion on Shaman instead of killing
+Result: Maintains peace narrative; Shaman returns Spear peacefully
+
+CRITICAL DIPLOMATIC REVELATION:
+
+Regardless of path, at Peace Conference in Tarna:
+  - Leopardman Chief attacks Laibon unexpectedly  
+  - Yesufu kills Chief with fatal spear thrust (lines 2224-2228)
+  - This was DEMON manipulation — not either faction's true will
+  - Rakeesh warns player to find Demons before war erupts
+
+This reveals the underlying puzzle truth: BOTH FACTIONS were honest
+about wanting peace. The conflict was manufactured by third party (Demons).
+The diplomacy puzzle's purpose was preventing deaths that would fuel
+the Demon Portal — making every point of peacemaking mechanically tie
+to the final battle requirements.
+```
+
+<small>Source: qfg3-gamefaqs-cyricz.txt, lines 2180-2230 — Fighter route to Leopardmen</small>
+
+<small>Source: qfg3-gamefaqs-cyricz.txt, lines 2963-3007 — Thief infiltration of Chief's Hut</small>
+
+**Why It's Multi-Faction Diplomacy (Not Information Brokerage)**:
+
+While information is exchanged, the core puzzle mechanic is:
+1. **Dual Authorization Required**: Both factions must be separately satisfied before unified resolution
+2. **Conflicting Initial Narratives**: One says "they stole from us," other says "they attacked us first"
+3. **Reconciliation via Item Exchange**: Physical objects (Spear, Drum) serve as peace tokens, not just information carriers
+4. **Underlying Third-Party Manipulation Reveal**: Truth only emerges at conference when BOTH sides shown wanting peace
+
+Information Brokerage = trade A for B with single NPC
+Multi-Faction Diplomacy = reconcile A and B's conflict by satisfying requirements for both independently
+
+---
+
+### Quest for Glory III: The Harami Redemption Arc (QFG3)
+
+**Setup**: Early game, player witnesses thief "Harami" being captured and sentenced to honorlessness at Hall of Judgement. Later, homeless in Tarna streets, he becomes a secondary character who can become ally or enemy depending on treatment.
+
+<small>Source: qfg3-gamefaqs-cyricz.txt, lines 1895-1906 — "A man will start running away. Chase after him (8) and you'll find him caught"</small>
+
+```
+FRACTION MICRO-DIPLOMACY: ONE NPC AS NEUTRAL PARTY
+
+INITIAL ENCOUNTER: Hall of Judgement
+Observation: Thief sentenced; declared "without honor"
+Player Choice Point: Testify against him OR remain silent (implicit choice)
+
+SECONDARY ENCOUNTERS (Bazaar Streets):
+
+Encounter 1: Begging for help
+Action Required: Agree to help (+4 pts, lines 2121-2123)
+Failure State: If refused later interactions locked
+
+Encounter 2-4: Night visits  
+Actions Required: 
+  - Give food each night (consumes inventory)
+  - For Thief class: Show proper Thief Sign (+8 pts, line 2928)
+  
+Encounter 5: Final conversation
+Required Topic: Tell him about Rakeesh (+8 pts)
+Information Gained: Harami's backstory; why he stole
+
+CRITICAL REVELATION AT PEACE CONFERENCE:
+
+After conference violence breaks out:
+- Player must flee Tarna to reach Lost City alone
+- Later, at Lost City chamber with Doppelganger enemies:
+  - Five heroes each face evil mirror-self  
+  - All five are losing battles (lines 2290-2293, 2887-2893, 3064-3068)
+
+Diplomatic Payoff Moment:
+Harami appears and STABS the Doppelganger in back (+8 pts honor despite being thief)
+"Letting you run up the stairs to tower"
+
+Why this counts as diplomacy:
+1. Early investment (food, kindness, showing proper thief sign) pays off at critical moment
+2. His help is ESSENTIAL without it team cannot progress
+3. Redemption arc shows he was never truly villainous — just misunderstood outcast like player may have been
+
+This micro-faction represents "the forgotten" — those cast aside by society who can still prove their worth through unexpected acts of honor when player showed them dignity first.
+```
+
+<small>Source: qfg3-gamefaqs-cyricz.txt, lines 2122-2128 — Helping Harami sequence</small>
+
+<small>Source: qfg3-gamefaqs-cyricz.txt, lines 2292-2293, 2678-2679, 3067-3068 — "Harami will show up and stab it in the back"</small>
+
+---
+
+## Related Types
+
+| Type | Similarity | Distinction |
+|------|------------|-------------|
+| Multi-Faceted Plan | Both gather requirements across many sources | MFP = unified objective with parallel tasks; MFD = conflicting objectives must be reconciled |
+| Information Brokerage | Both involve exchange of goods/services for access | IB = linear chain A→B→C; MFD = two independent chains that merge at resolution |
+| Class-Specific Ritual | Both diverge by class | CSR = same outcome, different mechanics; MFD = classes achieve OUTCOMES differently but same diplomatic end-state |

src/puzzles/observation-replay.md

@@ -0,0 +1,620 @@
+# Observation Replay
+
+**Information Architecture**: Game presents a procedural sequence once, under observation-only conditions (guard present, locked door, NPC interference). Player cannot interact during the demonstration.
+
+**Player Action Pattern**: Watch and memorize the exact sequence of actions or values. Return when guard/interference is absent. Replay sequence precisely to unlock new access.
+
+**Core Mechanic**: Single viewing + exact reproduction = reward. Information is presented in correct order once; puzzle difficulty emerges from memory load plus opportunity management.
+
+**Variations**:
+- Numeric sequences (safe combinations, door codes)
+- Action sequences (push/pull patterns, dance moves)
+- Visual patterns (light arrangements, color orders)
+
+**Adventure Game Implementation**:
+- NPC performs action while blocking player interaction
+- Cutscene triggers once, cannot be rewound
+- Player must note sequence through observation alone
+- Return later when conditions allow replication
+- Standard actions (USE TALK LOOK) applied in memorized order
+
+**Example Structure**:
+
+```
+Player needs: Access to [LOCKED_LOCATION]
+
+Discovery Phase:
+→ Approach [LOC] and observe [NPC] perform exact sequence:
+  "Watch as guard opens safe: PULL-15, PUSH-3, PULL-27"
+→ Blocked from interacting ("Can't touch while watched!")
+
+Return Phase:
+→ Create opportunity (distract NPC, wait for departure)
+→ Apply memorized sequence to [OBJECT] with same standard actions:
+  USE safe → PULL handle 15 times...
+→ Reward unlocked
+```
+
+**King's Quest VI Parallel**: None identified in walkthrough.
+
+---
+
+### Quest for Glory IV: Dr. Cranium's Doorbell Sequence (QFG4)
+
+**Setup**: To enter Dr. Cranium's laboratory, the player must ring doorbells in the exact sequence they play when activated. This is a pure observation-replay puzzle where the correct order is demonstrated once at the door.
+
+<small>Source: qfg4-gamefaqs-anonymous.txt, lines 641-647 — "Ring doorbells in exact sequence they play (listen and repeat)"</small>
+
+```
+OBSERVATION PHASE - Sequence Demonstration:
+→ Approach Dr. Cranium's office exterior  
+→ Click on door or bell rope to initiate demonstration
+→ Four bells ring in specific melodic sequence:
+  Bell Order Heard: 2nd → 4th → 1st → 3rd (example)
+→ Audio cue is distinct for each bell position  
+→ Dialogue feedback: "You must match the sequence to enter!"
+
+REPLAY EXECUTION PHASE - Memory Test:
+→ Return to bell ropes after demonstration completes
+→ Click bells in EXACT same order observed during demo
+→ Success condition: All four clicked correctly in sequence, no errors
+→ Failed attempt: Door remains locked; can retry but must remember sequence
+
+Reward upon completion (6 puzzle points): Laboratory access granted.
+```
+
+**Why It's Observation Replay**: Single demonstration of correct sequence under "observation only" conditions. Player cannot interact during demo—must memorize exact bell order, then reproduce precisely when interaction becomes available. No partial hints given; perfect recall required for success.
+
+<small>Cited from: qfg4-gamefaqs-sac.txt:2201-2204</small>
+
+---
+
+### Quest for Glory IV: Will-o'-Wisp Capture (QFG4)  
+
+**Setup**: To reveal the Sense Ritual at a Squid Stone location, the player must capture Will-o'-Wisps at night using candy, then release them in daytime. The puzzle combines timed consequence with observation replay of wisp movement patterns.
+
+<small>Source: qfg4-gamefaqs-anonymous.txt, lines 1075-1076 — "Use candy to lure wisp at night catch in empty flask"</small>
+
+```
+OBSERVATION PHASE - Behavior Learning:
+→ Visit swamp edge at NIGHT (time-gated) only
+→ Observe Will-o'-Wisps floating above dark water  
+→ Note attraction pattern: Wisps approach source of sweets/candy slowly
+→ Observe collection opportunity: Use Empty Flask near wisp when it's close enough
+
+REPLAY EXECUTION PHASE - Timing and Conditions:
+Step 1 → Ensure candy in inventory (purchased from General Store)
+Step 2 → Return to swamp edge at night, confirm Wisps visible
+Step 3 → Use candy on ground/near water surface → Wisps approach lured by sweet smell
+Step 4 → Wait for wisp to come within capture range (~3-5 seconds of wandering)
+Step 5 → Use Empty Flask on approaching wisp → captures it inside
+Time Criticality: Must release Wisps before daybreak or they die in flask!
+
+Deferred Application - Ritual Revelation:
+Step 6 → Visit Squid Stone area with captured Wisps during appropriate conditions
+Step 7 → Release Will-o'-Wisps from flask onto ritual marker  
+Result: Light reveals hidden Mad Monk's tomb entrance/Bone Ritual location
+
+Why It's Observation Replay + Timed Consequence hybrid:Player must OBSERVE wisp attraction behavior then REPLAY the luring sequence correctly.
+CRITICAL TIMING: Wisps must be released BEFORE dawn otherwise puzzle fails permanently.
+This combines OR (observe-reproduce) with TC (narrative urgency without hard deadline but real consequence).
+```
+
+<small>Cited from: qfg4-gamefaqs-anonymous.txt:1075-1080, qfg4-gamefaqs-sac.txt:1946-1952</small>
+
+**Monkey Island Examples**:
+
+**Monkey Island Examples**:
+- **Safe Combination**: Storekeeper opens safe while player watches (notes combination). Later, when storekeeper leaves shop unsupervised after going to find Sword Master, player returns and enters exact PULL/PUSH sequence he observed.
+
+### Grim Fandango: Year Three - Meche's Vault Safe Combination Lock (GF)
+
+**Problem**: Manny must open the vault safe where Meche is hiding from Domino. The safe has a complex combination lock with four tumblers that must be precisely aligned before pulling the opening wheel. Critical detail: Pulling too early causes tumblers to spin, requiring complete reset.
+
+<small>Source: the-spoiler_walkthrough.html, lines 723-760 — Safe combination Q&A and execution details</small>
+
+```
+OBSERVATION PHASE - Learning Combination Lock Mechanics:
+→ Initial vault door approach → "Can't just open; needs tumblers aligned"
+→ Examine wheel interface → Four tumblers visible through slot window
+→ Observation: Tumbler position relative to door jamb indicates alignment
+
+
+REPLAY EXECUTION CHAIN (Must be performed in exact order):
+
+STEP 1A - Align First Tumbler (TOP tumbler):
+Action: Rotate WHEEL RIGHT (clockwise) until all four tumblers begin spinning together
+Critical: Stop wheel exactly when TOPMOST tumbler aligns with door jamb gap
+Verification: Step away from wheel, look at it → Manny's dialogue confirms "they're lined up" or indicates misalignment
+
+
+STEP 1B - Lock First Tumbler in Place:
+Action: Use SCYTHE on spinning tumblers AFTER correct alignment achieved
+Critical Timing: Must block BEFORE pulling handle; handles spinning if pulled prematurely
+
+
+STEP 2 - Align Second Tumbler (SECOND from top):
+Action: Rotate WHEEL LEFT (counter-clockwise) until second tumbler aligns with jamb gap
+Constraint: Cannot overshoot; if passed alignment point, must restart entire sequence from Step 1
+
+
+STEP 3 - Align Third Tumbler (THIRD from top):  
+Action: Rotate WHEEL RIGHT again until third tumbler aligned
+Same constraints apply: Precision stopping required; no room for error
+
+
+STEP 4 - Align Fourth Tumbler (BOTTOM tumbler):
+Action: Rotate WHELL LEFT one final time until bottom tumbler matches jamb gap position
+Final check: All four tumblers should show gaps aligned with door jamb in single column
+
+
+STEP 5 - Open Vault Door:
+Prerequisite: SCYTHE already used on tumblers to lock their positions (Step 1B)
+Action: PULL HANDLE
+Result: If all alignment correct + tumblers locked → Vault opens, Manny enters
+
+FAILURE MECHANICS:
+If PULL HANDLE before SCYTHE locks tumblers → tumblers spin wildly, door won't open. Must restart entire sequence from zero alignment.
+
+
+WHY IT'S OBSERVATION REPLAY:
+
+MEMORIZED SEQUENCE REQUIRED:
+The RIGHT-LEFT-RIGHT-LEFT rotation pattern must be remembered and reproduced precisely. Game provides no on-screen checklist—player either recalls the alternating pattern or fails repeatedly until they notice the alternating direction requirement through observation of tumbler behavior.
+
+EXACT TIMING CRITICAL:
+Each tumbler must stop at exact jamb gap alignment. This is not trial-and-error but PATTERN RECOGNITION from observing how tumblers move as wheel rotates. The "aha" moment comes from watching movement patterns, then reproducing them.
+
+NOIR THEME - CLASSIC SAFE-CRACKING TROPES:
+Combination locks are quintessential noir elements—precision timing, mechanical understanding of locking mechanisms, the tension between success (opening smooth) and failure (tumblers spin). The dialogue feedback ("Manny tells you if they're lined up") mimics films where safecrackers rely on auditory/visual cues.
+
+DISTINCTION FROM PATTERN LEARNING:
+Unlike Pattern Learning, there's no Domain A → Domain B transfer. The vault safe is a single-instance puzzle where observation of THIS SPECIFIC MECHANISM enables success at THIS SPECIFIC LOCATION. No generalized tumbler-system learned for later application elsewhere.
+```
+
+---
+
+### Beneath a Steel Sky: Power Plant Switch Sequence (BAS)
+
+**Problem**: The control panel behind barred gates requires two switches positioned correctly before re-energizing the system, but the correct configuration cannot be determined through examination alone—player must create an opportunity to observe the mechanism working.
+
+<small>Source: 5_steamah_walkthrough.html, lines 382-384 — "Place the PUTTY on the LIGHT SOCKET and turn the main SWITCH back on. This results in a short circuit, opening the left CONTROL PANEL. Turn the main SWITCH back off. Notice two SWITCHes (levers) within the left CONTROL PANEL? Get the left SWITCH levered up and the right SWITCH levered down."</small>
+
+**Discovery Phase**:
+```
+Location: Power Plant (Middle Level)
+
+PHASE 1 - Create Observation Opportunity:
+1. Arrive at power plant with WRENCH and PUTTY (from Factory storeroom)
+2. Use WRENCH on two BUTTONS below steam pipe to unlock them
+3. Have Joey press right button while player presses left simultaneously
+4. Steam valve overloads, old worker leaves room
+5. Turn OFF main SWITCH above control panel → safe to examine
+
+PHASE 2 - Force System State Change (Observation Trigger):
+1. Remove LIGHT BULB from socket when power is off
+2. Replace with PUTTY (conductive material creates short circuit)
+3. Turn main SWITCH back ON → bars blow open due to electrical surge
+4. TURN POWER OFF immediately (now safe to inspect exposed panel)
+
+PHASE 3 - Observe Required Configuration:
+Two switches visible inside opened left control panel:
+- Left switch must be UP
+- Right switch must be DOWN
+
+PHASE 4 - Reproduce Correct Configuration:
+1. Set LEFT SWITCH levered UP
+2. Set RIGHT SWITCH levered DOWN  
+3. Turn main power back ON
+→ Elevator access granted to middle level
+```
+
+<small>Source: 1_preterhuman_mitch_shaw_walkthrough.html, lines 160-174 — Detailed switch manipulation and power cycling sequence</small>
+
+**Why It's This Type**: Player cannot know the correct switch configuration through direct interaction or hints. The puzzle requires creating conditions (short circuit with putty) that cause the game to *demonstrate* the working state (bars open when switches are positioned correctly), then reproducing that exact state later once the panel is accessible.
+
+**Note on 16-bit SCUMM Engine Quirk**: This puzzle leverages Revolution Software's SCUMM-derived engine mechanics—the short circuit isn't realistic behavior but exploits how voltage/short detection logic triggers cutscene events regardless of actual electrical physics. Common in 1990s point-and-click adventures where object interaction rules simplify real-world causality.
+
+---
+
+### Broken Sword: Shadow of the Templars - Stealing Towel and Wire (Chapter 2)
+
+**Problem**: Must steal two items from guarded locations—towel while Doyle takes a drink, wire while monk sneezes. Both require precise timing based on observed NPC action patterns.
+
+<small>Source: broken-sword-1/4_agh_peter_christiansen_walkthrough.html, lines 257-260</small>
+<small>Source: broken-sword-1/4_agh_peter_christiansen_walkthrough.html, line 269</small>
+<small>Source: broken-sword-1/1_walkthroughking_broken_sword.html, lines 97, 100</small>
+
+**Sub-Puzzle A - Towel Theft**:
+```
+OBSERVATION PHASE:
+→ Locate Doyle's office with towel hanging near desk
+→ Watch NPC pattern: Doyle periodically walks to desk corner, takes sip from glass
+→ Identify exact timing window: towel accessible ONLY during drinking animation
+
+REPLAY PHASE:
+→ Wait for next sip cycle (no interaction possible outside window)
+→ At precise moment when mouth reaches glass → Take towel action executes
+→ Towel added to inventory; Doyle unaware due to animation-blocking state
+```
+
+**Sub-Puzzle B - Wire Theft**:  
+```
+OBSERVATION PHASE:
+→ Locate monk holding wire in side room/altar area
+→ Watch NPC pattern: Monk performs repetitive prayer gesture, then sneezes at interval
+→ Identify exact timing window: wire drops to floor during sneeze animation
+
+REPLAY PHASE:  
+→ Wait for next sneeze cycle from doorway (cannot approach without detection)
+→ At precise moment of sneeze → Grab wire action executes before monk recovers
+→ Wire added to inventory; used later for Plaster Casting System puzzle
+```
+
+**Why It's This Type**: Classic Observation Replay structure—player watches NPC perform blocking action once, memorizes exact timing window created by secondary animation (drinking, sneezing), then replays identical sequence to steal item. NOT Pattern Learning because no system rules transfer to new domains—each theft is unique one-off timing puzzle. NOT Distraction Physics because player doesn't manipulate environment; they exploit existing NPC behavior loop without modification.
+
+---
+
+### Broken Sword II: The Smoking Mirror - London Underground Signal Switch (Chapter 5)
+
+**Problem**: Nico must board the train at Thames Dock by switching the signal light to red, but requires obtaining a weight card from a scale that needs coins, and coins are only accessible via hairclip trick on vending machine. The sequence of actions observed during exploration must be reproduced in precise order.
+
+<small>Source: 2_the_spoiler_tom_hayes_walkthrough.html, lines 274-281 — "Walk over to the vending machine. Use the hairclip with the coin slot. Get the coin from the coin reject slot."</small>
+
+<small>Source: 4_kasagaming_walkthrough.html, lines 370-377 — "Use the hairclip on the coin slot of the chocolate machine, then pick up the coin from the coin reject slot... Use the coin on the weighing machine and receive a weight card."</small>
+
+```
+OBSERVATION / EXPLORATION PHASE:
+→ Enter London Underground Station platform area
+→ Observe vending machine with locked items (chocolate, coin) behind slots
+→ Notice handbag in inventory contains hairclip
+→ Try direct interaction → "Can't open without coin" feedback
+  
+REPLAY EXECUTION CHAIN:
+Step 1 → Use hairclip on coin slot of chocolate vending machine
+         - Observed mechanism: clip jams/reverses slot logic
+Step 2 → Collect ejected coin from reject slot  
+         - Timing: immediate action after insertion, no delay
+
+Step 3 → Approach weighing machine with coin in hand
+         - Note display: "Insert penny for card" prompt visible
+
+Step 4 → Use coin on scale → receive weight card automatically
+         - Exchange is automatic; no additional timing window
+
+Step 5 → Locate cupboard next to weighing machine  
+Step 6 → Examine crack near cupboard mechanism (requires dagger)
+Step 7 → Use ancient dagger on cupboard lock → disables obstruction
+Step 8 → Use weight card on access crack → activates door mechanism
+
+Step 9 → Press red signal button → switches train lights to STOP signal
+         - Train now accessible for boarding
+
+Step 10 → Board train → cutscene triggers, arrive at Thames Dock
+```
+
+**Why It's This Type**: While primarily a sequential item use chain, the core mechanic is observing environmental cause→effect relationships then replaying them: hairclip→coin ejection, coin→card exchange, card+dagger→access. Player explores station and observes each mechanism's requirements independently, then replays exact sequences in correct order. The "observation" is reading environmental UI hints (slot prompts, crack visibility); the "replay" is executing the discovered action chains precisely as observed.
+
+**Distinction from Meta-Puzzle Construction**: Each step produces output for next step (coin→card→access), but player DISCOVERS this chain through exploration and observation of separate mechanisms, then REPLAYS it once fully understood. There's no "trial sequence that demonstrates solution" element—just cause-effect relationships learned individually.
+
+---
+
+### Broken Sword II: The Smoking Mirror - Thames Dock Guard Evasion (Chapter 5)
+
+**Problem**: Nico must steal into the ship cabin where Professor Oubier holds the Jaguar Stone, but a guard patrols continuously with Pablo nearby. Success requires timing movement to exact patrol cycle—any deviation results in capture/death. The sequence must be memorized from initial observation and reproduced precisely.
+
+<small>Source: 2_the_spoiler_tom_hayes_walkthrough.html, lines 309-315 — "Click on the other crate on the left, so Nico can hide closer to the ship... Wait until the guard starts talking to Pablo, and then climb down the ladder..."</small>
+
+<small>Source: 4_kasagaming_walkthrough.html, lines 400-404 — Move to second crate after guard passes, move onto boat (ditto) and climb the ladder..."</small>
+
+```
+OBSERVATION PHASE - PATROL CYCLE ANALYSIS:
+→ Enter Thames Dock area, observe guard movement pattern
+→ Guard patrols back along dockside route at fixed intervals  
+→ Pablo stands stationary near ship ladder; occasional dialogue with guard
+→ Ship cabin accessible only during guard attention window on Pablo
+
+GUARD BEHAVIOR LOOPS IDENTIFIED:
+Loop A → Patrol approaches from left → reaches Nico's position → continues right
+Loop B → Reaches Pablo after ~10 seconds → engages in conversation (~5 seconds)
+Loop C → Returns to patrol loop; ship cabin exposed during entire Loop B window
+
+REPLAY EXECUTION - TIMING SEQUENCE:
+Step 1 → Wait for guard patrol → move to SECOND crate (after guard passes first)
+         <small>Source: kasagaming_walkthrough, line 402 — "Move to the second crate after the guard has passed"</small>
+         
+Step 2 → Continue movement ONTO SHIP as patrol clears area
+Step 3 → CLIMB LADDER before patrol completes cycle return
+
+CRITICAL TIMING WINDOW:
+Step 4 → Wait for guard to reach Pablo and START TALKING  
+         <small>Source: tom_hayes_walkthrough, line 312 — "Wait until the guard starts talking to Pablo"</small>
+         
+Step 5 → CLIMB DOWN LADDER (immediately as conversation begins)
+Step 6 → OPEN CUPBOARD door
+Step 7 → CLIMB BACK UP LADDER (guard now faces away, occupied with Pablo)
+
+COMPLETION SEQUENCE:
+Step 8 → Guard enters cupboard investigating → climb down, close cupboard
+Step 9 → Grab mop, use on cupboard door to stick it open/slow guard discovery  
+Step 10 → Look through porthole as cutscene triggers (Oubier/Karzac confrontation)
+
+Step 11 → Enter cabin automatically during scene break
+         → Check Oubier → he's still alive
+         → Grab Jaguar Stone immediately
+         → Karzac attacks → use ancient dagger to escape
+```
+
+**Why It's This Type**: Player observes guard patrol pattern, identifying that guard+Pablo conversation creates temporary vulnerability window. Entire sequence (climb down, open cupboard, climb back up, close behind guard) must reproduce exact timing observed during initial exploration. The "single viewing" is watching guard behavior; the "reproduce exactly" is executing the 4-action sequence during correct patrol cycle. Multiple saves/tries needed if timing fails—but successful run matches observed opportunity window precisely.
+
+**Distinction from Distraction Physics**: Player doesn't CREATE distraction; they EXPLOIT existing NPC routine. Guard-Pablo dialogue happens automatically in game loop—Nico must TIME her actions to it, not trigger it. DNP would involve "pull lever to make guard investigate noise" whereas this is "wait for guard to naturally talk to Pablo."
+
+---
+
+### Syberia: Momo's Dam and Oar Sequence (Valadilene, SYB)
+
+**Problem**: To access the secret mammoth cave, player must open a dam that blocks the river path. The lever controlling the dam is broken when first attempted. Player must observe Momo (the automaton guide)'s movement pattern, then replicate key actions through timed interactions with Momo as intermediary.
+
+<small>Source: gamefaqs_thayes_syberia.txt, lines 360-371 — "ask Momo to Help open the dam. He'll try, but the lever will break off. Get the lever... Run right and ask him to Help get the oar. After Momo gets the oar, run right and ask him to Help open the dam."</small>
+
+```
+OBSERVATION PHASE (Momo's Behavior Pattern):
+
+Step 1 → Follow long forest path after Voralberg house attic sequence
+         - Momo walks ahead as visible guide through secret route
+         
+Step 2 → Reach dam control post with large lever mechanism
+         - Attempt to USE handle directly on dam → Lever BREAKS OFF
+         
+Step 3 → Receive BROKEN LEVER item in inventory (damaged state recorded)
+         - Dam remains closed, path blocked
+   
+Step 4 → Dialogue option "Help" appears when talking to Momo
+         - Player learns Momo CAN interact with environment independently
+
+
+REPETITION REQUIRED SEQUENCE (Exact Action Order):
+
+CRITICAL DISCOVERY:
+→ Dam lever physically broke off—human hands too weak/damaged mechanism
+→ Momo is automaton with superior strength but no independent agency trigger
+→ "Help" dialogue must be used in SPECIFIC CONTEXT to activate Momo's assistance
+
+
+EXECUTION SEQUENCE (must follow exact order):
+
+Step 1 → Collect broken lever from ground after first failed attempt
+         <small>Source: gamefaqs_thayes_syberia.txt, line 364 — "Get the lever"</small>
+         
+Step 2 → Navigate DOWN path to abandoned boat location
+         - Dam is uphill; boat with oar is downstream along riverbed
+
+Step 3 → Attempt to USE broken lever on boat's stuck oar
+         <small>Note: First player tries alone—mechanically fails</small>
+         
+Step 4 → Return to Momo (automaton reappears at boat location)
+         
+Step 5 → Select "Help" dialogue targeting the OAR retrieval
+         <small>Source: line 367-368 — "ask him to Help get the oar"</small>
+         - CRITICAL: Context must be "oar stuck in boat" not general help request
+         
+Step 6 → Momo's automaton animation triggers: Pulls oar free with mechanical strength
+         - Player observes exact action sequence (Momo grips oar, pulls smoothly)
+         - OAR now loose, retrievable by player
+
+Step 7 → Collect OAR from boat (inventory item acquired)
+         
+Step 8 → Navigate UPSTREAM back to dam location (retracing path)
+         
+Step 9 → Select "Help" dialogue targeting DAM lever again
+         <small>Source: line 369 — "ask him to Help open the dam"</strong></small>
+         - Context now is "dam won't open with broken lever"
+         
+Step 10 → Momo's animation triggers second time: Uses superior strength to force dam lever open
+          - Dam gates swing open, river flow unblocked
+          
+Step 11 → Follow newly opened path upstream into mammoth cave entrance
+
+
+WHY IT'S OBSERVATION REPLAY (Not Pattern Learning):
+
+SINGLE-SEQUENCE MEMORIZATION:
+Player does not learn a general SYSTEM to apply across multiple targets. Instead, discovers that Momo can be "helped" with specific tasks in a SPECIFIC ORDER:
+1. Get broken lever → break happens
+2. Go to boat, ask help on OAR first (not dam)
+3. Collect oar → return upstream  
+4. Ask help on DAM second (after oar task completed)
+
+The puzzle is NOT "Momo can lift heavy things" generalized rule—it's EXACT SEQUENCE: broken lever attempt creates item, downstream oar retrieval must complete before upstream dam opening succeeds. Order matters because game state tracks Momo's "help availability" through this specific sequence chain.
+
+
+TIMING/CONTEXT DEPENDENCY:
+Player cannot simply "ask for help twice." The "Help" dialogue option appears ONLY when player is at target location with appropriate context:
+- At boat = OAR help available  
+- At dam AFTER oar retrieved = DAM help available
+
+This creates observation-replay structure where player discovers opportunity windows through initial failure (broken lever), then reproduces the correct sequence of HELP REQUESTS in discovered order.
+
+
+SYBERIA AUTOMATON THEME IMPLEMENTATION:
+Unlike BAS's guard patrol timing, SYB uses Momo as a MECHANICAL intermediary that requires proper input sequencing. The automaton isn't teaching general principles—it's responding to specific command sequences. Player "observes" through trial (broken lever reveals problem) then "replays" correct interaction order with Momo assistant.
+```
+
+---
+
+### Gabriel Knight 1: Snake Scale Observation - Face Removal Sequence (GK1)
+
+**Setup**: After being attacked by a python in the Voodoo Museum, Gabriel returns to his bookstore looking sick. Grace removes something from his face and places it in her ashtray. The player must observe this sequence during a cutscene, then reproduce specific actions when full control returns—using tweezers to retrieve a tiny snake scale that provides critical evidence linking the museum python to the crime scene murders.
+
+<small>Source: justadventure_walkthrough.html, lines 942-950 — "As Gabriel enters the bookstore, Grace remarks on how 'green' he looks and notices something sparkling on his face. (i) Watch CAREFULLY what happens next! (ii) She removes something from Gabriel's face …….. (iii) …………... and puts the small item into the ashtray on her desk. From inventory, use the Magnifying Glass to enlarge the small item in the ashtray – It is a snake scale from the python that attacked Gabriel in the Voodoo Museum. [+ 1 point] Since it is so fragile, from inventory, use the Tweezers to pick up the Museum Snake Scale. [+ 1 point]"</small>
+
+<small>Source: justadventure_walkthrough.html, lines 948-950 — "In inventory, compare the Museum Snake Scale with the Lake Snake Scale you picked up at the crime scene. See the 2 Snake Scales side by side in inventory – They are DEFINITELY from the SAME snake! [+ 2 points]"</small>
+
+**Single Viewing Phase (Cutscene - No Control)**:
+- Player watches Grace observe something on Gabriel's face during dialogue sequence
+- She removes an invisible-to-inventory item with specific hand motion
+- Places it in ashtray on her desk before player regains control
+- Player has NO opportunity to intervene during this sequence
+
+**Reproduction Phase (Full Control Restored)**:
+1. Use magnifying glass on ashtray → reveals tiny snake scale was left behind [+ 1 point]
+2. Use tweezers to pick up fragile Museum Snake Scale from ashtray [+ 1 point]
+3. Compare with Lake Snake Scale from earlier crime scene in inventory
+4. Discovery: Both scales are from the SAME snake species [+ 2 points]
+5. Critical evidence chain complete: Python attack at museum directly connected to murders
+
+**Why It's Observation Replay (Not Truth Revelation)**:
+- The scale existed but was effectively invisible until player WATCHED where Grace placed it during the cutscene
+- Without observing the sequence, player would never know to examine the ashtray specifically—too many other interactions available
+- Actions must be reproduced in exact order: magnifying glass first (reveals item), then tweezers for pickup
+- The discovery (scales match) only possible because player observed AND replayed the removal location
+
+**Distinction from Pattern Learning**: Player doesn't learn a SYSTEM with multiple applications. They observe ONE specific sequence with ONE required reproduction. Grace's action is not part of a reusable mechanic—it's a narrative event that must be witnessed to enable later solution.
+
+---
+
+### Legend of Kyrandia: Merith Marble Chase Path (LK1)
+
+**Problem**: After healing the rotten willow tree with a teardrop from Pool of Sorrows, the spirit Merith appears and mentions finding a marble needed to repair Brynn's silver altar. To obtain it, Brandon must play a game of tag—following Merith's exact movement pattern and sneaking up from behind to claim the marble.
+
+<small>Source: classicgamesparadise_walkthrough.html, line 47 — "At the rotten willow tree, try using the teardrop you found at the Pool of Sorrows to heal the tree. After it is healed, Merith shows up and mentions a marble he found. To get it, you will need to play a little game of tag. He will lead you to the northeast where you can sneak up on him."</small>
+
+<small>Source: classicgamesparadise_walkthrough.html, line 55 — Summary step: "Chase Merith for the marble"</small>
+
+```
+OBSERVATION PHASE - Initial Encounter and Path Demonstration:
+
+Step 1 → Prerequisite Completion:
+- Earlier in game: Obtain teardrop from Pool of Sorrows (separate puzzle chain)
+- Navigate to rotten willow tree location (Timbermist Woods area)
+- Use teardrop on diseased tree → healing transformation cutscene triggers
+
+Step 2 → Merith Appearance:
+- Tree spirit Merith materializes after healing complete
+- Dialogue exchange: Merith mentions discovering marble, implies it belongs on altar
+- No explicit handover; Merith initiates chase game instead
+
+Step 3 → Path Demonstration (Observation Critical):
+- Merith begins moving in SPECIFIC DIRECTION (northeast from willow tree)
+- Movement pattern establishes exact route through forest terrain
+- Brandon cannot interact with Merith during this phase ("too fast!") or if approaching from wrong angle (Merith flees)
+
+REPLAY EXECUTION - Path Following and Capture:
+
+Step 4 → Follow Observed Route:
+- Player must navigate Brandon along SAME northeast path Merith demonstrated
+- Key spatial detail: Merith's movement establishes correct navigation through maze-like woods
+
+
+Step 5 → Position for Approach:
+- Continue following until reaching endpoint of chase path
+- Merith slows/stops at destination point (northeast forest clearing)
+
+Step 6 → Sneak-Up Maneuver (Timing/Angle Critical):
+- Player must approach from BEHIND Merith's position
+- Attempting frontal interaction or wrong angle → Merith runs again, requires respawning/chase restart
+  
+Step 7 → Marble Acquisition:
+- Successful sneak approach triggers capture event
+- Marble automatically added to inventory
+- Merith departs, puzzle resolved
+
+
+WHY IT'S OBSERVATION REPLAY:
+
+SINGLE VIEWING ESTABLISHES SOLUTION:
+Merith's initial northeast movement is the ONLY demonstration of correct path. No map marker, no compass hint, no repeated dialogue explaining direction. Player must MEMORIZE the exact route Merith took during opening chase phase.
+
+
+EXACT REPRODUCTION REQUIRED:
+Path following isn't "general area navigation." The walkthrough specifies "northeast" as critical detail—wrong directional choice leads to dead ends or requires backtracking to restart pursuit.
+
+Angle/Timing Component Adds Memory Load:
+Beyond path memorization, player must remember APPROACH MECHANIC: sneak from behind. This is demonstrated implicitly by game's blocking behavior (can't grab Merith during chase, fails if approached incorrectly). Successful reproduction requires combining BOTH spatial memory (where) AND interaction memory (how).
+
+
+NO TRIAL-AND-ERROR DISCOVERY:
+Unlike exploration puzzles where player experiments with different paths, here the SOLUTION EXISTS IN THE CUTSCENE. Trial-and-error only works through multiple save/loads or by correctly retaining path information from initial observation.
+
+FAILURE MODES DEMONSTRATE MEMORY REQUIREMENT:
+- Wrong direction from willow tree → cannot find Merith, must revisit and reobserve chase start
+- Correct path but wrong approach angle → Merith flees, sequence potentially resets
+- Frontal approach attempt → blocked by game state ("can't catch him!")
+
+
+DISTINCTION FROM DISTRACTION PHYSICS:
+Player doesn't CREATE distraction condition or manipulate environment. Merith's movement pattern is pre-scripted game loop—Brandon must ADAPT to it, not cause it. The puzzle tests OBSERVATION → MEMORY → REPRODUCTION chain, not environmental manipulation or timing-based NPC state change.
+
+
+POTENTIAL IMPLEMENTATION VARIANTS:
+This chase structure could easily be a Pattern Learning if marble-catching mechanics applied elsewhere (e.g., "catch other escaping sprites using same path-follow rule"). But in LK1's context, it's single-instance observation replay: one cutscene establishes solution, one reproduction sequence succeeds.
+
+
+CONNECTION TO LARGER PUZZLE CHAIN:
+Marble itself feeds into METALOGIC puzzle: Silver Altar Repair at Brynn's Temple:
+1. Get teardrop from Pool of Sorrows (earlier chain)  
+2. Heal willow tree → triggers Merith appearance
+3. Chase Merith for marble (this observation replay)
+4. Return marble to Brynn's temple altar
+5. Place silver rose on repaired altar → activates amulet
+
+The chase is ONE LINK in larger meta-construction, but its internal mechanic is pure observation replay.
+
+
+
+---
+
+### Indiana Jones and the Last Crusade: Skull Music Sequence Puzzle (INDY1)
+
+**Problem**: In lower catacombs of Venice, a chamber contains multiple skulls mounted on walls. Each skull produces a distinct musical tone when struck in sequence. The grail diary contains a musical notation indicating which skulls to strike and in what order. Player must observe the skull positions during initial exploration, then precisely replay the sequence when all conditions are met—hitting wrong skull or wrong order triggers failure state.
+
+<small>Source: walkthrough-king.txt, lines 137-139 — "Look at the diary once more to get some clues. The top line indicates the left skull, the next the second skull, etc. Play the skulls in the order indicated by the music to open the door."</small>
+
+**Observation Phase**:
+```
+INFORMATION SOURCE: Grail Diary Musical Notation
+- Open diary in inventory
+- Examine page showing staff notation with note positions
+- Each line/position corresponds to skull from left-to-right
+- Example: Top line = first skull (far left), second line = second skull, etc.
+
+SKULL CHAMBER EXPLORATION:
+- Enter chamber containing multiple mounted skulls
+- Note each skull produces DIFFERENT PITCH when struck
+- Skulls arranged horizontally along wall in linear sequence
+- Player must mentally map diary lines to physical positions (1st diagram line = 1st physical skull from left)
+
+BLOCKING CONDITION BEFORE OBSERVATION COMPLETE:
+- Door to next area locked, no alternate passage exists
+- Attempting random strikes produces incorrect notes (audio feedback indicates wrong sequence)
+- Only correct musical sequence opens door
+```
+
+**Replay Execution Phase**:
+```
+SEQUENTIAL STRIKE PATTERN (Per Diary Notation):
+
+Step 1 → Examine grail diary one final time, confirm note order mentally
+         - Critical: Must remember sequence; cannot look at diary during execution
+
+Step 2 → Strike FIRST skull indicated by top-most notational line in diary
+         - Position determined by line position (not absolute left-to-right on screen, 
+           but relative to diagram structure)
+
+Step 3 → Move to SECOND skull per next musical notation line
+         - Timing: Must occur within reasonable interval or sequence may reset
+
+Step 4 → Continue through ALL skulls matching notated pattern
+         - Audio feedback: Each strike produces distinct pitch
+         - Visual confirmation: Skull vibrates when struck correctly
+
+VALIDATION: After final correct skull struck, hidden mechanism activates → door unlocks silently
+```
+
+**Why It's Observation Replay (Not Symbol Code Translation)**: While there IS a diagram to decode, the core mechanic is MEMORY AND TIMING—player must internalize sequence from static notation then perform it without reference during execution phase. Unlike SCT where symbols map directly to interface buttons here, the player memorizes ACTION SEQUENCE (strike order) rather than translating symbol-to-button equivalency. The skulls are not "interface elements" with matching properties—they're distinct physical objects requiring correct STRIKE ORDER reproduction.
+
+**Distinction from Pattern Learning**: Single application only—no repeated framework across multiple door/sequence pairs. Pure observation → memory → exact reproduction structure. Once learned and executed successfully, puzzle complete with no further applications of the musical sequence system.
+
+**Critical Timing Element**: Walkthrough emphasis on "play skulls in order" suggests sequence must occur within time window—player cannot indefinitely flip back to diary between strikes. This creates memory load pressure where player must retain full sequence during single execution attempt.
+
+<small>Cited from: walkthrough-king.txt:137-139</small>

src/puzzles/pattern-learning.md

@@ -0,0 +1,812 @@
+# Pattern Learning / Knowledge Transfer
+
+**Information Architecture**: Game teaches a complete mechanical system in a low-stakes domain, then requires application of exact same rules in higher-stakes domain against different target. The tutorial IS the training—no explicit instruction, only pattern discovery through interaction.
+
+**Player Action Pattern**: Engage with training instances exhaustively to discover full rule set. Internalize cause/effect mappings (insult A → retort B). Face final application where mechanics are identical but consequences escalate (more rounds, permanent failure state, critical plot progression).
+
+**Core Mechanic**: The learning domain and application domain share IDENTICAL underlying rules. Player success depends on recognizing that Domain A was never a different puzzle—it WAS the solution manual for Domain B. This is NOT "practice makes perfect" through repetition; it's "this system you just learned operates elsewhere."
+
+**Variations**:
+- Combat dialogue systems (insult/retort pairs)
+- Construction/crafting frameworks (ingredient categories → application recipe)
+- Code/password mechanics where training example uses same algorithm as lock
+
+**Adventure Game Implementation**:
+- Tutorial or "optional" early-game puzzles that teach full system
+- Standard TALK/USE actions reveal mechanical rules through trial/error
+- Later puzzles invoke same mechanic with different flavor/text/skins
+- Player must recognize: the framework hasn't changed, only the context
+
+---
+
+## Example Structure
+
+### Swordfight Combat System (MI1)
+
+```
+Learning Phase:
+→ Encounter 4 types of roaming pirate NPCs with combat mini-game
+→ Each duel reveals subset of insult/retort rule mappings
+→ Exhaust all 16 combinations: learn every insult → correct retort pair
+→ Rule: If opponent uses wrong retort, you win point; if they use right one, they win
+
+Application Phase:
+→ Sword Master fight introduces NEW insult text (20+ different lines)
+→ BUT: Same 16 retort rules apply to mapped insults
+→ Pattern recognition critical: "My tongue is sharper" → maps to feather-duster rule
+→ First to 5 points wins (vs training's first-to-3)
+```
+
+### Voodoo Doll Construction Framework (MI2)
+
+```
+Learning Phase (Act I - Largo):
+→ Voodoo Lady explains 4 ingredient categories for curse doll:
+  1. Something of the Thread (clothing)
+  2. Something of the Head (hair/hairpiece)  
+  3. Something of the Body (bodily fluids)
+  4. Something of the Dead (ancestor bone/remains)
+→ Player gathers these 4 types for Largo doll successfully
+→ Complete doll construction = working framework learned
+
+Application Phase (Part IV - LeChuck):
+→ After explosion, discover same Juju Bag mechanic
+→ Framework from Act I applies: need Thread/Head/Body/Dead components
+→ New instances of each category: Skull (Head), Beard Bits (Body), 
+   Underwear (Thread), Used Hanky (fluid)
+→ Apply same construction recipe → empowered doll works on LeChuck
+```
+
+### Beneath a Steel Sky: LINC-SPACE Tile Password System (BAS)
+
+**Problem**: Navigating through virtual reality spaces requires understanding the tile-based password system. The game teaches this in an early safe zone, then requires exact application in restricted security areas with timed constraints.
+
+<small>Source: 5_steamah_walkthrough.html, lines 454-460 — "Pick up the BALL (Compressed Data – Red & Green YinYang symbol)... Open the CARPET BAG and obtain the MAGNIFYING GLASS (Decrypt) and BIRTHDAY SURPRISE (Decompress)... Keep alternating between the green and red passwords on the tiles"</small>
+
+```
+Learning Phase (First LINC-Space Visit - Tutorial Area):
+→ Enter interface room at Security HQ with ID CARD
+→ Access INTERFACE terminal, "jack in" to LINC-Space VR environment
+→ Room 1: Pick up BALL (Compressed Data) containing Red+Green password symbols
+→ Room 2: Open CARPET BAG → get MAGNIFYING GLASS (Decrypt command) and SURPRISE GIFT (Decompress)
+→ Discovered mechanic: DECRYPT removes "?" from documents, DECOMPRESS expands ball into passwords
+→ Room 3: TILE PASSWORD SYSTEM demonstrated on floor panels with green/red symbols
+
+Rule Discovery:
+1. Floor tiles show GREEN or RED symbols
+2. Player stands on a tile → places matching COLOR PASSWORD on current tile
+3. This reveals a BRIDGE to adjacent tile (previously invisible/impassable)
+4. Pattern: Alternate red/green passwords as you progress across tile sequence
+5. Goal: Reach thick plasma beam exit using correct alternating sequence
+
+Application Phase (Later LINC-Space Visits - Timed Security Zones):
+→ First return with ANITA's CARD: Same tile rules apply, but now EYEBALL guardians present
+→ SECONDARY RULE discovered: Use BLIND command on eyeballs to freeze them temporarily (~15-20 sec)
+→ Pattern learned applies under pressure: Must navigate tiles WHILE managing reactivation timer
+→ Player must remember/execute the exact same password alternation pattern learned earlier, 
+   but now with added time constraint (eyeball reactivates after 15-20 seconds)
+
+Third Visit - FINAL APPLICATION:
+→ Enter with medical android's RED CARD → need access to CRYSTAL room guarded by CRUSADER
+→ Same tile password mechanics apply (unchanged)
+→ New challenge: CRUSADER blocks path until destroyed
+→ Player must have acquired DIVINE WRATH program (from earlier eyeball blinding) to remove guardian
+→ Once CRUSADER defeated, same red/green tile alternation allows access to CRYSTAL room
+→ OSCILLATOR program (TUNING FORK from second visit) shatters crystal → VIRUS obtained
+```
+
+<small>Source: 1_preterhuman_mitch_shaw_walkthrough.html, lines 232-247 — "Use the DECRYPT program on the two DOCUMENTS with '?' on them... Use the PASSWORDS (green and red swirls) to get to the DOOR..."</small>
+
+<small>Source: 5_steamah_walkthrough.html, lines 517-571 — Timed eyeball blind/CRUSADER sequence combining multiple learned systems</small>
+
+**Why It's Pattern Learning**: The tile password system is taught exhaustively in the first safe visit (Room 3). Every subsequent LINC-Space visit uses IDENTICAL mechanics—no new tutorial, no changed rules. The challenge escalation comes from added constraints (timed eyeballs, guardian enemy) but the underlying navigation framework never changes. Player must recognize "the red/green alternation I learned in Room 3 still works here."
+
+**Distinct Cyberpunk/Hack Element**: Unlike classic adventure puzzles, this leverages LINC-Space's virtual reality setting—inventory becomes COMMANDS not OBJECTS (Decrypt, Decompress, Blind, Oscillator as verbs). Pattern applies across "virtual rooms" with consistent rules regardless of visual theme changes.
+
+---
+
+### Quest for Glory IV: Antwerp Maze → Knowledge Transfer to Monastery (QFG4)
+
+**Setup**: Dr. Cranium's lab contains two interconnected puzzles using a bizarre antwerp-throwing device (TRAP). The maze puzzle teaches core mechanics in a low-stakes bouncing-ball format, while information gathered about hexapods transfers to a completely separate monastery puzzle days later.
+
+<small>Source: qfg4-gamefaqs-anonymous.txt, lines 648-679 — "Use TRAP device to identify baby antwerp via yes/no questions... second TRAP use identifies hexapod → learns eats garlic (info for monastery later!)"</small>
+
+```
+LEARNING PHASE - Antwerp Maze Mechanics (Dr. Cranium's Lab, Room 2):
+→ Enter bouncing room with antwerps (strange legless babies that hop constantly)
+→ Use T.R.A.P. device in center room to identify target: Baby Antwerp
+  Rule discovered: TRAP uses elimination-based yes/no questioning
+  Questions asked: "Does it bounce?" → Yes; "Does it have legs?" → No; etc.
+  Must whittle down until only Baby Antwerp matches all answers (2 points)
+
+→ Feed avocado to device → captures one baby antwerp successfully (2 points)  
+  Rule discovered: Baby antwerps can be trapped via food bait
+
+→ Enter Key Maze room with captured antwerp inside
+→ Rotate maze walls to guide bouncing antwerp toward key, then exit
+  Rules learned:
+  - Antwerp bounces off walls at consistent angles (physics pattern)
+  - Holes send antwerp back to start (avoidance consequence)
+  - Rotating maze changes trajectory dynamically  
+  - Key must be reached BEFORE final exit to complete puzzle
+→ Exhaustive pattern testing required: try rotations, observe bounce outcomes, 
+  refine mental model of reflection physics
+
+APPLICATION PHASE 1 - Second TRAP Identification (Same location, different target):
+→ Return to T.R.A.P. device, identify another creature
+→ Through elimination questioning, discover HEXAPOD properties:
+  "Does it have six legs?" → Yes
+  "What does it eat?" → GARBAGE revealed as preference BUT also GARLIC mentioned
+  Critical knowledge gained: "Hexapods love garlic!" (2 points)
+→ No immediate application of this information here—store for later
+
+DEFERRED APPLICATION PHASE - Monastery Hexapod Encounter (~5+ days later, different location):
+→ Enter monastery basement, find hexapod statue above fireplace  
+→ Remember TRAP identification: hexapods love garlic!
+→ Use clove of Garlic on hexapod statue
+→ Result: Statue's aggression neutralized, can approach without harm
+→ Click Hand on right side of fireplace → discovers secret passage to basement (6 points)
+
+Why It's Pattern Learning / Knowledge Transfer:DOMAIN TRANSFER BETWEEN PHYSICALLY SEPARATED PUZZLES:
+Learning domain = Dr. Cranium's lab with TRAP device and antwerp maze
+Application domain 1 = Same TRAP device but different creature (hexapod info extraction)  
+Application domain 2 = Completely separate monastery building, days later
+
+MECHANICAL CONSISTENCY:TRAP device uses identical yes/no elimination mechanic for both creatures.
+Information gathered in low-stakes lab puzzles has HIGHER-STAKES application at monastery:
+without garlic knowledge, player either can't progress or takes damage trying to approach aggressively.
+
+THE KEY DIFFERENCE FROM INFORMATION BROKERAGE:Not "NPC A tells you info NPC B needs" (brokerage)
+but rather "Player discovers rule/mechanic/knowledge in Domain A that solves problem in Domain B."
+The TRAP device doesn't GIVE information—it enables PLAYER to extract knowledge through mechanical interaction,
+then player must remember and apply it across significant spatial/temporal separation.
+
+EXHAUSTIBLE RULE SPACE:Antwerp maze has finite physics system (bounce angles, hole penalties, key/exit sequence)
+TRAP questioning has binary branching tree with exhaustive answer combinations
+Both are COMPLETE systems fully learnable before application required
+```
+
+<small>Cited from: qfg4-gamefaqs-sac.txt:2210-2235, qfg4-gamefaqs-anonymous.txt:648-728</small>
+
+---
+
+## Key Identifiers
+
+1. **Same mechanic, different skin**: Not "I learned to make Largo's curse" but "I learned the voodoo doll system"
+2. **Exhaustible rule space**: Finite complete system can be discovered (16 insults, 4 categories)
+3. **Domain transfer**: Learning happens in Domain A, application in Domain B, mechanics identical
+4. **No new teaching**: Application phase provides zero tutorials; assumes player recognized the system
+
+---
+
+## Related Types
+
+- **Multi-Faceted Plan**: Both gather across multiple steps, but MFP has different *categories* of requirement (key+code+distracter), not one unifying *system*
+- **Observation Replay**: OR reproduces exact sequence verbatim; KT applies rules to new targets
+- **Environmental Storytelling**: KT often includes world text, but puzzle is the mechanic transfer, not narrative connection
+
+---
+
+## Common Misidentifications (NOT Knowledge Transfer)
+
+| Apparent Similarity | Why It's Different | Actual Type |
+|--------------------|---------------------|-------------|
+| Password game: learn finger-counting logic → apply to 3 doors | Single-domain application, no mechanical transfer | Pattern Recognition / Logic Puzzle |
+| Parrot directions: feed crackers → get navigation clues | Information collection, not system learning | Multi-Faceted Plan (direction synthesis) |
+| Spitting contest: watch wind timing → spit in window | Observation + execution of single puzzle | Environmental Timing Puzzle |
+| Bone maze dream: song lyrics → corridor mapping | Cryptic message decoding | Metaphor-to-Literal Translation |
+
+**Critical Test**: Could you describe the solution as "I learned [SYSTEM] that applies to both [CONTEXT A] and [CONTEXT B]"? If not, it's not Knowledge Transfer.
+
+---
+
+### Broken Sword: Shadow of the Templars - Plaster Casting System (Chapter 2)
+
+**Problem**: Create key cast from statue impression, but plaster won't set correctly without understanding material science principles that must be learned in one domain and applied in another.
+
+<small>Source: broken-sword-1/4_agh_peter_christiansen_walkthrough.html, lines 289-307</small>
+<small>Source: broken-sword-1/1_walkthroughking_broken_sword.html, lines 113-119</small>
+
+```
+Learning Phase (Domain A - Chemistry Lab):
+→ Visit chemistry laboratory environment early in chapter
+→ Examine plaster demonstration station or read related documentation
+→ Discovery through environment: Plaster requires moisture to cure properly
+→ Scientific principle learned: Water acts as catalyst—dry plaster = useless, wet plaster = functional
+
+Application Phase (Domain B - Pub Cellar Imprisonment):
+→ Later imprisoned in pub cellar with statue impression and dry plaster
+→ Standard approach fails: can't cast without water source nearby
+→ Framework recognition moment: "Plaster needs moisture"—lab principle applies here
+→ Environmental scan for liquid → towel accessible near water source (pub cellar sink)
+→ Apply learned system: Wet the towel, mix controlled moisture with plaster
+→ Successful key cast produced using transferred knowledge from Domain A
+
+WHY IT'S PATTERN LEARNING / KNOWLEDGE TRANSFER:
+The UNDERLYING RULE ("plaster requires moisture ratio to cure") is IDENTICAL across both domains. Laboratory teaches complete mechanical framework—not "do steps a,b,c here" but "this chemical principle exists." Cellar imprisonment requires recognizing that framework applies despite different context/setting. Distinction from Observation Replay: no sequence memorization, only abstract cause-effect relationship transfers. NOT Multi-Faceted Plan because single unifying system governs both instances, not separate requirements needing synthesis.
+```
+
+---
+
+### Grim Fandango: Coat Check System + Photo Finish Ticket (GF - Year Two)
+
+**Problem**: In the Calavera Cafe bar, Lupe runs a coat check system using color-coded tickets. The photo finish counter at the Cat Track requires a specific racing ticket with week number, day of week, and race number. Both systems encode information symbolically—players must learn the encoding rules from environmental clues, then apply them to generate correct outputs.
+
+<small>Source: the-spoiler_walkthrough.html, lines 683-691 — "Pull out your ticket printer and print up a ticket for Week 2, Tuesday, Race 6... Week 2 can be found by reading the plaque on the statue of the cat, Race 6 can be found by looking at the photo, and the day of the week is Tuesday when the kitty hats are handed out according to the guy at the ticket counter"</small>
+
+```
+LEARNING PHASE (Domain A - Coat Check System Tutorial):
+→ Calavera Cafe: Lupe manages coat check using color-coded tickets
+→ Player observes ticket system in action (other patrons receiving/checking coats)
+→ Examination of coat rack reveals colored tags organized systematically
+
+Rule Discovery Through Environmental Clues:
+RULE 1: Each coat/item has specific COLOR ASSOCIATION from its owner
+RULE 2: Tickets encode information through VISUAL CATEGORIES (color = person's identifier)  
+RULE 3: Coat check is SYMBOL-CODING system, not simple key-locked retrieval
+
+APPLICATION PHASE - Ticket Printer Puzzle (Domain B - Cat Track Photo Finish):
+→ After SeaBee lawyer sequence, obtain ticket printer as item
+→ Visit photo finish counter at Cat Track
+→ Receive generic blank ticket (must print correct values)
+
+
+DECODING THE REQUIRED TICKET PARAMETERS:
+
+PARAMETER 1 - Week Number (Week 2):
+Clue Source: Statue plaque outside Cat Track
+Discovery: Plaque mentions "Second Annual Feline Classic" or similar text
+Decoding: "Second annual" = WEEK 2 of cat racing season
+
+
+PARAMETER 2 - Race Number (Race 6):  
+Clue Source: Previously-obtained photo showing race finish line
+Discovery: Photo shows cats crossing finish, count reveals which race depicted
+Decoding: EXAMINE PHOTO → Identify it's the SIXTH race in sequence
+
+
+PARAMETER 3 - Day of Week (Tuesday):
+Clue Source: Ticket counter NPC dialogue when asked about events/schedule
+Disovery: Counter person mentions "we give out free kitty hats on Tuesdays" or equivalent
+Decoding: "Kitty hat day" = TUESDAY
+
+
+APPLICATION - Print Correct Ticket:
+→ Use ticket printer in inventory → Generate ticket with parameters:
+   Week: 2 | Day: Tuesday | Race: 6
+→ Submit completed ticket at Photo Finish window
+→ Receive incriminating photo (Nick kissing Olivia) as output
+
+
+WHY IT'S PATTERN LEARNING / KNOWLEDGE TRANSFER:
+
+SYSTEM TEACHING THROUGH COAT CHECK DOMAIN:
+The coat check system establishes that THIS WORLD ENCODES INFORMATION SYMBOLICALLY. Lupe's color-coded tickets aren't just "keys"—they're a SYSTEM of encoding categories (color = person identity). This trains player to look for VISUAL/EVIDENTIAL CLUES rather than direct dialogue statements.
+
+FRAMEWORK TRANSFER TO PHOTO FINISH:
+Once coat check establishes "this game uses symbolic information encoding," the photo finish puzzle applies IDENTICAL LOGIC:
+- Coat check: Color → Person mapping (learn system)
+- Photo ticket: Visual clues → Encoded parameters (apply same "decode symbols" skill)
+
+The learning happens by recognizing patterns in how THIS GAME CONVEYS INFORMATION. Both systems require finding HIDDEN MEANINGS in environmental objects/plaque text/NPC hints and translating those into usable game states.
+
+No single NPC states the complete solution: "Print Week 2, Tuesday, Race 6." Player must synthesize from THREE separate information sources using the pattern-learning principle that clues exist as SYMBOLS requiring interpretation, not explicit statements.
+
+
+NOIR THREAT THEME INTEGRATION:
+The coat check system is pure noir—a seedy bar, mysterious code system, information never given freely. The photo finish puzzle extends this with film noir investigation tropes: examining evidence photos, reading environmental text (plaques), questioning witnesses for fragmentary clues. Both require "detective work" mindset established in tutorial domain.
+```
+
+---
+
+### Broken Sword II: The Smoking Mirror - Pyramid Wheel Room (Chapter 6)
+
+**Problem**: Nico must unlock a sealed chamber door using Mayan pictogram interface. A complex machine displays four large rotating wheels with symbols; ten smaller tiles each show two-symbol combinations that must be formed on the machine first, then pressed. Four even smaller final tiles require matching TWO tiles-from-ten simultaneously. The puzzle teaches its own rule set through initial examination, then requires application exhaustively across multiple tile types.
+
+<small>Source: 4_kasagaming_walkthrough.html, lines 426-430 — "Notice the pictograms on the great Mayan machine and on the tiles... Each tile from the set of ten has a symbol on it made from two symbols on the machine."</small>
+
+```
+LEARNING PHASE - RULE DISCOVERY THROUGH EXAMINATION:
+→ Enter pyramid wheel room, examine interface components:
+  - Large rotating wheels with multiple pictogram options each
+  - Set of 10 medium tiles (each showing 2-symbol combination)
+  - Set of 4 small final tiles (each showing reference to 2-of-10-tiles)
+
+→ First attempt at any tile → locked, won't move
+→ Observation: Tiles encode REQUIRED STATES for wheels
+→ Pattern discovered from examination:
+  
+  RULE A: Each wheel has multiple symbol positions (rotateable)
+  RULE B: Medium tiles show target 2-symbol pairings needed on machine
+  RULE C: Small tiles reference TWO medium-tiles that must be activated first
+
+APPLICATION CHAIN - EXHAUSTIVE FRAMEWORK EXECUTION:
+
+Step 1 → Examine medium tile #1 → shows "crescent + skull" pairing
+         <small>Source: kasagaming_walkthrough, line 427 — "Each tile from the set of ten has a symbol on it made from two symbols on the machine"</small>
+         
+Step 2 → Rotate wheels to show crescent AND skull simultaneously on display
+
+Step 3 → Press medium tile #1 → ACCEPTED (wheels match its encoded pair)
+
+REPEAT for all other medium tiles in set of 10:
+→ Each requires finding correct WHEEL CONFIGURATION first
+→ Pattern holds consistently: examine tile = read requirement, adjust wheels = fulfill requirement, press tile = validate match
+→ By ~5-8 tiles, player internalizes full system rule: "Tile shows goal state → configure machine to that → press when matched"
+
+FINAL PHASE - COMPOUND TILE CHAIN (Rule B applied recursively):
+Step A → Examine small tile #1 → shows reference to medium-tiles 3+7
+         <small>Source: kasagaming_walkthrough, line 429 — "Each tile below the Mayan statue is made from two tiles from the set of ten"</small>
+
+Step B → Medium tile #3 already pressed (from earlier phase) ✓
+Step C → Medium tile #7 already pressed (from earlier phase) ✓
+         - If not yet done, player learns: SMALL-TILES require MEDIUM-TILE PREREQUISITES
+
+Step D → Press small tile #1 → ACCEPTED (both referenced tiles activated)
+
+REPEAT for all 4 small tiles using same compound rule.
+→ Complete set of 4 small-tiles pressed inward → secret door opens automatically
+```
+
+**Why It's This Type**: The puzzle TEACHES its mechanical rules through initial interaction: examining tiles reveals required wheel configurations; first few tile presses confirm the "match wheels to tile, then press" framework. This SAME RULE SET exhaustively applied to all remaining tiles—including compound small-tiles that reference already-completed medium-tiles. Player doesn't discover scattered clues; they learn a COMPREHENSIVE SYSTEM whose consistent application is the solution. The teaching happens IN THE PUZZLE ITSELF through graduated difficulty (medium-tiles straightforward, small-tiles introduce layer-2 dependency).
+
+**Core Mechanic Distinction**: Unlike Symbol Code Translation where static symbols translate to actions (Bible diagram → chess moves), here player LEARNS AN INTERACTIVE SYSTEM: "Machine wheels are adjustable; tiles validate configurations; some tiles depend on others." This framework applies EXHAUSTIVELY across ALL instances—no external training domain needed because the puzzle scaffolds learning through progressive revelation of its own rules.
+
+**Distinction from Symbol Code Translation**: Player isn't translating static visual codes to separate interface actions (Bible → chessboard). Instead, they're operating a UNIFIED MECHANICAL SYSTEM where examining components reveals the system's operational logic. The wheels ARE the solution space; the tiles ARE validation gates for wheel states discovered through iterative experimentation.
+
+---
+
+### Simon the Sorcerer: Magic Word Learning and Witch Duel Application (SIMON)
+
+**Problem**: The Witch challenges Simon to a magical duel but will not let him attempt it unless he becomes an official wizard first. Becoming a wizard requires learning magic words—taught by a talking tree in exchange for removing paint. Once learned, the exact same magic word system is then applied in combat against the witch.
+
+<small>Source: walkthroughs/simon1/simon1.txt, lines 827-863 — "Simon still needs to learn some magic words... Go to the Tree, four screens east of the Dragon's Cave. It promises to teach you the words if you help it [remove paint]. Return to the tree with White Spirit from shop, use on pink splodge → learns four magic words: Alakazam=snake, Hocus Pocus=cat, Sausages=dog, Abracadabra=mouse."</small>
+
+<small>Source: walkthroughs/simon1/simon1_3.txt, lines 226-245 — "The duel is a weird match. Using the magic words taught to you by the tree, you morph into various animals... Dog beats snake, snake beats cat, and cat beats dog. Don't use the mouse in the duel, because the mouse always loses."</small>
+
+```
+LEARNING PHASE (Domain A - Talking Tree Tutorial):
+
+PHASE 1A - Discovering the Magic Word System Exists:
+→ Navigate to tree located four screens east of Dragon's Cave  
+→ TREE DIALOGUE: "I can teach you magic words if you help me"
+→ Player learns: Magic words exist as gameplay mechanic (previously unknown)
+
+
+PHASE 1B - Learning Prerequisite Mechanic (White Spirit Acquisition):
+→ Tree requirement stated: "Remove the pink paint stain on my bark"
+→ Player must determine: How do you remove paint from a tree?
+→ HYPOTHESIS GENERATION: White spirit = paint thinner in real world logic
+→ Execute: Buy white spirit from village shop with previously-earned gold coins
+
+
+PHASE 1C - Word-Mapping Discovery (The Rule Set):
+→ After cleaning tree with white spirit → Tree teaches four magic words and their effects:
+
+WORD 1: "Alakazam" → Simon transforms into SNAKE
+WORD 2: "Hocus Pocus" → Simon transforms into CAT  
+WORD 3: "Sausages" → Simon transforms into DOG
+WORD 4: "Abracadabra" → Simon transforms into MOUSE
+
+
+RULE EXPLANATION PROVIDED BY TREE:
+→ Tree explains animal hierarchy: "Dog beats snake, snake beats cat, cat beats dog"
+← Critical detail: MOUSE ALWAYS LOSES (explicit warning)
+
+Complete rule set now learned and documented by player.
+
+
+APPLICATION PHASE (Domain B - Witch's Magical Duel):
+
+PHASE 2A - Gaining Access to Duel Context:
+→ Navigate to Witch's Cottage  
+→ Attempt to take broomstick → Witch challenges Simon to duel
+→ WITCH CONDITION: "Only wizards can duels with me"
+→ Player must first complete staff acquisition chain (become wizard at pub, separate plotline)
+
+
+PHASE 2B - Applying Learned System in Combat Context:
+→ Once wizard status granted, rematch initiated
+→ Same magic word system NOW applied under stakes:
+
+DUEL MECHANICS (Five rounds, best of five wins):
+ROUND STRUCTURE:
+1- Witch selects animal form via dialogue choice (randomized by game)
+2- Player responds by selecting counter-form using learned words
+3- Combat resolution calculated per tree's stated rules
+
+
+EXAMPLE ROUND EXECUTION:
+Witch chooses CAT form → says "Hocus Pocus!" (from same word set as player learned)
+
+Player MUST KNOW: What beats cat? → SNAKE (per tree's rule teaching)
+Player executes: SAY "Alakazam" → transforms to snake → wins round
+
+
+COMBAT DECISION TREE (Applying Learned Rules):
+- IF witch = DOG → respond with CAT ("Hocus Pocus")
+- IF witch = SNAKE → respond with DOG ("Sausages")  
+- IF witch = CAT → respond with SNAKE ("Alakazam")
+
+
+CRITICAL AVOIDANCE RULE (Learned from Tutorial):
+Abracadabra/MOUSE is NEVER a winning response. Choosing it grants point to Witch automatically.
+Player who learned tutorial well knows: "Never use mouse form in combat."
+
+
+TIE-BREAKER MECHANIC:
+→ If score tied after five rounds → game continues until tie broken
+→ Same rules apply, no new mechanics introduced
+→ Player must maintain word mapping under extended pressure
+
+
+POST-DUEL PLOT DEVICE (Mouse Form Utility):
+After winning duel, Witch transforms into DRAGON and attacks.
+SOLUTION: Use "Abracadabra" → become mouse → escape through mouse hole in wall
+
+This is where MOUSE form becomes useful—but NOT as combat mechanic, 
+instead as ESCAPE MECHANIC. The tutorial taught all transformations have some valid use,
+even if some are combat-ineffective.
+
+
+WHY IT'S PATTERN LEARNING / KNOWLEDGE TRANSFER:
+
+IDENTICAL RULE SYSTEM IN BOTH DOMAINS:
+Domain A (Tree Tutorial): "Dog beats snake, snake beats cat, cat beats dog" + word mappings
+Domain B (Witch Combat): Exactly same rule set applies during five-round duel
+
+PLAYER MUST RECOGNIZE: The system hasn't changed; only context shifted from 
+friendly teaching environment to competitive combat. The magic words don't work differently 
+against the witch—they're the EXACT SAME transformations with the EXACT SAME hierarchy rules.
+
+
+EXHAUSTIVE RULE DISCOVERY IN TUTORIAL:
+All four word→animal mappings are revealed upfront during tree interaction.
+Hierarchy rules explicitly explained by tree character.
+
+This differs from combat puzzles where you "learn through fighting" (try sword attack,
+learn it doesn't work). Here the tutorial provides complete system knowledge before
+combat begins—if player succeeded in learning tree phase, they know everything needed to win duel.
+
+
+DOMAIN TRANSFER EVIDENCE:
+The Tree explicitly warns: "Don't use mouse in combat—it always loses."
+This is TUTORIAL→APPLICATION ADVICE that applies only if player recognizes:
+"The tree's rules about animal hierarchy apply to this witch duel!"
+
+Player who treats them as separate puzzles might waste time trying all four words randomly.
+Player who recognizes knowledge transfer knows immediately: Never choose mouse form.
+
+
+STOCHASTIC ELEMENT DOES NOT AFFECT MECHANICS:
+Witch chooses animal randomly each round (per walkthrough notes).
+This does not change UNDERLYING RULE SET—same hierarchy governs resolution regardless of choice.
+
+Randomness adds challenge but does NOT create new mechanic. Player still applies:
+"If opponent = X, response = Y" where X and Y come from fixed 4-element set taught in tutorial.
+
+
+FAILURE AS KNOWLEDGE GAP IDENTIFICATION:
+Losing rounds reveals player's knowledge gap, not mechanical complexity:
+- Lose because you forgot which animal witch chose → memory failure
+- Lose because you picked wrong counter → rule application failure  
+- Lose because you chose mouse → ignored tutorial advice
+
+None of these are "complex puzzle mechanics." They're pure knowledge retention/application tests.
+Player who took notes during tree phase should be able to replay those notes verbatim in duel.
+
+
+DISTINCTION FROM COMBAT MINI-GAMES:
+Unlike Monkey Island swordfight where player must discover insult/retort pairings, 
+Simon's magic system is EXPLICITLY TAUGHT before combat begins. Player receives all rules
+as dialogue from NPC tree—not hidden mechanics uncovered through experimentation.
+
+This makes Pattern Learning rather than combat-discovery: The tutorial phase isn't "practice"
+combat—it's receiving the solution manual that applies DIRECTLY to actual combat phase.
+```
+
+**Why It's Pattern Learning**: The Talking Tree provides exhaustive system teaching (all four word mappings, all three hierarchy rules, explicit warning about useless mouse option). 
+
+---
+
+### Legend of Kyrandia: Royal Bell Musical Sequence Puzzle (LK1)
+
+**Problem**: In a bedroom on the west side of Castle Kyrandia's second floor, Four bells mounted on a stand produce different musical notes when struck. Player must discover the correct striking sequence to reveal a hidden golden key behind a painting. This is the only source of one of two keys needed for the great hall doors—critical path item with no alternative acquisition method.
+
+<small>Source: classicgamesparadise_walkthrough.html, lines 323-324 — "If you strike the bells in the correct order, the last gold key will be revealed behind the painting. The correct order is Do, Fa, Mi, Re, or green, white, gold then blue."</small>
+
+<small>Source: bonny_ploeg_walkthrough.html, line 78 — "Number the bells 1 to 4 from left to right, play 4 1 2 3 to move the painting up and take the golden key."</small>
+
+```
+LEARNING PHASE: No explicit tutorial—discovery through environmental observation or trial/external reference
+
+CONTEXTUAL SETUP:
+→ Player reaches Castle Kyrandia after completing Faeriewood potions and retrieving Royal Chalice
+→ Second floor bedroom accessible ONLY AFTER using yellow healing gem on Herman (sleep spell)
+→ Bell stand found in westernmost room, four bells of different colors/materials
+
+
+PATTERN DISCOVERY MECHANICS:
+
+OPTION 1 - Trial and Error with External Save/Load:
+Step 1 → Save game before first bell interaction
+Step 2 → Strike arbitrary sequence (e.g., all bells one at a time)
+Step 3 → Observe result: nothing happens / wrong sequence feedback
+Step 4 → Reload save, try different permutation
+Step 5 → Repeat until correct sequence discovered
+
+
+OPTION 2 - External Knowledge/Walkthrough Consultation:
+Player learns from guide: "Do Fa Mi Re" = scale positions mapped to bells 1-4
+
+OPTION 3 - Color Sequence Mapping (Visual Pattern):
+Walkthrough provides alternative notation: "green, white, gold, blue" = physical bell colors
+Player translates color sequence to left-to-right numeric positions
+
+
+CRITICAL CONSTRAINT - ONE CHANCE OR SAVE REQUIRED:
+
+The walkthrough doesn't explicitly state whether WRONG sequences fail permanently or allow re-attempts. Based on LK1's general design patterns and similar puzzles in the game (birthstone altar consumes items), it's LIKELY that:
+- Either: Each wrong attempt RESETS the bells to neutral state allowing retry
+- Or: Wrong sequence locks the puzzle requiring reload/backtrack
+
+This creates HIGH STAKES application—single failure may mean losing progress to earlier save point.
+
+
+PATTERN STRUCTURE ANALYSIS:
+
+MUSICAL SCALE AS RULE SET:
+- "Do Re Mi Fa" = basic solfège scale, universally recognized pattern
+- Correct sequence is do → fa → mi → re (positions 1 → 4 → 2 → 3 by standard ordering)
+- This is REVERSE CHROMATIC ORDER—intentional deviation from expected 1-2-3-4
+
+
+COLOR AS ALTERNATIVE NOTATION SYSTEM:
+- Green = Do (position 1?) OR position 4 if reverse mapping used
+- White = Fa (position 4 in numeric order, but walkthrough says "4 1 2 3")
+- Gold/Brown = Mi (position 2)
+- Blue = Re (position 3)
+
+TWO COMPETING NOTATION SYSTEMS create ambiguity:
+- Classicgamesparadise: "green, white, gold, blue" 
+- Bonny Ploeg: "4 1 2 3 left-to-right numeric order"
+
+These appear to BE THE SAME SOLUTION expressed differently. Translation required:
+If bells are numbered L→R as 1-2-3-4, and solution is 4-1-2-3, then:
+- Bell 4 (rightmost) = first struck = white = Do? [contradiction - see below]
+[NOTE: Walkthrough discrepancy may indicate multiple valid solutions OR conflicting sources]
+
+
+WHY IT'S PATTERN LEARNING:
+
+NO EXPLICIT TUTORIAL PHASE EXISTS IN THIS SPECIFIC INSTANCE.
+However, the puzzle QUALIFIES as Pattern Learning by this definition:
+
+1. LEARNED RULE SYSTEM FROM EXTERNAL DOMAIN:
+   - Solfège musical scale knowledge assumed or acquirable
+   - Color-to-note mapping requires pattern recognition skill
+   - Player learns (somehow) that sequence matters, not individual actions
+   
+2. APPLICATION UNDER CONSEQUENCES:
+   - Wrong sequence = failure (painting doesn't move, key inaccessible)
+   - Single source of critical item—no alternate acquisition path exists
+   - Failure may require save/reload OR complete backtracking if locked state
+
+3. IDENTICAL MECHANICS TO LK1'S FLUTE PUZZLE:
+   The Serpent's Grotto ice-shattering requires playing a HIGH NOTE on flute. 
+   This is SIMPLIFIED version—just "play high pitch" without full sequence.
+   Both puzzles use MUSIC AS LANGUAGE with discoverable rule set.
+
+
+DISTINCTION FROM OBSERVATION REPLAY:
+
+Observation Replay would be: WATCH someone play bells correctly, then reproduce EXACTLY what was observed. Here, NO demonstration is provided within game. Player must derive pattern through experimentation or external knowledge—no single viewing to memorize.
+
+The "learned" element comes from PATTERN DISCOVERY (recognizing scale/music/color system applies) not MEMORY RETENTION (reproduce what was seen once).
+
+
+DISTINCTION FROM SYMBOL CODE TRANSLATION:
+
+Symbol Code Translation = visual puzzle where symbols on object A directly TRANSFER TO INTERFACE B (e.g., glyphs on statue → matching glyph buttons on door, same shape must go in same-shaped slot). Here, bells have NO VISUAL SYMBOLS transferring—just abstract color or positional identifiers. The "code" is musical scale knowledge, not visual symbol matching.
+
+
+COMPARISON TO MI1'S SWORDFIGHT:
+
+Both require discovering rule sets that map inputs → outputs correctly under pressure. Swordfight = insults/retorts; Bells = sequence/ordering. Both have single-failure-consequences (Sword Master fight loses immediately if wrong retort used too many times).
+```
+
+---The Witch duel then applies that exact same system unchanged in a higher-stakes context. Success depends entirely on recognizing the context shift while maintaining mechanical fidelity—the combat is just a test of remembered knowledge from tutorial domain, not new discovery.
+
+**Comedy Element as Justification**: The absurdity of "Sausages = dog transformation" delivers humor while maintaining logical consistency (words are arbitrary triggers, hierarchy follows rock-paper-scissors). Player laughs at the mapping but must treat it seriously in combat—comedy doesn't break mechanics, it flavors them.
+
+### Gabriel Knight 1: Loa Machine Cipher Translation System (GK1)
+
+**Problem**: After obtaining Voodoo Code Page 1 from the conclave (Marie Laveau's tombstone symbols), Magenta at Moonbeam Books tests Gabriel with her "Loa Machine"—a cipher translation framework. The system teaches symbol-to-letter mapping rules that must then be applied to decode Voodoo Code Page 2 discovered later at the Second Conclave.
+
+<small>Source: justadventure_walkthrough.html, lines 906-923 — Loa machine translates symbols to letters; Page 1 decoded first</small>
+
+```
+LEARNING PHASE (Voodoo Code Page 1 Translation via Loa Machine):
+
+Step A → Visit Magenta at Moonbeam Books residence in French Quarter
+         <small>Source: line 906 — "From inventory, show Magentia your Voodoo Code and ask her to decipher it. But she won't 'For outsiders' such as Gabriel"</small>
+
+Step B → Ask to be tested with her "Loa Machine"
+         - She agrees after persuasion
+         - Machine functions as CIPHER DECODER tool
+
+Step C → Voodoo Code Page 1 displayed on screen:
+         - Left side: Symbol grid (voodoo pictograms)
+         - Right side: Blank letter slots beneath each symbol
+
+Step D → TRANSLATION RULES DISCOVERY THROUGH EXPERIMENTATION:
+         Each voodoo symbol corresponds to ONE English letter
+         Letters appear beneath symbols in specific positions
+
+Step E → COMPLETE DECODED MESSAGE (Page 1):
+         "DJ CONCLAVE TONIGHT BRING F WET KASH"
+         <small>Source: line 920 — "Look at the Voodoo Code in inventory. Now, beneath each of the symbols is a letter..."</small>
+
+         Translation breakdown:
+         DJ → likely abbreviation/name
+         CONCLAVE TONIGHT → meeting timing directive
+         BRING F WET KASH → cryptic instruction (F=French? Wet=wet ingredients? Kash=cash?)
+
+FRAMEWORK ESTABLISHED:
+Rule Learnt: Symbol-to-letter mapping follows consistent cipher
+            Once one symbol is decoded, same symbol elsewhere = same letter
+            Position within message matters (symbols maintain relative spacing)
+
+---
+
+APPLICATION PHASE (Voodoo Code Page 2 - Same Rules Apply):
+
+Step F → Return to conclave aftermath (after Crash death scene)
+         - New coded message appears on wall/floor at crime scene
+         <small>Source: line 998 — "take your sketchbook and copy the new coded message – you now have Voodoo Code Page 2"</small>
+
+Step G → Acquire Voodoo Code Page 2 via sketchbook documentation
+         - OLD ITEM renamed: "Voodoo Code" → "Voodoo Code Page 1"
+         - NEW item created: "Voodoo Code Page 2"
+
+Step H → COMBINE Pages in Inventory:
+         Action: Select both Page 1 and Page 2 together
+         Result: Game AUTOMATICALLY applies translation framework from Page 1
+                 New composite item created: "Voodo Code" (merged translation)
+
+         <small>Source: lines 999-1000 — "In inventory, the coded message that Magentia translated has been renamed from Voodoo Code to Voodoo Code Page 1...combining Voodoo Code Page 1 and Voodoo Code Page 2 in inventory and obtaining the single item Voodoo Code"</small>
+
+CRITICAL MECHANIC:
+- Player doesn't manually decode Page 2 symbol-by-symbol
+- Instead, player COMBINES items → game applies SAME cipher rules automatically
+- The "learning" was discovering that symbol→letter mapping is consistent
+- The "application" is trusting the framework transfers to new instance
+
+WHY IT'S PATTERN LEARNING:
+1. TUTORIAL DOMAIN (Page 1): Low stakes—decode with Magenta's help via Loa Machine
+2. APPLICATION DOMAIN (Page 2): Higher stakes—independent discovery, no helper available
+3. IDENTICAL RULES APPLY: Same cipher framework works for both pages
+4. NO NEW DISCOVERY NEEDED: Player recognizes "this is same system as before"
+
+DISTINCTION FROM SYMBOL CODE TRANSLATION:
+- SCT would be: Symbol A on artifact → Shape match on interface button
+- PL here is: Learn cipher framework once (symbol→letter), apply to new MESSAGE instances
+- The framework transfers; individual symbols may repeat across pages
+
+COMPARISON TO MI1 SWORDFIGHT:
+Similarities:
+  - Train with low-stakes examples (roaming pirates / Magenta tutorial)
+  - Apply same rules to high-stakes final (Sword Master / crime scene decoding)
+Differences:
+  - Swordfight = active combat mini-game
+  - Voodoo Code = passive translation using learned framework
+
+ESCALATION PATTERN:
+Page 1 → Safe decode with NPC assistance → Framework understood
+Page 2 → Independent application → Same rules reveal plot-critical information
+```
+
+<small>Cited from: justadventure_walkthrough.html:906-1000</small>
+
+---
+
+### Leshy Riddle Progression (QFG4) - German Folklore Pattern System
+
+**Problem**: The Hero encounters a mischievous forest spirit (Leshy) who demands knowledge demonstration before offering assistance. Six riddles must be answered sequentially, but each answer is GATED by completing unrelated quests—the system teaches that "knowledge" in this game means "completing activities that provide knowable information."
+
+<small>Source: qfg4-gamefaqs-sac.txt, lines 3179-3210 — "You cannot answer a riddle correctly until your character has the knowledge... Q: Who am I? A: 'Leshy' (Found in Hero's Magazine in Adventurer's Guild)"</small>
+
+```
+LESHY RIDDLE SYSTEM - COMPLETE PROGRESSION:
+
+RIDDLE 1: Identity (Simple Knowledge)
+Question: "Who am I?"
+Answer Required: "Leshy"
+How to Learn: Read Hero's Magazine on bookshelf in Adventurer's Guild
+Pattern Established: Folklore knowledge = answer ability [2 points]
+
+---
+
+RIDDLE 2: Plant Quest Integration (Action-Knowledge Bridge)  
+Question: "Save a plant from goo."
+Answer Required: "Bush"
+Knowledge Gate: Must have completed separate bonsai bush rescue
+  - Go to Squid Stone area
+  - Use Force Bolt on rocks blocking bush
+  - Cast Fetch spell to retrieve Bush
+  - Answer riddle with correct response
+  - Then transplant bush to Erana's Garden
+Pattern Addition: Riddles gate other quests; completing quests enables riddle answers [2 points]
+
+---
+
+RIDDLE 3: Exploration Verification
+Question: "Who's in the lake?"
+Answer Required: "Rusalka"
+Knowledge Gate: Visit Lake Mordavia, interact with Rusalka at least once
+Pattern Addition: Knowledge = exploration completion, not just reading [2 points]
+
+---
+
+RIDDLE 4: Narrative Connection (Folklore to Character)
+Question: "Who hides behind 'trick sticks'?"  
+Answer Required: "Baba Yaga"
+Knowledge Gate: Either visit Baba Yaga's hut OR speak with Punny Bones about her
+Pattern Addition: Recognize folklore references applied to in-game characters [2 points]
+
+---
+
+RIDDLE 5: Multi-Stage Quest Gate (Elderbury Pie Chain)
+Question: "A berry bush with attitude?"
+Answer Required: "Elderbury Bush"  
+Knowledge Gate: COMPLETE Baba Yaga's Elderbury Pie quest:
+  1. Buy/obtain Pie Pan from General Store
+  2. Collect Grue Goo in Empty Flask at Squid Stone area
+  3. Make Bonemeal (find Bone, grind in mortar at Baba Yaga's, collect)
+  4. Force Bolt Elderbury Bush to dislodge berries, Fetch the branch
+  5. Combine all four items → Elderbury Pie
+  6. Return pie to Baba Yaga via her laser-skulls oven
+Pattern Addition: Some riddles gate major quest chains; completion = answerable [2 points]
+
+---
+
+RIDDLE 6: Spell Acquisition Dependency (Heart Ritual)
+Question: "What does the Faery Queen want?"  
+Answer Required: "Staff" (referring to Erana's Staff)
+Knowledge Gate: Must possess Ritual of Release spell
+  - Granted by Faeries after bush planted in Riddle 2
+  - Connect spell's purpose (freeing Staff from its rock base) to Faerie Queen's desires
+Pattern Addition: Most difficult riddles gate both quest completion AND magic progression [2 points]
+
+---
+
+WHY THIS IS PATTERN LEARNING:
+
+THE RULE SYSTEM is IDENTICAL across all six riddles and must be recognized/applied exhaustively:
+
+CORE PATTERN (Applied Every Time):
+1. Leshy asks riddle question about element X
+2. Player checks: "Have I completed activity that teaches me about X?"
+3. If YES → game allows selecting correct answer from dialogue tree
+4. If NO → game rejects attempt, must go complete prerequisite activity
+5. Return to Leshy, same interface, apply newly acquired knowledge
+
+CRITICAL DISTINCTION FROM MULTI-FACETED PLAN:
+
+In Multi-Faceted Plan (like gathering 4 items for Baba Yaga's pie itself):
+- Each requirement is different TYPE of acquisition
+- Items gathered independently in any order
+- Solution = synthesis at the end (combine ingredients)
+
+In this Leshy riddle system:
+- All six requirements are SAME TYPE: "gain knowledge"
+- Each riddle shares IDENTICAL solution mechanic: "check completed activities → answer from dialogue"
+- Progression is LINEAR and GATED, not independent
+- The pattern isn't synthesis—it's RECURSIVE APPLICATION of "knowledge = completion"
+
+The system teaches once (Riddle 1: read magazine = know answer), then applies identical rule five more times with escalating complexity. Domain A (simple reading) = tutorial for Domain B (multi-stage quest chains), but MECHANIC never changes.
+```
+
+<small>Source: qfg4-gamefaqs-sac.txt, lines 3206-3210 — "Now, getting the bush for the Leshy... Cast Force Bolt at the rocks to bust them up, then cast Fetch to snag the Bush itself (15). Now that you have the Bush, go back to answer the Leshy's riddle, then go to Erana's Garden and plant it (6)"</small>
+
+---

src/puzzles/predator-chase-escape.md

@@ -0,0 +1,107 @@
+# Predator Chase Escape Puzzle
+
+**Information Architecture**: A relentless pursuer NPC (often an armored antagonist) hunts the player through hostile environments. The environment itself contains natural or artificial hazards that can be exploited to eliminate or deter the attacker. Information about escape routes and environmental traps comes from direct observation during chase sequences.
+
+**Player Action Pattern**:
+1. Recognize pursuit state initiated by antagonist appearance
+2. Navigate toward known dangerous zones (environmental hazards)
+3. Position self safely while luring pursuer into hazard
+4. Trigger hazard to defeat/delay pursuer
+5. Collect rewards or items dropped by defeated pursuer
+
+**Core Mechanic**: The player cannot directly confront the enemy; victory requires redirecting environmental danger toward the pursuer, exploiting the antagonist's inability to recognize terrain-based threats.
+
+## Variations
+
+| Variation | Pursuit Type | Trap Method | Example |
+|-----------|--------------|-------------|---------|
+| **Natural Hazard** | Unavoidable hunter NPC | Biological trap (predatory flora/fauna) | SQ3 Phleebhut pods |
+| **Constructed Trap** | Persistent pursuer | Mechanical devices, environmental hazards | Generic adventure games |
+| **Time-Based Retreat** | Countdown timer | Reach safe zone before deadline | Timed escape sequences |
+
+---
+
+## Game Examples
+
+### SpaceQuest III: Arnoid Pursuit and Pod Trap (Phleebhut) (SQ3)
+
+**Problem**: After landing on Phleebhut, Roger Wilco is hunted by the "Arnold" — a relentless robotic terminator with superior combat capabilities. Direct confrontation guarantees death. The only escape requires luring the Arnold into carnivorous hanging pods that populate a specific cave area and harvest their bounty (invisibility belt) from the defeated machine.
+
+<small>Source: gamefaqs-tricrokra-archive.html, lines 376-382 — "Well, it'll take awhile before he finds you... Now the Terminator will catch you."</small>
+
+<small>Source: the-spoiler-walkthrough.html, lines 89-97 — "The Arnoid will show up. Luckily, he is in a good mood and will give you a small amount of time to run away."</small>
+
+```
+CHASE INITIATION PHASE:
+
+Step 1 - Purchase Required Items (Pre-Chase Preparation):
+Command Sequence: Enter World o' Wonders → SELL Gem → BUY Orat on a stick → BUY Underwear → BUY Hat
+Citation: gamefaqs-tricrokra-archive.html, lines 393-401 — "= Sell the gem... = Buy Orat on a stick = Buy the chicken hat = Buy the thermoweave underwear"
+
+Critical: Must sell gem for enough buckazoids to afford all three items. The Orat is specifically required for extracting the invisibility belt post-defeat.
+
+
+CHASE EXECUTION PHASE (Two methods; only one reliably succeeds):
+
+UNRELIABLE METHOD - Hook Grab Attempt:
+Navigation: Go west twice → Enter building → Up elevator → When Arnold gets close, grab hanging hook
+Success Rate: Low; sometimes fails entirely
+Point Award: Minimal (less than alternative method)
+Citation: gamefaqs-tricrokra-archive.html, lines 406-411 — "go west, enter the building go up the elevator and grab the hook when the Terminator gets close. This method gets you less points though, and does not always work."
+
+
+RELIABLE METHOD - Carnivorous Pod Trap:
+
+Step A - Lead Pursuer to Trap Zone:
+Command Sequence: South x3 → East → Enter cave with hanging pods
+Citation: gamefaqs-tricrokra-archive.html, lines 413-417 — "= Exit south x3"
+
+
+Step B - Position for Safe Harvest:
+Positioning Instruction: Stand BEHIND the carnivorous pods but NOT directly underneath them
+Critical Constraint: The "things-in-the-cave" will kill Roger if he enters beneath them while Arnold is present. Standing behind (not under) keeps player safe while Arnold passes through danger zone.
+Citation: gamefaqs-tricrokra-archive.html, lines 416-420 — "= Stand in the cave behind the 'things' and wait for the Terminator to come it'll get eaten by the 'things.'"
+
+
+Step C - Wait for Trap Activation:
+Mechanism: Carnivorous pods have independent detection system that triggers when humanoid (Arnold) enters kill zone but does not detect Roger unless he is directly below.
+Outcome: Arnold is captured and consumed; Roger emerges unharmed from protected position.
+
+
+Step D - Extract Invisibility Belt:
+Prerequisite: ORAT ON A STICK in inventory (purchased earlier on Phleebhut)
+Command: USE ORAT on defeated Arnold's remains
+Reward: INVISIBILITY BELT acquired
+Citation: gamefaqs-tricrokra-archive.html, line 421 — "= Use the Orat on a stick to get the Terminator's invisibility belt"
+
+Failure Modes:
+- If player returns to ship while being pursued → Arnold catches and kills Roger instantly (game over)
+Citation: gamefaqs-tricrokra-archive.html, lines 418-420 — "DON'T GO TO YOUR SHIP. If you go there, you'll be killed."
+
+- If Arnold fails to follow player into pod cave area → may need to exit and re-enter or check west path
+Note: Sometimes the Terminator simply won't come; player must avoid ship until pursuit is resolved
+
+
+```
+
+**Why It's Predator Chase Escape (New Type)**:
+This represents a distinct puzzle category because environmental hazards serve as the *only* defeat mechanism, and timing/positioning both matter. Roger must: (1) survive during escape, (2) successfully guide pursuer through narrow corridor to trap zone without entering danger himself, (3) exploit the specific mechanical weakness of Arnold (cannot see pod danger, unlike player). The three-phase structure—preparation → chase → harvest—is unique from Observation Replay or other pursuit mechanics.
+
+**Information Discovery**: Partial trial-and-error during escape. The walkthrough warns that:
+- One method ("hook grab") is unreliable and yields fewer points
+- The second method (pods) is the only guaranteed success path
+- Environmental positioning (behind vs under pods) is critical for survival
+
+This requires both environmental intelligence (knowing what pods do) AND tactical retreat execution (luring without being caught).
+
+**Distinction from Distraction Physics**: Unlike distraction physics where NPCs are diverted by manipulating their environment or attention, predator chase requires the player to also navigate while pursued. The Arnold follows Roger directly; there's no "making him watch something else"—only escape and trap activation exists as valid strategies.
+
+---
+
+## Related Types
+
+| Type | Similarity | Distinction |
+|------|------------|-------------|
+| **Timed Consequence Puzzle** | Both involve urgent avoidance of death state | Timed consequence has explicit story deadline; predator chase has immediate pursuit mechanic with no timer UI |
+| **Distraction Physics** | Both manipulate environment to bypass blocked path | DP: distract NPC attention; Predator Chase: literally hide while enemy hunts you through terrain |
+| **Observation Replay** | May require memorizing safe positions/routes during initial observation | OR: watch sequence once, replay later; Predator Chase: active pursuit without prior "viewing phase"—must act during hunt |

src/puzzles/repair-chain-construction.md

@@ -0,0 +1,127 @@
+# Repair Chain Construction Puzzle
+
+**Information Architecture**: Player discovers repair requirements through direct examination of broken system states. Missing components must be found and integrated in a specific sequence where each component's installation enables progression to the next step. The ship cannot function until ALL required parts are installed; partial repairs yield no progress.
+
+**Player Action Pattern**:
+1. Examine non-functional systems → identify what's broken/missing
+2. Locate missing components through environmental search
+3. Install components in required sequence (reactor → wires → engines)
+4. Test system functionality after installation
+
+**Core Mechanic**: The ship is a collection of interdependent failure states—each system cannot be repaired until its prerequisite systems are fixed, creating a linear dependency chain where the player must discover both *what* parts are needed and *where* to find them.
+
+## Variations
+
+| Type | Dependency Structure | Example |
+|------|---------------------|---------|
+| **Sequential Chain** | A→B→C (must complete in order) | SQ3 Ship Reactor installation |
+| **Parallel Requirements** | A+B+C (order irrelevant) | Multi-faceted plan variants |
+| **Conditional Branching** | Different paths based on available components | Complex crafting systems |
+
+---
+
+## Game Examples
+
+### SpaceQuest III: Escape Pod Repair Chain (SQ3)
+
+**Problem**: Roger Wilco awakens in his escape pod aboard a garbage freighter. The ship is non-functional—it lacks a reactor, proper wiring, and an engine. Each component must be located separately throughout the ship's hazardous environments and installed in sequence before he can escape.
+
+<small>Source: gamefaqs-tricrokra-archive.html, lines 256-260 — "Now to get outta here..."</small>
+
+<small>Source: the-spoiler-walkthrough.html, lines 63-70 — "South. East. Stand near the bucket conveyor and you will be taken up. 'Stand'. 'Jump'."</small>
+
+```
+PHASE 1 - COMPONENT ACQUISITION (Order discovered through exploration):
+
+COMPONENT A: WIRES
+Location: Tube passage in garbage scow
+Acquisition Method:
+- Exit east → west twice → south → east
+- Climb down to tube with rat
+- Rats steal all items EXCEPT reactor initially; reroute search
+Command: GET WIRE
+Citation: gamefaqs-tricrokra-archive.html, line 263 — "= Get the wires"
+
+COMPONENT B: REACTOR  
+Location: Basement/lower level of garbage scow (west wall)
+Acquisition Method:
+- Enter tube, climb down to basement
+- Rats attack and steal all inventory except reactor
+- Must re-enter after rat attack to retrieve lost items
+- Climb ladder back up after acquiring reactor
+Command: GET REACTOR
+Citation: the-spoiler-walkthrough.html, line 69 — "'Get reactor'"
+
+COMPONENT C: ENGINE
+Location: Upper conveyor system, requires grabber cart manipulation
+Acquisition Method:
+- Use grabber cart and move to correct position above engine chute
+- "Move about half-way across this screen and type 'push button'"
+- Claw mechanism picks up green engine object (trial-and-error positioning)
+Citation: the-spoiler-walkthrough.html, lines 76-80 — "Move the grabber above the middle chute... The claw should come out of the grabber which will pick up the green object."
+
+COMPONENT D: LADDER
+Location: After sliding down middle chute near entrance to rat pit
+Acquisition Method:
+- Exit scow area and climb ladder back up
+- Retrieve ladder that leads to ship entrance
+Command: GET LADDER
+Citation: gamefaqs-tricrokra-archive.html, line 328 — "= GET THE LADDER (80)"
+
+
+
+PHASE 2 - INSTALLATION SEQUENCE (Must follow this order):
+
+STEP 1 - Position Ship for Access
+Action: Navigate to the front of ship where green engine was deposited
+Citation: gamefaqs-tricrokra-archive.html, lines 295-300 — "Exit east... Move to the front and press the button to release the engine."
+
+STEP 2 - Climb onto Ship Exterior
+Prerequisites: LADDER in inventory
+Command: USE LADDER → CLIMB → OPEN HATCH
+Citation: gamefaqs-tricrokra-archive.html, lines 340-344 — "= USE LADDER = CLIMB = OPEN HATCH = SIT"
+
+STEP 3 - Install Reactor
+Prerequisite: REACTOR in inventory, hatch interior accessible
+Command: USE REACTOR
+Citation: the-spoiler-walkthrough.html, line 87 — "'Put reactor in hole'"
+
+STEP 4 - Install Wiring  
+Prerequisite: WIRES in inventory, reactor installed (power needed for electronics)
+Command: USE WIRE
+Citation: the-spoiler-walkthrough.html, line 87 — "'Put wires in hole'"
+
+STEP 5 - Initialize Engine Systems
+Prerequisite: ENGINE was dropped into ship hold earlier; now power available
+Command: SIT → LOOK SCREEN → Select "1" for Engines
+Citation: gamefaqs-tricrokra-archive.html, lines 346-350 — "Choose 1. Engines"
+
+STEP 6 - Activate Shields and Weapons (Optional but recommended)
+Command: Choose 8 for Weapon System → F for Front shields → Press space to fire
+Citation: gamefaqs-tricrokra-archive.html, lines 352-354 — "= Choose 8... = Press space (Fire)"
+
+STEP 7 - Escape Planet
+Prerequisites: All systems operational
+Command: Look Screen → 2 (Navigation) → 1 (Scan) → 2 (Set Course to Phleebhut) → 5 (Light Speed) → 3 (Land)
+Citation: gamefaqs-tricrokra-archive.html, lines 362-370 — "= Choose 2. Navigation System = Choose 1. Scan"
+
+```
+
+**Why It's Meta-Puzzle Construction (Not Multi-Faceted Plan)**:
+This is a repair chain where each component installation enables the next action—without reactor power, wires cannot function; without wire connections, engine screen cannot activate. Components must be found first (parallel search phase), but installation follows linear sequence. Unlike MFP where requirements are just "all needed," here order matters due to hard dependencies: Reactor→Wires→Screen access.
+
+**Distinction from Similar Types**:
+- **Multi-Faceted Plan**: Would allow acquiring reactor, wires, AND engine in any order then installing all simultaneously. SQ3 requires sequential installation because powered systems won't recognize unpowered subsystems.
+- **Meta-Puzzle Construction**: The BROKEN SHIP itself is the puzzle structure—each failed system reveals what's needed, and repairs must happen in causal order (electricity before electronics).
+
+**Key Information Discovery Method**: Environmental examination. Looking at each broken panel/screen directly states what component is missing (e.g., "The reactor compartment is empty"). Unlike MFP's distributed NPC dialogue hints, SQ3 uses direct system interface feedback.
+
+---
+
+## Related Types
+
+| Type | Similarity | Distinction |
+|------|-----------|-------------|
+| **Meta-Puzzle Construction** | Sequential dependency; each step enables next | SQ3 has parallel acquisition phase (find all parts) before sequential installation |
+| **Multi-Faceted Plan** | Multiple requirements gathered from environment | MFP = gather then combine freely; SQ3 repair chain requires strict installation order |
+| **Environmental Storytelling Discovery** | Information revealed through examining objects/breakdowns | That type focuses on narrative revelation, not mechanical repair chains |

src/puzzles/robot-programming.md

@@ -0,0 +1,314 @@
+# Robot Programming / Color-Encoded Action Sequences (Pattern Learning Variant)
+
+**Information Architecture**: Player discovers mechanical rule system through trial-and-error with no explicit tutorial. Each button color maps to specific robot action (directional movement or item manipulation). Rules are consistent and exhaustive—once discovered, player understands COMPLETE control framework. Later puzzles invoke identical mechanics for different goals, requiring players to compose NEW sequences using mastered framework rather than learning new rules.
+
+**Player Action Pattern**:
+1. Encounter robot/control panel interface with multiple color-coded buttons
+2. Experiment with individual button colors to discover action mappings (purple=left, blue=up, etc.)  
+3. Observe robot behavior provides immediate visual feedback for each input
+4. Compose sequences by entering multiple colored commands before execution trigger
+5. Press execution button (triangle) to run programmed sequence
+6. If goal not achieved: review failed sequence, adjust color/order, re-execute
+7. When framework mastered: apply same rules to entirely different objectives without new teaching
+
+**Core Mechanic**: Color-coded interface buttons map to specific robot actions; player learns exhaustive rule set through experimentation in low-stakes puzzle context, then applies IDENTICAL framework to new goals where failure has higher consequences (power restoration affects game progression).
+
+---
+
+## Variations
+
+| Type | Learning Method | Feedback Clarity | Application Diversity | Example |
+|------|-----------------|------------------|----------------------|---------|
+| **Direct Experimentation** | Trial-and-error with no hints | High (visible robot movement) | Multiple goals, same rules | Robot lens retrieval → power restoration |
+| **Environmental Hints** | Murals/displays suggest button-color meanings | Medium (requires interpretation) | Single complex goal | Light bridge controls via museum display interpretation |
+| **Progressive Unlocking** | First rule reveals access to discover second | Low-Medium | Linear sequence discovery | Multi-stage control room puzzles |
+
+---
+
+## Adventure Game Implementation
+
+### Standard Actions Applied:
+- **CLICK** individual colored buttons = Input commands into program buffer (does NOT execute immediately)
+- **OBSERVE** robot display = Monitor command queue accumulation before execution
+- **CLICK TRIANGULAR/EXECUTION BUTTON** = Run programmed sequence
+- **WHITE CLEAR/BACKSPACE BUTTONS** = Reset or edit command queue mid-programming
+
+### Learning Through Failure:
+Unlike combat systems (swordfight) where failed attempts produce loss states, robot programming failures are benign—the robot simply doesn't achieve the desired outcome and returns to starting position. Player can retry indefinitely with modified sequences. This creates a sandbox learning environment with no penalty for experimentation.
+
+---
+
+## Example Structure: The Dig Robot Lens Retrieval
+
+### Learning Phase (Nexus Power Room)
+
+**Environment Setup**:
+[Source: spoiler_paul_greunke_walkthrough.txt, lines 158-173]
+
+```
+LOCATION: Nexus power room beneath main floor
+INTERFACE: Control panel with 7 color-coded buttons:
+→ Purple = ??? 
+→ Blue = ???
+→ Yellow = ???  
+→ Green = ???
+→ Orange/Red = ??? (contextually changes function)
+→ Top White = Backspace (remove last command)
+→ Bottom White = Clear (reset all commands)
+
+PHYSICAL CONTEXT: Robot descends through chute when triangular execution button pressed. Below robot can move over a pit containing an unattached lens that needs to be retrieved and placed in lens slot.
+
+PLAYER KNOWLEDGE STATE: Zero—no hints provided about button functions.
+```
+
+**Discovery Process Through Experimentation**:
+
+Based on walkthrough reconstruction and logical deduction:
+
+[Source: mogelpower_morgana_walkthrough.txt, lines 916-923]
+
+The walkthrough author describes the actual discovery method:
+
+> "The simplest way to figure out what the BUTTONS did seemed to be to plug in a line of one color on the CONTROL PANEL, PUSH the TRIANGULAR BUTTON, watch what happened, and then repeat with the next color. This way I'd be able to devise a program that would get the thing to the UNATTACHED LENS..."
+
+**Systematic Discovery Process**:
+```
+STEP 1: Test Purple Button
+→ Input: purple [execute]
+→ Observation: Robot moves LEFT one step
+→ Rule discovered: PURPLE = MOVE LEFT
+
+STEP 2: Test Blue Button  
+→ Input: blue [execute]
+→ Observation: Robot moves UP (toward top of screen/away from lens area)
+→ Rule discovered: BLUE = MOVE UP
+
+STEP 3: Test Yellow Button
+→ Input: yellow [execute]  
+→ Observation: Robot moves DOWN (toward lens area)
+→ Rule discovered: YELLOW = MOVE DOWN
+
+STEP 4: Test Green Button
+→ Input: green [execute]
+→ Observation: Robot moves RIGHT
+→ Rule discovered: GREEN = MOVE RIGHT
+
+STEP 5: Understand Orange/Red Contextual Function
+→ When robot positioned over item: orange/red = GRAB
+→ When robot holding item: orange/red = DROP
+→ Rule discovered: ORANGE/RED = contextual (GRAB/DROP toggle)
+
+RULE SET NOW COMPLETE—all button mappings known
+```
+
+**Application 1: Lens Retrieval Program**:
+
+[Source: spoiler_paul_greunke_walkthrough.txt, lines 173-175]
+
+> "to get the lens push: purple 4 times, yellow 2 times, and red 1 time"
+
+**Translation to Robot Commands**:
+```
+PROGRAM QUEUE (before execution):
+purple, purple, purple, purple, yellow, yellow, orange
+
+EXECUTED ACTIONS:
+LEFT → LEFT → LEFT → LEFT (robot positions over lens)
+DOWN → DOWN (robot descends to lens level)  
+ORANGE/RED = GRAB (robot picks up lens)
+
+[Execution button pressed] → Robot completes sequence, returns via chute with lens
+[Result check]: Lens slot now filled → Power activates → Nexus doors unlockable
+```
+
+**Key Design Element**: The walkthrough author notes in [mogelpower_morgana_walkthrough.txt, lines 919-923]:
+
+> "I had to PUSH the TRIANGULAR BUTTON a few times as I was putting the program together to make sure it was working right"
+
+This confirms player can ITERATE development—build partial sequence, test, add more commands, test again. This creates an accessible programming environment that mirrors modern incremental software development practices.
+
+---
+
+### Application 2: Power Restoration (Identical Rules, Different Goal)
+
+[Source: spoiler_paul_greunke_walkthrough.txt, lines 176-180]
+
+After lens retrieval, power activates but is temporarily on. Player must now create SECOND program to permanently restore power by placing lens into correct slot.
+
+> "to restore power (to open doors) push: purple 5 times, blue 4 times, and red 1 time"
+
+**Translation to Robot Commands**:
+```
+PROGRAM QUEUE:
+purple, purple, purple, purple, purple, blue, blue, blue, blue, orange
+
+EXECUTED ACTIONS:
+LEFT x5 (position robot over slot)  
+UP x4 (ascend to slot height)
+ORANGE/RED = DROP (release lens into slot)
+
+[Result check]: Lens installed → Power permanently restored → Door panels functional
+```
+
+**Why This Is Pattern Learning**:
+1. **Same Mechanic, Different Target**: Robot doesn't learn anything new—player knows all rules from Application 1. Only goal changed (retrieval vs installation).
+2. **New Sequence Required**: Cannot reuse lens retrieval program; player must compose fresh command sequence for different spatial objective.
+3. **Same Framework**: Purple still = left, blue still = up, etc. Zero new teaching occurs.
+
+The robot puzzle teaches the COLOR→ACTION rule set ONCE in Application 1, then requires EXHAUSTIVE APPLICATION of those rules to solve Application 2 without any additional hints or tutorials.
+
+---
+
+### Extended Application: Light Bridge Controls (Same Framework, New Domain)
+
+A related Puzzle Learning example exists throughout The Dig with the light bridge "strange device" controls found on each spire.
+
+**Light Bridge Control Pattern**:
+[Source: spoiler_paul_greunke_walkthrough.txt, lines 200-203; mogelpower_morgana_walkthrough.txt, lines 1278-1295]
+
+```
+MECHANIC: Three-lens positioning puzzle with timing component
+
+REPEATING FRAMEWORK on EACH spire light bridge:
+1. Position LENS to one of three angles (each produces different audio tone)
+2. Listen for which position produces DISTINCT/DIFFERENT tone  
+3. PUSH and HOLD switch until crystal above glows
+4. Maintain hold until line completes drawing across pentagonal display
+5. EXIT interface → BRIGHT LIGHT walkable bridge now appears connecting to central sphere
+
+WALKTHROUGH AUTHOR NOTE: Same process applies at least FOUR TIMES (Museum Spire, Planetarium Spire, Map Spire, Tomb Spire)
+[mogelpower_morgana_walkthrough.txt, lines 1599-1627 — light bridge solutions repeated across multiple spires with identical procedures]
+
+VARIATION: Last active light bridge encountered includes hidden prism puzzle within control panel—randomly placed to add unexpected complexity after framework mastery
+```
+
+**Why Light Bridges Are Pattern Learning (not Symbol Code Translation)**:
+- No visual symbol matching—player learns procedural sequence, not visual equivalencies
+- Identical process applies across ALL instances with zero re-teaching  
+- Player discovers rule set ONCE through first successful light bridge activation, then applies exhaustively
+- Audio feedback (different tone) becomes learned indicator of correct state
+
+---
+
+## Why Robot Programming Is Pattern Learning vs. Other Types
+
+### Distinction from Multi-Faceted Plan:
+- **MFP**: Scatter multiple DIFFERENT puzzle requirements (key, code, distractor); collect all, SYNTHESIZE into solution
+- **Robot Programming**: Discover ONE rule system (colors = actions); APPLY to multiple goals
+
+The robot uses a SINGLE mechanical framework applied repeatedly, not synthesis of disparate elements.
+
+### Distinction from Meta-Puzzle Construction:  
+- **MPC**: Step A produces output → Step B consumes that output → Step C builds on previous result
+- **Robot Programming**: Lens retrieval succeeds as complete unit; power restoration is separate task using same tools
+
+While both robot programs achieve related goals in same location, they are INDEPENDENT solutions not a chain where one's output becomes another's input. Player could restore power then retrieve lens—the order doesn't create dependencies.
+
+### Distinction from Observation Replay:
+- **OR**: Watch exact sequence once, reproduce verbatim—NO rule understanding required  
+- **Robot Programming**: Discover abstract rules ("purple moves left"), compose ORIGINAL sequences for new goals
+
+Player didn't watch "purple-purple-yellow-red" and memorize it for later repetition. Player discovered PURPLE=LEFT as a reusable rule, then COMPOSED custom programs for each objective.
+
+---
+
+## Design Considerations for Robot/Programming Puzzles
+
+**Implementation Patterns**:
+1. **Incremental Testing Capability**: Allow players to test partial sequences before full commits
+2. **Clear Visual Feedback**: Robot movement must be unambiguous—exactly 1 step per command with visible positioning
+3. **Command Queue Display**: Show entered sequence BEFORE execution so player can verify correctness mentally
+4. **Benign Failure States**: Incorrect programs should reset without permanent consequences or item loss
+
+**Best Practices**:
+1. Keep rule set small and memorable (5-7 actions maximum)
+2. First goal requires shorter sequence (~5-8 commands) to teach without overwhelming  
+3. Later applications require longer/more complex sequences using same rules (~10+ commands)
+4. Provide visual/auditory feedback for each command type (different sounds/animations per action)
+
+**Common Pitfalls**:
+- Rules too abstract or counterintuitive ("blue means diagonal movement" violates spatial intuition)
+- No way to test partial sequences—player must get entire program right on first attempt  
+- Robot pathfinding obscured by visual clutter (can't see if robot actually moved correct number of steps)
+
+---
+
+## Related Types
+
+| Type | Similarity to Robot Programming | Distinction |
+|------|----------------------------------|-------------|
+| **Pattern Learning / Knowledge Transfer** | Same core mechanism: learn rules once, apply exhaustively | Robot programming is concrete spatial manipulation; PL often abstract (dialogue, ingredient categories) |
+| **Symbol Code Translation** | Both systematic rule discovery through experimentation | SCT adds visual matching layer; robot programming uses direct abstraction (color→action, no intermediate symbol artifact) |
+| **Observation Replay** | Both require remembering sequences | OR copies watched sequence exactly; Robot requires composing NEW sequences from learned rules |
+
+---
+
+## Game Examples
+
+### The Dig: Nexus Robot Programming - Complete Walkthrough Solution
+
+**Setup**: After Brink dies and crew enters Nexus, player descends ramp to power room. Blue crystal provides temporary light but removing it causes blackout. An unattached lens hangs over a pit below—must be retrieved and installed to restore permanent power so Nexus doors can open.
+
+**Solution Chain**:
+[Source: Combined from spoiler_paul_greunke_walkthrough.txt lines 150-183; mogelpower_morgana_walkthrough.txt lines 915-925]
+
+**PHASE 1 - Rule Discovery (Tutorial Sandbox)**:
+1. Return to control panel with blue crystal in place (lights on for visibility)
+2. Click individual colored buttons one at a time, execute single-command programs:
+   - Purple alone → observe robot movement direction
+   - Blue alone → observe robot movement direction  
+   - Yellow/Green same process
+3. Discover purple=left, blue=up, yellow=down, green=right through systematic testing
+4. Learn orange/red button = GRAB/DROP (contextual based on robot state)
+
+**PHASE 2 - Lens Retrieval Program Composition**:
+5. Input sequence: P-P-P-P-Y-Y-O (purple×4, yellow×2, orange)
+6. Execute with triangular button → robot descends, navigates to lens position, grabs it
+7. Robot returns to chute with lens—lens now in inventory
+
+**PHASE 3 - Power Restoration Program Composition**:  
+8. Return to control panel (lights off but can interact)
+9. Input sequence: P-P-P-P-P-B-B-B-B-O (purple×5, blue×4, orange)
+10. Execute → robot navigates to slot position, drops lens into mount
+11. Power activates permanently, Nexus doors now unlockable with engraved rods
+
+**Why It's Extended Pattern Learning**:
+- Phase 1 teaches COMPLETE rule framework through experimentation
+- Phases 2 and 3 REQUIRE application of learned rules without additional hints
+- Player must COMPPOSE original sequences (not recall watched actions) using abstract mappings (colors → directions → spatial navigation)
+- Same system could theoretically be taught via explicit tutorial ("purple is left") but game design deliberately WITHHOLDS instruction, forcing discovery learning
+
+**Design Significance**: Unlike typical adventure game puzzle types where player solves discrete problems with unique solutions, the robot programming puzzle teaches a REUSABLE SYSTEM. This is mechanically closer to video game tutorial levels or mini-games that teach controls—except there's no explicit teaching text, only discovery through trial-and-error in authentic gameplay context.
+
+---
+
+## When to Document as Robot Programming / Color-Encoded Sequences
+
+Document as this type when:
+1. ✓ Interface uses abstract symbols (colors/shapes) mapping to specific actions via consistent rules  
+2. ✓ Player must DISCOVER mappings through experimentation—not taught explicitly
+3. ✓ Learned rule set applies to MULTIPLE puzzle goals requiring different sequences  
+4. ✓ Framework functions without visual artifact matching (unlike Symbol Code Translation's rod→button equivalence)
+
+DO NOT classify as this type if:
+- Only ONE solution sequence exists (no repeated application of learned rules = not Pattern Learning)
+- Mappings taught through explicit text/tutorial rather than discovery
+- Different rule sets required for different goals (not consistent framework = Multi-Faceted Plan instead)
+
+---
+
+## Cross-Reference to Related Mechanics
+
+### Contrast with Symbol Code Translation:
+Both teach systems through first-instance learning but differ in COGNITIVE LAYER:
+- **Robot Programming**: Abstraction learning ("purple → left")  
+- **Symbol Translation**: Visual matching learning ("red triangle on artifact → red triangle button on interface")
+
+In practice, The Dig uses BOTH systems extensively—robots for power restoration and spatial puzzles, rods for door unlocking. Each exemplifies Pattern Learning through different cognitive mechanisms (abstract vs visual).
+
+### Contrast with Observation Replay:
+Both involve sequences but differ in FLEXIBILITY:
+- **Robot Programming**: Player composes custom sequences based on understood rules
+- **Observation Replay**: Player reproduces EXACT watched sequence—no modification possible
+
+If player can think "I need to go LEFT 6 times instead of 4" rather than "I must repeat purple-purple-yellow-red exactly as shown," it's Robot Programming/Pattern Learning, not Observation Replay.

src/puzzles/surreal-logic-bridge.md

@@ -0,0 +1,247 @@
+# Surreal Logic Bridge
+
+**Information Architecture**: Player encounters a blocking condition where standard causality fails (eggplant ≠ toupee logically). Success requires accepting and acting ON explicit comedic/absurdist equivalences stated by game world or implied through character dialogue. The "aha" moment recognizes the puzzle operates on cartoon logic, not physical simulation.
+
+**Player Action Pattern**: 
+1. Attempt conventional solution → rejected with humorous failure
+2. Game provides absurdist clue (dialogue, environmental joke, item description)
+3. Player must mentally shift from realistic to surreal reasoning
+4. Execute action that makes comedic but NOT literal sense
+5. Success confirms the logic domain has shifted
+
+**Core Mechanic**: The puzzle explicitly rejects real-world causality in favor of cartoon/comedy logic equivalences (X = Y because the joke says so, not physics). Player success depends on recognizing when to abandon realistic reasoning entirely.
+
+---
+
+## Variations
+
+| Type | Clue Delivery | Equivalence Logic | Example |
+|------|---------------|-------------------|---------|
+| **Visual-Pun Bridge** | Environmental visual gag implies equivalence | X looks like Y → treat as same | Vegetable that looks like person's head = that person |
+| **Wordplay Literalization** | Double-meaning phrase taken literally | Pun becomes mechanic | "Toupee party" involves vegetable + toupee interaction |
+| **Cartoon Physics Bridge** | Action violates physics but consistent with animation tropes | Impossible action works because cartoons say so | Pull beard → hidden door opens |
+| **Surreal Item Combination** | Two unrelated items combine via comedic logic | A + B = C where relationship is joke-based | Eggplant on toupee transfers toupee to player |
+
+---
+
+## Game Examples
+
+### Sam & Max Hit the Road: Celebrity Vegetable Museum Toupee Acquisition (SMHTR)
+
+**Problem**: Player needs a toupee from Conroy Bumpus's house at Bumpusville. The toupee sits prominently displayed above the fireplace but is guarded/alarm-protected. Direct interaction triggers alarm and guards appear. Standard stealth or distraction approaches fail or are unavailable.
+
+<small>Source: adventuregamers_walkthrough.html, embedded walkthrough lines 503-510 — "Use the Conroy Bumpus eggplant on the toupee. The alarm will sound and Lee-Harvey will throw you out of the house, but you'll get the toupee."</small>
+
+<small>Source: abandonwaredos_solution.html, line 470 — "Use The Bumpus-Vegetable with the toupee -> Toupee"</small>
+
+```
+SETUP PHASE (Multi-Location Preparation):
+Location: Bumpusville House, Library Room
+Action: Use golf retriever on bookshelf → Obtain cleaning robot manual
+Note: This provides INFORMATION about alarms but NOT solution method
+Exit scene when maintenance droid appears
+
+Location: Celebrity Vegetable Museum
+Action: Pick up eggplant from vegetable display box
+Dialogue context: Eggplant visually resembles Conroy Bumpus's head shape
+Exit to car, travel back to Bumpusville
+
+CRITICAL PUZZLE EXECUTION:
+Location: Bumpusville House, Bedroom/Fireplace Area (9.3)
+Phase 1 - Setup Previous Actions Complete:
+- Toupee visible above fireplace/display shelf
+- Eggplant in inventory (from vegetable museum, acquired earlier)
+- Guardian NPC (Lee-Harvey maintenance droid) has patrolling pattern established
+
+Phase 2 - Surreal Logic Bridge Moment:
+1. Examine toupee → No direct pickup option available
+2. Standard "distract then steal" fails—alarm triggers regardless of guard position
+3. Player must recognize EGGPLANT + TOUPEE interaction as solution space
+4. Use Eggplant ON Toupee (not on alarm, not on guard—on the toupee itself)
+
+Phase 3 - Resolution:
+- Alarm TRIGGERS (expected/acceptable consequence)
+- Lee-Harvey appears and throws player out of the house
+- TOUPEE IS NOW IN INVENTORY despite eviction
+- Puzzle complete through accepted comedic trade-off
+
+
+LOGIC DOMAIN ANALYSIS:
+
+REALISTIC LOGIC (FAILS):
+- Eggplant has no physical property that affects toupees
+- Alarm system should prevent theft regardless of item used
+- Eviction = failure state in standard adventure game logic
+
+CARTOON LOGIC (SUCCEEDS):
+- Vegetable shaped like head + toupee on head = vegetable CLAIMS toupee
+- When player uses eggplant-on-toupee: toupee "transfers" to eggplant
+- Taking eggplant = taking toupee (comedic equivalence)
+- Alarm/eviction is COMIC CONSEQUENCE not puzzle failure
+- Narratively "worth it" because toupee was obtained
+
+Why Eggplant Specifically?
+- Visual joke: Bumpus's head resembles eggplant shape/color
+- Cultural reference: Eggplants as phallic/comedic vegetable tropes
+- Absurdist escalation: Normal items don't work; must use thematically-linked JOKE item
+```
+
+**Why It's Surreal Logic Bridge (Not Sensory Exploitation)**:
+1. **Logic Domain Shift Required**: Player actively rejects realistic causality—eggplant doesn't STEAL via distraction or perception manipulation; it COMEDICALLY TRANSFERS ownership through visual pun logic
+2. **Clue Provided Through Absurdism**: The vegetable museum establishes "celebrity vegetables" as joke concept (John Muir gourd, Bumpus eggplant). Player must accept this world internal comedy rules apply to puzzle-solving
+3. **Trade-off is Narrative, Not Mechanic**: In sensory exploitation, you avoid detection entirely. Here you ACCEPT failure consequence (eviction) because the comedic logic override provides desired outcome anyway
+
+**Distinction from Meta-Puzzle Construction**: The eggplant and toupee aren't steps in a production chain. They don't have sequential interdependence. Instead: EGGPLANT-AS-SURREAL-KEY directly unlocks TOUPEE ACCESS via cartoon physics equivalence, not through multi-step causal relationship.
+
+---
+
+### Sam & Max Hit the Road: Tunnel of Love Beard Pull Door Reveal (SMHTR)
+
+**Problem**: Inside the Carnival's Tunnel of Love attraction, a hidden door behind a medieval castle facade is invisible/unreachable via standard interaction. Player needs to access Doug the Mole Man's room to obtain crowbar and Twine Ball location info.
+
+<small>Source: adventuregamers_walkthrough.html, embedded walkthrough lines 205-213 — "Look at the man on the right. Sam will pull the beard, and a small door in the castle will open. Walk through the door."</small>
+
+<small>Source: abandonwaredos_solution.html, line 279 — "Use the Beard of the Man to the Right -> Hidden door opens, Go through it"</small>
+
+```
+CARTOON PHYSICS EXECUTION CHAIN:
+
+Location: Tunnel of Love Hidden Room (3.7)
+Access Phase (prior to beard puzzle):
+1. Ride swan boat into Tunnel of Love attraction
+2. Use flashlight on back walls → reveals hidden fuse box
+3. Use Max on fuse box → stops moving swan boat in place
+4. Examine wall decorations → medieval castle facade with knight portrait visible
+5. Portrait shows bearded man (medieval king/knight imagery)
+
+The Surreal Logic Bridge:
+CRITICAL MOMENT - Realistic logic would suggest:
+- Examine portrait for hidden switches
+- Look behind canvas/frame for mechanism
+- Seek key or code elsewhere in room
+- Attempt to open visible doors/windows
+
+ACTUAL PUZZLE SOLUTION (Cartoon Physics):
+6. Use PULL action on the knight's BEARD in the portrait
+7. Beard removal triggers mechanical linkage
+8. Hidden door physically slides open in castle wall
+9. Enter newly-accessed passage → Doug's room
+
+LOGIC ANALYSIS:
+
+CARTOON TROPE UTILIZATION:
+- Classic animation trope: Pull fake beard → reveal disguise/hidden person/mechanism
+- Beards as removable props is established cartoon convention
+- Portrait "come to life" interaction violates normal art-object rules
+- Mechanical linkage between 2D portrait and 3D door exists without physical explanation
+
+WORLD-BUILDING JUSTIFICATION:
+- Tunnel of Love IS carnival ride → already operates on amusement-theme logic
+- Hidden room contains Doug the Mole Man (another cartoon character)
+- Entire sequence occurs within attraction designed for comedy/fantasy effects
+
+CONSEQUENCE STRUCTURE:
+No failure state—beard pull always works. The "puzzle" is recognizing that cartoon physics apply where realistic mechanics would fail.
+```
+
+**Why It's Surreal Logic Bridge**:
+1. **Explicit Cartoon Trope Reference**: Pulling fake beard to reveal hidden thing is animation convention, not physical world behavior
+2. **No Clues or Trial-and-Error Needed**: Beard pull should seem obvious TO cartoon literate players but IMPOSSIBLE to realistic logic
+3. **Success Confirms World Rules**: After this puzzle, player learns Sam & Max operates on comedy physics consistently
+
+**Distinction from Environmental Storytelling Discovery**: The hidden door isn't discovered through careful observation of environmental details (cracks in wall, odd texture). It's discovered through EXECUTING a cartoon action that has NO real-world precedent. The "clue" is genre literacy, not in-game detail.
+
+---
+
+## Related Types
+
+| Type | Similarity | Distinction |
+|------|------------|-------------|
+| **Metaphor-to-Literal Translation** | Both require non-literal thinking | Metaphor = decode language; SurrLogic = accept cartoon physics override |
+| **Sensory Exploitation** | Both bypass standard interaction | SE exploits perception weakness; SL abandons causality entirely |
+| **Meta-Puzzle Construction** | Both involve multi-step solutions | MPC uses realistic chains; SL uses joke equivalences as steps |
+
+---
+
+## Design Considerations
+
+**When to Use**: Puzzles where comedy tone is central to game identity; situations where realistic logic would create tedium or false dead-ends.
+
+**Risks**: 
+- Overuse makes world feel inconsistent (can player trust ANY logic?)
+- Solutions may seem random rather than clever if clues aren't thematic enough
+- Frustration when players can't recognize genre convention reference
+
+**Best Practice**: Anchor surreal equivalences in visual jokes or established character/world comedy. The eggplant works because vegetable museum established "celebrity vegetables" as running gag first.
+
+### Simon the Sorcerer: Watermelon-Sousaphone Trade (SIMON)
+
+**Problem**: A musician is endlessly playing a sousaphone near the Troll Bridge, annoying Simon who needs to pass by. The musician refuses to stop—and crucially, offers the player the broken instrument after some event occurs. The solution involves an object interaction with no realistic causal link: throwing a giant melon directly into a brass instrument's bell.
+
+<small>Source: walkthroughs/simon1/simon1.txt, lines 553-556 — "Go to the sousaphone player, near the troll bridge. Simon hates his music, so use the watermelon on the sousaphone. You receive a sousaphone for your troubles."</small>
+
+<small>Source: walkthroughs/simon1/simon1_2.txt, lines 115-116 — "Use the watermelon on the sousaphone to get the sousaphone"</small>
+
+```
+CARTOON PHYSICS ACTION REQUIRED:
+
+REALISTIC EXPECTATION:
+If player throws large fruit at a musical instrument during performance:
+→ Instrument might be damaged (realistically expensive brass instrument)
+→ Musician would be angry/upset  
+→ No guarantee of obtaining possession of the instrument
+
+
+SIMON CARTOON LOGIC OUTCOME:
+1- Player USES watermelon on sousaphone bell (direct contact action)
+2- Watermelon physically enters and JAMS the brass tubing interior
+3- Musician stops playing because instrument is now inoperable
+4- COMIC EXCHANGE DIALOGUE occurs (not captured in walkthrough but implied):
+   - Musician: "You've ruined my sousaphone with this giant melon!"
+   - Simon: "Here's another one? Take it. My bad."
+   - Player receives the broken original as consolation replacement
+
+
+WHY IT'S SURREAL LOGIC BRIDGE:
+
+NO REAL-WORLD CAUSAL CHAIN EXISTS FOR THIS SOLUTION:
+There is NO legitimate reason why throwing a watermelon at a sousaphone should result in player acquisition of that sousaphone. In realistic logic:
+- Jamming instrument ≠ transferring ownership
+- Damaging property usually creates conflict, not gift economy
+
+The puzzle works PURELY through COMEDIC CAUSALITY:
+"Watermelon clogs instrument" → "Musician defeated by absurdity" → "Player gets damaged goods as compensation"
+
+
+COMIC JUSTIFICATION AS GAME LOGIC:
+The humor derives from treating the exchange as completely legitimate within game world. No characters express shock at the fairness of "broken sousaphone for ruined watermelon"—it's accepted trade practice that the player receives the instrument simply by having destroyed its playability. This is cartoon logic where physical comedy automatically resolves to new item acquisition, regardless of realistic transaction rules.
+
+
+FAILURE MODE ABSENCE AS MECHANICAL FEATURE:
+Unlike other puzzles where wrong interactions lead to blocked progress or hostile NPC responses, surreal logic puzzles often have NO FAILURE STATE for their core action. Throwing the watermelon CANNOT "fail" in a traditional sense—it will ALWAYS jam and player will ALWAYS get the sousaphone because that's how cartoon equivalences work.
+
+This differs from Sensory Exploitation (wrong item = failure to exploit) or Meta-Construction (wrong sequence = broken chain). The surreal action is BINARY AND GUARANTEED: perform the absurd interaction, receive the absurd reward.
+
+
+THEMATIC ANCHOR IN SIMON WORLD:
+Simon the Sorcerer establishes early that its world operates on comedic causality where ridiculous actions have legitimate game-state consequences. The watermelon-sousaphone trade justifies subsequent acceptance of other cartoon solutions like:
+- Eating magic mushrooms to resize character
+- Talking animals (owl, tree) providing quest help  
+- A talking pig (Rapunzel) eating through a chocolate door
+
+Once player accepts "melon jams horn = get horn" as valid logic, the game's identity is confirmed: this world rewards absurdity as legitimate puzzle-solving methodology.
+
+
+PREVIOUS CONTEXT NEEDED FOR FULL COMIC EFFECT:
+The watermelon itself required a prior chain to obtain (beans → compost pile → melon growth). This means player HAS INVESTED in obtaining the absurd item before discovering its equally-absurd application. The comedy is AMPLIFIED because:
+
+1- Player worked through realistic-ish chain for watermelon (water beans, plant on compost, harvest fruit)
+2- Application context appears at first glance as hostile confrontation (musician blocking path)  
+3- Solution revealed to be GENTLE CARTOON PHYSICS rather than real conflict—no violence required, just throwing produce
+
+The tonal shift from realistic item acquisition → cartoon application delivers the full comedic surprise that justifies the surreal equivalence.
+```
+
+**Why It's Surreal Logic Bridge**: The watermelon-to-sousaphone exchange requires player to abandon realistic causation entirely and accept cartoon physics where "damage through absurdity = compensatory possession transfer." No trial-and-error, no clues about "fruit jams instruments"—just execution of inherently ridiculous action that game world accepts as legitimate transaction.
+
+---

src/puzzles/symbol-code-translation.md

@@ -0,0 +1,805 @@
+# Symbol Code Translation / Extended Pattern Learning
+
+**Information Architecture**: Game establishes a mechanical system in a low-stakes domain (first engraved rod + door panel combination), then requires application of IDENTICAL rules across multiple instances with different targets. The player learns the translation framework once, then exhaustively applies it to new symbol sequences discovered throughout exploration. This extends Pattern Learning by adding a VISUAL SYMBOL RECOGNITION layer—player must observe symbol shapes and colors, map them to interface buttons with matching visual properties, then input exact sequence order.
+
+**Player Action Pattern**:
+1. Acquire engraved rod or similar symbol-bearing artifact from environment
+2. EXAMINE artifact to view full symbolic sequence (4-5 colored geometric shapes in specific order)
+3. Locate corresponding interface panel with selectable symbol/color buttons
+4. Map each observed symbol → matching button on panel (visual equivalency check)
+5. Input sequence from left-to-right (order matters; random attempts fail)
+6. Panel validates → door/mechanism unlocks
+
+**Core Mechanic**: The learning domain and application domain share IDENTICAL underlying rules with an ADDITIONAL visual mapping layer—player must recognize that Symbol Domain A (engraved rod sequence) translates to Action Domain B (panel button presses) through SHAPE+COLOR matching, not just mechanical repetition like standard swordfight insults or voodoo ingredient categories.
+
+---
+
+## Variations
+
+| Type | Learning Instance | Application Count | Visual Mapping Complexity | Example |
+|------|-------------------|-------------------|--------------------------|---------|
+| **Direct Translation** | Single rod learned | Multiple rods applied | Low (shapes/colors match directly) | Engraved rods → Nexus doors |
+| **Multi-Source Map Generation** | All rods collected | Single panel application | Medium (sequential code entry, output is informational) | Map Room: all rods reveal spire locations |
+| **Hidden Sequence Discovery** | Pattern visible after power activation | One-time use | High (symbols only readable AFTER prerequisite puzzle) | Crystal control room panels |
+
+---
+
+## Adventure Game Implementation
+
+### Standard Actions Applied:
+- **EXAMINE** = Reveal symbol sequence on artifact (cannot proceed without observation)
+- **LOOK/USE** on panel = Access button interface for input
+- **CLICK** on individual buttons = Select symbols in sequence (order sensitive, no "backspace" mechanic in most implementations)
+- **TAKE** artifact first = Must possess symbol source in inventory before translation is possible
+
+### Key Distinctions from Pattern Learning:
+1. **No combat/training domain**: Player doesn't practice with dummy doors; first rod is a FUNCTIONAL puzzle
+2. **Visual recognition layer added**: Not just "insult A → retort B" rules but also "red triangle shape on rod = red triangle button on panel" mapping
+3. **Exploration-dependent progression**: New rods discovered across scattered locations (museum, underwater caves, creature encounters) rather than sequential tutorial flow
+
+---
+
+## Example Structure: The Dig Engraved Rod System
+
+### Learning Phase (First Door in Nexus):
+
+```
+ACQUISITION:
+→ Purple engraved rod obtained after activating wire in Wreck chamber
+   [Source: spoiler_paul_greunke_walkthrough.txt, lines 107-108 — "get wire / get engraved rod"]
+   
+EXAMINATION PHASE:
+→ EXAMINE purple rod reveals: 4 colored geometric shapes in sequence
+   [Source: mogelpower_morgana_walkthrough.txt, lines 690-698 — "I EXAMINED it and found some 
+   colored geometric symbols on it... The shapes seemed to resemble the BUTTONS on the PANELS"]
+   
+→ IMPORTANT NOTE from walkthrough: Symbol arrangements appear RANDOM per playthrough
+   [Source: mogelpower_morgana_walkthrough.txt, lines 692-697 — "I discovered in replaying 
+   the game that the symbols appear to be set randomly from game to game...red triangle, green 
+   hexagon, green cube, another red triangle"]
+
+INTERFACE DISCOVERY:
+→ First sealed door panel shows 4 rows of color-coded geometric buttons
+→ Each row corresponds to ONE position in rod sequence
+→ Player must scroll through button options until each position matches rod shape+color
+   
+VALIDATION DISCOVERY:
+→ Input order is LEFT-TO-RIGHT (matches visual reading direction on rod)
+   [Source: mogelpower_morgana_walkthrough.txt, lines 995-997 — "I plugged in the combination 
+   on the PURPLE ENGRAVED ROD as it appeared there from left to right and the SEALED DOOR opened!"]
+
+SUCCESS = Door opens → Tram access unlocked
+```
+
+### Application Phase (Subsequent Doors - No Teaching Reminders):
+
+**Orange Rod (Underwater Cave) → Second Door**:
+```
+→ Player acquires orange rod AFTER defeating sea monster, swimming underwater
+[Source: spoiler_paul_greunke_walkthrough.txt, lines 257-258 — "get plate / get orange engraved rod"]
+
+→ EXAMINATION reveals 4 new symbols (randomized, different from purple rod)
+NO REMINDER that left-to-right order matters
+NO EXPLANATION of color+shape matching principle
+
+→ Player must self-instruct: "this works the same way purple rod did"
+→ Door opens successfully via IDENTICAL process
+```
+
+**Red Rod (Museum Spire) → Third Door**:
+```
+[Source: spoiler_paul_greunke_walkthrough.txt, line 212 — "get red engraved rod"]
+→ Same mechanical translation, zero reinforcement of rules
+```
+
+**Green Rod (Planetarium Spire Creature Trap Puzzle) → Fourth Door**:
+```
+[Source: spoiler_paul_greunke_walkthrough.txt, line 361 — "get green rod"]
+→ Requires completing meta-puzzle construction (dowel+pole+rib cage trap sequence)
+→ THEN symbol translation applies identically to door 4
+```
+
+**Yellow Rod (Tomb Spire/Eclipse Mechanism) → Final Door Access**:
+```
+[Source: spoiler_paul_greunke_walkthrough.txt, line 415 — "use yellow engraved rod with slot"]
+→ Requires solving eclipse/tomb opening puzzle first
+→ Translation mechanic applies same way as doors 1-4
+```
+
+### Extended Application (Map Room - Multi-Rod Synthesis):
+
+The Map Spire introduces a SECONDARY application of the translation system:
+
+**Map Panel Information Generation**:
+[Source: mogelpower_morgana_walkthrough.txt, lines 1633-1653]
+
+```
+SINGLE PANEL with 5 input slots = Requires ALL rods collected from previous spires
+
+PROCEDURE:
+→ Plug in purple rod sequence → View Museum Spire location on map display
+→ Plug in orange rod sequence → View Underwater Cave/Tunnel locations on map  
+→ Plug in red rod sequence → View TOMBE location with "way below it" highlighted (critical late-game clue)
+→ Plug in green rod sequence → View Planetarium Spire chamber locations
+→ Each output is INFORMATION only, not door unlock
+
+KEY DIFFERENCE: Rods previously functioned as KEYS (open single target). Here they function as MAP COORDINATES (reveal information about game world layout)—SAME mechanical translation, different output type.
+```
+
+**Critical Clue Extraction**:
+The Red Rod's map view specifically shows "a crypt somewhere -- with a way below it" which:
+1. Alerts player that tomb has hidden lower chambers
+2. Required for later puzzle progression (cannot access crypt unless player has seen map)
+   [Source: mogelpower_morgana_walkthrough.txt, lines 1650-1658 — "NOTE: It appears that viewing the crypt in the MAP ROOM as just described can save you a lot of trouble later"]
+
+---
+
+## Why This Is Extended Pattern Learning vs. Other Types
+
+### Distinction from Observation Replay:
+- **OR**: Memorize exact button sequence (e.g., "up-down-left-left-down"), reproduce exactly
+- **Symbol Translation**: Memorize RULE ("rod symbols = panel buttons, left-to-right, shape+color match") then apply to NEW values each time
+
+The engraved rod system cannot be Observation Replay because:
+1. Symbols are randomized per playthrough—walkthroughs cannot hard-code solutions
+2. Player applies FRAMEWORK (translation rule) not specific VALUES (button sequence)
+3. Each new rod requires fresh visual recognition, not "remember the last one"
+
+### Distinction from Multi-Faceted Plan:
+- **MFP**: Gather scattered requirements (key+code+distractor), SYNTHESIZE into single solution
+- **Symbol Translation**: Gather scattered instances of SAME requirement type, apply FRAMEWORK repeatedly
+
+Each rod is independently complete—no synthesis across rods needed. The purple rod doesn't "combine" with orange rod; they each individually open one door using identical mechanics.
+
+### Distinction from Standard Pattern Learning (MI1 Sword Fighting):
+**Additional Visual Mapping Layer**: MI1 player learns abstract rule pairs ("My tongue is sharper → feather duster"). The Dig player must ALSO perform visual recognition: "this red hexagon on rod = this red hexagon button on panel." It's not just mechanical transfer (rule applies elsewhere), it's VISUAL-to-ACTION translation.
+
+---
+
+## Design Considerations for Symbol Code Translation Puzzles
+
+**Implementation Patterns**:
+1. **Randomization per Playthrough**: Ensures walkthroughs cannot hard-code solutions; forces player engagement with the MECHANIC not memory
+2. **Consistent Visual Grammar**: Shapes and colors on rods MUST match button interfaces exactly (no "close enough" matching)
+3. **First Instance as Sandbox**: First rod/door pair has no penalty for wrong order attempts (can retry indefinitely until pattern discovered)
+4. **No Backspace Mechanic** (optional): Increases difficulty by requiring complete sequence re-entry if one position is wrong
+
+**Best Practices**:
+1. Provide clear visual feedback on EXAMINATION—symbols must be readable and unambiguous
+2. First success should produce immediate, unmistakable result (door HUMS then opens with cutscene)
+3. Consider varying OUTPUT TYPE across instances (some doors open, some panels generate information like Map Room) to keep mechanic fresh while maintaining same underlying rules
+
+**Common Pitfalls**:
+- Players may incorrectly believe symbols are cipher codes requiring "decryption" rather than direct visual matching
+- Order sensitivity should be obvious (left-to-right reading direction is intuitive but should be reinforced by first instance)
+- If randomized, ensure ALL symbol shapes/colors appear available on panels—nothing on rod that panel cannot display
+
+---
+
+### Quest for Glory IV: Dr. Cranium's Keyhole Slider Puzzle (QFG4)
+
+**Setup**: After obtaining the key from the Antwerp maze, the player must open Dr. Cranium's main laboratory door using a sliding puzzle panel mechanism that requires matching colored background keys to form a keyhole image.
+
+<small>Source: qfg4-gamefaqs-anonymous.txt lines 684-687 — "Match colored background keys in sliding panel puzzle to form keyhole image"</small>
+
+```
+SYMBOL OBSERVATION PHASE - Keyhole Pattern Recognition:
+→ Approach locked door with sliding tile panel interface  
+→ Panel contains multiple movable tiles, each showing partial keyhole sections
+→ Goal state: Arrange tiles so complete KEYHOLE shape emerges from combined pieces
+→ CRITICAL VISUAL CLUE: Match COLORS of background keys on tiles to correct positions
+
+SLIDING MECHANIC APPLICATION:
+Step 1 → Identify edge pieces (keyhole outline segments) by color matching  
+Step 2 → Note specific tile colors must align (background keys have distinct hues)
+Step 3 → Slide tiles systematically—typically require ~8-12 moves for solution
+      Standard sliding puzzle mechanics apply: only adjacent empty space allows movement
+
+VALIDATION:→ When complete keyhole image forms correctly, grid lines of puzzle vanish  
+→ Panel automatically unlocks door to Dr. Cranium's private lab (6 points)
+```
+
+**Why It's Symbol Code Translation**: Player OBSERVES visual symbol pattern (keyhole image with color-coded sections), then TRANSLATES this into interface actions (sliding specific colored tiles to positions). Color matching on background keys creates explicit visual equivalency between desired state and tile properties.
+
+<small>Cited from: qfg4-gamefaqs-sac.txt:2227-2235</small>
+
+---
+
+### Quest for Glory IV: Borgov Tomb Color Spelling Puzzle (QFG4)
+
+**Setup**: Inside the Borgov family crypt, a secret passage to Castle Borgov is hidden behind a color-coded interactive floor mechanism. The player must spell "BORGOV" using six distinct colors mapped to letters on the tomb's crest carving.
+
+<small>Source: qfg4-gamefaqs-anonymous.txt lines 893-899 — Color-based spelling puzzle where colors map to literal letters</small>
+
+```
+SYMBOL DISCOVERY PHASE - Crest Examination:
+→ Locate Borgov family crest embedded in crypt floor or wall
+→ Crest displays word "BORGOV" with color-coded letter associations
+→ Observation reveals color-to-letter mapping (example):
+  B = Blue
+  O = Orange  
+  R = Red
+  G = Green
+  O = Orange (second instance)
+  V = Violet/Purple
+
+COLOR SEQUENCE APPLICATION - Secret Passage Activation:
+Step 1 → Approach color-sensitive pressure plate or interactable mechanism near crest
+      Note: Location may be subtle—often requires "look around" for clickable colored tiles/rings
+
+Step 2 → Press activated colors in EXACT letter order spelling B-O-R-G-O-V:
+  Click Blue → Orange → Red → Green → Orange → Violet
+  
+Step 3 → Confirm sequence is complete (mechanism provides visual/audio feedback)
+
+VALIDATION:Secret passage opens behind crested wall or floor panel shifts
+→ Leads directly to hidden interior of Castle Borgov, bypassing front gate security
+```
+
+**Why It's Symbol Code Translation **(with Unique Color-to-Alphabet Mapping)This puzzle introduces a DISTINCT sub-variation: colors don't match visual shapes but instead TRANSLATE to LITERAL LETTERS via an explicit mapping system. Player observes the code (crest displaying colored letters), then translates abstract symbols (colors on interface) into semantic meaning (letters spelling name).
+
+This is MORE COMPLEX than standard SCT because:
+1. **Two-step translation**: Color → Letter → Position in word
+2. **Semantic layer added**: Not just visual shape matching but also spelling comprehension
+3. **Repeated color handling**: Orange appears twice but must be used twice in sequence (O_RGOV)
+
+**Comparison to Standard SCT Framework:**
+- The Dig rods: Shape+color ON rod → same shape+color on PANEL buttons (direct visual match)
+- Borgov tomb: Color ON interface → LETTER value → correct word spelling (semantic translation required)
+
+Both share core SCT structure but Borgov adds **METAPHOR LAYER**: colors represent abstract concepts (letters), not just matching visual patterns. This bridges Symbol Code Translation with Metaphor-to-Literal Translation mechanics.
+
+<small>Cited from: qfg4-gamefaqs-anonymous.txt:893-899, crystalshard.txt:398-401</small>
+
+---
+
+## Related Types
+
+| Type | Similarity to Symbol Code Translation | Distinction |
+|------|---------------------------------------|-------------|
+| **Pattern Learning / Knowledge Transfer** | Both teach system once, apply exhaustively across new targets | SCT adds visual recognition matching layer; standard PL is abstract rule transfer only |
+| **Observation Replay** | Both require careful observation of symbolic sequence | OR copies exact values repeated; SCT translates symbols to interface actions each time |
+| **Multi-Faceted Plan Puzzle** | Both involve collecting scattered artifacts across exploration | MFP SYNTHESIZES multiple unique requirements; SCT applies ONE framework to multiple instances |
+| **Metaphor-to-Literal Translation** | Borgov tomb color spelling uses symbolic representation | MMI interprets abstract language as GAME MECHANICS; this uses colors as LETTER stand-ins (visual metaphor, not linguistic) |
+
+---
+
+## Game Examples
+
+### The Dig: Purple Engraved Rod → First Nexus Door (Learning Instance)
+
+**Setup**: After Brink dies, player explores central Nexus chamber with 5 sealed doors and corresponding control panels. One door has no panel but an alchove for plates. Four doors have panels with geometric button interfaces.
+
+**Solution Chain**:
+1. Obtain purple engraved rod from Wreck chamber (pulled wire activates ghost light, revealing hidden rod)
+2. EXAMINE rod in inventory—reveals 4-symbol sequence (e.g., red triangle, green hexagon, blue cube, red circle—varies per playthrough)
+3. Note that rods have NO intrinsic function other than being examined for symbols
+4. Move to first door panel with button interface and examine
+5. Each of 4 rows on panel scrolls through different colored shapes when clicked
+6. Input sequence from left to right, matching rod order exactly:
+   - Row 1: Scroll until shows red triangle → Click to set
+   - Row 2: Scroll until shows green hexagon → Click to set  
+   - Row 3: Scroll until shows blue cube → Click to set
+   - Row 4: Scroll until shows red circle → Click to set
+7. Exit panel interface—door hums briefly then slides open
+
+**Why It's Symbol Code Translation**: This is the TUTORIAL instance—player learns framework here without explicit instruction. Success depends on recognizing visual equivalency (shape+color match) AND order sensitivity (left-to-right reading). The rod itself provides NO information other than symbol display—it must be paired with a panel interface to have function.
+
+**Citation**: 
+- [spoiler_paul_greunke_walkthrough.txt, lines 149-150 — "examine purple rod / click on the buttons until they match the purple rod"]
+- [mogelpower_morgana_walkthrough.txt, lines 682-700 — rod examination and button matching process]
+
+---
+
+### The Dig: Robot Programming via Symbol Sequences (Pattern Learning Variant)
+
+A related but distinct mechanic in The Dig demonstrates Pattern Learning without the symbol translation layer—pure action sequence learning.
+
+**Lens Retrieval Robot Control Panel**:
+[Source: spoiler_paul_greunke_walkthrough.txt, lines 164-173]
+
+```
+COLOR-CODED BUTTON FUNCTIONS (learnt through experimentation):
+→ Purple button = robot moves left
+→ Blue button = robot moves up  
+→ Yellow button = robot moves down
+→ Green button = robot moves right
+→ Orange/Red button = robot GRABS/DROPS item (context sensitive)
+→ White buttons = backspace / clear
+
+PROGRAMMING PHASE:
+Player discovers functions via trial-and-error with no explicit tutorial
+
+TO RETRIEVE LENS:
+Sequence learned through experimentation:
+"purple 4 times, yellow 2 times, and red 1 time" [Source: spoiler_paul_greunke_walkthrough.txt, line 173]
+Translation: LEFT x4, DOWN x2, GRAB = robot navigates over edge to unattached lens
+
+TO RESTORE POWER (different task, SAME mechanics):
+"purple 5 times, blue 4 times, and red 1 time" [Source: spoiler_paul_greunke_walkthrough.txt, line 179]
+Translation: LEFT x5, UP x4, DROP = robot returns lens to slot
+```
+
+**Why This IS Pattern Learning (not Symbol Code Translation)**:
+- No visual symbol mapping layer—player learns abstract rule set "color → directional action"
+- Same framework applies to TWO different goals with DIFFERENT sequences
+- Framework is mechanical (button press → movement command), not visual (symbol A = button B)
+
+---
+
+### The Longest Journey: Crystal Altar Puzzle (Chapter 7 - A Deep Blue Mirror)
+
+**Problem**: Inside underwater city of Atlast, an altar in the sacred cave requires four crystals placed into corresponding holes with symbol rings rotated to matching positions. Each crystal has unique color/appearance and each hole displays a distinct symbol that must be aligned correctly.
+
+<strong>Source: 04_gameboomers_k_daleng.txt, lines 216-221 — "Put the brown crystal in the hole marked with a wave (the symbols can be difficult to see, but just look at the holes and April will tell you the symbol) with the wave symbol turned out. Put the yellow crystal in the hole marked with a fish with harpoon symbol turned out."</strong>
+
+<strong>Source: 02_outrider_complete_walkthrough.txt, Chapter 7 section — "Four crystals must be found and placed on altar in specific configuration"</strong>
+
+```
+SYMBOL TRANSLATION FRAMEWORK:
+
+CRITICAL CLUE SOURCE (Wall Paintings):
+Step A → Earlier exploration of Atlast city reveals wall paintings depicting symbols AND their corresponding crystal placements
+         - Player must examine paintings carefully before attempting altar puzzle
+         - Each painting shows: Symbol + Crystal Color + Orientation requirement
+
+CRYSTAL ACQUISITION PHASE (Collection Sub-Puzzle—Separate MFP):
+Step B → Collect four crystals from disparate locations around Atlast/water city:
+         
+         1. BLACK PEARL/Crystal from clam just outside airbubble entrance
+            <small>Source: 04_gameboomers_k_daleng.txt, line 210 — "Take the black pearl inside the clam right outside the bobble"</small>
+            
+         2. YELLOW/GREEN Crystal from city wall grime scraping
+            <small>Source: 04_gameboomers_k_daleng.txt, line 211 — "Get some of the green stuff on the wall" (used as blood substitute ritual)</small>
+            
+         3-5. Three remaining crystals from cave seagrass clearing sequence:
+              - Must CLEAR seaweed obstacles to access each crystal location
+              - Each clearing reveals ONE crystal at a time
+
+ALTAR SOLUTION EXECUTION (Symbol Translation):
+Step C → Enter sacred cave; altar displays four circular holes with rotatable symbol rings
+            
+Step D → BROWN CRYSTAL assignment:
+         - HOLE: Marked with WAVE symbol in engraving
+         - RING ROTATION: Wave symbol must face OUTWARD (away from center)
+            
+Step E → YELLOW CRYSTAL assignment:  
+         - HOLE: Marked with FISH symbol  
+         - RING ROTATION: HARPOON symbol must face OUTWARD (NOT fish itself!)
+         - CRITICAL DISTINCTION: Ring shows TWO symbols; correct one is HARPOON, not the hole's primary marker
+            
+Step F → GREY CRYSTAL assignment:
+         - HOLE: Marked with ONE-EYE TEMPLE symbol  
+         - RING ROTATION: One-eyed temple faces OUTWARD (matching hole marker)
+            
+Step G → GREEN CRYSTAL assignment:
+         - HOLE: Marked with HARPOON symbol
+         - RING ROTATION: FISH symbol faces OUTWARD (NOT harpoon!)
+         - INVERSION: Ring symbol is OPPOSITE of hole's marker
+
+STEP H → Final validation: All four crystals placed with correct ring orientations  
+         → Altar activates, reveals hidden opening to Sharptooth chamber
+
+
+SYMBOL MAPPING PATTERN ANALYSIS:
+
+Two Distinct Symbol-Pairing Rules Discovered:
+Rule 1 (Direct Match): Brown→Wave, Grey→Temple = Ring symbol MATCHES hole symbol
+Rule 2 (Inversion Pair): Yellow→Harpoon (on Fish hole), Green→Fish (on Harpoon hole)  
+         = Ring symbol is INVERTED from hole symbol
+
+PLAYER DISCOVERY METHOD: Wall paintings provide visual reference for correct pairings
+WITHOUT examining paintings carefully, player must guess through trial-and-error
+
+**Why It's Symbol Code Translation**: The puzzle establishes a VISUAL SYMBOL RECOGNITION framework through wall paintings (information source). Player then must apply this framework across FOUR separate crystal assignments, each requiring independent symbol→ring mapping. Unlike standard pattern learning where rules transfer between domains, here the player translates BETWEEN visual representation formats: Wall Painting Symbols → Altar Ring Orientation. The additional complexity is that TWO crystals follow direct matching while TWO follow inversion pairing—the player must recognize BOTH SUB-RULES apply within same puzzle instance.
+
+**TLJ-Specific Implementation**: This represents TLJ's Arcadian puzzle aesthetic—mystical symbols with environmental information sources rather than sci-fi interfaces like Stark side. Same Symbol Code Translation framework, different visual language (carved stone vs electronic panels).
+
+---
+
+
+
+## When to Document as Symbol Code Translation
+
+Document a puzzle as Symbol Code Translation when:
+1. ✓ Visual symbols on ONE artifact (rod/code plate/map key) must be matched to interface elements with matching PROPERTIES (shape/color/type)
+2. ✓ Sequence ORDER matters and must be maintained through translation process
+3. ✓ Same mechanical framework applies to MULTIPLE instances across gameplay (at least 3+ uses of system)
+4. ✓ First instance functions as implicit tutorial without explicit teaching
+
+DO NOT use this classification if:
+- Symbols are fixed values player simply memorizes (Observation Replay instead)
+- Only ONE translation occurs with no repeated applications (Simple Code Puzzle, not system-based)
+- Visual recognition is irrelevant—abstract rule transfer only (Pattern Learning / Knowledge Transfer instead)
+- Multiple DIFFERENT artifacts must be combined (Multi-Faceted Plan or Meta-Puzzle Construction instead)
+
+---
+
+### Indiana Jones and the Last Crusade: Library Stained Glass Window Puzzle (INDY1)
+
+**Problem**: After meeting Elsa Schön at Venice, Indiana Jones must escape a pursuing gunman by finding the correct stained glass window hidden among many in a library complex. The grail diary contains a visual diagram of one specific window AND a Latin quotation referencing roman numerals inscribed on stone pillars—player must translate both symbol types into physical actions to locate and trigger the escape mechanism.
+
+<small>Source: walkthrough-king.txt, lines 83-87 — "Look at the grail diary and note the design of a window, and a quotation. Walk through the rooms with stained glass windows until you find the one that exactly matches the picture from the book."</small>
+
+<small>Source: walkthrough-king.txt, lines 96-100 — "Now the quotation will mention a number and a direction, which indicate which roman numeral to read. If it says, for example, 'the first on the right', look on the inscription to your right (on the large stone pillars) and read the first numeral. Once you have the numeral, use the metal post to smash the indicated slab on the floor."</small>
+
+**Dual Symbol Translation System**:
+
+```
+SYMBOL SET 1: Window Pattern Recognition (Visual Matching)
+Source Material: Grail diary page showing stained glass design
+Application Method: Navigate library rooms displaying multiple stained glass windows
+Translation Process:
+- EXAMINE grail diary → observe specific window pattern (cross/geometric arrangement)
+- Walk through each room with stained glass windows
+- COMPARE each window's design to diary illustration
+- IDENTIFY exact match (only one window matches diary diagram exactly)
+
+SYMBOL SET 2: Latin Quotation → Roman Numeral Mapping (Linguistic-to-Positional)
+Source Material: Grail diary Latin quotation mentioning ordinal position + direction
+Application Method: Stone pillars surrounding matched window bear engraved roman numerals
+Translation Process:
+- READ quotation for directional instruction ("first on the right", "third from left")
+- Example: "the first on the right" → count roman numerals RIGHT of window, select FIRST
+- Extract numeral value (I, II, III, IV, etc.)
+- NUMERAL indicates which FLOOR SLAB to destroy
+
+ACTION OUTPUT: Smashing Sequence
+- Acquire metal post from library cordon posts (earlier collection)
+- USE metal post on floor slab corresponding to extracted roman numeral
+- Floor collapses → escape route opens below, avoiding gunman
+```
+
+**Why It's Symbol Code Translation**: Two distinct symbol systems must be TRANSLATED:
+1. **Visual Pattern Translation**: Window diagram → physical window identification through shape/color matching
+2. **Linguistic-to-Positional Translation**: Latin ordinal phrase → roman numeral selection → floor slab targeting
+
+Both require examining a static information source (diary) and translating its encoded information into game-world actions across different symbolic domains. Order sensitivity confirmed—must find window pattern BEFORE reading quotation makes sense; must extract numeral before smashing floor.
+
+**Distinction from Observation Replay**: No NPC demonstrates the sequence. Player DISCOVERES symbols through environmental examination, then INTERPRETS them mechanically (diagram→window match, phrase→numeral→floor position). The puzzle tests SYMBOL RECOGNITION + TRANSLATION skill, not memory of observed actions.
+
+**Distinction from Pattern Learning**: Single application only—no repeated framework across multiple similar puzzles. Pure "find environmental code and decode it" rather than "learn rule once, apply exhaustively."
+
+<small>Cited from: walkthrough-king.txt:83-100</small>
+
+---
+
+### Indiana Jones and the Last Crusade: 3-Statue Combination Lock (INDY1)
+
+**Problem**: In lower catacombs beneath Venice library, three rotating statues stand before a stone door. Each statue displays multiple plaque options showing different symbols. The grail diary contains visual clues indicating which combination is "good" (correct) versus which is "bad" (deadly trap). Player must match diagram to physical interface without error—wrong selection triggers fatal consequence.
+
+<small>Source: walkthrough-king.txt, lines 129-133 — "Look in the grail diary again for more clues - there is one combination which is good, and one which is very bad. Push the middle plaque until it shows the good image. Now push the right plaque until it is correct, and finally the left one."</small>
+
+**Symbol Translation Mechanic**:
+
+```
+SYMBOL SOURCE: Grail Diary Illustrations
+- One diagram showing CORRECT symbol combination (survival/escape imagery)
+- One diagram showing INCORRECT combination (death/danger imagery)
+- Player must memorize which visual pattern = safe passage
+
+PHYSICAL INTERFACE: Three rotating statues with selectable plaques
+- LEFT statue (statue 1): Multiple symbol options rotatable via plaque push
+- MIDDLE statue (statue 2): Multiple symbol options  
+- RIGHT statue (statue 3): Multiple symbol options
+
+TRANSLATION CHAIN:
+Step 1 → Examine grail diary, identify GOOD combination symbol pattern visually
+        - Note specific symbols/icons appearing on each of three positions
+        - Critical: Must distinguish from BAD combination shown nearby
+        
+Step 2 → Approach LEFT statue, push plaque until displays matching symbol from diary's left position
+        - Symbol recognition required: "this carved design = that diagram element"
+
+Step 3 → Move to MIDDLE statue per walkthrough instruction sequence  
+        - Push plaque until displays matching center-position symbol
+
+Step 4 → Complete RIGHT statue with final symbol from combination diagram
+        - All three statues now display GOOD combination pattern simultaneously
+
+Step 5 → Door opens safely (no trap triggered; player can proceed)
+```
+
+**Why It's Symbol Code Translation**: Visual symbols on static artifact (grail diary page) must be matched to interactive interface elements (rotating statue plaques) through shape/icon recognition. Order explicitly matters—walkthrough specifies sequence: middle, right, left. The translational layer exists because player observes symbols in 2D diagram format then applies to 3D mechanical interface where symbols appear as carved relief sculptures rather than flat drawings.
+
+**Critical Distinction from King's Quest VII Tomb Lock**: KQVII tomb uses environmental decorations (wall carvings) as clue source; this puzzle uses explicit INVENTORY ITEM examination (diary). Both are Symbol Code Translation but differ in information medium: KQVII = passive environment scanning; INDY1 = active item inspection with multiple diagrams requiring discriminative visual matching.
+
+**Deadly Consequence Mechanic**: Unlike most SCT puzzles where wrong combinations simply fail, this puzzle explicitly documents "one combination is very bad"—implying permanent consequence (likely death/game over) for selecting wrong pattern. This adds stakes to symbol recognition accuracy beyond simple lockout feedback.
+
+<small>Cited from: walkthrough-king.txt:129-133</small>
+
+---
+
+### Indiana Jones: Fate of Atlantis - Sunstone/Moonstone Alignment with Plato's Lost Dialogue (INDY2)
+
+**Setup**: After obtaining the Sunstone (varies by path) and Moonstone (Crete excavation using surveyor's instrument), Indy must align these artifacts according to instructions in Plato's Lost Dialogue. The 3rd page contains a diagram showing which symbol positions correspond with different celestial features (horns of statues).
+
+<small>Source: walkthroughking_ashley_walkthrough.html, lines 86-87 — "From the Lost Dialogue (3rd page) align the correct symbol with the horns and click on the peg."</small>
+
+**Solution Chain**:
+1. Open Plato's Lost Dialogue in inventory
+2. Navigate to page 3 showing celestial alignment diagram
+3. Identify target symbols on Sunstone/Moonstone that match diagram positions
+4. At dig site: Insert Wooden Peg into mural hole, place Sunstone on peg
+5. Look at the stone/alignment → dialogue prompts for correct position
+6. Rotate to match "horns" symbol as indicated in Lost Diagram page 3
+7. Repeat process at Crete with both stones on stone dial
+
+<small>Source: walkthroughking_ashley_walkthrough.html, line 87 — "Go back and put both stones on the stone dial where you arrived at Crete, and follow the next set of directions in the Lost Dialogue."</small>
+
+**Why It's Symbol Code Translation**: 
+- Visual symbols on artifacts (Sunstone/Moonstone geometric markings)
+- External reference source (Lost Dialogue page 3 diagram) provides translation key
+- Order/matching matters—correct symbol must align with specific feature ("horns")
+- Same framework applies to multiple stone/alignment pairs across different locations
+
+**Distinction from Pattern Learning**: Player isn't learning an abstract rule system to apply exhaustively. Instead, they're translating specific visual codes from one medium (book diagram) to another (physical artifact positioning). The Lost Dialogue is the cipher; the stones are the encoded messages.
+
+<small>Source: gamefaqs_darth_maul_walkthrough.html, lines 904-910 — "First, open the Lost Dialogue of Plato and look at page 3...align the correct symbol with the horns"</small>
+
+---
+
+### King's Quest VII: Tomb Combination Lock - Skull, Bat, Spider (KQVII)
+
+**Setup**: After obtaining and blowing gravedigger's horn in graveyard area, a hidden hole opens in the ground leading to underground tomb entrance. The tomb door features a large combination lock with three symbol selections.
+
+<small>Source: walkthroughking_kq7.html:86</small>
+
+**Symbol Source Discovery (Distributed Environmental Clues)**:
+- Graveyard decorations, wall carvings, or environmental art establish the sequence through visual examination  
+- Specific hint location varies; player must observe graveyard area thoroughly to notice symbol hierarchy/pattern
+
+**Solution Chain**:
+```
+1. Enter tomb via revealed hole after horn use
+2. Approach large combination lock door
+3. Observe three available symbols: skull, bat, spider
+4. Press in exact sequence: SKULL → BAT → SPIDER (that specific order)
+5. Lock mechanism opens, door unlocks
+
+6. Walk through door into underground chamber with Troll King coffin
+7. Continue puzzle chain (separate from this symbol lock puzzle)
+```
+
+**Why It's Symbol Code Translation**:
+- **Visual Symbols as Input**: Three distinct iconographic symbols (skull, bat, spider) presented on interface
+- **Order-Sensitive Sequence**: Not just "press all three"—specific arrangement required for success  
+- **Environmental Clue Dependency**: Correct sequence must be deduced from earlier visual examination; not obvious from lock itself
+
+**Distinction from Observation Replay**: While there IS a single sequence to memorize and replay, the key differentiator is that player must first DISCOVER the code through environmental investigation—not just WATCH someone use it once. The clue presentation (graveyard decoration pattern) REQUIRES symbol interpretation, not just visual note-taking of an action performed by NPC/Game character.
+
+**Distinction from Pattern Learning**: Single application only—no repeated framework applied across multiple doors. This is pure "find the code through environmental reading" puzzle rather than "learn system once, apply exhaustively."
+
+---
+
+### Gabriel Knight 1: Rada Drum Translation (GK1)
+
+**Setup**: In Jackson Square outside the Police Station, an African drummer sits beating complex rhythms on a large drum. After obtaining the Rada Book from Tulane University (requested by Grace at bookshop), Gabriel must decode the hidden message embedded within 36 drum symbols to discover the location and timing of the Voodoo Conclave.
+
+<small>Source: justadventure_walkthrough.html, lines 1017-1040 — Rada Book has three pages of symbol translations; decoder must scan both drum-symbol-lines</small>
+
+```
+SYMBOL DISCOVERY PHASE (Rada Drumbeat Observation):
+Step A → Approach drummer in Jackson Square (ignores Gabriel initially)
+         <small>Source: lines 1018-1019 — "Approach the drummer and try to talk to him – but he ignores Gabriel"</small>
+
+Step B → Use Rada Book on drummer from inventory
+         → Drummer continues playing, reveals two horizontal lines of drum symbols
+         → Each line contains 18 symbols (36 total)
+
+Step C → Screen splits into TWO PANELS:
+         LEFT PANEL: Three accessible pages of Rada Book dictionary
+                    - Each page shows symbol groups with English translations
+                    - Navigation via curved arrows (clockwise/anticlockwise)
+         RIGHT PANEL: Two lines of drum symbols (the encoded message)
+
+SYMBOL TRANSLATION PROCESS (Multi-Page Dictionary Lookup):
+Step D → PAGE 1 SCANNING PROCEDURE:
+         - Scan down symbol list on Page 1 (left panel)
+         - Identify matching symbol GROUP in drumbeat line (right panel)
+         - CRITICAL: Symbols appear in specific ORDER within the 36-symbol camouflage
+
+         MATCH FOUND at Line 2, Positions 2-5:
+         Drum symbols → [SYMBOL A][SYMBOL B][SYMBOL C][SYMBOL D]
+         Translation on Page 1 Row 2 → "TONIGHT"
+         <small>Source: lines 1030-1031 — "This string of symbols is identical to the second row down on page-1...translation is 'Tonight'"</small>
+
+Step E → Turn to PAGE 2 via arrow navigation
+
+         MATCH FOUND at Bottom Line, Positions 11-15:
+         Drum symbols → 5-symbol sequence (positions from left)
+         Translation on Page 2 Row 6 → "SWAMP"
+         <small>Source: lines 1034-1035 — "Bottom Right hand side...Five symbols, 11th through 15th yielding 'SWAMP'"</small>
+
+Step F → Turn to PAGE 3 via arrow navigation
+
+         MATCH FOUND at Top Line, Positions 7-12:
+         Drum symbols → 6-symbol sequence
+         Translation on Page 3 Bottom Row → "CALL CONCLAVE"
+         <small>Source: lines 1039-1040 — "Top Right hand side...Five symbols, 7th through 12th yielding 'CALL CONCLAVE'"</small>
+
+FINAL MESSAGE ASSEMBLY:
+Three words discovered across three pages → "TONIGHT SWAMP CALL CONCLAVE"
+Complete translation reveals conclave timing (tonight) + location (swamp)
+
+WHY IT'S SYMBOL CODE TRANSLATION:
+1. VISUAL SYMBOL MATCHING: Player must recognize that symbol shapes on drumbeat = same symbols in book dictionary
+2. MULTI-PAGE NAVIGATION: Translation requires navigating across three separate pages of reference material
+3. ORDER WITHIN CAMOUFLAGE: Only THREE WORDS hidden among 36 meaningless symbols—player must find positionally-correct sequences
+4. DICTIONARY-LIKE TRANSLATION: Not mechanical pattern (like engraved rods), but linguistic translation via symbol→word mapping
+5. NO SINGLE SEQUENCE TO MEMORIZE: Unlike Observation Replay, player isn't memorizing order—they're translating using reference dictionary
+
+DISTINCTION FROM PATTERN LEARNING:
+- PL would be: Learn rule "symbol A = word X", apply to NEW instances
+- SCT here is: Use book as CIPHER KEY to decode this SPECIFIC message (no framework reuse)
+- Player doesn't learn a repeatable system—just decodes once using provided dictionary
+
+COMPARISON TO STANDARD ENGRAVED ROD SYSTEM:
+Similarities: Both use visual symbol matching + order sensitivity
+Differences: 
+  - Rods use shape/color for direct mechanical translation (shape on rod → shape on button)
+  - Rada Drums use abstract symbols for LINGUISTIC translation (symbol pattern → English word)
+  - Rada requires multi-page navigation; rods are single-examination
+```
+
+<small>Cited from: justadventure_walkthrough.html:1017-1040</small>
+
+---
+
+### King's Quest VIII: Fire Dwarf Temple Door Pressure Plates (KQVIII)
+
+**Setup**: After reaching the Barren Region and defeating the Basilisk, player climbs into the temple where they discover a dead Fire Dwarf holding a granite key. The main chamber has four pressure plates around a central sarcophagus, each marked with a different symbol (crescent, triangle, circle, square). The wall displays repeating sequences of these four symbols in various arrangements.
+
+<small>Source: gamefaqs_gkisom_kq8_recovered.txt, lines 1096-1103</small>
+
+**Solution Chain**:
+```
+1. Click dead Fire Dwarf → obtain granite key (for later use)
+2. Examine wall symbols → player observes four repeating symbols arranged in sequence on walls: crescent, triangle, circle, square
+3. Examine sarcophagus → four pressure plates surround it, each marked with one of the four symbols
+4. Walk Connor against pressure plates in exact order matching wall decoration:
+   - First: Crescent plate
+   - Second: Triangle plate  
+   - Third: Circle plate
+   - Fourth: Square plate
+5. Door behind sarcophagus opens after all four plates pressed in correct sequence
+6. Take the long-sword from opened sarcophagus
+```
+
+**Why It's Symbol Code Translation**:
+- **Visual Symbols as Input**: Four distinct geometric/symbolic shapes (crescent, triangle, circle, square) displayed on both walls and pressure plates
+- **Order-Sensitive Sequence**: Not just "press all four"—specific arrangement must match wall decoration sequence
+- **Environmental Clue Dependency**: Correct code must be extracted from examining wall patterns; sarcophagus alone provides no indication of correct order
+- **Translation Layer**: Symbols observed passively on walls → must be actively translated into physical plate-pressing actions
+
+**Distinction from Observation Replay**: Player is not watching an NPC demonstrate the sequence. Instead, they're interpreting static environmental decoration as a code to be decoded and applied mechanically. The symbols-as-decoration require player inference ("these wall patterns represent the unlock sequence") rather than simple visual memorization of demonstrated actions.
+
+**Relation to Standard Pattern Learning**: While KQVIII uses this SAME system for the Fire Dwarf lair door (lines 1131-1133: "Click the panels in the same order as at the temple sarcophagus"), THIS specific puzzle is single-application Symbol Code Translation. The broader framework across both doors would be Pattern Learning—the first temple teaches the symbol→plate mechanic, which then transfers to the lair door context.
+
+---
+
+### Broken Sword: Shadow of the Templars - Chessboard Chamber (Chapter 5, Spain)
+
+**Problem**: Access sealed chamber in Spanish temple requires arranging chess pieces according to Bible design pattern discovered earlier. Visual symbols on manuscript must be translated to physical chess piece positions.
+
+<small>Source: broken-sword-1/4_agh_peter_christiansen_walkthrough.html, lines 448-454</small>
+<small>Source: broken-sword-1/1_walkthroughking_broken_sword.html, line 176</small>
+
+**Solution Chain**:
+```
+PHASE 1 - Symbol Discovery (Bible Examination):
+→ Find annotated Bible at prior location (temple or library area)
+→ EXAMINE Bible pages → reveal diagram showing chess pattern
+→ Pattern shows specific piece arrangement needed: bishop, nothing, knight, king in center column
+
+INTERPRETATION LAYER:
+→ Diagram uses symbolic representation of chess pieces (iconographic drawings)
+→ Must translate 2D symbol notation into 3D physical piece types
+→ Center column emphasis indicates which row on actual chessboard matters most
+
+PHASE 2 - Application at Chessboard Interface:
+→ Enter sealed chamber with large chessboard display/lock mechanism
+→ Available chess pieces include all standard types (king, queen, bishops, knights, rooks, pawns)
+→ Arrange pieces according to Bible diagram pattern:
+   - Row/Column 1 center position: BISHOP piece
+   - Row/Column 2 center position: EMPTY (no piece placed)  
+   - Row/Column 3 center position: KNIGHT piece
+   - Row/Column 4 center position: KING piece
+
+PHASE 3 - Validation and Access:
+→ After correct arrangement → chessboard mechanism activates
+→ Sealed chamber door unlocks automatically
+→ Player can proceed to next exploration area
+```
+
+**Why It's Symbol Code Translation**: Visual symbols on Bible manuscript (2D diagrammatic representation) must be translated to interface actions (3D chess piece placement). The translation layer maps SYMBOL A (bishop drawing) → ACTION B (physically place bishop piece at specified position). Order sensitivity confirmed—diagram positions map to specific board coordinates. Single application like KQVII tomb lock rather than exhaustive system framework, but same core mechanic: observe symbols in one medium, apply equivalency rules to interactive interface, order matters for validation.
+
+**Distinction from Observation Replay**: Player doesn't watch NPC demonstrate sequence once and memorize it. Instead, player INTERPRETS static environmental decoration (Bible diagram) as code requiring active translation into mechanical action. The puzzle requires symbol recognition AND coordinate mapping, not just visual memory of performed actions.
+
+**Distinction from Standard Pattern Learning**: Only ONE application instance, no repeated framework across multiple doors or locations. This is pure "find the code through environmental reading" puzzle with symbol interface as output medium, rather than "learn system once, apply exhaustively" structure.
+
+---
+
+### Broken Sword II: The Smoking Mirror - Pyramid Wheel Room Pictogram Puzzle (Chapter 6)
+
+**Problem**: Nico must unlock sealed chamber door using four rotating wheels displaying Mayan pictograms. Ten small tiles each encode a target two-symbol pairing the wheels must display; pressing them validates correct wheel configuration. Four additional "master" tiles reference which TWO-of-TEN-tiles must be activated together, requiring compound validation across layers.
+
+<small>Source: 4_kasagaming_walkthrough.html, lines 426-430 — "Notice the pictograms on the great Mayan machine and on the tiles. If you try to move the tiles, they won't budge."</small>
+
+```
+PHASE 1 - SYMBOL DISCOVERY (Machine Interface Examination):
+→ Enter wheel room, examine four large rotating wheels
+  - Each wheel displays multiple Mayan pictograms (eagle, jaguar, serpent, etc.)
+  - WHEELS rotate individually using standard EXAMINE/CLICK actions
+  
+→ Examine set of 10 medium tiles on floor/wall:
+  - Each tile shows two pictogram symbols in specific arrangement
+  - Tiles represent TARGET STATES for wheel configuration
+  
+→ Examine 4 small master tiles below statue:
+  - Each shows reference to TWO medium-tiles (tile numbers or positions)
+  - Represents COMPOUND VALIDATION requirement
+  
+INTERPRETATION LAYER:
+→ Visual symbol recognition required: identify pictograms on wheels and tiles
+→ Coordination mapping: wheel position + target tile alignment
+→ Tile A showing "eagle above jaguar" → rotate wheels to show eagle+jaguar in that spatial arrangement
+
+PHASE 2 - TRANSLATION APPLICATION (Medium Tiles, Exhaustive Set):
+For each medium tile in set of 10:
+
+Step 1 → Examine tile → observe encoded two-symbol pictogram pair  
+         <small>Source: kasagaming_walkthrough, line 427 — "Each tile from the set of ten has a symbol on it made from two symbols on the machine"</small>
+         
+Example: Tile #3 shows [SERPENT icon positioned vertically above SKULL icon]
+
+Step 2 → Rotate wheels to match exact pictogram positions shown on tile  
+         - Wheel A rotated to display SERPENT at top position
+         - Wheel B rotated to display SKULL at bottom position
+         - Spatial arrangement matches tile layout (above/below or left/right orientation matters)
+
+Step 3 → Press the tile → ACCEPTED when wheel pictograms tile's encoded pattern
+
+
+REPEAT for all 10 medium tiles:
+→ Each presents different pictogram pair requirement
+→ Same translation mechanic applies: READ symbols, ADJUST wheels, VALIDATE via press
+
+PHASE 3 - COMPOUND VALIDATION (Master Tiles):
+Step A → Examine master tile #1  
+         <small>Source: kasagaming_walkthrough, line 429 — "Each tile below the Mayan statue is made from two tiles from the set of ten"</small>
+
+         Tile references Medium-Tile #3 AND Medium-Tile #7
+
+Step B → Verify both referenced medium-tiles were activated earlier ✓
+         - If not → player must backtrack and complete prerequisite tiles first
+
+Step C → Press master tile #1 → ACCEPTED when both dependencies satisfied
+
+REPEAT for all 4 master tiles using same compound dependency rule.
+
+
+PHASE 4 - FINAL ACCESS:
+→ All 4 master tiles pressed inward sequentially  
+→ Secret chamber door unlocks automatically
+→ Player proceeds to pyramid exit sequence
+```
+
+**Why It's Symbol Code Translation**: Visual pictograms on static medium tiles encode target wheel configurations. Player translates symbolic representation (tile shows "serpent above skull") → mechanical action (rotate wheels to match that exact pictogram pairing). Order/space matters: tile layout encodes position relationship, not just symbol presence. Multi-layer dependency system where master-tiles reference medium-tile indices, requiring player to track which tiles were already activated.
+
+**Distinction from Pattern Learning**: While similar in "learn framework once, apply exhaustively," the core distinction is SYMBOL RECOGNITION OVERHEAD. Pattern Learning uses abstract rules (insult type A → retort type B). This puzzle adds explicit VISUAL MAPPING: identify that iconographic shape on tile = same pictogram on wheel surface. Translation layer exists because symbols must be recognized across TWO DOMAINS (tile art → wheel display) before action is possible.
+
+**Distinction from Observation Replay**: No NPC demonstration sequence to memorize. Symbols are static environmental decoration requiring active interpretation and translation, not passive observation for timing windows.
+
+---
+
+## Related Types Summary
+
+| Type | Similarity | Critical Distinction |
+|------|------------|---------------------|
+| Pattern Learning / Knowledge Transfer | Both use "learn once, apply exhaustively" framework | PL shares identical mechanic rules across domains; SCT adds symbol recognition layer requiring visual translation between artifact and interface |
+| Observation Replay | Both require careful sequence execution | OR memorizes NPC action pattern through passive watching; SCT interprets static environmental symbols through active examination |
+| Multi-Faceted Plan | Both can involve multiple items/requirements collected across exploration | MFP synthesizes independent components (item A + item B + item C → final solution); SCT exhaustively applies ONE SYSTEM across multiple instances where each instance is a variation of same rule set |
+
+
+| The Dig Engraved Rods | Same extended framework structure, multiple application instances | TD uses colored shapes; BS2 uses pictograms. Both map artifact symbols→panel buttons through color/shape recognition + order sensitivity. Core mechanic identical despite different visual language. |

src/puzzles/timed-consequence.md

@@ -0,0 +1,522 @@
+# Timed Consequence Puzzle
+
+## Mechanic Definition
+
+Urgency is conveyed through narrative consequence rather than mechanical time limits. The player learns that failure will result in permanent story change, but there's no visible countdown, progress bar, or explicit mechanical deadline. The pressure is diegetic—existing within the story world, not imposed by the game interface.
+
+## Information Architecture
+
+**Conveyance Method**: Threat of consequence through dialogue/narrative
+- NPCs explicitly state what will happen if player doesn't act
+- The consequence is always permanent and story-altering
+- No UI element tracks the deadline—the player must infer urgency from narrative
+
+**Player Action Pattern**:
+1. Learn threat through dialogue/story event
+2. Understand what the consequence is (permanent story change)
+3. Determine what actions prevent the consequence
+4. Execute actions with appropriate urgency
+5. If successful, consequence avoided; if not, permanent change occurs
+
+**Core Mechanic**: The puzzle is about managing urgency without visible metrics. The player must internalize the threat and act accordingly.
+
+## Design Rationale
+
+- Maintains immersion—no UI elements break narrative
+- Creates emotional stakes—the threat of permanent loss matters more than "game over"
+- Rewards urgency without stress—players feel pressure without countdown anxiety
+- Allows variable pacing—skilled/experienced players can take more time
+
+## Why It's Effective
+
+The tension is narrative rather than mechanical. Failing doesn't mean "game over and restart"—it means the story changes permanently. This creates real stakes without punishing exploration.
+
+## Mechanic Variations
+
+| Variation | Urgency Signal | Consequence Type |
+|-----------|---------------|------------------|
+| Dialogue-stated | Character says "you have limited time" | Permanent transformation/death |
+| Environmental | World visibly changes (emptying city, rising fire) | NPCs become unavailable |
+| Progressive | Character relationships degrade over time | Missing story content |
+| Celestial | Described event (alignment, eclipse) approaches | One-time opportunity lost |
+
+## Generic Example Structure
+
+**Information Flow**:
+- Character: "You have until [event] to [action]. After that, [consequence]."
+- Player understands consequence: Permanent story change, not restart
+- Player determines required actions: What needs to be done before event
+- Player acts with urgency but can still explore
+- If completed before event: Normal continuation
+- If not: [Consequence] occurs—game continues but fundamentally altered
+
+**The puzzle**: Internalizing urgency without visible metrics and acting accordingly.
+
+## Adventure Game Implementation
+
+Limited actions become urgent:
+- TALK to NPCs quickly—some become unavailable after consequence
+- WALK between locations—with purpose, not exploration
+- The puzzle isn't about speed, it's about priority
+
+This puzzle tests: "Can I internalize narrative urgency and act with appropriate priority without mechanical feedback?"
+
+---
+
+## Game Examples
+
+### Beneath a Steel Sky: Eyeball Guardian Timing Puzzle (BAS)
+
+**Problem**: In LINC-Space security zones, Eyeball guardians patrol virtual corridors. Player must navigate past them to retrieve critical items (TUNING FORK, DIVINE WRATH program) while managing 15-20 second blind duration windows before reactivation.
+
+<small>Source: 5_steamah_walkthrough.html, lines 521-523 — "'Blind' the first EYEBALL. The idea is to get the TUNING FORK before the first EYEBALL reactivates in about 15-20 seconds... This eyeball reactivates only within a few seconds, so be quick!"</small>
+
+<small>Source: 1_preterhuman_mitch_shaw_walkthrough.html, lines 305-315 — "Use the BLIND program on the EYE. Go NORTH again. Get the TUNING FORK if the EYE is still blinded (white)"</small>
+
+**Consequence Structure**:
+```
+THREAT: Being trapped/locked out by reactivated eyeballs
+PERMANENTITY: Must disconnect and re-enter LINC-Space, losing progress
+NO VISIBLE TIMER: Player must estimate from visual feedback (eyeball color: white=blinded vs colored=active)
+
+PHASE 1 - BLIND FIRST EYEBALL (Timer ~15-20s):
+→ Use BLIND command → eyeball turns WHITE (inactive state)
+→ ⏱️ Invisible timer starts NOW
+→ Move to second room before reactivation
+
+PHASE 2 - BLIND SECOND EYEBALL (Timer "few seconds"):  
+→ Second eyeball reactivates much faster ("within a few seconds")
+→ Use BLIND immediately → white state achieved
+→ QUICKLY enter thick plasma exit beside it
+
+PHASE 3 - RACE TO TUNING FORK:
+→ Exit north (STOP before CRUSADER room—don't engage yet)
+→ Go right into side corridor
+→ GRAB TUNING FORK from floor
+→ ⏱️ If first eyeball reactivates during this phase = trapped
+
+PHASE 4 - SAFE RESET POINT:
+→ Return to hub with WELL in center
+→ Use PLAYBACK command on WELL (resets eyeball states)
+→ DISCONNECT safely to main terminal
+
+FAILURE STATE: If timer expires before Phase 4 complete
+→ Eyeballs reactivate (return to colored state)
+→ Player locked into section until disconnect/reconnect
+
+---
+
+### Broken Sword: Shadow of the Templars - Khan Cliff Escape (Chapter 4)
+
+**Problem**: Final confrontation with Khan creates narrative urgency—George must execute precise escape sequence at cliff edge. No visible timer but death occurs if action order deviates from required pattern (buzzer then immediate jump).
+
+<small>Source: broken-sword-1/4_agh_peter_christiansen_walkthrough.html, lines 420-427</small>
+<small>Source: broken-sword-1/1_walkthroughking_broken_sword.html, lines 178-179</small>
+
+**Consequence Structure**:
+```
+NARRATIVE URGENCY (No Mechanical Timer):
+→ Scene establishes Khan confrontation as life-or-death scenario
+→ No countdown visible, no progress bar tracking urgency
+→ Threat conveyed entirely through NARRATIVE context: failed actions = character death
+
+ESCAPE SEQUENCE REQUIREMENT:
+Step 1 → Approach cliff edge with Khan pursuing behind
+         - Cutscene or dialogue establishes critical moment
+         
+Step 2 → Press buzzer at exact location (bridge/escape mechanism trigger)
+         - Activates bridge withdrawal or rope lowering mechanism
+         
+Step 3 → JUMP OFF CLIFF Immediately after buzzer activation
+         - Cannot pause, explore, or examine environment
+         - Death state triggers if delay exceeds narrow window
+
+FAILURE STATE: Sequence deviation results in game over
+→ Jump before pressing buzzer = fall to death (no rescue mechanism active)
+→ Press buzzer then delay too long = Khan catches player / bridge collapses / narrative consequence triggers restart
+```
+
+**Why It's Timed Consequence**: Urgency exists entirely through NARRATIVE stakes (Khan pursuing, life-or-death scene establishment), not mechanical timer. Player internalizes threat from story context—cutscene language, dialogue, positioning all indicate "act now or die." No HUD element tracks the deadline; urgency is DIEGETIC within story world. The puzzle tests ability to prioritize correctly: player must recognize that immediate action required rather than exploration/interaction. This differs from Observation Replay's precise timing window (where exact button press moment matters for success) because TC focuses on ACTION SEQUENCE ORDER with narrative threat, not frame-perfect execution skill.
+
+---
+
+### Legend of Kyrandia: Malcolm Knife Throw-Back (LK1)
+
+**Problem**: At the entrance to Serpent's Grotto, the antagonist Malcolm appears and throws a knife at Brandon. The player must click to throw the knife back BEFORE it hits Brandon. This is a critical first-time-only encounter with immediate permanent consequence—failure results in death and game over. Any other action (saving, running, dialogue) triggers Malcolm throwing another knife that cannot be missed.
+
+<small>Source: classicgamesparadise_walkthrough.html, lines 107-108 — "When you try to enter, Malcolm will show up to taunt Brandon. When he throws the knife at Brandon, quickly click on it while it is stuck in the tree to throw it back. If you try to run, Malcolm will throw another and won't miss this time."</small>
+
+<small>Source: bonny_ploeg_walkthrough.html, lines 45-46 — "Enter the grotto: Malcolm will come out. As soon as you can, throw the knife back at him: anything else, even saving the game, is lethal." + line 88 — "Getting turned to stone (or in the floppy version: knifed) by Malcolm at the serpent grotto" listed as death scenario</small>
+
+```
+NARRATIVE URGENCY WITHOUT MECHANICAL TIMER:
+
+THREAT ESTABLISHMENT:
+→ Player attempts to enter Serpent's Grotto after sealing ice with flute
+→ Cutscene/dialogue sequence establishes confrontation
+→ MALCOLM THROWS KNIFE at Brandon (animated projectile)
+→ CRITICAL MOMENT: Knife is STUCK IN TREE near Brandon (not yet lethal)
+
+TIME WINDOW:
+- No visible countdown or progress bar
+- Deadline implied: "click knife before it completes trajectory"
+- Threat conveyed through cutscene tension, not UI element
+
+
+REQUIRED ACTION SEQUENCE:
+
+Step 1 → Malcolm throws knife; animation plays showing projectile
+         - Player cannot interact during throw animation
+         
+Step 2 → Knife lands STUCK IN TREE (briefly accessible state)
+         - CRITICAL: Must click on stuck knife IMMEDIATELY
+         - Pre-typing command won't work—must wait for exact moment
+
+Step 3 → Click/USE on knife while it's stuck (before game processes impact)
+         - Brandon catches and throws knife back at Malcolm
+         - Cutscene: Malcolm stunned, flees, seals grotto entrance with ice
+
+FAILURE STATES:
+
+A. RUN AWAY: Trigger different animation—Malcolm throws second knife
+   → Second projectile cannot be caught/deflected
+   → Direct hit = instant death/game over
+   
+B. SAVE GAME during initial throw window:
+   → Saving triggers "too slow" failure state  
+   → Even the act of saving counts as "wrong action"
+   → Malcolm's dialogue changes; second knife throws
+
+C. WRONG DIALOGUE/INTERACTION:
+   → Any command other than immediate knife-click fails
+   → Same outcome: lethal follow-up attack
+
+
+WHY IT'S TIMED CONSEQUENCE (Not Observation Replay):
+
+NARRATIVE URGENCY VS MECHANICAL PRECISION:
+This puzzle establishes urgency through STORY CONTEXT—Malcolm as antagonist, confrontation scene, life-or-death stakes—rather than requiring frame-perfect input skill. The "timing window" exists not because animation frames demand exact timing, but because the NARRATIVE establishes Malcolm's attack as IMMEDIATE THREAT that demands immediate response.
+
+PERMANENT CONSEQUENCE:
+Failure = DEATH (permanent game state ending requiring restart/loading). Not just "puzzle failed, try different approach." The consequence is binary: survive or permanent death. This matches TC's emphasis on story-altering outcomes rather than mechanical retry loops.
+
+NO MEMORIZATION REQUIRED:
+Unlike Observation Replay where player must memorize sequence from one viewing then reproduce it later, here player acts DURING the event, not after witnessing it. No prior observation, no delayed reproduction—pure immediate response to narrative threat.
+
+
+"ANYTHING ELSE IS LETHAL" MECHANIC:
+The walkthrough explicitly states "even saving the game is lethal"—this emphasizes how NARRATIVE URGENCY overrides normal game systems. The save system (normally safe action) becomes DEATH TRIGGER because story context demands one specific immediate response. This is TC's hallmark: urgency that exists beyond UI/menus, embedded in diegetic world rules.
+```
+
+---
+
+### Legend of Kyrandia: Fireberry Maze Navigation (LK1)
+
+**Problem**: Inside Shadowrealm/Serpent's Grotto, the player navigates a dark maze with limited visibility. Fireberries provide illumination but burn out after exactly 3 screen transitions when carried. If caught in darkness without light source, shadow wraiths devour Brandon (game over). The puzzle requires careful resource management across an unmemorable labyrinth with death as consequence for miscalculation.
+
+<small>Source: classicgamesparadise_walkthrough.html, lines 173-175 — "Be careful though; you can only safely move between rooms 3 times before the Fireberries will burn out. If you are caught in a dark room without any light, the shadow wraiths will no longer be repelled by the light and will devour you. If you drop a fireberry on the ground, it won't burn out and will make that room safe to go back to if you run out of berries."</small>
+
+<small>Source: bonny_ploeg_walkthrough.html, lines 49-53 — "The caves are dark. If you are in a dark spot when you have no firebrities on you, you'll die... Fireberries will burn infinitely on the bush or on the floor, but you can only carry them for 3 screens."</small>
+
+```
+NARRATIVE URGENCY THROUGH RESOURCE DECAY:
+
+THREAT ESTABLISHMENT:
+→ Shadowrealm is naturally dark (perpetual shadow/dungeon aesthetic)
+→ Fireberries are required to repel shadow wraiths (established through early death or hint)
+→ CRITICAL MECHANIC: Berries burn out after 3 screen transitions when HELD IN INVENTORY
+
+DEATH CONSEQUENCE:
+- No timer visible, no progress bar tracking berry burn-rate
+- Player must internally count "1 screen... 2 screens... 3 screens remaining"
+- At zero burns: darkness activates → wraiths appear → instant death
+
+
+STRATEGY OPTIONS (Both Require Planning):
+
+OPTION A - Permanent Light Beacons:
+Step 1 → Pick up 4 fireberries at each bush
+Step 2 → Travel to new dark room, DROP ONE BERRY ON FLOOR before moving on
+           - Berry placed on floor burns INDEFINITELY (doesn't decay)
+           - Room becomes permanently safe for re-entry
+Step 3 → Continue with remaining berries; each room gets beacon
+Step 4 → If run out of portable berries → backtrack to any lit room (safe zone)
+
+OPTION B - Map-Assisted Save/Reload at Bushes:
+Step 1 → Create external paper map, number all fireberry bush locations
+Step 2 → Establish secondary save file at EACH bush position
+         - Label saves with location identifier from map
+         - Primary save = progression; secondary save = bush checkpoint
+Step 3 → When carrying berries into unknown section, use primary save only
+Step 4 → If berries expire before finding next bush: RELOAD to nearest bush save
+
+CRITICAL STRATEGY ELEMENTS:
+
+1. BERRY ECONOMY MANAGEMENT:
+   - Carrying = rapid decay (3 screens max)
+   - Dropped on floor = infinite burn time
+   - Each bush = finite resource pool, not renewable indefinitely
+   
+2. NAVIGATION WITHOUT MEMORY:
+   All rooms look identical (dark cave aesthetic, no unique visual markers). External mapping required because internal landmarks don't exist.
+
+3. DEATH CONSEQUENCE STRUCTURE:
+   Darkness death is PERMANENT (game over), not "lose current berries and respawn." Player must manage risk through strategic berry placement or save-file discipline.
+
+
+WHY IT'S TIMED CONSEQUENCE:
+
+RESOURCE-DECAY URGENCY VS MECHANICAL TIMER:
+No visible countdown exists. The "3 screens" burn rate is revealed through failed attempts or walkthrough knowledge. The urgency comes from INTERNAL COUNTING—player mentally tracks remaining screens before berry expiration. This creates NARRATIVE TENSION ("how far can I go before darkness claims me?") without HUD timer.
+
+STORY-EMBEDDED MECHANIC:
+The fireberry mechanic is THEMATICO—shadow realms require light; carried light burns through use; abandoned light becomes permanent sanctuary. These rules feel diegetic, not arbitrary "3 moves before reset" puzzle structure.
+
+PERMANENT CONSEQUENCE FOR MISMANAGEMENT:
+Death in darkness = complete game over, requiring reload to much earlier save point. This is TC's hallmark stakes—consequence is NARRATIVE FAILURE (Brandon consumed by shadows), not JUST mechanical setback (lose inventory and retry).
+
+
+DISTINCTION FROM PATTERNS/LOGISTICS PUZZLES:
+While inventory management involved (Cross-Realm Logistics element), the CORE PUZZLE MECHANIC is URGENCY MANAGEMENT. Not "where are items located" but "how long until items cease functioning." The temporal decay creates narrative urgency absent from pure logistics puzzles.
+
+```
+
+---
+
+### SpaceQuest III: Ortega Force Field Escape (SQ3)
+
+**Problem**: Roger reaches Ortega, a planet protected by an impenetrable force field beam maintained by a shield generator. After discovering the generator's location via telescope and acquiring items needed for escape, Roger must destroy the generator to disable the shielding—triggering an invisible countdown before the entire planet explodes. The player receives warning that time is limited but no visible timer displays remaining duration.
+
+<small>Source: gamefaqs-tricrokra-archive.html, lines 485-491 — "Once you continued a timer will start to run. A timer you don't see, but one that is pretty narrow."</small>
+
+<small>Source: the-spoiler-walkthrough.html, lines 126-128 — "'Throw detonator'. 'Climb down ladder'. The planet's going to explode!."</small>
+
+```
+THREAT STRUCTURE:
+
+URGENCY SIGNAL (Dialogue-based):
+Walkthrough explicitly states "Once you continued here a timer will start to run. A timer you don't see, but one that is pretty narrow."
+The threat consequence: "If you exceed the time you are dead." [game over]
+
+NO UI TIMER EXISTS:
+Player must infer remaining time from narrative cue alone ("planet's going to explode!") and internal urgency management
+
+
+PHASE 1 - PREPARATION (Before Timer Activates):
+
+STEP A - Wait for Scouting Party to Depart
+Prerequisite: Land on Ortega, wear thermoweave underwear (heat protection)
+Location: South → West → South (behind bridge structure)
+Action: Wait until armed men leave the area before proceeding
+Citation: the-spoiler-walkthrough.html, line 123 — "Walk behind the boulder and wait for the men to leave"
+
+
+STEP B - Discover Planet Location via Telescope
+Location: Scout observation post (same location as above)
+Action: LOOK in telescope → discover Pestulon coordinates
+Outcome: New destination added to ship navigation system
+Citation: gamefaqs-tricrokra-archive.html, line 489 — "Use the telescope, and you'll discover Pestulon"
+
+
+STEP C - Acquire Escape Tools
+Items collected at scout post (before heading north):
+- THERMAL DETONATOR (from box) → used to destroy generator
+- METAL POLE → required to pole vault across chasm after explosion
+
+Citation: gamefaqs-tricrokra-archive.html, lines 490-491 — "= Get a detonator from the box = Get the pole"
+
+
+PHASE 2 - TIMER ACTIVATION SEQUENCE:
+
+STEP A - Navigate to Shield Generator
+Path: Exit south post → East × 2 → North (outside generator) → North again → Downstairs → North → East
+Citation: gamefaqs-tricrokra-archive.html, lines 498-503 — Path sequence to reach generator interior
+
+
+STEP B - Climb Final Access Point  
+Command: CLIMB ladder at north end of generator room
+
+
+STEP C - DESTROY GENERATOR (TIMER BEGINS)
+Action: THROW detonator into large hole in floor
+Consequence Triggered: Force field deactivates; planet enters destruction sequence
+Invisible Countdown: Walkthrough notes "pretty narrow" time limit
+
+Citation: gamefaqs-tricrokra-archive.html, line 508 — "Throw the Detonator into the big hole"
+
+
+PHASE 3 - ESCAPE SEQUENCE (Race Against Invisible Timer):
+
+STEP A - Descend Generator Building  
+Command: CLIMB DOWN ladder immediately after detonation
+Citation: gamefaqs-tricrokra-archive.html, line 509 — "= Climb down"
+
+
+STEP B - Navigate Back to Ship (Fixed Exit Path)
+Navigation Sequence (MUST NOT DEVIATE):
+- West → South → South → West ×2 → North
+
+Critical Step at Chasm:
+Position: After second west direction, before final east
+Action: USE POLE to vault across ground crack formed by explosion
+Citation: gamefaqs-tricrokra-archive.html, line 468 — "USE POLE (you'll use your pole to jump over the crack)"
+
+
+STEP C - Reach Ship and Launch
+Final Moves: EAST → NORTH (center of screen) → Enter ship based on position
+Commands in Ship: SIT → LOOK COMPUTER → Select "1" (Engines) → "3" (Takeoff)
+
+Citation: gamefaqs-tricrokra-archive.html, lines 520-527 — Final escape sequence
+
+
+CONSEQUENCE STRUCTURE:
+
+IF TIMER EXPIRES BEFORE ESCAPE:
+Consequence: Game over (death by planetary explosion)
+No UI warning—player must infer remaining time from narrative urgency alone
+
+
+WHY IT'S TIMED CONSEQUENCE PUZZLE:
+
+NARRATIVE URGENCY WITHOUT MECHANICAL TIMER:
+Walkthrough explicitly states "A timer you don't see"—this is TC's defining trait. The player knows time matters but cannot quantify remaining duration without external knowledge (walkthrough) or careful observation of explosion animations (which may not be visible before game ends).
+
+NO SAVE/LOAD GAMEPLAY LOOPS ALLOWED:
+While player can theoretically save/reload, the design intends single-attempt execution after detonation. There's no "try again" safety net—player must prepare all items beforehand and know/remember escape route.
+
+CONSEQUENCE IS PERMANENT STORY CHANGE (Or Death):
+If player fails to escape in time, consequence is Roger Wilco dying—story ends. This is TC's hallmark: stakes are narrative (character death) rather than mechanical (lose points/item).
+
+
+KEY DISTINCTION FROM PREDATOR CHASE ESCAPE:
+Predator Chase has immediate pursuit mechanic with no timer UI but ACTIVE PURSUER. Player is being hunted by Arnold in real-time. Ortega escape has no visible pursuer—only environmental destruction sequence triggered by player's own action, requiring self-managed urgency without external threat presence.
+
+TIMED URGENCY VS FIXED ROUTE:
+The puzzle's difficulty emerges from knowing/remembering a specific multi-step path (West → South × 2 → West × 2 → North → East) under time pressure. Unlike standard navigation puzzles, deviation or hesitation risks explosion death. This combines memory management with urgency—TC's narrative tension applied to rote escape sequence.
+
+```
+
+---
+
+### Quest for Glory IV: Gypsy Rescue Window (QFG4)
+
+**Setup**: On days 4-5 of gameplay, the Burgomeister at the town office will announce that gypsies have been captured and accused of being werewolves, with Igor "missing." The player must investigate and rescue them before a specific deadline or the gypsies are executed/lost permanently.
+
+<small>Source: qfg4-gamefaqs-anonymous.txt lines 831-856 — "Day 4-5: Farmers found gypsy at Burgomeister's office... Gypsy accused of being werewolf, Igor 'missing'"</small>
+
+```
+URGENCY SIGNAL - NARRATIVE THREAT:
+Step 1 → Visit Burgomeister's office on Day 4+ (in-game calendar tracked by hotel nights)
+         Event triggers automatically if player has progressed足够 enough in valley exploration
+         
+Dialogue Conveyance:Burgomeister explains gypsies captured for "werewolf activities" near village farms.
+Igor the hunchback is "missing" and suspected of involvement.
+THREAT IMPLICIT: If gypsies are proven guilty or Igor not found, they face execution/expulsion from valley.
+
+NO MECHANICAL TIMER UI:Player has no countdown or explicit deadline displayed.
+Urgency must be inferred from narrative context: legal situations typically resolve quickly in medieval-settings.
+
+CONSEQUENCE OF INACTION:If player delays too long (approx. days 6-8 depending on playthrough):Gypsies may be executed, released prematurely without aid,
+OR the investigation opportunity closes entirely.
+Result: Cannot complete Gypsy-related quests including Fortune Teller readings OR Rusalka quest for Paladins
+
+REQUIRED ACTION SEQUENCE (Rescue Path):Step 1 → Search Igor's likely locations (NOT town, NOT Dr. Cranium's)
+         Clue: Igor works at cemetery during day
+
+Step 2 → Visit Cemetery after gypsy accusation event
+         Look for tipped tombstone or unusual markings near graves
+
+Step 3 → Investigate moaning sound coming from UNDER a disturbed grave
+         Tombstone has been pushed over, revealing hidden cavity underneath
+
+Step 4 → Class-specific tombstone lifting:
+          Fighter: Use strength to push/force tombstone aside directly
+          Thief: Use rope tied to nearby tree branch as pulley system to lift stone  
+          Wizard: Cast Fetch spell on tombstone to magically remove it
+         Result: Igor freed from underground hiding/detention spot
+
+Step 5 → Automatic consequence: Gypsies are released once Igor is found
+         Reasoning: Without Igor's alleged leadership, accusation collapses
+
+REWARD FOR SUCCESSFUL RESCUE:Gypsy camp becomes fully accessible for future interactions.
+Magda the Fortune Teller available for tarot readings (up to 4, providing Undead Amulet/Aura Spell).
+Critical information about Dark One's name "AVOOZL" eventually revealed through readings.
+
+PALADIN-SPECIFIC EXTENSION:Rescued gypsies provide quest hints for Rusalka lake spirit release.
+Magda can advise on "sacrifice needed" and guidance toward true redemption mechanics.
+
+WHY IT'S TIMED CONSEQUENCE PUZZLE:NARRATIVE URGENCY WITHOUT MECHANICAL DEADLINE:
+Player learns THREAT exists (gypsies face consequences) but NO COUNTDOWN DISPLAYS.
+Game continues normally if player ignores it—consequence only manifests as LOST OPPORTUNITY.
+
+PERMANENT STORY CHANGE:Puzzle opportunity closes after certain point (exact timing undocumented, varies by playthrough).
+Unlike "game over" puzzles, the game CONTINUES but specific content becomes UNACCESSIBLE.
+This is hallmark Timed Consequence: narrative urgency, player-managed priority, permanent consequence of delay.
+
+COMPARISON TO SPACEQUEST 4 EXPLOSION:SQ4 = mechanical death if fail (hard reset)
+QFG4 = missed questline content (soft lockout, game continues)
+Both share core TC trait: no visible timer, must infer urgency from narrative context.
+```
+
+<small>Cited from: qfg4-gamefaqs-anonymous.txt:831-856, qfg4-gamefaqs-sac.txt:2430-2447</small>
+
+---
+
+### Quest for Glory IV: Will-o'-Wisp Nighttime Capture (QFG4)
+
+**Setup**: To reveal the Sense Ritual location at the Squid Stone, player must capture Will-o'-Wisps. Wisps only appear at NIGHT and die if not released before DAYBREAK. This creates a strict time-window puzzle combining environmental timing with consequence management.
+
+<small>Source: qfg4-gamefaqs-sac.txt lines 1946-1952 — "Make sure to let them out before daybreak or else they'll expire"</small>
+
+```
+ENVIRONMENTAL URGENCY SIGNAL - Celestial Cycle:
+Step 1 → Travel to swamp edge area (west forest, near Dark One Cave entrance)
+         CRITICAL CONSTRAINT: Must visit during NIGHT game time only
+         
+NIGHTTIME DETECTION:Will-o'-Wisps visible as floating lights above dark water surface.
+During daytime: Wisps disappear entirely; cannot be captured or interacted with.
+
+CAPTURE MECHANIC:Step 2 → Ensure candy in inventory (purchased from General Store, town)
+         Item prerequisite for luring wisps
+
+Step 3 → Use CANDY on ground/water near visible wisp
+         Result: Wisps approach slowly, attracted by sweet smell
+
+Step 4 → Wait ~3-5 seconds until wisp enters capture range
+
+Step 5 → Use EMPTY FLASK on approaching wisp  
+Result: Wisp captured inside flask, added to inventory item "Flask of Will O' Wisps"
+
+TIMED CONSEQUENCE WINDOW - Daybreak Deadline:
+         URGENCY: Captured wisps are ALIVE organisms inside flask.
+         
+         THREAT: If daybreak occurs before releasing wisps back into environment,
+                 they DIE inside the flask permanently.
+                 
+         NO EXPLICIT WARNING: Game does not display countdown or "wisps dying soon" message.
+                  Player must track time by observing sun/moon position OR checking clock UI.
+
+RELEASE AND APPLICATION (Daytime):Step 6 → Travel to Squid Stone ritual marker location
+         
+Step 7 → Use Flask of Will O' Wisps on ritual stone BEFORE daybreak if captured at night end
+         Result: Wisp light reveals hidden Mad Monk's tomb entrance + Bone Ritual scroll location
+
+CONSEQUENCE STRUCTURE:If wisps die from daybreak before release:Flask becomes empty/useless.
+Must restart entire capture process (wait for next night cycle, repeat luring).
+No permanent game lockout, but creates REPLAY PENALTY and delays progression.
+
+WHY IT'S TIMED CONSEQUENCE PUZZLE:ENVIRONMENTAL URGENCY WITHOUT MECHANICAL TENSION:
+Player knows "before daybreak" is deadline but no explicit countdown.
+Natural celestial cycle serves as timer (day/night transition).
+
+SOFT CONSEQUENCE (Not Death/Lockout):Wisps dying = inconvenience and delay, not permanent story change or game over.
+This is softer Timed Consequence compared to Gypsy rescue (which can permanently close questlines).
+
+HYBRID WITH OBSERVATION REPLAY:OR component:Lure pattern must be observed and reproduced correctly (behavior learning).
+TC component: Capture-to-release window creates urgency layer on top of OR mechanics.
+
+The Will-o'-Wisp puzzle demonstrates TC can apply to ITEM PRESERVATION not just character survival—
+maintaining captured organism's viability is the timed challenge, with mechanical consequence (item uselessness) if deadline missed.
+```
+
+<small>Cited from: qfg4-gamefaqs-anonymous.txt:1075-1080, qfg4-gamefaqs-sac.txt:1946-1952</small>

src/puzzles/truth-revelation.md

@@ -0,0 +1,124 @@
+# Truth Revelation Mechanic
+
+## Mechanic Definition
+
+An item or action reveals hidden truth—disguising what's false, exposing hidden identity, or showing what lies beneath the surface. The solution is not combat or force but *seeing through* deception. The truth itself is the key that unlocks the puzzle.
+
+This differs from "evidence collection" puzzles: the item doesn't just *prove* something, it actively *shows* something.
+
+## Information Architecture
+
+**Conveyance Method**: Item-based revelation
+- Player obtains a "revealing" item through gameplay
+- Using the item on a target reveals hidden information
+- The reveal is diegetic—within the game world, not a UI popup
+
+**Player Action Pattern**:
+1. Obtain revelation item through normal gameplay
+2. Identify suspect/obstacle that might be disguised
+3. Use revealing item on target
+4. Information revealed → player knows truth
+5. Use truth to solve puzzle (unlock path, prove guilt, etc.)
+
+**Core Mechanic**: The puzzle isn't about finding evidence—it's about revealing what's hidden. The item is a probe, not a weapon.
+
+## Design Rationale
+
+- Rewards observation—player must suspect something is hidden before investigating
+- Creates dramatic reveals—unmasking is inherently theatrical
+- Avoids violence—solution is cognitive, not confrontational
+- Integrates with narrative—revealing truth advances the story
+
+## Why It's Effective
+
+The reveal moment is satisfying because it's active discovery, not passive proof-gathering. The player uses a tool to learn something, not collects documents to prove something.
+
+## Mechanic Variations
+
+| Variation | Revelation Method | Information Revealed |
+|-----------|-------------------|---------------------|
+| Optical | Special item shows true form | Identity, disguise |
+| Chemical | Substance reveals hidden marks | Truth, lies, secret writing |
+| Physical | Object breaks concealment | Hidden rooms, mechanisms |
+| Temporal | Time reveals truth | History, past events |
+| Emotional | Truth triggers response | Deception, intentions |
+
+## Generic Example Structure
+
+**Goal**: Identify the [Imposter/Truth/Hidden Thing]
+
+**Information Flow**:
+- Player obtains [Revealing Item] through normal exploration
+- Player suspects something is not as it seems (through dialogue contradictions, visual anomalies)
+- Player uses [Revealing Item] on [Suspect/Object]
+- Game shows what's actually there (not what appears)
+- Player uses revealed truth to solve puzzle
+
+**The puzzle**: Player must both obtain the revealing item AND correctly identify what to use it on.
+
+## Adventure Game Implementation
+
+### SpaceQuest 1: Sarien ID Card Truth Revelation (SQ1)
+
+**Problem**: Inside Deltaur mothership laundry room, Roger obtains a washing machine-disguised Sarien uniform. However, simply having the uniform isn't enough—examination reveals a critical truth about his new identity status that enables armory access. The puzzle lies in discovering WHAT THE UNIFORM TRULY REPRESENTS (authentic credentials, not mere clothing).
+
+<small>Source: cheatbook_walkthrough.html, lines 368-371 — "After washing open the machine (you now look like a Sarien). Exit east... Type LOOK CLOTHES and you get an ID card"</small>
+
+**Truth Revelation Sequence**:
+
+```
+PHASE 1 - APPEARANCE TRANSFORMATION (Surface Truth):
+Step 1 → Hide in washing machine during laundry cycle
+Step 2 → Washing completes; player exits wearing Sarien soldier uniform  
+Step 3 → Visual state changed: sprite now appears as "Sarien soldier" to guards
+         This is the FALSE/OBVIOUS truth: "I look like a Sarien, so I'm trusted"
+
+PHASE 2 - EXAMINATION REVEALS DEEPER TRUTH:
+Step 4 → Type "look at clothes/uniform/clothes" command (critical investigation action)
+Step 5 → Game reveals HIDDEN truth: "You find an ID card in the pocket belonging to Butston Freem"
+
+         This is the ACTUAL truth: The uniform's true value isn't appearance—it's
+         the AUTHENTIC credentials it contains. Without the ID, disguise fails at armory.
+
+
+PHASE 3 - TRUTH DEPLOYMENT (Application of Revelation):
+Step 6 → Navigate to armory room via ventilation system/laundry exit
+Step 7 → Show ID card to robot guard → "It's Butston Freem's authentic credentials!"
+         Robot accepts as proof of authorization, departs to retrieve pulseray
+         
+Step 8 → Without having examined uniform and discovered the truth (ID exists),
+         player cannot progress—appearence alone insufficient for armory gate
+
+
+WHY IT'S TRUTH REVELATION:
+
+SURFACE vs HIDDEN TRUTH STRUCTURE CLEAR:
+- Surface Truth: "I'm disguised as a Sarien soldier" (visual sprite change, obvious)
+- Hidden Truth: "The uniform contains legitimate access credentials" (requires LOOK command discovery)
+- Revelation Mechanic: The "look at clothes" command ACTS AS THE REVEALING TOOL—it actively shows what's hidden in the pocket that couldn't be known through visual sprite inspection alone
+
+
+ACTIVE DISCOVERY vs PASSIVE COLLECTION:
+Player isn't just "picking up an item"—they must INFER that examining the uniform might reveal something beyond appearance. This requires thinking: "What else does THIS UNIFORM offer besides visual disguise?" The ID card's existence is DIEGETICALLY HIDDEN until player commands examination.
+
+
+TRUTH ENABLES NEXT PHASE (Not Mere Proof):
+ID card isn't PROOF of Sarien identity—it IS the functional authorization token. Without it, robot would reject even perfectly-disguised Roger. This demonstrates "truth as key to unlock" principle: uniform alone = cosmetic; ID within = access key.
+
+
+HYBRID WITH SENSORY EXPLOITATION:
+This puzzle layers Truth Revelation (discovering what the uniform CONTAINS) atop Sensory Exploitation (Sariens trust VISIBLE UNIFORM appearance). The laundry room is primarily SE, but the ARMORY ACCESS requires the TRUTH about credentials hidden within. This creates multi-layered puzzle architecture where both mechanics required for full solution.
+
+
+DISTINCTION FROM SIMPLE ITEM PICKUP:
+Many games have "find key in container" patterns. What makes THIS truth revelation is that the player must actively INVESTIGATE the uniform for hidden elements. Just grabbing uniform sprite → wearing it isn't sufficient. The LOOK command is explicit cognitive act of investigating WHAT ELSE this object might be beyond its surface function.
+
+
+---
+
+## Related Types
+
+- **Sensory Exploitation**: Both use character perception, but SE exploits what the NPC trusts while TR reveals hidden reality
+- **Information Brokerage**: Both involve exchange, but IB trades items for info while TR uses tools to discover concealed truth
+
+This puzzle tests: "Can I identify what's hidden and see through surface appearance to deeper meaning?"