Struct Config 

pub struct Config {
    pub save: SaveConfig,
    pub display: DisplayConfig,
    pub defaults: DefaultsConfig,
    pub cache: CacheConfig,
    pub watch: WatchConfig,
    pub mcp: McpConfig,
}

Top-level configuration.

Fields

save: SaveConfig

Save file configuration.

display: DisplayConfig

Display preferences.

defaults: DefaultsConfig

Default values for commands.

cache: CacheConfig

Cache settings.

watch: WatchConfig

File watcher settings.

mcp: McpConfig

MCP server settings.

Implementations

impl Config

pub fn load() -> Result<Self, ConfigError>

Load config from the default path (~/.nms-copilot/config.toml).

Returns the default config if the file doesn’t exist. Returns an error if the file exists but can’t be parsed.

pub fn load_from(path: &Path) -> Result<Self, ConfigError>

Load config from a specific path.

pub fn apply_env_overrides(&mut self)

Apply environment variable overrides to the config.

Reads:

• NMS_SAVE_DIR -> self.save.dir
• NMS_SAVE_FILE -> self.save.file
• NMS_SAVE_FORMAT -> self.save.format

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

Resolve the effective save file path from all configured sources.

Priority:

1. save.file (explicit file path)
2. save.path if it points to a file (backward compat)
3. save.dir — find most recent save in that directory
4. save.path if it points to a directory (backward compat)
5. None if nothing is configured or resolvable

pub fn cache_path_for(&self, save_path: Option<&Path>) -> PathBuf

Resolve the effective cache path.

If cache.path is explicitly set in config, uses that (single override). Otherwise, derives a per-save cache path from the save file path: ~/.nms-copilot/<account_dir>/<save_stem>/galaxy.rkyv. Falls back to the legacy ~/.nms-copilot/galaxy.rkyv if no save path given.

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

Resolve the effective save path (if configured).

Delegates to [effective_save_file]. For backward compatibility, also checks the legacy save.path field.

pub fn cache_enabled(&self) -> bool

Whether caching is enabled.

pub fn watch_enabled(&self) -> bool

Whether file watching is enabled.

pub fn watch_debounce(&self) -> Duration

The configured debounce duration for file watching.

pub fn mcp_http_addr(&self) -> SocketAddr

The configured MCP HTTP bind address.

Trait Implementations

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Config

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

where Config: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.