v3.1.1 - Reality Initialization Bug Fix

🐛 Bug Fixes

Quantum Machine Positioning

• Fixed critical issue where entry actions were not executing on subsequent PositionMachine calls (#469d3b9)
• Reset realityInitialized flag before executing startOnReality to ensure proper state initialization
• Ensures entry actions are consistently executed when positioning machines in experimental/machine.go

🔧 Technical Details

The fix addresses a state management issue in the experimental QuantumMachine implementation where the realityInitialized flag would remain set after the first positioning call, causing entry actions to be skipped on subsequent calls. This could lead to incorrect state initialization in complex positioning scenarios.

---

Full Changelog: v3.1.0...v3.1.1

v 3.1.0 - Enhanced Quantum Machine Positioning

✨ New Features

Quantum Machine Positioning API

• PositionMachine: New method for quantum state positioning with two-path approach (static positioning vs full flow execution) (#c913127)
• PositionMachineOnInitial: Convenience method for positioning machines using universe's initial state (#7834c13)
• Canonical Name Positioning: Added PositionMachineByCanonicalName and PositionMachineOnInitialByCanonicalName methods for easier universe resolution (#0bbd011)

📝 Documentation

• Comprehensive API documentation for all QuantumMachine interface methods including Init, InitWithEvent, SendEvent, LoadSnapshot, GetSnapshot, and ReplayOnEntry (#56548c5)
• Enhanced README with additional badges (CodeQL, Dependabot, Contributing) (#8f62ea9, #d96532b)
• Added AI-powered exploration tool reference in README (#fc359aa)
• Complete documentation for new positioning APIs (#649cd33)

🔧 Improvements

• Extracted superposition snapshot logic into separate method for better code organization (#f9e97de)
• Preserved original event metadata for downstream universes in positioning flows
• Added comprehensive parameter validation and error handling for positioning methods
• Extracted universe not found error to constant for reuse

🧪 Testing

• Added comprehensive test coverage for all positioning scenarios (success and error cases)
• Tests cover invalid/empty canonical names, universe validation, and initial state requirements

---

Full Changelog: v3.0.0...3.1.0

v3.0.0 - Module Path Normalization and Enhanced Stability

🚀 Major Changes

• Documentation and examples updated to reflect new module path
• Coverage profiles regenerated with new paths

✨ New Features

• Comprehensive documentation suite including:
  • Core concepts and modeling guide
  • API reference and instrumentation details
  • Getting started guide with examples
  • Debugging and troubleshooting guides
• Enhanced test coverage for experimental features

🛠️ Improvements

• Code quality improvements across multiple modules
• Better error handling with formatted error messages
• Import statement standardization
• Enhanced bot initialization and parameter handling

🐛 Bug Fixes

• Fixed missing parameters in bot initialization
• Improved type assertions and error handling
• Removed unnecessary dependencies

📚 Documentation

• Complete documentation overhaul
• Updated README with proper links and badges
• Contributing guide integration