Module cursor 

Cursor and walking primitives for Orbit rings.

This module owns the generic “walk counters from cursor toward head” semantics shared by event streams, cache compaction, metrics, and future ring-backed substrates. Semantic layers decode frames after this layer has handled wraparound, in-flight slots, loss, and cursor advance.

Structs

RingCursor

Caller-owned position in a ring walk.

RingLoss

Counters skipped while walking a ring.

RingPoll

Result of walking a cursor toward a ring’s visible head.

Enums

RingRead

Result of reading one logical counter from a ring source.

Traits

RingFrameSource

Read-only source that can be walked by RingCursor.

Functions

poll_ring

Walk cursor toward the current visible head of source.