Struct Task 

pub struct Task {

    pub id: TaskId,
    pub run_id: RunId,
    pub task_key: String,
    pub description: String,
    pub state: TaskState,
    pub command_class: CommandClass,
    pub depends_on: Vec<TaskId>,
    pub evidence_ids: Vec<Uuid>,
    pub attempt_no: u32,
    pub max_attempts: u32,
    pub blocker: Option<BlockerCode>,
    pub last_error: Option<String>,
    pub blocker_detail: Option<String>,
    pub correlation_id: CorrelationId,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub priority: u32,
}

A task within a run.

Fields

id: TaskId

Unique task identifier (UUIDv7 for time-ordering).

run_id: RunId

The run this task belongs to.

task_key: String

Human-readable key for deduplication (unique per run).

description: String

Description of what this task should accomplish.

state: TaskState

Current FSM state.

command_class: CommandClass

Command class for concurrency caps.

depends_on: Vec<TaskId>

Tasks this task depends on (must be TaskComplete before this can run).

evidence_ids: Vec<Uuid>

Evidence IDs attached to this task.

attempt_no: u32

Current attempt number (starts at 1, incremented on retry).

max_attempts: u32

Maximum allowed attempts before permanent failure.

blocker: Option<BlockerCode>

Blocker code when in TaskBlocked state.

last_error: Option<String>

Root-cause error message preserved across state changes. Set on first failure; not overwritten by subsequent kills or timeouts.

blocker_detail: Option<String>

Free-form annotation for blocker context (e.g. “see blocker-001.md”). Set by external agents or the task annotate CLI command.

correlation_id: CorrelationId

Correlation ID (inherited from parent run).

created_at: DateTime<Utc>

When the task was created.

updated_at: DateTime<Utc>

When the task last changed state.

priority: u32

Priority for queue ordering (0-100, higher is more urgent).

Implementations

impl Task

pub fn new( run_id: RunId, task_key: impl Into<String>, description: impl Into<String>, command_class: CommandClass, correlation_id: CorrelationId, ) -> Self

Create a new task in TaskOpen state.

pub fn depends_on(&mut self, task_id: TaskId)

Add a dependency on another task.

pub fn with_priority(self, priority: u32) -> Self

Set the task priority (0-100, higher is more urgent).

pub fn with_max_attempts(self, max: u32) -> Self

Set the maximum number of attempts.

pub fn set_last_error(&mut self, error: impl Into<String>)

Set the root-cause error message. Only sets if not already populated, preserving the original failure reason across subsequent state changes.

pub fn set_blocker_detail(&mut self, detail: impl Into<String>)

Set the blocker detail annotation.

pub fn clear_blocker_detail(&mut self)

Clear the blocker detail annotation.

pub fn attach_evidence(&mut self, evidence_id: Uuid)

Attach evidence to this task.

pub fn transition( &mut self, to: TaskState, reason: impl Into<String>, actor: impl Into<String>, causation_id: Option<EventId>, ) -> Result<Transition, TransitionError>

Attempt a state transition. Returns a Transition event on success.

Enforces Section 7.2 rules:

• Terminal states are immutable.
• Only valid transitions are allowed.
• TaskBlocked requires a blocker code.
• Retry from TaskFailed to TaskReady increments attempt_no.

pub fn block( &mut self, blocker: BlockerCode, reason: impl Into<String>, actor: impl Into<String>, causation_id: Option<EventId>, ) -> Result<Transition, TransitionError>

Transition to TaskBlocked with a mandatory blocker code.

pub fn dependencies_satisfied<F>(&self, is_complete: F) -> bool

where F: Fn(&TaskId) -> bool,

Check if all dependencies are satisfied given a predicate.

Trait Implementations

impl Clone for Task

fn clone(&self) -> Task

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Task

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Task

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Task

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

where __S: Serializer,

Serialize this value into the given Serde serializer.