ADR 0003: Separate versioned control and IQ WebSockets¶
- Status: accepted
- Date: 2026-08-24
Decision¶
Use one JSON control WebSocket and one binary IQ WebSocket per session. The control plane is low-rate, inspectable, acknowledged, and schema-versioned. IQ frames use a fixed 80-byte network-byte-order header followed by sample bytes.
Separate channels prevent high-volume IQ backpressure from delaying stop,
lease, error, and status messages. Sequence and sample counters make loss and
retune discontinuities explicit. Full details are normative in
docs/protocol/V1.md.
Evolution¶
Breaking wire changes increment the major version. Receivers reject unknown major versions; additive flags or JSON fields use minor versions. Reserved fields must be transmitted as zero and ignored on receipt.