strom-research 1.28.0-beta.2 → 1.28.0

package/CHANGELOG.cs.md

@@ -7,7 +7,7 @@ Změny každé verze ve zkratce. Úplné poznámky a instalační řádky jsou n
 
 ## 1.28.0
 
-*Připravuje se: bety do 1.28.0-beta.2. Oddíl bude úplný s vydáním.*
+*6. 11. 2026 · patří k aplikaci Strom 3.24.0.*
 
 - **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
@@ -28,11 +28,20 @@ Změny každé verze ve zkratce. Úplné poznámky a instalační řádky jsou n
 
 - **Kde agent pracuje, pro mapu aplikace Strom.** Během práce agenta strom aplikaci říká, ke kterému místu patří kniha,
   kterou agent zkoumá – farnost nebo obec jejích zápisů, nikdy archiv –, aby ho aplikace při sledování práce mohla
-  ukázat na mapě. Když to výzkum neví, nic neříká a aplikace zůstane u míst osoby.
+  ukázat na mapě. Když to výzkum neví, nic neříká a aplikace zůstane u míst osoby. Práce na rodině uvede pár – manžela,
+  jinak manželku – i rodinu samotnou, aby se aplikace mohla zaměřit na pár.
 
 - **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.
 
+- **Seznam před během ukazuje, co běh vezme.** V položce Nechat agenta pracovat samotného jsou mezi úkoly v pořadí, v jakém je agent
+  vezme, i úkoly dějin míst, když na ně přijde řada – místa údajů k zařazení jdou napřed –, označené jako dějiny.
+
+- **Podmínka běhu na jednom řádku.** Co podmínka (`run.gate`) odpověděla, jak se ptá – před každým sezením, nebo při
+  ručním spuštění jednou – a její strop se před prvním sezením řeknou na jednom řádku, ne na třech. Agent, který čte
+  webové stránky přes vlastního pomocníka, se už nehlásí jako bez nástroje na čtení webu; nástroj, který opravdu
+  chybí, se řekne v jazyce výzkumu.
+
 ## 1.27.0
 
 *5. 11. 2026 · patří k aplikaci Strom 3.23.0.*

package/CHANGELOG.de.md

@@ -7,7 +7,7 @@ Die Änderungen jeder Version in Kürze. Die vollständigen Hinweise und die Ins
 
 ## 1.28.0
 
-*In Vorbereitung: die Betas bis 1.28.0-beta.2. Der Abschnitt ist mit dem Release vollständig.*
+*6.11.2026 · gehört zur Strom-App 3.24.0.*
 
 - **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,
@@ -32,12 +32,22 @@ Die Änderungen jeder Version in Kürze. Die vollständigen Hinweise und die Ins
 - **Wo der Agent arbeitet, für die Karte der Strom-App.** Während ein Agent arbeitet, sagt strom der App, zu welchem
   Ort das Buch gehört, das er untersucht – die Pfarrei oder das Dorf seiner Einträge, nie das Archiv –, damit die App
   ihn beim Verfolgen der Arbeit auf der Karte zeigen kann. Weiß die Forschung es nicht, sagt sie nichts, und die App
-  bleibt bei den Orten der Person.
+  bleibt bei den Orten der Person. Arbeit an einer Familie nennt das Paar – den Ehemann, sonst die Ehefrau – und die
+  Familie selbst, damit die App sich dem Paar zuwenden kann.
 
 - **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.
 
+- **Die Liste vor einem Lauf zeigt, was der Lauf nimmt.** Unter „Den Agenten allein arbeiten lassen“ stehen unter den
+  Aufgaben in der Reihenfolge, in der der Agent sie nimmt, nun auch die Aufgaben der Geschichte der Orte, wenn sie an der
+  Reihe sind – die Orte der Angaben zuerst –, als Geschichte gekennzeichnet.
+
+- **Die Bedingung eines Laufs in einer Zeile.** Was die Bedingung (`run.gate`) geantwortet hat, wie sie gefragt wird
+  – vor jeder Sitzung oder bei von Hand gestarteten Aufgaben einmal – und ihre Obergrenze stehen vor der ersten Sitzung
+  in einer Zeile, nicht in dreien. Ein Agent, der Webseiten über seinen eigenen Helfer liest, wird nicht mehr
+  als ohne Werkzeug zum Lesen des Webs gemeldet; ein Werkzeug, das wirklich fehlt, wird in der Sprache der Forschung gesagt.
+
 ## 1.27.0
 
 *5.11.2026 · gehört zur Strom-App 3.23.0.*

package/CHANGELOG.md

@@ -7,7 +7,7 @@ The changes of each version in short. The full notes and the install lines are o
 
 ## 1.28.0
 
-*In preparation: the betas up to 1.28.0-beta.2. The section is complete with the release.*
+*2026-11-06 · goes with the Strom app 3.24.0.*
 
 - **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
@@ -30,11 +30,21 @@ The changes of each version in short. The full notes and the install lines are o
 - **Where the agent works, for the map of the Strom app.** While an agent works, strom tells the app which place the
   book it examines belongs to – the parish or village of its records, never the archive – so the app can show it on the
   map when following the work. When the research does not know it, it says nothing, and the app keeps to the person's
-  own places.
+  own places. Work on a family names the couple – the husband, else the wife – and the family itself, so the app can
+  turn to the pair.
 
 - **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.
 
+- **The list before a run shows what the run takes.** Under Let the agent work on its own, the tasks listed in the order
+  the agent takes them now include the tasks of the history of the places in their turn – the places of the facts to
+  map come first – marked as history.
+
+- **The condition of a run in one line.** What the condition (`run.gate`) answered, how it is asked – before each
+  session, once for tasks started by hand – and its cap are said in one line before the first session, not in three.
+  An agent that reads web pages through its own helper is no longer reported as missing its web fetch; a tool
+  really missing is said in the research's language.
+
 ## 1.27.0
 
 *2026-11-05 · goes with the Strom app 3.23.0.*

package/CHANGELOG.pl.md

@@ -7,7 +7,7 @@ Zmiany każdej wersji w skrócie. Pełne informacje o wydaniach i polecenia inst
 
 ## 1.28.0
 
-*W przygotowaniu: bety do 1.28.0-beta.2. Sekcja będzie kompletna z wydaniem.*
+*6.11.2026 · współpracuje z aplikacją Strom 3.24.0.*
 
 - **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ą
@@ -31,11 +31,21 @@ Zmiany każdej wersji w skrócie. Pełne informacje o wydaniach i polecenia inst
 - **Gdzie pracuje agent – dla mapy aplikacji Strom.** Podczas pracy agenta strom podaje aplikacji, do którego miejsca
   należy księga, którą agent bada – parafia lub wieś jej wpisów, nigdy archiwum – aby aplikacja mogła je pokazać na
   mapie podczas śledzenia pracy. Gdy badania tego nie wiedzą, nic nie podają, a aplikacja pozostaje przy miejscach
-  osoby.
+  osoby. Praca nad rodziną podaje parę – męża, a jeśli go brak, żonę – oraz samą rodzinę, aby aplikacja mogła skupić
+  się na parze.
 
 - **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.
 
+- **Lista przed uruchomieniem pokazuje, co weźmie agent.** W pozycji „Pozwól agentowi pracować samodzielnie“ wśród
+  zadań w kolejności, w jakiej bierze je agent, są teraz także zadania historii miejsc, gdy przychodzi ich kolej –
+  miejsca danych najpierw –, oznaczone jako historia.
+
+- **Warunek przebiegu w jednym wierszu.** Co odpowiedział warunek (`run.gate`), jak jest pytany – przed każdą sesją
+  albo raz przy zadaniach uruchomionych ręcznie – i jego pułap są podane przed pierwszą sesją w jednym wierszu, nie w
+  trzech. Agent, który czyta strony internetowe przez własnego pomocnika, nie jest już zgłaszany jako
+  pozbawiony narzędzia do czytania stron; narzędzie, którego naprawdę brak, jest podawane w języku badań.
+
 ## 1.27.0
 
 *5.11.2026 · współpracuje z aplikacją Strom 3.23.0.*

package/assets/lang/cs.json

@@ -614,6 +614,7 @@
   "ui.run.denied": "  · oprávnění odmítla {n}×: {what}",
   "ui.run.refused": "  · strom odmítl {n}× (limit {per, plural, one {# webového požadavku} other {# webových požadavků}} na jeden server v sezení nebo limit serveru): {what}",
   "ui.run.recover": "  · spojení agenta selhalo ({why}) — jeho sezení pokračuje za {s} s ({n}/{max})",
+  "ui.run.missingtools": "  · Claude Code nenačetl {tools} – sezení se bez toho nemusí obejít; s nastavením agent.addons on běží se vším jako dřív",
   "ui.run.exitOnly": "  · {session}: agent sezení uzavřel a pak skončil s kódem {code} — bráno jako hotové, běh pokračuje",
   "session.user": "zastaveno uživatelem",
   "session.run": "běh se zastavil dřív, než sezení skončilo (přerušení, nebo vypnutý počítač)",
@@ -2009,6 +2010,7 @@
   "ui.run.skip.held": "  · {task} vynechán: pracuje na něm jiný agent",
   "ui.run.next": "Na řadě jsou tyto úkoly, v pořadí, v jakém je agent vezme:",
   "ui.run.story": " (vyprávění)",
+  "ui.run.ofhistory": " (dějiny)",
   "ui.run.what": "Co má agent udělat?",
   "ui.run.queue": "Pracovat v pořadí fronty – počet úkolů se zadá",
   "ui.run.pick": "Jen vybrané úkoly ze seznamu",
@@ -2022,21 +2024,21 @@
   "ui.menu.working.more": "Samostatně teď pracují agenti: {n}.",
   "ui.run.beside": "⚠ Agent už tu pracuje sám (běhy: {n}). Další vedle něj si vezme jiné úkoly – náklady se sčítají.",
   "ui.run.beside.sure": "Spustit další vedle něj?",
-  "ui.run.gate": "· podmínka: {name} — ptá se před každým sezením; běh může nechat čekat",
   "ui.run.gate.wait": "⏸ čekání do {at} — {reason} (Ctrl-C běh ukončí)",
   "ui.run.asleep.wait": "⏸ čekání do {at} – zbylé úkoly potřebují {host}, který teď neodpovídá (Ctrl-C běh ukončí)",
   "ui.run.asleep.why": "{host} teď neodpovídá",
   "ui.run.stop.gate": "podmínka „{name}“ řekla dost — {reason}",
   "ui.run.stop.gate.error": "podmínka „{name}“ neodpověděla, jak má — {reason} (strom gate test)",
-  "ui.run.gate.once": "· podmínka: {name} — ruční spuštění: při nesplněné podmínce jedna otázka, zda přesto začít",
   "ui.run.gate.anyway": "Podmínka „{name}“ by teď nespouštěla — {reason}. Spustit přesto?",
   "ui.run.gate.anyway.here": "Spustit přesto?",
   "ui.run.gate.later": "zatím ne",
   "ui.run.gate.no": "ne",
   "ui.run.gate.noanswer": "neodpověděla, jak má (strom gate test)",
   "ui.run.stop.gate.declined": "nespuštěno — podmínka „{name}“: {reason}",
-  "ui.run.gate.cap": "· {name}: nastavený strop – kontroluje se před každým sezením; žádné „přesto začít“ ho nepřekročí",
-  "ui.run.gate.said": "· podmínka {name}: {word}{reason} (kód {status}; .strom/gate.log)",
+  "ui.run.gate.said": "· podmínka {name}{how}: {word}{reason} (kód {status}; .strom/gate.log)",
+  "ui.run.gate.how.each": " (ptá se před každým sezením)",
+  "ui.run.gate.how.once": " (ruční spuštění: ptá se jednou)",
+  "ui.run.gate.how.cap": " (strop: hlídá se před každým sezením, žádné „přesto začít“ ho nepřekročí)",
   "ui.run.stop.gate.cap": "strop podmínky „{name}“ – {reason} (pevná hranice z run.gate; „přesto začít“ ji nepřekročí)",
   "ui.run.cap.finish": "⏳ {session}: limit agenta na {used} % ({kind}) – sezení dostalo žádost zapsat, co našlo, a skončit; za stropem další sezení nezačne",
   "ui.run.limit.five_hour": "pětihodinové okno",

package/assets/lang/de.json

@@ -614,6 +614,7 @@
   "ui.run.denied": "  · Berechtigungen verweigert {n}×: {what}",
   "ui.run.refused": "  · strom hat {n}× abgelehnt (die Grenze von {per, plural, one {# Webanfrage} other {# Webanfragen}} an einen Server in einer Sitzung oder die des Servers): {what}",
   "ui.run.recover": "  · die Verbindung des Agenten ist abgebrochen ({why}) — seine Sitzung geht in {s} s weiter ({n}/{max})",
+  "ui.run.missingtools": "  · Claude Code hat {tools} nicht geladen – die Sitzung kommt ohne vielleicht nicht aus; mit der Einstellung agent.addons on läuft sie wie früher mit allem",
   "ui.run.exitOnly": "  · {session}: der Agent hat die Sitzung abgeschlossen und danach mit Code {code} geendet — als erledigt gewertet, der Lauf geht weiter",
   "session.user": "vom Benutzer angehalten",
   "session.run": "der Lauf brach ab, bevor die Sitzung endete (unterbrochen, oder der Computer wurde ausgeschaltet)",
@@ -2009,6 +2010,7 @@
   "ui.run.skip.held": "  · {task} ausgelassen: ein anderer Agent arbeitet daran",
   "ui.run.next": "Als Nächstes in der Warteschlange, in der Reihenfolge, in der der Agent sie nimmt:",
   "ui.run.story": " (eine Geschichte)",
+  "ui.run.ofhistory": " (Geschichte)",
   "ui.run.what": "Was soll der Agent tun?",
   "ui.run.queue": "Die Warteschlange in dieser Reihenfolge abarbeiten – wie viele, steht zur Wahl",
   "ui.run.pick": "Nur die aus der Liste gewählten Aufgaben",
@@ -2022,21 +2024,21 @@
   "ui.menu.working.more": "Gerade arbeiten Agenten selbstständig: {n}.",
   "ui.run.beside": "⚠ Hier arbeitet schon ein Agent selbstständig (Läufe: {n}). Ein weiterer daneben nimmt andere Aufgaben – die Kosten addieren sich.",
   "ui.run.beside.sure": "Einen weiteren daneben starten?",
-  "ui.run.gate": "· Bedingung: {name} — vor jeder Sitzung gefragt; sie kann den Lauf warten lassen",
   "ui.run.gate.wait": "⏸ Warten bis {at} — {reason} (Strg-C beendet den Lauf)",
   "ui.run.asleep.wait": "⏸ Warten bis {at} — die übrigen Aufgaben brauchen {host}, der gerade nicht antwortet (Strg-C beendet den Lauf)",
   "ui.run.asleep.why": "{host} antwortet gerade nicht",
   "ui.run.stop.gate": "die Bedingung „{name}“ sagte Halt — {reason}",
   "ui.run.stop.gate.error": "die Bedingung „{name}“ gab keine gültige Antwort — {reason} (strom gate test)",
-  "ui.run.gate.once": "· Bedingung: {name} — von Hand gestartet: ist die Bedingung nicht erfüllt, eine Frage, ob trotzdem begonnen wird",
   "ui.run.gate.anyway": "Die Bedingung „{name}“ würde jetzt nicht starten — {reason}. Trotzdem starten?",
   "ui.run.gate.anyway.here": "Trotzdem starten?",
   "ui.run.gate.later": "noch nicht",
   "ui.run.gate.no": "nein",
   "ui.run.gate.noanswer": "keine gültige Antwort (strom gate test)",
   "ui.run.stop.gate.declined": "nicht gestartet — die Bedingung „{name}“: {reason}",
-  "ui.run.gate.cap": "· {name}: eine Obergrenze ist gesetzt – vor jeder Sitzung geprüft; kein „trotzdem starten“ geht darüber hinaus",
-  "ui.run.gate.said": "· Bedingung {name}: {word}{reason} (Code {status}; .strom/gate.log)",
+  "ui.run.gate.said": "· Bedingung {name}{how}: {word}{reason} (Code {status}; .strom/gate.log)",
+  "ui.run.gate.how.each": " (vor jeder Sitzung gefragt)",
+  "ui.run.gate.how.once": " (von Hand gestartet: einmal gefragt)",
+  "ui.run.gate.how.cap": " (Obergrenze: vor jeder Sitzung geprüft, kein „trotzdem starten“ geht darüber hinaus)",
   "ui.run.stop.gate.cap": "die Obergrenze der Bedingung „{name}“ – {reason} (eine feste Grenze aus run.gate; kein „trotzdem starten“ geht darüber hinaus)",
   "ui.run.cap.finish": "⏳ {session}: das Limit des Agenten bei {used} % ({kind}) – die Sitzung ist gebeten aufzuschreiben, was gefunden wurde, und zu schließen; über der Obergrenze beginnt keine nächste Sitzung",
   "ui.run.limit.five_hour": "Fünf-Stunden-Fenster",

package/assets/lang/pl.json

@@ -614,6 +614,7 @@
   "ui.run.denied": "  · uprawnienia odmówiły {n}×: {what}",
   "ui.run.refused": "  · strom odmówił {n}× (limit {per, plural, one {# zapytania internetowego} few {# zapytań internetowych} many {# zapytań internetowych} other {# zapytań internetowych}} do jednego serwera w sesji albo limit serwera): {what}",
   "ui.run.recover": "  · połączenie agenta zostało przerwane ({why}) — jego sesja będzie kontynuowana za {s} s ({n}/{max})",
+  "ui.run.missingtools": "  · Claude Code nie wczytał {tools} – sesja może się bez tego nie obejść; z ustawieniem agent.addons on działa ze wszystkim, jak dawniej",
   "ui.run.exitOnly": "  · {session}: agent zamknął sesję, a potem zakończył się kodem {code} — uznane za ukończone, przebieg trwa dalej",
   "session.user": "zatrzymano przez użytkownika",
   "session.run": "przebieg zatrzymał się, zanim sesja się zakończyła (przerwanie albo wyłączony komputer)",
@@ -2009,6 +2010,7 @@
   "ui.run.skip.held": "  · {task} pominięte: pracuje nad nim inny agent",
   "ui.run.next": "Teraz kolej na te zadania, w kolejności, w jakiej weźmie je agent:",
   "ui.run.story": " (opowieść)",
+  "ui.run.ofhistory": " (historia)",
   "ui.run.what": "Co ma zrobić agent?",
   "ui.run.queue": "Praca według kolejki – liczba zadań do podania",
   "ui.run.pick": "Tylko wybrane zadania z listy",
@@ -2022,21 +2024,21 @@
   "ui.menu.working.more": "Agenci pracujący teraz samodzielnie: {n}.",
   "ui.run.beside": "⚠ Agent już tu pracuje samodzielnie (przebiegi: {n}). Kolejny obok niego weźmie inne zadania – koszty się sumują.",
   "ui.run.beside.sure": "Uruchomić kolejnego obok niego?",
-  "ui.run.gate": "· warunek: {name} – pytany przed każdą sesją; może kazać przebiegowi czekać",
   "ui.run.gate.wait": "⏸ oczekiwanie do {at} – {reason} (Ctrl-C kończy przebieg)",
   "ui.run.asleep.wait": "⏸ oczekiwanie do {at} – pozostałe zadania potrzebują {host}, który teraz nie odpowiada (Ctrl-C kończy przebieg)",
   "ui.run.asleep.why": "{host} teraz nie odpowiada",
   "ui.run.stop.gate": "warunek „{name}” powiedział dość – {reason}",
   "ui.run.stop.gate.error": "warunek „{name}” nie odpowiedział, jak powinien – {reason} (strom gate test)",
-  "ui.run.gate.once": "· warunek: {name} – uruchomienie ręczne: gdy warunek nie jest spełniony, jedno pytanie, czy mimo to zacząć",
   "ui.run.gate.anyway": "Warunek „{name}” teraz by nie uruchomił – {reason}. Uruchomić mimo to?",
   "ui.run.gate.anyway.here": "Uruchomić mimo to?",
   "ui.run.gate.later": "jeszcze nie",
   "ui.run.gate.no": "nie",
   "ui.run.gate.noanswer": "nie odpowiedział, jak powinien (strom gate test)",
   "ui.run.stop.gate.declined": "nie uruchomiono – warunek „{name}”: {reason}",
-  "ui.run.gate.cap": "· {name}: ustawiony pułap – sprawdzany przed każdą sesją; żadne „mimo to zacząć” go nie przekroczy",
-  "ui.run.gate.said": "· warunek {name}: {word}{reason} (kod {status}; .strom/gate.log)",
+  "ui.run.gate.said": "· warunek {name}{how}: {word}{reason} (kod {status}; .strom/gate.log)",
+  "ui.run.gate.how.each": " (pytany przed każdą sesją)",
+  "ui.run.gate.how.once": " (uruchomienie ręczne: pytany raz)",
+  "ui.run.gate.how.cap": " (pułap: sprawdzany przed każdą sesją, żadne „mimo to zacząć” go nie przekroczy)",
   "ui.run.stop.gate.cap": "pułap warunku „{name}” – {reason} (sztywna granica z run.gate; „mimo to zacząć” jej nie przekroczy)",
   "ui.run.cap.finish": "⏳ {session}: limit agenta na {used} % ({kind}) – sesja dostała prośbę o zapisanie, co znalazła, i zakończenie; po przekroczeniu pułapu kolejna sesja nie ruszy",
   "ui.run.limit.five_hour": "okno pięciogodzinne",

package/assets/strom-doc/CISLA.md

@@ -20,6 +20,7 @@ nenapsáno) · `neplatí od <verze>`.
 | R1.5 | R1-research-in-brief.md | výzkum 1.0.0 | platí | Co rozhoduje člověk | What a person decides | Was der Mensch entscheidet | Co rozstrzyga człowiek |
 | R1.6 | R1-research-in-brief.md | výzkum 1.0.0 | platí | Výzkum a aplikace Strom | The research and the Strom app | Die Forschung und die Strom-App | Badanie i aplikacja Strom |
 | R1.7 | R1-research-in-brief.md | výzkum 1.0.0 | platí | Jak výzkum čte skeny | How the research reads scans | Wie die Forschung Scans liest | Jak badanie czyta skany |
+| R1.8 | R1-research-in-brief.md | výzkum 1.28.0 | platí | Jak Strom funguje: `strom doc` | How Strom works: `strom doc` | So funktioniert Strom: `strom doc` | Jak działa Strom: `strom doc` |
 | R2 | R2-lines-and-queue.md | výzkum 1.0.0 | platí | Linie a fronta | Lines and the queue | Linien und Warteschlange | Linie i kolejka |
 | R2.1 | R2-lines-and-queue.md | výzkum 1.0.0 | platí | Linie určuje, co výzkum zkoumá | A line sets what the research investigates | Die Linie bestimmt, was die Forschung untersucht | Linia wyznacza, co badanie bada |
 | R2.1.1 | R2-lines-and-queue.md | výzkum 1.0.0 | platí | Druhy linií a meze | Kinds of lines and their limits | Arten von Linien und Grenzen | Rodzaje linii i ograniczenia |
@@ -83,6 +84,7 @@ nenapsáno) · `neplatí od <verze>`.
 | R6.3.1 | R6-awaiting-action.md | výzkum 1.14.0 | platí | Svolení archivu | An archive's permission | Erlaubnis eines Archivs | Zgoda archiwum |
 | R6.3.2 | R6-awaiting-action.md | výzkum 1.14.0 | platí | Vyprávění ke schválení | A story to approve | Erzählung zur Freigabe | Opowieść do zatwierdzenia |
 | R6.3.3 | R6-awaiting-action.md | výzkum 1.26.0 | platí | Větve mimo linie | Branches off the lines | Zweige außerhalb der Linien | Gałęzie poza liniami |
+| R6.3.4 | R6-awaiting-action.md | výzkum 1.28.0 | platí | Hypotézy k rozhodnutí | Hypotheses to decide | Hypothesen zu entscheiden | Hipotezy do rozstrzygnięcia |
 | R6.4 | R6-awaiting-action.md | výzkum 1.14.0 | platí | Skupiny a pořadí | Groups and order | Gruppen und Reihenfolge | Grupy i kolejność |
 | R6.5 | R6-awaiting-action.md | výzkum 1.14.0 | platí | Co jde vyřídit kde | What can be dealt with where | Was sich wo erledigen lässt | Co można załatwić gdzie |
 | R6.6 | R6-awaiting-action.md | výzkum 1.14.0 | platí | Co smí jen člověk | What only a person may do | Was nur der Mensch darf | Co może tylko człowiek |
@@ -147,6 +149,7 @@ nenapsáno) · `neplatí od <verze>`.
 | R9.10.3 | R9-archives.md | výzkum 1.27.0 | koncept | eBadatelna SOA Praha | eBadatelna SOA Praha | eBadatelna SOA Praha | eBadatelna SOA Praha |
 | R9.10.4 | R9-archives.md | výzkum 1.14.0 | koncept | Matricula | Matricula | Matricula | Matricula |
 | R9.10.5 | R9-archives.md | výzkum 1.27.0 | koncept | Szukaj w Archiwach | Szukaj w Archiwach | Szukaj w Archiwach | Szukaj w Archiwach |
+| R9.10.6 | R9-archives.md | výzkum 1.28.0 | koncept | DigiArchiv SOA Třeboň | DigiArchiv SOA Třeboň | DigiArchiv SOA Třeboň | DigiArchiv SOA Třeboň |
 | R10 | R10-people-and-hypotheses.md | výzkum 1.0.0 | platí | Osoby: ztotožnění, jména a hypotézy | People: identification, names and hypotheses | Personen: Identifizierung, Namen und Hypothesen | Osoby: identyfikacja, imiona i hipotezy |
 | R10.1 | R10-people-and-hypotheses.md | výzkum 1.0.0 | platí | Jmenovec není hledaná osoba | A namesake is not the person sought | Ein Namensvetter ist nicht die gesuchte Person | Imiennik to nie poszukiwana osoba |
 | R10.2 | R10-people-and-hypotheses.md | výzkum 1.0.0 | platí | Dva záznamy jedné osoby: sloučení | Two records of one person: merging | Zwei Einträge einer Person: Zusammenführen | Dwa wpisy jednej osoby: scalenie |
@@ -168,6 +171,7 @@ nenapsáno) · `neplatí od <verze>`.
 | A1.4 | A1-the-app-in-brief.md | aplikace 1.0.0 | platí | Načtení a výstupy | Loading and outputs | Einlesen und Ausgaben | Wczytanie i wyniki |
 | A1.5 | A1-the-app-in-brief.md | aplikace 1.0.0 | platí | Prameny, doložení a kontrola | Sources, evidence and checks | Quellen, Belege und Prüfung | Źródła, udokumentowanie i kontrola |
 | A1.6 | A1-the-app-in-brief.md | aplikace 1.0.0 | platí | Aplikace a výzkum | The app and the research | App und Forschung | Aplikacja i badanie |
+| A1.7 | A1-the-app-in-brief.md | aplikace 3.24.0 | platí | Jak Strom funguje v aplikaci | How Strom works in the app | So funktioniert Strom in der App | Jak działa Strom w aplikacji |
 | A2 | A2-loading-a-family-tree.md | aplikace 1.9.0 | platí | Načtení rodokmenu (GEDCOM) | Loading a family tree (GEDCOM) | Einlesen eines Stammbaums (GEDCOM) | Wczytanie drzewa genealogicznego (GEDCOM) |
 | A2.1 | A2-loading-a-family-tree.md | aplikace 1.9.0 | platí | Co se načte a co ne | What is loaded and what is not | Was eingelesen wird und was nicht | Co się wczytuje, a co nie |
 | A2.1.1 | A2-loading-a-family-tree.md | aplikace 1.9.0 | platí | Souhrn importu | Import summary | Zusammenfassung des Imports | Podsumowanie importu |

package/assets/strom-doc/PIN

@@ -1 +1 @@
-885249f43ea2f346c667b3f0ead9f8bba950f23f
+b2a5943d296d11635146b545905040055605ff9b

package/assets/strom-doc/REJSTRIK.md

@@ -665,12 +665,12 @@ Pojmy aplikace a jejího spojení s výzkumem, v abecedním pořadí.
 
 | Jazyk | Termín | Definice |
 |---|---|---|
-| cs | Hypotézy | Otázka, kterou výzkum vede o osobě nebo vazbě, s verzemi odpovědi; je otevřená, rozhodnutá pro jednu verzi, nebo zrušená. |
-| en | Hypotheses | A question the research keeps about a person or a link, with versions of the answer; it is open, decided for one version, or dropped. |
-| de | Hypothesen | Eine Frage, die die Forschung zu einer Person oder Verbindung führt, mit Versionen der Antwort; sie ist offen, für eine Version entschieden oder verworfen. |
-| pl | Hipotezy | Pytanie, które badanie prowadzi o osobie lub powiązaniu, z wersjami odpowiedzi; jest otwarte, rozstrzygnięte na rzecz jednej wersji albo anulowane. |
+| cs | Hypotézy · Hypotézy k rozhodnutí (terminal) | Otázka, kterou výzkum vede o osobě nebo vazbě, s verzemi odpovědi; je otevřená, rozhodnutá pro jednu verzi, nebo zrušená. Rozhoduje ji jen člověk, agent rozhodnutí navrhne. |
+| en | Hypotheses · Hypotheses to decide (terminal) | A question the research keeps about a person or a link, with versions of the answer; it is open, decided for one version, or dropped. Only a person decides it; the agent proposes the decision. |
+| de | Hypothesen · Hypothesen zu entscheiden (terminal) | Eine Frage, die die Forschung zu einer Person oder Verbindung führt, mit Versionen der Antwort; sie ist offen, für eine Version entschieden oder verworfen. Entscheiden darf sie nur der Mensch; der Agent schlägt die Entscheidung vor. |
+| pl | Hipotezy · Hipotezy do rozstrzygnięcia (terminal) | Pytanie, które badanie prowadzi o osobie lub powiązaniu, z wersjami odpowiedzi; jest otwarte, rozstrzygnięte na rzecz jednej wersji albo anulowane. Rozstrzyga je tylko człowiek; agent proponuje rozstrzygnięcie. |
 
-- **Čísla:** [R10.3](cs/R10-people-and-hypotheses.md#R10.3), R10.3.1, S3.5, S3.5.1
+- **Čísla:** [R10.3](cs/R10-people-and-hypotheses.md#R10.3), R10.3.1, R6.3.4, S3.5, S3.5.1
 
 <a id="pedigree-collapse"></a>
 ### Implex
@@ -684,6 +684,18 @@ Pojmy aplikace a jejího spojení s výzkumem, v abecedním pořadí.
 
 - **Čísla:** [A6.4](cs/A6-views.md#A6.4)
 
+<a id="how-strom-works"></a>
+### Jak Strom funguje
+
+| Jazyk | Termín | Definice |
+|---|---|---|
+| cs | Jak Strom funguje (app) · `strom doc` (terminal) | Tato dokumentace, přibalená v aplikaci i ve výzkumu: pravidla podle čísla, rejstřík pojmů a hledání, i bez internetu. |
+| en | How Strom works (app) · `strom doc` (terminal) | This documentation, carried in the app and in the research: rules by number, the glossary and a search, offline too. |
+| de | So funktioniert Strom (app) · `strom doc` (terminal) | Diese Dokumentation, mitgeliefert in der App und in der Forschung: Regeln nach Nummer, Begriffsverzeichnis und Suche, auch ohne Internet. |
+| pl | Jak działa Strom (app) · `strom doc` (terminal) | Ta dokumentacja, dołączona do aplikacji i do badania: zasady według numeru, słowniczek pojęć i wyszukiwanie, także bez internetu. |
+
+- **Čísla:** [A1.7](cs/A1-the-app-in-brief.md#A1.7), R1.8
+
 <a id="where-evidence-is-missing"></a>
 ### Kde chybí doklady
 

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

@@ -2,7 +2,7 @@
 # A1 Aplikace v kostce
 
 Jak aplikace Strom pracuje jako celek, na jedné stránce. Každý oddíl vede na kapitolu s přesnými pravidly. Popisuje
-aplikaci Strom 3.21.2 a výzkum 1.25.2.
+aplikaci Strom 3.21.2 a výzkum 1.25.2; změny z novější verze mají u sebe její číslo.
 
 <a id="A1.1"></a>
 ## A1.1 Rodokmen v prohlížeči, data na zařízení
@@ -61,3 +61,25 @@ a to, co výzkum o osobách ví, a úpravy posílá zpět do výzkumu ([R1.6](R1
 - Propojení: [S1](S1-connecting-app-and-research.md). Úpravy z aplikace: [S2](S2-edits-from-the-app.md).
   Co ví výzkum: [S3](S3-what-the-research-knows.md). Výzkum řízený z aplikace:
   [S4](S4-research-from-the-app.md). Telefon: [S5](S5-phone.md).
+
+<a id="A1.7"></a>
+## A1.7 Jak Strom funguje v aplikaci
+
+Tato dokumentace je přibalená v aplikaci a čte se i bez internetu. Okno **Jak Strom funguje** má obsah částí A, R
+a S, **Rejstřík pojmů** a hledání podle slova nebo čísla pravidla.
+
+- **Hranice:**
+  - otevření okna nic neposílá a nic nenačítá ze sítě;
+  - číslo pravidla a Enter skočí přímo na pravidlo (`R4.3`); neznámé číslo ukáže obsah;
+  - odkazy mezi pravidly mají **Zpět**; **Na webu** otevře stejné pravidlo na stromapp.info;
+  - pravidlo novější než připojený výzkum to řekne („Výzkum připojený k tomuto stromu má verzi …, tohle platí od …“).
+- **Ovládání:** aplikace: **Akce → Jak Strom funguje**, na telefonu **Další → Jak Strom funguje**, nebo **O aplikaci
+  → Jak Strom funguje**. Kroužek **?** v záhlaví otevře nápovědu přímo u pravidla: v Přehledu výzkumu a malém panelu
+  u oddílů **Fronta** ([R2.4](R2-lines-and-queue.md#R2.4)), **Čeká na vyřízení** ([R6.4](R6-awaiting-action.md#R6.4))
+  a **Teď** ([R7](R7-when-the-agent-works.md), při pozastavení [R7.6](R7-when-the-agent-works.md#R7.6)), v okně **Místa** ([R4.5](R4-places.md#R4.5)), ve správci míst
+  ([R4.4](R4-places.md#R4.4)), v panelu rozporů ([R5.3](R5-conflicts.md#R5.3)) a v **Co ví výzkum → Rozpory**
+  ([R5.6](R5-conflicts.md#R5.6)). V okně je i **Prohlídka aplikace**. Ve výzkumu: `strom doc`
+  ([R1.8](R1-research-in-brief.md#R1.8)).
+- **Platí od:** aplikace 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/cs/A3-evidence-in-the-app.md

@@ -47,8 +47,11 @@ ukáže jedno ze tří:
 - **Ovládání:** editor pramene, **Více: přepis, datum zápisu, spolehlivost**; v **Akce → Prameny** filtr
   **Přepis neověřen** (jen u stromu **Doloženo** se staršími neověřenými prameny).
 - **Platí od:** aplikace 3.9.0
+- **Od aplikace 3.24.0:** překlad přepisu, který poslal výzkum ([R3.4](R3-verification-and-citation.md#R3.4)), je
+  pod přepisem jako sbalený oddíl **Překlad přepisu**: v prohlížeči pramene i na kartě pramene na stránce osoby.
+  Poznámka pramene se tím nemění; editor poznámky ji ukazuje celou. Pramen bez překladu vypadá jako dřív.
 
-<!-- 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 Citace: co pramen dokládá

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

@@ -1,7 +1,7 @@
 <a id="A6"></a>
 # A6 Pohledy a výběr osob
 
-Jak aplikace Strom vybírá, které osoby ukáže, a jak je ukazují jednotlivé pohledy. Popisuje aplikaci 3.21.2.
+Jak aplikace Strom vybírá, které osoby ukáže, a jak je ukazují jednotlivé pohledy. Popisuje aplikaci 3.21.2; změny z novější verze mají u sebe její číslo.
 
 Pohled je jiné čtení **téhož výběru osob**. Výběr určuje ústřední osoba (ta, na kterou se klikne) a hloubka
 **Předci** a **Potomci**. Rodina, Potomci, Časová osa a Mapa ukazují stejné okolí ústřední osoby. Vějíř si
@@ -136,12 +136,22 @@ název místa, jak je zapsaný ve stromu, a jen se souhlasem. Ve stromu z výzku
   - před prvním dohledáním se aplikace zeptá (**Dohledat souřadnice online?**). Odejdou jen názvy míst, žádná jména,
     data ani vztahy. Nejvýš jeden dotaz zhruba za sekundu;
   - souřadnice se uloží do stromu: každé místo se dohledá jednou a mapa pak funguje i bez připojení;
-  - automatické dohledání vezme **první výsledek** služby pro zapsaný název. Stejnojmenné obce při tom nerozliší:
-    místo tak může padnout do obce stejného jména jinde. Takovou polohu pak označí **Ověřit**
-    ([R4.4.1](R4-places.md#R4.4.1));
+  - automatické dohledání vezme **první výsledek** služby pro zapsaný název. Do aplikace 3.23.0 při tom stejnojmenné
+    obce nerozlišilo: místo tak mohlo padnout do obce stejného jména jinde. Polohu, která do stromu nesedí, označí
+    **Ověřit** ([R4.4.1](R4-places.md#R4.4.1));
   - jen místo s číslem domu, které služba nenašla, se dohledá podle obce. Z obcí toho jména se vybere ta nejblíž
     ostatním místům stromu („Obec toho jména je víckrát; vybrána ta nejblíž ostatním místům stromu.“); u místa stojí
     **Poloha podle obce**;
+  - **od aplikace 3.24.0** se nejbližší obec vybírá u každého místa: když se dvě a víc obcí jmenují přesně jako
+    zapsané místo (bez ohledu na velikost písmen a diakritiku), vezme se ta nejbližší středu stromu, ne první
+    výsledek. Střed je medián poloh zadaných ručně nebo potvrzených **Ponechat**, když jsou aspoň 3; jinak medián
+    všech poloh stromu a míst, která dohledání našlo bez pochyb. Místo s dalším určením („Lhota u Kolína“,
+    „Lhota 16“), jediná obec nebo strom bez poloh dostane první výsledek jako dřív. Pořád jde o jeden dotaz na místo;
+  - kontrola místa řekne, kolik obcí toho jména mapa našla („Mapa našla 3 obce toho jména a vzala tu nejbližší
+    ostatním místům stromu.“); od aplikace 3.24.0, dřív vždy „dvě“;
+  - poloha, která už ve stromu je, se nepřesune: dohledání hledá jen místa bez polohy. Ani sloučení s jiným stromem
+    nebo souborem GEDCOM nepřepíše polohu zadanou ručně nebo potvrzenou **Ponechat**, jen doplní chybějící. Špatnou
+    starší polohu jde přesunout jen ručně;
   - co se nenajde, zůstane bez polohy. Aplikace nic nehádá: „pomůže opravit zápis nebo doplnit zemi“.
 - **Ovládání:** aplikace: **Nastavení → Dohledávat místa online**; v okně míst **Špatné místo? Opravit**, **Najít toto
   místo pod jiným názvem** (připojí se jen poloha, zápis ve stromu se nemění), **Použít i pro další čísla domů v …**,
@@ -149,9 +159,9 @@ název místa, jak je zapsaný ve stromu, a jen se souhlasem. Ve stromu z výzku
 - **Proč:** dohledání míst je jediná část aplikace, která něco posílá ven; proto jen se souhlasem, jen názvy a každé
   místo jednou (komentář v kódu). Limit jednoho dotazu za sekundu je podmínka služby.
 - **Platí od:** aplikace 1.10.0; **Špatné místo? Opravit** 1.10.1; **Vyčistit osiřelá místa** 2.1.0; poloha podle obce
-  3.21.0
+  3.21.0; nejbližší stejnojmenná obec u každého místa a počet obcí v kontrole 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 Rod v pohledu

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

@@ -2,7 +2,7 @@
 # R1 Výzkum v kostce
 
 Jak výzkum pracuje jako celek, na jedné stránce. Každý oddíl vede na kapitolu s přesnými pravidly. Popisuje
-výzkum 1.25.2 a aplikaci Strom 3.21.2.
+výzkum 1.25.2 a aplikaci Strom 3.21.2; změny z novější verze mají u sebe její číslo.
 
 <a id="R1.1"></a>
 ## R1.1 Výzkum je záznam, ne rozhovor
@@ -51,8 +51,9 @@ podmínka, kterou nastavil člověk (například tempo týdenního limitu předp
 Agent pracuje podle **Genealogical Proof Standard** (GPS): důkladné hledání, citace každého údaje, rozbor
 a srovnání důkazů, řešení rozporů a sepsaný závěr, kterému další badatel porozumí.
 
-- Každý údaj má stupeň jistoty: **Vodítko**, **Možné**, **Pravděpodobné**, **Doložené**. Rodokmen a rodinná paměť
-  jsou vždy jen vodítko, rejstřík slouží k nalezení zápisu. Podrobně: [R3](R3-verification-and-citation.md).
+- Každý údaj má stupeň jistoty: **Vodítko**, **Možné**, **Pravděpodobné**, **Doložené**. Rodokmen, rodinná paměť
+  a rejstřík jsou vždy jen vodítko: rejstřík vede k zápisu, doloží až zápis sám (rejstřík hlídá kód od výzkumu
+  1.28.0). Podrobně: [R3](R3-verification-and-citation.md).
 - Jmenovec není hledaná osoba. Osobu určuje rok, místo, dům, povolání, manžel nebo manželka a rodiče. Dva záznamy se
   stejným jménem a jinými rodiči jsou dvě osoby. Ztotožnění osob, jejich jména a soupeřící hypotézy:
   [R10](R10-people-and-hypotheses.md).
@@ -60,20 +61,22 @@ a srovnání důkazů, řešení rozporů a sepsaný závěr, kterému další b
 - Když se záznamy liší, agent nevybírá potichu: zapíše **rozpor**. Podrobně: [R5](R5-conflicts.md).
 - Místo dostane polohu na mapě, jen když je jisté, které místo to je. Podrobně: [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 Co rozhoduje člověk
 
 Některá rozhodnutí patří jen člověku. Výzkum se na ně ptá v **Čeká na vyřízení** a agent za člověka neodpoví.
 
-- Co čeká na člověka (dopisy, snímky k stažení, otázky k místům, rozpory, vyprávění ke schválení) a kde se to vyřizuje:
-  [R6](R6-awaiting-action.md).
+- Co čeká na člověka (dopisy, snímky k stažení, otázky k místům, rozpory, hypotézy, vyprávění ke schválení) a kde se
+  to vyřizuje: [R6](R6-awaiting-action.md).
+- Hypotézu rozhoduje jen člověk; agent rozhodnutí navrhne (od výzkumu 1.28.0):
+  [R10.3.1](R10-people-and-hypotheses.md#R10.3.1).
 - Rozhodnutí člověka platí. Agent ho změní jen na základě nového pramene: [R5.4](R5-conflicts.md#R5.4).
 - Poloha místa zadaná člověkem se nemění: [R4.3](R4-places.md#R4.3).
 - Nastavení, která mění, co smí agent, potvrzuje člověk (například podmínka samostatné práce, [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 Výzkum a aplikace Strom
@@ -96,3 +99,27 @@ a přepisem. Čtení modelem AI není stoprocentní; důležité údaje má ide
 - **Platí od:** výzkum 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 Jak Strom funguje: `strom doc`
+
+Tato dokumentace je přibalená ve výzkumu a čte se i bez internetu. `strom doc` vypíše obsah, `strom doc R10.1`
+jedno pravidlo i s pravidly pod ním a `strom doc <slova>` hledá v nadpisech, rejstříku pojmů a textu.
+
+- **Hranice:**
+  - číslo jde napsat i malými písmeny nebo s pomlčkou (`r4.3`, `R4-3`). Neznámé číslo skončí chybou, která řekne
+    nejbližší čísla;
+  - hledání nedbá na diakritiku ani velikost písmen. Ukáže nejvýš 10 pravidel, nejlepší první, a kolik jich je
+    dalších (`--limit` jiný počet);
+  - text je v jazyce výzkumu (`--lang` jiný). Jazyk, do kterého dokumentace přeložená není, dostane angličtinu
+    s poznámkou;
+  - u pravidla je odkaz na stejné pravidlo na stromapp.info;
+  - funguje i mimo výzkum a v Archivu Stromu a nic nezapisuje.
+- **Jen metodika:** na otázku člověka, jak nebo proč Strom něco dělá, agent odpoví podle `strom doc`: s číslem
+  pravidla a s odkazem, který `strom doc` vypíše.
+- **Ovládání:** terminál: `strom doc`, `strom doc R2.3`, `strom doc hypotéza --lang en`, `--json`. Nápověda pro
+  člověka (`strom help --human`) končí odkazem na `strom doc`. Aplikace má stejnou dokumentaci v **Jak Strom
+  funguje** ([A1.7](A1-the-app-in-brief.md#A1.7)).
+- **Platí od:** výzkum 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/cs/R10-people-and-hypotheses.md

@@ -3,7 +3,7 @@
 
 Jak výzkum pozná, že zápis patří hledané osobě, co udělá se dvěma záznamy jedné osoby, jak vede soupeřící
 vysvětlení (hypotézy) a jak zapisuje jména a lidi, které zápis jmenuje. Popisuje výzkum 1.27.0 a aplikaci Strom
-3.23.0. U pravidel je rozlišeno, co **hlídá kód** a co je jen **pravidlo metodiky**.
+3.23.0; změny z novější verze mají u sebe její číslo. U pravidel je rozlišeno, co **hlídá kód** a co je jen **pravidlo metodiky**.
 
 <a id="R10.1"></a>
 ## R10.1 Jmenovec není hledaná osoba
@@ -43,6 +43,8 @@ s poznámkou, do koho byl sloučen.
     (`strom family merge`).
 - **Jen metodika:** osoba z převzatého rodokmenu, která už je ve výzkumu zkoumaná, se slučuje **do** zkoumané
   osoby; ta si drží své doklady ([R11.3](R11-material-from-the-user.md#R11.3)).
+- **Proč:** strom mezi dvěma údaji nevybírá potichu: který platí, rozhodne doklad. Druhý se odvolá s důvodem, takže
+  zůstane vidět, co kde stálo.
 - **Ovládání:** terminál: `strom person merge`, `strom family merge`. Možné duplicity ve stromu hlásí aplikace v
   Kontrole stromu ([A5.6](A5-tree-check.md#A5.6)).
 - **Platí od:** výzkum 1.0.0
@@ -74,21 +76,38 @@ nevybírá potichu. Zapíše hypotézu: otázku a její verze A, B, C… s tím,
 <a id="R10.3.1"></a>
 ### R10.3.1 Rozhodnutí hypotézy
 
-Hypotéza se rozhodne pro jednu verzi, nebo se zruší, když žádnou rozhodnout nejde. Rozhoduje se ve výzkumu; aplikace
-hypotézu rozhodnout nedá.
+Hypotéza se rozhodne pro jednu verzi, nebo se zruší, když žádnou rozhodnout nejde. Rozhoduje jen člověk, ve výzkumu;
+agent rozhodnutí navrhne. Aplikace hypotézu rozhodnout nedá.
 
 - **Hlídá kód:**
-  - rozhodnutí potřebuje text rozhodnutí (`--decision`); zrušení je `--abandon`;
-  - rozhodnout znovu jde jen s důvodem (`--reason`). Předchozí rozhodnutí zůstane v poznámce hypotézy;
-  - po rozhodnutí strom vypíše prameny, které hypotéza jmenuje a které žádný údaj jejích osob necituje: co
-    říkají, se má zapsat k osobám.
-- **Jen metodika:** hypotéza, jejíž verze nesou spojení, se rozhoduje s volbou verze (`--variant B`). Rozhodnutou
-  hypotézu, kterou nový záznam vyvrátí, agent rozhodne znovu s důvodem. Co agent zadržel, dokud byla osoba jen
-  hypotéza, zapíše k osobě po rozhodnutí.
-- **Ovládání:** terminál: `strom hypothesis decide H… --variant B --decision "…"` (znovu s `--reason "…"`).
+  - rozhodnutí je krok člověka. Když `strom hypothesis decide` spustí agent (i uvnitř `strom batch`), strom ho
+    odmítne;
+  - agent rozhodnutí navrhne: verzi a text rozhodnutí (`strom hypothesis propose`), nebo zrušení (`--abandon`). Nový
+    návrh nahradí předchozí. Na odpověď se nečeká, práce jde dál;
+  - návrh čeká v **Co čeká** ve skupině **Hypotézy k rozhodnutí** ([R6.3.4](R6-awaiting-action.md#R6.3.4)): člověk
+    rozhodne podle návrhu, jinak (jiná verze nebo žádná, s důvodem), nebo hypotézu nechá, jak je. Nepřijatý návrh
+    zůstane v poznámce hypotézy;
+  - rozhodnutí i návrh potřebují text rozhodnutí (`--decision`); zrušení je `--abandon`;
+  - hypotéza, jejíž verze říkají, co by spojily, se rozhoduje i navrhuje jen s uvedenou verzí (`--variant B`). Bez
+    ní strom odmítne a nic nezapíše;
+  - rozhodnout znovu (i navrhnout znovu) jde jen s důvodem (`--reason`). Předchozí rozhodnutí zůstane v poznámce
+    hypotézy;
+  - co rozhodnutí člověka spojuje, a prameny, které hypotéza jmenuje a které žádný údaj jejích osob necituje,
+    dostane agent na začátku příští práce jako první úkol k zapsání do stromu.
+- **Jen metodika:** agent navrhne rozhodnutí, když záznamy ukazují na jednu verzi, a řekne to člověku jednou větou.
+  Rozhodnutou hypotézu, kterou nový záznam vyvrátí, agent navrhne znovu s důvodem. Co agent zadržel, dokud byla
+  osoba jen hypotéza, zapíše k osobě, až člověk hypotézu rozhodne.
+- **Proč:** nové rozhodnutí potřebuje důvod, protože se rozhodnutí mění otevřeně: předchozí zůstane čitelné a nové
+  řekne, co ho změnilo (obvykle nový záznam).
+- **Ovládání:** terminál: menu `strom` → **Co čeká** → **Hypotézy k rozhodnutí** → **Rozhodnout podle návrhu**,
+  **Rozhodnout jinak**, **Nechat, jak je (návrh nepřijat)**; příkazem `strom hypothesis decide H… --proposed`,
+  `--keep-open`, nebo `--variant B --decision "…"` (znovu s `--reason "…"`). Agent: `strom hypothesis propose H…
+  --variant B --decision "…"`.
 - **Platí od:** výzkum 1.0.0; výpis nezapsaných pramenů 1.12.0
+- **Od výzkumu 1.28.0:** rozhoduje jen člověk, agent navrhuje; uvedenou verzi hlídá kód (dřív jen metodika).
+  Hypotézy, které dřív rozhodl agent, zůstávají, jak byly.
 
-<!-- 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 Rodina mimo strom čeká na doloženou vazbu
@@ -130,6 +149,8 @@ stojí v záznamu; sjednocují se jen data.
   - osoba, kterou slabší záznam jmenoval jinak, si to jméno nechá jako variantu; správné jméno se označí jako
     hlavní. Nic se nemaže;
   - jméno přečtené jen zčásti: [R8.6](R8-reading-scans.md#R8.6).
+- **Proč:** popis místo jména („mrtvě narozený syn“) by aplikace i GEDCOM ukazovaly a hledaly jako křestní jméno
+  a párování jmen by ho za jméno bralo. To, že dítě zemřelo bez jména, je údaj (úmrtí, poznámka).
 - **Ovládání:** terminál: `strom name add P… "Marie /Vlková/" --kind birth --cite S…`, `strom name primary P…
   "…"` (`--clear` vrátí rodné jméno). Tvary příjmení v aplikaci: [A4.5](A4-surnames-and-families.md#A4.5),
   [A4.6](A4-surnames-and-families.md#A4.6).