Struct ParsedTask 

pub struct ParsedTask {

    pub title: String,
    pub status: TaskStatus,
    pub created_at: DateTimeValue,
    pub updated_at: DateTimeValue,
    pub completed_at: Option<DateTimeValue>,
    pub due: Option<DateTimeValue>,
    pub scheduled: Option<NaiveDate>,
    pub defer_until: Option<NaiveDate>,
    pub project: Option<FileReference>,
    pub area: Option<FileReference>,
    pub body: String,
    pub extra: HashMap<String, Value>,
    pub projects_count: Option<usize>,
}

Parsed task content without a file path.

Use this when parsing from a string rather than reading from disk.

Fields

title: String

The task title.

status: TaskStatus

Current status of the task.

created_at: DateTimeValue

When the task was created.

updated_at: DateTimeValue

When the task was last updated.

completed_at: Option<DateTimeValue>

When the task was completed.

due: Option<DateTimeValue>

When the task is due.

scheduled: Option<NaiveDate>

Date the task is scheduled to be worked on.

defer_until: Option<NaiveDate>

Date until which the task is deferred.

project: Option<FileReference>

Reference to the project this task belongs to.

area: Option<FileReference>

Reference to the area this task belongs to.

body: String

Markdown body.

extra: HashMap<String, Value>

Unknown frontmatter fields.

projects_count: Option<usize>

Number of elements in the projects array (if used).

Implementations

impl ParsedTask

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

Parse task content from a string.

This extracts frontmatter using gray_matter and parses known fields. Unknown fields are preserved in the extra map.

Errors

Returns Error::ContentParse if the content cannot be parsed. Returns Error::ContentMissingField if required fields are absent. Returns Error::ContentInvalidField if a field has an invalid value.

impl ParsedTask

pub fn with_path(self, path: impl Into<PathBuf>) -> Task

Convert to a Task by associating with a file path.

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

Validate the parsed task against spec recommendations.

Returns a list of warnings for spec violations. An empty list means the task fully complies with the specification.

Checks performed:

• projects array should have exactly one element (warns if >1)
• Completed tasks (done/dropped) should have completed-at set

Trait Implementations

impl Clone for ParsedTask

fn clone(&self) -> ParsedTask

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParsedTask

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

Formats the value using the given formatter.

impl Display for ParsedTask

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

Serialize to file content (frontmatter + body).

The output is a valid markdown file with YAML frontmatter. Field order is consistent and deterministic. Unknown fields from extra are preserved. The projects_count field is NOT serialized (validation metadata only).

impl PartialEq for ParsedTask

fn eq(&self, other: &ParsedTask) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ParsedTask