Enum ChoiceAction 

pub enum ChoiceAction {
    Resume {
        run: String,
    },
    ResumeRun {
        run: String,
    },
    ReleaseTask {
        task: String,
        held_at: Timestamp,
        reason: Option<String>,
    },
    RerunChecks {
        repo: PathBuf,
        pr: String,
        head: String,
        runs: Vec<String>,
    },
    AbandonRun {
        run: String,
    },
    Requeue,
    Hold,
    Done,
}

What the daemon does to the task behind a question when a particular choice is answered.

A closed set, attached to a choice by the asker (magi ask --choice X --action X=resume) and matched by the choice’s exact text. Nothing here is ever derived from the wording of a label or of a free-text answer: a question without an action for the chosen label does nothing but answer.

Variants

Resume

Resume this run of the task that owns the question.

Fields

run: String

The run to continue. Must still be the task’s latest run.

ResumeRun

Resume a named execution through the shared driver service.

Fields

run: String

Exact run ID; never a prefix resolved at application time.

ReleaseTask

Release only the exact hold the question was filed about.

Fields

task: String

Exact queue task ID.

held_at: Timestamp

Start of the hold observed when filing the question.

reason: Option<String>

Exact hold reason (including its absence) observed when filing.

RerunChecks

Rerun these failed workflow runs once, on this exact PR head.

Fields

repo: PathBuf

Repository used for forge access.

pr: String

Named pull request URL or number.

head: String

Commit whose checks the owner saw.

runs: Vec<String>

Failed workflow run IDs, bounded to twenty.

AbandonRun

End a predecessor only after the shared driver judge proves it dead.

Fields

run: String

Exact predecessor run ID.

Requeue

Requeue the task as a fresh competition.

Hold

Hold the task until the operator releases it.

Done

Close the task as done.

Implementations

impl ChoiceAction

pub fn targets(&self, task: &Task) -> bool

Queue owners affected by a named maintenance action.

pub fn maintenance(&self) -> bool

Maintenance effects are applied exclusively by the daemon.

pub fn parse(spec: &str, default_run: &str) -> Result<(String, Self)>

Parse a --action value: <label>=<verb>, where the verb is resume[:<run>], requeue, hold or done. A resume without a run takes default_run (the asker’s own MAGI_RUN). Returns the label and its action; whether the label is one of the choices is the caller’s check.

pub fn matches_alias(&self, input: &str) -> bool

Stable aliases for internal recovery, independent of display labels. Other effects still require their offered labels and existing consent.

pub fn describe(&self) -> String

Short human wording, for magi show and the card.

Trait Implementations

impl Clone for ChoiceAction

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 ChoiceAction

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ChoiceAction

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ChoiceAction

impl PartialEq for ChoiceAction

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ChoiceAction

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 ChoiceAction