mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-16 07:13:29 +00:00
feat(daily): finalise the morning digest when last night's sleep lands
The nightly insight pre-pass runs ~04:30, before last night's sleep has synced, so the morning digest and health score reference the day without the current sleep. Close the gap the event-driven way instead of an on-mount generation. A day's digest is now provisional until the sleep-dependent output has been regenerated with last night's sleep, and final after. The lifecycle is driven by a real marker (User.morningDigestRefreshedOn, the user-local date the refresh completed), not a heuristic: it flips the instant the refresh runs, ahead of the snapshot cache that feeds the sleep last-seen fallback. A day with no sleep device stays honestly provisional and keeps the sleep-pending note rather than showing a stale final score. When a completed sleep segment for last night lands from any of the three sleep transports — Withings sync-sleep, the WHOOP sync, the Apple-Health measurement batch — a debounced morning-digest-refresh job is enqueued. "Last night" is judged in the user's profile timezone, so a full-history re-sync never re-triggers for an old night. The queue singletonKey plus the marker collapse the many samples of one night, across all sources, into one refresh per user per local morning; the job re-runs the same comprehensive pipeline the nightly cron uses (forced, so the content-hash gate turns a no-change regen into a cheap no-op) and stamps the marker. A hard generation failure leaves the day provisional and hands recovery to the existing 45-minute briefing-retry machinery.
This commit is contained in:
1 parent
b7a6b4c898
commit
b6ded4d1f9
14 files changed
+790
-5
No files matched your search
@@ -0,0 +1,15 @@
|
||||
-- Morning-freshness marker (S4 of the unified daily-value system).
|
||||
--
|
||||
-- The nightly insight pre-pass runs ~04:30, before last night's sleep has
|
||||
-- synced, so the morning digest/health-score reference the day WITHOUT the
|
||||
-- current sleep. This column records the user-local YYYY-MM-DD (their profile
|
||||
-- timezone) for which the event-driven morning refresh has completed: last
|
||||
-- night's sleep arrived AND the sleep-dependent insight/score cache was
|
||||
-- regenerated with it. The daily digest reports `final` once this equals the
|
||||
-- user's current local date, `provisional` otherwise (honest degradation when
|
||||
-- sleep is late or never arrives). Stamped by the `morning-digest-refresh`
|
||||
-- pg-boss job the sleep-arrival trigger enqueues, debounced once per local
|
||||
-- morning. NULL for every existing row = provisional until the next sleep
|
||||
-- landing, which is the correct pre-feature reading.
|
||||
ALTER TABLE "users"
|
||||
ADD COLUMN "morning_digest_refreshed_on" TEXT;
|
||||
@@ -111,6 +111,15 @@ model User {
|
||||
// without re-paying for the findings. This stamps the day a re-roll ran so
|
||||
// the gate stays at most one extra call per day.
|
||||
insightsBriefingRerollDate String? @map("insights_briefing_reroll_date")
|
||||
// Morning-freshness marker: the user-local YYYY-MM-DD (their profile
|
||||
// timezone) for which the event-driven morning refresh has run — i.e. last
|
||||
// night's sleep has arrived AND the sleep-dependent insight/score cache was
|
||||
// regenerated with it. The daily digest reads `final` when this equals the
|
||||
// user's current local date, `provisional` otherwise. Stamped by the
|
||||
// `morning-digest-refresh` job the sleep-arrival trigger enqueues; the
|
||||
// string form makes the "same local morning" comparison timezone-honest
|
||||
// without a second timestamp read.
|
||||
morningDigestRefreshedOn String? @map("morning_digest_refreshed_on")
|
||||
// v1.4.36 W3 T3 — per-user AI Insights exclude-metrics list, mirrors
|
||||
// `coachPrefsJson.excludeMetrics`. The /api/insights/generate route
|
||||
// filters matching keys off `features` before JSON.stringify so the
|
||||
|
||||
Reference in new issue
Block a user