Enum EpisodeStanding 

pub enum EpisodeStanding {
    Current,
    Open,
    Foreign,
    Stranded,
}

Where an open episode stands, as far as the repository can observe it.

It is worth being precise about what is not here. Whether the provider that opened an episode is still attached to its conversation is not a fact of this repository: the episode file records no pid, the peer board records no episode id, and a client that exits without firing its end event leaves a file identical to one a live worker is using. Guessing would produce exactly the confident-and-wrong answer this subsystem exists to avoid, so the vocabulary below is the observable one — where the file is, whose worktree it names, and whether the pointer follows it — and note always says which.

Read as a scale, the four run from “this checkout’s own work” to “nobody’s work any more”, and only the last is a fault: current and open are both this worktree’s live episodes and differ only in which one the pointer happens to aim at, foreign belongs to another worktree and is reported rather than adopted, and stranded is the one that needs a person, because nothing can close it.

use majordomus_cli::capability::builtin::lifecycle::EpisodeStanding;

// the standings that are somebody's live work, against the one that is nobody's
let live = [EpisodeStanding::Current, EpisodeStanding::Open, EpisodeStanding::Foreign];
assert!(live.iter().all(|s| *s != EpisodeStanding::Stranded));

// serialised as the word `as_str` gives, so the two renderings cannot drift apart
for s in [EpisodeStanding::Current, EpisodeStanding::Foreign, EpisodeStanding::Stranded] {
    assert_eq!(serde_json::to_value(s).unwrap(), serde_json::json!(s.as_str()));
}

Variants

Current

This checkout’s pointer resolves to it. continuity.state is about this one.

Open

Open, and it names this worktree, but the pointer names a different episode. Two windows of one provider on one worktree are two workers, and only one is pointed at.

Foreign

It names another worktree of this repository. Reported, never treated as this checkout’s — a record about somebody else’s work quietly becoming yours is the failure the two-tier resolution rule exists to prevent.

Stranded

The worktree it names is gone from disk. Nothing can close it: the close path composes the record from git in the worktree the episode opened in.

Implementations

impl EpisodeStanding

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

The word this standing is reported and serialised under. One spelling for the value, so that the Cockpit, the API and MCP name a stranded episode identically and a reader who learned the vocabulary once has learned it everywhere.

use majordomus_cli::capability::builtin::lifecycle::EpisodeStanding;
assert_eq!(EpisodeStanding::Stranded.as_str(), "stranded");
// the serialised form is this word, not a second rendering of the same value
assert_eq!(
    serde_json::to_value(EpisodeStanding::Stranded).unwrap(),
    serde_json::json!(EpisodeStanding::Stranded.as_str()),
);

Trait Implementations

impl Clone for EpisodeStanding

fn clone(&self) -> EpisodeStanding

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for EpisodeStanding

impl Debug for EpisodeStanding

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EpisodeStanding

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for EpisodeStanding

impl JsonSchema for EpisodeStanding

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Ord for EpisodeStanding

fn cmp(&self, other: &EpisodeStanding) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for EpisodeStanding

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for EpisodeStanding

fn partial_cmp(&self, other: &EpisodeStanding) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for EpisodeStanding

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 EpisodeStanding