health

Your personal Chief Medical Officer for AI Ready Life. Tracks lab results against clinical reference ranges (glucose, A1c, LDL, HDL, TSH, creatinine, and more), monitors wearable data from Oura Ring and Apple Health for anomalies, manages your medication refill schedule with 7-day early-fill buffers, surfaces preventive care gaps against age-appropriate screening schedules, and tracks your deductible progress and HSA balance. Produces a monthly wellness brief and flags out-of-range values the moment lab results arrive. All data stays local — nothing leaves your vault.

Exports iPhone Health data — steps, active energy, resting heart rate, body weight, and workouts — via an iOS Shortcut that saves a CSV or XML export to iCloud Drive for automatic Mac sync. No API key required; uses device-local export. The health agent reads the synced file from the configured iCloud Drive path. Owns dedup and append into vault/health/00_current/wearable-log.csv: every ingest checks each incoming row's date against existing dates and writes only new records. Can be used standalone or alongside Oura Ring. Configure the iCloud export path in vault/health/config.md.

Accesses patient portal records — lab results (PDF and structured values), visit notes, after-visit summaries, upcoming appointments, current medication list, and immunization records — from a provider's MyChart instance via Playwright with Chrome cookie authentication. Used by the health agent to download clinical data for local review and vault storage. Requires headless=False due to Chrome app-bound encryption. Configure your provider's portal URL and username in vault/health/config.md.

Fetches daily sleep, readiness, and activity data from the Oura Ring API v2 using a personal API key. Returns sleep score, total sleep duration, deep/REM/light sleep stages, HRV RMSSD (nightly), resting heart rate, readiness score (0-100), steps, and active calories. Owns dedup and append into vault/health/00_current/wearable-log.csv: every fetch checks each incoming day's date against existing rows and appends only records not already present. Used by the health agent for wearable data sync, 90-day baseline trend analysis, and anomaly detection. Configure API key in vault/health/config.md.

Builds a monthly HSA (Health Savings Account) utilization summary. Reports YTD qualified spend, current cash balance, current invested balance, contribution status vs annual limit, and a check against the configured invest-above threshold (default $2,000 cash buffer). Categorizes spend by IRS Publication 502 category. Flags receipts missing for any HSA withdrawal (audit risk). HSA balances and statements are uploaded manually since most HSA custodians lack a public API.

Builds a structured lab result summary with current biomarker values, reference ranges, trend direction vs. the prior panel, and out-of-range items surfaced first within each panel group. Compares glucose, A1c, LDL, HDL, TSH, creatinine, CBC, and all metabolic markers against clinical reference ranges and flags deviations with severity tier (borderline, elevated, critical).