Struct ProjectPersistence 

pub struct ProjectPersistence { /* private fields */ }

Helper for reading/writing persisted project state.

Implementations

impl ProjectPersistence

pub fn new(index_root: &Path, cache_directory: &str) -> Self

Create a new persistence helper.

Arguments

• index_root - The project’s index root path
• cache_directory - The cache directory from config (relative paths only for security)

Security

Only relative paths are allowed for cache_directory. Absolute paths or paths with .. traversal are rejected to prevent writes outside the project root. (Fixes HIGH path traversal finding from review)

pub fn ensure_state_root(&self) -> Result<()>

Ensure the state root directory exists.

Errors

Returns an error if the directory cannot be created.

pub fn state_file_path(&self, project_id: ProjectId) -> PathBuf

Get the path for a project’s state file.

pub fn write_metadata(&self, state: &PersistedProjectState) -> Result<()>

Write metadata to disk with atomic temp + rename.

Errors

Returns an error if:

• The state root cannot be created
• Serialization fails
• File I/O fails

Safety

Uses atomic temp + rename pattern with directory fsync for durability. Temp files are cleaned up on all error paths (fixes LOW finding from review).

pub fn read_metadata( &self, project_id: ProjectId, ) -> Result<Option<PersistedProjectState>>

Read metadata from disk if present and valid.

Returns

• Ok(Some(state)) if valid state was loaded
• Ok(None) if state file doesn’t exist
• Err(_) if file exists but cannot be read/parsed

Errors

Returns an error if the file exists but:

• Cannot be opened
• Cannot be parsed as JSON
• Checksum validation fails