Struct ConfigLoader 

pub struct ConfigLoader {
    pub paths: ConfigPaths,
    /* private fields */
}

Configuration loader that handles tier-based merging.

Fields

paths: ConfigPaths

Paths for each tier

Implementations

impl ConfigLoader

pub fn find_file(&self, relative_path: &str) -> Option<ResolvedFile>

Find a file by relative path, searching from highest tier to lowest.

Returns the first file found, or None if not found in any tier.

pub fn find_file_path(&self, relative_path: &str) -> Option<PathBuf>

Find a file, returning the path if found on disk.

pub fn file_exists(&self, relative_path: &str) -> bool

Check if a file exists in any tier.

pub fn file_tier(&self, relative_path: &str) -> Option<ConfigTier>

Get the tier where a file would be found.

pub fn list_files(&self, relative_dir: &str) -> Vec<(String, FileSource)>

List files in a directory across all tiers.

Returns a deduplicated list where higher-tier files shadow lower-tier ones.

impl ConfigLoader

pub fn load() -> Result<Self>

Load configuration from all tiers with proper merging.

pub fn load_with_paths(paths: ConfigPaths) -> Result<Self>

Load configuration with explicit paths.

pub fn load_prompts(&self) -> Prompts

Load prompts configuration with tier merging.

pub fn load_workflows(&self) -> WorkflowsConfig

Load workflows configuration with tier merging.

Loads from embedded defaults, then project workflows.yaml, then user workflows.yaml. Later tiers override earlier ones (objects are deep-merged, prompts are replaced).

pub fn config(&self) -> &Config

Get the loaded configuration.

pub fn config_mut(&mut self) -> &mut Config

Get mutable access to the configuration.

pub fn into_config(self) -> Config

Consume the loader and return the configuration.

pub fn config_path(&self) -> Option<&Path>

Get the config file path that was used.

pub fn is_using_deprecated(&self) -> bool

Check if using deprecated paths.

pub fn project_dir(&self) -> Option<&Path>

Get the effective project directory.

pub fn user_dir(&self) -> Option<&Path>

Get the user directory.

pub fn skills_dir(&self) -> PathBuf

Get the skills directory, checking all tiers.

pub fn load_workflow_by_name(&self, name: &str) -> Result<WorkflowsConfig>

Load a named workflow file (workflow-{name}.yaml).

Searches in order: user directory, project directory, install directory, embedded. User overrides project, project overrides install, install overrides embedded. Returns the merged workflow config (defaults + named workflow).

pub fn list_workflows(&self) -> Vec<String>

List available named workflows.

Returns workflow names (e.g., “solo”, “swarm”) found in user, project, install directories, and embedded defaults. Embedded workflows are always available as fallbacks.

pub fn list_overlays(&self) -> Vec<String>

List available overlay files (overlay-*.yaml).

Returns overlay names (e.g., “git”, “troubleshooting”) found in user, project, install directories, and embedded defaults. Embedded overlays are always available as fallbacks.

pub fn load_overlay_by_name(&self, name: &str) -> Result<WorkflowsConfig>

Load an overlay by name (overlay-{name}.yaml).

Unlike load_workflow_by_name, overlays are loaded as raw deltas WITHOUT merging with defaults. This prevents double-appending prompts when the overlay is later applied via apply_overlay().

Searches in order: user directory, project directory, install directory, embedded.

Trait Implementations

impl Clone for ConfigLoader

fn clone(&self) -> ConfigLoader

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConfigLoader

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

Formats the value using the given formatter.