Added - Omega Scorer Lite + Scenario Engine Integration
This release implements the core B2B demonstration features planned in v0.0.5, transforming RExSyn-Nexus-Light into an intelligent sales tool with scenario-driven simulations.
Core Features Implemented
-
Omega Scorer Lite (
backend/app/services/omega_scorer_lite.py)- Geometric mean algorithm: Ω = (I × P × (1-Δ))^(1/3)
- Integrity (I): confidence × validation_multiplier
- Resonance (P): 1 - normalized_pain (inverse of user pain metrics)
- Stability (1-Δ): consistency × exp(-error_count × 0.1)
- Grade boundaries: S++ (≥0.965), S+ (≥0.95), S (≥0.93), A (≥0.85), B (≥0.75), C (≥0.65), D (≥0.50), F (<0.50)
- Aligned with Full Edition scoring system
-
Scenario Engine (
backend/app/services/scenario_engine.py)- PERFECT: All metrics excellent (Ω=0.97, S++ grade), deployment approved
- DRIFT_DETECTED: Day 1-2 perfect, Day 3+ degraded (Ω=0.71, C grade), deployment blocked
- EMPATHY_FAIL: High user pain metrics (Ω=0.68, D grade), deployment blocked
- RANDOM: Original random behavior for testing
- 100% deterministic outcomes for repeatable demos
API Enhancements
-
PredictionConfig (
backend/app/api/v1/predict.py)- Added
simulation_scenariooptional parameter - Supports: "perfect", "drift_detected", "empathy_fail", "random"
- Added
-
PredictionResponse updates:
- Added
omega_preview: Early Omega score estimate with I/P/1-Δ breakdown - Added
scenario_active: Active simulation scenario indicator
- Added
-
/predictEndpoint Integration:- Calculates Omega score when
simulation_scenariospecified - Returns Omega breakdown in response for immediate feedback
- Logs scenario execution results for demo tracking
- Calculates Omega score when
Test Suite (14 tests, 100% passing)
- test_omega_scorer.py (6 tests):
- Perfect scenario validation (S++ grade)
- Empathy fail scenario (low resonance)
- Drift scenario (low stability)
- Grade boundary validation
- Validation failure penalty
- Serialization (to_dict)
Added - Comprehensive Planning & Documentation
Upgrade Specification (NEW)
- UPGRADE_SPEC_v0.1.0.md: 850+ line implementation guide for v0.1.0 release
- Omega Scorer Lite algorithm design with code examples
- Scenario Engine architecture (PERFECT, DRIFT_DETECTED, EMPATHY_FAIL, RANDOM modes)
- Visual Feedback System specifications (CSS + JavaScript)
- Security hardening roadmap with 8 dependency updates
- 4-week implementation timeline with success metrics
- File change summary and breaking changes analysis
Documentation Enhancements
-
README.md Overhaul:
- Version badge updated to v0.0.5 with architecture badge
- Enhanced overview highlighting v0.1.0 planning
- Updated roadmap with clear v0.0.5 → v0.1.0 → v0.2.0 path
- Clarified "planned" vs "active" feature status
-
CHANGELOG.md Structure:
- Added [Unreleased - v0.1.0] section for planned features
- v0.0.5 focuses on documentation and planning (not implementation)
- Clear distinction between current and future capabilities