gioser

sergio/takana

> Una distribución Linux construida con un laboratorio funcional y hermético en el > sótano, y una terminal mutable, clásica y anárquica en el piso de arriba — diseñada > desde el suelo para que una IA programadora entienda, modifique y co…

TOML 815Rust 56Shell 37Markdown 291229 Definitions

⎇ 42288230f9560814e356586d8b9eeb36747b95fc crates/hammerd/src/main.rs Rust · 162 lines · 6.3 KB History Who touched what raw

Fase 5: política de caps del bus desde agent-caps.toml 42288230f · Sergio ·

1//! `hammerd` — daemon de hammer. Tres responsabilidades:
2//!   1. Diario de mutaciones: fanotify sobre /bin,/sbin,/lib,/etc → `hammer-journal`.
3//!   2. FIFO de control humano: `/run/init.control` (texto crudo, una línea por comando).
4//!   3. Bus de agente: `/run/agent.sock` (JSON-líneas, SO_PEERCRED). Ver `docs/07-agent-bus.md`.
5//!
6//! Cada subsistema vive en su thread. Si uno falla en init (típicamente el watcher sin
7//! CAP_SYS_ADMIN), los demás siguen arrancando: el daemon en dev puede correr sin sudo y aún
8//! así probar el bus.
9
10use std::path::PathBuf;
11use std::thread;
12
13use clap::Parser;
14
15mod bus;
16mod control;
17mod events;
18mod watcher;
19
20#[derive(Parser)]
21#[command(name = "hammerd", version, about = "Daemon de hammer: bus de agente + diario.")]
22struct Args {
23    /// Socket del bus de agente.
24    #[arg(long, default_value = "/run/agent.sock")]
25    agent_sock: String,
26    /// FIFO de control humano del init.
27    #[arg(long, default_value = "/run/init.control")]
28    init_control: PathBuf,
29    /// Directorio del diario de mutaciones.
30    #[arg(long, default_value = "/var/lib/hammer/journal")]
31    journal: String,
32    /// Directorio raíz de overlays (para que el watcher pueda filtrar eventos bajo overlays
33    /// activos). Default coincide con `hammer try`.
34    #[arg(long, default_value = hammer_overlay::DEFAULT_STATE_ROOT)]
35    overlay_state_root: String,
36    /// Directorios extra a vigilar; si vacío, usa los defaults del FHS (SDD 05 §2).
37    #[arg(long = "watch")]
38    extra_watch: Vec<PathBuf>,
39    /// Store CAS donde sellar artefactos de COMPILE.
40    #[arg(long, default_value = "/store")]
41    store: PathBuf,
42    /// Modo dev: desactiva el watcher fanotify (útil cuando hammerd corre sin CAP_SYS_ADMIN
43    /// y sólo queremos probar el bus). Igual que arrancar sin permisos, pero explícito.
44    #[arg(long)]
45    no_watcher: bool,
46    /// Fichero de política de capacidades del bus. Si existe, sustituye a la política por
47    /// defecto (misma-UID ⇒ casi todo; otros ⇒ query). Ver `docs/07-agent-bus.md` §4.
48    #[arg(long, default_value = "/etc/hammer/agent-caps.toml")]
49    agent_caps: PathBuf,
50}
51
52fn main() -> anyhow::Result<()> {
53    tracing_subscriber::fmt()
54        .with_writer(std::io::stderr)
55        .with_env_filter(
56            tracing_subscriber::EnvFilter::try_from_default_env()
57                .unwrap_or_else(|_| "info".into()),
58        )
59        .init();
60
61    let args = Args::parse();
62    tracing::info!(
63        agent_sock = %args.agent_sock,
64        init_control = %args.init_control.display(),
65        journal = %args.journal,
66        store = %args.store.display(),
67        "hammerd: arranque"
68    );
69
70    let event_bus = events::EventBus::new();
71
72    // FIFO de control humano: lo creamos siempre que se pueda (no es fatal).
73    let init_fifo_ok = match control::ensure_fifo(&args.init_control) {
74        Ok(path) => {
75            let reader_path = path.clone();
76            thread::Builder::new()
77                .name("init-ctl-reader".into())
78                .spawn(move || {
79                    if let Err(e) = control::run_reader(&reader_path) {
80                        tracing::warn!(error = %e, "init-ctl-reader: terminó");
81                    }
82                })
83                .ok();
84            true
85        }
86        Err(e) => {
87            tracing::warn!(error = %e, "init-control: no pude crear FIFO; INIT del bus fallará");
88            false
89        }
90    };
91
92    // Watcher fanotify: opcional. Si falla (no caps), el daemon sigue con el bus solo.
93    if !args.no_watcher {
94        let journal = hammer_journal::Journal::open(&args.journal)?;
95        let mut dirs = watcher::default_watch_dirs();
96        dirs.extend(args.extra_watch.clone());
97        let overlay_root = PathBuf::from(&args.overlay_state_root);
98        let bus_for_watcher = event_bus.clone();
99        match watcher::Watcher::start_with_events(
100            &dirs,
101            journal,
102            Some(overlay_root),
103            Some(bus_for_watcher),
104        ) {
105            Ok(w) => {
106                tracing::info!("watcher fanotify activo");
107                thread::Builder::new()
108                    .name("watcher".into())
109                    .spawn(move || {
110                        if let Err(e) = w.run_forever() {
111                            tracing::warn!(error = %e, "watcher: terminó con error");
112                        }
113                    })
114                    .ok();
115            }
116            Err(e) => {
117                tracing::warn!(
118                    error = %e,
119                    "watcher fanotify NO arrancó; daemon sigue (sin diario en este run)"
120                );
121            }
122        }
123    } else {
124        tracing::info!("--no-watcher: omitiendo fanotify");
125    }
126
127    // Bus de agente: bloqueante en este thread. Si falla, fin del daemon.
128    // Política de caps: del fichero si existe, si no la heurística por-UID por defecto.
129    let policy = match hammer_core::AgentCapsConfig::load(&args.agent_caps) {
130        Ok(Some(cfg)) => {
131            tracing::info!(path = %args.agent_caps.display(), rules = cfg.rule.len(),
132                "bus: política de caps cargada de fichero");
133            bus::policy_from_config(cfg)
134        }
135        Ok(None) => {
136            tracing::info!(path = %args.agent_caps.display(),
137                "bus: sin fichero de caps; uso la política por defecto (por-UID)");
138            bus::default_policy()
139        }
140        Err(e) => {
141            // Config presente pero inválida: fallar cerrado sería más seguro, pero romper el
142            // arranque del daemon por un typo es peor en la práctica. Avisamos fuerte y caemos
143            // a la política por defecto (restrictiva para no-dueños).
144            tracing::error!(path = %args.agent_caps.display(), error = %e,
145                "bus: fichero de caps inválido; uso la política por defecto");
146            bus::default_policy()
147        }
148    };
149    let ctx = bus::BusContext {
150        store_root: args.store,
151        init_control: if init_fifo_ok {
152            args.init_control
153        } else {
154            // Apuntamos a un path inexistente: cualquier INIT fallará con "init_send_failed"
155            // y un mensaje claro. Mejor que callar.
156            PathBuf::from("/dev/null/init-control-missing")
157        },
158        events: event_bus,
159    };
160    bus::serve_agent_bus(std::path::Path::new(&args.agent_sock), policy, ctx)?;
161    Ok(())
162}