refactor(fe): trim >30-line comment blocks (second pass, #2077)

frontend/packages/shared/src/terminal.js

@@ -3,54 +3,9 @@
 // owns scroll behaviour, animation suppression on backfill, and the
 // EventSource lifecycle.
 //
-// Usage:
-//
-//   import { create, linkify } from '@hive/shared/terminal.js';
-//
-//   create({
-//     logEl: document.getElementById('msgflow'),
-//     historyUrl: '/messages/history?limit=200',  // optional
-//     streamUrl:  '/messages/stream',
-//     renderers: {
-//       sent:      (ev, api) => api.row('msgrow sent', ...),
-//       delivered: (ev, api) => api.row('msgrow delivered', ...),
-//       _default:  (ev, api) => api.row('note', JSON.stringify(ev)),
-//     },
-//     onLiveEvent: (ev) => { /* live-only side effects (notif, state pokes) */ },
-//     onAnyEvent:  (ev, { fromHistory }) => { /* runs for every event in
-//       both backfill replay and live — use for derived views that need
-//       the full picture (e.g. a per-recipient inbox built from broker
-//       events) */ },
-//     onBackfillDone: (count) => { /* one-shot after history replay */ },
-//     onStreamOpen: () => { /* fires on every EventSource (re)connect —
-//       use to re-sync snapshot-derived state after a reconnect gap */ },
-//     pillAnchor: document.getElementById('msgflow').parentElement,
-//   });
-//
-// Renderers receive (ev, api) where api exposes:
-//
-//   api.row(cls, text, icon?)           → appends a flat <div class="row cls">;
-//                                          optional `icon` lands in a
-//                                          fixed-width `.row-glyph` cell
-//   api.details(cls, summary, body, icon?) → appends <details class="row cls">
-//                                          with a <pre.tool-body>; `icon` (if
-//                                          given) shares the `.row-glyph` column
-//   api.detailsDiff(cls, summary, body, icon?) → ditto but body is
-//                                          line-coloured by leading "+ "/"- "
-//   api.placeholder(text)               → replaces log content with a single
-//                                          muted "(placeholder)" row, cleared
-//                                          on the next real row
-//   api.fromHistory                     → true while backfill is replaying
-//
-// Each kind is dispatched to `renderers[ev.kind]`; unknown kinds fall
-// through to `renderers._default` (which itself defaults to a JSON-dump
-// note row). The convention is that the SSE/history endpoints emit
-// objects with a `kind` field.
-//
-// Backfill is best-effort: if `historyUrl` is unset or the fetch fails,
-// we skip straight to SSE. The optional `onBackfillDone(count)` hook
-// fires after replay finishes (or after a failed/skipped fetch with
-// count=0); pages use it to set state flags from the replayed history.
+// create(opts) — full options list + renderer api (api.row, api.details,
+//   api.detailsDiff, api.placeholder, api.fromHistory) + behavioral notes:
+//   docs/web-ui/shape.md §Shared terminal pane.
 
 const NEAR_BOTTOM_PX = 48;
 // Scroll distance from the top of the log that triggers an automatic