Struct Plan 

pub struct Plan {
    pub id: Option<String>,
    pub slug: Option<String>,
    pub version: u32,
    pub steps: Vec<PlanStep>,
    pub goal: Option<String>,
    pub parent_plan_id: Option<String>,
    pub metadata: HashMap<String, Value>,
    pub created_at: u64,
    pub updated_at: u64,
}

Available on crate feature plan-execute only.

Execution plan

Fields

id: Option<String>

Plan unique ID (auto-generated)

slug: Option<String>

Human-readable slug (e.g., “swift-fox”)

version: u32

Version number (incremented on each replan)

steps: Vec<PlanStep>

List of steps in the plan

goal: Option<String>

Overall goal description of the plan

parent_plan_id: Option<String>

Parent plan ID (for incremental replanning tracking)

metadata: HashMap<String, Value>

Additional metadata

created_at: u64

Creation timestamp (seconds)

updated_at: u64

Last update timestamp (seconds)

Implementations

impl Plan

pub fn new(steps: Vec<PlanStep>) -> Plan

Create a new plan

pub fn with_goal(self, goal: impl Into<String>) -> Plan

Set the plan goal description

pub fn with_slug(self, slug: impl Into<String>) -> Plan

Set a human-readable slug

pub fn with_parent(self, parent_id: impl Into<String>) -> Plan

Set the parent plan ID (for incremental replanning)

pub fn with_metadata(self, key: impl Into<String>, value: Value) -> Plan

Add metadata

pub fn completed_count(&self) -> usize

Return the number of completed steps

pub fn is_completed(&self) -> bool

Check if the plan is fully completed

pub fn touch(&mut self)

Touch the update timestamp

pub fn validate(&self) -> Vec<PlanValidationIssue>

Validate the plan, returning all discovered issues

pub fn auto_fix(&mut self) -> Vec<String>

Auto-fix fixable issues

pub fn resolve_dependency_with_fuzzy(&self, dep: &str) -> (Option<usize>, bool)

Resolve a dependency string to a step index, returning whether fuzzy matching was used

pub fn resolve_dependency(&self, dep: &str) -> Option<usize>

Resolve a dependency string to a step index

pub fn downstream_steps(&self, step_idx: usize) -> Vec<usize>

Get all downstream steps of a given step (steps that depend on it)

pub fn downstream_steps_recursive(&self, step_idx: usize) -> Vec<usize>

Recursively get all downstream steps (including transitive dependencies)

Trait Implementations

impl Clone for Plan

fn clone(&self) -> Plan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Plan

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Plan

fn deserialize<__D>( __deserializer: __D, ) -> Result<Plan, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Plan

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.