Struct Git2BlueprintStore 

pub struct Git2BlueprintStore { /* private fields */ }

Git2-backed BlueprintStore — one bare repo per BlueprintId under <root>/<id>/.git/, delegating the mechanical blob/commit work to a shared Git2BlobStore.

Implementations

impl Git2BlueprintStore

pub fn open_or_init(root: impl AsRef<Path>) -> Result<Self, BlueprintStoreError>

Open (or create) the store rooted at root. Per-id repositories are created lazily on first write/read.

pub fn root(&self) -> &Path

The root directory this store was opened with.

Trait Implementations

impl BlueprintStore for Git2BlueprintStore

fn name(&self) -> &str

Backend identifier, for logging / diagnostics (e.g. "git2", "in-memory").

fn read_head<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 BlueprintId, ) -> Pin<Box<dyn Future<Output = Result<Traced<Blueprint>, BlueprintStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Read the current head — the latest commit for this BlueprintId.

fn write_new<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, id: &'life1 BlueprintId, new_bp: &'life2 Blueprint, parents: &'life3 [BlueprintVersion], metadata: CommitMetadata, ) -> Pin<Box<dyn Future<Output = Result<BlueprintVersion, BlueprintStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Append a new Blueprint. Computes the ContentHash and returns the resulting BlueprintVersion.

fn read_version<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 BlueprintId, version: BlueprintVersion, ) -> Pin<Box<dyn Future<Output = Result<Traced<Blueprint>, BlueprintStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Look up a past version — used for audit or debug.

fn history<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 BlueprintId, limit: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<BlueprintVersion>, BlueprintStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

List history newest-to-oldest, up to limit; head included.

fn read_commit_rationale<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 BlueprintId, version: BlueprintVersion, ) -> Pin<Box<dyn Future<Output = Result<Option<String>, BlueprintStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Return the rationale attached to a commit (its CommitMetadata.rationale, a one-line changelog). Backends that cannot recover it return Ok(None); the trait’s default implementation returns None.

fn list_ids<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<BlueprintId>, BlueprintStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List every BlueprintId (relevant when the Layout::Multi axis is in use).

fn archive_id<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 BlueprintId, ) -> Pin<Box<dyn Future<Output = Result<(), BlueprintStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Archive a BlueprintId — logical soft-delete via an archive marker commit. After archive, read_head returns BlueprintStoreError::Archived, list_ids filters the id out by default, and downstream resolvers (e.g. swarm_run(id)) hard-reject with the same error.

fn unarchive_id<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 BlueprintId, ) -> Pin<Box<dyn Future<Output = Result<(), BlueprintStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Reverse of archive_id — append an unarchive marker commit to the main head and re-expose the id.

fn is_archived<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 BlueprintId, ) -> Pin<Box<dyn Future<Output = Result<bool, BlueprintStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Return true if the id is currently archived. Default returns Ok(false) for backends that never archive.