Coding Projects

flowchart TB
  USER["📱 Mike (iPhone) — installed PWAs + push"]
  HUB["🦚 mikeslife hub
doc: lifeos/uid"]
  subgraph RUP["Rupert — agent / data engine"]
    CLOUD["☁️ Vercel crons in mikeslife
brief · context · banners · heartbeat
travel · fitness-coach · updates · nutrition
/api/rupert chat (OpenAI or Claude, auto-fallback)"]
    MINI["🖥️ Mac mini (OpenClaw)
adamjobs + social digests only"]
  end
  subgraph SPOKES["Spoke apps — each its own Firebase project"]
    FIT["💪 fitness"]
    HLTH["🫀 health"]
    MON["💰 money"]
    RENT["🏠 rentals"]
    UPD["📡 updates"]
    NUT["🥗 nutrition"]
    TRAV["✈️ travel"]
  end
  USER -->|read/write| HUB
  USER -->|read/write| SPOKES
  USER -->|peacock chat| CLOUD
  CLOUD <-->|read slices / write brief, content| HUB
  CLOUD -->|read curated data via admin SAs| SPOKES
  CLOUD -->|write banners + generated content| SPOKES
  MINI -->|digest alerts| HUB
  HUB -->|FCM push| USER

Today's shift: the Rupert banners for money & rentals moved from the mini to cloud crons (cron-finance-note, cron-rental-note), joining cron-fitness-note. The mini is now down to the non-critical adamjobs/social digests.

One app = one project = one source of truth. Only shared project: trip-planner-5cc84 (fitness + mikeandadam). Rupert reaches other projects with per-project admin service-account keys (Vercel env in the cloud).

flowchart LR
  subgraph SRC["Spoke sources of truth"]
    FIT["💪 fitness"]
    HLTH["🫀 health"]
    MON["💰 money"]
    GOOG["📧 Google Cal + Gmail"]
  end
  subgraph CRONS["Vercel context crons (read)"]
    CF["cron-fitness-context"]
    CH["cron-health-context"]
    CM["cron-finance-context"]
    CG["cron-google (3d/30msg + delivery sweep)"]
  end
  SL["lifeos/uid slices:
fitnessContext · healthContext
financeContext · calendarText
emailText (+snippets +deliveries)"]
  subgraph THINK["Rupert thinks — OpenAI or Claude (settings.aiProvider)"]
    BR["cron-brief → todayBrief"]
    CHAT["/api/rupert chat"]
  end
  subgraph OUT["Write-out"]
    WU["cron-updates → updates"]
    WN["cron-nutrition → nutrition"]
    WB["banners: fitness/finance/rental-note"]
  end
  FIT --> CF --> SL
  HLTH --> CH --> SL
  MON --> CM --> SL
  GOOG --> CG --> SL
  SL --> BR
  SL --> CHAT
  THINK --> OUT

Read-in: daily, just before the brief, cloud crons distill each spoke into a few lines in lifeos/uid. Write-out: other crons generate content + banners into the spokes' own Firestore. New: the brain is now provider-agnostic (api/_llm.js) — flip OpenAI↔Claude in Settings.

sequenceDiagram
  autonumber
  participant G as Google
  participant SP as Spokes
  participant L as lifeos/uid
  participant B as cron-brief
  participant P as iPhone
  Note over G,L: context syncs ~10:50 UTC
  G->>L: cron-google → calendar, email(+deliveries)
  SP->>L: fitness/finance/health-context → slices
  Note over B: runs hourly, fires at settings.briefHour (def 7 ET)
  L->>B: commitments, plans, slices, recent-focus, doneLedger
  B->>B: Top of mind · Focus · Health · FYI · Delivery · Looking ahead
  B->>L: write todayBrief (idempotent per ET day)
  B->>P: FCM push (suppressed during quiet hours)
  P->>L: tap ✓ handled → marks plan task done

Today's changes: the brief + check-in crons now run hourly, gated to settings.briefHour (so you can move your brief time); quiet hours suppress the push while still writing data; the Gemini-style brief adds Delivery updates + Looking ahead; and doneLedger stops completed items resurfacing.

flowchart TB
  HAE["Health Auto Export (iPhone)"] -->|POST webhook + token| HF["Cloud Function: mikeshealthHealthIngest"]
  HF -->|normalize + write| HD["mikeshealth: dailyMetrics + biology/bio"]
  HD -->|cron-health-context| L["lifeos.healthContext"]
  PLAID["Plaid"] -->|syncItem Cloud Function| MD["mikes-money: accounts/transactions"]
  MD -->|daily dashboardSnapshots| MS["snapshot"]
  MS -->|cron-finance-context| L2["lifeos.financeContext"]
  GAPI["Google APIs (OAuth)"] -->|cron-google| L3["lifeos.calendar / emailText"]

Two-hop for health: Apple Health → mikeshealth Cloud Function → Firestore → context cron → lifeos. That Cloud Function deploys separately (firebase deploy --only functions) — it does not ship with Vercel.

Heartbeat (NEW): cron-heartbeat (14:00 UTC) checks that Google + the three context syncs + today's brief actually ran; if anything is >26h stale it pushes one alert — so silent failures surface instead of hiding.

Banners: a rupert/note doc in each spoke's Firestore (now written by cloud crons) drives the shared RupertBanner atop that app.

Push: all notifications come from mikeslife via FCM. Fix today: only the latest FCM token is kept, ending the duplicate-morning-ping bug.

Principles: loose coupling (per-project Firebase, one-directional cross-project access via Rupert's keys) · agentSlices not duplication · cloud-first (mini now nearly retired) · git push auto-deploys frontends + Vercel crons.

Watch out for: Firebase Cloud Functions don't auto-deploy (separate firebase deploy --only functions) · local folders can drift behind GitHub (pull/clone fresh) · a new Rupert↔spoke link needs that project's admin SA in Vercel env (missing = 503) · Eastern-time everywhere (never UTC toISOString().split()).