strom-research 1.28.0-beta.2 → 1.28.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/CHANGELOG.cs.md +11 -2
  2. package/CHANGELOG.de.md +12 -2
  3. package/CHANGELOG.md +12 -2
  4. package/CHANGELOG.pl.md +12 -2
  5. package/assets/lang/cs.json +6 -4
  6. package/assets/lang/de.json +6 -4
  7. package/assets/lang/pl.json +6 -4
  8. package/assets/strom-doc/CISLA.md +4 -0
  9. package/assets/strom-doc/PIN +1 -1
  10. package/assets/strom-doc/REJSTRIK.md +17 -5
  11. package/assets/strom-doc/cs/A1-the-app-in-brief.md +23 -1
  12. package/assets/strom-doc/cs/A3-evidence-in-the-app.md +4 -1
  13. package/assets/strom-doc/cs/A6-views.md +16 -6
  14. package/assets/strom-doc/cs/R1-research-in-brief.md +34 -7
  15. package/assets/strom-doc/cs/R10-people-and-hypotheses.md +33 -12
  16. package/assets/strom-doc/cs/R11-material-from-the-user.md +17 -6
  17. package/assets/strom-doc/cs/R3-verification-and-citation.md +32 -13
  18. package/assets/strom-doc/cs/R6-awaiting-action.md +21 -5
  19. package/assets/strom-doc/cs/R7-when-the-agent-works.md +2 -0
  20. package/assets/strom-doc/cs/R8-reading-scans.md +3 -1
  21. package/assets/strom-doc/cs/R9-archives.md +19 -1
  22. package/assets/strom-doc/cs/S3-what-the-research-knows.md +2 -1
  23. package/assets/strom-doc/de/A1-the-app-in-brief.md +28 -1
  24. package/assets/strom-doc/de/A3-evidence-in-the-app.md +6 -1
  25. package/assets/strom-doc/de/A6-views.md +21 -6
  26. package/assets/strom-doc/de/R1-research-in-brief.md +36 -7
  27. package/assets/strom-doc/de/R10-people-and-hypotheses.md +40 -15
  28. package/assets/strom-doc/de/R11-material-from-the-user.md +20 -6
  29. package/assets/strom-doc/de/R3-verification-and-citation.md +34 -14
  30. package/assets/strom-doc/de/R6-awaiting-action.md +23 -5
  31. package/assets/strom-doc/de/R7-when-the-agent-works.md +3 -0
  32. package/assets/strom-doc/de/R8-reading-scans.md +3 -1
  33. package/assets/strom-doc/de/R9-archives.md +22 -1
  34. package/assets/strom-doc/de/S3-what-the-research-knows.md +2 -1
  35. package/assets/strom-doc/en/A1-the-app-in-brief.md +25 -1
  36. package/assets/strom-doc/en/A3-evidence-in-the-app.md +5 -1
  37. package/assets/strom-doc/en/A6-views.md +17 -6
  38. package/assets/strom-doc/en/R1-research-in-brief.md +35 -7
  39. package/assets/strom-doc/en/R10-people-and-hypotheses.md +34 -13
  40. package/assets/strom-doc/en/R11-material-from-the-user.md +18 -6
  41. package/assets/strom-doc/en/R3-verification-and-citation.md +31 -12
  42. package/assets/strom-doc/en/R6-awaiting-action.md +21 -4
  43. package/assets/strom-doc/en/R7-when-the-agent-works.md +2 -0
  44. package/assets/strom-doc/en/R8-reading-scans.md +3 -1
  45. package/assets/strom-doc/en/R9-archives.md +21 -1
  46. package/assets/strom-doc/en/S3-what-the-research-knows.md +2 -1
  47. package/assets/strom-doc/pl/A1-the-app-in-brief.md +24 -1
  48. package/assets/strom-doc/pl/A3-evidence-in-the-app.md +5 -1
  49. package/assets/strom-doc/pl/A6-views.md +18 -6
  50. package/assets/strom-doc/pl/R1-research-in-brief.md +34 -7
  51. package/assets/strom-doc/pl/R10-people-and-hypotheses.md +33 -12
  52. package/assets/strom-doc/pl/R11-material-from-the-user.md +18 -6
  53. package/assets/strom-doc/pl/R3-verification-and-citation.md +32 -14
  54. package/assets/strom-doc/pl/R6-awaiting-action.md +22 -5
  55. package/assets/strom-doc/pl/R7-when-the-agent-works.md +2 -0
  56. package/assets/strom-doc/pl/R8-reading-scans.md +3 -1
  57. package/assets/strom-doc/pl/R9-archives.md +22 -1
  58. package/assets/strom-doc/pl/S3-what-the-research-knows.md +2 -1
  59. package/dist/cli/menu.js +5 -4
  60. package/dist/cli/ui.js +6 -4
  61. package/dist/commands/session.js +15 -8
  62. package/dist/core/live.js +32 -8
  63. package/dist/core/tree.js +1 -1
  64. package/dist/runners/claude.js +14 -4
  65. package/package.json +2 -5
@@ -23,12 +23,19 @@ erfasst daraus nur, was wirklich darin steht.
23
23
  - **Nur Methodik:** Namen und Orte werden so erfasst, wie sie geschrieben sind; vereinheitlicht werden nur Daten. Die
24
24
  Aufgabe wird mit dem geschlossen, was aus der Unterlage hervorging, und mit weiteren Aufgaben: wo nach Einträgen zu
25
25
  suchen ist, die die Hinweise belegen.
26
+ - **Warum:**
27
+ - 20 Bilder: Scans einer Matrik gehören nicht als Hunderte Aufgaben Unterlagen in die Historie des Stammbaums.
28
+ Familienunterlagen eines Ordners sind meist einige bis einige Dutzend Dateien; mehr als 20 Bilder sind meist
29
+ Scans eines Buches und werden als Buch erfasst;
30
+ - 20 MB: die Historie des Stammbaums wird nie umgeschrieben und geht mit dem Stammbaum in Sicherungen und
31
+ Übertragungen mit. Große Dateien (Video, unkomprimierte Scans) würden sie dauerhaft vergrößern, deshalb liegen
32
+ sie im gemeinsamen Medienspeicher.
26
33
  - **Bedienung:** Terminal: `strom intake <soubory nebo složky>`, `strom intake --text "…"` (was der Benutzer sagt),
27
34
  `strom input list`, `strom input show I…`. App: **Material senden…**, **Materialien hinzufügen…**
28
35
  ([A3.5](A3-evidence-in-the-app.md#A3.5)).
29
36
  - **Gilt seit:** Forschung 1.0.0
30
37
 
31
- <!-- 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 -->
38
+ <!-- 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 -->
32
39
 
33
40
  <a id="R11.2"></a>
34
41
  ## R11.2 Eine Urkunde ist eine Quelle, der Rest ist ein Hinweis
@@ -85,7 +92,8 @@ Einen Ordner, eine ZIP-Datei oder eine Schachtel Dokumente, aus der App gesendet
85
92
  Stapel an. Der Agent sortiert ihn dann nach Aufgaben.
86
93
 
87
94
  - **Prüft der Code:**
88
- - ein Stapel wird geschlossen, wenn die App meldet, dass er vollständig ist, oder einen Tag nach der letzten Datei;
95
+ - ein Stapel wird geschlossen, wenn die App meldet, dass er vollständig ist, oder einen Tag nach der letzten Datei
96
+ (ein Stapel vom Telefon eine Stunde nach dem letzten Foto, [S5.4](S5-phone.md#S5.4));
89
97
  - dann werden daraus Aufgaben Unterlagen zu je etwa 25 Dateien, nach den Ordnern, in denen die Dateien kamen. Im
90
98
  Strom-Archiv warten die Aufgaben zurückgestellt;
91
99
  - die Dateien eines Stapels werden als Originale im gemeinsamen Medienspeicher gespeichert, nicht in der Historie
@@ -101,10 +109,16 @@ Stapel an. Der Agent sortiert ihn dann nach Aufgaben.
101
109
  erfasst, und die Einträge werden daraus gelesen wie aus jedem Buch ([R8](R8-reading-scans.md));
102
110
  - die Aufgabe wird geschlossen, wenn jede ihrer Dateien eingeordnet ist; ein weiterer Teil des Stapels ist eine
103
111
  eigene Aufgabe.
104
- - **Warum:** der Pfad einer Datei im Stapel sagt viel (`Babička/Dopisy/1946.jpg`); was nicht zur Familie gehört, soll
105
- nicht in den Stammbaum gelangen (Methodik).
112
+ - **Warum:**
113
+ - einen Tag nach der letzten Datei: die App sendet die Dateien einzeln. Ein Stapel, von dem niemand gesagt hat, dass
114
+ er vollständig ist, wird mit dem geschlossen, was kam, damit nichts länger wartet; ein Tag ohne weitere Datei
115
+ heißt, dass das Senden vorbei ist. Die Seite auf dem Telefon wird leicht geschlossen, ohne den Stapel zu
116
+ übergeben, deshalb genügt dort eine Stunde;
117
+ - 25 Dateien: eine Aufgabe Unterlagen liest eine Sitzung des Agenten, und etwa 25 Dateien passen hinein;
118
+ - der Pfad einer Datei im Stapel sagt viel (`Babička/Dopisy/1946.jpg`); was nicht zur Familie gehört, soll nicht in
119
+ den Stammbaum gelangen (Methodik).
106
120
  - **Bedienung:** Terminal: `strom input batch` (Stapel und wie viel eingeordnet ist), `strom input sort I… --as
107
121
  source|document|photo|unrelated --person P…`. App: **Materialien hinzufügen…** im Menü der Forschung.
108
- - **Gilt seit:** Forschung 1.12.0
122
+ - **Gilt seit:** Forschung 1.12.0; Stapel vom Telefon 1.18.0
109
123
 
110
- <!-- 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" -->
124
+ <!-- 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" -->
@@ -38,7 +38,7 @@ Schlussfolgerung aus allen Quellen der Angabe ist, nicht, wie gut eine einzelne
38
38
  ### R3.1.1 Standardgrad und die Zitation, die ihn hebt
39
39
 
40
40
  - Eine ohne `--status` erfasste Angabe: ohne Zitation **Hinweis**; mit Zitation mindestens einer Quelle, die nicht
41
- schwach ist ([R3.3](#R3.3)), **Wahrscheinlich**; sonst Hinweis.
41
+ schwach ist ([R3.3](#R3.3)), **Wahrscheinlich**; sonst Hinweis. Ab Forschung 1.28.0 ist auch ein Register schwach.
42
42
  - `strom cite` ohne `--status` hebt Hinweis auf Wahrscheinlich, wenn die neue Quelle nicht schwach ist. Einen anderen
43
43
  Grad ändert es nicht.
44
44
  - Eine Änderung des Grades über `strom event edit --status` braucht `--reason`; eine Zitation mit Grad
@@ -56,19 +56,21 @@ eines Grades: `event add`, `cite`, `event edit` und auch bei Angaben, die aus de
56
56
  - **Grenzen (prüft der Code),** in dieser Reihenfolge:
57
57
  1. Wahrscheinlich und Belegt brauchen mindestens eine Zitation.
58
58
  2. Mindestens eine Zitation muss aus einer Quelle stammen, die nicht schwach ist. Schwach sind ein Stammbaum
59
- (`--kind family-tree`), eine Erinnerung (`--kind family-memory`) und ein verfasstes Werk (`--form authored`).
59
+ (`--kind family-tree`), eine Erinnerung (`--kind family-memory`), ein verfasstes Werk (`--form authored`) und ab
60
+ Forschung 1.28.0 ein Register (`--kind index`).
60
61
  3. Belegt braucht zusätzlich unter den Zitationen aus nicht schwachen Quellen mindestens eine mit
61
62
  Primärinformation (`--information primary`): ein Eintrag, zur Zeit des Ereignisses geschrieben von jemandem,
62
63
  der es wusste. Die Information bei der Zitation hat Vorrang vor der Information bei der Quelle.
63
64
  - **Nur Methodik:** der Code prüft nicht, dass die Quelle eine Originalquelle ist (`--form original`), dass der Agent
64
65
  sie selbst gelesen hat, dass der Eintrag die Angabe direkt nennt, und auch nicht die blinde zweite Lesung
65
- ([R3.5](#R3.5)). Belegt geht darum auch bei einer Kopie oder einem Register mit Primärinformation durch.
66
+ ([R3.5](#R3.5)). Belegt geht darum auch bei einer Kopie mit Primärinformation durch (bei einem Register bis
67
+ Forschung 1.27.0 ebenfalls).
66
68
  - **Bedienung:** Terminal: `strom event add P… BIRT --date "…" --cite S… --information primary --status proven`.
67
69
  Die Ablehnung nennt den Grund und was stattdessen geht (Hinweis lassen, `--status possible` oder
68
70
  `--status probable`).
69
71
  - **Gilt seit:** Forschung 1.0.0
70
72
 
71
- <!-- 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 -->
73
+ <!-- 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" -->
72
74
 
73
75
  <a id="R3.2.1"></a>
74
76
  ### R3.2.1 Quelle: Form und Information
@@ -95,18 +97,21 @@ eines Grades: `event add`, `cite`, `event edit` und auch bei Angaben, die aus de
95
97
  Stammbaum, Erinnerung, Register, Katalog und Online-Stammbaum sagen, wo zu suchen ist. Sie sind kein Nachweis einer
96
98
  Angabe. Eine Angabe aus ihnen bleibt Hinweis, bis ein Eintrag sie belegt.
97
99
 
98
- - **Prüft der Code:** Stammbaum, Erinnerung und verfasstes Werk sind schwache Quellen: eine Angabe nur aus ihnen ist
99
- nie Wahrscheinlich oder Belegt ([R3.2](#R3.2)). Ein übernommener Stammbaum:
100
- [R11.3](R11-material-from-the-user.md#R11.3).
101
- - **Nur Methodik:** das Register. Der Code hält es nicht für schwach: mit seiner Zitation bekommt eine Angabe ohne
102
- `--status` den Grad Wahrscheinlich, und mit `--information primary` geht auch Belegt durch. Die Methodik will das
103
- Register nur zum Finden der Seite; der Eintrag wird im Kirchenbuch gelesen. Auch ein fehlender Eintrag im Register
104
- ist nur ein Hinweis: eine ähnliche Form des Familiennamens ist ein Kandidat.
100
+ - **Prüft der Code:** Stammbaum, Erinnerung, verfasstes Werk und Register (`--kind index`) sind schwache Quellen: eine
101
+ Angabe nur aus ihnen ist nie Wahrscheinlich oder Belegt ([R3.2](#R3.2)). Eine Angabe, die nur ein Register zitiert,
102
+ bleibt Hinweis, bis der Eintrag selbst gelesen und zitiert ist; mit der Zitation des Eintrags ist es eine Angabe des
103
+ Eintrags. Ein übernommener Stammbaum: [R11.3](R11-material-from-the-user.md#R11.3).
104
+ - **Grenzen:** bei Änderungen aus der App zählt ein Register als Eintrag: die Änderung einer Angabe, die ein Register
105
+ belegt, wird zu einem Widerspruch ([R5.2](R5-conflicts.md#R5.2)), nichts wird stillschweigend überschrieben.
106
+ - **Nur Methodik:** das Register dient nur zum Finden der Seite; der Eintrag wird im Kirchenbuch gelesen. Auch ein
107
+ fehlender Eintrag im Register ist nur ein Hinweis: eine ähnliche Form des Familiennamens ist ein Kandidat.
105
108
  - Unterlagen vom Benutzer (Urkunde, Foto, Brief, was der Benutzer sagt):
106
109
  [R11.2](R11-material-from-the-user.md#R11.2).
107
110
  - **Gilt seit:** Forschung 1.0.0
111
+ - **Ab Forschung 1.28.0:** das Register prüft der Code als schwache Quelle (früher nur Methodik: mit seiner Zitation
112
+ bekam eine Angabe Wahrscheinlich, und mit `--information primary` ging auch Belegt durch).
108
113
 
109
- <!-- 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 -->
114
+ <!-- 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 -->
110
115
 
111
116
  <a id="R3.4"></a>
112
117
  ## R3.4 Zitation: Ausschnitt und Abschrift
@@ -119,19 +124,24 @@ Seite sind mehrere Quellen.
119
124
  `--locator` (Folio, Seite, Nummer des Eintrags) und bei der Angabe `--quote`. In ein Feld (`--date`, `--house`,
120
125
  `--age`, Name) kommt nur, was sicher gelesen ist; Unsicheres kommt mit `[?]` in die Abschrift und in die Notiz der
121
126
  Angabe.
127
+ - **Nur Methodik, ab Forschung 1.28.0:** ein Eintrag in einer anderen Sprache oder Schrift als der Sprache der
128
+ Forschung (Latein, Kurrent, Polnisch, Kyrillisch…) bekommt neben der wörtlichen Abschrift auch eine Übersetzung in
129
+ die Sprache der Forschung (`--translation`). Die Abschrift bleibt in der Sprache des Eintrags. Die App zeigt die
130
+ Übersetzung zugeklappt unter der Abschrift ([A3.1.1](A3-evidence-in-the-app.md#A3.1.1)).
122
131
  - **Prüft der Code:** höchstens 3 Ausschnitte je Quelle (der Eintrag und seine Fortsetzung über einen Seitenumbruch).
123
132
  Einen fehlenden Ausschnitt oder eine fehlende Abschrift lehnt der Code nicht ab, er erinnert nur bei einer Quelle
124
133
  auf einem Scan daran: nach `strom source add`, nach `strom source edit` mit Bild oder Ausschnitt und bei
125
134
  `strom task done` bei den Quellen, die die Aufgabe erfasst hat.
126
135
  - Ältere Quellen: den Ausschnitt ergänzt `strom clips`, die Abschrift `strom transcripts` (Leser, ein zweiter Blick
127
136
  prüft sie).
128
- - **Bedienung:** Terminal: `strom source add "…" --clip B…:57@x,y,w,h --transcript @notes/zapis.txt --locator "…"`.
137
+ - **Bedienung:** Terminal: `strom source add "…" --clip B…:57@x,y,w,h --transcript @notes/zapis.txt --translation
138
+ @notes/preklad.txt --locator "…"`; Ergänzung `strom source edit S… --translation "…"`.
129
139
  Die App zeigt den Ausschnitt des Eintrags neben der Abschrift.
130
140
  - **Gilt seit:** Forschung 1.1.0 (Ausschnitt, `strom clips`, `strom transcripts`); Abschrift 1.0.0
131
141
  - **Ab Forschung 1.26.0:** die Hilfe der Option `--clip` sagt „ein weiterer bei jedem Seitenumbruch, höchstens 3“ (in 1.25.2
132
142
  „ein zweiter“). Die Regel ändert sich nicht.
133
143
 
134
- <!-- 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 -->
144
+ <!-- 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 -->
135
145
 
136
146
  <a id="R3.5"></a>
137
147
  ## R3.5 Blinde zweite Lesung
@@ -303,6 +313,16 @@ Eine Erzählung wird aus den Angaben für die Familie geschrieben. Was nicht bel
303
313
  Sprache der Forschung;
304
314
  - Format des Textes: nur Absätze, Zwischenüberschriften, Aufzählungspunkte, Fettdruck und Kursivschrift. Anderes
305
315
  (Links, Tabellen, Zitate, nummerierte Listen) zeigt die App nach der Methodik als einfachen Text.
316
+ - **Warum:**
317
+ - nichts wird hinzugedacht: eine Erzählung ist für die Familie und stützt sich auf Belege. Was wahrscheinlich
318
+ klänge, aber nicht belegt ist, würde in der Familie bald als Tatsache gelten;
319
+ - Hintergrund: er ist für den Ort belegt, nicht für die Person; als Ursache dessen, was die Person tat, wäre er eine
320
+ als Tatsache ausgegebene Vermutung. Die Erzählung nennt die Quelle des Hintergrunds (`--source`), damit sie sich
321
+ prüfen lässt;
322
+ - Erzählung eines Paares: das gemeinsame Leben wird einmal erzählt, beim Paar, damit dasselbe Leben nicht zweimal
323
+ erzählt wird und die Fassungen nicht auseinandergehen;
324
+ - Format: die Strom-App zeigt nur Absätze, Zwischenüberschriften, Aufzählungspunkte, Fettdruck und Kursivschrift;
325
+ alles andere sähen die Lesenden als einfachen Text mit Zeichen.
306
326
  - Freigabe und neue Fassung einer freigegebenen Erzählung: [R6.3.2](R6-awaiting-action.md#R6.3.2).
307
327
  - **Bedienung:** Terminal: `strom story set P… --text @notes/… --fact E… --source S… --note "co je odvozené"`
308
328
  (Erzählung eines Paares bei der Familie F…).
@@ -25,7 +25,9 @@ nur dort erledigt wird. Die Liste wird jedes Mal aus der Forschung berechnet, in
25
25
  - Die Zeile **Wartet: N (davon X nur hier im Terminal, Y warten auf Antwort)** teilt die Zahl wie die App. Die Zahl
26
26
  der App ist N ohne die Einträge nur für das Terminal und ohne gesendete Anfragen.
27
27
  - Nur im Terminal sind Stammbäume, die aus der App gesendet wurden (**Die Strom-App**), Fragen zum Lesen der Scans
28
- (**Das Lesen der Scans**), Widersprüche (**Widersprüche zu entscheiden**, siehe [R5](R5-conflicts.md)) und mildere Bedingungen eines Archivs. In der Übersicht **Was wartet** kommen sie zuerst unter
28
+ (**Das Lesen der Scans**), Widersprüche (**Widersprüche zu entscheiden**, siehe [R5](R5-conflicts.md)), Hypothesen zu
29
+ entscheiden (ab Forschung 1.28.0) und mildere Bedingungen eines Archivs. In der Übersicht **Was wartet** kommen sie
30
+ zuerst unter
29
31
  der Überschrift **Nur hier im Terminal (nicht in der Strom-App)**, danach **Auch in der Strom-App**.
30
32
  - Die Seite für das Telefon liest nur: ohne die Einträge nur für das Terminal, mit Erzählungen, zuerst 20 Einträge,
31
33
  höchstens 200 auf einmal. Sie schreibt **Entscheiden lässt sich am Computer in der Forschungsübersicht.**
@@ -87,12 +89,12 @@ freiwilligen Notiz.
87
89
  ## R6.3 Entscheidungen
88
90
 
89
91
  Der Abschnitt **Entscheidungen** sammelt Fragen, die den Agenten aufhalten: Erlaubnis eines Archivs, zu bestätigende
90
- Downloader, mildere Bedingungen, Seite prüfen, Erzählung, Ort (siehe [R4](R4-places.md)), Widerspruch (siehe [R5](R5-conflicts.md)), Stammbäume aus der App und das Lesen der Scans. Entscheidungen
91
- stehen in der Liste zuerst.
92
+ Downloader, mildere Bedingungen, Seite prüfen, Erzählung, Ort (siehe [R4](R4-places.md)), Widerspruch (siehe [R5](R5-conflicts.md)), Hypothese (siehe
93
+ [R6.3.4](#R6.3.4)), Stammbäume aus der App und das Lesen der Scans. Entscheidungen stehen in der Liste zuerst.
92
94
 
93
95
  - **Bedienung:** Terminal: **Was wartet** → Eintrag; `strom allow archive --way`, `strom place answer`,
94
96
  `strom conflict resolve`, `strom media calibrate --answer`.
95
- - **Gilt seit:** Forschung 1.14.0. Widersprüche seit 1.20.0, Orte seit 1.25.0.
97
+ - **Gilt seit:** Forschung 1.14.0. Widersprüche seit 1.20.0, Orte seit 1.25.0, Hypothesen seit 1.28.0.
96
98
 
97
99
  <!-- 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 -->
98
100
 
@@ -135,6 +137,20 @@ stehen in der Liste zuerst.
135
137
 
136
138
  <!-- 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 -->
137
139
 
140
+ <a id="R6.3.4"></a>
141
+ ### R6.3.4 Hypothesen zu entscheiden
142
+
143
+ - Eine Hypothese, deren Entscheidung der Agent vorgeschlagen hat ([R10.3.1](R10-people-and-hypotheses.md#R10.3.1)),
144
+ wartet in der Gruppe **Hypothesen zu entscheiden**: die Frage, die Versionen und der Vorschlag („Vorschlag:
145
+ Variante B – …“). Wahl: **Wie vorgeschlagen entscheiden**, **Anders entscheiden** (eine andere Version oder keine,
146
+ mit Grund), **So lassen (Vorschlag nicht übernommen)**.
147
+ - **Grenzen:** es entscheidet nur der Mensch ([R6.6](#R6.6)). Sie ist nur im Terminal, die Strom-App zeigt sie nicht
148
+ ([R6.1.1](#R6.1.1)). Im Strom-Archiv gibt es die Gruppe nicht.
149
+ - **Bedienung:** Terminal: **Was wartet** → Eintrag, `strom hypothesis decide H… --proposed | --keep-open`.
150
+ - **Gilt seit:** Forschung 1.28.0
151
+
152
+ <!-- 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 -->
153
+
138
154
  <a id="R6.4"></a>
139
155
  ## R6.4 Gruppen und Reihenfolge
140
156
 
@@ -200,8 +216,10 @@ startet, fragt die Forschung den Menschen in einem Systemfenster, oder sie lehnt
200
216
  wachsenden Zweig (`strom offline answer`), das Überlassen eines Widerspruchs aus einer Änderung an den Agenten
201
217
  (`strom conflict leave`), das Zurücknehmen und Verwerfen eines Sendens aus der App (`strom sync undo|discard`) und
202
218
  die Korrekturen `strom fixes … edit-decisions|woken-waits`.
219
+ - **Ab Forschung 1.28.0:** nur der Mensch entscheidet auch eine Hypothese (`strom hypothesis decide`, auch innerhalb
220
+ von `strom batch`); der Agent schlägt sie nur vor ([R10.3.1](R10-people-and-hypotheses.md#R10.3.1)).
203
221
 
204
- <!-- 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) -->
222
+ <!-- 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) -->
205
223
 
206
224
  <a id="R6.7"></a>
207
225
  ## R6.7 Gesendet, Antwort und Rückkehr in die Warteschlange
@@ -299,6 +299,9 @@ anderen Computer übertragen), wartet auf ihn. Bis dahin verhält sie sich wie e
299
299
  - der gespeicherte Modus ändert sich nicht, und die Aufgaben werden nicht zurückgestellt. Nach der Installation des
300
300
  Agenten macht die Forschung von selbst mit den Aufgaben weiter, die sie hatte;
301
301
  - ein Agent, der gerade in der Forschung arbeitet (auch ein anderer als der eingestellte), macht sie zur Forschung.
302
+ - **Warum:** ein Archiv ist die Wahl des Menschen, und strom erfasst sie nicht für ihn. Eine Forschung ohne Agenten
303
+ verhält sich nur wie ein Archiv, deshalb macht sie nach der Installation des Agenten von selbst mit den Aufgaben
304
+ weiter, die sie hatte; keine ist zurückgestellt.
302
305
  - **Bedienung:** Terminal: Menü, erster Punkt (**Nur als Strom-Archiv behalten: die Daten aus der Strom-App
303
306
  speichern** oder die Installation des Agenten); `strom mode` zeigt den Zustand. Die App zeigt eine solche Forschung
304
307
  als **Archiv** ([S1.3](S1-connecting-app-and-research.md#S1.3)).
@@ -409,6 +409,8 @@ daraus und die Suche, die ihn gefunden hat.
409
409
  - eine Quelle aus einem Scan bekommt `--clip` (den Ausschnitt, in dem der Eintrag gelesen wurde), `--transcript`
410
410
  (die Worte des Eintrags zeilenweise, nicht Gelesenes `[?]`) und `--locator` (Folio, Seite, Nummer des Eintrags);
411
411
  ausführlich [R3.4](R3-verification-and-citation.md#R3.4);
412
+ - ein Eintrag in einer anderen Sprache oder Schrift als der Sprache der Forschung bekommt neben der wörtlichen
413
+ Abschrift auch eine Übersetzung in die Sprache der Forschung (`--translation`), ab Forschung 1.28.0;
412
414
  - in die Felder (`--date`, `--house`, `--age`, Name) kommt nur sicher Gelesenes. Unsicheres kommt mit `[?]` in die
413
415
  Abschrift und in die Notiz der Angabe („Haus 21 oder 27“). Was ein Leser als unleserlich gemeldet hat, bleibt
414
416
  unleserlich, bis der Agent es selbst liest. Eine leere Spalte ist leer; nichts wird nach dem Üblichen ergänzt;
@@ -426,7 +428,7 @@ daraus und die Suche, die ihn gefunden hat.
426
428
  ([A3.3](A3-evidence-in-the-app.md#A3.3)).
427
429
  - **Gilt seit:** Forschung 1.0.0; Ausschnitt 1.1.0
428
430
 
429
- <!-- zdroj: research:assets/method/recording.md:1-27, :55-65 · assets/method/reading.md:76-84 · assets/method/core.md „Negative results are results“ -->
431
+ <!-- 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) -->
430
432
 
431
433
  <a id="R8.7"></a>
432
434
  ## R8.7 Sicherheit und Prüfung des Gelesenen
@@ -460,7 +460,8 @@ Schritte bei einer Aufgabe, die auf Bilder eines Archivs wartet, wohin der Agent
460
460
  <a id="R9.10"></a>
461
461
  ## R9.10 Beispiele
462
462
 
463
- Stufen und Grenzen stammen aus der Liste der Archive der Forschung 1.27.0. Die Familie Horák ist erfunden.
463
+ Stufen und Grenzen stammen aus der Liste der Archive der Forschung 1.27.0, DigiArchiv SOA Třeboň aus der Forschung
464
+ 1.28.0. Die Familie Horák ist erfunden.
464
465
 
465
466
  <a id="R9.10.1"></a>
466
467
  ### R9.10.1 Moravský zemský archiv (Acta Publica)
@@ -530,3 +531,23 @@ Stufen und Grenzen stammen aus der Liste der Archive der Forschung 1.27.0. Die F
530
531
  - **Gilt seit:** Forschung 1.27.0
531
532
 
532
533
  <!-- zdroj: research:assets/archives.json szukajwarchiwach.gov.pl (restricted, browserOnly) -->
534
+
535
+ <a id="R9.10.6"></a>
536
+ ### R9.10.6 DigiArchiv SOA Třeboň
537
+
538
+ - Archiv: nur von Hand, nur über den Browser eines Menschen. Bedingungen auf der Startseite des DigiArchivs (`/Uvod`):
539
+ „Snímky jsou poskytnuty pouze za účelem on-line prohlížení v DigiArchivu SOA v Třeboni, jejich kopírování,
540
+ distribuování, prodávání, využití v jiných projektech a na jiných stránkách je zakázáno.“ (Die Bilder werden nur
541
+ zum Online-Ansehen im DigiArchiv des SOA in Třeboň bereitgestellt; ihr Kopieren, Verbreiten, Verkaufen und ihre
542
+ Nutzung in anderen Projekten und auf anderen Seiten ist verboten.) Der Server lehnt die Anfragen von strom ab
543
+ (403), nach dem Archiv absichtlich.
544
+ - Das Archiv hat bestätigt: der Mensch darf von Hand nur ausgewählte Bilder speichern, nie das ganze Buch oder einen
545
+ wesentlichen Teil davon. Werkzeuge zum Herunterladen sind nicht erlaubt, auch nicht der Browser des Agenten.
546
+ - Aufgabe: der Eintrag von Marie Horáková in einer Matrik im DigiArchiv. Die Aufgabe wartet immer auf Bilder, die der
547
+ Mensch auswählt und speichert. Eine Erlaubnis öffnet das nicht; weder der Downloader noch ein Webabruf noch der
548
+ Browser des Agenten darf dorthin.
549
+ - Zitation: der dauerhafte Link auf ein Bild ist die Adresse seiner Seite `https://digi.ceskearchivy.cz/<kniha>/<snímek>`
550
+ oder **Odkaz na snimek** (Link auf das Bild) im Panel **POPIS**.
551
+ - **Gilt seit:** Forschung 1.28.0
552
+
553
+ <!-- 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 -->
@@ -170,7 +170,8 @@ B*, *verworfen*, die Zahl der Versionen und eine Notiz. Offene sind aufgeklappt.
170
170
  verbunden“, „Nicht mehr gültig: …“.
171
171
  - **Welche Hypothesen die Forschung sendet:** offene; entschiedene und verworfene nur die, deren Versionen
172
172
  Verbindungen tragen. Zurückgezogene nie.
173
- - **Grenzen:** eine Hypothese lässt sich aus der App nicht entscheiden; entschieden wird in der Forschung.
173
+ - **Grenzen:** eine Hypothese lässt sich aus der App nicht entscheiden; sie entscheidet der Mensch in der Forschung,
174
+ im Terminal ([R10.3.1](R10-people-and-hypotheses.md#R10.3.1)).
174
175
  - **Bedienung:** App: Schalter **Zeigen** bei der Version ([S3.5.1](#S3.5.1)).
175
176
  - **Gilt seit:** App 3.11.0 mit Forschung 1.14.0 (Versionen, Stand, **Zeigen**); Liste der Hypothesen seit App 3.4.0
176
177
 
@@ -2,7 +2,7 @@
2
2
  # A1 The app in brief
3
3
 
4
4
  How the Strom app works as a whole, on one page. Each section leads to a chapter with the exact rules. Describes the
5
- Strom app 3.21.2 and the research 1.25.2.
5
+ Strom app 3.21.2 and the research 1.25.2; changes from a later version carry its number.
6
6
 
7
7
  <a id="A1.1"></a>
8
8
  ## A1.1 A family tree in the browser, data on the device
@@ -64,3 +64,27 @@ work and what the research knows about people, and it sends edits back to the re
64
64
  - Connection: [S1](S1-connecting-app-and-research.md). Edits from the app: [S2](S2-edits-from-the-app.md).
65
65
  What the research knows: [S3](S3-what-the-research-knows.md). The research run from the app:
66
66
  [S4](S4-research-from-the-app.md). Phone: [S5](S5-phone.md).
67
+
68
+ <a id="A1.7"></a>
69
+ ## A1.7 How Strom works in the app
70
+
71
+ This documentation is carried in the app and can be read offline too. The window **How Strom works** has the contents
72
+ of parts A, R and S, the **Glossary** and a search by a word or by the number of a rule.
73
+
74
+ - **Limits:**
75
+ - opening the window sends nothing and loads nothing from the network;
76
+ - the number of a rule and Enter jump straight to the rule (`R4.3`); an unknown number shows the contents;
77
+ - links between rules have **Back**; **On the web** opens the same rule on stromapp.info;
78
+ - a rule newer than the connected research says so (“The research connected to this tree is version …; this
79
+ applies from …”).
80
+ - **Controls:** app: **Actions → How Strom works**, on the phone **More → How Strom works**, or **About Strom → How
81
+ Strom works**. The circle **?** in a header opens the help right at the rule: in the Research overview and the small
82
+ panel at the sections **Queue** ([R2.4](R2-lines-and-queue.md#R2.4)), **Awaiting action**
83
+ ([R6.4](R6-awaiting-action.md#R6.4)) and **Now** ([R7](R7-when-the-agent-works.md), when paused
84
+ [R7.6](R7-when-the-agent-works.md#R7.6)), in the window **Places** ([R4.5](R4-places.md#R4.5)), in the places
85
+ manager ([R4.4](R4-places.md#R4.4)), in the conflicts panel ([R5.3](R5-conflicts.md#R5.3)) and in **What the
86
+ research knows → Conflicts** ([R5.6](R5-conflicts.md#R5.6)). The window also has the **App tour**. In the research:
87
+ `strom doc` ([R1.8](R1-research-in-brief.md#R1.8)).
88
+ - **Since:** app 3.24.0
89
+
90
+ <!-- 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) -->
@@ -50,8 +50,12 @@ setting **My source transcriptions** decides how the research takes it
50
50
  - **Controls:** the source editor, **More: transcript, record date, reliability**; in **Actions → Sources** the
51
51
  filter **Transcription not verified** (only in a tree set to **Evidence** with older unverified sources).
52
52
  - **Since:** app 3.9.0
53
+ - **From app 3.24.0:** a translation of the transcription sent by the research
54
+ ([R3.4](R3-verification-and-citation.md#R3.4)) is under the transcription as a folded section **Translation of the
55
+ transcript**: in the source viewer and on the source card on a person's page. The note of the source does not
56
+ change; the note editor shows it whole. A source without a translation looks as before.
53
57
 
54
- <!-- 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 -->
58
+ <!-- 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 -->
55
59
 
56
60
  <a id="A3.2"></a>
57
61
  ## A3.2 Citation: what a source supports
@@ -1,7 +1,7 @@
1
1
  <a id="A6"></a>
2
2
  # A6 Views and the choice of people
3
3
 
4
- How the Strom app chooses which people to show and how each view shows them. Describes the app 3.21.2.
4
+ How the Strom app chooses which people to show and how each view shows them. Describes the app 3.21.2; changes from a later version carry its number.
5
5
 
6
6
  A view is a different reading of **the same choice of people**. The choice is set by the central person (the one
7
7
  clicked) and the depth **Ancestors** and **Descendants**. Family, Descendants, Timeline and Map show the same
@@ -142,12 +142,23 @@ tree from the research, places are identified by the research ([R4](R4-places.md
142
142
  - before the first lookup the app asks (**Look up coordinates online?**). Only place names leave the app, no names
143
143
  of people, dates or relations. At most one request about every second;
144
144
  - the coordinates are saved into the tree: each place is looked up once, and the map then works offline too;
145
- - the automatic lookup takes the service's **first result** for the written name. It does not tell apart towns of
146
- the same name: a place can thus land in a town of the same name elsewhere. Such a location is then marked
147
- **Check** ([R4.4.1](R4-places.md#R4.4.1));
145
+ - the automatic lookup takes the service's **first result** for the written name. Up to app 3.23.0 it did not tell
146
+ apart towns of the same name: a place could thus land in a town of the same name elsewhere. A location that does
147
+ not fit the tree is marked **Check** ([R4.4.1](R4-places.md#R4.4.1));
148
148
  - only a place with a house number that the service did not find is looked up by its town. Of the towns of that
149
149
  name, the one nearest the tree's other places is chosen (“Several towns have this name; the one nearest the tree’s
150
150
  other places was chosen.”); the place shows **Located by the town of …**;
151
+ - **from app 3.24.0** the nearest town is chosen for every place: when two or more towns are named exactly like the
152
+ written place (regardless of letter case and diacritics), the one nearest the centre of the tree is taken, not the
153
+ first result. The centre is the median of the locations set by hand or confirmed with **Keep**, when there are at
154
+ least 3; otherwise the median of all the tree's locations and of the places the lookup found without doubt.
155
+ A place with a further detail (“Lhota u Kolína”, “Lhota 16”), a single town or a tree without locations gets the
156
+ first result as before. It is still one request per place;
157
+ - the place check says how many towns of that name the map found (“The map found 3 towns with this name and took the
158
+ one nearest the tree’s other places.”); from app 3.24.0, formerly always “two”;
159
+ - a location already in the tree is not moved: the lookup looks up only places without a location. Not even a merge
160
+ with another tree or a GEDCOM file overwrites a location set by hand or confirmed with **Keep**; it only adds
161
+ missing ones. A wrong older location can be moved only by hand;
151
162
  - what is not found stays without a location. The app guesses nothing: “check the spelling, or add the country”.
152
163
  - **Controls:** app: **Settings → Look up places online**; in the places window **Wrong spot? Fix this place**,
153
164
  **Search for this place under another name** (only the location is attached, the entry in the tree does not
@@ -156,9 +167,9 @@ tree from the research, places are identified by the research ([R4](R4-places.md
156
167
  names, and each place once (a comment in the code). The limit of one request per second is a condition of the
157
168
  service.
158
169
  - **Since:** app 1.10.0; **Wrong spot? Fix this place** 1.10.1; **Clean orphaned places** 2.1.0; the location by the
159
- town 3.21.0
170
+ town 3.21.0; the nearest town of the same name for every place and the number of towns in the check 3.24.0
160
171
 
161
- <!-- 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) -->
172
+ <!-- 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 -->
162
173
 
163
174
  <a id="A6.6"></a>
164
175
  ## A6.6 A family line in the view
@@ -2,7 +2,7 @@
2
2
  # R1 The research in brief
3
3
 
4
4
  How the research works as a whole, on one page. Each section leads to a chapter with the exact rules. Describes
5
- the research 1.25.2 and the Strom app 3.21.2.
5
+ the research 1.25.2 and the Strom app 3.21.2; changes from a later version carry its number.
6
6
 
7
7
  <a id="R1.1"></a>
8
8
  ## R1.1 The research is a record, not a conversation
@@ -52,8 +52,9 @@ work and the condition set by a person allows it (for example the pace of the we
52
52
  The agent works by the **Genealogical Proof Standard** (GPS): a reasonably exhaustive search, a citation for every fact,
53
53
  analysis and correlation of the evidence, resolution of conflicts, and a written conclusion another researcher can follow.
54
54
 
55
- - Every fact has a degree of certainty: **Lead**, **Possible**, **Probable**, **Proven**. A family tree and family
56
- memory are always only a lead; an index serves to find the entry. In detail: [R3](R3-verification-and-citation.md).
55
+ - Every fact has a degree of certainty: **Lead**, **Possible**, **Probable**, **Proven**. A family tree, family
56
+ memory and an index are always only a lead: an index leads to the entry, only the entry itself proves it (the code
57
+ enforces the index from research 1.28.0). In detail: [R3](R3-verification-and-citation.md).
57
58
  - A namesake is not the person sought. A person is identified by year, place, house, occupation, spouse and parents.
58
59
  Two records with the same name and different parents are two persons. Identifying persons, their names and
59
60
  competing hypotheses: [R10](R10-people-and-hypotheses.md).
@@ -62,7 +63,7 @@ analysis and correlation of the evidence, resolution of conflicts, and a written
62
63
  - When records differ, the agent does not choose silently: it writes a **conflict**. In detail: [R5](R5-conflicts.md).
63
64
  - A place gets a position on the map only when it is certain which place it is. In detail: [R4](R4-places.md).
64
65
 
65
- <!-- zdroj: research:assets/method/core.md (úvod, „Certainty is explicit“, „A namesake is not your person“, „Negative results are results“) -->
66
+ <!-- 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) -->
66
67
 
67
68
  <a id="R1.5"></a>
68
69
  ## R1.5 What a person decides
@@ -70,14 +71,16 @@ analysis and correlation of the evidence, resolution of conflicts, and a written
70
71
  Some decisions belong to a person only. The research asks about them in **Awaiting action**, and the agent does not
71
72
  answer for the person.
72
73
 
73
- - What waits for a person (letters, images to download, questions about places, conflicts, stories to approve) and
74
- where it is dealt with: [R6](R6-awaiting-action.md).
74
+ - What waits for a person (letters, images to download, questions about places, conflicts, hypotheses, stories to
75
+ approve) and where it is dealt with: [R6](R6-awaiting-action.md).
76
+ - Only a person decides a hypothesis; the agent proposes the decision (from research 1.28.0):
77
+ [R10.3.1](R10-people-and-hypotheses.md#R10.3.1).
75
78
  - A person's decision holds. The agent changes it only on the strength of a new source: [R5.4](R5-conflicts.md#R5.4).
76
79
  - A place position set by a person does not change: [R4.3](R4-places.md#R4.3).
77
80
  - Settings that change what the agent may do are confirmed by a person (for example the condition for working alone,
78
81
  [R7](R7-when-the-agent-works.md)).
79
82
 
80
- <!-- zdroj: research:assets/method/waiting.md · src/core/conflicts.ts againAllowed · src/core/placeid.ts personsHand · src/core/config.ts run.gate -->
83
+ <!-- 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) -->
81
84
 
82
85
  <a id="R1.6"></a>
83
86
  ## R1.6 The research and the Strom app
@@ -102,3 +105,28 @@ important facts should ideally be verified by a person as well.
102
105
  - **Since:** research 1.0.0
103
106
 
104
107
  <!-- zdroj: research:assets/method/reading.md · assets/method/locate.md · assets/method/recording.md · src/commands/read.ts:183-200 -->
108
+
109
+ <a id="R1.8"></a>
110
+ ## R1.8 How Strom works: `strom doc`
111
+
112
+ This documentation is carried in the research and can be read offline too. `strom doc` lists the contents,
113
+ `strom doc R10.1` one rule together with the rules under it, and `strom doc <words>` searches the headings, the
114
+ glossary and the text.
115
+
116
+ - **Limits:**
117
+ - a number can also be written in small letters or with a hyphen (`r4.3`, `R4-3`). An unknown number ends with an
118
+ error that gives the nearest numbers;
119
+ - the search ignores diacritics and letter case. It shows at most 10 rules, the best first, and how many more there
120
+ are (`--limit` another count);
121
+ - the text is in the language of the research (`--lang` another). A language the documentation is not translated
122
+ into gets English with a note;
123
+ - each rule has a link to the same rule on stromapp.info;
124
+ - it works outside a research and in a Strom archive too, and writes nothing.
125
+ - **Method only:** to a person's question how or why Strom does something, the agent answers from `strom doc`: with
126
+ the number of the rule and with the link that `strom doc` prints.
127
+ - **Controls:** terminal: `strom doc`, `strom doc R2.3`, `strom doc hypothesis --lang en`, `--json`. The help for
128
+ a person (`strom help --human`) ends with a pointer to `strom doc`. The app has the same documentation in **How
129
+ Strom works** ([A1.7](A1-the-app-in-brief.md#A1.7)).
130
+ - **Since:** research 1.28.0
131
+
132
+ <!-- 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 -->
@@ -3,7 +3,7 @@
3
3
 
4
4
  How the research recognises that an entry belongs to the person sought, what it does with two records of one person,
5
5
  how it keeps competing explanations (hypotheses), and how it records names and the people an entry names. Describes
6
- the research 1.27.0 and the Strom app 3.23.0. Each rule says what is **enforced by the code** and what is only a
6
+ the research 1.27.0 and the Strom app 3.23.0; changes from a later version carry its number. Each rule says what is **enforced by the code** and what is only a
7
7
  **rule of the method**.
8
8
 
9
9
  <a id="R10.1"></a>
@@ -46,6 +46,8 @@ it stays retracted, with a note saying into whom it was merged.
46
46
  records, the families are merged first (`strom family merge`).
47
47
  - **Method only:** a person from an imported family tree who is already researched in the research is merged **into**
48
48
  the researched person; that person keeps their documents ([R11.3](R11-material-from-the-user.md#R11.3)).
49
+ - **Why:** strom never chooses quietly between two facts: the evidence decides which one stands. The other is retracted
50
+ with a reason, so what stood where stays visible.
49
51
  - **Controls:** terminal: `strom person merge`, `strom family merge`. Possible duplicates in the tree are reported by
50
52
  the app in the Tree check ([A5.6](A5-tree-check.md#A5.6)).
51
53
  - **Since:** research 1.0.0
@@ -79,22 +81,38 @@ A, B, C… with what speaks for each and what against.
79
81
  <a id="R10.3.1"></a>
80
82
  ### R10.3.1 Deciding a hypothesis
81
83
 
82
- A hypothesis is decided for one version, or abandoned when none can be decided. It is decided in the research; the
83
- app does not let a hypothesis be decided.
84
+ A hypothesis is decided for one version, or abandoned when none can be decided. Only a person decides, in the
85
+ research; the agent proposes the decision. The app does not let a hypothesis be decided.
84
86
 
85
87
  - **Enforced by the code:**
86
- - a decision needs the text of the decision (`--decision`); abandoning is `--abandon`;
87
- - deciding again is possible only with a reason (`--reason`). The previous decision stays in a note of the
88
- hypothesis;
89
- - after a decision strom lists the sources the hypothesis names that no fact of its persons cites: what they say
90
- should be recorded at the persons.
91
- - **Method only:** a hypothesis whose versions carry connections is decided with the choice of a version
92
- (`--variant B`). A decided hypothesis that a new record overturns is decided again by the agent, with a reason. What
93
- the agent held back while the person was only a hypothesis it records at the person after the decision.
94
- - **Controls:** terminal: `strom hypothesis decide H… --variant B --decision "…"` (again with `--reason "…"`).
88
+ - a decision is a person's step. When the agent runs `strom hypothesis decide` (also inside `strom batch`), strom
89
+ refuses it;
90
+ - the agent proposes the decision: a version and the text of the decision (`strom hypothesis propose`), or
91
+ abandoning (`--abandon`). A new proposal replaces the previous one. The work does not wait for the answer;
92
+ - the proposal waits in **What waits** in the group **Hypotheses to decide** ([R6.3.4](R6-awaiting-action.md#R6.3.4)):
93
+ a person decides as proposed, otherwise (another version or none, with a reason), or leaves the hypothesis as it
94
+ is. A proposal not taken stays in a note of the hypothesis;
95
+ - a decision and a proposal need the text of the decision (`--decision`); abandoning is `--abandon`;
96
+ - a hypothesis whose versions say what they would connect is decided and proposed only with the version named
97
+ (`--variant B`). Without it strom refuses and writes nothing;
98
+ - deciding again (and proposing again) is possible only with a reason (`--reason`). The previous decision stays in
99
+ a note of the hypothesis;
100
+ - what a person's decision connects, and the sources the hypothesis names that no fact of its persons cites, the
101
+ agent gets at the start of its next work as the first task to record on the tree.
102
+ - **Method only:** the agent proposes a decision when the records point to one version, and tells the person in one
103
+ sentence. A decided hypothesis that a new record overturns the agent proposes again, with a reason. What the agent
104
+ held back while the person was only a hypothesis it records at the person once a person decides the hypothesis.
105
+ - **Why:** a new decision needs a reason because decisions change in the open: the previous one stays readable and
106
+ the new one says what changed it (usually a new record).
107
+ - **Controls:** terminal: the `strom` menu → **What waits** → **Hypotheses to decide** → **Decide as proposed**,
108
+ **Decide otherwise**, **Leave it as it is (the proposal not taken)**; by command `strom hypothesis decide H…
109
+ --proposed`, `--keep-open`, or `--variant B --decision "…"` (again with `--reason "…"`). The agent: `strom
110
+ hypothesis propose H… --variant B --decision "…"`.
95
111
  - **Since:** research 1.0.0; the list of sources not recorded 1.12.0
112
+ - **From research 1.28.0:** only a person decides, the agent proposes; the code enforces the named version (formerly
113
+ method only). Hypotheses the agent decided before stay as they were.
96
114
 
97
- <!-- 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" -->
115
+ <!-- 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 -->
98
116
 
99
117
  <a id="R10.4"></a>
100
118
  ## R10.4 A family outside the tree waits for a proven link
@@ -138,6 +156,9 @@ own record. Names are recorded as they stand in the entry; only dates are standa
138
156
  - a person whom a weaker record named differently keeps that name as a variant; the correct name is marked as the
139
157
  main one. Nothing is deleted;
140
158
  - a name read only in part: [R8.6](R8-reading-scans.md#R8.6).
159
+ - **Why:** a description in place of a name (“stillborn son”) would be shown and searched as a given name by the app
160
+ and by GEDCOM, and name matching would take it for a name. That the child died without a name is a fact (a death,
161
+ a note).
141
162
  - **Controls:** terminal: `strom name add P… "Marie /Vlková/" --kind birth --cite S…`, `strom name primary P…
142
163
  "…"` (`--clear` returns the birth name). Surname forms in the app: [A4.5](A4-surnames-and-families.md#A4.5),
143
164
  [A4.6](A4-surnames-and-families.md#A4.6).