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

src/beaver_gateway/frontends/markdown/mirror.py

@@ -1,13 +1,8 @@
-"""Vault files for ``deep`` conversations that were not typed into a file (§3.10).
+"""Vault files for ``deep`` conversations that were not typed into a file.
 
-``materialize`` is the markdown frontend's answer to ``spawn(kind=deep)``:
-a new file in the vault with ``agent`` + ``conversation_id`` frontmatter
-and the ``(markdown, path)`` binding. ``run`` tails the gateway bus and
-appends every ``reply`` of a markdown-bound conversation to its file -
-the seed turn of a spawn, a message posted through ``/api``, a turn
-that came in over ``/v1/messages`` - and stamps the same exchange into
-the canonical history, so a continuation typed in Obsidian aligns
-against the store and resumes the same SDK session instead of reseeding.
+``materialize`` creates the file for a conversation spawned elsewhere;
+``run`` appends replies produced by other origins and keeps the canonical
+history in sync so a continuation typed in Obsidian resumes the same session.
 """
 
 from __future__ import annotations