fix(#2003): reword root auto-start comment (not 'required infra'; opt-out is a separate host setting)

This commit is contained in:
damocles 2026-06-26 17:23:17 +02:00 committed by mara
commit c16eff0d5c

View file

@ -195,14 +195,14 @@ pub async fn ensure_root_agent(coord: &Arc<Coordinator>) -> Result<()> {
} else { } else {
tracing::debug!("manager container already present"); tracing::debug!("manager container already present");
} }
// The root/manager is required infrastructure — it must be running // hive-c0re auto-manages the root/manager by default, so a
// after every hive-c0re (re)start. A previous bring-up can leave it // present-but-stopped root (e.g. a first-start failure on a fresh
// *created but stopped* (e.g. a first-start failure on a fresh // install) is brought back up here: the startup sweep's rebuild only
// install): the startup sweep's rebuild only restarts a container // restarts a container that was already running, so without this it
// that was already running, so without this it stays down until a // stays down until a manual `nixos-container start`. The sub-agent
// manual `nixos-container start`. Unlike sub-agents there is no // `was_running` guard is intentionally left untouched. (An operator
// "deliberately stopped root" intent to honour, so start it // opt-out of this whole auto-management is tracked as a separate
// unconditionally when it isn't running. // host setting.)
if !lifecycle::is_running(MANAGER_NAME).await { if !lifecycle::is_running(MANAGER_NAME).await {
tracing::info!("manager container present but not running — starting"); tracing::info!("manager container present but not running — starting");
if let Err(e) = lifecycle::start(MANAGER_NAME).await { if let Err(e) = lifecycle::start(MANAGER_NAME).await {