Struct FeatureState 

pub struct FeatureState {
    pub feature: FeatureInfo,
    pub status: FeatureStatus,
    pub current_phase: u32,
    pub git: GitInfo,
    pub phases: Vec<PhaseRecord>,
    pub pr: Option<PrInfo>,
    pub total: TotalStats,
}

Complete state of a feature’s execution, persisted to state.yml.

Tracks the progress of a feature through all execution phases, enabling crash recovery by resuming from the last completed phase.

Examples

use coda_core::state::{FeatureState, FeatureStatus};

let yaml = r#"
feature:
  slug: "add-auth"
  created_at: "2026-02-10T10:30:00Z"
  updated_at: "2026-02-10T10:30:00Z"
status: planned
current_phase: 0
git:
  worktree_path: ".trees/add-auth"
  branch: "feature/add-auth"
  base_branch: "main"
phases: []
total:
  turns: 0
  cost_usd: 0.0
  cost:
    input_tokens: 0
    output_tokens: 0
  duration_secs: 0
"#;

let state: FeatureState = serde_yaml::from_str(yaml).unwrap();
assert_eq!(state.status, FeatureStatus::Planned);
assert_eq!(state.feature.slug, "add-auth");

Fields

feature: FeatureInfo

Basic feature metadata.

status: FeatureStatus

Overall feature execution status.

current_phase: u32

Index of the current phase being executed (0-based).

git: GitInfo

Git branch and worktree information.

phases: Vec<PhaseRecord>

Records for each execution phase.

pr: Option<PrInfo>

Pull request information, populated after PR creation.

total: TotalStats

Cumulative statistics across all phases.

Implementations

impl FeatureState

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

Validates structural invariants after deserialization.

Checks that phases has at least [MIN_PHASE_COUNT] entries (1+ dev phases + review + verify), current_phase is within bounds, and worktree_path does not contain parent-directory references.

Errors

Returns a human-readable error description when validation fails.

Trait Implementations

impl Clone for FeatureState

fn clone(&self) -> FeatureState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FeatureState

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FeatureState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FeatureState

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

where __S: Serializer,

Serialize this value into the given Serde serializer.