strom-research 1.19.0 → 1.20.0-beta.1

package/CHANGELOG.cs.md

@@ -5,6 +5,18 @@
 Změny každé verze ve zkratce. Úplné poznámky a instalační řádky jsou na
 [GitHub Releases](https://github.com/ACiDekCZ/strom-research/releases) (anglicky).
 
+## 1.20.0
+
+*Připravuje se: bety do 1.20.0-beta.1. Oddíl bude úplný s vydáním.*
+
+- **Menu bez nikoho u terminálu to řekne hned.** Spuštěné tam, kde nemá kdo odpovědět (zavřený vstup, okno
+  bez terminálu), skončí jednou větou v jazyce výzkumu a tím, co udělat místo toho, už ne chybou programu; otázka,
+  jejíž vstup skončí dřív než odpověď, ukončí menu stejně.
+- **`strom check` mluví jedním jazykem.** Pro člověka jsou všechny nálezy, součet i poznámky v jazyce výzkumu, pro
+  agenta celé anglicky, nikdy směs obou.
+- **Když sandbox agenta odmítne git, je jmenováno správné místo.** Zpráva uvádí jako odepřenou historii výzkumu
+  (jeho složku `.git`), ne program gitu.
+
 ## 1.19.0
 
 *22. 10. 2026 · patří k aplikaci Strom 3.15.0.*

package/CHANGELOG.de.md

@@ -5,6 +5,19 @@
 Die Änderungen jeder Version in Kürze. Die vollständigen Hinweise und die Installationszeilen stehen bei
 [GitHub Releases](https://github.com/ACiDekCZ/strom-research/releases) (auf Englisch).
 
+## 1.20.0
+
+*In Vorbereitung: die Betas bis 1.20.0-beta.1. Der Abschnitt ist mit dem Release vollständig.*
+
+- **Das Menü ohne jemanden am Terminal sagt es sofort.** Dort gestartet, wo niemand antworten kann (geschlossene
+  Eingabe, ein Fenster ohne Terminal), endet es mit einem Satz in der Sprache der Forschung und dem, was
+  stattdessen zu tun ist, nicht mehr mit einem Fehler des Programms; eine Frage, deren Eingabe vor der Antwort endet,
+  beendet das Menü genauso.
+- **`strom check` spricht eine Sprache.** Für einen Menschen stehen alle Befunde, die Summe und die Hinweise in der
+  Sprache der Forschung, für einen Agenten alles auf Englisch, nie beides gemischt.
+- **Verweigert die Sandbox des Agenten git, wird der richtige Ort genannt.** Die Meldung nennt die Geschichte der
+  Forschung (ihren Ordner `.git`) als verweigerten Ort, nicht das Programm git.
+
 ## 1.19.0
 
 *22.10.2026 · gehört zur Strom-App 3.15.0.*

package/CHANGELOG.md

@@ -5,6 +5,18 @@ English · [Čeština](CHANGELOG.cs.md) · [Deutsch](CHANGELOG.de.md)
 The changes of each version in short. The full notes and the install lines are on
 [GitHub Releases](https://github.com/ACiDekCZ/strom-research/releases).
 
+## 1.20.0
+
+*In preparation: the betas up to 1.20.0-beta.1. The section is complete with the release.*
+
+- **The menu with nobody at a terminal says so at once.** Started where no one can answer (a closed input, a window
+  without a terminal), the menu ends with one sentence in the research's language and what to do instead,
+  no longer with an error of the program; a question whose input ends before an answer ends the menu the same way.
+- **`strom check` speaks one language.** For a person every finding, the sum and the notes are in the research's
+  language; for an agent all of it is in English, never a mix of both.
+- **When the agent's sandbox refuses git, the right place is named.** The message names the research's history (its
+  `.git` folder) as the place refused, not git's own program.
+
 ## 1.19.0
 
 *2026-10-22 · goes with the Strom app 3.15.0.*

package/assets/lang/cs.json

@@ -2413,6 +2413,10 @@
   "ui.error.record.none": "{id} v rodokmenu není",
   "ui.error.record.merged": "{id} je sloučené do {into}",
   "ui.error.setting.missing": "chybí nastavení: {keys}",
+  "ui.error.menu.no-terminal": "menu je pro člověka u terminálu – tady žádný není",
+  "ui.error.menu.no-terminal.hint": "otevřít terminál a spustit v něm strom",
+  "ui.error.input.ended": "vstup skončil dřív, než přišla odpověď – není tu koho se zeptat",
+  "ui.error.input.ended.hint": "spustit v terminálu",
   "ui.error.conflict.needs-reasoning": "chybí --reasoning",
   "ui.error.conflict.needs-reasoning.hint": "strom conflict resolve {id} … --reasoning \"<proč>\"",
   "ui.error.sync.not-sync": "{input} není synchronizace",

package/assets/lang/de.json

@@ -2413,6 +2413,10 @@
   "ui.error.record.none": "{id} gibt es im Stammbaum nicht",
   "ui.error.record.merged": "{id} ist in {into} zusammengeführt",
   "ui.error.setting.missing": "es fehlt die Einstellung: {keys}",
+  "ui.error.menu.no-terminal": "das Menü ist für einen Menschen am Terminal – hier ist keiner",
+  "ui.error.menu.no-terminal.hint": "ein Terminal öffnen und strom darin starten",
+  "ui.error.input.ended": "die Eingabe endete vor einer Antwort – hier ist niemand zu fragen",
+  "ui.error.input.ended.hint": "im Terminal starten",
   "ui.error.conflict.needs-reasoning": "--reasoning fehlt",
   "ui.error.conflict.needs-reasoning.hint": "strom conflict resolve {id} … --reasoning \"<warum>\"",
   "ui.error.sync.not-sync": "{input} ist kein Abgleich",

package/dist/cli/context.js

@@ -8,7 +8,7 @@ import { Settings } from "../core/config.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 { Cancelled, InputEnded, NeedsConsentError, NeedsInputError, StromError, UsageError } from "../core/errors.js";
 import { migrate } from "../core/migrate.js";
 import { Tree, findTreeUpwards, isTreeDir, knownTreesIn } from "../core/tree.js";
 import { SCHEMA_VERSION } from "../core/model.js";
@@ -101,8 +101,12 @@ export class Context {
         }
         else {
             const rl = readline.createInterface({ input: this.io.stdin ?? process.stdin, output: process.stdout });
+            // the input ending before an answer (stdin closed, used up) settles the question too — never a question left
+            // open; a moment later, so Ctrl-C at a terminal (it closes the line first) stays the person's Ctrl-C
+            const ended = new Promise((_, reject) => rl.once("close", () => setImmediate(() => reject(new InputEnded()))));
+            ended.catch(() => undefined);
             try {
-                answer = await rl.question(prompt);
+                answer = await Promise.race([rl.question(prompt), ended]);
             }
             catch (err) {
                 // Ctrl-C at the question (Node: "Aborted with Ctrl+C", found on Mac as the menu's "that did not work")

package/dist/cli/main.js

@@ -70,7 +70,8 @@ function systemError(e, agent) {
         case "EACCES":
         case "EPERM":
         case "EROFS":
-            return noPermission(e.path, agent);
+            // git not let to start under an agent: said as the research's folder (underAgent)
+            return noPermission((agent && e.gitFolder) || e.path, agent);
         case "EISDIR":
             return new UsageError(`a folder was given where a file is expected${where}`, { code: "fs.folder", ...(e.path ? { params: { path: e.path } } : {}) });
         case "ENOTDIR":
@@ -109,20 +110,23 @@ const REFUSALS = new Set(["fs.no-permission", "git.unwritable", "init.unwritable
  * Codex's sandbox ran strom with none of its marks) is named to the person as the likely cause — not certain, so
  * the other causes after it.
  */
-function underAgent(e, env) {
+function underAgent(e, env, gitFolder) {
     if (!REFUSALS.has(e.code ?? ""))
         return e;
+    // git not let to start under an agent: the research's folder is where (found on Windows: "…\Git\cmd\git.exe"),
+    // what the agent's sandbox is to let strom use; with no agent the program refused stays said (an antivirus)
+    const where = gitFolder ?? e.params?.where;
     if (isAgent(env))
-        return noPermission(e.params?.where, env);
+        return noPermission(where, env);
     const above = agentInAncestry(env);
     if (above)
-        return noPermission(e.params?.where, false, process.platform, above);
-    return ancestryUnread(env) ? noPermission(e.params?.where, false, process.platform, "?") : e;
+        return noPermission(where, false, process.platform, above);
+    return ancestryUnread(env) ? noPermission(where, false, process.platform, "?") : e;
 }
 function printError(io, json, err, debug, lang, env) {
     const agent = isAgent(env) && env;
     const sys = err instanceof StromError ? err : (systemError(err, agent) ?? err);
-    const e = sys instanceof StromError ? underAgent(sys, env) : sys;
+    const e = sys instanceof StromError ? underAgent(sys, env, err?.gitFolder) : sys;
     if (e instanceof StromError) {
         if (json)
             io.stdout(toJson(e.toJSON()));

package/dist/cli/menu-parts.js

@@ -4,7 +4,7 @@ import { fileURLToPath } from "node:url";
 import { agentHere } from "../core/state.js";
 import { ui } from "./ui.js";
 import { Tree } from "../core/tree.js";
-import { Cancelled } from "../core/errors.js";
+import { Cancelled, InputEnded } from "../core/errors.js";
 import { findPersons, label } from "../core/people.js";
 import { agentsHere } from "../core/apps.js";
 /** The test (or a script) gave all its answers: nothing more is asked. */
@@ -144,6 +144,9 @@ export async function guarded(ctx, lang, act) {
         // Ctrl-C at its question: stopped by the person, nothing changed — no failure, the menu goes on
         if (err instanceof Cancelled)
             return void ctx.io.stdout(ui(lang, "ui.cancelled") + "\n");
+        // nobody left to ask: the menu ends, said once
+        if (err instanceof InputEnded)
+            throw err;
         ctx.io.stdout(ui(lang, "ui.menu.failed", { reason: err.message }) + "\n");
         await pause(ctx, lang);
     }

package/dist/cli/ui.js

@@ -2279,6 +2279,10 @@ export const UI = {
     "ui.error.record.none": "{id} is not in the family tree",
     "ui.error.record.merged": "{id} was merged into {into}",
     "ui.error.setting.missing": "missing setting: {keys}",
+    "ui.error.menu.no-terminal": "the menu is for a person at a terminal — none here",
+    "ui.error.menu.no-terminal.hint": "open a terminal and run strom there",
+    "ui.error.input.ended": "the input ended before an answer — nobody to ask here",
+    "ui.error.input.ended.hint": "run it at a terminal",
     "ui.error.conflict.needs-reasoning": "--reasoning is required",
     "ui.error.conflict.needs-reasoning.hint": "strom conflict resolve {id} … --reasoning \"<why>\"",
     "ui.error.sync.not-sync": "{input} is not a sync",

package/dist/commands/checks.js

@@ -62,10 +62,13 @@ register({
     tree: true,
     run(ctx) {
         const tree = ctx.tree();
-        // its verdict and sum in the research's language: the person follows it in the agent's session too; a warning
-        // a person may meet, in it where a person runs it
-        const checked = report([...verifyFull(tree).findings, ...check(tree), ...guard(tree), ...unwritable(tree, isAgent(ctx.env))], ui(tree.lang, "ui.check.ok"), tree.lang, !isAgent(ctx.env));
-        // much kept beside the research that can go (an older strom never tidied it): a sentence, in the research's language —
+        // one language from the first line to the last: a person reads it in the research's language (the findings a
+        // person may meet too); an agent reads it all in English, as it reads strom's errors — its findings say what to
+        // run (found on Mac: English findings above a Czech sum)
+        const agent = isAgent(ctx.env);
+        const lang = agent ? "en" : tree.lang;
+        const checked = report([...verifyFull(tree).findings, ...check(tree), ...guard(tree), ...unwritable(tree, agent)], ui(lang, "ui.check.ok"), lang, !agent);
+        // much kept beside the research that can go (an older strom never tidied it): a sentence, in that language —
         // none where .strom cannot be listed (found on Windows: a folder denied to strom ended check with "no permission"
         // instead of its finding; unwritable says it)
         let disk;
@@ -76,14 +79,14 @@ register({
             disk = undefined;
         }
         const out = disk && disk.frees >= TIDY_SAID
-            ? { ...checked, text: lines(checked.text, ui(tree.lang, "ui.tidy.hint", { strom: mb(disk.size.strom, tree.lang), size: mb(disk.frees, tree.lang) })), data: { ...checked.data, disk: { strom: disk.size.strom, frees: disk.frees } } }
+            ? { ...checked, text: lines(checked.text, ui(lang, "ui.tidy.hint", { strom: mb(disk.size.strom, lang), size: mb(disk.frees, lang) })), data: { ...checked.data, disk: { strom: disk.size.strom, frees: disk.frees } } }
             : checked;
         // not an error — research to do: who rests on no record of their own
         const unproven = unprovenPeople(tree).filter((u) => !u.living).length;
         // an archive: what to research is no matter of it
         if (!unproven || actsAsArchive(tree))
             return out;
-        return { ...out, text: lines(out.text, ui(tree.lang, "ui.check.unproven", { n: unproven })), data: { ...out.data, unproven } };
+        return { ...out, text: lines(out.text, ui(lang, "ui.check.unproven", { n: unproven })), data: { ...out.data, unproven } };
     },
 }, {
     path: ["verify"],

package/dist/commands/start.js

@@ -8,7 +8,7 @@ import { prependPath, spawnAgent } from "../runners/runner.js";
 import { register } from "../cli/registry.js";
 import { lines, numberIn, truncate } from "../cli/format.js";
 import { ui } from "../cli/ui.js";
-import { StromError, UsageError } from "../core/errors.js";
+import { EXIT, StromError, UsageError } from "../core/errors.js";
 import { PROFILES } from "../agents/profiles.js";
 import { conversationArgs, conversationEnv } from "../agents/launch.js";
 import { globalTargets, installGlobal, isInstalled, uninstallGlobal } from "../agents/global.js";
@@ -579,6 +579,10 @@ register({
     run: async (ctx) => {
         if (isAgent(ctx.env))
             throw new UsageError("the menu is for a person at a terminal", { hint: "strom (orientation) — or strom --json" });
+        // nobody at a terminal to answer (stdin closed or not one, STROM_NONINTERACTIVE, --yes/--json): said at once —
+        // never a menu waiting for an answer that cannot come
+        if (!ctx.interactive)
+            throw new StromError("the menu is for a person at a terminal — none here", { exitCode: EXIT.needsInput, code: "menu.no-terminal", hint: "strom (orientation) — or strom --json" });
         const { runMenu } = await import("../cli/menu.js");
         const { main } = await import("../cli/main.js");
         await runMenu(ctx, (argv, quiet) => main(argv, quiet ? { ...ctx.io, stdout: () => undefined } : ctx.io, ctx.env, ctx.cwd));

package/dist/core/errors.js

@@ -72,6 +72,17 @@ export class Cancelled extends StromError {
         this.name = "Cancelled";
     }
 }
+/**
+ * The input ended before an answer (stdin closed, a file or a pipe used up): nobody left to ask — said, never a
+ * process that hangs on its question (found on Mac: the menu with stdin closed ended in Node's "unsettled top-level
+ * await", exit 13).
+ */
+export class InputEnded extends StromError {
+    constructor() {
+        super("the input ended before an answer — nobody to ask here", { exitCode: EXIT.needsInput, code: "input.ended", hint: "run it at a terminal" });
+        this.name = "InputEnded";
+    }
+}
 /** A name matched more than one record. Never pick one silently. */
 export class AmbiguousError extends StromError {
     candidates;

package/dist/core/git.js

@@ -72,6 +72,9 @@ export function runGit(cwd, args, input, extraEnv = {}) {
             const where = fs.existsSync(dotGit) ? dotGit : cwd;
             if (writeRefusal(where))
                 throw gitUnwritable(where, "");
+            // git itself not let to start (found on Windows: an agent's sandbox, git.exe refused): the research's folder
+            // kept with it — under an agent that is what its sandbox is to let strom use (cli/main.ts)
+            throw Object.assign(r.error, { gitFolder: where });
         }
         throw gitTimedOut(args, r.error) ?? r.error;
     }

package/dist/core/tree.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strom-research",
-  "version": "1.19.0",
+  "version": "1.20.0-beta.1",
   "description": "Genealogical research toolkit for AI coding agents",
   "type": "module",
   "bin": {
@@ -57,5 +57,8 @@
   "devDependencies": {
     "@types/node": "^22.20.4",
     "typescript": "^7.0.2"
+  },
+  "publishConfig": {
+    "tag": "beta"
   }
 }