railiance-telemetry/workplans/RTELE-WP-0001-statehub-bootstrap.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

84 lines
2.4 KiB
Markdown

---
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.