Enum TaskLifecycle 

pub enum TaskLifecycle {
    PendingLaunch,
    Starting,
    Ready,
    Running,
    Suspended,
    Done(TerminationReason),
}

Schedulability lifecycle of a task — orthogonal to the intra-turn step, which stays on crate::scheduler::state_machine::LoopPhase, and distinct from the task-goal blackboard crate::context::task_state::TaskState.

Variants

PendingLaunch

Spec §10.4 · the kernel has minted this task’s identity (task/attempt/launch token) but the launch effect that carries it is not published yet. A child exists as a committed fact before any host is asked to start it — that is what stops a resolution from creating process identity.

Every spawn constructs this state; publication advances it to Self::Starting and only a correlated launch acknowledgement advances it to Self::Running.

Starting

Spec §10.4 · the launch effect is published and the host has been asked to start the child, but no acknowledgement has arrived. Distinct from Self::Running because “we asked” and “it is running” are different facts, and only the second may be reported as one.

Ready

Eligible to run, not yet picked by the scheduler.

Running

Currently executing a turn (ProcessState::Running).

Suspended

Suspended awaiting external resolution (human approval / sub-agent join).

Done(TerminationReason)

Finished. Carries the termination reason (ProcessState::{Joined,Failed}).

Implementations

impl TaskLifecycle

pub fn label(self) -> &'static str

pub fn is_terminal(self) -> bool

pub fn occupies_slot(self) -> bool

Whether this task holds one of the operation’s concurrency slots.

A launch the kernel has already decided on occupies a slot even before the host confirms it — otherwise every in-flight launch would be invisible to the spawn quota and an ack-gated run could overshoot max_concurrent_subagents by the size of its launch window. Legacy runs never construct the two launch states, so this reads exactly as == Running for them.

Trait Implementations

impl Clone for TaskLifecycle

fn clone(&self) -> TaskLifecycle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TaskLifecycle

impl Debug for TaskLifecycle

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TaskLifecycle

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TaskLifecycle

impl From<ProcessState> for TaskLifecycle

A successful join maps to Done(Completed); any other termination is Done(<reason>).

fn from(state: ProcessState) -> Self

Converts to this type from the input type.

impl PartialEq for TaskLifecycle

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for TaskLifecycle

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TaskLifecycle