Skip to main content

Kind

Enum Kind 

Source
pub enum Kind {
    Spinoff,
    Research,
    TechnicalDecision,
    FanOut,
    Unknown,
}
Expand description

The run/node kind enum (design.md §1.2).

The 0.2 subtractive cut removed the code, orchestrate, orchestrated, bugfix, and make-skill kinds (the interactive + DAG-driver topologies and the two phantom variants that were behaviourally Spinoff). The surviving kinds are all autonomous. Kind::Unknown is a read-only catch-all so a legacy on-disk run recorded under a since-removed kind still deserializes — doctor / run list report it, never delete it (ADR §D7).

Variants§

§

Spinoff

Autonomous fire-and-forget task that merges itself back (/worktree-spinoff).

§

Research

Autonomous multi-source research worktree (/worktree-research).

§

TechnicalDecision

Drives one architectural decision to an ADR (/worktree-technical-decision).

§

FanOut

Parallel fan-out of many identical units (/fan-out).

§

Unknown

A kind this build no longer models — a legacy run recorded on disk under a kind removed in the 0.2 cut (code / orchestrate / orchestrated / bugfix / make-skill), or any future/unknown wire value. Read-only: #[serde(other)] maps every unrecognized kind here so doctor / run list can still surface such a run rather than faulting on it (ADR §D7). It is NEVER a creatable kind — it is absent from Kind::WIRE_NAMES, so no CLI surface or report validator accepts it as input.

Implementations§

Source§

impl Kind

Source

pub const WIRE_NAMES: &'static [&'static str]

Every creatable kind’s kebab-case wire name, in declaration order. Single source of truth for “the set of accepted kinds” — see Kind::wire_name. Excludes Kind::Unknown, which is a read-only catch-all, never a valid input.

Source

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

The kebab-case wire name for this kind — the same string serde (de)serializes via rename_all = "kebab-case".

The exhaustive match is deliberate: adding a Kind variant fails to compile until its wire name is listed here, so Kind::WIRE_NAMES and any caller that advertises the accepted kinds (e.g. the report validator’s expected hint) cannot silently drift from the enum.

Source

pub fn lifecycle(self) -> Lifecycle

Default how-run Lifecycle for a kind — the value a run gets when created WITHOUT --interactive. Every kind defaults to autonomous; the 0.2 cut removed the code kind that used to imply interactivity, so interactivity is no longer kind-derived — it is the explicit --interactive flag (Lifecycle docs, design.md §2/§6). This method only seeds the default; it must NOT be read as “this kind is (non-)interactive”. Kind::Unknown (a legacy on-disk run) reads as autonomous too; it is never freshly supervised, so the value only ever feeds read-only display.

Source

pub fn is_autonomous_single_node_worker(self) -> bool

Whether this kind is a top-level, single-node, autonomous worker — one detached agent that materializes its own worktree and self-merges, with no children and no parent DAG driving it. These are exactly the kinds eligible for the supervisor’s bounded auto-retry on an empty-handed agent-died (issue autoretry-agent-died-worker).

Excludes FanOut (a multi-unit driver — its driver node has no agent of its own) and Kind::Unknown (a legacy on-disk run, never freshly supervised).

The exhaustive match fails to compile when a new Kind is added, forcing a deliberate eligibility decision rather than a silent default.

Trait Implementations§

Source§

impl Clone for Kind

Source§

fn clone(&self) -> Kind

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for Kind

Source§

impl Debug for Kind

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for Kind

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Eq for Kind

Source§

impl Hash for Kind

Source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
Source§

impl PartialEq for Kind

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl Serialize for Kind

Source§

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

Serialize this value into the given Serde serializer. Read more
Source§

impl StructuralPartialEq for Kind

Auto Trait Implementations§

§

impl Freeze for Kind

§

impl RefUnwindSafe for Kind

§

impl Send for Kind

§

impl Sync for Kind

§

impl Unpin for Kind

§

impl UnsafeUnpin for Kind

§

impl UnwindSafe for Kind

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more