Struct RunOptions 

pub struct RunOptions {

    pub max_tasks: Option<usize>,
    pub approver: Option<Arc<dyn Approver>>,
    pub progress: Option<Arc<dyn Progress>>,
    pub parallel: usize,
    pub lane: Option<String>,
    pub cancel: Option<Arc<AtomicBool>>,
    pub ignore_checklists: bool,
    pub fresh_acceptance: bool,
    pub allow_failing_baseline: bool,
    pub run_grants: Arc<Mutex<Vec<Object>>>,
    pub run_id: Arc<Mutex<RunId>>,
    pub asked: Arc<Mutex<u32>>,
    pub in_place: bool,
    pub session: Option<Arc<Mutex<Session>>>,
    pub bug_home: Option<Arc<NativeBug>>,
    pub mode: RunMode,
    pub agent: Option<String>,
    pub cap: Option<Cap>,
    pub left: Option<Cap>,
}

How a run behaves beyond its configuration.

Fields

max_tasks: Option<usize>

At most this many tasks in a feature run.

approver: Option<Arc<dyn Approver>>

Who to ask inline when a call needs approval; without one, the attempt stops and speccoder task approve decides.

progress: Option<Arc<dyn Progress>>

Where live progress goes: the CLI’s printer.

parallel: usize

Ready [P] tasks run at once, each in its own worktree; 0 or 1: one at a time.

lane: Option<String>

Run the task in this lane’s worktree instead of the feature’s.

cancel: Option<Arc<AtomicBool>>

Set by a person (an editor’s cancel): a feature run stops before its next task.

ignore_checklists: bool

Run although the feature’s checklists have unchecked items; the override is recorded on every commit of the run.

fresh_acceptance: bool

Set a task’s held or interrupted attempt aside and write its acceptance tests anew (run --task T --fresh-acceptance).

allow_failing_baseline: bool

Attempt although a check cannot run on the untouched code (run --allow-failing-baseline); otherwise the run stops before any model call (CHECK-BROKEN).

run_grants: Arc<Mutex<Vec<Object>>>

Objects a person approved “for this run”: shared by every task (and lane) of one speccoder run, gone with it.

run_id: Arc<Mutex<RunId>>

The run: one per speccoder run from its fresh start; an invocation that resumes a suspended attempt adopts that attempt’s. Grants, the asking count and the batch are keyed by it.

asked: Arc<Mutex<u32>>

Prompts the run has shown a person ([approvals] budget caps them).

in_place: bool

Run in the person’s checkout on speccoder/<feature> instead of a worktree (run --in-place).

session: Option<Arc<Mutex<Session>>>

The in-place session the runtime opened for this run.

bug_home: Option<Arc<NativeBug>>

Run a bug of the format’s own bug structure (no task list names it).

mode: RunMode

How the run asks for a person: Ask as today, or Autopilot — nothing asks, a call that would is refused for the run unless a grant in run_grants (the ones the person ticked) covers it.

agent: Option<String>

This run’s agent (run --agent <id>): an ACP preset, or native for speccoder’s own loop; speccoder.toml is untouched.

cap: Option<Cap>

What this run may spend (run --cap); over [budget] cap.

left: Option<Cap>

What is left of the run’s cap for this task, set by the feature loop.

Implementations

impl RunOptions

pub fn run(&self) -> RunId

The run’s id now.

pub fn asked_now(&self) -> u32

The run’s prompts so far.

Trait Implementations

impl Clone for RunOptions

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 RunOptions

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

Formats the value using the given formatter.

impl Default for RunOptions

fn default() -> Self

Returns the “default value” for a type.