Struct CommSister 

pub struct CommSister { /* private fields */ }

Contracts-compliant Comm sister.

Wraps CommStore and implements all v0.2.0 traits. This is the canonical “Comm as a sister” interface.

Implementations

impl CommSister

pub fn from_store(store: CommStore, file_path: Option<PathBuf>) -> Self

Create from an existing store (for migration from SessionManager).

pub fn store(&self) -> &CommStore

Get a reference to the underlying store.

pub fn store_mut(&mut self) -> &mut CommStore

Get a mutable reference to the underlying store.

pub fn current_session_id(&self) -> Option<u32>

Get the current u32 session ID (for interop with existing code).

Trait Implementations

impl FileFormatReader for CommSister

fn read_file(path: &Path) -> SisterResult<Self>

Read a file with version handling

fn can_read(path: &Path) -> SisterResult<FileInfo>

Check if a file is readable (without full parse). Returns file info for quick inspection

fn file_version(path: &Path) -> SisterResult<Version>

Get file version without full parse

fn migrate(_data: &[u8], _from_version: Version) -> SisterResult<Vec<u8>>

Migrate old version data to current format (in memory). Returns the migrated bytes

impl FileFormatWriter for CommSister

fn write_file(&self, path: &Path) -> SisterResult<()>

Write to a file path

fn to_bytes(&self) -> SisterResult<Vec<u8>>

Serialize the content to bytes

impl Grounding for CommSister

fn ground(&self, claim: &str) -> SisterResult<GroundingResult>

Verify a claim against stored evidence.

fn evidence( &self, query: &str, max_results: usize, ) -> SisterResult<Vec<EvidenceDetail>>

Get detailed evidence for a query.

fn suggest( &self, query: &str, limit: usize, ) -> SisterResult<Vec<GroundingSuggestion>>

Find similar items when an exact match fails.

impl Queryable for CommSister

fn query(&self, query: Query) -> SisterResult<QueryResult>

Execute a query.

fn supports_query(&self, query_type: &str) -> bool

Check if a query type is supported.

fn query_types(&self) -> Vec<QueryTypeInfo>

List supported query types.

fn search(&self, text: &str) -> Result<QueryResult, SisterError>

Execute a simple search query.

fn recent(&self, count: usize) -> Result<QueryResult, SisterError>

Get recent items.

fn list(&self, limit: usize, offset: usize) -> Result<QueryResult, SisterError>

List items with pagination.

impl SessionManagement for CommSister

fn start_session(&mut self, name: &str) -> SisterResult<ContextId>

Start a new session. Returns the session ID. The previous session (if any) is automatically ended

fn end_session(&mut self) -> SisterResult<()>

End the current session. After this, a new session must be started before operations

fn current_session(&self) -> Option<ContextId>

Get the current session ID. Returns None if no session is active

fn current_session_info(&self) -> SisterResult<ContextInfo>

Get info about the current session

fn list_sessions(&self) -> SisterResult<Vec<ContextSummary>>

List all past sessions (most recent first)

fn export_session(&self, id: ContextId) -> SisterResult<ContextSnapshot>

Export a session as a snapshot (for backup/transfer)

fn import_session( &mut self, snapshot: ContextSnapshot, ) -> SisterResult<ContextId>

Import a session from a snapshot

fn start_session_with_metadata( &mut self, name: &str, metadata: HashMap<String, Value>, ) -> Result<ContextId, SisterError>

Start a new session with metadata

fn get_session_info(&self, id: ContextId) -> Result<ContextInfo, SisterError>

Get info about a specific past session

impl Sister for CommSister

const SISTER_TYPE: SisterType = SisterType::Comm

The type of this sister

const FILE_EXTENSION: &'static str = "acomm"

File extension for this sister’s format (without dot)

fn init(config: SisterConfig) -> SisterResult<Self>

where Self: Sized,

Initialize the sister with configuration

fn health(&self) -> HealthStatus

Check health status

fn version(&self) -> Version

Get current version

fn shutdown(&mut self) -> SisterResult<()>

Shutdown gracefully

fn capabilities(&self) -> Vec<Capability>

Get capabilities this sister provides

fn sister_type(&self) -> SisterType

Get the sister type

fn file_extension(&self) -> &'static str

Get the file extension

fn is_healthy(&self) -> bool

Check if the sister is healthy

fn name(&self) -> String

Get a human-readable name

fn mcp_prefix(&self) -> &'static str

Get MCP tool prefix