Struct GroveConfig 

pub struct GroveConfig {
    pub version: u32,
    pub mode: Mode,
    pub explore: Option<Value>,
    pub harnesses: Vec<HarnessId>,
}

The grove project configuration, persisted to .grove/config.json.

Construct with GroveConfig::default (mode = mcp, no explore section), then persist with GroveConfig::save.

Fields

version: u32

Wire version. The only valid value today is 1; [validate] rejects other values to ensure future migrations are explicit.

mode: Mode

Which grove integration surface is active.

explore: Option<Value>

Optional mcp-llm explorer configuration, stored as a raw JSON value (opaque to core). The CLI layer (which depends on grove-explore-core) deserializes this into ExploreConfig when it needs typed access. Omitted from the serialized form when None (see skip_serializing_if).

harnesses: Vec<HarnessId>

The coding agents grove init has wired into this project. Defaults to [claude-code] when absent, so pre-multi-harness configs are unchanged.

Implementations

impl GroveConfig

pub fn config_path(root: &Path) -> PathBuf

The canonical config path for a project rooted at root: <root>/.grove/config.json.

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

Read, deserialize, and validate the config under root.

Three-branch cascade:

1. config.json present → read, deserialize, validate (normal path).
2. explore.json present → one-time legacy migration: synthesise a GroveConfig from the old wire shape, write config.json atomically, emit a deprecation warning, and return the config.
3. Neither → actionable grove init error (unchanged).

pub fn save(&self, root: &Path) -> Result<()>

Validate, then persist to <root>/.grove/config.json atomically.

The write goes to a sibling temp file in the same directory and is then renamed into place. Creates .grove/ if absent.

pub fn validate(&self) -> Result<()>

Reject structurally invalid state:

• version must be 1 (the only supported wire version).

Trait Implementations

impl Clone for GroveConfig

fn clone(&self) -> GroveConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GroveConfig

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

Formats the value using the given formatter.

impl Default for GroveConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GroveConfig

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for GroveConfig

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for GroveConfig

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 GroveConfig