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: LogFileSetting,
    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,
    pub cost_gate_node_limit: Option<usize>,
    pub cost_gate_min_prefix: Option<usize>,
    pub cost_gate_min_literal: Option<usize>,
}

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: LogFileSetting

Structured-log file destination (cluster-G §5.3).

Defaults to LogFileSetting::Path(<runtime_dir>/sqryd.log) so a fresh install logs to a tailable file under $XDG_RUNTIME_DIR/sqry/sqryd.log (Linux/macOS) or %LOCALAPPDATA%\sqry\sqryd.log (Windows). Operators opt out of file logging by setting log_file = "stderr" or log_file = "-" in TOML, or SQRY_DAEMON_LOG_FILE=- in the environment — both produce LogFileSetting::Special and disable the rolling appender so the daemon writes only to stderr.

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.

cost_gate_node_limit: Option<usize>

Pre-flight cost-gate arena-size cap (per B_cost_gate.md §1.4 + 00_contracts.md §3.CC-3). When Some(n), prohibitive query shapes (unanchored regex with no scope coupling) are rejected once the snapshot’s node count exceeds n. When None (or Some(0)), the cap is disabled and all shapes are allowed regardless of arena size — the gate degenerates to a shape-only check. Default DEFAULT_COST_GATE_NODE_LIMIT (50_000).

cost_gate_min_prefix: Option<usize>

Pre-flight cost-gate minimum literal-prefix length. When Some(n), an anchored regex passes the gate iff its longest required literal prefix has length ≥ n. Default DEFAULT_COST_GATE_MIN_PREFIX (3).

cost_gate_min_literal: Option<usize>

Pre-flight cost-gate minimum Hir::minimum_len. When Some(n), a regex with no usable prefix passes the gate iff its Hir::properties().minimum_len() is ≥ n. Default DEFAULT_COST_GATE_MIN_LITERAL (4).

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.