Enum AutoWorkerDecision 

pub enum AutoWorkerDecision {
    Minted,
    Reminted,
    Unchanged,
    RecordedNotRunning,
    OperatorStopped,
    Retired,
    OperatorRecord,
    DarkOutbox,
    UnrunnableHarness,
    Failed,
}

What was decided about one task queue.

Variants

Minted

No record served this queue, so one was minted and converged.

Reminted

The queue’s own auto record existed and named a DIFFERENT document, so it was replaced and its worker restarted onto the new one.

Unchanged

The queue’s own auto record already names this exact document. Nothing was written; the running worker was left alone and merely converged.

RecordedNotRunning

The record was written durably, and this server could NOT start it. The record stands and the next boot’s reconcile honours it; detail carries the supervision failure and its remedy.

Distinct from every arm above because those all claim a running worker, and claiming one that does not exist is the exact defect this whole lane exists to end — one layer up.

OperatorStopped

The queue’s own auto record was deliberately STOPPED by an operator, and their intent was preserved rather than reversed.

Retired

The document no longer declares this queue, so the record this server minted for it was withdrawn and its worker stopped.

OperatorRecord

A record the OPERATOR authored already serves this queue. Their record wins and nothing here touched or duplicated it.

DarkOutbox

This server binds no liminal worker listener, so a minted record would dial nothing. Refused, with the [outbox] remedy in detail.

UnrunnableHarness

The document’s harness names an agent THIS host cannot launch — an absent or non-executable agent binary, or a literal working directory that does not exist here. Refused with the missing path named; the deploy itself landed. Measured 2026-08-26 on the estate: a fleet document deployed from a Linux box minted workers on the Mac server whose harness named /home/aion/... paths, and every dispatch routed to them burned an attempt on a spawn that could only fail.

Failed

Auto-provision could not be carried out. detail says what refused.

Implementations

impl AutoWorkerDecision

pub const fn token(self) -> &'static str

Stable token for logs and metrics.

pub const fn is_refusal(self) -> bool

Whether this outcome left the queue WITHOUT the built-in agent worker the document asked for by declaring a harness section.

Three arms are deliberately NOT refusals, because in each of them a person already decided: Self::OperatorRecord (their record serves the queue), Self::OperatorStopped (they stopped it on purpose), and Self::Retired (the document stopped declaring the queue).

pub const fn claims_running(self) -> bool

Whether this outcome CLAIMS a running worker.

The claim is only ever made where a convergence returned success. It is separated from the decision because a record can be written correctly and still not run, and reporting those two as one thing is how a status surface comes to say a worker started when no process exists.

Trait Implementations

impl Clone for AutoWorkerDecision

fn clone(&self) -> AutoWorkerDecision

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AutoWorkerDecision

impl Debug for AutoWorkerDecision

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AutoWorkerDecision

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for AutoWorkerDecision

impl PartialEq for AutoWorkerDecision

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for AutoWorkerDecision

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 AutoWorkerDecision