strom-research 1.27.0 → 1.28.0-beta.1

package/CHANGELOG.cs.md

@@ -5,6 +5,30 @@
 Změny každé verze ve zkratce. Úplné poznámky a instalační řádky jsou na
 [GitHub Releases](https://github.com/ACiDekCZ/strom-research/releases) (anglicky).
 
+## 1.28.0
+
+*Připravuje se: bety do 1.28.0-beta.1. Oddíl bude úplný s vydáním.*
+
+- **Jak Strom funguje je přímo ve stromu: `strom doc`.** Dokumentace aplikace a výzkumu v češtině, angličtině, němčině
+  a polštině je součástí stromu a čte se i bez internetu: `strom doc` vypíše kapitoly, `strom doc R10.1` jedno pravidlo
+  i s tím, proč tak je, `strom doc <slova>` hledá v nadpisech, rejstříku pojmů a textu (bez ohledu na diakritiku a
+  velikost písmen). U každého pravidla je odkaz na stejnou stránku na stromapp.info. Na otázku, jak nebo proč Strom
+  něco dělá, odpovídá agent podle ní s číslem pravidla. Nápověda pro člověka (`strom help --human`) na ni odkazuje.
+
+- **Hypotézu rozhoduje jen uživatel.** Agent už mezi soupeřícími vysvětleními nerozhoduje sám: navrhne verzi s důvody
+  a hypotéza čeká v menu stromu v Co čeká – rozhodne se podle návrhu, jinak, nebo zůstane otevřená. Co rozhodnutí
+  spojí, zapíše agent do stromu v další session. Dříve rozhodnuté hypotézy zůstávají, jak byly. Hypotéza, jejíž verze
+  říkají, co by spojily, se rozhoduje jen s uvedenou verzí.
+
+- **Rejstřík je vodítko, nikdy doklad.** Údaj, který cituje jen rejstřík, zůstane vodítkem, dokud se nepřečte a
+  necituje samotný zápis – stejně jako u rodokmenu nebo vzpomínky.
+
+- **Překlad vedle přepisu.** Záznam 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.
+
+- **DigiArchiv SOA v Třeboni:** podmínky, jak je archiv potvrdil – ručně jen vybrané snímky, nikdy celá kniha, žádné
+  nástroje ke stahování – a jak citovat trvalý odkaz na snímek.
+
 ## 1.27.0
 
 *5. 11. 2026 · patří k aplikaci Strom 3.23.0.*

package/CHANGELOG.de.md

@@ -5,6 +5,34 @@
 Die Änderungen jeder Version in Kürze. Die vollständigen Hinweise und die Installationszeilen stehen bei
 [GitHub Releases](https://github.com/ACiDekCZ/strom-research/releases) (auf Englisch).
 
+## 1.28.0
+
+*In Vorbereitung: die Betas bis 1.28.0-beta.1. Der Abschnitt ist mit dem Release vollständig.*
+
+- **Wie Strom funktioniert gehört zu strom: `strom doc`.** Die Dokumentation der App und der Forschung auf Tschechisch,
+  Englisch, Deutsch und Polnisch ist Teil von strom und liest sich auch ohne Internet: `strom doc` listet die Kapitel,
+  `strom doc R10.1` zeigt eine Regel samt dem Warum, `strom doc <Wörter>` sucht in Überschriften, im Begriffsregister
+  und im Text (Akzente und Groß-/Kleinschreibung egal). Jede Regel trägt den Link zur selben Seite auf stromapp.info.
+  Auf die Frage, wie oder warum Strom etwas tut, antwortet der Agent danach mit der Nummer der Regel. Die Hilfe für
+  Menschen (`strom help --human`) verweist darauf.
+
+- **Über eine Hypothese entscheidet nur der Nutzer.** Der Agent entscheidet nicht mehr selbst zwischen konkurrierenden
+  Erklärungen: Er schlägt eine Variante mit Gründen vor, und die Hypothese wartet im Menü von strom unter „Was wartet“ –
+  entschieden wie vorgeschlagen, anders oder offen gelassen. Was die Entscheidung verbindet, trägt der Agent in seiner
+  nächsten Sitzung in den Stammbaum ein. Früher entschiedene Hypothesen bleiben, wie sie waren. Eine Hypothese, deren
+  Varianten sagen, was sie verbinden würden, wird nur mit genannter Variante entschieden.
+
+- **Ein Register ist ein Hinweis, nie ein Beleg.** Eine Angabe, die nur ein Register zitiert, bleibt ein Hinweis, bis
+  der Eintrag selbst gelesen und zitiert ist – wie bei einem Stammbaum oder einer Erinnerung.
+
+- **Eine Übersetzung neben der Abschrift.** Ein Eintrag in einer anderen Sprache oder Schrift als der der Forschung –
+  Latein, Kurrent, Polnisch, Kyrillisch – bekommt neben der wörtlichen Abschrift eine Übersetzung in die Sprache der
+  Forschung.
+
+- **DigiArchiv des Staatlichen Gebietsarchivs Třeboň:** seine Bedingungen, wie das Archiv sie bestätigt hat – von Hand
+  nur ausgewählte Bilder, nie ein ganzes Buch, keine Download-Werkzeuge – und wie der dauerhafte Link eines Bildes
+  zitiert wird.
+
 ## 1.27.0
 
 *5.11.2026 · gehört zur Strom-App 3.23.0.*

package/CHANGELOG.md

@@ -5,6 +5,31 @@ English · [Čeština](CHANGELOG.cs.md) · [Deutsch](CHANGELOG.de.md) · [Polski
 The changes of each version in short. The full notes and the install lines are on
 [GitHub Releases](https://github.com/ACiDekCZ/strom-research/releases).
 
+## 1.28.0
+
+*In preparation: the betas up to 1.28.0-beta.1. The section is complete with the release.*
+
+- **How Strom works comes with strom: `strom doc`.** The documentation of the app and the research, in Czech, English,
+  German and Polish, is part of strom and reads offline: `strom doc` lists its chapters, `strom doc R10.1` shows one rule
+  with why it is so, `strom doc <words>` searches its titles, its index of terms and its text (accents and case aside).
+  Each rule carries its link to the same page on stromapp.info. Asked how or why Strom does something, the agent answers
+  from it with the rule's number. A person's help (`strom help --human`) ends with it.
+
+- **Only the user decides a hypothesis.** The agent no longer decides between competing explanations itself: it proposes
+  a variant with its reasons, and the hypothesis waits in strom's menu under What waits, to be decided as proposed,
+  otherwise, or left open. What the decision connects, the agent records on the tree in its next session. Hypotheses
+  decided earlier stay as they were. A hypothesis whose variants say what they would connect is decided only with the
+  variant named.
+
+- **An index is a lead, never proof.** A fact that only an index cites stays a lead until the entry itself is read and
+  cited, as with a family tree or a memory.
+
+- **A translation beside the transcript.** A record in another language or script than the research's – Latin, German
+  Kurrent, Polish, Cyrillic – gets a translation into the research's language beside its word-for-word transcript.
+
+- **DigiArchiv of the regional archive in Třeboň:** its terms as the archive confirmed them – selected images saved by
+  hand only, never a whole book, no download tools – and how to cite an image's permanent link.
+
 ## 1.27.0
 
 *2026-11-05 · goes with the Strom app 3.23.0.*

package/CHANGELOG.pl.md

@@ -5,6 +5,32 @@
 Zmiany każdej wersji w skrócie. Pełne informacje o wydaniach i polecenia instalacji są na
 [GitHub Releases](https://github.com/ACiDekCZ/strom-research/releases) (po angielsku).
 
+## 1.28.0
+
+*W przygotowaniu: bety do 1.28.0-beta.1. Sekcja będzie kompletna z wydaniem.*
+
+- **Jak działa Strom – w samym stromie: `strom doc`.** Dokumentacja aplikacji i badań po czesku, angielsku, niemiecku i
+  polsku jest częścią stromu i czyta się ją także bez internetu: `strom doc` wypisuje rozdziały, `strom doc R10.1` jedną
+  regułę wraz z tym, dlaczego tak jest, `strom doc <słowa>` szuka w tytułach, indeksie pojęć i tekście (bez względu na
+  znaki diakrytyczne i wielkość liter). Każda reguła ma link do tej samej strony na stromapp.info. Na pytanie, jak lub
+  dlaczego Strom coś robi, agent odpowiada według niej z numerem reguły. Pomoc dla człowieka (`strom help --human`)
+  do niej odsyła.
+
+- **O hipotezie decyduje tylko użytkownik.** Agent nie rozstrzyga już sam między konkurencyjnymi wyjaśnieniami:
+  proponuje wariant z uzasadnieniem, a hipoteza czeka w menu stromu w „Co czeka” – rozstrzygnięta zgodnie z propozycją,
+  inaczej albo pozostawiona otwarta. To, co decyzja łączy, agent zapisuje w drzewie w następnej sesji. Hipotezy
+  rozstrzygnięte wcześniej pozostają bez zmian. Hipotezę, której warianty mówią, co by połączyły, rozstrzyga się tylko
+  ze wskazanym wariantem.
+
+- **Indeks to wskazówka, nigdy dowód.** Fakt, który cytuje tylko indeks, pozostaje wskazówką, dopóki nie zostanie
+  odczytany i zacytowany sam wpis – tak jak przy drzewie genealogicznym czy wspomnieniu.
+
+- **Tłumaczenie obok transkrypcji.** Wpis w innym języku lub piśmie niż język badań – łacina, kurrenta, niemiecki,
+  cyrylica – otrzymuje obok dosłownej transkrypcji tłumaczenie na język badań.
+
+- **DigiArchiv Archiwum Państwowego w Třeboniu:** jego warunki, tak jak potwierdziło je archiwum – ręcznie tylko wybrane
+  skany, nigdy cała księga, żadnych narzędzi do pobierania – i jak cytować stały link do skanu.
+
 ## 1.27.0
 
 *5.11.2026 · współpracuje z aplikacją Strom 3.23.0.*

package/assets/archives.json

@@ -42,8 +42,8 @@
       "host": "digi.ceskearchivy.cz",
       "name": "Státní oblastní archiv v Třeboni (DigiArchiv)",
       "level": "manual",
-      "terms": "https://digi.ceskearchivy.cz/DA?subject=2&menu=8",
-      "quote": "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 apod. je zakázáno.",
+      "terms": "https://digi.ceskearchivy.cz/Uvod",
+      "quote": "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.",
       "robots": "403 Forbidden for strom's User-Agent, robots.txt and the terms page too (2026-11-03); before: Allow: /DA* · Disallow: /help/* · /pages/* · /oai/* · /Assets/*",
       "disallow": [
         "/help/",
@@ -51,8 +51,8 @@
         "/oai/",
         "/Assets/"
       ],
-      "scope": "a person's browser only: the server refuses strom's requests (403, even robots.txt and the catalogue); its images by hand, for viewing only (the terms quoted as read on 2026-10-11)",
-      "checked": "2026-10-11",
+      "scope": "a person's browser only: the server refuses strom's requests (403, even robots.txt and the catalogue; on purpose, the archive's reply of 2026-11-05); by hand only and selected images only, never a whole book or a substantial part of it; no download tools and not the agent's browser either; the permanent link of an image is its page's address …/<book>/<image> or \"Odkaz na snímek\" in the POPIS panel (the terms of /Uvod and the archive's reply, 2026-11-05)",
+      "checked": "2026-11-05",
       "browserOnly": true
     },
     {
@@ -667,11 +667,11 @@
       "host": "www.ceskearchivy.cz",
       "name": "Státní oblastní archiv v Třeboni (website)",
       "level": "manual",
-      "terms": "https://digi.ceskearchivy.cz/DA?subject=2&menu=8",
-      "quote": "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 apod. je zakázáno.",
+      "terms": "https://digi.ceskearchivy.cz/Uvod",
+      "quote": "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.",
       "robots": "User-agent: * · Disallow: /administrator/ · /images/ · /media/ … (Joomla default)",
-      "scope": "the archive's information pages only; its scans are on digi.ceskearchivy.cz (a person's browser only, viewing only); the research rules and price lists lie under /images/, which robots.txt keeps off (the terms quoted as read on 2026-10-11)",
-      "checked": "2026-10-11"
+      "scope": "the archive's information pages only; its scans are on digi.ceskearchivy.cz (a person's browser only, selected images by hand only); the research rules and price lists lie under /images/, which robots.txt keeps off (the terms quoted as read on 2026-11-05)",
+      "checked": "2026-11-05"
     },
     {
       "host": "www.soalitomerice.cz",

package/assets/lang/cs.json

@@ -491,6 +491,7 @@
   "ui.wait.kind.tune": "čtení snímků",
   "ui.wait.kind.other": "jiné",
   "ui.wait.kind.conflict": "rozpor",
+  "ui.wait.kind.hypothesis": "hypotéza",
   "ui.wait.kind.place": "místo",
   "ui.wait.kind.branch": "větev",
   "ui.waiting.place.propose": "Které místo je {place}?",
@@ -530,6 +531,19 @@
   "ui.wait.conflict.take.research": "Převzít hodnotu výzkumu",
   "ui.wait.conflict.take.archive": "Převzít hodnotu Archivu Stromu",
   "ui.wait.conflict.open": "Nechat otevřený",
+  "ui.wait.hypothesis.proposed": "Návrh: varianta {variant} – {decision}",
+  "ui.wait.hypothesis.proposed.plain": "Návrh: {decision}",
+  "ui.wait.hypothesis.proposed.abandon": "Návrh: neplatí žádná z variant – {decision}",
+  "ui.wait.hypothesis.again": "Znovu rozhodnout, protože: {reason}",
+  "ui.wait.hypothesis.was": "Dříve rozhodnuto: {decision}",
+  "ui.wait.hypothesis.accept": "Rozhodnout podle návrhu",
+  "ui.wait.hypothesis.other": "Rozhodnout jinak",
+  "ui.wait.hypothesis.keep": "Nechat, jak je (návrh nepřijat)",
+  "ui.wait.hypothesis.pick": "Která varianta platí?",
+  "ui.wait.hypothesis.none": "Žádná (hypotéza odložena)",
+  "ui.wait.hypothesis.decided": "✓ Hypotéza je rozhodnutá.",
+  "ui.wait.hypothesis.abandoned": "✓ Hypotéza je odložená: neplatí žádná z jejích variant.",
+  "ui.wait.hypothesis.kept": "Hypotéza zůstává, jak byla; návrh je uložen v jejích poznámkách.",
   "ui.wait.letter.todo": "dopis k odeslání",
   "ui.wait.family.todo": "dotaz k odeslání",
   "ui.wait.ago.today": "dnes",
@@ -884,7 +898,7 @@
   "review.reread.done": "zápis každého údaje přečtený naslepo modelem {model} (strom read M… --blind): shoda → poznámka u údaje; rozdíl → rozpor s oběma čteními",
   "review.conflicts.what": "Rozhodnout, co zůstalo otevřené u osoby {name}: {list}{more}",
   "review.conflicts.why": "rozpory mezi prameny a soupeřící hypotézy čekají na rozhodnutí ({research})",
-  "review.conflicts.done": "každý vyřešený nebo rozhodnutý se zdůvodněním (strom conflict resolve, strom hypothesis decide) – nebo úkol říká, co by rozhodlo",
+  "review.conflicts.done": "každý rozpor vyřešený se zdůvodněním (strom conflict resolve), každá hypotéza, kterou záznamy rozhodují, navržená uživateli k rozhodnutí (strom hypothesis propose) – nebo úkol říká, co by rozhodlo",
   "hypothesis.links.what": "Doplnit, co by spojovaly verze hypotéz {list}",
   "hypothesis.links.why": "tyto hypotézy jmenují své osoby jen slovy svých verzí; aplikace Strom ukáže, co by verze spojila – i kde strom končí – jen z jejích vazeb",
   "hypothesis.links.done": "každá verze přečtená (strom hypothesis show {first} …) a řečeno, co by spojila: strom hypothesis link H… <písmeno> --child P… --of F… (nebo --parents P… [P…], --same, --partners, --siblings); verze, která nic jasného nespojuje, zůstane bez vazeb",
@@ -1252,6 +1266,7 @@
   "ui.help.cmd.person.list": "Osoby v rodokmenu",
   "ui.help.cmd.pedigree": "Předkové osoby jako strom",
   "ui.help.cmd.find": "Najít osobu, záznam nebo místo podle jména",
+  "ui.help.cmd.doc": "Jak Strom funguje: pravidla výzkumu a aplikace podle čísla nebo slov",
   "ui.help.cmd.app": "Otevřít výzkum v aplikaci Strom",
   "ui.help.cmd.app.install": "Nainstalovat aplikaci Strom z prohlížeče",
   "ui.help.cmd.live": "Zda aplikace Strom sleduje výzkum živě: most pro ni a jeho adresa",
@@ -1298,6 +1313,18 @@
   "ui.help.more": "Nápověda k jednomu příkazu: strom help <příkaz> --human · všechny příkazy anglicky (co čte agent): strom help",
   "ui.help.more.archive": "Nápověda k jednomu příkazu: strom help <příkaz> --human",
   "ui.help.source": "Zdrojový kód (GNU AGPL 3.0 nebo pozdější): {url}",
+  "ui.help.doc": "Jak Strom funguje: strom doc · stromapp.info/doc/{lang}/",
+  "ui.docs.how": "Pravidlo: strom doc R2.3 · hledání: strom doc <slova>",
+  "ui.docs.fallback": "Jak Strom funguje není napsáno v jazyce {language}: anglicky.",
+  "ui.docs.chapter": "V této kapitole:",
+  "ui.docs.under": "Podrobněji:",
+  "ui.docs.found": "Nalezeno pro „{query}“: {n}",
+  "ui.docs.more": "A dalších {n}: strom doc {query} --limit {all}",
+  "ui.docs.none": "Pro „{query}“ nic nenalezeno – obsah: strom doc",
+  "ui.error.doc.unknown": "{number} v Jak Strom funguje není (strom-doc {pin}) – nejblíž: {near}",
+  "ui.error.doc.unknown.hint": "strom doc {first} · obsah: strom doc",
+  "ui.error.doc.unknown.none": "{number} v Jak Strom funguje není (strom-doc {pin})",
+  "ui.error.doc.unknown.none.hint": "obsah: strom doc",
   "ui.help.examples": "Příklady:",
   "ui.help.details": "Podrobnosti a volby (anglicky): strom help {cmd}",
   "ui.help.agentonly": "strom {cmd}: příkaz, který používá agent při práci – podrobnosti (anglicky): strom help {cmd}",
@@ -2396,6 +2423,7 @@
   "wait.group.conflicts": "K rozhodnutí – rozpory",
   "wait.group.places": "Místa ke ztotožnění",
   "wait.group.branches": "Větve mimo linie",
+  "wait.group.hypotheses": "Hypotézy k rozhodnutí",
   "log.session.start": "Agent začal: {name}",
   "log.session.close": "Agent skončil: {name}",
   "log.lesson.add": "Poznatek: {name}",
@@ -2405,6 +2433,8 @@
   "log.hypothesis.link": "Co by verze hypotézy spojila: {name}",
   "log.hypothesis.variant": "Další možnost hypotézy: {name}",
   "log.hypothesis.decide": "Hypotéza rozhodnuta: {name}",
+  "log.hypothesis.propose": "Návrh rozhodnutí hypotézy: {name}",
+  "log.hypothesis.keep": "Hypotéza ponechána, jak byla: {name}",
   "log.conflict.add": "Záznamy si odporují: {name}",
   "log.conflict.resolve": "Rozpor vyřešen: {name}",
   "log.conflict.leave": "Rozpor ponechán agentovi: {name}",
@@ -2944,6 +2974,7 @@
   "ui.error.option.unknown.none.hint": "{help}",
   "ui.error.option.unknown.status.hint": "jistota (--status) patří jen k údaji (E…), nikdy ke jménu ani k rodině: strom cite E… S… --status probable|proven, strom event edit E… --status …",
   "ui.error.option.no-value": "{opt} se píše bez hodnoty",
+  "ui.error.option.positive": "{opt} je celé číslo od 1 – „{value}“ jím není",
   "ui.error.option.needs-value": "{opt} potřebuje hodnotu {value}",
   "ui.error.option.needs-value.hint": "strom help {path}",
   "ui.error.record.none": "{id} v rodokmenu není",
@@ -2978,6 +3009,7 @@
   "ui.error.conflict.needs-resolution.hint": "nebo vzít jednu stranu: strom conflict resolve {id} --take user|research",
   "ui.error.person.no-match": "nikdo v rodokmenu neodpovídá „{ref}“",
   "ui.conflict.tasks-open": "k {id} jsou ještě otevřené úkoly {tasks} — uzavřít: strom task done {first} --result \"…\"",
+  "ui.hypothesis.decided.next": "Co rozhodnutí spojuje a zdroje, které uvádí, zapíše agent do stromu při své příští práci.",
   "ui.arg.what-the-family-knows": "co rodina ví",
   "ui.error.story.no-source": "{id} v rodokmenu není",
   "ui.error.story.no-source.hint": "pozadí místa a doby se nejdřív zapíše jako pramen: strom source add … --kind book|newspaper|web",

package/assets/lang/de.json

@@ -491,6 +491,7 @@
   "ui.wait.kind.tune": "Lesen der Scans",
   "ui.wait.kind.other": "Sonstiges",
   "ui.wait.kind.conflict": "Widerspruch",
+  "ui.wait.kind.hypothesis": "Hypothese",
   "ui.wait.kind.place": "Ort",
   "ui.wait.kind.branch": "Zweig",
   "ui.waiting.place.propose": "Welcher Ort ist {place}?",
@@ -530,6 +531,19 @@
   "ui.wait.conflict.take.research": "Wert der Forschung übernehmen",
   "ui.wait.conflict.take.archive": "Wert des Strom-Archivs übernehmen",
   "ui.wait.conflict.open": "Offen lassen",
+  "ui.wait.hypothesis.proposed": "Vorschlag: Variante {variant} – {decision}",
+  "ui.wait.hypothesis.proposed.plain": "Vorschlag: {decision}",
+  "ui.wait.hypothesis.proposed.abandon": "Vorschlag: keine der Varianten trifft zu – {decision}",
+  "ui.wait.hypothesis.again": "Erneut entscheiden, weil: {reason}",
+  "ui.wait.hypothesis.was": "Früher entschieden: {decision}",
+  "ui.wait.hypothesis.accept": "Wie vorgeschlagen entscheiden",
+  "ui.wait.hypothesis.other": "Anders entscheiden",
+  "ui.wait.hypothesis.keep": "So lassen (Vorschlag nicht übernommen)",
+  "ui.wait.hypothesis.pick": "Welche Variante trifft zu?",
+  "ui.wait.hypothesis.none": "Keine (Hypothese zurückgestellt)",
+  "ui.wait.hypothesis.decided": "✓ Die Hypothese ist entschieden.",
+  "ui.wait.hypothesis.abandoned": "✓ Die Hypothese ist zurückgestellt: keine ihrer Varianten trifft zu.",
+  "ui.wait.hypothesis.kept": "Die Hypothese bleibt, wie sie war; der Vorschlag steht in ihren Notizen.",
   "ui.wait.letter.todo": "ein Brief zu senden",
   "ui.wait.family.todo": "eine Nachricht zu senden",
   "ui.wait.ago.today": "heute",
@@ -884,7 +898,7 @@
   "review.reread.done": "der Eintrag jeder Angabe blind mit {model} gelesen (strom read M… --blind): übereinstimmend → Notiz an der Angabe; abweichend → ein Widerspruch mit beiden Lesungen",
   "review.conflicts.what": "Entscheiden, was bei {name} offen geblieben ist: {list}{more}",
   "review.conflicts.why": "Widersprüche zwischen Quellen und konkurrierende Hypothesen warten auf eine Entscheidung ({research})",
-  "review.conflicts.done": "jeder gelöst oder entschieden mit Begründung (strom conflict resolve, strom hypothesis decide) – oder eine Aufgabe sagt, was entscheiden würde",
+  "review.conflicts.done": "jeder Widerspruch gelöst mit Begründung (strom conflict resolve), jede Hypothese, die die Einträge entscheiden, dem Nutzer zur Entscheidung vorgeschlagen (strom hypothesis propose) – oder eine Aufgabe sagt, was entscheiden würde",
   "hypothesis.links.what": "Angeben, was die Varianten von {list} verbinden würden",
   "hypothesis.links.why": "diese Hypothesen nennen ihre Personen nur in den Worten ihrer Varianten; die Strom-App zeigt, was eine Variante verbinden würde – und wo der Stammbaum endet – nur aus ihren Verknüpfungen",
   "hypothesis.links.done": "jede Variante gelesen (strom hypothesis show {first} …) und angegeben, was sie verbinden würde: strom hypothesis link H… <Buchstabe> --child P… --of F… (oder --parents P… [P…], --same, --partners, --siblings); eine Variante, die nichts Klares verbindet, bleibt ohne Verknüpfungen",
@@ -1252,6 +1266,7 @@
   "ui.help.cmd.person.list": "Die Personen des Stammbaums",
   "ui.help.cmd.pedigree": "Die Vorfahren einer Person als Baum",
   "ui.help.cmd.find": "Eine Person, einen Eintrag oder einen Ort nach dem Namen finden",
+  "ui.help.cmd.doc": "Wie Strom funktioniert: die Regeln der Forschung und der App, nach Nummer oder Wörtern",
   "ui.help.cmd.app": "Die Forschung in der Strom-App öffnen",
   "ui.help.cmd.app.install": "Die Strom-App aus dem Browser installieren",
   "ui.help.cmd.live": "Ob die Strom-App die Forschung live verfolgt: die Brücke dafür und ihre Adresse",
@@ -1298,6 +1313,18 @@
   "ui.help.more": "Hilfe zu einem Befehl: strom help <Befehl> --human · alle Befehle auf Englisch (was ein Agent liest): strom help",
   "ui.help.more.archive": "Hilfe zu einem Befehl: strom help <Befehl> --human",
   "ui.help.source": "Quellcode (GNU AGPL 3.0 oder später): {url}",
+  "ui.help.doc": "Wie Strom funktioniert: strom doc · stromapp.info/doc/{lang}/",
+  "ui.docs.how": "Eine Regel: strom doc R2.3 · Suche: strom doc <Wörter>",
+  "ui.docs.fallback": "Wie Strom funktioniert gibt es nicht auf {language}: auf Englisch.",
+  "ui.docs.chapter": "In diesem Kapitel:",
+  "ui.docs.under": "Im Einzelnen:",
+  "ui.docs.found": "Gefunden für „{query}“: {n}",
+  "ui.docs.more": "Noch {n}: strom doc {query} --limit {all}",
+  "ui.docs.none": "Für „{query}“ nichts gefunden – Inhalt: strom doc",
+  "ui.error.doc.unknown": "{number} gibt es in Wie Strom funktioniert nicht (strom-doc {pin}) – am nächsten: {near}",
+  "ui.error.doc.unknown.hint": "strom doc {first} · Inhalt: strom doc",
+  "ui.error.doc.unknown.none": "{number} gibt es in Wie Strom funktioniert nicht (strom-doc {pin})",
+  "ui.error.doc.unknown.none.hint": "Inhalt: strom doc",
   "ui.help.examples": "Beispiele:",
   "ui.help.details": "Einzelheiten und Optionen (auf Englisch): strom help {cmd}",
   "ui.help.agentonly": "strom {cmd}: ein Befehl, den der Agent bei seiner Arbeit verwendet – Einzelheiten (auf Englisch): strom help {cmd}",
@@ -2396,6 +2423,7 @@
   "wait.group.conflicts": "Widersprüche zu entscheiden",
   "wait.group.places": "Orte zu bestimmen",
   "wait.group.branches": "Zweige außerhalb der Linien",
+  "wait.group.hypotheses": "Hypothesen zu entscheiden",
   "log.session.start": "Der Agent beginnt: {name}",
   "log.session.close": "Der Agent ist fertig: {name}",
   "log.lesson.add": "Gelernt: {name}",
@@ -2405,6 +2433,8 @@
   "log.hypothesis.link": "Was eine Variante der Hypothese verbinden würde: {name}",
   "log.hypothesis.variant": "Eine weitere Möglichkeit der Hypothese: {name}",
   "log.hypothesis.decide": "Hypothese entschieden: {name}",
+  "log.hypothesis.propose": "Vorschlag zur Entscheidung der Hypothese: {name}",
+  "log.hypothesis.keep": "Hypothese gelassen, wie sie war: {name}",
   "log.conflict.add": "Die Einträge widersprechen sich: {name}",
   "log.conflict.resolve": "Widerspruch geklärt: {name}",
   "log.conflict.leave": "Widerspruch dem Agenten überlassen: {name}",
@@ -2944,6 +2974,7 @@
   "ui.error.option.unknown.none.hint": "{help}",
   "ui.error.option.unknown.status.hint": "eine Sicherheit (--status) gehört nur zu einer Angabe (E…), nie zu einem Namen oder einer Familie: strom cite E… S… --status probable|proven, strom event edit E… --status …",
   "ui.error.option.no-value": "{opt} hat keinen Wert",
+  "ui.error.option.positive": "{opt} ist eine ganze Zahl ab 1 – „{value}“ ist keine",
   "ui.error.option.needs-value": "{opt} braucht einen Wert {value}",
   "ui.error.option.needs-value.hint": "strom help {path}",
   "ui.error.record.none": "{id} gibt es im Stammbaum nicht",
@@ -2978,6 +3009,7 @@
   "ui.error.conflict.needs-resolution.hint": "oder eine Seite wählen: strom conflict resolve {id} --take user|research",
   "ui.error.person.no-match": "niemand im Stammbaum passt zu „{ref}“",
   "ui.conflict.tasks-open": "zu {id} sind noch Aufgaben offen: {tasks} — abschließen: strom task done {first} --result \"…\"",
+  "ui.hypothesis.decided.next": "Was die Entscheidung verbindet und die Quellen, die sie nennt, trägt der Agent bei seiner nächsten Arbeit in den Stammbaum ein.",
   "ui.arg.what-the-family-knows": "was die Familie weiß",
   "ui.error.story.no-source": "{id} gibt es im Stammbaum nicht",
   "ui.error.story.no-source.hint": "der Hintergrund von Ort und Zeit wird zuerst als Quelle erfasst: strom source add … --kind book|newspaper|web",

package/assets/lang/pl.json

@@ -491,6 +491,7 @@
   "ui.wait.kind.tune": "odczyt skanów",
   "ui.wait.kind.other": "inne",
   "ui.wait.kind.conflict": "sprzeczność",
+  "ui.wait.kind.hypothesis": "hipoteza",
   "ui.wait.kind.place": "miejsce",
   "ui.wait.kind.branch": "gałąź",
   "ui.waiting.place.propose": "Które miejsce to {place}?",
@@ -530,6 +531,19 @@
   "ui.wait.conflict.take.research": "Przyjęcie wartości z badania",
   "ui.wait.conflict.take.archive": "Przyjęcie wartości z Archiwum Strom",
   "ui.wait.conflict.open": "Pozostaw otwartą",
+  "ui.wait.hypothesis.proposed": "Propozycja: wariant {variant} – {decision}",
+  "ui.wait.hypothesis.proposed.plain": "Propozycja: {decision}",
+  "ui.wait.hypothesis.proposed.abandon": "Propozycja: żaden z wariantów nie jest prawdziwy – {decision}",
+  "ui.wait.hypothesis.again": "Ponowne rozstrzygnięcie, ponieważ: {reason}",
+  "ui.wait.hypothesis.was": "Wcześniej rozstrzygnięto: {decision}",
+  "ui.wait.hypothesis.accept": "Rozstrzygnąć zgodnie z propozycją",
+  "ui.wait.hypothesis.other": "Rozstrzygnąć inaczej",
+  "ui.wait.hypothesis.keep": "Zostawić bez zmian (propozycja nieprzyjęta)",
+  "ui.wait.hypothesis.pick": "Który wariant jest prawdziwy?",
+  "ui.wait.hypothesis.none": "Żaden (hipoteza odłożona)",
+  "ui.wait.hypothesis.decided": "✓ Hipoteza jest rozstrzygnięta.",
+  "ui.wait.hypothesis.abandoned": "✓ Hipoteza jest odłożona: żaden z jej wariantów nie jest prawdziwy.",
+  "ui.wait.hypothesis.kept": "Hipoteza zostaje bez zmian; propozycja jest zapisana w jej notatkach.",
   "ui.wait.letter.todo": "list do wysłania",
   "ui.wait.family.todo": "zapytanie do wysłania",
   "ui.wait.ago.today": "dzisiaj",
@@ -884,7 +898,7 @@
   "review.reread.done": "akt każdej danej odczytany na ślepo modelem {model} (strom read M… --blind): zgodność → notatka przy danej; różnica → sprzeczność z oboma odczytami",
   "review.conflicts.what": "Rozstrzygnąć, co pozostało otwarte przy osobie {name}: {list}{more}",
   "review.conflicts.why": "sprzeczności między źródłami i konkurujące hipotezy czekają na rozstrzygnięcie ({research})",
-  "review.conflicts.done": "każda rozwiązana lub rozstrzygnięta z uzasadnieniem (strom conflict resolve, strom hypothesis decide) – albo zadanie mówi, co by ją rozstrzygnęło",
+  "review.conflicts.done": "każda sprzeczność rozwiązana z uzasadnieniem (strom conflict resolve), każda hipoteza, którą rozstrzygają zapisy, zaproponowana użytkownikowi do rozstrzygnięcia (strom hypothesis propose) – albo zadanie mówi, co by ją rozstrzygnęło",
   "hypothesis.links.what": "Uzupełnić, co łączyłyby warianty hipotez {list}",
   "hypothesis.links.why": "te hipotezy wymieniają swoje osoby tylko słowami swoich wariantów; aplikacja Strom pokaże, co wariant by połączył – i gdzie drzewo się kończy – tylko na podstawie jego powiązań",
   "hypothesis.links.done": "każdy wariant przeczytany (strom hypothesis show {first} …) i podane, co by połączył: strom hypothesis link H… <litera> --child P… --of F… (albo --parents P… [P…], --same, --partners, --siblings); wariant, który nie łączy niczego jasnego, pozostaje bez powiązań",
@@ -1252,6 +1266,7 @@
   "ui.help.cmd.person.list": "Osoby w drzewie",
   "ui.help.cmd.pedigree": "Przodkowie osoby w formie drzewa",
   "ui.help.cmd.find": "Znajdź osobę, zapis albo miejsce według nazwy",
+  "ui.help.cmd.doc": "Jak działa Strom: zasady badania i aplikacji według numeru albo słów",
   "ui.help.cmd.app": "Otwórz badanie w aplikacji Strom",
   "ui.help.cmd.app.install": "Zainstaluj aplikację Strom z przeglądarki",
   "ui.help.cmd.live": "Czy aplikacja Strom śledzi badanie na żywo: mostek dla niej i jego adres",
@@ -1298,6 +1313,18 @@
   "ui.help.more": "Pomoc do jednego polecenia: strom help <polecenie> --human · wszystkie polecenia po angielsku (to, co czyta agent): strom help",
   "ui.help.more.archive": "Pomoc do jednego polecenia: strom help <polecenie> --human",
   "ui.help.source": "Kod źródłowy (GNU AGPL 3.0 lub nowsza): {url}",
+  "ui.help.doc": "Jak działa Strom: strom doc · stromapp.info/doc/{lang}/",
+  "ui.docs.how": "Zasada: strom doc R2.3 · wyszukiwanie: strom doc <słowa>",
+  "ui.docs.fallback": "Jak działa Strom nie jest napisane w języku {language}: po angielsku.",
+  "ui.docs.chapter": "W tym rozdziale:",
+  "ui.docs.under": "Szczegółowo:",
+  "ui.docs.found": "Znaleziono dla „{query}”: {n}",
+  "ui.docs.more": "I jeszcze {n}: strom doc {query} --limit {all}",
+  "ui.docs.none": "Dla „{query}” nic nie znaleziono – spis treści: strom doc",
+  "ui.error.doc.unknown": "{number} nie ma w Jak działa Strom (strom-doc {pin}) – najbliżej: {near}",
+  "ui.error.doc.unknown.hint": "strom doc {first} · spis treści: strom doc",
+  "ui.error.doc.unknown.none": "{number} nie ma w Jak działa Strom (strom-doc {pin})",
+  "ui.error.doc.unknown.none.hint": "spis treści: strom doc",
   "ui.help.examples": "Przykłady:",
   "ui.help.details": "Szczegóły i opcje (po angielsku): strom help {cmd}",
   "ui.help.agentonly": "strom {cmd}: polecenie, którego agent używa przy pracy – szczegóły (po angielsku): strom help {cmd}",
@@ -2396,6 +2423,7 @@
   "wait.group.conflicts": "Do rozstrzygnięcia – sprzeczności",
   "wait.group.places": "Miejsca do identyfikacji",
   "wait.group.branches": "Gałęzie poza liniami",
+  "wait.group.hypotheses": "Hipotezy do rozstrzygnięcia",
   "log.session.start": "Agent zaczął: {name}",
   "log.session.close": "Agent skończył: {name}",
   "log.lesson.add": "Spostrzeżenie: {name}",
@@ -2405,6 +2433,8 @@
   "log.hypothesis.link": "Co połączyłby wariant hipotezy: {name}",
   "log.hypothesis.variant": "Kolejna możliwość hipotezy: {name}",
   "log.hypothesis.decide": "Hipoteza rozstrzygnięta: {name}",
+  "log.hypothesis.propose": "Propozycja rozstrzygnięcia hipotezy: {name}",
+  "log.hypothesis.keep": "Hipoteza pozostawiona bez zmian: {name}",
   "log.conflict.add": "Zapisy sobie przeczą: {name}",
   "log.conflict.resolve": "Sprzeczność wyjaśniona: {name}",
   "log.conflict.leave": "Sprzeczność pozostawiona agentowi: {name}",
@@ -2944,6 +2974,7 @@
   "ui.error.option.unknown.none.hint": "{help}",
   "ui.error.option.unknown.status.hint": "pewność (--status) należy tylko do faktu (E…), nigdy do imienia ani do rodziny: strom cite E… S… --status probable|proven, strom event edit E… --status …",
   "ui.error.option.no-value": "{opt} podaje się bez wartości",
+  "ui.error.option.positive": "{opt} to liczba całkowita od 1 – „{value}” nią nie jest",
   "ui.error.option.needs-value": "{opt} wymaga wartości {value}",
   "ui.error.option.needs-value.hint": "strom help {path}",
   "ui.error.record.none": "{id} nie ma w drzewie genealogicznym",
@@ -2978,6 +3009,7 @@
   "ui.error.conflict.needs-resolution.hint": "albo wybrać jedną stronę: strom conflict resolve {id} --take user|research",
   "ui.error.person.no-match": "nikt w drzewie genealogicznym nie odpowiada „{ref}”",
   "ui.conflict.tasks-open": "do {id} są jeszcze otwarte zadania {tasks} – zamknąć: strom task done {first} --result \"…\"",
+  "ui.hypothesis.decided.next": "To, co rozstrzygnięcie łączy, i źródła, które wymienia, agent wpisze do drzewa podczas swojej następnej pracy.",
   "ui.arg.what-the-family-knows": "co wie rodzina",
   "ui.error.story.no-source": "{id} nie ma w drzewie genealogicznym",
   "ui.error.story.no-source.hint": "tło miejsca i czasu zapisuje się najpierw jako źródło: strom source add … --kind book|newspaper|web",

package/assets/method/core.md

@@ -49,7 +49,7 @@ conclusion so the next researcher can follow it.
   --pages` for what was searched in vain — never all of it at the end.
   A fact of a person goes on the person (`event add`); a note or the diary is
   for what is not a fact yet. What you held back while who it was stayed a
-  hypothesis goes on the person when you decide it.
+  hypothesis goes on the person once the user decides it.
 <!-- end -->
 - **The time is strom's to say** (a session working alone stops when the
   brief says): its output gives the time left after long steps and counts
@@ -78,9 +78,11 @@ conclusion so the next researcher can follow it.
   words only. An older open hypothesis you work on that has none gets them
   then (`strom hypothesis list --unlinked`). A variant's letter stays its
   claim's: a claim that would connect other people is a new variant
-  (`strom hypothesis variant H… "<claim>"`). Deciding one whose variants have
-  links names the variant it is decided for:
-  `strom hypothesis decide H… --variant B --decision "…"`.
+  (`strom hypothesis variant H… "<claim>"`).
+- **The user decides a hypothesis**; you propose it once the records point
+  to one variant: `strom hypothesis propose H… --variant B --decision "…"`
+  (none holds: `--abandon`), and go on. What the user decided, the brief
+  lists for you to record.
 <!-- end -->
 <!-- for links -->
   Read each variant whole (`strom hypothesis show H…`) and the people it

package/assets/method/link.md

@@ -22,7 +22,8 @@
 6. **Extract the whole entry** (see core). Godparents and witnesses are often
    relatives and prove the next link.
 7. **Record** (see "recording an entry"): source (with transcript in the
-   original language), facts with citations, names, family links, the search
+   original language, and a translation into the research language when the
+   record is in another language or script), facts with citations, names, family links, the search
    (found or negative), lessons about the book. `proven` only for what you read
    yourself and the entry states directly.
 8. Done when the entry is found and recorded — or the agreed range was searched

package/assets/method/recording.md

@@ -25,6 +25,9 @@ creates, `@name` uses it later; a found search comes after the source it found
 - `--transcript` is the entry's words as they stand in it — its own language,
   spelling and abbreviations, line by line, unread letters `[?]`; the Strom app
   shows them next to the entry's image. Every entry read gets them.
+- `--translation`: a record in another language or script than the
+  research's (Latin, Kurrent, Polish, Cyrillic …) gets one in the research
+  language; the transcript stays in the record's.
 - A fact already in the tree gets the citation (`cite E…`, `--status` is a
   fact's only — a name or a family cited takes none), not a second fact —
   and what the record adds to it: `event edit E… --age husband:27 --age wife:17
@@ -80,7 +83,7 @@ creates, `@name` uses it later; a found search comes after the source it found
   link) stands: an agent decides it again — or opens a conflict of that fact
   again — only on a source the decision did not weigh (`--source S…`) and with
   `--reason "…"`; the same record read again changes nothing. A decided
-  hypothesis that a new record overturns is decided again (the earlier
-  decision is kept): `strom hypothesis decide H… --decision "…" --reason "…"`.
+  hypothesis that a new record overturns is proposed again (the earlier
+  decision is kept): `strom hypothesis propose H… --decision "…" --reason "…"`.
   People named wrongly by the weaker record keep that name as a variant
   (`name add … --primary` for the right one); they are not deleted.