railiance-telemetry/README.md
tegwick cecef79f31 Implement private Q2 signal contract and durable reference receiver
Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a06ecb-456a-71c2-b41e-0755d336e883
2026-09-06 19:17:59 +02:00

1.4 KiB

railiance-telemetry

Observability for Railiance providing monitoring, metrics, alerting etc to enable the self-organizing control loop.

Status: private reference implementation. A versioned signal contract, SQLite receipt/inbox CLI and platform adapter are implemented and tested. No monitoring runtime or notification schedule is installed by this work. See the contract and workflow.

Why this repo exists

Five Railiance layers independently declare that they intend to be "self-evidencing" or "auditable" — infra, cluster, platform, apps, and forge. None of them owned the place that evidence goes. This repo is that place.

It owns the signal, not the meaning of the signal: conformance rules and consistency checks stay with the repos that own those concerns, and telemetry carries and surfaces their output.

Start here

  1. INTENT.md — why this exists and what it is becoming
  2. SCOPE.md — in scope, out of scope, how it fits
  3. AGENTS.md — session protocol
  4. workplans/

Placement and verification

Quality dimension, Q2 Observability, as recorded in INTENT/SCOPE. Monitoring workload packaging remains outside this repo.

Run python3 -m unittest discover -s tests -v (Python 3.11+, no dependencies). Live acceptance is tracked by RTEL-WP-0002-T04; local receipts are not external operator delivery proof.