crewly 1.20.143 → 1.20.145

package/dist/backend/backend/src/services/system/auto-update.utils.d.ts

@@ -0,0 +1,265 @@
+/**
+ * Auto-update helpers — pure / filesystem-only pieces of the self-update
+ * (specs/auto-update.md), kept apart from the service so each rule is
+ * testable without timers:
+ *
+ * - where the running copy lives and what kind of install it is (npm global,
+ *   user-prefix npm, dev checkout, anything else);
+ * - the `npm install -g` arguments that target that same prefix;
+ * - the on/off decision (setting + env override);
+ * - whether a supervisor will bring the backend back after RESTART_REQUESTED;
+ * - the status file (`crewly update-status`) and the pending-upgrade marker.
+ *
+ * @module services/system/auto-update.utils
+ */
+/** What kind of install the running copy is. */
+export type InstallKind = 'npm-global' | 'dev-checkout' | 'unmanaged';
+/** Where and how the running copy is installed. */
+export interface InstallInfo {
+    /** Install kind */
+    kind: InstallKind;
+    /** Real path of the Crewly package root (null when not found) */
+    packageRoot: string | null;
+    /** npm prefix the package lives under (npm-global only) */
+    prefix: string | null;
+    /** Human-readable reason, used in the skip log line */
+    detail: string;
+}
+/** Why auto-update is on or off. */
+export type AutoUpdateSwitch = 'enabled' | 'disabled-setting' | 'disabled-env' | 'enabled-env';
+/** How the last auto-update attempt ended. */
+export type AutoUpdateOutcome = 'up-to-date' | 'deferred-busy' | 'installed-restarting' | 'upgraded' | 'install-failed' | 'verify-failed' | 'restart-unavailable' | 'check-failed' | 'skipped';
+/** Persisted status of the auto-updater (`<crewlyHome>/auto-update-state.json`). */
+export interface AutoUpdateState {
+    /** Version this backend is running */
+    currentVersion: string | null;
+    /** Latest version the registry reported */
+    latestVersion: string | null;
+    /** ISO time of the last registry check */
+    lastCheckAt: string | null;
+    /** Whether the updater would act, and why not when it would not */
+    mode: string;
+    /** How the last attempt ended */
+    lastResult: {
+        outcome: AutoUpdateOutcome;
+        at: string;
+        version?: string;
+        message?: string;
+    } | null;
+    /** Failed attempts in a row (reset on success) */
+    consecutiveFailures: number;
+    /** ISO time before which no new attempt is made */
+    backoffUntil: string | null;
+    /** Target version the owner was already told about (one failure DM per version) */
+    failureNotifiedVersion: string | null;
+}
+/** Marker persisted before an upgrade restart and read on the next boot. */
+export interface PendingUpgradeMarker {
+    /** Version the process was running before the restart */
+    fromVersion: string;
+    /** Version that was installed */
+    toVersion: string;
+    /** ISO time the marker was written */
+    at: string;
+}
+/**
+ * Resolve symlinks when the path exists.
+ *
+ * @param p - Path
+ * @returns Real path, or the resolved path when it does not exist
+ */
+export declare function realOrResolved(p: string): string;
+/**
+ * Walk up from `startDir` to the directory whose package.json is `crewly`.
+ *
+ * @param startDir - Directory to start from
+ * @returns The package root, or null when none is found
+ */
+export declare function findCrewlyPackageRoot(startDir: string): string | null;
+/**
+ * Package root of the running backend, anchored on the entry script
+ * (`process.argv[1]`, e.g. `<root>/dist/backend/backend/src/index.js`) rather
+ * than the cwd — after `npm install -g` replaces the package directory the
+ * old cwd no longer exists.
+ *
+ * @param argv1 - Entry script path (defaults to process.argv[1])
+ * @param cwd - Fallback start directory
+ * @returns Real path of the package root, or null
+ */
+export declare function resolveRunningPackageRoot(argv1?: string | undefined, cwd?: string): string | null;
+/**
+ * The npm prefix a package root was installed under, when it is a global
+ * install: `<prefix>/lib/node_modules/crewly` on POSIX,
+ * `<prefix>\node_modules\crewly` on Windows. Covers the default global prefix
+ * (nvm, Homebrew, /usr/local) and the user prefix (`<crewlyHome>/npm-global`)
+ * alike — installing with `--prefix <that>` replaces exactly the running copy
+ * even when a different `npm` is first on PATH.
+ *
+ * @param packageRoot - Real path of the package root
+ * @param platform - Platform (tests)
+ * @returns The prefix, or null for anything that is not a global install
+ *
+ * @example
+ * ```ts
+ * derivePrefixFromPackageRoot('/usr/local/lib/node_modules/crewly'); // '/usr/local'
+ * derivePrefixFromPackageRoot('/home/me/.crewly/npm-global/lib/node_modules/crewly'); // '/home/me/.crewly/npm-global'
+ * derivePrefixFromPackageRoot('/home/me/proj/node_modules/crewly'); // null (local dependency)
+ * ```
+ */
+export declare function derivePrefixFromPackageRoot(packageRoot: string, platform?: NodeJS.Platform): string | null;
+/**
+ * Whether a directory is a git working tree root (`.git` directory, or the
+ * `.git` file of a worktree).
+ *
+ * @param dir - Directory
+ * @returns True when `.git` exists there
+ */
+export declare function isGitWorkingTree(dir: string): boolean;
+/**
+ * Classify the running install.
+ *
+ * - `dev-checkout`: the package root is a git working tree (e.g. the owner's
+ *   `crewly/` repo running its own build, or an `npm link` that resolves into
+ *   it). It must never npm-install over itself.
+ * - `npm-global`: the root sits in `<prefix>/lib/node_modules/crewly`.
+ * - `unmanaged`: anything else (Docker image at /app, a local dependency, an
+ *   npx cache) — nobody owns an in-place upgrade there.
+ *
+ * @param packageRoot - Real path of the package root (null when unknown)
+ * @param platform - Platform (tests)
+ * @returns Install info
+ */
+export declare function detectInstall(packageRoot: string | null, platform?: NodeJS.Platform): InstallInfo;
+/**
+ * `npm` arguments that install `crewly@<version>` over the running copy.
+ *
+ * @param prefix - Prefix from {@link derivePrefixFromPackageRoot}
+ * @param version - Exact target version
+ * @returns Arguments for npm
+ *
+ * @example
+ * ```ts
+ * npmInstallArgs('/usr/local', '1.20.144');
+ * // ['install', '-g', '--prefix', '/usr/local', 'crewly@1.20.144']
+ * ```
+ */
+export declare function npmInstallArgs(prefix: string, version: string): string[];
+/**
+ * The npm executable that belongs to the running node, when it sits next to
+ * it (nvm, official installers); plain `npm` from PATH otherwise.
+ *
+ * @param execPath - Running node binary (defaults to process.execPath)
+ * @param platform - Platform (tests)
+ * @returns Command to run
+ */
+export declare function resolveNpmCommand(execPath?: string, platform?: NodeJS.Platform): string;
+/**
+ * Version in `<packageRoot>/package.json`, read fresh from disk.
+ *
+ * @param packageRoot - Package root
+ * @returns The version, or null when unreadable
+ */
+export declare function readInstalledVersion(packageRoot: string): string | null;
+/**
+ * Whether `latest` is a strictly newer semver than `current`
+ * (numeric major.minor.patch; pre-release tags are ignored).
+ *
+ * @param latest - Candidate version
+ * @param current - Running version
+ * @returns True when latest > current
+ */
+export declare function isNewerVersion(latest: string, current: string): boolean;
+/**
+ * Resolve the on/off switch: the env override wins over the setting.
+ *
+ * @param settingValue - `settings.general.autoUpdate` (undefined = default on)
+ * @param env - Environment
+ * @returns The switch state
+ *
+ * @example
+ * ```ts
+ * resolveAutoUpdateSwitch(true, { CREWLY_AUTO_UPDATE: '0' }); // 'disabled-env'
+ * resolveAutoUpdateSwitch(false, {}); // 'disabled-setting'
+ * ```
+ */
+export declare function resolveAutoUpdateSwitch(settingValue: boolean | undefined, env?: NodeJS.ProcessEnv): AutoUpdateSwitch;
+/**
+ * Whether a switch state means "on".
+ *
+ * @param state - Switch state
+ * @returns True when enabled
+ */
+export declare function isSwitchOn(state: AutoUpdateSwitch): boolean;
+/**
+ * Read the command line of a process (POSIX only; `/proc` on Linux, `ps`
+ * elsewhere).
+ *
+ * @param pid - Process id
+ * @returns The command line, or null
+ */
+export declare function readProcessCommandLine(pid: number): string | null;
+/**
+ * Whether a supervisor will respawn the backend after it exits with
+ * RESTART_REQUESTED. That supervisor is `crewly start` (foreground, under the
+ * macOS login-item wrapper, under systemd, or under the desktop app). New
+ * CLIs say so in the env; an older CLI parent is recognised by its command line.
+ *
+ * @param env - Environment
+ * @param parentCommandLine - Reader for the parent's command line (tests)
+ * @returns True when a respawning parent is present
+ */
+export declare function hasRestartSupervisor(env?: NodeJS.ProcessEnv, parentCommandLine?: () => string | null): boolean;
+/**
+ * A fresh, empty state.
+ *
+ * @returns Default state
+ */
+export declare function emptyAutoUpdateState(): AutoUpdateState;
+/**
+ * Read the status file; missing or malformed → empty state.
+ *
+ * @param file - Path of the status file
+ * @returns The state
+ */
+export declare function readAutoUpdateState(file: string): AutoUpdateState;
+/**
+ * Write the status file atomically (temp file + rename).
+ *
+ * @param file - Path of the status file
+ * @param state - State to write
+ */
+export declare function writeAutoUpdateState(file: string, state: AutoUpdateState): void;
+/**
+ * Write the pending-upgrade marker.
+ *
+ * @param file - Marker path
+ * @param marker - Contents
+ */
+export declare function writePendingMarker(file: string, marker: PendingUpgradeMarker): void;
+/**
+ * Read and delete the pending-upgrade marker. It is removed even when
+ * malformed, so a crash loop can never repeat the notice.
+ *
+ * @param file - Marker path
+ * @returns The marker, or null when absent or malformed
+ */
+export declare function consumePendingMarker(file: string): PendingUpgradeMarker | null;
+/**
+ * Owner notice after a successful auto-upgrade.
+ *
+ * @param version - New version
+ * @param deviceName - This machine's name
+ * @returns The one-line notice
+ */
+export declare function composeUpgradedNotice(version: string, deviceName: string): string;
+/**
+ * Owner notice after repeated failures.
+ *
+ * @param version - Target version
+ * @param deviceName - This machine's name
+ * @param failures - Failures in a row
+ * @param reason - Last failure reason
+ * @returns The notice text
+ */
+export declare function composeFailureNotice(version: string, deviceName: string, failures: number, reason: string): string;
+//# sourceMappingURL=auto-update.utils.d.ts.map

package/dist/backend/backend/src/services/system/auto-update.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-update.utils.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/system/auto-update.utils.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/system/auto-update.utils.js

@@ -0,0 +1,397 @@
+/**
+ * Auto-update helpers — pure / filesystem-only pieces of the self-update
+ * (specs/auto-update.md), kept apart from the service so each rule is
+ * testable without timers:
+ *
+ * - where the running copy lives and what kind of install it is (npm global,
+ *   user-prefix npm, dev checkout, anything else);
+ * - the `npm install -g` arguments that target that same prefix;
+ * - the on/off decision (setting + env override);
+ * - whether a supervisor will bring the backend back after RESTART_REQUESTED;
+ * - the status file (`crewly update-status`) and the pending-upgrade marker.
+ *
+ * @module services/system/auto-update.utils
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { execFileSync } from 'child_process';
+import { AUTO_UPDATE_CONSTANTS } from '../../constants.js';
+/** Name of the directory npm installs packages into. */
+const NODE_MODULES_DIR = 'node_modules';
+/** Directory between the prefix and node_modules for POSIX global installs. */
+const POSIX_GLOBAL_LIB_DIR = 'lib';
+/** Env values that force auto-update off. */
+const ENV_OFF_VALUES = ['0', 'false', 'off', 'no'];
+/** Env values that force auto-update on. */
+const ENV_ON_VALUES = ['1', 'true', 'on', 'yes'];
+/** Pattern matching the `crewly start` command line of a supervising CLI parent. */
+const CLI_START_CMDLINE_PATTERN = /(?:\bcrewly|cli[\\/]src[\\/]index\.[jt]s)\S*\s+start\b/;
+/**
+ * Resolve symlinks when the path exists.
+ *
+ * @param p - Path
+ * @returns Real path, or the resolved path when it does not exist
+ */
+export function realOrResolved(p) {
+    try {
+        return fs.realpathSync(p);
+    }
+    catch {
+        return path.resolve(p);
+    }
+}
+/**
+ * Walk up from `startDir` to the directory whose package.json is `crewly`.
+ *
+ * @param startDir - Directory to start from
+ * @returns The package root, or null when none is found
+ */
+export function findCrewlyPackageRoot(startDir) {
+    let current = path.resolve(startDir);
+    for (;;) {
+        const pkgPath = path.join(current, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+                if (pkg.name === AUTO_UPDATE_CONSTANTS.PACKAGE_NAME)
+                    return current;
+            }
+            catch {
+                // Malformed package.json — keep walking
+            }
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+/**
+ * Package root of the running backend, anchored on the entry script
+ * (`process.argv[1]`, e.g. `<root>/dist/backend/backend/src/index.js`) rather
+ * than the cwd — after `npm install -g` replaces the package directory the
+ * old cwd no longer exists.
+ *
+ * @param argv1 - Entry script path (defaults to process.argv[1])
+ * @param cwd - Fallback start directory
+ * @returns Real path of the package root, or null
+ */
+export function resolveRunningPackageRoot(argv1 = process.argv[1], cwd) {
+    const anchors = [];
+    if (argv1)
+        anchors.push(path.dirname(realOrResolved(argv1)));
+    if (cwd)
+        anchors.push(cwd);
+    for (const anchor of anchors) {
+        const root = findCrewlyPackageRoot(anchor);
+        if (root)
+            return realOrResolved(root);
+    }
+    return null;
+}
+/**
+ * The npm prefix a package root was installed under, when it is a global
+ * install: `<prefix>/lib/node_modules/crewly` on POSIX,
+ * `<prefix>\node_modules\crewly` on Windows. Covers the default global prefix
+ * (nvm, Homebrew, /usr/local) and the user prefix (`<crewlyHome>/npm-global`)
+ * alike — installing with `--prefix <that>` replaces exactly the running copy
+ * even when a different `npm` is first on PATH.
+ *
+ * @param packageRoot - Real path of the package root
+ * @param platform - Platform (tests)
+ * @returns The prefix, or null for anything that is not a global install
+ *
+ * @example
+ * ```ts
+ * derivePrefixFromPackageRoot('/usr/local/lib/node_modules/crewly'); // '/usr/local'
+ * derivePrefixFromPackageRoot('/home/me/.crewly/npm-global/lib/node_modules/crewly'); // '/home/me/.crewly/npm-global'
+ * derivePrefixFromPackageRoot('/home/me/proj/node_modules/crewly'); // null (local dependency)
+ * ```
+ */
+export function derivePrefixFromPackageRoot(packageRoot, platform = process.platform) {
+    const p = platform === 'win32' ? path.win32 : path.posix;
+    if (p.basename(packageRoot) !== AUTO_UPDATE_CONSTANTS.PACKAGE_NAME)
+        return null;
+    const nodeModules = p.dirname(packageRoot);
+    if (p.basename(nodeModules) !== NODE_MODULES_DIR)
+        return null;
+    const parent = p.dirname(nodeModules);
+    if (platform === 'win32')
+        return parent;
+    if (p.basename(parent) !== POSIX_GLOBAL_LIB_DIR)
+        return null;
+    return p.dirname(parent);
+}
+/**
+ * Whether a directory is a git working tree root (`.git` directory, or the
+ * `.git` file of a worktree).
+ *
+ * @param dir - Directory
+ * @returns True when `.git` exists there
+ */
+export function isGitWorkingTree(dir) {
+    return fs.existsSync(path.join(dir, '.git'));
+}
+/**
+ * Classify the running install.
+ *
+ * - `dev-checkout`: the package root is a git working tree (e.g. the owner's
+ *   `crewly/` repo running its own build, or an `npm link` that resolves into
+ *   it). It must never npm-install over itself.
+ * - `npm-global`: the root sits in `<prefix>/lib/node_modules/crewly`.
+ * - `unmanaged`: anything else (Docker image at /app, a local dependency, an
+ *   npx cache) — nobody owns an in-place upgrade there.
+ *
+ * @param packageRoot - Real path of the package root (null when unknown)
+ * @param platform - Platform (tests)
+ * @returns Install info
+ */
+export function detectInstall(packageRoot, platform = process.platform) {
+    if (!packageRoot) {
+        return { kind: 'unmanaged', packageRoot: null, prefix: null, detail: 'package root not found' };
+    }
+    if (isGitWorkingTree(packageRoot)) {
+        return { kind: 'dev-checkout', packageRoot, prefix: null, detail: `dev checkout (${packageRoot})` };
+    }
+    const prefix = derivePrefixFromPackageRoot(packageRoot, platform);
+    if (!prefix) {
+        return { kind: 'unmanaged', packageRoot, prefix: null, detail: `not a global npm install (${packageRoot})` };
+    }
+    return { kind: 'npm-global', packageRoot, prefix, detail: `npm global install under ${prefix}` };
+}
+/**
+ * `npm` arguments that install `crewly@<version>` over the running copy.
+ *
+ * @param prefix - Prefix from {@link derivePrefixFromPackageRoot}
+ * @param version - Exact target version
+ * @returns Arguments for npm
+ *
+ * @example
+ * ```ts
+ * npmInstallArgs('/usr/local', '1.20.144');
+ * // ['install', '-g', '--prefix', '/usr/local', 'crewly@1.20.144']
+ * ```
+ */
+export function npmInstallArgs(prefix, version) {
+    return ['install', '-g', '--prefix', prefix, `${AUTO_UPDATE_CONSTANTS.PACKAGE_NAME}@${version}`];
+}
+/**
+ * The npm executable that belongs to the running node, when it sits next to
+ * it (nvm, official installers); plain `npm` from PATH otherwise.
+ *
+ * @param execPath - Running node binary (defaults to process.execPath)
+ * @param platform - Platform (tests)
+ * @returns Command to run
+ */
+export function resolveNpmCommand(execPath = process.execPath, platform = process.platform) {
+    const name = platform === 'win32' ? 'npm.cmd' : 'npm';
+    const sibling = path.join(path.dirname(execPath), name);
+    return fs.existsSync(sibling) ? sibling : name;
+}
+/**
+ * Version in `<packageRoot>/package.json`, read fresh from disk.
+ *
+ * @param packageRoot - Package root
+ * @returns The version, or null when unreadable
+ */
+export function readInstalledVersion(packageRoot) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf-8'));
+        return typeof pkg.version === 'string' ? pkg.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Whether `latest` is a strictly newer semver than `current`
+ * (numeric major.minor.patch; pre-release tags are ignored).
+ *
+ * @param latest - Candidate version
+ * @param current - Running version
+ * @returns True when latest > current
+ */
+export function isNewerVersion(latest, current) {
+    const parse = (v) => v.split('-')[0].split('.').map((n) => Number.parseInt(n, 10) || 0);
+    const l = parse(latest);
+    const c = parse(current);
+    for (let i = 0; i < Math.max(l.length, c.length); i++) {
+        const a = l[i] ?? 0;
+        const b = c[i] ?? 0;
+        if (a !== b)
+            return a > b;
+    }
+    return false;
+}
+/**
+ * Resolve the on/off switch: the env override wins over the setting.
+ *
+ * @param settingValue - `settings.general.autoUpdate` (undefined = default on)
+ * @param env - Environment
+ * @returns The switch state
+ *
+ * @example
+ * ```ts
+ * resolveAutoUpdateSwitch(true, { CREWLY_AUTO_UPDATE: '0' }); // 'disabled-env'
+ * resolveAutoUpdateSwitch(false, {}); // 'disabled-setting'
+ * ```
+ */
+export function resolveAutoUpdateSwitch(settingValue, env = process.env) {
+    const raw = env[AUTO_UPDATE_CONSTANTS.ENV_VAR]?.trim().toLowerCase();
+    if (raw && ENV_OFF_VALUES.includes(raw))
+        return 'disabled-env';
+    if (raw && ENV_ON_VALUES.includes(raw))
+        return 'enabled-env';
+    return settingValue === false ? 'disabled-setting' : 'enabled';
+}
+/**
+ * Whether a switch state means "on".
+ *
+ * @param state - Switch state
+ * @returns True when enabled
+ */
+export function isSwitchOn(state) {
+    return state === 'enabled' || state === 'enabled-env';
+}
+/**
+ * Read the command line of a process (POSIX only; `/proc` on Linux, `ps`
+ * elsewhere).
+ *
+ * @param pid - Process id
+ * @returns The command line, or null
+ */
+export function readProcessCommandLine(pid) {
+    if (process.platform === 'win32' || !Number.isInteger(pid) || pid <= 1)
+        return null;
+    try {
+        const procFile = `/proc/${pid}/cmdline`;
+        if (fs.existsSync(procFile)) {
+            return fs.readFileSync(procFile, 'utf-8').split('\0').join(' ').trim();
+        }
+        return execFileSync('ps', ['-o', 'command=', '-p', String(pid)], { encoding: 'utf-8', timeout: 2000 }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Whether a supervisor will respawn the backend after it exits with
+ * RESTART_REQUESTED. That supervisor is `crewly start` (foreground, under the
+ * macOS login-item wrapper, under systemd, or under the desktop app). New
+ * CLIs say so in the env; an older CLI parent is recognised by its command line.
+ *
+ * @param env - Environment
+ * @param parentCommandLine - Reader for the parent's command line (tests)
+ * @returns True when a respawning parent is present
+ */
+export function hasRestartSupervisor(env = process.env, parentCommandLine = () => readProcessCommandLine(process.ppid)) {
+    if (env[AUTO_UPDATE_CONSTANTS.SUPERVISOR_ENV_VAR] === AUTO_UPDATE_CONSTANTS.SUPERVISOR_CLI_START)
+        return true;
+    const cmd = parentCommandLine();
+    return !!cmd && CLI_START_CMDLINE_PATTERN.test(cmd);
+}
+/**
+ * A fresh, empty state.
+ *
+ * @returns Default state
+ */
+export function emptyAutoUpdateState() {
+    return {
+        currentVersion: null,
+        latestVersion: null,
+        lastCheckAt: null,
+        mode: 'unknown',
+        lastResult: null,
+        consecutiveFailures: 0,
+        backoffUntil: null,
+        failureNotifiedVersion: null,
+    };
+}
+/**
+ * Read the status file; missing or malformed → empty state.
+ *
+ * @param file - Path of the status file
+ * @returns The state
+ */
+export function readAutoUpdateState(file) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, 'utf-8'));
+        return { ...emptyAutoUpdateState(), ...parsed };
+    }
+    catch {
+        return emptyAutoUpdateState();
+    }
+}
+/**
+ * Write the status file atomically (temp file + rename).
+ *
+ * @param file - Path of the status file
+ * @param state - State to write
+ */
+export function writeAutoUpdateState(file, state) {
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    const tmp = `${file}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(state, null, 2), 'utf-8');
+    fs.renameSync(tmp, file);
+}
+/**
+ * Write the pending-upgrade marker.
+ *
+ * @param file - Marker path
+ * @param marker - Contents
+ */
+export function writePendingMarker(file, marker) {
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, JSON.stringify(marker, null, 2), 'utf-8');
+}
+/**
+ * Read and delete the pending-upgrade marker. It is removed even when
+ * malformed, so a crash loop can never repeat the notice.
+ *
+ * @param file - Marker path
+ * @returns The marker, or null when absent or malformed
+ */
+export function consumePendingMarker(file) {
+    if (!fs.existsSync(file))
+        return null;
+    let marker = null;
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, 'utf-8'));
+        if (typeof parsed.fromVersion === 'string' && typeof parsed.toVersion === 'string' && typeof parsed.at === 'string') {
+            marker = { fromVersion: parsed.fromVersion, toVersion: parsed.toVersion, at: parsed.at };
+        }
+    }
+    catch {
+        marker = null;
+    }
+    try {
+        fs.unlinkSync(file);
+    }
+    catch {
+        // Already gone
+    }
+    return marker;
+}
+/**
+ * Owner notice after a successful auto-upgrade.
+ *
+ * @param version - New version
+ * @param deviceName - This machine's name
+ * @returns The one-line notice
+ */
+export function composeUpgradedNotice(version, deviceName) {
+    return `Crewly 已自动升级到 ${version}（本机：${deviceName}）`;
+}
+/**
+ * Owner notice after repeated failures.
+ *
+ * @param version - Target version
+ * @param deviceName - This machine's name
+ * @param failures - Failures in a row
+ * @param reason - Last failure reason
+ * @returns The notice text
+ */
+export function composeFailureNotice(version, deviceName, failures, reason) {
+    return `Crewly 自动升级到 ${version} 失败（本机：${deviceName}，已连续 ${failures} 次）：${reason}。会稍后重试；也可以在这台机器上运行 crewly upgrade。`;
+}
+//# sourceMappingURL=auto-update.utils.js.map

package/dist/backend/backend/src/services/system/auto-update.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-update.utils.js","sourceRoot":"","sources":["../../../../../../backend/src/services/system/auto-update.utils.ts"],"names":[],"mappings":"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"}