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

package/assets/lang/cs.json

@@ -275,6 +275,9 @@
   "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.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 +657,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:",
@@ -1496,6 +1499,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 +1594,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 +1622,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,9 @@
   "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.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 +657,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:",
@@ -1496,6 +1499,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 +1594,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 +1622,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/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,9 @@ 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.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 +564,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:",
@@ -1346,6 +1349,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 +1428,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 +1457,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/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
@@ -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 } };
     },
 });

package/dist/commands/setup.js

@@ -3,7 +3,7 @@ import { gitSize, lastCompacted } from "../core/history.js";
 import fs from "node:fs";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
-import { register } from "../cli/registry.js";
+import { APP_URL_INVALID_SETTING, register } from "../cli/registry.js";
 import { lines, table } from "../cli/format.js";
 import { checkValue, configFile, DEFAULT_BUDGET, DEFAULT_RUN_MINUTES, OTHER_ENV, SETTINGS, settingDef, writeStored } from "../core/config.js";
 import { syncAgentFiles } from "../agents/files.js";
@@ -27,7 +27,7 @@ import { configDir, defaultHome, desktopDir, isolated, noLinks, ownCommand } fro
 import { backupBefore, backupSaid, lastBackupLine } from "../cli/backups.js";
 import { BACKUP_SAID_DAYS, lastBackup } from "../core/backup.js";
 import { planMove, sameFolder } from "../core/relocate.js";
-import { appOpensLinks, defaultAppUrl, researchUrl, stromAppUrl, stromAppState } from "../core/stromapp.js";
+import { appOpensLinks, appUrlSetting, researchUrl, stromAppUrl, stromAppState } from "../core/stromapp.js";
 import { isInstalled } from "../agents/global.js";
 import { offerLinks, shortcutName } from "../cli/wizard.js";
 import { linkHandlerState, linkScheme } from "../core/links.js";
@@ -357,6 +357,11 @@ function diagnose(ctx) {
         add("app", "ok", t("ui.doc.app.isolated"));
     else
         add("app", "ok", t(`ui.doc.app.${app}`), app === "unknown" ? FIX : undefined, app === "unknown" ? "app" : undefined);
+    // the copy of the app strom opens: a setting that says no address of it (STROM_APP_URL, or written by hand into the
+    // settings) is a problem said with its way out — doctor never fails on it (strom app refuses to open it)
+    const appUrl = appUrlSetting(ctx.settings).invalid;
+    if (appUrl)
+        add("appurl", "fail", t(appUrl.source === "env" ? "ui.doc.appurl.env" : "ui.doc.appurl.config", { value: appUrl.value }), appUrl.source === "env" ? undefined : placeholders(lang, "strom config set strom.app.url <address> · strom config unset strom.app.url"));
     // …and whether it may start the research here (strom-research:// links): only while the app is wanted
     if (app !== "no" && appOpensLinks(ctx.settings)) {
         const links = linkHandlerState(ctx.env);
@@ -404,7 +409,8 @@ async function repair(ctx, checks, out) {
     }
     if (todo.has("links") && person)
         await offerLinks(ctx, lang);
-    if (todo.has("app") && person && (await ctx.confirm(ui(lang, "ui.fix.app"), false))) {
+    // (never into the address of an invalid strom.app.url: its check says how to put it right)
+    if (todo.has("app") && person && !appUrlSetting(ctx.settings).invalid && (await ctx.confirm(ui(lang, "ui.fix.app"), false))) {
         openForUser(stromAppUrl(ctx.settings), ctx.env);
         out(ui(lang, "ui.app.install"));
     }
@@ -607,6 +613,15 @@ function treeSettings(ctx) {
 /** Effective value of a setting, with the default filled in. */
 function effective(ctx, def) {
     const s = ctx.settings;
+    // the address of the Strom app: read as everything reads it (appUrlSetting) — never failing; one that is no address of
+    // the app is shown as found, marked invalid (B1-e)
+    if (def.key === "strom.app.url") {
+        const said = appUrlSetting(s);
+        if (said.invalid)
+            return { value: said.invalid.value, source: said.invalid.source, invalid: true };
+        const r = s.resolve(def.key);
+        return r ?? { value: said.url, source: "default" };
+    }
     const tree = treeSettings(ctx);
     if (def.key === "home")
         return s.home() ?? { value: undefined, source: "unset" };
@@ -631,8 +646,6 @@ function effective(ctx, def) {
         return { value: DEFAULT_RUN_MINUTES, source: "default" };
     if (def.key === "connectors.consent")
         return { value: "off", source: "default" };
-    if (def.key === "strom.app.url")
-        return { value: defaultAppUrl(ctx.env), source: "default" };
     if (def.key === "browser.downloads")
         return { value: downloadsDir(ctx.env), source: "detected" };
     if (def.key === "agent.permissions")
@@ -749,10 +762,11 @@ register({
     run(ctx) {
         const rows = SETTINGS.map((def) => {
             const r = effective(ctx, def);
-            return { key: def.key, value: r.value, source: r.source, env: def.env, tree: def.tree, description: def.description };
+            return { key: def.key, value: r.value, source: r.source, env: def.env, tree: def.tree, description: def.description, ...(r.invalid ? { invalid: true } : {}) };
         });
-        const text = lines(table(rows.map((r) => [r.key, display(ctx, settingDef(r.key), r.value), r.source, r.env])), "", "order: flag > env > tree (strom.json) > config > default", `change: strom config set <key> <value> [--for-tree]  ·  strom config unset <key> [--for-tree]`, `other env: ${OTHER_ENV.map((e) => e.env).join(" ")}  (strom help config where)`, `config file: ${ctx.display(configFile(ctx.env))}`);
-        return { text, data: { settings: rows, otherEnv: OTHER_ENV, file: configFile(ctx.env) } };
+        const invalid = rows.filter((r) => r.invalid).map((r) => r.key);
+        const text = lines(table(rows.map((r) => [r.key, `${display(ctx, settingDef(r.key), r.value)}${r.invalid ? "  (invalid)" : ""}`, r.source, r.env])), "", ...(invalid.length ? [APP_URL_INVALID_SETTING, ""] : []), "order: flag > env > tree (strom.json) > config > default", `change: strom config set <key> <value> [--for-tree]  ·  strom config unset <key> [--for-tree]`, `other env: ${OTHER_ENV.map((e) => e.env).join(" ")}  (strom help config where)`, `config file: ${ctx.display(configFile(ctx.env))}`);
+        return { text, data: { settings: rows, otherEnv: OTHER_ENV, file: configFile(ctx.env), ...(invalid.length ? { invalid } : {}) } };
     },
     description: "Settings a tree can carry (lang, agent, model.*, brief.budget, run.minutes) are set per tree with --for-tree.\n" +
         OTHER_ENV.map((e) => `${e.env}: ${e.description}`).join("\n"),
@@ -764,7 +778,11 @@ register({
     run(ctx, { args }) {
         const def = settingDef(args[0]);
         const r = effective(ctx, def);
-        return { text: r.value === undefined ? "" : display(ctx, def, r.value), data: { key: def.key, value: r.value, source: r.source } };
+        const shown = r.value === undefined ? "" : display(ctx, def, r.value);
+        // a strom.app.url that is no address of the app: as found, and said so (B1-e)
+        if (r.invalid)
+            return { text: lines(`${shown}  (invalid)`, APP_URL_INVALID_SETTING), data: { key: def.key, value: r.value, source: r.source, invalid: [def.key] } };
+        return { text: shown, data: { key: def.key, value: r.value, source: r.source } };
     },
 }, {
     path: ["config", "set"],
@@ -778,7 +796,7 @@ register({
     examples: ["strom config set lang cs", 'strom config set shared "/Volumes/Big/strom-shared"', "strom config set model.vision opus --for-tree", "strom config set run.minutes 45"],
     run: async (ctx, { args, opts }) => {
         const def = settingDef(args[0]);
-        const value = checkValue(def, args[1], (p) => ctx.resolvePath(p));
+        const value = checkValue(def, args[1], (p) => ctx.resolvePath(p), ctx.env);
         // In their own terminal the user reads what full means and says yes once more.
         if (def.key === "agent.permissions" && value === "full" && ctx.settings.agentPermissions() !== "full" && !opts["for-tree"] && ctx.interactive && !isAgent(ctx.env)) {
             const lang = ctx.uiLang();

package/dist/commands/start.js

@@ -19,7 +19,7 @@ import { assertIntact } from "../core/integrity.js";
 import { agentBrowser } from "../core/connector.js";
 import { browserNote } from "./connectors.js";
 import { offerLinks } from "../cli/wizard.js";
-import { appOpensLinks, appOpensResearch, importAppUrl, installedStromApp, liveAppUrl, noticeStromApp, STROM_APP_URL, stromAppUrl } from "../core/stromapp.js";
+import { appOpensLinks, appOpensResearch, appUrlSetting, importAppUrl, installedStromApp, liveAppUrl, liveAppUrlShown, noticeStromApp, stromAppUrl } from "../core/stromapp.js";
 import { forgetLive, liveRunning, serveLive, startLive, stopLive } from "../core/live.js";
 import { openForUser } from "../core/open.js";
 import { createShortcut, openInNewTerminal } from "../core/shortcut.js";
@@ -72,6 +72,21 @@ function bridgeTree(ctx) {
     const tree = ctx.tree();
     return { root: tree.root, lang: tree.lang };
 }
+/**
+ * What strom live and live start say of the app that follows the bridge: its address — or, where strom.app.url says no
+ * address of the app, how that stands, and no address built on it with the bridge's secret (the bridge runs all the same).
+ */
+function liveAppLine(ctx, lang, bridge) {
+    const url = liveAppUrlShown(bridge, ctx.settings);
+    if (url)
+        return ui(lang, "ui.live.app", { url });
+    const bad = appUrlSetting(ctx.settings).invalid;
+    return ui(lang, bad.source === "env" ? "ui.doc.appurl.env" : "ui.doc.appurl.config", { value: bad.value });
+}
+function liveAppData(ctx, bridge) {
+    const url = liveAppUrlShown(bridge, ctx.settings);
+    return url ? { app: url } : {};
+}
 register({
     path: ["chat"],
     summary: "Talk with the AI agent about the research — in its desktop app or in this terminal, set up the way you chose",
@@ -209,7 +224,7 @@ register({
     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). Each entry comes with its image,\n` +
-        `cut out of its scan (the settings excerpts.*; excerpts.for none: without). Web: ${STROM_APP_URL}`,
+        `cut out of its scan (the settings excerpts.*; excerpts.for none: without). Web: {appUrl}`,
     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)" },
@@ -217,6 +232,9 @@ register({
     examples: ["strom app", "strom app --live", "strom app install"],
     async run(ctx, { opts }) {
         const lang = ctx.uiLang();
+        // a strom.app.url that is no address of the app (the variable, or written by hand into the settings): refused
+        // before anything starts — nothing opened, no address built on it with the bridge's secret (B1-c)
+        stromAppUrl(ctx.settings);
         const root = appOpensResearch(ctx.settings) ? ctx.locateTree() : undefined;
         if (root) {
             const tree = Tree.open(root, ctx.env);
@@ -308,7 +326,7 @@ register({
         const lang = tree.lang;
         const info = liveRunning(tree.root);
         return info
-            ? { text: lines(ui(lang, "ui.live.runs", { url: info.url }), ui(lang, "ui.live.app", { url: liveAppUrl(info.url, ctx.settings) }), ui(lang, "ui.live.stophow")), data: { running: true, ...info, app: liveAppUrl(info.url, ctx.settings) } }
+            ? { text: lines(ui(lang, "ui.live.runs", { url: info.url }), liveAppLine(ctx, lang, info.url), ui(lang, "ui.live.stophow")), data: { running: true, ...info, ...liveAppData(ctx, info.url) } }
             : { text: ui(lang, "ui.live.none"), data: { running: false } };
     },
 }, {
@@ -324,8 +342,8 @@ register({
         if (!info)
             throw new StromError("the bridge did not start", { hint: "strom live serve shows why", code: "live.not-started" });
         return {
-            text: lines(ui(lang, "ui.live.runs", { url: info.url }), ui(lang, "ui.live.app", { url: liveAppUrl(info.url, ctx.settings) }), info.moved ? ui(lang, "ui.live.moved") : undefined),
-            data: { ...info, app: liveAppUrl(info.url, ctx.settings) },
+            text: lines(ui(lang, "ui.live.runs", { url: info.url }), liveAppLine(ctx, lang, info.url), info.moved ? ui(lang, "ui.live.moved") : undefined),
+            data: { ...info, ...liveAppData(ctx, info.url) },
         };
     },
 }, {

package/dist/commands/sync.js

@@ -19,7 +19,7 @@ import { isArchive } from "../core/mode.js";
 import { applySync, discardReceived, nothingSince, withoutImages, planSync, readTreeFile, receivedAll, receivedPending, receivedSince, receivedOf, settleReceived, SYNC_INBOX, syncConflicts, undoReceived, undoSync } from "../core/sync.js";
 import { labels } from "../gedcom/labels.js";
 import { startLive } from "../core/live.js";
-import { appSendsChanges, sendAppUrl } from "../core/stromapp.js";
+import { appSendsChanges, sendAppUrl, stromAppUrl } from "../core/stromapp.js";
 import { appWindow, openAppIn, replaceGone } from "../core/appbrowser.js";
 import { isAgent } from "../core/which.js";
 /**
@@ -181,6 +181,8 @@ async function fromApp(ctx, tree, lang) {
     const root = tree.root;
     if (!appSendsChanges(ctx.settings))
         return { text: ui(lang, "ui.sync.nosend") };
+    // a strom.app.url that is no address of the app: refused before the bridge starts — no address built on it (B1-c)
+    stromAppUrl(ctx.settings);
     // what the app sends the bridge writes at once (unless the user reviews each send): what came of it is said, not shown to write
     const atOnce = isArchive(tree) || !ctx.settings.syncReview(tree.config);
     const info = startLive(root, ctx.env, { current: true });

package/dist/core/appbrowser.js

@@ -6,7 +6,7 @@
 // Never one it cannot reach strom from (Safari). A tree handed over (`holdsTree`: ?adopt=) waits in the storage of
 // the browser it came from: there only — its app, else its tab — while that browser is here.
 import { appBrowsers, browserKind, browserName, defaultBrowser, openInBrowser, openWebApp } from "./chromium.js";
-import { installedStromApps, stromAppUrl } from "./stromapp.js";
+import { appUrlSetting, installedStromApps } from "./stromapp.js";
 /**
  * Where the Strom app opens on this computer — nothing when no browser here reaches strom. `holdsTree`: the address
  * needs the app's storage in the browser its tree came from (a tree handed over), so another browser's app is no use.
@@ -14,7 +14,7 @@ import { installedStromApps, stromAppUrl } from "./stromapp.js";
 export function appWindow(settings, env, platform = process.platform, opts = {}) {
     const reach = appBrowsers(env, platform);
     // the copies of the app (strom.app.url) installed from a browser that is here
-    const apps = installedStromApps(env, platform, stromAppUrl(settings)).filter((a) => a.appId && a.browser && reach.some((b) => b.name === a.browser));
+    const apps = installedStromApps(env, platform, appUrlSetting(settings).url).filter((a) => a.appId && a.browser && reach.some((b) => b.name === a.browser));
     const appOf = (b) => {
         const a = b && apps.find((x) => x.browser === b.name);
         return a?.appId && a.browser ? { browser: a.browser, appId: a.appId, ...(a.profile ? { profile: a.profile } : {}) } : undefined;