basemind 0.2.2

Full AI context layer over MCP — tree-sitter code-map, document RAG (PDF/Office/HTML/email + OCR + reranker), shared agent memory, on-demand web crawl, git history + blame + per-symbol diff. 300+ languages, 8 coding-agent harnesses, content-addressed Fjall + LanceDB.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

//! Provenance tagging for a resolved config value. Captures *which layer* of
//! the precedence stack produced each field so introspection (`--help`-style
//! diagnostics, telemetry) can explain why a value is what it is.
//!
//! Precedence — highest wins: `Mcp` > `Cli` > `Env` > `File` > `Default`.

use serde::{Deserialize, Serialize};

/// Origin of a resolved config field. Internal-only — never appears in the
/// JSON Schema (`JsonSchema` deliberately not derived).
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum ConfigSource {
    /// Hard-coded `Default::default()` value.
    Default,
    /// Loaded from `.basemind/basemind.toml`.
    File,
    /// Override pulled from an environment variable (`BASEMIND_*`).
    Env,
    /// Override passed via a CLI flag (`--documents-*`).
    Cli,
    /// Override passed via per-call MCP params (iter 3 — handled inside the tool body).
    Mcp,
}

/// Dotted-path → source map. Keys look like `"documents.reranker.preset"`.
/// `BTreeMap` keeps iteration order deterministic for snapshot tests.
pub type ProvenanceMap = std::collections::BTreeMap<&'static str, ConfigSource>;