Files
HealthLog/.planning/STATE.md
T
Marc-André BombeckandClaude Opus 4.7 1c0cd8c87e docs(planning): record Wave 2 — Insights surface polish
Six atomic commits landed for A1-A6: BP target headline re-anchor,
BP tile feature parity, comparison-toggle moved to Settings only,
layout grid normalisation, "Muster" rename + section tabs lifted
above the hero, and the recommendation-card token-leak fix plus DE
component-label normalisation.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-10 20:55:27 +02:00

6.5 KiB

v1.4.22 marathon — state log

Status: Wave 2 — Insights surface polish complete Last update: 2026-05-10T21:00+02:00

Previous patch: v1.4.21 live (image digest sha256:4e818d44702c…, /api/version=1.4.21). v1.4.22 = big polishing release before v1.5 iOS. Closes ALL known bugs + applies ALL deferred items from .planning/v1421-backlog.md so the iOS app builds on a clean foundation.

Wave 1 — Research + probe (parallel)

Per feedback_research_before_complex_features.md, deep-fix work on 4-attempt bugs (BD-Zielbereich, api-tokens scrollbar) + Coach prompt rewrite needs research first.

W1a — Playwright PROD probe + token-leak hunt

  • BD-Zielbereich tile rendering against PROD with maintainer session (4-attempt bug pattern: probe before patching)
  • Admin / api-tokens scrollbar at multiple viewports (5th attempt)
  • Raw Metrik <Type> token leaks in Recommendations / Findings
  • Targets / Zielwerte page screenshot for upgrade brainstorm
  • Inventory .planning/v1421-backlog.md items by complexity
  • Detailed report: .planning/phase-W1a-report.md

W1b — Health-coach prompt research

  • Benchmark health-coach / motivational-interviewing prompt patterns (Apple Health Coaching, Oura, Whoop, …)
  • Define "natural prose first, evidence collapsible" structure with concrete EN + DE drafts
  • PROMPT_VERSION 4.20.2 → 4.22.0 (significant Coach tone shift)
  • Detailed report: .planning/phase-W1b-coach-prompt-research.md

Wave 2 — Insights surface polish

A1 — BD-Zielbereich 5th attempt

  • Headline re-anchored to windows.last30Days?.pct; all-time surfaced as bpInTargetPctAllTime for the new sub-row
  • Integration test pins the route contract
  • Detailed report: .planning/phase-W2-report.md

A2 — BD-Kachel feature parity

  • Trend arrow + 7-day-trend chip + comparison overlay parity (synthesised slope from 7d/30d delta); <TrendCard> extended with optional avgAllTime sub-value

A3 — Comparison-Toggle → global Settings

  • On-surface <CompareToggle /> removed from /insights; Settings → Dashboard already carries the canonical picker
  • User.dashboardWidgetsJson.comparisonBaseline field already exists (v1.4.16 phase B8) — every chart still consumes it

A4 — Insights layout grid normalisation

  • Row-fill rule: BP / weight / medications grids collapse to full-width when only one card has data
  • Trends row equal heights via min-h-[300px]
  • <CorrelationRow> drops insufficient-data tiles; zero ok cards hides the row entirely

A5 — Section heading + tab rename

  • "Muster" → "Zusammenhänge" (DE) / "Patterns" → "Relationships" (EN). Picked Zusammenhänge over Trends because the row above already uses Trends.
  • <InsightsSectionNav> lifted above the hero strip (sticky scroll-anchored; tabs visible first)

A6 — Raw Metrik <Type> token leak fix

  • <RecommendationCard> text wrapped in stripChartTokens()
  • DE componentMood/componentBp/componentCompliance renamed to German nouns; i18n-integrity test pins the contract

Wave 3 — Coach polish

B1 — Prompt rewrite

  • Adopt W1b research output: natural prose-first, motivational, conservative, evidence-grounded
  • PROMPT_VERSION 4.22.0; EN + DE
  • Coach-specific test suite covering tone + evidence-collapsible pattern

B2 — Collapsible provenance + values

  • Move inline raw values out of prose into a "Worauf bezieht sich das?" expandable below each assistant message
  • Source chips stay visible; values reveal on click

B3 — User avatar = Gravatar (parity)

  • Same dimensions as Coach avatar
  • Reuses existing gravatarUrl from /api/auth/me

B4 — Disclaimer move

  • "Coach replies are generated. Clinical decisions belong with your doctor." moves from below input → right rail
  • Right rail "Coach reads only your connected data" repurposed so the source picker stands alone

B5 — Settings cog wire-or-remove

  • Decide: wire to per-user prompt-tuning toggles (Coach tone, verbosity), OR remove the icon
  • No dead buttons in v1.4.22

Wave 4 — Other surfaces + backlog cleanup

C1 — Zielwerte page upgrade

  • Visual + UX brought to the v1.4.20 polish bar

C2 — Admin / api-tokens scrollbar 5th attempt

  • Live Playwright probe: which element actually overflows
  • Patch the right layer this time

C3 — Coolify image-digest auto-deploy

  • Wire watchtower-via-Coolify path OR enable Coolify image-digest checkbox
  • Validate end-to-end: tag push → fresh image deployed without host-side retag

C4 — AuthShell post-hydration redirect flicker

  • Move null-onboardingCompletedAt redirect to proxy.ts server-side, OR gate dashboard render on the field

C5 — node-26-alpine bump

  • Investigate the dependabot PR that failed; either patch the Dockerfile to support node 26 or close the PR with reasoning

D — .planning/v1421-backlog.md cleanup wave

Apply or confirm-defer every item:

  • Phase D reconcile carry-over (22 MED + 16 LOW + 4 simplify-maybe)
  • F6 docs site audit (9 MED + 5 LOW)
  • F5 best-practice (5 LOW)
  • FX carry-overs:
    • 191 Marc references in src/ source comments
    • DE+EN bilingual CHANGELOG entries normalised to EN
    • CLAUDE.md + AGENTS.md filename rename or retire decision

E2E fix wave (already on develop)

  • 5 commits on develop from the v1.4.21 follow-up; release-merge brings them into main when v1.4.22 ships

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

  • code-reviewer
  • security review
  • design / UX review
  • senior-dev review
  • simplify
  • Product Lead — v1.5 plan refresh based on v1.4.22 state
  • Reconcile applied CRITICAL + HIGH; defer MED/LOW with reasoning

Wave 6 — Release v1.4.22

  • Pre-release verify (typecheck, lint, test, integration, format, build)
  • Bump package.json 1.4.21 → 1.4.22 + CHANGELOG
  • Release-merge develop → main
  • Tag + push v1.4.22
  • GHCR build green
  • Coolify deploy (should work without host-side fallback after C3)
  • /api/version=1.4.22 confirmed
  • Production smoke + e2e workflow on main passes (e2e fix wave from develop is included in the release-merge)
  • GH release
  • Docs site + landing site sync
  • docs/audit/v1422-summary.md (release brief)
  • v1.5 plan refreshed for the iOS push