Skip to content

ADR-0017 — Candle runtime and materialization model

Status: Accepted
Date: 2026-08-28

Context

Candles must support both incremental live operation and reproducible historical data.

Decision

CandleDefinition owns reproducible semantics. A PARTIAL candle is mutable and incremental and is not sealed. A CLOSED candle is immutable after closure. A reusable closed-candle series may be persisted as a canonical derived dataset with catalog, partition and lineage semantics.

Consequences

Candles are first-class representations, not merely features. Candle code and schemas remain future work.