diff --git a/docs/web-ui/dashboard.md b/docs/web-ui/dashboard.md
index 4a77e131..aa74c19d 100644
--- a/docs/web-ui/dashboard.md
+++ b/docs/web-ui/dashboard.md
@@ -794,11 +794,15 @@ the per-agent `⋮` menu and the bulk selection bar.
 bulk) carries a `stop gracefully — let the agent finish its turn
 and flush state before the container stops` checkbox. When ticked,
 the action POSTs `/kill/<name>?graceful=1` (the bulk path appends
-the flag per-agent); unticked is today's instant hard stop
-(`/kill/<name>` with no query). NOTE: the per-agent quiesce is
-still being implemented (see the graceful-agent-stop tracker) — the
-flag is accepted now so the wire shape is stable, but the backend
-currently treats a graceful request the same as a hard stop.
+the flag per-agent); unticked is the instant hard stop
+(`/kill/<name>` with no query). The backend enqueues a
+`GracefulStop` rebuild-queue transient: the harness runs one
+stop-checkpoint turn (so the agent can flush `/state`) and then
+exits, with a 3-minute timeout that falls back to a hard stop. The
+quiescing progress surfaces through the same rebuild-queue
+transient + build log the card already reads for a rebuild. (Note:
+the `hivectl --graceful` CLI flag is still a no-op pending a
+separate gating change — only the dashboard / HTTP path is live.)
 
 ### Topology tree