Struct Mount 

pub struct Mount {
    pub mem: String,
    pub schema: Option<SchemaRef>,
    pub storage: MountStorage,
    pub capability: MountCapability,
    pub lifecycle: MountLifecycle,
    pub cross_linkable: bool,
    pub migration_target: Option<SchemaRef>,
}

A single mem attachment in a Workspace. One mount = one mem. The schema pin is on the mount because per-mem schema resolution is fixed in code (local-storage → built-in → registry, with the storage layer owning where “local” lives — see the glossary’s Schema entry); the mount carries which schema this mem expects, the backend resolves where the YAMLs come from.

Fields

mem: String

Operator-facing mem name within this workspace.

schema: Option<SchemaRef>

Optional expectation assertion about this mem’s schema pin (exact <name>@<version>). The authoritative pin is the mem’s own MemConfig.schema on its storage backend; boot/load resolve from there. This field is a workspace-local cross-check — useful for foreign or read-only mounts. None means “assert nothing, trust the backend config”. When Some and mismatching the config pin, loading surfaces a SchemaPinMismatch finding naming both values; neither is silently preferred. Resolution falls back to this value only when the backend config carries no pin.

storage: MountStorage

Backend-specific reference to the mem’s content.

capability: MountCapability

Read-only or writable attachment.

lifecycle: MountLifecycle

Eager (open the backend at engine start) or lazy (defer to first read). V1 runtime treats every mount as Eager; the Lazy slot is reserved for archive backends that should not unzip at boot.

cross_linkable: bool

Whether other mounts in the same workspace may form cross-mem edges into this mount. Workspace-level cross-mem permission policy can override.

migration_target: Option<SchemaRef>

In-flight schema migration target. Some(target) puts the mem in dual-pin state: writes validate against target (the engine’s effective validation schema), reads stay permissive, and schema remains the settled pin until every entity is integral against the target — then the atomic switch sets schema = target and clears this field in one workspace-store write. Persisted so a long migration is resumable across engine restarts.

Implementations

impl Mount

pub fn mem_path(&self) -> Option<String>

Hierarchical organisational path for this mount, or None for flat layout / non-hierarchical storage. Mirrors the MemCreateParams.path create-side input — at delete time the lifecycle candidate composes as <mem_path>/<name> (or <name> alone when None) to match the create-side rule.

Derivation: MountStorage::GitBranch carries the path in its branch field. Tolerates both fully-qualified refs/heads/<mem_path>/<mem> (the shape create_mem produces) and bare <mem_path>/<mem> (the shape mounts.json operator-edited entries carry) — full’s instantiate_full_backend already normalises both forms. Strip the optional refs/heads/ prefix and the trailing <mem> leaf. Folder / Archive carry no hierarchical path on the storage variant — runtime callers that know the create-time path plumb it directly into the router via Engine::register_writable_mem.

Trait Implementations

impl Clone for Mount

fn clone(&self) -> Mount

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Mount

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

Formats the value using the given formatter.

impl Eq for Mount

impl PartialEq for Mount

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Mount