Struct TtlConfig 

pub struct TtlConfig {
    pub default_seconds: Option<u64>,
    pub namespace: TtlNamespaceConfig,
    pub scope: TtlScopeConfig,
}

Runtime TTL (Time-To-Live) configuration.

Controls memory expiration with domain-scoped and per-namespace defaults. TTL values are stored in seconds (0 means no expiration).

Defaults

• default_seconds: None (no expiration)
• All namespace/scope overrides: None (inherit from default)

Environment Variables

Variable	Description	Example
SUBCOG_TTL_DEFAULT	Default TTL	“30d”, “0”

Priority Order (highest to lowest)

1. Explicit --ttl flag on capture command
2. Per-namespace TTL (e.g., ttl.namespace.context = "7d")
3. Per-scope TTL (e.g., ttl.scope.project = "30d")
4. Global default TTL (e.g., ttl.default = "30d")
5. No expiration (if nothing configured)

Fields

default_seconds: Option<u64>

Default TTL in seconds for all memories (None = no expiration, 0 = no expiration).

namespace: TtlNamespaceConfig

Per-namespace TTL overrides in seconds.

scope: TtlScopeConfig

Per-scope TTL overrides in seconds.

Implementations

impl TtlConfig

pub fn new() -> Self

Creates a new TTL configuration with defaults.

pub fn from_config_file(file: &ConfigFileTtl) -> Self

Creates configuration from config file settings.

pub fn from_env() -> Self

Loads configuration from environment variables.

pub fn with_env_overrides(self) -> Self

Applies environment variable overrides.

pub fn get_ttl_seconds(&self, namespace: &str, scope: &str) -> Option<u64>

Gets the effective TTL in seconds for a given namespace and scope.

Returns None if no TTL is configured (memory never expires). Returns Some(0) if explicitly set to never expire.

Priority order:

1. Per-namespace TTL
2. Per-scope TTL
3. Global default TTL

pub const fn with_default_seconds(self, seconds: Option<u64>) -> Self

Sets the default TTL in seconds.

Trait Implementations

impl Clone for TtlConfig

fn clone(&self) -> TtlConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TtlConfig

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

Formats the value using the given formatter.

impl Default for TtlConfig

fn default() -> TtlConfig

Returns the “default value” for a type.