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

1.6 KiB

repo updated
ops-hub 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.