mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-17 23:52:24 +00:00
feat(illness): surface sleep as a context line on the recovery card
Adds a neutral sleep observation alongside the per-episode recovery gap: the user's usual asleep minutes over their well baseline vs the mean over the episode window, narrated as 'you slept more/less than usual' when the two diverge. It is an observation only — never a recovery claim, never a return track, and never part of the headline recovery-gap number. Per-night asleep totals come from the canonical night reconstruction over the baseline and episode windows, so a multi-source night (two writers for one sleep) is counted once, matching every other sleep surface. The observation withholds entirely on thin data — too few baseline or episode nights, or a delta below a 30-minute floor — so day-to-day jitter is never narrated as a finding. Additive optional DTO field; no schema, no migration. Two locale keys across the six bundles. Regenerate the OpenAPI contract from the Zod source.
This commit is contained in:
1 parent
e432b53e0d
commit
8d6d63cd1a
13 files changed
+562
-4
No files matched your search
@@ -202,6 +202,19 @@ const illnessRedFlag = z
|
||||
"A retrospective red-flag escalation (sustained low SpO2 or sustained fever) against absolute clinical floors. Copy must escalate ('seek care if this recurs'), never reassure.",
|
||||
});
|
||||
|
||||
const illnessSleepContext = z
|
||||
.object({
|
||||
baselineMeanMinutes: z.number(),
|
||||
episodeMeanMinutes: z.number(),
|
||||
deltaMinutes: z.number(),
|
||||
nightsCounted: z.number().int(),
|
||||
})
|
||||
.meta({
|
||||
id: "IllnessSleepContext",
|
||||
description:
|
||||
"A neutral sleep-as-context observation: the user's median asleep minutes over the well baseline vs the mean over the episode window, and their signed delta (positive = slept more than usual). A pure OBSERVATION surfaced alongside the gap — NEVER a recovery return and NEVER part of the headline recovery-gap. Withheld (the field is null) on thin sleep data or a sub-floor delta.",
|
||||
});
|
||||
|
||||
const illnessCorrelationValue = z
|
||||
.object({
|
||||
episodeId: z.string(),
|
||||
@@ -213,11 +226,12 @@ const illnessCorrelationValue = z
|
||||
feltBetterDay: z.string().nullable(),
|
||||
gapDriverType: z.string().nullable(),
|
||||
redFlags: z.array(illnessRedFlag),
|
||||
sleepContext: illnessSleepContext.nullable(),
|
||||
})
|
||||
.meta({
|
||||
id: "IllnessCorrelationValue",
|
||||
description:
|
||||
"The retrospective correlation findings for one episode: pre-onset anomaly scan, nadir, per-vital physiological returns (incl. the user-logged symptom-burden track, `type:FUNCTIONAL_IMPACT`), the headline recovery-gap (median of per-track gaps), the driving metric (`gapDriverType`), and any red flags.",
|
||||
"The retrospective correlation findings for one episode: pre-onset anomaly scan, nadir, per-vital physiological returns (incl. the user-logged symptom-burden track, `type:FUNCTIONAL_IMPACT`), the headline recovery-gap (median of per-track gaps), the driving metric (`gapDriverType`), any red flags, and an optional sleep-as-context observation (`sleepContext`, never in the gap).",
|
||||
});
|
||||
|
||||
const illnessCorrelationResponse = z
|
||||
|
||||
Reference in new issue
Block a user