Release v1.21.0

CHANGELOG.md

@@ -2,6 +2,35 @@
 
 ## [Unreleased]
 
+## [1.21.0] — 2026-06-26 — Date-format preference, a far more connected Coach, and broad correctness work
+
+A feature release. The Coach reaches every data domain on demand, surfaces the cross-metric patterns the analytics tier already discovers, opens in context from any screen, and speaks with a warmer, forward-looking voice on one shared set of safety thresholds. Dates render in your chosen format everywhere. Two additive migrations (`0193` rollup x-rescale, `0192` date format); no breaking changes.
+
+### Added
+
+- A date-format preference in the profile — automatic (follows the language), day-month-year, month-day-year, or ISO — honoured across the app, including every date and date-time field, which now render in your chosen order regardless of the browser's locale.
+- The Coach answers from the full data picture: every metric domain on demand plus cycle and workouts, and it surfaces the discovered cross-metric correlations — medication adherence against symptoms, short sleep against the next morning's vitals, and so on — citing only what the analytics tier actually found.
+- Open the Coach in context from any metric page or insight card and it arrives already scoped to what you were looking at, with a relevant opening question.
+- "Learn more" pointers on the vitals tiles, the glucose panel, the resilience tile, and the lab biomarker detail link out to the matching guide; the Coach references the same guides and can no longer offer a link that doesn't exist.
+- Medication compliance and symptom severity are now first-class signals in the correlation engine, so an adherence dip that tracks a symptom flare can finally be surfaced.
+
+### Changed
+
+- The Coach connects signals into one story instead of listing metrics, looks ahead with gentle, ranged outlooks, ends an action turn by checking your confidence and offering a single doable step, and keeps affirmation earned. A closed acute-symptom clause points to prompt medical attention for crisis signs.
+- Critical-threshold numbers — blood pressure, fever, glucose — now come from one source, so the dashboard banner, the Coach, the status cards, and the notifications always state the same thresholds.
+- The trend regression is composed on an origin-rescaled, mean-centred basis, removing a floating-point cancellation on long windows; the rollup now matches the live computation to the last digit.
+- The daily AI usage budget is provider-aware: usage on your own OpenAI key, ChatGPT plan, or local model is no longer limited by the server-cost ceiling that applies to an operator-provided key.
+- The Coach builds its data snapshot once per turn and may take an extra reasoning round for a deep cross-metric question.
+- Discovered correlations are held to an effect-size floor and a confidence tier, and sparse personal signals are shrunk toward the baseline, so a real-but-trivial association is no longer stated as a confident driver.
+
+### Fixed
+
+- ChatGPT/OpenAI sign-in users no longer hit a spurious "daily limit reached" after only a couple of messages.
+- The symptom journal's recovery-return and the SpO2 red-flag count consecutive calendar days and are order-independent; the "two or more vitals out of band today" flag is keyed to your calendar day rather than UTC.
+- Withings activity sync and the medication-intake dedup issue far fewer queries on a long backfill.
+- The trend read returns the same boundary day whether served from the rollup or from a live query.
+- The native date primitives that ignored the locale are gone — every field routes through the format-aware inputs.
+
 ## [1.20.2] — 2026-06-26 — Hardening across insights, safety flags, and integrations
 
 A patch release. A broad pass over the server tier and the AI surfaces: a few correctness and safety fixes, a numerical hardening of the trend tier, and several smaller robustness and cost improvements. No schema changes.

docs/api/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: HealthLog API
-  version: 1.20.2
+  version: 1.21.0
   description: >-
     Self-hosted personal-health-tracking PWA — public API surface for the iOS native client and external ingest.
 
@@ -8184,6 +8184,15 @@ components:
             - AUTO
             - H12
             - H24
+        dateFormat:
+          description: Date-order display preference. AUTO follows the locale convention, DMY pins day-month-year (dd.MM.yyyy),
+            MDY pins month-day-year (MM/dd/yyyy), YMD pins ISO yyyy-MM-dd.
+          type: string
+          enum:
+            - AUTO
+            - DMY
+            - MDY
+            - YMD
         moodReminderEnabled:
           type: boolean
         fullName:
@@ -15784,6 +15793,15 @@ components:
             - H12
             - H24
           description: Hour-cycle display preference. AUTO follows the locale convention, H12 forces AM/PM, H24 forces 24-hour.
+        dateFormat:
+          type: string
+          enum:
+            - AUTO
+            - DMY
+            - MDY
+            - YMD
+          description: Date-order display preference. AUTO follows the locale convention, DMY pins day-month-year (dd.MM.yyyy),
+            MDY pins month-day-year (MM/dd/yyyy), YMD pins ISO yyyy-MM-dd.
         moodReminderEnabled:
           type: boolean
         fullName:
@@ -15815,6 +15833,7 @@ components:
         - locale
         - timezone
         - timeFormat
+        - dateFormat
         - moodReminderEnabled
         - fullName
         - insurerName
@@ -15885,6 +15904,15 @@ components:
             - H12
             - H24
           description: Hour-cycle display preference. AUTO follows the locale convention, H12 forces AM/PM, H24 forces 24-hour.
+        dateFormat:
+          type: string
+          enum:
+            - AUTO
+            - DMY
+            - MDY
+            - YMD
+          description: Date-order display preference. AUTO follows the locale convention, DMY pins day-month-year (dd.MM.yyyy),
+            MDY pins month-day-year (MM/dd/yyyy), YMD pins ISO yyyy-MM-dd.
         moodReminderEnabled:
           type: boolean
         fullName:
@@ -15912,6 +15940,7 @@ components:
         - locale
         - timezone
         - timeFormat
+        - dateFormat
         - moodReminderEnabled
         - fullName
         - insurerName

e2e/medications-wizard-daily.spec.ts

@@ -59,6 +59,9 @@ test.describe("medication wizard — daily", () => {
 
     // Step 4 — course window (today by default).
     await expectStep(page, 4);
+    // `DateField` keeps the ISO value on a hidden native date input
+    // (data-slot), while the visible overlay paints the locale-formatted
+    // string. Assert the committed ISO value on the hidden input.
     await expect(
       page.locator('[data-slot="course-window-starts"]'),
     ).toHaveValue(/^\d{4}-\d{2}-\d{2}$/);

e2e/medications-wizard-oneshot.spec.ts

@@ -62,7 +62,15 @@ test.describe("medication wizard — one-shot", () => {
     // Step 4 — course window. Set startsOn to a deterministic date so
     // the post body assertion below is stable.
     await expectStep(page, 4);
-    await page.locator('[data-slot="course-window-starts"]').fill("2026-10-15");
+    // `DateField` rides a visible text overlay (the data-testid) that parses
+    // a typed ISO string back to the canonical value; the hidden native input
+    // (data-slot) carries the committed ISO. Type into the overlay, then blur
+    // so the parse commits.
+    await page.getByTestId("course-window-starts-field").fill("2026-10-15");
+    await page.getByTestId("course-window-starts-field").blur();
+    await expect(
+      page.locator('[data-slot="course-window-starts"]'),
+    ).toHaveValue("2026-10-15");
     await clickNext(page);
 
     // Step 5 — pick Einmalig. The path compresses to 5 steps the

e2e/settings-mobile-consistency.spec.ts

@@ -48,7 +48,16 @@ test.describe("Settings mobile consistency (Pixel 5)", () => {
         )
         .evaluateAll((els) =>
           els.map((el) => {
-            const rect = el.getBoundingClientRect();
+            // DateField / DateTimeField front an sr-only native input with a
+            // formatted overlay; the 44px tap target is the wrapper, while the
+            // overlay sits inside the wrapper's border (≈42px). Measure the
+            // wrapper for any input inside one so the target-size reflects the
+            // real affordance, not the inner content box.
+            const wrapper = el.closest(
+              '[data-slot="date-field"],[data-slot="date-time-field"]',
+            );
+            const measured = wrapper ?? el;
+            const rect = measured.getBoundingClientRect();
             const style = getComputedStyle(el);
             return {
               id: el.id || el.getAttribute("name") || "",
@@ -64,17 +73,15 @@ test.describe("Settings mobile consistency (Pixel 5)", () => {
           }),
         )
     ).filter(
-      // The avatar profile-photo upload uses the accessible
-      // visually-hidden <input type="file"> pattern: the input itself
-      // is sr-only / zero-size and the real 44 px touch target is the
-      // styled label/button that triggers it. The touch-target sweep
-      // must measure that visible affordance, not the hidden input, so
-      // exempt file inputs that are hidden or collapsed to zero size.
-      (inp) =>
-        !(
-          inp.type === "file" &&
-          (inp.hidden || inp.height === 0 || inp.width === 0)
-        ),
+      // Some inputs use the accessible visually-hidden pattern: the input
+      // itself is sr-only / zero-size and the real 44 px touch target is a
+      // sibling visible affordance — the styled label/button for the avatar
+      // <input type="file">, and the formatted overlay that fronts the
+      // sr-only native <input type="date"|"datetime-local"> inside DateField /
+      // DateTimeField. The touch-target sweep must measure those visible
+      // affordances, not the hidden input, so exempt any input that is
+      // visually hidden or collapsed to zero size.
+      (inp) => !(inp.hidden || inp.height === 0 || inp.width === 0),
     );
 
     expect(formInputs.length).toBeGreaterThan(0);

messages/de.json

@@ -20,6 +20,7 @@
     "inactive": "Inaktiv",
     "disabled": "Deaktiviert",
     "networkError": "Netzwerkfehler",
+    "openDatePicker": "Datumsauswahl öffnen",
     "unknownError": "Unbekannter Fehler",
     "copied": "Kopiert!",
     "or": "oder",
@@ -33,7 +34,8 @@
     "retry": "Erneut versuchen",
     "reportIssue": "Fehler melden",
     "showPassword": "Passwort anzeigen",
-    "hidePassword": "Passwort verbergen"
+    "hidePassword": "Passwort verbergen",
+    "learnMore": "Mehr erfahren"
   },
   "doctorReport": {
     "title": "Gesundheitsbericht",
@@ -2223,7 +2225,7 @@
       "feedbackThanks": "Danke für das Signal.",
       "feedbackError": "Feedback konnte nicht gespeichert werden",
       "dailyLimitTitle": "Heute-Limit erreicht",
-      "dailyLimitBody": "Heute-Limit erreicht; Reset um 00:00 UTC.",
+      "dailyLimitBody": "Tageslimit erreicht. Das Budget setzt sich um Mitternacht (UTC) zurück.",
       "providerRateLimitTitle": "Provider rate-limited",
       "providerRateLimitBody": "Provider ist temporär überlastet; Reset in ~5 min.",
       "cluster": {
@@ -2278,14 +2280,15 @@
       "dictateError": "Spracheingabe konnte nicht gestartet werden. Prüfe die Mikrofonberechtigung und versuche es erneut.",
       "showConversations": "Unterhaltungen anzeigen",
       "hideConversations": "Unterhaltungen ausblenden",
-      "heroGreeting": "Wie kann ich dir helfen?",
+      "heroGreeting": "Frage mich etwas zu deinen Daten",
       "heroSubline": "Frag nach deinen Verläufen, Medikamenten oder Messwerten.",
       "thinkingElapsed": "{seconds}s",
       "thinkingDuration": "Nachgedacht für {seconds}s",
       "thinkingExpandAria": "Zeigen, was der Coach berücksichtigt hat",
       "thinkingDetail": "Beantwortet aus deinem Gesundheits-Snapshot.",
       "tokensUsed": "{count} Tokens",
-      "tokensUsedWithModel": "{count} Tokens · {model}"
+      "tokensUsedWithModel": "{count} Tokens · {model}",
+      "askAboutThis": "Den Coach dazu fragen"
     },
     "relativeJustNow": "gerade eben",
     "relativeMinutesAgoOne": "vor {count} Minute",
@@ -4120,6 +4123,16 @@
       "saved": "Stundenformat gespeichert.",
       "saveError": "Speichern des Stundenformats fehlgeschlagen."
     },
+    "dateFormat": {
+      "title": "Datumsformat",
+      "description": "Bestimmt die Reihenfolge von Tag, Monat und Jahr bei der Anzeige von Daten.",
+      "auto": "Automatisch (Sprache)",
+      "dmy": "TT.MM.JJJJ",
+      "mdy": "MM/TT/JJJJ",
+      "ymd": "JJJJ-MM-TT",
+      "saved": "Datumsformat gespeichert.",
+      "saveError": "Speichern des Datumsformats fehlgeschlagen."
+    },
     "username": "Benutzername",
     "height": "Körpergröße (cm)",
     "dateOfBirth": "Geburtsdatum",

messages/en.json

@@ -20,6 +20,7 @@
     "inactive": "Inactive",
     "disabled": "Disabled",
     "networkError": "Network error",
+    "openDatePicker": "Open date picker",
     "unknownError": "Unknown error",
     "copied": "Copied!",
     "or": "or",
@@ -33,7 +34,8 @@
     "retry": "Retry",
     "reportIssue": "Report issue",
     "showPassword": "Show password",
-    "hidePassword": "Hide password"
+    "hidePassword": "Hide password",
+    "learnMore": "Learn more"
   },
   "doctorReport": {
     "title": "Health Report",
@@ -2223,7 +2225,7 @@
       "feedbackThanks": "Thanks for the signal.",
       "feedbackError": "Could not save feedback",
       "dailyLimitTitle": "Daily limit reached",
-      "dailyLimitBody": "Daily limit reached; resets at 00:00 UTC.",
+      "dailyLimitBody": "Daily limit reached. The budget refreshes at midnight UTC.",
       "providerRateLimitTitle": "Provider rate-limited",
       "providerRateLimitBody": "Provider temporarily rate-limited; retry in ~5 min.",
       "cluster": {
@@ -2278,14 +2280,15 @@
       "dictateError": "Could not start voice input. Check microphone permission and try again.",
       "showConversations": "Show conversations",
       "hideConversations": "Hide conversations",
-      "heroGreeting": "How can I help you?",
+      "heroGreeting": "Ask me anything about your data",
       "heroSubline": "Ask about your trends, medications, or readings.",
       "thinkingElapsed": "{seconds}s",
       "thinkingDuration": "Thought for {seconds}s",
       "thinkingExpandAria": "Show what the Coach considered",
       "thinkingDetail": "Answered from your health snapshot.",
       "tokensUsed": "{count} tokens",
-      "tokensUsedWithModel": "{count} tokens · {model}"
+      "tokensUsedWithModel": "{count} tokens · {model}",
+      "askAboutThis": "Ask the coach about this"
     },
     "relativeJustNow": "just now",
     "relativeMinutesAgoOne": "{count} minute ago",
@@ -4120,6 +4123,16 @@
       "saved": "Hour format saved.",
       "saveError": "Saving the hour format failed."
     },
+    "dateFormat": {
+      "title": "Date format",
+      "description": "Controls the order of day, month and year when dates are shown.",
+      "auto": "Automatic (language)",
+      "dmy": "DD.MM.YYYY",
+      "mdy": "MM/DD/YYYY",
+      "ymd": "YYYY-MM-DD",
+      "saved": "Date format saved.",
+      "saveError": "Saving the date format failed."
+    },
     "username": "Username",
     "height": "Height (cm)",
     "dateOfBirth": "Date of birth",

messages/es.json

@@ -20,6 +20,7 @@
     "inactive": "Inactivo",
     "disabled": "Desactivado",
     "networkError": "Error de red",
+    "openDatePicker": "Abrir el selector de fecha",
     "unknownError": "Error desconocido",
     "copied": "¡Copiado!",
     "or": "o",
@@ -33,7 +34,8 @@
     "retry": "Reintentar",
     "reportIssue": "Reportar problema",
     "showPassword": "Mostrar contraseña",
-    "hidePassword": "Ocultar contraseña"
+    "hidePassword": "Ocultar contraseña",
+    "learnMore": "Más información"
   },
   "doctorReport": {
     "title": "Informe de salud",
@@ -2221,7 +2223,7 @@
       "feedbackThanks": "Gracias por la indicación.",
       "feedbackError": "No se pudo guardar el comentario",
       "dailyLimitTitle": "Límite diario alcanzado",
-      "dailyLimitBody": "Límite diario alcanzado; reinicio a las 00:00 UTC.",
+      "dailyLimitBody": "Límite diario alcanzado. El cupo se reinicia a medianoche (UTC).",
       "providerRateLimitTitle": "Proveedor con límite de tasa",
       "providerRateLimitBody": "El proveedor está temporalmente saturado; reinicio en ~5 min.",
       "settingsContextLabel": "Enviar contexto",
@@ -2278,14 +2280,15 @@
       "dictateError": "No se pudo iniciar la entrada de voz. Comprueba el permiso del micrófono e inténtalo de nuevo.",
       "showConversations": "Mostrar conversaciones",
       "hideConversations": "Ocultar conversaciones",
-      "heroGreeting": "¿En qué puedo ayudarte?",
+      "heroGreeting": "Pregúntame lo que quieras sobre tus datos",
       "heroSubline": "Pregunta por tus tendencias, medicamentos o mediciones.",
       "thinkingElapsed": "{seconds}s",
       "thinkingDuration": "Pensó durante {seconds}s",
       "thinkingExpandAria": "Mostrar lo que el Coach tuvo en cuenta",
       "thinkingDetail": "Respondido a partir de tu resumen de salud.",
       "tokensUsed": "{count} tokens",
-      "tokensUsedWithModel": "{count} tokens · {model}"
+      "tokensUsedWithModel": "{count} tokens · {model}",
+      "askAboutThis": "Pregúntale al coach sobre esto"
     },
     "relativeJustNow": "ahora mismo",
     "relativeMinutesAgoOne": "hace {count} minuto",
@@ -4120,6 +4123,16 @@
       "saved": "Formato horario guardado.",
       "saveError": "No se pudo guardar el formato horario."
     },
+    "dateFormat": {
+      "title": "Formato de fecha",
+      "description": "Determina el orden de día, mes y año al mostrar las fechas.",
+      "auto": "Automático (idioma)",
+      "dmy": "DD.MM.AAAA",
+      "mdy": "MM/DD/AAAA",
+      "ymd": "AAAA-MM-DD",
+      "saved": "Formato de fecha guardado.",
+      "saveError": "No se pudo guardar el formato de fecha."
+    },
     "username": "Nombre de usuario",
     "height": "Altura (cm)",
     "dateOfBirth": "Fecha de nacimiento",