Struct ContextTemplateService 

pub struct ContextTemplateService {
    config: SubcogConfig,
    storage_cache: HashMap<DomainScope, Arc<dyn ContextTemplateStorage>>,
    renderer: TemplateRenderer,
}

Service for context template CRUD operations and rendering.

Fields

config: SubcogConfig

Full subcog configuration.

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

Cached storage backends per domain.

renderer: TemplateRenderer

Template renderer instance.

Implementations

impl ContextTemplateService

pub fn new() -> Self

Creates a new context template service with default configuration.

pub fn with_config(config: SubcogConfig) -> Self

Creates a new context template service with custom configuration.

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

Gets the storage backend for a domain scope.

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

Saves a context template, auto-incrementing the version.

Arguments

• template - The context template to save
• domain - The domain scope to save in (defaults to User)

Returns

A tuple of (name, version) for the saved template.

Errors

Returns an error if:

• The template name is empty or invalid
• Storage fails

pub fn save_default( &mut self, template: &ContextTemplate, ) -> Result<(String, u32)>

Saves a context template to the default domain (User).

Errors

Returns an error if the template name is invalid or storage fails.

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

Gets a context template by name and optional version.

Arguments

• name - The template name to search for
• version - Optional version number (None = latest)
• domain - Optional domain to search (if None, searches User then Project)

Returns

The context template if found.

Errors

Returns an error if storage access fails.

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

Lists context templates matching the filter.

Returns only the latest version of each template.

Errors

Returns an error if storage access fails.

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

Deletes a context template by name and optional version.

Arguments

• name - The template name to delete
• version - Optional version (None = delete all versions)
• domain - The domain scope to delete from

Returns

true if any versions were deleted.

Errors

Returns an error if storage access fails.

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

Gets all available versions for a template.

Errors

Returns an error if storage access fails.

pub fn render_with_memories( &mut self, template_name: &str, version: Option<u32>, memories: &[Memory], statistics: &MemoryStatistics, custom_vars: &HashMap<String, String>, format: Option<OutputFormat>, ) -> Result<RenderResult>

Renders a template with memories and statistics.

This is the main entry point for template rendering. It:

1. Retrieves the template by name/version
2. Builds a render context with auto-variables populated
3. Renders the template with variable substitution and iteration
4. Converts to the requested output format

Arguments

• template_name - Name of the template to render
• version - Optional version (None = latest)
• memories - List of memories to include
• statistics - Memory statistics
• custom_vars - Custom user-defined variables
• format - Output format (or None to use template default)

Returns

A RenderResult containing the rendered output.

Errors

Returns an error if:

• Template not found
• Required user variables not provided
• Rendering fails

pub fn render_direct( &self, template: &ContextTemplate, memories: &[Memory], statistics: &MemoryStatistics, custom_vars: &HashMap<String, String>, format: Option<OutputFormat>, ) -> Result<String>

Renders a template directly (without loading from storage).

Useful for preview/dry-run scenarios.

Errors

Returns an error if rendering fails or required variables are missing.

fn build_render_context( &self, memories: &[Memory], statistics: &MemoryStatistics, custom_vars: &HashMap<String, String>, template: &ContextTemplate, ) -> Result<RenderContext>

Builds a render context with auto-variables populated.

pub fn validate(&self, template: &ContextTemplate) -> Result<ValidationResult>

Validates template content without saving.

Checks for:

• Valid variable syntax
• Balanced iteration blocks
• Known auto-variables

Errors

This function currently does not return errors (returns Ok with validation result).

Trait Implementations

impl Default for ContextTemplateService

fn default() -> Self

Returns the “default value” for a type.