Struct MemRouterSnapshot 

pub struct MemRouterSnapshot { /* private fields */ }

Mem configuration for the engine runtime — cloneable snapshot.

Tracks which mems are writable, which are visible, and their directories. Held on Engine behind an Arc<MemRouterSnapshot>; lifecycle mutations clone the snapshot, edit the clone, and swap the Arc pointer atomically inside the engine mutex.

Implementations

impl MemRouterSnapshot

pub fn new() -> Self

pub fn add_writable( &mut self, name: String, dir: Option<PathBuf>, origin: MemOrigin, )

Register a writable mem with its directory path and origin.

The mem’s hierarchical organisational path is part of name itself (e.g. "team/sub-mem"). The router HashMap key, the Mount::mem field, and the lifecycle-allowlist candidate all converge on the same string — no separate composition step.

pub fn remove_writable(&mut self, name: &str) -> bool

Remove a writable mem from the router. Returns true when the entry was present.

Internal — called by Engine::unregister_mem_runtime. Read-only entries are not affected; unregistering a name that names a read-only mem is a caller-level misuse and returns false.

pub fn add_read_only(&mut self, name: String, archive_path: PathBuf)

Register a read-only mem backed by a sealed .mem archive.

archive_path is the on-disk location of the archive. The router retains it so reload can re-open the same archive without re-parsing the project config.

pub fn remove_read_only(&mut self, name: &str) -> bool

Remove a read-only mem from the router. Returns true when the entry was present. Mirror of Self::remove_writable for the uninstall path: writable entries are not affected, and visible only drops the name when no writable entry still carries it.

pub fn is_writable(&self, mem: &str) -> bool

Check if a mem is writable.

pub fn is_visible(&self, mem: &str) -> bool

Check if a mem is visible (writable or read-only).

pub fn is_entity_visible(&self, entity_id: &EntityId) -> bool

Check if an entity is visible from the given context.

pub fn dir_for_mem(&self, mem: &str) -> Option<&Path>

Get the directory path for a writable mem.

Returns None when the mem is unknown OR when the mem is mem-repo-backed (no on-disk directory). Callers that need to distinguish “mem not found” from “mem has no dir” use is_writable first.

pub fn origin_for_mem(&self, mem: &str) -> Option<&MemOrigin>

Get the MemOrigin for a writable mem. Used by the MEM_NAME_COLLISION envelope renderer and the memstead_health { include_config: true } per-mem origin field.

pub fn archive_path_for_mem(&self, mem: &str) -> Option<&Path>

Get the sealed-archive path for a read-only mem.

Returns None for writable mems and unknown names. Keep this distinct from dir_for_mem — a directory and a zip archive are different backing stores, and callers usually care which they get.

pub fn writable_mems(&self) -> &HashSet<String>

Get all writable mem names.

pub fn visible_mems(&self) -> &HashSet<String>

Get all visible mem names.

pub fn validate_writable(&self, mem: &str) -> Result<(), String>

Validate that a mem is writable, returning an error message if not.

Trait Implementations

impl Clone for MemRouterSnapshot

fn clone(&self) -> MemRouterSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemRouterSnapshot

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

Formats the value using the given formatter.

impl Default for MemRouterSnapshot

fn default() -> Self

Returns the “default value” for a type.