//! Passive APT observations for installations with a configured planning source. use anyhow::{Context, Result}; use rmm_privileged_helper::{Binding, readiness}; use std::path::Path; /// Called only by the periodic blocking inventory worker, never heartbeat or a /// caller-selected live query. Failure retains honest unknown/not_configured. pub fn planning_observation(binding: Option<&Binding>) -> serde_json::Value { let result = (|| -> Result { let binding = binding.context("APT_PLANNING_NOT_CONFIGURED")?; let path = std::env::var_os("RMM_APT_HELPER_PROOF_FILE").context("APT_PLANNING_NOT_CONFIGURED")?; let pin = readiness::Pin::read(Path::new(&path), binding)?; let socket = std::env::var_os("RMM_APT_HELPER_SOCKET").context("APT_PLANNING_NOT_CONFIGURED")?; readiness::planning(Path::new(&socket), binding, &pin) .or_else(|_| readiness::planning_for_recovery(Path::new(&socket), binding, &pin))? .planning .context("APT_PLANNING_UNAVAILABLE") })(); match result { Ok(planning) => { let recovery = planning.native_recovery.is_some(); serde_json::json!({"scope":if recovery{"linux.apt.recovery-planning"}else{"linux.apt.planning"}, "source_id":if recovery{"root-helper:apt_recovery_planning_v1"}else{"root-helper:apt_planning_v1"}, "observed_at":planning.observed_at, "quality":"valid", "completeness":"complete", "truncated":false, "data":planning}) } Err(_) => { serde_json::json!({"scope":"linux.apt.planning", "source_id":"root-helper:apt_planning_v1", "observed_at":chrono::Utc::now(), "quality":"unknown", "completeness":"unknown", "truncated":false, "error_code":if binding.is_none() || std::env::var_os("RMM_APT_HELPER_SOCKET").is_none(){"APT_PLANNING_NOT_CONFIGURED"}else{"APT_PLANNING_UNAVAILABLE"}, "data":null}) } } } #[cfg(test)] mod tests { use super::*; #[test] fn passive_planning_without_binding_is_honest_unknown_without_data() { let observation = planning_observation(None); assert_eq!(observation["scope"], "linux.apt.planning"); assert_eq!(observation["quality"], "unknown"); assert_eq!(observation["error_code"], "APT_PLANNING_NOT_CONFIGURED"); assert!(observation["data"].is_null()); assert!(observation.get("received_at").is_none()); } }