Skip to main content

Module plan

Module plan 

Source
Expand description

Layered execution plan with cascading staleness reasons. Build plan — immutable DAG snapshot with staleness reasons.

Plan::compute traverses the action graph topologically (Kahn layers) and decides which actions are stale by comparing their current input hash against the last recorded BuildEvent in the cache. Stale-ness cascades: an action whose hash didn’t change but which depends on a stale ancestor is marked ChangeReason::UpstreamMoved.

The resulting Plan is owned, cloneable, and can be replayed any number of times by the orchestrator (with --dry-run, --explain, etc.).

Structs§

Plan
Immutable, topologically-layered execution plan.

Enums§

ChangeReason
Why a given action is considered stale and needs to re-run.
PlanError
Errors raised while computing a Plan.