Struct UnifiedConfig 

pub struct UnifiedConfig {
    pub general: GeneralConfig,
    pub ccs: CcsConfig,
    pub agents: HashMap<String, AgentConfigToml>,
    pub ccs_aliases: CcsAliases,
    pub agent_chain: Option<FallbackConfig>,
}

Unified configuration file structure.

This is the sole source of truth for Ralph configuration, located at ~/.config/ralph-workflow.toml.

Fields

general: GeneralConfig

General settings.

ccs: CcsConfig

CCS defaults for aliases.

agents: HashMap<String, AgentConfigToml>

Agent definitions (used via serde deserialization for future expansion).

ccs_aliases: CcsAliases

CCS alias mappings.

agent_chain: Option<FallbackConfig>

Agent chain configuration.

When omitted, Ralph uses built-in defaults.

Implementations

impl UnifiedConfig

pub fn load_default() -> Option<Self>

Load unified configuration from the default path.

Returns None if the file doesn’t exist.

pub fn load_with_env(env: &dyn ConfigEnvironment) -> Option<Self>

Load unified configuration using a [ConfigEnvironment].

This is the testable version of [load_default]. It reads from the unified config path as determined by the environment.

Returns None if no config path is available or the file doesn’t exist.

pub fn load_from_path(path: &Path) -> Result<Self, ConfigLoadError>

Load unified configuration from a specific path.

Note: This method uses std::fs directly. For testable code, use [load_from_path_with_env] with a [ConfigEnvironment] instead.

pub fn load_from_path_with_env( path: &Path, env: &dyn ConfigEnvironment, ) -> Result<Self, ConfigLoadError>

Load unified configuration from a specific path using a [ConfigEnvironment].

This is the testable version of [load_from_path].

pub fn ensure_config_exists() -> Result<ConfigInitResult>

Ensure unified config file exists, creating it from template if needed.

This creates ~/.config/ralph-workflow.toml with the default template if it doesn’t already exist.

pub fn ensure_config_exists_with_env( env: &dyn ConfigEnvironment, ) -> Result<ConfigInitResult>

Ensure unified config file exists using a [ConfigEnvironment].

This is the testable version of [ensure_config_exists].

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

Ensure a config file exists at the specified path.

pub fn ensure_config_exists_at_with_env( path: &Path, env: &dyn ConfigEnvironment, ) -> Result<ConfigInitResult>

Ensure a config file exists at the specified path using a [ConfigEnvironment].

This is the testable version of [ensure_config_exists_at].

Trait Implementations

impl Clone for UnifiedConfig

fn clone(&self) -> UnifiedConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UnifiedConfig

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

Formats the value using the given formatter.

impl Default for UnifiedConfig

fn default() -> UnifiedConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for UnifiedConfig

where UnifiedConfig: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.