AINA data engine room - telemetry contract - 2026-06-09

Telemetry Contract v0

PostHog/Sentry-ready envelopes with external writes disabled.

The Single Idea

Telemetry can be made product-ready before it is connected to external sinks: pseudonymize learner references with a local HMAC key, count artifact refs, keep event names stable, and block raw profile/prompt/response payloads.

01

Snapshot

16events
8learner hashes
Falseexternal writes
0conversion errors
02

Event Names

EventCount
aina.data_engine_decision_generated8
aina.evaluator_completed8
03

Sink Contracts

SinkStatusExternalAllowedBlocked
posthoglocal_contract_only_disabledFalseevent_name, decision_id, packet_id, module_id, learner_ref_hash, overall_score, failed_gate_count, safe_propertieslearner_id, raw_profile, artifact_refs, response_text, prompt, freeform_payload
sentrylocal_contract_only_disabledFalseevent_name, source_event_type, decision_id, module_id, failed_gate_count, safe_propertieslearner_id, raw_profile, artifact_refs, response_text, prompt, freeform_payload
04

Boundary

This artifact is a local contract and safety proof only. It does not send events to PostHog, Sentry, or any external service, and learner references use a local HMAC pseudonym key stored outside git-tracked files.

Where to start
Keep this redaction contract intact before enabling any telemetry sink.