Module telemetry 

Host-side telemetry decoders for the megakernel ring and control buffers.

The runtime already exposes low-level helpers such as read_done_count, read_epoch, and read_metrics. This module adds a single structured snapshot surface useful for wrappers like VyreOffload.

Structs

ControlSnapshot

Structured view of the control buffer.

CountMinSketch

Fixed-depth Count-Min sketch for compact megakernel telemetry.

ResidentRuntimeCounters

Aggregated runtime performance counters derived from one telemetry snapshot.

ResidentRuntimeEvidence

Runtime-owned IO/residency evidence envelope for release and benchmark artifacts.

ResidentWatchdogSnapshot

Watchdog view computed from two host-visible telemetry snapshots.

RingOccupancy

Slot occupancy counts across the ring.

RingSlotSnapshot

Snapshot of one ring slot.

RingTelemetry

Combined host-visible telemetry for a megakernel run.

RuntimeEvidenceMetricCoverage

Coverage bits for the required runtime evidence metric families.

SketchTelemetry

Compact sketch summary derived from a megakernel telemetry snapshot.

SketchTelemetryScratch

Caller-owned scratch for repeated compact telemetry sketches.

TelemetryDecodeCapacityEvidence

Evidence that a telemetry decode used caller-owned output and scratch buffers.

TelemetryDecodeScratch

Caller-owned scratch for repeated megakernel telemetry decodes.

WindowTelemetry

Aggregated telemetry for one ticketed route window.

Enums

RingStatus

Decoded top-level ring slot state.

RuntimeEvidenceMetricFamily

Required metric families for runtime IO/residency evidence.

Constants

RUNTIME_IO_EVIDENCE_SCHEMA_VERSION

Schema version for IO/runtime evidence emitted from megakernel telemetry.

TELEMETRY_DECODE_CAPACITY_SCHEMA_VERSION

Schema version for telemetry decode capacity evidence.