Struct Settings 

pub struct Settings {
    pub managed_root: Option<String>,
    pub targets: Option<Vec<String>>,
    pub model_visibility: ModelVisibility,
    pub models_cache_ttl_hours: u32,
    pub min_mars_version: Option<String>,
    pub default_harness: Option<String>,
    pub default_model: Option<String>,
    pub harness_order: Option<Vec<String>>,
    pub provider_order: Option<Vec<String>>,
    pub agent_emission: Option<AgentEmission>,
    pub model_policies: Vec<ModelPolicyRule>,
}

Global settings — extensible via additional fields.

Fields

managed_root: Option<String>

Custom managed output directory (e.g. “.claude”).

When unset, mars no longer creates a generic .agents target by default; .mars/ is the canonical compiled store and native emission is handled by target-specific compiler paths.

targets: Option<Vec<String>>

Managed target directories materialized from .mars/ canonical store. When set, only listed targets are populated. When unset, managed_root is used for backwards compatibility; otherwise no target-sync targets are enabled by default.

model_visibility: ModelVisibility

models_cache_ttl_hours: u32

min_mars_version: Option<String>

Minimum mars binary version required to use this project. Old binary + new package with this set → compatibility error. New binary + old package without this set → succeeds with defaults.

default_harness: Option<String>

Default harness for launch routing when profile/alias/provider cannot resolve one.

default_model: Option<String>

Project-wide default model token when no CLI override or profile model is set.

harness_order: Option<Vec<String>>

Ordered harness preference for launch-bundle candidate selection.

When set, replaces built-in provider preference ordering for candidate selection. First installed candidate wins.

provider_order: Option<Vec<String>>

Ordered provider preference for model-first routing tie-breaks.

Optional soft preference used only after model-name matching. Empty means preserve harness-reported model order.

agent_emission: Option<AgentEmission>

Controls whether harness-bound agents are emitted to native harness dirs.

auto (the default when unset) emits for standalone mars syncs and suppresses native agent artifacts when Meridian invokes mars with MERIDIAN_MANAGED=1.

model_policies: Vec<ModelPolicyRule>

Implementations

impl Settings

pub fn effective_links(&self) -> EffectiveLinks

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

Returns the effective list of managed target directories.

• If targets is explicitly set, returns those targets normalized through the link migration boundary.
• If targets is unset, uses normalized managed_root for backwards compatibility.
• If neither is set, returns no target-sync targets; .mars/ remains the canonical compiled store.

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

Returns known harness intents from configured links. Generic targets are ignored.

Trait Implementations

impl Clone for Settings

fn clone(&self) -> Settings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Settings

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

Formats the value using the given formatter.

impl Default for Settings

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Settings

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Settings

fn eq(&self, other: &Settings) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Settings

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Settings