Upgrade VulnerabilityEngine to a multi-dimensional recovery model with Strain, Sleep, and Autonomic Recovery metrics

Author: Ashutosh0x

app/src/main/java/com/alphahealth/monitor/data/VulnerabilityEngine.kt

@@ -13,14 +13,19 @@ data class PredictiveRiskScore(
     val glycemicRiskPercent: Int,
     val thermalNutritionalWarning: String,
     val isDegradedState: Boolean = false,
-    val resolvedDeviceSource: String = "Smart Watch"
+    val resolvedDeviceSource: String = "Smart Watch",
+    
+    // Multi-dimensional Recovery Metrics, bringing parity with WHOOP v5.0
+    val strainScore: Float = 4.0f,            // 0.0 to 21.0 standard cardiovascular strain scale
+    val sleepCapacityPercent: Int = 85,       // 0% to 100% sleep restoration budget
+    val autonomicRecoveryPercent: Int = 85    // 0% to 100% vagal tone autonomic recovery capacity
 )
 
 class VulnerabilityEngine(private val context: Context) {
 
     /**
-     * Analyzes autonomic stability. Frames output around "Systemic Recovery Budget" to adhere
-     * to the 2026 FDA General Wellness guidelines (avoiding diagnostic clinical claims).
+     * Analyzes autonomic stability. Frames output around a multi-dimensional "Systemic Recovery Budget"
+     * (Strain, Sleep, and Autonomic Recovery) to adhere to 2026 FDA General Wellness guidelines.
      * Implements Dual-Wearable Conflict Resolution and Graceful Signal Degradation.
      */
     fun analyzeVulnerability(
@@ -42,7 +47,6 @@ class VulnerabilityEngine(private val context: Context) {
         var deviceSource = "Smart Watch"
 
         // 1. GRACEFUL SIGNAL DEGRADATION (WRIST SHIFT)
-        // Fall back to passive resting sleep metrics or mechanical trackers when optical sensor flatlines
         val actualEda: Float
         val actualHeartRate: Int
         if (isSignalDegraded) {
@@ -55,7 +59,6 @@ class VulnerabilityEngine(private val context: Context) {
         }
 
         // 2. DUAL-DEVICE WEARABLE RESOLUTION (RING VS WATCH)
-        // Nocturnal hours prioritize Ring thermal/skin contact; Active hours prioritize Watch optical
         val resolvedEda: Float
         val resolvedHydration: Float
         if (isNocturnal) {
@@ -93,18 +96,29 @@ class VulnerabilityEngine(private val context: Context) {
         var finalIndex = index.coerceIn(0, 100)
 
         var thermalWarning = "Thermal baselines stable."
+        var sleepApneaAdjustment = 0
         if (lastScannedFood != null && sleepApneaActive) {
             val calories = lastScannedFood.baselineCalories
             if (calories > 450) {
                 thermalWarning = "WARNING: Late-night calorie load (${calories} kcal) is correlated with a 0.4°C increase in overnight micro-thermal skin temperature and elevated Sleep Apnea clusters. Limit intake 3 hours prior to sleep."
                 finalIndex += 15
+                sleepApneaAdjustment = 20
             }
         }
 
         val finalIndexCoerced = finalIndex.coerceIn(0, 100)
-        val recoveryBudget = 100 - finalIndexCoerced
 
-        // FDA General Wellness compliance: Frame outputs strictly as Recovery capacity and Wellness Budgets
+        // Calculate Multidimensional Recovery telemetry (mirroring WHOOP v5.0 models)
+        // Strain: scaled to 0-21 based on active hours heart rate and EDA sweat surges
+        val rawStrain = ((actualHeartRate - 50f) / 100f * 15f) + (resolvedEda * 1.2f)
+        val strainScoreCalculated = rawStrain.coerceIn(0.0f, 21.0f)
+
+        // Sleep Capacity: affected by apnea occurrences, late-night ingestion thermal alerts, and baseline energy
+        val sleepCapacityCalculated = (avgEnergyScore - (if (sleepApneaActive) 25 else 0) - sleepApneaAdjustment).coerceIn(10, 100)
+
+        // Autonomic Recovery capacity: inverse of autonomic stress vulnerability
+        val recoveryCapacityCalculated = 100 - finalIndexCoerced
+
         val recommendation = when {
             finalIndexCoerced >= 70 -> {
                 "CRITICAL: Low Autonomic Recovery Budget detected. Glycemic Risk is at $glycemicRisk% after consuming ${lastScannedFood?.foodItemName ?: "recent food"}. Perform guided breathing to restore autonomic wellness."
@@ -132,7 +146,10 @@ class VulnerabilityEngine(private val context: Context) {
                 glycemicRiskPercent = glycemicRisk,
                 thermalNutritionalWarning = thermalWarning,
                 isDegradedState = isSignalDegraded,
-                resolvedDeviceSource = deviceSource
+                resolvedDeviceSource = deviceSource,
+                strainScore = strainScoreCalculated,
+                sleepCapacityPercent = sleepCapacityCalculated,
+                autonomicRecoveryPercent = recoveryCapacityCalculated
             )
         )
     }

app/src/test/java/com/alphahealth/monitor/data/VulnerabilityEngineTest.kt

@@ -30,6 +30,9 @@ class VulnerabilityEngineTest {
         assertEquals("Smart Watch", result.resolvedDeviceSource)
         assertEquals("Homeostasis Maintained", result.conditionRisk)
         assertEquals(15, result.vulnerabilityIndex)
+        assertTrue(result.strainScore >= 0.0f && result.strainScore <= 21.0f)
+        assertEquals(80, result.sleepCapacityPercent)
+        assertEquals(85, result.autonomicRecoveryPercent)
     }
 
     @Test