Family Assistant v1.5 — Wadsworth Review & Confirmation
Document Type: Scope Confirmation
Date: 2026-04-21
For Review By: Matt
Prepared By: Daedalus 🎨
Related Scope: SCOPE.md (source of truth)
Executive Summary
Family Assistant v1.5 addresses trust and reliability gaps from the April 2026 audit. Six features scoped across P0–P2. This document is the review checklist and approval form.
Feature Summary
| # | Feature | Priority | Backend Owner | Frontend Owner |
|---|---|---|---|---|
| 1 | Undo Stack | P0 | Socrates | Daedalus |
| 2 | Persistent Conflict Registry | P0 | Socrates | Daedalus |
| 3 | Brain Offline Fallback | P1 | Socrates | Daedalus |
| 4 | Family Dashboard (Read-Only Calendar) | P1 | Socrates | Daedalus |
| 5 | Newsletter Digest v2 | P2 | Socrates | Daedalus |
| 6 | Proactive Travel Notifications | P2 | Socrates | Daedalus |
Decision Points — Requires Your Input
These are the open questions from SCOPE.md. We need your answers before work begins:
1. Undo TTL ⏱️
Question: Is 5 minutes sufficient for the undo window?
Options:
- A. 5 minutes (default, matches SCOPE)
- B. 10 minutes (safer for hesitant users)
- C. Configurable per operation type (move=10min, cancel=5min, rename=5min)
Recommendation: B — 5 minutes feels rushed for a family at 7 AM.
Your call: B — 10 minutes
2. Conflict Nag Escalation 📢
Question: Who gets the escalation after 3 unacknowledged conflict alerts?
Options:
- A. Family group chat only (current behavior, less intrusive)
- B. DMs to Matt only (you absorb the noise, Aundrea shielded)
- C. DMs to whoever created the conflict (detect who added the second event)
Recommendation: B — Aundrea shouldn't be spammed; Matt handles infrastructure.
Your call: B — Matt DM, escalate to group if unaddressed by end of day
3. Dashboard Auth 🔐
Question: How should Aundrea access the read-only family dashboard?
Options:
- A. Passwordless token link (time-limited URL, e.g., hoffdesk.com/family?token=xyz)
- B. Simple 4-digit PIN (easy for family, easy to share)
- C. Telegram OAuth (only works if accessed via Telegram in-app browser)
Recommendation: A — Passwordless is sovereign, no account management.
Your call: A — Passwordless token link (standard dashboard protocols)
4. Travel Buffer 🚗
Question: Fixed 5-minute buffer before leave-by time, or configurable?
Options:
- A. Fixed 5 minutes (simple, matches SCOPE)
- B. Configurable per event type: Medical=15min, Sports=5min, School=10min
- C. Always 10 minutes (maximum safety)
Recommendation: B — Medical appointments deserve more buffer than soccer practice.
Your call: A — Fixed 5 min (P2 deferred to v2.0 to keep cron ≤30 min)
What's Already Decided (No Action Needed)
| Decision | Value | Rationale |
|---|---|---|
| Undo stack depth | 5 operations | Caps storage, sufficient history |
| Conflict nag threshold | 3 alerts | Balance persistence vs. spam |
| Brain fallback mode | Keyword search | Graceful degradation, no hard failures |
| Calendar views | Week default, day included, month optional | Family planning is weekly |
| Person colors | Sullivan=blue, Harper=pink, Family=green | Pre-assigned in design tokens |
| Newsletter categories | School, Sports, Medical, Community, Other | Matches household structure |
Deliverables by Owner
Socrates 🧠 (Backend)
| Module | Status |
|---|---|
undo_stack.py |
Not started |
conflict_registry.py |
Not started |
brain_fallback.py |
Not started |
travel_alerts.py |
Deferred to v2.0 |
digest_generator.py |
Not started |
| API endpoints (11 total) | Not started |
Daedalus 🎨 (Frontend)
| Component | Status |
|---|---|
| Undo Toast | Not started |
| Conflict Badge | Not started |
| Conflict Detail Panel | Not started |
| Calendar Week View | Not started |
| Calendar Day View | Not started |
| Digest Card | Not started |
| Offline Badge | Not started |
| Design Tokens | Not started |
Pre-Requisites Before Work Begins
- [ ] This document signed off (Matt approves decisions + scope)
- [ ] API specs written (Socrates →
shared/api-specs/family-assistant-v1.5.yaml) - [ ] Design tokens finalized (Daedalus →
shared/design-tokens/family-assistant/) - [ ] v1.0 stabilized (v1.5 builds on stable foundation)
Approval Form
Your name: Matt Hoffmann
Date: 2026-04-21
| Decision | Your Choice |
|---|---|
| Undo TTL | B — 10 minutes |
| Conflict Nag Escalation | B — Matt DM, escalate to group EOD |
| Dashboard Auth | A — Passwordless token link |
| Travel Buffer | A — Fixed 5 min (deferred to v2.0) |
Scope Approval: ✅ Approved by Matt 2026-04-21
Scope Approval with changes: ☐ (attach delta)
Rejected: ☐
Signature: _________
Next Steps After Approval
- Socrates writes API specs →
shared/api-specs/family-assistant-v1.5.yaml - Daedalus creates design tokens →
shared/design-tokens/family-assistant/ - Both work in parallel against contracts
- Weekly sync (Tuesdays?) to review progress
- Alpha test when P0 features complete
- Beta test when all features complete
- Production push after your sign-off
Prepared by Daedalus 🎨 for Matt's review. Questions? Ask in Telegram or add to this document.