---
Status: Approved
Owner Role: Orchestrator
Created: 2026-05-14
Approved: 2026-05-14
Consultant Review: cr-0631c4f4e009
---

# Admin Runtime Health Dashboard Requirements

## Goal

Add an admin-only, read-only `Admin -> Health` dashboard that exposes Blueprint
Runtime orchestration health. The dashboard must show Runtime workflow truth,
not generic server uptime, and must keep Runtime daemon/API as the canonical
authority.

## Background

Blueprint Runtime now owns orchestration state, validation profiles, leases,
dispatcher coordination, consultant checkpoints, and summary semantics. Admin
users need a dashboard that makes the current Runtime state visible in an
operational format inspired by Jenkins, GitLab, Argo CD, Kubernetes Dashboard,
and Grafana.

Consultant plan review `cr-0631c4f4e009` returned `revise` and recommended
keeping the five-chunk plan with explicit revisions:

- Make `runtime.healthSnapshot` explicit, versioned, read-only, bounded, and
  degraded-state aware.
- Do not use shell scorecard wrappers as the backend Health proof surface.
- Make Runtime daemon absence a first-class degraded/unavailable state.
- Redact or summarize unsafe raw Runtime details by default.
- Keep MVP refresh to page load/manual refresh.

## In Scope

- Runtime-owned health snapshot contract.
- Admin-guarded backend read-only proxy.
- Admin navigation entry and frontend data access.
- Read-only Health dashboard UI.
- Validation, docs, schema/codegen refresh, and safety checks.
- Admin Runtime Health dashboard documentation at
  `ai/standards/admin-runtime-health-dashboard.md`.

## Out Of Scope

- Mutation controls.
- Approval, retry, close, commit, lifecycle transition, dispatcher execution,
  or consultant response import controls.
- Polling, streaming, alerting, subscriptions, and long-term historical
  analytics.
- External monitoring integrations.
- Shell-wrapper canonical Health implementation.
- Product behavior outside the Admin Runtime Health dashboard.

## Acceptance Criteria

- Admin users can open `Admin -> Health`.
- Non-admin users cannot see or access the Health dashboard query.
- The Health page is read-only.
- Runtime owns workflow truth through a stable health snapshot contract.
- Backend proxies Runtime health read-only and handles Runtime daemon absence as
  degraded/unavailable rather than opaque failure.
- Frontend renders the snapshot and does not compute canonical workflow
  decisions.
- Healthy waiting states are visually distinct from blocked, stale, failed,
  degraded, and unavailable states.
- Consultant checkpoint status is advisory and cannot authorize execution.
- Raw/debug details are bounded and redacted by default.

## Data And API Notes

- Preferred Runtime surface: `runtime.healthSnapshot`.
- Backend should expose an admin-guarded GraphQL query backed by Runtime
  API/daemon state.
- GraphQL codegen must be refreshed after backend schema or frontend operation
  changes.
- The current `RemoteDevConsoleService.runtimeStatus()` shell scorecard pattern
  is a legacy trap and must not become the Health dashboard canonical proof
  surface.

## Test Expectations

- Runtime tests for the health snapshot contract, redaction, bounded reads, and
  degraded/unavailable fallback.
- Backend tests for admin guard, non-admin denial, redaction, and Runtime
  unavailable handling.
- Frontend tests for admin navigation, non-admin hiding, dashboard rendering,
  manual refresh, and absence of mutation controls.
- Codegen/build validation across backend and frontend.

## Risks And Assumptions

- Runtime daemon may be unavailable; the UI must still render a safe degraded
  snapshot.
- Raw Runtime details can include local paths or operational internals.
- Existing admin navigation uses a signal-driven view model rather than Angular
  Router routes.
- Angular Router cutover is tracked separately by
  `chunk-000138-frontend-angular-router-cutover`.
- The initial dashboard should remain dense and operational, not decorative.

## Open Questions

- None blocking for MVP after consultant review. Unredacted local-dev details,
  polling, streaming, and mutation controls remain future decisions.

## Recommended Chunks

- `chunk-000133-runtime-health-snapshot-contract`
- `chunk-000134-backend-admin-runtime-health-proxy`
- `chunk-000135-frontend-admin-health-route-data-access`
- `chunk-000136-admin-health-dashboard-ui`
- `chunk-000137-health-dashboard-validation-docs`
- `chunk-000138-frontend-angular-router-cutover`