fix(sources): ladder STRESS_SCORE so the source collapse stays deterministic

STRESS_SCORE has no source-priority ladder, so metricKeyForType returns null
and the SQL source collapse falls to an alphabetical rank-90 tiebreak. It is
safe today because the only producer is the COMPUTED HRV-derived proxy, but
the instant a device-native producer (Oura daily_stress) is enabled both rows
survive and blend nondeterministically.

Add a stress metric key with an OURA-above-COMPUTED default ladder, wire it
through metricKeyForType and RANKED_TYPES, and surface it in the Sources
settings (all six locales). A guard test asserts every RANKED_TYPES member
resolves to a non-null metric key so a future ranked type can't ship unladdered.
Regenerate the OpenAPI for the additive source-priority key.
This commit is contained in:
Marc-André Bombeck committed 2026-06-20 16:52:10 +02:00
1 parent 013241ba74
commit 56d8cf19c5
12 files changed
+154 -7

No files matched your search

+12
View File
@@ -131,6 +131,13 @@ export const SOURCE_PRIORITY_METRIC_KEYS = [
// `RECOVERY_SCORE` rows distinguished by source — this ladder lets the
// same picker resolve native-above-proxy without a second engine.
"recovery",
// v1.18.10 I-5 — native-vs-derived stress. HealthLog computes a COMPUTED
// HRV-derived `STRESS_SCORE` proxy; a device-native producer (Oura
// `daily_stress`) is the deferred second source. Laddering it now makes the
// picker deterministic the instant a second producer is enabled, instead of
// collapsing to the alphabetical rank-90 tiebreak. Single-producer today,
// so the ladder is a no-op until the second producer lands.
"stress",
] as const;
export type SourcePriorityMetricKey =
@@ -297,6 +304,11 @@ export const DEFAULT_SOURCE_PRIORITY: Required<MetricPriority> = {
// fallback for users without a strap. v1.17.0 — Oura readiness + Polar
// nightly recovery slot below WHOOP and above the computed proxy.
recovery: ["WHOOP", "OURA", "POLAR", "COMPUTED"],
// v1.18.10 I-5 — native-vs-derived stress. Oura's device-native
// `daily_stress` (the deferred second producer) outranks HealthLog's
// COMPUTED HRV-derived proxy; the proxy is the fallback for users without a
// device-native stress signal. Single-producer today.
stress: ["OURA", "COMPUTED"],
};
/**