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
@@ -22,12 +22,18 @@ what really stands in it.
22
22
  kept for later ([R7.8](R7-when-the-agent-works.md#R7.8)).
23
23
  - **Method only:** names and places are recorded as they are written; only dates are standardised. The task is closed
24
24
  with what came out of the material and with further tasks: where to look for records that would prove the leads.
25
+ - **Why:**
26
+ - 20 images: the scans of a register do not belong in the tree's history as hundreds of material tasks. The family
27
+ documents of one folder are usually a handful to a few dozen files; more than 20 images are usually the scans of
28
+ a book and are recorded as a book;
29
+ - 20 MB: the tree's history is never rewritten and goes with the tree in backups and transfers. Large files (video,
30
+ uncompressed scans) would enlarge it for good, so they lie in the shared media store.
25
31
  - **Controls:** terminal: `strom intake <soubory nebo složky>`, `strom intake --text "…"` (what the user says),
26
32
  `strom input list`, `strom input show I…`. App: **Send material…**, **Add materials…**
27
33
  ([A3.5](A3-evidence-in-the-app.md#A3.5)).
28
34
  - **Since:** research 1.0.0
29
35
 
30
- <!-- 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 -->
36
+ <!-- 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 -->
31
37
 
32
38
  <a id="R11.2"></a>
33
39
  ## R11.2 A document is a source, the rest is a lead
@@ -80,7 +86,8 @@ A folder, a ZIP or a box of documents sent from the app is received by the resea
80
86
  sorts it by tasks.
81
87
 
82
88
  - **Enforced by the code:**
83
- - a batch is closed when the app reports that it is complete, or a day after the last file;
89
+ - a batch is closed when the app reports that it is complete, or a day after the last file (a batch from a phone
90
+ an hour after the last photo, [S5.4](S5-phone.md#S5.4));
84
91
  - then it becomes material tasks of about 25 files each, by the folders the files came in. In a Strom archive the
85
92
  tasks wait, kept for later;
86
93
  - the files of a batch are stored as originals in the shared media store, not in the tree's history. What the agent
@@ -94,10 +101,15 @@ sorts it by tasks.
94
101
  - the scans of one book (many numbered images) are not read file by file: they are recorded as a book, and entries
95
102
  are read from it as from any book ([R8](R8-reading-scans.md));
96
103
  - the task is closed once each of its files is sorted; a further part of the batch is a task of its own.
97
- - **Why:** a file's path in a batch says a lot (`Babička/Dopisy/1946.jpg`); what does not belong to the family should
98
- not get into the tree (the method).
104
+ - **Why:**
105
+ - a day after the last file: the app sends files one by one. A batch nobody said is complete is closed with what
106
+ came, so that nothing waits longer; a day without another file means the sending has ended. A phone's page is
107
+ easily closed without handing the batch over, so an hour is enough there;
108
+ - 25 files: one material task is read by one agent session, and about 25 files fit into it;
109
+ - a file's path in a batch says a lot (`Babička/Dopisy/1946.jpg`); what does not belong to the family should not get
110
+ into the tree (the method).
99
111
  - **Controls:** terminal: `strom input batch` (batches and how much is sorted), `strom input sort I… --as
100
112
  source|document|photo|unrelated --person P…`. App: **Add materials…** in the research menu.
101
- - **Since:** research 1.12.0
113
+ - **Since:** research 1.12.0; a batch from a phone 1.18.0
102
114
 
103
- <!-- 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" -->
115
+ <!-- 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" -->
@@ -37,7 +37,7 @@ the conclusion is from all the fact's sources, not how good one source is ([R3.2
37
37
  ### R3.1.1 The default degree and the citation that raises it
38
38
 
39
39
  - A fact entered without `--status`: with no citation **Lead**; with a citation of at least one source that is not
40
- weak ([R3.3](#R3.3)), **Probable**; otherwise Lead.
40
+ weak ([R3.3](#R3.3)), **Probable**; otherwise Lead. From research 1.28.0 an index is weak too.
41
41
  - `strom cite` without `--status` raises Lead to Probable when the new source is not weak. It changes no other degree.
42
42
  - A change of degree with `strom event edit --status` needs `--reason`; a citation with a degree
43
43
  (`strom cite … --status`) does not.
@@ -54,18 +54,19 @@ A degree must not claim more than the fact's citations give. The code checks thi
54
54
  - **Limits (enforced by the code),** in this order:
55
55
  1. Probable and Proven need at least one citation.
56
56
  2. At least one citation must be from a source that is not weak. Weak are a family tree (`--kind family-tree`),
57
- a memory (`--kind family-memory`) and an authored work (`--form authored`).
57
+ a memory (`--kind family-memory`), an authored work (`--form authored`) and from research 1.28.0 an index
58
+ (`--kind index`).
58
59
  3. Proven additionally needs, among the citations from sources that are not weak, at least one with primary
59
60
  information (`--information primary`): a record written at the time of the event by someone who knew. The
60
61
  information at a citation takes precedence over the information at the source.
61
62
  - **Method only:** the code does not check that the source is an original (`--form original`), that the agent read it
62
63
  itself, that the record states the fact directly, or a blind second reading ([R3.5](#R3.5)). Proven therefore also
63
- passes for a copy or an index with primary information.
64
+ passes for a copy with primary information (for an index too up to research 1.27.0).
64
65
  - **Controls:** terminal: `strom event add P… BIRT --date "…" --cite S… --information primary --status proven`.
65
66
  A refusal gives the reason and what to do instead (leave it a Lead, `--status possible`, or `--status probable`).
66
67
  - **Since:** research 1.0.0
67
68
 
68
- <!-- 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 -->
69
+ <!-- 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" -->
69
70
 
70
71
  <a id="R3.2.1"></a>
71
72
  ### R3.2.1 A source: form and information
@@ -93,16 +94,20 @@ A degree must not claim more than the fact's citations give. The code checks thi
93
94
  A family tree, a memory, an index, a catalogue and an online tree say where to look. They are not evidence of a fact.
94
95
  A fact from them stays a Lead until a record proves it.
95
96
 
96
- - **Enforced by the code:** a family tree, a memory and an authored work are weak sources: a fact only from them is
97
- never Probable or Proven ([R3.2](#R3.2)). A family tree taken over: [R11.3](R11-material-from-the-user.md#R11.3).
98
- - **Method only:** an index. The code does not treat it as weak: with its citation a fact without `--status` gets the
99
- degree Probable, and with `--information primary` even Proven passes. The method wants an index only for finding the
100
- page; the entry is read in the register. Even an entry missing from an index is only a lead: a similar form of the
101
- surname is a candidate.
97
+ - **Enforced by the code:** a family tree, a memory, an authored work and an index (`--kind index`) are weak
98
+ sources: a fact only from them is never Probable or Proven ([R3.2](#R3.2)). A fact that cites only an index stays
99
+ a Lead until the entry itself is read and cited; with a citation of the entry it is a fact of the entry. A family
100
+ tree taken over: [R11.3](R11-material-from-the-user.md#R11.3).
101
+ - **Limits:** for edits from the app an index counts as a record: an edit of a fact backed by an index becomes
102
+ a conflict ([R5.2](R5-conflicts.md#R5.2)); nothing is overwritten silently.
103
+ - **Method only:** an index serves only for finding the page; the entry is read in the register. Even an entry
104
+ missing from an index is only a lead: a similar form of the surname is a candidate.
102
105
  - Material from the user (a document, a photo, a letter, what the user says): [R11.2](R11-material-from-the-user.md#R11.2).
103
106
  - **Since:** research 1.0.0
107
+ - **From research 1.28.0:** the code enforces an index as a weak source (formerly method only: with its citation
108
+ a fact got Probable, and with `--information primary` even Proven passed).
104
109
 
105
- <!-- 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 -->
110
+ <!-- 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 -->
106
111
 
107
112
  <a id="R3.4"></a>
108
113
  ## R3.4 A citation: clip and transcription
@@ -114,12 +119,17 @@ several sources.
114
119
  (the words of the entry as they stand, line by line, an unread letter `[?]`), plus `--locator` (folio, page, entry
115
120
  number) and, at the fact, `--quote`. A field (`--date`, `--house`, `--age`, a name) takes only what is read with
116
121
  certainty; what is uncertain goes into the transcription with `[?]` and into the fact's note.
122
+ - **Method only, from research 1.28.0:** an entry in a language or script other than the language of the research
123
+ (Latin, Kurrent, Polish, Cyrillic…) gets, beside the literal transcription, a translation into the language of the
124
+ research (`--translation`). The transcription stays in the language of the entry. The app shows the translation
125
+ folded under the transcription ([A3.1.1](A3-evidence-in-the-app.md#A3.1.1)).
117
126
  - **Enforced by the code:** at most 3 clips per source (the entry and its continuation across a page break). The code
118
127
  does not refuse a missing clip or transcription; it only reminds about it for a source on a scan: after
119
128
  `strom source add`, after `strom source edit` with an image or a clip, and at `strom task done` for the sources the
120
129
  task entered.
121
130
  - Older sources: `strom clips` adds the clip, `strom transcripts` the transcription (readers; a second look checks them).
122
- - **Controls:** terminal: `strom source add "…" --clip B…:57@x,y,w,h --transcript @notes/entry.txt --locator "…"`.
131
+ - **Controls:** terminal: `strom source add "…" --clip B…:57@x,y,w,h --transcript @notes/entry.txt --translation
132
+ @notes/translation.txt --locator "…"`; added later with `strom source edit S… --translation "…"`.
123
133
  The app shows the clip of the entry beside the transcription.
124
134
  - **Since:** research 1.1.0 (clip, `strom clips`, `strom transcripts`); transcription 1.0.0
125
135
  - **From research 1.26.0:** the help of the `--clip` option says “another for each page break, at most 3” (in 1.25.2
@@ -290,6 +300,15 @@ A story is written from the facts, for the family. What has not been proven is n
290
300
  of the research;
291
301
  - the format of the text: only paragraphs, subheadings, bullets, bold and italics. Anything else (links, tables,
292
302
  quotations, numbered lists) the app shows as plain text, according to the method.
303
+ - **Why:**
304
+ - nothing is made up: a story is for the family and rests on evidence. What would sound likely but is not proven
305
+ would start to be taken as fact in the family;
306
+ - background: it is proven for the place, not for the person; as the cause of what a person did it would be
307
+ a guess passed off as fact. The story names the source of the background (`--source`) so that it can be checked;
308
+ - a couple's story: the shared life is told once, with the couple, so that the same life is not told twice and the
309
+ versions do not drift apart;
310
+ - format: the Strom app shows only paragraphs, subheadings, bullets, bold and italics; anything else the reader would
311
+ see as plain text with marks.
293
312
  - Approval and a new version of an approved story: [R6.3.2](R6-awaiting-action.md#R6.3.2).
294
313
  - **Controls:** terminal: `strom story set P… --text @notes/… --fact E… --source S… --note "co je odvozené"`
295
314
  (a couple's story on the family F…).
@@ -25,7 +25,8 @@ The list is worked out from the research each time; nothing is written into it.
25
25
  - The line **Waiting: N (of these X only here in the terminal, Y waiting for a reply)** splits the count the way the
26
26
  app does. The app's number is N without the items for the terminal only and without requests sent.
27
27
  - Only in the terminal are trees sent from the app (**The Strom app**), questions about reading scans (**The reading
28
- of scans**), conflicts (**Conflicts to decide**, see [R5](R5-conflicts.md)) and milder terms of an archive. In the
28
+ of scans**), conflicts (**Conflicts to decide**, see [R5](R5-conflicts.md)), hypotheses to decide (from research 1.28.0) and
29
+ milder terms of an archive. In the
29
30
  overview **What waits** they come first under the heading **Only here in the terminal (not in the Strom app)**,
30
31
  followed by **Also in the Strom app**.
31
32
  - The page for the phone only reads: without the items for the terminal only, with stories, 20 items first, at most
@@ -87,11 +88,11 @@ and its images can be seen**, **Only to be viewed there** or **It does not work*
87
88
 
88
89
  The section **decisions** gathers the questions that hold the agent up: an archive's permission, downloaders to
89
90
  confirm, milder terms, a site to check, a story, a place (see [R4](R4-places.md)), a conflict (see
90
- [R5](R5-conflicts.md)), trees from the app and the reading of scans. Decisions come first in the list.
91
+ [R5](R5-conflicts.md)), a hypothesis (see [R6.3.4](#R6.3.4)), trees from the app and the reading of scans. Decisions come first in the list.
91
92
 
92
93
  - **Controls:** terminal: **What waits** → the item; `strom allow archive --way`, `strom place answer`,
93
94
  `strom conflict resolve`, `strom media calibrate --answer`.
94
- - **Since:** research 1.14.0. Conflicts from 1.20.0, places from 1.25.0.
95
+ - **Since:** research 1.14.0. Conflicts from 1.20.0, places from 1.25.0, hypotheses from 1.28.0.
95
96
 
96
97
  <!-- 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 -->
97
98
 
@@ -134,6 +135,20 @@ confirm, milder terms, a site to check, a story, a place (see [R4](R4-places.md)
134
135
 
135
136
  <!-- 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 -->
136
137
 
138
+ <a id="R6.3.4"></a>
139
+ ### R6.3.4 Hypotheses to decide
140
+
141
+ - A hypothesis whose decision the agent proposed ([R10.3.1](R10-people-and-hypotheses.md#R10.3.1)) waits in the
142
+ group **Hypotheses to decide**: the question, the versions and the proposal (“Proposed: variant B — …”). The
143
+ choice: **Decide as proposed**, **Decide otherwise** (another version, or none, with a reason), **Leave it as it is
144
+ (the proposal not taken)**.
145
+ - **Limits:** only a person decides ([R6.6](#R6.6)). It is only in the terminal; the Strom app does not show it
146
+ ([R6.1.1](#R6.1.1)). In a Strom archive the group does not exist.
147
+ - **Controls:** terminal: **What waits** → the item, `strom hypothesis decide H… --proposed | --keep-open`.
148
+ - **Since:** research 1.28.0
149
+
150
+ <!-- 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 -->
151
+
137
152
  <a id="R6.4"></a>
138
153
  ## R6.4 Groups and order
139
154
 
@@ -196,8 +211,10 @@ asks the person in a system window, or refuses the command.
196
211
  research also refuses the agent `strom story set --final`), the answer to a growing branch (`strom offline
197
212
  answer`), leaving a conflict from an edit to the agent (`strom conflict leave`), undoing and discarding a send from
198
213
  the app (`strom sync undo|discard`) and the fixes `strom fixes … edit-decisions|woken-waits`.
214
+ - **From research 1.28.0:** only a person also decides a hypothesis (`strom hypothesis decide`, also inside
215
+ `strom batch`); the agent only proposes it ([R10.3.1](R10-people-and-hypotheses.md#R10.3.1)).
199
216
 
200
- <!-- 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) -->
217
+ <!-- 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) -->
201
218
 
202
219
  <a id="R6.7"></a>
203
220
  ## R6.7 Sent, the answer and the return to the queue
@@ -281,6 +281,8 @@ for it. Until then it behaves as a Strom archive.
281
281
  - the saved mode does not change and the tasks are not parked. Once the agent is installed, the research goes on by
282
282
  itself with the tasks it had;
283
283
  - an agent that is working in the research right now (even one other than the one set) makes it a research.
284
+ - **Why:** an archive is the person's choice and strom does not record it for them. A research without an agent only
285
+ behaves as an archive, so once the agent is installed it goes on by itself with the tasks it had; none is parked.
284
286
  - **Controls:** terminal: the menu, the first item (**Keep it only as a Strom archive: keeping the data from the Strom
285
287
  app**, or installing the agent); `strom mode` shows the state. The app shows such a research as **Archive**
286
288
  ([S1.3](S1-connecting-app-and-research.md#S1.3)).
@@ -397,6 +397,8 @@ it and the search that found it.
397
397
  - a source from a scan gets `--clip` (the crop in which the entry was read), `--transcript` (the words of the entry
398
398
  line by line, what was not read `[?]`) and `--locator` (folio, page, order of the entry); in detail
399
399
  [R3.4](R3-verification-and-citation.md#R3.4);
400
+ - an entry in a language or script other than the language of the research gets, beside the literal
401
+ transcription, a translation into the language of the research (`--translation`), from research 1.28.0;
400
402
  - into the fields (`--date`, `--house`, `--age`, the name) only what was read with certainty. What is uncertain goes
401
403
  into the transcription with `[?]` and into the fact's note ("house 21 or 27"). What a reader reported as illegible
402
404
  stays illegible until the agent reads it itself. An empty column is empty; nothing is filled in by what is usual;
@@ -413,7 +415,7 @@ it and the search that found it.
413
415
  ([A3.3](A3-evidence-in-the-app.md#A3.3)).
414
416
  - **Since:** research 1.0.0; the clip 1.1.0
415
417
 
416
- <!-- zdroj: research:assets/method/recording.md:1-27, :55-65 · assets/method/reading.md:76-84 · assets/method/core.md „Negative results are results“ -->
418
+ <!-- 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) -->
417
419
 
418
420
  <a id="R8.7"></a>
419
421
  ## R8.7 Certainty and verification of what was read
@@ -434,7 +434,8 @@ The steps for a task that waits for images of an archive where the agent may not
434
434
  <a id="R9.10"></a>
435
435
  ## R9.10 Examples
436
436
 
437
- The levels and limits are from the list of archives of the research 1.27.0. The Horák family is made up.
437
+ The levels and limits are from the list of archives of the research 1.27.0, DigiArchiv SOA Třeboň from the research
438
+ 1.28.0. The Horák family is made up.
438
439
 
439
440
  <a id="R9.10.1"></a>
440
441
  ### R9.10.1 Moravský zemský archiv (Acta Publica)
@@ -504,3 +505,22 @@ The levels and limits are from the list of archives of the research 1.27.0. The
504
505
  - **Since:** research 1.27.0
505
506
 
506
507
  <!-- zdroj: research:assets/archives.json szukajwarchiwach.gov.pl (restricted, browserOnly) -->
508
+
509
+ <a id="R9.10.6"></a>
510
+ ### R9.10.6 DigiArchiv SOA Třeboň
511
+
512
+ - Archive: by hand only, only through a person's browser. The terms on DigiArchiv's opening page (`/Uvod`): “Snímky
513
+ jsou poskytnuty pouze za účelem on-line prohlížení v DigiArchivu SOA v Třeboni, jejich kopírování, distribuování,
514
+ prodávání, využití v jiných projektech a na jiných stránkách je zakázáno.” (The images are provided only for online
515
+ viewing in DigiArchiv of SOA Třeboň; copying, distributing, selling and using them in other projects and on other
516
+ sites is forbidden.) The server refuses strom's requests (403), on purpose according to the archive.
517
+ - The archive confirmed: a person may save by hand only selected images, never a whole book or a substantial part of
518
+ it. Download tools are not allowed, nor is the agent's browser.
519
+ - Task: the entry of Marie Horáková in a register in DigiArchiv. The task always waits for images that a person
520
+ selects and saves. Permission does not open it; neither a downloader, a web fetch nor the agent's browser may go
521
+ there.
522
+ - Citation: the permanent link to an image is the address of its page `https://digi.ceskearchivy.cz/<book>/<image>`,
523
+ or **Odkaz na snímek** (link to the image) in the panel **POPIS**.
524
+ - **Since:** research 1.28.0
525
+
526
+ <!-- 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 -->
@@ -163,7 +163,8 @@ B*, *abandoned*, the number of versions and a note. Open ones are expanded.
163
163
  to people in the tree", for a decided one *chosen*, "Now linked for real", "No longer valid: …".
164
164
  - **Which hypotheses the research sends:** open ones; decided and abandoned ones only those whose versions carry
165
165
  links. Withdrawn ones never.
166
- - **Limits:** a hypothesis cannot be decided from the app; it is decided in the research.
166
+ - **Limits:** a hypothesis cannot be decided from the app; a person decides it in the research, in the terminal
167
+ ([R10.3.1](R10-people-and-hypotheses.md#R10.3.1)).
167
168
  - **Controls:** app: the switch **Show** at a version ([S3.5.1](#S3.5.1)).
168
169
  - **Since:** app 3.11.0 with research 1.14.0 (versions, state, **Show**); the list of hypotheses from app 3.4.0
169
170
 
@@ -2,7 +2,7 @@
2
2
  # A1 Aplikacja w skrócie
3
3
 
4
4
  Jak aplikacja Strom działa jako całość, na jednej stronie. Każda sekcja prowadzi do rozdziału z dokładnymi zasadami.
5
- Opisuje aplikację Strom 3.21.2 i badanie 1.25.2.
5
+ Opisuje aplikację Strom 3.21.2 i badanie 1.25.2; zmiany z nowszej wersji mają przy sobie jej numer.
6
6
 
7
7
  <a id="A1.1"></a>
8
8
  ## A1.1 Drzewo genealogiczne w przeglądarce, dane na urządzeniu
@@ -62,3 +62,26 @@ pracę i to, co badanie wie o osobach, a zmiany wysyła z powrotem do badania ([
62
62
  - Połączenie: [S1](S1-connecting-app-and-research.md). Zmiany z aplikacji: [S2](S2-edits-from-the-app.md).
63
63
  Co wie badanie: [S3](S3-what-the-research-knows.md). Badanie sterowane z aplikacji:
64
64
  [S4](S4-research-from-the-app.md). Telefon: [S5](S5-phone.md).
65
+
66
+ <a id="A1.7"></a>
67
+ ## A1.7 Jak działa Strom w aplikacji
68
+
69
+ Ta dokumentacja jest dołączona do aplikacji i czyta się ją także bez internetu. Okno **Jak działa Strom** ma spis
70
+ treści części A, R i S, **Słowniczek pojęć** i wyszukiwanie według słowa lub numeru zasady.
71
+
72
+ - **Granice:**
73
+ - otwarcie okna niczego nie wysyła i niczego nie wczytuje z sieci;
74
+ - numer zasady i Enter przechodzą prosto do zasady (`R4.3`); nieznany numer pokazuje spis treści;
75
+ - odnośniki między zasadami mają **Wstecz**; **W sieci** otwiera tę samą zasadę na stromapp.info;
76
+ - zasada nowsza niż połączone badanie mówi o tym („Badania połączone z tym drzewem mają wersję …, to obowiązuje
77
+ od …”).
78
+ - **Obsługa:** aplikacja: **Akcje → Jak działa Strom**, na telefonie **Więcej → Jak działa Strom** albo **O aplikacji
79
+ → Jak działa Strom**. Kółko **?** w nagłówku otwiera pomoc od razu przy zasadzie: w Przeglądzie badania i małym
80
+ panelu przy sekcjach **Kolejka** ([R2.4](R2-lines-and-queue.md#R2.4)), **Czeka na decyzję** ([R6.4](R6-awaiting-action.md#R6.4))
81
+ i **Teraz** ([R7](R7-when-the-agent-works.md), przy wstrzymaniu [R7.6](R7-when-the-agent-works.md#R7.6)), w oknie **Miejsca** ([R4.5](R4-places.md#R4.5)), w menedżerze miejsc
82
+ ([R4.4](R4-places.md#R4.4)), w panelu sprzeczności ([R5.3](R5-conflicts.md#R5.3)) i w **Co wie badanie → Sprzeczności**
83
+ ([R5.6](R5-conflicts.md#R5.6)). W oknie jest też **Przewodnik po aplikacji**. W badaniu: `strom doc`
84
+ ([R1.8](R1-research-in-brief.md#R1.8)).
85
+ - **Obowiązuje od:** aplikacja 3.24.0
86
+
87
+ <!-- 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) -->
@@ -51,8 +51,12 @@ ustawienie **Moje transkrypcje źródeł** określa, jak traktuje ją badanie
51
51
  - **Obsługa:** edytor źródła, **Więcej: transkrypcja, data zapisu, wiarygodność**; w **Akcje → Źródła** filtr
52
52
  **Transkrypcja niezweryfikowana** (tylko przy drzewie **Udokumentowane** ze starszymi niezweryfikowanymi źródłami).
53
53
  - **Obowiązuje od:** aplikacja 3.9.0
54
+ - **Od aplikacji 3.24.0:** tłumaczenie transkrypcji, które wysłało badanie ([R3.4](R3-verification-and-citation.md#R3.4)),
55
+ jest pod transkrypcją jako zwinięta sekcja **Tłumaczenie transkrypcji**: w podglądzie źródła i na karcie źródła na
56
+ stronie osoby. Notatka źródła się przez to nie zmienia; edytor notatki pokazuje ją całą. Źródło bez tłumaczenia
57
+ wygląda jak wcześniej.
54
58
 
55
- <!-- 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 -->
59
+ <!-- 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 -->
56
60
 
57
61
  <a id="A3.2"></a>
58
62
  ## A3.2 Cytat: co źródło dokumentuje
@@ -2,7 +2,7 @@
2
2
  # A6 Widoki i wybór osób
3
3
 
4
4
  Jak aplikacja Strom wybiera, które osoby pokaże, i jak pokazują je poszczególne widoki. Opisuje aplikację
5
- 3.21.2.
5
+ 3.21.2; zmiany z nowszej wersji mają przy sobie jej numer.
6
6
 
7
7
  Widok to inne odczytanie **tego samego wyboru osób**. Wybór określa osoba w centrum (ta, którą się kliknie)
8
8
  i głębokość **Przodkowie** oraz **Potomkowie**. Rodzina, Potomkowie, Oś czasu i Mapa pokazują to samo otoczenie
@@ -141,12 +141,23 @@ badanie ([R4](R4-places.md)).
141
141
  - przed pierwszym wyszukiwaniem aplikacja pyta (**Odszukać współrzędne online?**). Wychodzą tylko nazwy miejsc,
142
142
  żadne imiona, daty ani relacje. Najwyżej jedno zapytanie mniej więcej na sekundę;
143
143
  - współrzędne zapisują się w drzewie: każde miejsce wyszukuje się raz, a mapa działa potem także bez połączenia;
144
- - automatyczne wyszukiwanie bierze **pierwszy wynik** usługi dla zapisanej nazwy. Miejscowości o tej samej nazwie
145
- przy tym nie rozróżnia: miejsce może więc trafić do miejscowości o tej samej nazwie gdzie indziej. Takie położenie
146
- oznacza potem **Do sprawdzenia** ([R4.4.1](R4-places.md#R4.4.1));
144
+ - automatyczne wyszukiwanie bierze **pierwszy wynik** usługi dla zapisanej nazwy. Do aplikacji 3.23.0 nie
145
+ rozróżniało przy tym miejscowości o tej samej nazwie: miejsce mogło więc trafić do miejscowości o tej samej nazwie
146
+ gdzie indziej. Położenie, które do drzewa nie pasuje, oznacza **Do sprawdzenia** ([R4.4.1](R4-places.md#R4.4.1));
147
147
  - tylko miejsce z numerem domu, którego usługa nie znalazła, wyszukuje się według miejscowości. Spośród miejscowości
148
148
  o tej nazwie wybiera się tę najbliższą innym miejscom drzewa („Miejscowość o tej nazwie występuje kilka razy;
149
149
  wybrano tę najbliższą innym miejscom drzewa.”); przy miejscu stoi **Położenie według miejscowości**;
150
+ - **od aplikacji 3.24.0** najbliższą miejscowość wybiera się przy każdym miejscu: gdy dwie lub więcej miejscowości
151
+ nazywa się dokładnie tak jak zapisane miejsce (bez względu na wielkość liter i znaki diakrytyczne), bierze się tę
152
+ najbliższą środka drzewa, nie pierwszy wynik. Środek to mediana położeń wprowadzonych ręcznie lub potwierdzonych
153
+ **Zachowaj**, gdy jest ich co najmniej 3; w przeciwnym razie mediana wszystkich położeń drzewa i miejsc, które
154
+ wyszukiwanie znalazło bez wątpliwości. Miejsce z dalszym określeniem („Lhota u Kolína”, „Lhota 16”), jedyna
155
+ miejscowość lub drzewo bez położeń dostaje pierwszy wynik jak wcześniej. Nadal jest to jedno zapytanie na miejsce;
156
+ - kontrola miejsca mówi, ile miejscowości o tej nazwie mapa znalazła („Mapa znalazła 3 miejscowości o tej nazwie
157
+ i wybrała tę najbliższą innym miejscom drzewa.”); od aplikacji 3.24.0, wcześniej zawsze „dwie”;
158
+ - położenie, które już jest w drzewie, się nie przesuwa: wyszukiwanie szuka tylko miejsc bez położenia. Także
159
+ scalenie z innym drzewem lub plikiem GEDCOM nie nadpisuje położenia wprowadzonego ręcznie lub potwierdzonego
160
+ **Zachowaj**, tylko uzupełnia brakujące. Złe starsze położenie można przesunąć tylko ręcznie;
150
161
  - czego się nie znajdzie, zostaje bez położenia. Aplikacja niczego nie zgaduje: „pomoże poprawienie zapisu lub
151
162
  dodanie kraju”.
152
163
  - **Obsługa:** aplikacja: **Ustawienia → Wyszukiwanie miejsc online**; w oknie miejsc **Złe miejsce? Popraw**,
@@ -155,9 +166,10 @@ badanie ([R4](R4-places.md)).
155
166
  - **Dlaczego:** wyszukiwanie miejsc to jedyna część aplikacji, która coś wysyła na zewnątrz; dlatego tylko za zgodą,
156
167
  tylko nazwy i każde miejsce raz (komentarz w kodzie). Limit jednego zapytania na sekundę to warunek usługi.
157
168
  - **Obowiązuje od:** aplikacja 1.10.0; **Złe miejsce? Popraw** 1.10.1; **Wyczyść osierocone miejsca** 2.1.0; położenie
158
- według miejscowości 3.21.0
169
+ według miejscowości 3.21.0; najbliższa miejscowość o tej samej nazwie przy każdym miejscu i liczba miejscowości
170
+ w kontroli 3.24.0
159
171
 
160
- <!-- 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 -->
161
173
 
162
174
  <a id="A6.6"></a>
163
175
  ## A6.6 Ród w widoku
@@ -2,7 +2,7 @@
2
2
  # R1 Badanie w skrócie
3
3
 
4
4
  Jak badanie działa jako całość, na jednej stronie. Każda sekcja prowadzi do rozdziału z dokładnymi zasadami. Opisuje
5
- badanie 1.25.2 i aplikację Strom 3.21.2.
5
+ badanie 1.25.2 i aplikację Strom 3.21.2; zmiany z nowszej wersji mają przy sobie jej numer.
6
6
 
7
7
  <a id="R1.1"></a>
8
8
  ## R1.1 Badanie to zapis, nie rozmowa
@@ -53,8 +53,8 @@ Agent pracuje według **Genealogical Proof Standard** (GPS): rzetelne wyszukiwan
53
53
  i porównanie dowodów, rozwiązywanie sprzeczności i spisany wniosek, który zrozumie kolejny badacz.
54
54
 
55
55
  - Każda dana ma stopień pewności: **Wskazówka**, **Możliwe**, **Prawdopodobne**, **Udokumentowane**. Drzewo
56
- genealogiczne i pamięć rodzinna są zawsze tylko wskazówką, indeks służy do odnalezienia wpisu. Szczegółowo:
57
- [R3](R3-verification-and-citation.md).
56
+ genealogiczne, pamięć rodzinna i indeks są zawsze tylko wskazówką: indeks prowadzi do wpisu, dokumentuje dopiero
57
+ sam wpis (indeksu pilnuje kod od badania 1.28.0). Szczegółowo: [R3](R3-verification-and-citation.md).
58
58
  - Imiennik nie jest szukaną osobą. Osobę wyznacza rok, miejsce, dom, zawód, mąż lub żona i rodzice. Dwa akty
59
59
  z tym samym imieniem i innymi rodzicami to dwie osoby. Identyfikacja osób, ich imiona i nazwiska oraz konkurujące
60
60
  hipotezy: [R10](R10-people-and-hypotheses.md).
@@ -63,7 +63,7 @@ i porównanie dowodów, rozwiązywanie sprzeczności i spisany wniosek, który z
63
63
  - Gdy akty się różnią, agent nie wybiera po cichu: zapisuje **sprzeczność**. Szczegółowo: [R5](R5-conflicts.md).
64
64
  - Miejsce dostaje położenie na mapie tylko wtedy, gdy jest pewne, które to miejsce. Szczegółowo: [R4](R4-places.md).
65
65
 
66
- <!-- 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) -->
67
67
 
68
68
  <a id="R1.5"></a>
69
69
  ## R1.5 Co rozstrzyga człowiek
@@ -71,14 +71,16 @@ i porównanie dowodów, rozwiązywanie sprzeczności i spisany wniosek, który z
71
71
  Niektóre decyzje należą tylko do człowieka. Badanie pyta o nie w **Czeka na decyzję**, a agent nie odpowiada za
72
72
  człowieka.
73
73
 
74
- - Co czeka na człowieka (listy, skany do pobrania, pytania o miejsca, sprzeczności, opowieści do zatwierdzenia)
75
- i gdzie się to załatwia: [R6](R6-awaiting-action.md).
74
+ - Co czeka na człowieka (listy, skany do pobrania, pytania o miejsca, sprzeczności, hipotezy, opowieści do
75
+ zatwierdzenia) i gdzie się to załatwia: [R6](R6-awaiting-action.md).
76
+ - Hipotezę rozstrzyga tylko człowiek; agent proponuje rozstrzygnięcie (od badania 1.28.0):
77
+ [R10.3.1](R10-people-and-hypotheses.md#R10.3.1).
76
78
  - Decyzja człowieka obowiązuje. Agent zmienia ją tylko na podstawie nowego źródła: [R5.4](R5-conflicts.md#R5.4).
77
79
  - Położenie miejsca wprowadzone przez człowieka się nie zmienia: [R4.3](R4-places.md#R4.3).
78
80
  - Ustawienia, które zmieniają, co wolno agentowi, potwierdza człowiek (na przykład warunek samodzielnej pracy,
79
81
  [R7](R7-when-the-agent-works.md)).
80
82
 
81
- <!-- 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) -->
82
84
 
83
85
  <a id="R1.6"></a>
84
86
  ## R1.6 Badanie i aplikacja Strom
@@ -103,3 +105,28 @@ najlepiej sprawdzić jeszcze człowiek.
103
105
  - **Obowiązuje od:** badanie 1.0.0
104
106
 
105
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 Jak działa Strom: `strom doc`
111
+
112
+ Ta dokumentacja jest dołączona do badania i czyta się ją także bez internetu. `strom doc` wypisuje spis treści,
113
+ `strom doc R10.1` jedną zasadę razem z zasadami pod nią, a `strom doc <słowa>` szuka w nagłówkach, słowniczku pojęć
114
+ i tekście.
115
+
116
+ - **Granice:**
117
+ - numer można napisać także małymi literami lub z myślnikiem (`r4.3`, `R4-3`). Nieznany numer kończy się błędem,
118
+ który podaje najbliższe numery;
119
+ - wyszukiwanie nie zwraca uwagi na znaki diakrytyczne ani wielkość liter. Pokazuje najwyżej 10 zasad, najlepsze
120
+ pierwsze, i ile jest dalszych (`--limit` inna liczba);
121
+ - tekst jest w języku badania (`--lang` inny). Język, na który dokumentacja nie jest przetłumaczona, dostaje
122
+ angielski z uwagą;
123
+ - przy zasadzie jest odnośnik do tej samej zasady na stromapp.info;
124
+ - działa także poza badaniem i w Archiwum Strom i niczego nie zapisuje.
125
+ - **Tylko metodyka:** na pytanie człowieka, jak lub dlaczego Strom coś robi, agent odpowiada według `strom doc`:
126
+ z numerem zasady i z odnośnikiem, który `strom doc` wypisuje.
127
+ - **Obsługa:** terminal: `strom doc`, `strom doc R2.3`, `strom doc hypotéza --lang en`, `--json`. Pomoc dla
128
+ człowieka (`strom help --human`) kończy się odnośnikiem do `strom doc`. Aplikacja ma tę samą dokumentację w **Jak
129
+ działa Strom** ([A1.7](A1-the-app-in-brief.md#A1.7)).
130
+ - **Obowiązuje od:** badanie 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
  Jak badanie rozpoznaje, że wpis należy do poszukiwanej osoby, co robi z dwoma wpisami jednej osoby, jak prowadzi
5
5
  konkurujące wyjaśnienia (hipotezy) i jak zapisuje imiona i nazwiska oraz osoby, które wpis wymienia. Opisuje badanie
6
- 1.27.0 i aplikację Strom 3.23.0. Przy zasadach rozróżnia się, czego **pilnuje kod**, a co jest tylko **zasadą
6
+ 1.27.0 i aplikację Strom 3.23.0; zmiany z nowszej wersji mają przy sobie jej numer. Przy zasadach rozróżnia się, czego **pilnuje kod**, a co jest tylko **zasadą
7
7
  metodyki**.
8
8
 
9
9
  <a id="R10.1"></a>
@@ -47,6 +47,8 @@ z którą osobą go scalono.
47
47
  (`strom family merge`).
48
48
  - **Tylko metodyka:** osobę z przejętego drzewa genealogicznego, która jest już w badaniu badana, scala się **do**
49
49
  badanej osoby; ta zachowuje swoje dowody ([R11.3](R11-material-from-the-user.md#R11.3)).
50
+ - **Dlaczego:** strom nigdy nie wybiera po cichu między dwiema danymi: która obowiązuje, rozstrzyga dowód. Drugą
51
+ wycofuje się z powodem, więc zostaje widoczne, co gdzie stało.
50
52
  - **Obsługa:** terminal: `strom person merge`, `strom family merge`. Możliwe duplikaty w drzewie zgłasza aplikacja
51
53
  w Kontroli drzewa ([A5.6](A5-tree-check.md#A5.6)).
52
54
  - **Obowiązuje od:** badanie 1.0.0
@@ -79,21 +81,38 @@ nie wybiera po cichu. Zapisuje hipotezę: pytanie i jego wersje A, B, C… z tym
79
81
  <a id="R10.3.1"></a>
80
82
  ### R10.3.1 Rozstrzygnięcie hipotezy
81
83
 
82
- Hipotezę rozstrzyga się na rzecz jednej wersji albo porzuca, gdy żadnej nie da się rozstrzygnąć. Rozstrzyga się
83
- w badaniu; aplikacja nie pozwala rozstrzygnąć hipotezy.
84
+ Hipotezę rozstrzyga się na rzecz jednej wersji albo porzuca, gdy żadnej nie da się rozstrzygnąć. Rozstrzyga tylko
85
+ człowiek, w badaniu; agent proponuje rozstrzygnięcie. Aplikacja nie pozwala rozstrzygnąć hipotezy.
84
86
 
85
87
  - **Pilnuje kod:**
86
- - rozstrzygnięcie wymaga tekstu rozstrzygnięcia (`--decision`); porzucenie to `--abandon`;
87
- - rozstrzygnąć ponownie można tylko z powodem (`--reason`). Poprzednie rozstrzygnięcie zostaje w notatce hipotezy;
88
- - po rozstrzygnięciu strom wypisuje źródła, które hipoteza wymienia, a których nie cytuje żadna dana jej osób: to,
89
- co mówią, należy zapisać przy osobach.
90
- - **Tylko metodyka:** hipotezę, której wersje niosą połączenia, rozstrzyga się z wyborem wersji (`--variant B`).
91
- Rozstrzygniętą hipotezę, którą obali nowy akt, agent rozstrzyga ponownie z powodem. To, co agent wstrzymał, dopóki
92
- osoba była tylko hipotezą, zapisuje przy osobie po rozstrzygnięciu.
93
- - **Obsługa:** terminal: `strom hypothesis decide H… --variant B --decision "…"` (ponownie z `--reason "…"`).
88
+ - rozstrzygnięcie to krok człowieka. Gdy `strom hypothesis decide` uruchomi agent (także wewnątrz `strom batch`),
89
+ strom je odrzuca;
90
+ - agent proponuje rozstrzygnięcie: wersję i tekst rozstrzygnięcia (`strom hypothesis propose`) albo porzucenie
91
+ (`--abandon`). Nowa propozycja zastępuje poprzednią. Na odpowiedź się nie czeka, praca idzie dalej;
92
+ - propozycja czeka w **Co czeka** w grupie **Hipotezy do rozstrzygnięcia** ([R6.3.4](R6-awaiting-action.md#R6.3.4)):
93
+ człowiek rozstrzyga zgodnie z propozycją, inaczej (inna wersja albo żadna, z powodem) albo zostawia hipotezę bez
94
+ zmian. Nieprzyjęta propozycja zostaje w notatce hipotezy;
95
+ - rozstrzygnięcie i propozycja wymagają tekstu rozstrzygnięcia (`--decision`); porzucenie to `--abandon`;
96
+ - hipotezę, której wersje mówią, co by połączyły, rozstrzyga się i proponuje tylko z podaną wersją (`--variant B`).
97
+ Bez niej strom odrzuca i niczego nie zapisuje;
98
+ - rozstrzygnąć ponownie (także ponownie zaproponować) można tylko z powodem (`--reason`). Poprzednie rozstrzygnięcie
99
+ zostaje w notatce hipotezy;
100
+ - to, co łączy rozstrzygnięcie człowieka, oraz źródła, które hipoteza wymienia, a których nie cytuje żadna dana jej
101
+ osób, agent dostaje na początku następnej pracy jako pierwsze zadanie do zapisania w drzewie.
102
+ - **Tylko metodyka:** agent proponuje rozstrzygnięcie, gdy akty wskazują na jedną wersję, i mówi to człowiekowi
103
+ jednym zdaniem. Rozstrzygniętą hipotezę, którą obali nowy akt, agent proponuje ponownie z powodem. To, co agent
104
+ wstrzymał, dopóki osoba była tylko hipotezą, zapisuje przy osobie, gdy człowiek rozstrzygnie hipotezę.
105
+ - **Dlaczego:** nowe rozstrzygnięcie wymaga powodu, bo rozstrzygnięcia zmieniają się jawnie: poprzednie zostaje
106
+ czytelne, a nowe mówi, co je zmieniło (zwykle nowy akt).
107
+ - **Obsługa:** terminal: menu `strom` → **Co czeka** → **Hipotezy do rozstrzygnięcia** → **Rozstrzygnąć zgodnie
108
+ z propozycją**, **Rozstrzygnąć inaczej**, **Zostawić bez zmian (propozycja nieprzyjęta)**; poleceniem
109
+ `strom hypothesis decide H… --proposed`, `--keep-open` albo `--variant B --decision "…"` (ponownie z `--reason "…"`).
110
+ Agent: `strom hypothesis propose H… --variant B --decision "…"`.
94
111
  - **Obowiązuje od:** badanie 1.0.0; wypis niezapisanych źródeł 1.12.0
112
+ - **Od badania 1.28.0:** rozstrzyga tylko człowiek, agent proponuje; podanej wersji pilnuje kod (wcześniej tylko
113
+ metodyka). Hipotezy, które wcześniej rozstrzygnął agent, zostają takie, jakie były.
95
114
 
96
- <!-- 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 -->
97
116
 
98
117
  <a id="R10.4"></a>
99
118
  ## R10.4 Rodzina poza drzewem czeka na udokumentowane powiązanie
@@ -138,6 +157,8 @@ zapisuje się tak, jak stoją w akcie; ujednolica się tylko daty.
138
157
  - osoba, którą słabszy akt nazwał inaczej, zachowuje to imię i nazwisko jako wariant; właściwe oznacza się jako
139
158
  główne. Nic się nie usuwa;
140
159
  - imię i nazwisko odczytane tylko częściowo: [R8.6](R8-reading-scans.md#R8.6).
160
+ - **Dlaczego:** opis zamiast imienia („martwo urodzony syn”) aplikacja i GEDCOM pokazywałyby i wyszukiwały jako
161
+ imię, a parowanie imion brałoby go za imię. To, że dziecko zmarło bez imienia, jest daną (zgon, notatka).
141
162
  - **Obsługa:** terminal: `strom name add P… "Marie /Vlková/" --kind birth --cite S…`, `strom name primary P…
142
163
  "…"` (`--clear` przywraca imię i nazwisko z urodzenia). Formy nazwiska w aplikacji:
143
164
  [A4.5](A4-surnames-and-families.md#A4.5), [A4.6](A4-surnames-and-families.md#A4.6).
@@ -22,12 +22,18 @@ to, co w nim rzeczywiście stoi.
22
22
  odłożone ([R7.8](R7-when-the-agent-works.md#R7.8)).
23
23
  - **Tylko metodyka:** imiona, nazwiska i miejsca zapisuje się tak, jak są napisane; ujednolica się tylko daty. Zadanie
24
24
  zamyka się z tym, co z materiału wynikło, i z kolejnymi zadaniami: gdzie szukać aktów, które udokumentują wskazówki.
25
+ - **Dlaczego:**
26
+ - 20 obrazów: skany księgi metrykalnej nie należą do historii drzewa jako setki zadań materiały. Dokumenty rodzinne
27
+ jednego folderu to zwykle od kilku do kilkudziesięciu plików; więcej niż 20 obrazów to zwykle skany księgi
28
+ i zapisuje się je jako księgę;
29
+ - 20 MB: historii drzewa nigdy się nie przepisuje i idzie ona z drzewem przy kopii zapasowej i przeniesieniu. Duże
30
+ pliki (wideo, nieskompresowane skany) powiększyłyby ją na trwałe, dlatego leżą we wspólnym magazynie mediów.
25
31
  - **Obsługa:** terminal: `strom intake <soubory nebo složky>`, `strom intake --text "…"` (to, co powie użytkownik),
26
32
  `strom input list`, `strom input show I…`. Aplikacja: **Wyślij materiał…**, **Dodaj materiały…**
27
33
  ([A3.5](A3-evidence-in-the-app.md#A3.5)).
28
34
  - **Obowiązuje od:** badanie 1.0.0
29
35
 
30
- <!-- 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 -->
36
+ <!-- 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 -->
31
37
 
32
38
  <a id="R11.2"></a>
33
39
  ## R11.2 Dokument jest źródłem, reszta jest wskazówką
@@ -79,7 +85,8 @@ Folder, ZIP albo pudło dokumentów wysłane z aplikacji badanie przyjmuje jako
79
85
  na zadania.
80
86
 
81
87
  - **Pilnuje kod:**
82
- - partia zamyka się, gdy aplikacja zgłosi, że jest kompletna, albo dzień po ostatnim pliku;
88
+ - partia zamyka się, gdy aplikacja zgłosi, że jest kompletna, albo dzień po ostatnim pliku (partia
89
+ z telefonu godzinę po ostatnim zdjęciu, [S5.4](S5-phone.md#S5.4));
83
90
  - potem powstają z niej zadania materiały po mniej więcej 25 plików, według folderów, w których pliki przyszły.
84
91
  W Archiwum Strom zadania czekają odłożone;
85
92
  - pliki partii zapisuje się jako oryginały we wspólnym magazynie mediów, nie w historii drzewa. Czego agent z nich
@@ -93,10 +100,15 @@ na zadania.
93
100
  - skanów jednej księgi (wiele numerowanych skanów) nie czyta się plik po pliku: zapisuje się je jako księgę i czyta
94
101
  się z niej wpisy jak z każdej księgi ([R8](R8-reading-scans.md));
95
102
  - zadanie zamyka się, gdy każdy jego plik jest sklasyfikowany; kolejna część partii to osobne zadanie.
96
- - **Dlaczego:** ścieżka pliku w partii wiele mówi (`Babička/Dopisy/1946.jpg`); to, co do rodziny nie należy, nie
97
- powinno trafić do drzewa (metodyka).
103
+ - **Dlaczego:**
104
+ - dzień po ostatnim pliku: aplikacja wysyła pliki pojedynczo. Partia, o której nikt nie powiedział, że jest
105
+ kompletna, zamyka się z tym, co przyszło, żeby nic nie czekało dłużej; dzień bez kolejnego pliku oznacza, że
106
+ wysyłanie się skończyło. Stronę w telefonie łatwo zamknąć bez przekazania partii, dlatego tam wystarczy godzina;
107
+ - 25 plików: jedno zadanie materiały czyta jedna sesja agenta i mieści się w niej mniej więcej 25 plików;
108
+ - ścieżka pliku w partii wiele mówi (`Babička/Dopisy/1946.jpg`); to, co do rodziny nie należy, nie powinno trafić
109
+ do drzewa (metodyka).
98
110
  - **Obsługa:** terminal: `strom input batch` (partie i ile z nich posortowano), `strom input sort I… --as
99
111
  source|document|photo|unrelated --person P…`. Aplikacja: **Dodaj materiały…** w menu badania.
100
- - **Obowiązuje od:** badanie 1.12.0
112
+ - **Obowiązuje od:** badanie 1.12.0; partia z telefonu 1.18.0
101
113
 
102
- <!-- 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" -->
114
+ <!-- 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" -->