Module loader 

Unified Configuration Loader

This module handles loading configuration from the unified config file at ~/.config/ralph-workflow.toml, with environment variable overrides.

Configuration Priority

1. Primary source: ~/.config/ralph-workflow.toml
2. Override layer: Environment variables (RALPH_*)
3. CLI arguments: Final override (handled at CLI layer)

Migration Support

For backwards compatibility, the loader also checks legacy config locations (~/.config/ralph/agents.toml and .agent/agents.toml) and emits deprecation warnings when they are used.

Functions

load_config

Load configuration with the unified approach.

load_config_from_path

Load configuration from a specific path or the default location.

load_config_from_path_with_env

Load configuration from a specific path or the default location using a ConfigEnvironment.

unified_config_exists

Check if the unified config file exists.