forge-openclaw-plugin 0.2.108 → 0.2.110

package/dist/server/server/src/health-weight-loss.js

@@ -4,6 +4,7 @@ import { getDatabase, runInTransaction } from "./db.js";
 import { getSettings } from "./repositories/settings.js";
 import { getDefaultUser, resolveUserForMutation } from "./repositories/users.js";
 import { readEncryptedSecret } from "./repositories/calendar.js";
+import { hallNiddkWeeklyRateKgToDailyEnergyAdjustment } from "../../src/lib/weight-loss-energy-model.js";
 const optionalNumberSchema = z
     .union([z.coerce.number().finite(), z.null()])
     .optional();
@@ -269,12 +270,31 @@ function average(values) {
     }
     return real.reduce((sum, value) => sum + value, 0) / real.length;
 }
-function metricTotal(metrics, key) {
+function median(values) {
+    const sorted = values
+        .filter((value) => Number.isFinite(value))
+        .sort((left, right) => left - right);
+    if (sorted.length === 0) {
+        return null;
+    }
+    const middle = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 1) {
+        return sorted[middle] ?? null;
+    }
+    return ((sorted[middle - 1] ?? 0) + (sorted[middle] ?? 0)) / 2;
+}
+function metricRecord(metrics, key) {
     const metric = metrics[key];
     if (!metric || typeof metric !== "object") {
         return null;
     }
-    const record = metric;
+    return metric;
+}
+function metricTotal(metrics, key) {
+    const record = metricRecord(metrics, key);
+    if (!record) {
+        return null;
+    }
     for (const field of ["total", "average", "latest"]) {
         const value = record[field];
         if (typeof value === "number" && Number.isFinite(value)) {
@@ -283,6 +303,31 @@ function metricTotal(metrics, key) {
     }
     return null;
 }
+function metricSampleCount(metrics, key) {
+    const value = metricRecord(metrics, key)?.sampleCount;
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function metricLatestSampleAt(metrics, key) {
+    const value = metricRecord(metrics, key)?.latestSampleAt;
+    return typeof value === "string" && value.trim().length > 0
+        ? value.trim()
+        : null;
+}
+function sampleHourOfDay(value) {
+    if (!value) {
+        return null;
+    }
+    const match = value.match(/T(\d{2}):/);
+    if (match?.[1]) {
+        const parsed = Number(match[1]);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        return null;
+    }
+    return date.getHours();
+}
 function parsePlanNoteNumber(notes, key) {
     if (!notes) {
         return null;
@@ -292,6 +337,30 @@ function parsePlanNoteNumber(notes, key) {
     const parsed = Number(match?.[1]?.trim());
     return Number.isFinite(parsed) ? parsed : null;
 }
+function parsePlanNoteText(notes, key) {
+    if (!notes) {
+        return null;
+    }
+    const escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const match = notes.match(new RegExp(`${escapedKey}=([^;]+)`));
+    return match?.[1]?.trim() ?? null;
+}
+function mifflinStJeorRestingKcal(input) {
+    if ((input.sex !== "male" && input.sex !== "female") ||
+        input.ageYears == null ||
+        input.ageYears <= 0 ||
+        input.heightCm == null ||
+        input.heightCm <= 0 ||
+        input.weightKg == null ||
+        input.weightKg <= 0) {
+        return null;
+    }
+    const sexAdjustment = input.sex === "male" ? 5 : -161;
+    return (10 * input.weightKg +
+        6.25 * input.heightCm -
+        5 * input.ageYears +
+        sexAdjustment);
+}
 function estimateStepActiveCaloriesKcal(input) {
     if (input.stepCount == null ||
         input.stepCount <= 0 ||
@@ -344,6 +413,8 @@ function buildStoredEnergyModel(input) {
             dateKey: row.date_key,
             activeEnergyKcal: metricTotal(metrics, "activeEnergyBurned"),
             restingEnergyKcal: metricTotal(metrics, "basalEnergyBurned"),
+            restingSampleCount: metricSampleCount(metrics, "basalEnergyBurned"),
+            restingLatestSampleAt: metricLatestSampleAt(metrics, "basalEnergyBurned"),
             exerciseMinutes: metricTotal(metrics, "appleExerciseTime"),
             stepCount: metricTotal(metrics, "stepCount")
         };
@@ -396,7 +467,59 @@ function buildStoredEnergyModel(input) {
             .get(input.userId, input.dayStartAt, input.dayEndAt)
         : null;
     const activeEnergyAverage = average(dailyHealthKit.map((day) => day.activeEnergyKcal));
-    const restingEnergyAverage = average(dailyHealthKit.map((day) => day.restingEnergyKcal));
+    const restingEvidenceDays = dailyHealthKit.filter((day) => day.restingEnergyKcal != null);
+    const restingExclusionReasons = [];
+    const qualifiedRestingDays = restingEvidenceDays.filter((day) => {
+        const reasons = [];
+        if (day.dateKey >= todayKey) {
+            reasons.push("current_day_or_future_day");
+        }
+        if ((day.restingSampleCount ?? 0) < 24) {
+            reasons.push(`sample_count_${day.restingSampleCount ?? 0}_below_24`);
+        }
+        const latestSampleHour = sampleHourOfDay(day.restingLatestSampleAt);
+        if (latestSampleHour == null) {
+            reasons.push("missing_latest_basal_sample");
+        }
+        else if (latestSampleHour < 20) {
+            reasons.push(`latest_basal_sample_hour_${latestSampleHour}_before_20`);
+        }
+        if (input.formulaRestingKcal != null && day.restingEnergyKcal != null) {
+            const lowThreshold = Math.max(input.formulaRestingKcal * 0.75, 1000);
+            if (day.restingEnergyKcal < lowThreshold) {
+                reasons.push(`basal_${round(day.restingEnergyKcal, 0)}_below_${round(lowThreshold, 0)}`);
+            }
+        }
+        if (reasons.length > 0) {
+            restingExclusionReasons.push(`${day.dateKey}: ${reasons.join(",")}`);
+            return false;
+        }
+        return true;
+    });
+    const wearableRestingKcal = median(qualifiedRestingDays
+        .map((day) => day.restingEnergyKcal)
+        .filter((value) => value != null));
+    const chosenRestingKcal = input.formulaRestingKcal ?? input.savedRestingKcal ?? null;
+    const chosenRestingSource = input.formulaRestingKcal != null
+        ? "mifflin_profile_baseline"
+        : input.savedRestingKcal != null
+            ? "saved_plan_legacy"
+            : null;
+    const restingConfidence = (() => {
+        if (input.formulaRestingKcal == null && input.savedRestingKcal != null) {
+            return "low";
+        }
+        if (input.formulaRestingKcal == null) {
+            return "low";
+        }
+        if (wearableRestingKcal != null &&
+            Math.abs(wearableRestingKcal - input.formulaRestingKcal) /
+                input.formulaRestingKcal >
+                0.15) {
+            return "review";
+        }
+        return qualifiedRestingDays.length > 0 ? "high" : "medium";
+    })();
     const workoutEnergyAverage = average([...workoutByDay.values()]);
     const movementCaloriesAverage = average([...movementByDay.values()]);
     const fallbackActiveBurn = workoutEnergyAverage != null || movementCaloriesAverage != null
@@ -477,13 +600,15 @@ function buildStoredEnergyModel(input) {
     const todayActiveCalories = input.dailyActiveOverride?.activeCaloriesKcal ??
         todayObservedActiveCalories ??
         baselineActiveCalories;
-    const todayTargetAdjustmentKcal = todayActiveCalories - baselineActiveCalories;
-    const estimatedTdeeKcal = activeBurnKcal != null && restingEnergyAverage != null
-        ? round(activeBurnKcal + restingEnergyAverage, 0)
+    const todayActiveSurplusKcal = Math.max(0, todayActiveCalories - baselineActiveCalories);
+    const todayActivityBufferKcal = todayActiveSurplusKcal * input.activityEatBackFraction;
+    const todayTargetAdjustmentKcal = todayActivityBufferKcal;
+    const estimatedTdeeKcal = activeBurnKcal != null && chosenRestingKcal != null
+        ? round(activeBurnKcal + chosenRestingKcal, 0)
         : input.inferredTdee;
     const hasHealthKitDailyActiveEnergy = activeEnergyAverage != null;
     const hasHealthKitEnergy = hasHealthKitDailyActiveEnergy ||
-        restingEnergyAverage != null ||
+        wearableRestingKcal != null ||
         workoutEnergyAverage != null;
     const hasMovementEnergy = movementCaloriesAverage != null;
     const sourceConfidence = activeEnergyAverage != null
@@ -493,7 +618,18 @@ function buildStoredEnergyModel(input) {
             : "target_inference_only";
     return {
         activeEnergyCalories: activeEnergyAverage != null ? round(activeEnergyAverage, 0) : null,
-        restingEnergyCalories: restingEnergyAverage != null ? round(restingEnergyAverage, 0) : null,
+        restingEnergyCalories: chosenRestingKcal != null ? round(chosenRestingKcal, 0) : null,
+        formulaRestingKcal: input.formulaRestingKcal != null
+            ? round(input.formulaRestingKcal, 0)
+            : null,
+        wearableRestingKcal: wearableRestingKcal != null ? round(wearableRestingKcal, 0) : null,
+        wearableRestingSource: wearableRestingKcal != null ? "healthkit_basal_energy" : null,
+        wearableRestingDayCount: restingEvidenceDays.length,
+        wearableRestingCoverageQualifiedDayCount: qualifiedRestingDays.length,
+        chosenRestingKcal: chosenRestingKcal != null ? round(chosenRestingKcal, 0) : null,
+        chosenRestingSource,
+        restingConfidence,
+        restingExclusionReasons,
         wearableConfidence: hasHealthKitEnergy
             ? "measured_directional"
             : "directional",
@@ -507,6 +643,9 @@ function buildStoredEnergyModel(input) {
             : null,
         todayActiveCaloriesSource: todayActiveSource,
         todayTargetAdjustmentKcal: round(todayTargetAdjustmentKcal, 0),
+        todayActiveSurplusKcal: round(todayActiveSurplusKcal, 0),
+        todayActivityBufferKcal: round(todayActivityBufferKcal, 0),
+        activityEatBackFraction: round(input.activityEatBackFraction, 2),
         todayWorkoutEnergyKcal: todayWorkoutEnergy != null ? round(todayWorkoutEnergy, 0) : null,
         todayMovementCaloriesKcal: todayMovementCalories != null ? round(todayMovementCalories, 0) : null,
         todayHealthKitActiveCaloriesKcal: todayHealthKitActive != null ? round(todayHealthKitActive, 0) : null,
@@ -1539,9 +1678,17 @@ export function getWeightLossViewData(userIds, options = {}) {
         ? round(recentTotals.calories / recentTrackedDays, 0)
         : 0;
     const inferredTdee = target.calorieTarget != null
-        ? round(target.calorieTarget + Math.abs(n(target.weeklyRateGoalKg)) * 1100, 0)
+        ? round(target.calorieTarget +
+            Math.abs(hallNiddkWeeklyRateKgToDailyEnergyAdjustment(target.weeklyRateGoalKg) ?? 0), 0)
         : null;
     const defaultActiveCalories = parsePlanNoteNumber(target.notes, "activity_kcal");
+    const formulaRestingKcal = mifflinStJeorRestingKcal({
+        sex: parsePlanNoteText(target.notes, "sex"),
+        ageYears: parsePlanNoteNumber(target.notes, "age_years"),
+        heightCm: parsePlanNoteNumber(target.notes, "height_cm"),
+        weightKg: weightTrend.latestWeightKg
+    });
+    const activityEatBackFraction = Math.min(1, Math.max(0, parsePlanNoteNumber(target.notes, "eat_back_fraction") ?? 0.5));
     const dailyActiveOverride = getDailyEnergyOverride(userId, todayKey);
     const energyModel = buildStoredEnergyModel({
         userId,
@@ -1554,7 +1701,10 @@ export function getWeightLossViewData(userIds, options = {}) {
         recentFoodLogDayCount: recentTrackedDays,
         defaultActiveCalories,
         latestWeightKg: weightTrend.latestWeightKg,
-        dailyActiveOverride
+        dailyActiveOverride,
+        formulaRestingKcal,
+        savedRestingKcal: parsePlanNoteNumber(target.notes, "resting_kcal"),
+        activityEatBackFraction
     });
     const todayTargetCalories = Math.max(0, round(target.calorieTarget + energyModel.todayTargetAdjustmentKcal, 0));
     const todayLedger = buildTodayLedger(logs, target, todayKey, todayTargetCalories, energyModel.todayTargetAdjustmentKcal, energyModel.todayActiveCaloriesSource);