Struct Task 

pub struct Task {
    pub id: String,
    pub title: String,
    pub description: Option<String>,
    pub key: Option<String>,
    pub status: TaskStatus,
    pub priority: u8,
    pub blocked_by: Vec<String>,
    pub loop_id: Option<String>,
    pub created: String,
    pub started: Option<String>,
    pub closed: Option<String>,
}

A task in the task tracking system.

Fields

id: String

Unique ID: task-{unix_timestamp}-{4_hex_chars}

title: String

Short description

description: Option<String>

Optional detailed description

key: Option<String>

Stable key for idempotent orchestrator-managed tasks.

status: TaskStatus

Current state

priority: u8

Priority 1-5 (1 = highest)

blocked_by: Vec<String>

Tasks that must complete before this one

loop_id: Option<String>

Loop ID that created this task (from RALPH_LOOP_ID env var). Used to filter tasks by ownership when multiple loops share a task list.

created: String

Creation timestamp (ISO 8601)

started: Option<String>

Start timestamp (ISO 8601), if the task entered in_progress.

closed: Option<String>

Completion timestamp (ISO 8601), if closed

Implementations

impl Task

pub fn new(title: String, priority: u8) -> Self

Creates a new task with the given title and priority.

pub fn with_loop_id(self, loop_id: Option<String>) -> Self

Sets the loop ID for this task.

pub fn generate_id() -> String

Generates a unique task ID: task-{timestamp}-{hex_suffix}

pub fn is_ready(&self, all_tasks: &[Task]) -> bool

Returns true if this task is ready to work on (open + no blockers pending).

pub fn with_description(self, description: Option<String>) -> Self

Sets the description of the task.

pub fn with_key(self, key: Option<String>) -> Self

Sets the stable orchestration key for the task.

pub fn with_blocker(self, task_id: String) -> Self

Adds a blocker task ID.

pub fn start(&mut self)

Marks the task as in progress and records a start timestamp if absent.

pub fn reopen(&mut self)

Reopens a terminal task for further work.

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.