charness 3.3.2 → 3.5.0

package/dist/selfUpdate/installKind.js

@@ -0,0 +1,99 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.npmManualCommand = void 0;
+exports.detectInstallKind = detectInstallKind;
+const path = __importStar(require("path"));
+const ephemeralFolderName = '_npx';
+const nodeModulesFolderName = 'node_modules';
+const gitEntryName = '.git';
+const selfUpdateScriptRelativePath = path.join('scripts', 'self-update.sh');
+const npmGlobalLibFolderName = 'lib';
+const npmGlobalBinFolderName = 'bin';
+/** Path fragments of the package managers whose global installs we do not drive. */
+const foreignPackageManagerFragments = [
+    { fragment: `${path.sep}.pnpm${path.sep}`, manualCommand: 'pnpm add -g charness@latest' },
+    { fragment: `${path.sep}pnpm${path.sep}global${path.sep}`, manualCommand: 'pnpm add -g charness@latest' },
+    { fragment: `${path.sep}.bun${path.sep}`, manualCommand: 'bun add -g charness@latest' },
+    { fragment: `${path.sep}yarn${path.sep}global${path.sep}`, manualCommand: 'yarn global add charness@latest' },
+    { fragment: `${path.sep}.yarn${path.sep}`, manualCommand: 'yarn global add charness@latest' },
+];
+exports.npmManualCommand = 'npm install -g charness@latest';
+function getCheckoutManualCommand(root) {
+    return path.join(root, selfUpdateScriptRelativePath);
+}
+/**
+ * The npm global prefix a package folder sits under: `<prefix>/lib/node_modules/charness` on POSIX,
+ * `<prefix>/node_modules/charness` on Windows. `null` when the folder is not directly inside a `node_modules`.
+ */
+function getNpmPrefix(packageRoot, platform) {
+    const nodeModulesDirectory = path.dirname(packageRoot);
+    if (path.basename(nodeModulesDirectory) !== nodeModulesFolderName)
+        return null;
+    const parent = path.dirname(nodeModulesDirectory);
+    if (platform === 'win32')
+        return { prefix: parent, isGlobalLayout: true };
+    return path.basename(parent) === npmGlobalLibFolderName
+        ? { prefix: path.dirname(parent), isGlobalLayout: true }
+        : { prefix: parent, isGlobalLayout: false };
+}
+/** @description Decide the install kind of a package folder. */
+function detectInstallKind({ packageRoot, fs: filesystem, platform, hasExecve }) {
+    if (packageRoot.split(path.sep).includes(ephemeralFolderName))
+        return { kind: 'ephemeral' };
+    if (filesystem.checkExists(path.join(packageRoot, gitEntryName))) {
+        const manualCommand = getCheckoutManualCommand(packageRoot);
+        if (!hasExecve)
+            return { kind: 'notifyOnly', reason: 'noExecve', manualCommand, isCheckout: true };
+        const canWrite = filesystem.checkIsWritable(packageRoot) && filesystem.checkExists(path.join(packageRoot, selfUpdateScriptRelativePath));
+        return canWrite ? { kind: 'checkout', root: packageRoot } : { kind: 'notifyOnly', reason: 'readOnlyCheckout', manualCommand, isCheckout: true };
+    }
+    const foreign = foreignPackageManagerFragments.find(({ fragment }) => `${packageRoot}${path.sep}`.includes(fragment));
+    if (foreign)
+        return { kind: 'notifyOnly', reason: 'packageManager', manualCommand: foreign.manualCommand, isCheckout: false };
+    const npmPrefix = getNpmPrefix(packageRoot, platform);
+    if (npmPrefix === null || !npmPrefix.isGlobalLayout) {
+        return { kind: 'notifyOnly', reason: 'localInstall', manualCommand: 'npm install charness@latest', isCheckout: false };
+    }
+    if (!hasExecve)
+        return { kind: 'notifyOnly', reason: 'noExecve', manualCommand: exports.npmManualCommand, isCheckout: false };
+    const nodeModulesDirectory = path.dirname(packageRoot);
+    const binDirectory = path.join(npmPrefix.prefix, npmGlobalBinFolderName);
+    const canWrite = filesystem.checkIsWritable(nodeModulesDirectory) && (platform === 'win32' || filesystem.checkIsWritable(binDirectory));
+    return canWrite
+        ? { kind: 'npmGlobal', prefix: npmPrefix.prefix }
+        : { kind: 'notifyOnly', reason: 'readOnlyPrefix', manualCommand: exports.npmManualCommand, isCheckout: false };
+}
+//# sourceMappingURL=installKind.js.map

package/dist/selfUpdate/installKind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installKind.js","sourceRoot":"","sources":["../../src/selfUpdate/installKind.ts"],"names":[],"mappings":"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"}

package/dist/selfUpdate/launchEnvironment.d.ts

@@ -0,0 +1,3 @@
+/** @description A copy of the environment the process was launched with. */
+export declare function getLaunchEnvironment(): NodeJS.ProcessEnv;
+//# sourceMappingURL=launchEnvironment.d.ts.map

package/dist/selfUpdate/launchEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchEnvironment.d.ts","sourceRoot":"","sources":["../../src/selfUpdate/launchEnvironment.ts"],"names":[],"mappings":"AASA,4EAA4E;AAC5E,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,UAAU,CAExD"}

package/dist/selfUpdate/launchEnvironment.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLaunchEnvironment = getLaunchEnvironment;
+/**
+ * The process environment as it was handed to this process — captured the moment this module first loads, which `cli.ts`
+ * makes its FIRST import, before any `.env` file is read into `process.env`. A re-exec (the updater's restart, the hot
+ * supervisor's re-exec) launches the new image with THIS, never with the live `process.env`: the new run then loads the
+ * `.env` files again, so a hand edit of them is honoured and a key removed from them is gone, instead of the old run's
+ * loaded values lingering.
+ */
+const launchEnvironment = { ...process.env };
+/** @description A copy of the environment the process was launched with. */
+function getLaunchEnvironment() {
+    return { ...launchEnvironment };
+}
+//# sourceMappingURL=launchEnvironment.js.map

package/dist/selfUpdate/launchEnvironment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchEnvironment.js","sourceRoot":"","sources":["../../src/selfUpdate/launchEnvironment.ts"],"names":[],"mappings":";;AAUA,oDAEC;AAZD;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAsB,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAEhE,4EAA4E;AAC5E,SAAgB,oBAAoB;IAClC,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAAC;AAClC,CAAC"}

package/dist/selfUpdate/npmSource.d.ts

@@ -0,0 +1,34 @@
+import { type CommandRunner } from './commandRunner';
+import type { NpmLatest } from './updatePolicy';
+/** The package this updater follows. */
+export declare const npmPackageName = "charness";
+/** @description A source (registry, remote, installer) did not do what was asked; the message is for the operator. */
+export declare class UpdateSourceError extends Error {
+}
+export interface NpmSourceDeps {
+    runCommand: CommandRunner;
+    /** The running `node`: its sibling `npm` is the one that installed this charness (nvm-safe), honouring the user's `.npmrc`. */
+    execPath: string;
+    /** The npm global prefix this install sits under. */
+    prefix: string;
+    env?: NodeJS.ProcessEnv;
+}
+export interface NpmSource {
+    /** What `latest` is now; throws {@link UpdateSourceError} when the registry does not answer. */
+    getLatest: () => Promise<NpmLatest>;
+    /** Install exactly `version` into the prefix; throws {@link UpdateSourceError} with the output's tail. */
+    install: (version: string, options?: {
+        isRollback?: boolean;
+    }) => Promise<void>;
+}
+/** @description The `npm` next to a `node` binary. */
+export declare function getNpmBinary(execPath: string): string;
+/** @description Where the host-wide lock of an npm global install lives. */
+export declare function getHostLockPath(prefix: string): string;
+/**
+ * @description Reads `npm view charness@latest version engines deprecated --json`. A package that names no `engines` or
+ * is not deprecated has no such key; `engines` is the `node` range, `deprecated` a message.
+ */
+export declare function parseNpmViewOutput(stdout: string): NpmLatest;
+export declare function createNpmSource({ runCommand, execPath, prefix, env }: NpmSourceDeps): NpmSource;
+//# sourceMappingURL=npmSource.d.ts.map

package/dist/selfUpdate/npmSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npmSource.d.ts","sourceRoot":"","sources":["../../src/selfUpdate/npmSource.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,wCAAwC;AACxC,eAAO,MAAM,cAAc,aAAa,CAAC;AAKzC,sHAAsH;AACtH,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAE/C,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,aAAa,CAAC;IAC1B,+HAA+H;IAC/H,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,gGAAgG;IAChG,SAAS,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,0GAA0G;IAC1G,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjF;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAQD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAc5D;AAED,wBAAgB,eAAe,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,aAAa,GAAG,SAAS,CAwB/F"}

package/dist/selfUpdate/npmSource.js

@@ -0,0 +1,107 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateSourceError = exports.npmPackageName = void 0;
+exports.getNpmBinary = getNpmBinary;
+exports.getHostLockPath = getHostLockPath;
+exports.parseNpmViewOutput = parseNpmViewOutput;
+exports.createNpmSource = createNpmSource;
+const path = __importStar(require("path"));
+const commandRunner_1 = require("./commandRunner");
+const constants_1 = require("./constants");
+/** The package this updater follows. */
+exports.npmPackageName = 'charness';
+const distTag = 'latest';
+const hostLockFileName = '.charness-update.lock';
+const nodeModulesRelativePath = path.join('lib', 'node_modules');
+/** @description A source (registry, remote, installer) did not do what was asked; the message is for the operator. */
+class UpdateSourceError extends Error {
+}
+exports.UpdateSourceError = UpdateSourceError;
+/** @description The `npm` next to a `node` binary. */
+function getNpmBinary(execPath) {
+    return path.join(path.dirname(execPath), 'npm');
+}
+/** @description Where the host-wide lock of an npm global install lives. */
+function getHostLockPath(prefix) {
+    return path.join(prefix, nodeModulesRelativePath, hostLockFileName);
+}
+/**
+ * @description Reads `npm view charness@latest version engines deprecated --json`. A package that names no `engines` or
+ * is not deprecated has no such key; `engines` is the `node` range, `deprecated` a message.
+ */
+function parseNpmViewOutput(stdout) {
+    let output;
+    try {
+        output = JSON.parse(stdout);
+    }
+    catch {
+        throw new UpdateSourceError(`npm view printed something unreadable: ${stdout.slice(0, 200)}`);
+    }
+    if (typeof output?.version !== 'string')
+        throw new UpdateSourceError('npm view named no version');
+    const nodeRange = typeof output.engines === 'object' ? output.engines.node : undefined;
+    return {
+        version: output.version,
+        engines: typeof nodeRange === 'string' ? nodeRange : null,
+        isDeprecated: typeof output.deprecated === 'string' && output.deprecated !== '',
+    };
+}
+function createNpmSource({ runCommand, execPath, prefix, env }) {
+    const npm = getNpmBinary(execPath);
+    // A quiet, prompt-free npm: no update notifier, no audit or fund noise on the install's output tail.
+    const commonArguments = ['--no-fund', '--no-audit', '--loglevel=error'];
+    return {
+        async getLatest() {
+            const result = await runCommand(npm, ['view', `${exports.npmPackageName}@${distTag}`, 'version', 'engines', 'deprecated', '--json', ...commonArguments], {
+                env,
+                timeoutMs: constants_1.queryTimeoutMs,
+            });
+            if (!result.ok) {
+                throw new UpdateSourceError(result.isTimedOut ? 'the registry did not answer in time' : `the registry did not answer: ${(0, commandRunner_1.getOutputTail)(result, 2)}`);
+            }
+            return parseNpmViewOutput(result.stdout);
+        },
+        async install(version, options = {}) {
+            // A rollback prefers what the npm cache already holds: the registry may be the very thing that is down.
+            const args = ['install', '-g', '--prefix', prefix, `${exports.npmPackageName}@${version}`, ...commonArguments, ...(options.isRollback ? ['--prefer-offline'] : [])];
+            const result = await runCommand(npm, args, { env, timeoutMs: constants_1.installTimeoutMs });
+            if (!result.ok) {
+                throw new UpdateSourceError(result.isTimedOut ? `npm install ${version} did not finish in time` : `npm install ${version} failed: ${(0, commandRunner_1.getOutputTail)(result)}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=npmSource.js.map

package/dist/selfUpdate/npmSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npmSource.js","sourceRoot":"","sources":["../../src/selfUpdate/npmSource.ts"],"names":[],"mappings":"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"}

package/dist/selfUpdate/releaseNotes.d.ts

@@ -0,0 +1,33 @@
+/** One version's headlines in a what's-new summary; `version` is `null` for a checkout, which has no versions to name. */
+export interface WhatsNewGroup {
+    version: string | null;
+    headlines: string[];
+}
+/**
+ * What an update changed, ready to be worded: the entries an operator must act on (`### Upgrading`) first, then the
+ * headline of every other entry grouped by version, capped — `moreCount` entries did not fit.
+ */
+export interface WhatsNewSummary {
+    todo: string[];
+    groups: WhatsNewGroup[];
+    moreCount: number;
+}
+/**
+ * @description The headline of a CHANGELOG entry: its bold first sentence, links reduced to their text, code marks
+ * dropped. An entry without a bold lead (an old section) falls back to its first sentence, cut at a sentence end or at
+ * {@link fallbackHeadlineMaxLength} characters.
+ */
+export declare function getEntryHeadline(entryText: string): string;
+/**
+ * @description The summary of the released versions after `fromVersion` up to and including `toVersion` — every version
+ * the update skipped over — read from the installed `CHANGELOG.md`, oldest version first. `null` when the range holds no
+ * entry (an old package without a CHANGELOG, or without sections for these versions).
+ */
+export declare function getNpmReleaseNotes(changelogText: string, fromVersion: string, toVersion: string, limit?: number): WhatsNewSummary | null;
+/**
+ * @description The summary of what a checkout's update ADDED to `CHANGELOG.md`, read from `git diff` of the file with the
+ * whole file as context (so an entry added under an existing `### Upgrading` is still known as one). An entry counts when
+ * its first line is an added line; a reworded entry counts as new. `null` when nothing was added.
+ */
+export declare function getCheckoutReleaseNotes(diffText: string, limit?: number): WhatsNewSummary | null;
+//# sourceMappingURL=releaseNotes.d.ts.map

package/dist/selfUpdate/releaseNotes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"releaseNotes.d.ts","sourceRoot":"","sources":["../../src/selfUpdate/releaseNotes.ts"],"names":[],"mappings":"AAIA,0HAA0H;AAC1H,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAgBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAO1D;AA6CD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAA0B,GAChC,eAAe,GAAG,IAAI,CAYxB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAA0B,GAAG,eAAe,GAAG,IAAI,CAenH"}

package/dist/selfUpdate/releaseNotes.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEntryHeadline = getEntryHeadline;
+exports.getNpmReleaseNotes = getNpmReleaseNotes;
+exports.getCheckoutReleaseNotes = getCheckoutReleaseNotes;
+const changelogEntries_1 = require("../changelogEntries");
+const constants_1 = require("./constants");
+const semver_1 = require("./semver");
+const upgradingSubsection = 'upgrading';
+const versionHeadingPattern = /^## (\d+\.\d+\.\d+)(?:\s|$)/;
+const boldLeadPattern = /^\*\*(?=\S)([\s\S]*?\S)\*\*/;
+const linkPattern = /\[([^\]]*)\]\([^)]*\)/g;
+const fallbackHeadlineMaxLength = 200;
+const sentenceEndPattern = /[.!?](?:\s|$)/;
+const diffAddedPrefix = '+';
+const diffContextPrefix = ' ';
+const diffFileHeaderPattern = /^(?:diff --git|index |--- |\+\+\+ |@@ |\\)/;
+function reduceMarkdown(text) {
+    return text.replace(linkPattern, '$1').replaceAll('`', '').replace(/\s+/g, ' ').trim();
+}
+/**
+ * @description The headline of a CHANGELOG entry: its bold first sentence, links reduced to their text, code marks
+ * dropped. An entry without a bold lead (an old section) falls back to its first sentence, cut at a sentence end or at
+ * {@link fallbackHeadlineMaxLength} characters.
+ */
+function getEntryHeadline(entryText) {
+    const bold = boldLeadPattern.exec(entryText);
+    if (bold)
+        return reduceMarkdown(bold[1]);
+    const plain = reduceMarkdown(entryText);
+    const sentenceEnd = sentenceEndPattern.exec(plain);
+    const sentence = sentenceEnd ? plain.slice(0, sentenceEnd.index + 1) : plain;
+    return sentence.length > fallbackHeadlineMaxLength ? `${sentence.slice(0, fallbackHeadlineMaxLength - 1)}…` : sentence;
+}
+/** Caps the entries at `limit` in display order (to-do items first, then versions in the order given). */
+function createSummary(entries, limit) {
+    if (entries.length === 0)
+        return null;
+    const todoEntries = entries.filter((entry) => entry.isUpgrading);
+    const otherEntries = entries.filter((entry) => !entry.isUpgrading);
+    const kept = [...todoEntries, ...otherEntries].slice(0, limit);
+    const groups = [];
+    for (const entry of kept.filter((candidate) => !candidate.isUpgrading)) {
+        const group = groups.find((candidate) => candidate.version === entry.version);
+        if (group)
+            group.headlines.push(entry.headline);
+        else
+            groups.push({ version: entry.version, headlines: [entry.headline] });
+    }
+    return {
+        todo: kept.filter((entry) => entry.isUpgrading).map((entry) => entry.headline),
+        groups,
+        moreCount: entries.length - kept.length,
+    };
+}
+/** The `## X.Y.Z` sections of a CHANGELOG, each with its body text. */
+function getVersionSections(changelogText) {
+    const sections = [];
+    let current = null;
+    for (const line of changelogText.split('\n')) {
+        const heading = versionHeadingPattern.exec(line);
+        if (heading) {
+            current = { version: heading[1], lines: [] };
+            sections.push(current);
+        }
+        else if (line.startsWith('## ')) {
+            current = null;
+        }
+        else {
+            current?.lines.push(line);
+        }
+    }
+    return sections.map((section) => ({ version: section.version, body: section.lines.join('\n') }));
+}
+/**
+ * @description The summary of the released versions after `fromVersion` up to and including `toVersion` — every version
+ * the update skipped over — read from the installed `CHANGELOG.md`, oldest version first. `null` when the range holds no
+ * entry (an old package without a CHANGELOG, or without sections for these versions).
+ */
+function getNpmReleaseNotes(changelogText, fromVersion, toVersion, limit = constants_1.whatsNewItemLimit) {
+    const inRange = getVersionSections(changelogText)
+        .filter(({ version }) => ((0, semver_1.compareVersionTexts)(version, fromVersion) ?? -1) > 0 && ((0, semver_1.compareVersionTexts)(version, toVersion) ?? 1) <= 0)
+        .sort((left, right) => (0, semver_1.compareVersionTexts)(left.version, right.version) ?? 0);
+    const entries = inRange.flatMap(({ version, body }) => (0, changelogEntries_1.getChangelogEntries)(body).map((entry) => ({
+        version,
+        headline: getEntryHeadline(entry.text),
+        isUpgrading: entry.subsection?.toLowerCase() === upgradingSubsection,
+    })));
+    return createSummary(entries, limit);
+}
+/**
+ * @description The summary of what a checkout's update ADDED to `CHANGELOG.md`, read from `git diff` of the file with the
+ * whole file as context (so an entry added under an existing `### Upgrading` is still known as one). An entry counts when
+ * its first line is an added line; a reworded entry counts as new. `null` when nothing was added.
+ */
+function getCheckoutReleaseNotes(diffText, limit = constants_1.whatsNewItemLimit) {
+    const fileLines = [];
+    for (const line of diffText.split('\n')) {
+        if (diffFileHeaderPattern.test(line))
+            continue;
+        if (line.startsWith(diffAddedPrefix))
+            fileLines.push({ text: line.slice(1), isAdded: true });
+        else if (line.startsWith(diffContextPrefix))
+            fileLines.push({ text: line.slice(1), isAdded: false });
+    }
+    const entries = (0, changelogEntries_1.getChangelogEntries)(fileLines.map((line) => line.text).join('\n'))
+        .filter((entry) => fileLines[entry.leadLineIndex]?.isAdded)
+        .map((entry) => ({
+        version: null,
+        headline: getEntryHeadline(entry.text),
+        isUpgrading: entry.subsection?.toLowerCase() === upgradingSubsection,
+    }));
+    return createSummary(entries, limit);
+}
+//# sourceMappingURL=releaseNotes.js.map

package/dist/selfUpdate/releaseNotes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"releaseNotes.js","sourceRoot":"","sources":["../../src/selfUpdate/releaseNotes.ts"],"names":[],"mappings":"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"}

package/dist/selfUpdate/restart.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Replacing the running process with a fresh image of the same charness: `process.execve` — the SAME pid, so systemd,
+ * pm2, nohup or a foreground terminal see nothing happen. The new image gets the launch environment (see
+ * `launchEnvironment.ts`) and the original arguments; the agents are external processes and are re-adopted as on any restart.
+ */
+/** `EX_TEMPFAIL`: the restart could not be done now, a supervisor may try again. */
+export declare const restartFailedExitCode = 75;
+export interface ReexecTarget {
+    file: string;
+    args: string[];
+}
+/** @description The command line of a re-exec: `node <packageRoot>/dist/cli.js <the original arguments>`. */
+export declare function getReexecTarget(options: {
+    execPath: string;
+    packageRoot: string;
+    argv: readonly string[];
+}): ReexecTarget;
+/** @description What would make a re-exec fail, found BEFORE anything is shut down: a missing node, a missing `dist/cli.js`. */
+export declare function getReexecProblems(target: ReexecTarget, checkExists?: (target: string) => boolean): string[];
+export interface ReexecDeps {
+    execve: ((file: string, args: readonly string[], env: NodeJS.ProcessEnv) => never) | undefined;
+    exit: (code: number) => void;
+    log: (line: string) => void;
+}
+/**
+ * @description Replace this process with `target`. Never returns on success. A missing `process.execve` or an error from it
+ * is logged and ends the process with {@link restartFailedExitCode}, so a supervisor sees a failed restart rather than a bot
+ * that is silently gone.
+ */
+export declare function reexecProcess(target: ReexecTarget, env: NodeJS.ProcessEnv, deps: ReexecDeps): void;
+/** @description The real dependencies of {@link reexecProcess}. */
+export declare function createDefaultReexecDeps(): ReexecDeps;
+//# sourceMappingURL=restart.d.ts.map

package/dist/selfUpdate/restart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.d.ts","sourceRoot":"","sources":["../../src/selfUpdate/restart.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,6GAA6G;AAC7G,wBAAgB,eAAe,CAAC,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,YAAY,CAIzH;AAED,gIAAgI;AAChI,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAuB,GAAG,MAAM,EAAE,CAM1H;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,KAAK,CAAC,GAAG,SAAS,CAAC;IAC/F,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAYlG;AAED,mEAAmE;AACnE,wBAAgB,uBAAuB,IAAI,UAAU,CAOpD"}

package/dist/selfUpdate/restart.js

@@ -0,0 +1,94 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.restartFailedExitCode = void 0;
+exports.getReexecTarget = getReexecTarget;
+exports.getReexecProblems = getReexecProblems;
+exports.reexecProcess = reexecProcess;
+exports.createDefaultReexecDeps = createDefaultReexecDeps;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Replacing the running process with a fresh image of the same charness: `process.execve` — the SAME pid, so systemd,
+ * pm2, nohup or a foreground terminal see nothing happen. The new image gets the launch environment (see
+ * `launchEnvironment.ts`) and the original arguments; the agents are external processes and are re-adopted as on any restart.
+ */
+/** `EX_TEMPFAIL`: the restart could not be done now, a supervisor may try again. */
+exports.restartFailedExitCode = 75;
+/** @description The command line of a re-exec: `node <packageRoot>/dist/cli.js <the original arguments>`. */
+function getReexecTarget(options) {
+    const cliPath = path.join(options.packageRoot, 'dist', 'cli.js');
+    // argv[0] of the new image is the executable itself; `process.argv` here is [node, script, ...arguments].
+    return { file: options.execPath, args: [options.execPath, cliPath, ...options.argv.slice(2)] };
+}
+/** @description What would make a re-exec fail, found BEFORE anything is shut down: a missing node, a missing `dist/cli.js`. */
+function getReexecProblems(target, checkExists = fs.existsSync) {
+    const problems = [];
+    if (!checkExists(target.file))
+        problems.push(`the node executable ${target.file} is gone`);
+    const cliPath = target.args[1];
+    if (!checkExists(cliPath))
+        problems.push(`${cliPath} is gone`);
+    return problems;
+}
+/**
+ * @description Replace this process with `target`. Never returns on success. A missing `process.execve` or an error from it
+ * is logged and ends the process with {@link restartFailedExitCode}, so a supervisor sees a failed restart rather than a bot
+ * that is silently gone.
+ */
+function reexecProcess(target, env, deps) {
+    if (!deps.execve) {
+        deps.log('[update] this Node has no process.execve — cannot restart in place');
+        deps.exit(exports.restartFailedExitCode);
+        return;
+    }
+    try {
+        deps.execve(target.file, target.args, env);
+    }
+    catch (error) {
+        deps.log(`[update] execve failed: ${error instanceof Error ? error.message : String(error)}`);
+        deps.exit(exports.restartFailedExitCode);
+    }
+}
+/** @description The real dependencies of {@link reexecProcess}. */
+function createDefaultReexecDeps() {
+    const nativeExecve = process.execve;
+    return {
+        execve: nativeExecve ? (file, args, env) => nativeExecve.call(process, file, args, env) : undefined,
+        exit: (code) => process.exit(code),
+        log: (line) => console.error(line),
+    };
+}
+//# sourceMappingURL=restart.js.map

package/dist/selfUpdate/restart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.js","sourceRoot":"","sources":["../../src/selfUpdate/restart.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,0CAIC;AAGD,8CAMC;AAaD,sCAYC;AAGD,0DAOC;AAlED,uCAAyB;AACzB,2CAA6B;AAE7B;;;;GAIG;AAEH,oFAAoF;AACvE,QAAA,qBAAqB,GAAG,EAAE,CAAC;AAOxC,6GAA6G;AAC7G,SAAgB,eAAe,CAAC,OAA2E;IACzG,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjE,0GAA0G;IAC1G,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACjG,CAAC;AAED,gIAAgI;AAChI,SAAgB,iBAAiB,CAAC,MAAoB,EAAE,cAA2C,EAAE,CAAC,UAAU;IAC9G,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,IAAI,UAAU,CAAC,CAAC;IAC3F,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,UAAU,CAAC,CAAC;IAC/D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAQD;;;;GAIG;AACH,SAAgB,aAAa,CAAC,MAAoB,EAAE,GAAsB,EAAE,IAAgB;IAC1F,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,IAAI,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC;QAC/E,IAAI,CAAC,IAAI,CAAC,6BAAqB,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,GAAG,CAAC,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9F,IAAI,CAAC,IAAI,CAAC,6BAAqB,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,SAAgB,uBAAuB;IACrC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IACpC,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QACnG,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAClC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;KACnC,CAAC;AACJ,CAAC"}

package/dist/selfUpdate/selfCheck.d.ts

@@ -0,0 +1,20 @@
+export interface SelfCheckResult {
+    /** The package version, whatever else failed. */
+    version: string;
+    /** What is wrong; empty = the install is sound. */
+    problems: string[];
+}
+/** @description The built modules a self-check imports: every `.js` under `dist/` except entry points and tests, relative paths. */
+export declare function listImportableModules(distDirectory: string): string[];
+/**
+ * @description Check the install at `packageRoot` (the folder holding `package.json` and `dist/`). Importing the modules
+ * may resolve paths under `DATA_DIR` at import time, so the check runs with a throwaway one and removes it.
+ * `loadNativeBinding` loads `node-pty` (a parameter so a test can make it fail).
+ */
+export declare function runSelfCheck(packageRoot: string, expectVersion: string | null, loadNativeBinding?: () => Promise<object>): Promise<SelfCheckResult>;
+/**
+ * @description The CLI face: version on stdout, every problem on stderr, exit 1 when there is one. `packageRoot` is the
+ * folder this module's own `dist/` belongs to.
+ */
+export declare function runSelfCheckCli(args: string[], packageRoot: string): Promise<number>;
+//# sourceMappingURL=selfCheck.d.ts.map

package/dist/selfUpdate/selfCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selfCheck.d.ts","sourceRoot":"","sources":["../../src/selfUpdate/selfCheck.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,oIAAoI;AACpI,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAMrE;AAOD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,iBAAiB,GAAE,MAAM,OAAO,CAAC,MAAM,CAA4B,GAClE,OAAO,CAAC,eAAe,CAAC,CAsC1B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO1F"}