mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-18 16:12:11 +00:00
Phase E ticked complete in STATE.md; v1.4.20 archived to ROADMAP "Previous milestone" with completion timestamp. Top of ROADMAP scaffolds v1.4.21 with carry-over candidates from .planning/v1421-backlog.md. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
318 lines
17 KiB
Markdown
318 lines
17 KiB
Markdown
# 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/<section>` 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 `<InsightsPageHero>` 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] `<CorrelationRow>` + `<TrendsRow>` 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] `<HealthChart>` 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 `<lg`
|
||
open side-sheets that host the same HistoryRail / SourcesRail
|
||
the desktop layout uses; refactored body into
|
||
`<CoachDrawerBody>` 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 `<Sheet side="right">` with three-column
|
||
layout on `lg+` (history rail · message thread · sources rail) and
|
||
full-screen single-column on mobile; `<MessageThread>` renders user
|
||
/ assistant bubbles + an in-flight streaming bubble with
|
||
pinned-to-bottom auto-scroll; `<SourceChips>` renders provenance as
|
||
labels-only chips (metric · window · n-count, never raw values);
|
||
`<CoachInput>` 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; `<HistoryRail>` with substring filter
|
||
and confirm-then-go delete; `<SourcesRail>` 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;
|
||
`<HealthScoreCard>` (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?"); `<HeroStrip>` 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.
|