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_raw_index( &self, query: &DiscoveryQuery, ) -> Vec<SessionDescriptor>

Scan file-backed session metadata without pagination or conversation previews. Child sessions are retained so a long-lived caller can keep an exact in-memory lineage index and project it without rescanning the native stores.

pub fn project_index( &self, query: &DiscoveryQuery, descriptors: impl IntoIterator<Item = SessionDescriptor>, ) -> Result<Vec<SessionDescriptor>, InterchangeError>

Project a raw metadata index through the query’s lineage, search, and pagination rules without reading any transcript content.

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

Add the bounded topic/latest-message previews used by list clients to an already projected metadata page.

pub fn enrich_index_page_with_codex_history( &self, query: &DiscoveryQuery, sessions: Vec<SessionDescriptor>, codex_history: &CodexHistoryTopicIndex, ) -> Result<Vec<SessionDescriptor>, InterchangeError>

Add list previews using a retained append-aware Codex history index.

Results are identical to Self::enrich_index_page, while a long-lived caller avoids reparsing all of history.jsonl for every active transcript write.

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 refresh_file_index_descriptor( &self, locator: &SessionLocator, workspace: Option<&Path>, ) -> Result<Option<SessionDescriptor>, InterchangeError>

Refresh only stable list metadata for one file-backed descriptor. This avoids reading conversation preview windows for background index maintenance.

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.