mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-17 07:42:23 +00:00
feat(illness): correlation + recovery-gap engine
Add the retrospective correlation engine for illness episodes: a pre-onset
anomaly scan (deviation in robust SDs from the user's own median±MAD
baseline), the nadir / what-dropped across the active span, and the
recovery-gap (physiological return-to-baseline vs the felt-better marker).
CHRONIC_ONGOING is excluded from the gap. Every derived number is gated by
the shared coverage/confidence model — a thin signal asserts nothing rather
than showing a wrong figure.
The baseline window ends strictly before the pre-onset lookback, so an
episode's own days can never contaminate the baseline it is measured against.
Reads are DAY-native (rollup tier with a live-SQL fallback), reusing the
baseline engine's read path so the rollup-vs-live parity carries over.
Surfaces:
- GET /api/illness/episodes/{id}/correlation — per-episode findings (gated
Derived wire shape; red-flag escalation for sustained low SpO2 / fever).
- GET /api/illness/insights — cross-episode retrospective ("sick N times ·
typical recovery gap X days"), with the typical-gap withheld below the
min-sample floor. Retrospective only — never a predictor or diagnoser.
Reliability battery: golden-fixture recovery-gap math, rollup-vs-live parity,
baseline-contamination guard, thin-data / coverage-gate, red-flag escalation.
Born-gated + owner-scoped; server-authoritative DTO (iOS renders). i18n ×6.
This commit is contained in:
1 parent
a7b2b61b99
commit
745fa28c8b
16 files changed
+1737
No files matched your search
@@ -18,4 +18,17 @@ export const illnessKeys = {
|
||||
illnessEpisode: (id: string) => ["illness", "episode", id] as const,
|
||||
illnessDayLog: (episodeId: string, date: string) =>
|
||||
["illness", "day-log", episodeId, date] as const,
|
||||
/**
|
||||
* v1.18.1 P3 — the per-episode retrospective correlation findings
|
||||
* (pre-onset scan, nadir, recovery-gap). Server-authoritative; the read
|
||||
* is gated, so the surface pattern-matches `status` rather than recomputing.
|
||||
*/
|
||||
illnessCorrelation: (id: string) =>
|
||||
["illness", "correlation", id] as const,
|
||||
/**
|
||||
* v1.18.1 P3 — the cross-episode retrospective summary ("sick N times ·
|
||||
* typical recovery gap X days") over a trailing window in days.
|
||||
*/
|
||||
illnessInsights: (windowDays: number) =>
|
||||
["illness", "insights", windowDays] as const,
|
||||
};
|
||||
Reference in new issue
Block a user