strom-research 1.12.1 → 1.13.0-beta.1

package/README.md

@@ -152,6 +152,35 @@ npm run release                       # release/: strom-app.tar.gz, SHASUMS256.t
 
 Zero runtime dependencies: TypeScript on Node's built-ins, and git.
 
+## A second strom beside the first
+
+For testers and developers: another version of strom, e.g. to try one, next to
+the one you use — with its own command, program folder, settings and research
+folder, so the two never share data.
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/ACiDekCZ/strom-research/main/install/install.sh | \
+  STROM_ISOLATED=1 STROM_INSTALL_DIR="$HOME/strom-try" STROM_CONFIG_DIR="$HOME/.config/strom-try" \
+  STROM_COMMAND=strom-try sh
+```
+
+Windows (PowerShell):
+`$env:STROM_ISOLATED='1'; $env:STROM_INSTALL_DIR="$env:LOCALAPPDATA\Programs\Strom-try"; $env:STROM_CONFIG_DIR="$env:APPDATA\strom-try"; $env:STROM_COMMAND='strom-try'; irm https://raw.githubusercontent.com/ACiDekCZ/strom-research/main/install/install.ps1 | iex`
+
+- `STROM_ISOLATED=1` with `STROM_INSTALL_DIR` and `STROM_CONFIG_DIR`: the
+  program and its settings live in those folders only; it teaches no agent,
+  puts no shortcut on the desktop and leaves your `strom` alone.
+- `STROM_COMMAND=strom-<letters and digits>` (optional): the command it starts
+  with, next to `strom` (macOS, Linux: `~/.local/bin`; Windows: a `bin` folder
+  of its own on your PATH). It never overwrites a command it did not write. Its
+  research folder is suggested as `Documents/Strom <name>` (`Strom try`), and
+  links from the Strom app can reach it as `strom-research-<name>://` (on your
+  yes, as with the first). Without a command it is started by its full path and
+  takes no links.
+- To remove it: `strom-try uninstall` — its command, its links, its PATH entry
+  and its program folder go; its settings and research stay (delete them by
+  hand when not needed), and so does the first strom with everything of it.
+
 ## License
 
 Copyright © 2026 Milan Víšek.

package/assets/lang/cs.json

@@ -62,6 +62,9 @@
   "ui.dialog.refused": "Nepovoleno – nic se nezměnilo.",
   "ui.link.isolated": "Tohle je izolovaná instalace (STROM_ISOLATED): odkazy strom-research:// nezapisuje – zůstávají běžné instalaci stromu.",
   "ui.doc.isolated": "izolovaná instalace v {folder}",
+  "ui.doc.second": "druhá instalace: příkaz {command}, ve složce {folder}, její odkazy {scheme}://",
+  "ui.doc.home.regular": "je to i složka běžného stromu: dvě instalace nad jedním výzkumem",
+  "ui.doc.home.program": "ve složce programu strom – aktualizace nebo odinstalace by ji mohla vzít; lépe přesunout jinam (strom setup v terminálu ji přesune i s výzkumem)",
   "ui.doc.knows.isolated": "izolovaná instalace: agenty mimo ni nic neučí",
   "ui.doc.links.isolated": "izolovaná instalace: odkazy nezapisuje",
   "ui.doc.app.isolated": "izolovaná instalace: úmyslně se nepoužívá",
@@ -74,6 +77,8 @@
   "ui.consent.connector.revoke": "Zastavit stahovač „{name}“?",
   "ui.consent.host": "Povolit automatické stahování z {host}?",
   "ui.consent.host.revoke": "Zastavit automatické stahování z {host}?",
+  "ui.consent.elsewhere.connector": "Spustit stahovač „{name}“? Žádá o to agent mimo složku výzkumu ({cwd}).",
+  "ui.consent.elsewhere.run": "Spustit samostatnou práci agenta na výzkumu „{tree}“? Žádá o to agent mimo složku výzkumu ({cwd}); práce stojí peníze.",
   "ui.consent.connectors.off": "Nechat stahovače běžet bez ptaní předem?",
   "ui.menu.title": "Strom výzkum {version}",
   "ui.menu.tree": "Rodokmen: {name} · osob: {persons}",
@@ -150,6 +155,7 @@
   "ui.consent.connector.hosts": "Připojí se jen k {hosts} – pomalu, přes omezovač stromu.",
   "ui.consent.connector.changed": "Jeho kód se od povolení změnil.",
   "ui.consent.connector.direct": "Pozor: jeho kód se připojuje k síti sám, mimo omezovač stromu.",
+  "ui.consent.connector.unfenced": "Pozor: spouští program, který strom neohraničí ({run}) – může číst a měnit všechny soubory tohoto uživatele, spouštět jiné programy a připojit se kamkoli. Po každé změně jeho kódu se dotaz zopakuje.",
   "ui.consent.connector.terms": "Podmínky užití archivu: {terms}",
   "ui.consent.host.unblock": "{host} nás odmítl. Povolit znovu – jen pokud archiv řekl, že je to v pořádku?",
   "ui.menu.otheragent": "Tentokrát mluvit s jiným agentem nebo jinde",
@@ -253,6 +259,8 @@
   "ui.doc.app": "aplikace Strom",
   "ui.doc.tree": "tento rodokmen",
   "ui.doc.innode": "strom {version} v Node {node}",
+  "ui.doc.fence": "stahovače v ohrádce",
+  "ui.doc.fence.net": "Node {node}: stahovače běží v ohrádce, ale síť jim zavře až Node 25 nebo novější",
   "ui.doc.oldnode": "Node {node} je příliš starý (potřeba 22.18 nebo novější)",
   "ui.doc.missing": "chybí",
   "ui.doc.notsetup": "zatím nenastaveno",
@@ -396,7 +404,9 @@
   "ui.uninstall.npm": "Samotný program (nainstalovaný přes npm): npm uninstall -g strom-research",
   "ui.uninstall.done": "strom je odinstalovaný. Děkujeme za bádání s ním.",
   "ui.uninstall.running": "strom z této instalace ještě běží v jiném okně ({list}): zavřít ho – menu, rozhovor, práci agenta – a spustit strom uninstall znovu. Nic se neodebralo.",
-  "ui.uninstall.later": "zmizí, jakmile se toto okno zavře",
+  "ui.uninstall.folderKept": "Složka {folder} zůstává: je v ní, co do ní strom nedal ({what}).",
+  "ui.uninstall.later": "zmizí několik sekund po skončení tohoto příkazu",
+  "ui.uninstall.skipped": "{path} je v install.json uveden jako spouštěč programu strom, ale spouštěč to není (jiné jméno, nebo leží ve výzkumu) – zůstává.",
   "ui.menu.update.line": "Vyšla nová verze stromu: {version}.",
   "ui.menu.update": "Aktualizovat strom na {version}",
   "ui.doc.update": "nová verze",
@@ -404,7 +414,7 @@
   "ui.update.unknown": "Nepodařilo se zjistit nejnovější verzi stromu.",
   "ui.update.current": "strom {version} je nejnovější verze.",
   "ui.update.available": "Vyšla nová verze: {version} (tato je {current}) – nainstaluje ji strom update.",
-  "ui.update.npm": "Vyšla nová verze: {version}. strom je tu nainstalovaný přes npm: npm install -g strom-research@latest",
+  "ui.update.npm": "Vyšla nová verze: {version}. strom je tu nainstalovaný přes npm: npm install -g strom-research@{tag}",
   "ui.update.sure": "Aktualizovat strom z {current} na {version}? Výzkumy zůstanou, jak jsou.",
   "ui.update.later": "Teď ne – kdykoli strom update.",
   "ui.update.downloading": "Stahuji strom {version}…",
@@ -432,6 +442,19 @@
   "ui.update.node.sure": "Aktualizovat Node stromu z {from} na {to} (bezpečnostní opravy)?",
   "ui.update.node.done": "✓ Node je aktualizovaný: {from} → {to}.",
   "ui.update.bridges": "Živé sledování v aplikaci Strom pokračuje s novou verzí ({n}).",
+  "ui.update.npm.channel": "strom je tu nainstalovaný přes npm: npm install -g strom-research@{tag}",
+  "ui.update.channel.beta.sure": "Přepnout strom na beta verze: {current} → {version}?",
+  "ui.update.channel.stable.sure": "Vrátit strom k vydaným verzím: {current} → {version}?",
+  "ui.update.channel.beta.now": "Od teď strom bere beta verze.",
+  "ui.update.channel.stable.now": "Od teď strom bere vydané verze.",
+  "ui.update.older": "{version} je starší verze než {current}; výzkumy zůstanou, jak jsou.",
+  "ui.update.stays": "Výzkumy zůstanou, jak jsou.",
+  "ui.doc.beta": "beta verze",
+  "ui.doc.backup": "záloha",
+  "ui.backup.made": "Záloha před přechodem z {from} na {to}: {path} ({size}).",
+  "ui.backup.last": "Poslední záloha (před přechodem z {from} na {to}, {date}): {path}",
+  "ui.backup.readme": "Strom výzkum – záloha\n\nVytvořena {date}, před přechodem ze stromu {from} na {to}.\n\nUvnitř:\n- trees: všechny rodokmeny tohoto počítače, každý celou svou složkou i s historií (.git);\n- settings: nastavení stromu s klíči pečetí a přihlášeními, jak byly na tomto počítači.\n\nNení uvnitř: sdílené obrázky (složka shared/media). Každý je tam uložen podle svého obsahu a strom žádný nemaže; každá verze stromu čte tytéž. Vynecháno je i to, co strom vytvoří znovu sám (náhledy skenů, výřezy).\n\nVrácení rodokmenu: zkopírovat jeho složku z trees zpět tam, kde rodokmeny jsou (místo té, která tam je, nebo vedle ní pod jiným jménem), a spustit strom: strom ho zkontroluje (strom check).",
+  "ui.trees.locked": "zamčeno: zapsal strom {by}",
   "ui.setup.stromapp": "Aplikace Strom (zdarma, v prohlížeči) ukáže výzkum jako rodokmen – u každého zápisu jeho obrázek vyříznutý ze skenu, příběhy předků – a když agent pracuje, sleduje výzkum živě. Používat ji?",
   "ui.setup.stromapp.install": "Ano – nainstalovat ji teď (otevře se v prohlížeči, strom řekne, kam kliknout)",
   "ui.setup.stromapp.later": "Ano, ale teď ne",
@@ -1304,6 +1327,7 @@
   "ui.home.stays": "Výzkum zůstává ve složce {from}.",
   "ui.home.inside": "{to} je uvnitř složky výzkumu {from} (nebo naopak) – vybrat složku mimo ni.",
   "ui.home.notEmpty": "Ve složce {to} už něco je – výzkum se přesune jen do prázdné nebo nové složky.",
+  "ui.home.program": "{to} leží ve složce programu strom – aktualizace nahrazuje, co tam je; je potřeba složka mimo ni.",
   "ui.home.busy": "V rodokmenu {trees} teď někdo pracuje (agent, samostatná práce nebo živé sledování v aplikaci Strom) – výzkum půjde přesunout, až skončí.",
   "ui.home.failed": "Přesunout se nepodařilo ({reason}) – nic se nezměnilo.",
   "ui.app.notinstalled": "Aplikace Strom na tomto počítači ještě není nainstalovaná. Nainstalovat ji teď jako aplikaci z prohlížeče (zdarma; strom ukáže, kam kliknout)?",
@@ -1467,6 +1491,23 @@
   "ui.error.arg.missing": "chybí <{arg}>",
   "ui.error.arg.missing.hint": "strom help {cmd}",
   "ui.error.prefix": "chyba",
+  "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.",
+  "ui.error.backup.failed.update.hint": "Uvolnit místo na disku ({where}) a znovu strom update --channel {channel}",
+  "ui.error.folder.in-program": "{folder} leží ve složce programu strom {program} – aktualizace ji nahrazuje a odinstalace odstraňuje, výzkum by šel s ní. Nic se nezměnilo.",
+  "ui.error.folder.in-program.hint": "Zvolit složku mimo ni, například {suggested}",
+  "ui.error.folder.in-program.default.hint": "Zadat složku mimo ni: strom setup --home \"{suggested}\" --yes",
+  "ui.error.update.in-program": "{folder} leží uvnitř {entry}, kterou aktualizace nahrazuje – výzkum by šel s ní. Nic se nenainstalovalo.",
+  "ui.error.update.in-program.hint": "Nejdřív přesunout výzkum ze složky programu strom: strom setup ve vlastním terminálu (otázka na složku ho přesune i s výzkumem), pak znovu strom update",
+  "ui.error.tree.newer": "Tento rodokmen zapsal strom {by}, novější než tento strom {version}. Tento strom ho nechává beze změny.",
+  "ui.error.tree.newer.hint": "Aktualizovat strom: strom update",
+  "ui.error.tree.newer.backup": "Tento rodokmen zapsal strom {by}, novější než tento strom {version}. Tento strom ho nechává beze změny.",
+  "ui.error.tree.newer.backup.hint": "Aktualizovat strom: strom update\nZáloha z doby před přechodem: {backup}",
+  "ui.error.tree.newer.beta": "Tento rodokmen zapsal strom {by}, novější než tento strom {version}. Tento strom ho nechává beze změny.",
+  "ui.error.tree.newer.beta.hint": "Vrátit se k betě: strom update --channel beta – nebo počkat na vydání {release}",
+  "ui.error.tree.newer.beta.backup": "Tento rodokmen zapsal strom {by}, novější než tento strom {version}. Tento strom ho nechává beze změny.",
+  "ui.error.tree.newer.beta.backup.hint": "Vrátit se k betě: strom update --channel beta – nebo počkat na vydání {release}\nZáloha z doby před přechodem: {backup}",
   "log.input.app": "Úpravy poslané z aplikace Strom",
   "log.input.app.undo": "Úpravy z aplikace Strom vráceny",
   "ui.init.created": "Rodokmen „{name}“ založen v {path}",
@@ -1474,6 +1515,22 @@
   "ui.init.lang.detected": "jazyk výzkumu: {lang} ({code}) – podle systému; jiný: strom lang <kód>",
   "ui.init.archive": "archiv: data přicházejí z aplikace Strom (výzkum se zapíná přes strom mode research)",
   "ui.init.next": "dál    {command}",
+  "ui.setup.summary": "Strom je nastavený.",
+  "ui.setup.summary.home": "domov",
+  "ui.setup.summary.trees": "rodokmeny",
+  "ui.setup.summary.shared": "sdílená data",
+  "ui.setup.summary.lang": "jazyk",
+  "ui.setup.summary.detected": " – podle systému; jiný jazyk: strom config set lang <kód>",
+  "ui.setup.summary.agent": "agent",
+  "ui.setup.summary.missing": " – zatím není nainstalovaný",
+  "ui.setup.summary.talk": "rozhovor",
+  "ui.setup.summary.app": "v aplikaci {app}",
+  "ui.setup.summary.terminal": "v terminálu (jeho CLI)",
+  "ui.setup.summary.both": " – obojí je tu; rozhoduje uživatel: strom setup --where {where}",
+  "ui.setup.summary.knows": "zná strom",
+  "ui.setup.summary.anywhere": "{agent}, v každé složce",
+  "ui.setup.summary.config": "nastavení",
+  "ui.arg.family-tree-name": "název, např. příjmení rodu",
   "ui.arg.agent": "agent",
   "ui.arg.batch": "dávka",
   "ui.arg.book": "kniha",
@@ -1536,6 +1593,8 @@
   "ui.error.option.is-arg.hint": "{cmd} <{arg}>",
   "ui.error.option.unknown": "neznámá volba {opt} u {cmd}",
   "ui.error.option.unknown.hint": "volby: {options} · strom help {path}",
+  "ui.error.option.unknown.none": "neznámá volba {opt} u {cmd}",
+  "ui.error.option.unknown.none.hint": "{help}",
   "ui.error.option.no-value": "{opt} se píše bez hodnoty",
   "ui.error.option.needs-value": "{opt} potřebuje hodnotu {value}",
   "ui.error.option.needs-value.hint": "strom help {path}",

package/assets/lang/de.json

@@ -62,6 +62,9 @@
   "ui.dialog.refused": "Nicht erlaubt – nichts wurde geändert.",
   "ui.link.isolated": "Dies ist eine isolierte Installation (STROM_ISOLATED): sie registriert keine strom-research://-Links – diese bleiben beim eigenen strom.",
   "ui.doc.isolated": "isolierte Installation in {folder}",
+  "ui.doc.second": "zweite Installation: der Befehl {command}, in {folder}, ihre Links {scheme}://",
+  "ui.doc.home.regular": "auch der Ordner des regulären strom: zwei Installationen an einer Forschung",
+  "ui.doc.home.program": "im Programmordner von strom – ein Update oder die Deinstallation könnte sie mitnehmen; besser woandershin (strom setup im Terminal verschiebt sie mit)",
   "ui.doc.knows.isolated": "isolierte Installation: den Agenten wird außerhalb nichts beigebracht",
   "ui.doc.links.isolated": "isolierte Installation: registriert keine Links",
   "ui.doc.app.isolated": "isolierte Installation: absichtlich nicht verwendet",
@@ -74,6 +77,8 @@
   "ui.consent.connector.revoke": "Den Downloader „{name}“ stoppen?",
   "ui.consent.host": "Automatisches Herunterladen von {host} erlauben?",
   "ui.consent.host.revoke": "Automatisches Herunterladen von {host} stoppen?",
+  "ui.consent.elsewhere.connector": "Den Downloader „{name}“ starten? Ein Agent fragt danach von außerhalb des Forschungsordners ({cwd}).",
+  "ui.consent.elsewhere.run": "Den Agenten allein an der Forschung „{tree}“ arbeiten lassen? Ein Agent fragt danach von außerhalb des Forschungsordners ({cwd}); die Arbeit kostet Geld.",
   "ui.consent.connectors.off": "Downloader laufen lassen, ohne vorher zu fragen?",
   "ui.menu.title": "Strom Ahnenforschung {version}",
   "ui.menu.tree": "Stammbaum: {name} · Personen: {persons}",
@@ -150,6 +155,7 @@
   "ui.consent.connector.hosts": "Er verbindet sich nur mit {hosts} – langsam, über den Begrenzer von strom.",
   "ui.consent.connector.changed": "Sein Code hat sich seit der Erlaubnis geändert.",
   "ui.consent.connector.direct": "Achtung: sein Code greift selbst auf das Netz zu, am Begrenzer von strom vorbei.",
+  "ui.consent.connector.unfenced": "Achtung: er startet ein Programm, das strom nicht eingrenzt ({run}) – es kann alle Dateien dieses Benutzers lesen und ändern, andere Programme starten und jede Adresse erreichen. Nach jeder Änderung seines Codes wird erneut gefragt.",
   "ui.consent.connector.terms": "Nutzungsbedingungen des Archivs: {terms}",
   "ui.consent.host.unblock": "{host} hat uns abgewiesen. Wieder erlauben – nur wenn das Archiv gesagt hat, dass es in Ordnung ist?",
   "ui.menu.otheragent": "Diesmal mit einem anderen Agenten oder woanders sprechen",
@@ -253,6 +259,8 @@
   "ui.doc.app": "Strom-App",
   "ui.doc.tree": "dieser Stammbaum",
   "ui.doc.innode": "strom {version} in Node {node}",
+  "ui.doc.fence": "Downloader eingegrenzt",
+  "ui.doc.fence.net": "Node {node}: Downloader laufen eingegrenzt, aber erst Node 25 oder neuer hält sie auch vom Netz fern",
   "ui.doc.oldnode": "Node {node} ist zu alt (nötig: 22.18 oder neuer)",
   "ui.doc.missing": "fehlt",
   "ui.doc.notsetup": "noch nicht eingerichtet",
@@ -396,7 +404,9 @@
   "ui.uninstall.npm": "Das Programm selbst (mit npm installiert): npm uninstall -g strom-research",
   "ui.uninstall.done": "strom ist deinstalliert. Danke fürs Forschen mit strom.",
   "ui.uninstall.running": "strom läuft aus dieser Installation noch in einem anderen Fenster ({list}): es schließen – das Menü, ein Gespräch, eine Arbeit des Agenten – und strom uninstall erneut starten. Nichts wurde entfernt.",
-  "ui.uninstall.later": "verschwindet, sobald dieses Fenster geschlossen ist",
+  "ui.uninstall.folderKept": "Der Ordner {folder} bleibt: darin liegt, was strom nicht hineingelegt hat ({what}).",
+  "ui.uninstall.later": "verschwindet wenige Sekunden nach dem Ende dieses Befehls",
+  "ui.uninstall.skipped": "{path} steht in install.json als Starter von strom, ist aber keiner (ein anderer Name, oder es liegt in der Forschung) – es bleibt.",
   "ui.menu.update.line": "Eine neue Version von strom ist da: {version}.",
   "ui.menu.update": "strom auf {version} aktualisieren",
   "ui.doc.update": "neue Version",
@@ -404,7 +414,7 @@
   "ui.update.unknown": "Die neueste Version von strom ließ sich nicht ermitteln.",
   "ui.update.current": "strom {version} ist die neueste Version.",
   "ui.update.available": "Eine neue Version ist da: {version} (diese ist {current}) – strom update installiert sie.",
-  "ui.update.npm": "Eine neue Version ist da: {version}. strom ist hier mit npm installiert: npm install -g strom-research@latest",
+  "ui.update.npm": "Eine neue Version ist da: {version}. strom ist hier mit npm installiert: npm install -g strom-research@{tag}",
   "ui.update.sure": "strom von {current} auf {version} aktualisieren? Die Forschungen bleiben, wie sie sind.",
   "ui.update.later": "Nicht jetzt – jederzeit strom update.",
   "ui.update.downloading": "strom {version} wird heruntergeladen…",
@@ -432,6 +442,19 @@
   "ui.update.node.sure": "strom's Node von {from} auf {to} aktualisieren (Sicherheitskorrekturen)?",
   "ui.update.node.done": "✓ Node ist aktualisiert: {from} → {to}.",
   "ui.update.bridges": "Die Live-Ansicht in der Strom-App läuft mit der neuen Version weiter ({n}).",
+  "ui.update.npm.channel": "strom ist hier mit npm installiert: npm install -g strom-research@{tag}",
+  "ui.update.channel.beta.sure": "strom auf die Beta-Versionen umstellen: {current} → {version}?",
+  "ui.update.channel.stable.sure": "strom zu den veröffentlichten Versionen zurückstellen: {current} → {version}?",
+  "ui.update.channel.beta.now": "Ab jetzt nimmt strom die Beta-Versionen.",
+  "ui.update.channel.stable.now": "Ab jetzt nimmt strom die veröffentlichten Versionen.",
+  "ui.update.older": "{version} ist eine ältere Version als {current}; die Forschungen bleiben, wie sie sind.",
+  "ui.update.stays": "Die Forschungen bleiben, wie sie sind.",
+  "ui.doc.beta": "Beta-Versionen",
+  "ui.doc.backup": "Sicherung",
+  "ui.backup.made": "Sicherung vor dem Wechsel von {from} auf {to}: {path} ({size}).",
+  "ui.backup.last": "Letzte Sicherung (vor dem Wechsel von {from} auf {to}, {date}): {path}",
+  "ui.backup.readme": "Strom-Forschung – eine Sicherung\n\nErstellt {date}, vor dem Wechsel von strom {from} auf {to}.\n\nDarin:\n- trees: alle Stammbäume dieses Computers, jeder mit seinem ganzen Ordner samt Verlauf (.git);\n- settings: die Einstellungen von strom mit den Siegelschlüsseln und den Anmeldungen, wie sie auf diesem Computer waren.\n\nNicht darin: die gemeinsamen Bilder (der Ordner shared/media). Jedes liegt dort nach seinem Inhalt, und strom löscht keines; jede Version von strom liest dieselben. Ebenfalls weggelassen: was strom selbst wieder erstellt (Ansichten von Scans, Ausschnitte).\n\nEinen Stammbaum zurückholen: seinen Ordner aus trees dorthin zurückkopieren, wo die Stammbäume liegen (anstelle des vorhandenen oder daneben unter anderem Namen), dann strom starten: strom prüft ihn (strom check).",
+  "ui.trees.locked": "gesperrt: geschrieben von strom {by}",
   "ui.setup.stromapp": "Die Strom-App (kostenlos, im Browser) zeigt die Forschung als Stammbaum – jeden Eintrag mit seinem Bild aus dem Scan, die Geschichten der Vorfahren – und verfolgt sie live, während der Agent arbeitet. Soll sie verwendet werden?",
   "ui.setup.stromapp.install": "Ja – jetzt installieren (sie öffnet sich im Browser, strom zeigt, wo zu klicken ist)",
   "ui.setup.stromapp.later": "Ja, aber nicht jetzt",
@@ -1304,6 +1327,7 @@
   "ui.home.stays": "Die Forschung bleibt in {from}.",
   "ui.home.inside": "{to} liegt im Ordner der Forschung {from} (oder umgekehrt) – einen Ordner daneben wählen.",
   "ui.home.notEmpty": "In {to} liegt schon etwas – die Forschung zieht nur in einen leeren oder neuen Ordner.",
+  "ui.home.program": "{to} liegt im Programmordner von strom – ein Update ersetzt, was dort liegt; ein Ordner außerhalb ist nötig.",
   "ui.home.busy": "Im Stammbaum {trees} arbeitet gerade jemand (ein Agent, ein Lauf oder die Strom-App live) – die Forschung kann umziehen, wenn das fertig ist.",
   "ui.home.failed": "Das Verschieben ging nicht ({reason}) – nichts wurde geändert.",
   "ui.app.notinstalled": "Die Strom-App ist auf diesem Computer noch nicht installiert. Jetzt als App aus dem Browser installieren (kostenlos; strom zeigt, wo zu klicken ist)?",
@@ -1467,6 +1491,23 @@
   "ui.error.arg.missing": "<{arg}> fehlt",
   "ui.error.arg.missing.hint": "strom help {cmd}",
   "ui.error.prefix": "Fehler",
+  "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.",
+  "ui.error.backup.failed.update.hint": "Platz auf dem Datenträger freimachen ({where}), dann erneut strom update --channel {channel}",
+  "ui.error.folder.in-program": "{folder} liegt im Programmordner von strom {program} – ein Update von strom ersetzt, was dort liegt, und die Deinstallation entfernt es, die Forschung mit. Nichts wurde geändert.",
+  "ui.error.folder.in-program.hint": "Einen Ordner außerhalb wählen, zum Beispiel {suggested}",
+  "ui.error.folder.in-program.default.hint": "Einen Ordner außerhalb angeben: strom setup --home \"{suggested}\" --yes",
+  "ui.error.update.in-program": "{folder} liegt in {entry}, das das Update ersetzt – die Forschung ginge mit. Nichts wurde installiert.",
+  "ui.error.update.in-program.hint": "Zuerst die Forschung aus dem Programmordner von strom verschieben: strom setup in einem eigenen Terminal (die Frage nach dem Ordner verschiebt sie mit), dann erneut strom update",
+  "ui.error.tree.newer": "Diesen Stammbaum hat strom {by} geschrieben, neuer als dieses strom {version}. Dieses strom lässt ihn unverändert.",
+  "ui.error.tree.newer.hint": "strom aktualisieren: strom update",
+  "ui.error.tree.newer.backup": "Diesen Stammbaum hat strom {by} geschrieben, neuer als dieses strom {version}. Dieses strom lässt ihn unverändert.",
+  "ui.error.tree.newer.backup.hint": "strom aktualisieren: strom update\nDie Sicherung vor dem Wechsel: {backup}",
+  "ui.error.tree.newer.beta": "Diesen Stammbaum hat strom {by} geschrieben, neuer als dieses strom {version}. Dieses strom lässt ihn unverändert.",
+  "ui.error.tree.newer.beta.hint": "Zurück zur Beta: strom update --channel beta – oder auf die Veröffentlichung von {release} warten",
+  "ui.error.tree.newer.beta.backup": "Diesen Stammbaum hat strom {by} geschrieben, neuer als dieses strom {version}. Dieses strom lässt ihn unverändert.",
+  "ui.error.tree.newer.beta.backup.hint": "Zurück zur Beta: strom update --channel beta – oder auf die Veröffentlichung von {release} warten\nDie Sicherung vor dem Wechsel: {backup}",
   "log.input.app": "Aus der Strom-App gesendete Änderungen",
   "log.input.app.undo": "Änderungen aus der Strom-App zurückgenommen",
   "ui.init.created": "Stammbaum „{name}“ angelegt in {path}",
@@ -1474,6 +1515,22 @@
   "ui.init.lang.detected": "Sprache der Forschung: {lang} ({code}) – vom System übernommen; eine andere: strom lang <Code>",
   "ui.init.archive": "ein Archiv: die Daten kommen aus der Strom-App (die Forschung wird mit strom mode research eingeschaltet)",
   "ui.init.next": "weiter {command}",
+  "ui.setup.summary": "Strom ist eingerichtet.",
+  "ui.setup.summary.home": "Zuhause",
+  "ui.setup.summary.trees": "Stammbäume",
+  "ui.setup.summary.shared": "gemeinsame Daten",
+  "ui.setup.summary.lang": "Sprache",
+  "ui.setup.summary.detected": " – vom System erkannt; eine andere Sprache: strom config set lang <Code>",
+  "ui.setup.summary.agent": "Agent",
+  "ui.setup.summary.missing": " – noch nicht installiert",
+  "ui.setup.summary.talk": "Gespräch",
+  "ui.setup.summary.app": "in der App {app}",
+  "ui.setup.summary.terminal": "im Terminal (seine CLI)",
+  "ui.setup.summary.both": " – beides ist hier; die Entscheidung liegt beim Benutzer: strom setup --where {where}",
+  "ui.setup.summary.knows": "kennt strom",
+  "ui.setup.summary.anywhere": "{agent}, in jedem Ordner",
+  "ui.setup.summary.config": "Einstellungen",
+  "ui.arg.family-tree-name": "Name, z. B. der Familienname",
   "ui.arg.agent": "Agent",
   "ui.arg.batch": "Stapel",
   "ui.arg.book": "Buch",
@@ -1536,6 +1593,8 @@
   "ui.error.option.is-arg.hint": "{cmd} <{arg}>",
   "ui.error.option.unknown": "unbekannte Option {opt} für {cmd}",
   "ui.error.option.unknown.hint": "Optionen: {options} · strom help {path}",
+  "ui.error.option.unknown.none": "unbekannte Option {opt} für {cmd}",
+  "ui.error.option.unknown.none.hint": "{help}",
   "ui.error.option.no-value": "{opt} hat keinen Wert",
   "ui.error.option.needs-value": "{opt} braucht einen Wert {value}",
   "ui.error.option.needs-value.hint": "strom help {path}",

package/assets/plugins/connectors/DISCOVERY.md

@@ -148,6 +148,11 @@ as well: see step 2.
 - strom shows each image's size (width × height). It should be the right page
   and full size, not a thumbnail. Check that the number of images of a book
   matches the portal.
+- Keep `run` in connector.json as `["node", "connector.ts"]`: then it runs
+  fenced in (Node's permission model) and you may change the code without
+  asking. Split it into more files of this folder if you like, imported from
+  connector.ts. Another program, or a switch of Node's in `run`, needs the
+  user's consent after every change.
 - If strom answers with exit code 4 (consent required), stop and tell the
   user: they give it in their own terminal after reading the warning
   (`strom allow connector __NAME__`). You never do that.

package/assets/plugins/connectors/README.md

@@ -56,6 +56,10 @@ starts with `.` or `_` are ignored (`_old-version/`).
 - `title`: the archive or portal, as people call it.
 - `run`: the program and its arguments, started in the connector's folder.
   `"node"` is the Node that runs strom (it runs TypeScript as it is).
+  `"node"` followed only by files of the connector's folder (no switches, no
+  `..`, no absolute paths) runs in Node's permission model. Any other program,
+  or a switch of Node's, runs only with the user's consent to the code exactly
+  as it is, asked again after every change of it.
 - `hosts`: every host it contacts. `"example.org"` includes its subdomains.
   strom refuses requests anywhere else, and each host needs the user's consent.
 - `can`: what it does: any of `find`, `list`, `fetch`, `part`, `locate`.
@@ -384,8 +388,9 @@ with the text round it.
 A connector runs as soon as it is in the folder. Two things need the user's
 consent, given in their own terminal (`strom allow connector <name>`, or when
 they run a test or a fetch themselves, where strom asks right away):
-- code that reaches the network itself, past strom: always, and again after
-  every change of it;
+- a `run` other than `"node"` and files of its folder, or code that seems to
+  reach the network itself, past strom: always, and again after every change
+  of it;
 - every connector and each of its hosts, when the user asked to be asked first
   (`strom config set connectors.consent on`).
 

package/dist/cli/backups.js

@@ -0,0 +1,79 @@
+// The backup before another channel or an older version (core/backup.ts), as the CLI makes it: every research this
+// computer knows and the settings, the README in the person's language, kept in the user config, said in a line.
+import { EXIT, StromError } from "../core/errors.js";
+import { backupOnce, backupsDir, BackupFailed, mb } from "../core/backup.js";
+import { installation, replacedHolding } from "../core/self.js";
+import { ui } from "./ui.js";
+/** A local date and time for a sentence. */
+function when(iso) {
+    const d = new Date(iso);
+    const p = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`;
+}
+/** The versions as a sentence says them: their channels too where the version stays the same. */
+function sides(t) {
+    const same = t.from === t.to;
+    return { from: `${t.from}${same && t.fromChannel ? ` (${t.fromChannel})` : ""}`, to: `${t.to}${same && t.toChannel ? ` (${t.toChannel})` : ""}` };
+}
+/**
+ * Make the backup of this change unless one was made for it already. Returns the one made now (undefined: made
+ * before, or nothing to back up — no home). Throws a StromError (exit 6) with the reason and what to do when it
+ * cannot: `update` — strom update stops before it installs; otherwise this strom opens no research for writing.
+ */
+export function backupBefore(ctx, t, opts = {}) {
+    const home = ctx.settings.home()?.value;
+    if (!home)
+        return undefined;
+    const lang = ctx.uiLang();
+    const said = sides(t);
+    try {
+        // never inside what strom update replaces (app/, node/ of the installer's folder): the backup would go with it
+        const inst = installation();
+        const inside = inst.kind === "installed" && inst.root ? replacedHolding(inst.root, [backupsDir(home)])[0] : undefined;
+        if (inside)
+            throw new BackupFailed(`${backupsDir(home)} lies inside ${inside.entry}, which strom update replaces — the research belongs outside strom's program folder`);
+        return backupOnce({
+            home,
+            env: ctx.env,
+            trees: () => ctx.knownTrees().map((k) => k.root),
+            research: [ctx.settings.trees()?.value, ctx.settings.shared()?.value].filter((p) => !!p),
+            transition: t,
+            readme: ui(lang, "ui.backup.readme", { ...said, date: when(new Date().toISOString()) }),
+            record: (made, before) => {
+                ctx.settings.config.backups = [...before, made];
+                ctx.settings.save();
+            },
+        });
+    }
+    catch (e) {
+        const detail = e instanceof BackupFailed ? e.message : e.message;
+        const where = backupsDir(home);
+        const back = t.fromChannel ?? "stable";
+        const params = { ...said, detail, where, back, channel: opts.update?.channel ?? "" };
+        if (opts.update)
+            throw new StromError(`the backup before going from ${said.from} to ${said.to} could not be made: ${detail} — nothing was installed`, {
+                exitCode: EXIT.noBackup,
+                hint: `free room on the disk (${where}), then strom update --channel ${opts.update.channel} again`,
+                code: "backup.failed.update",
+                params,
+                details: { from: t.from, to: t.to, where, ...(e instanceof BackupFailed && e.room ? { room: e.room } : {}) },
+            });
+        throw new StromError(`the backup before going from ${said.from} to ${said.to} could not be made: ${detail} — nothing is switched: this strom opens no family tree for writing until it is made (tried again at each run)`, {
+            exitCode: EXIT.noBackup,
+            hint: `tell the user: free room on the disk (${where}), then run strom again — or go back: strom update --channel ${back}`,
+            code: "backup.failed",
+            params,
+            details: { from: t.from, to: t.to, where, ...(e instanceof BackupFailed && e.room ? { room: e.room } : {}) },
+        });
+    }
+}
+/** Where the backup is, in a line: the person's language, or JSON for an agent (--json). */
+export function backupSaid(ctx, b) {
+    if (ctx.json)
+        return JSON.stringify({ backup: { path: b.path, bytes: b.bytes, from: b.from, to: b.to } });
+    return ui(ctx.uiLang(), "ui.backup.made", { ...sides(b), path: b.path, size: mb(b.bytes) });
+}
+/** The last backup in a line (the menu, strom doctor). */
+export function lastBackupLine(lang, b) {
+    return ui(lang, "ui.backup.last", { ...sides(b), date: when(b.at), path: b.path });
+}

package/dist/cli/context.js

@@ -5,10 +5,13 @@ import path from "node:path";
 import readline from "node:readline/promises";
 import { Writable } from "node:stream";
 import { Settings } from "../core/config.js";
-import { displayPath, expandHome } from "../core/paths.js";
+import { configDir, displayPath, expandHome, ISOLATED_HOME } from "../core/paths.js";
+import { backupsDir } from "../core/backup.js";
+import { insideProgram } from "../core/self.js";
 import { Cancelled, NeedsConsentError, NeedsInputError, StromError, UsageError } from "../core/errors.js";
 import { migrate } from "../core/migrate.js";
 import { Tree, findTreeUpwards, isTreeDir } from "../core/tree.js";
+import { SCHEMA_VERSION } from "../core/model.js";
 import { readJsonIfExists } from "../core/json.js";
 import { foldText } from "../core/text.js";
 import { currentSession } from "../core/session.js";
@@ -27,6 +30,11 @@ export class Context {
     page;
     dryRun = false;
     opened;
+    /**
+     * The backup before another channel or an older version could not be made (cli/backups.ts): no research is brought
+     * to this strom's schema meanwhile — reading one that needs it says why, as writing does.
+     */
+    backupFailed;
     constructor(opts) {
         this.env = opts.env;
         this.cwd = opts.cwd;
@@ -185,6 +193,36 @@ export class Context {
         // a person (a script, no terminal) reads it in their language; an agent the English it goes by
         throw new NeedsConsentError([{ key, kind: "consent", question: `${question}${agent ? " (an agent cannot answer this)" : ""}`, set }], agent ? undefined : says);
     }
+    /**
+     * An agent strom did not start, working outside the research's folder and strom's shared one (a session in
+     * another repository, where the agents' global rule lets it run strom without asking): what runs a connector's
+     * code or starts paid work is asked in a window there — reading the research is not.
+     */
+    agentElsewhere() {
+        if (!isAgent(this.env) || this.env.STROM_WORKER || this.env.STROM_SESSION)
+            return false;
+        if (findTreeUpwards(this.cwd))
+            return false;
+        const shared = this.settings.shared()?.value;
+        const inside = (dir, p) => {
+            const rel = path.relative(dir, p);
+            return rel === "" || (!rel.startsWith("..") && !path.isAbsolute(rel));
+        };
+        const real = (p) => {
+            try {
+                return fs.realpathSync(p);
+            }
+            catch {
+                return path.resolve(p);
+            }
+        };
+        return !(shared && inside(real(shared), real(this.cwd)));
+    }
+    /** What an agent elsewhere (agentElsewhere) may do only with the person's yes, in a window: `says` in their language. */
+    confirmElsewhere(question, set, key, says) {
+        if (this.agentElsewhere())
+            this.requireHuman(question, set, key, says);
+    }
     /**
      * One of numbered options (1…n, or keys of their own like "0"); Enter takes
      * the suggested one. Asks again on anything else. `back` adds "0" with that
@@ -230,9 +268,12 @@ export class Context {
         const home = this.settings.home();
         if (home)
             return home.value;
-        const suggested = this.settings.suggestedHome();
-        if (this.yes)
+        // the default inside strom's program folder (settings lying in node/): refused with --yes, never offered
+        const suggested = this.homeSuggestion();
+        if (this.yes) {
+            this.refuseProgramFolder("home", this.settings.suggestedHome(), { asDefault: true });
             return this.saveHome(suggested);
+        }
         if (!this.interactive)
             throw new NeedsInputError([
                 {
@@ -248,10 +289,52 @@ export class Context {
         return this.saveHome(this.resolvePath(answer));
     }
     saveHome(dir) {
+        this.refuseProgramFolder("home", dir);
         this.settings.config.home = dir;
         this.settings.save();
         return dir;
     }
+    /**
+     * What is the research's and the person's on this computer: the home, its backups, the folder of the trees, the
+     * shared folder, every tree known, the settings — what strom update and strom uninstall never take away.
+     */
+    researchFolders() {
+        const home = this.settings.home()?.value;
+        return [
+            ...(home ? [home, backupsDir(home)] : []),
+            ...[this.settings.trees()?.value, this.settings.shared()?.value].filter((p) => !!p),
+            ...this.knownTrees().map((k) => k.root),
+            configDir(this.env),
+        ];
+    }
+    /**
+     * A folder for the research (home, trees, shared) never inside strom's program folder: an update replaces what is
+     * there and an uninstall takes it away (found 2026-10-07: a research inside app/ went with the next update, and the
+     * backup made just before it). Refused with what to do; nothing is written.
+     */
+    refuseProgramFolder(key, folder, opts = {}) {
+        const program = insideProgram(folder, { settings: configDir(this.env) });
+        if (!program)
+            return;
+        const home = this.homeSuggestion();
+        const suggested = this.display(opts.suggested ?? (key === "shared" ? path.join(home, "shared") : home));
+        // the folder strom would take by itself (none named, --yes): the way on is naming one
+        throw new UsageError(`${this.display(folder)} is inside strom's program folder ${this.display(program)} — strom update replaces what is there and strom uninstall takes it away, the research with it; nothing was changed`, {
+            hint: opts.asDefault ? `pass --home with a folder outside it: strom setup --home "${suggested}" --yes` : `a folder outside it, e.g. ${suggested}`,
+            ...(opts.asDefault ? { hintCode: "folder.in-program.default" } : {}),
+            code: "folder.in-program",
+            params: { folder: this.display(folder), program: this.display(program), key, suggested },
+        });
+    }
+    /**
+     * The folder suggested for the research: the usual one (defaultHome) — unless it lies inside strom's program folder
+     * (an isolated installation's settings in its node/ or app/: found on a Mac), then one beside that folder.
+     */
+    homeSuggestion() {
+        const home = this.settings.suggestedHome();
+        const program = insideProgram(home, { settings: configDir(this.env) });
+        return program ? path.join(path.dirname(program), ISOLATED_HOME) : home;
+    }
     treesDir() {
         return this.settings.trees()?.value;
     }
@@ -313,7 +396,10 @@ export class Context {
             const names = known.map((t) => `"${t.name}"`).join(", ");
             throw new UsageError("which tree? there are several", { hint: `pass --tree <name>: ${names}`, code: "tree.which", params: { names } });
         }
-        this.opened = Tree.open(root, this.env);
+        const opened = Tree.open(root, this.env);
+        if (this.backupFailed && (opened.config.schema ?? 1) < SCHEMA_VERSION)
+            throw this.backupFailed;
+        this.opened = opened;
         // Data an older strom wrote under an older schema: brought forward first (a dry run too — it is not the command's change).
         // said in the person's language: each step by its own sentence (the commit keeps the English one)
         for (const step of migrate(this.opened)) {