charness 3.3.2 → 3.5.0

package/dist/selfUpdate/gitSource.js

@@ -0,0 +1,183 @@
+"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.checkIsEmittedSource = checkIsEmittedSource;
+exports.checkChangesEmittedSource = checkChangesEmittedSource;
+exports.parseScriptKeys = parseScriptKeys;
+exports.parseGitCheck = parseGitCheck;
+exports.createGitSource = createGitSource;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const commandRunner_1 = require("./commandRunner");
+const constants_1 = require("./constants");
+const npmSource_1 = require("./npmSource");
+const selfUpdateScriptRelativePath = path.join('scripts', 'self-update.sh');
+const changelogFileName = 'CHANGELOG.md';
+const manifestFileNames = ['yarn.lock', 'package.json'];
+/** What `tsc -w` turns into files under `dist/` — and so into a worker reload by nodemon (which watches nothing else). */
+const emittedSourceRoot = 'src/';
+const unemittedSourcePrefixes = ['src/__tests__/', 'src/release/'];
+const emittedSourceExtension = '.ts';
+const declarationFileExtension = '.d.ts';
+/** The worker's own entry under `dist/`: a file nodemon watches, whose mtime alone makes it replace the worker. */
+const hotWorkerEntryRelativePath = path.join('dist', 'cli', 'botEntry.js');
+/** Enough context lines that the diff of CHANGELOG.md holds the whole file (an entry's `###` heading included). */
+const wholeFileContext = '--unified=100000';
+const heldBreakingExitCode = 3;
+const scriptKeyPattern = /^(status|reason|from|to|behind|migrationGuides)=(.*)$/;
+const gitCheckStatuses = ['upToDate', 'behind', 'skip'];
+const gitSkipReasons = ['dirty', 'diverged', 'noUpstream', 'inProgress', 'fetchFailed'];
+/**
+ * @description Whether a change to `filePath` makes `tsc -w` write a file under `dist/` — a TypeScript source it compiles (tests,
+ * the release tooling and declaration files excluded). Everything else — docs, the CHANGELOG, scripts, the manifests, a tsconfig
+ * edit that changes no output — leaves `dist/` as it is, so nothing would replace a hot worker by itself.
+ */
+function checkIsEmittedSource(filePath) {
+    return (filePath.startsWith(emittedSourceRoot) &&
+        filePath.endsWith(emittedSourceExtension) &&
+        !filePath.endsWith(declarationFileExtension) &&
+        !unemittedSourcePrefixes.some((prefix) => filePath.startsWith(prefix)));
+}
+/** @description Whether a pull of these paths is followed by a rebuild — and so by nodemon replacing the hot worker. */
+function checkChangesEmittedSource(changedFiles) {
+    return changedFiles.some(checkIsEmittedSource);
+}
+/** @description The `key=value` lines of the script's stdout (its log lines are ignored). */
+function parseScriptKeys(stdout) {
+    const keys = {};
+    for (const line of stdout.split('\n')) {
+        const match = scriptKeyPattern.exec(line);
+        if (match)
+            keys[match[1]] = match[2];
+    }
+    return keys;
+}
+function splitGuides(text) {
+    return (text ?? '').split(' ').filter((guide) => guide !== '');
+}
+function splitPaths(text) {
+    return text.split('\n').filter((line) => line !== '');
+}
+function toSkipReason(text) {
+    return gitSkipReasons.find((reason) => reason === text) ?? null;
+}
+/** @description The check a `--check` run printed. */
+function parseGitCheck(stdout) {
+    const keys = parseScriptKeys(stdout);
+    const status = gitCheckStatuses.find((candidate) => candidate === keys.status);
+    if (!status)
+        throw new npmSource_1.UpdateSourceError(`self-update.sh --check printed no status: ${stdout.slice(0, 200)}`);
+    return {
+        status,
+        reason: status === 'skip' ? toSkipReason(keys.reason) : null,
+        from: keys.from ?? '',
+        to: keys.to ?? '',
+        behind: Number(keys.behind ?? 0),
+        migrationGuides: splitGuides(keys.migrationGuides),
+    };
+}
+function createGitSource({ runCommand, root, env }) {
+    const script = path.join(root, selfUpdateScriptRelativePath);
+    async function runGit(args, timeoutMs) {
+        const result = await runCommand('git', args, { cwd: root, env, timeoutMs });
+        if (!result.ok)
+            throw new npmSource_1.UpdateSourceError(`git ${args[0]} failed: ${(0, commandRunner_1.getOutputTail)(result, 2)}`);
+        return result.stdout;
+    }
+    async function getChangedFiles(from, to) {
+        return splitPaths(await runGit(['diff', '--name-only', from, to], constants_1.queryTimeoutMs));
+    }
+    async function reloadHotWorker() {
+        const entry = path.join(root, hotWorkerEntryRelativePath);
+        const now = new Date();
+        try {
+            await fs.promises.utimes(entry, now, now);
+        }
+        catch (error) {
+            throw new npmSource_1.UpdateSourceError(`cannot ask the hot worker to reload (${entry}): ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return {
+        async check() {
+            const result = await runCommand('bash', [script, '--check'], { cwd: root, env, timeoutMs: constants_1.queryTimeoutMs });
+            if (!result.ok)
+                throw new npmSource_1.UpdateSourceError(result.isTimedOut ? 'the remote did not answer in time' : `self-update.sh --check failed: ${(0, commandRunner_1.getOutputTail)(result, 2)}`);
+            return parseGitCheck(result.stdout);
+        },
+        async apply({ holdBreaking }) {
+            const result = await runCommand('bash', [script, ...(holdBreaking ? ['--hold-breaking'] : [])], { cwd: root, env, timeoutMs: constants_1.installTimeoutMs });
+            const keys = parseScriptKeys(result.stdout);
+            if (result.exitCode === heldBreakingExitCode) {
+                return { status: 'held', from: keys.from ?? '', to: keys.to ?? '', migrationGuides: splitGuides(keys.migrationGuides) };
+            }
+            if (!result.ok)
+                throw new npmSource_1.UpdateSourceError(result.isTimedOut ? 'the update did not finish in time' : `self-update.sh failed: ${(0, commandRunner_1.getOutputTail)(result)}`);
+            if (keys.status === 'updated')
+                return { status: 'updated', from: keys.from ?? '', to: keys.to ?? '', migrationGuides: splitGuides(keys.migrationGuides) };
+            if (keys.status === 'upToDate')
+                return { status: 'upToDate' };
+            if (keys.status === 'skip')
+                return { status: 'skip', reason: toSkipReason(keys.reason) };
+            throw new npmSource_1.UpdateSourceError(`self-update.sh printed no status: ${(0, commandRunner_1.getOutputTail)(result)}`);
+        },
+        async getChangelogDiff(from, to) {
+            return runGit(['diff', wholeFileContext, `${from}..${to}`, '--', changelogFileName], constants_1.queryTimeoutMs);
+        },
+        getChangedFiles,
+        reloadHotWorker,
+        async rollback({ from, to, isHot }) {
+            const changedFiles = await getChangedFiles(from, to);
+            // `--keep`: refuses rather than overwrite a local change the update never touched.
+            await runGit(['reset', '--keep', from], constants_1.queryTimeoutMs);
+            const isManifestChanged = changedFiles.some((file) => manifestFileNames.includes(file));
+            if (isManifestChanged) {
+                const install = await runCommand('yarn', ['install', '--immutable'], { cwd: root, env, timeoutMs: constants_1.installTimeoutMs });
+                if (!install.ok)
+                    throw new npmSource_1.UpdateSourceError(`yarn install failed on the way back: ${(0, commandRunner_1.getOutputTail)(install)}`);
+            }
+            // A hot watcher rebuilds the reset checkout by itself; a second build beside it would race its writes. When the range changed
+            // no compiled source there is nothing to rebuild — and nothing that would restart the worker: ask for the reload.
+            if (isHot) {
+                if (!checkChangesEmittedSource(changedFiles))
+                    await reloadHotWorker();
+                return;
+            }
+            const build = await runCommand('yarn', ['build'], { cwd: root, env, timeoutMs: constants_1.installTimeoutMs });
+            if (!build.ok)
+                throw new npmSource_1.UpdateSourceError(`yarn build failed on the way back: ${(0, commandRunner_1.getOutputTail)(build)}`);
+        },
+    };
+}
+//# sourceMappingURL=gitSource.js.map

package/dist/selfUpdate/gitSource.js.map

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

package/dist/selfUpdate/hostLock.d.ts

@@ -0,0 +1,16 @@
+export interface HostLockDeps {
+    now: () => number;
+    /** Whether a process with this pid exists (`kill(pid, 0)`). */
+    checkIsProcessAlive: (pid: number) => boolean;
+    pid: number;
+}
+export interface HostLock {
+    release: () => void;
+}
+export declare function createDefaultHostLockDeps(): HostLockDeps;
+/**
+ * @description Take the lock at `lockPath`, or `null` when another live process holds it. A stale or unreadable lock
+ * is taken over; the file is created exclusively, so two takers can never both win.
+ */
+export declare function acquireHostLock(lockPath: string, deps?: HostLockDeps): HostLock | null;
+//# sourceMappingURL=hostLock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hostLock.d.ts","sourceRoot":"","sources":["../../src/selfUpdate/hostLock.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,+DAA+D;IAC/D,mBAAmB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAMD,wBAAgB,yBAAyB,IAAI,YAAY,CAcxD;AAgBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,YAA0C,GAAG,QAAQ,GAAG,IAAI,CAmBnH"}

package/dist/selfUpdate/hostLock.js

@@ -0,0 +1,101 @@
+"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.createDefaultHostLockDeps = createDefaultHostLockDeps;
+exports.acquireHostLock = acquireHostLock;
+const fs = __importStar(require("fs"));
+const constants_1 = require("./constants");
+function getErrorCode(error) {
+    return error instanceof Error && 'code' in error && typeof error.code === 'string' ? error.code : undefined;
+}
+function createDefaultHostLockDeps() {
+    return {
+        now: () => Date.now(),
+        pid: process.pid,
+        checkIsProcessAlive: (pid) => {
+            try {
+                process.kill(pid, 0);
+                return true;
+            }
+            catch (error) {
+                // EPERM: it exists but is another user's.
+                return getErrorCode(error) === 'EPERM';
+            }
+        },
+    };
+}
+function readLockRecord(lockPath) {
+    try {
+        const record = JSON.parse(fs.readFileSync(lockPath, 'utf8'));
+        return Number.isInteger(record.pid) && Number.isFinite(record.startedAt) ? record : null;
+    }
+    catch {
+        return null;
+    }
+}
+function checkIsLockStale(record, deps) {
+    if (record === null)
+        return true;
+    return !deps.checkIsProcessAlive(record.pid) || deps.now() - record.startedAt > constants_1.hostLockStaleMs;
+}
+/**
+ * @description Take the lock at `lockPath`, or `null` when another live process holds it. A stale or unreadable lock
+ * is taken over; the file is created exclusively, so two takers can never both win.
+ */
+function acquireHostLock(lockPath, deps = createDefaultHostLockDeps()) {
+    const record = { pid: deps.pid, startedAt: deps.now() };
+    const maxAttempts = 2;
+    for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
+        try {
+            fs.writeFileSync(lockPath, JSON.stringify(record), { flag: 'wx' });
+            return {
+                release: () => {
+                    // Only the owner's own file: a lock taken over meanwhile is not ours to remove.
+                    if (readLockRecord(lockPath)?.pid === deps.pid)
+                        fs.rmSync(lockPath, { force: true });
+                },
+            };
+        }
+        catch (error) {
+            if (getErrorCode(error) !== 'EEXIST')
+                throw error;
+            if (!checkIsLockStale(readLockRecord(lockPath), deps))
+                return null;
+            fs.rmSync(lockPath, { force: true });
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=hostLock.js.map

package/dist/selfUpdate/hostLock.js.map

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

package/dist/selfUpdate/hotSupervisor.d.ts

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+/**
+ * The hot supervisor (`charness hot`: `tsc -w` + nodemon) reloads only its WORKER on an update. When a file the SUPERVISOR
+ * itself loaded changed, the supervisor must be replaced too: it re-executes itself on `SIGUSR2` — same pid, so a Docker
+ * entrypoint `wait`ing on it, `charness-restart-bot` and systemd see nothing. This module is the contract between the two:
+ * the supervisor records what it loaded and who it is, the worker compares the record with `dist/` and, at an idle point,
+ * signals exactly that supervisor — never a pid that has been reused.
+ */
+export declare const hotSupervisorRecordFileName = "hot-supervisor.json";
+/** Sent by a worker to its supervisor: re-execute yourself. */
+export declare const supervisorReexecSignal: NodeJS.Signals;
+declare const recordSchema: z.ZodObject<{
+    pid: z.ZodNumber;
+    startToken: z.ZodString;
+    canReexec: z.ZodBoolean;
+    modules: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** What a supervisor says about itself: its identity, whether it can re-execute, and the hash of every `dist/` module it loaded. */
+export type HotSupervisorRecord = z.infer<typeof recordSchema>;
+export declare function getHotSupervisorRecordPath(dataDir: string): string;
+export declare function hashFile(filePath: string): string;
+/**
+ * @description The modules a process loaded from `<root>/dist`, as paths relative to `dist/` with the hash of the file on
+ * disk. Called at the START of the supervisor, before its watcher rebuilds anything, so the hash is the loaded code's.
+ */
+export declare function collectLoadedDistModules(distDirectory: string, loadedModulePaths: readonly string[]): HotSupervisorRecord['modules'];
+export declare function writeHotSupervisorRecord(dataDir: string, record: HotSupervisorRecord): void;
+/** @description The supervisor's record; `null` when there is none (a supervisor that predates re-exec) or it is unreadable. */
+export declare function readHotSupervisorRecord(dataDir: string): HotSupervisorRecord | null;
+/** @description The recorded modules whose file on disk now differs, or is gone: the supervisor runs code that is no longer there. */
+export declare function getStaleSupervisorModules(record: HotSupervisorRecord, distDirectory: string): string[];
+export interface SupervisorSignalDeps {
+    /** The start token of the process with this pid now; `null` when no such process exists. */
+    getStartToken: (pid: number) => string | null;
+    kill: (pid: number, signal: NodeJS.Signals) => void;
+}
+export type SupervisorSignalResult = 'signaled' | 'gone' | 'differentProcess' | 'cannotReexec';
+/**
+ * @description Ask the supervisor named by `record` to re-execute — only when that pid is still the SAME process (its start
+ * token matches) and the record says it can. A reused pid is a stranger's process: it gets nothing.
+ */
+export declare function requestSupervisorReexec(record: HotSupervisorRecord, deps: SupervisorSignalDeps): SupervisorSignalResult;
+export {};
+//# sourceMappingURL=hotSupervisor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hotSupervisor.d.ts","sourceRoot":"","sources":["../../src/selfUpdate/hotSupervisor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;GAMG;AAEH,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AAGjE,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,OAAmB,CAAC;AAEhE,QAAA,MAAM,YAAY;;;;;;;;iBAKhB,CAAC;AAEH,oIAAoI;AACpI,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAE/D,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,MAAM,EAAE,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAMpI;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAE3F;AAED,gIAAgI;AAChI,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAOnF;AAED,sIAAsI;AACtI,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAUtG;AAED,MAAM,WAAW,oBAAoB;IACnC,4FAA4F;IAC5F,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC9C,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,MAAM,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAE/F;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,oBAAoB,GAAG,sBAAsB,CAOvH"}

package/dist/selfUpdate/hotSupervisor.js

@@ -0,0 +1,125 @@
+"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.supervisorReexecSignal = exports.hotSupervisorRecordFileName = void 0;
+exports.getHotSupervisorRecordPath = getHotSupervisorRecordPath;
+exports.hashFile = hashFile;
+exports.collectLoadedDistModules = collectLoadedDistModules;
+exports.writeHotSupervisorRecord = writeHotSupervisorRecord;
+exports.readHotSupervisorRecord = readHotSupervisorRecord;
+exports.getStaleSupervisorModules = getStaleSupervisorModules;
+exports.requestSupervisorReexec = requestSupervisorReexec;
+const crypto = __importStar(require("crypto"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const configDirFile_1 = require("../configDirFile");
+/**
+ * The hot supervisor (`charness hot`: `tsc -w` + nodemon) reloads only its WORKER on an update. When a file the SUPERVISOR
+ * itself loaded changed, the supervisor must be replaced too: it re-executes itself on `SIGUSR2` — same pid, so a Docker
+ * entrypoint `wait`ing on it, `charness-restart-bot` and systemd see nothing. This module is the contract between the two:
+ * the supervisor records what it loaded and who it is, the worker compares the record with `dist/` and, at an idle point,
+ * signals exactly that supervisor — never a pid that has been reused.
+ */
+exports.hotSupervisorRecordFileName = 'hot-supervisor.json';
+const recordFileMode = 0o600;
+const sha256Algorithm = 'sha256';
+/** Sent by a worker to its supervisor: re-execute yourself. */
+exports.supervisorReexecSignal = 'SIGUSR2';
+const recordSchema = zod_1.z.object({
+    pid: zod_1.z.number().int().positive(),
+    startToken: zod_1.z.string().min(1),
+    canReexec: zod_1.z.boolean(),
+    modules: zod_1.z.array(zod_1.z.object({ path: zod_1.z.string(), sha256: zod_1.z.string() })),
+});
+function getHotSupervisorRecordPath(dataDir) {
+    return path.join(dataDir, exports.hotSupervisorRecordFileName);
+}
+function hashFile(filePath) {
+    return crypto.createHash(sha256Algorithm).update(fs.readFileSync(filePath)).digest('hex');
+}
+/**
+ * @description The modules a process loaded from `<root>/dist`, as paths relative to `dist/` with the hash of the file on
+ * disk. Called at the START of the supervisor, before its watcher rebuilds anything, so the hash is the loaded code's.
+ */
+function collectLoadedDistModules(distDirectory, loadedModulePaths) {
+    const prefix = `${distDirectory}${path.sep}`;
+    return loadedModulePaths
+        .filter((modulePath) => modulePath.startsWith(prefix) && modulePath.endsWith('.js'))
+        .map((modulePath) => ({ path: path.relative(distDirectory, modulePath).split(path.sep).join('/'), sha256: hashFile(modulePath) }))
+        .sort((left, right) => left.path.localeCompare(right.path));
+}
+function writeHotSupervisorRecord(dataDir, record) {
+    (0, configDirFile_1.writeJsonFileAtomically)(getHotSupervisorRecordPath(dataDir), record, recordFileMode);
+}
+/** @description The supervisor's record; `null` when there is none (a supervisor that predates re-exec) or it is unreadable. */
+function readHotSupervisorRecord(dataDir) {
+    try {
+        const parsed = recordSchema.safeParse(JSON.parse(fs.readFileSync(getHotSupervisorRecordPath(dataDir), 'utf8')));
+        return parsed.success ? parsed.data : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** @description The recorded modules whose file on disk now differs, or is gone: the supervisor runs code that is no longer there. */
+function getStaleSupervisorModules(record, distDirectory) {
+    return record.modules
+        .filter((module) => {
+        try {
+            return hashFile(path.join(distDirectory, module.path)) !== module.sha256;
+        }
+        catch {
+            return true;
+        }
+    })
+        .map((module) => module.path);
+}
+/**
+ * @description Ask the supervisor named by `record` to re-execute — only when that pid is still the SAME process (its start
+ * token matches) and the record says it can. A reused pid is a stranger's process: it gets nothing.
+ */
+function requestSupervisorReexec(record, deps) {
+    if (!record.canReexec)
+        return 'cannotReexec';
+    const startToken = deps.getStartToken(record.pid);
+    if (startToken === null)
+        return 'gone';
+    if (startToken !== record.startToken)
+        return 'differentProcess';
+    deps.kill(record.pid, exports.supervisorReexecSignal);
+    return 'signaled';
+}
+//# sourceMappingURL=hotSupervisor.js.map

package/dist/selfUpdate/hotSupervisor.js.map

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

package/dist/selfUpdate/installKind.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @description How this charness was installed — decided by what the package folder IS and by what the bot may
+ * write there, never by "is this a container": a Docker image mounting a git checkout is a checkout.
+ *
+ *   - `npmGlobal`: `npm install -g`, the prefix writable → `npm install -g charness@X` into the SAME prefix.
+ *   - `checkout`: a git checkout (`npm link` and a mounted checkout included), writable → `scripts/self-update.sh`.
+ *   - `notifyOnly`: it cannot update itself (no write access, a package manager we do not drive, a Node without
+ *     `process.execve`): for an npm-style install it says a new version is out and names the command to run by hand; a
+ *     checkout (`isCheckout`) is not watched at all — `/update` names the reason and the command.
+ *   - `ephemeral`: `npx` — gone after the run, nothing to update.
+ */
+export type InstallKind = {
+    kind: 'npmGlobal';
+    prefix: string;
+} | {
+    kind: 'checkout';
+    root: string;
+} | {
+    kind: 'notifyOnly';
+    reason: NotifyOnlyReason;
+    manualCommand: string;
+    isCheckout: boolean;
+} | {
+    kind: 'ephemeral';
+};
+/** @name NotifyOnlyReason @description Why an install can only notify; the `/update` screen words each one. */
+export type NotifyOnlyReason = 'readOnlyPrefix' | 'readOnlyCheckout' | 'packageManager' | 'localInstall' | 'noExecve';
+/** What the detector needs from the filesystem — injected, so a test needs no real prefix. */
+export interface InstallKindFs {
+    checkExists: (target: string) => boolean;
+    /** Whether the current process may create and replace entries in the directory. */
+    checkIsWritable: (directory: string) => boolean;
+}
+export interface InstallKindInput {
+    /** The package's folder, symlinks resolved (`fs.realpathSync`) — the folder `dist/cli.js` sits in. */
+    packageRoot: string;
+    fs: InstallKindFs;
+    platform: NodeJS.Platform;
+    /** Whether this Node has `process.execve` (22.15+, POSIX): the plain-mode restart needs it. */
+    hasExecve: boolean;
+}
+export declare const npmManualCommand = "npm install -g charness@latest";
+/** @description Decide the install kind of a package folder. */
+export declare function detectInstallKind({ packageRoot, fs: filesystem, platform, hasExecve }: InstallKindInput): InstallKind;
+//# sourceMappingURL=installKind.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"installKind.d.ts","sourceRoot":"","sources":["../../src/selfUpdate/installKind.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAC5F;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAE1B,+GAA+G;AAC/G,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,cAAc,GAAG,UAAU,CAAC;AAEtH,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC,mFAAmF;IACnF,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CACjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,sGAAsG;IACtG,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,aAAa,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,+FAA+F;IAC/F,SAAS,EAAE,OAAO,CAAC;CACpB;AAgBD,eAAO,MAAM,gBAAgB,mCAAmC,CAAC;AAoBjE,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,gBAAgB,GAAG,WAAW,CA0BrH"}