Flamehaven-Labs/QSOT-Compiler: [1.2.3] - 2025-12-23

[*] "Causal Horizon" Module & Open Source Release

This release marks the public open source debut of QSOT Compiler on GitHub with production-grade reliability improvements including comprehensive validation, optimization convergence checks, and expanded test coverage.

Added

• [Pub] Open Source Release: Published to https://github.com/flamehaven01/QSOT-Compiler under MIT License
• [UI] Prism Dashboard: Professional glassmorphism interface with Voidwalker dark theme (src/qsot/server/dashboard.py)
• [Viz] Real-time Visualizations: 4 interactive plots (Kirkwood-Dirac heatmap, axiom integrity, entanglement evolution, memory kernel)
• [AI] PyTorch Optimizer: Gradient descent engine for Kirkwood-Dirac quasi-probability minimization (src/qsot/core/optimizer.py)
• [Exp] Artifact Export System: One-click download of NPZ states, JSON reports, PNG plots, and lab protocol
• [Tool] Auto-Venv Launcher: run_dashboard.bat with automatic virtual environment setup and PyTorch installation
• [Doc] Screenshot Gallery: Added docs/ folder with dashboard screenshot and example outputs
• [Doc] Enhanced README: Complete rewrite with ASCII-safe symbols, installation guide, architecture diagram, troubleshooting section
• [Doc] Citation Support: Added BibTeX format and theoretical references (Transfer Tensor Method, Kirkwood-Dirac, Relativistic QI)
• [Valid] Density Matrix Validation: New validate_density_matrix() function with Hermitian, trace, and positive semi-definite checks
• [AI] Early Stopping: Optimizer now includes convergence detection with patience parameter and gradient clipping
• [Test] Expanded Coverage: Added test_physics.py with parametrized tests for relativity and entanglement modules

Changed

• [Docs] ASCII Safety: Replaced all Unicode emojis with ASCII alternatives for cross-platform compatibility (cp949/Windows safe)
• [Docs] Expanded Documentation: Added Prerequisites, Quick Start (Windows/Linux/macOS), CLI Mode examples, Dashboard Features guide
• [Build] Version Alignment: Updated all documentation to reflect v1.2.3 release
• [UI] Metric Display: Improved single-qubit vs. multipartite system detection (L1 Coherence vs. Logarithmic Negativity)
• [UX] Sidebar Layout: Reorganized configuration panel with clearer labels and helper tooltips
• [AI] Optimizer Output: Now includes convergence metadata and contextuality flag in results JSON

Fixed

• [Critical] Simulation Trigger: Resolved deadlock where RUN SIMULATION button was nested inside conditional display block
• [Bug] Variable Scope: Fixed NameError: velocity by correcting global variable scope in dashboard
• [UX] Silent Failures: Added verbose logging to launcher showing PyTorch download progress (~2.5GB first-time install)
• [Docs] Badge Accuracy: Corrected Python version badge (3.9+ instead of 3.10+), marked PyTorch as optional dependency
• [Robust] Error Handling: Enhanced error handling in optimizer with try-except blocks and graceful degradation
• [Stable] Gradient Clipping: Added max_norm=1.0 clipping to prevent optimization divergence