Struct SupervisorSpec 

pub struct SupervisorSpec {

    pub path: SupervisorPath,
    pub strategy: SupervisionStrategy,
    pub children: Vec<ChildSpec>,
    pub config_version: String,
    pub default_restart_policy: RestartPolicy,
    pub default_backoff_policy: BackoffPolicy,
    pub default_health_policy: HealthPolicy,
    pub tree_shutdown: TreeShutdownPolicy,
    pub supervisor_failure_limit: u32,
    pub restart_limit: Option<RestartLimit>,
    pub escalation_policy: Option<EscalationPolicy>,
    pub group_strategies: Vec<GroupStrategy>,
    pub group_configs: Vec<GroupConfig>,
    pub group_dependencies: Vec<GroupDependencyEdge>,
    pub severity_defaults: HashMap<TaskRole, SeverityClass>,
    pub child_strategy_overrides: Vec<ChildStrategyOverride>,
    pub dynamic_supervisor_policy: DynamicSupervisorPolicy,
    pub control_channel_capacity: usize,
    pub event_channel_capacity: usize,
    pub backpressure_config: BackpressureConfig,
    pub meltdown_policy: MeltdownPolicy,
    pub failure_window_config: FailureWindowConfig,
    pub restart_budget_config: RestartBudgetConfig,
    pub pipeline_journal_capacity: usize,
    pub pipeline_subscriber_capacity: usize,
    pub concurrent_restart_limit: u32,
    pub metrics_enabled: bool,
    pub audit_enabled: bool,
}

Declarative specification for one supervisor node.

Fields

path: SupervisorPath

Path for this supervisor.

strategy: SupervisionStrategy

Restart scope strategy for child exits.

children: Vec<ChildSpec>

Children in declaration order.

config_version: String

Configuration version that produced this declaration.

default_restart_policy: RestartPolicy

Restart policy inherited by children that do not override it.

default_backoff_policy: BackoffPolicy

Backoff policy inherited by children that do not override it.

default_health_policy: HealthPolicy

Health policy inherited by children that do not override it.

tree_shutdown: TreeShutdownPolicy

Tree shutdown policy for this supervisor and default child budgets.

supervisor_failure_limit: u32

Maximum supervisor failures before the supervisor-level escalation path is selected.

restart_limit: Option<RestartLimit>

Optional supervisor-level restart limit.

escalation_policy: Option<EscalationPolicy>

Optional fallback escalation policy for execution plans that do not define a child-level or group-level policy.

Root supervisors do not have a parent supervisor at runtime. When this field is set on a root supervisor, EscalateToParent should be treated as a configured policy label for planning and diagnostics, not as proof that a parent supervisor exists.

group_strategies: Vec<GroupStrategy>

Group-level strategy overrides.

group_configs: Vec<GroupConfig>

Group-level configurations for restart budget, membership, and isolation.

group_dependencies: Vec<GroupDependencyEdge>

Cross-group dependency edges for fault propagation.

severity_defaults: HashMap<TaskRole, SeverityClass>

Default severity class per task role for escalation bifurcation (US3).

child_strategy_overrides: Vec<ChildStrategyOverride>

Child-level strategy overrides.

dynamic_supervisor_policy: DynamicSupervisorPolicy

Runtime policy for dynamic child additions.

control_channel_capacity: usize

Control command channel capacity.

Runtime capacity for queued supervisor control commands. Recommended default: RECOMMENDED_CHANNEL_CAPACITY.

event_channel_capacity: usize

Event broadcast channel capacity.

Runtime capacity for supervisor event broadcast delivery. Recommended default: RECOMMENDED_CHANNEL_CAPACITY.

backpressure_config: BackpressureConfig

Backpressure policy used by observability event subscribers.

meltdown_policy: MeltdownPolicy

Failure fuse policy used by the supervision pipeline.

failure_window_config: FailureWindowConfig

Failure accumulation window used by the supervision pipeline.

restart_budget_config: RestartBudgetConfig

Restart budget used by the supervision pipeline.

pipeline_journal_capacity: usize

Event journal capacity used by the supervision pipeline.

pipeline_subscriber_capacity: usize

Subscriber queue capacity used by the supervision pipeline.

concurrent_restart_limit: u32

Maximum concurrent restarts allowed for this supervisor instance.

metrics_enabled: bool

Whether metrics recording is enabled.

audit_enabled: bool

Whether audit event recording is enabled.

Implementations

impl SupervisorSpec

pub fn root(children: Vec<ChildSpec>) -> Self

Creates a root supervisor specification.

Arguments

• children: Children declared under the root supervisor.

Returns

Returns a root SupervisorSpec with declaration-order children.

Examples

let spec = rust_supervisor::spec::supervisor::SupervisorSpec::root(Vec::new());
assert_eq!(spec.path.to_string(), "/");

pub fn propagate_tree_shutdown_budget(&mut self)

Copies the tree shutdown budget into every declared child.

Call this after changing Self::tree_shutdown when children should inherit the updated cooperative stop windows.

Arguments

This function has no arguments.

Returns

This function does not return a value.

pub fn shutdown_budget_for(&self, child_id: &ChildId) -> ShutdownBudget

Returns the shutdown budget for one declared child.

Arguments

• child_id: Stable child identifier.

Returns

Returns the child override when present, otherwise the tree default budget.

pub fn validate(&self) -> Result<(), SupervisorError>

Validates this supervisor and its direct children.

Arguments

This function has no arguments.

Returns

Returns Ok(()) when the supervisor declaration is usable.

Trait Implementations

impl Clone for SupervisorSpec

fn clone(&self) -> SupervisorSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SupervisorSpec

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.