Struct Spec 

pub struct Spec {
    pub id: String,
    pub frontmatter: SpecFrontmatter,
    pub title: Option<String>,
    pub body: String,
}

Fields

id: String

frontmatter: SpecFrontmatter

title: Option<String>

body: String

Implementations

impl Spec

pub fn parse(id: &str, content: &str) -> Result<Self>

Parse a spec from file content.

pub fn load(path: &Path) -> Result<Self>

Load a spec from a file path.

pub fn load_frontmatter_only(path: &Path) -> Result<Self>

Load only the frontmatter from a spec file, without parsing the body. This is more efficient for operations that only need metadata (status, dependencies, etc.) and don’t need the full spec body content.

pub fn load_with_branch_resolution(spec_path: &Path) -> Result<Self>

Load a spec, optionally resolving from its working branch.

If the spec is in_progress and has a branch (frontmatter.branch or chant/{id}), attempt to read the spec content from that branch for live progress.

pub fn save(&self, path: &Path) -> Result<()>

Save the spec to a file.

pub fn count_unchecked_checkboxes(&self) -> usize

Count unchecked checkboxes (- [ ]) in the Acceptance Criteria section only. Returns the count of unchecked items in that section, skipping code fences. Uses the LAST ## Acceptance Criteria heading outside code fences.

pub fn count_total_checkboxes(&self) -> usize

Count total checkboxes (both checked and unchecked) in the Acceptance Criteria section. Used to assess spec complexity.

pub fn add_derived_fields(&mut self, fields: HashMap<String, String>)

Add derived fields to the spec’s frontmatter. Updates the frontmatter with the provided derived fields.

pub fn auto_check_acceptance_criteria(&mut self) -> bool

Auto-check all acceptance criteria checkboxes in the spec body. Replaces all - [ ] with - [x] in the Acceptance Criteria section. Returns true if any checkboxes were checked, false otherwise.

pub fn has_acceptance_criteria(&self) -> bool

Check if this spec has acceptance criteria. Returns true if the spec body contains an “## Acceptance Criteria” section with at least one checkbox item.

pub fn is_blocked(&self, all_specs: &[Spec]) -> bool

Check if this spec has unmet dependencies or approval requirements that would block it.

pub fn is_ready(&self, all_specs: &[Spec]) -> bool

Check if this spec is ready to execute.

pub fn get_blocking_dependencies( &self, all_specs: &[Spec], _specs_dir: &Path, ) -> Vec<BlockingDependency>

Get the list of dependencies that are blocking this spec.

pub fn has_frontmatter_field(&self, field: &str) -> bool

Check if the spec’s frontmatter contains a specific field.

pub fn requires_approval(&self) -> bool

Check if this spec requires approval before work can begin.

pub fn is_approved(&self) -> bool

Check if this spec has been approved.

pub fn is_rejected(&self) -> bool

Check if this spec has been rejected.

Trait Implementations

impl Clone for Spec

fn clone(&self) -> Spec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Spec

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

Formats the value using the given formatter.