Struct TaskState 

pub struct TaskState {
    pub goal: String,
    pub criteria: Vec<String>,
    pub plan: Vec<PlanStep>,
    pub current_step: Option<usize>,
    pub progress: String,
    pub scratchpad: String,
    pub blocked_on: Vec<String>,
    pub directives: Vec<String>,
    pub preserved_refs: Vec<String>,
    pub compression_log: Vec<CompressionEntry>,
}

Persistent task state that lives in the working partition. Survives compression, renewal, and wake/resume cycles because the working partition is compressible = false.

Fields

goal: String

Primary objective for this run. Set at run_started, immutable thereafter.

criteria: Vec<String>

Acceptance criteria copied from RunStarted.

plan: Vec<PlanStep>

Ordered plan steps.

current_step: Option<usize>

Index of the step currently executing (0-based). None before planning.

progress: String

Free-text progress note updated after each significant action.

scratchpad: String

Ephemeral scratch space for model use. Cleared on renewal. NOT used by the compression pipeline (use compression_log instead).

blocked_on: Vec<String>

Reasons the current step cannot proceed.

directives: Vec<String>

Durable user directives / standing constraints (e.g. mid-task corrections, “don’t do X”). Promoted here from the ephemeral signal channel so they survive compression AND renewal like the goal does — without this, the most recent user command loses salience exactly at the compaction/renewal boundaries between consecutive contexts (the “goal drift” failure). Bounded + recency-ordered (oldest dropped past MAX_DIRECTIVES); newest last.

preserved_refs: Vec<String>

Call IDs or artifact hashes that must be preserved from compression.

compression_log: Vec<CompressionEntry>

Append-only log of all compression events. Never overwritten. Rendered into systemVolatile so the model always sees compression history.

Implementations

impl TaskState

pub fn format_compact(&self) -> String

Compact text block for embedding in system_text. Returns an empty string when the task has not been initialised.

pub fn record_directive(&mut self, text: impl Into<String>)

Record a durable user directive (deduped against the most recent, recency-capped at MAX_DIRECTIVES). Newest is appended last; the oldest is dropped past the cap so the channel stays bounded across a long session.

pub fn log_compression(&mut self, action: &str, summary: String)

Append a compression event to the log. Never overwrites existing entries.

pub fn apply(&mut self, update: TaskUpdate)

pub fn open_steps(&self) -> Vec<String>

Open steps (not yet done), for renewal handoff.

Trait Implementations

impl Clone for TaskState

fn clone(&self) -> TaskState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaskState

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

Formats the value using the given formatter.

impl Default for TaskState

fn default() -> TaskState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TaskState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TaskState

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

where __S: Serializer,

Serialize this value into the given Serde serializer.