Struct ProtectedPaths 

pub struct ProtectedPaths {
    home: Option<PathBuf>,
    data_root: Option<PathBuf>,
    install_dirs: Vec<PathBuf>,
    system_roots: Vec<PathBuf>,
    exempt_roots: Vec<PathBuf>,
}

What a mutation must never touch (spec §9, “Security”): a filesystem root, the home folder itself, AgentMux’s own data and installation, the OS’s system folders, and the inside of a macOS app bundle. Nor anything that CONTAINS one of those: deleting C:\Users would delete the home folder too.

Every path held here is in path_key form.

Fields

home: Option<PathBuf>

data_root: Option<PathBuf>

~/.agentmux. Inside it only agents’ own workspaces (agents/<name>/…) may be changed; the rest is AgentMux’s state.

install_dirs: Vec<PathBuf>

system_roots: Vec<PathBuf>

exempt_roots: Vec<PathBuf>

Inside these the system list doesn’t apply: the temp folder, which on macOS lives under /var.

Implementations

impl ProtectedPaths

pub fn current() -> Self

The protected set for this machine, computed afresh so a check made right before a mutation reflects the filesystem as it is then.

pub fn check(&self, target: &Path) -> Result<(), String>

Ok if a mutation may act on target (a resolve_entry_path result). The error is a sentence for the user.

fn check_in_distro(&self, share: &SharePath) -> Result<(), String>

Self::check for a WSL distro’s file through \\wsl.localhost (remote::wsl_fs). Its /mnt/<letter> is a Windows drive, so the Windows rules decide; its own system folders and home folders are protected as this machine’s are.

Trait Implementations

impl Clone for ProtectedPaths

fn clone(&self) -> ProtectedPaths

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProtectedPaths

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

Formats the value using the given formatter.

impl Default for ProtectedPaths

fn default() -> ProtectedPaths

Returns the “default value” for a type.