Struct DotfileGuardian 

pub struct DotfileGuardian { /* private fields */ }

The Dotfile Guardian.

Central protection mechanism that:

• Detects protected dotfiles
• Enforces confirmation requirements
• Logs all access attempts
• Manages backups
• Prevents cascading modifications

Implementations

impl DotfileGuardian

pub async fn new(config: DotfileProtectionConfig) -> Result<Self>

Create a new dotfile guardian with the given configuration.

pub async fn with_defaults() -> Result<Self>

Create a guardian with default configuration.

pub fn is_protected(&self, path: &Path) -> bool

Check if a file path is a protected dotfile.

pub fn is_whitelisted(&self, path: &Path) -> bool

Check if a file is whitelisted.

pub async fn request_access( &self, context: &AccessContext, ) -> Result<ProtectionDecision>

Request access to a dotfile.

Returns a protection decision that must be handled by the caller.

pub async fn confirm_modification( &self, context: &AccessContext, is_whitelisted: bool, ) -> Result<()>

Record that user confirmed the modification.

pub async fn reject_modification(&self, context: &AccessContext) -> Result<()>

Record that user rejected the modification.

pub async fn would_cascade(&self, file_path: &Path) -> bool

Check if modifying a file would trigger a cascade.

pub async fn get_latest_backup( &self, file_path: &Path, ) -> Result<Option<DotfileBackup>>

Get the most recent backup for a file.

pub async fn restore_from_backup(&self, file_path: &Path) -> Result<()>

Restore a file from its most recent backup.

pub async fn get_audit_history( &self, file_path: &str, ) -> Result<Vec<AuditEntry>>

Get audit entries for a file.

pub async fn verify_audit_integrity(&self) -> Result<bool>

Verify audit log integrity.

pub async fn reset_session(&self)

Reset session state (for new conversation).

pub async fn get_modified_files(&self) -> Vec<PathBuf>

Get list of files modified in this session.

Trait Implementations

impl Clone for DotfileGuardian

fn clone(&self) -> DotfileGuardian

Returns a duplicate of the value.

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

Performs copy-assignment from source.