strom-research 1.13.0-beta.2 → 1.13.0-beta.5

package/assets/lang/cs.json

@@ -275,6 +275,10 @@
   "ui.doc.app.seen": "nalezena v počítači",
   "ui.doc.app.no": "není chtěná",
   "ui.doc.app.unknown": "nenalezena",
+  "ui.doc.appurl": "adresa aplikace Strom",
+  "ui.doc.appurl.config": "nastavení strom.app.url „{value}“ není adresa aplikace Strom – strom app nic neotevře, dokud se neopraví nebo neodebere",
+  "ui.doc.appurl.env": "proměnná STROM_APP_URL „{value}“ není adresa aplikace Strom – strom app nic neotevře, dokud se neopraví nebo neodebere",
+  "ui.doc.appurl.env.fix": "proměnnou STROM_APP_URL nastavit na adresu aplikace Strom ({web}, nebo její kopie na tomto počítači http://127.0.0.1:<port>/), nebo odebrat",
   "ui.doc.tree.ok": "{name}: data v pořádku a zapečetěná",
   "ui.doc.tree.bad": "{name}: problémů {n}",
   "ui.doc.allok": "Všechno potřebné je na místě.",
@@ -654,7 +658,7 @@
   "ui.help.archive.stats": "Archiv v kostce: osoby, jak jisté jsou údaje, předkové v každé generaci",
   "ui.help.archive.pack": "Zabalit archiv do jednoho souboru ZIP, aby v něm mohl pokračovat někdo jiný",
   "ui.help.archive.intake": "Přidat podklady od rodiny: dokumenty, fotky, rodokmen, co je známo",
-  "ui.help.title": "strom <příkaz> – co člověk se stromem dělá (nebo jen {strom}: menu)",
+  "ui.help.title": "{strom} <příkaz> – co člověk se stromem dělá (nebo jen {strom}: menu)",
   "ui.help.more": "Nápověda k jednomu příkazu: strom help <příkaz> --human · všechny příkazy anglicky (co čte agent): strom help",
   "ui.help.more.archive": "Nápověda k jednomu příkazu: strom help <příkaz> --human",
   "ui.help.examples": "Příklady:",
@@ -846,11 +850,12 @@
   "ui.live.app": "  aplikace Strom ho sleduje na adrese: {url}",
   "ui.live.stophow": "  zastavit: strom live stop",
   "ui.live.none": "most neběží – strom live start (nebo strom app --live)",
-  "ui.live.moved": "  má novou adresu (starý port byl obsazený): aplikace Strom ji najde, až v ní výzkum znovu otevře – strom app --live",
+  "ui.live.moved": "  má novou adresu: aplikace Strom ji najde, až v ní výzkum znovu otevře – strom app --live",
   "ui.live.stopped": "most se zastavil",
   "ui.live.killed": "most neskončil, když byl požádán: byl ukončen natvrdo",
   "ui.live.noneran": "žádný most neběžel",
   "ui.live.forgotten": "jeho adresa je zapomenutá: další most dostane novou",
+  "ui.live.newsecret": "  další most dostane novou tajnou adresu: aplikace Strom ji dostane při dalším otevření výzkumu – strom app",
   "ui.live.ended": "most skončil",
   "ui.guide.archive": "Tento rodokmen je archiv: data přicházejí z aplikace Strom. Co v něm je: strom stats · strom person card <kdo> · strom pedigree <kdo> · strom recent. Výzkum zapíná jen uživatel: strom mode research (nebo menu).",
   "ui.setup.links.archive": "Dovolit aplikaci Strom otevírat archiv na tomto počítači? (Jedním klikem pošle úpravy zpět nebo otevře výřez v plné kvalitě – vždy se tu nejdřív zeptá.)",
@@ -1496,6 +1501,10 @@
   "ui.error.arg.missing": "chybí <{arg}>",
   "ui.error.arg.missing.hint": "strom help {cmd}",
   "ui.error.prefix": "chyba",
+  "ui.error.config.app-url": "neplatné strom.app.url „{value}“: není to adresa aplikace Strom",
+  "ui.error.config.app-url.hint": "aplikace Strom: {web}, nebo její kopie na tomto počítači http://127.0.0.1:<port>/",
+  "ui.error.config.app-url.config.hint": "aplikace Strom: {web}, nebo její kopie na tomto počítači http://127.0.0.1:<port>/\nopravit: strom config set strom.app.url <adresa> – nebo odebrat: strom config unset strom.app.url",
+  "ui.error.config.app-url.env.hint": "aplikace Strom: {web}, nebo její kopie na tomto počítači http://127.0.0.1:<port>/\nproměnnou STROM_APP_URL opravit, nebo odebrat",
   "ui.error.backup.failed": "Zálohu před přechodem z {from} na {to} se nepodařilo vytvořit: {detail}. Nic se nepřepíná: tento strom neotevře žádný rodokmen k zápisu, dokud záloha nebude hotová.",
   "ui.error.backup.failed.hint": "Uvolnit místo na disku ({where}) a spustit strom znovu – nebo se vrátit: strom update --channel {back}",
   "ui.error.backup.failed.update": "Zálohu před přechodem z {from} na {to} se nepodařilo vytvořit: {detail}. Nic se nenainstalovalo.",
@@ -1587,6 +1596,7 @@
   "ui.arg.tree-name": "název",
   "ui.arg.url": "adresa",
   "ui.arg.value": "hodnota",
+  "ui.arg.address": "adresa",
   "ui.arg.what": "co",
   "ui.arg.where": "kde",
   "ui.arg.who": "kdo",
@@ -1614,7 +1624,7 @@
   "ui.error.event.needs-reason.hint": "např. --reason \"záznam S0012 uvádí 1811, ne 1813\"",
   "ui.error.family.needs-reason": "změna toho, kdo do rodiny patří nebo jak, potřebuje --reason",
   "ui.error.family.needs-reason.hint": "např. --reason \"křest uvádí Jana jako otčíma\"",
-  "ui.error.person.needs-reason": "změna jména nebo známého pohlaví potřebuje --reason",
+  "ui.error.person.needs-reason": "změna jména, jeho titulu nebo známého pohlaví potřebuje --reason",
   "ui.error.person.needs-reason.hint": "např. --reason \"špatně přečteno: matrika má Novák, ne Nowak\"",
   "ui.error.retract.needs-reason": "stažení potřebuje --reason",
   "ui.error.retract.needs-reason.hint": "např. --reason \"špatně přečteno: zápis uvádí Annu, ne Antona\"",

package/assets/lang/de.json

@@ -275,6 +275,10 @@
   "ui.doc.app.seen": "auf dem Computer gefunden",
   "ui.doc.app.no": "nicht gewünscht",
   "ui.doc.app.unknown": "nicht gefunden",
+  "ui.doc.appurl": "Adresse der Strom-App",
+  "ui.doc.appurl.config": "die Einstellung strom.app.url „{value}“ ist keine Adresse der Strom-App – strom app öffnet nichts, bis sie berichtigt oder entfernt ist",
+  "ui.doc.appurl.env": "die Variable STROM_APP_URL „{value}“ ist keine Adresse der Strom-App – strom app öffnet nichts, bis sie berichtigt oder entfernt ist",
+  "ui.doc.appurl.env.fix": "die Variable STROM_APP_URL auf eine Adresse der Strom-App setzen ({web}, oder eine Kopie auf diesem Computer http://127.0.0.1:<port>/) oder entfernen",
   "ui.doc.tree.ok": "{name}: Daten in Ordnung und versiegelt",
   "ui.doc.tree.bad": "{name}: Probleme: {n}",
   "ui.doc.allok": "Alles Nötige ist vorhanden.",
@@ -654,7 +658,7 @@
   "ui.help.archive.stats": "Das Archiv auf einen Blick: Personen, wie sicher die Angaben sind, Vorfahren je Generation",
   "ui.help.archive.pack": "Das Archiv in eine ZIP-Datei packen, damit jemand anderes weitermachen kann",
   "ui.help.archive.intake": "Material der Familie hinzufügen: Dokumente, Fotos, einen Stammbaum, eigenes Wissen",
-  "ui.help.title": "strom <Befehl> – was ein Mensch mit strom tut (oder nur {strom}: das Menü)",
+  "ui.help.title": "{strom} <Befehl> – was ein Mensch mit strom tut (oder nur {strom}: das Menü)",
   "ui.help.more": "Hilfe zu einem Befehl: strom help <Befehl> --human · alle Befehle auf Englisch (was ein Agent liest): strom help",
   "ui.help.more.archive": "Hilfe zu einem Befehl: strom help <Befehl> --human",
   "ui.help.examples": "Beispiele:",
@@ -846,11 +850,12 @@
   "ui.live.app": "  die Strom-App folgt ihr unter: {url}",
   "ui.live.stophow": "  anhalten: strom live stop",
   "ui.live.none": "die Brücke läuft nicht – strom live start (oder strom app --live)",
-  "ui.live.moved": "  sie hat eine neue Adresse (der alte Port war belegt): die Strom-App findet sie, wenn die Forschung darin wieder geöffnet wird – strom app --live",
+  "ui.live.moved": "  sie hat eine neue Adresse: die Strom-App findet sie, wenn die Forschung darin wieder geöffnet wird – strom app --live",
   "ui.live.stopped": "die Brücke ist angehalten",
   "ui.live.killed": "die Brücke endete nicht auf Bitte: sie wurde hart beendet",
   "ui.live.noneran": "keine Brücke lief",
   "ui.live.forgotten": "ihre Adresse ist vergessen: die nächste Brücke bekommt eine neue",
+  "ui.live.newsecret": "  die nächste Brücke bekommt eine neue geheime Adresse: die Strom-App bekommt sie beim nächsten Öffnen der Forschung – strom app",
   "ui.live.ended": "die Brücke ist beendet",
   "ui.guide.archive": "Dieser Stammbaum ist ein Archiv: die Daten kommen aus der Strom-App. Was er enthält: strom stats · strom person card <wer> · strom pedigree <wer> · strom recent. Die Forschung schaltet nur der Benutzer ein: strom mode research (oder das Menü).",
   "ui.setup.links.archive": "Der Strom-App erlauben, das Archiv auf diesem Computer zu öffnen? (Ein Klick schickt die Änderungen zurück oder öffnet einen Ausschnitt in voller Qualität – jeweils erst hier gefragt.)",
@@ -1496,6 +1501,10 @@
   "ui.error.arg.missing": "<{arg}> fehlt",
   "ui.error.arg.missing.hint": "strom help {cmd}",
   "ui.error.prefix": "Fehler",
+  "ui.error.config.app-url": "ungültige strom.app.url „{value}“: keine Adresse der Strom-App",
+  "ui.error.config.app-url.hint": "die Strom-App: {web}, oder eine Kopie auf diesem Computer http://127.0.0.1:<port>/",
+  "ui.error.config.app-url.config.hint": "die Strom-App: {web}, oder eine Kopie auf diesem Computer http://127.0.0.1:<port>/\nberichtigen: strom config set strom.app.url <Adresse> – oder entfernen: strom config unset strom.app.url",
+  "ui.error.config.app-url.env.hint": "die Strom-App: {web}, oder eine Kopie auf diesem Computer http://127.0.0.1:<port>/\ndie Variable STROM_APP_URL berichtigen oder entfernen",
   "ui.error.backup.failed": "Die Sicherung vor dem Wechsel von {from} auf {to} ließ sich nicht erstellen: {detail}. Es wird nichts umgestellt: dieses strom öffnet keinen Stammbaum zum Schreiben, bis die Sicherung erstellt ist.",
   "ui.error.backup.failed.hint": "Platz auf dem Datenträger freimachen ({where}) und strom erneut starten – oder zurück: strom update --channel {back}",
   "ui.error.backup.failed.update": "Die Sicherung vor dem Wechsel von {from} auf {to} ließ sich nicht erstellen: {detail}. Es wurde nichts installiert.",
@@ -1587,6 +1596,7 @@
   "ui.arg.tree-name": "Name",
   "ui.arg.url": "Adresse",
   "ui.arg.value": "Wert",
+  "ui.arg.address": "Adresse",
   "ui.arg.what": "was",
   "ui.arg.where": "wo",
   "ui.arg.who": "wer",
@@ -1614,7 +1624,7 @@
   "ui.error.event.needs-reason.hint": "z. B. --reason \"Eintrag S0012 nennt 1811, nicht 1813\"",
   "ui.error.family.needs-reason": "wer zur Familie gehört oder wie, ändert sich nur mit --reason",
   "ui.error.family.needs-reason.hint": "z. B. --reason \"die Taufe nennt Jan als Stiefvater\"",
-  "ui.error.person.needs-reason": "ein Name oder ein bekanntes Geschlecht ändert sich nur mit --reason",
+  "ui.error.person.needs-reason": "ein Name, sein Titel oder ein bekanntes Geschlecht ändert sich nur mit --reason",
   "ui.error.person.needs-reason.hint": "z. B. --reason \"falsch gelesen: im Register steht Novák, nicht Nowak\"",
   "ui.error.retract.needs-reason": "Zurückziehen braucht --reason",
   "ui.error.retract.needs-reason.hint": "z. B. --reason \"falsch gelesen: der Eintrag nennt Anna, nicht Anton\"",

package/dist/agents/files.js

@@ -12,12 +12,15 @@ import { writeFileAtomic } from "../core/json.js";
 import { PROFILES, SELF_READING } from "./profiles.js";
 import { isArchive } from "../core/mode.js";
 import { Settings } from "../core/config.js";
+import { agentAppUrl, appSite } from "../core/stromapp.js";
 import { configDir } from "../core/paths.js";
 import { agentBrowser } from "../core/connector.js";
 import { CHROME_ALLOW, CHROME_DENY, chromeDomain } from "../core/browser.js";
 export const MARKER = "<!-- strom: generated above this line (strom agents sync); your own notes below are kept -->";
 function agentsMd(tree) {
     const lang = langName(tree.config.lang);
+    // the Strom app's address as strom app opens it now (the beta its beta, strom.app.url where it says another)
+    const app = agentAppUrl(tree.env);
     return `# Family research: ${tree.config.name}
 
 This folder is a family tree researched with **strom**, a command-line tool
@@ -99,12 +102,12 @@ they ask.
 - **What waits for them** (\`strom\` shows it): tell them plainly what to do
   and where, one thing at a time.
 - **Results and the Strom app**: \`output/tree-strom.ged\` is the family tree
-  for the Strom app (https://stromapp.info) — strom's companion: a free family
+  for the Strom app (${appSite(app)}) — strom's companion: a free family
   tree app, no account, their data stay on their computer; it shows the tree,
   the sources, a map, a family book. When they want to see the results, or
   when \`strom\` says to offer it (it does once, not in every conversation),
   suggest it gently, in a sentence or two: best installed as an app from the browser, from
-  https://stromapp.info/run/ — \`strom app install\` opens it there and says
+  ${app} — \`strom app install\` opens it there and says
   where to click; it works offline then; \`strom app\` opens it, with this
   research when the app can take it — run by you, the app then follows the
   research live, what you record shows there by itself (else in the app:

package/dist/agents/global.js

@@ -16,9 +16,11 @@ import path from "node:path";
 import { isolated, userHome } from "../core/paths.js";
 import { writeFileAtomic } from "../core/json.js";
 import { installation } from "../core/self.js";
+import { agentAppUrl, appSite } from "../core/stromapp.js";
 const BEGIN = "<!-- strom: begin (strom agents install; removed by strom agents uninstall) -->";
 const END = "<!-- strom: end -->";
-export const GLOBAL_TEXT = `# strom — family history research
+/** What the agents are taught; app: the Strom app's address it names — the one `strom app` opens when it is written (agentAppUrl). */
+export const globalText = (app) => `# strom — family history research
 
 strom (the \`strom\` command) is installed on this computer: a tool for
 researching a family's history with you as the researcher — people, parish
@@ -57,11 +59,11 @@ mentions strom, a family tree or the Strom app.
 8. Scans come through strom. An archive the research needs has no
    downloader (connector) yet: build one yourself, unasked
    (\`strom connector new\`), and tell the user in a sentence.
-9. The Strom app (https://stromapp.info) is strom's companion: a free family
+9. The Strom app (${appSite(app)}) is strom's companion: a free family
    tree app, no account, the data stay on the user's computer. The research's
    result (\`output/tree-strom.ged\`) opens in it. When the user wants to see
    the tree (or \`strom\` says to offer it — once), suggest it gently — best installed as an app from the browser,
-   from https://stromapp.info/run/ (\`strom app install\` opens it there; it
+   from ${app} (\`strom app install\` opens it there; it
    then works offline); \`strom app\` opens it — with the research, followed
    live while you work, when the app can take it. Without it, the user can ask
    you about anyone in the tree: answer from \`strom person show\` and the like.
@@ -149,7 +151,9 @@ export function globalTargets(env) {
     if (isolated(env))
         return [];
     const home = userHome(env);
-    return [
+    // the app's address as strom app opens it now: a run of another channel (its first) writes the texts again
+    const app = agentAppUrl(env);
+    const targets = [
         { agent: "claude", file: path.join(env.CLAUDE_CONFIG_DIR ?? path.join(home, ".claude"), "skills", "strom", "SKILL.md"), kind: "own" },
         { agent: "claude", file: path.join(env.CLAUDE_CONFIG_DIR ?? path.join(home, ".claude"), "settings.json"), kind: "allow" },
         { agent: "codex", file: path.join(env.CODEX_HOME ?? path.join(home, ".codex"), "AGENTS.md"), kind: "block" },
@@ -161,13 +165,14 @@ export function globalTargets(env) {
         { agent: "grok", file: path.join(grokDir(env), "skills", "strom", "SKILL.md"), kind: "own" },
         { agent: "grok", file: path.join(grokDir(env), "config.toml"), kind: "allow" },
     ];
+    return targets.map((t) => ({ ...t, app }));
 }
-const SKILL = `---
+const skill = (app) => `---
 name: strom
 description: Family history and genealogy research with the strom command — ancestors, family trees, parish registers and archives, evidence, GEDCOM and the Strom app. Use when the user wants to research their family or mentions strom or the Strom app.
 ---
 
-${GLOBAL_TEXT}`;
+${globalText(app)}`;
 function read(file) {
     try {
         return fs.readFileSync(file, "utf8");
@@ -282,10 +287,10 @@ export function installGlobal(t) {
         next = JSON.stringify(s, null, 2) + "\n";
     }
     else if (t.kind === "own")
-        next = t.agent === "claude" || t.agent === "grok" ? SKILL : GLOBAL_TEXT;
+        next = t.agent === "claude" || t.agent === "grok" ? skill(t.app) : globalText(t.app);
     else {
         const rest = cur ? withoutBlock(cur).replace(/\s+$/, "") : "";
-        next = `${rest ? `${rest}\n\n` : ""}${BEGIN}\n${GLOBAL_TEXT}${END}\n`;
+        next = `${rest ? `${rest}\n\n` : ""}${BEGIN}\n${globalText(t.app)}${END}\n`;
     }
     if (cur === next)
         return false;

package/dist/cli/context.js

@@ -16,7 +16,7 @@ import { readJsonIfExists } from "../core/json.js";
 import { foldText } from "../core/text.js";
 import { currentSession } from "../core/session.js";
 import { isAgent } from "../core/which.js";
-import { systemDialog, WAIT_SECONDS } from "../core/dialog.js";
+import { canShowDialog, systemDialog, WAIT_SECONDS } from "../core/dialog.js";
 import { UI, ui } from "./ui.js";
 export class Context {
     env;
@@ -179,7 +179,8 @@ export class Context {
         const agent = isAgent(this.env);
         if (this.interactive && !agent)
             return "terminal";
-        if (this.env.STROM_NONINTERACTIVE !== "1" && opts.window !== false) {
+        // a window only where one can be shown (the test's own answer stands for one): else nothing said to wait in it
+        if (this.env.STROM_NONINTERACTIVE !== "1" && opts.window !== false && (this.io.dialog || canShowDialog(this.env))) {
             const lang = this.uiLang();
             const text = { title: ui(lang, "ui.dialog.title"), question: says ?? question, yes: ui(lang, "ui.dialog.yes"), no: ui(lang, "ui.dialog.no") };
             // said first where it runs: a window can be behind others, and the command waits for it without a word

package/dist/cli/help.js

@@ -1,6 +1,6 @@
 // Help text generated from the registry. Short by design: examples first,
 // then arguments and options.
-import { GROUPS, GLOBAL_OPTIONS, WRITE_OPTIONS, commands, match, subcommandsOf, usageLine } from "./registry.js";
+import { GROUPS, GLOBAL_OPTIONS, WRITE_OPTIONS, commands, descriptionOf, match, subcommandsOf, usageLine } from "./registry.js";
 import { table } from "./format.js";
 import { suggest } from "./execute.js";
 import { UI, ui } from "./ui.js";
@@ -43,13 +43,14 @@ function inArchive(def) {
         return own;
     return AI_WORDS.test(def.summary) ? undefined : def.summary;
 }
-export function commandHelp(def, archive = false) {
+export function commandHelp(def, archive, appUrl) {
     const summary = archive ? inArchive(def) : def.summary;
     if (summary === undefined)
         return `strom ${def.path.join(" ")}: not in an archive (research is switched on by the user: strom mode research)`;
     const out = [usageLine(def), "", summary];
-    if (def.description && !(archive && AI_WORDS.test(def.description)))
-        out.push("", def.description);
+    const description = descriptionOf(def, appUrl);
+    if (description && !(archive && AI_WORDS.test(description)))
+        out.push("", description);
     const examples = (def.examples ?? []).filter((e) => !(archive && AI_WORDS.test(e)));
     if (examples.length)
         out.push("", "Examples:", ...examples.map((e) => `  ${e}`));
@@ -111,14 +112,14 @@ export function overview(archive = false) {
     out.push("", "One command — usage, examples, options: strom help <command>", archive ? "Each command with what it does: strom commands <group>" : "Each command with what it does: strom commands [<group>] · with options and examples: strom commands <group> --json");
     return out.join("\n");
 }
-export function helpFor(input, archive = false) {
+export function helpFor(input, archive, appUrl) {
     // "strom help 'research new'" — one quoted argument with several words.
     const words = input.flatMap((w) => w.trim().split(/\s+/)).filter(Boolean);
     if (words.length === 0)
         return overview(archive);
     const found = match(words);
     if (found && found.used === words.length)
-        return commandHelp(found.def, archive);
+        return commandHelp(found.def, archive, appUrl);
     if (subcommandsOf(words).length > 0)
         return groupHelp(words, archive);
     const all = commands().filter((c) => c.path.length > 0).map((c) => c.path.join(" "));
@@ -185,7 +186,7 @@ function pointer(words, as) {
 export function helpAs(input, as) {
     const words = input.flatMap((w) => w.trim().split(/\s+/)).filter(Boolean);
     if (!as.human)
-        return helpFor(words, as.archive) + pointer(words, as);
+        return helpFor(words, as.archive, as.appUrl) + pointer(words, as);
     if (words.length === 0)
         return humanOverview(as);
     const found = match(words);

package/dist/cli/main.js

@@ -16,7 +16,7 @@ import { fireHooks, HOOK_INTERFACE } from "../core/hooks.js";
 import { prependPath } from "../runners/runner.js";
 import { shimDir } from "../commands/session.js";
 import { isAgent } from "../core/which.js";
-import { noticeStromApp } from "../core/stromapp.js";
+import { appUrlShown, noticeStromApp } from "../core/stromapp.js";
 import { lastChannelOf, pendingTransition, updateChannel } from "../core/update.js";
 import { backupBefore, backupSaid } from "./backups.js";
 import { installation } from "../core/self.js";
@@ -157,7 +157,7 @@ export async function main(argv, io, env, cwd) {
         catch (err) {
             if (err instanceof GroupOnly) {
                 const c = Context.fromOptions({ env, cwd, io, json, values: {} });
-                io.stdout(groupHelpAs(err.group, { archive: c.archiveHere(), human: false, lang: c.uiLang(), pointer: io.tty && !isAgent(env) }) + "\n");
+                io.stdout(groupHelpAs(err.group, { archive: c.archiveHere(), human: false, lang: c.uiLang(), appUrl: appUrlShown(c.settings), pointer: io.tty && !isAgent(env) }) + "\n");
                 return EXIT.ok;
             }
             throw err;
@@ -170,7 +170,7 @@ export async function main(argv, io, env, cwd) {
             // the agent's help, whoever asks (Milan, 2026-10-04: "výchozí je pro agenta"); a person at a terminal is told in a
             // line of their language how to get theirs (strom help <command> --human)
             const c = Context.fromOptions({ env, cwd, io, json, values: v });
-            io.stdout(helpAs(def.path, { archive: c.archiveHere(), human: false, lang: c.uiLang(), pointer: io.tty && !isAgent(env) }) + "\n");
+            io.stdout(helpAs(def.path, { archive: c.archiveHere(), human: false, lang: c.uiLang(), appUrl: appUrlShown(c.settings), pointer: io.tty && !isAgent(env) }) + "\n");
             return EXIT.ok;
         }
         if (v.version) {

package/dist/cli/menu-links.js

@@ -20,7 +20,7 @@ import { appWindow } from "../core/appbrowser.js";
 import { moveTree } from "./move.js";
 import { changeLines } from "../core/changelog.js";
 import { startLive } from "../core/live.js";
-import { adoptAppUrl, appTreeNameFromInstall, defaultAppUrl } from "../core/stromapp.js";
+import { adoptAppUrl, appTreeNameFromInstall, defaultAppUrl, stromAppUrl } from "../core/stromapp.js";
 import { stromReadsTags } from "../gedcom/export.js";
 import { appMarkFromInstall } from "../core/links.js";
 import { settleFromApp } from "./wizard.js";
@@ -288,6 +288,9 @@ export async function newFromApp(ctx, runIn, token, openAt, forward, opts = {})
             ctx.settings.config.stromAppUrl = move.mark.app;
         ctx.settings.save();
     }
+    // a strom.app.url that is no address of the app: refused before anything is asked or made — the tree's way back
+    // would be an address built on it with the bridge's secret (B1-c)
+    stromAppUrl(ctx.settings);
     let lang = ctx.uiLang();
     let t = translator(lang);
     out(ctx, t("ui.link.new.title"));

package/dist/cli/menu.js

@@ -24,7 +24,7 @@ import { lacksImages } from "../core/queue.js";
 import { othersAtWork } from "../core/session.js";
 import { DEFAULT_RUN_MINUTES } from "../core/config.js";
 import { truncate } from "./format.js";
-import { installedStromApp, noticeStromApp, stromAppState, stromAppUrl } from "../core/stromapp.js";
+import { appUrlSetting, installedStromApp, noticeStromApp, stromAppState } from "../core/stromapp.js";
 import { appBrowsers } from "../core/chromium.js";
 import { liveWorkers, runsAtWork } from "../core/workers.js";
 import { askStromApp, settleInstall, shortcutName } from "./wizard.js";
@@ -344,7 +344,7 @@ export async function runMenu(ctx, run) {
             const app = stromAppState(ctx.settings);
             if (app !== "no") {
                 const atWork = liveWorkers(root).length > 0 || runsAtWork(root).length > 0;
-                const hasApp = app !== "unknown" || Boolean(installedStromApp(ctx.env, process.platform, stromAppUrl(ctx.settings)));
+                const hasApp = app !== "unknown" || Boolean(installedStromApp(ctx.env, process.platform, appUrlSetting(ctx.settings).url));
                 appItem = {
                     key: "7",
                     label: t(!hasApp ? "ui.menu.app.new" : atWork ? "ui.menu.app.watch" : "ui.menu.app"),
@@ -500,7 +500,7 @@ async function openStromApp(ctx, run, lang, said) {
             await run(["app"]);
         return;
     }
-    if (!installedStromApp(ctx.env, process.platform, stromAppUrl(ctx.settings)) && (await ctx.confirm(t("ui.app.notinstalled"), true))) {
+    if (!installedStromApp(ctx.env, process.platform, appUrlSetting(ctx.settings).url) && (await ctx.confirm(t("ui.app.notinstalled"), true))) {
         await run(["app", "install"]);
         return;
     }

package/dist/cli/registry.js

@@ -73,11 +73,28 @@ export function usageLine(def) {
     });
     return ["strom", ...def.path, ...args, (def.options?.some((o) => !o.hidden) || def.writes) ? "[options]" : ""].filter(Boolean).join(" ");
 }
+/**
+ * A command's description as it is said here: {appUrl} the copy of the Strom app `strom app` opens (stromAppUrl — the
+ * beta for a strom of the beta channel, strom.app.url where it says another; found: help app named stromapp.info on the
+ * beta).
+ */
+export function descriptionOf(def, appUrl) {
+    const said = def.description?.replace(/\{appUrl\}/g, appUrl.url);
+    // an address of no Strom app in the setting: the help names the default and says so (B1-b)
+    return said && appUrl.invalid && def.description.includes("{appUrl}") ? `${said}\n${APP_URL_INVALID}` : said;
+}
+/** What a help says under the address of the Strom app when strom.app.url says no address of it (B1-b). */
+export const APP_URL_INVALID = "Note: the setting strom.app.url (or STROM_APP_URL) is no address of the Strom app, so the address above is the default.\n" +
+    "Set it right (strom config set strom.app.url <address>) or remove it (strom config unset strom.app.url).";
+/** What strom config where / config get say under a strom.app.url that is no address of the Strom app (B1-e). */
+export const APP_URL_INVALID_SETTING = "Note: the setting strom.app.url (or STROM_APP_URL) is no address of the Strom app: strom app refuses it, and where only an address is named, the default is.\n" +
+    "Set it right (strom config set strom.app.url <address>) or remove it (strom config unset strom.app.url).";
 /** Catalog entry for `strom commands --json`: only what is there (empty fields are left out). */
-export function describe(def) {
+export function describe(def, appUrl) {
     const out = { command: def.path.join(" "), usage: usageLine(def), summary: def.summary, group: def.group };
-    if (def.description)
-        out.description = def.description;
+    const description = descriptionOf(def, appUrl);
+    if (description)
+        out.description = description;
     if (def.writes)
         out.writes = true;
     if (def.tree)

package/dist/cli/ui.js

@@ -242,6 +242,10 @@ export const UI = {
     "ui.doc.app.seen": "found on this computer",
     "ui.doc.app.no": "not wanted",
     "ui.doc.app.unknown": "not found",
+    "ui.doc.appurl": "address of the Strom app",
+    "ui.doc.appurl.config": "the setting strom.app.url \"{value}\" is no address of the Strom app — strom app opens nothing until it is set right or removed",
+    "ui.doc.appurl.env": "the variable STROM_APP_URL \"{value}\" is no address of the Strom app — strom app opens nothing until it is set right or removed",
+    "ui.doc.appurl.env.fix": "the variable STROM_APP_URL set to an address of the Strom app ({web}, or a copy on this computer http://127.0.0.1:<port>/), or removed",
     "ui.doc.tree.ok": "{name}: data consistent and sealed",
     "ui.doc.tree.bad": "{name}: {n} problem(s)",
     "ui.doc.allok": "Everything needed is in place.",
@@ -561,7 +565,7 @@ export const UI = {
     "ui.help.archive.stats": "The archive at a glance: people, how sure the facts are, ancestors in each generation",
     "ui.help.archive.pack": "Pack the archive into one ZIP file for someone to go on with it",
     "ui.help.archive.intake": "Add material from the family: documents, photos, a family tree, what the family knows",
-    "ui.help.title": "strom <command> — what a person does with strom (or just {strom}: the menu)",
+    "ui.help.title": "{strom} <command> — what a person does with strom (or just {strom}: the menu)",
     "ui.help.more": "Help for one command: strom help <command> --human · every command in English (what an agent reads): strom help",
     "ui.help.more.archive": "Help for one command: strom help <command> --human",
     "ui.help.examples": "Examples:",
@@ -762,11 +766,12 @@ export const UI = {
     "ui.live.app": "  the Strom app following it: {url}",
     "ui.live.stophow": "  stop: strom live stop",
     "ui.live.none": "the bridge does not run — strom live start (or strom app --live)",
-    "ui.live.moved": "  its address is new (its old port was taken): the Strom app finds it when the research is opened in it again — strom app --live",
+    "ui.live.moved": "  its address is new: the Strom app finds it when the research is opened in it again — strom app --live",
     "ui.live.stopped": "the bridge stopped",
     "ui.live.killed": "the bridge did not end when asked: it was ended for good",
     "ui.live.noneran": "no bridge ran",
     "ui.live.forgotten": "its address is forgotten: the next bridge gets a new one",
+    "ui.live.newsecret": "  the next bridge gets a new secret address: the Strom app gets it when the research is opened in it again — strom app",
     "ui.live.ended": "the bridge ended",
     "ui.guide.archive": "This family tree is an archive: the data come from the Strom app. What it holds: strom stats · strom person card <who> · strom pedigree <who> · strom recent. Research is switched on by the user alone: strom mode research (or the menu).",
     "ui.setup.links.archive": "Let the Strom app open the archive on this computer? (One click sends the edits back or opens an excerpt in full quality — each asked here first.)",
@@ -1346,6 +1351,10 @@ export const UI = {
     "ui.error.arg.missing": "<{arg}> is missing",
     "ui.error.arg.missing.hint": "strom help {cmd}",
     "ui.error.prefix": "error",
+    "ui.error.config.app-url": "invalid strom.app.url \"{value}\": no address of the Strom app",
+    "ui.error.config.app-url.hint": "the Strom app: {web}, or a copy on this computer http://127.0.0.1:<port>/",
+    "ui.error.config.app-url.config.hint": "the Strom app: {web}, or a copy on this computer http://127.0.0.1:<port>/\nset it right: strom config set strom.app.url <address> — or remove it: strom config unset strom.app.url",
+    "ui.error.config.app-url.env.hint": "the Strom app: {web}, or a copy on this computer http://127.0.0.1:<port>/\nthe variable STROM_APP_URL set right, or removed",
     "ui.error.backup.failed": "The backup before going from {from} to {to} could not be made: {detail}. Nothing is switched: this strom opens no family tree for writing until the backup is made.",
     "ui.error.backup.failed.hint": "Free room on the disk ({where}), then run strom again — or go back: strom update --channel {back}",
     "ui.error.backup.failed.update": "The backup before going from {from} to {to} could not be made: {detail}. Nothing was installed.",
@@ -1421,6 +1430,7 @@ export const UI = {
     "ui.arg.tree-name": "tree name",
     "ui.arg.url": "url",
     "ui.arg.value": "value",
+    "ui.arg.address": "address",
     "ui.arg.what": "what",
     "ui.arg.where": "where",
     "ui.arg.who": "who",
@@ -1449,7 +1459,7 @@ export const UI = {
     "ui.error.event.needs-reason.hint": "e.g. --reason \"record S0012 gives 1811, not 1813\"",
     "ui.error.family.needs-reason": "changing who belongs to a family, or how, needs --reason",
     "ui.error.family.needs-reason.hint": "e.g. --reason \"the baptism names Jan as stepfather\"",
-    "ui.error.person.needs-reason": "changing a name or a known sex needs --reason",
+    "ui.error.person.needs-reason": "changing a name, its title or a known sex needs --reason",
     "ui.error.person.needs-reason.hint": "e.g. --reason \"misread: the register has Novák, not Nowak\"",
     "ui.error.retract.needs-reason": "retracting needs --reason",
     "ui.error.retract.needs-reason.hint": "e.g. --reason \"misread: the entry names Anna, not Anton\"",

package/dist/cli/wizard.js

@@ -14,7 +14,7 @@ import { chooseWay, wayName } from "./ways.js";
 import { PROFILES } from "../agents/profiles.js";
 import { writeStored, PERMISSION_LEVELS } from "../core/config.js";
 import { globalTargets, installGlobal } from "../agents/global.js";
-import { appCopyOfInstall, appOpensLinks, defaultAppUrl, noticeStromApp, researchUrl, STROM_APP_URL, stromAppState, stromAppUrl } from "../core/stromapp.js";
+import { appCopyOfInstall, appOpensLinks, defaultAppUrl, noticeStromApp, researchUrl, STROM_APP_URL, stromAppState, appUrlSetting } from "../core/stromapp.js";
 import { openForUser } from "../core/open.js";
 import { createShortcut } from "../core/shortcut.js";
 import { appMarkFromInstall, linkFiles, linkHandlerState, linkOwner, registerLinks } from "../core/links.js";
@@ -355,8 +355,12 @@ export async function askStromApp(ctx, lang, back = ui(lang, "ui.browse.back"))
     ctx.settings.config.stromApp = answer === "no" ? "no" : "yes";
     ctx.settings.save();
     if (answer === "install") {
-        const url = stromAppUrl(ctx.settings);
-        ctx.io.stdout(ui(lang, openForUser(url, ctx.env) ? "ui.app.install" : "ui.app.url", { url }) + "\n");
+        // a strom.app.url that is no address of the app: nothing opened, said how it stands (strom doctor says how to put it right)
+        const said = appUrlSetting(ctx.settings);
+        if (said.invalid)
+            ctx.io.stdout(ui(lang, said.invalid.source === "env" ? "ui.doc.appurl.env" : "ui.doc.appurl.config", { value: said.invalid.value }) + "\n");
+        else
+            ctx.io.stdout(ui(lang, openForUser(said.url, ctx.env) ? "ui.app.install" : "ui.app.url", { url: said.url }) + "\n");
     }
     return answer;
 }

package/dist/commands/analysis.js

@@ -577,6 +577,9 @@ function haystack(r) {
             Object.values(v).forEach(add);
     };
     const { id: _i, type: _t, created: _c, updated: _u, ...rest } = r;
+    // a person's titles ("Ing.", "ml.") are never searched as their name — the Strom app finds nobody by them either
+    if (r.type === "person")
+        rest.names = r.names.map(({ prefix: _p, suffix: _s, ...n }) => n);
     add(rest);
     return parts.join(" \u0001 ");
 }

package/dist/commands/guide.js

@@ -3,7 +3,9 @@
 // sessions and costs tokens every time. Every command in it must exist
 // (test/cli/examples.test.ts checks them against the registry).
 import { langName } from "../core/lang.js";
-export function guideText(lang) {
+import { appSite } from "../core/stromapp.js";
+/** The guide; appUrl: the Strom app's address it names — the one `strom app` opens (appUrlShown). */
+export function guideText(lang, appUrl) {
     const language = lang
         ? `The research language of this tree is ${langName(lang)} (${lang}): talk to the user in ${langName(lang)} and write notes, tasks and stories in ${langName(lang)}. Keep transcripts of records in their original language.`
         : "Talk to the user in their language. Set it as the research language: strom setup --lang <code> (cs, en, de, pl, …).";
@@ -181,11 +183,11 @@ output/tree-strom.ged (for the Strom app) — both from the same evidence, also
 Changes are committed automatically; you never run git yourself.
 
 THE STROM APP — where the user sees the result
-  The Strom app (https://stromapp.info) is strom's companion: a free family tree app, no account,
+  The Strom app (${appSite(appUrl)}) is strom's companion: a free family tree app, no account,
   the family's data stay on their computer; it shows the tree, the sources, a map, a family book.
   When the user wants to see the results, or when strom says to offer it (once, not in every
   conversation), suggest it gently, in a sentence or two — best installed as an app from the browser, then it works offline:
-  https://stromapp.info/run/   the app itself: opened in the browser, installed from there (the
+  ${appUrl}   the app itself: opened in the browser, installed from there (the
                         install icon at the end of the address bar; Safari: File → Add to Dock)
   strom app install     opens it there and says where to click
   strom app             opens it — with this research when the app can take it (strom says so), and

package/dist/commands/meta.js

@@ -5,7 +5,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { newerVersion } from "../core/update.js";
 import { mb, tidyPlan, TIDY_SAID } from "../core/tidy.js";
-import { appOpensResearch, installedStromApp, stromAppUrl } from "../core/stromapp.js";
+import { appOpensResearch, appUrlSetting, appUrlShown, installedStromApp } from "../core/stromapp.js";
 import { register, commands, describe, GROUPS } from "../cli/registry.js";
 import { UsageError } from "../core/errors.js";
 import { helpAs } from "../cli/help.js";
@@ -88,7 +88,7 @@ function orientation(ctx) {
     // What a conversation tells the user once, not again after it starts afresh (a new conversation, /clear): the Strom app, the stories, asking here.
     const told = ctx.settings.config.told ?? {};
     if (fs.existsSync(file))
-        base.results = { file, app: !wanted ? "not-wanted" : installedStromApp(ctx.env, process.platform, stromAppUrl(ctx.settings)) ? "installed" : "offer", ...(told.app ? { told: true } : {}) };
+        base.results = { file, app: !wanted ? "not-wanted" : installedStromApp(ctx.env, process.platform, appUrlSetting(ctx.settings).url) ? "installed" : "offer", ...(told.app ? { told: true } : {}) };
     const vision = ctx.settings.models(ctx.settings.agent(tree.config).value, tree.config).vision;
     if (vision) {
         const other = readByOtherModels(tree, vision);
@@ -185,7 +185,7 @@ register({
                         ? appOpensResearch(ctx.settings) && !o.results.told ? "ui.o.results.installed.live" : "ui.o.results.installed"
                         : o.results.app === "offer"
                             ? o.results.told ? "ui.o.results.offered" : appOpensResearch(ctx.settings) ? "ui.o.results.offer.live" : "ui.o.results.offer"
-                            : "ui.o.results.plain", { file: ctx.display(o.results.file), url: stromAppUrl(ctx.settings) }))
+                            : "ui.o.results.plain", { file: ctx.display(o.results.file), url: appUrlSetting(ctx.settings).url }))
                 : undefined, archive ? row(t("ui.o.mode"), t("ui.o.mode.archive")) : undefined, o.stories && !archive ? row(t("ui.o.stories"), t(`ui.o.stories.${o.stories}`)) : undefined, o.ask && !archive ? row(t("ui.o.ask"), t("ui.o.ask.tell")) : undefined, o.reread && !archive ? row(t("ui.o.reread"), t("ui.o.reread.offer", { n: o.reread.facts, models: o.reread.models.join(", "), model: o.reread.model })) : undefined, o.researches?.length
                 ? t("ui.o.research") + "\n" + table(o.researches.map((r) => [`  ${r.id}`, r.name, `[${r.state}]`, r.focus]))
                 : t("ui.o.research.none"), o.working?.length
@@ -209,7 +209,7 @@ register({
             const said = ui(ctx.tree().lang, "ui.guide.archive");
             return { text: said, data: { guide: said, lang, archive: true } };
         }
-        const text = guideText(lang);
+        const text = guideText(lang, appUrlShown(ctx.settings).url);
         return { text, data: { guide: text, lang } };
     },
 }, {
@@ -218,7 +218,7 @@ register({
     group: "start",
     args: [{ name: "filter", description: "only commands starting with these words, or of this group", variadic: true }],
     examples: ["strom commands", "strom commands source --json", "strom commands analysis"],
-    run(_ctx, { args }) {
+    run(ctx, { args }) {
         const words = args.flatMap((a) => a.split(/\s+/)).filter(Boolean);
         const prefix = words.join(" ");
         const defs = commands().filter((c) => c.path.length > 0 && (!prefix || c.group === prefix || c.path.join(" ") === prefix || c.path.join(" ").startsWith(`${prefix} `)));
@@ -231,7 +231,8 @@ register({
         })
             .filter(Boolean)
             .join("\n\n");
-        return { text, data: { version: VERSION, commands: defs.map(describe) } };
+        const appUrl = appUrlShown(ctx.settings);
+        return { text, data: { version: VERSION, commands: defs.map((d) => describe(d, appUrl)), ...(appUrl.invalid ? { invalid: ["strom.app.url"] } : {}) } };
     },
 }, {
     path: ["help"],
@@ -247,7 +248,7 @@ register({
         // the agent's help, whoever asks — a person's only with --human (Milan, 2026-10-04); a person at a terminal is told
         // how in a line of their language
         const human = Boolean(input.opts.human) && !input.opts.agent;
-        const text = helpAs(input.args, { archive: ctx.archiveHere(), human, lang: ctx.uiLang(), pointer: !human && ctx.io.tty && !isAgent(ctx.env) });
+        const text = helpAs(input.args, { archive: ctx.archiveHere(), human, lang: ctx.uiLang(), appUrl: appUrlShown(ctx.settings), pointer: !human && ctx.io.tty && !isAgent(ctx.env) });
         return { text, data: { help: text } };
     },
 });