Struct LifecycleRequest 

pub struct LifecycleRequest {
    pub action: LifecycleAction,
    pub schedule_id: CycleScheduleId,
    pub cycle_id: Option<GeneratedCycleId>,
    pub actor: String,
    pub reason: Option<String>,
    pub timestamp: Option<String>,
    pub confirmed: bool,
    pub capacity: Option<CapacityCalculation>,
}

The explicit, confirmed intent to carry out one lifecycle action.

Every field is supplied and none is inferred. timestamp is the caller’s explicit instant — this codebase has no clock — required by every action that writes; reason is required by the five actions that record one (see LifecycleAction::requires_reason).

Fields

action: LifecycleAction

Which action to carry out.

schedule_id: CycleScheduleId

The schedule to act on, by stable id.

cycle_id: Option<GeneratedCycleId>

The instance to act on, when the action names one.

actor: String

Who asked — the audit actor.

reason: Option<String>

Why, when the action records one.

timestamp: Option<String>

The explicit instant (RFC 3339, YYYY-MM-DDTHH:MM:SSZ) the action happened.

confirmed: bool

Whether the caller confirmed the action. An unconfirmed request is inert.

capacity: Option<CapacityCalculation>

The capacity calculation a close records as its evidence, when the caller computed one (mission cycle-capacity-planning-01M3C85C, WP04).

The caller supplies this, and a later reader must not “fix” that by teaching apply to build one. The close path has no Config and no issue store — only the cycle records, the schedule index and this request — so it cannot run the calculation, and threading a store through apply would change every CLI, TUI and MCP call site for a value those surfaces already hold. The caller that owns the project configuration and the issue store computes it (one CapacityCalculation::for_scope) and sets it here.

None — the default, and what every caller written before this field did — means the close captures no capacity evidence, which is exactly the issue-181 behaviour: a snapshot with an empty measurements map. A payload this mission wrote reads back as “no capacity evidence”, never an error, so an un-updated caller is not broken by the field’s arrival.

Implementations

impl LifecycleRequest

pub fn new( action: LifecycleAction, schedule_id: CycleScheduleId, actor: impl Into<String>, ) -> Self

A request that is not yet confirmed.

pub fn with_capacity(self, calculation: CapacityCalculation) -> Self

Record the capacity calculation a close should capture as its evidence.

pub fn confirm(self) -> Self

Record the confirmation.

pub fn for_cycle(self, cycle_id: GeneratedCycleId) -> Self

Name the instance the action targets.

pub fn with_reason(self, reason: impl Into<String>) -> Self

Record why.

pub fn with_timestamp(self, timestamp: impl Into<String>) -> Self

Record the explicit instant.

Trait Implementations

impl Clone for LifecycleRequest

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 LifecycleRequest

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

Formats the value using the given formatter.

impl Eq for LifecycleRequest

impl PartialEq for LifecycleRequest

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for LifecycleRequest