Skip to content

Latest commit

 

History

History
27 lines (20 loc) · 1.08 KB

File metadata and controls

27 lines (20 loc) · 1.08 KB

Architecture

The package is a synchronous, in-memory identity index with three structures:

stable view key ──> reconciled entity
mutation ID ──────> stable view key
canonical ID ─────> stable view key

An optimistic entry owns its view key. When an acknowledgement connects it to a canonical entry that arrived earlier, the optimistic key survives and the temporary canonical-only entry is removed. This avoids UI remounts.

All writes replace immutable public entry objects and publish a new snapshot. The map and array containers are internal. This makes getSnapshot compatible with external-store consumers without requiring a UI-framework dependency.

Boundaries

The core deliberately does not own networking, persistence, retries, list ordering, schema validation, or conflict timestamps. It also does not rewrite nested foreign-key references. These concerns have different lifecycle and consistency rules and should be layered around the identity primitive.

See ADR-0001 for the central safety decision.