ClickHouse Alert Context Hydration

Summary

This change makes alert details durable. Selecting an alert no longer depends only on the live cache to resolve evidence; the terminal asks the API for a ClickHouse-backed alert context bundle and uses that bundle to populate the existing drawer, classifier support, smart-money support, and prefetch evidence stores.

Changes Made

• Added fetchAlertContextByTraceId in storage to load an alert, linked flow packets, linked option prints, and unresolved evidence refs.
• Added GET /flow/alerts/:trace_id/context to the API without changing existing alert list, history, replay, or websocket feeds.
• Updated the terminal alert selection effect to fetch persisted context in live, replay, and history modes.
• Merged hydrated packets and prints into pinned maps so existing evidence consumers share the resolved context.
• Adjusted alert drawer copy and loading state to reference persisted context rather than live cache misses.
• Expanded alert evidence print rows with execution NBBO side, bid, ask, mid, spread, quote age, underlying spot, bid, ask, and mid where available.

Context

Alert rows intentionally remain lightweight for live bursts. The detail drawer is the right place to hydrate heavier investigative context because it runs only when a user asks for a specific alert. The authoritative linkage remains AlertEvent.evidence_refs.

Important Implementation Details

The new API response shape is:

{
  alert: AlertEvent | null,
  flow_packets: FlowPacket[],
  option_prints: OptionPrint[],
  missing_refs: string[]
}

Flow packet refs are resolved with both prefixed and unprefixed candidates. Option print refs are resolved by trace_id. Missing refs are returned explicitly instead of failing the whole response.

Expected Impact for End-Users

Alert details should feel more trustworthy after cache churn or replay navigation. Users can select an older or non-hot alert and still see the preserved evidence context needed to evaluate the signal.

Validation

• bun test packages/storage/tests
• bun test services/api/tests
• bun test apps/web/app/terminal.test.ts
• bun --cwd=apps/web run build

Issues, Limitations, and Mitigations

• The endpoint is detail-time only, which avoids making alert list payloads heavier during bursts.
• Malformed trace ids are rejected by route-level validation.
• Missing evidence refs remain visible to the drawer as diagnostics rather than hiding partial context.
• No schema migration was needed because option prints already persist execution context fields.

Follow-up Work

No follow-up beads issue was filed. The requested storage, API, frontend, tests, build, and documentation work is complete.