An interactive web-based riddle game that challenges players to solve philosophical puzzles about AI, code agents, digital identity, and more. Featuring multiple riddles with dynamic hints, custom feedback, and a sleek mobile-optimized interface.
This is a beautifully designed Progressive Web App (PWA) with:
- Multiple Riddles: Collection of thought-provoking riddles including "The Gatekeeper's Riddle" and "The Mirror's Paradox"
- Elegant Dark Theme: Modern UI with gradient backgrounds and smooth animations
- Dynamic Hints System: Each riddle has its own progressive hints that update as you switch riddles
- Custom Feedback: Riddle-specific messages for wrong and close answers
- Attempt Tracking: Keep track of how many tries it takes to solve each riddle
- Responsive Design: Optimized for mobile with compact bubble button bar
- PWA Support: Works offline with service worker caching and manual refresh capability
- Modal Reveals: Dramatic answer reveal with thematic explanations
Visit The Gatekeeper's Riddle to start playing immediately!
Can you solve all the riddles? Test your logic, lateral thinking, and understanding of technology, philosophy, and digital identity. Each riddle explores different themes at the intersection of code, reflection, and consciousness. With More to come.
- Multiple Riddles: Expandable riddle system with easy addition of new challenges
- Smart Answer Detection: Accepts multiple variations of correct answers
- Close Answer Recognition: Get hints when you're on the right track
- Progress Tracking: Your attempts are saved per riddle
- Compact Mobile UI: Bubble button bar that fits under the input field
- Previous/Next Navigation: Easily move between riddles
- Riddle Selection: Choose any riddle from the selector modal
- Help & Hints: Access game instructions and progressive hints
- Request New Riddles: Built-in feedback system for suggesting riddles
- State-of-the-Art Database: SQLite-based system with 29 tables, full-text search, and enterprise features
- Modular Architecture: Separate CSS, JavaScript, and riddle modules
- PWA Capabilities: Installable, works offline, can be refreshed manually
- Service Worker: Intelligent caching for optimal performance
- No Dependencies: Zero external libraries or frameworks required (except database)
- ES6 Modules: Clean, maintainable code structure
- CLI Tools: Comprehensive command-line interface for database management
The GateKeepers Riddle/
├── LICENSE
├── _config.yml
├── docs
│ ├── AUTOMATED_RIDDLES.md
│ ├── BreakDown.md
│ ├── IMPLEMENTATION_SUMMARY.md
│ └── ISSUE_RIDDLE_REQUESTS.md
├── .github
│ ├── ISSUE_TEMPLATE
│ │ └── riddle_request.md
│ ├── PULL_REQUEST_TEMPLATE
│ │ └── riddle_request.md
│ ├── README.md
│ ├── agents
│ │ ├── repo-mapper.agent.md
│ │ └── riddle-finder.agent.md
│ └── workflows
│ ├── auto-assign-copilot.yml
│ ├── repo-mapper-agent.yml
│ └── riddle-finder-agent.yml
├── index.html
└── system
├── css
│ └── game.css
├── database
│ ├── COMPARISON.md
│ ├── QUICKSTART.md
│ ├── README.md
│ ├── cli
│ │ └── repo-db.js
│ ├── data
│ │ ├── ARCHITECTURE.md
│ │ ├── code-index.json
│ │ ├── metrics.json
│ │ └── repo-map.json
│ ├── lib
│ │ ├── database.js
│ │ ├── init_db.sh
│ │ └── migrate.js
│ ├── package.json
│ └── schema
│ └── core.sql
├── js
│ ├── auth.js
│ ├── game.js
│ └── sw.js
├── riddle.html
├── riddles
│ ├── riddle.template.js
│ └── riddles.js
├── scripts
│ └── l.h.s.script
└── storage
├── icon.logo.png
└── manifest.json18 directories, 41 files, ∞ Riddles
This repository now features a comprehensive database system that rivals PostgreSQL in functionality, transforming it into a true state-of-the-art mono-repo with enterprise-grade data management.
- 29 Interconnected Tables with full relational integrity
- SQLite Engine with WAL mode for performance
- Full-Text Search (FTS5) across files and functions
- ACID Transactions for data consistency
- 30+ Indexes for fast queries
- 6 Optimized Views for common operations
- CLI Management Tool with 8+ commands
- JavaScript API for programmatic access
- Migration Tools from JSON to database
- Backup & Restore capabilities
cd system/database
npm install
npm run init # Initialize database
npm run migrate # Migrate existing JSON data
npm run stats # View statisticsSee the Database Documentation for complete details.
- Clone or Download this repository
- Open
index.htmlin any modern web browser (or host it on a web server) - Read the riddle carefully
- Enter your answer in the input field
- Submit your guess and get feedback
- Use hints if you're stuck (click the hints button)
- Switch riddles using Previous/Next or the riddle selector
- Give up to reveal the answer if needed
Want to add your own riddle? It's easy!
- Copy the
riddle.template.jsfile - Rename it to
{your-riddle-name}.riddle.js - Fill in all the required fields:
id: Unique identifier (lowercase, no spaces)title: Display titletext: The riddle text (use backticks for multiline)correctAnswers: Array of valid answers (lowercase)closeAnswers: Array of near-miss answers (lowercase)hints: Array of 6+ progressive hintswrongAnswerFeedback: Message for incorrect answerscloseAnswerFeedback: Message for close answersexplanation: Why this is the answeranswer: Official answer to display
- Import your riddle in
riddles.js - Add it to the riddles array
- Test your riddle in the game!
export const riddle = {
id: 'my-riddle',
title: 'My Amazing Riddle',
text: `What walks on four legs in the morning,
two legs at noon,
and three legs in the evening?`,
correctAnswers: ['human', 'person', 'man'],
closeAnswers: ['animal', 'creature', 'being'],
hints: [
'Think about the stages of life',
'Morning, noon, and evening represent different times',
// ... more hints
],
wrongAnswerFeedback: 'Not quite. Think metaphorically...',
closeAnswerFeedback: 'You\'re warm! Consider the riddle\'s metaphor.',
explanation: 'Humans crawl as babies, walk on two legs as adults, and use a cane in old age.',
answer: 'A Human'
};The app uses a service worker to cache all resources, allowing you to play even without an internet connection.
If you need to force-update the app:
- Click the More button (three dots)
- Select Refresh App
- This clears all caches and reloads the latest version
On mobile devices, you can install this as a standalone app:
- iOS: Tap Share → Add to Home Screen
- Android: Tap Menu → Install App
Simply open index.html in a browser or use a local server:
# Python 3 (recommended)
python3 -m http.server 8080
# Node.js
npx http-serverThe service worker is configured to cache:
- HTML, CSS, and JavaScript files
- Riddle module files
- App icons and manifest
External resources (badges, CDN content) are intentionally not cached to keep cache size minimal.
Works on all modern browsers:
- Chrome/Edge (90+)
- Firefox (88+)
- Safari (14+)
- Mobile browsers (iOS Safari, Chrome Mobile)
We welcome contributions! Here are some ways to help:
- Submit new riddles via pull request (use the template!)
- Report bugs or suggest features via issues
- Improve documentation or add examples
- Enhance UI/UX with design improvements
This repository includes two intelligent automation systems plus a UI-initiated PR flow:
- UI PR Riddle Request: The game UI now opens a pull request using the
riddle_requestPR template. Expect the app feed to refresh in ~10 minutes after the PR is processed. No issue workflow is required. - UI Issue-based Riddle Request: The game UI now opens an issue using the
riddle_requestissue template which requests the Riddle Finder Agent to open a code-agent PR. The issue is automatically assigned to three Copilot agent accounts and one maintainer for Notes review; the repository workflow will trigger the Riddle Finder Agent, watch the generated PR, and approve/merge it when the agent work is complete (target: within 10 minutes). - Riddle Finder Agent: Automatically searches for and submits new riddles daily or when requested via an issue. See agent instructions and workflow.
- Repository Mapper Agent: Maintains comprehensive repository documentation and code maps. See agent instructions and workflow.
