notid/puzzle-design-kb
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Complete: Configure mdbook mermaid support and create KQVI puzzle inventory

Browse Source
This commit is contained in:
Bryce
2026-03-19 19:21:41 -07:00
parent 414fdfc059
commit ec4d81ac82
3 changed files with 445 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
book.toml
View File

@@ -11,3 +11,5 @@ edit-url-template = "https://github.com/noti/puzzle-design-kb/edit/main/{path}"
[output.html.playground]
editable = true
line-numbers = true
[preprocessor.mermaid]

389
src/inspiration/kings-quest-vi-puzzle-inventory.md Normal file
View File

@@ -0,0 +1,389 @@
# King's Quest VI: Comprehensive Puzzle Inventory
This document catalogs all puzzles found across 4 walkthrough sources for KQVI, cross-referenced by geographical area and compared against the existing dependency chart.
## Sources Analyzed
1. **Sierra Planet** - Full walkthrough with detailed puzzle solutions
2. **GameFAQs (bananagirl)** - Comprehensive walkthrough with point list and item table
3. **GameFAQs (Tricrokra)** - Step-by-step walkthrough with inventory references
4. **GameFAQs (ASchultz)** - Point-by-point action list with itemized details
---
## Area 1: Isle of the Crown
### 1.1 Beach
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Royal Ring Discovery** | Need identification to prove prince身份 | None | Royal Insignia Ring | None |
| **Hidden Box** | Get valuable coin from debris | None | Copper Coin | Move plank |
| **Magic Map Activation** | Access to other islands | None (must be at beach/dock) | Magic Map | Trade Royal Ring to Pawn Shop |
### 1.2 Castle Entry
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Guard Dogs Proof** | Need to enter castle | Royal Insignia Ring | Audience with Vizier | Get Ring from Beach |
| **Vizier Meeting** | Learn about Cassima's situation | Proof of identity | Kicked out of castle | Show Ring to Guards |
### 1.3 Village
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Pawn Shop Trading** | Get useful items | Copper Coin | Nightingale (first trade) | None |
| **Magic Map Trade** | Access to all islands | Royal Insignia Ring | Magic Map | Talk to ferryman first |
| **Invisible Ink Discovery** | Item for gnome puzzle | None | Invisible Ink Bottle | Pawn shop owner trashes items after map trade |
| **Jollo Trust** | Unlock story info, best ending path | Royal Insignia Ring | Jollo's trust, story hints | Return to bookstore after ferry |
### 1.4 Crossroads / Forest
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Sing-Sing Befriending** | Messenger to Cassima | Mechanical Nightingale | Bird trusts you | None |
| **Ring Delivery to Cassima** | Start communication with princess | Royal Insignia Ring | Hair Ribbon + Cassima's Hair | Befriend Sing-Sing |
| **Love Poem Delivery** | Build relationship with Cassima | Love Poem | Cassima's Letter | Give Ring first |
| **White Rose Delivery** | Final message to Cassima | White Rose (second) | No direct return | Beauty/Beast quest complete |
### 1.5 Dock / Ferry
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Ferryman Access** | Learn about islands, get ferry info | Talk to Ali first | Rabbit's Foot | None |
| **Rabbit Foot** | Item for gnome puzzle | None | Rabbit's Foot | Get ferryman trust |
### 1.6 Mansion
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Beauty Trust** | Break Beast's curse | White Rose | Beauty's trust | None |
| **Ring Exchange** | Unite Beauty with Beast | Beast's Ring | Beauty's Dress, Mirror | Give Rose first |
---
## Area 2: Isle of Wonder
### 2.1 Beach
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Five Gnomes** | Access to island interior | Flower of Stench, Nightingale, Mint, Rabbit Foot, Invisible Ink | Can explore island | Get items from IoC |
| **Oyster Pearl** | Trade item, later quest | Boring Book | Pearl | Read book to oyster |
| **Sentence Fragment** | Complete dangling participle | None (floats in) | Sentence ("Where are you going?") | Wait for it to wash ashore |
### 2.2 Point / Book Garden
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Bookworm Trade** | Get rare book for spellbook | Dangling Participle | Rare Book | Get participle from IoB |
| **Spider Web Paper** | Learn riddle answer for Gate | Loose Thread (web) | Word "LOVE" | Pull thread first |
| **Love Poem** | Send to Cassima | Poetry bookshelf | Love Poem (page falls) | Search bookshelf |
### 2.3 Swamp
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Milk Bottle** | Needed for baby's tears | None | Milk | None |
| **Swamp Ooze Collection** | Ingredient for paint spell | Rotten Tomato, Tea Cup | Swamp Ooze | Give tomato to Bump-on-log |
### 2.4 Garden
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Hole-in-the-Wall Capture** | Item needed for catacombs | Flute | Hole-in-the-Wall | Play flute for wallflowers |
| **Iceberg Lettuce** | Cool boiling pool | None | Iceberg Lettuce | None |
| **Rotten Tomato** | Get swamp ooze | None | Rotten Tomato | None |
| **Baby's Tears Collection** | Ingredient for rain spell | Milk, Hunter's Lamp | Baby's Tears | Give milk to baby plant |
| **Tea Cup** | Container for spells | None | Tea Cup | None |
| **"Drink Me" Potion** | Fake death for genie | None | Potion | None |
### 2.5 Chessboard Land
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Red Scarf** | Lure minotaur to death | None | Red Scarf | Queens leave after conversation |
| **Coal/Egg Trade** | Get sulfur egg for spell | Lump of Coal | Sulfur Egg | Get coal from IoM |
---
## Area 3: Isle of the Beast
### 3.1 Beach
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Dangling Participle** | Trade with bookworm | Sentence Fragment | Dangling Participle | Speak to bookworm first, show sentence |
### 3.2 Boiling Pool
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Cool the Pool** | Cross to north area | Iceberg Lettuce | Can cross | Get lettuce from IoW |
| **Hunter's Lamp** | Container for rain spell | None | Lamp | None |
### 3.3 Garden / Archer Gate
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Archer Statue Bypass** | Access to hedge maze | Shield | Safe passage | Get shield from catacombs |
| **Brick** | Stop trap in catacombs | None | Brick | None |
| **Rose Hedge Cut** | Access to Beast | Scythe | Path opens | Get scythe from IoM |
### 3.4 Hedge Maze
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Beast Meeting** | Learn about curse, get ring | None | Beast's Ring, Mirror | Have white rose |
| **Beauty's Dress** | Disguise, fire protection | Give Rose + Ring to Beauty | Beauty's Dress, Mirror | None |
| **White Rose (second)** | Final gift to Cassima | None | White Rose | None |
---
## Area 4: Minotaur's Maze / Catacombs
### 4.1 Level 1
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Skull Collection** | Spell ingredient | None | Skull | Navigate maze |
| **Tile Puzzle** | Navigate spikes safely | Manual (copy protection) | Path opens | Manual required |
| **Shield** | Protection from archer | None | Shield | Navigate maze |
| **Dead Man's Coins** | Pay Charon | None | Coins | Navigate maze |
| **Falling Ceiling Trap** | Survive crushing | Brick | Continue to L2 | None |
### 4.2 Level 2 (Dark)
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Light the Way** | See in darkness | Tinderbox | Can navigate | Have tinderbox |
| **Spy Room** | Learn minotaur secret | Hole-in-the-Wall | See tapestry location | Use at correct wall |
| **Tapestry Discovery** | Find minotaur entrance | None | Access to lair | Navigate maze |
### 4.3 Minotaur's Lair
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Minotaur Defeat** | Get dagger, proceed | Red Scarf | Dagger, Sacred Water, Oracle Vial | Lure with scarf |
---
## Area 5: Isle of Sacred Mountain
### 5.1 Beach
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Flower of Stench** | Gnome puzzle | None | Flower | None |
| **Black Feather** | Paint spell ingredient | None | Feather | None |
### 5.2 Cliffs of Logic
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Five Logic Puzzles** | Climb to summit | Manual (copy protection) | Path to summit | Manual required |
### 5.3 Clifftop
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Poison Berry Avoidance** | Survive | None (wait) | None | Reject fake lady |
| **Cave Entry** | Access to mint | Tinderbox | Peppermint Leaves | Light way |
### 5.4 Dark Cave
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Mint Leaves** | Defeat genie | Tinderbox | Peppermint Leaves | Light cave |
### 5.5 Winged Ones / Oracle
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Prophecy Fulfillment** | Get sacred water | Red Scarf, Tinderbox, Hole-in-Wall, Brick | Sacred Water, Oracle Vial | Complete catacombs |
| **Night Mare Charm** | Access Realm of Dead | Spoiled Egg, Hair, Ember, Skull | Ride Nightmare | Have all ingredients |
---
## Area 6: Isle of the Mists
### 6.1 Beach
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Druid Survival** | Not burned | Rain Spell + Beauty's Dress | Survive | Prepare rain spell |
### 6.2 Village
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Scythe** | Cut rose hedge | None | Scythe | None |
| **Coal** | Trade for sulfur egg | None | Coal | None |
### 6.3 Ceremonial Ground
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Ember Collection** | Spell ingredient | Skull | Ember | Have skull |
| **Skull Preparation** | Cast charm spell | Spoiled Egg, Hair, Ember | Skull ready for spell | Have all ingredients |
---
## Area 7: Realm of the Dead
### 7.1 Landing Point
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Zombie Avoidance** | Survive | Rain Spell (if triggered) | None | Navigate carefully |
| **Cassima's Parents** | Get underworld ticket | None | Ticket | Talk to spirits |
### 7.2 Pathway
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Ghost Mother** | Help find son | None | Handkerchief | Talk to ghost |
### 7.3 Gate
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Xylophone** | Get skeleton key | None | Skeleton Key | Play bones |
| **Ticket Gate** | Enter underworld | Ticket | Access to Styx | Give to skeleton |
### 7.4 River Styx
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Gauntlet** | Challenge Death | None | Gauntlet | Search knight |
| **Styx Water** | Paint spell final ingredient | Tea Cup | Styx Water | Have cup |
| **Charon's Ferry** | Cross river | Dead Man's Coins | Access to Gate | Pay fare |
### 7.5 Gate (Talking)
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **LOVE Riddle** | Enter Death's domain | Answer "LOVE" | Access to throne | Remember from spider web |
### 7.6 Throne Room
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Death's Challenge** | Make Death cry | Mirror | Parents freed | Show mirror |
---
## Area 8: Castle Interior (Infiltration)
### 8.1 Side Wall (Long Path)
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Paint Door** | Create castle entrance | Black Feather, Swamp Ooze, Styx Water, Paintbrush | Door appears | Have all ingredients + spellbook |
| **Magic Paint Spell** | Animate door | Spellbook | Real door | Paint door first |
### 8.2 Castle Disguise (Short Path)
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Beauty's Dress** | Disguise as servant | Beauty's Dress | Enter castle | Get from Beauty |
### 8.3 Basement / Cells
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Ghost Boy** | Learn secret passage | Handkerchief | Hint about armor | None |
| **Guard Avoidance** | Not captured | Nightingale (distraction) | Continue | Navigate carefully |
| **Jollo's Room** | Best ending requirement | Befriend Jollo earlier | Access to give lamp | Jollo trust |
### 8.4 Secret Passage
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Eavesdrop** | Learn password part | None | Password "ALI" | Find passage |
| **Cassima Meeting** | Give dagger, see Cassima | Dagger | Cassima has dagger | Navigate passage |
| **Vizier Spy** | Learn password part | None | Password "ZEBU" | Find passage |
| **Closet Exit** | Access vizier's room | None | Entry to bedroom | Find door |
### 8.5 Vizier's Bedroom
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Chest Unlock** | Get treason letter | Skeleton Key | Vizier's Letter | Get key from Realm |
| **Treasure Room Password** | Two-part code | "ALI" + "ZEBU" | Treasury opens | Learn from spy passages |
### 8.6 Treasury
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Stolen Treasures** | Learn genie stole them | None | Point bonus | None |
---
## Area 9: Final Confrontation
### 9.1 Throne Room
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Mirror Reveal** | Show Cassima's true identity | Mirror | Truth revealed | None |
| **Saladin Proof** | Let you enter ceremony | Vizier's Letter | Access to wedding | Get letter from chest |
### 9.2 Tower
| Puzzle | Problem Solved | Items Required | Items Obtained | Dependencies |
|--------|---------------|----------------|----------------|--------------|
| **Genie Defeat (Best)** | Control genie | Fake Lamp (from Jollo) | Genie controlled | Best ending path |
| **Genie Defeat (Alt)** | Incapacitate genie | Peppermint Leaves | Genie drunk | None |
| **Vizier Fight** | Defeat villain | Sword, Cassima's help | Victory | Give dagger to Cassima |
---
## Puzzles NOT in Current Dependency Chart
Based on cross-referencing all 4 walkthroughs, the following puzzles/activities appear in walkthroughs but are **missing from the dependency chart**:
| Missing Puzzle | Area | Notes |
|---------------|------|-------|
| **Love Poem acquisition** | Isle of Crown - Bookstore | Optional point-scoring action |
| **Spider Web Paper / LOVE word** | Isle of Wonder - Point | Critical for Realm of the Dead Gate riddle, but indirect dependency |
| **"Drink Me" Potion** | Isle of Wonder - Garden | Used for fake suicide genie trick (Long Path) |
| **Coal from Isle of Mists** | Isle of Mists - Village | Needed for Chessboard egg trade |
| **Beauty's Hair vs Cassima's Hair** | Either IoC or IoB | Both serve same spell purpose, but chart only shows one path |
| **Ember Collection** | Isle of Mists - Ceremonial | Spell ingredient, dependency implied but not explicit |
| **Xylophone Bone Key** | Realm of the Dead - Gate | Explicit puzzle for key |
| **Charon Ferry Payment** | Realm of the Dead - Styx | Explicit payment puzzle |
| **Password "ALI ZEBU" Discovery** | Castle - Secret Passage | Two-step discovery process |
| **Treasury Treasures** | Castle - Treasury | Optional point collection |
| **Jollo's Lamp Switch** | Castle - Jollo's Room | Best ending requirement |
| **Handkerchief from Ghost Mother** | Realm of the Dead - Pathway | Optional but gives hint |
| **Nail from Pillar** | Castle - Upstairs Hallway | Used for chest in bedroom |
---
## Puzzle Classification Summary
| Category | Count | Examples |
|----------|-------|----------|
| **Item Collection** | 40+ | Ring, coin, map, pearl, etc. |
| **Trade/Exchange** | 8+ | Pawn shop trades, bookworm, chess queens |
| **Communication/Messenger** | 4 | Sing-Sing deliveries to Cassima |
| **Copy Protection** | 5 | Logic Cliffs puzzles (manual required) |
| **Navigation Hazards** | 10+ | Gnomes, archer, boiling pool, zombies |
| **Spells (3 total)** | 3 | Make Rain, Magic Paint, Charm Creatures |
| **Combat/Trap** | 6+ | Minotaur, falling ceiling, tile puzzle |
| **Social/Dialogue** | 5+ | Jollo trust, Beauty trust, Beast curse |
| **Riddle** | 1 | Gate's LOVE riddle |
| **Disguise** | 2 | Beauty's dress, invisible ink |
---
## Key Design Patterns Observed
1. **Multi-Stage Collection**: Items often require multiple steps (e.g., pearl needs book → oyster yawn → grab)
2. **Parallel Solutions**: Several puzzles can be solved in any order within an area
3. **Copy Protection**: Logic Cliffs require manual reference, isolating this puzzle type
4. **Inventory Cycling**: Pawn shop allows trading one item for another, enabling flexibility
5. **Messenger Pattern**: Sing-Sing bridges isolated areas without direct access
6. **Spell Components**: Three spells each require 3 ingredients from different areas
7. **Best Ending Locks**: Jollo trust and lamp switch required for optimal outcome

74
todos/TODOS.md
View File

@@ -1,31 +1,65 @@
# TODO List for KQVI Puzzle Dependencies QA Fixes
# TODO List for KQVI Puzzle Dependencies Rework
## Issues to Fix in `src/inspiration/kings-quest-vi-heir-today-gone-tomorrow.md`
## 8 Critical Feedback Points to Address
### 1. Fix S17 Undefined Node (Critical)
- [x] S17 removed from classDef (was causing CSS error)
### 1. mdbook Mermaid Configuration
- [ ] Add mermaid support to book.toml
- [ ] Verify diagram renders with `mdbook build`
### 2. Fix S20 Dead End
- [x] S19 and S20 removed entirely (catacomb content outside scope)
### 2. Actions vs Outcomes as Separate Nodes
- [ ] "Talk to ferryman" and "get rabbit's foot" must be SEPARATE nodes
- [ ] Every action and outcome must be distinct nodes
### 3. Fix S12 Orphan (Pearl)
- [x] Added dashed note edge indicating optional side quest
### 3. Individual Item Acquisition Nodes
- [ ] "Receive coin" and "receive ring" must be separate nodes
- [ ] Every individual item/event has its own outcome node
### 4. Fix S19/S20 Sequential Chain
- [x] Removed S19 and S20 nodes, kept S21 as parallel from P6
### 4. Organize by Lands/Areas
- [ ] Group nodes by geographical area
- [ ] Isle of Sacred Mountain, Isle of Wonder, etc.
- [ ] Show proper cross-area dependency hierarchy
### 5. Verify Phase 6/7 Flow (Shield Dependency)
- [x] Verified - chart structure is correct, Shield from Minotaur Maze flows back via C2
### 5. Problem-Solution Flow (FIX BACKWARDS STRUCTURE)
- [ ] Current: Problem is prevented first (WRONG)
- [ ] Should be: Solution steps lead TO problem resolution
- [ ] Structure: START --> Prereqs --> Recognize Problem --> Solution Steps --> Problem Resolved
### 6. mdbook Integration
- [x] SUMMARY.md already links correctly
- [x] Run `mdbook build` - passed
- [x] Verify page exists in book output
### 6. Complete Puzzle Inventory from Walkthroughs
- [ ] Read all 4 KQVI walkthroughs
- [ ] Create checklist of ALL puzzles in the game
- [ ] Verify each puzzle appears in the chart
- [ ] Document any missing puzzles
### 7. Mechanic Note on 4 Items (Locked Choice)
- [ ] Document: paint brush, nightingale, tinderbox, flute are LOCKED CHOICE
- [ ] Each unlocked by trading one for another
- [ ] For dependency graph: treat each as UNLOCKED
- [ ] Focus on locks and keys, not mini-game trading
### 8. Modern, Legible Styling
- [ ] Fix contrast and colors
- [ ] WCAG accessibility minimums
- [ ] Clean color palette for node types
- [ ] Modern aesthetics
---
## Commit Points
## Subtasks
- Complete: Fix orphaned/undefined nodes (S17, S20, S12)
- Complete: Fix sequential to parallel (S19/S20 chain)
- Complete: Verify mdbook integration
### Phase 1: Configuration & Research
- [ ] Task 1.1: Add mermaid preprocessor to book.toml
- [ ] Task 1.2: Verify mdbook build works with mermaid
- [ ] Task 2.1: Read all 4 KQVI walkthroughs
- [ ] Task 2.2: Create complete puzzle inventory checklist
### Phase 2: Chart Rework
- [ ] Task 3.1: Restructure nodes - separate actions from outcomes
- [ ] Task 3.2: Create individual item acquisition nodes
- [ ] Task 3.3: Organize by geographical areas
- [ ] Task 3.4: Fix problem-solution flow direction
- [ ] Task 3.5: Apply modern styling with proper contrast
### Phase 3: Verification
- [ ] Task 4.1: Cross-reference puzzle inventory against chart
- [ ] Task 4.2: Add locked choice mechanic note
- [ ] Task 4.3: Final mdbook build verification