Initial public release

crates/bsk-cli/src/daemon/mod.rs

@@ -0,0 +1,53 @@
+//! Daemon runtime: long-lived background process exposing IPC + WS.
+
+pub mod abort;
+pub mod browsers;
+mod cancel_forward;
+pub mod inflight;
+pub mod info;
+pub mod ipc;
+pub mod lockfile;
+pub mod paths;
+pub mod queue;
+pub mod session_interrupt;
+pub mod sessions;
+pub mod start;
+pub mod state;
+pub mod ws;
+
+pub use start::{DaemonConfig, run_foreground};
+pub use state::{DaemonHandle, DaemonState};
+
+use std::net::{IpAddr, Ipv4Addr, SocketAddr};
+use std::path::PathBuf;
+use std::sync::Arc;
+
+/// Default WebSocket port (design §3.2). Override via `--port`.
+pub const DEFAULT_WS_PORT: u16 = 52800;
+
+/// Test/embed entry point used by M4/M5 integration tests and the
+/// experimental `bsk daemon start --foreground` flag. Spins up the WS
+/// server (always) and the IPC server (if `ipc_socket.is_some()`),
+/// returning a [`DaemonHandle`] the caller can drive directly.
+///
+/// Note: this path intentionally bypasses M2's lockfile / daemon.json
+/// machinery — use [`run_foreground`] for the real daemon lifecycle.
+pub async fn run(
+    config: DaemonConfig,
+    ipc_socket: Option<PathBuf>,
+) -> anyhow::Result<DaemonHandle> {
+    let ws_port = config.ws_port;
+    let state = Arc::new(DaemonState::new(config));
+    let ws_addr = SocketAddr::new(IpAddr::V4(Ipv4Addr::LOCALHOST), ws_port);
+    let ws_handle = ws::WsServer::new(Arc::clone(&state)).bind(ws_addr).await?;
+    let ipc_handle = match ipc_socket {
+        Some(path) => Some(ipc::IpcServer::new(Arc::clone(&state)).bind(path).await?),
+        None => None,
+    };
+    // Ensure WS/IPC accept loops have polled `shutdown.notified()` before any
+    // caller can invoke `DaemonHandle::shutdown()` — `Notify::notify_waiters()`
+    // drops wakeups when nothing is registered yet, which otherwise hangs
+    // shutdown forever (hit by tests that connect/shutdown immediately).
+    tokio::task::yield_now().await;
+    Ok(DaemonHandle::new(state, ws_handle, ipc_handle))
+}