Struct Config 

pub struct Config {
    pub agents: Vec<AgentSpec>,
    pub roles: Roles,
    pub graph: Graph,
    pub blind: Blind,
    pub verify: Verify,
    pub merge: Merge,
    pub update: Update,
    pub prompts: Prompts,
    pub notify: Notify,
    pub repos: Repos,
}

Top-level configuration.

Fields

agents: Vec<AgentSpec>

Agent roster.

roles: Roles

Role assignment.

graph: Graph

Graph shape.

blind: Blind

Blindness policy.

verify: Verify

Verification commands.

merge: Merge

Merge policy.

update: Update

Self-update policy.

prompts: Prompts

Project-specific text appended to the node prompts.

notify: Notify

How the operator is told a run is waiting on them.

repos: Repos

Local repositories the plan surface can start or derive a conversation against.

Implementations

impl Config

pub const CONFIG_DIR_ENV: &str = "MAGI_CONFIG_DIR"

Environment variable that relocates the machine-wide config layer.

Set it to a directory and magi reads <dir>/magi/config.toml instead of the one under dirs::config_dir; set it to the empty string and magi reads no machine layer at all.

This exists because the machine layer is otherwise unavoidable, and a test that builds a config fixture is not asking for the operator’s preferences to be merged into it. Adding [repos] roots to the real machine config on a development box turned two passing tests red - repos_list_returns_name_and_path_for_every_configured_root and repos_list_only_rescans_within_the_ttl_when_asked_to, whose fixtures declare [repos] roots of their own, which Config::layers then found in two layers and Config::refuse_split_arrays correctly refused. CI never saw it: a runner has no machine config, so the suite was green there and red only where somebody actually uses magi.

An operator gets the same escape hatch for free: a second machine config, or none, without moving files about.

pub fn load(path: &Path) -> Result<Self>

Load one file through teravars: Tera rendering, [vars] resolution, and the include = [...] directive.

pub fn load_layers(paths: &[PathBuf]) -> Result<Self>

Load and deep-merge a stack of config files, later files winning.

This is why the config is TOML-through-teravars rather than plain serde: the roster is a machine fact (which CLIs and plans you pay for) while the gate is a repository fact (cargo make check here, pnpm test there). Picking one file and ignoring the other would force every repo to restate the roster.

pub fn discover( repo: &Path, explicit: Option<&Path>, ) -> Result<(Self, Vec<PathBuf>)>

Resolve the config for repo, honouring an explicit --config path.

Returns the config and the layers it came from, empty for built-in defaults.

pub fn layers(repo: &Path) -> Vec<PathBuf>

Every config layer that applies to repo, in increasing precedence.

The machine layer is whatever Config::machine_layer resolves to, which is nothing at all in a test build.

pub fn autodetected() -> Self

Built-in config whose roster is the agent CLIs found on PATH.

pub fn agent(&self, id: &str) -> Result<&AgentSpec>

Look an agent up by id.

pub fn resolve_roles(&self) -> Result<ResolvedRoles>

Fill the roles out to the configured widths.

An empty role list rotates through the whole roster, so a three-agent roster with candidates = 3 gives one implementation per agent, and judges = 3 rotates the judge seats by one so that judge i is not the author of candidate i whenever the roster has more than one agent.

pub fn shell(&self) -> Vec<String>

Shell prefix for Verify commands.

pub fn starter_toml() -> String

Starter config, as written by magi init.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

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.

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.