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_from_path(path: &Path) -> Result<Self, ConfigLoadError>

Load unified configuration from a specific 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_at(path: &Path) -> Result<ConfigInitResult>

Ensure a config file exists at the specified path.

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.