Struct ArtifactStore 

pub struct ArtifactStore { /* private fields */ }

A content-addressed store of generated outputs, rooted at a directory. The in-memory index is populated lazily on first access, so read methods take &mut self.

Implementations

impl ArtifactStore

pub fn new(root: &Path) -> Self

A store rooted at root (created lazily on first write).

pub fn store( &mut self, draft: ArtifactDraft, ) -> Result<Artifact, ArtifactStoreError>

Store draft, writing its bytes (deduplicated), optional preview, and a provenance sidecar, and return the resulting record.

pub fn list(&mut self) -> Result<Vec<Artifact>, ArtifactStoreError>

Every artifact, newest first by (created_at, id).

pub fn get(&mut self, id: &str) -> Result<Option<Artifact>, ArtifactStoreError>

The artifact with id, if stored.

pub fn url(&mut self, id: &str) -> Result<Option<PathBuf>, ArtifactStoreError>

The absolute path to id’s output file, if stored.

pub fn preview_data( &mut self, id: &str, ) -> Result<Option<Vec<u8>>, ArtifactStoreError>

The bytes of id’s preview, if it has one.

pub fn delete(&mut self, id: &str) -> Result<(), ArtifactStoreError>

Delete id: remove its sidecar always, and its output/preview files only when no surviving artifact still references them (deduplicated files stay until their last owner is gone). Files are unlinked permanently.