agent-trace 0.1.0

Git-backed document memory, trace continuity, and permissioned writes for agent workflows
Documentation 
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
29
30
31
32
33
34
35
36
37
38
39

use anyhow::{Context, Result};
use std::path::{Path, PathBuf};

use super::{
    git::{CommitInfo, GitStore},
    manifest::Manifest,
    permissions::Overrides,
};

/// Bundles GitStore, Manifest, and Overrides for a single store root.
/// Commands should use this instead of opening each component separately.
pub struct Store {
    pub root: PathBuf,
    pub git: GitStore,
    pub manifest: Manifest,
    pub overrides: Overrides,
}

impl Store {
    /// Open an existing store at `root`. Returns an error if not initialized.
    pub fn open(root: &Path) -> Result<Self> {
        let git = GitStore::open(root)
            .with_context(|| format!("Not an agent-trace store: {}", root.display()))?;
        let manifest = Manifest::load(root)
            .with_context(|| format!("Failed to load manifest at {}", root.display()))?;
        let overrides = Overrides::load(root).with_context(|| "Failed to load overrides")?;
        Ok(Self {
            root: root.to_path_buf(),
            git,
            manifest,
            overrides,
        })
    }

    /// Commit changes to the store with a structured commit message.
    pub fn commit(&self, info: &CommitInfo) -> Result<git2::Oid> {
        self.git.commit(info)
    }
}