refactor: no comments left - one-line module docstrings, contracts on public fields only; jobs/job.py; example config and README

src/beaver_gateway/frontends/api/frontend.py

@@ -1,18 +1,7 @@
-"""``ApiFrontend`` - ``/api/*``: conversations, SSE, sessions, usage, limits (§3.9).
+"""``ApiFrontend`` - ``/api/*``: conversations, SSE, sessions, usage, limits.
 
 Bearer scope ``api``; token and audit management need ``admin``. Every
-write goes through ``core/conversations``; the frontend only shapes JSON.
-``/api/events`` and ``/api/conversations/{id}/events`` replay the gateway
-bus as SSE with the same keepalive the markdown frontend uses, so a proxy
-never sees a silent socket.
-
-Usage figures come from the ``usage`` table (one row per turn; API-price
-``cost_usd`` and per-model ``model_usage`` are per-turn deltas of the SDK's
-cumulative ``ResultMessage`` counters, see ``storage.append_usage``);
-subscription quotas come from ``rate_limits``
-(``RateLimitEvent``). The quota covers the whole subscription, so
-``/api/limits`` puts the gateway's own spend for the window next to it
-for calibration by eye.
+write goes through conversations/service.py; the frontend only shapes JSON.
 """
 
 from __future__ import annotations