product · internal

meridian

A read-first cockpit for a multi-session agent fleet — one screen that makes “what’s running, what landed, what’s blocked, what tripped a guard, how much budget’s left” glanceable across concurrent herdr sessions and the estate’s merge / deploy / guard activity. Internal fleet tool today; built product-shaped so the cerebral-work path isn’t a rewrite.

What it does

▸Session roster. Every concurrent herdr pane at a glance — pane, agent, status, cwd, repo, branch, behind, dirty, ticket, label. The anti-duplication payload: see who’s on what before you start a duplicate run.
▸Token tracking. Session and weekly quota headroom surfaced as a first-class view — session_pct, weekly_pct, reset_at — so budget is read, not squinted at from a statusline.
▸Tool-call traces. Per-tool-call OpDelta records already captured in blackwall’s custody store become a queryable stream; Langfuse covers the LLM-call dimension the tool-level traces miss. The board renders the trace, it does not own it.
▸Settle-state visibility. Every dispatch shows its run-hash, changeset, and pending → running → completed | failed | blocked-on-settle state. The board surfaces the settle URL and the changeset; the operator keeps the apply/discard authority.
▸Merge-train pulse. What landed, what’s gated, what’s in flight — across repos, on one row — so the 2026-07-19 “NP fixes re-prepared that the train had already landed” failure can’t repeat.
▸Guard events. Block / flock / override / near-miss enforcement events, pulled out of log burial into a legible column. The board watches the work, not the cluster.

Architecture

A local collector runs where the fleet runs (your workstation — it needs the local herdr api + git) and emits a versioned state snapshot. A thin PWA reader fetches the snapshot and renders the cockpit. The reader holds no credentials to the fleet — it reads a snapshot, it cannot act. The four seams below are how the board relates to the rest of the estate.

Component	Role in meridian	Boundary
`reverie mesh`	The session source. The collector reads the local herdr api (panes, agents, status) — the live pulse of concurrent OMP / Claude Code sessions the operator is running.	Read-only. The board never drives sessions; herdr does.
`Langfuse`	The LLM-call dimension the tool-level traces miss. Token spend, per-call cost, and model telemetry feed the budget headroom view the operator reads at a glance.	Observability sink — meridian renders what Langfuse recorded, it does not record.
`blackwall REST`	The custody spine. `POST /v1/projects/<tenant>/dispatch`, `GET /v1/jobs/:id`, and `GET /v1/projects/<tenant>/runs/:hash/changeset` are the surface the board reads settle-state and run-hashes from.	No settle authority. Workers dispatch + inspect; only the operator selects / applies / discards.
`dispatch queue`	The settle-state table — one row per in-flight run, its changeset, and its terminal state — rendered as the “what’s blocked, what landed, what’s waiting on you” column of the cockpit.	Stale state WARNS, never greenlights. The enforcement layer fails safe.

Status

internal Read-only cockpit, scoped 2026-07-20, scaffolded. Collector spine built (7d4673a); herdr.rs slice-1 landed via PR #2; git.rs + gh.rs pending. Not yet wired to live data; Local-only GitHub remote (operator-gated).

v1Read-only cockpit — sessions, merge train, guard events, swimlanes, budget. Ships fast, zero blast radius, earns the next investment. Reference UI at static/reference/design-pass-1.html (artifact 07e44c1d); the SvelteKit port is the first build task.
v2Claim registry — sessions claim {ticket, repo, files}; a PreToolUse hook warns on collision. Must fail safe (stale state warns, never greenlights).
v3Datalake-native + multi-tenant. The tenant seam activates; the cerebral-work product path opens. Board shares one event spine with the OPS-828 lake.

Deploy: in-cluster pwa-host on Cygnus, behind the estate Traefik edge. Access: cerebral.work SSO via app-sso (apex hostname operator-gated). Copyright © 2026 Christian M. Todie / cerebral.work — all rights reserved.