mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-17 07:42:23 +00:00
- STATE.md: F6 ticked complete with the two healthlog-docs commits (19eb8de S3 + arm64 + 3d3ea21 production-state alignment) - phase-F6-report.md: 38 pages checked, 2 CRIT + 10 HIGH inline, 9 MED + 5 LOW deferred, 2 flagged-but-uncertain items captured - v1421-backlog.md: F6 audit findings appended (co-edited with F5) Foundation phases F0/F1/F2/F5/F6/FX complete; develop ready for B1 dispatch (Insights redesign hero + Daily Briefing). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
7.5 KiB
7.5 KiB
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
- Commit phase-E1-report.md + phase-E3-report.md v1.4.19 updates
- STATE.md replaced with v1.4.20 scaffold; v1.4.19 archived to ROADMAP.md
- ROADMAP.md updated with v1.4.20 milestone + previous-milestone archive
F1 — Branch model: long-lived develop
- Create
developfrom cleanedmainHEAD (a1cf9bc) - Push
developto origin (tracking set up) - GHCR workflow verified — only
branches: [main]+tags: ['v*']push paths build/publish; PRs tomainbuild but do not push; develop is build-free - All v1.4.20 commits target
develop; release-merge tomainonly at Phase E - Detailed report:
.planning/phase-F1-report.md
F2 — Document branch + release model
- Extend
CONTRIBUTING.mdwith branch flow + ASCII diagram (this branch) - Mirror page on healthlog-docs at
/contributing/branch-model/(5d96861on healthlog-docs/main) - 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).
- HealthLog main repo: 20 files scrubbed,
a1cf9bcon origin/main (CHANGELOG.md, docs/audit/v146 / v1414 / v1415 / v1416 / v1418 / v1419, docs/codex-protocol-spec.md, docs/migration/, docs/ops/) - healthlog-docs: 7 files scrubbed,
782862bon origin/main (api/ examples replaced "marc" → "alice", DE leaks fixed) - healthlog-landing: 1 file scrubbed,
9b31083on origin/main (JSON-LD author block depersonalised) - GH releases v1.4.14–v1.4.19: republish bodies from cleaned CHANGELOG sections (see Phase E pipeline)
- Source-comment sweep (
src/has 191Marcreferences 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
- CODE_OF_CONDUCT.md (Contributor Covenant 2.1,
e7b6b27) - Issue + PR templates (
.github/ISSUE_TEMPLATE/*.yml,PULL_REQUEST_TEMPLATE.md,072941b) - Dependabot expanded to github-actions + docker (
779e5a3) - package.json metadata: description, license, homepage, repository, bugs, keywords (
f7977d1) - 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
- 38 docs site pages cross-checked against the live app (v1.4.19), CHANGELOG,
.env.example, Dockerfile, docker-compose, docker-publish workflow - CRITICAL fixed inline:
19eb8de(S3 env-var names + arm64 build claim removed) on healthlog-docs/main - 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 - 9 MED + 5 LOW deferred to
.planning/v1421-backlog.md"Docs site audit" section - 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)
- Replace
<InsightsPageHero>with new hero strip (greeting, 3 micro-stat tiles, AI Coach entry block, Daily Briefing card) - New
src/components/insights/{hero-strip,daily-briefing, suggested-prompts}.tsx - Extend
aiInsightResponseSchemawithdailyBriefing(paragraph,keyFindings[]) - PROMPT_VERSION bump 4.19.0 → 4.20.0
- Apple Health gated tiles render "Connect Apple Health (iOS app)" placeholder until v1.5 ships
- Detailed report:
.planning/phase-B1-report.md
B2 — AI Coach panel + streaming chat + persistence (~5-7 days)
- Drawer overlay over
/insights; full-page route deferred to v1.5 - New
POST /api/insights/chatSSE-streaming endpoint - New
src/components/insights/coach-panel/* - New Prisma
CoachConversation+CoachMessage(encrypted content, GDPR cascade) - Source-chip rows on every assistant message (provenance)
- Token-budget cap + 20-turn conversation cap
- Prompt-injection refusal pattern (extend v1.4.15 C1)
- Detailed report:
.planning/phase-B2-report.md
B3 — Correlation discovery + Trends row with AI annotations (~3-5 days)
- 3 pre-defined hypotheses: BP×compliance, mood×pulse, weight×weekday
- New
src/lib/insights/correlations.ts - New
src/components/insights/{correlation-card,trends-row, trend-annotation}.tsx - Confidence ≥ 0.95, n ≥ 14, conservative phrasing
- Detailed report:
.planning/phase-B3-report.md
B4 — Weekly Report + Storyboard + Mobile passes (~3-4 days)
- New
/insights/report/[week]route +window.print()export - Storyboard 90-day BP timeline with annotations[]
- Mobile passes: B1 + B2 mobile equivalents (drawer → full-screen sheet)
- Detailed report:
.planning/phase-B4-report.md
B5 — Personal AI Coach Health Score (~2-3 days)
- Composite Health Score (0-100): 30% BP-target + 20% weight-trend + 20% mood-stability + 30% compliance
- Three bands (≥75 green, 50–74 yellow, <50 red)
- "Ask the Coach" CTA opens B2 drawer with prefilled prompt
- Detailed report:
.planning/phase-B5-report.md
Wave D — Multi-agent QA + Product-Lead review
- code-reviewer
- security review
- design / UX review
- senior-dev review
- simplify
- Product Lead — v1.5 redesign plan
- Reconcile applied CRITICAL + HIGH; defer MED/LOW to v1.4.21
- Detailed report:
.planning/phase-D-v1420-reconcile-report.md
Phase E — Release v1.4.20
- Pre-release verify (typecheck, lint, test, integration, format, build)
- Bump package.json + CHANGELOG
- Merge develop → main (release-merge only)
- Tag + push v1.4.20
- GHCR build green
- Coolify deploy
- /api/version=1.4.20 confirmed
- Production smoke
- GH release
- Docs site + landing site sync
docs/audit/v1420-summary.md(release brief)- Update v1.5 plan based on what v1.4.20 learned
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 (stillmain); F1 will introducedevelop.