Build Log

Known's Third Pillar — Today's Handoff

July 2, 2026

Reframed the 'Jan-herself gap' as care-load transferability, then shipped the smallest real version by extending an existing share link instead of building new infrastructure.

KnownFeatureCaregiver UX

new DB tables — fully reused existing schema

features shipped (Handoff notes on share page, one-tap Send)

silent file-write failures caught and recovered

Timeline

Start

Received the Charge

GPT-refined brief reframing 'Jan-herself gap' as care-load transferability, not caregiver wellness

20m

Reconciled brief against real code

Explore agent found Worth Noticing and Day History already substantially built — only Today's Handoff was a real gap

35m

Design-tier Crucible (architect/ux/steward)

First pass was shallow/boilerplate; pushed back and got two concrete, usable findings: regenerate-live not cached, and one-tap share over a full form

55m

Shipped v1 — Recent notes on share page

Extended /care-card/[shareToken] with a live-queried 48h handoff-note feed; fixed a pre-existing onClick crash found during verification

80m

Shipped v2 — one-tap Send

New SendHandoffButton (navigator.share + clipboard fallback); caught two silent write failures via user report + grep verification

95m

Removed 'Add from a recent chat' entry points

Explicit user call — button was confusing next to the new Send action; route/feature itself untouched

What shipped

Today's Handoff v1: /care-card/[shareToken] share page now shows recent (48h, non-private) handoff notes above the static Known Card — same link, no new token

Today's Handoff v2: SendHandoffButton on the portrait page — one tap silently enables sharing if needed, opens native share sheet (navigator.share), falls back to clipboard copy

Fixed pre-existing Server Component onClick crash on the care-card share page (replaced raw button with existing PrintButton client component, extended it to accept custom label children)

Updated SharePanel copy from 'Private caregiver link' to Today's Handoff framing

Removed 'Add from a recent chat' entry points from home page and portrait page (route/feature left intact) per explicit user request

“I get nervous about 2 because that won't help until things are built up”
— Zeb, catching that the 'activity idea from Behavior Loop' v2 candidate had a hidden dependency on a sibling session's feature having real adoption first