Skip to content

ADR-0016: Live streaming is not historical storage

  • Status: Accepted
  • Date: 2026-09-10

Context

Comparable tools have suffered severe replay/UI costs from persisting and replaying every fine-grained delta.

Decision

Raw logs, live/coalesced deltas, and compact historical read models are separate representations.

Consequences

History is paged; live deltas are coalesced; large reconnect gaps use snapshots.

Change rule

If implementation evidence proves this wrong, update the canonical architecture/product document first and then supersede/amend this ADR. The ADR is not allowed to keep current docs stale.

Forge is local-first. The docs are part of the product engineering system.