## 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** — workstream/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