hive-c0re: split OpenAPI summary/description, move param docs to params

utoipa splits a handler's doc comment on the first blank `///` line:
everything before it becomes the OpenAPI `summary` (shown in Swagger
UI's collapsed endpoint-list row), everything after becomes the
`description` (only shown once that row is expanded). With no blank
line, the whole doc comment becomes the summary and the description is
empty — which is what every handler in hive-c0re/src/dashboard/ was
doing, so the all-endpoints list showed full multi-sentence prose next
to every route instead of a short one-liner.

For every `#[utoipa::path(...)]`-annotated handler across the 19 files
in that module:

- Inserted a blank `///` line after the first short sentence/clause so
  utoipa's split produces a real summary + description, where the doc
  comment had more to say. Left already-short single-clause docs alone
  (nothing to split).
- Where a query struct derives `IntoParams`, moved param prose that
  duplicated a field's own doc comment out of the handler doc (the
  field already documents itself in the generated spec), or added a
  field doc where the handler explained a param that had none.

No behavior changes — doc comments and `params()` description text
only. Verified `cargo build -p hive-c0re` (clean) and `nix fmt` (zero
changes) after.

Closes #2969

hive-c0re/src/dashboard/misc_api.rs

@@ -16,6 +16,7 @@ use crate::container_stats::ContainerResource;
 use crate::hive_stats::HiveStats;
 
 /// Unread operator-directed messages for the dashboard's Y3R C4LL inbox.
+///
 /// Returns messages addressed to `"operator"` that haven't been
 /// acked yet (the operator clears them via the existing
 /// `POST /api/agent/operator/mark-all-read`). Newest-first; path-shaped
@@ -72,12 +73,14 @@ pub(super) async fn api_operator_inbox(State(state): State<AppState>) -> Respons
 
 #[derive(Deserialize, IntoParams)]
 pub(super) struct StatsHiveQuery {
+    /// Stats window; defaults to `24h`.
     window: Option<String>,
 }
 
 /// Hive-wide turn-stats rollup for the dashboard swarm-stats view.
+///
 /// Aggregates every agent's `hyperhive-turn-stats.sqlite` read-only
-/// (skips missing/unreadable ones). Window defaults to `24h`.
+/// (skips missing/unreadable ones).
 #[utoipa::path(
     get,
     path = "/api/stats-hive",
@@ -97,8 +100,10 @@ pub(super) async fn api_stats_hive(
     .into_response()
 }
 
-/// Live per-agent-container CPU + memory load from cgroup v2. Samples
-/// CPU over a short interval (~200 ms), so this call briefly awaits.
+/// Live per-agent-container CPU + memory load from cgroup v2.
+///
+/// Samples CPU over a short interval (~200 ms), so this call briefly
+/// awaits.
 #[utoipa::path(
     get,
     path = "/api/container-resources",
@@ -110,8 +115,9 @@ pub(super) async fn api_container_resources() -> Response {
 }
 
 /// `GET /api/audit-log` — most-recent agent-initiated privileged-action
-/// audit entries, newest first (server-clamped to 500). Backs the
-/// operator dashboard's audit view. Returns
+/// audit entries, newest first (server-clamped to 500).
+///
+/// Backs the operator dashboard's audit view. Returns
 /// `{ "entries": [AuditEntry…], "total": N }` so the UI can show
 /// "latest 500 of N" rather than silently capping. `ts_unix` is in
 /// **seconds**.
@@ -138,11 +144,12 @@ pub(super) async fn api_audit_log(State(state): State<AppState>) -> Response {
 }
 
 /// Operator-driven "clear this agent's inbox" — backs the side-panel
-/// "mark all read" button. Marks every message addressed to the
-/// agent as acked (backfilling `delivered_at` for any still-pending
-/// rows so vacuum can collect them). Returns `{ "marked": N }` so the
-/// frontend can show "cleared N messages" feedback without an extra
-/// fetch.
+/// "mark all read" button.
+///
+/// Marks every message addressed to the agent as acked (backfilling
+/// `delivered_at` for any still-pending rows so vacuum can collect
+/// them). Returns `{ "marked": N }` so the frontend can show "cleared
+/// N messages" feedback without an extra fetch.
 #[utoipa::path(
     post,
     path = "/api/agent/{name}/mark-all-read",