GraphQL API Layer — Architecture Document

## Dream Origin Dream ID: `dream_202601260133_1b112f` Pattern connections: Supabase integration, streaming pipelines, API performance, cross-project pollination - **Performance Prophet** → Health metrics streaming, trend-based subscriptions - **Thought Mesh** → Distributed real-time state propagation - **Cross-Script Bridge** → WebSocket-based real-time translation - **Dream Weaver** → Event-driven lifecycle with state transitions ### Core Principles 1. **Subscription-first** — Every mutation that changes observable state emits to subscribers 2. **Datasource-agnostic** — Resolvers talk to abstract datasource interfaces (Supabase, REST, in-memory) 3. **Layered middleware** — Auth, rate limiting, caching, and logging compose cleanly 4. **Type-safe end-to-end** — Schema → codegen → resolvers → client, all TypeScript The schema follows a **domain-driven** approach. Core domains identified from cross-project patterns: 1. **Relay-style pagination** — All list fields use `Connection` types with `edges` + `pageInfo` 2. **Input types for mutations** — Every mutation takes a single `input` argument 3. **Subscription payloads** — Subscriptions return wrapper types with `event` enum + `data` union 4. **Error unions** — Mutations return `Result` union types (`Success | ValidationError | NotFoundError`)