Struct Config 

pub struct Config {
    pub settings: Settings,
    pub commands: Commands,
    pub wrappers: WrapperConfig,
    pub git: GitConfig,
    pub cargo: CargoConfig,
    pub kubectl: KubectlConfig,
    pub gh: GhConfig,
    pub project_overlay_path: Option<PathBuf>,
}

Top-level configuration, produced by merging embedded defaults with an optional user overlay from ~/.config/cc-toolgate/config.toml.

Fields

settings: Settings

Global settings (e.g. escalate_deny).

commands: Commands

Flat command-to-decision mappings (allow, ask, deny lists).

wrappers: WrapperConfig

Wrapper commands that execute their arguments as subcommands.

git: GitConfig

Git subcommand-aware evaluation rules.

cargo: CargoConfig

Cargo subcommand-aware evaluation rules.

kubectl: KubectlConfig

kubectl subcommand-aware evaluation rules.

gh: GhConfig

GitHub CLI (gh) subcommand-aware evaluation rules.

project_overlay_path: Option<PathBuf>

Path to the project overlay file, if one was loaded. Set by Config::load() when a project-level .claude/cc-toolgate.toml is found. Used to annotate ASK decisions with provenance.

Implementations

impl Config

pub fn default_config() -> Self

Load the default embedded configuration.

pub fn load() -> Self

Load configuration with resolution order:

1. Start with embedded defaults
2. Merge user overlay from ~/.config/cc-toolgate/config.toml (if exists)
3. Merge project overlay from /.claude/cc-toolgate.toml (if CWD is inside a git repo and the file exists)

Each overlay merges with what’s below it: lists extend, scalars override. Set replace = true in any section to replace its defaults entirely. Use remove_<field> lists to subtract specific items.

When a project overlay is loaded, project_overlay_path is set to the file that was applied. Callers can inspect this to annotate decisions with provenance information.

Trait Implementations

impl Debug for Config

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

Formats the value using the given formatter.

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.