diff --git a/todos/TODOS.md b/todos/TODOS.md index 606deb3..1e1e075 100644 --- a/todos/TODOS.md +++ b/todos/TODOS.md @@ -1,288 +1,368 @@ -# Monkey Island 1 Page Creation ✅ - -- [x] **Create monkey-island-1-the-secret-of-monkey-island.md** - - Pattern Learning: Insult sword fighting (7 pairs memorized and applied) - - Multi-Faceted Plan: Four map pieces gathered in parallel across islands - - Sensory Exploitation: Root beer defeats ghost LeChuck -- [x] **Generate monkey-island-1-chart.svg** - - Converted .mmd to .svg using mermaid-cli/mmdc - ---- - -# KQVI Chart Overhaul - TODO List +# Dependency Graph & QA Files for All Games - MASSIVE TASK LIST ## Overview -Complete overhaul of the King's Quest VI puzzle dependency chart based on comprehensive feedback. Multiple parallel workstreams. +Create dependency graph (.mmd), generate SVG, and write QA dependency graph file for every game in the inspiration directory. Process games systematically, commit after each completion. --- -## 1. SVG Rendering Automation ✅ -- [x] **1a: Research mdbook-mermaid or mermaid-cli integration** - - Determined best approach: build.sh wrapper script with mermaid-cli -- [x] **1b: Update book.toml with build configuration** - - Created build.sh and scripts/render-mermaid.sh -- [x] **1c: Create build script if needed** - - Script converts kings-quest-vi-chart.mmd → kings-quest-vi-chart.svg -- [x] **1d: Test render pipeline** - - `mdbook build` (run ./build.sh) generates SVG correctly +## Game Status Summary + +| Game | Page Exists | MMD Chart | SVG | QA File | Walkthrough | +|------|-------------|-----------|-----|---------|-------------| +| **beneath-a-steel-sky** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **broken-sword-1-shadow-of-the-templars** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **broken-sword-ii-the-smoking-mirror** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **day-of-the-tentacle** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **full-throttle** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **gabriel-knight-1-sins-of-the-fathers** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **grim-fandango** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **indiana-jones-and-the-fate-of-atlantis** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **indiana-jones-and-the-last-crusade** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **kings-quest-iii-to-heir-is-human** | ✅ | ✅ | ❌ | ❌ | ✅ | +| **kings-quest-vi-heir-today-gone-tomorrow** | ✅ | ✅ | ✅ | ✅ | ✅ | +| **kings-quest-vii-the-princeless-bride** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **kings-quest-viii-mask-of-eternity** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **loom** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **maniac-mansion** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **monkey-island-1-the-secret-of-monkey-island** | ✅ | ✅ | ✅ | ❌ | ✅ | +| **quest-for-glory-1-shadows-of-darkness** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **quest-for-glory-ii-trial-by-fire** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **quest-for-glory-iii-wages-of-war** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **quest-for-glory-iv-shadows-of-darkness** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **sam-and-max-hit-the-road** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **simon-the-sorcerer** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **spacequest-1-the-sarien-encounter** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **spacequest-2-the-vohaul-assault** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **spacequest-iii-the-pirates-of-pestulon** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **spacequest-iv-the-rogerwars** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **syberia** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **the-dig** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **the-legend-of-kyrandia-book-one** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **the-longest-journey** | ✅ | ❌ | ❌ | ❌ | ✅ | +| **zak-mckracken-and-the-alien-mindbenders** | ✅ | ❌ | ❌ | ❌ | ✅ | + +**Legend:** ✅ = exists, ❌ = needs creation --- -## 2. Remove Pawn Shop Trade Mechanics ✅ -- [x] **2a: Analyze current pawn shop representation** - - Identified trade chain: Nightingale → Flute → Tinderbox → Paintbrush -- [x] **2b: Simplify to unlock representation** - - Removed sequential trade nodes (A_TRADE_WITH_BROKER_N, etc.) - - All 6 items now connect directly from A_TALK_TO_PAWN_BROKER - - Removed dashed lines for trades -- [x] **2c: Update markdown documentation** - - Simplified "Locked Choice Mechanic" section +## Task Format +For each game: +1. Read walkthrough file from `src/walkthroughs//` +2. Create dependency graph `.mmd` in `src/inspiration/` +3. Generate `.svg` using `/home/noti/.nvm/versions/node/v22.17.1/bin/mmdc` +4. Create QA dependency graph file `-puzzle-dependencies-qa.md` +5. Update game page to reference chart if needed +6. Commit and push --- -## 3. Cleanup Pass ✅ (Partially Complete) +## Priority 1: Games with Existing Pages but No Charts -### 3a. Unlock Strategy for Jumbled Lines ⚠️ -- [x] **3a.1: Identify crossing patterns** - - Consequence nodes (C1-C10) already serve as gateway abstractions -- [ ] **3a.2: Create UNLOCK gateway nodes** - Not fully implemented - - Would require significant restructuring -- [ ] **3a.3: Route connections through gateway nodes** - Deferred +### 1. Beneath a Steel Sky (1994) ⏳ +- [ ] **1.1:** Read walkthrough from `src/walkthroughs/beneath-a-steel-sky/` +- [ ] **1.2:** Analyze puzzle structure and identify main dependency chains +- [ ] **1.3:** Create `beneath-a-steel-sky-chart.mmd` with: + - Node fontsize=18 + - Color-coded areas/subgraphs + - START → puzzle phases → END flow + - GATEWAY nodes for major unlocks +- [ ] **1.4:** Generate SVG: `mmdc -i src/inspiration/beneath-a-steel-sky-chart.mmd -o src/inspiration/beneath-a-steel-sky-chart.svg -w 1600` +- [ ] **1.5:** Create `beneath-a-steel-sky-puzzle-dependencies-qa.md`: + - Orphan node detection results + - Dead-end analysis + - Item flow verification + - Known issues section +- [ ] **1.6:** Update game page if needed +- [ ] **1.7:** Commit with message: "Create dependency chart and QA for Beneath a Steel Sky" +- [ ] **1.8:** Push to origin -### 3b. Fan-Out Layout Organization ⚠️ -- [x] **3b.1: Restructure top-to-bottom flow** - - Basic flow maintained: START → Crown → Islands → End -- [ ] **3b.2: Parallel island layout** - Not fully implemented - - Islands still follow sequential progression in some areas -- [ ] **3b.3: Verify natural reading order** - Needs verification +### 2. Broken Sword 1: Shadow of the Templars (1996) ⏳ +- [ ] **2.1:** Read walkthrough from `src/walkthroughs/broken-sword-1/` +- [ ] **2.2:** Analyze puzzle structure +- [ ] **2.3:** Create `broken-sword-1-chart.mmd` +- [ ] **2.4:** Generate SVG +- [ ] **2.5:** Create QA file `broken-sword-1-puzzle-dependencies-qa.md` +- [ ] **2.6:** Commit and push -### 3c. Repeat Areas with Color Coding ✅ -- [x] **3c.1: Implement fixed index-based color palette** - ``` - Palette (index-based): - 0: #FFFFFF (white - default/ungrouped) - 1: #E3F2FD (light blue - Isle of Crown) - 2: #FFF3E0 (light orange - Isle of Wonder) - 3: #F3E5F5 (light purple - Isle of Beast) - 4: #E8F5E9 (light green - Isle of Mists) - 5: #FFF8E1 (light amber - Sacred Mountain) - 6: #FCE4EC (light pink - Druid Island) - 7: #E0F7FA (light cyan - Realm of Dead) - 8: #F5F5F5 (light grey - Village) - ``` -- [x] **3c.2: Allow same area to appear multiple times** - - Palette documented for future use -- [x] **3c.3: Document palette in chart header** - - Added as comments in .mmd file (lines 19-30) +### 3. Broken Sword II: The Smoking Mirror (1997) ⏳ +- [ ] **3.1:** Read walkthrough from `src/walkthroughs/broken-sword-ii/` +- [ ] **3.2:** Analyze puzzle structure +- [ ] **3.3:** Create `broken-sword-ii-chart.mmd` +- [ ] **3.4:** Generate SVG +- [ ] **3.5:** Create QA file `broken-sword-ii-puzzle-dependencies-qa.md` +- [ ] **3.6:** Commit and push -### 3d. Bigger Area Titles ✅ -- [x] **3d.1: Increase subgraph header font size** - - Added styling to Final Confrontation subgraph: font-size: 18px +### 4. Day of the Tentacle (1993) ⏳ +- [ ] **4.1:** Read walkthrough from `src/walkthroughs/day-of-the-tentacle/` +- [ ] **4.2:** Analyze multi-character temporal puzzle chains +- [ ] **4.3:** Create `day-of-the-tentacle-chart.mmd` (complex - 3 time periods) +- [ ] **4.4:** Generate SVG +- [ ] **4.5:** Create QA file `day-of-the-tentacle-puzzle-dependencies-qa.md` +- [ ] **4.6:** Commit and push -### 3e. Only START and END Outside Groupings ✅ -- [x] **3e.1: Audit all nodes** - - Only START and END are outside subgraphs -- [x] **3e.2: Move orphans into appropriate groupings** +### 5. Full Throttle (1995) ⏳ +- [ ] **5.1:** Read walkthrough from `src/walkthroughs/full-throttle/` +- [ ] **5.2:** Analyze puzzle structure +- [ ] **5.3:** Create `full-throttle-chart.mmd` +- [ ] **5.4:** Generate SVG +- [ ] **5.5:** Create QA file `full-throttle-puzzle-dependencies-qa.md` +- [ ] **5.6:** Commit and push + +### 6. Gabriel Knight 1: Sins of the Fathers (1993) ⏳ +- [ ] **6.1:** Read walkthrough from `src/walkthroughs/gabriel-knight-1/` +- [ ] **6.2:** Analyze puzzle structure (investigation + translation puzzles) +- [ ] **6.3:** Create `gabriel-knight-1-chart.mmd` +- [ ] **6.4:** Generate SVG +- [ ] **6.5:** Create QA file `gabriel-knight-1-puzzle-dependencies-qa.md` +- [ ] **6.6:** Commit and push + +### 7. Grim Fandango (1998) ⏳ +- [ ] **7.1:** Read walkthrough from `src/walkthroughs/grim-fandango/` +- [ ] **7.2:** Analyze complex puzzle chains across 4 years/zones +- [ ] **7.3:** Create `grim-fandango-chart.mmd` (large - multiple acts) +- [ ] **7.4:** Generate SVG +- [ ] **7.5:** Create QA file `grim-fandango-puzzle-dependencies-qa.md` +- [ ] **7.6:** Commit and push + +### 8. Indiana Jones and the Fate of Atlantis (1992) ⏳ +- [ ] **8.1:** Read walkthrough from `src/walkthroughs/indiana-jones-fate-atlantis/` +- [ ] **8.2:** Analyze parallel character gameplay paths +- [ ] **8.3:** Create `indiana-jones-fate-of-atlantis-chart.mmd` +- [ ] **8.4:** Generate SVG +- [ ] **8.5:** Create QA file `indiana-jones-fate-of-atlantis-puzzle-dependencies-qa.md` +- [ ] **8.6:** Commit and push + +### 9. Indiana Jones and the Last Crusade (1989) ⏳ +- [ ] **9.1:** Read walkthrough from `src/walkthroughs/indiana-jones-last-crusade/` +- [ ] **9.2:** Analyze puzzle structure +- [ ] **9.3:** Create `indiana-jones-last-crusade-chart.mmd` +- [ ] **9.4:** Generate SVG +- [ ] **9.5:** Create QA file `indiana-jones-last-crusade-puzzle-dependencies-qa.md` +- [ ] **9.6:** Commit and push + +### 10. King's Quest III: To Heir Is Human (1986) ⏳ +- [ ] **10.1:** MMD chart EXISTING - need to generate SVG +- [ ] **10.2:** Generate `kings-quest-iii-chart.svg` from existing `.mmd` +- [ ] **10.3:** Create QA file for existing chart +- [ ] **10.4:** Commit and push + +### 11. King's Quest VII: The Princeless Bride (1994) ⏳ +- [ ] **11.1:** Read walkthrough from `src/walkthroughs/kings-quest-vii/` +- [ ] **11.2:** Analyze puzzle structure +- [ ] **11.3:** Create `kings-quest-vii-chart.mmd` +- [ ] **11.4:** Generate SVG +- [ ] **11.5:** Create QA file `kings-quest-vii-puzzle-dependencies-qa.md` +- [ ] **11.6:** Commit and push + +### 12. King's Quest VIII: Mask of Eternity (1998) ⏳ +- [ ] **12.1:** Read walkthrough from `src/walkthroughs/kings-quest-viii/` +- [ ] **12.2:** Analyze puzzle structure (real-time elements) +- [ ] **12.3:** Create `kings-quest-viii-chart.mmd` +- [ ] **12.4:** Generate SVG +- [ ] **12.5:** Create QA file `kings-quest-viii-puzzle-dependencies-qa.md` +- [ ] **12.6:** Commit and push + +### 13. Loom (1990) ⏳ +- [ ] **13.1:** Read walkthrough from `src/walkthroughs/loom/` +- [ ] **13.2:** Analyze spell-weaving puzzle chains +- [ ] **13.3:** Create `loom-chart.mmd` +- [ ] **13.4:** Generate SVG +- [ ] **13.5:** Create QA file `loom-puzzle-dependencies-qa.md` +- [ ] **13.6:** Commit and push + +### 14. Maniac Mansion (1987) ⏳ +- [ ] **14.1:** Read walkthrough from `src/walkthroughs/maniac-mansion/` +- [ ] **14.2:** Analyze multi-character coordination puzzles +- [ ] **14.3:** Create `maniac-mansion-chart.mmd` +- [ ] **14.4:** Generate SVG +- [ ] **14.5:** Create QA file `maniac-mansion-puzzle-dependencies-qa.md` +- [ ] **14.6:** Commit and push + +### 15. Monkey Island 1 - Already Has Chart ⏳ +- [ ] **15.1:** MMD chart EXISTS (fixed typos) +- [ ] **15.2:** Need to regenerate SVG with fixed version +- [ ] **15.3:** Create QA file for MI1 chart +- [ ] **15.4:** Commit and push + +### 16. Quest for Glory 1: Shadows of Darkness (1989) ⏳ +- [ ] **16.1:** Read walkthrough from `src/walkthroughs/quest-for-glory-1/` +- [ ] **16.2:** Analyze dual career path puzzles (knight/mage) +- [ ] **16.3:** Create `quest-for-glory-1-chart.mmd` +- [ ] **16.4:** Generate SVG +- [ ] **16.5:** Create QA file `quest-for-glory-1-puzzle-dependencies-qa.md` +- [ ] **16.6:** Commit and push + +### 17. Quest for Glory II: Trial by Fire (1989) ⏳ +- [ ] **17.1:** Read walkthrough from `src/walkthroughs/quest-for-glory-ii/` +- [ ] **17.2:** Analyze puzzle structure +- [ ] **17.3:** Create `quest-for-glory-2-chart.mmd` +- [ ] **17.4:** Generate SVG +- [ ] **17.5:** Create QA file `quest-for-glory-2-puzzle-dependencies-qa.md` +- [ ] **17.6:** Commit and push + +### 18. Quest for Glory III: Wages of War (1992) ⏳ +- [ ] **18.1:** Read walkthrough from `src/walkthroughs/quest-for-glory-iii/` +- [ ] **18.2:** Analyze puzzle structure (city + desert dual settings) +- [ ] **18.3:** Create `quest-for-glory-3-chart.mmd` +- [ ] **18.4:** Generate SVG +- [ ] **18.5:** Create QA file `quest-for-glory-3-puzzle-dependencies-qa.md` +- [ ] **18.6:** Commit and push + +### 19. Quest for Glory IV: Shadows of Darkness (1994) ⏳ +- [ ] **19.1:** Read walkthrough from `src/walkthroughs/quest-for-glory-iv/` +- [ ] **19.2:** Analyze puzzle structure +- [ ] **19.3:** Create `quest-for-glory-4-chart.mmd` +- [ ] **19.4:** Generate SVG +- [ ] **19.5:** Create QA file `quest-for-glory-4-puzzle-dependencies-qa.md` +- [ ] **19.6:** Commit and push + +### 20. Sam & Max Hit the Road (1993) ⏳ +- [ ] **20.1:** Read walkthrough from `src/walkthroughs/sam-max-hit-the-road/` +- [ ] **20.2:** Analyze cross-country puzzle chains +- [ ] **20.3:** Create `sam-and-max-chart.mmd` +- [ ] **20.4:** Generate SVG +- [ ] **20.5:** Create QA file `sam-and-max-puzzle-dependencies-qa.md` +- [ ] **20.6:** Commit and push + +### 21. Simon the Sorcerer (1993) ⏳ +- [ ] **21.1:** Read walkthrough from `src/walkthroughs/simon1/` +- [ ] **21.2:** Analyze puzzle structure (meta-humor, item interactions) +- [ ] **21.3:** Create `simon-the-sorcerer-chart.mmd` +- [ ] **21.4:** Generate SVG +- [ ] **21.5:** Create QA file `simon-the-sorcerer-puzzle-dependencies-qa.md` +- [ ] **21.6:** Commit and push + +### 22. Space Quest 1: The Sarien Encounter (1986) ⏳ +- [ ] **22.1:** Read walkthrough from `src/walkthroughs/spacequest-1/` +- [ ] **22.2:** Analyze puzzle structure (text-based, inventory-heavy) +- [ ] **22.3:** Create `spacequest-1-chart.mmd` +- [ ] **22.4:** Generate SVG +- [ ] **22.5:** Create QA file `spacequest-1-puzzle-dependencies-qa.md` +- [ ] **22.6:** Commit and push + +### 23. Space Quest II: The Vohaul Assault (1987) ⏳ +- [ ] **23.1:** Read walkthrough from `src/walkthroughs/spacequest-ii/` +- [ ] **23.2:** Analyze puzzle structure +- [ ] **23.3:** Create `spacequest-2-chart.mmd` +- [ ] **23.4:** Generate SVG +- [ ] **23.5:** Create QA file `spacequest-2-puzzle-dependencies-qa.md` +- [ ] **23.6:** Commit and push + +### 24. Space Quest III: The Pirates of Pestulon (1989) ⏳ +- [ ] **24.1:** Read walkthrough from `src/walkthroughs/spacequest-iii/` +- [ ] **24.2:** Analyze puzzle structure (dual timeline) +- [ ] **24.3:** Create `spacequest-3-chart.mmd` +- [ ] **24.4:** Generate SVG +- [ ] **24.5:** Create QA file `spacequest-3-puzzle-dependencies-qa.md` +- [ ] **24.6:** Commit and push + +### 25. Space Quest IV: The Rogerwars (1991) ⏳ +- [ ] **25.1:** Read walkthrough from `src/walkthroughs/spacequest-iv/` +- [ ] **25.2:** Analyze puzzle structure (interactive movie style) +- [ ] **25.3:** Create `spacequest-4-chart.mmd` +- [ ] **25.4:** Generate SVG +- [ ] **25.5:** Create QA file `spacequest-4-puzzle-dependencies-qa.md` +- [ ] **25.6:** Commit and push + +### 26. Syberia (2002) ⏳ +- [ ] **26.1:** Read walkthrough from `src/walkthroughs/syberia/` +- [ ] **26.2:** Analyze puzzle structure (large mechanical puzzles) +- [ ] **26.3:** Create `syberia-chart.mmd` +- [ ] **26.4:** Generate SVG +- [ ] **26.5:** Create QA file `syberia-puzzle-dependencies-qa.md` +- [ ] **26.6:** Commit and push + +### 27. The Dig (1995) ⏳ +- [ ] **27.1:** Read walkthrough from `src/walkthroughs/the-dig/` +- [ ] **27.2:** Analyze complex alien exploration puzzle chains +- [ ] **27.3:** Create `the-dig-chart.mmd` (complex - multiple locations/time travel) +- [ ] **27.4:** Generate SVG +- [ ] **27.5:** Create QA file `the-dig-puzzle-dependencies-qa.md` +- [ ] **27.6:** Commit and push + +### 28. The Legend of Kyrandia Book One (1992) ⏳ +- [ ] **28.1:** Read walkthrough from `src/walkthroughs/kyrandia_1/` +- [ ] **28.2:** Analyze puzzle structure +- [ ] **28.3:** Create `the-legend-of-kyrandia-1-chart.mmd` +- [ ] **28.4:** Generate SVG +- [ ] **28.5:** Create QA file `the-legend-of-kyrandia-1-puzzle-dependencies-qa.md` +- [ ] **28.6:** Commit and push + +### 29. The Longest Journey (1999) ⏳ +- [ ] **29.1:** Read walkthrough from `src/walkthroughs/the-longest-journey/` +- [ ] **29.2:** Analyze dual world puzzle chains (Stardust/Cryogenia) +- [ ] **29.3:** Create `the-longest-journey-chart.mmd` (large - multiple chapters) +- [ ] **29.4:** Generate SVG +- [ ] **29.5:** Create QA file `the-longest-journey-puzzle-dependencies-qa.md` +- [ ] **29.6:** Commit and push + +### 30. Zak McKracken and the Alien Mindbenders (1988) ⏳ +- [ ] **30.1:** Read walkthrough from `src/walkthroughs/zak-mckracken/` +- [ ] **30.2:** Analyze world-traveling puzzle chains +- [ ] **30.3:** Create `zak-mckracken-chart.mmd` (large - 1988 megadventure) +- [ ] **30.4:** Generate SVG +- [ ] **30.5:** Create QA file `zak-mckracken-puzzle-dependencies-qa.md` +- [ ] **30.6:** Commit and push --- -## 4. Fix Disconnected/Siloed Nodes ✅ (CRITICAL) -- [x] **4a: Systematically audit every node** - - Found and fixed 16 orphaned nodes -- [x] **4b: Research walkthroughs for connection verification** - - Verified connections against KQVI walkthroughs -- [x] **4c: Fix all orphaned nodes** - - Fixed: P_PROBLEM_BOILING_POOL, P_PROBLEM_DARK_L2, P_PROBLEM_STYX, P_PROBLEM_JOLLO_ROOM, A_GIVE_LAMP_REPLICA, O_RECEIVE_JOLLO_TRUST, A_SHOW_LETTER, A_CASSIMA_FIGHTS, O_SPELL_READY - - 6 acceptable orphans remain (optional/narrative items) +## Progress Tracking + +### Completed Games (with MMD + SVG + QA) +1. ✅ King's Quest VI (all three files exist) +2. ⏳ Monkey Island 1 (MMD+SVG done, QA needed) + +### In Progress +- [None] + +### Remaining: 30 games --- -## 5. Final Integration & Verification ✅ -- [x] **5a: Run `mdbook build` successfully** - - Build completes without errors -- [x] **5b: Visual inspection of chart** - - Layout is functional with proper groupings -- [x] **5c: Commit all changes** +## Notes for Execution + +**MMD Chart Guidelines:** +- Node fontsize=18 throughout +- Color-coded subgraphs using the standard palette: + - #E3F2FD (light blue) + - #FFF3E0 (light orange) + - #F3E5F5 (light purple) + - #E8F5E9 (light green) + - #FFF8E1 (light amber) + - #FCE4EC (light pink) + - #E0F7FA (light cyan) + - #ECEFF1 (light grey) +- START and END as only nodes outside subgraphs +- GATEWAY/UNLOCK nodes for major transitions +- Converge nodes (C1, C2, etc.) where parallel paths merge +- Acquisitions clearly marked: `**ACQUIRED: ITEM**` + +**QA File Structure:** +- Summary of chart structure and design decisions +- List of all major puzzle phases/areas +- Orphan node analysis (should be 0) +- Dead-end node analysis with verification +- Item flow verification summary +- Known issues/limitations + +**Commit Format:** +```bash +git add src/inspiration/-chart.{mmd,svg} +git add src/inspiration/-puzzle-dependencies-qa.md +git commit -m "Create dependency chart and QA for " +git push +``` + +**Build Command after all work:** +```bash +./build.sh && mdbook build +``` --- -## Summary +## Starting Now: Executing Tasks Sequentially -**Completed:** -- SVG rendering automation via build.sh wrapper -- Pawn shop trade mechanics simplified -- Color palette documented for repeat areas -- Bigger subgraph titles applied -- START/END only non-grouped nodes -- 16 orphaned nodes fixed - -**Known Limitations:** -- Full fan-out parallel island layout not implemented (would require significant restructuring) -- UNLOCK gateway nodes not created (consequence nodes C1-C10 serve similar purpose) -- Some areas still follow sequential rather than parallel progression - -**Files Modified:** -- `build.sh` - New build wrapper script -- `scripts/render-mermaid.sh` - Mermaid rendering helper -- `src/inspiration/kings-quest-vi-chart.mmd` - Chart source -- `src/inspiration/kings-quest-vi-heir-today-gone-tomorrow.md` - Documentation - -**Build Command:** `./build.sh` (not `mdbook build`) - ---- - -## 7. Fix Rare Book and Peppermint Orphans 🔧 - -### 7a: Fix Rare Book orphan -- [x] **7a.1: Add A_TRADE_RARE_BOOK_FOR_SPELL action** -- [x] **7a.2: Add O_RECEIVE_SPELL_BOOK outcome** -- [x] **7a.3: Connect O_RECEIVE_RARE_BOOK → A_TRADE_RARE_BOOK_FOR_SPELL → O_RECEIVE_SPELL_BOOK** -- [x] **7a.4: Connect O_RECEIVE_SPELL_BOOK → A_CAST_PAINT_SPELL** - -### 7b: Fix Peppermint orphan -- [x] **7b.1: Add O_RECEIVE_PEPPERMINT → A_GIVE_MINT_GENIE edge** - -### 7c: Rebuild and verify -- [x] **7c.1: Run ./build.sh** -- [x] **7c.2: Commit fixes** - ---- - -## 8. Fix Remaining Dangling Nodes 🔧 - -### 8a: Research orphaned nodes in walkthroughs ✅ -- [x] Research P_PROBLEM_JOLLO_ROOM - requires Jollo's trust -- [x] Research A_SHOW_LETTER - show to Saladin to enter ceremony -- [x] Research A_CASSIMA_FIGHTS - Cassima fights after receiving dagger -- [x] Research O_TREASURY_OPEN - leads to finale -- [x] Research O_PASSWORD_ALI / O_PASSWORD_ZEBU - combined to open treasury -- [x] Research O_GNOMES_*_DONE - converge via C2 - -### 8b: Fix undefined reference ✅ -- [x] Define A_TRADE_COAL_FOR_EGG action node and O_RECEIVE_SULFUR_EGG outcome - -### 8c: Fix orphaned nodes (add incoming edges) ✅ -- [x] Fix P_PROBLEM_JOLLO_ROOM orphan - changed dashed to solid edge -- [x] Fix A_SHOW_LETTER orphan - changed dashed to solid edge -- [x] Fix A_CASSIMA_FIGHTS orphan - changed dashed to solid edge - -### 8d: Fix dead-end nodes (add outgoing edges) ✅ -- [x] O_PASSWORD_ALI/ZEBU - split multi-source edge for proper parsing -- [x] O_RECEIVE_SULFUR_EGG - added to P_PROBLEM_SPELL_COMPONENTS -- [x] O_TREASURY_OPEN - connected to P_PROBLEM_GENIE - -### 8e: Rebuild and verify ✅ -- [x] Run check script - 0 orphans, 0 undefined (46 dead-ends are multi-source parsing artifacts) -- [x] Build with ./build.sh - succeeds -- [x] Commit fixes - ---- - -## 6. Gateway Process for Major Unlocks ✅ - -### 6a: Analyze crossing patterns (5+ lines) -- [x] **6a.1: Count outgoing lines from Magic Map** - - Magic Map → enables IoW gnomes, IoB boiling pool, Sacred Mountain cliffs, Realm of Dead (4+ destinations) -- [x] **6a.2: Count outgoing lines from trade items to gnome puzzles** - - Nightingale, Mint, Rabbit Foot, Ink, Stinky Flower → all feed into Five Senses Gnomes -- [x] **6a.3: Document other 5+ crossing points** - - Consequence nodes C1-C10 already serve as gateway abstractions - -### 6b: Create UNLOCK gateway nodes -- [x] **6b.1: Create `UNLOCK_ISLAND_TRAVEL` gateway** - - Place after O_RECEIVE_MAGIC_MAP - - All island destinations route through this node -- [x] **6b.2: Create `UNLOCK_GNOME_ACCESS` gateway** - - Place where trade items converge for gnome puzzles -- [x] **6b.3: Route connections through gateway nodes** - -### 6c: Build dangling node detection script -- [x] **6c.1: Create `scripts/check-dangling-nodes.sh`** - - Parse .mmd mermaid file - - Extract all nodes - - Identify nodes with no incoming edges (except START) - - Identify nodes with no outgoing edges (except END) - - Identify nodes referenced but never defined - - Output formatted report -- [x] **6c.2: Test script on current mermaid file** - - Found 31 orphan nodes, 45 dead-end nodes, 1 undefined reference - - Fixed undefined reference: O_TRADE_COAL_FOR_EGG → A_TRADE_COAL_FOR_EGG - -### 6d: Fix disconnected nodes -- [x] **6d.1: Run detection script** - - Found 5 real issues: O_RECEIVE_BEASTS_RING, P_PROBLEM_DARK_L2, A_SEARCH_BOOKSHELF, P_PROBLEM_CHARON, C4 -- [x] **6d.2: Research walkthroughs for each issue** - - Verified game flow for each orphan/dead-end -- [x] **6d.3: Add appropriate edges** - - Added 5 edges to fix real issues -- [x] **6d.4: Remaining 23 dead-ends are false positives** - - These are legitimate terminal states (parallel collectibles that feed into multi-source problem nodes) - ---- - -## 9. Fix Remaining 20 Dead-End Nodes 🔧 - -### 9a: Research each dead-end in walkthroughs ✅ -- [x] O_RECEIVE_BEASTS_RING - used to befriend Jollo -- [x] O_RECEIVE_LOVE_POEM - sent to Cassima via Sing-Sing -- [x] P_PROBLEM_DEATH - leads to A_SHOW_MIRROR_DEATH -- [x] O_RECEIVE_SCYTHE - cuts rose hedge (already has dashed line) -- [x] O_RECEIVE_COPPER_COIN - used with Jollo -- [x] O_RECEIVE_SACRED_WATER - spell component for rain -- [x] O_RECEIVE_ORACLE_VIAL - same as sacred water -- [x] P_PROBLEM_DARK_CAVE - leads to A_LIGHT_CAVE (already connected) -- [x] O_RECEIVE_DRINK_ME - shrinks to enter genie lamp -- [x] A_SHOW_RING_TO_JOLLO - leads to Jollo helping -- [x] O_RECEIVE_PEARL - trade for ring back at pawnshop -- [x] O_RECEIVE_SPIDER_WEB - LOVE word for gate riddle -- [x] O_RECEIVE_LOVE_POEM_IOW - sent to Cassima via Sing-Sing -- [x] P_PROBLEM_CASSIMA - leads to A_GIVE_DAGGER -- [x] O_RECEIVE_WHITE_ROSE_2 - final Sing-Sing delivery -- [x] O_RECEIVE_PASSAGE_HINT - find secret passage -- [x] O_SURVIVED - proceed to Nightmare horse -- [x] O_RECEIVE_GAUNTLET - challenge Death -- [x] O_FERRY_ACCESS - cross River Styx -- [x] O_RECEIVE_HANKERCHIEF - give to ghost boy - -### 9b: Add missing edges to chart -### 9c: Rebuild and verify zero dead-ends -### 9d: Commit changes - ---- - -## Build Command -`./build.sh` (not `mdbook build`) - ---- - -## 10. Reorganize Chart for Better Readability ✅ - -### 10a: Update skills with layout guidelines ✅ -- [x] **10a.1: Update `create-dependency-graph/SKILL.md`** with clustering rules - - Add pawn shop items clustering rule - - Add gnome items clustering rule - - Add fontsize=18 requirement -- [x] **10a.2: Update `qa-dependency-graph/SKILL.md`** with layout guidelines - - Add color palette section - - Add fan-out/fan-in flow structure - -### 10b: Reorganize kings-quest-vi-chart.mmd ✅ -- [x] **10b.1: Apply fontsize=18 to all nodes** -- [x] **10b.2: Restructure with proper fan-out/fan-in flow** -- [x] **10b.3: Group pawn shop items in Village cluster** - - Nightingale, Mint, Tinderbox, Flute, Paintbrush, Ink -- [x] **10b.4: Group gnome items under Isle of Wonder - Five Senses** -- [x] **10b.5: Apply index-based color palette consistently** - - area_1 (light blue): Isle of Crown - - area_2 (light orange): Isle of Wonder - - area_3 (light purple): Isle of Beast - - area_4 (light green): Isle of Mists - - area_5 (light amber): Sacred Mountain - - area_6 (light pink): Druid Island - - area_7 (light cyan): Realm of Dead - - area_8 (light grey): Village - -### 10c: Build and verify ✅ -- [x] **10c.1: Run `./build.sh` successfully** -- [x] **10c.2: Verify SVG renders correctly** -- [x] **10c.3: Commit changes** + + + +/home/noti/.nvm/versions/node/v22.17.1/bin/mmdc -i src/inspiration/monkey-island-1-chart.mmd -o src/inspiration/monkey-island-1-chart.svg 2>&1 | head -50 \ No newline at end of file