Struct Snapshot 

pub struct Snapshot {
    pub file: PathBuf,
    pub id: String,
    pub revision: u64,
    pub primary: PathBuf,
    pub roots: Vec<AttachedRoot>,
    pub unavailable: Vec<String>,
}

An immutable view of one Workspace revision.

Fields

file: PathBuf

id: String

revision: u64

primary: PathBuf

Canonical primary root (read-write).

roots: Vec<AttachedRoot>

Canonical additional roots that exist; see Snapshot::unavailable.

unavailable: Vec<String>

Attached roots that no longer resolve to the recorded directory (deleted, or replaced by a symlink). They grant nothing.

Implementations

impl Snapshot

pub fn granting_roots(&self) -> impl Iterator<Item = (&Path, Access)>

Every root that grants access, primary first.

pub fn additional_root_strings(&self) -> Vec<String>

The additional roots as strings, for the request’s tool context.

pub fn root_for(&self, canonical: &Path) -> Option<(&Path, Access)>

The granting root containing the canonical path, if any. The most specific root wins, so a read-only root nested in a read-write one stays read-only.

pub fn admits(&self, canonical: &Path) -> bool

True when the canonical path lies in a granting root.

pub fn admits_write(&self, canonical: &Path) -> bool

True when the canonical path lies in a read-write root.

pub fn project_root_for(&self, wanted: &str) -> String

The request’s project root: wanted when a granting root contains it, else the primary root.

pub fn status_line(&self) -> String

One line naming the binding, for MCP status output.

pub fn to_json(&self) -> Value

Structured form for lean-ctx workspace show --json and /api/scope.

Trait Implementations

impl Clone for Snapshot

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Snapshot

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

Formats the value using the given formatter.

impl Eq for Snapshot

impl PartialEq for Snapshot

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Snapshot