strom-research 1.28.0-beta.2 → 1.28.0

package/assets/strom-doc/cs/R11-material-from-the-user.md

@@ -21,12 +21,17 @@ v něm skutečně stojí.
     ([R7.8](R7-when-the-agent-works.md#R7.8)).
 - **Jen metodika:** jména a místa se zapisují tak, jak jsou napsaná; sjednocují se jen data. Úkol se zavře s tím,
   co z podkladu vzešlo, a s dalšími úkoly: kde hledat záznamy, které vodítka doloží.
+- **Proč:**
+  - 20 obrázků: skeny matriky nepatří do historie stromu jako stovky úkolů podklady. Rodinné doklady jedné složky
+    bývají jednotky až desítky souborů; víc než 20 obrázků už obvykle jsou skeny knihy a zapíšou se jako kniha;
+  - 20 MB: historie stromu se nepřepisuje a jde se stromem při záloze a přenosu. Velké soubory (video, nekomprimované
+    skeny) by ji natrvalo zvětšily, proto leží ve sdíleném úložišti médií.
 - **Ovládání:** terminál: `strom intake <soubory nebo složky>`, `strom intake --text "…"` (co řekne uživatel),
   `strom input list`, `strom input show I…`. Aplikace: **Poslat materiál…**, **Přidat materiály…**
   ([A3.5](A3-evidence-in-the-app.md#A3.5)).
 - **Platí od:** výzkum 1.0.0
 
-<!-- zdroj: research:src/commands/intake.ts intake (description, BOOK_OF_SCANS=20, sha256 known, intakeTask) · research:src/core/media.ts MAX_IN_TREE=20 MB · research:assets/method/intake.md kroky 1, 4, 6, 7 -->
+<!-- zdroj: research:src/commands/intake.ts intake (description, BOOK_OF_SCANS=20, sha256 known, intakeTask) · research:src/core/media.ts MAX_IN_TREE=20 MB · commit ff18ac678 "a folder full of images is a book of scans" · commit e9386db84 · research:assets/method/intake.md kroky 1, 4, 6, 7 -->
 
 <a id="R11.2"></a>
 ## R11.2 Doklad je pramen, ostatní je vodítko
@@ -78,7 +83,8 @@ Složku, ZIP nebo krabici dokumentů poslanou z aplikace výzkum přijme jako je
 úkolech.
 
 - **Hlídá kód:**
-  - dávka se uzavře, když aplikace ohlásí, že je celá, nebo den po posledním souboru;
+  - dávka se uzavře, když aplikace ohlásí, že je celá, nebo den po posledním souboru (dávka z telefonu hodinu po
+    poslední fotce, [S5.4](S5-phone.md#S5.4));
   - pak se z ní stanou úkoly podklady po zhruba 25 souborech, podle složek, ve kterých soubory přišly. V Archivu
     Stromu úkoly čekají odložené;
   - soubory dávky se ukládají jako originály do sdíleného úložiště médií, ne do historie stromu. Co z nich agent
@@ -91,10 +97,15 @@ Složku, ZIP nebo krabici dokumentů poslanou z aplikace výzkum přijme jako je
   - skeny jedné knihy (mnoho číslovaných snímků) se nečtou soubor po souboru: zapíšou se jako kniha a čtou se
     z ní zápisy jako z každé knihy ([R8](R8-reading-scans.md));
   - úkol se zavře, až je každý jeho soubor zařazený; další část dávky je vlastní úkol.
-- **Proč:** cesta souboru v dávce hodně řekne (`Babička/Dopisy/1946.jpg`); co do rodiny nepatří, nemá se dostat do
-  stromu (metodika).
+- **Proč:**
+  - den po posledním souboru: aplikace posílá soubory po jednom. Dávka, o které nikdo neřekl, že je celá, se uzavře
+    s tím, co přišlo, aby nic nečekalo déle; den bez dalšího souboru znamená, že posílání skončilo. Stránka telefonu
+    se snadno zavře, aniž dávku předá, proto tam stačí hodina;
+  - 25 souborů: jeden úkol podklady přečte jedno sezení agenta a zhruba 25 souborů se do něj vejde;
+  - cesta souboru v dávce hodně řekne (`Babička/Dopisy/1946.jpg`); co do rodiny nepatří, nemá se dostat do stromu
+    (metodika).
 - **Ovládání:** terminál: `strom input batch` (dávky a kolik je roztříděno), `strom input sort I… --as
   source|document|photo|unrelated --person P…`. Aplikace: **Přidat materiály…** v menu výzkumu.
-- **Platí od:** výzkum 1.12.0
+- **Platí od:** výzkum 1.12.0; dávka z telefonu 1.18.0
 
-<!-- zdroj: research:src/core/batches.ts hlavička, BATCH_TASK_FILES=25 (od v1.12.0) · research:src/commands/intake.ts input batch done (--idle), input sort (unrelated --reason) · research:assets/method/intake.md "A batch from the Strom app" -->
+<!-- zdroj: research:src/core/batches.ts hlavička, BATCH_TASK_FILES=25 (od v1.12.0), BATCH_IDLE_MS, PHONE_BATCH_IDLE_MS (od v1.18.0) · research:src/commands/intake.ts input batch done (--idle), input sort (unrelated --reason) · research:assets/method/intake.md "A batch from the Strom app" -->

package/assets/strom-doc/cs/R3-verification-and-citation.md

@@ -35,7 +35,7 @@ ze všech pramenů údaje, ne jak dobrý je jeden pramen ([R3.2.1](#R3.2.1)).
 ### R3.1.1 Výchozí stupeň a citace, která ho zvedne
 
 - Údaj zapsaný bez `--status`: bez citace **Vodítko**; s citací aspoň jednoho pramene, který není slabý
-  ([R3.3](#R3.3)), **Pravděpodobné**; jinak Vodítko.
+  ([R3.3](#R3.3)), **Pravděpodobné**; jinak Vodítko. Od výzkumu 1.28.0 je slabý i rejstřík.
 - `strom cite` bez `--status` zvedne Vodítko na Pravděpodobné, když nový pramen není slabý. Jiný stupeň nemění.
 - Změna stupně přes `strom event edit --status` potřebuje `--reason`; citace se stupněm (`strom cite … --status`) ne.
 - Hlídá kód. **Platí od:** výzkum 1.0.0
@@ -51,18 +51,18 @@ Stupeň nesmí tvrdit víc, než dávají citace údaje. Kód to kontroluje při
 - **Hranice (hlídá kód),** v tomto pořadí:
   1. Pravděpodobné i Doložené potřebuje aspoň jednu citaci.
   2. Aspoň jedna citace musí být z pramene, který není slabý. Slabý je rodokmen (`--kind family-tree`), vzpomínka
-     (`--kind family-memory`) a autorské dílo (`--form authored`).
+     (`--kind family-memory`), autorské dílo (`--form authored`) a od výzkumu 1.28.0 rejstřík (`--kind index`).
   3. Doložené navíc potřebuje mezi citacemi z ne-slabých pramenů aspoň jednu s primární informací
      (`--information primary`): záznam psaný v době události někým, kdo to věděl. Informace u citace má přednost
      před informací u pramene.
 - **Jen metodika:** kód nekontroluje, že je pramen originál (`--form original`), že ho agent přečetl sám, že záznam
-  údaj uvádí přímo, ani slepé druhé čtení ([R3.5](#R3.5)). Doložené proto projde i u opisu nebo rejstříku
-  s primární informací.
+  údaj uvádí přímo, ani slepé druhé čtení ([R3.5](#R3.5)). Doložené proto projde i u opisu s primární informací
+  (u rejstříku do výzkumu 1.27.0 také).
 - **Ovládání:** terminál: `strom event add P… BIRT --date "…" --cite S… --information primary --status proven`.
   Odmítnutí řekne důvod a co místo toho (nechat Vodítko, `--status possible`, nebo `--status probable`).
 - **Platí od:** výzkum 1.0.0
 
-<!-- zdroj: research:src/core/evidence.ts:27 isWeak, :32 informationOf, :55-68 checkStatus · src/core/actions.ts:196-209 makeEvent, :648, :906 · src/commands/people.ts:745 -->
+<!-- zdroj: research:src/core/evidence.ts:27 isWeak, :32 informationOf, :55-68 checkStatus · src/core/actions.ts:196-209 makeEvent, :648, :906 · src/commands/people.ts:745 · od v1.28.0 evidence.ts isWeak (kind index), checkStatus "… or an index cannot make a fact" -->
 
 <a id="R3.2.1"></a>
 ### R3.2.1 Pramen: forma a informace
@@ -86,15 +86,20 @@ Stupeň nesmí tvrdit víc, než dávají citace údaje. Kód to kontroluje při
 Rodokmen, vzpomínka, rejstřík, katalog a online strom říkají, kde hledat. Nejsou dokladem údaje. Údaj z nich zůstává
 Vodítko, dokud ho nedoloží záznam.
 
-- **Hlídá kód:** rodokmen, vzpomínka a autorské dílo jsou slabé prameny: údaj jen z nich nikdy není Pravděpodobné
-  ani Doložené ([R3.2](#R3.2)). Převzatý rodokmen: [R11.3](R11-material-from-the-user.md#R11.3).
-- **Jen metodika:** rejstřík. Kód ho za slabý nepovažuje: s jeho citací dostane údaj bez `--status` stupeň
-  Pravděpodobné a s `--information primary` projde i Doložené. Metodika chce rejstřík jen k nalezení stránky;
-  zápis se čte v matrice. I chybějící zápis v rejstříku je jen vodítko: podobný tvar příjmení je kandidát.
+- **Hlídá kód:** rodokmen, vzpomínka, autorské dílo a rejstřík (`--kind index`) jsou slabé prameny: údaj jen
+  z nich nikdy není Pravděpodobné ani Doložené ([R3.2](#R3.2)). Údaj, který cituje jen rejstřík, zůstane Vodítko,
+  dokud se nepřečte a necituje samotný zápis; s citací zápisu je údaj zápisu. Převzatý rodokmen:
+  [R11.3](R11-material-from-the-user.md#R11.3).
+- **Hranice:** u úprav z aplikace se rejstřík počítá jako záznam: úprava údaje doloženého rejstříkem se stane
+  rozporem ([R5.2](R5-conflicts.md#R5.2)), nic se tiše nepřepíše.
+- **Jen metodika:** rejstřík slouží jen k nalezení stránky; zápis se čte v matrice. I chybějící zápis v rejstříku
+  je jen vodítko: podobný tvar příjmení je kandidát.
 - Materiál od uživatele (doklad, fotka, dopis, co řekne): [R11.2](R11-material-from-the-user.md#R11.2).
 - **Platí od:** výzkum 1.0.0
+- **Od výzkumu 1.28.0:** rejstřík hlídá kód jako slabý pramen (dřív jen metodika: s jeho citací dostal údaj
+  Pravděpodobné a s `--information primary` prošlo i Doložené).
 
-<!-- zdroj: research:assets/method/core.md:8-12 · locate.md:22-24 · link.md:6-12 · intake.md:9-16 · src/core/evidence.ts:27 isWeak · src/core/import.ts:1-7, :113-117 · src/commands/sources.ts:221 -->
+<!-- zdroj: research:assets/method/core.md:8-12 · locate.md:22-24 · link.md:6-12 · intake.md:9-16 · src/core/evidence.ts isWeak (kind index od v1.28.0), isCompiled (sync) · src/core/sync.ts isCompiled · src/core/import.ts:1-7, :113-117 · src/commands/sources.ts:221 · test/cli/index-weak.test.ts · commit 9685fcbe -->
 
 <a id="R3.4"></a>
 ## R3.4 Citace: výřez a přepis
@@ -105,17 +110,22 @@ Citace říká, kde přesně v prameni údaj stojí. Pramen je jeden zápis; ví
   zápisu, jak stojí, po řádcích, nepřečtené písmeno `[?]`), k tomu `--locator` (folio, strana, číslo zápisu)
   a u údaje `--quote`. Do pole (`--date`, `--house`, `--age`, jméno) jde jen to, co je přečtené jistě; nejisté jde
   do přepisu s `[?]` a do poznámky údaje.
+- **Jen metodika, od výzkumu 1.28.0:** zápis v jiném jazyce nebo písmu, než je jazyk výzkumu (latina, kurent,
+  polština, azbuka…), dostane vedle doslovného přepisu i překlad do jazyka výzkumu (`--translation`). Přepis zůstává
+  v jazyce zápisu. Aplikace překlad ukazuje sbalený pod přepisem
+  ([A3.1.1](A3-evidence-in-the-app.md#A3.1.1)).
 - **Hlídá kód:** nejvýš 3 výřezy na pramen (zápis a jeho pokračování přes zlom stránky). Chybějící výřez nebo přepis
   kód neodmítne, jen připomene u pramene na skenu: po `strom source add`, po `strom source edit` se snímkem nebo
   výřezem a při `strom task done` u pramenů, které úkol zapsal.
 - Starší prameny: výřez doplní `strom clips`, přepis `strom transcripts` (čtenáři, druhý pohled je zkontroluje).
-- **Ovládání:** terminál: `strom source add "…" --clip B…:57@x,y,w,h --transcript @notes/zapis.txt --locator "…"`.
+- **Ovládání:** terminál: `strom source add "…" --clip B…:57@x,y,w,h --transcript @notes/zapis.txt --translation
+  @notes/preklad.txt --locator "…"`; doplnění `strom source edit S… --translation "…"`.
   Aplikace ukazuje výřez zápisu vedle přepisu.
 - **Platí od:** výzkum 1.1.0 (výřez, `strom clips`, `strom transcripts`); přepis 1.0.0
 - **Od výzkumu 1.26.0:** nápověda volby `--clip` říká „další na každý zlom stránky, nejvýš 3“ (v 1.25.2 „druhý“).
   Pravidlo se nemění.
 
-<!-- zdroj: research:assets/method/recording.md:19-27, :55-62 · src/core/media.ts:285 MAX_CLIPS, :481 transcriptNote, :492 clipNote · src/commands/sources.ts:183, :214, :250, :893 · src/commands/tasks.ts:366-369 finishTask · src/commands/clips.ts · src/commands/transcripts.ts · HEAD commit 6bc7430b -->
+<!-- zdroj: research:assets/method/recording.md:19-27, :55-62 · src/core/media.ts:285 MAX_CLIPS, :481 transcriptNote, :492 clipNote · src/commands/sources.ts:183, :214, :250, :893 · src/commands/tasks.ts:366-369 finishTask · src/commands/clips.ts · src/commands/transcripts.ts · HEAD commit 6bc7430b · překlad: assets/method/recording.md "--translation", link.md krok 7, src/brief/brief.ts (Research language), src/commands/sources.ts:196 translation, src/gedcom/export.ts:557 (oddíl poznámky pramene „Překlad:“), commit a1ccd24e -->
 
 <a id="R3.5"></a>
 ## R3.5 Slepé druhé čtení
@@ -270,6 +280,15 @@ Vyprávění se píše z údajů pro rodinu. Co se nedoložilo, se nedomýšlí.
   - staré povolání a pojem, kterému čtenář nerozumí, se vysvětlí; píše se v jazyce výzkumu;
   - formát textu: jen odstavce, podnadpisy, odrážky, tučné písmo a kurzíva. Ostatní (odkazy, tabulky, citace,
     číslované seznamy) aplikace podle metodiky ukáže jako prostý text.
+- **Proč:**
+  - nic se nedomýšlí: vyprávění je pro rodinu a stojí na dokladech. Co by znělo pravděpodobně, ale doložené není,
+    by se v rodině začalo brát jako fakt;
+  - pozadí: je doložené pro místo, ne pro člověka; jako příčina toho, co osoba udělala, by bylo domněnkou vydávanou
+    za fakt. Pramen pozadí vyprávění jmenuje (`--source`), aby šel ověřit;
+  - vyprávění páru: společný život se vypráví jednou, u páru, aby se tentýž život nevyprávěl dvakrát a verze se
+    nerozcházely;
+  - formát: aplikace Strom ukáže jen odstavce, podnadpisy, odrážky, tučné písmo a kurzívu; ostatní by čtenář viděl
+    jako prostý text se značkami.
 - Schválení a nová verze schváleného vyprávění: [R6.3.2](R6-awaiting-action.md#R6.3.2).
 - **Ovládání:** terminál: `strom story set P… --text @notes/… --fact E… --source S… --note "co je odvozené"`
   (vyprávění páru na rodině F…).

package/assets/strom-doc/cs/R6-awaiting-action.md

@@ -24,7 +24,8 @@ Seznam se pokaždé spočítá z výzkumu, nic se do něj nezapisuje.
 - Řádek **Čeká: N (z toho X jen tady v terminálu, Y čeká na odpověď)** dělí počet jako aplikace. Číslo aplikace je
   N bez položek jen pro terminál a bez odeslaných dotazů.
 - Jen v terminálu jsou stromy poslané z aplikace (**Aplikace Strom**), otázky ke čtení snímků (**Čtení snímků**),
-  rozpory (**K rozhodnutí – rozpory**, viz [R5](R5-conflicts.md)) a mírnější podmínky archivu. V přehledu **Co čeká** jdou napřed pod
+  rozpory (**K rozhodnutí – rozpory**, viz [R5](R5-conflicts.md)), hypotézy k rozhodnutí (od výzkumu 1.28.0) a mírnější
+  podmínky archivu. V přehledu **Co čeká** jdou napřed pod
   nadpisem **Jen tady v terminálu (v aplikaci Strom nejsou)**, za nimi **I v aplikaci Strom**.
 - Stránka pro telefon jen čte: bez položek jen pro terminál, s vyprávěním, napřed 20 položek, nejvýš 200 najednou.
   Píše **Rozhodnout jde na počítači v Přehledu výzkumu.**
@@ -80,12 +81,12 @@ vidět**, **Jen prohlížet** nebo **Nejde to**, s nepovinnou poznámkou.
 ## R6.3 Rozhodnutí
 
 Oddíl **rozhodnutí** sbírá otázky, které zdržují agenta: svolení archivu, stahovače k potvrzení, mírnější
-podmínky, ověřit web, vyprávění, místo (viz [R4](R4-places.md)), rozpor (viz [R5](R5-conflicts.md)), stromy z aplikace a čtení snímků. Rozhodnutí
-jdou v seznamu první.
+podmínky, ověřit web, vyprávění, místo (viz [R4](R4-places.md)), rozpor (viz [R5](R5-conflicts.md)), hypotézu (viz [R6.3.4](#R6.3.4)), stromy
+z aplikace a čtení snímků. Rozhodnutí jdou v seznamu první.
 
 - **Ovládání:** terminál: **Co čeká** → položka; `strom allow archive --way`, `strom place answer`,
   `strom conflict resolve`, `strom media calibrate --answer`.
-- **Platí od:** výzkum 1.14.0. Rozpory od 1.20.0, místa od 1.25.0.
+- **Platí od:** výzkum 1.14.0. Rozpory od 1.20.0, místa od 1.25.0, hypotézy od 1.28.0.
 
 <!-- zdroj: research:src/core/waiting.ts:51-65 SECTION, :75 DECIDE_RANK · src/cli/menu-waiting.ts:486 decideConflictHere, :518 decidePlace, :712 decideTune · CHANGELOG.cs.md 1.20.0, 1.25.0 -->
 
@@ -124,6 +125,19 @@ jdou v seznamu první.
 
 <!-- zdroj: research:HEAD src/core/waiting.ts:428-451 (group branches) · src/cli/menu-waiting.ts decideBranch · assets/lang/cs.json:2359 wait.group.branches -->
 
+<a id="R6.3.4"></a>
+### R6.3.4 Hypotézy k rozhodnutí
+
+- Hypotéza, jejíž rozhodnutí agent navrhl ([R10.3.1](R10-people-and-hypotheses.md#R10.3.1)), čeká ve skupině
+  **Hypotézy k rozhodnutí**: otázka, verze a návrh („Návrh: varianta B – …“). Volba: **Rozhodnout podle návrhu**,
+  **Rozhodnout jinak** (jiná verze, nebo žádná, s důvodem), **Nechat, jak je (návrh nepřijat)**.
+- **Hranice:** rozhoduje jen člověk ([R6.6](#R6.6)). Je jen v terminálu, aplikace Strom ji neukazuje
+  ([R6.1.1](#R6.1.1)). V Archivu Stromu skupina není.
+- **Ovládání:** terminál: **Co čeká** → položka, `strom hypothesis decide H… --proposed | --keep-open`.
+- **Platí od:** výzkum 1.28.0
+
+<!-- zdroj: research:src/core/waiting.ts (kind hypothesis, section decide, DECIDE_RANK 0, TERMINAL_ONLY hypotheses, actsAsArchive) · src/cli/menu-waiting.ts decideHypothesis · assets/lang/cs.json wait.group.hypotheses, ui.wait.hypothesis.proposed/accept/other/keep -->
+
 <a id="R6.4"></a>
 ## R6.4 Skupiny a pořadí
 
@@ -182,8 +196,10 @@ v systémovém okně, nebo příkaz odmítne.
   výzkum odmítne i `strom story set --final`), odpověď na rostoucí větev (`strom offline answer`), nechání rozporu
   z úpravy agentovi (`strom conflict leave`), vrácení a zahození poslání z aplikace (`strom sync undo|discard`)
   a opravy `strom fixes … edit-decisions|woken-waits`.
+- **Od výzkumu 1.28.0:** jen člověk také rozhoduje hypotézu (`strom hypothesis decide`, i uvnitř `strom batch`);
+  agent ji jen navrhne ([R10.3.1](R10-people-and-hypotheses.md#R10.3.1)).
 
-<!-- zdroj: research:src/commands/tasks.ts:897-970 (requireHuman :941, task.check-person :932) · src/commands/archives.ts:586-645 · src/commands/calibrate.ts:320 · src/commands/placeid.ts:343 person · assets/method/waiting.md, narrate.md:26-31 · src/cli/menu-waiting.ts:45 ANSWER_MAX · 1.26.0: userOnly u story approve/discard, offline answer, conflict leave, sync undo/discard (commity 4683a22d, 1189532f, 942c56f9), fixes.ts edit-decisions/woken-waits (person at the terminal) -->
+<!-- zdroj: research:src/commands/tasks.ts:897-970 (requireHuman :941, task.check-person :932) · src/commands/archives.ts:586-645 · src/commands/calibrate.ts:320 · src/commands/placeid.ts:343 person · assets/method/waiting.md, narrate.md:26-31 · src/cli/menu-waiting.ts:45 ANSWER_MAX · 1.26.0: userOnly u story approve/discard, offline answer, conflict leave, sync undo/discard (commity 4683a22d, 1189532f, 942c56f9), fixes.ts edit-decisions/woken-waits (person at the terminal) · 1.28.0: analysis.ts hypothesis decide (person), batch.ts def.person (commit 9b12256a) -->
 
 <a id="R6.7"></a>
 ## R6.7 Odesláno, odpověď a návrat do fronty

package/assets/strom-doc/cs/R7-when-the-agent-works.md

@@ -261,6 +261,8 @@ Do té doby se chová jako Archiv Stromu.
     výzkum čeká na agenta, a kde ho nainstalovat nebo vybrat jiného;
   - uložený režim se nemění a úkoly se neodkládají. Po instalaci agenta výzkum pokračuje sám s úkoly, které měl;
   - agent, který ve výzkumu právě pracuje (i jiný než nastavený), ho dělá výzkumem.
+- **Proč:** archiv je volba člověka a strom ji za něj nezapíše. Výzkum bez agenta se jen chová jako archiv, takže po
+  instalaci agenta sám pokračuje s úkoly, které měl; žádný není odložený.
 - **Ovládání:** terminál: menu, první položka (**Nechat jen jako Archiv Stromu: ukládat data z aplikace Strom**,
   nebo instalace agenta); `strom mode` ukáže stav. Aplikace ukazuje takový výzkum jako **Archiv**
   ([S1.3](S1-connecting-app-and-research.md#S1.3)).

package/assets/strom-doc/cs/R8-reading-scans.md

@@ -363,6 +363,8 @@ Nalezený zápis se zapíše najednou: pramen s výřezem, přepisem a místem v
   - pramen ze skenu dostane `--clip` (výřez, ve kterém se zápis četl), `--transcript` (slova zápisu po řádcích,
     nepřečtené `[?]`) a `--locator` (folio, strana, pořadí zápisu); podrobně
     [R3.4](R3-verification-and-citation.md#R3.4);
+  - zápis v jiném jazyce nebo písmu, než je jazyk výzkumu, dostane vedle doslovného přepisu i překlad do jazyka
+    výzkumu (`--translation`), od výzkumu 1.28.0;
   - do polí (`--date`, `--house`, `--age`, jméno) jen jistě přečtené. Nejisté jde do přepisu s `[?]` a do poznámky
     údaje („dům 21 nebo 27“). Co čtenář nahlásil jako nečitelné, zůstane nečitelné, dokud to agent nepřečte sám.
     Prázdný sloupec je prázdný; nic se nedoplňuje podle obvyklého;
@@ -376,7 +378,7 @@ Nalezený zápis se zapíše najednou: pramen s výřezem, přepisem a místem v
 - **Ovládání:** terminál (agent). Aplikace: stránka pramene ukazuje výřez a přepis ([A3.3](A3-evidence-in-the-app.md#A3.3)).
 - **Platí od:** výzkum 1.0.0; výřez 1.1.0
 
-<!-- zdroj: research:assets/method/recording.md:1-27, :55-65 · assets/method/reading.md:76-84 · assets/method/core.md „Negative results are results“ -->
+<!-- zdroj: research:assets/method/recording.md:1-27, :55-65 · assets/method/reading.md:76-84 · assets/method/core.md „Negative results are results“ · překlad: recording.md "--translation", link.md krok 7 (od v1.28.0) -->
 
 <a id="R8.7"></a>
 ## R8.7 Jistota a ověření přečteného

package/assets/strom-doc/cs/R9-archives.md

@@ -400,7 +400,8 @@ Kroky u úkolu, který čeká na snímky archivu, kam agent nesmí:
 <a id="R9.10"></a>
 ## R9.10 Příklady
 
-Úrovně a meze jsou ze seznamu archivů výzkumu 1.27.0. Rodina Horákových je vymyšlená.
+Úrovně a meze jsou ze seznamu archivů výzkumu 1.27.0, DigiArchiv SOA Třeboň z výzkumu 1.28.0. Rodina Horákových je
+vymyšlená.
 
 <a id="R9.10.1"></a>
 ### R9.10.1 Moravský zemský archiv (Acta Publica)
@@ -464,3 +465,20 @@ Kroky u úkolu, který čeká na snímky archivu, kam agent nesmí:
 - **Platí od:** výzkum 1.27.0
 
 <!-- zdroj: research:assets/archives.json szukajwarchiwach.gov.pl (restricted, browserOnly) -->
+
+<a id="R9.10.6"></a>
+### R9.10.6 DigiArchiv SOA Třeboň
+
+- Archiv: jen ručně, jen přes prohlížeč člověka. Podmínky na úvodní stránce DigiArchivu (`/Uvod`): „Snímky jsou
+  poskytnuty pouze za účelem on-line prohlížení v DigiArchivu SOA v Třeboni, jejich kopírování, distribuování,
+  prodávání, využití v jiných projektech a na jiných stránkách je zakázáno.“ Server požadavky stromu odmítá (403),
+  podle archivu záměrně.
+- Archiv potvrdil: člověk smí ručně uložit jen vybrané snímky, nikdy celou knihu ani její podstatnou část. Nástroje ke
+  stahování nejsou dovolené, ani prohlížeč agenta.
+- Úkol: zápis Marie Horákové v matrice v DigiArchivu. Úkol vždy čeká na snímky, které vybere a uloží člověk. Svolení
+  to neotevře; stahovač, stažení webu ani prohlížeč agenta tam nesmí.
+- Citace: trvalý odkaz na snímek je adresa jeho stránky `https://digi.ceskearchivy.cz/<kniha>/<snímek>`, nebo
+  **Odkaz na snímek** v panelu **POPIS**.
+- **Platí od:** výzkum 1.28.0
+
+<!-- zdroj: research:assets/archives.json digi.ceskearchivy.cz (manual, browserOnly, terms https://digi.ceskearchivy.cz/Uvod, quote, robots 403, scope, checked 2026-11-05), www.ceskearchivy.cz (stejné terms/quote) · src/core/terms.ts allows (browserOnly + manual) · CHANGELOG.cs.md 1.28.0 · znalosti/archivy-cz.md „SOA v Třeboni (DigiArchiv)“ (odpověď archivu 5. 11. 2026) · commit 805b871d -->

package/assets/strom-doc/cs/S3-what-the-research-knows.md

@@ -152,7 +152,8 @@ a poznámka. Otevřené jsou rozbalené.
   „+ 2 lidí“, „Tak to strom už vede“, „Jen text, nedá se ukázat.“, „bez vazby k osobám stromu“,
   u rozhodnuté *zvolená*, „Teď spojeno doopravdy“, „Už neplatí: …“.
 - **Které hypotézy výzkum pošle:** otevřené; rozhodnuté a zrušené jen ty, jejichž verze nesou vazby. Odvolané nikdy.
-- **Hranice:** rozhodnout hypotézu z aplikace nejde; rozhoduje se ve výzkumu.
+- **Hranice:** rozhodnout hypotézu z aplikace nejde; rozhoduje ji člověk ve výzkumu, v terminálu
+  ([R10.3.1](R10-people-and-hypotheses.md#R10.3.1)).
 - **Ovládání:** aplikace: přepínač **Ukázat** u verze ([S3.5.1](#S3.5.1)).
 - **Platí od:** aplikace 3.11.0 s výzkumem 1.14.0 (verze, stav, **Ukázat**); seznam hypotéz od aplikace 3.4.0
 

package/assets/strom-doc/de/A1-the-app-in-brief.md

@@ -2,7 +2,8 @@
 # A1 Die App im Überblick
 
 Wie die Strom-App als Ganzes arbeitet, auf einer Seite. Jeder Abschnitt führt zu einem Kapitel mit den genauen
-Regeln. Beschrieben werden die Strom-App 3.21.2 und die Forschung 1.25.2.
+Regeln. Beschrieben werden die Strom-App 3.21.2 und die Forschung 1.25.2. Änderungen aus einer neueren Version tragen
+deren Nummer.
 
 <a id="A1.1"></a>
 ## A1.1 Stammbaum im Browser, Daten auf dem Gerät
@@ -65,3 +66,29 @@ zurück an die Forschung ([R1.6](R1-research-in-brief.md#R1.6)).
 - Verbindung: [S1](S1-connecting-app-and-research.md). Änderungen aus der App: [S2](S2-edits-from-the-app.md).
   Was die Forschung weiß: [S3](S3-what-the-research-knows.md). Forschung aus der App gesteuert:
   [S4](S4-research-from-the-app.md). Telefon: [S5](S5-phone.md).
+
+<a id="A1.7"></a>
+## A1.7 So funktioniert Strom in der App
+
+Diese Dokumentation liegt der App bei und lässt sich auch ohne Internet lesen. Das Fenster **So funktioniert Strom**
+hat den Inhalt der Teile A, R und S, das **Begriffsverzeichnis** und eine Suche nach einem Wort oder einer Nummer der
+Regel.
+
+- **Grenzen:**
+  - das Öffnen des Fensters sendet nichts und lädt nichts aus dem Netz;
+  - die Nummer einer Regel und Enter springen direkt zur Regel (`R4.3`); eine unbekannte Nummer zeigt den Inhalt;
+  - Links zwischen Regeln haben **Zurück**; **Im Web** öffnet dieselbe Regel auf stromapp.info;
+  - eine Regel, die neuer ist als die verbundene Forschung, sagt das („Die mit diesem Baum verbundene Forschung hat
+    Version …, dies gilt ab …“).
+- **Bedienung:** App: **Aktionen → So funktioniert Strom**, auf dem Telefon **Mehr → So funktioniert Strom**, oder
+  **Über Strom → So funktioniert Strom**. Der Kreis **?** in der Kopfzeile öffnet die Hilfe direkt bei der Regel: in
+  der Forschungsübersicht und im kleinen Panel bei den Abschnitten **Warteschlange**
+  ([R2.4](R2-lines-and-queue.md#R2.4)), **Wartet auf Bearbeitung** ([R6.4](R6-awaiting-action.md#R6.4)) und
+  **Jetzt** ([R7](R7-when-the-agent-works.md), beim Pausieren [R7.6](R7-when-the-agent-works.md#R7.6)), im Fenster
+  **Orte** ([R4.5](R4-places.md#R4.5)), in der Verwaltung der Orte ([R4.4](R4-places.md#R4.4)), im Panel der
+  Widersprüche ([R5.3](R5-conflicts.md#R5.3)) und in **Was die Forschung weiß → Widersprüche**
+  ([R5.6](R5-conflicts.md#R5.6)). Im Fenster ist auch der **Rundgang durch die App**. In der Forschung: `strom doc`
+  ([R1.8](R1-research-in-brief.md#R1.8)).
+- **Gilt seit:** App 3.24.0
+
+<!-- zdroj: app:src/help/help-data.ts, src/help/topics.ts HELP_TOPICS · src/ui/help-mark.ts · strings.ts help.title, index, search, searchPh, web, back, unknown, verRes, topics; tour.menu · vendor/strom-doc/PIN · prace/1105-app-napoveda-impl (§1–§11, e2e help.spec: otevření okna bez síťového požadavku) -->

package/assets/strom-doc/de/A3-evidence-in-the-app.md

@@ -55,8 +55,13 @@ Forschung verbundenen Stammbaum bestimmt die Einstellung **Meine Quellenabschrif
   Quellen** der Filter **Abschrift nicht geprüft** (nur bei einem Stammbaum auf **Beleg** mit älteren ungeprüften
   Quellen).
 - **Gilt seit:** App 3.9.0
+- **Ab App 3.24.0:** die Übersetzung der Transkription, die die Forschung gesendet hat
+  ([R3.4](R3-verification-and-citation.md#R3.4)), steht unter der Transkription als zugeklappter Abschnitt
+  **Übersetzung der Transkription**: im Quellenbetrachter und auf der Karte der Quelle auf der Seite der Person. Die
+  Notiz der Quelle ändert sich dadurch nicht; der Editor der Notiz zeigt sie ganz. Eine Quelle ohne Übersetzung sieht
+  aus wie früher.
 
-<!-- zdroj: app:src/research-sync.ts:357 researchReadSource, :365 isOlderSource, :377 verifiedOffer, :385 unverifiedOlderSources · src/ui/sources.ts:618 renderSourceReading, :658 sourceVerifiedValue, :296 renderSourcesFilter, :377 renderSourceViewer · strings.ts sources.verified/verifiedHintGuide/verifiedHintOlder/verifiedByTree/readBy/userReadingNote/filterUnverified -->
+<!-- zdroj: app:src/research-sync.ts:357 researchReadSource, :365 isOlderSource, :377 verifiedOffer, :385 unverifiedOlderSources · src/ui/sources.ts:618 renderSourceReading, :658 sourceVerifiedValue, :296 renderSourcesFilter, :377 renderSourceViewer · strings.ts sources.verified/verifiedHintGuide/verifiedHintOlder/verifiedByTree/readBy/userReadingNote/filterUnverified · překlad (od 3.24.0): src/source-translation.ts SOURCE_TRANSLATION_LABELS, splitSourceTranslation · strings.ts viewerTranslation, translation · commit c2942b0 -->
 
 <a id="A3.2"></a>
 ## A3.2 Zitation: was eine Quelle belegt

package/assets/strom-doc/de/A6-views.md

@@ -2,7 +2,7 @@
 # A6 Ansichten und Auswahl der Personen
 
 Wie die Strom-App auswählt, welche Personen sie zeigt, und wie die einzelnen Ansichten sie zeigen. Beschrieben wird
-die App 3.21.2.
+die App 3.21.2. Änderungen aus einer neueren Version tragen deren Nummer.
 
 Eine Ansicht ist eine andere Lesart **derselben Auswahl der Personen**. Die Auswahl bestimmen die zentrale Person
 (die angeklickte) und die Tiefe **Vorfahren** und **Nachkommen**. Familie, Nachkommen, Zeitleiste und Karte zeigen
@@ -145,13 +145,27 @@ Stammbaum aus der Forschung bestimmt die Forschung die Orte ([R4](R4-places.md))
     keine Namen von Personen, keine Daten und Beziehungen. Höchstens etwa eine Anfrage pro Sekunde;
   - die Koordinaten werden im Stammbaum gespeichert: jeder Ort wird einmal nachgeschlagen, und die Karte funktioniert
     dann auch ohne Verbindung;
-  - das automatische Nachschlagen nimmt das **erste Ergebnis** des Dienstes für den geschriebenen Namen.
-    Gleichnamige Gemeinden unterscheidet es dabei nicht: ein Ort kann so in eine gleichnamige Gemeinde anderswo
-    fallen. Eine solche Lage markiert dann **Prüfen** ([R4.4.1](R4-places.md#R4.4.1));
+  - das automatische Nachschlagen nimmt das **erste Ergebnis** des Dienstes für den geschriebenen Namen. Bis App
+    3.23.0 unterschied es dabei gleichnamige Gemeinden nicht: ein Ort konnte so in eine gleichnamige Gemeinde
+    anderswo fallen. Eine Lage, die nicht in den Stammbaum passt, markiert **Prüfen** ([R4.4.1](R4-places.md#R4.4.1));
   - nur ein Ort mit Hausnummer, den der Dienst nicht gefunden hat, wird nach der Gemeinde nachgeschlagen. Von den
     Gemeinden dieses Namens wird die gewählt, die den übrigen Orten des Stammbaums am nächsten liegt („Mehrere Orte
     tragen diesen Namen; gewählt wurde der, der den übrigen Orten des Stammbaums am nächsten liegt.“); beim Ort steht
     **Lage nach dem Ort …**;
+  - **ab App 3.24.0** wird die nächste Gemeinde bei jedem Ort gewählt: heißen zwei oder mehr Gemeinden genau wie der
+    geschriebene Ort (ohne Rücksicht auf Groß- und Kleinschreibung und diakritische Zeichen), wird die genommen, die
+    der Mitte des Stammbaums am nächsten liegt, nicht das erste Ergebnis. Die Mitte ist der Median der Lagen, die von
+    Hand eingetragen oder mit **Beibehalten** bestätigt sind, wenn es mindestens 3 sind; sonst der Median aller Lagen
+    des Stammbaums und der Orte, die das Nachschlagen ohne Zweifel gefunden hat. Ein Ort mit weiterer Angabe („Lhota u
+    Kolína“, „Lhota 16“), eine einzige Gemeinde oder ein Stammbaum ohne Lagen bekommt das erste Ergebnis wie früher.
+    Es bleibt bei einer Anfrage je Ort;
+  - die Prüfung des Ortes sagt, wie viele Gemeinden dieses Namens die Karte gefunden hat („Die Karte fand 3 Orte
+    dieses Namens und nahm den, der den übrigen Orten des Stammbaums am nächsten liegt.“); ab App 3.24.0, früher
+    immer „zwei“;
+  - eine Lage, die schon im Stammbaum ist, wird nicht verschoben: das Nachschlagen sucht nur Orte ohne Lage. Auch das
+    Zusammenführen mit einem anderen Stammbaum oder einer GEDCOM-Datei überschreibt eine von Hand eingetragene oder
+    mit **Beibehalten** bestätigte Lage nicht, es ergänzt nur fehlende. Eine falsche ältere Lage lässt sich nur von
+    Hand verschieben;
   - was nicht gefunden wird, bleibt ohne Lage. Die App rät nichts: „Schreibweise prüfen oder das Land hinzufügen“.
 - **Bedienung:** App: **Einstellungen → Orte online nachschlagen**; im Fenster der Orte **Falsche Stelle? Diesen Ort
   korrigieren**, **Diesen Ort unter einem anderen Namen suchen** (nur die Lage wird ergänzt, der Eintrag im Stammbaum
@@ -160,9 +174,10 @@ Stammbaum aus der Forschung bestimmt die Forschung die Orte ([R4](R4-places.md))
   Zustimmung, nur Namen und jeden Ort einmal (Kommentar im Code). Das Limit von einer Anfrage pro Sekunde ist eine
   Bedingung des Dienstes.
 - **Gilt seit:** App 1.10.0; **Falsche Stelle? Diesen Ort korrigieren** 1.10.1; **Verwaiste Orte bereinigen** 2.1.0;
-  Lage nach dem Ort 3.21.0
+  Lage nach dem Ort 3.21.0; die nächste gleichnamige Gemeinde bei jedem Ort und die Zahl der Gemeinden in der Prüfung
+  3.24.0
 
-<!-- zdroj: app:src/geocode.ts hlavička, REQUEST_INTERVAL_MS=1100, geocodePlace (limit 1, parseGeocodeResponse první výsledek), geocodeTown/pickTownHit nearestTo (od v3.21.0), geocodePlaces townFallback · app:src/strings.ts map.consentTitle, consentBody, settingLabel, wrongSpot (v1.10.1), searchLabel, attachOnly, useForOthers, cleanOrphans (v2.1.0), nearestTown, byTown, doneWithMisses · FB podnět 2026-11-04 (stejnojmenná obec) -->
+<!-- zdroj: app:src/geocode.ts hlavička, REQUEST_INTERVAL_MS=1100, geocodePlace (limit 1, parseGeocodeResponse první výsledek), geocodeTown/pickTownHit nearestTo (od v3.21.0), geocodePlaces townFallback · app:src/strings.ts map.consentTitle, consentBody, settingLabel, wrongSpot (v1.10.1), searchLabel, attachOnly, useForOthers, cleanOrphans (v2.1.0), nearestTown, byTown, doneWithMisses · FB podnět 2026-11-04 (stejnojmenná obec) · od 3.24.0: geocode.ts treeCenter (medián, PERSONS_CENTER_MIN=3), sameNamedTowns, pickPlaceHit (townChoices), buildGeocodeUrl limit · place-check.ts multi count · strings.ts checkMulti(n) · merge-executor test (ruční poloha zůstane) · commit 046967d -->
 
 <a id="A6.6"></a>
 ## A6.6 Stammlinie in der Ansicht

package/assets/strom-doc/de/R1-research-in-brief.md

@@ -2,7 +2,8 @@
 # R1 Die Forschung im Überblick
 
 Wie die Forschung als Ganzes arbeitet, auf einer Seite. Jeder Abschnitt führt zu einem Kapitel mit den genauen
-Regeln. Beschrieben werden die Forschung 1.25.2 und die Strom-App 3.21.2.
+Regeln. Beschrieben werden die Forschung 1.25.2 und die Strom-App 3.21.2. Änderungen aus einer neueren Version tragen
+deren Nummer.
 
 <a id="R1.1"></a>
 ## R1.1 Die Forschung ist eine Aufzeichnung, kein Gespräch
@@ -57,8 +58,9 @@ Der Agent arbeitet nach dem **Genealogical Proof Standard** (GPS): gründliche S
 und Vergleich der Beweise, Auflösung von Widersprüchen und eine niedergeschriebene Schlussfolgerung, die eine weitere
 forschende Person versteht.
 
-- Jede Angabe hat einen Grad der Sicherheit: **Hinweis**, **Möglich**, **Wahrscheinlich**, **Belegt**. Ein Stammbaum
-  und die Familienüberlieferung sind immer nur ein Hinweis, ein Register dient zum Finden des Eintrags. Ausführlich:
+- Jede Angabe hat einen Grad der Sicherheit: **Hinweis**, **Möglich**, **Wahrscheinlich**, **Belegt**. Ein Stammbaum,
+  die Familienüberlieferung und ein Register sind immer nur ein Hinweis: das Register führt zum Eintrag, belegt erst
+  der Eintrag selbst (das Register prüft der Code ab Forschung 1.28.0). Ausführlich:
   [R3](R3-verification-and-citation.md).
 - Ein Namensvetter ist nicht die gesuchte Person. Eine Person bestimmen Jahr, Ort, Haus, Beruf, Ehemann oder Ehefrau
   und die Eltern. Zwei Einträge mit demselben Namen und anderen Eltern sind zwei Personen. Identifizierung von
@@ -69,7 +71,7 @@ forschende Person versteht.
   Ausführlich: [R5](R5-conflicts.md).
 - Ein Ort bekommt eine Lage auf der Karte nur, wenn sicher ist, welcher Ort es ist. Ausführlich: [R4](R4-places.md).
 
-<!-- zdroj: research:assets/method/core.md (úvod, „Certainty is explicit“, „A namesake is not your person“, „Negative results are results“) -->
+<!-- zdroj: research:assets/method/core.md (úvod, „Certainty is explicit“, „A namesake is not your person“, „Negative results are results“) · src/core/evidence.ts isWeak (rejstřík od 1.28.0) -->
 
 <a id="R1.5"></a>
 ## R1.5 Was der Mensch entscheidet
@@ -77,14 +79,16 @@ forschende Person versteht.
 Manche Entscheidungen gehören nur dem Menschen. Die Forschung fragt danach in **Wartet auf Bearbeitung**, und der
 Agent antwortet nicht an Stelle des Menschen.
 
-- Was auf den Menschen wartet (Briefe, Bilder zum Herunterladen, Fragen zu Orten, Widersprüche, Erzählungen zur
-  Freigabe) und wo es erledigt wird: [R6](R6-awaiting-action.md).
+- Was auf den Menschen wartet (Briefe, Bilder zum Herunterladen, Fragen zu Orten, Widersprüche, Hypothesen,
+  Erzählungen zur Freigabe) und wo es erledigt wird: [R6](R6-awaiting-action.md).
+- Eine Hypothese entscheidet nur der Mensch; der Agent schlägt die Entscheidung vor (ab Forschung 1.28.0):
+  [R10.3.1](R10-people-and-hypotheses.md#R10.3.1).
 - Die Entscheidung des Menschen gilt. Der Agent ändert sie nur auf Grund einer neuen Quelle: [R5.4](R5-conflicts.md#R5.4).
 - Eine vom Menschen eingetragene Lage eines Ortes wird nicht geändert: [R4.3](R4-places.md#R4.3).
 - Einstellungen, die ändern, was der Agent darf, bestätigt der Mensch (zum Beispiel die Bedingung für die Arbeit des
   Agenten allein, [R7](R7-when-the-agent-works.md)).
 
-<!-- zdroj: research:assets/method/waiting.md · src/core/conflicts.ts againAllowed · src/core/placeid.ts personsHand · src/core/config.ts run.gate -->
+<!-- zdroj: research:assets/method/waiting.md · src/core/conflicts.ts againAllowed · src/core/placeid.ts personsHand · src/core/config.ts run.gate · src/commands/analysis.ts hypothesis decide (person, od 1.28.0) -->
 
 <a id="R1.6"></a>
 ## R1.6 Die Forschung und die Strom-App
@@ -109,3 +113,28 @@ KI-Modell ist nicht hundertprozentig; wichtige Angaben soll idealerweise noch ei
 - **Gilt seit:** Forschung 1.0.0
 
 <!-- zdroj: research:assets/method/reading.md · assets/method/locate.md · assets/method/recording.md · src/commands/read.ts:183-200 -->
+
+<a id="R1.8"></a>
+## R1.8 So funktioniert Strom: `strom doc`
+
+Diese Dokumentation liegt der Forschung bei und lässt sich auch ohne Internet lesen. `strom doc` gibt den Inhalt aus,
+`strom doc R10.1` eine Regel samt den Regeln darunter und `strom doc <Wörter>` sucht in den Überschriften, im
+Begriffsverzeichnis und im Text.
+
+- **Grenzen:**
+  - die Nummer lässt sich auch in Kleinbuchstaben oder mit Bindestrich schreiben (`r4.3`, `R4-3`). Eine unbekannte
+    Nummer endet mit einem Fehler, der die nächsten Nummern nennt;
+  - die Suche achtet weder auf diakritische Zeichen noch auf Groß- und Kleinschreibung. Sie zeigt höchstens 10 Regeln,
+    die besten zuerst, und wie viele es noch gibt (`--limit` eine andere Anzahl);
+  - der Text ist in der Sprache der Forschung (`--lang` eine andere). Eine Sprache, in die die Dokumentation nicht
+    übersetzt ist, bekommt Englisch mit einem Hinweis;
+  - bei der Regel steht ein Link auf dieselbe Regel auf stromapp.info;
+  - funktioniert auch außerhalb der Forschung und im Strom-Archiv und schreibt nichts.
+- **Nur Methodik:** auf die Frage des Menschen, wie oder warum Strom etwas tut, antwortet der Agent nach `strom doc`:
+  mit der Nummer der Regel und mit dem Link, den `strom doc` ausgibt.
+- **Bedienung:** Terminal: `strom doc`, `strom doc R2.3`, `strom doc hypotéza --lang en`, `--json`. Die Hilfe für den
+  Menschen (`strom help --human`) endet mit einem Verweis auf `strom doc`. Die App hat dieselbe Dokumentation in
+  **So funktioniert Strom** ([A1.7](A1-the-app-in-brief.md#A1.7)).
+- **Gilt seit:** Forschung 1.28.0
+
+<!-- zdroj: research:src/commands/doc.ts (SEARCH_ROWS=10, --limit, ui.docs.fallback, docUrl) · src/core/doc.ts · assets/strom-doc/ (PIN) · src/agents/files.ts:188 "answer from `strom doc`" · src/cli/help.ts (help --human, poslední řádek) · CHANGELOG.cs.md 1.28.0 · commity 314ab218, 4acfb170 -->

package/assets/strom-doc/de/R10-people-and-hypotheses.md

@@ -3,8 +3,8 @@
 
 Wie die Forschung erkennt, dass ein Eintrag der gesuchten Person gehört, was sie mit zwei Datensätzen einer Person
 tut, wie sie konkurrierende Erklärungen (Hypothesen) führt und wie sie Namen und die Personen erfasst, die ein Eintrag
-nennt. Beschrieben werden die Forschung 1.27.0 und die Strom-App 3.23.0. Bei den Regeln wird unterschieden, was
-**der Code prüft** und was nur eine **Regel der Methodik** ist.
+nennt. Beschrieben werden die Forschung 1.27.0 und die Strom-App 3.23.0. Änderungen aus einer neueren Version tragen
+deren Nummer. Bei den Regeln wird unterschieden, was **der Code prüft** und was nur eine **Regel der Methodik** ist.
 
 <a id="R10.1"></a>
 ## R10.1 Ein Namensvetter ist nicht die gesuchte Person
@@ -49,6 +49,8 @@ Datensatz verschwindet nicht: er bleibt zurückgezogen, mit einer Notiz, in wen
     es dieselben Eltern in zwei Datensätzen, werden zuerst die Familien zusammengeführt (`strom family merge`).
 - **Nur Methodik:** eine Person aus einem übernommenen Stammbaum, die in der Forschung schon erforscht ist, wird **in**
   die erforschte Person zusammengeführt; diese behält ihre Belege ([R11.3](R11-material-from-the-user.md#R11.3)).
+- **Warum:** strom wählt zwischen zwei Angaben nie stillschweigend: welche gilt, entscheidet der Beleg. Die andere
+  wird mit Grund zurückgezogen, so bleibt sichtbar, was wo stand.
 - **Bedienung:** Terminal: `strom person merge`, `strom family merge`. Mögliche doppelte Personen im Stammbaum meldet
   die App in der Prüfung des Stammbaums ([A5.6](A5-tree-check.md#A5.6)).
 - **Gilt seit:** Forschung 1.0.0
@@ -85,23 +87,43 @@ A, B, C… mit dem, was für jede spricht und was dagegen.
 <a id="R10.3.1"></a>
 ### R10.3.1 Entscheidung einer Hypothese
 
-Eine Hypothese wird für eine Version entschieden oder verworfen, wenn sich keine entscheiden lässt. Entschieden wird in
-der Forschung; die App lässt eine Hypothese nicht entscheiden.
+Eine Hypothese wird für eine Version entschieden oder verworfen, wenn sich keine entscheiden lässt. Entscheiden kann
+nur der Mensch, in der Forschung; der Agent schlägt die Entscheidung vor. Die App lässt eine Hypothese nicht
+entscheiden.
 
 - **Prüft der Code:**
-  - die Entscheidung braucht den Text der Entscheidung (`--decision`); das Verwerfen ist `--abandon`;
-  - erneut entscheiden lässt sich nur mit Grund (`--reason`). Die vorige Entscheidung bleibt in einer Notiz der
-    Hypothese;
-  - nach der Entscheidung gibt strom die Quellen aus, die die Hypothese nennt und die keine Angabe ihrer Personen
-    zitiert: was sie sagen, soll bei den Personen erfasst werden.
-- **Nur Methodik:** eine Hypothese, deren Versionen Verbindungen tragen, wird mit der Wahl einer Version entschieden
-  (`--variant B`). Eine entschiedene Hypothese, die ein neuer Eintrag umstößt, entscheidet der Agent mit Grund erneut.
-  Was der Agent zurückgehalten hat, solange die Person nur eine Hypothese war, erfasst er nach der Entscheidung bei
-  der Person.
-- **Bedienung:** Terminal: `strom hypothesis decide H… --variant B --decision "…"` (erneut mit `--reason "…"`).
+  - die Entscheidung ist ein Schritt des Menschen. Startet der Agent `strom hypothesis decide` (auch innerhalb von
+    `strom batch`), lehnt strom den Befehl ab;
+  - der Agent schlägt die Entscheidung vor: die Version und den Text der Entscheidung (`strom hypothesis propose`)
+    oder das Verwerfen (`--abandon`). Ein neuer Vorschlag ersetzt den vorigen. Auf die Antwort wird nicht gewartet,
+    die Arbeit geht weiter;
+  - der Vorschlag wartet in **Was wartet** in der Gruppe **Hypothesen zu entscheiden**
+    ([R6.3.4](R6-awaiting-action.md#R6.3.4)): der Mensch entscheidet wie vorgeschlagen, anders (eine andere Version
+    oder keine, mit Grund) oder lässt die Hypothese, wie sie ist. Ein nicht übernommener Vorschlag bleibt in einer
+    Notiz der Hypothese;
+  - sowohl die Entscheidung als auch der Vorschlag brauchen den Text der Entscheidung (`--decision`); das Verwerfen
+    ist `--abandon`;
+  - eine Hypothese, deren Versionen sagen, was sie verbinden würden, wird nur mit angegebener Version entschieden und
+    vorgeschlagen (`--variant B`). Ohne sie lehnt strom ab und erfasst nichts;
+  - erneut entscheiden (und erneut vorschlagen) lässt sich nur mit Grund (`--reason`). Die vorige Entscheidung bleibt
+    in einer Notiz der Hypothese;
+  - was die Entscheidung des Menschen verbindet, und die Quellen, die die Hypothese nennt und die keine Angabe ihrer
+    Personen zitiert, bekommt der Agent zu Beginn der nächsten Arbeit als erste Aufgabe zum Erfassen im Stammbaum.
+- **Nur Methodik:** der Agent schlägt eine Entscheidung vor, wenn die Einträge auf eine Version zeigen, und sagt es dem
+  Menschen in einem Satz. Eine entschiedene Hypothese, die ein neuer Eintrag umstößt, schlägt der Agent mit Grund
+  erneut vor. Was der Agent zurückgehalten hat, solange die Person nur eine Hypothese war, erfasst er bei der Person,
+  sobald der Mensch die Hypothese entscheidet.
+- **Warum:** eine neue Entscheidung braucht einen Grund, weil sich Entscheidungen offen ändern: die vorige bleibt
+  lesbar, und die neue sagt, was sie geändert hat (meist ein neuer Eintrag).
+- **Bedienung:** Terminal: Menü `strom` → **Was wartet** → **Hypothesen zu entscheiden** → **Wie vorgeschlagen
+  entscheiden**, **Anders entscheiden**, **So lassen (Vorschlag nicht übernommen)**; per Befehl
+  `strom hypothesis decide H… --proposed`, `--keep-open` oder `--variant B --decision "…"` (erneut mit
+  `--reason "…"`). Agent: `strom hypothesis propose H… --variant B --decision "…"`.
 - **Gilt seit:** Forschung 1.0.0; Ausgabe nicht erfasster Quellen 1.12.0
+- **Ab Forschung 1.28.0:** entscheidet nur der Mensch, der Agent schlägt vor; die angegebene Version prüft der Code
+  (früher nur Methodik). Hypothesen, die früher der Agent entschieden hat, bleiben, wie sie waren.
 
-<!-- zdroj: research:src/commands/analysis.ts hypothesis decide (earlier decision in a note, "deciding again needs --reason", sourcesNotOnPeople od v1.12.0) · research:assets/method/core.md "Write as you go", "Say what a hypothesis would connect" · research:assets/method/recording.md "A decided hypothesis that a new record overturns" -->
+<!-- zdroj: research:src/commands/analysis.ts hypothesis propose, hypothesis decide (person: …, --proposed, --keep-open, againNeedsReason, decidedVariant) · src/cli/main.ts:288 def.person && isAgent · src/commands/batch.ts (def.person) · src/core/waiting.ts (hypotheses, TERMINAL_ONLY) · src/cli/menu-waiting.ts decideHypothesis · src/core/hypolinks.ts decidedToRecord, sourcesNotOnPeople · src/brief/brief.ts "Decided by the user — record it on the tree first" · assets/lang/cs.json wait.group.hypotheses, ui.wait.hypothesis.* · research:assets/method/core.md "The user decides a hypothesis" · assets/method/recording.md "is proposed again" · CHANGELOG.cs.md 1.28.0 · commit 9b12256a -->
 
 <a id="R10.4"></a>
 ## R10.4 Eine Familie außerhalb des Stammbaums wartet auf eine belegte Verbindung
@@ -146,6 +168,9 @@ hat seinen eigenen Datensatz. Namen werden so erfasst, wie sie im Eintrag stehen
   - eine Person, die ein schwächerer Eintrag anders genannt hat, behält diesen Namen als Variante; der richtige Name
     wird als Hauptname markiert. Nichts wird gelöscht;
   - ein nur teilweise gelesener Name: [R8.6](R8-reading-scans.md#R8.6).
+- **Warum:** eine Beschreibung an Stelle des Namens („totgeborener Sohn“) würden die App und GEDCOM als Vornamen
+  zeigen und suchen, und der Abgleich der Namen hielte sie für einen Namen. Dass das Kind ohne Namen starb, ist eine
+  Angabe (Tod, Notiz).
 - **Bedienung:** Terminal: `strom name add P… "Marie /Vlková/" --kind birth --cite S…`, `strom name primary P…
   "…"` (`--clear` stellt den Geburtsnamen wieder her). Formen des Nachnamens in der App:
   [A4.5](A4-surnames-and-families.md#A4.5), [A4.6](A4-surnames-and-families.md#A4.6).