URUZ VM

Docs
Gateway

Architecture, runtime operation, integration surfaces, and operator references organized for engineers who need signal fast.

ARCHITECTURE
OPERATIONS
INTEGRATION
OBSERVABILITY

DOCUMENTATION PATHS

Organized around actual work.

Architecture

Principles, execution boundaries, canonical mapping discipline, and why the coordinator remains the orchestration owner.

Runtime Operations

Bring-up, health, loop health, progression metrics, and what 'runtime ready' actually means in local/devnet.

Integration Surfaces

Execution, settlement, release service, and the contracts expected from upstream backends and future URUZ devnet data.

Observability

Flow inspection, mismatch visibility, reconciliation semantics, and why phase views stay derived rather than authoritative.

START HERE

Different roles, different entry points.

Protocol Engineers

  • Architecture Principles
  • Current Capabilities
  • Roadmap

Infra Operators

  • Runbook
  • Health and Loop Surfaces
  • Progression Metrics

Technical Collaborators

  • Integration Contract
  • Technical Collaboration
  • Dashboard Surface

RUNTIME SURFACES

Inspection first, not guesswork.

URUZ VM already exposes the operational surfaces needed to understand health, loop behavior, canonical flow truth, and reconciliation drift separately.

/health

Process-level health only. Useful, but not sufficient to claim runtime readiness.

/health/loops

Loop state, backoff visibility, and runtime lifecycle for settlement, execution, and release observation.

/metrics/progression

Progression counters for pending and confirmed stages, plus reconciliation warning and mismatch counts.

/bridge/flows

Canonical flow list with current state, retry count, errors, and derived phase view.

/bridge/phases/{message_id}

Execution phase, release phase, and recovery metadata without creating a second source of truth.

/bridge/mismatches

Warnings and mismatches from reconciliation so operators can spot drift before guessing.

Technical users should not have to guess.

The runtime, the docs, and the inspection surfaces should agree on what the system is doing and where to look next.