Struct JsonFileStore 

pub struct JsonFileStore { /* private fields */ }

File-backed stage store. Persists to JSON on every mutation. Loads stdlib on first creation, then reads from disk on subsequent runs.

Implementations

impl JsonFileStore

pub fn open(path: impl Into<PathBuf>) -> Result<Self, StoreError>

Open or create a store at the given path. If the file exists, loads from it. Otherwise creates an empty store.

pub fn len(&self) -> usize

Number of stages in the store.

pub fn is_empty(&self) -> bool

Trait Implementations

impl StageStore for JsonFileStore

fn put(&mut self, stage: Stage) -> Result<StageId, StoreError>

fn upsert(&mut self, stage: Stage) -> Result<StageId, StoreError>

Insert a stage, replacing any existing stage with the same ID. Used to upgrade unsigned stdlib stages after signing is added.

fn remove(&mut self, id: &StageId) -> Result<(), StoreError>

Remove a stage entirely. Returns Ok(()) whether or not the stage existed.

fn get(&self, id: &StageId) -> Result<Option<&Stage>, StoreError>

fn contains(&self, id: &StageId) -> bool

fn list(&self, lifecycle: Option<&StageLifecycle>) -> Vec<&Stage>

fn update_lifecycle( &mut self, id: &StageId, lifecycle: StageLifecycle, ) -> Result<(), StoreError>

fn stats(&self) -> StoreStats

fn get_owned(&self, id: &StageId) -> Result<Option<Stage>, StoreError>

Return an owned clone of the stage. Useful for async contexts where holding a borrow across lock boundaries is not permitted.

fn list_owned(&self, lifecycle: Option<&StageLifecycle>) -> Vec<Stage>

Return owned clones of all matching stages.

fn find_by_name(&self, name: &str) -> Vec<&Stage>

Find all stages whose metadata name field matches exactly. Used by graph loaders so composition files can reference stages by their human-authored name instead of their 8-char content-hash prefix. Returns every match across all lifecycles; callers typically filter for Active.

fn get_by_signature(&self, signature_id: &SignatureId) -> Option<&Stage>

Look up the Active stage for a given SignatureId. This is the M2 “resolve signature to latest implementation” pathway: a graph that pins a stage by signature_id gets whichever implementation is Active today.

fn active_stages_with_signature( &self, signature_id: &SignatureId, ) -> Vec<&Stage>

Return every Active stage whose signature_id matches. Ordered lexicographically by implementation ID so iteration is stable across HashMap-backed stores.