Commit Graph

221 Commits

Author SHA1 Message Date
424bc47a67 Fix: Add missing edges for Styx, Skeleton Key, Scythe, Coal in KQVI chart 2026-03-19 22:11:35 -07:00
f60514b50d Fix undefined reference: O_TRADE_COAL_FOR_EGG → A_TRADE_COAL_FOR_EGG 2026-03-19 22:00:22 -07:00
e5413dc833 Start: Gateway process and dangling node detection 2026-03-19 21:42:43 -07:00
a38c41acf5 Complete KQVI chart overhaul: SVG rendering, pawn shop simplification, and cleanup
- Add build.sh wrapper script for SVG rendering via mermaid-cli
- Simplify pawn shop: remove trade chain, show items as UNLOCKED directly
- Add documented color palette for repeat areas
- Fix 16 orphaned nodes (input/output connectivity issues)
- Apply bigger subgraph titles (18px for Final Confrontation)
- Ensure only START/END outside subgraph groupings

Build: ./build.sh (not mdbook build)
2026-03-19 21:32:49 -07:00
1686ad756e Fix disconnected/siloed nodes in KQVI chart
Fixed problem nodes without outputs:
- P_PROBLEM_BOILING_POOL --> A_COOL_POOL
- P_PROBLEM_DARK_L2 --> A_LIGHT_TINDERBOX
- P_PROBLEM_STYX --> A_COLLECT_STYX_WATER
- P_PROBLEM_JOLLO_ROOM --> A_GIVE_LAMP_REPLICA

Connected action chains:
- A_GIVE_LAMP_REPLICA --> O_JOLLO_HELPS
- O_RECEIVE_JOLLO_TRUST -.-> P_PROBLEM_JOLLO_ROOM (optional prerequisite)
- A_SHOW_LETTER --> P_PROBLEM_VIZIER
- A_CASSIMA_FIGHTS --> P_PROBLEM_VIZIER

Fixed O_SPELL_READY connection:
- A_COLLECT_COMPONENTS --> O_SPELL_READY
- O_SPELL_READY --> A_CAST_CHARM_SPELL

Remaining 6 orphans are optional/narrative items or redundant definitions.
2026-03-19 21:28:43 -07:00
d6c784c8b2 KQVI chart: Move START/END outside subgraphs, add larger subgraph titles
Changes applied:
- 3e: START and END nodes now outside all subgraph groupings
- 3d: area_final renamed to area_1_final with <style> tag for larger font
- Fixed missing internal connections in maze_l2 and rod_styx subgraphs
2026-03-19 21:23:08 -07:00
f5c0bd0b87 Complete: Convert KQVI puzzle chart from PNG to SVG 2026-03-19 20:46:48 -07:00
76a3b0a001 Convert KQVI puzzle chart from PNG to SVG for crisp zoom rendering
- Add kings-quest-vi-chart.svg (550KB vector file)
- Update kings-quest-vi-chart-preview.png to high-quality 1200px preview
- Remove obsolete kings-quest-vi-chart-full.png
- Update markdown to link preview PNG to SVG for full vector quality
- SVG remains crisp at any zoom level
2026-03-19 20:46:42 -07:00
9242bc446a Re-render KQVI mermaid chart at higher resolution with source link
- Extract original mermaid code from git history (faa30b9)
- Create kings-quest-vi-chart.mmd with raw mermaid source
- Render preview at 3000px wide (247KB PNG)
- Render full-size at 6000px wide (657KB PNG)
- Add link to raw mermaid source file in markdown
- Also fix: set mermaid startOnLoad: false to prevent duplicate renders
2026-03-19 20:43:29 -07:00
45910128f6 Complete: Update todo list after mermaid to image migration 2026-03-19 20:37:25 -07:00
d21555f1d7 Replace embedded mermaid with rendered PNG images
- Render KQVI puzzle dependency chart as PNG (preview + full-size)
- Replace mermaid code block with image embed linking to full version
- Remove broken mermaid-lightbox.js from book.toml and delete file
- Update Chart Configuration section (was Mermaid Configuration)
- Images copied to src/inspiration/ for mdbook build
2026-03-19 20:37:09 -07:00
faa30b9285 Fix: Check if theme button elements exist before adding event listeners
The mermaid-init script was throwing 'Uncaught TypeError: can't access
property addEventListener, document.getElementById(...) is null' because
it tried to attach click handlers to theme toggle buttons (ayu, navy, coal,
light, rust) that may not exist on all pages.

Fixed by:
- Wrapping theme button event listener registration in null checks
- Using DOMContentLoaded fallback when document is still loading
- Keeping mermaid.initialize() call outside the check since it needs to
  run early with startOnLoad: true
2026-03-19 20:14:58 -07:00
917b550916 Add enlargable/zoomable mermaid lightbox for KQVI diagram
- Add mermaid-lightbox.js with click-to-expand modal functionality
- Hover shows 'View Full Size' button on mermaid diagrams
- Modal displays full diagram with dark overlay backdrop
- Escape key or click outside closes modal
- CSS fades in expand button on hover for discoverability
- Works with mdbook's mermaid preprocessor
2026-03-19 20:05:29 -07:00
2a54053675 Complete: Add mermaid rendering assets 2026-03-19 19:59:57 -07:00
8a446932de Complete: Fix disconnected action-outcome pairs and missing transitive dependencies in KQVI chart
- Add O_RECEIVE_STINKY_FLOWER --> A_GIVE_STINKY_FLOWER connection
- Add A_READ_BOOK_TO_OYSTER --> O_RECEIVE_PEARL connection
- Add A_PICK_ROTTEN_TOMATO and O_RECEIVE_ROTTEN_TOMATO nodes
- Fix A_GIVE_ROTTEN_TOMATO --> O_RECEIVE_SWAMP_OOZE connection
- Add A_SEARCH_POETRY_SHELF --> O_RECEIVE_LOVE_POEM_IOW connection
- Add O_RECEIVE_DANGLING_PARTICIPLE --> A_TRADE_PARTICIPLE_BOOK connection
- Fix A_GET_DANGLING_PARTICIPLE with prerequisite and outcome
- Add A_TALK_TO_GHOST_MOTHER --> O_RECEIVE_HANKERCHIEF connection
- Add C8 --> A_SEARCH_KNIGHT prerequisite
- Update class definitions for new nodes
- Configure mdbook-mermaid preprocessor properly
- Add future task: Implement Layered Abstraction
2026-03-19 19:59:18 -07:00
5f27b226db Complete: Finalize TODOS.md for KQVI rework 2026-03-19 19:27:59 -07:00
e64d2182fe Complete: Rework KQVI puzzle dependency chart with all 8 feedback points 2026-03-19 19:27:34 -07:00
ec4d81ac82 Complete: Configure mdbook mermaid support and create KQVI puzzle inventory 2026-03-19 19:21:41 -07:00
414fdfc059 Complete: KQVI puzzle dependency chart QA fixes and mdbook integration 2026-03-19 19:07:04 -07:00
69799a9cb9 Fix KQVI puzzle dependency chart QA issues: remove S17 undefined node, S19/S20 dead ends, add Pearl note 2026-03-19 19:06:10 -07:00
cf7b6dd036 Complete: KQVI dependency chart layout verification 2026-03-19 18:39:12 -07:00
cb182dafb7 Complete: KQVI dependency chart QA verification 2026-03-19 18:33:17 -07:00
4d7b22f3ff QA analysis of KQVI puzzle dependencies + fixes
- Created QA report identifying 5+ invalid dependencies:
  1. Village Phase: S3-S6 shown as sequential but are parallel paths
  2. Five Gnomes: Pearl not gated by gnome solutions
  3. Phase 6/7 ordering: Shield from Minotaur Maze required BEFORE archer
  4. Minotaur internal: S23/S24 and S20/S21 are parallel, not sequential

- Fixed main chart:
  - Village: Show parallel paths converging (S3,S4,S5,S6 → P4)
  - Five Gnomes: Pearl (S12) now independent, gnomes gate north path
  - Phase 6/7: Restructured to show Must do Minotaur Maze FIRST to get Shield
  - Added Phase 6b for return visit with Shield
  - Renumbered all subsequent phases
  - Updated Key Dependency Chains text
2026-03-19 18:32:15 -07:00
d38c4378f4 Complete: KQVI puzzle dependency chart 2026-03-19 18:24:26 -07:00
0dcb42de3c Complete: Acquire 3 KQVI walkthroughs 2026-03-19 18:20:45 -07:00
fc9eb47012 Add KQVI puzzle dependency chart project tasks 2026-03-19 18:16:18 -07:00
9e11c74065 Complete: Remaining restructure tasks - design notes, cross-reference index, worksheet, FAQ
- Add Design Process Notes to 5 puzzle taxonomy overviews
- Create cross-reference-index.md mapping 28 games to puzzle types
- Create quick-start-worksheet.md with design checklist and templates
- Create comprehensive FAQ with 10 common design questions answered
2026-03-19 15:38:49 -07:00
743aaf088e Create cross-reference index mapping games to puzzle types
- Table 1: Games → Puzzle Types (28 games catalogued)
- Table 2: Puzzle Type → Games with examples (organized by taxonomy)
- Category summary showing representative games per category
2026-03-19 15:37:46 -07:00
e7a2efe62d Add comprehensive TODO list for Puzzle Design Handbook restructure 2026-03-19 15:23:26 -07:00
d926595135 Organize adventure game resources into 7 category subdirectories
Created category structure:
- criticism/ (5 articles) - Design critiques and anti-patterns
- defense/ (2 articles) - Praise and genre defense
- puzzle-design/ (7 articles) - Puzzle mechanics and methodology
- technical/ (4 articles) - SCUMM and engineering history
- history/ (6 articles) - Genre evolution and decline analysis
- moon-logic/ (5 articles) - Moon logic puzzle psychology
- community/ (2 articles) - Community discussions and analysis

Each category has README.md with summaries and key themes.
Main index.md updated to link to all categories.
2026-03-19 14:37:45 -07:00
9e94e4192a Add 30 adventure game design articles to resources directory
Articles downloaded via webfetch from:
- Ron Gilbert (GrumpyGamer)
- FilFre (Jim Chambers)
- Game Developer (gamedeveloper.com)
- Various adventure game design blogs and communities

Includes index.md with descriptions for all saved resources.
5 URLs could not be fetched (rate limits, 403, 404).
2026-03-19 14:32:54 -07:00
ada195efad Complete: All puzzle type refactoring tasks marked done
All 22 puzzle type pages refactored to ≤400 lines with consistent template format.
mdbook build passes. Verification complete.
2026-03-19 14:01:26 -07:00
e598a785b4 Fix symbol-code-translation.md: use proper headers, add Index section
- Convert inline bold headers to proper ## headers for Core Mechanic and When to Use
- Add Index table to match template
- Add Symbol Code Translation and other types to skill best practices
2026-03-19 14:00:46 -07:00
1922709700 Complete: Tier 3 puzzle type refactoring (all 15 files) 2026-03-19 12:09:45 -07:00
eafcca6636 Refactor: symbol-code-translation.md 2026-03-19 12:09:19 -07:00
f08ec1d06a Refactor: observation-replay.md 2026-03-19 12:08:08 -07:00
7ee7101c77 Refactor: metaphor-literal.md 2026-03-19 12:08:00 -07:00
9679c4f480 Refactor: surreal-logic-bridge.md 2026-03-19 12:07:11 -07:00
4de8f9b7ba Refactor: escalating-combat-progression.md 2026-03-19 12:07:10 -07:00
7688449cf0 Refactor: robot-programming.md 2026-03-19 12:07:01 -07:00
8ed0d134d4 Refactor: multi-faction-diplomacy.md 2026-03-19 12:06:53 -07:00
d0357a7c51 Refactor: distraction-environmental-manipulation.md 2026-03-19 12:06:03 -07:00
ede2b9bad3 Refactor: class-specific-ritual.md 2026-03-19 12:05:57 -07:00
3643db8a08 Refactor: comedy-based-persuasion.md 2026-03-19 12:05:56 -07:00
6a086ddc5c Refactor: timed-consequence.md 2026-03-19 12:05:40 -07:00
bce59604ec Refactor: truth-revelation.md 2026-03-19 12:04:27 -07:00
8eadc6324f Refactor: multi-character-coordination.md 2026-03-19 12:03:06 -07:00
fe5981962f Refactor: cross-realm-logistics.md 2026-03-19 12:02:57 -07:00
b27168ed80 Refactor: cross-temporal-causality.md 2026-03-19 12:02:51 -07:00
cd4cf0e49f Complete: Tier 2 puzzle type refactoring 2026-03-19 11:57:03 -07:00