Struct CompressedSearchPath 

pub struct CompressedSearchPath<P> { /* private fields */ }

A search path annotated with compression context.

When a query enters the semantic-memory runtime, it may carry compressed index artifacts (e.g. turbo-quant polar codes or fib-quant radial sketches). CompressedSearchPath wraps the raw search path + the codec metadata needed to route the query correctly.

Type parameters

• P — the underlying search path type (e.g. Vec<NamespaceId>, ScopeFilter, etc.) must be Send + Sync so the wrapper can be used across async boundaries.

Implementations

impl<P> CompressedSearchPath<P>

where P: Send + Sync,

pub fn new(path: P, codec_id: CodecId) -> Self

Wrap an existing search path with compression context.

pub fn produced_at(self, ts: DateTime<Utc>) -> Self

Set the produced_at timestamp.

pub fn provenance_label(self, label: impl Into<String>) -> Self

Set the provenance label.

pub fn require_exact(self) -> Self

Disallow approximate decode — require exact fallback on every decode.

pub fn codec_id(&self) -> CodecId

Returns the codec identity.

pub fn path(&self) -> &P

Returns the wrapped search path by reference.

pub fn into_path(self) -> P

Consumes the wrapper and returns the inner search path.

pub fn approximate_allowed(&self) -> bool

Returns true if approximate decode is allowed on this path.

pub fn requires_exact_fallback(&self) -> bool

Returns true if this path requires an exact fallback decode.

pub fn map_path<Q, F>(self, f: F) -> CompressedSearchPath<Q>

where F: FnOnce(P) -> Q,

Map the inner path type using f.

This allows transforming the wrapped path type without touching the compression metadata.

Trait Implementations

impl<P: Clone> Clone for CompressedSearchPath<P>

fn clone(&self) -> CompressedSearchPath<P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P: Debug> Debug for CompressedSearchPath<P>

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

Formats the value using the given formatter.

impl<'de, P> Deserialize<'de> for CompressedSearchPath<P>

where P: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<P> Display for CompressedSearchPath<P>

where P: Debug,

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

Formats the value using the given formatter.

impl<P> Serialize for CompressedSearchPath<P>

where P: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.