mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-18 08:02:12 +00:00
Wave 5 reconcile pass complete: 7 HIGH applied inline, ~6 MEDs applied inline, remaining MED + LOW deferred to `.planning/v1422-backlog.md` under "Wave 5 reconcile carry-over". - `.planning/phase-W5-v1422-reconcile-report.md`: 10 commit SHAs with cross-references to each finding, test count delta (+14 unit tests, +3 integration tests; final 2111 / 245 files), per-bucket HIGH / MED / LOW disposition, and items the maintainer should weigh in on (CSP scope, insights split, sentinel parser malformed-enum priority, /me resync stays as fall-back). - `.planning/v1422-backlog.md`: every deferred MED + LOW with a one-line trace per item, organised by review bucket. - `.planning/STATE.md`: Wave 5 ticked complete; tail updated to point at the W5 review files + reconcile report. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
199 lines
8.1 KiB
Markdown
199 lines
8.1 KiB
Markdown
# v1.4.22 marathon — state log
|
|
|
|
Status: Wave 5 — multi-agent QA + reconcile complete
|
|
Last update: 2026-05-10T22:30+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
|
|
|
|
- [x] Headline re-anchored to `windows.last30Days?.pct`; all-time
|
|
surfaced as `bpInTargetPctAllTime` for the new sub-row
|
|
- [x] Integration test pins the route contract
|
|
- Detailed report: `.planning/phase-W2-report.md`
|
|
|
|
### A2 — BD-Kachel feature parity
|
|
|
|
- [x] 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
|
|
|
|
- [x] On-surface `<CompareToggle />` removed from `/insights`;
|
|
Settings → Dashboard already carries the canonical picker
|
|
- [x] `User.dashboardWidgetsJson.comparisonBaseline` field already
|
|
exists (v1.4.16 phase B8) — every chart still consumes it
|
|
|
|
### A4 — Insights layout grid normalisation
|
|
|
|
- [x] Row-fill rule: BP / weight / medications grids collapse to
|
|
full-width when only one card has data
|
|
- [x] Trends row equal heights via `min-h-[300px]`
|
|
- [x] `<CorrelationRow>` drops insufficient-data tiles; zero ok
|
|
cards hides the row entirely
|
|
|
|
### A5 — Section heading + tab rename
|
|
|
|
- [x] "Muster" → "Zusammenhänge" (DE) / "Patterns" → "Relationships"
|
|
(EN). Picked Zusammenhänge over Trends because the row above
|
|
already uses Trends.
|
|
- [x] `<InsightsSectionNav>` lifted above the hero strip (sticky
|
|
scroll-anchored; tabs visible first)
|
|
|
|
### A6 — Raw `Metrik <Type>` token leak fix
|
|
|
|
- [x] `<RecommendationCard>` text wrapped in `stripChartTokens()`
|
|
- [x] DE `componentMood`/`componentBp`/`componentCompliance` renamed
|
|
to German nouns; i18n-integrity test pins the contract
|
|
|
|
## Wave 3 — Coach polish
|
|
|
|
### B1 — Prompt rewrite
|
|
|
|
- [x] Adopt W1b research output: natural prose-first, motivational,
|
|
conservative, evidence-grounded
|
|
- [x] PROMPT_VERSION 4.22.0; EN + DE
|
|
- [x] Coach-specific test suite covering tone + evidence-collapsible
|
|
pattern
|
|
- Detailed report: `.planning/phase-W3-report.md`
|
|
|
|
### B2 — Collapsible provenance + values
|
|
|
|
- [x] Move inline raw values out of prose into a
|
|
"Worauf bezieht sich das?" expandable below each assistant
|
|
message; `---KEYVALUES---` … `---END---` sentinel stripped
|
|
server-side, parsed into `provenance.keyValues`
|
|
- [x] Source chips stay visible; values reveal on click
|
|
|
|
### B3 — User avatar = Gravatar (parity)
|
|
|
|
- [x] Same dimensions as Coach avatar
|
|
- [x] Reuses existing `gravatarUrl` from `/api/auth/me`; initials
|
|
fallback when no Gravatar configured
|
|
|
|
### B4 — Disclaimer move
|
|
|
|
- [x] "Coach replies are generated. Clinical decisions belong with
|
|
your doctor." moves from below input → sources rail footer
|
|
- [x] "Coach reads only your connected data" caption replaced by the
|
|
disclaimer so the source picker stands alone
|
|
|
|
### B5 — Settings cog wire-or-remove
|
|
|
|
- [x] Removed for v1.4.22; per-user prompt-tuning surface deferred
|
|
to v1.4.23 (no dead buttons in this release)
|
|
|
|
## Wave 4 — Other surfaces + backlog cleanup
|
|
|
|
### C1 — Zielwerte page upgrade
|
|
|
|
- [x] 30-day sparkline + Δ-vs-last-month caption per card (Direction
|
|
A from W1a §4). Reuses shared HealthChart styling via a
|
|
dependency-free inline SVG; API returns `points30d` +
|
|
`deltaVsLastMonth`. BMI derives both from the weight series.
|
|
|
|
### C2 — Admin / api-tokens scrollbar 5th attempt
|
|
|
|
- [x] Live Playwright probe confirmed `whitespace-nowrap` on the date
|
|
`<td>`s was the residual culprit (W1a §2). Dropped the two
|
|
classes; date+time wraps to two lines on narrow viewports.
|
|
|
|
### C3 — Coolify image-digest auto-deploy
|
|
|
|
- [x] Workflow appends `?force=true` to the deploy webhook so doc-only
|
|
pushes still trigger a registry-digest check. Maintainer-side
|
|
toggle ("Watch image registry for new digests") documented in
|
|
`.planning/coolify-auto-deploy-howto.md` — one UI flip.
|
|
|
|
### C4 — AuthShell post-hydration redirect flicker
|
|
|
|
- [x] Redirect lives in `proxy.ts`. Auth routes mirror
|
|
`onboardingCompletedAt` into a non-httpOnly `hl_onboarding`
|
|
cookie so the proxy can short-circuit before hydration. The
|
|
e2e onboarding-flicker spec dropped its workaround.
|
|
|
|
### C5 — node-26-alpine bump
|
|
|
|
- [x] Dependabot PR #162 closed with reasoning. node:26-alpine ships
|
|
without corepack pre-installed; Next.js 16 also still pins
|
|
node 22 LTS as the supported minimum. Reopen when the framework
|
|
bumps its node-version requirement.
|
|
|
|
### D — `.planning/v1421-backlog.md` cleanup wave
|
|
|
|
Apply or confirm-defer every item:
|
|
|
|
- [x] Phase D reconcile carry-over (22 MED + 16 LOW + 4 simplify-maybe)
|
|
- [x] FX carry-overs:
|
|
- [x] 191 `Marc` references swept across `src/` (test fixtures kept
|
|
as opaque test data per brief)
|
|
- [x] DE+EN bilingual CHANGELOG entries (v1.4.14 + v1.4.15) reduced
|
|
to English-only
|
|
- [x] `CLAUDE.md` renamed to `CONTRIBUTING-AI.md` so the filename
|
|
is not AI-vendor-specific; `AGENTS.md` stays for multi-agent
|
|
compatibility. `CONTRIBUTING.md` reference updated.
|
|
|
|
### E2E fix wave (already on develop)
|
|
|
|
- [x] 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
|
|
|
|
- [x] code-reviewer (`.planning/phase-W5-v1422-code-review.md` — 0 CRIT, 2 HIGH, 4 MED, 5 LOW)
|
|
- [x] security review (`.planning/phase-W5-v1422-security-review.md` — 0 CRIT, 0 HIGH, 2 MED, 4 LOW)
|
|
- [x] design / UX review (`.planning/phase-W5-v1422-design-review.md` — 0 CRIT, 3 HIGH, 7 MED, 5 LOW)
|
|
- [x] senior-dev review (`.planning/phase-W5-v1422-senior-dev-review.md` — 0 CRIT, 2 HIGH, 5 MED, 4 LOW)
|
|
- [x] simplify (`.planning/phase-W5-v1422-simplify-review.md` — 5 apply-yes, 4 apply-maybe, 6 apply-no)
|
|
- [x] Product Lead — v1.5 plan refresh based on v1.4.22 state (`.planning/phase-W5-v1422-product-lead-review.md`)
|
|
- [x] Reconcile applied CRITICAL + HIGH; defer MED/LOW with reasoning (10 commits; report at `.planning/phase-W5-v1422-reconcile-report.md`; backlog at `.planning/v1422-backlog.md`)
|
|
|
|
## 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
|