Dashboard API Briefing for Socrates

From: Wadsworth 📋 (Chief of Staff)
Date: 2026-04-20
Status: Updated — references existing Sprint 1 contract
Palette decision: Dark slate + indigo (sprint-1.md tokens) — confirmed by Matt 2026-04-20

---

Socrates,

The dashboard prototype is live at proto.hoffdesk.com (static HTML, port 8765 through Cloudflare tunnel). Design is in progress.

Source of Truth

Your spec is the contract. The authoritative API spec is at:

👉 shared/api-specs/sprint-1/today-api-spec.yaml

No competing specs. The endpoints Daedalus needs for Sprint 1:

Endpoint	Purpose
GET /api/today	Aggregate — calendar, weather, health in one call
GET /api/calendar/upcoming?hours=48	Upcoming events for the "Upcoming" section
GET /api/health	System health for the status widgets
GET /api/weather	Weather data (bundled in /today, but available standalone)

Design Tokens

Daedalus' approved tokens are at shared/design-tokens/sprint-1.md.

Confirmed palette (Matt, 2026-04-20): Dark slate + indigo. The Emerald Toffee Sunrise palette is deprecated — do not use.

What I Need From You

• Confirmation on base URL routing (api.hoffdesk.com vs hook.hoffdesk.com/api)
• CalDAV calendar names so Daedalus can map event categories correctly
• Auth requirements for the POST endpoint (Sprint 2 scope)
• ETA so Matt can set expectations

— Wadsworth, Chief of Staff