- Add homework-wte2-chapter4.md: Present Continuous with animals and pets
- Add homework-sbs-chapter3.md: Present Continuous with daily activities
- Add homework-sbs-chapter9.md: Simple Present with languages and nationalities
- Add homework-sbs-chapter10.md: Yes/No questions and negatives
- Add audio-scripts.md: Recording scripts for homework audio files
All homework follow simplified bilingual format (Chinese/English)
SBS homeworks follow diagnostic format with audio, text, and 6 questions
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add SBS chapter 10: Simple Present Yes/No Questions & Negatives
* Master Yes/No questions (Do/Does)
* Learn negatives (don't/doesn't)
* Practice short answers
* Days of the week vocabulary
* 125 vocabulary words, 17 phrases, 6 dialogs
- Add SBS 3-10 fusion chapter: Present Continuous vs Simple Present
* Contrast present continuous (NOW) vs simple present (ALWAYS)
* Combined 150 vocabulary words from both chapters
* 7 texts showing both tenses in context
* Comprehensive tense comparison exercises
- Add WTE2 chapter 4: More About Animals - Present Continuous
* Learn animal actions with present continuous (is/are + -ing)
* Fun Zoo story with Danny and elephants
* Phonics: L and R sounds
* Silly vs logical statements
* 47 vocabulary words, 7 dialogs, miming game activity
- Update book metadata files
* sbs.json: Add chapter 10 to available chapters
* sbs-fusion.json: Add chapter 3-10 fusion
* wte2.json: Add chapter 4
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add Hanyu Jiaocheng (Chinese course) book and chapters (3 & 4)
- Update TODO with completed game improvements
- Remove legacy TODO file
- Improve game modules with visual enhancements and bug fixes
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Render floating words as wooden trunks using Canvas instead of div elements
- Trunks scale proportionally to word length (longer words = bigger trunks)
- Add realistic wood texture with grain, rings, and highlights
- Display word text both on trunk and below for clarity
- Improve event handling for Canvas-based clickable elements
- Update styles and animations to work with Canvas elements
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- Reduce RiverRun game height from 100vh to 75vh for better screen fit
- Reduce AdventureReader game height from 100vh to 75vh
- Fix Mario level number display (was showing currentLevel + 1 twice)
- Updated HUD level display in Renderer.js
- Updated finish line flag level display in Renderer.js
- Add portable setup files and documentation
- Add new game modules: SentenceInvaders, ThematicQuestions
- Add new content: wte2 book, sbs chapters 2-3, wte2-2 chapter
- Update various game modules for improved compatibility
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Add visual enhancements including fireball animations, improved rendering, and physics updates across multiple game modules (WizardSpellCaster, MarioEducational, WordDiscovery, WordStorm, RiverRun, GrammarDiscovery).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major improvements:
- Add TTSHelper utility for text-to-speech functionality
- Enhance content compatibility scoring across all games
- Improve sentence extraction from multiple content sources
- Update all game modules to support diverse content formats
- Refine MarioEducational physics and rendering
- Polish UI styles and remove unused CSS
Games updated: AdventureReader, FillTheBlank, FlashcardLearning,
GrammarDiscovery, MarioEducational, QuizGame, RiverRun, WhackAMole,
WhackAMoleHard, WizardSpellCaster, WordDiscovery, WordStorm
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Implement click-to-speak functionality with visual pronunciation feedback in QuizGame and FlashcardLearning. When users click on vocabulary options or answers, the system plays native language audio (e.g., Chinese) and highlights the pronunciation (pinyin) with animation.
Features:
- TTS uses chapter language (zh-CN, en-US, etc.) for correct pronunciation
- Pronunciation text displayed under each quiz option
- Click on answer triggers TTS + 2s highlight animation
- Hover effects on clickable elements
- Auto-detect and use matching voice from speechSynthesis API
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Enhance Fill The Blank to work with both predefined exercises and auto-generated blanks from phrases:
- Add dual content mode support (predefined fill-in-blanks + auto-generated from phrases)
- Implement smart blank generation with max 20% word blanking and max 2 blanks per phrase
- Prefer vocabulary words for auto-blanking with intelligent word selection
- Add comprehensive JSDoc comments explaining both modes
- Improve compatibility scoring to prioritize predefined exercises
- Simplify input handling with data attributes for answers
- Fix WhackAMole and WhackAMoleHard games to use entire hole as clickable area
- Add pronunciation support for correct answers
- Improve error handling and user feedback
Games updated:
- FillTheBlank.js - Dual-mode content system with smart blank generation
- GrammarDiscovery.js - Code cleanup and consistency improvements
- WhackAMole.js - Entire hole clickable, not just text label
- WhackAMoleHard.js - Entire hole clickable, not just text label
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Issue: Players found it difficult to click precisely on the mole text,
especially on mobile or with fast-paced gameplay.
Fix:
- Changed click event from hole.mole (text only) to hole.element (entire hole circle)
- Makes the entire circular hole clickable, not just the word
- Much easier to target, especially on small screens
- Applied to both WhackAMole and WhackAMoleHard
Changes:
- src/games/WhackAMole.js:719 - Click on hole.element instead of hole.mole
- src/games/WhackAMoleHard.js:862 - Click on hole.element instead of hole.mole
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Issue: Game failed with "No suitable content available for flashcards"
even when chapter had vocabulary data.
Root Cause:
- FlashcardLearning.init() tried window.contentLoader.getContent() first
- This synchronous utils ContentLoader might not have content yet
- Game already receives content via dependencies from GameLoader
Fix:
- Prioritize this._content (from dependencies) first
- Only fallback to window.contentLoader if no dependency content
- Content is guaranteed to be loaded by GameLoader before init()
Changes:
- src/games/FlashcardLearning.js:178 - Reversed content loading priority
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
🐛 Bug Fixed:
"Module name must be a non-empty string" errors throughout RiverRun gameplay
🔍 Root Causes:
1. Module constructor not ensuring this.name is always defined
2. EventBus.emit() calls missing required third parameter (moduleName)
3. GameLoader may instantiate modules without providing a name
🔧 Solutions Applied:
**Constructor (lines 5, 11-14):**
- Added fallback: super(name || 'river-run', ['eventBus'])
- Explicit check: if (!this.name) this.name = 'river-run'
- Guarantees this.name is always 'river-run' if undefined
**_collectWord() (line 617):**
- Added missing third parameter to emit call
- Before: emit('game:score-update', {...})
- After: emit('game:score-update', {...}, this.name)
**_endGame() (line 719):**
- Added fallback for module name in emit
- emit('game:end', {...}, this.name || 'river-run')
✅ Result:
- All EventBus validation passes
- Game works during gameplay (collecting words, scoring)
- Game Over screen works without errors
- Play Again button works correctly
🎮 Tested:
- Launch game ✅
- Collect correct words ✅
- Miss words ✅
- Game over ✅
- Replay ✅🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
🔧 Changes:
- StoryReader now handles both old/new text structures (original_language vs content)
- Fixed memory leak: properly remove global event listeners on destroy
- Added null check in _hideWordPopup() to prevent errors after DOM cleanup
- Fixed chapter list display (was showing only one chapter instead of all)
- Smart routing: only load chapter content when needed
- Use module ContentLoader for proper content loading with vocabulary
🐛 Bugs Fixed:
1. "Cannot read properties of undefined (reading 'split')" - StoryReader couldn't handle texts with 'content' field
2. "Cannot read properties of null (reading 'style')" - Event listeners firing after game cleanup
3. Chapter list showing only book ID instead of all chapters
4. Game compatibility scores dropping to 0.00 after navigation
✨ Architecture Improvements:
- Event listener cleanup follows best practices
- Proper handler reference storage for removeEventListener
- Defensive programming with null checks
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Preserving current work:
- Modified DRS modules and factories
- Updated content and progress tracking
- Deprecated PhraseModule moved to archive
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add test-heavy.json book with 156 advanced academic vocabulary terms
- Add test-heavy-stress.json chapter for system stress testing
- Update UnifiedDRS with ContentDependencyAnalyzer integration
- Update VocabularyModule for unified persistence system
- Update progress saves with test data
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Simplified loadPersistedVocabularyData() to use only VocabularyProgressManager
- Updated calculateVocabularyProgress() to use unified data structure
- Removed old system references from knowledge panel data loading
- Fixed field names (drsDiscovered, drsMastered) for unified system
- Knowledge panel now displays vocabulary progress correctly
✅ TESTED: Vocabulary Knowledge panel working with unified system
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major Features:
• Smart vocabulary dependency analysis - only learn words needed for next content
• Discovered vs Mastered word tracking with self-assessment (Again/Hard/Good/Easy)
• Vocabulary Knowledge interface connected to DRS PrerequisiteEngine (not flashcard games)
• Smart Guide UI adaptation for vocabulary override with clear explanations
• Real PrerequisiteEngine with full method support replacing basic fallbacks
Technical Implementation:
• VocabularyModule: Added discovered words tracking + self-assessment scoring
• UnifiedDRS: Vocabulary override detection with Smart Guide signaling
• Vocabulary Knowledge: Reads from DRS only, shows discovered vs mastered stats
• Smart Guide: Adaptive UI showing "Vocabulary Practice (N words needed)" when overridden
• PrerequisiteEngine: Full initialization with analyzeChapter() method
Architecture Documentation:
• Added comprehensive "Intelligent Content Dependency System" to CLAUDE.md
• Content-driven vocabulary acquisition instead of arbitrary percentage-based forcing
• Complete implementation plan for smart content analysis and targeted learning
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
🎯 MAJOR ACHIEVEMENTS:
✅ Eliminated ALL mock/fallback responses - Real AI only
✅ Implemented strict scoring logic (0-20 wrong, 70-100 correct)
✅ Fixed multi-language translation support (Spanish bug resolved)
✅ Added comprehensive OpenAI → DeepSeek fallback system
✅ Created complete Open Analysis Modules suite
✅ Achieved 100% test validation accuracy
🔧 CORE CHANGES:
- IAEngine: Removed mock system, added environment variable support
- LLMValidator: Eliminated fallback responses, fail-hard approach
- Translation prompts: Fixed context.toLang parameter mapping
- Cache system: Temporarily disabled for accurate testing
🆕 NEW EXERCISE MODULES:
- TextAnalysisModule: Deep comprehension with AI coaching
- GrammarAnalysisModule: Grammar correction with explanations
- TranslationModule: Multi-language validation with context
📋 DOCUMENTATION:
- Updated CLAUDE.md with complete AI system status
- Added comprehensive cache management guide
- Included production deployment recommendations
- Documented 100% test validation results
🚀 PRODUCTION STATUS: READY
- Real AI scoring validated across all exercise types
- No fake responses possible - educational integrity ensured
- Multi-provider fallback working (OpenAI → DeepSeek)
- Comprehensive testing suite with 100% pass rate
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add AIReportSystem.js for detailed AI response capture and report generation
- Add AIReportInterface.js UI component for report access and export
- Integrate AI reporting into LLMValidator and SmartPreviewOrchestrator
- Add missing modules to Application.js configuration (unifiedDRS, smartPreviewOrchestrator)
- Create missing content/chapters/sbs.json for book metadata
- Enhance Application.js with debug logging for module loading
- Add multi-format export capabilities (text, HTML, JSON)
- Implement automatic learning insights extraction from AI feedback
- Add session management and performance tracking for AI reports
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major Changes:
- Moved legacy system to Legacy/ folder for archival
- Built new modular architecture with strict separation of concerns
- Created core system: Module, EventBus, ModuleLoader, Router
- Added Application bootstrap with auto-start functionality
- Implemented development server with ES6 modules support
- Created comprehensive documentation and project context
- Converted SBS-7-8 content to JSON format
- Copied all legacy games and content to new structure
New Architecture Features:
- Sealed modules with WeakMap private data
- Strict dependency injection system
- Event-driven communication only
- Inviolable responsibility patterns
- Auto-initialization without commands
- Component-based UI foundation ready
Technical Stack:
- Vanilla JS/HTML/CSS only
- ES6 modules with proper imports/exports
- HTTP development server (no file:// protocol)
- Modular CSS with component scoping
- Comprehensive error handling and debugging
Ready for Phase 2: Converting legacy modules to new architecture
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add 3 NCE content modules (NCE1-Lesson63-64, NCE2-Lesson3, NCE2-Lesson30)
- Integrate NCE modules in content-scanner, game-loader, navigation
- Add sentences extracted from stories for better game compatibility
- Add meteor spells to NCE1 (15+ word sentences for wizard game)
- Enhanced wizard spell effects with particles and casting animations
- Update games-config.json with NCE module configurations
Note: Architecture needs refactoring - too many interdependencies
Current state has issues that need systematic cleanup
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
🚨 MAJOR FIXES:
- Remove all hardcoded French templates (60+ lines of garbage)
- Replace with real sentence extraction from content
- Support story.chapters, rawContent.story, and sentences arrays
- Universal language support (English/Chinese, not French-only)
🎯 INTELLIGENT WORD SELECTION:
- Priority 1: Words from content vocabulary (educational value)
- Priority 2: Longest words if vocabulary not available
- Max 1-2 blanks per sentence (random) for readability
- Universal logic works for all languages (Chinese, English, etc.)
🔧 TECHNICAL IMPROVEMENTS:
- Clean punctuation before vocabulary matching
- Case-insensitive word comparison
- Proper fallback sentences with correct target language
- Better sentence filtering (min 3 words for blanks)
✅ RESULT:
- WTA1B1 now shows English sentences with Chinese translations
- Targets vocabulary words (turtle, umbrella, violet, etc.)
- No more "Je vois un..." French garbage
- Works universally for any language content
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
🎉 GOOD ANSWER ANIMATIONS:
- Enhanced explosion with color transitions (blue→green→orange→red)
- Screen shake effect for impact feedback
- Floating points popup (+10, +12, etc.) with smooth animation
- Gentle vibration pattern for positive reinforcement
❌ BAD ANSWER ANIMATIONS:
- Red shake animation for all falling words
- Answer panel flash with red glow effect
- Full screen red overlay flash
- Strong vibration pattern for negative feedback
🎨 TECHNICAL IMPROVEMENTS:
- New CSS keyframes: explode, wrongShake, wrongFlash, screenShake, pointsFloat
- Enhanced correctAnswer() method with screen shake and points popup
- Enhanced wrongAnswer() method with multi-element animations
- Vibration API integration for tactile feedback
- Proper animation cleanup and timing
🎯 UX ENHANCEMENT:
- Much more satisfying and engaging gameplay experience
- Clear visual distinction between success and failure
- Gamification elements that motivate continued play
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Separate punctuation from words during sentence parsing
- Add special handling for letter pairs (Aa, Bb, Cc, etc.)
- Add special handling for punctuation marks (., !, ?, :, etc.)
- Preserve punctuation display while enabling proper word-by-word navigation
- Fix alphabet learning display in SBS-1 content
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Enhanced Story Reader with text-to-story conversion methods
- Added support for simple texts and sentences in Story Reader
- Removed Text Reader game file (js/games/text-reader.js)
- Updated all configuration files to remove Text Reader references
- Modified game compatibility system to use Story Reader instead
- Updated test fixtures to reflect game changes
- Cleaned up debug/test HTML files
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
🎮 NEW GAMES:
- River Run: Endless runner with word collection and guaranteed target spawning
- Grammar Discovery: Focused grammar learning with 8-step rotation cycles
- Letter Discovery: Letter-first alphabet learning with progression system
- Enhanced Word Discovery: Shuffled practice mode with image support and auto-TTS
📚 NEW CONTENT MODULES:
- WTA1B-1: English letters U,V,T with pets vocabulary and Chinese translation
- SBS-1: English "To Be" introduction with comprehensive grammar lessons
- French Beginner Story: Story content for English speakers learning French
🔊 TTS ENHANCEMENTS:
- Story Reader: Multi-story support with TTS for sentences and individual words
- Adventure Reader: Auto-TTS for vocabulary popups and sentence modals
- Word Discovery: Immediate TTS playback with difficulty-based speed control
- Integrated SettingsManager compatibility across all games
🎯 GAMEPLAY IMPROVEMENTS:
- River Run: Target word guaranteed within 10 spawns, progressive spacing
- Story Reader: Story selector dropdown with independent progress tracking
- Adventure Reader: Fixed HUD overlap issue with proper viewport spacing
- Enhanced punctuation preservation in Story Reader word parsing
✨ SYSTEM UPDATES:
- Content scanner integration for all new modules
- Game loader mappings for seamless content discovery
- Simplified content titles: "WTA1B-1" and "SBS-1" for easy identification
- Comprehensive test files for isolated game development
🎉 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- New Word Discovery game with image support and practice phases
- Auto-play TTS on word appearance with speed control (0.7x-1.1x)
- Complete Settings page with TTS controls and debug interface
- Language standardization with BCP 47 codes (en-US, zh-CN, fr-FR)
- Media fallback handling for missing images and audio
- Settings Manager with voice selection and debug tools
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Remove all debug-*.js and test-*.* files from root directory
- Remove temporary conversion and example files
- Remove documentation files that cluttered root
- Remove admin and start batch files
- Keep only essential core files and organized directory structure
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major features:
- Add new Word Storm falling words vocabulary game
- Refactor CSS to modular architecture (global base + game injection)
- Fix template literal syntax errors causing loading failures
- Add comprehensive developer guidelines to prevent common mistakes
Technical changes:
- Word Storm: Complete game with falling words, scoring, levels, lives
- CSS Architecture: Move game-specific styles from global CSS to injectCSS()
- GameLoader: Add Word Storm mapping and improve error handling
- Navigation: Add Word Storm configuration
- Documentation: Add debugging guides and common pitfall prevention
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add intelligent content-game compatibility system with visual badges
- Fix Adventure Reader to work with Dragon's Pearl content structure
- Implement multi-column games grid for faster navigation
- Add pronunciation display for Chinese vocabulary and sentences
- Fix navigation breadcrumb to show proper hierarchy (Home > Levels > Content)
- Add back buttons to all navigation pages
- Improve JSONContentLoader to preserve story structure
- Add comprehensive debugging and diagnostic tools
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Replace legacy extractTexts() method with ultra-modular support
- Add support for texts with original_language/user_language format
- Add extractSentences() and extractVocabulary() methods for content flexibility
- Support reading individual sentences and vocabulary words as mini-texts
- Remove legacy content.content references, use content.original/translation
- Update full text display to show both original and translation
- Maintain backward compatibility through rawContent fallback
- Improve error messages to reflect ultra-modular requirements
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Complete test infrastructure with runners, helpers, and fixtures
- Unit tests for core modules: EnvConfig, ContentScanner, GameLoader
- Integration tests for proxy, content loading, and navigation
- Edge case tests covering data corruption, network failures, security
- Stress tests with 100+ concurrent requests and performance monitoring
- Test fixtures with malicious content samples and edge case data
- Comprehensive README with usage instructions and troubleshooting
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Fix WebSocket server to properly broadcast logs to all connected clients
- Integrate professional logging system with real-time WebSocket interface
- Add network status indicator with DigitalOcean Spaces connectivity
- Implement AWS Signature V4 authentication for private bucket access
- Add JSON content loader with backward compatibility to JS modules
- Restore navigation breadcrumb system with comprehensive logging
- Add multiple content formats: JSON + JS with automatic discovery
- Enhance top bar with logger toggle and network status indicator
- Remove deprecated temp-games module and clean up unused files
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Complete SPA architecture with dynamic module loading
- 9 different educational games (whack-a-mole, memory, quiz, etc.)
- Rich content system supporting multimedia (audio, images, video)
- Chinese study mode with character recognition
- Adaptive game system based on available content
- Content types: vocabulary, grammar, poems, fill-blanks, corrections
- AI-powered text evaluation for open-ended answers
- Flexible content schema with backward compatibility
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
