Core Architecture

The Temporal Layer

Modern state managers answer "What is the current value?".
TCR answers "What happened, why, and can I go back?".

Traditional State

  • × Mutation-based updates
  • × Snapshot only (no history)
  • × "Where am I?"
  • × Reactive debugging

Temporal Layer

  • › Intent-based recording
  • › Traversable history
  • › "How did I get here?"
  • › Time-travel exploration

Core Concepts

01. Intent (Time-Traveller)

An intent is not just a payload. It's a record with a unique ID, timestamp, and semantic meaning. It travels through the temporal layer, subject to conflict resolution rules.

02. Reality (Projection)

Reality is merely the current projection of the history. Move the pointer back, and reality shifts instantly. It is lazy, computed, and ephemeral.

03. Resolution

Intents can be recorded, superseded (replaced by newer intents), discarded (rejected by logic), or deferred. This creates a causal graph of "why" a state exists.

Memory Architecture

Hot Tier

Binary Ring Buffer
  • Struct-of-Arrays layout
  • Zero-copy access
  • Deterministic bounds
Spill on pressure ↓

Warm Tier

IndexedDB / Worker
  • Compressed JSON
  • Lazy load on access
Export for debugging ↓

Cold Tier

Optional Export
  • Full history export for forensic analysis