Struct DaemonConfig 

pub struct DaemonConfig {

    pub memory_limit_mb: u64,
    pub idle_timeout_minutes: u64,
    pub debounce_ms: u64,
    pub incremental_threshold: usize,
    pub closure_limit_percent: u32,
    pub stale_serve_max_age_hours: u32,
    pub rebuild_drain_timeout_ms: u64,
    pub ipc_shutdown_drain_secs: u64,
    pub tool_timeout_secs: u64,
    pub max_shim_connections: usize,
    pub interner_compaction_threshold: f32,
    pub log_file: Option<PathBuf>,
    pub log_level: String,
    pub log_max_size_mb: u64,
    pub socket: SocketConfig,
    pub workspaces: Vec<WorkspaceConfig>,
    pub auto_start_ready_timeout_secs: u64,
    pub log_keep_rotations: u32,
    pub install_user_service: bool,
}

Top-level daemon configuration.

Loaded from ~/.config/sqry/daemon.toml by default. Env-var overrides (see the ENV_* constants) are layered on top by DaemonConfig::load.

Fields

memory_limit_mb: u64

Hard cap on total resident graph memory across every loaded workspace.

idle_timeout_minutes: u64

Workspace idle-timeout before it becomes eligible for LRU eviction.

debounce_ms: u64

Filesystem-watcher debounce window (ms) for coalescing bursts of changes.

incremental_threshold: usize

If > incremental_threshold files changed in one window, full-rebuild instead of incremental-rebuild.

closure_limit_percent: u32

If the reverse-dep closure covers > closure_limit_percent% of the graph’s files, full-rebuild instead of incremental-rebuild.

stale_serve_max_age_hours: u32

Cap on how long a Failed workspace may keep serving its last-good snapshot as stale: true. 0 disables the cap (serve indefinitely).

rebuild_drain_timeout_ms: u64

Retention-reaper WARN threshold, not an accounting deadline. Retained bytes are released when Arc::strong_count drops to 1 — regardless of wall-clock time.

ipc_shutdown_drain_secs: u64

Grace window (seconds) for the IPC accept loop to drain active connections during shutdown. Task 8 Phase 8a.

tool_timeout_secs: u64

Per-tool invocation timeout. Bounds the response latency of any single tool call; exceeding this returns DaemonError::ToolTimeout (JSON-RPC -32000 / MCP internal_error with kind = "deadline_exceeded").

Important contract: this bounds RESPONSE LATENCY, not the detached OS-thread lifetime. When the timeout fires, the tokio::task::spawn_blocking tokio::task::JoinHandle is dropped; the OS thread running the tool closure continues until the closure itself returns. A buggy/runaway tool closure can keep its thread alive past daemon/stop. Default 60 seconds. Task 8 Phase 8c U6.

max_shim_connections: usize

Cap on the number of concurrently-registered shim byte-pump connections. Every accepted ShimRegister frame must pass crate::ipc::shim_registry::ShimRegistry::try_register_bounded against this cap under a single mutex-guard — over-cap admissions reply ShimRegisterAck { accepted: false, reason: "shim registry full (N / cap)" } and the connection closes. Default 256. Task 8 Phase 8c U10.

interner_compaction_threshold: f32

Interner housekeeping: if the live-ratio drops below this, the next debounce tick schedules a mandatory full rebuild.

log_file: Option<PathBuf>

Optional structured-log file path.

log_level: String

Log verbosity (matches tracing_subscriber::EnvFilter syntax).

log_max_size_mb: u64

Log-rotation trigger.

socket: SocketConfig

IPC listener binding (UDS on Unix, named pipe on Windows).

workspaces: Vec<WorkspaceConfig>

Pre-declared workspaces — pinned workspaces load at daemon startup.

auto_start_ready_timeout_secs: u64

Timeout (seconds) used in two places:

1. --detach parent wait loop (run_start_detach): how long the launching parent process waits for the grandchild to signal ready via the self-pipe before giving up and killing the grandchild.
2. lifecycle::start_detached (Task 10 auto-spawn): how long the client helper polls the daemon socket before returning DaemonError::AutoStartTimeout.

Valid range (enforced by DaemonConfig::validate): 1..=60.

log_keep_rotations: u32

Number of rotated log archives to keep alongside the live log file.

When RollingSizeAppender rotates, it shifts existing .1–.N files one position and deletes any file beyond this limit. A value of 5 means .1–.5 are retained; .6 and beyond are removed.

Valid range (enforced by DaemonConfig::validate): 1..=100.

install_user_service: bool

Reserved for future use — will drive automated systemd user-service installation on first sqryd start when set to true. Currently a no-op; stored in config to avoid breaking changes when the feature lands. Defaults to false.

Implementations

impl DaemonConfig

pub fn load() -> DaemonResult<Self>

Load the effective config: start from defaults, apply the TOML file at the canonical path (or the one named by ENV_CONFIG_PATH), then layer environment-variable overrides.

A missing config file is not an error — the defaults plus env-var overrides are returned. A malformed file is always an error.

pub fn load_from_path(path: &Path) -> DaemonResult<Self>

Load a config file from an explicit path, ignoring env overrides. Useful for tests and documentation examples.

pub fn from_toml_str(text: &str) -> Result<Self>

Parse a TOML string into a DaemonConfig. Defaults fill any missing fields.

pub fn apply_env_overrides(&mut self) -> DaemonResult<()>

Apply SQRY_DAEMON_* environment-variable overrides. See the ENV_* constants for the full list.

pub fn validate(&self) -> DaemonResult<()>

Sanity-check invariants that admission accounting and the rebuild dispatcher depend on.

pub fn resolve_config_path() -> DaemonResult<PathBuf>

Resolve the config-file path, respecting ENV_CONFIG_PATH.

Falls back to $XDG_CONFIG_HOME/sqry/daemon.toml, then $HOME/.config/sqry/daemon.toml.

pub fn socket_path(&self) -> PathBuf

Path the IPC server binds to.

• Unix: explicit socket.path, else $XDG_RUNTIME_DIR/sqry/sqryd.sock, else $TMPDIR/sqry-<uid>/sqryd.sock.
• Windows: \\\\.\\pipe\\<socket.pipe_name> (default sqry).

pub fn pid_path(&self) -> PathBuf

Where to write the daemon pidfile. One per user.

pub fn lock_path(&self) -> PathBuf

Flock target — held exclusively by the running daemon, and briefly by clients during auto-start to avoid racing two sqry processes.

pub fn runtime_dir(&self) -> PathBuf

Platform-specific per-user runtime directory where the socket, pidfile, and lockfile live.

This is the public accessor for the private [runtime_dir] free function. The return value is the same as socket_path().parent() when the socket path uses the default (not the explicit socket.path override).

pub const fn memory_limit_bytes(&self) -> u64

Memory budget in bytes, derived from Self::memory_limit_mb.

Trait Implementations

impl Clone for DaemonConfig

fn clone(&self) -> DaemonConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DaemonConfig

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

Formats the value using the given formatter.

impl Default for DaemonConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DaemonConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DaemonConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.