strom-research 1.0.0 → 1.1.0

package/dist/commands/setup.js

@@ -17,7 +17,7 @@ import { agentsHere, DESKTOP_APPS, inDesktopApp, whereToTalk } from "../core/app
 import { setupWizard } from "../cli/wizard.js";
 import { installation, stromLauncher } from "../core/self.js";
 import { VERSION } from "../core/tree.js";
-import { installUpdate, isNewer, knownNewerVersion, latestVersion, newerVersion } from "../core/update.js";
+import { installUpdate, isNewer, knownNewerVersion, latestVersion, newerNode, newerVersion } from "../core/update.js";
 import { desktopDir } from "../core/paths.js";
 import { researchUrl, stromAppUrl, stromAppState } from "../core/stromapp.js";
 import { isInstalled } from "../agents/global.js";
@@ -189,7 +189,7 @@ function diagnose(ctx) {
     }
     // For a person: the shortcut on the desktop, the Strom app.
     const desktop = desktopDir(ctx.env);
-    const shortcut = [`${shortcutName(lang)}.command`, `${shortcutName(lang)}.cmd`, "strom-research.desktop"].some((f) => fs.existsSync(path.join(desktop, f)));
+    const shortcut = [`${shortcutName(lang)}.command`, `${shortcutName(lang)}.lnk`, `${shortcutName(lang)}.cmd`, "strom-research.desktop"].some((f) => fs.existsSync(path.join(desktop, f)));
     if (shortcut)
         add("shortcut", "ok", t("ui.doc.yes"));
     else
@@ -229,7 +229,7 @@ async function repair(ctx, checks, out) {
             out(ui(lang, "ui.setup.shortcut.done", { file: ctx.display(f) }));
     }
     if (todo.has("app") && person && (await ctx.confirm(ui(lang, "ui.fix.app"), false))) {
-        openForUser(stromAppUrl(ctx.env), ctx.env);
+        openForUser(stromAppUrl(ctx.settings), ctx.env);
         out(ui(lang, "ui.app.install"));
     }
 }
@@ -277,14 +277,18 @@ register({
             throw new StromError(t("ui.update.unknown"), { hint: "check the network — or run the installer again" });
         ctx.settings.config.updateCheck = { at: new Date().toISOString(), latest: newest };
         ctx.settings.save();
-        if (!isNewer(newest, VERSION))
+        const inst = installation();
+        // The installer's Node: the newest release of its line (security fixes) is taken along.
+        const node = inst.kind === "installed" ? await newerNode(ctx.env, inst.node).catch(() => undefined) : undefined;
+        const newer = isNewer(newest, VERSION);
+        if (!newer && !node)
             return { text: t("ui.update.current", { version: VERSION }), data: { current: VERSION, latest: newest, newer: false } };
+        const nodeLine = node ? t("ui.update.node.available", { from: inst.node ?? "?", to: node.version }) : undefined;
         if (opts.check)
-            return { text: t("ui.update.available", { version: newest, current: VERSION }), data: { current: VERSION, latest: newest, newer: true } };
-        const inst = installation();
+            return { text: lines(newer ? t("ui.update.available", { version: newest, current: VERSION }) : undefined, nodeLine), data: { current: VERSION, latest: newest, newer, ...(node ? { node: node.version } : {}) } };
         if (inst.kind !== "installed")
             return { text: t(inst.kind === "npm" ? "ui.update.npm" : "ui.update.source", { version: newest }), data: { current: VERSION, latest: newest, newer: true, npm: inst.kind === "npm" } };
-        const question = t("ui.update.sure", { version: newest, current: VERSION });
+        const question = newer ? t("ui.update.sure", { version: newest, current: VERSION }) : t("ui.update.node.sure", { from: inst.node ?? "?", to: node.version });
         if (isAgent(ctx.env) || !ctx.yes) {
             if (!isAgent(ctx.env) && ctx.interactive) {
                 if (!(await ctx.confirm(question, true)))
@@ -295,9 +299,9 @@ register({
         }
         if (ctx.interactive)
             ctx.io.stdout(`${t("ui.update.downloading", { version: newest })}\n`);
-        let version;
+        let done;
         try {
-            version = await installUpdate(ctx.env, inst.root);
+            done = await installUpdate(ctx.env, inst.root);
         }
         catch (e) {
             throw new StromError(t("ui.update.failed", { detail: e.message }), { hint: "strom update — or run the installer again" });
@@ -305,7 +309,10 @@ register({
         // The agents learn what the new version tells them.
         const { command, args } = stromLauncher();
         spawnSync(command, [...args, "agents", "install"], { stdio: "ignore", env: ctx.env, windowsHide: true });
-        return { text: t("ui.update.done", { version, previous: VERSION }), data: { previous: VERSION, version, updated: true } };
+        return {
+            text: lines(newer ? t("ui.update.done", { version: done.version, previous: VERSION }) : undefined, done.node ? t("ui.update.node.done", done.node) : undefined),
+            data: { previous: VERSION, version: done.version, updated: true, ...(done.node ? { node: done.node } : {}) },
+        };
     },
 });
 function display(ctx, def, value) {

package/dist/commands/sources.js

@@ -1,4 +1,5 @@
 // source · cite · repo · recordset · place — where the evidence comes from.
+import { OFF_MAP_HOW, offMapLine, placesOffMap } from "../core/places.js";
 import fs from "node:fs";
 import { commands, register } from "../cli/registry.js";
 import { lines, moreLine, paginate, table, truncate } from "../cli/format.js";
@@ -8,7 +9,8 @@ import { create, csvOpt, listOpt, normId, requireRecord, textOpt, update } from
 import { makeNote, parseDate } from "../core/actions.js";
 import { calibrationLine, fitCalibration } from "../core/calibration.js";
 import { foldText } from "../core/text.js";
-import { imageOfRef } from "../core/media.js";
+import { clipNote, clipText, imageOfRef, MAX_CLIPS, transcriptNote } from "../core/media.js";
+import { partRegion } from "../core/views.js";
 import { formatName } from "../core/people.js";
 function written(tree) {
     return lines(...tree.written.map((o) => o.summary), tree.dryRun ? "(dry run — nothing written)" : undefined);
@@ -40,6 +42,26 @@ function mediaRefs(tree, refs) {
         return m.id;
     });
 }
+/**
+ * Where the entry is on an image, as its view was cut: "M0012@0.05,0.4,0.45,0.18", "B0001:57@left:0.1,0.4,0.8,0.1"
+ * (a half, then a crop within it), pixels of the registered image, or "M0012" alone (the entry is the whole image).
+ */
+function clipRefs(tree, specs) {
+    return specs.map((spec) => {
+        const m = /^([^@]+?)(?:@(.+))?$/.exec(spec.trim()) ?? [];
+        let [ref, where] = [m[1] ?? "", m[2]];
+        // "M0012:0.1,0.2,0.3,0.1" — the colon of a record set's image number stays hers
+        const colon = !where && /^([Mm]\d+):(.+)$/.exec(ref);
+        if (colon)
+            [ref, where] = [colon[1], colon[2]];
+        const media = mediaRefs(tree, [ref])[0];
+        if (!where)
+            return { media, region: { x: 0, y: 0, w: 1, h: 1 } };
+        const w = /^(?:(left|right|top|bottom)(?::|$))?(.*)$/.exec(where.trim());
+        const region = partRegion({ half: w[1], crop: w[2] || undefined }, tree.get(media));
+        return { media, region };
+    });
+}
 /** "Teinitz an der Elbe@de:1850-1918" → another name of a place. */
 function altName(a) {
     const m = /^(.+?)(?:@([a-z]{2,3}))?(?::(\d{3,4})?-(\d{3,4})?)?$/.exec(a);
@@ -113,10 +135,17 @@ register({
         { name: "form", type: "string", value: "<form>", description: "original (default), derivative (copy, index — the default for --kind index and in a record set of kind index only), authored (compiled work)" },
         { name: "url", type: "string", value: "<url>", description: "link to the image or catalog entry" },
         { name: "media", type: "string", multiple: true, value: "<M…|B…:n>", description: "the registered image(s) the record is on (repeatable)" },
+        {
+            name: "clip",
+            type: "string",
+            multiple: true,
+            value: "<M…@x,y,w,h>",
+            description: "where the entry itself is on its image — the crop you read it in (the view prints it); a second one when it runs over a page break",
+        },
         { name: "note", type: "string", value: "<text>", description: "short note" },
     ],
     examples: [
-        'strom source add "Křest Jana Nováka 1905" --kind baptism --recordset B0001 --locator "fol. 45, č. 12" --language la --information primary --transcript @zapis.txt',
+        'strom source add "Křest Jana Nováka 1905" --kind baptism --recordset B0001 --locator "fol. 45, č. 12" --language la --information primary --transcript @zapis.txt --clip B0001:2@0.05,0.40,0.45,0.18',
         'strom source add "Rodinný strom od tety Marie" --kind family-tree --form authored --input I0001',
     ],
     run(ctx, { args, opts }) {
@@ -126,7 +155,10 @@ register({
             requireRecord(tree, opts.repo, "repository");
         if (opts.input)
             requireRecord(tree, opts.input, "input");
-        const media = mediaRefs(tree, csvOpt(opts.media));
+        const clips = clipRefs(tree, listOpt(opts.clip));
+        if (clips.length > MAX_CLIPS)
+            throw new UsageError(`at most ${MAX_CLIPS} clips: an entry, and its continuation over a page break`);
+        const media = [...new Set([...mediaRefs(tree, csvOpt(opts.media)), ...clips.map((c) => c.media)])];
         // a line of an index is a copy made by another hand; a book with its own index holds originals too
         const kind = oneOf(opts.kind, SOURCE_KINDS, "kind", "other");
         const form = kind === "index" || (book && book.kinds.length > 0 && book.kinds.every((k) => k === "index")) ? "derivative" : "original";
@@ -146,9 +178,10 @@ register({
             url: str(opts.url),
             accessed: str(opts.url) ? new Date().toISOString().slice(0, 10) : undefined,
             ...(media.length ? { media } : {}),
+            ...(clips.length ? { clips } : {}),
             note: str(opts.note),
         }, (id) => `+${id} source "${truncate(args[0], 60)}"${media.length ? ` on ${media.join(" ")}` : ""}`, media);
-        return { text: lines(written(tree), "", `cite it: strom cite <event> ${src.id} --locator "…"`), data: { source: src } };
+        return { text: lines(written(tree), clipNote(tree, src), transcriptNote(tree, src), "", `cite it: strom cite <event> ${src.id} --locator "…"`), data: { source: src } };
     },
 }, {
     path: ["source", "list"],
@@ -207,7 +240,7 @@ register({
                     if (c.source === s.id)
                         citing.push(`${f.id} ${e.id} ${e.kind}${at(c)}`);
         }
-        const text = lines(`${s.id} ${s.title}`, `kind ${s.kind} · ${s.form} · information ${s.information}${s.language ? ` · language ${s.language}` : ""}${s.date ? ` · dated ${s.date}` : ""}`, s.recordset || s.repository ? `in     ${[s.recordset, s.repository].filter(Boolean).join(" · ")}${s.locator ? ` · ${s.locator}` : ""}` : s.locator ? `at     ${s.locator}` : undefined, s.url ? `url    ${s.url}` : undefined, s.media?.length ? `images ${s.media.map((id) => { const m = tree.get(id); return m ? `${id}${m.recordset ? ` (${m.recordset}:${m.image ?? "?"})` : ""}` : id; }).join(" · ")} — strom media view <M…>` : undefined, s.transcript ? `\ntranscript\n${s.transcript}` : undefined, s.translation ? `\ntranslation\n${s.translation}` : undefined, citing.length ? `\ncited by\n${citing.map((c) => `  ${c}`).join("\n")}` : "\ncited by nothing yet", ...s.notes.map((n) => `note   ${n.text}`));
+        const text = lines(`${s.id} ${s.title}`, `kind ${s.kind} · ${s.form} · information ${s.information}${s.language ? ` · language ${s.language}` : ""}${s.date ? ` · dated ${s.date}` : ""}`, s.recordset || s.repository ? `in     ${[s.recordset, s.repository].filter(Boolean).join(" · ")}${s.locator ? ` · ${s.locator}` : ""}` : s.locator ? `at     ${s.locator}` : undefined, s.url ? `url    ${s.url}` : undefined, s.media?.length ? `images ${s.media.map((id) => { const m = tree.get(id); return m ? `${id}${m.recordset ? ` (${m.recordset}:${m.image ?? "?"})` : ""}` : id; }).join(" · ")} — strom media view <M…>` : undefined, s.clips?.length ? `clips  ${s.clips.map((c, i) => `${i + 1}. ${clipText(c)}`).join(" · ")} — where the entry is on its image` : undefined, s.transcript ? `\ntranscript\n${s.transcript}` : undefined, s.translation ? `\ntranslation\n${s.translation}` : undefined, citing.length ? `\ncited by\n${citing.map((c) => `  ${c}`).join("\n")}` : "\ncited by nothing yet", ...s.notes.map((n) => `note   ${n.text}`));
         return { text, data: { source: s, citedBy: citing } };
     },
 });
@@ -228,7 +261,7 @@ register({
         { name: "automation", type: "string", value: "<a>", description: "allowed, manual (browser only), forbidden, unknown (default)" },
         { name: "note", type: "string", value: "<text>", description: "short note" },
     ],
-    examples: ['strom repo add "SOA Praha (eBadatelna)" --country CZ --url https://ebadatelna.soapraha.cz --automation manual'],
+    examples: ['strom repo add "State Archive, online reading room" --country CZ --url https://archive.example.org --automation manual'],
     run(ctx, { args, opts }) {
         const tree = ctx.tree();
         const r = create(tree, "repository", {
@@ -396,10 +429,11 @@ register({
         { name: "kind", type: "string", value: "<kind>", description: "village, town, parish, estate, district, …" },
         { name: "lat", type: "string", value: "<deg>", description: "latitude" },
         { name: "lon", type: "string", value: "<deg>", description: "longitude" },
+        { name: "unlocated", type: "string", value: "<why>", description: "no coordinates yet, and why: not identified which of the places of this name it is (coordinates given later clear it)" },
         { name: "parent", type: "string", value: "<L…>", description: "place it belongs to" },
         { name: "note", type: "string", value: "<text>", description: "short note" },
     ],
-    examples: ['strom place add "Týnec nad Labem" --alt "Teinitz an der Elbe@de" --kind town --lat 50.042 --lon 15.358'],
+    examples: ['strom place add "Týnec nad Labem" --alt "Teinitz an der Elbe@de" --kind town --lat 50.042 --lon 15.358', 'strom place add "Lhota" --kind village --unlocated "which Lhota: the record gives no parish"'],
     run(ctx, { args, opts }) {
         const tree = ctx.tree();
         const names = [{ name: args[0].trim() }];
@@ -416,6 +450,7 @@ register({
             names,
             kind: str(opts.kind),
             coords: lat !== undefined && lon !== undefined ? { lat, lon } : undefined,
+            unlocated: lat === undefined ? str(opts.unlocated) : undefined,
             parent: opts.parent ? normId(opts.parent) : undefined,
             jurisdictions: [],
             note: str(opts.note),
@@ -425,12 +460,21 @@ register({
     },
 }, {
     path: ["place", "list"],
-    summary: "Places known in this tree",
+    summary: "Places known in this tree — or, with --off-map, the places of facts not on the Strom app's map yet",
     group: "sources",
     tree: true,
     args: [{ name: "filter", description: "part of a name" }],
-    run(ctx, { args }) {
+    options: [{ name: "off-map", type: "boolean", description: "places of facts without coordinates (no place record yet, or one without them), the most facts first" }],
+    examples: ["strom place list", "strom place list --off-map"],
+    run(ctx, { args, opts }) {
         const tree = ctx.tree();
+        if (opts["off-map"]) {
+            const off = placesOffMap(tree);
+            return {
+                text: off.length ? lines(...off.map(offMapLine), OFF_MAP_HOW) : "every place of a fact is on the map (or says why not)",
+                data: { offMap: off.map((m) => ({ name: m.name, events: m.events, place: m.place?.id })) },
+            };
+        }
         const all = args[0] ? tree.list("place").filter((p) => p.names.some((n) => matches(n.name, args[0]))) : tree.list("place");
         return {
             text: all.length
@@ -519,15 +563,24 @@ register({
     description: "Only the options given change; --media adds images, --note adds a note. Changing what a record says or\n" +
         "how good it is (kind, form, information, date, locator, transcript, record set) needs --reason; filling in doesn't.",
     args: [{ name: "source", description: "source ID (S0001)", required: true }],
-    options: editOptions(addOptions("source add"), [{ name: "title", type: "string", value: "<text>", description: "a better title" }]).filter((o) => o.name !== "input"),
-    examples: ['strom source edit S0001 --translation "Jan, son of Josef" --media B0001:2', 'strom source edit S0001 --information secondary --reason "the entry was written years later"'],
+    options: [
+        ...editOptions(addOptions("source add"), [{ name: "title", type: "string", value: "<text>", description: "a better title" }]).filter((o) => o.name !== "input"),
+        { name: "clip-remove", type: "string", value: "<n|all>", description: "take away a clip that is wrong (its number in strom source show), or all of them" },
+    ],
+    examples: [
+        'strom source edit S0001 --translation "Jan, son of Josef" --media B0001:2',
+        'strom source edit S0001 --information secondary --reason "the entry was written years later"',
+        "strom source edit S0001 --clip M0001@0.05,0.42,0.45,0.16",
+    ],
     run(ctx, { args, opts }) {
         const tree = ctx.tree();
         if (opts.recordset)
             requireRecord(tree, opts.recordset, "recordset");
         if (opts.repo)
             requireRecord(tree, opts.repo, "repository");
-        const media = mediaRefs(tree, csvOpt(opts.media));
+        const clips = clipRefs(tree, listOpt(opts.clip));
+        const drop = str(opts["clip-remove"]);
+        const media = [...new Set([...mediaRefs(tree, csvOpt(opts.media)), ...clips.map((c) => c.media)])];
         const s = editFields(tree, args[0], "source", {
             title: str(opts.title),
             kind: optOneOf(opts.kind, SOURCE_KINDS, "kind"),
@@ -542,8 +595,25 @@ register({
             form: optOneOf(opts.form, ["original", "derivative", "authored"], "form"),
             url: str(opts.url),
             accessed: str(opts.url) ? new Date().toISOString().slice(0, 10) : undefined,
-        }, { kind: "other", form: undefined, information: "unknown", date: undefined, locator: undefined, transcript: undefined, recordset: undefined }, opts, (cur) => (media.some((m) => !(cur.media ?? []).includes(m)) ? { media: [...new Set([...(cur.media ?? []), ...media])] } : {}));
-        return { text: written(tree), data: { source: s } };
+        }, { kind: "other", form: undefined, information: "unknown", date: undefined, locator: undefined, transcript: undefined, recordset: undefined }, opts, (cur) => {
+            let kept = cur.clips ?? [];
+            if (drop === "all")
+                kept = [];
+            else if (drop !== undefined) {
+                const n = Number(drop);
+                if (!Number.isInteger(n) || n < 1 || n > kept.length)
+                    throw new UsageError(kept.length ? `--clip-remove takes 1–${kept.length} or all` : `${cur.id} has no clips`, { hint: `strom source show ${cur.id}` });
+                kept = kept.filter((_, i) => i !== n - 1);
+            }
+            const next = [...kept, ...clips.filter((c) => !kept.some((k) => clipText(k) === clipText(c)))];
+            if (next.length > MAX_CLIPS)
+                throw new UsageError(`at most ${MAX_CLIPS} clips: an entry, and its continuation over a page break`, { hint: `take one away: --clip-remove <n> (strom source show ${cur.id})` });
+            return {
+                ...(media.some((m) => !(cur.media ?? []).includes(m)) ? { media: [...new Set([...(cur.media ?? []), ...media])] } : {}),
+                ...(drop !== undefined || clips.length ? { clips: next.length ? next : undefined } : {}),
+            };
+        });
+        return { text: lines(written(tree), media.length ? clipNote(tree, s) : undefined, media.length || clips.length ? transcriptNote(tree, s) : undefined), data: { source: s } };
     },
 }, {
     path: ["repo", "edit"],
@@ -609,7 +679,7 @@ register({
     description: "--alt adds names; a place's names are never removed.",
     args: [{ name: "place", description: "place ID (L0001)", required: true }],
     options: editOptions(addOptions("place add")),
-    examples: ['strom place edit L0001 --alt "Teinitz an der Elbe@de:1850-1918" --lat 50.042 --lon 15.358'],
+    examples: ['strom place edit L0001 --alt "Teinitz an der Elbe@de:1850-1918" --lat 50.042 --lon 15.358', 'strom place edit L0001 --unlocated "two villages of this name in the district; the record does not say which"'],
     run(ctx, { args, opts }) {
         const tree = ctx.tree();
         const lat = opts.lat === undefined ? undefined : Number(opts.lat);
@@ -624,10 +694,12 @@ register({
         const p = editFields(tree, args[0], "place", {
             kind: str(opts.kind),
             coords: lat !== undefined && lon !== undefined ? { lat, lon } : undefined,
+            unlocated: lat === undefined ? str(opts.unlocated) : undefined,
             parent: opts.parent ? normId(opts.parent) : undefined,
         }, {}, opts, (cur) => {
             const add = alt.filter((n) => !cur.names.some((x) => foldText(x.name) === foldText(n.name) && x.lang === n.lang));
-            return add.length ? { names: [...cur.names, ...add] } : {};
+            // located at last: no longer "not identified"
+            return { ...(add.length ? { names: [...cur.names, ...add] } : {}), ...(lat !== undefined && cur.unlocated ? { unlocated: undefined } : {}) };
         });
         return { text: written(tree), data: { place: p } };
     },

package/dist/commands/start.js

@@ -16,19 +16,19 @@ import { syncAgentFiles } from "../agents/files.js";
 import { AGENTS, findAgent, isAgent } from "../core/which.js";
 import { DESKTOP_APPS, agentsHere, whereToTalk } from "../core/apps.js";
 import { assertIntact } from "../core/integrity.js";
-import { browserConnectors } from "../core/connector.js";
+import { treeBrowserConnectors } from "../core/connector.js";
 import { appOpensResearch, importAppUrl, installedStromApp, liveAppUrl, noticeStromApp, STROM_APP_URL, stromAppUrl } from "../core/stromapp.js";
 import { liveRunning, serveLive, startLive, stopLive } from "../core/live.js";
 import { openForUser } from "../core/open.js";
 import { createShortcut, openInNewTerminal } from "../core/shortcut.js";
-import { chromiumBrowser, openFileWith, openInBrowser, revealFile } from "../core/chromium.js";
+import { chromiumBrowser, openFileWith, openInBrowser, openWebApp, revealFile } from "../core/chromium.js";
 import { uninstallPlan } from "../core/uninstall.js";
 import { Tree } from "../core/tree.js";
 import { commitNow, shimDir } from "./session.js";
 import { abandonedSessions, closeSession, openSessions } from "../core/session.js";
 import { enterWorker, liveWorkers } from "../core/workers.js";
 import { phrase } from "../core/phrases.js";
-import { writeGedcoms, writeTreeGed } from "./output.js";
+import { imageSettings, writeGedcoms, writeTreeGed } from "./output.js";
 import { shortcutName } from "../cli/wizard.js";
 /** Has the user trusted this folder in Claude Code already? (Its own record, read only.) */
 function claudeTrusts(root, env) {
@@ -73,7 +73,8 @@ register({
         // An agent strom started (a conversation, a run) is where the research happens already. Any other
         // agent — the one that set strom up from the web page, one opened in some folder — hands the
         // research over: its own conversation, opened where it lives (the tree folder, its permissions).
-        const agentHere = isAgent(ctx.env);
+        // A window strom opened to hand the research over is the person's (STROM_HANDOVER): never handed over again from there.
+        const agentHere = isAgent(ctx.env) && !ctx.env.STROM_HANDOVER;
         if (agentHere && (ctx.env.STROM_WORKER || ctx.env.STROM_SESSION) && !opts.print)
             throw new UsageError("strom chat opens a conversation for the user — you are in one already", { hint: "go on with strom here" });
         const tree = ctx.tree();
@@ -117,6 +118,8 @@ register({
         if (agentHere && !opts.print) {
             const say = typeof opts.say === "string" && opts.say.trim() ? ["--say", opts.say.trim()] : [];
             const opened = openInNewTerminal(["chat", "--agent", agent, ...say], tree.root, ctx.env);
+            if (opened === "recent")
+                return { text: ui(lang, "ui.chat.handover.recent", { agent: profile.name }), data: { agent, handover: "recent", cwd: tree.root } };
             return { text: ui(lang, opened ? "ui.chat.handover" : "ui.chat.handover.failed", { agent: profile.name }), data: { agent, handover: opened ? "window" : "none", cwd: tree.root } };
         }
         const base = {
@@ -128,7 +131,7 @@ register({
             // its research when there is one, the day.
             name: ["Strom", tree.config.name, researches.length === 1 ? researches[0].name : undefined, new Date().toLocaleDateString(lang, { day: "numeric", month: "numeric" })].filter(Boolean).join(" · "),
             shared,
-            ...(agent === "claude" ? { chrome: browserConnectors(ctx.env, shared).length > 0 } : {}),
+            ...(agent === "claude" ? { chrome: treeBrowserConnectors(tree, shared).length > 0 } : {}),
         };
         const args = conversationArgs(agent, base);
         if (opts.print)
@@ -137,8 +140,9 @@ register({
         // works, and has its own session. Sessions of conversations that ended without closing are closed.
         for (const s of abandonedSessions(Tree.open(tree.root, ctx.env))) {
             const t = Tree.open(tree.root, ctx.env);
-            closeSession(t, s, { summary: phrase(t.lang, "session.chat"), next: "", interrupted: true, endedBy: "chat" });
-            commitNow(t, `${s.id} interrupted: its conversation had ended`);
+            // a run that is gone (each has a worker of its own), or a conversation
+            closeSession(t, s, { summary: phrase(t.lang, s.runner ? "session.run" : "session.chat"), next: "", interrupted: true, endedBy: s.runner ? "run" : "chat" });
+            commitNow(t, `${s.id} interrupted: its ${s.runner ? "run had stopped" : "conversation had ended"}`);
         }
         const worker = `${agent}-${process.pid}-${Date.now().toString(36)}`;
         const leave = enterWorker(tree.root, worker, `${profile.name} conversation`);
@@ -146,7 +150,8 @@ register({
         // Claude Code asks once whether the folder is to be trusted — its own safety step, kept; the user knows what to answer.
         if (agent === "claude" && !claudeTrusts(tree.root, ctx.env))
             ctx.io.stdout(ui(lang, "ui.chat.trust") + "\n");
-        const env = { ...prependPath(ctx.env, shimDir(tree)), STROM_WORKER: worker };
+        const env = { ...prependPath(ctx.env, shimDir(tree)), STROM_WORKER: worker, ...(base.model ? { STROM_MODEL: base.model } : {}) };
+        delete env.STROM_HANDOVER;
         let code;
         try {
             const started = Date.now();
@@ -176,41 +181,56 @@ register({
     group: "output",
     description: "In a tree, with an app that can take it (from its version 3.0.0), the app opens this research itself — the first time as\n" +
         "a new tree, after that the same tree updated — and follows it while somebody is at work on it (the live bridge).\n" +
-        `Otherwise the results are ready for it in output/tree-strom.ged (in the app: Import). Web: ${STROM_APP_URL}`,
-    options: [{ name: "live", type: "boolean", description: "the app follows this research while it goes on (the live bridge)" }],
+        `Otherwise the results are ready for it in output/tree-strom.ged (in the app: Import). Each entry comes with its image,\n` +
+        `cut out of its scan (the settings excerpts.*; excerpts.for none: without). Web: ${STROM_APP_URL}`,
+    options: [
+        { name: "live", type: "boolean", description: "the app follows this research while it goes on (the live bridge)" },
+        { name: "images", type: "boolean", description: "each entry with its image (the default; kept for older scripts)" },
+    ],
     examples: ["strom app", "strom app --live", "strom app install"],
     run(ctx, { opts }) {
         const lang = ctx.uiLang();
-        const root = appOpensResearch(ctx.env) ? ctx.locateTree() : undefined;
+        const root = appOpensResearch(ctx.settings) ? ctx.locateTree() : undefined;
         if (root) {
             const tree = Tree.open(root, ctx.env);
             const name = tree.config.name;
             // Followed while somebody is at work on it: an agent strom started, or the agent asking for it now.
             const follow = Boolean(opts.live) || liveWorkers(root).length > 0 || isAgent(ctx.env);
-            // The file as the research is now: the installed app takes it, or the user drags it in.
-            const file = writeTreeGed(tree, { for: "strom", stromVersion: ctx.settings.stromVersion(tree.config) }).file;
-            // B, D: the app reaches strom on this computer — in a Chromium browser, never whatever is the default (Safari cannot).
+            // The file as the research is now, each entry with its image: the installed app takes it, or the user drags it in.
+            const ged = writeTreeGed(tree, { for: "strom", stromVersion: ctx.settings.stromVersion(tree.config) });
+            const file = ged.file;
+            // what strom decided itself (smaller, left out) the user hears, in their language
+            const r = ged.images;
+            const set = ged.imageSettings;
+            const withImages = r && set
+                ? lines(ui(lang, "ui.app.images", { n: String(r.excerpts), mb: (r.bytes / 1024 / 1024).toFixed(1) }), r.level !== r.asked ? ui(lang, "ui.app.images.smaller", { limit: String(set.mb), level: r.level, asked: r.asked }) : undefined, r.dropped.length ? ui(lang, "ui.app.images.left", { n: String(r.dropped.length), limit: String(set.mb) }) : undefined, r.outOfScope ? ui(lang, "ui.app.images.scope", { n: String(r.outOfScope), for: set.for }) : undefined, r.unclipped.length ? ui(lang, "ui.app.images.unclipped", { n: String(r.unclipped.length) }) : undefined)
+                : undefined;
+            // B, D: the app reaches strom on this computer — installed from a Chromium browser (its own window: first
+            // choice), else in a Chromium browser's tab; never whatever is the default (Safari cannot).
+            // The copy of the app strom opens (strom.app.url: its beta, its development) — installed, that one only.
+            const installed = installedStromApp(ctx.env, process.platform, stromAppUrl(ctx.settings));
+            const webApp = installed?.appId && installed.browser ? { browser: installed.browser, appId: installed.appId, ...(installed.profile ? { profile: installed.profile } : {}) } : undefined;
             const browser = chromiumBrowser(ctx.env);
-            if (browser) {
+            if (webApp || browser) {
                 // The bridge serves the tree's GEDCOM to the app; it ends by itself when nobody asks it anything.
-                const info = startLive(root, ctx.env);
+                const info = startLive(root, ctx.env, { current: true });
                 if (!info)
                     throw new StromError("the bridge did not start", { hint: "strom live serve shows why" });
-                const url = follow ? liveAppUrl(info.url, ctx.env) : importAppUrl(`${info.url}/tree.ged`, ctx.env);
-                const opened = openInBrowser(browser, url, ctx.env);
-                const text = opened ? ui(lang, follow ? "ui.app.following" : "ui.app.research", { name, where: browser.name }) : ui(lang, "ui.app.url", { url });
-                return { text, data: { opened, via: "browser", browser: browser.name, url, bridge: info.url, follow } };
+                const url = follow ? liveAppUrl(info.url, ctx.settings) : importAppUrl(`${info.url}/tree.ged`, ctx.settings);
+                const inApp = webApp ? openWebApp(webApp, url, ctx.env) : false;
+                const opened = inApp || (browser ? openInBrowser(browser, url, ctx.env) : false);
+                const where = inApp ? ui(lang, "ui.app.where.installed") : (browser?.name ?? "");
+                const text = lines(opened ? ui(lang, follow ? "ui.app.following" : "ui.app.research", { name, where }) : ui(lang, "ui.app.url", { url }), withImages);
+                return { text, data: { opened, via: inApp ? "app" : "browser", ...(browser ? { browser: browser.name } : {}), url, bridge: info.url, follow } };
             }
-            // A: no such browser to hand it over, but the Strom app installed from one takes the file itself (its
-            // file handler) — not when strom is pointed at another copy of the app (STROM_APP_URL: a beta, a development one).
-            const installed = installedStromApp(ctx.env);
-            if (!follow && !ctx.env.STROM_APP_URL && installed && /Chrome|Edge|Brave|Chromium|Vivaldi/.test(installed.kind) && openFileWith(installed.path, file, ctx.env))
-                return { text: ui(lang, "ui.app.research", { name, where: installed.kind }), data: { opened: true, via: "file", file, app: installed.path, follow } };
+            // A: no such browser to hand it over, but the Strom app installed from one takes the file itself (its file handler).
+            if (!follow && installed && /Chrome|Edge|Brave|Chromium|Vivaldi/.test(installed.kind) && openFileWith(installed.path, file, ctx.env))
+                return { text: lines(ui(lang, "ui.app.research", { name, where: installed.kind }), withImages), data: { opened: true, via: "file", file, app: installed.path, follow } };
             // C: no such browser — the app opens, the file is shown, the user drags it into the app's window.
-            openForUser(installed?.path ?? stromAppUrl(ctx.env), ctx.env);
+            openForUser(installed?.path ?? stromAppUrl(ctx.settings), ctx.env);
             const shown = revealFile(file, ctx.env);
             return {
-                text: lines(follow ? ui(lang, "ui.app.nolive") : undefined, ui(lang, "ui.app.drag", { file: ctx.display(file), shown: shown ? ui(lang, "ui.app.drag.shown") : "" })),
+                text: lines(follow ? ui(lang, "ui.app.nolive") : undefined, ui(lang, "ui.app.drag", { file: ctx.display(file), shown: shown ? ui(lang, "ui.app.drag.shown") : "" }), withImages),
                 data: { opened: shown, via: "drag", file, follow },
             };
         }
@@ -218,14 +238,14 @@ register({
             const info = startLive(ctx.tree().root, ctx.env);
             if (!info)
                 throw new StromError("the bridge did not start", { hint: "strom live serve shows why" });
-            const url = liveAppUrl(info.url, ctx.env);
+            const url = liveAppUrl(info.url, ctx.settings);
             const opened = openForUser(url, ctx.env);
             return { text: opened ? ui(lang, "ui.app.opened", { where: ui(lang, "ui.app.browser") }) : ui(lang, "ui.app.url", { url }), data: { opened, url, bridge: info.url } };
         }
-        const app = noticeStromApp(ctx.settings, ctx.env, { look: true }) ?? installedStromApp(ctx.env);
-        const opened = openForUser(app?.path ?? stromAppUrl(ctx.env), ctx.env);
-        const text = opened ? ui(lang, "ui.app.opened", { where: app ? app.kind : ui(lang, "ui.app.browser") }) : ui(lang, "ui.app.url", { url: stromAppUrl(ctx.env) });
-        return { text, data: { opened, url: stromAppUrl(ctx.env), ...(app ? { installed: app } : {}) } };
+        const app = noticeStromApp(ctx.settings, ctx.env, { look: true }) ?? installedStromApp(ctx.env, process.platform, stromAppUrl(ctx.settings));
+        const opened = openForUser(app?.path ?? stromAppUrl(ctx.settings), ctx.env);
+        const text = opened ? ui(lang, "ui.app.opened", { where: app ? app.kind : ui(lang, "ui.app.browser") }) : ui(lang, "ui.app.url", { url: stromAppUrl(ctx.settings) });
+        return { text, data: { opened, url: stromAppUrl(ctx.settings), ...(app ? { installed: app } : {}) } };
     },
 }, {
     path: ["live"],
@@ -240,7 +260,7 @@ register({
         const tree = ctx.tree();
         const info = liveRunning(tree.root);
         return info
-            ? { text: lines(`the bridge runs: ${info.url}`, `  the Strom app following it: ${liveAppUrl(info.url, ctx.env)}`, "  stop: strom live stop"), data: { running: true, ...info, app: liveAppUrl(info.url, ctx.env) } }
+            ? { text: lines(`the bridge runs: ${info.url}`, `  the Strom app following it: ${liveAppUrl(info.url, ctx.settings)}`, "  stop: strom live stop"), data: { running: true, ...info, app: liveAppUrl(info.url, ctx.settings) } }
             : { text: "the bridge does not run — strom live start (or strom app --live)", data: { running: false } };
     },
 }, {
@@ -253,7 +273,7 @@ register({
         const info = startLive(tree.root, ctx.env);
         if (!info)
             throw new StromError("the bridge did not start", { hint: "strom live serve shows why" });
-        return { text: lines(`the bridge runs: ${info.url}`, `  the Strom app following it: ${liveAppUrl(info.url, ctx.env)}`), data: { ...info, app: liveAppUrl(info.url, ctx.env) } };
+        return { text: lines(`the bridge runs: ${info.url}`, `  the Strom app following it: ${liveAppUrl(info.url, ctx.settings)}`), data: { ...info, app: liveAppUrl(info.url, ctx.settings) } };
     },
 }, {
     path: ["live", "stop"],
@@ -280,14 +300,14 @@ register({
     group: "output",
     run(ctx) {
         const lang = ctx.uiLang();
-        const app = installedStromApp(ctx.env);
+        const app = installedStromApp(ctx.env, process.platform, stromAppUrl(ctx.settings));
         if (app) {
             noticeStromApp(ctx.settings, ctx.env, { look: true });
             const opened = openForUser(app.path, ctx.env);
             return { text: ui(lang, "ui.app.installed", { kind: app.kind }), data: { installed: app, opened } };
         }
-        const opened = openForUser(stromAppUrl(ctx.env), ctx.env);
-        return { text: opened ? ui(lang, "ui.app.install") : ui(lang, "ui.app.url", { url: stromAppUrl(ctx.env) }), data: { installed: false, opened, url: stromAppUrl(ctx.env) } };
+        const opened = openForUser(stromAppUrl(ctx.settings), ctx.env);
+        return { text: opened ? ui(lang, "ui.app.install") : ui(lang, "ui.app.url", { url: stromAppUrl(ctx.settings) }), data: { installed: false, opened, url: stromAppUrl(ctx.settings) } };
     },
 });
 register({

package/dist/commands/tasks.js

@@ -12,11 +12,12 @@ import { UsageError } from "../core/errors.js";
 import { TASK_LEVELS } from "../core/model.js";
 import { create, csvOpt, listOpt, normId, requireRecord, update } from "../core/records.js";
 import { resolvePerson } from "../core/people.js";
+import { foldText } from "../core/text.js";
 import { now, typeOfId } from "../core/tree.js";
 import { resolveResearch } from "./research.js";
 import { makeNote } from "../core/actions.js";
 import { lacksImages, rankTasks } from "../core/queue.js";
-import { inboxFolderFor, parseImageList } from "../core/media.js";
+import { clipNote, inboxFolderFor, parseImageList, transcriptNote } from "../core/media.js";
 function written(tree) {
     return lines(...tree.written.map((o) => o.summary), tree.dryRun ? "(dry run — nothing written)" : undefined);
 }
@@ -76,7 +77,7 @@ export function rankedQueue(tree, filter = {}) {
         .list("task")
         .filter((t) => !filter.research || !t.research || t.research === filter.research)
         .filter((t) => !filter.level || t.level === filter.level);
-    return rankTasks(tree, tasks, filter.strategy);
+    return rankTasks(tree, tasks, filter.strategy, { storyTurn: filter.storyTurn });
 }
 function taskLine(t) {
     return [t.id, `p${t.priority}`, t.level, t.state === "open" ? "" : `[${t.state}]`, truncate(t.what, 70)];
@@ -107,6 +108,20 @@ function stateChange(tree, ref, state, fields, reason, verb) {
         return next;
     }, { op: `task.${verb}`, summary: `${id} ${verb}${fields.result ? `: ${truncate(fields.result, 60)}` : ""}`, reason });
 }
+/** Tasks still to be done — the ones a new task must not repeat. */
+const OPEN_STATES = ["open", "doing", "waiting", "parked"];
+/** How alike two tasks' texts must be to be the same work: anywhere, or in the same books. */
+const SAME_TEXT = 0.75;
+const SAME_TEXT_IN_BOOK = 0.6;
+/** How alike two task texts are (0–1): the share of their words in common, any script, accents and punctuation aside. */
+export function alikeness(a, b) {
+    const words = (t) => new Set(foldText(t).split(/[^\p{L}\p{M}\p{N}]+/u).filter(Boolean));
+    const [x, y] = [words(a), words(b)];
+    if (!x.size || !y.size)
+        return 0;
+    const common = [...x].filter((w) => y.has(w)).length;
+    return common / (x.size + y.size - common);
+}
 register({
     path: ["task", "add"],
     summary: "Add a task: what, where, why, done-when (all required)",
@@ -126,6 +141,7 @@ register({
         { name: "about", type: "string", multiple: true, value: "<who>", description: "person/record the task is about, also a conflict X… or hypothesis H… it decides (repeatable)" },
         { name: "research", type: "string", value: "<G…>", description: "research it belongs to (default: the only active one)" },
         { name: "note", type: "string", value: "<text>", description: "short note" },
+        { name: "anyway", type: "boolean", description: "add it although an open task of the same person and level reads the same (it is really other work)" },
     ],
     examples: [
         'strom task add "Křest Jana Nováka (~1905)" --level link --where B0001 --why "potvrdí otce Josefa" --done-when "zápis nalezen, nebo ročníky 1903–1907 prohledány celé" --about P0001 --priority 4',
@@ -141,6 +157,24 @@ register({
         if (!Number.isInteger(priority) || priority < 1 || priority > 5)
             throw new UsageError("--priority must be 1..5");
         const where = listOpt(opts.where).map((w) => (/^[Bb]\d+$/.test(w) ? requireRecord(tree, w, "recordset").id : w));
+        const subject = subjects(tree, listOpt(opts.about));
+        const research = defaultResearch(tree, opts.research);
+        // The same work again: an open task of the same person and level that reads the same (or nearly, in the same
+        // books) — not added; what is new goes into that one.
+        if (!opts.anyway) {
+            const books = new Set(where.filter((w) => /^B\d+$/.test(w)));
+            const same = tree
+                .list("task")
+                .filter((x) => OPEN_STATES.includes(x.state) && x.level === opts.level && x.research === research && x.subject.some((s) => subject.includes(s)))
+                .map((x) => ({ x, alike: alikeness(x.what, args[0]), books: x.where.some((w) => books.has(w)) }))
+                .filter((m) => m.alike >= SAME_TEXT || (m.books && m.alike >= SAME_TEXT_IN_BOOK))
+                .sort((a, b) => b.alike - a.alike)[0];
+            if (same)
+                throw new UsageError(`a task like this is open already: ${same.x.id} p${same.x.priority} ${same.x.level} "${truncate(same.x.what, 70)}"`, {
+                    hint: `add to it: strom task edit ${same.x.id} --priority … --where … --note "…" — or, if it is really other work: --anyway`,
+                    details: { task: same.x.id },
+                });
+        }
         const t = create(tree, "task", {
             level: opts.level,
             priority,
@@ -148,8 +182,8 @@ register({
             where,
             why: String(opts.why).trim(),
             doneWhen: String(opts["done-when"]).trim(),
-            subject: subjects(tree, listOpt(opts.about)),
-            research: defaultResearch(tree, opts.research),
+            subject,
+            research,
             state: "open",
             origin: tree.actor,
             note: opts.note,
@@ -158,7 +192,7 @@ register({
         const books = new Set(where.filter((w) => /^B\d+$/.test(w)));
         const similar = tree
             .list("task")
-            .filter((x) => x.id !== t.id && ["open", "doing", "waiting", "parked"].includes(x.state) && x.level === t.level)
+            .filter((x) => x.id !== t.id && OPEN_STATES.includes(x.state) && x.level === t.level)
             .filter((x) => x.subject.some((s) => t.subject.includes(s)) && (books.size === 0 || x.where.some((w) => books.has(w))));
         // A link without images can only wait for the user: say now what to download, while
         // it is known — not in a session spent finding out that there is nothing to read.
@@ -338,7 +372,10 @@ register({
             for (const id of new Set([...t.subject, ...t.where]))
                 if (typeOfId(id) === "input" && tree.get(id)?.state === "new")
                     update(tree, id, "input", (i) => ({ ...i, state: "processed" }), { op: "input.done", summary: `${id} processed (${t.id} done)` });
-        return { text: lines(written(tree), noSearch, handover), data: { task: t } };
+        // The entries it recorded from scans: each with where it is on its image.
+        const recorded = (t.produced ?? []).filter((id) => typeOfId(id) === "source").flatMap((id) => tree.get(id) ?? []);
+        const unclipped = recorded.flatMap((s) => [clipNote(tree, s), transcriptNote(tree, s)].filter((n) => !!n));
+        return { text: lines(written(tree), noSearch, handover, ...unclipped), data: { task: t } };
     },
 }, {
     path: ["task", "park"],