ops-hub/INTENT.md
tegwick 552e705ea7
All checks were successful
CI Smoke / host-smoke (push) Successful in 1s
CI Smoke / container-smoke (push) Successful in 11s
docs: workplan-first agent guidance prose (CUST-WP-0055 T04 batch 3)
2026-07-08 17:15:26 +02:00

40 lines
1.6 KiB
Markdown

---
repo: ops-hub
updated: "2026-06-06"
---
# INTENT
## Why it exists
`ops-hub` is the Operations / System 1 extension for the interaction framework.
It turns operational reality into governed, queryable, and evidence-backed hub
records: environments, hosts, clusters, services, endpoints, releases, backups,
incidents, risks, runbooks, readiness gates, and migration waves.
It exists because Railiance and HelixForge operations need a durable
operational truth surface while the fleet transitions toward railiance01
production. State Hub continues to own workplans and decisions; **Core Hub**
owns the production framework API (`hub.coulomb.social` since 2026-07-03).
Historical Haskell Inter-Hub lives in `inter-hub-haskell` (retired). `ops-hub`
owns the operations extension behavior and posts evidence to Core Hub.
## Governing principle
This repository should stay focused on the purpose above. Work that changes its
authority, ownership boundaries, or operational promises should be captured in a
workplan before implementation.
The first implementation rule is: domain-specific runtime code belongs here,
while generic hub framework behavior belongs in Core Hub.
## What it enables
- Operators can see what runs where, how it is reached, and what evidence proves
it is healthy.
- Collectors, adapters, and scheduled probes can report operational facts into
Inter-Hub using the ops vocabulary.
- Readiness and migration gates can be represented as explicit, auditable
operational records.
- Future VSM hubs can reuse the extension pattern without turning Inter-Hub
itself into a domain-specific operations product.