ops-hub/.claude/rules/architecture.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.2 KiB

Architecture

ops-hub is a Python tooling repo that extends Inter-Hub with VSM Operations (System 1) vocabulary, bootstrap clients, and gate probes. Inter-Hub remains the generic hub substrate; this repo owns domain-specific seeds, scripts, and library code.

Components

Path Role
src/ops_hub/interhub_gate_probe.py Public gate probe for bootstrap API surface
src/ops_hub/bootstrap.py Authenticated bootstrap client (plan, dry-run, execute)
scripts/interhub-gate-probe.py CLI wrapper for gate probe
scripts/ops-hub-bootstrap-api.py CLI wrapper for bootstrap
seeds/ Manifest, widget, and SQL bootstrap artifacts
docs/ Runbook, readiness gates, inventory handoff
workplans/ ADR-001 work source of truth

External integrations

  • Inter-Hub (https://hub.coulomb.social) — hub rows, manifests, widgets, events
  • State Hub — workplan/task cache rebuilt from workplan files
  • OpenBao — operator and runtime API key custody (warden access --exec)
  • ops-warden — SSH cert issuance and credential routing only

Quick Reference

~/state-hub/mcp_server/TOOLS.md — MCP tool reference