serve.rs 87.3%

55 of 63 lines run, 7 of 20 functions · run #8 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);
    };
    let (u, t, _) = tokio::join!(unix_srv, tcp_srv, signal);
    u?;
    t?;
    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	3×	pub async fn serve(ctx: &Ctx, bind: &str, insecure: bool) -> Result<i32> {
14	3×	let addr: SocketAddr = bind.parse().with_context(\|\| format!("--bind {bind} is not an address and port"))?;
15	3×	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	3×	}
18	3×	let socket = ctx.socket();
19	3×	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	3×	}
25	3×	let daemon = Daemon::start(&ctx.data).await?;
26	3×	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	3×	std::fs::set_permissions(&socket, std::fs::Permissions::from_mode(0o660))?;
31		}
32	3×	let tcp = tokio::net::TcpListener::bind(addr).await.with_context(\|\| format!("binding {addr}"))?;
33	3×	let port = tcp.local_addr()?.port();
34	3×	let origins = vec![format!("http://127.0.0.1:{port}"), format!("http://localhost:{port}"), format!("http://{addr}")];
35	3×	let state = AppState { daemon: daemon.clone(), origins: Arc::new(origins) };
36	3×	let app = spectra_mcp::http::router(state);
37
38	3×	let (head, _) = daemon.ledger.head().await;
39	3×	let agents = sqlx::query_scalar::<_, i64>("SELECT COUNT(*) FROM agents WHERE disabled_ms IS NULL")
40	3×	.fetch_one(daemon.ledger.pool())
41	3×	.await
42	3×	.unwrap_or(0);
43	3×	println!("{} {}", ui::done("Serving"), ui::subject("Spectra"));
44	3×	println!("{}", ui::kv("socket", ui::path(socket.display())));
45	3×	println!("{}", ui::kv("http", format!("http://127.0.0.1:{port}")));
46	3×	println!("{}", ui::kv("ledger", format!("{head} events{}{agents} agent(s)", ui::sep())));
47	3×	println!(" {} {}", ui::note(), ui::dim("agents connect with: spectra mcp --agent NAME"));
48
49	3×	let (stop_tx, stop_rx) = tokio::sync::watch::channel(false);
50	6×	let stop = \|mut rx: tokio::sync::watch::Receiver<bool>\| async move {
51	6×	let _ = rx.wait_for(\|s\| *s).await;
52	12×	};
53	3×	let unix_srv =
54	3×	axum::serve(unix, app.clone().into_make_service_with_connect_info::<PeerInfo>()).with_graceful_shutdown(stop(stop_rx.clone()));
55	3×	let tcp_srv = axum::serve(tcp, app.into_make_service_with_connect_info::<PeerInfo>()).with_graceful_shutdown(stop(stop_rx));
56	3×	let signal = async move {
57	3×	shutdown_signal().await;
58	3×	let _ = stop_tx.send(true);
59	3×	};
60	3×	let (u, t, _) = tokio::join!(unix_srv, tcp_srv, signal);
61	3×	u?;
62	3×	t?;
63	3×	daemon.shutdown().await;
64	3×	std::fs::remove_file(&socket).ok();
65	3×	println!("{} {}", ui::done("Stopped"), ui::dim(format!("ledger checkpointed at {} events", daemon.ledger.head().await.0)));
66	3×	Ok(0)
67	3×	}
68
69	3×	async fn shutdown_signal() {
70		#[cfg(unix)]
71		{
72	3×	let mut term = tokio::signal::unix::signal(tokio::signal::unix::SignalKind::terminate()).expect("a SIGTERM handler");
73	3×	tokio::select! {
74	3×	_ = tokio::signal::ctrl_c() => {}
75	3×	_ = term.recv() => {}
76		}
77		}
78		#[cfg(not(unix))]
79		let _ = tokio::signal::ctrl_c().await;
80	3×	}

`/`	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.3%

Keyboard