Struct PromptService 

pub struct PromptService {
    config: Config,
    subcog_config: Option<SubcogConfig>,
    storage_cache: HashMap<DomainScope, Arc<dyn PromptStorage>>,
}

Service for prompt template CRUD operations.

Uses PromptStorageFactory to get domain-scoped storage backends.

Fields

config: Config

Simple configuration (for backwards compatibility).

subcog_config: Option<SubcogConfig>

Full subcog configuration (for storage config).

storage_cache: HashMap<DomainScope, Arc<dyn PromptStorage>>

Cached storage backends per domain.

Implementations

impl PromptService

pub fn new(config: Config) -> Self

Creates a new prompt service.

pub fn with_subcog_config(subcog_config: SubcogConfig) -> Self

Creates a new prompt service with full subcog configuration.

This allows the service to use storage settings from the config file.

pub fn with_repo_path(self, path: impl Into<PathBuf>) -> Self

Creates a prompt service with a repository path.

pub fn set_repo_path(&mut self, path: impl Into<PathBuf>)

Sets the repository path.

fn get_storage(&mut self, domain: DomainScope) -> Result<Arc<dyn PromptStorage>>

Gets the storage backend for a domain scope.

pub fn save( &mut self, template: &PromptTemplate, domain: DomainScope, ) -> Result<String>

Saves or updates a prompt template.

Arguments

• template - The prompt template to save
• domain - The domain scope to save in (defaults to Project)

Returns

The unique ID of the saved prompt.

Errors

Returns an error if:

• The template name is empty or invalid
• Storage fails

Example

use subcog::services::PromptService;
use subcog::models::PromptTemplate;
use subcog::storage::index::DomainScope;

let mut service = PromptService::new(Default::default());
let template = PromptTemplate::new("code-review", "Review {{code}}");
let id = service.save(&template, DomainScope::Project)?;

pub fn save_with_enrichment<P: LlmProvider>( &mut self, name: &str, content: &str, domain: DomainScope, options: &SaveOptions, llm: Option<P>, existing: Option<PartialMetadata>, ) -> Result<SaveResult>

Saves a prompt with LLM-powered enrichment.

This method extracts variables from the content, optionally enriches with LLM-generated metadata (descriptions, tags, variable info), and saves the template.

Arguments

• name - Prompt name (kebab-case).
• content - The prompt template content.
• domain - Domain scope to save in.
• options - Save options (skip enrichment, dry run).
• llm - Optional LLM provider for enrichment.
• existing - Optional existing metadata to preserve.

Returns

A SaveResult containing the saved template and enrichment status.

Errors

Returns an error if the name is invalid or storage fails. Enrichment failures are gracefully handled with fallback.

pub fn get( &mut self, name: &str, domain: Option<DomainScope>, ) -> Result<Option<PromptTemplate>>

Gets a prompt by name, searching domain hierarchy.

Searches in priority order: Project → User → Org

Arguments

• name - The prompt name to search for
• domain - Optional domain to search (if None, searches all)

Returns

The prompt template if found.

Errors

Returns an error if storage operations fail.

pub fn list(&mut self, filter: &PromptFilter) -> Result<Vec<PromptTemplate>>

Lists prompts matching the filter.

Arguments

• filter - Filter criteria

Returns

List of matching prompt templates.

Errors

Returns an error if storage operations fail.

pub fn delete(&mut self, name: &str, domain: DomainScope) -> Result<bool>

Deletes a prompt by name.

Arguments

• name - The prompt name to delete
• domain - The domain scope to delete from

Returns

true if the prompt was found and deleted.

Errors

Returns an error if storage operations fail.

pub fn search( &mut self, query: &str, limit: usize, ) -> Result<Vec<PromptTemplate>>

Searches prompts semantically by query.

Arguments

• query - The search query
• limit - Maximum results

Returns

List of matching prompt templates, ordered by relevance.

Errors

Returns an error if storage operations fail.

pub fn increment_usage(&mut self, name: &str, domain: DomainScope) -> Result<()>

Increments the usage count for a prompt.

Arguments

• name - The prompt name
• domain - The domain scope

Errors

Returns an error if the prompt is not found or storage fails.

fn matches_filter( &self, template: &PromptTemplate, filter: &PromptFilter, ) -> bool

Checks if a template matches the filter.

fn calculate_relevance(&self, template: &PromptTemplate, query: &str) -> f32

Calculates relevance score for search.

Trait Implementations

impl Default for PromptService

fn default() -> Self

Returns the “default value” for a type.