Contract-First Telemetry

Pitgun
Telemetry Framework.

Ingest real-time events, validate them against public schemas, process high-frequency telemetry, and turn it into reliable operational insight.

Event Envelope Metrics Dictionary Gateway Metrics
PG
Runtime Contracts
Gateway Active
$ cargo run -p pitgun-gateway --release
# Accepting pitgun-envelope-v1 events...
$ curl /schemas/pitgun-envelope/v1
✓ Public contract resolved
Current Status
Runtime Schema Published
v0.22

Runtime Modules

Composable Rust services and schemas. Use the gateway alone or build a full processing pipeline.

1
01

Event Gateway

HTTP/WebSocket ingress layer for runtime events. Accepts the public pitgun-envelope-v1 contract, writes accepted events, exposes Prometheus metrics, and can mirror domain-specific runs to downstream services.

2
02

Processing Core

pitgun-core provides manifest-driven pipelines, formula evaluation, conversion, and aggregation primitives. It is the processing layer behind telemetry normalization and reproducible analysis.

3
03

Public Schemas

Versioned JSON Schemas define the stable boundary between producers, processors, and insight services: event envelopes, metric dictionaries, pipeline manifests, bundle manifests, and analysis contracts.

4
04

Reference Apps WIP

Pitgun the game is a live reference implementation for motorsport telemetry. Solver and authority concepts remain advanced modules, but the framework itself stays domain-agnostic.

Contracted Telemetry Flow

Ingress

Producers send pitgun-envelope-v1 events over HTTP or WebSocket.

Processing

Gateway validates, queues, writes, and exports runtime metrics.

Compute

Core pipelines derive metrics and summaries from canonical dictionaries.

Insight

Analysis manifests and insight contracts feed reporting services or LLM tools.