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.
- package/CHANGELOG.cs.md +11 -2
- package/CHANGELOG.de.md +12 -2
- package/CHANGELOG.md +12 -2
- package/CHANGELOG.pl.md +12 -2
- package/assets/lang/cs.json +6 -4
- package/assets/lang/de.json +6 -4
- package/assets/lang/pl.json +6 -4
- package/assets/strom-doc/CISLA.md +4 -0
- package/assets/strom-doc/PIN +1 -1
- package/assets/strom-doc/REJSTRIK.md +17 -5
- package/assets/strom-doc/cs/A1-the-app-in-brief.md +23 -1
- package/assets/strom-doc/cs/A3-evidence-in-the-app.md +4 -1
- package/assets/strom-doc/cs/A6-views.md +16 -6
- package/assets/strom-doc/cs/R1-research-in-brief.md +34 -7
- package/assets/strom-doc/cs/R10-people-and-hypotheses.md +33 -12
- package/assets/strom-doc/cs/R11-material-from-the-user.md +17 -6
- package/assets/strom-doc/cs/R3-verification-and-citation.md +32 -13
- package/assets/strom-doc/cs/R6-awaiting-action.md +21 -5
- package/assets/strom-doc/cs/R7-when-the-agent-works.md +2 -0
- package/assets/strom-doc/cs/R8-reading-scans.md +3 -1
- package/assets/strom-doc/cs/R9-archives.md +19 -1
- package/assets/strom-doc/cs/S3-what-the-research-knows.md +2 -1
- package/assets/strom-doc/de/A1-the-app-in-brief.md +28 -1
- package/assets/strom-doc/de/A3-evidence-in-the-app.md +6 -1
- package/assets/strom-doc/de/A6-views.md +21 -6
- package/assets/strom-doc/de/R1-research-in-brief.md +36 -7
- package/assets/strom-doc/de/R10-people-and-hypotheses.md +40 -15
- package/assets/strom-doc/de/R11-material-from-the-user.md +20 -6
- package/assets/strom-doc/de/R3-verification-and-citation.md +34 -14
- package/assets/strom-doc/de/R6-awaiting-action.md +23 -5
- package/assets/strom-doc/de/R7-when-the-agent-works.md +3 -0
- package/assets/strom-doc/de/R8-reading-scans.md +3 -1
- package/assets/strom-doc/de/R9-archives.md +22 -1
- package/assets/strom-doc/de/S3-what-the-research-knows.md +2 -1
- package/assets/strom-doc/en/A1-the-app-in-brief.md +25 -1
- package/assets/strom-doc/en/A3-evidence-in-the-app.md +5 -1
- package/assets/strom-doc/en/A6-views.md +17 -6
- package/assets/strom-doc/en/R1-research-in-brief.md +35 -7
- package/assets/strom-doc/en/R10-people-and-hypotheses.md +34 -13
- package/assets/strom-doc/en/R11-material-from-the-user.md +18 -6
- package/assets/strom-doc/en/R3-verification-and-citation.md +31 -12
- package/assets/strom-doc/en/R6-awaiting-action.md +21 -4
- package/assets/strom-doc/en/R7-when-the-agent-works.md +2 -0
- package/assets/strom-doc/en/R8-reading-scans.md +3 -1
- package/assets/strom-doc/en/R9-archives.md +21 -1
- package/assets/strom-doc/en/S3-what-the-research-knows.md +2 -1
- package/assets/strom-doc/pl/A1-the-app-in-brief.md +24 -1
- package/assets/strom-doc/pl/A3-evidence-in-the-app.md +5 -1
- package/assets/strom-doc/pl/A6-views.md +18 -6
- package/assets/strom-doc/pl/R1-research-in-brief.md +34 -7
- package/assets/strom-doc/pl/R10-people-and-hypotheses.md +33 -12
- package/assets/strom-doc/pl/R11-material-from-the-user.md +18 -6
- package/assets/strom-doc/pl/R3-verification-and-citation.md +32 -14
- package/assets/strom-doc/pl/R6-awaiting-action.md +22 -5
- package/assets/strom-doc/pl/R7-when-the-agent-works.md +2 -0
- package/assets/strom-doc/pl/R8-reading-scans.md +3 -1
- package/assets/strom-doc/pl/R9-archives.md +22 -1
- package/assets/strom-doc/pl/S3-what-the-research-knows.md +2 -1
- package/dist/cli/menu.js +5 -4
- package/dist/cli/ui.js +6 -4
- package/dist/commands/session.js +15 -8
- package/dist/core/live.js +32 -8
- package/dist/core/tree.js +1 -1
- package/dist/runners/claude.js +14 -4
- 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:**
|
|
105
|
-
|
|
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`)
|
|
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
|
|
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
|
|
99
|
-
nie Wahrscheinlich oder Belegt ([R3.2](#R3.2)).
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
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
|
|
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 --
|
|
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))
|
|
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)),
|
|
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
|
|
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;
|
|
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.
|
|
146
|
-
the same name: a place
|
|
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
|
|
56
|
-
memory are always only a lead
|
|
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
|
|
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.
|
|
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
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
-
|
|
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 (
|
|
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).
|