Observability for railiance providing monitoring, metrics, alerting etc to enable the selforganizing control loop.
Find a file
tegwick e263a640c8 Record mailbox password supplied and scoped delivery gate
Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a0e6f1-443f-7783-9920-a16b2ffc467f
2026-09-28 11:21:57 +02:00
activity-definitions Prepare bounded telemetry runtime jobs and activity definitions 2026-09-06 19:32:26 +02:00
contracts Record mailbox password supplied and scoped delivery gate 2026-09-28 11:21:57 +02:00
docs Implement authenticated alert receipt acknowledgments and audit delivery 2026-09-28 11:11:33 +02:00
history Record mailbox password supplied and scoped delivery gate 2026-09-28 11:21:57 +02:00
integration Implement authenticated alert receipt acknowledgments and audit delivery 2026-09-28 11:11:33 +02:00
rules Complete local Prometheus mapping and record live acceptance blockers 2026-09-28 09:42:04 +02:00
scripts Implement authenticated alert receipt acknowledgments and audit delivery 2026-09-28 11:11:33 +02:00
tasks Prepare bounded telemetry runtime jobs and activity definitions 2026-09-06 19:32:26 +02:00
templates Implement authenticated alert receipt acknowledgments and audit delivery 2026-09-28 11:11:33 +02:00
tests Implement authenticated alert receipt acknowledgments and audit delivery 2026-09-28 11:11:33 +02:00
tests_runtime Implement authenticated alert receipt acknowledgments and audit delivery 2026-09-28 11:11:33 +02:00
workplans Record mailbox password supplied and scoped delivery gate 2026-09-28 11:21:57 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-09-28 11:13:16 +02:00
.gitignore Implement private Q2 signal contract and durable reference receiver 2026-09-06 19:17:59 +02:00
.repo-classification.yaml chore(classification): add repo classification 2026-08-25 14:02:41 +02:00
AGENTS.md Implement private Q2 signal contract and durable reference receiver 2026-09-06 19:17:59 +02:00
INTENT.md Place telemetry on the Quality dimension as Q2 Observability 2026-08-11 22:54:30 +02:00
LICENSE Seed INTENT, SCOPE, README for the observability layer 2026-08-11 21:51:42 +02:00
README.md Implement authenticated alert receipt acknowledgments and audit delivery 2026-09-28 11:11:33 +02:00
requirements-runtime.lock Implement authenticated alert receipt acknowledgments and audit delivery 2026-09-28 11:11:33 +02:00
requirements-runtime.txt Implement authenticated alert receipt acknowledgments and audit delivery 2026-09-28 11:11:33 +02:00
SCOPE.md Implement private Q2 signal contract and durable reference receiver 2026-09-06 19:17:59 +02:00
WORK-RECORDS.md Complete local Prometheus mapping and record live acceptance blockers 2026-09-28 09:42:04 +02:00

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.

Managed production package

rapp-telemetry packages Prometheus, Alertmanager and Grafana for railiance01, with telemetry.coulomb.social as the intended Grafana hostname. This repo retains Q2 contracts and rule meaning. The local receiver and activity candidates are reference tooling; do not enable them as a second production monitoring plane. The package records private installation and restore proof; delivery acceptance remains blocked in RTEL-WP-0002-T04. The Prometheus mapping supplies a tested report exporter and failure/absence rules for package integration.

The email acknowledgment component records an explicit Railiance admin confirmation with a durable audit-core outbox. It is not activated. Identity/policy adapters are implemented; native package admission, SMTP password custody and recipient proof remain under T04.