Struct BackendConfig 

pub struct BackendConfig {
    pub name: String,
    pub kind: BackendKind,
    pub path: Option<PathBuf>,
    pub cache_mb: Option<u32>,
    pub journal_mode: Option<String>,
    pub served_kinds: Option<BTreeSet<SubstrateKind>>,
    pub read_only: bool,
    pub wal_ceiling_bytes: Option<u64>,
    pub disk_reserve_bytes: Option<u64>,
    pub disk_guard_deadline_ms: Option<u64>,
}

Configuration for a named storage backend.

Corresponds to a [[backends]] entry in khive.toml. When no [[backends]] section is present, a single implicit main backend is synthesised from the existing --db / KHIVE_DB / default-path resolution. All packs fall back to main when their name is absent from [packs]. cache_mb and journal_mode are parsed but rejected during validation because per-backend tuning is not implemented.

[[backends]]
name = "main"
kind = "sqlite"
path = "~/.khive/khive.db"
read_only = false

Fields

name: String

Unique backend name. Referenced by [packs.<name>].backend.

kind: BackendKind

Storage backend kind. Defaults to sqlite.

path: Option<PathBuf>

Filesystem path for sqlite kind. Tilde is expanded to $HOME. None for memory kind (path is ignored when present).

cache_mb: Option<u32>

SQLite page-cache size in MiB. Parsed but rejected as unsupported.

journal_mode: Option<String>

SQLite journal mode (e.g. "wal"). Parsed but rejected as unsupported.

served_kinds: Option<BTreeSet<SubstrateKind>>

Substrate kinds this backend serves.

Omission preserves conservative fan-out to this backend. An explicit declaration is closed over SubstrateKind and must not be empty. The backend set must cover both note and entity search.

read_only: bool

Open the backend read-only. Defaults to false.

wal_ceiling_bytes: Option<u64>

WAL extent ceiling in bytes. None inherits the environment setting; zero disables the ceiling. Read-only backends retain the configured value for reporting but enforce no writer policy.

disk_reserve_bytes: Option<u64>

SQLite disk reserve, in bytes. Zero explicitly disables the floor.

disk_guard_deadline_ms: Option<u64>

Volume-guard acquisition deadline, in milliseconds (100..=10000).

Implementations

impl BackendConfig

pub fn resolve_disk_guard( &self, environment: &DiskGuardEnvironment, ) -> Result<Option<EffectiveDiskGuardConfig>, ConfigError>

Resolve from the host’s captured environment; never sample live environment here.

Trait Implementations

impl Clone for BackendConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BackendConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BackendConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.