Struct StatusChange 

pub struct StatusChange<'a> {
    pub column: &'a str,
    pub commit: Option<&'a str>,
    pub override_reason: Option<&'a str>,
}

A request to move an issue to a column, through the seam.

WP03 T013. A struct rather than a positional list because the three arguments are all Option-shaped and adjacent: (Some(commit), None, None) is a mistake waiting to happen at a call site, and the field names are what stop it.

Deliberately absent

No actor. The seam records the identity itself through actor_identity, so a caller cannot attribute a decision to somebody else and the audit trail keeps one definition of “who acted”. Passing an actor in would make the attribution a choice of the caller, which is exactly the thing an audit trail must not be.

No updated. The seam bumps it, on exactly the transitions that change something. A caller supplying it would be able to write a file whose date says a no-op was an edit.

Fields

column: &'a str

The column to move to. A column the board does not configure is refused with unknown_column; a same-column request is accepted and inert.

commit: Option<&'a str>

The commit to record when this move reaches the board’s completion column.

Ignored on a move that does not reach completion, and a previously recorded commit is cleared on a move that leaves it. None therefore means “record nothing”, which is distinct from “leave the old value alone” — leaving an issue in its completion column with an unrelated commit is what the clear exists to prevent.

override_reason: Option<&'a str>

Why a policy rule was being overridden, when one was.

Without a reason the service refuses a transition out of a terminal category outright, so this is the only way out of done. The CLI flag that supplies it lands in WP04; the seam takes the parameter now so a half-built seam — one that can refuse but never accept-with-reason — is never what ships.

Implementations

impl<'a> StatusChange<'a>

pub fn to(column: &'a str) -> Self

A plain move: no commit, no override.

The common case, named so the call site reads as “move it” rather than as three Nones.

pub fn with_commit(self, commit: Option<&'a str>) -> Self

This request with a commit, for a move that reaches completion.

pub fn with_override(self, reason: Option<&'a str>) -> Self

This request with an override reason, for a move out of a terminal category.

Trait Implementations

impl<'a> Clone for StatusChange<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for StatusChange<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for StatusChange<'a>

impl<'a> PartialEq for StatusChange<'a>

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for StatusChange<'a>