3 Commits

Author	SHA1	Message	Date
Michael Mainguy	e9ddf91b85	Implement trigger-based mission brief dismissal for VR gameplay ... Add mission briefing system that displays when entering VR and requires trigger pull to dismiss before gameplay begins. This prevents accidental weapon firing and provides clear mission objectives to players. ## Key Features - Mission brief displays on VR entry with objectives from directory.json - Ship controls disabled during briefing (movement, rotation, weapons) - Either controller trigger dismisses brief and starts game timer - First trigger pull does not fire weapons, only dismisses briefing - Subsequent trigger pulls fire weapons normally ## Implementation Details - Added MissionBrief class with mesh-based UI parented to ship - Ship class gains disableControls()/enableControls() methods - New mission brief trigger observable bypasses normal shoot handling - ControllerInput modified to allow triggers through when disabled - Level1 orchestrates control flow: disable → show brief → enable - Game timer and physics recording start only after dismissal ## Technical Changes - controllerInput.ts: Allow trigger events when controls disabled - ship.ts: Add control state tracking and mission brief observable - level1.ts: Integrate mission brief into XR initialization flow - missionBrief.ts: New class for displaying briefing with trigger detection - Fixed property name mismatch in level selection event dispatch - Added cache-busting for dev mode level loading - Exposed LevelRegistry to window for debugging 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-11-21 07:44:46 -06:00
Michael Mainguy	244a25fff5	Implement hybrid level storage system with JSON-based defaults and configurable orbit constraints ... Major changes: - Add LevelRegistry for managing default (JSON) and custom (localStorage) levels - Default levels now load from /public/levels/*.json files - Add 6 default level JSON files (rookie-training through final-challenge) - Implement version-based automatic cache invalidation - Add LevelVersionManager for tracking level updates - Add LevelStatsManager for performance tracking (completion rate, best time, etc.) - Add legacy migration tool for existing localStorage data - Update level selector UI with stats display and version badges - Add configurable orbit constraints per level (useOrbitConstraints flag) - Hide copy button in level selector UI (TODO: re-enable later) - Add extensive debug logging for velocity troubleshooting - Add cloud sync infrastructure interfaces (future-ready) Technical improvements: - Hybrid storage: immutable defaults from JSON, editable custom levels in localStorage - Automatic cache refresh when directory.json version changes - Cache API for offline support - Fresh start migration approach with export option - Level loading now initializes before router starts Physics configuration: - Add useOrbitConstraints flag to LevelConfig - Rookietraining.json uses constraints (velocities will create orbital motion) - Debug logging added to verify velocity application 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-11-11 18:40:01 -06:00
Michael Mainguy	0dc3c9d68d	Restructure codebase into logical subdirectories ... ## Major Reorganization Reorganized all 57 TypeScript files from flat src/ directory into logical subdirectories for improved maintainability and discoverability. ## New Directory Structure ``` src/ ├── core/ (4 files) │ └── Foundation modules: defaultScene, gameConfig, debug, router │ ├── ship/ (10 files) │ ├── Ship coordination and subsystems │ └── input/ - VR controller and keyboard input │ ├── levels/ (10 files) │ ├── config/ - Level schema, serialization, deserialization │ ├── generation/ - Level generator and editor │ └── ui/ - Level selector │ ├── environment/ (11 files) │ ├── asteroids/ - Rock factory and explosions │ ├── celestial/ - Suns, planets, textures │ ├── stations/ - Star base loading │ └── background/ - Stars, mirror, radar │ ├── ui/ (9 files) │ ├── hud/ - Scoreboard and status screen │ ├── screens/ - Login, settings, preloader │ └── widgets/ - Discord integration │ ├── replay/ (7 files) │ ├── Replay system components │ └── recording/ - Physics recording and storage │ ├── game/ (3 files) │ └── Game systems: stats, progression, demo │ ├── services/ (2 files) │ └── External integrations: auth, social │ └── utils/ (5 files) └── Shared utilities and helpers ``` ## Changes Made ### File Moves (57 files) - Core modules: 4 files → core/ - Ship system: 10 files → ship/ + ship/input/ - Level system: 10 files → levels/ (+ 3 subdirs) - Environment: 11 files → environment/ (+ 4 subdirs) - UI components: 9 files → ui/ (+ 3 subdirs) - Replay system: 7 files → replay/ + replay/recording/ - Game systems: 3 files → game/ - Services: 2 files → services/ - Utilities: 5 files → utils/ ### Import Path Updates - Updated ~200 import statements across all files - Fixed relative paths based on new directory structure - Fixed case-sensitive import issues (physicsRecorder, physicsStorage) - Ensured consistent lowercase filenames for imports ## Benefits 1. **Easy Navigation** - Related code grouped together 2. **Clear Boundaries** - Logical separation of concerns 3. **Scalability** - Easy pattern for adding new features 4. **Discoverability** - Find ship code in /ship, levels in /levels, etc. 5. **Maintainability** - Isolated modules easier to update 6. **No Circular Dependencies** - Clean dependency graph maintained ## Testing - All TypeScript compilation errors resolved - Build succeeds with new structure - Import paths verified and corrected - Case-sensitivity issues fixed 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-11-11 12:53:18 -06:00