Struct LifecycleCompactOptions 

pub struct LifecycleCompactOptions {
    pub archive_threshold: f32,
    pub summarize: bool,
    pub max_episodes_per_summary: usize,
    pub compact_opts: CompactOptions,
    pub max_archive_batch: usize,
    pub realm: Option<String>,
    pub optimize_indices: bool,
}

Options for lifecycle-aware compaction.

Fields

archive_threshold: f32

Retention score below which episodes are considered cold and eligible for archival. Episodes where importance × retention(t) < threshold will be archived (or summarised first when summarize is true). Range [0.0, 1.0]. Default 0.0 (disabled).

summarize: bool

When true, cold episodes are fed to the Summarizer callback before archival so a semantic summary can be persisted.

max_episodes_per_summary: usize

Maximum number of episodes that may be batched into a single summary. Default 50.

compact_opts: CompactOptions

Standard Lance compaction options (fragment merging, row grouping).

max_archive_batch: usize

Maximum number of episode IDs to accumulate in memory during a single archival pass (N-M21 — prevents unbounded in-memory accumulation for very large datasets). Set to usize::MAX to disable the cap. Default: 10_000.

realm: Option<String>

Restrict compaction to a single realm (namespace). When None, the entire dataset is compacted.

optimize_indices: bool

Run optimize_indices after compaction. Default true.

Trait Implementations

impl Clone for LifecycleCompactOptions

fn clone(&self) -> LifecycleCompactOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LifecycleCompactOptions

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

Formats the value using the given formatter.

impl Default for LifecycleCompactOptions

fn default() -> Self

Returns the “default value” for a type.