Struct HarnessCatalog 

pub struct HarnessCatalog;

Read-only entry point for discovering, loading, and following persisted harness sessions.

Implementations

impl HarnessCatalog

pub fn new() -> HarnessCatalog

Construct a catalog. It holds no cache or global mutable state.

pub fn discover( &self, query: &DiscoveryQuery, ) -> Result<Vec<SessionDescriptor>, InterchangeError>

Discover sessions using lightweight headers/indexes rather than full transcript normalization. Malformed or concurrently-created entries are skipped without aborting the rest of the scan.

pub fn discover_page( &self, query: &DiscoveryQuery, ) -> Result<DiscoveryPage, InterchangeError>

Discover one stable page and return the cursor for its successor.

pub fn refresh_file_descriptor( &self, locator: &SessionLocator, workspace: Option<&Path>, include_topic_candidates: bool, ) -> Result<Option<SessionDescriptor>, InterchangeError>

Refresh one file-backed descriptor without rescanning its native store.

This is the incremental counterpart to Self::discover_page: a filesystem notification is only an invalidation hint, so callers re-read the durable file and derive the complete current descriptor. None means the path disappeared or no longer contains a recognizable session. SQLite-backed harnesses retain their indexed discovery path.

pub fn load( &self, locator: &SessionLocator, ) -> Result<Session, InterchangeError>

Load the complete normalized session named by a durable locator.

pub fn load_with_fidelity( &self, locator: &SessionLocator, fidelity: Fidelity, ) -> Result<Session, InterchangeError>

Self::load at a declared fidelity.

Read-only surfaces (a session mirror, follow) pass Fidelity::Semantic so a compacted transcript renders instead of erroring; every continuation/transfer/export caller keeps the strict default. See Session::load_with_fidelity.

pub fn follow( &self, locator: &SessionLocator, ) -> Result<SessionFollower, InterchangeError>

Open a passive change-triggered follower for a durable locator.

pub fn follow_with_fidelity( &self, locator: &SessionLocator, fidelity: Fidelity, ) -> Result<SessionFollower, InterchangeError>

Self::follow at a declared fidelity — see Self::load_with_fidelity.

Trait Implementations

impl Clone for HarnessCatalog

fn clone(&self) -> HarnessCatalog

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for HarnessCatalog

impl Debug for HarnessCatalog

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for HarnessCatalog

fn default() -> HarnessCatalog

Returns the “default value” for a type.