Struct RuntimeConfig 

#[non_exhaustive]
pub struct RuntimeConfig {
    pub kindling_home: PathBuf,
    pub project_root: String,
    pub spool_path: Option<PathBuf>,
    pub spawn: SpawnStrategy,
}

Configuration for a Runtime.

#[non_exhaustive]: build via RuntimeConfig::embedded, RuntimeConfig::with_home, or RuntimeConfig::from_default_home (then mutate fields), so new fields can be added without a breaking change.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

kindling_home: PathBuf

Root of the per-project databases and the daemon’s socket/pid/port files (~/.kindling by default). Using the default layout shares the DB with the kindling CLI and Claude Code hooks.

project_root: String

Project root string, sent as the X-Kindling-Project header on every data endpoint for per-project DB routing.

spool_path: Option<PathBuf>

Path to the durable-emit spool file. Defaults to <home>/spool.ndjson when None. Only meaningful with the spool feature.

spawn: SpawnStrategy

How to obtain the daemon. Defaults to SpawnStrategy::Embedded.

Implementations

impl RuntimeConfig

pub fn from_default_home( project_root: impl Into<String>, ) -> Result<Self, RuntimeError>

Build a config rooted at the default kindling home (~/.kindling) for project_root, with the default SpawnStrategy.

Errors only if no home directory can be determined.

pub fn embedded(project_root: impl Into<String>) -> Self

Build an embedded-daemon config rooted at the default home for project_root (the common anvil case).

Infallible: if no home directory can be determined it silently falls back to .kindling in the current working directory. Prefer from_default_home when you want a missing home to surface as an error instead of a cwd-relative fallback.

pub fn with_home( kindling_home: impl Into<PathBuf>, project_root: impl Into<String>, spawn: SpawnStrategy, ) -> Self

Build a config rooted at an explicit kindling_home (tests / isolated hosts) with the given SpawnStrategy.

pub fn effective_spool_path(&self) -> PathBuf

The effective spool path: the configured one, or <home>/spool.ndjson.

Trait Implementations

impl Clone for RuntimeConfig

fn clone(&self) -> RuntimeConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RuntimeConfig

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

Formats the value using the given formatter.