Commit Graph

215 Commits

Author SHA1 Message Date
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
c9198296f5 Refactor: memo-chain.md 2026-03-19 11:56:37 -07:00
14e432c3b5 Refactor: environmental-storytelling.md 2026-03-19 11:55:55 -07:00
863ce2e1fe Refactor: information-brokerage.md 2026-03-19 11:55:21 -07:00
135a3fd9d7 Refactor: sequential-construction.md 2026-03-19 11:54:38 -07:00
44d7936513 Fix broken link: meta-construction → sequential-construction 2026-03-19 11:53:20 -07:00
83f452b99f Update: TODOS.md - mark Tier 1 refactoring complete 2026-03-19 11:20:08 -07:00