Struct PathManager 

pub struct PathManager {
    base_dir: PathBuf,
    subcog_dir: PathBuf,
}

Manages storage paths for subcog backends.

PathManager provides a centralized way to construct paths for:

• SQLite index databases
• Vector similarity indices
• The user-level data directory

Project scope uses the user-level data directory with project facets.

Fields

base_dir: PathBuf

Base directory for storage (user data dir).

subcog_dir: PathBuf

The subcog data directory (same as base dir).

Implementations

impl PathManager

pub fn for_repo(_repo_root: impl AsRef<Path>) -> Self

Creates a PathManager for repository-scoped storage.

Storage paths will be within the user data directory. Falls back to a temporary user-level directory if the user data dir cannot be resolved.

Arguments

• repo_root - Path to the git repository root

Examples

let manager = PathManager::for_repo(Path::new("/home/user/project"));
// Uses user data directory, not repo-local storage

pub fn for_user(user_data_dir: impl AsRef<Path>) -> Self

Creates a PathManager for user-scoped storage.

Storage paths will be directly within the user data directory (no .subcog subdirectory).

Arguments

• user_data_dir - Platform-specific user data directory

Examples

let manager = PathManager::for_user(Path::new("/home/user/.local/share/subcog"));
assert_eq!(manager.subcog_dir(), Path::new("/home/user/.local/share/subcog"));

pub fn base_dir(&self) -> &Path

Returns the base directory (user data dir).

pub fn subcog_dir(&self) -> &Path

Returns the subcog data directory.

For project/user scope: {user_data_dir} (same as base)

pub fn index_path(&self) -> PathBuf

Returns the path to the SQLite index database.

Returns

{subcog_dir}/index.db

pub fn vector_path(&self) -> PathBuf

Returns the path to the vector similarity index.

Returns

{subcog_dir}/vectors.idx

pub fn graph_path(&self) -> PathBuf

Returns the path to the graph SQLite database.

Returns

{subcog_dir}/graph.db

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

Ensures the subcog directory exists.

Creates the directory and any necessary parent directories.

Errors

Returns an error if directory creation fails due to permissions or other filesystem issues.

Examples

let manager = PathManager::for_repo(Path::new("/path/to/repo"));
manager.ensure_subcog_dir()?;
// Now safe to create backends at manager.index_path() and manager.vector_path()

pub fn ensure_parent_dir(path: &Path) -> Result<()>

Ensures the parent directory of a path exists.

Useful for ensuring index or vector file parents exist before creating backends.

Arguments

• path - The path whose parent should be created

Errors

Returns an error if directory creation fails.

Trait Implementations

impl Clone for PathManager

fn clone(&self) -> PathManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathManager

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

Formats the value using the given formatter.