Enum CloseReason 

pub enum CloseReason {
    Detach,
    Shutdown,
    Expired,
}

Why an episode was closed. Reported to the repository as the end event’s reason, where share/providers.yaml’s deliberate-end list decides whether the record says closed or interrupted — the same table the provider hooks are read through, so a connection episode and a hook episode cannot disagree about what “ended deliberately” means.

The serialised word and CloseReason::as_str are one vocabulary:

use majordomus_cli::episodes::CloseReason;
for reason in [CloseReason::Detach, CloseReason::Shutdown, CloseReason::Expired] {
    let json = serde_json::to_string(&reason).unwrap();
    assert_eq!(json, format!("\"{}\"", reason.as_str()));
}

Variants

Detach

The client said so: episodes.detach, or DELETE /mcp. A deliberate end.

Shutdown

The server is stopping and every episode goes with it. Deliberate: nothing was cut short by this, the machine was.

Expired

The connection went and did not come back inside REATTACH_GRACE. Not deliberate, and the record says interrupted, because calling a crashed episode complete is the worse of the two mistakes.

Implementations

impl CloseReason

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

The word sent to the repository’s end event, as its reason. Only expired is outside the deliberate-end list, so only it records the episode as interrupted.

use majordomus_cli::episodes::CloseReason;
assert_eq!(CloseReason::Detach.as_str(), "detach");
assert_eq!(CloseReason::Expired.as_str(), "expired");

Trait Implementations

impl Clone for CloseReason

fn clone(&self) -> CloseReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CloseReason

impl Debug for CloseReason

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CloseReason

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CloseReason

impl JsonSchema for CloseReason

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 PartialEq for CloseReason

fn eq(&self, other: &CloseReason) -> 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 Serialize for CloseReason

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 CloseReason