🗂️ Registry Architecture

This section describes the segment registry as the lifecycle/cache orchestration layer between SegmentIndex and Segment instances.

Topics

• Segment Registry — responsibilities, state machine, per-entry model, and operation semantics.

Diagrams

• Registry states
• Get: cache hit READY
• Get: cache hit LOADING wait
• Get: cache miss with putIfAbsent(LOADING)
• Eviction: removeLastRecentUsedSegment(...)