Struct Supervisor 

pub struct Supervisor { /* private fields */ }

Process-local orchestrator for Runtime-owned managed services.

The supervisor never starts, stops, or replaces its host process.

Implementations

impl Supervisor

pub fn diagnose(&self) -> SupervisorDiagnosis

Returns a deterministic diagnostic report without mutating services.

pub fn snapshots(&self) -> Vec<ServiceSnapshot>

Returns current service snapshots in lexical order.

pub fn events(&self) -> Vec<SupervisorEvent>

Returns retained lifecycle events without removing them.

pub fn is_healthy(&self, timestamp_ms: u64) -> bool

Reports whether graph, watchdog, executor, and critical services are healthy.

impl Supervisor

pub fn reconcile(&self, timestamp_ms: u64) -> SupervisorResult<()>

Reconciles health and schedules restart work without executing it inline.

pub fn restart(&self, name: &str, timestamp_ms: u64) -> SupervisorResult<()>

Schedules one restart while enforcing its temporal budget.

pub fn stop(&self, name: &str, timestamp_ms: u64) -> SupervisorResult<()>

Stops one enabled service without affecting the host process.

pub fn evaluate_watchdog(&self, timestamp_ms: u64) -> WatchdogSnapshot

Independently evaluates watchdog progress and emits transition events.

pub fn shutdown(&self, timestamp_ms: u64) -> SupervisorResult<()>

Stops the restart executor and all enabled services in reverse order.

impl Supervisor

pub fn new() -> Self

Creates an empty supervisor with safe watchdog and executor defaults.

pub fn with_watchdog_config(config: WatchdogConfig) -> SupervisorResult<Self>

Creates an empty supervisor with installation watchdog policy.

pub fn with_event_capacity(event_capacity: usize) -> Self

Creates an empty supervisor with an explicit event bound.

pub fn same_instance(&self, other: &Self) -> bool

Reports whether two handles reference the same supervisor instance.

pub fn watchdog(&self) -> Arc<SupervisorWatchdog>

Returns the lock-independent watchdog shared with health consumers.

pub fn register(&self, service: Arc<dyn ManagedService>) -> SupervisorResult<()>

Registers one unique service without starting it.

pub fn register_or_replace_inactive( &self, service: Arc<dyn ManagedService>, ) -> SupervisorResult<()>

Registers a service or replaces an inactive deployment placeholder.

An enabled registration is never replaced because it may own resources.

pub fn validate(&self) -> SupervisorResult<Vec<String>>

Validates policies and returns dependency-first service order.

pub fn start_all(&self) -> SupervisorResult<()>

Starts all enabled services in dependency order.

pub fn start(&self, name: &str, timestamp_ms: u64) -> SupervisorResult<()>

Starts one enabled service after checking all dependencies.

Trait Implementations

impl Clone for Supervisor

fn clone(&self) -> Supervisor

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for Supervisor

fn default() -> Self

Returns the “default value” for a type.