Struct MobKitStorageLayout 

pub struct MobKitStorageLayout { /* private fields */ }

Immutable path authority, constructed once at bootstrap.

Implementations

impl MobKitStorageLayout

pub fn from_meerkat_layout( meerkat_layout: &StorageLayout, state_dir: PathBuf, ) -> Self

Embedded construction: MobKit runs inside a Meerkat realm and derives from Meerkat’s already-resolved meerkat_core::StorageLayout — MobKit never re-resolves ambient roots. state_dir is the directory MobKit’s stores live in (the embedder chooses where under the realm); the Meerkat state root is carried for the layout summary so health surfaces can correlate the two.

pub fn standalone(state_dir: PathBuf, gateway_home: PathBuf) -> Self

Standalone gateway construction from an explicit state directory plus the gateway home (registry + peer key). Derive the home with default_gateway_home; nothing else may read $XDG_STATE_HOME.

pub fn standalone_from_store_path( store_path: &Path, gateway_home: PathBuf, ) -> Self

Standalone construction from a gateway store_path init parameter: a path with a file extension is an explicit session-database override (its parent becomes the state directory); otherwise it is the state directory itself. This is the one place that interprets the store_path escape hatch — call sites never sniff extensions.

pub fn declared_ephemeral(scratch_root: PathBuf) -> Self

Explicitly declared-ephemeral construction: no persistent state exists, and every store under scratch_root is per-process scratch. The choice is recorded in the layout summary — never a silent call-site fallback into the OS temp directory.

pub fn with_injected_roots( state_dir: PathBuf, gateway_home: Option<PathBuf>, ) -> Self

Fully-injected constructor: no ambient reads at all (tests, and embedders that own their environment — the runtime builder constructs its layout from the explicit persistent_state() root this way).

pub fn state_dir(&self) -> &Path

The state directory every database locator resolves under.

pub fn gateway_home(&self) -> Option<&Path>

The XDG gateway home (registry + peer key), when this layout has one.

pub fn meerkat_state_root(&self) -> Option<&Path>

The Meerkat realm state root, when embedded via Self::from_meerkat_layout.

pub fn session_db_override(&self) -> Option<&Path>

The explicit session-database override, when constructed from a store_path with a file extension.

pub fn is_declared_ephemeral(&self) -> bool

Whether the state root is an explicitly declared scratch root.

pub fn resolve_database( &self, slot: DatabaseSlot, ) -> Result<ResolvedDatabase, StorageLayoutError>

Resolve a database locator by canonical-name-first probing (see the module docs). The resolver never creates files and never renames.

pub fn session_db(&self) -> Result<ResolvedDatabase, StorageLayoutError>

The sessions database (probing; honors the explicit override).

pub fn continuity_db(&self) -> Result<ResolvedDatabase, StorageLayoutError>

The identity-continuity database (probing).

pub fn metadata_db(&self) -> Result<ResolvedDatabase, StorageLayoutError>

The runtime-metadata database (probing).

pub fn console_db(&self) -> Result<ResolvedDatabase, StorageLayoutError>

The console-timeline database (probing).

pub fn agent_memory_root(&self) -> Result<ResolvedDatabase, StorageLayoutError>

The agent-memory root directory (probing; per-realm files beneath it stay feature-owned).

pub fn runtime_db(&self) -> PathBuf

The runtime store database. One spelling everywhere — infallible.

pub fn schedule_db(&self) -> PathBuf

The schedule store database. One spelling everywhere — infallible.

pub fn workgraph_db(&self) -> PathBuf

The workgraph store database. One spelling everywhere — infallible.

pub fn jobs_db(&self) -> PathBuf

Canonical Meerkat-level detached-job database inherited by MobKit’s composite provider. This is realm-owned, not a second MobKit store.

pub fn event_log_db(&self) -> PathBuf

The reserved event-log locator (nothing opens it before M4).

pub fn blob_root(&self) -> PathBuf

The blob root directory (internal sharding stays feature-owned).

pub fn peer_key_file(&self) -> Option<PathBuf>

The gateway peer-key file, when this layout has a gateway home.

pub fn registry_file(&self) -> Option<PathBuf>

The runtime registry file, when this layout has a gateway home.

pub fn layout_summary(&self) -> StorageLayoutSummary

A serializable snapshot of the layout and every slot’s resolution, for health surfaces (the storage doctor consumes it).

Trait Implementations

impl Clone for MobKitStorageLayout

fn clone(&self) -> MobKitStorageLayout

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MobKitStorageLayout

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

Formats the value using the given formatter.

impl Eq for MobKitStorageLayout

impl PartialEq for MobKitStorageLayout

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MobKitStorageLayout