strom-research 1.28.0-beta.1 → 1.28.0-beta.2

package/CHANGELOG.cs.md

@@ -7,7 +7,7 @@ Změny každé verze ve zkratce. Úplné poznámky a instalační řádky jsou n
 
 ## 1.28.0
 
-*Připravuje se: bety do 1.28.0-beta.1. Oddíl bude úplný s vydáním.*
+*Připravuje se: bety do 1.28.0-beta.2. Oddíl bude úplný s vydáním.*
 
 - **Jak Strom funguje je přímo ve stromu: `strom doc`.** Dokumentace aplikace a výzkumu v češtině, angličtině, němčině
   a polštině je součástí stromu a čte se i bez internetu: `strom doc` vypíše kapitoly, `strom doc R10.1` jedno pravidlo
@@ -26,6 +26,10 @@ Změny každé verze ve zkratce. Úplné poznámky a instalační řádky jsou n
 - **Překlad vedle přepisu.** Záznam v jiném jazyce nebo písmu, než je jazyk výzkumu – latina, kurent, polština,
   azbuka –, dostane vedle doslovného přepisu i překlad do jazyka výzkumu.
 
+- **Kde agent pracuje, pro mapu aplikace Strom.** Během práce agenta strom aplikaci říká, ke kterému místu patří kniha,
+  kterou agent zkoumá – farnost nebo obec jejích zápisů, nikdy archiv –, aby ho aplikace při sledování práce mohla
+  ukázat na mapě. Když to výzkum neví, nic neříká a aplikace zůstane u míst osoby.
+
 - **DigiArchiv SOA v Třeboni:** podmínky, jak je archiv potvrdil – ručně jen vybrané snímky, nikdy celá kniha, žádné
   nástroje ke stahování – a jak citovat trvalý odkaz na snímek.
 

package/CHANGELOG.de.md

@@ -7,7 +7,7 @@ Die Änderungen jeder Version in Kürze. Die vollständigen Hinweise und die Ins
 
 ## 1.28.0
 
-*In Vorbereitung: die Betas bis 1.28.0-beta.1. Der Abschnitt ist mit dem Release vollständig.*
+*In Vorbereitung: die Betas bis 1.28.0-beta.2. Der Abschnitt ist mit dem Release vollständig.*
 
 - **Wie Strom funktioniert gehört zu strom: `strom doc`.** Die Dokumentation der App und der Forschung auf Tschechisch,
   Englisch, Deutsch und Polnisch ist Teil von strom und liest sich auch ohne Internet: `strom doc` listet die Kapitel,
@@ -29,6 +29,11 @@ Die Änderungen jeder Version in Kürze. Die vollständigen Hinweise und die Ins
   Latein, Kurrent, Polnisch, Kyrillisch – bekommt neben der wörtlichen Abschrift eine Übersetzung in die Sprache der
   Forschung.
 
+- **Wo der Agent arbeitet, für die Karte der Strom-App.** Während ein Agent arbeitet, sagt strom der App, zu welchem
+  Ort das Buch gehört, das er untersucht – die Pfarrei oder das Dorf seiner Einträge, nie das Archiv –, damit die App
+  ihn beim Verfolgen der Arbeit auf der Karte zeigen kann. Weiß die Forschung es nicht, sagt sie nichts, und die App
+  bleibt bei den Orten der Person.
+
 - **DigiArchiv des Staatlichen Gebietsarchivs Třeboň:** seine Bedingungen, wie das Archiv sie bestätigt hat – von Hand
   nur ausgewählte Bilder, nie ein ganzes Buch, keine Download-Werkzeuge – und wie der dauerhafte Link eines Bildes
   zitiert wird.

package/CHANGELOG.md

@@ -7,7 +7,7 @@ The changes of each version in short. The full notes and the install lines are o
 
 ## 1.28.0
 
-*In preparation: the betas up to 1.28.0-beta.1. The section is complete with the release.*
+*In preparation: the betas up to 1.28.0-beta.2. The section is complete with the release.*
 
 - **How Strom works comes with strom: `strom doc`.** The documentation of the app and the research, in Czech, English,
   German and Polish, is part of strom and reads offline: `strom doc` lists its chapters, `strom doc R10.1` shows one rule
@@ -27,6 +27,11 @@ The changes of each version in short. The full notes and the install lines are o
 - **A translation beside the transcript.** A record in another language or script than the research's – Latin, German
   Kurrent, Polish, Cyrillic – gets a translation into the research's language beside its word-for-word transcript.
 
+- **Where the agent works, for the map of the Strom app.** While an agent works, strom tells the app which place the
+  book it examines belongs to – the parish or village of its records, never the archive – so the app can show it on the
+  map when following the work. When the research does not know it, it says nothing, and the app keeps to the person's
+  own places.
+
 - **DigiArchiv of the regional archive in Třeboň:** its terms as the archive confirmed them – selected images saved by
   hand only, never a whole book, no download tools – and how to cite an image's permanent link.
 

package/CHANGELOG.pl.md

@@ -7,7 +7,7 @@ Zmiany każdej wersji w skrócie. Pełne informacje o wydaniach i polecenia inst
 
 ## 1.28.0
 
-*W przygotowaniu: bety do 1.28.0-beta.1. Sekcja będzie kompletna z wydaniem.*
+*W przygotowaniu: bety do 1.28.0-beta.2. Sekcja będzie kompletna z wydaniem.*
 
 - **Jak działa Strom – w samym stromie: `strom doc`.** Dokumentacja aplikacji i badań po czesku, angielsku, niemiecku i
   polsku jest częścią stromu i czyta się ją także bez internetu: `strom doc` wypisuje rozdziały, `strom doc R10.1` jedną
@@ -28,6 +28,11 @@ Zmiany każdej wersji w skrócie. Pełne informacje o wydaniach i polecenia inst
 - **Tłumaczenie obok transkrypcji.** Wpis w innym języku lub piśmie niż język badań – łacina, kurrenta, niemiecki,
   cyrylica – otrzymuje obok dosłownej transkrypcji tłumaczenie na język badań.
 
+- **Gdzie pracuje agent – dla mapy aplikacji Strom.** Podczas pracy agenta strom podaje aplikacji, do którego miejsca
+  należy księga, którą agent bada – parafia lub wieś jej wpisów, nigdy archiwum – aby aplikacja mogła je pokazać na
+  mapie podczas śledzenia pracy. Gdy badania tego nie wiedzą, nic nie podają, a aplikacja pozostaje przy miejscach
+  osoby.
+
 - **DigiArchiv Archiwum Państwowego w Třeboniu:** jego warunki, tak jak potwierdziło je archiwum – ręcznie tylko wybrane
   skany, nigdy cała księga, żadnych narzędzi do pobierania – i jak cytować stały link do skanu.
 

package/dist/core/live.js

@@ -12,7 +12,9 @@
 //                          Made once for a state of the research on a thread of its own (core/livestatus.ts) and
 //                          answered from it while the state lasts. ?parts=1 (feature status.parts): without the parts
 //                          that weigh (waiting; queue, queueMore, queueCounts; offLine; researches), with parts {name:
-//                          rev} instead — the same rev, the same part.
+//                          rev} instead — the same rev, the same part. Each of working (who is at work; the event
+//                          working too): the place record (L…) of the book the agent examines, when the research knows
+//                          it (place, core/workplace.ts; none: not known) — feature working.place.
 //   GET <token>/status/<part>  one of those parts: {part, rev, head, …its fields as /status carries them}; 404
 //                          status.part for another name.
 //                          A queue item off the lines of a research with several (core/offline.ts) says offLine:
@@ -299,6 +301,7 @@
 // new secret. Nothing is replaced on a timer.
 import { browserState, treeBrowserArchives } from "./browserhelp.js";
 import { opsLogsOf } from "./opslog.js";
+import { placeOfWork } from "./workplace.js";
 import { notDownloaded } from "./integrity.js";
 import fs from "node:fs";
 import os from "node:os";
@@ -1122,7 +1125,7 @@ function idsOf(applied, known) {
     return Object.keys(ids.persons).length || Object.keys(ids.sources).length ? { ids } : {};
 }
 /** What the bridge does that an app may ask about (each added once, never taken away). */
-export const BRIDGE_FEATURES = ["sync.again", "sync.undoneSince", "sync.takenBack", "sync.conflictEdit", "sync.since", "sync.ids", "family.noCouple", "family.alone", "adopt.transfer", "adopt.empty", "material.list", "person.titles", "media.codes", "hypothesis.links", "status.recent", "spend.readers", "hypothesis.intree", "archive.permission", "task.check", "waiting.groups", "waiting.sent", "waiting.note", "batch.kept", "live.end", "whats.new", "terminal.choice", "person.marriedSurname", "phone", "read.now", "read.sync", "excerpt.get", "log.sources", "material.assign", "material.thumb", "seal.foreign", "tree.state", "disk.full", "tree.notDownloaded", "sync.removed", "tree.kind", "experiments", "experiments.off", "experiments.link", "experiments.split", "history.events", "history.hide", "experiments.pace", "history.first", "history.regions", "history.hide.all", "history.skip", "history.map", "history.delete", "history.delete.restore", "stories.history", "history.place", "surnames.suggest", "surnames.read", "lineage.read", "duplicates.judge", "quality.dismiss", "quality.read", "person.primary", "fixes.list", "fixes.towns", "history.back", "places.identify", "places.answer", "places.undo", "tasks.offLine", "status.busy", "history.kinds", "history.align", "places.nameKinds", "directions.edit", "directions.order", "directions.found", "directions.people", "offLine.branches", "queue.own", "story.sources", "queue.page", "status.parts", "waiting.answer", "browser.state"];
+export const BRIDGE_FEATURES = ["sync.again", "sync.undoneSince", "sync.takenBack", "sync.conflictEdit", "sync.since", "sync.ids", "family.noCouple", "family.alone", "adopt.transfer", "adopt.empty", "material.list", "person.titles", "media.codes", "hypothesis.links", "status.recent", "spend.readers", "hypothesis.intree", "archive.permission", "task.check", "waiting.groups", "waiting.sent", "waiting.note", "batch.kept", "live.end", "whats.new", "terminal.choice", "person.marriedSurname", "phone", "read.now", "read.sync", "excerpt.get", "log.sources", "material.assign", "material.thumb", "seal.foreign", "tree.state", "disk.full", "tree.notDownloaded", "sync.removed", "tree.kind", "experiments", "experiments.off", "experiments.link", "experiments.split", "history.events", "history.hide", "experiments.pace", "history.first", "history.regions", "history.hide.all", "history.skip", "history.map", "history.delete", "history.delete.restore", "stories.history", "history.place", "surnames.suggest", "surnames.read", "lineage.read", "duplicates.judge", "quality.dismiss", "quality.read", "person.primary", "fixes.list", "fixes.towns", "history.back", "places.identify", "places.answer", "places.undo", "tasks.offLine", "status.busy", "history.kinds", "history.align", "places.nameKinds", "directions.edit", "directions.order", "directions.found", "directions.people", "offLine.branches", "queue.own", "story.sources", "queue.page", "status.parts", "waiting.answer", "browser.state", "working.place"];
 /** /status busy: how many sessions and runs work now. */
 function busyOf(tree) {
     const b = busyIn(tree);
@@ -1339,31 +1342,38 @@ export function whoAtWork(label, lang) {
  * The person an agent works on, for the app to follow it in the tree: the first person its task is about (a marriage
  * names both, the one it asks about first), else the last one its session wrote about.
  */
-function workedOn(root, tree, s, task) {
+function workedOn(tree, ops, task) {
     const known = (id) => /^P\d{1,7}$/.test(id) && tree.get(id) !== undefined;
     const first = (task?.subject ?? []).find(known);
     if (first)
         return { person: first };
+    for (let i = ops.length - 1; i >= 0; i--) {
+        const person = (ops[i].targets ?? []).findLast(known);
+        if (person)
+            return { person };
+    }
+    return {};
+}
+/** What a session wrote, in its order (a line being written, or a log not readable: left out). */
+function sessionOps(root, s) {
     let lines = [];
     try {
         lines = opsLogsOf(path.join(root, "data"), s.id).flatMap((file) => fs.readFileSync(file, "utf8").split("\n"));
     }
     catch {
-        return {};
+        return [];
     }
-    for (let i = lines.length - 1; i >= 0; i--) {
-        let op;
+    const ops = [];
+    for (const line of lines) {
         try {
-            op = JSON.parse(lines[i]);
+            if (line.trim())
+                ops.push(JSON.parse(line));
         }
         catch {
-            continue; // empty, or a line being written
+            // a line being written
         }
-        const person = (op.targets ?? []).findLast(known);
-        if (person)
-            return { person };
     }
-    return {};
+    return ops;
 }
 /** Who is at work now, on which task (an agent strom started, and its open session). */
 function working(root, tree, all) {
@@ -1378,11 +1388,16 @@ function working(root, tree, all) {
             who: whoAtWork(w.label, tree.lang),
             since: w.since,
             ...(w.paused ? { paused: w.paused } : {}),
-            ...(s ? { session: s.id, ...(s.task ? { task: task ? taskTitle(tree, task) : s.task } : {}), ...workedOn(root, tree, s, task) } : {}),
+            ...(s ? { session: s.id, ...(s.task ? { task: task ? taskTitle(tree, task) : s.task } : {}), ...worked(tree, sessionOps(root, s), task) } : {}),
             ...(research ? { research } : {}),
         };
     });
 }
+/** The person and the place (L…, core/workplace.ts) an agent works on, from what its session wrote and its task. */
+function worked(tree, ops, task) {
+    const place = placeOfWork(tree, ops, task);
+    return { ...workedOn(tree, ops, task), ...(place ? { place } : {}) };
+}
 /** The direction a session worked on: its own, else its task's. */
 function sessionResearch(tree, s, all) {
     if (s.research)

package/dist/core/tree.js

@@ -31,7 +31,7 @@ export const TREE_FILE = "strom.json";
 export const SEAL_FOREIGN = "seal.foreign";
 // between releases the candidate being made (a bridge run from the sources says what it is: the Strom app goes by it);
 // at a release the release's own (package.json)
-export const VERSION = "1.28.0-beta.1";
+export const VERSION = "1.28.0-beta.2";
 const GITIGNORE = `# Strom Research — local state and large files are not versioned
 .strom/
 /media/

package/dist/core/workplace.js

@@ -0,0 +1,69 @@
+// Where an agent works now, for the Strom app's map while it follows the work (the bridge's working[].place, feature
+// working.place): the place record (L…) of the book the agent examines — the parish or the village of its records,
+// never an archive. Only what the agent wrote through strom tells it, nothing guessed: the newest record of its work the
+// session wrote (an image fetched, a source, a search, a book) decides alone — its book's place, none when its book is
+// unsure (a search in several books of several places, a source of no book: the web); before any, the books its task
+// names. What it writes of people from a record (a fact, a citation) keeps the place of that record.
+// A book is a place's when the place lists it among its records (strom place jurisdiction --recordset), else when one
+// place record alone bears the name of the first place the book covers. Unsure (no such place, several of one name,
+// the task's books in several places): none — the app shows the person's places then.
+import { foldText } from "./text.js";
+/** The place record (L…) of the book the agent examines now, when the research knows it. */
+export function placeOfWork(tree, ops, task) {
+    // the newest record of its work the session wrote decides alone: its book's place, or none — never an older book's
+    for (let i = ops.length - 1; i >= 0; i--) {
+        const main = ops[i].targets?.[0];
+        if (main && /^[BMSQ]\d+$/.test(main))
+            return placeOfRecord(tree, main);
+    }
+    // nothing written yet: the books its task names, when they are all of one place
+    return placeOfBooks(tree, (task?.where ?? []).map((w) => w.trim()));
+}
+/** The place of the books named, when they are all of one known place. */
+function placeOfBooks(tree, ids) {
+    const books = ids.map((id) => tree.get(id)).filter((b) => b?.type === "recordset" && !b.retracted);
+    const places = new Set(books.map((b) => placeOfBook(tree, b)));
+    return places.size === 1 ? [...places][0] : undefined;
+}
+/** The place of a record of work: of its book, of the books of a search when all of one place; none when unsure. */
+function placeOfRecord(tree, id) {
+    if (/^Q\d+$/.test(id)) {
+        const q = tree.get(id);
+        return q && !q.retracted ? placeOfBooks(tree, q.recordsets) : undefined;
+    }
+    const book = bookOf(tree, id);
+    return book ? placeOfBook(tree, book) : undefined;
+}
+/** The book a record is of: a book itself, an image of it, a source from it. */
+function bookOf(tree, id) {
+    const book = (b) => {
+        const r = b ? tree.get(b) : undefined;
+        return r?.type === "recordset" && !r.retracted ? r : undefined;
+    };
+    if (/^B\d+$/.test(id))
+        return book(id);
+    if (/^M\d+$/.test(id)) {
+        const m = tree.get(id);
+        return m && !m.retracted ? book(m.recordset) : undefined;
+    }
+    if (/^S\d+$/.test(id)) {
+        const s = tree.get(id);
+        if (!s || s.retracted)
+            return undefined;
+        return book(s.recordset) ?? book((s.media ?? []).map((m) => tree.get(m)?.recordset).find(Boolean));
+    }
+    return undefined;
+}
+/** The place record of a book: the one listing it among its records, else the one alone of the name of its first place. */
+function placeOfBook(tree, book) {
+    const places = tree.list("place").filter((p) => !p.retracted);
+    const listing = places.filter((p) => p.jurisdictions.some((j) => (j.recordsets ?? []).includes(book.id)));
+    if (listing.length === 1)
+        return listing[0].id;
+    const first = book.places[0]?.trim();
+    if (!first)
+        return undefined;
+    const name = foldText(first);
+    const named = (listing.length ? listing : places).filter((p) => p.names.some((n) => foldText(n.name) === name));
+    return named.length === 1 ? named[0].id : undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strom-research",
-  "version": "1.28.0-beta.1",
+  "version": "1.28.0-beta.2",
   "stromDoc": "885249f43ea2f346c667b3f0ead9f8bba950f23f",
   "description": "Genealogical research toolkit for AI coding agents",
   "type": "module",