Struct ConfigResolver 

pub struct ConfigResolver { /* private fields */ }

Manages loading and merging of all configuration layers.

Resolution order: System → User → Project → Session Higher precedence layers override lower precedence layers.

Implementations

impl ConfigResolver

pub fn new(dir_context: DirectoryContext, working_dir: PathBuf) -> Self

Create a new ConfigResolver for a working directory.

pub fn resolve(&self) -> Result<Config, ConfigError>

Load all layers and merge them into a resolved Config.

Layers are merged from highest to lowest precedence: Session > Project > UserPlatform > User > System

Each layer fills in values missing from higher precedence layers.

pub fn user_config_path(&self) -> PathBuf

Get the path to user config file.

pub fn project_config_path(&self) -> PathBuf

Get the path to project config file. Checks new location first (.fresh/config.json), falls back to legacy (config.json).

pub fn project_config_write_path(&self) -> PathBuf

Get the preferred path for writing project config (new location).

pub fn session_config_path(&self) -> PathBuf

Get the path to session config file.

pub fn user_platform_config_path(&self) -> Option<PathBuf>

Get the path to platform-specific user config file.

pub fn load_user_layer(&self) -> Result<Option<PartialConfig>, ConfigError>

Load the user layer from disk.

pub fn load_user_platform_layer( &self, ) -> Result<Option<PartialConfig>, ConfigError>

Load the platform-specific user layer from disk.

pub fn load_project_layer(&self) -> Result<Option<PartialConfig>, ConfigError>

Load the project layer from disk.

pub fn load_session_layer(&self) -> Result<Option<PartialConfig>, ConfigError>

Load the session layer from disk.

pub fn save_to_layer( &self, config: &Config, layer: ConfigLayer, ) -> Result<(), ConfigError>

Save a config to a specific layer, writing only the delta from parent layers.

pub fn save_to_layer_with_baseline( &self, current: &Config, baseline: &Config, layer: ConfigLayer, ) -> Result<(), ConfigError>

Save a config to a specific layer, using a baseline to track changes.

This solves the problem where save_to_layer can’t distinguish between:

• “User didn’t change this field” (should preserve external edits)
• “User changed this field to the default” (should update the file)

By comparing current against baseline (what was loaded), we know exactly which fields the user modified. Those fields are updated even if they match defaults; untouched fields preserve any external edits to the file.

pub fn save_changes_to_layer( &self, changes: &HashMap<String, Value>, deletions: &HashSet<String>, layer: ConfigLayer, ) -> Result<(), ConfigError>

Save specific changes to a layer file using JSON pointer paths.

This reads the existing file, applies only the specified changes, and writes back. This preserves any manual edits not touched by the changes.

pub fn save_session(&self, session: &SessionConfig) -> Result<(), ConfigError>

Save a SessionConfig to the session layer file.

pub fn load_session(&self) -> Result<SessionConfig, ConfigError>

Load the session config from disk, or return an empty one if it doesn’t exist.

pub fn clear_session(&self) -> Result<(), ConfigError>

Clear the session config file on editor exit.

pub fn get_layer_sources( &self, ) -> Result<HashMap<String, ConfigLayer>, ConfigError>

Determine which layer each setting value comes from. Returns a map of JSON pointer paths to their source layer.