Merge remote-tracking branch 'origin/main' into wip/v140-I

docs/api/openapi.yaml

@@ -3928,7 +3928,10 @@ paths:
         explicit `unit` token and a summary `stats` block. `bloodPressure` pairs systolic + diastolic (`secondary`)
         within ±5 min so one fetch renders the dual-line chart; `sleep` collapses per-stage rows into one per-night
         point carrying time-asleep in hours (`sleepStages` holds the per-stage breakdown) and is internally capped to
-        365 days. `glucose` values + `unit` resolve to the user's mg/dL|mmol/L preference. Auth via cookie or Bearer.
+        365 days. `glucose` values + `unit` resolve to the user's mg/dL|mmol/L preference. Where a metric has a
+        source-priority ladder (pulse, weight, SpO2, HRV, ...), each day shows the readings of the source the person's
+        ladder picks for that day, so a second provider never blends into or duplicates a day; a metric without a ladder
+        (glucose, body water, bone mass) keeps every source. Auth via cookie or Bearer.
       parameters:
         - in: query
           name: kind