coulomb/railiance-telemetry
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

chore: treat hub bootstrap as proposed and adopt RTEL-WP- prefix

Browse source 
Do not deploy a monitoring stack here. Next real workplan is the
emission contract, private by default.
This commit is contained in:
tegwick 2026-08-15 20:52:04 +02:00
parent 53165d2a50
commit 9e6a88e21e
2 changed files with 37 additions and 16 deletions
Download patch file Download diff file Expand all files Collapse all files

12
AGENTS.md
View file

@ -7,7 +7,7 @@
**Domain:** financials **Domain:** financials
**Repo slug:** railiance-telemetry **Repo slug:** railiance-telemetry
**Topic ID:** `ca369340-a64e-442e-98f1-a4fa7dc74a38` **Topic ID:** `ca369340-a64e-442e-98f1-a4fa7dc74a38`
**Workplan prefix:** `RAILIANCE-WP-` **Workplan prefix:** `RTEL-WP-`
--- ---
@ -134,10 +134,10 @@ curl -s -X PATCH "http://127.0.0.1:8000/tasks/<task_id>" \
Work items originate as files in this repo — not in the hub. The hub is a Work items originate as files in this repo — not in the hub. The hub is a
read/cache/index layer that rebuilds from files. read/cache/index layer that rebuilds from files.
**File location:** `workplans/RAILIANCE-WP-NNNN-<slug>.md` **File location:** `workplans/RTEL-WP-NNNN-<slug>.md`
**Archived location:** finished workplans may move to **Archived location:** finished workplans may move to
`workplans/archived/YYMMDD-RAILIANCE-WP-NNNN-<slug>.md`. The `YYMMDD` prefix is `workplans/archived/YYMMDD-RTEL-WP-NNNN-<slug>.md`. The `YYMMDD` prefix is
the completion/archive date; the frontmatter `id` does not change. the completion/archive date; the frontmatter `id` does not change.
**Ad Hoc Tasks:** small opportunistic fixes discovered during a session use **Ad Hoc Tasks:** small opportunistic fixes discovered during a session use
@ -149,7 +149,7 @@ anything needing analysis, design, approval, dependencies, or multiple phases.
```yaml ```yaml
--- ---
id: RAILIANCE-WP-NNNN id: RTEL-WP-NNNN
type: workplan type: workplan
title: "..." title: "..."
domain: financials domain: financials
@ -177,7 +177,7 @@ API/MCP/frontmatter bridges until `STATE-WP-0069` retires them — see
## Task Title ## Task Title
` ` `task ` ` `task
id: RAILIANCE-WP-NNNN-T01 id: RTEL-WP-NNNN-T01
status: wait | todo | progress | done | cancel status: wait | todo | progress | done | cancel
priority: high | medium | low priority: high | medium | low
state_hub_task_id: "<uuid>" # written by fix-consistency — do not edit state_hub_task_id: "<uuid>" # written by fix-consistency — do not edit
@ -190,7 +190,7 @@ Status progression: `todo` → `progress` → `done`; use `wait` for waiting/blo
**Residuals when finishing:** actionable leftovers become live work records **Residuals when finishing:** actionable leftovers become live work records
before `status: finished` — usually an intake (`origin: residual`, before `status: finished` — usually an intake (`origin: residual`,
`origin_ref: RAILIANCE-WP-NNNN`) or a spawned workplan. Residual is a *role*, `origin_ref: RTEL-WP-NNNN`) or a spawned workplan. Residual is a *role*,
not a kind. Fleet list lives on State Hub, not in `SCOPE.md`. not a kind. Fleet list lives on State Hub, not in `SCOPE.md`.
To create a new workplan: To create a new workplan:

41
workplans/RAILIANCE-WP-0001-statehub-bootstrap.md
View file

@ -4,17 +4,29 @@ type: workplan
title: "Bootstrap State Hub integration" title: "Bootstrap State Hub integration"
domain: financials domain: financials
repo: railiance-telemetry repo: railiance-telemetry
status: ready status: proposed
owner: codex owner: codex
topic_slug: railiance topic_slug: railiance
created: "2026-08-11" created: "2026-08-11"
updated: "2026-08-11" updated: "2026-08-15"
related:
- ADR-0008
- RMASTER-WP-0023
state_hub_workstream_id: "60f5fe7c-9749-40be-9945-6ad608398b3f" state_hub_workstream_id: "60f5fe7c-9749-40be-9945-6ad608398b3f"
--- ---
# Bootstrap State Hub integration # Bootstrap State Hub integration
Observability for Railiance — monitoring, metrics, logs, traces, and alerting that turn running behaviour into evidence and give the self-organizing control loop a signal to close on. ## 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 `RAILIANCE-WP-` prefix. New telemetry
workplans use `RTEL-WP-`. Do not change this file's `id` or hub UUID.
## Review Generated Integration Files ## Review Generated Integration Files
@ -25,8 +37,10 @@ priority: high
state_hub_task_id: "de712c57-79fa-49be-97a2-873e9e1a8bec" state_hub_task_id: "de712c57-79fa-49be-97a2-873e9e1a8bec"
``` ```
Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`. Confirm INTENT/SCOPE/AGENTS match the seeded Q2 evidence-plane
Replace generated placeholders with repo-specific facts where needed. 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 ## Verify Local Developer Workflow
@ -37,9 +51,9 @@ priority: high
state_hub_task_id: "79febfbb-6a67-40e0-9c24-96ff83ab706e" state_hub_task_id: "79febfbb-6a67-40e0-9c24-96ff83ab706e"
``` ```
Identify the repo's install, test, lint, build, and run commands. Add or refine There is no implementation yet. Record that in AGENTS.md (no install /
those commands in the agent instructions so future coding sessions can verify test / run). Do not invent a Makefile that deploys monitoring. T03 owns
changes confidently. the first verification command.
## Seed First Real Workplan ## Seed First Real Workplan
@ -50,8 +64,15 @@ priority: medium
state_hub_task_id: "adea3657-c074-443b-9c5e-3c2095dd7c5b" state_hub_task_id: "adea3657-c074-443b-9c5e-3c2095dd7c5b"
``` ```
Create the first implementation workplan for the repository's most important Seed `RTEL-WP-0002` for the **emission contract**: what other layers
next change. After workplan file updates, run the sync locally from this repo 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: checkout:
```bash ```bash