Enum WorkerSpawnError 

pub enum WorkerSpawnError {
    NotLeadCaller,
    EmptyLabel,
    ReservedLabel,
    LabelWithPathSeparator,
    EmptyCharter,
    UnknownCallerProject,
    DispatchFailed {
        message: String,
    },
    WorktreeCreationFailed {
        reason: String,
    },
    ResumeLookupFailed {
        label: String,
        message: String,
    },
}

Synchronous error from spawn_worker. All gating happens before the workspace dispatch is even issued.

Variants

NotLeadCaller

Caller is a worker, not a project lead. v1 is lead-only.

EmptyLabel

label is empty after trim.

ReservedLabel

label collides with the reserved "lead" keyword (workers MCP uses it as an addressing target for the worker’s own lead - see LEAD_LABEL).

LabelWithPathSeparator

label carries a slash. claude rewrites one before deriving its worktree path and branch, so forge’s own composition from the raw label names a directory and a branch claude never uses (#1603).

EmptyCharter

charter is empty after trim.

UnknownCallerProject

Caller’s session key resolves to no known project (defensive; the tools closure-bind a real key at spawn time, so this should never fire in practice).

DispatchFailed

Spawn was dispatched but the workspace returned an error (e.g. tag-write failed). Forwarded as-is to the LLM.

Fields

message: String

WorktreeCreationFailed

The worker’s git worktree is missing or unusable, so nothing was spawned: claude could not create --worktree <label> (its reason passed through verbatim), or the composed path belongs to another project’s checkout or worker and was refused before anything could touch it.

Fields

reason: String

ResumeLookupFailed

resume_session was set and the label’s prior session could not be looked up: the transcript directory, or a transcript in it, is there and unreadable. Nothing was spawned. A lookup that found nothing is not this - that one falls back to a fresh session and reports it.

Fields

label: String

message: String

Implementations

impl WorkerSpawnError

pub(crate) fn message(&self) -> String

The sentence a caller reads. Shared with the spawn handler, which the command bus and the socket reach without the tool’s own validation, so both seams refuse a label with the same words.

Trait Implementations

impl Clone for WorkerSpawnError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkerSpawnError

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

Formats the value using the given formatter.

impl Eq for WorkerSpawnError

impl PartialEq for WorkerSpawnError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WorkerSpawnError