Module config 

Configuration resolution for Ralph, including global and project layers.

Responsibilities:

• Resolve configuration from multiple layers: global config, project config, and defaults.
• Load and parse config files (JSON with JSONC comment support via load_layer).
• Merge configuration layers via ConfigLayer and apply_layer.
• Validate configuration values (version, paths, numeric ranges, runner binaries).
• Resolve queue/done file paths and ID generation settings (prefix, width).
• Discover repository root via .ralph/ directory or .git/.

Not handled here:

• CLI argument parsing (see crate::cli).
• Queue operations like task CRUD (see crate::queue).
• Runner execution or agent invocation (see crate::runner).
• Prompt rendering or template processing (see crate::prompts_internal).
• Lock management (see crate::lock).

Invariants/assumptions:

• Config version must be 2; unsupported versions are rejected.
• Paths are resolved relative to repo root unless absolute.
• Global config resolves from ~/.config/ralph/config.jsonc.
• Project config resolves from .ralph/config.jsonc.
• Config layers are applied in this order: defaults, then global, then project (later layers override earlier ones).
• save_layer creates parent directories automatically if needed.

Structs

ConfigLayer

RepoTrust

Local trust file for execution-sensitive project configuration.

Resolved

Resolved configuration including computed paths.

Enums

TrustFileInitStatus

Outcome of initialize_repo_trust_file.

Functions

apply_layer

Apply a config layer on top of a base config. Later layers override earlier ones using leaf-wise merge semantics.

find_repo_root

Find the repository root starting from a given path.

git_ref_invalid_reason

global_config_path

Get the path to the global config file.

initialize_repo_trust_file

Create or update .ralph/trust.jsonc so RepoTrust::is_trusted becomes true.

load_layer

Load a config layer from a JSON/JSONC file.

load_repo_trust

Load repo trust if present, otherwise return the default untrusted state.

project_config_path

Get the path to the project config file for a given repo root.

project_trust_path

Preferred local trust path for a repository root.

resolve_done_path

Resolve the done file path from config.

resolve_from_cwd

Resolve configuration from the current working directory.

resolve_from_cwd_for_doctor

Resolve config for the doctor command, skipping instruction_files validation. This allows doctor to diagnose and warn about missing files without failing early.

resolve_from_cwd_skipping_project_execution_trust

Resolve like resolve_from_cwd, but skip project-layer execution trust validation.

resolve_from_cwd_with_profile

Resolve config with an optional profile selection.

resolve_id_prefix

Resolve the queue ID prefix from config.

resolve_id_width

Resolve the queue ID width from config.

resolve_queue_path

Resolve the queue file path from config.

save_layer

Save a config layer to a JSON file. Automatically sets version to 2 if not specified and creates parent directories.

validate_agent_binary_paths

validate_agent_patch

validate_config

validate_project_execution_trust

validate_queue_done_file_override

validate_queue_file_override

validate_queue_id_prefix_override

validate_queue_id_width_override

validate_queue_overrides