Auto-sync from GitHub: RSM Simulator updates

README.md

@@ -10,12 +10,16 @@ pinned: false
 license: mit
 ---
 
-# 🔮 RSM Simulator
+# 🔮 RSM Simulator v2.2
 
 **Resonant Structures of Meaning: A Machine-Executable Ontology for Interpretive AI**
 
 This is an interactive demo of the RSM (Resonant Structures of Meaning) framework developed by the Flamehaven Initiative. RSM provides a machine-executable ontology for symbolic and interpretive AI across multiple cultural systems.
 
+[![Live Demo](https://img.shields.io/badge/🚀-Live%20Demo-blue)](https://huggingface.co/spaces/Flamehaven/rms-simulator)
+[![Paper](https://img.shields.io/badge/📄-Paper-green)](https://rsm-ontology.github.io)
+[![Source Code](https://img.shields.io/badge/💻-Source%20Code-orange)](https://github.com/flamehaven/rsm-implementation)
+
 ## 🎯 What is RSM?
 
 RSM comprises three core computational mechanisms:
@@ -24,41 +28,71 @@ RSM comprises three core computational mechanisms:
 2. **Resonance Index (RI)**: A quantitative metric of interpretive alignment and temporal stability
 3. **DriftSentinel**: Monitors longitudinal deviations in symbolic consistency
 
-## 🚀 How to Use
+## 🚀 Quick Start
+
+### Online Demo
+Simply visit our [Hugging Face Space](https://huggingface.co/spaces/Flamehaven/rms-simulator) to try RSM immediately!
+
+### Local Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/flamehaven/rsm-implementation
+cd rsm-implementation/huggingface_deployment
 
-1. **Select Symbolic Inputs**: Choose from Tarot cards, astrological signs, and Saju elements
-2. **Calculate RSM**: Click the calculate button or watch results update automatically
-3. **Interpret Results**: View the VME vector, Resonance Index, and cultural interpretation
+# Install dependencies
+pip install -r requirements.txt
+
+# Run the application
+python app.py
+```
+
+### Requirements
+- Python 3.8+
+- gradio>=5.0.0
+- numpy>=1.21.0
+- plotly>=5.0.0
+- python-dateutil>=2.8.0
 
 ## 🔬 Technical Features
 
 - **Real-time Calculation**: Instant symbolic reasoning with academic-grade reproducibility
+- **Interactive Visualizations**: 3D energy maps, harmony trends, and cultural balance wheels
 - **Multi-cultural Integration**: Seamless blending of Western and Eastern symbolic systems
-- **Interpretive Analysis**: AI-generated insights based on symbolic resonance patterns
+- **Interpretive Analysis**: User-friendly insights based on symbolic resonance patterns
 - **Drift Monitoring**: Stability assessment of symbolic interpretations
+- **Complete Reproducibility**: Fixed random seeds and deterministic computation (δ < 1e-12)
 
 ## 📚 Academic Background
 
-This demo is based on the research paper:
+This demo implements the research described in:
 
 **"Resonant Structures of Meaning: A Machine-Executable Ontology for Interpretive AI"**
-*Flamehaven Research Team (2025)*
+*Yun Kwansub, Flamehaven Initiative (2025)*
+
+**Version Correspondence:**
+- **Paper**: RSM v2.1 methodology, Simulator suite v2.2
+- **Implementation**: RSM Simulator v2.2 (this release)
+- **Hugging Face Space**: Live deployment of v2.2
 
 The framework adopts a **code-first methodology** where executable systems are treated as primary artifacts from which theoretical insights are derived.
 
-## 🔗 Links
+## 🔗 Links & Resources
 
-- [📄 Full Paper](https://rsm-ontology.github.io)
-- [💻 Source Code](https://github.com/flamehaven/rsm-implementation)
-- [🏛️ Flamehaven Initiative](https://flamehaven-papers.github.io)
-- [🚀 Live Demo](https://huggingface.co/spaces/Flamehaven/rms-simulator)
+- [🚀 **Live Demo**](https://huggingface.co/spaces/Flamehaven/rms-simulator) - Try RSM online
+- [📄 **Academic Paper**](https://rsm-ontology.github.io) - Full methodology and validation
+- [💻 **Source Code**](https://github.com/flamehaven/rsm-implementation) - Complete implementation
+- [🏛️ **Flamehaven Initiative**](https://flamehaven-papers.github.io) - Research organization
+- [📊 **Experimental Data**](https://github.com/flamehaven/rsm-implementation/tree/main/experiments) - Validation results
 
 ## 📊 Experimental Validation
 
 The RSM framework has been validated through comprehensive experiments:
 
 - **VME Normalization**: 100% accuracy (norm = 1.000 ± 0.000)
-- **RI Calibration**: False alignment rate = 0.000 (≤0.05 criterion met)
+- **RI Calibration**: MAE = 0.1196, False Alignment Rate = 0.000 (≤0.05 criterion met)
+- **DriftSentinel**: Mean DI2 = 0.013345 across 4 test scenarios
+- **LawBinder**: Mean ΔRI = +0.0110, SCG = 0.7600
 - **Reproducibility**: Perfect deterministic results (δ < 1e-12)
 - **Cross-cultural Validation**: Successful integration across symbolic systems
 
@@ -67,12 +101,39 @@ The RSM framework has been validated through comprehensive experiments:
 ```bibtex
 @article{flamehaven2025rsm,
   title={Resonant Structures of Meaning: A Machine-Executable Ontology for Interpretive AI},
-  author={Flamehaven Research Team},
+  author={Yun, Kwansub},
+  institution={Flamehaven Initiative},
   journal={arXiv preprint arXiv:2509.xxxxx},
-  year={2025}
+  year={2025},
+  note={Simulator suite v2.2 available at https://huggingface.co/spaces/Flamehaven/rms-simulator}
 }
 ```
 
 ## 🏷️ Tags
 
-`symbolic-ai` `ontology` `interpretive-ai` `cultural-systems` `tarot` `astrology` `saju` `resonance` `meaning-structures`
+`symbolic-ai` `ontology` `interpretive-ai` `cultural-systems` `tarot` `astrology` `saju` `resonance` `meaning-structures` `machine-executable` `reproducibility`
+
+## 📋 Version History
+
+- **v2.2** (Current): Enhanced user experience, interactive visualizations, security updates
+- **v2.1**: Core RSM methodology implementation, academic validation
+- **v2.0**: Initial release with basic functionality
+
+## 🔧 Reproducibility & Testing
+
+This implementation ensures complete reproducibility through:
+- Fixed random seeds (`numpy.random.seed(42)`)
+- Deterministic computation with tolerance δ < 1e-12
+- Complete audit trails with SHA-256 hashing
+- Versioned dependencies and test harness
+
+For validation, run the test suite:
+```bash
+python -m pytest tests/ -v
+```
+
+## 📞 Contact & Support
+
+- **Issues**: [GitHub Issues](https://github.com/flamehaven/rsm-implementation/issues)
+- **Email**: info@flamehaven.space
+- **Research Inquiries**: Flamehaven Initiative

app.py

@@ -16,6 +16,9 @@ import plotly.graph_objects as go
 import plotly.express as px
 from plotly.subplots import make_subplots
 
+
+# Fix random seed for reproducibility (δ < 1e-12)
+np.random.seed(42)
 # Add current directory to path for imports
 sys.path.append(os.path.dirname(os.path.abspath(__file__)))
 
@@ -568,22 +571,19 @@ def create_interface():
                     with gr.Column():
                         vme_3d_plot = gr.Plot(
                             label="🎯 Your Energy Map (3D)",
-                            value=None,
-                            info="Interactive 3D visualization of your symbol's energy signature"
+                            value=None
                         )
 
                     with gr.Column():
                         ri_trend_plot = gr.Plot(
                             label="📈 Harmony History",
-                            value=None,
-                            info="How your harmony scores change with different combinations"
+                            value=None
                         )
 
                 with gr.Row():
                     radar_plot = gr.Plot(
                         label="🌍 Cultural Balance Wheel",
-                        value=None,
-                        info="See how different traditions contribute to your reading"
+                        value=None
                     )
 
         # Event handlers