Struct StorageLayout 

pub struct StorageLayout { /* private fields */ }

Computes all Synwire storage paths for a given product name.

Configuration hierarchy

1. SYNWIRE_DATA_DIR / SYNWIRE_CACHE_DIR environment variables
2. Programmatic override via StorageLayout::with_root
3. Project-local .<product>/config.json
4. Platform default (directories::BaseDirs)

Implementations

impl StorageLayout

pub fn new(product_name: impl Into<String>) -> Result<Self, StorageError>

Create a new layout for the given product name, respecting environment variables and platform defaults.

Errors

Returns StorageError::NotWritable if the platform provides no usable base directories.

pub fn with_root( root: impl AsRef<Path>, product_name: impl Into<String>, ) -> Self

Create a layout rooted at a custom base directory (for testing or explicit overrides). Data is stored under <root>/data/<product> and caches under <root>/cache/<product>.

pub fn with_config(self, config: &StorageConfig) -> Self

Apply a StorageConfig override on top of this layout.

pub fn data_home(&self) -> &Path

Root durable data directory for this product.

pub fn cache_home(&self) -> &Path

Root cache directory for this product.

pub fn product_name(&self) -> &str

Product name.

pub fn session_db(&self, session_id: &str) -> PathBuf

SQLite checkpoint database for a given session ID.

pub fn experience_db(&self, worktree: &WorktreeId) -> PathBuf

Per-worktree experience pool database.

pub fn skills_dir(&self) -> PathBuf

Global agent skills directory.

pub fn logs_dir(&self) -> PathBuf

Rotating log files directory.

pub fn daemon_pid_file(&self) -> PathBuf

Daemon PID file path.

pub fn daemon_socket(&self) -> PathBuf

Daemon Unix domain socket path.

pub fn global_experience_db(&self) -> PathBuf

Global cross-project experience database.

pub fn global_dependency_db(&self) -> PathBuf

Global cross-project dependency index database.

pub fn global_registry(&self) -> PathBuf

Global project registry JSON file.

pub fn global_config(&self) -> PathBuf

Global product config JSON file.

pub fn index_cache(&self, worktree: &WorktreeId) -> PathBuf

Vector + BM25 index cache directory for a worktree.

pub fn graph_dir(&self, worktree: &WorktreeId) -> PathBuf

Code dependency graph directory for a worktree.

pub fn communities_dir(&self, worktree: &WorktreeId) -> PathBuf

Community detection state directory for a worktree.

pub fn lsp_cache(&self, worktree: &WorktreeId) -> PathBuf

LSP server cache directory for a worktree.

pub fn models_cache(&self) -> PathBuf

Embedding model download cache.

pub fn repos_cache(&self) -> PathBuf

Root directory for cloned repositories.

pub fn repo_cache(&self, owner: &str, repo: &str) -> PathBuf

Directory for a specific cloned repository.

pub fn repo_gc(&self, max_age_days: u64) -> Result<Vec<PathBuf>, StorageError>

Remove cached repositories not accessed within max_age_days.

Returns the list of directories removed. Skips repositories that are currently mounted (not implemented in v0.1).

Errors

Returns StorageError::Io if a directory entry cannot be read or removed.

pub fn project_skills_dirname(&self) -> &str

Name of the project-local skills directory (e.g., .synwire).

pub fn ensure_dir(&self, path: &Path) -> Result<(), StorageError>

Ensure the given directory exists, creating it (and all parents) as needed. Sets permissions to 0o700 on Unix.

Errors

Returns StorageError::Io if the directory cannot be created.

pub fn load_project_config( &self, project_root: &Path, ) -> Result<Option<StorageConfig>, StorageError>

Load a per-project config from <project_root>/.<product>/config.json.

Returns Ok(None) if the file does not exist.

Errors

Returns StorageError::InvalidConfig if the file exists but is not valid JSON.

Trait Implementations

impl Clone for StorageLayout

fn clone(&self) -> StorageLayout

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StorageLayout

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

Formats the value using the given formatter.