hivectl: note that stop --graceful is not yet effective

Until the per-agent quiesce lands, --graceful falls through to a hard
stop. Help-text the limitation so an operator passing the flag isn't
misled into thinking the agent quiesced.
This commit is contained in:
atlas 2026-06-19 00:33:28 +02:00 committed by mara
commit 465dd2d433

View file

@ -113,6 +113,11 @@ enum Cmd {
scope: ScopeArgs,
/// Gracefully quiesce each agent (finish the current turn, drain
/// the inbox) before stopping, instead of a hard stop.
///
/// NOTE: not yet effective — the per-agent quiesce is still being
/// implemented (see the graceful-agent-stop tracker), so today
/// this falls through to a hard stop. The flag is accepted now so
/// the wire/CLI shape is stable when the quiesce lands.
#[arg(long)]
graceful: bool,
/// Path to the hive-c0re host admin socket.