docs: handbook states what the code does (fact sweep fixes)

docs/2-handbook/hives/dashboard.md

@@ -10,7 +10,7 @@ matrix accounts, the controller's job graph — are on the
 
 hive-c0re serves the dashboard at `/`.
 It has a fixed chrome header at the top and a `<main>` that shows exactly
-one tab pane at a time. The URL hash (`#agents`, `#rebuild`, `#meta`,
+one tab pane at a time. The URL hash (`#agents`, `#rebuild`,
 `#kept`) drives which pane is
 active; hash changes don't reload the page.
 
@@ -428,7 +428,8 @@ the pages menu's **api docs** entry), with the raw spec at `/api/openapi.json`.
 It's a growing supplement, not yet a full replacement for the list
 below — some endpoints aren't in it yet.
 
-- `POST /api/{rebuild,kill,restart,start,destroy}/{name}` — lifecycle.
+- `POST /api/{rebuild,kill,restart,start,destroy,pause,resume}/{name}` —
+  lifecycle.
   `destroy` accepts `purge=on` to also wipe state dirs.
 - `POST /api/purge-tombstone/{name}` — wipe a tombstone's state dirs.
 - `POST /api/rebuild-queue/{id}/cancel` — drop a `Queued` entry.
@@ -441,6 +442,10 @@ below — some endpoints aren't in it yet.
   not yet delivered and sets `acked_at = now`. Returns
   `{ "marked": N }`. Agent name validated against
   `[a-z0-9_-]`, 1-63 chars; 400 on bad input.
+- `GET /api/build-logs?limit=N` — most-recent build log headers across
+  all agents (`limit` defaults to 30).
+- `GET /api/build-log/{node_id}` and `/api/build-log/{node_id}/raw` — the
+  build log of one job-queue node, as JSON and as `text/plain`.
 - `GET /api/build-logs/{agent}?limit=N` — most-recent build log
   headers for one agent, newest first. Returns
   `Vec<BuildLogHeader>` (JSON): `id`, `agent`, `kind`, `cmdline`,
@@ -458,11 +463,6 @@ below — some endpoints aren't in it yet.
 - `GET /api/build-logs/id/{id}/raw` — raw concatenated
   stdout+stderr as `text/plain`. Works on both finished and in-progress
   build logs.
-- `GET /api/reminders` — list pending reminders for the
-  dashboard's queued-reminders panel.
-- `POST /api/cancel-reminder/{id}` — hard-delete a pending reminder.
-- `POST /api/retry-reminder/{id}` — re-arm a reminder whose delivery
-  failed (clears the failure state so the scheduler retries).
 
 - `GET /api/dashboard/stream` — unified live event channel:
   broker `sent` / `delivered`, plus the mutation events listed
@@ -498,12 +498,6 @@ payload):
   terminal-history trim). Unlike the snapshot events below it ships
   no state at all: the client re-fetches `GET /api/jobq/graph`, which
   is where it reads the queue from cold too.
-- `reminders_changed` (seq, reminders: `Vec<PendingReminder>`) —
-  full snapshot of all pending reminders. Emitted after every
-  reminder mutation: agent `remind` calls (`agent_server`),
-  operator cancel / retry (`/api/system/reminders/*`), `cancel_loose_end`
-  with Reminder kind, and the scheduler tick after each delivery
-  batch (`reminder_scheduler`).
 - `tombstones_changed` (seq, tombstones: `Vec<TombstoneView>`) —
   full snapshot of destroyed-but-state-kept agents. Emitted on
   destroy, purge, and revive. The K3PT ST4T3 tab subscribes.

docs/2-handbook/hives/hivectl.md

@@ -63,9 +63,10 @@ resume drains the backlog rather than dropping it. Points worth knowing:
 - **Sticky.** The marker lives on the persistent harness mount, so a
   paused agent stays paused across a container restart — and pausing a
   _stopped_ agent makes it come up parked.
-- **Not a DAG.** Unlike `restart`/`stop`, there's no container operation
-  to sequence, so it applies immediately with nothing to wait on.
-- **Stopping a paused agent is still fast.** hivectl skips the graceful-stop
+- **A DAG, with an acknowledgement wait.** `pause` creates a DAG whose drain
+  node waits for the harness to acknowledge the marker (giving up after
+  3 minutes); `--no-wait` returns once the DAG exists.
+- **Stopping a paused agent is still fast.** hive-c0re skips the graceful-stop
   handshake for a paused agent (it would never answer), which
   is safe precisely because the pause check sits at the top of the loop:
   a paused agent has no turn in flight to checkpoint.