# v1.4.20 marathon — state log Status: in flight Last update: 2026-05-10T15:00+02:00 > Previous milestone: v1.4.19 live (image digest > `sha256:b48f93874cdb…`, `/api/version=1.4.19`). > v1.4.20 = Insights redesign with AI Coach > (handoff at `~/Downloads/design_handoff_insights_redesign`). > v1.5 reserved for iOS app + Apple Health integration. ## Foundation — pre-flight before any feature work Per `.planning/v1420-marathon-handoff.md`, F1–F6 must complete before B1 dispatches. ### F0 — Commit dangling v1.4.19 reports + bootstrap v1.4.20 scaffold - [x] Commit phase-E1-report.md + phase-E3-report.md v1.4.19 updates - [x] STATE.md replaced with v1.4.20 scaffold; v1.4.19 archived to ROADMAP.md - [x] ROADMAP.md updated with v1.4.20 milestone + previous-milestone archive ### F1 — Branch model: long-lived `develop` - [x] Create `develop` from cleaned `main` HEAD (`a1cf9bc`) - [x] Push `develop` to origin (tracking set up) - [x] GHCR workflow verified — only `branches: [main]` + `tags: ['v*']` push paths build/publish; PRs to `main` build but do not push; develop is build-free - [x] All v1.4.20 commits target `develop`; release-merge to `main` only at Phase E - Detailed report: `.planning/phase-F1-report.md` ### F2 — Document branch + release model - [x] Extend `CONTRIBUTING.md` with branch flow + ASCII diagram (this branch) - [x] Mirror page on healthlog-docs at `/contributing/branch-model/` (`5d96861` on healthlog-docs/main) - [x] User-vs-contributor distinction explicit in both surfaces - Detailed report: `.planning/phase-F2-report.md` ### FX — User-facing artifact cleanup (PII + jargon + German leaks) Combined sweep across HealthLog main repo + healthlog-docs + healthlog-landing (F3 + F4 + new PII rule consolidated into one wave). - [x] HealthLog main repo: 20 files scrubbed, `a1cf9bc` on origin/main (CHANGELOG.md, docs/audit/v146 / v1414 / v1415 / v1416 / v1418 / v1419, docs/codex-protocol-spec.md, docs/migration/, docs/ops/) - [x] healthlog-docs: 7 files scrubbed, `782862b` on origin/main (api/ examples replaced "marc" → "alice", DE leaks fixed) - [x] healthlog-landing: 1 file scrubbed, `9b31083` on origin/main (JSON-LD author block depersonalised) - [x] GH releases v1.4.14–v1.4.19: republished bodies from cleaned CHANGELOG sections during Phase E pipeline - [ ] Source-comment sweep (`src/` has 191 `Marc` references in maintainer comments) — defer to v1.4.21 backlog as low-priority - [ ] DE+EN bilingual CHANGELOG entries (v1.4.15 era) — defer; larger rewrite, captured in v1.4.21 backlog - Detailed report: `.planning/phase-FX-report.md` ### F5 — Best-practice GitHub repo audit - [x] CODE_OF_CONDUCT.md (Contributor Covenant 2.1, `e7b6b27`) - [x] Issue + PR templates (`.github/ISSUE_TEMPLATE/*.yml`, `PULL_REQUEST_TEMPLATE.md`, `072941b`) - [x] Dependabot expanded to github-actions + docker (`779e5a3`) - [x] package.json metadata: description, license, homepage, repository, bugs, keywords (`f7977d1`) - [x] LOW carry-over (README badges, FUNDING.yml, repo-root tidy) deferred to `.planning/v1421-backlog.md` - Detailed report: `.planning/phase-F5-report.md` - Note: initial sub-agent dispatch hit a content-filter block on the CoC text; refactored to inline execution (download CoC verbatim from contributor-covenant.org). ### F6 — Multi-agent QA on new docs - [x] 38 docs site pages cross-checked against the live app (v1.4.19), CHANGELOG, `.env.example`, Dockerfile, docker-compose, docker-publish workflow - [x] CRITICAL fixed inline: `19eb8de` (S3 env-var names + arm64 build claim removed) on healthlog-docs/main - [x] HIGH fixed inline: `3d3ea21` (achievement count 38 → 59, `/admin/
` paths, AI rate-limit 2/h → 10/h, default-locale flip, comparison-overlay scope) on healthlog-docs/main - [x] 9 MED + 5 LOW deferred to `.planning/v1421-backlog.md` "Docs site audit" section - [x] Two flagged-but-uncertain items captured for maintainer review - Detailed report: `.planning/phase-F6-report.md` ## Wave B — Insights redesign with AI Coach (sequential) Per `.planning/phase-D-v1419-product-lead-review.md`. Each phase ships behind a feature flag and unlocks independently. ### B1 — Hero strip + Daily Briefing + Suggested-prompts (~3-5 days) - [x] Replace `` with new hero strip (greeting, action row + suggested-prompt strip; Daily Briefing card mounts full-width below the hero) - [x] New `src/components/insights/{hero-strip,daily-briefing, suggested-prompts}.tsx` - [x] Extend `aiInsightResponseSchema` with `dailyBriefing` (`paragraph`, `keyFindings[]`) - [x] PROMPT_VERSION bump 4.19.0 → 4.20.0 - [~] Apple Health gated tiles — descoped per `phase-D-v1419-product- lead-review.md` decision. The 4-vitals tile row from the artboard uses BP / Weight / Pulse / Mood (all data already in the app); HRV / Sleep / Resting-HR tiles defer to v1.5 / iOS app. The B1 tile row itself (Vitals at-a-glance) is deferred to a later B-phase since it duplicates the per-section status cards below — see B1 report for the rationale. - Detailed report: `.planning/phase-B1-v1420-report.md` (the older `phase-B1-report.md` is from the v1.4.18 achievements marathon) ### B2 — AI Coach panel + streaming chat + persistence (~5-7 days) Split into B2a (backend, complete) + B2b (drawer UI, complete). Both halves landed on `develop` under nine atomic commits total — five for the backend wave, four for the drawer wave plus a state-tick commit. - [x] New `POST /api/insights/chat` SSE-streaming endpoint - [x] New `GET /api/insights/chat` (list) + `GET/DELETE /api/insights/chat/[id]` (single + delete) - [x] New Prisma `CoachConversation` + `CoachMessage` + `CoachUsage` (encrypted content, GDPR cascade) - [x] Source-chip provenance attached to every assistant message - [x] Token-budget cap (25 000 tokens / user / UTC-day) + 20-turn conversation cap with summarised-history fold - [x] Prompt-injection + off-topic refusal pattern (EN+DE) - [x] Drawer overlay over `/insights`; full-page `/insights/coach` route deferred to v1.5 paired with the iOS app - [x] New `src/components/insights/coach-panel/*` — drawer shell, message thread, source chips, composer, history rail, sources rail, TanStack Query + SSE hooks - Detailed report: `.planning/phase-B2a-report.md` (backend); `.planning/phase-B2b-report.md` (drawer UI) ### B3 — Correlation discovery + Trends row with AI annotations (~3-5 days) - [x] 3 pre-defined hypotheses: BP×compliance, mood×pulse, weight×weekday - [x] New `src/lib/insights/correlations.ts` (Pearson + weekday-ANOVA; n >= 14 + p < 0.05 surfacing gate) - [x] New `src/components/insights/{correlation-card,correlation-row, trends-row,trend-annotation}.tsx` - [x] Confidence interval via Fisher z-transform; conservative phrasing locked in by code-review convention - [x] PROMPT_VERSION 4.20.0 → 4.20.1; new `trendAnnotations` block on the AI response schema (nullable + optional for legacy payloads) - [x] `/api/analytics` now emits `correlations: {bpCompliance, moodPulse, weightWeekday}` server-side - [x] `` + `` mounted on `/insights` between Daily Briefing and the Advisor card - Detailed report: `.planning/phase-B3-report.md` ### B4 — Weekly Report + Storyboard + Mobile passes (~3-4 days) - [x] PROMPT_VERSION 4.20.1 → 4.20.2; aiInsightResponseSchema gains `weeklyReport` + `storyboardAnnotations`; GROUND RULES 10/11 across EN + DE prompts - [x] New `/insights/report/[week]` route — newsletter-style printable surface with Summary / Going-well / Worth-watching / Tips / Data-quality sections; `window.print()` export via Tailwind `print:` variants - [x] Hero strip banner-card surfaces the fresh weeklyReport with Read · Share · Export PDF actions; Share uses Web Share API + clipboard fallback; Export deep-links to `?print=1` - [x] `` gains an additive `annotations[]` prop; `resolveAnnotationPositions()` pure helper maps date→pointIndex with a 7-day snap window and 24-char small-viewport truncation - [x] Coach drawer rail trays — chevron-button triggers on `` for SSR-test surface - Detailed report: `.planning/phase-B4-report.md` ### B5 — Personal AI Coach Health Score (~2-3 days) - [x] Composite Health Score (0-100): 30% BP-target + 20% weight-trend + 20% mood-stability + 30% compliance - [x] Three bands (≥75 green, 50–74 yellow, <50 red) - [x] "Ask the Coach" CTA opens B2 drawer with prefilled prompt - Detailed report: `.planning/phase-B5-report.md` ## Wave B summary (B1–B5) Wave B closed the Insights redesign across 5 phases on `develop`: | Phase | Theme | Commits | Test count delta (unit / int) | | ----- | ------------------------------------------ | --------- | ----------------------------- | | B1 | Hero strip + Daily Briefing + Suggested | 5 | 1672 → 1753 (+81) / 67 → 67 | | B2 | AI Coach drawer (B2a backend + B2b UI) | 5 + 4 | 1753 → 1833 (+80) / 67 → 78 | | B3 | Correlation discovery + Trends row + AI | 5 | 1833 → 1907 (+74) / 78 → 78 | | B4 | Weekly Report + Storyboard + Mobile passes | 5 | 1907 → 1975 (+68) / 78 → 78 | | B5 | Personal Health Score | 5 | 1975 → 2026 (+51) / 78 → 81 | | | **Cumulative** | **29** | **+354 / +14** | Test count: 1672 → 2026 unit (+354), 67 → 81 integration (+14). Test files 217 → 237. typecheck clean every phase; lint 13 baseline warnings unchanged. ## Wave D — Multi-agent QA + Product-Lead review - [x] code-reviewer (`.planning/phase-D-v1420-code-review.md`) - [x] security review (`.planning/phase-D-v1420-security-review.md`) - [x] design / UX review (`.planning/phase-D-v1420-design-review.md`) - [x] senior-dev review (`.planning/phase-D-v1420-senior-dev-review.md`) - [x] simplify (`.planning/phase-D-v1420-simplify-review.md`) - [x] Product Lead — v1.5 redesign plan (`.planning/phase-D-v1420-product-lead-review.md`) - [x] Reconcile applied CRITICAL + HIGH (13 of 13) + 6 MED inline; 22 MED + 16 LOW + 4 simplify-apply-maybe deferred to `.planning/v1421-backlog.md` "Phase D reconcile carry-over" section - Detailed report: `.planning/phase-D-v1420-reconcile-report.md` ## Phase E — Release v1.4.20 - [x] Pre-release verify (typecheck, lint, test, integration, format, build) — 2026 unit + 81 integration green - [x] Bump package.json + CHANGELOG (`aac8b5e chore(release): v1.4.20`) - [x] Sync Dependabot dep bumps from main → develop (`dd2ef57`) - [x] Release-merge develop → main (`666f6ee Release v1.4.20`) - [x] Tag + push v1.4.20 (annotated, `666f6ee`) - [x] GHCR build green (run `25633807964`, 4m02s, digest `sha256:b112a31947…`) - [x] Coolify deploy — auto-deploy webhook still missing on apps-01; host-side retag fallback used (same fault mode as v1.4.19) - [x] /api/version=1.4.20 confirmed (flipped 2026-05-10T16:49:25Z) - [x] Production smoke — all gated routes redirect 307 → `/auth/login` as expected for an unauthenticated request; `/api/version` and `/auth/login` 200 - [x] GH release published (https://github.com/MBombeck/HealthLog/releases/tag/v1.4.20) - [x] GH releases v1.4.14 → v1.4.19 republished from cleaned CHANGELOG sections (FX carry-over) - [x] Docs site sync (`0b83430` on healthlog-docs/main — version pins + ai-insights v1.4.20 callout) - [x] Landing site sync (`43ce4c7` on healthlog-landing/main — JSON-LD `softwareVersion` 1.4.20 + 3 new featureList entries) - [x] `docs/audit/v1420-summary.md` (release brief, `7f9ae21`) - [x] v1.5 plan refreshed — see `.planning/phase-D-v1420-product- lead-review.md` --- ## Status block — F0 (v1.4.20) - 2026-05-10T15:00+02:00 — F0 complete. Dangling v1.4.19 release reports (`phase-E1-report.md` + `phase-E3-report.md`) committed, STATE.md replaced with v1.4.20 scaffold (F1–F6 foundation + B1–B5 Insights redesign + Wave D + Phase E), ROADMAP.md updated to track v1.4.20 with v1.4.19 archived. Branch model unchanged for this commit (still `main`); F1 will introduce `develop`. ## Status block — B2a (v1.4.20) - 2026-05-10T16:15+02:00 — B2a complete. AI Coach backend landed in five atomic commits on `develop`: Prisma migration `0035_coach_conversations_v1420` adds `CoachConversation`, `CoachMessage`, and `CoachUsage` tables (cascade-on-user-delete); Coach helpers (types, persistence with AES-256-GCM message bodies, per-day 25 000-token budget ledger, EN+DE prompt-injection + off-topic refusal); SSE streaming endpoint at POST `/api/insights/chat` (idempotent on conversation creation only, 20-turn history fold, refusal short-circuit, provenance frame, done frame); list / fetch-single / delete endpoints with 404-not-403 ownership boundary. Tests: 1753 → 1781 unit (+28), 67 → 78 integration (+11). UI drawer (B2b) deferred to a separate dispatch. ## Status block — B2b (v1.4.20) - 2026-05-10T16:30+02:00 — B2b complete. AI Coach drawer landed in four atomic commits on `develop`: TanStack Query + SSE streaming hooks (`useCoachConversations`, `useCoachConversation`, `useDeleteCoachConversation`, `useSendCoachMessage`) with a pure `parseSseChunk()` helper for unit-testable frame parsing; drawer shell wrapped in `` with three-column layout on `lg+` (history rail · message thread · sources rail) and full-screen single-column on mobile; `` renders user / assistant bubbles + an in-flight streaming bubble with pinned-to-bottom auto-scroll; `` renders provenance as labels-only chips (metric · window · n-count, never raw values); `` composer with Enter / Cmd+Enter / Shift+Enter semantics, disabled mic placeholder ("voice arrives in v1.5"), and the "Coach replies are generated. Clinical decisions belong with your doctor." disclaimer; `` with substring filter and confirm-then-go delete; `` with the five Coach metric contracts; `/insights` page mounts the drawer with the hero strip's "Ask the coach" button + suggested-prompt chips driving open + prefill. Tests: 1781 → 1833 unit (+52, six new test files: `use-coach`, `source-chips`, `message-thread`, `coach-input`, `sources-rail`, `history-rail`). Integration count unchanged at 78. typecheck + lint clean (12 baseline warnings). ## Status block — Wave D reconcile (v1.4.20) - 2026-05-10T18:15+02:00 — Wave D reconcile complete. Six reviewers filed 0 CRIT · 12 HIGH · 28 MED · 22 LOW + 5 simplify-apply-yes + 4 simplify-apply-maybe + 3 simplify-apply-no across the code, security, design, senior-dev, simplify, and product-lead lenses. All 12 HIGH items + the design pushback on the disabled weekly- report button + 6 MED items + every simplify-apply-yes item landed inline across 11 atomic commits on `develop` (`e632e26` → `31fbf98`). 22 MED + 16 LOW + 4 simplify-apply-maybe deferred to `.planning/v1421-backlog.md` under "Phase D — v1.4.20 reconcile carry-over". Test counts unchanged (2026 unit / 81 integration); typecheck + lint clean; one observed integration-test flake on `coach-chat.test.ts` "round-trips" (not introduced by Phase-D — consistent re-runs pass). Phase E (release v1.4.20) unblocked. ## Status block — B5 (v1.4.20) - 2026-05-10T17:45+02:00 — B5 complete. Personal Health Score landed in five atomic commits on `develop`: pure formula library (`src/lib/analytics/health-score.ts`) with linear-regression slope, coefficient-of-variation, weight-trend alignment, mood stability, and compliance-rate helpers; the four-component composite scales remaining weights when sub-components are null (29 unit tests pin every shape); `/api/analytics` emits `healthScore: { score, band, components, delta } | null` with the wide-event annotation carrying score + band + delta; `` (220 px desktop, full-width mobile) with band-tinted progress bar, four sub-bars, "vs last week" delta line, score-aware "Ask the Coach" prefill ("Why is my health score X out of 100?"); `` flips to `lg:flex-row` and mounts the panel beside the title block when the analytics payload includes a score. Tests: 1975 → 2026 unit (+51), 78 → 81 integration (+3). typecheck + lint clean. Canonical sample (the integration's strong-positive seed): score 95, band green, components 90/100/89/100. Wave-B closed; Wave D dispatch next.