Struct Stranded 

pub struct Stranded {
    pub session_id: String,
    pub path: String,
    pub reason: String,
    pub remedy: String,
}

An open episode that cannot close itself, and what to do about it.

The remedy here is the mechanical one — remove the file — because it is correct in every checkout and needs nothing that is not already installed. lib/recover.sh on feature/session-store-recovery is the same three degradations seen from the writing side: it classifies each candidate by reading it, prints the evidence before acting, and closes a stranded episode into a real record rather than deleting it. When that lands, the remedy a finding carries should become majordomus recover episodes and the two detections should become one — a reader and a writer that each decide for themselves what “stranded” means are two definitions, and this repository has been bitten by that shape often enough to name it.

use majordomus_cli::capability::builtin::lifecycle::Stranded;
use serde_json::json;

let s: Stranded = serde_json::from_value(json!({
    "session_id": "s-0007",
    "path": ".ai/local/state/sessions-open/claude-7.yaml",
    "reason": "the worktree it opened in is gone from disk",
    "remedy": "rm .ai/local/state/sessions-open/claude-7.yaml",
})).unwrap();

// the reason is about the world and the remedy is a command: a finding with no
// remedy is a complaint, so both are required fields rather than optional ones
assert!(!s.reason.is_empty() && !s.remedy.is_empty());
assert!(s.remedy.contains(&s.path), "the remedy acts on the file it names");

Fields

session_id: String

The episode id.

path: String

The open record, repository-relative.

reason: String

Why it is stranded.

remedy: String

The command that clears it. A finding with no remedy is a complaint.

Trait Implementations

impl Clone for Stranded

fn clone(&self) -> Stranded

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Stranded

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Stranded

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Stranded

impl JsonSchema for Stranded

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 Stranded

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

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 Stranded