Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

4.5 KB
Raw Blame
//! Git module config types loaded from the [git] section of the binding TOML.

use serde::Deserialize;

#[derive(Debug, Clone, Deserialize)]
pub struct GitConfig {
    #[serde(default)]
    pub enabled: bool,
    #[serde(default = "default_backend")]
    pub backend: String,
    #[serde(default = "default_branch")]
    pub default_branch: String,
    #[serde(default = "default_author_name")]
    pub author_name: String,
    #[serde(default = "default_author_email")]
    pub author_email: String,

    #[serde(default)]
    pub local: Option<GitLocalConfig>,
    #[serde(default)]
    pub s3: Option<GitS3ConfigPy>,

    #[serde(default)]
    pub tuning: GitTuningConfig,
}

#[derive(Debug, Clone, Deserialize)]
pub struct GitLocalConfig {
    pub base_dir: String,
}

#[derive(Debug, Clone, Deserialize)]
pub struct GitS3ConfigPy {
    pub bucket: String,
    #[serde(default = "default_s3_prefix")]
    pub prefix: String,
    pub region: String,
    #[serde(default)]
    pub endpoint: String,
    #[serde(default)]
    pub access_key: Option<String>,
    #[serde(default)]
    pub secret_key: Option<String>,
    #[serde(default = "default_cas_mode")]
    pub cas_mode: String,
    #[serde(default)]
    pub redis_lock_url: Option<String>,
    #[serde(default = "default_true")]
    pub use_path_style: bool,
}

#[derive(Debug, Clone, Deserialize)]
pub struct GitTuningConfig {
    /// Enable Fast Path 1: skip read+SHA-1 for files whose `(size, mtime_ns)`
    /// match the previous commit's persisted index. Defaults to `true`; set
    /// to `false` to force the slow path on every commit (useful for tests
    /// and for environments with unreliable mtimes).
    #[serde(default = "default_true")]
    pub commit_index_enabled: bool,
    /// Enable Fast Path 3: on the commit slow path, run an `exists()` precheck
    /// before compressing and putting a blob, skipping the write when the
    /// object already exists. Defaults to `true`. `put` is idempotent, so this
    /// only affects backend call counts, never commit results.
    #[serde(default = "default_true")]
    pub blob_exists_precheck_enabled: bool,
}

impl Default for GitTuningConfig {
    fn default() -> Self {
        Self {
            commit_index_enabled: default_true(),
            blob_exists_precheck_enabled: default_true(),
        }
    }
}

fn default_backend() -> String {
    "local".to_string()
}
fn default_branch() -> String {
    "main".to_string()
}
fn default_author_name() -> String {
    "openviking-bot".to_string()
}
fn default_author_email() -> String {
    "[email protected]".to_string()
}
fn default_s3_prefix() -> String {
    ".ovgit".to_string()
}
fn default_cas_mode() -> String {
    "native".to_string()
}
fn default_true() -> bool {
    true
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn parses_minimal_local_config() {
        let toml_src = r#"
            enabled = true
            backend = "local"

            [local]
            base_dir = "/tmp/ov-git"
        "#;
        let cfg: GitConfig = toml::from_str(toml_src).unwrap();
        assert!(cfg.enabled);
        assert_eq!(cfg.backend, "local");
        assert_eq!(cfg.default_branch, "main");
        assert_eq!(cfg.author_name, "openviking-bot");
        assert_eq!(cfg.author_email, "[email protected]");
        assert_eq!(cfg.local.as_ref().unwrap().base_dir, "/tmp/ov-git");
        assert!(cfg.s3.is_none());
        assert!(cfg.tuning.commit_index_enabled);
        assert!(cfg.tuning.blob_exists_precheck_enabled);
    }

    #[test]
    fn parses_s3_config_with_overrides() {
        let toml_src = r#"
            enabled = true
            backend = "s3"
            default_branch = "trunk"
            author_name = "alice"
            author_email = "[email protected]"

            [s3]
            bucket = "ov-bucket"
            region = "us-west-2"
            endpoint = "https://s3.example.com"
            access_key = "AKxxx"
            secret_key = "SKxxx"

        "#;
        let cfg: GitConfig = toml::from_str(toml_src).unwrap();
        assert_eq!(cfg.backend, "s3");
        assert_eq!(cfg.default_branch, "trunk");
        let s3 = cfg.s3.as_ref().unwrap();
        assert_eq!(s3.bucket, "ov-bucket");
        assert_eq!(s3.prefix, ".ovgit");
        assert_eq!(s3.region, "us-west-2");
        assert_eq!(s3.cas_mode, "native");
        assert!(cfg.tuning.commit_index_enabled);
    }

    #[test]
    fn defaults_when_section_minimal() {
        let cfg: GitConfig = toml::from_str("").unwrap();
        assert!(!cfg.enabled);
        assert_eq!(cfg.backend, "local");
    }
}