serve.rs 87.0%

67 of 77 lines run, 10 of 26 functions · run #9 on main · run missed

//! `spectra serve`: the daemon (spec §7.1, §21.1). It holds the ledger,
//! serves Tuner (and, as they land, the API and Radar) on the Unix socket
//! and on a loopback port, and writes a checkpoint when it stops.

use super::{ui, Ctx};
use anyhow::{bail, Context, Result};
use spectra_core::daemon::Daemon;
use spectra_mcp::client::Client;
use spectra_mcp::http::{AppState, PeerInfo};
use std::net::SocketAddr;
use std::sync::Arc;

pub async fn serve(ctx: &Ctx, bind: &str, insecure: bool) -> Result<i32> {
    let addr: SocketAddr = bind.parse().with_context(|| format!("--bind {bind} is not an address and port"))?;
    if !addr.ip().is_loopback() && !insecure {
        bail!("Spectra serves loopback only unless it has TLS (spec §21.1); pass --insecure to bind {addr} in plain HTTP anyway");
    }
    let socket = ctx.socket();
    if socket.exists() {
        if Client::alive(&socket).await {
            bail!("Spectra is already serving {} (its socket answers)", ctx.data.display());
        }
        std::fs::remove_file(&socket).ok();
    }
    let daemon = Daemon::start(&ctx.data).await?;
    let unix = tokio::net::UnixListener::bind(&socket).with_context(|| format!("binding {}", socket.display()))?;
    #[cfg(unix)]
    {
        use std::os::unix::fs::PermissionsExt;
        std::fs::set_permissions(&socket, std::fs::Permissions::from_mode(0o660))?;
    }
    let tcp = tokio::net::TcpListener::bind(addr).await.with_context(|| format!("binding {addr}"))?;
    let port = tcp.local_addr()?.port();
    let origins = vec![format!("http://127.0.0.1:{port}"), format!("http://localhost:{port}"), format!("http://{addr}")];
    let state = AppState { daemon: daemon.clone(), origins: Arc::new(origins) };
    let app = spectra_mcp::http::router(state);

    let (head, _) = daemon.ledger.head().await;
    let agents = sqlx::query_scalar::<_, i64>("SELECT COUNT(*) FROM agents WHERE disabled_ms IS NULL")
        .fetch_one(daemon.ledger.pool())
        .await
        .unwrap_or(0);
    println!("{} {}", ui::done("Serving"), ui::subject("Spectra"));
    println!("{}", ui::kv("socket", ui::path(socket.display())));
    println!("{}", ui::kv("http", format!("http://127.0.0.1:{port}")));
    println!("{}", ui::kv("ledger", format!("{head} events{}{agents} agent(s)", ui::sep())));
    println!("  {} {}", ui::note(), ui::dim("agents connect with: spectra mcp --agent NAME"));

    let (stop_tx, stop_rx) = tokio::sync::watch::channel(false);
    let stop = |mut rx: tokio::sync::watch::Receiver<bool>| async move {
        let _ = rx.wait_for(|s| *s).await;
    };
    let unix_srv =
        axum::serve(unix, app.clone().into_make_service_with_connect_info::<PeerInfo>()).with_graceful_shutdown(stop(stop_rx.clone()));
    let tcp_srv = axum::serve(tcp, app.into_make_service_with_connect_info::<PeerInfo>()).with_graceful_shutdown(stop(stop_rx));
    let signal = async move {
        shutdown_signal().await;
        let _ = stop_tx.send(true);
    };
    // After the signal, open connections get five seconds to finish: a
    // `subscriptions/listen` stream never does by itself.
    let (stopping_tx, mut stopping) = tokio::sync::watch::channel(false);
    tokio::spawn(async move {
        signal.await;
        let _ = stopping_tx.send(true);
    });
    let servers = async { tokio::join!(unix_srv, tcp_srv) };
    tokio::select! {
        (u, t) = servers => {
            u?;
            t?;
        }
        _ = async {
            let _ = stopping.wait_for(|s| *s).await;
            tokio::time::sleep(std::time::Duration::from_secs(5)).await;
        } => {
            tracing::info!("connections still open five seconds after the signal; stopping anyway");
        }
    }
    daemon.shutdown().await;
    std::fs::remove_file(&socket).ok();
    println!("{} {}", ui::done("Stopped"), ui::dim(format!("ledger checkpointed at {} events", daemon.ledger.head().await.0)));
    Ok(0)
}

async fn shutdown_signal() {
    #[cfg(unix)]
    {
        let mut term = tokio::signal::unix::signal(tokio::signal::unix::SignalKind::terminate()).expect("a SIGTERM handler");
        tokio::select! {
            _ = tokio::signal::ctrl_c() => {}
            _ = term.recv() => {}
        }
    }
    #[cfg(not(unix))]
    let _ = tokio::signal::ctrl_c().await;
}

1		//! `spectra serve`: the daemon (spec §7.1, §21.1). It holds the ledger,
2		//! serves Tuner (and, as they land, the API and Radar) on the Unix socket
3		//! and on a loopback port, and writes a checkpoint when it stops.
4
5		use super::{ui, Ctx};
6		use anyhow::{bail, Context, Result};
7		use spectra_core::daemon::Daemon;
8		use spectra_mcp::client::Client;
9		use spectra_mcp::http::{AppState, PeerInfo};
10		use std::net::SocketAddr;
11		use std::sync::Arc;
12
13	6×	pub async fn serve(ctx: &Ctx, bind: &str, insecure: bool) -> Result<i32> {
14	6×	let addr: SocketAddr = bind.parse().with_context(\|\| format!("--bind {bind} is not an address and port"))?;
15	6×	if !addr.ip().is_loopback() && !insecure {
16	0×	bail!("Spectra serves loopback only unless it has TLS (spec §21.1); pass --insecure to bind {addr} in plain HTTP anyway");
17	6×	}
18	6×	let socket = ctx.socket();
19	6×	if socket.exists() {
20	0×	if Client::alive(&socket).await {
21	0×	bail!("Spectra is already serving {} (its socket answers)", ctx.data.display());
22	0×	}
23	0×	std::fs::remove_file(&socket).ok();
24	6×	}
25	6×	let daemon = Daemon::start(&ctx.data).await?;
26	6×	let unix = tokio::net::UnixListener::bind(&socket).with_context(\|\| format!("binding {}", socket.display()))?;
27		#[cfg(unix)]
28		{
29		use std::os::unix::fs::PermissionsExt;
30	6×	std::fs::set_permissions(&socket, std::fs::Permissions::from_mode(0o660))?;
31		}
32	6×	let tcp = tokio::net::TcpListener::bind(addr).await.with_context(\|\| format!("binding {addr}"))?;
33	6×	let port = tcp.local_addr()?.port();
34	6×	let origins = vec![format!("http://127.0.0.1:{port}"), format!("http://localhost:{port}"), format!("http://{addr}")];
35	6×	let state = AppState { daemon: daemon.clone(), origins: Arc::new(origins) };
36	6×	let app = spectra_mcp::http::router(state);
37
38	6×	let (head, _) = daemon.ledger.head().await;
39	6×	let agents = sqlx::query_scalar::<_, i64>("SELECT COUNT(*) FROM agents WHERE disabled_ms IS NULL")
40	6×	.fetch_one(daemon.ledger.pool())
41	6×	.await
42	6×	.unwrap_or(0);
43	6×	println!("{} {}", ui::done("Serving"), ui::subject("Spectra"));
44	6×	println!("{}", ui::kv("socket", ui::path(socket.display())));
45	6×	println!("{}", ui::kv("http", format!("http://127.0.0.1:{port}")));
46	6×	println!("{}", ui::kv("ledger", format!("{head} events{}{agents} agent(s)", ui::sep())));
47	6×	println!(" {} {}", ui::note(), ui::dim("agents connect with: spectra mcp --agent NAME"));
48
49	6×	let (stop_tx, stop_rx) = tokio::sync::watch::channel(false);
50	12×	let stop = \|mut rx: tokio::sync::watch::Receiver<bool>\| async move {
51	12×	let _ = rx.wait_for(\|s\| *s).await;
52	24×	};
53	6×	let unix_srv =
54	6×	axum::serve(unix, app.clone().into_make_service_with_connect_info::<PeerInfo>()).with_graceful_shutdown(stop(stop_rx.clone()));
55	6×	let tcp_srv = axum::serve(tcp, app.into_make_service_with_connect_info::<PeerInfo>()).with_graceful_shutdown(stop(stop_rx));
56	6×	let signal = async move {
57	6×	shutdown_signal().await;
58	6×	let _ = stop_tx.send(true);
59	6×	};
60		// After the signal, open connections get five seconds to finish: a
61		// `subscriptions/listen` stream never does by itself.
62	6×	let (stopping_tx, mut stopping) = tokio::sync::watch::channel(false);
63	6×	tokio::spawn(async move {
64	6×	signal.await;
65	6×	let _ = stopping_tx.send(true);
66	6×	});
67	6×	let servers = async { tokio::join!(unix_srv, tcp_srv) };
68	6×	tokio::select! {
69	6×	(u, t) = servers => {
70	6×	u?;
71	6×	t?;
72		}
73	6×	_ = async {
74	6×	let _ = stopping.wait_for(\|s\| *s).await;
75	3×	tokio::time::sleep(std::time::Duration::from_secs(5)).await;
76	0×	} => {
77	0×	tracing::info!("connections still open five seconds after the signal; stopping anyway");
78		}
79		}
80	6×	daemon.shutdown().await;
81	6×	std::fs::remove_file(&socket).ok();
82	6×	println!("{} {}", ui::done("Stopped"), ui::dim(format!("ledger checkpointed at {} events", daemon.ledger.head().await.0)));
83	6×	Ok(0)
84	6×	}
85
86	6×	async fn shutdown_signal() {
87		#[cfg(unix)]
88		{
89	6×	let mut term = tokio::signal::unix::signal(tokio::signal::unix::SignalKind::terminate()).expect("a SIGTERM handler");
90	6×	tokio::select! {
91	6×	_ = tokio::signal::ctrl_c() => {}
92	6×	_ = term.recv() => {}
93		}
94		}
95		#[cfg(not(unix))]
96		let _ = tokio::signal::ctrl_c().await;
97	6×	}

`/`	Search
`g` `c`	Code
`g` `h`	History
`g` `b`	Bookmarks
`g` `t`	Trust
`y`	Permalink to this state (files and trees)
`?`	This sheet

Coverage / src/cli/serve.rs 87.0%

Keyboard