coulomb/runbook-tutorials
5
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Sync consistency output
All checks were successful
CI Smoke / host-smoke (push) Successful in 1s
Details
CI Smoke / container-smoke (push) Successful in 2s
Details
Work Records / validate (push) Successful in 13s
Details

Browse source 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Assistant: claude-code
Assistant-Model: sonnet
Assistant-Process: 295952@bnt-lap001
Assistant-Session: e93f64ad-516c-46eb-9666-aad8d300c477
This commit is contained in:
tegwick 2026-09-29 00:25:09 +02:00
parent f4fe66f11c
commit cdbd61d4a2
7 changed files with 66 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

38
WORK-RECORDS.md Normal file
View file

@ -0,0 +1,38 @@
# Work Records — runbook-tutorials
> Generated by `statehub fix-consistency` (CUST-WP-0061-T04, work-record
> stage 3). Do not edit by hand — edit the source file/block listed for
> each record and re-run fix-consistency to refresh this index. Archived
> workplans are omitted; closed decisions/intakes/engagements stay listed
> so recently-resolved work is still visible. [auto]
| Kind | ID | Status | Lane | Source |
| --- | --- | --- | --- | --- |
| workplan | RBT-WP-0001 | finished | — | workplans/RBT-WP-0001-statehub-bootstrap.md |
| workplan | RBT-WP-0002 | active | — | workplans/RBT-WP-0002-runbook-pack-spec-and-validator.md |
| workplan | RBT-WP-0003 | ready | — | workplans/RBT-WP-0003-engine-core-run-state-and-evidence.md |
| workplan | RBT-WP-0004 | ready | — | workplans/RBT-WP-0004-local-runbook-ui.md |
| workplan | RBT-WP-0005 | active | — | workplans/RBT-WP-0005-legacy-adapter-and-console-migration.md |
| workplan | RBT-WP-0006 | backlog | — | workplans/RBT-WP-0006-execution-mode-and-pack-index.md |
| task | RBT-WP-0001-T01 | done | — | workplans/RBT-WP-0001-statehub-bootstrap.md |
| task | RBT-WP-0001-T02 | done | — | workplans/RBT-WP-0001-statehub-bootstrap.md |
| task | RBT-WP-0001-T03 | done | — | workplans/RBT-WP-0001-statehub-bootstrap.md |
| task | RBT-WP-0002-T01 | done | — | workplans/RBT-WP-0002-runbook-pack-spec-and-validator.md |
| task | RBT-WP-0002-T02 | done | — | workplans/RBT-WP-0002-runbook-pack-spec-and-validator.md |
| task | RBT-WP-0002-T03 | done | — | workplans/RBT-WP-0002-runbook-pack-spec-and-validator.md |
| task | RBT-WP-0002-T04 | todo | — | workplans/RBT-WP-0002-runbook-pack-spec-and-validator.md |
| task | RBT-WP-0003-T01 | todo | — | workplans/RBT-WP-0003-engine-core-run-state-and-evidence.md |
| task | RBT-WP-0003-T02 | todo | — | workplans/RBT-WP-0003-engine-core-run-state-and-evidence.md |
| task | RBT-WP-0003-T03 | todo | — | workplans/RBT-WP-0003-engine-core-run-state-and-evidence.md |
| task | RBT-WP-0003-T04 | todo | — | workplans/RBT-WP-0003-engine-core-run-state-and-evidence.md |
| task | RBT-WP-0004-T01 | todo | — | workplans/RBT-WP-0004-local-runbook-ui.md |
| task | RBT-WP-0004-T02 | todo | — | workplans/RBT-WP-0004-local-runbook-ui.md |
| task | RBT-WP-0004-T03 | todo | — | workplans/RBT-WP-0004-local-runbook-ui.md |
| task | RBT-WP-0004-T04 | todo | — | workplans/RBT-WP-0004-local-runbook-ui.md |
| task | RBT-WP-0005-T01 | done | — | workplans/RBT-WP-0005-legacy-adapter-and-console-migration.md |
| task | RBT-WP-0005-T02 | done | — | workplans/RBT-WP-0005-legacy-adapter-and-console-migration.md |
| task | RBT-WP-0005-T03 | todo | — | workplans/RBT-WP-0005-legacy-adapter-and-console-migration.md |
| task | RBT-WP-0005-T04 | todo | — | workplans/RBT-WP-0005-legacy-adapter-and-console-migration.md |
| task | RBT-WP-0005-T05 | todo | — | workplans/RBT-WP-0005-legacy-adapter-and-console-migration.md |
| task | RBT-WP-0006-T01 | wait | — | workplans/RBT-WP-0006-execution-mode-and-pack-index.md |
| task | RBT-WP-0006-T02 | wait | — | workplans/RBT-WP-0006-execution-mode-and-pack-index.md |

4
workplans/RBT-WP-0001-statehub-bootstrap.md
View file

@ -9,6 +9,7 @@ owner: codex
topic_slug: stack
created: "2026-09-29"
updated: "2026-09-29"
state_hub_workstream_id: "6e7852c6-04b2-5801-8c41-827ab3371954"
---
# Bootstrap State Hub integration
@ -21,6 +22,7 @@ Runbook-tutorial engine and UI that guides operators through parameterized IT ad
id: RBT-WP-0001-T01
status: done
priority: high
state_hub_task_id: "bab9969b-008d-569a-aea9-4bfabd5be7f0"
```
Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`.
@ -32,6 +34,7 @@ Replace generated placeholders with repo-specific facts where needed.
id: RBT-WP-0001-T02
status: done
priority: high
state_hub_task_id: "58661155-4185-530e-aa81-044ef1f16c34"
```
Identify the repo's install, test, lint, build, and run commands. Add or refine
@ -44,6 +47,7 @@ changes confidently.
id: RBT-WP-0001-T03
status: done
priority: medium
state_hub_task_id: "fafa64cc-968a-5a4b-bb08-264b51451ce7"
```
Create the first implementation workplan for the repository's most important

5
workplans/RBT-WP-0002-runbook-pack-spec-and-validator.md
View file

@ -10,6 +10,7 @@ owner: claude
topic_slug: stack
created: "2026-09-29"
updated: "2026-09-29"
state_hub_workstream_id: "f72323f4-4ef8-5bcd-9662-09df1c20290e"
---
## Goal
@ -24,6 +25,7 @@ between this repo and every pack owner.
id: RBT-WP-0002-T01
status: done
priority: high
state_hub_task_id: "f9e466d2-9fd1-502e-b2b8-e737068c12d2"
```
`docs/pack-spec.md` v0.1: manifest fields, parameters (never secret), steps with
@ -36,6 +38,7 @@ attended-procedure standard, and the legacy-command engine.
id: RBT-WP-0002-T02
status: done
priority: high
state_hub_task_id: "84c0496f-57c1-547a-b831-f4a20b75c0e9"
```
`schema/runbook-pack.schema.json` with conditional requirements per engine.
@ -46,6 +49,7 @@ priority: high
id: RBT-WP-0002-T03
status: done
priority: high
state_hub_task_id: "2760f95a-5016-5a2e-b25c-b8b67847061c"
```
`rtut/pack.py` and the CLI (`python -m rtut list|validate|show|render`), with
@ -59,6 +63,7 @@ unsafe characters.
id: RBT-WP-0002-T04
status: todo
priority: high
state_hub_task_id: "1e1bdfdd-2482-5280-a870-5d823dfa1d34"
```
Walk through the spec with Bernd against the real NetKingdom packs and the

5
workplans/RBT-WP-0003-engine-core-run-state-and-evidence.md
View file

@ -11,6 +11,7 @@ topic_slug: stack
created: "2026-09-29"
updated: "2026-09-29"
depends_on: [RBT-WP-0002]
state_hub_workstream_id: "b7f2568a-96a2-5e92-8d04-4e7ac7b6da9b"
---
## Goal
@ -25,6 +26,7 @@ exercise status.
id: RBT-WP-0003-T01
status: todo
priority: high
state_hub_task_id: "e61fbba9-d69f-59d4-ad86-c1fab69e8171"
```
Specify `runbook-run/v0.1`: pack id and revision, operator label, parameter
@ -38,6 +40,7 @@ rejection as packs. Stored under `.local/runbook-runs/` in the repo being operat
id: RBT-WP-0003-T02
status: todo
priority: high
state_hub_task_id: "fb10ebd1-d122-5b5f-9fd5-83d08539f8c1"
```
Create, resume and list runs. Enforce order, block a step until the previous
@ -50,6 +53,7 @@ resume.
id: RBT-WP-0003-T03
status: todo
priority: medium
state_hub_task_id: "870980df-c1e8-51e5-9a00-643f63404783"
```
`manual`, `exit-0` and `output-contains` checks. Commands are shown to the
@ -62,6 +66,7 @@ it, with a timeout and captured output size only (no output stored).
id: RBT-WP-0003-T04
status: todo
priority: medium
state_hub_task_id: "bad99b81-2b64-520f-b92f-1b8c6457659b"
```
When every step of a run has verified, offer to write

5
workplans/RBT-WP-0004-local-runbook-ui.md
View file

@ -11,6 +11,7 @@ topic_slug: stack
created: "2026-09-29"
updated: "2026-09-29"
depends_on: [RBT-WP-0003]
state_hub_workstream_id: "bbd03473-fcf7-5b20-a295-e9ff45fb7ecc"
---
## Goal
@ -25,6 +26,7 @@ what you have proven.
id: RBT-WP-0004-T01
status: todo
priority: high
state_hub_task_id: "8309d778-3688-5cb3-bb34-18f87b66dbf3"
```
Run `make security-bootstrap-ui` in `net-kingdom` with Bernd and record what to keep
@ -37,6 +39,7 @@ approval phrase) and what to change. Output: a short UX note in `docs/`.
id: RBT-WP-0004-T02
status: todo
priority: high
state_hub_task_id: "e15c22b6-60eb-5a54-9d22-b268897fcf4d"
```
Parameter form, ordered steps with owner tags, rendered copyable commands,
@ -50,6 +53,7 @@ posture, works without JavaScript frameworks.
id: RBT-WP-0004-T03
status: todo
priority: medium
state_hub_task_id: "a33cbd52-8759-583f-a2f0-8ab926569346"
```
`rtut run <pack>` walking the same run record in the terminal, for hosts
@ -61,6 +65,7 @@ without a browser.
id: RBT-WP-0004-T04
status: todo
priority: medium
state_hub_task_id: "616255c2-091c-5948-8160-abd9dc69907f"
```
Show the run record, export it as non-secret JSON, and produce the exercise-status

6
workplans/RBT-WP-0005-legacy-adapter-and-console-migration.md
View file

@ -11,6 +11,7 @@ topic_slug: stack
created: "2026-09-29"
updated: "2026-09-29"
depends_on: [RBT-WP-0002]
state_hub_workstream_id: "253d0512-46e2-51b2-8e26-12da2c1534ca"
---
## Goal
@ -25,6 +26,7 @@ moving its generic parts into the engine.
id: RBT-WP-0005-T01
status: done
priority: high
state_hub_task_id: "0e459512-a5b4-539e-9603-79a2cfa4f27e"
```
`net-kingdom/runbooks/security-bootstrap-console/pack.yaml`
@ -37,6 +39,7 @@ priority: high
id: RBT-WP-0005-T02
status: done
priority: high
state_hub_task_id: "8ff275f5-c70f-5a12-a69e-44f8922a32f0"
```
`rtut launch <pack>` runs `legacy.command` from the owning repo root, waits for
@ -49,6 +52,7 @@ with a stub server.
id: RBT-WP-0005-T03
status: todo
priority: high
state_hub_task_id: "dbb5553d-fb0c-5298-85c8-cebc9dd63312"
```
Classify the 5,300-line `security_bootstrap_console.py` into generic engine
@ -63,6 +67,7 @@ the tests that pin current behaviour.
id: RBT-WP-0005-T04
status: todo
priority: medium
state_hub_task_id: "14261c00-65d0-55be-8ab2-bd81e579e20d"
```
Move the generic parts into `rtut` behind the run record. The console in
@ -76,6 +81,7 @@ Move the generic parts into `rtut` behind the run record. The console in
id: RBT-WP-0005-T05
status: todo
priority: low
state_hub_task_id: "c54cfa35-1a34-5d5a-b85b-86ae8771dcfb"
```
With Bernd: keep the console as a permanent legacy pack, migrate its runbooks

3
workplans/RBT-WP-0006-execution-mode-and-pack-index.md
View file

@ -11,6 +11,7 @@ topic_slug: stack
created: "2026-09-29"
updated: "2026-09-29"
depends_on: [RBT-WP-0004]
state_hub_workstream_id: "35196f02-7cb9-5706-9529-1cba9c736058"
---
## Goal
@ -24,6 +25,7 @@ discovery of packs across the estate.
id: RBT-WP-0006-T01
status: wait
priority: low
state_hub_task_id: "0424deab-3b51-5222-80b1-54c0ea26928d"
```
Per-step `execute: true` allowed only for `read-only` steps first, with an
@ -36,6 +38,7 @@ decision on which identity runs the command.
id: RBT-WP-0006-T02
status: wait
priority: low
state_hub_task_id: "0cfb69bc-dc7e-5960-8359-64c49a742a6e"
```
`rtut list --estate` scans registered repos for `runbooks/*/pack.yaml` and publishes