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
|
@@ -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:**
|
|
98
|
-
|
|
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`)
|
|
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
|
|
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
|
|
97
|
-
never Probable or Proven ([R3.2](#R3.2)). A
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
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
|
|
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 --
|
|
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))
|
|
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
|
|
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
|
|
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.
|
|
145
|
-
przy tym
|
|
146
|
-
oznacza
|
|
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
|
|
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
|
|
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
|
|
83
|
-
w badaniu;
|
|
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
|
|
87
|
-
|
|
88
|
-
-
|
|
89
|
-
|
|
90
|
-
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
-
|
|
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 (
|
|
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:**
|
|
97
|
-
|
|
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" -->
|