mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-18 08:02:12 +00:00
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
441 lines
28 KiB
Markdown
441 lines
28 KiB
Markdown
# v1.4.16 marathon — state log
|
||
|
||
Status: phase-0-done
|
||
Last update: 2026-05-09T23:12:52+02:00
|
||
|
||
> Previous milestone: `docs/audit/v1415-summary.md` (live: `/api/version=1.4.15`,
|
||
> image digest `sha256:ace7d441f47b…`).
|
||
|
||
## Phase 0 — Bootstrap
|
||
|
||
- [x] STATE+ROADMAP rewritten for v1.4.16
|
||
- [x] git status clean
|
||
- [x] codex-protocol-spec re-read
|
||
- [x] v1416-backlog.md inventoried
|
||
- Result: ok / commit `chore(planning): bootstrap v1.4.16 marathon` on origin/main
|
||
- Detailed report: `.planning/phase-0-report.md`
|
||
|
||
## Wave A — Quick fixes (parallel buckets)
|
||
|
||
### A1 — Sidebar admin-expand bug
|
||
|
||
- [x] Clicking Admin from non-admin route does NOT auto-expand sub-items (mirror Settings exact pattern)
|
||
- [x] Gravatar dropdown does NOT trigger sidebar expansion side-effect
|
||
- Detailed report: `.planning/phase-A1-A3-report.md`
|
||
- Commit: `77fe256 fix(nav): admin sub-items don't expand from gravatar dropdown or admin-link click` on origin/main
|
||
|
||
### A2 — BD-Zielbereich real-fix (regression from v1.4.15 A4)
|
||
|
||
- [x] Investigate root cause — A4 in v1.4.15 marked this fixed but Marc still sees 0%
|
||
- [x] Verify against actual user data with measurements (pulled from production apps-01 DB)
|
||
- [x] Fix root cause + add E2E test that exercises full flow against real session
|
||
- Detailed report: `.planning/phase-A2-A6-report.md`
|
||
- Commit: `577d8dd fix(insights): BD-Zielbereich computes correctly for real measurement data` on origin/main
|
||
- Root cause: v1.4.15 fix corrected the denominator but kept the ESH narrow-band predicate (`sysLow <= sys <= sysHigh AND diaLow <= dia <= diaHigh`); Marc's normotensive readings (e.g. 117/79) were below sysLow=120 and so counted as OUT. Marc's actual production data: 0/10 paired readings in target under v1.4.15. Fix: change to one-sided ceiling semantics with hypotension floor (`90 <= sys <= sysHigh AND 50 <= dia <= diaHigh`); centralised in `isBpReadingInTarget()` shared by 6 call sites. Marc's data now reports 50% (was 0%).
|
||
|
||
### A3 — /admin/api-tokens table responsive (still scrolling)
|
||
|
||
- [x] Inspect current state on prod with Marc's session — overflow-x scrollbar visible
|
||
- [x] Fix properly: card-list mobile fallback OR proper column-hide chain at xs/sm/md breakpoints
|
||
- Detailed report: `.planning/phase-A1-A3-report.md`
|
||
- Commit: `277a5aa fix(admin): api-tokens table no horizontal overflow on Pixel-5 viewport` on origin/main
|
||
|
||
### A4 — "7-Tage-Schnitt" → "7-Tage-Trend" DE + indicator on ALL charts
|
||
|
||
- [ ] DE i18n string rename everywhere (incl. tile-strip + chart subtitles)
|
||
- [ ] Trend indicator (+/-) appears for EVERY chart including mood + medication + insights
|
||
- [ ] Trend on "all" filter computes correctly (currently shows 0)
|
||
- Detailed report: `.planning/phase-A4-report.md`
|
||
|
||
### A5 — Top-tile-selector real-fix (regression from v1.4.15 A4)
|
||
|
||
- [ ] Investigate why settings save isn't reflected on dashboard
|
||
- [ ] Probably a query-cache stale-read OR the layout-config field isn't actually consumed by the tile-strip
|
||
- [ ] Fix + e2e test toggling visibility persists
|
||
- Detailed report: `.planning/phase-A5-report.md`
|
||
|
||
### A6 — Medication-chart 7d-trend + target-range
|
||
|
||
- [x] Medication-chart matches other charts: 7d-trend label + indicator + target-range visualization
|
||
- Detailed report: `.planning/phase-A2-A6-report.md`
|
||
- Commit: `9b01c86 feat(charts): medication chart matches other charts (7d trend + indicator + target-range)` on origin/main
|
||
- Added `computeMedicationTrend7d()` helper (split-half mean comparison, 14-day cap), trend chip in header (signed Δ-pp + arrow icon, `up-good` sentiment colours), 100% goal ReferenceLine alongside the existing 80% threshold. 6 new unit tests pin trend computation. Cross-agent race note: `9b01c86` accidentally bundled A7's `INSIGHTS_RATE_LIMIT_PER_HOUR` work — see report for details.
|
||
|
||
### A7 — AI Generator rate-limit 10/h + cache-invalidate-on-new
|
||
|
||
- [x] Rate-limit current 2/h → 10/h (env-configurable via `INSIGHTS_RATE_LIMIT_PER_HOUR`)
|
||
- [x] When user generates new insight: evict ALL cached previous insights for that user (per-status `audit_logs` rows for `insights.<scope>-status.<locale>` are deleted; `insights-card.tsx` already invalidates `["insights"]` on mutation success)
|
||
- [x] Verify: dashboard shows newest insight, never stale-cached (3 new test blocks: 10/h default, env override, sub-1 fallback, deleteMany call shape, cached-path skip)
|
||
- Detailed report: `.planning/phase-A7-A8a-report.md`
|
||
- Commit: source landed inside `9b01c86 feat(charts): medication chart matches other charts` (cross-agent race — A6 worker pushed first and absorbed the staged A7 files). Code is verbatim what A7 wrote: `resolveInsightsRateLimit()`, `evictPerStatusInsightCache()`, the rate-limit message rewrite to `Maximum ${limit} insight generations per hour.`, and the i18n flatten ("Bitte warte — du hast das stündliche Limit für Analysen erreicht."). All on origin/main.
|
||
|
||
### A8 — Umlaute encoding bug + login-overview
|
||
|
||
- [x] "Nrnberg" should be "Nürnberg" — geo helper now decodes via `arrayBuffer() + TextDecoder('utf-8')` instead of `Response.json()`, so an upstream proxy that strips/rewrites the `Content-Type: charset` parameter cannot poison the umlaut path
|
||
- [x] Audited all of `src/` for ASCII-fold patterns (`normalize("NFD")`, slugify, `[^a-zA-Z…]/g` strips, `String.fromCharCode`/`charCodeAt` deburr): zero hits. The geo helper was the only surface
|
||
- [x] Regression test for known-umlaut roundtrip: 7 cities (Nürnberg, München, Düsseldorf, Köln, Würzburg, Bückeburg, Weißenfels) plus eszett + Content-Type-without-charset case + Accept-Language assertion (de;q=1, en;q=0.5)
|
||
- Detailed report: `.planning/phase-A7-A8a-report.md`
|
||
- Commit: `2da0703 fix(geo): preserve umlauts in city names (login-overview no longer renders "Nrnberg")` on origin/main
|
||
|
||
## Wave B — Quality-leap features
|
||
|
||
### B1 — Insights/Charts Apple-Health-style visual leap (chart wrappers, first half)
|
||
|
||
- [ ] Benchmark against Apple Health, Withings Health Mate, Oura Ring
|
||
- [ ] Insights surface: gradient fills, animation, dynamic comparisons (better/worse), interactive tooltips, vertical slide-to-compare
|
||
- [x] Charts: same level of polish — Recharts replacement allowed if quality bar requires
|
||
- [ ] Insights surface visualizes data, not just text-summarizes
|
||
- Detailed report: `.planning/phase-B1-report.md`
|
||
|
||
#### B1a — Charts visual leap (chart wrappers only) — complete
|
||
|
||
- 2026-05-10T00:35+02:00 — B1a complete on origin/main.
|
||
- **Primitives** (`src/components/charts/{chart-gradient,chart-tooltip,chart-empty-state}.tsx`)
|
||
plus `src/lib/charts/reduced-motion.ts`. 11 unit tests.
|
||
- **HealthChart** (BP/weight/pulse/body-fat/sleep/steps wrapper):
|
||
`LineChart` → `ComposedChart`, gradient-filled `<Area>` per type,
|
||
90-day median personal-baseline `<ReferenceLine>` ("Your normal" /
|
||
"Dein Mittel"), `<RichChartTooltip>` with delta-vs-baseline,
|
||
600 ms ease-out animation respecting `prefers-reduced-motion`,
|
||
sparse-data `<ChartEmptyState>` for <3 points.
|
||
- **MoodChart**: same polish + emoji glyphs at every score (😖 🙁
|
||
😐 🙂 😄 mapped from 1..5) via Recharts `dot` callback; lavender
|
||
gradient under the score line.
|
||
- **MedicationComplianceChart**: same polish, purple gradient,
|
||
rich tooltip with "−N pp vs. target" delta. A6's existing 80 %
|
||
threshold + 100 % goal lines untouched.
|
||
- +23 net tests; full suite 1298/1299 (single pre-existing B6 fail).
|
||
- Commits on origin/main: primitives → `2611bb4` (subject belongs
|
||
to B5b due to a parallel-staging race; my 6 files + 7 i18n keys
|
||
correct), `74c2eb8 feat(charts): BP/weight/pulse polish (gradient,
|
||
baseline, rich tooltip)`, `901f44e feat(charts): mood chart polish
|
||
with emoji glyphs at data points` (also absorbed B5b's
|
||
`provider-runner.ts`), `8008613 feat(charts): medication chart
|
||
polish (gradient + animation + rich tooltip)` (clean).
|
||
- Architectural deviation: brief asked for separate
|
||
`blood-pressure-chart.tsx` / `weight-chart.tsx` / `pulse-chart.tsx`
|
||
files; the codebase has one `HealthChart` wrapper used for all
|
||
three families. Splitting would have been DRY-regressing — kept
|
||
one wrapper, one commit covers all three.
|
||
- "Optional targetWeightKg user-pref" on weight chart not added —
|
||
that's a Settings → Account field B6 owns; chart wrapper already
|
||
accepts a `valueBands` prop the dashboard can pass a target band
|
||
through whenever the user-pref ships.
|
||
- Detailed report: `.planning/phase-B1a-report.md`
|
||
|
||
### B2 — AI provider settings UX cleanup (Pulldown-driven)
|
||
|
||
- [x] Settings → AI: provider dropdown drives form below (no top/bottom split)
|
||
- [x] All providers configurable from one UI (Codex / OpenAI direct / Anthropic / Local / Admin OpenAI)
|
||
- [x] Form switch-renders dynamically when provider changes
|
||
- Detailed report: `.planning/phase-B2-report.md`
|
||
- Status block — 2026-05-10T01:15+02:00: B2 complete on `agent/b2-ai-provider-ux`
|
||
worktree, ready for fast-forward into `origin/main`. New `PUT
|
||
/api/insights/provider-chain` (5 unit tests + 2 integration tests).
|
||
Refactored `<AiSection>` collapses the v1.4.15 top/bottom split per
|
||
Marc's `feedback_settings_no_split.md`: one Pulldown drives a
|
||
switch-rendered config card (Codex / OpenAI / Anthropic / Local /
|
||
Admin OpenAI) and a `<FallbackChainCard>` reorders / toggles /
|
||
removes / adds entries with arrow controls (no new dependency —
|
||
`dnd-kit` not in `package.json`). EN+DE i18n keys + 8 new SSR
|
||
tests + 1 Playwright spec. `pnpm test` 1316/1316,
|
||
`pnpm test:integration` 55/55, typecheck 0 errors, lint 0 errors.
|
||
Worktree-isolated under `agent/b2-ai-provider-ux` so the
|
||
parallel-running B5c agent on the rec-card surface can't bleed in.
|
||
|
||
### B3 — Admin System-Status host-load chart
|
||
|
||
- [x] Host CPU/memory/disk-io graph last 2h (in-process sampler — Coolify Sentinel had no clean read endpoint)
|
||
- [x] Render above current system-status section
|
||
- Detailed report: `.planning/phase-B3-report.md`
|
||
- Commits on origin/main: `5d1ece1 feat(db): HostMetric model for host-load sampling`, `f1bd801 feat(jobs): host-metric sampler captures load + memory every minute, 7d retention`, `2877710 feat(api): /api/admin/host-metrics returns last 2h of host load + memory`. Chart component + system-status wiring + i18n landed inside `8d9f864 docs(planning): mark Wave-B B5a (medical-reference grounding) complete` due to a parallel-agent staging race during the verification-gate stash/restore loop — files are correct on origin/main, just under a misleading subject. 8 sampler unit tests + 6 API integration tests + 5 chart component tests all green; i18n parity test green.
|
||
|
||
### B4 — Admin logs visibility deepening
|
||
|
||
- [x] Audit log: filterable by actor/action/target, paginated (25/50/100 per page), exportable as CSV
|
||
- [x] App-log preview: tail of last 500 structured wide-events from per-process ring buffer, filterable by trace_id / level / action / time-window, JSON inspector modal
|
||
- Detailed report: `.planning/phase-B4-report.md`
|
||
- Commits: `8ac5602` (audit-log API + UI — bundled with verification-gate planning commit due to coordinator stash race; my code, wrong commit subject), `4cc3d8d feat(admin): app-log preview surfaces last 1h of structured events with filter + JSON inspector`, `6520ae4 feat(admin): sidebar entry for app-logs` on origin/main
|
||
- Status block — 2026-05-10T00:11+02:00: B4 complete on origin/main. New `src/lib/logging/in-memory-buffer.ts` (500-entry FIFO, FIFO eviction, redaction at API egress only). New `/api/admin/audit-log/actions` populates the action-dropdown via `groupBy`. New `/api/admin/app-logs` route + `<AppLogPreviewSection>` component + `app-logs` admin slug + `<AdminShell>` entry. 51/51 B4 unit tests green; typecheck/lint clean on B4 surface. Sibling B7 broken `export-per-type` typecheck failures predate this phase.
|
||
|
||
### B5a — Medical-reference grounding
|
||
|
||
- [x] AHA / ESC / ESH / WHO / DGE target ranges as system context (curated bundle in `src/lib/ai/medical-references.ts`)
|
||
- [x] Citations link to source guideline in UI (`<CitationFootnote>` opens in new tab)
|
||
- Detailed report: `.planning/phase-B5a-report.md`
|
||
- Commits on origin/main:
|
||
- `27f3933 feat(ai): curated medical-reference bundle for citation grounding`
|
||
- `466b8b5 feat(ai): schema accepts validated referenceId pointing into the medical-reference bundle`
|
||
- `7fbfca6 feat(ai): system prompt includes curated medical references for citation grounding`
|
||
- `53aade9 feat(ai): post-validation logs citation-coverage rate per insight generation`
|
||
- `a66c128 feat(insights): citation footnote on recommendations with medical reference`
|
||
- 5 atomic TDD-first commits, +44 net tests (15 bundle + 8 schema + 10 prompt + 15 coverage + 6 footnote − overlaps). PROMPT_VERSION bumped 4.15.0 → 4.16.0. Citation-coverage Wide-Event annotation observational in v1.4.16; B5c will flip to required for severity ≥ "important".
|
||
- Cross-agent worktree race captured B4 admin files into commit `a66c128` and my commit-5 content into `aff9add` (host-metrics-chart) — see report for detail.
|
||
|
||
### B5b — Multi-provider redundancy
|
||
|
||
- [x] try-each-on-hard-failure across configured providers
|
||
- [x] Fallback ordering configurable per user
|
||
- Detailed report: `.planning/phase-B5b-report.md`
|
||
- Commits on origin/main:
|
||
- `2611bb4 feat(db): User.aiProviderChain for ordered fallback config`
|
||
- `901f44e feat(charts): mood chart polish ...` (cross-agent race subject — actual diff includes the B5b runner + provider-chain resolver + route wiring; verified via `git show 901f44e`)
|
||
- `613d661 feat(settings): minimal display of active AI provider + configured chain`
|
||
- `d2bda42 test(ai): provider fallback covers happy path, hard-fail cascade, cache`
|
||
- 4 atomic TDD-first commits. New module `provider-runner.ts` exposes
|
||
both a strict `runWithFallback()` (for B5c migration) and a
|
||
legacy-shape `runRawCompletionWithFallback()` (consumed by the
|
||
current route). Hard-fail policy: 401/403/429/5xx/transport
|
||
cascade; schema 422 bubbles. Last-working cache: 1h TTL, in-process,
|
||
per-userId. New `User.aiProviderChain Json?` column + migration
|
||
`0033`. New `GET /api/insights/provider-chain` endpoint feeds
|
||
`<ProviderChainSummary>` (active + cached + configured chain) under
|
||
Settings → AI; full management UX deferred to B2 per scope. EN+DE
|
||
i18n parity green. Cross-agent race: commit 2 subject was hijacked
|
||
by parallel B1a worker (mood-chart polish); my code IS on origin.
|
||
|
||
### B5c — Per-Recommendation Explainability
|
||
|
||
- [ ] Each rec carries: WHY (what user-data triggered it), WINDOW (which time range was analyzed), CITATIONS (which medical guideline + which user metric)
|
||
- [ ] UI: expand-arrow on each rec → reveals the explainability card with mini-chart of the data window
|
||
- [ ] Schema enforces presence (extends v1.4.15 C1's strict schema)
|
||
- Detailed report: `.planning/phase-B5c-report.md`
|
||
|
||
### B5d — Confidence Score per Recommendation
|
||
|
||
- [ ] Each rec carries a 0-100 confidence score derived from: data sufficiency (n samples), recency, signal strength
|
||
- [ ] UI: visual confidence indicator (e.g., color-coded ring or 5-bar meter) per rec
|
||
- [ ] Below-threshold recs are tagged "Low confidence — based on limited data" rather than hidden
|
||
- Detailed report: `.planning/phase-B5d-report.md`
|
||
|
||
### B5e — User-Feedback Loop
|
||
|
||
- [ ] "War das hilfreich?" thumbs-up/down on each rec, persisted as RecommendationFeedback (new table)
|
||
- [ ] Aggregated feedback feeds into prompt-tuning: low-helpful patterns get a system-prompt addendum next generation
|
||
- [ ] Privacy: feedback is per-user; no cross-user training (offline only, opt-in for any aggregation)
|
||
- Detailed report: `.planning/phase-B5e-report.md`
|
||
|
||
### B6 — Settings naming-audit
|
||
|
||
- [x] Every settings sub-route reviewed for stringency, naming consistency, logical grouping
|
||
- [x] No top/bottom split anti-pattern anywhere (AI flagged for B2 — only known instance, out of B6 scope)
|
||
- [x] No double naming (audit found no live duplicate; settings vs admin scope rule landed in CLAUDE.md)
|
||
- Detailed report: `.planning/phase-B6-report.md` · audit doc: `docs/audit/v1416-settings-audit.md`
|
||
- Commits on origin/main:
|
||
- `01a05e4 docs(audit): v1.4.16 settings naming + consolidation audit`
|
||
- `a432cb2 refactor(settings): consistent naming + i18n key namespace`
|
||
- `ed0cfda refactor(settings): remove duplicate toggles, route to canonical owner`
|
||
- `d914f76 test(settings): coverage for renamed/consolidated sections`
|
||
- Status block — 2026-05-10T00:28+02:00: B6 complete on origin/main. Threshold component renames (`thresholds-settings-section.tsx` → `thresholds-section.tsx` route wrapper; old `thresholds-section.tsx` inner editor → `thresholds-editor-section.tsx` `<ThresholdsEditorSection>`) align every section with the canonical `<slug>-section.tsx` `<SlugSection>` convention. Three muddy section descriptions rewritten in EN + DE (`account`, `api`, `advanced`); `notifications.description` rewritten so the DE doesn't verbatim-copy the EN. New `sections-i18n-parity.test.ts` walks every `SETTINGS_SECTION_SLUGS` entry and asserts both `.title` + `.description` resolve in EN+DE and the DE differs from the EN. Settings tests 63/63 (was 40/40, +23 net). Typecheck 0 errors, lint 0 errors / 12 pre-existing warnings. Worktree-isolated under `agent/b6-settings-audit` so the sibling B1/B5b uncommitted state in the primary checkout couldn't bleed in. AI section top/bottom split (Marc's specific call-out) flagged for B2; flat-key hygiene PR flagged for post-v1.4.16.
|
||
|
||
### B7 — Settings → Export menu (Arztbrief consolidated)
|
||
|
||
- [x] New /settings/export route with consolidated UI: Doctor-report (PDF, configurable date range + practice name from B6 v1.4.15) + CSV/JSON exports (measurements/medications/mood per CLAUDE.md src/lib/export.ts)
|
||
- [x] Properly designed: card per export type, clear preview + filter + download button
|
||
- [x] Rename current doctor-report entry-point to live under /settings/export
|
||
- Detailed report: `.planning/phase-B7-report.md`
|
||
- Commits on origin/main:
|
||
- `621109c feat(settings): export-section consolidates doctor-report, CSVs, JSON backup`
|
||
- `a512650 feat(settings): /settings/export dynamic route wired into sidebar`
|
||
- `94c748d refactor(doctor-report): entry-point relocated under /settings/export`
|
||
- `226cac4 docs(planning): mark phase B3 (host-load chart) complete` — absorbed
|
||
the four `/api/export/*` route files + per-type unit tests + integration suite
|
||
via a parallel-agent staging race during the verification gate's stash/restore
|
||
loop. Code authored by me (Marc + Co-Authored-By Claude Opus), commit summary
|
||
name belongs to B3.
|
||
- `d5c8912 fix(export-section): point download buttons at the new plain-segment endpoints`
|
||
- `830b2b0 test(export): integration test points at the new plain-segment endpoints`
|
||
- `e628f33 test(export): coverage for export-section + endpoints`
|
||
- 5 cards rendered (Doctor Report PDF / Measurements CSV / Medications CSV with
|
||
optional intake-history toggle / Mood CSV / Full JSON Backup), each on its
|
||
own `data-testid` so the e2e suite can target without relying on i18n labels.
|
||
Mobile stacks; `>=md` is a 2-column grid. AdvancedSection is now danger-zone-only.
|
||
Routes use plain segments (`/api/export/measurements` rather than `.csv` —
|
||
vitest can't resolve dotted segments cleanly; the file extension lives in
|
||
`Content-Disposition`). All four endpoints share the global `export:<userId>`
|
||
10/h rate-limit bucket and write a `user.export.<kind>` audit-log entry.
|
||
10 unit + 9 integration + 2 e2e tests pin the contract.
|
||
|
||
### B8 — Extended Comparison Views (Vormonat / Vorjahr)
|
||
|
||
- [ ] Each chart + tile + insight gets toggleable comparison overlay: "vs. last month" / "vs. last year"
|
||
- [ ] Visual treatment: dimmed historical line beneath current; delta callout (Δ +5%, etc.)
|
||
- [ ] Insights surface narrates the comparison ("Your average BP improved by 4 mmHg vs. last month")
|
||
- [ ] Mobile-friendly comparison toggle (not a fragile hover-only interaction)
|
||
- Detailed report: `.planning/phase-B8-report.md`
|
||
|
||
## Wave C — Catch-up (deferred from v1.4.15)
|
||
|
||
- [x] CI Integration tests + e2e workflows pre-existing red since
|
||
`d8c549e` — both green from this phase forward
|
||
- [x] 5 of 8 deferred HIGH from v1.4.15 Wave-D (H1, H2, H4 code-review,
|
||
H4 design, H3 senior in-use; H3 mood-chart skipped per charts/
|
||
ownership; H1+H2 senior splits deferred)
|
||
- [x] 3 of 5 deferred MED from A5 mobile (tabs scroll, bottom-nav
|
||
5+More, system-status retry; measurements BP grouping + DOM
|
||
weight deferred to v1.5)
|
||
- [x] Coolify image-digest auto-deploy trigger — DEFERRED with v1.5
|
||
plan documented in `docs/audit/v1416-auto-deploy-fix.md` (Marc-
|
||
side UI flip is the 5-min realistic fix; MCP API doesn't expose
|
||
the toggle)
|
||
- [x] docker-publish main-branch hang — root cause was qemu-arm64
|
||
SIGILL; dropped arm64 from the platforms list, v1.5 to re-add via
|
||
native `ubuntu-24.04-arm` matrix
|
||
- Bonus: B5a i18n parity for `insights.recommendation.{source,viewSource}`
|
||
- Detailed report: `.planning/phase-C-report.md`
|
||
|
||
### Status block — Wave C
|
||
- 2026-05-10T00:44:00+02:00 — Wave C complete on origin/main.
|
||
Worktree-isolated agent at `/Users/marc/Projects/HealthLog-c` on
|
||
`agent/wave-c-catchup` shipped 11 commits without a single shared-
|
||
cwd race. CI Integration green (5 successive successes), e2e
|
||
in-progress at write time on `0d08e33`. `pnpm test` 1303/1303,
|
||
`pnpm test:integration` 53/53 (after `pnpm db:generate` for B5b's
|
||
new `aiProviderChain` column), `pnpm typecheck` 0 errors,
|
||
`pnpm lint` 12 pre-existing warnings.
|
||
- **CI fix:** `fbcd106` — quoted `ENCRYPTION_KEY` YAML scalar (was
|
||
parsed as integer 0) + seeded `onboarding_tour_completed = true`
|
||
in e2e global-setup so the spotlight tour overlay stops
|
||
intercepting clicks across 9 specs.
|
||
- **HIGH H1:** `fdac9e2` admin restore-failed scrubs raw Prisma
|
||
error.
|
||
- **HIGH H2:** `7f1a4de` moodEntry.tags refined to JSON-array.
|
||
- **HIGH H4 code:** `2afe3c4` tour-launcher sessionStorage scoped
|
||
by user id.
|
||
- **HIGH H4 design:** `b863e2c` 44 px tap targets on tour /
|
||
backups / notifications.
|
||
- **i18n parity:** `2a7ef72` Quelle / Leitlinie translations.
|
||
- **MED tabs:** `d7c2b2a` horizontal scroll on mobile.
|
||
- **MED bottom-nav:** `072eee6` 5+More with overflow sheet.
|
||
- **MED system-status:** `65b4bf9` Retry button.
|
||
- **Auto-deploy doc:** `4be6465` defer + v1.5 plan.
|
||
- **docker-publish:** `cc0f343` drop qemu-arm64.
|
||
|
||
## Wave D — Multi-agent QA + Product-Lead
|
||
|
||
- [ ] code-reviewer
|
||
- [ ] security review
|
||
- [ ] design / UX review (Apple Health benchmarking lens)
|
||
- [ ] senior-dev review
|
||
- [ ] simplify
|
||
- [ ] Product Lead — state of app, biggest items, v1.5 roadmap, follow-on initiatives
|
||
- [ ] Reconcile applies CRITICAL/HIGH inline
|
||
- Detailed report: `.planning/phase-D-report.md` + `product-lead-review.md`
|
||
|
||
## Phase E — Release v1.4.16
|
||
|
||
- [ ] Pre-release verify
|
||
- [ ] Bump package.json + CHANGELOG
|
||
- [ ] Tag + push v1.4.16
|
||
- [ ] GHCR build (verify both main + tag green; C3 v1.4.16 fix may finally help main)
|
||
- [ ] Coolify deploy
|
||
- [ ] /api/version=1.4.16 confirmed
|
||
- [ ] Production smoke
|
||
- [ ] GH release
|
||
- [ ] Docs site + landing site sync
|
||
- [ ] `docs/audit/v1416-summary.md` (Marc-Brief)
|
||
- Detailed report: `.planning/phase-E-report.md`
|
||
|
||
---
|
||
|
||
## Previous milestone — v1.4.15 (completed 2026-05-09T22:50+02:00)
|
||
|
||
LIVE at https://healthlog.bombeck.io · `/api/version=1.4.15` · image digest
|
||
`sha256:ace7d441f47b…` (was `0ced46004a54…` on v1.4.14).
|
||
|
||
Full Marc-Brief, commit table, deferred items, CI/prod state and
|
||
Phase-D reconcile detail: `docs/audit/v1415-summary.md`. Backlog seeded
|
||
to `.planning/v1416-backlog.md` (8 deferred HIGH + 39 MED/LOW + 4
|
||
simplify-no + 3 process items).
|
||
|
||
Phases run during v1.4.15 marathon:
|
||
|
||
- Phase 0 — Bootstrap (STATE+ROADMAP for v1.4.15)
|
||
- Phase A1–A5 + B-mobile — Quick fixes (nav, admin overview, quick-add labels, dashboard analytics, mobile audit + fix-application)
|
||
- Phase B1–B6 — Bigger features (backup completeness, Withings/moodLog robustness, notification reliability, achievements UI, onboarding tour, doctor-report v2)
|
||
- Phase C1–C5 — Hardening (AI/Codex schema + slug-drift, Coolify auto-deploy, CI/e2e reliability, i18n parity, empty-states audit)
|
||
- Phase D — Multi-agent QA (5 reviewers + reconcile; 0 CRITICAL, 5 HIGH fixed inline, 8 HIGH deferred to v1.4.16)
|
||
- Phase E1–E3 — Release (v1.4.15 tag, GHCR, host-side retag deploy, docs+landing sync, summary)
|
||
|
||
Marathon recurring meta: per-agent git-worktree adoption deferred to
|
||
v1.4.16 (commit-message drift recurred across A2, A4, B1, B-mobile, B2,
|
||
B3, B4, C1, C5).
|
||
|
||
---
|
||
|
||
## Status block — Phase 0 (v1.4.16)
|
||
|
||
- 2026-05-09T23:12:52+02:00 — Phase 0 complete. STATE.md + ROADMAP.md
|
||
scaffolded for v1.4.16 marathon (Wave A: A1-A8, Wave B: B1-B7, Wave C
|
||
catch-up, Wave D multi-agent QA + Product-Lead, Phase E release).
|
||
Previous v1.4.15 entries archived above. Working tree was carrying
|
||
re-run-prettier corruption on 22 .planning/ files (markdown list-
|
||
marker `+` flipped to `-`, breaking content) — discarded via
|
||
`git checkout -- .planning/` before scaffold; tracked files clean.
|
||
Untracked v1.4.14/v1.4.15 leftover phase reports (15 files) left in
|
||
place — they belong to previous milestones, not v1.4.16. Phase 0
|
||
commit contains only `.planning/STATE.md`, `.planning/ROADMAP.md`,
|
||
`.planning/phase-0-report.md`. Marc-status: speed matters.
|
||
|
||
## Status block — Wave A bucket-1 (A1 + A3)
|
||
|
||
- 2026-05-09T23:26:00+02:00 — A1 + A3 complete on origin/main.
|
||
- **A1** removed the entire admin sub-list expansion from
|
||
`sidebar-nav.tsx`; the Admin entry now mirrors the Settings entry
|
||
exactly (single link, no sub-items at any route, gravatar
|
||
dropdown unaffected). Vitest + new e2e
|
||
`e2e/sidebar-admin-no-expand.spec.ts` cover the contract.
|
||
Commit `77fe256`.
|
||
- **A3** swapped the api-tokens desktop `<table>` for a real mobile
|
||
card-list at <md (mirrors `<UserManagementSection>`). No
|
||
`overflow-x-auto` inside the mobile container; long names + perm
|
||
badges wrap within the card. New e2e
|
||
`e2e/admin-api-tokens-mobile.spec.ts` asserts no page scroll at
|
||
Pixel 5 with a worst-case payload. Commit `277a5aa`.
|
||
- Verification: `pnpm typecheck` clean, `pnpm lint` 12 pre-existing
|
||
warnings / 0 errors, `pnpm test` 1056/1057 (the single failure
|
||
is in A2's `bp-in-target.test.ts`, out of bucket-1 scope).
|
||
|
||
## Status block — Wave A bucket-3 (A4 + A5 + A8b)
|
||
|
||
- 2026-05-09T23:31:00+02:00 — A4 + A5 + A8b complete on origin/main.
|
||
- **A4** "7-Tage-Trend" rename across DE/EN (`movingAverage7d`,
|
||
`moodMA`, `trend7dShort` all use the long form now), plus
|
||
`summaryToTrend7Delta()` falls back to `slope30` when `slope7`
|
||
is null so sparser metrics like mood (logged < daily) show a
|
||
delta number instead of dropping the indicator. Commit `4df6dac`.
|
||
- **A5** root-cause: `widgetIdEnum` in
|
||
`src/app/api/dashboard/widgets/route.ts` was missing
|
||
`achievements`, so every PUT against the default layout 422'd
|
||
silently and the toggle never persisted. Extracted
|
||
`DASHBOARD_WIDGET_IDS` as the single source of truth in
|
||
`src/lib/dashboard-layout.ts` and derived the Zod enum from it
|
||
so the lists cannot drift again. Also hide the tile-strip
|
||
wrapper when zero tiles are visible (Marc's
|
||
"ganze Spalte breit, gleicher Höhe" constraint). Commit `93e712d`.
|
||
- **A8b** chart trend on "All" filter rounded to ±0 because
|
||
per-week rate over multi-year windows falls below the
|
||
1-decimal display precision. Added pure
|
||
`computeWindowTrend()` helper at
|
||
`src/lib/analytics/window-trend.ts` that returns both the
|
||
per-week delta and a split-half mean delta (second-half mean
|
||
minus first-half mean) for windows ≥ 90 days. The chart now
|
||
surfaces "Total +5.4 kg (6.7 %)" alongside the per-week rate
|
||
on long ranges. 7 unit tests pin the helper. Commit `af77e5e`.
|
||
- Verification: `pnpm test` 1081/1081 (+32 net), `pnpm typecheck`
|
||
0 errors, `pnpm lint` 12 pre-existing warnings / 0 errors.
|
||
Detailed report: `.planning/phase-A4-A5-A8b-report.md`.
|
||
|
||
## Status block — Wave-A verification gate
|
||
|
||
- 2026-05-10T00:08:00+02:00 — [x] Wave-A verification gate green, ready
|
||
for Wave B (gate-run sha `94c748d`). Local clean clone passes
|
||
typecheck (0 errors), lint (12 pre-existing warnings), `pnpm test`
|
||
1153/1153, `pnpm test:integration` 41/41. CI Security & Quality
|
||
workflow consistently passes Wave-A commits. Integration + e2e CI
|
||
workflows are pre-existing red (predate Wave A by hours; identical
|
||
failure shape on v1.4.15 release commit `0985c93`); not a Wave-A
|
||
regression. `pnpm format:check` flags 34 .planning/docs/test files
|
||
but is not in any CI workflow. Detailed report:
|
||
`.planning/phase-wave-a-gate-report.md`.
|