diff --git a/hive-sh4re/src/lib.rs b/hive-sh4re/src/lib.rs
index 8809c44d..c970f4f7 100644
--- a/hive-sh4re/src/lib.rs
+++ b/hive-sh4re/src/lib.rs
@@ -40,11 +40,10 @@ pub enum HostRequest {
     Approve { id: i64 },
     /// Deny a pending request by id.
     Deny { id: i64 },
-    /// Move an agent in the topology tree (#486). Pass `new_parent =
-    /// None` to promote the agent to root, or `Some(name)` to set a
-    /// new parent. Refuses cycles, unknown agents, and any attempt
-    /// to reparent the manager (which is structurally root).
-    /// Pure topology-json edit today; bind-mount work follows in #361.
+    /// Move an agent in the topology tree. `new_parent = None`
+    /// promotes the agent to root, `Some(name)` sets a new parent.
+    /// Validation rules + bind-mount caveat documented in
+    /// `docs/agent-hierarchy.md::Current state`.
     SetParent {
         child: String,
         new_parent: Option<String>,