Struct State 

pub struct State {
    pub stage: Stage,
    pub phase: u32,
    pub agent: AgentKind,
    pub mode: Mode,
    pub gate_pending: bool,
    pub consecutive_failures: u32,
    pub started_at: String,
    pub project_root: PathBuf,
    pub worktree_path: Option<PathBuf>,
}

Full workflow state persisted to .devflow/state.json.

Fields

stage: Stage

Current workflow stage.

phase: u32

Phase number being worked on.

agent: AgentKind

Which coding agent was launched.

mode: Mode

How the pipeline is driven (auto vs. supervise).

gate_pending: bool

Whether a gate has been written and is awaiting a human response.

consecutive_failures: u32

Consecutive Validate failures — drives the Auto-mode forced gate after crate::mode::MAX_CONSECUTIVE_FAILURES failures. Persisted across devflow advance invocations so the counter survives monitor restarts.

started_at: String

When the phase started (Unix seconds).

project_root: PathBuf

Path to the project root.

worktree_path: Option<PathBuf>

Working directory for the agent when running in a git worktree.

None means the agent runs in project_root. State and capture files always live under the main project_root; only the agent’s cwd changes.

Implementations

impl State

pub fn new( phase: u32, agent: AgentKind, mode: Mode, project_root: PathBuf, ) -> Self

Create a new state for starting a phase at the Stage::Define stage.

Trait Implementations

impl Clone for State

fn clone(&self) -> State

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for State

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for State

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for State

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

where __S: Serializer,

Serialize this value into the given Serde serializer.