06 — Nervous System

Performance

Health · Status · Incidents · Boot Readiness

Performance is the nervous system of Auroch. Every pillar watched. Every incident recorded. Every health state known. The command center that knows what is alive, broken, stale, or recovering.

Service Registry Health contract →

Service Registry

The organism, mapped.

A single canonical registry of every Auroch service across Winnie, AVN, Prospect, Prometheion, Ledger, Performance, and shared infrastructure.

auroch.registry.json

winnie.api

FastAPI kernel — health endpoint, command surface.

winnie.desktop

Tauri desktop shell with hotkey + tray.

avn.api

Intelligence desk endpoints — sources, lenses, briefings.

avn.workers

Wire ingestion and interpretation workers.

prospect.api

Run dispatch, prospect / signal / evidence inspection.

prospect.broker

Entitlement, export, audit subsystem.

prometheion.api

Forge endpoints — generate, refine, export, lineage.

prometheion.storage

Local artifact storage with integrity diagnostics.

ledger.api

Cross-system events endpoint, event spine reader.

performance.api

Fastify on port 3001 — health samples, status, registry.

performance.worker

Status checker polling every 15 seconds.

infrastructure

Postgres, dashboard, Docker Compose, shared services.

Health Contract

A shared shape for being alive.

CONTRACT 01

Health Endpoint

Every service exposes a normalized health endpoint with state, latency, version.

CONTRACT 02

Status Enum

nominal · degraded · offline · unknown — universal vocabulary across pillars.

CONTRACT 03

Dependency Graph

Each service declares what it depends on — cascading status propagation.

CONTRACT 04

Latest Sample

Most recent health sample per pillar — written by the status worker.

CONTRACT 05

Deduplicated Events

Repeated state transitions are collapsed — only meaningful changes are recorded.

CONTRACT 06

Recovery Steps

Each registered service includes the runbook fragment for recovery.

Boot Readiness

When Auroch wakes.

scripts/auroch-launch.sh

Ignition. Parses auroch.services.json, starts services, writes PIDs, logs, boot report.

Launch

scripts/auroch-status.sh

Live status across all registered pillars.

Status

scripts/auroch-stop.sh

Graceful shutdown across the organism.

Lifecycle

scripts/auroch-restart.sh

Restart a pillar or the whole system.

Lifecycle

scripts/auroch-tail.sh

Stream logs across the boot manifest.

Diagnostics

.auroch/state/boot-report.md

Human-readable boot report — degraded services, recovery steps, missing prerequisites.

Report

Performance

The organism, mapped.

A shared shape for being alive.

When Auroch wakes.

Performance watches everything.