Struct SemanticPolicy 

pub struct SemanticPolicy {

    pub mode: SemanticMode,
    pub download_policy: ModelDownloadPolicy,
    pub fast_tier_embedder: String,
    pub quality_tier_embedder: String,
    pub reranker: String,
    pub fast_dimension: usize,
    pub quality_dimension: usize,
    pub quality_weight: f32,
    pub max_refinement_docs: usize,
    pub semantic_budget_mb: u64,
    pub min_free_disk_mb: u64,
    pub max_model_size_mb: u64,
    pub max_backfill_threads: usize,
    pub max_backfill_rss_mb: u64,
    pub idle_delay_seconds: u64,
    pub chunk_timeout_seconds: u64,
    pub semantic_schema_version: u32,
    pub chunking_strategy_version: u32,
}

Resolved semantic policy after layering defaults → config → env → CLI.

Every field has a value — the resolution process fills in defaults for anything not specified by higher layers.

Fields

mode: SemanticMode

Active semantic mode.

download_policy: ModelDownloadPolicy

Whether model downloads may happen automatically.

fast_tier_embedder: String

Fast-tier embedder name (e.g., “hash”).

quality_tier_embedder: String

Quality-tier embedder name (e.g., “minilm”).

reranker: String

Reranker name (e.g., “ms-marco-minilm”).

fast_dimension: usize

Fast-tier embedding dimension.

quality_dimension: usize

Quality-tier embedding dimension.

quality_weight: f32

Quality weight for score blending (0.0–1.0).

max_refinement_docs: usize

Maximum documents refined per query.

semantic_budget_mb: u64

Total disk budget for all semantic artifacts (MB).

min_free_disk_mb: u64

Minimum free disk that must remain after writes (MB).

max_model_size_mb: u64

Maximum single model size (MB).

max_backfill_threads: usize

Max threads for background backfill.

max_backfill_rss_mb: u64

Max RSS target for backfill worker (MB).

idle_delay_seconds: u64

Idle delay before background work starts (seconds).

chunk_timeout_seconds: u64

Max seconds per background work chunk.

semantic_schema_version: u32

Semantic schema version — mismatch forces rebuild.

chunking_strategy_version: u32

Chunking strategy version — mismatch forces rebuild.

Implementations

impl SemanticPolicy

pub fn compiled_defaults() -> Self

Compiled defaults — lowest precedence.

pub fn with_env_overrides(self) -> Self

Layer environment variables over the current policy.

Only overrides fields for which env vars are set and parseable.

pub fn with_cli_overrides(self, overrides: &CliSemanticOverrides) -> Self

Layer explicit CLI overrides.

Each Option is Some only when the user passed that flag.

pub fn resolve(cli: &CliSemanticOverrides) -> Self

Full resolution: compiled defaults → env → CLI.

impl SemanticPolicy

pub fn check_budget( &self, write_size_mb: u64, current_semantic_usage_mb: u64, free_disk_mb: u64, ) -> BudgetDecision

Check whether a proposed write of write_size_mb is within budget.

This is intended for model downloads — the first check compares against max_model_size_mb. For vector index writes (which are much smaller), prefer skipping the per-model cap or calling with a separate budget method when one is needed.

current_semantic_usage_mb is the total disk used by semantic artifacts right now. free_disk_mb is the free space on the volume.

Trait Implementations

impl Clone for SemanticPolicy

fn clone(&self) -> SemanticPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SemanticPolicy

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

Formats the value using the given formatter.

impl Default for SemanticPolicy

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SemanticPolicy

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SemanticPolicy

fn eq(&self, other: &SemanticPolicy) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SemanticPolicy

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SemanticPolicy