Observability — ADRs
Architecture decisions in the observability field.
Decisions about what the framework reveals at runtime: execution_id routing so concurrent runs don't cross streams, shell hooks for external interception, the two-layer execution log system (automatic port I/O + voluntary _self_log), and the unified ErrorBus that surfaces every exception, log record, API failure, and React crash into the bottom-panel Report tab + toast layer.
| ID | Title | Date | Status | Supersedes |
|---|---|---|---|---|
adr-observability-001 |
execution_id routing for concurrent runs |
2026-03-22 |
accepted | — |
adr-observability-002 |
Hook system — pre/post node execution interceptors | 2026-04-02 |
accepted | — |
adr-observability-003 |
Node output log system — two-layer execution logging | 2026-04-07 |
accepted | — |
adr-observability-004 |
Unified error reporting bus — ErrorBus, ErrorEnvelope, error_event WS frame, Report tab |
2026-05-04 |
accepted | — |
adr-observability-005 |
Per-node LLM usage tracked via ContextVar hook in executor | 2026-05-10 |
accepted | — |