Struct PromptStorageFactory 

pub struct PromptStorageFactory;

Factory for creating domain-scoped prompt storage.

Implementations

impl PromptStorageFactory

pub fn create_for_scope( scope: DomainScope, config: &Config, ) -> Result<Arc<dyn PromptStorage>>

Creates a prompt storage for the given domain scope.

Domain Routing

• Project: SQLite at ~/.config/subcog/memories.db (with repo/branch facets)
• User: SQLite at ~/.config/subcog/memories.db (default)
• Org: SQLite at ~/.config/subcog/orgs/{org}/memories.db

Arguments

• scope - The domain scope
• config - Application configuration

Errors

Returns an error if:

• Org scope is requested but no org identifier can be resolved
• Storage backend cannot be initialized

pub fn create_for_scope_with_subcog_config( scope: DomainScope, config: &SubcogConfig, ) -> Result<Arc<dyn PromptStorage>>

Creates storage for the given scope using full subcog configuration.

Uses the storage settings from the config file when available.

Errors

Returns an error if:

• The storage backend cannot be initialized
• Required paths or connection strings are missing
• The Redis feature is not enabled for Redis backend

fn create_project_storage(_config: &Config) -> Result<Arc<dyn PromptStorage>>

Creates project-scoped storage (SQLite in project directory).

fn create_user_storage(_config: &Config) -> Result<Arc<dyn PromptStorage>>

Creates user-scoped storage based on configuration.

Priority order:

1. SQLite (default)
2. Filesystem (fallback if SQLite fails)

Note: PostgreSQL and Redis support requires explicit backend selection via create_with_backend().

fn create_org_storage(config: &Config) -> Result<Arc<dyn PromptStorage>>

Creates org-scoped storage based on configuration.

Resolves org identifier from:

1. SUBCOG_ORG environment variable
2. Git remote URL (extracts org from github.com/org/repo)
3. Falls back with error if no org can be resolved

Priority order:

1. SQLite (default)
2. Filesystem (fallback if SQLite fails)

fn resolve_org_identifier(config: &Config) -> Result<String>

Resolves the organization identifier.

Priority:

1. SUBCOG_ORG environment variable
2. Git remote URL (extracts org from github.com/org/repo)

fn extract_org_from_repo_path(path: &Path) -> Option<String>

Extracts organization from a git repository’s origin remote.

fn extract_org_from_git_url(url: &str) -> Option<String>

Extracts organization name from a git URL.

Supports:

• https://github.com/org/repo.git
• git@github.com:org/repo.git
• ssh://git@github.com/org/repo.git

pub fn create_with_backend( backend: PromptBackendType, path: Option<PathBuf>, connection_url: Option<String>, ) -> Result<Arc<dyn PromptStorage>>

Creates storage with an explicit backend type.

Arguments

• backend - The backend type to use
• path - Path for file-based backends (repo path for git, db path for SQLite, dir for filesystem)
• connection_url - Connection URL for network backends (PostgreSQL, Redis)

Errors

Returns an error if the backend cannot be initialized.