Skip to main content

Module engine

Module engine 

Source
Expand description

The lifecycle engine (ARCHITECTURE.md §2, §8).

Re-exports§

pub use error::EngineError;
pub use plan::Step;
pub use plan::StepKind;
pub use progress::NullProgress;
pub use progress::ProgressSink;
pub use progress::StepProgress;
pub use progress::StepProgressEvent;
pub use run::DownOutcome;
pub use run::Engine;
pub use run::StepTiming;
pub use run::UpOutcome;
pub use run::UpRequest;

Modules§

error
Engine errors. Substrate failures pass their own stable code through; the engine adds the step and instance context the §2 contract requires.
plan
Step planning: one validated definition + the derived graph → the ordered steps every substrate executes (§3/§4 share the sequence: provision integrations → prepare → start services → health gate).
progress
Step progress events during up — substrate-agnostic telemetry for agents and human operators.
run
The lifecycle engine (§2): plan steps, checkpoint before proceeding, reconcile recorded state against observation. Shared by up, resume, daemon adoption, and the reaper — they are the same machinery.