sqry-daemon 13.0.5

//! Task 9 lifecycle primitives.
//!
//! This module is the landing zone for all sqryd binary lifecycle concerns:
//!
//! - [`notify`] — thin `sd_notify` wrapper with platform-appropriate fallbacks.
//!   On Linux the real `sd_notify` crate is called; on macOS and Windows the
//!   functions are no-ops so that callers in the shared startup path never need
//!   `#[cfg(target_os = "linux")]` guards at the call site.
//! - [`log_rotate`] — `RollingSizeAppender` + `install_tracing` (Task 9 U5).
//!   Rotates the active log file when it exceeds `log_max_size_mb`, keeping at
//!   most `log_keep_rotations` copies.  When `NOTIFY_SOCKET` is present
//!   (systemd supervision) the rolling appender is skipped and output goes to
//!   stderr instead (§G.1 m4 fix).
//!
//! Modules added by later Task 9 units (U3–U10) will be declared here as they
//! are implemented.  This avoids merge-conflict churn: each unit adds one
//! `pub mod` line.
//!
//! # Design reference
//!
//! `docs/reviews/sqryd-daemon/2026-04-19/task-9-design_iter3_request.md` §C.3.1
//! (step 15 — authoritative ready-signal matrix) + §F.1 (systemd user unit
//! `Type=notify`) + §G (log rotation).

pub mod detach;
pub mod log_rotate;
pub mod notify;
pub mod pidfile;
pub mod signals;
pub mod units;

#[cfg(test)]
pub(crate) mod test_support {
    use std::ffi::OsString;
    use std::sync::{Mutex, MutexGuard};

    static NOTIFY_SOCKET_LOCK: Mutex<()> = Mutex::new(());

    pub(crate) struct NotifySocketGuard {
        previous: Option<OsString>,
        _lock: MutexGuard<'static, ()>,
    }

    impl NotifySocketGuard {
        pub(crate) fn unset() -> Self {
            let _lock = NOTIFY_SOCKET_LOCK.lock().unwrap_or_else(|e| e.into_inner());
            let previous = std::env::var_os("NOTIFY_SOCKET");
            unsafe {
                std::env::remove_var("NOTIFY_SOCKET");
            }
            Self { previous, _lock }
        }

        pub(crate) fn set(value: &str) -> Self {
            let _lock = NOTIFY_SOCKET_LOCK.lock().unwrap_or_else(|e| e.into_inner());
            let previous = std::env::var_os("NOTIFY_SOCKET");
            unsafe {
                std::env::set_var("NOTIFY_SOCKET", value);
            }
            Self { previous, _lock }
        }
    }

    impl Drop for NotifySocketGuard {
        fn drop(&mut self) {
            match &self.previous {
                Some(value) => unsafe { std::env::set_var("NOTIFY_SOCKET", value) },
                None => unsafe { std::env::remove_var("NOTIFY_SOCKET") },
            }
        }
    }
}