HealthLog/.planning/STATE.md

v1.4.19 marathon — state log

Status: phase-0-done Last update: 2026-05-10T12:48+02:00

Previous milestone: v1.4.18 live (image digest sha256:c636fca7db66…, /api/version=1.4.18). Next strategic milestone: v1.4.20 = Insights redesign with AI Coach (handoff at ~/Downloads/design_handoff_insights_redesign). v1.5 reserved for iOS app + Apple Health integration.

Phase 0 — Bootstrap

• STATE+ROADMAP rewritten for v1.4.19
• git status clean
• Result: ok / commit <sha>
• Detailed report: .planning/phase-0-report.md

Wave A — Bug fixes + polish (parallel buckets)

A1 — BD-Zielbereich constant 50% (4th attempt) ✅

• Live-DB audit of Marc's BP measurements (apps-01, db-pg8wggwogo8c4gc4ks0kk4ss-105148113251): 572 paired readings since 2022, last-30d = 50 %, last-7d = 50 %, all-time ≈ 10.8 %. Confirmed the headline 50 % cannot be the all-time value; it must be a copy of 30T.
• Root cause: analytics/route.ts set bpInTargetPct = windows.last30Days?.pct — literal copy of the 30T sub-value. computeBpInTargetWindows returned only 7d+30d so the headline could never legitimately differ.
• Fix: helper returns a third allTime window; route fetches all paired BP rows and routes the headline through allTime.
• TDD: 3 failing unit cases + 1 integration case red→green.
• pnpm test: 1640 / 1645 (5 pre-existing A3 failures unchanged).
• pnpm test:integration: 67 / 67.
• pnpm typecheck: clean. pnpm lint: 12 baseline 0 new.
• Commit a856272 pushed to origin/main first attempt.
• Detailed report: .planning/phase-A1-report.md

A2 — Charts mobile audit (axis-label overflow + X-axis density consistency) ✅

• Playwright headless against live PROD at Pixel 5, iPhone 12, iPhone SE, Galaxy Fold compact (280 px) — probe at .planning/v1419-a2-prod-probe.mjs, screenshots + JSON in /tmp/v1419-a2-prod/. Findings doc: .planning/phase-A2-mobile-findings.md.
• Pre-fix readings: Blood Pressure / Pulse / Mood / Medications cards all wrapped tabs to a 2nd row on iPhone 12 (header 92 → 188 px); fold-compact pushed Medications to 3 rows + horizontal overflow.
• Header layout fix — mobile-first stack (flex-col below sm, flex-row ≥ sm). Title + chips on row 1, range tabs + cog right-aligned on row 2 with flex-nowrap + px-2 sm:px-3 so tabs always own a single row at 280 px. Bucket-aggregation chip and comparison captions hide on mobile (hidden sm:inline-flex). Applied to HealthChart, MoodChart, MedicationComplianceChart.
• Universal x-axis tick-density helper at src/lib/charts/x-axis-density.ts + reactive viewport hook at src/hooks/use-viewport-width.ts. Caps visible ticks at 4 (Fold) / 6 (Pixel-5 / iPhone-12) / 8 (small tablet) / 10 (desktop). Wired into HealthChart, MoodChart, MedicationComplianceChart, ComplianceLineChart. Scatter correlation chart deliberately left alone (numeric x-axis with explicit ticks array).
• e2e regression at e2e/charts-mobile.spec.ts — runs only on chromium-mobile; asserts 1 row of tabs per card + ≤ 7 visible ticks per axis. Helper unit tests at src/lib/charts/__tests__/x-axis-density.test.ts (13 cases).
• pnpm test: 1637 / 1637 green. pnpm lint: 0 errors / 17 warnings (12 baseline + 5 from concurrent A3 work, none from A2). pnpm typecheck: A2 surface clean (one A3-owned error in src/app/insights/page.tsx unrelated to A2).
• Two commits on origin/main: 77a3ad3 (fix), a739085 (test). Note: parallel-agent race condition during the second commit caused a polluted intermediate commit 0cf23f3 to slip through with the wrong file content but the right message; the same content (mine) was re-committed cleanly as a739085 immediately after. 0cf23f3 was already pushed by another agent before the cleanup rebase could land, so it remains in history with a stale phase-A5-report.md payload — non-destructive but ugly. No --no-verify / --no-gpg-sign used.
• Detailed report: .planning/phase-A2-report.md

A3 — /insights polish + Comparison switch move ✅

• Remove Comparison-toggle from Dashboard (effectively landed via A4's b5e9a95 sweep — concurrent edits raced the working tree; the dashboard import + JSX use are both gone in origin/main).
• Re-position Comparison-toggle on /insights — folded into the hero meta band via new metaSlot prop on <InsightsPageHero>. Commit 60a91af.
• Consolidate refresh-buttons — onRegenerate no longer wired from page → advisor card. The hero owns the single page-level affordance; the per-recommendation Regenerate button (per v1.4.16 spec) stays. Commit 98a3d10.
• "Persönlicher AI Berater" placeholder subtitle removed — aiOverviewTitle no longer passed to <InsightAdvisorCard>, title prop made optional. Same commit 98a3d10.
• Small BP/Weight tile strip removed (-157 lines on src/app/insights/page.tsx plus dead helpers). Commit 335f288.
• Raw "metric: blood_pressure_sweet" leak fixed — STRIP_TOKEN_REGEX widened to [A-Za-z0-9_]+; PARSE_TOKEN_REGEX stays uppercase (render allowlist unchanged). Commit fa91a73.
• Tests: 9-case src/app/__tests__/insights-polish.test.ts pinning every guard. Commits 5360d3c (msg) + f2b21a4 (file). 1646 / 1646 green; lint + typecheck clean on touched files.
• Detailed report: .planning/phase-A3-report.md

A4 — AI prompt anpassen (no "Datengrundlage stark" as default first sentence)

• Edit src/lib/ai/prompts/insight-generator.ts
• Remove the auto-positive-first-sentence about data quality
• Only mention data quality when low (helpful: "based on limited data, treat with caution") not when fine
• Update tests
• Detailed report: .planning/phase-A4-report.md

A5 — Settings/Integrations status-UI consolidation (Withings + Mood Log)

• Single tag top-right per integration: "verbunden · vor X min"
• Remove redundant container with "verbunden / letzte erfolgreiche / letzter Versuch" / bottom "letzter Sync" — pick ONE place
• Mood Log container missing visual divider → add (consistency with Withings)
• Mobile-safe: tag wraps gracefully on Pixel 5
• Detailed report: .planning/phase-A5-report.md

A6 — Settings mobile audit + consistency

• Playwright headless audit /settings/account, /settings/profile, /settings/integrations, /settings/notifications, /settings/ai, /settings/dashboard, /settings/export
• Equalize input heights (Username/Email/Geburtsdatum)
• Sprache-Menü positioning consistent
• Right-side action buttons (Passwort Reset, Tool Neustarten) consistent vertical position
• Spacing between elements consistent
• Detailed report: .planning/phase-A6-report.md

A7 — Admin polish (Feedback, api-tokens 4th attempt, Zielwerte, i18n)

• Admin Feedback "offen/bestätigt/erledigt/archiviert" tabs mini-scrollbar removed (tabsListVariants now carries overflow-y-hidden; commit 088832a)
• /admin/api-tokens scrollbar 4th attempt: truncate-with- tooltip pattern on token-name, username, permission badge; table-fixed + colgroup widths on desktop table; e2e regression walks every element inside the mobile card-list (commit dd8212e)
• /admin/api-tokens "Einklappen" button removed (commit 7a70db6)
• Admin Zielwerte page: space-y-8 → space-y-6 on outer wrapper (commit 6507646)
• Translate Zielwerte status labels: 11 targets.label.<TYPE> entries + 41 targets.status.<key> entries in EN + DE; page uses STATUS_CATEGORY_KEY map to normalise server strings (commit 90a109d)
• Result: ok / 5 commits on origin/main, 1658 tests green
• Detailed report: .planning/phase-A7-report.md

Status block — A7 (v1.4.19)

• 2026-05-09T13:22+02:00 — A7 complete. Five atomic commits (088832a feedback tab strip, dd8212e api-tokens 4th-attempt truncate+tooltip, 7a70db6 Einklappen removal, 6507646 Zielwerte whitespace, 90a109d Zielwerte i18n) on origin/main via worktree /Users/marc/Projects/HealthLog-a7. Rebased once onto ef67da5 (A3 report) before push, no rebase conflicts. All pre-commit hooks green; pnpm test = 1658/1658, pnpm typecheck clean, pnpm lint baseline (0 errors / 12 pre-existing warnings). Touched only A7 surfaces: src/components/ui/tabs.tsx (shared primitive — feedback strip is one consumer), feedback section un-touched directly, src/components/admin/api-token-overview-section.tsx, src/app/targets/page.tsx, messages/{en,de}.json, i18n integrity test allowlist. Did NOT touch src/components/settings/*, src/lib/insights/*, src/lib/ai/*, src/components/charts/*, src/components/insights/*. No new dependencies.

A8 — Quality-of-life audit (write-only, fix-set deferred to inline B agent)

• Audit descriptions correctness across all pages
• Find redundancies + missing labels
• Find UI inconsistencies (text styling, spacing, button alignment)
• Output prioritized list for inline fixing
• Detailed report: .planning/phase-A8-quality-findings.md

Wave B — Apply A8 findings (after A8 completes)

• Fix CRITICAL/HIGH from quality-of-life audit
• Detailed report: .planning/phase-B-report.md

Wave D — Multi-agent QA + Product-Lead review

• code-reviewer
• security review
• design / UX review
• senior-dev review
• simplify
• Product Lead — strategic for v1.4.20 (Insights redesign roadmap, AI Coach feasibility)
• Reconcile applies CRITICAL/HIGH inline
• Detailed report: .planning/phase-D-report.md + product-lead-review.md

Phase E — Release v1.4.19

• Pre-release verify
• Bump package.json + CHANGELOG
• Tag + push v1.4.19
• GHCR build green
• Coolify deploy
• /api/version=1.4.19 confirmed
• Production smoke
• GH release
• Docs site + landing site sync
• docs/audit/v1419-summary.md (Marc-Brief)
• Detailed report: .planning/phase-E-report.md

---

Status block — Phase 0 (v1.4.19)

• 2026-05-10T12:48+02:00 — Phase 0 complete. STATE.md + ROADMAP.md scaffolded for v1.4.19 marathon (Wave A: A1 BD-Zielbereich constant 50% 4th attempt, A2 charts mobile audit + universal X-tick-density helper, A3 /insights polish + Comparison-toggle relocation, A4 AI-prompt rework, A5 Settings/Integrations status-UI consolidation, A6 Settings mobile audit, A7 Admin polish, A8 quality-of-life write-only audit; Wave B applies A8 findings; Wave D multi-agent QA

  • Product-Lead briefed for v1.4.20 Insights redesign + AI Coach; Phase E release). Previous v1.4.18 / v1.4.17 / v1.4.16 entries archived above. Tracked tree clean on entry; four untracked stale dotted-segment route directories (src/app/api/export/{full-backup.json,measurements.csv, medications.csv,mood.csv}/) left in place — same call as v1.4.16 / v1.4.18 Phase 0, they belong to previous milestones. Phase 0 commit contains only .planning/STATE.md, .planning/ROADMAP.md, .planning/phase-0-report.md. v1.4.20 reserved for Insights redesign with AI Coach (handoff at ~/Downloads/design_handoff_insights_redesign); v1.5 reserved for iOS app + Apple Health.

• 2026-05-10T12:59+02:00 — Wave A / A4 complete. Removed the default-positivity opener about data quality from the AI insights system prompt. Added GROUND RULE 7 in both EN + DE locales of src/lib/ai/prompts/insight-generator.ts forbidding "Your data foundation is strong" / "Datengrundlage ist sehr stark" style openers; data-quality caveats now allowed only when n<7 in the analyzed window, recencyDays>14, or a coverage gap biases the comparison. PROMPT_VERSION bumped 4.16.1 → 4.19.0 so feedback aggregation can attribute responses to the new rule. New test file src/lib/ai/__tests__/no-default-positivity-opener.test.ts (9 tests, all green) pins the rule + thresholds + banned phrases in both locales. Existing PROMPT_VERSION assertions in medical-reference-prompt.test.ts relaxed from /4\.16\.\d+/ to /4\.\d+\.\d+/. Single commit b5e9a95 on origin/main. Smoke verification deferred to post-deploy (cached payloads carry the old PROMPT_VERSION; the row's promptVersion distinguishes pre/post 4.19.0). Detailed report: .planning/phase-A4-report.md. Cross-agent race: pre-commit hook bundled A3's src/app/page.tsx edits into my commit — same shared-cwd race documented across earlier marathons; A3's edits are correct on origin/main.

• 2026-05-10T13:05+02:00 — Wave A / A5 complete. Settings → Integrations status UI consolidated. New <IntegrationStatusPill> (src/components/settings/integration-status-pill.tsx) is the single canonical surface — Dracula-tokenized chip top-right of every integration card, "Connected · 12 min ago" pattern with locale-aware relative-time bucketing (just now / min / h / d), three states (connected / error / disconnected), mobile-safe whitespace-nowrap. Withings + Mood Log cards refactored: redundant v1.4.15 status banner ("connected / last successful / last attempt" trio) is gone, Mood Log's bottom-of- card "letzter Sync" line is gone, both cards now show a <hr> visual divider between header and body for consistency (Marc flagged the asymmetry). Actionable error text preserved as a compact inline alert above the action row when a sync attempt failed. New i18n keys under settings.integrationPill.* (EN + DE). Three commits: ba0d6b8 (pill component + i18n + 6 vitest tests), 0dcc91a (refactor + 5 section vitest tests), 47a8fc7 (Pixel-5 e2e spec). Tests: 1646/1646 vitest pass; e2e spec added but not run in this session. Reusable for v1.4.20 Apple Health card on iOS. Detailed report: .planning/phase-A5-report.md. Cross-agent race: commit ba0d6b8 accidentally bundled A4's .planning/STATE.md and phase-A4-report.md edits — same shared- cwd race across earlier marathons, no information lost.

• 2026-05-10T13:11+02:00 — Wave A / A6 complete. Settings mobile consistency audited at Pixel-5 (393×851) against production with Marc's session cookie; findings + raw geometry tables in .planning/phase-A6-settings-audit.md. Five commits landed: 957f8e9 equalises every form input height to 36 px (AI active- provider select h-10 -> h-9, AI add-provider select h-8 -> h-9, Dashboard "Compare to" trigger drops min-h-11 so default h-9 applies); 9fda634 standardises action-button placement — Account → Password, Account → Restart onboarding tour, and Dashboard → Reset to defaults all stack the action below the title on <sm (full-width) and right-align on >=sm, fixing the Pixel-5 right-edge overflow Marc reported on the tour button (~48 px past the card border); 1075784 lifts the Sprache select out of the dob/language pair into its own row at the bottom of the Profile card, plus the duplicated native-select class string is pulled into a shared NATIVE_SELECT_CLASS constant; 737b533 uniformises card-internal space-y to space-y-4 (Dashboard layout space-y-5 -> space-y-4, AI provider config forms space-y-3 -> space-y-4); 78f1f3f adds e2e/settings-mobile-consistency.spec.ts — Pixel-5-only Playwright spec that locks in the five invariants (input heights, button-no- overflow, language-not-paired-with-dob, Compare-to-36 px, AI selects-36 px). All 1637 vitest tests + zero source typecheck errors + zero lint errors after the marathon. Cross-agent race: commit 737b533 bundled A5's .planning/STATE.md update; STATE content correct, no semantic harm. Detailed report: .planning/phase-A6-report.md. Files touched (only mine): src/components/settings/{account,ai,dashboard-layout}-section.tsx, e2e/settings-mobile-consistency.spec.ts, .planning/phase-A6-{settings-audit,report}.md.

---

Previous milestone — v1.4.18 (completed 2026-05-10T11:45+02:00)

LIVE at https://healthlog.bombeck.io · /api/version=1.4.18 · image digest sha256:c636fca7db66… (was v1.4.17: sha256:936e9cf25b2d…). Full Marc-Brief at docs/audit/v1418-summary.md. Backlog seeded to .planning/v1419-backlog.md (1 HIGH i18n bundle leak + MED/LOW) and .planning/v15-backlog.md / .planning/phase-D-v1418-product-lead-review.md (strategic).

Phases run during v1.4.18 marathon:

• Phase 0 — Bootstrap (STATE+ROADMAP for v1.4.18)
• Wave A — A1 BD-Zielbereich tile sub-values, A2 admin-shell mobile strip scrollbar, A3 chart visual revert + per-chart overlay toggles
• Wave B — B1 achievements expansion (38 → 59, +6 hidden, discovery filter, opaque hidden cards)
• Wave D — Multi-agent QA + reconcile (1 CRITICAL cleared, 8 of 10 HIGH fixed inline, 1 HIGH deferred to v1.4.19)
• Phase E1-E3 — Release v1.4.18 (tag, GHCR both green, Coolify deploy via force-pull, GH release, docs+landing sync, Marc-Brief)

---

Previous milestone — v1.4.17 hotfix (live 2026-05-10T07:58+00:00)

/insights TypeError on legacy cached payload — isLegacyInsightPayload() flag + advisor card short-circuit + defensive stripChartTokens / parseChartTokens. Three commits: 79bfa27 (fix), adab80a (release), da7070e (prettier). Detailed report: .planning/phase-v1417-hotfix-report.md.

---

Previous milestone — v1.4.16 (completed 2026-05-10T04:05+02:00)

Full report: docs/audit/v1416-summary.md. v1.5 backlog seeded at .planning/v15-backlog.md.