strom-research 1.15.0-beta.4 → 1.15.0-beta.5

package/README.md

@@ -48,7 +48,9 @@ Next time: run `strom`, or double-click the "Strom research" shortcut.
 Updates: strom looks for a new version at most once a day and says so;
 `strom update` installs it (checked like the installer does), and with it the
 newest security release of its Node line. Installed with
-npm: `npm install -g strom-research@latest`.
+npm: `npm install -g strom-research@latest`. What is new in each version:
+[CHANGELOG.md](CHANGELOG.md) ([čeština](CHANGELOG.cs.md), [Deutsch](CHANGELOG.de.md));
+`strom --version` and `strom update` link to it in the research language.
 
 ## Features
 

package/assets/lang/cs.json

@@ -754,6 +754,7 @@
   "ui.update.downloading": "Stahuji strom {version}…",
   "ui.update.failed": "Aktualizace se nepovedla: {detail}. strom zůstává, jak byl.",
   "ui.update.done": "✓ strom je aktualizovaný: {previous} → {version}.",
+  "ui.update.whatsnew": "Co je nového: {url}",
   "ui.update.restart": "strom je aktualizovaný — tahle nabídka ale ještě běží ve staré verzi. Po novém spuštění stromu (nebo zástupce „{shortcut}“) poběží nová verze.",
   "ui.o.update": "aktualizace",
   "ui.o.update.new": "vyšla {version} (tato je {current}) – řekni to uživateli; strom update ji s jeho souhlasem nainstaluje",

package/assets/lang/de.json

@@ -754,6 +754,7 @@
   "ui.update.downloading": "strom {version} wird heruntergeladen…",
   "ui.update.failed": "Die Aktualisierung hat nicht geklappt: {detail}. strom bleibt, wie er war.",
   "ui.update.done": "✓ strom ist aktualisiert: {previous} → {version}.",
+  "ui.update.whatsnew": "Was ist neu: {url}",
   "ui.update.restart": "strom ist aktualisiert — dieses Menü läuft aber noch in der alten Version. Nach einem Neustart von strom (oder der Verknüpfung „{shortcut}“) läuft die neue Version.",
   "ui.o.update": "Update",
   "ui.o.update.new": "{version} ist da (diese ist {current}) – sag es dem Benutzer; strom update installiert sie mit seiner Zustimmung",

package/dist/cli/main.js

@@ -23,7 +23,7 @@ import { prependPath } from "../runners/runner.js";
 import { shimDir } from "../commands/session.js";
 import { isAgent } from "../core/which.js";
 import { appUrlShown, noticeStromApp } from "../core/stromapp.js";
-import { lastChannelOf, pendingTransition, updateChannel } from "../core/update.js";
+import { lastChannelOf, pendingTransition, updateChannel, whatsNewUrl } from "../core/update.js";
 import { backupBefore, backupSaid } from "./backups.js";
 import { guestOf, installation, ownFolder, refreshTreeShim } from "../core/self.js";
 import { refreshGlobal } from "../agents/global.js";
@@ -133,6 +133,21 @@ function asOwnCommand(io, name, json, argv) {
     const text = (s) => asCommand(s, name, words);
     return { ...io, stdout: (s) => io.stdout(json ? asCommandJson(s, name, words) : text(s)), stderr: (s) => io.stderr(text(s)) };
 }
+/**
+ * strom --version: the version on its first line (what a script reads), then where to read what is new in it — the
+ * changelog in the research language, on the branch of the installation's channel. --json gives the version alone.
+ */
+function versionSaid(env, cwd, io, values = {}) {
+    const first = `strom ${VERSION}\n`;
+    try {
+        const lang = Context.fromOptions({ env, cwd, io, json: false, values }).uiLang();
+        return `${first}${ui(lang, "ui.update.whatsnew", { url: whatsNewUrl(VERSION, updateChannel(env), lang) })}\n`;
+    }
+    catch {
+        // no settings to read: the version alone
+        return first;
+    }
+}
 export async function main(argv, io, env, cwd) {
     const json = argv.includes("--json");
     const own = ownCommand(env);
@@ -157,7 +172,7 @@ export async function main(argv, io, env, cwd) {
         if (argv.length === 0 && io.tty && !isAgent(env) && env.STROM_NONINTERACTIVE !== "1")
             argv = ["menu"];
         if (argv.length === 1 && (argv[0] === "--version" || argv[0] === "-v")) {
-            io.stdout(json ? toJson({ version: VERSION }) : `strom ${VERSION}\n`);
+            io.stdout(json ? toJson({ version: VERSION }) : versionSaid(env, cwd, io));
             return EXIT.ok;
         }
         let resolved;
@@ -185,7 +200,7 @@ export async function main(argv, io, env, cwd) {
             return EXIT.ok;
         }
         if (v.version) {
-            io.stdout(json ? toJson({ version: VERSION }) : `strom ${VERSION}\n`);
+            io.stdout(json ? toJson({ version: VERSION }) : versionSaid(env, cwd, io, v));
             return EXIT.ok;
         }
         const ctx = Context.fromOptions({ env, cwd, io, json, values: v });

package/dist/cli/ui.js

@@ -681,6 +681,7 @@ export const UI = {
     "ui.update.downloading": "Downloading strom {version}…",
     "ui.update.failed": "The update did not work: {detail}. strom stays as it was.",
     "ui.update.done": "✓ strom is updated: {previous} → {version}.",
+    "ui.update.whatsnew": "What's new: {url}",
     "ui.update.restart": "strom is updated — this menu still runs the old version. Start strom again (or the shortcut \"{shortcut}\"), and the new version is at work.",
     "ui.o.update": "update",
     "ui.o.update.new": "{version} is out (this is {current}) — tell the user; strom update installs it with their yes",

package/dist/commands/setup.js

@@ -23,7 +23,7 @@ import { mb, sharedMedia, tidyPlan, TIDY_SAID } from "../core/tidy.js";
 /** So many bytes of the shared store no research here names: worth a warning. */
 const MEDIA_UNNAMED_SAID = 500 * 1024 * 1024;
 import { Tree, VERSION } from "../core/tree.js";
-import { checked, installUpdate, isNewer, knownNewerVersion, lastChannelOf, latestRelease, newerNode, newerVersion, setInstallChannel, updateChannel } from "../core/update.js";
+import { checked, installUpdate, isNewer, knownNewerVersion, lastChannelOf, latestRelease, newerNode, newerVersion, setInstallChannel, updateChannel, whatsNewUrl } from "../core/update.js";
 import { configDir, defaultHome, desktopDir, isolated, noLinks, ownCommand } from "../core/paths.js";
 import { backupBefore, backupSaid, lastBackupLine } from "../cli/backups.js";
 import { BACKUP_SAID_DAYS, lastBackup } from "../core/backup.js";
@@ -664,7 +664,9 @@ register({
                 bridges++;
         }
         return {
-            text: lines(newer ? t("ui.update.done", { version: done.version, previous: VERSION }) : undefined, done.node ? t("ui.update.node.done", done.node) : undefined, bridges ? t("ui.update.bridges", { n: bridges }) : undefined),
+            text: lines(newer ? t("ui.update.done", { version: done.version, previous: VERSION }) : undefined, 
+            // what is new in the version installed: the changelog in the research language, on the branch of its channel
+            newer ? t("ui.update.whatsnew", { url: whatsNewUrl(done.version, channel, lang) }) : undefined, done.node ? t("ui.update.node.done", done.node) : undefined, bridges ? t("ui.update.bridges", { n: bridges }) : undefined),
             data: { previous: VERSION, version: done.version, updated: true, ...(done.node ? { node: done.node } : {}), bridges, ...extra, ...(backup ? { backup: { path: backup.path, bytes: backup.bytes } } : {}) },
         };
     },

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.15.0-beta.4";
+export const VERSION = "1.15.0-beta.5";
 const GITIGNORE = `# Strom Research — local state and large files are not versioned
 .strom/
 /media/

package/dist/core/update.js

@@ -91,6 +91,20 @@ export function compareVersions(a, b) {
 export function isNewer(a, b) {
     return compareVersions(a, b) > 0;
 }
+/** The changelog of the project on GitHub: CHANGELOG.md (en), CHANGELOG.cs.md, CHANGELOG.de.md in the repository's root. */
+export const CHANGELOG_BASE = "https://github.com/ACiDekCZ/strom-research/blob";
+const CHANGELOG_LANGS = new Set(["cs", "de"]);
+/**
+ * What's new in a version: its section of the changelog in the person's language (another language: English), on the
+ * branch of the channel — main has the released versions only, beta the version being prepared. The section's anchor
+ * is the version without its prerelease part (`## 1.15.0` → #1150), the same from the first beta to the release.
+ */
+export function whatsNewUrl(version, channel, lang) {
+    const code = lang.trim().toLowerCase().split(/[-_]/)[0] ?? "";
+    const file = CHANGELOG_LANGS.has(code) ? `CHANGELOG.${code}.md` : "CHANGELOG.md";
+    const anchor = (version.split(/[-+]/)[0] ?? version).replace(/\D/g, "");
+    return `${CHANGELOG_BASE}/${channel === "beta" ? "beta" : "main"}/${file}#${anchor}`;
+}
 /** Where the official Node comes from (nodejs.org's layout: <base>/v<version>/<archive>, SHASUMS256.txt beside). */
 export function nodeBase(env) {
     return (env.STROM_NODE_BASE ?? "").trim() || "https://nodejs.org/dist";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strom-research",
-  "version": "1.15.0-beta.4",
+  "version": "1.15.0-beta.5",
   "description": "Genealogical research toolkit for AI coding agents",
   "type": "module",
   "bin": {
@@ -16,8 +16,8 @@
   },
   "scripts": {
     "strom": "node src/cli.ts",
-    "test": "node --test --import ./test/setup.ts --test-timeout=240000 --test-reporter=dot \"test/**/*.test.ts\"",
-    "test:quick": "node --test --import ./test/setup.ts --test-timeout=240000 --test-reporter=dot \"test/unit/**/*.test.ts\" \"test/gedcom/**/*.test.ts\"",
+    "test": "node --test --import ./test/setup.ts --test-global-setup=./test/global-setup.ts --test-timeout=240000 --test-reporter=dot \"test/**/*.test.ts\"",
+    "test:quick": "node --test --import ./test/setup.ts --test-global-setup=./test/global-setup.ts --test-timeout=240000 --test-reporter=dot \"test/unit/**/*.test.ts\" \"test/gedcom/**/*.test.ts\"",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "build": "tsc -p tsconfig.build.json",
     "prepack": "npm run build",