Enum PointerLayout 

pub enum PointerLayout {
    Pointer,
    Inline,
    Absent,
}

The layout of the pointer, which is how far the per-provider migration has got here.

Before the episode was keyed by its provider session, session-current.yaml was the open record: one regular file, one episode per checkout. Seven concurrent sessions on 2026-09-09 produced one record between them under that layout. A regular file here today is a checkout that has not run the migration, and its episodes are being overwritten.

Only one of the three is a finding, and it is the middle one. Pointer is the current layout and Absent means no episode is open here — a fresh clone, or a worker between episodes — while Inline is a checkout still on the pre-migration layout, where a second concurrent session silently overwrites the first one’s record. So the question a reader asks of this value is not “which layout” but “is it Inline”.

use majordomus_cli::capability::builtin::lifecycle::PointerLayout;

// the two that are fine, and the one that loses records
let loses_records = |l: PointerLayout| l == PointerLayout::Inline;
assert!(!loses_records(PointerLayout::Pointer));
assert!(!loses_records(PointerLayout::Absent), "no episode open is not a fault");
assert!(loses_records(PointerLayout::Inline));

// serialised as the word `as_str` gives
assert_eq!(
    serde_json::to_value(PointerLayout::Absent).unwrap(),
    serde_json::json!(PointerLayout::Absent.as_str()),
);

Variants

Pointer

A symlink into sessions-open/: the per-provider layout.

Inline

A regular file: the pre-migration layout, one episode per checkout.

Absent

Nothing is there. No episode is open here, which is not a fault.

Implementations

impl PointerLayout

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

The word this layout is reported and serialised under. Named for what the pointer is rather than for the migration that produced it, so that the value still reads correctly once nobody remembers there was a migration.

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

Trait Implementations

impl Clone for PointerLayout

fn clone(&self) -> PointerLayout

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PointerLayout

impl Debug for PointerLayout

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PointerLayout

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PointerLayout

impl JsonSchema for PointerLayout

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 PointerLayout

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

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

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

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 PointerLayout