Complete: Configure mdbook mermaid support and create KQVI puzzle inventory

todos/TODOS.md

@@ -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