Skip to main content

RunStatus

Enum RunStatus 

Source
pub enum RunStatus {
Show 14 variants Prep, Implementing, Judging, Deliberating, Voting, Reviewing, Gating, Landing, Merged, Ready, Stalled, Blocked, Failed, VerifiedNoop,
}
Expand description

Where a run got to.

Variants§

§

Prep

Worktrees being prepared.

§

Implementing

Candidates being implemented.

§

Judging

Judges ranking blind.

§

Deliberating

Judges deliberating after a split.

§

Voting

Final votes being collected privately.

§

Reviewing

Winner in the review + verification loop.

§

Gating

Gate commands running. Transient: graph::Runner::gate and graph::Runner::merge always move a run on from here, whether or not any gate commands are configured — see RunState::gate_status and SCHEMA’s doc for schema 7, which fixed a repo with an empty verify.gate stranding a review-only run in Gating forever.

§

Landing

Inside crate::land’s post-merge loop: watching CI, running a fix round, rebasing onto a moved base, or waiting on the owner’s merge approval. A run parked here while an approval is outstanding has handed its daemon slot back — see crate::daemon — and resumes through exactly this status, not a fresh competition.

§

Merged

Winner merged.

§

Ready

Winner passed the gate; merge was not requested.

§

Stalled

The judgement did not gather enough judges (e.g. rate limiting took out seats), so the verdict is not trustworthy. The run stopped and kept its work so it can be resumed or folded — it must never be confused with a healthy Ready.

§

Blocked

Review rounds exhausted with findings still open, or the gate failed.

§

Failed

The graph could not complete.

§

VerifiedNoop

Every candidate wrote nothing, and every one of them said why in a way that survived crate::graph::Runner’s adoption guard: a clean CLI exit, an actually-empty tree, no command left with an unconfirmed exit status, and non-empty evidence. Distinct from Failed on purpose — see SCHEMA’s doc for schema 10 — because the two read identically to an operator glancing at a card (“nothing happened”) while meaning opposite things: one is an agent that could not do the work, the other is an agent that checked and the work was already done. Settles the task through crate::queue::Task::handed_off, not crate::queue::Task::fail: a human still has to look — the claim is unverified by magi itself — and Held (not Failed-and-requeued) means nothing retries the task unattended on the same unconfirmed claim while that look is pending.

Implementations§

Source§

impl RunStatus

Source

pub fn done(self) -> bool

Is this a terminal state?

Source

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

The name this status is written and shown under, matching the snake_case serde spelling so a log line, an error message and the JSON a phone reads all say the same word.

Source

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

Label for a human-facing listing or report — the same word as Self::as_str except where the machine spelling would read harsher than the state actually is. VerifiedNoop is the one case: its own as_str exists for logs, JSON and event messages, none of which should quietly grow a second vocabulary, but a bare “verified_noop” in a report reads like an error code, not the qualified, evidence-backed claim it actually is.

Source

pub fn resumable(self) -> bool

Can this run be carried on from where it stopped?

Everything except a finished run and a failed one. execute skips nodes already recorded, so re-entering is cheap wherever the run stopped, and the alternative is always a fresh competition against work that already exists.

  • Stalled re-asks only the seats whose absence collapsed the panel, keeping the candidates that were already paid for.
  • Blocked re-enters the review loop against a branch that is built.
  • A non-terminal status means the run was interrupted: a parked run waiting for its upgrade, or one whose daemon was killed. This used to be excluded, which left run 4043 stuck at reviewing with the deck telling the operator it could not be resumed - the one state where resuming is the only sensible answer.

Failed does not qualify: the graph could not complete and there is no established point to continue from. Nor does a finished run, whose answer is a new competition. Nor does VerifiedNoop: every candidate already agreed nothing belongs in this worktree, and resuming would only re-ask the same question — the answer is for a human to check the evidence, not for the graph to run again.

Whether anything is already driving the run is a separate question, answered by daemon::is_working_on at the callers that need it.

Trait Implementations§

Source§

impl Clone for RunStatus

Source§

fn clone(&self) -> Self

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 RunStatus

Source§

impl Debug for RunStatus

Source§

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

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

impl<'de> Deserialize<'de> for RunStatus

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 RunStatus

Source§

impl PartialEq for RunStatus

Source§

fn eq(&self, other: &Self) -> 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 RunStatus

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 RunStatus

Auto Trait Implementations§

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<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<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

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

Source§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
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> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

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

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
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 = !

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

fn try_from(value: U) -> Result<T, !>

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<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