diff --git a/docs/tools/hivectl-cli.md b/docs/tools/hivectl-cli.md
index 8245acc7..8587c403 100644
--- a/docs/tools/hivectl-cli.md
+++ b/docs/tools/hivectl-cli.md
@@ -346,7 +346,7 @@ Restart containers hive-wide — `stop` then `start` over the same scope. Bare `
 * `--forge` — The forge container (`hive-forge`)
 * `--gateway` — The gateway container (`hive-gateway`)
 * `--matrix` — The matrix container (`hive-matrix`)
-* `--graceful` — Gracefully quiesce each agent on the stop half (see `stop --graceful`). NOTE: not yet effective — falls through to a hard stop until the per-agent quiesce lands
+* `--graceful` — Gracefully quiesce each agent on the stop half (see `stop --graceful`). Applies to agents only
 
 
 
diff --git a/hive-c0re/src/bin/hivectl.rs b/hive-c0re/src/bin/hivectl.rs
index 50d72e50..618258c0 100644
--- a/hive-c0re/src/bin/hivectl.rs
+++ b/hive-c0re/src/bin/hivectl.rs
@@ -144,8 +144,7 @@ enum Cmd {
         #[command(flatten)]
         scope: ScopeArgs,
         /// Gracefully quiesce each agent on the stop half (see
-        /// `stop --graceful`). NOTE: not yet effective — falls through to a
-        /// hard stop until the per-agent quiesce lands.
+        /// `stop --graceful`). Applies to agents only.
         #[arg(long)]
         graceful: bool,
     },