Struct MindmapCache 

pub struct MindmapCache { /* private fields */ }

Manages loading and caching of mindmap files with security validation

Implementations

impl MindmapCache

pub fn new(workspace_root: PathBuf) -> Self

Create a new cache with the given workspace root

pub fn workspace_root(&self) -> &Path

Get the workspace root

pub fn load( &mut self, base_file: &Path, relative: &str, visited: &HashSet<PathBuf>, ) -> Result<&Mindmap>

Load a mindmap file with caching

Arguments

• base_file - The file that contains the reference (used to resolve relative paths)
• relative - The relative path to load (e.g., “./MINDMAP.llm.md”)
• visited - Set of already-visited files (for cycle detection)

Errors

• Path traversal attempts (e.g., “../../../etc/passwd”)
• Absolute paths (POSIX, Windows drive letters, UNC paths)
• File too large (> max_file_size)
• File not found
• Cycle detected (path already in visited set)

pub fn resolve_path(&self, base_file: &Path, relative: &str) -> Result<PathBuf>

Resolve a relative path to a canonical absolute path

Path resolution rules:

1. Resolve relative to the base_file’s directory
2. No absolute paths allowed (POSIX /foo, Windows C:\foo, UNC \server\share)
3. No directory traversal escapes (../../../ blocked)
4. Final path must be within workspace_root

Errors

• Absolute path detected
• Path escape attempt (outside workspace_root)
• Path canonicalization failed

pub fn clear(&mut self)

Clear the cache

pub fn stats(&self) -> CacheStats

Get cache statistics

pub fn max_depth(&self) -> usize

Get max recursion depth

Trait Implementations

impl Debug for MindmapCache

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

Formats the value using the given formatter.