Phase 6/7 Bridge — Event Graph + Family Dashboard

Director Decision: Phase 7-ready, not MVP. Family iPad dashboard with proper auth.
Timeline: Aggressive — this week for skeleton, next week for features
Dispatch: Socrates (backend) + Daedalus (frontend) — parallel with API contract

Event Graph (Socrates)

Schema Requirements (Phase 7-Ready)

events
  id, source, source_id, event_type, title, description
  start_date, end_date, all_day, timezone
  location, location_lat, location_lon
  family_member, assigned_to, status
  confidence, extracted_at, created_at, updated_at
  raw_text, document_url

coordination
  id, event_id, context, needs_confirmation, blocking
  assigned_to, child, extracted_dates
  confirmed_at, confirmed_by

maintenance
  id, event_id, item_name, category, who
  last_done, next_due, interval_days, interval_miles
  service_type, provider, cost, warranty_expires
  document_url, confidence

conflicts
  id, event_ids[], conflict_type, severity
  detected_at, resolved_at, resolution
  notified, acknowledged_at

members
  id, name, role, email, telegram_id
  calendar_url, preferences

API Contract

POST /api/v1/events — create from document pipeline
GET /api/v1/events — list with filters (date_range, member, type)
GET /api/v1/events/:id — single event
PUT /api/v1/events/:id — update
DELETE /api/v1/events/:id — soft delete

GET /api/v1/briefing — HBM hierarchical briefing
  Query: date, member, scope (day/week/month)
  Response: { daily: {}, upcoming: [], coordination: [], maintenance: [] }

GET /api/v1/maintenance — upcoming maintenance items
GET /api/v1/conflicts — active conflicts
POST /api/v1/conflicts/:id/acknowledge

WebSocket /ws/events — real-time updates

Integration Points

• Document pipeline writes to events table after classification
• Coordination extraction writes to coordination table
• Conflict scanner reads from events, writes to conflicts
• HBM generator reads all tables, produces briefing

Family Dashboard (Daedalus)

iPad-First Design

• 1024×768 minimum, touch-optimized
• Cards, not tables
• Large tap targets (min 44pt)
• No hover states

Views

1. Today — what's happening now/soon
2. Week — upcoming events, maintenance due
3. Documents — recent documents with preview
4. Family — per-member view
5. Settings — preferences, notifications

Auth

• Same middleware sessions as existing Icarus
• Family user table with roles (admin/parent/child/viewer)
• Session cookie + CSRF protection
• No passwords stored locally — delegate to OAuth or use secure cookie tokens

Real-Time

• WebSocket connection for live updates
• Briefing cards auto-refresh on new documents

API Contract (Both Agents)

Data Shapes

interface Event {
  id: string;
  type: 'calendar' | 'coordination' | 'maintenance' | 'document';
  title: string;
  description?: string;
  startDate: string; // ISO
  endDate?: string;
  allDay: boolean;
  member: string; // 'matt' | 'aundrea' | 'sullivan' | 'harper' | 'family'
  location?: string;
  status: 'confirmed' | 'tentative' | 'needs_action';
  source: string; // 'email' | 'document' | 'manual' | 'inference'
  confidence: number;
}

interface Briefing {
  date: string;
  sections: {
    urgent: Event[]; // next 24h
    today: Event[];
    coordination: Event[]; // needs confirmation
    maintenance: Event[]; // due soon
    documents: Document[]; // recent
  }
}

Endpoint Prefix

/api/v1/

Auth Header

Authorization: Bearer <session_token>

Dispatch Instructions

Socrates — Immediate

1. Create Event Graph schema (SQLite + SQLAlchemy)
2. Implement CRUD API (FastAPI)
3. Integrate with document pipeline
4. Build HBM briefing generator
5. WebSocket endpoint for real-time

Daedalus — After API contract confirmed

1. React/Next.js scaffold
2. Auth middleware integration
3. Today view (consumes GET /api/v1/briefing)
4. Week view
5. Document browser
6. iPad optimization pass

Parallel Work

• Socrates builds API
• Daedalus builds UI with mock data
• Both test with staging API
• Integration at end of week

Files

• shared/api-specs/event-graph-api.md — full API contract
• shared/api-specs/dashboard-ui-spec.md — component spec
• shared/design-tokens/ipad-layout.json — layout tokens

Status: Approved for dispatch
Next: Socrates spec first, Daedalus UI spec parallel