the-custodian/state-hub/dashboard/src/reference.md

title

title
Reference

import {withDocHelp} from "./components/doc-overlay.js";

const _h1 = document.querySelector("#observablehq-main h1");
if (_h1) { _h1.style.position = "relative"; withDocHelp(_h1, "/docs/reference"); }

Reference

In-depth documentation for each dashboard page, data model, and design convention used in the Custodian State Hub.

---

Dashboard pages

Page	What it covers
Connecting to the Hub	Local and remote connection setup, ops-bridge tunnels, MCP transports
Contributions	Contribution types, lifecycle, third-party todo workflow
Decision Health	KPI formula, avg resolve time, open-age colour thresholds
Decisions	Decision types, statuses, escalation rules, filter bar
Dependencies	Dependency edges, registration, cycle detection
Domains	Domain model, statuses, cards with repos
Extension Points	EP types, statuses, priorities, registration
Inter-Repo Communication	Boundary rule, Internal/Ecosystem/Third-party taxonomy, routing workflows
Live Data	Poll interval, live indicator states, offline recovery
Overview	State summary sections, workstream chart, blocking decisions, next steps
Progress Log	Event types, append-only policy, session protocol
Repos	Repo registry, SBOM coverage map, ingestion commands
SBOM	Lockfile ingestion, licence report, copyleft detection
Tasks	Task statuses, priorities, filter bar, status distribution chart
Technical Debt	Debt types, severities, statuses, registration
Todo	Internal/Ecosystem/Third-party classification, data sources
Workstream Health	WHI formula, six base metrics, per-domain breakdown
Workstreams	Workstream statuses, dependency edges, WHI KPI card

---

Meta

Topic	What it covers
Ralph Workplan	/ralph-workplan skill — installation, usage, workplan format, COULOMBCORE setup
Reference & Context Help	How reference pages work; the ? context-help button