---
id: RTELE-WP-0001
type: workplan
title: "Bootstrap State Hub integration"
domain: financials
repo: railiance-telemetry
status: finished
owner: codex
topic_slug: railiance
created: "2026-08-11"
updated: "2026-09-06"
related:
  - ADR-0008
  - RMASTER-WP-0023
state_hub_workstream_id: "3acd587b-3ac6-5eee-af31-05170ff8bcf7"
---

# Bootstrap State Hub integration

## Goal

Finish State Hub onboarding for `railiance-telemetry`: confirm the
generated contract files, record that this repo has no runtime yet, and
seed the first *signal-contract* workplan. Do not deploy a monitoring
stack here. Placement is Quality / Q2 (INTENT/SCOPE). That is not an
open `railiance-master` question.

This id uses the historical `RTELE-WP-` prefix. New telemetry
workplans use `RTEL-WP-`. Do not change this file's `id` or hub UUID.

## Review Generated Integration Files

```task
id: RTELE-WP-0001-T01
status: done
priority: high
state_hub_task_id: "4aca4677-6712-553b-ac26-0682fdf211de"
```

Confirm INTENT/SCOPE/AGENTS match the seeded Q2 evidence-plane
boundary. Close leftover README contradictions (placement is Q2, not an
open S3-vs-Quality question). Set the *next* workplan prefix to
`RTEL-WP-`, not `RAILIANCE-WP-`.

## Verify Local Developer Workflow

```task
id: RTELE-WP-0001-T02
status: done
priority: high
state_hub_task_id: "b6632ce1-dc84-532d-b277-adce8510a304"
```

There is no implementation yet. Record that in AGENTS.md (no install /
test / run). Do not invent a Makefile that deploys monitoring. T03 owns
the first verification command.

## Seed First Real Workplan

```task
id: RTELE-WP-0001-T03
status: done
priority: medium
state_hub_task_id: "4877f6e2-8298-5bab-b6a8-9a1ec1718289"
```

Seed `RTEL-WP-0002` for the **emission contract**: what other layers
emit, retention for restore/rollout proof, and the operator-facing
health surface. Out of that plan: the deployable monitoring package
(future `rapp-*`), conformance *meaning* (owning repos /
`railiance-master`), and any public scrape/UI (forbidden until ADR-0006
`production-approved` plus an ADR-0008 grant; default `exposure` is
`private`).

After workplan file updates, run the sync locally from this repo
checkout:

```bash
statehub fix-consistency
```

Completed September 6: reviewed integration and Q2 boundary, corrected README,
documented the standard-library test workflow and seeded RTEL-WP-0002. Live
runtime/notification acceptance remains explicitly in RTEL-WP-0002-T04.