hive-c0re: annotate remaining dashboard routes with utoipa

hive-c0re/src/dashboard/tombstones.rs

@@ -104,6 +104,19 @@ pub(crate) async fn emit_tombstones_snapshot(coord: &Arc<Coordinator>) {
     });
 }
 
+/// `POST /api/purge-tombstone/{name}` — wipe a tombstoned agent's
+/// retained state dir + applied config dir entirely.
+#[utoipa::path(
+    post,
+    path = "/api/purge-tombstone/{name}",
+    params(("name" = String, Path, description = "agent name")),
+    responses(
+        (status = 200, description = "purged", body = String),
+        (status = 400, description = "bad agent name"),
+        (status = 500, description = "a live container still exists, or a dir removal failed"),
+    ),
+    tag = "tombstones"
+)]
 pub(super) async fn post_purge_tombstone(
     State(state): State<AppState>,
     AxumPath(name): AxumPath<String>,