jumbo-cli 3.7.2 → 3.8.1

package/dist/infrastructure/cli-metadata/update/NpmPackageUpgradeGateway.d.ts

@@ -0,0 +1,42 @@
+import type { ILogger } from "../../../application/logging/ILogger.js";
+import type { ITelemetryClient } from "../../../application/telemetry/ITelemetryClient.js";
+import type { CliUpgradeFeasibility } from "../../../application/cli-metadata/update/CliUpgradeFeasibility.js";
+import type { CliUpgradeResult } from "../../../application/cli-metadata/update/CliUpgradeResult.js";
+import type { ICliPackageUpgradeGateway } from "../../../application/cli-metadata/update/ICliPackageUpgradeGateway.js";
+type TestUpgradeResult = "success" | "failure";
+export declare class NpmPackageUpgradeGateway implements ICliPackageUpgradeGateway {
+    private readonly packageEntryPointPath;
+    private readonly telemetryClient?;
+    private readonly logger?;
+    private readonly npmCliPath;
+    private readonly selfUpgradeTestModeEnabled;
+    private readonly testUpgradeResult;
+    private readonly testUpgradeDelayMs;
+    constructor(packageEntryPointPath?: string, telemetryClient?: Pick<ITelemetryClient, "track"> | undefined, logger?: Pick<ILogger, "warn" | "info"> | undefined, npmCliPath?: string | null, selfUpgradeTestModeEnabled?: boolean, testUpgradeResult?: TestUpgradeResult, testUpgradeDelayMs?: number);
+    evaluate(): Promise<CliUpgradeFeasibility>;
+    upgrade(targetVersion: string): Promise<CliUpgradeResult>;
+    private getGlobalNodeModulesRoot;
+    private findPackageRoots;
+    private findPackageRootFromCandidate;
+    private resolvePackageEntryPointPaths;
+    private resolveNpmShimTargetPath;
+    private isInsideDirectory;
+    private isSourceCheckout;
+    private unavailable;
+    private feasibleResult;
+    private trackFeasibility;
+    private trackUpgrade;
+    private runNpm;
+    private resolveNpmInvocation;
+    private normalizeExecFileResult;
+    private decorateNpmError;
+    private describeError;
+    private describePathState;
+    private tail;
+    private delay;
+    private static parseTestUpgradeResult;
+    private static parseTestUpgradeDelayMs;
+    private static findNpmCliPath;
+}
+export {};
+//# sourceMappingURL=NpmPackageUpgradeGateway.d.ts.map

package/dist/infrastructure/cli-metadata/update/NpmPackageUpgradeGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NpmPackageUpgradeGateway.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/cli-metadata/update/NpmPackageUpgradeGateway.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AAE3F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mEAAmE,CAAC;AAC/G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AAErG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uEAAuE,CAAC;AA8BvH,KAAK,iBAAiB,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/C,qBAAa,wBAAyB,YAAW,yBAAyB;IAEtE,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAE3B,OAAO,CAAC,QAAQ,CAAC,0BAA0B;IAE3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAIlC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAXlB,qBAAqB,GAAE,MAA8B,EACrD,eAAe,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,YAAA,EACjD,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,YAAA,EACvC,UAAU,GAAE,MAAM,GAAG,IACK,EAC1B,0BAA0B,GAAE,OACE,EAC9B,iBAAiB,GAAE,iBAGjC,EACc,kBAAkB,GAAE,MAGlC;IAGC,QAAQ,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAwD1C,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAkEjD,wBAAwB;IAKtC,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,4BAA4B;IAgCpC,OAAO,CAAC,6BAA6B;IA2BrC,OAAO,CAAC,wBAAwB;IAwBhC,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,YAAY;YAkBN,MAAM;IAmBpB,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,uBAAuB;IAkB/B,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,aAAa;IAqDrB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,IAAI;YAIE,KAAK;IAQnB,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAMrC,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAStC,OAAO,CAAC,MAAM,CAAC,cAAc;CAU9B"}

package/dist/infrastructure/cli-metadata/update/NpmPackageUpgradeGateway.js

@@ -0,0 +1,375 @@
+import { execFile } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { promisify } from "node:util";
+import { CliPackageName } from "../../../application/cli-metadata/update/CliPackageName.js";
+import { CliUpdateFailureReason } from "../../../application/cli-metadata/update/CliUpdateFailureReason.js";
+import { CLI_UPDATE_TEST_MODE_ENV, CLI_UPDATE_TEST_UPGRADE_DELAY_MS_ENV, CLI_UPDATE_TEST_UPGRADE_RESULT_ENV, } from "./CliUpdateTestMode.js";
+const execFileAsync = promisify(execFile);
+const NPM_UPGRADE_TIMEOUT_MS = 120000;
+const NPM_FEASIBILITY_LOOKUP_COMPLETED_EVENT = "npm_upgrade_feasibility_lookup_completed";
+const NPM_PACKAGE_UPGRADE_COMPLETED_EVENT = "npm_package_upgrade_completed";
+const MANUAL_UPDATE_GUIDANCE = `Run npm install -g ${CliPackageName}@latest`;
+const NPM_COMMAND = "npm";
+const NPM_CLI_PATH_SEGMENTS = [
+    "node_modules",
+    "npm",
+    "bin",
+    "npm-cli.js",
+];
+const NPM_ROOT_OPERATION = "npm-root-global";
+const NPM_INSTALL_OPERATION = "npm-install-global";
+const NPM_STDIO_TAIL_LENGTH = 500;
+export class NpmPackageUpgradeGateway {
+    constructor(packageEntryPointPath = process.argv[1] ?? "", telemetryClient, logger, npmCliPath = NpmPackageUpgradeGateway.findNpmCliPath(), selfUpgradeTestModeEnabled = process.env[CLI_UPDATE_TEST_MODE_ENV] === "1", testUpgradeResult = NpmPackageUpgradeGateway.parseTestUpgradeResult(process.env[CLI_UPDATE_TEST_UPGRADE_RESULT_ENV]), testUpgradeDelayMs = NpmPackageUpgradeGateway.parseTestUpgradeDelayMs(process.env[CLI_UPDATE_TEST_UPGRADE_DELAY_MS_ENV])) {
+        this.packageEntryPointPath = packageEntryPointPath;
+        this.telemetryClient = telemetryClient;
+        this.logger = logger;
+        this.npmCliPath = npmCliPath;
+        this.selfUpgradeTestModeEnabled = selfUpgradeTestModeEnabled;
+        this.testUpgradeResult = testUpgradeResult;
+        this.testUpgradeDelayMs = testUpgradeDelayMs;
+    }
+    async evaluate() {
+        const startedAt = Date.now();
+        const context = {
+            entryPointState: this.describePathState(this.packageEntryPointPath),
+            npmInvocationMode: this.resolveNpmInvocation([]).mode,
+        };
+        try {
+            if (this.selfUpgradeTestModeEnabled) {
+                const result = this.feasibleResult();
+                this.logger?.info("npm upgrade feasibility test mode enabled", {
+                    env: CLI_UPDATE_TEST_MODE_ENV,
+                });
+                this.trackFeasibility(startedAt, result);
+                return result;
+            }
+            const candidatePaths = this.resolvePackageEntryPointPaths(this.packageEntryPointPath);
+            const packageRoots = this.findPackageRoots(candidatePaths);
+            context.candidatePathCount = candidatePaths.length;
+            context.packageRootCount = packageRoots.length;
+            const globalRoot = await this.getGlobalNodeModulesRoot();
+            context.globalRootResolved = true;
+            const safePackageRoot = packageRoots.find((packageRoot) => this.isInsideDirectory(packageRoot, globalRoot) &&
+                !this.isSourceCheckout(packageRoot));
+            context.safePackageRootFound = safePackageRoot !== undefined;
+            if (safePackageRoot === undefined) {
+                this.logger?.warn("npm upgrade feasibility unavailable", {
+                    ...context,
+                    reason: CliUpdateFailureReason.SelfUpgradeUnavailable,
+                });
+                return this.unavailable(startedAt, "PackageInstallSourceUnsupported");
+            }
+            const result = this.feasibleResult();
+            this.trackFeasibility(startedAt, result);
+            return result;
+        }
+        catch (error) {
+            const diagnostic = this.describeError(error);
+            this.logger?.warn("npm upgrade feasibility lookup failed", {
+                ...context,
+                ...diagnostic,
+            });
+            return this.unavailable(startedAt, diagnostic.errorType);
+        }
+    }
+    async upgrade(targetVersion) {
+        const startedAt = Date.now();
+        try {
+            if (this.selfUpgradeTestModeEnabled) {
+                await this.delay(this.testUpgradeDelayMs);
+                if (this.testUpgradeResult === "failure") {
+                    const result = {
+                        ok: false,
+                        reason: CliUpdateFailureReason.UpgradeFailed,
+                        guidance: MANUAL_UPDATE_GUIDANCE,
+                        errorType: "TestModeUpgradeFailure",
+                        message: "Upgrade test mode simulated failure.",
+                    };
+                    this.trackUpgrade(startedAt, targetVersion, result);
+                    this.logger?.warn("npm package upgrade test mode failed", {
+                        env: CLI_UPDATE_TEST_UPGRADE_RESULT_ENV,
+                        targetVersion,
+                    });
+                    return result;
+                }
+                const result = {
+                    ok: true,
+                    message: "Upgrade test mode completed. Restart Jumbo to continue testing.",
+                };
+                this.trackUpgrade(startedAt, targetVersion, result);
+                this.logger?.info("npm package upgrade test mode completed", {
+                    env: CLI_UPDATE_TEST_MODE_ENV,
+                    targetVersion,
+                });
+                return result;
+            }
+            await this.runNpm(["install", "-g", `${CliPackageName}@${targetVersion}`], NPM_UPGRADE_TIMEOUT_MS, NPM_INSTALL_OPERATION);
+            const result = {
+                ok: true,
+                message: "Upgrade completed. Restart Jumbo to use the new version.",
+            };
+            this.trackUpgrade(startedAt, targetVersion, result);
+            this.logger?.info("npm package upgrade completed", { targetVersion });
+            return result;
+        }
+        catch (error) {
+            const diagnostic = this.describeError(error);
+            const result = {
+                ok: false,
+                reason: CliUpdateFailureReason.UpgradeFailed,
+                guidance: MANUAL_UPDATE_GUIDANCE,
+                errorType: diagnostic.errorType,
+                message: diagnostic.errorMessage,
+            };
+            this.trackUpgrade(startedAt, targetVersion, result);
+            this.logger?.warn("npm package upgrade failed", {
+                targetVersion,
+                ...diagnostic,
+            });
+            return result;
+        }
+    }
+    async getGlobalNodeModulesRoot() {
+        const result = await this.runNpm(["root", "-g"], 5000, NPM_ROOT_OPERATION);
+        return path.resolve(result.stdout.trim());
+    }
+    findPackageRoots(candidatePaths) {
+        const packageRoots = [];
+        for (const candidatePath of candidatePaths) {
+            const packageRoot = this.findPackageRootFromCandidate(candidatePath);
+            if (packageRoot !== null) {
+                packageRoots.push(packageRoot);
+            }
+        }
+        return [...new Set(packageRoots)];
+    }
+    findPackageRootFromCandidate(candidatePath) {
+        if (!fs.existsSync(candidatePath)) {
+            return null;
+        }
+        let current = fs.statSync(candidatePath).isDirectory()
+            ? path.resolve(candidatePath)
+            : path.dirname(path.resolve(candidatePath));
+        while (true) {
+            const packageJsonPath = path.join(current, "package.json");
+            if (fs.existsSync(packageJsonPath)) {
+                try {
+                    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+                    if (packageJson.name === CliPackageName) {
+                        return current;
+                    }
+                }
+                catch {
+                    return null;
+                }
+            }
+            const parent = path.dirname(current);
+            if (parent === current) {
+                return null;
+            }
+            current = parent;
+        }
+    }
+    resolvePackageEntryPointPaths(startPath) {
+        if (startPath.length === 0) {
+            return [];
+        }
+        const absoluteStartPath = path.resolve(startPath);
+        const candidatePaths = [absoluteStartPath];
+        try {
+            const realPath = fs.realpathSync(absoluteStartPath);
+            if (realPath !== absoluteStartPath) {
+                candidatePaths.push(realPath);
+            }
+        }
+        catch {
+            return candidatePaths;
+        }
+        for (const candidatePath of [...candidatePaths]) {
+            const shimTargetPath = this.resolveNpmShimTargetPath(candidatePath);
+            if (shimTargetPath !== null) {
+                candidatePaths.push(shimTargetPath);
+            }
+        }
+        return [...new Set(candidatePaths)];
+    }
+    resolveNpmShimTargetPath(shimPath) {
+        if (!fs.existsSync(shimPath) || fs.statSync(shimPath).isDirectory()) {
+            return null;
+        }
+        const shimContent = fs.readFileSync(shimPath, "utf-8");
+        const packagePathPattern = new RegExp(String.raw `(?<target>[^"'\r\n]*node_modules[\\/]${CliPackageName}[\\/]dist[\\/]cli\.js)`, "i");
+        const match = shimContent.match(packagePathPattern);
+        const target = match?.groups?.target;
+        if (target === undefined) {
+            return null;
+        }
+        const normalizedTarget = target
+            .replace(/%~dp0%?[\\/]?/gi, "")
+            .replace(/\$basedir[\\/]?/gi, "")
+            .replace(/[\\/]/g, path.sep);
+        return path.resolve(path.dirname(shimPath), normalizedTarget);
+    }
+    isInsideDirectory(childPath, parentPath) {
+        const relativePath = path.relative(parentPath, childPath);
+        return (relativePath.length === 0 ||
+            (!relativePath.startsWith("..") && !path.isAbsolute(relativePath)));
+    }
+    isSourceCheckout(packageRoot) {
+        return fs.existsSync(path.join(packageRoot, ".git"));
+    }
+    unavailable(startedAt, errorType) {
+        const result = {
+            feasible: false,
+            reason: CliUpdateFailureReason.SelfUpgradeUnavailable,
+            guidance: MANUAL_UPDATE_GUIDANCE,
+        };
+        this.trackFeasibility(startedAt, result, errorType);
+        return result;
+    }
+    feasibleResult() {
+        return {
+            feasible: true,
+            command: NPM_COMMAND,
+            args: ["install", "-g", `${CliPackageName}@latest`],
+        };
+    }
+    trackFeasibility(startedAt, result, errorType) {
+        this.telemetryClient?.track(NPM_FEASIBILITY_LOOKUP_COMPLETED_EVENT, {
+            feasible: result.feasible,
+            durationMs: Date.now() - startedAt,
+            ...(result.feasible ? {} : { reason: result.reason }),
+            ...(errorType ? { errorType } : {}),
+        });
+    }
+    trackUpgrade(startedAt, targetVersion, result) {
+        this.telemetryClient?.track(NPM_PACKAGE_UPGRADE_COMPLETED_EVENT, {
+            targetVersion,
+            success: result.ok,
+            durationMs: Date.now() - startedAt,
+            ...(result.ok
+                ? {}
+                : {
+                    reason: result.reason,
+                    errorType: result.errorType,
+                }),
+        });
+    }
+    async runNpm(args, timeout, operation) {
+        const invocation = this.resolveNpmInvocation(args);
+        try {
+            const result = (await execFileAsync(invocation.command, [...invocation.args], { timeout }));
+            return this.normalizeExecFileResult(result);
+        }
+        catch (error) {
+            throw this.decorateNpmError(error, operation, invocation);
+        }
+    }
+    resolveNpmInvocation(args) {
+        if (this.npmCliPath !== null) {
+            return {
+                command: process.execPath,
+                args: [this.npmCliPath, ...args],
+                mode: "node-npm-cli",
+            };
+        }
+        return {
+            command: NPM_COMMAND,
+            args,
+            mode: "path-npm",
+        };
+    }
+    normalizeExecFileResult(result) {
+        if (typeof result === "string") {
+            return { stdout: result, stderr: "" };
+        }
+        const output = result;
+        return {
+            stdout: typeof output.stdout === "string" ? output.stdout : "",
+            stderr: typeof output.stderr === "string" ? output.stderr : "",
+        };
+    }
+    decorateNpmError(error, operation, invocation) {
+        const decorated = error instanceof Error ? error : new Error(String(error));
+        const details = decorated;
+        details.operation = operation;
+        details.npmInvocationMode = invocation.mode;
+        details.npmCommandBasename = path.basename(invocation.command);
+        return decorated;
+    }
+    describeError(error) {
+        const shapedError = error;
+        return {
+            errorType: typeof shapedError.name === "string" && shapedError.name.length > 0
+                ? shapedError.name
+                : "UnknownError",
+            errorMessage: typeof shapedError.message === "string"
+                ? shapedError.message
+                : String(error),
+            ...(typeof shapedError.code === "string"
+                ? { errorCode: shapedError.code }
+                : {}),
+            ...(typeof shapedError.exitCode === "number"
+                ? { exitCode: shapedError.exitCode }
+                : {}),
+            ...(typeof shapedError.signal === "string"
+                ? { signal: shapedError.signal }
+                : {}),
+            ...(typeof shapedError.operation === "string"
+                ? { operation: shapedError.operation }
+                : {}),
+            ...(typeof shapedError.npmInvocationMode === "string"
+                ? { npmInvocationMode: shapedError.npmInvocationMode }
+                : {}),
+            ...(typeof shapedError.npmCommandBasename === "string"
+                ? { npmCommand: shapedError.npmCommandBasename }
+                : {}),
+            ...(typeof shapedError.stdout === "string" && shapedError.stdout.length > 0
+                ? { stdoutTail: this.tail(shapedError.stdout) }
+                : {}),
+            ...(typeof shapedError.stderr === "string" && shapedError.stderr.length > 0
+                ? { stderrTail: this.tail(shapedError.stderr) }
+                : {}),
+        };
+    }
+    describePathState(targetPath) {
+        if (targetPath.length === 0) {
+            return "empty";
+        }
+        if (!fs.existsSync(targetPath)) {
+            return "missing";
+        }
+        return fs.statSync(targetPath).isDirectory() ? "directory" : "file";
+    }
+    tail(value) {
+        return value.slice(-NPM_STDIO_TAIL_LENGTH);
+    }
+    async delay(delayMs) {
+        if (delayMs <= 0) {
+            return;
+        }
+        await new Promise((resolve) => setTimeout(resolve, delayMs));
+    }
+    static parseTestUpgradeResult(value) {
+        return value === "failure" ? "failure" : "success";
+    }
+    static parseTestUpgradeDelayMs(value) {
+        if (value === undefined) {
+            return 0;
+        }
+        const parsedValue = Number.parseInt(value, 10);
+        return Number.isFinite(parsedValue) && parsedValue > 0 ? parsedValue : 0;
+    }
+    static findNpmCliPath() {
+        for (const searchPath of (process.env.PATH ?? "").split(path.delimiter)) {
+            const candidatePath = path.join(searchPath, ...NPM_CLI_PATH_SEGMENTS);
+            if (fs.existsSync(candidatePath)) {
+                return candidatePath;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=NpmPackageUpgradeGateway.js.map

package/dist/infrastructure/cli-metadata/update/NpmPackageUpgradeGateway.js.map

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

package/dist/infrastructure/cli-metadata/update/NpmPackageVersionGateway.d.ts

@@ -0,0 +1,17 @@
+import type { ILogger } from "../../../application/logging/ILogger.js";
+import type { ITelemetryClient } from "../../../application/telemetry/ITelemetryClient.js";
+import type { CliPackageVersionLookupResult } from "../../../application/cli-metadata/update/CliPackageVersionLookupResult.js";
+import type { ICliPackageVersionGateway } from "../../../application/cli-metadata/update/ICliPackageVersionGateway.js";
+export declare class NpmPackageVersionGateway implements ICliPackageVersionGateway {
+    private readonly telemetryClient?;
+    private readonly logger?;
+    private readonly fetchImplementation;
+    private readonly testLatestVersion;
+    constructor(telemetryClient?: Pick<ITelemetryClient, "track"> | undefined, logger?: Pick<ILogger, "warn" | "info"> | undefined, fetchImplementation?: typeof fetch, testLatestVersion?: string | null);
+    getLatestVersion(packageName: string): Promise<CliPackageVersionLookupResult>;
+    private fail;
+    private track;
+    private resolveErrorType;
+    private resolveErrorMessage;
+}
+//# sourceMappingURL=NpmPackageVersionGateway.d.ts.map

package/dist/infrastructure/cli-metadata/update/NpmPackageVersionGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NpmPackageVersionGateway.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/cli-metadata/update/NpmPackageVersionGateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AAC3F,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,2EAA2E,CAAC;AAE/H,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uEAAuE,CAAC;AAUvH,qBAAa,wBAAyB,YAAW,yBAAyB;IAEtE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAHjB,eAAe,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,YAAA,EACjD,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,YAAA,EACvC,mBAAmB,GAAE,OAAO,KAAa,EACzC,iBAAiB,GAAE,MAAM,GAAG,IACK;IAG9C,gBAAgB,CACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,6BAA6B,CAAC;IAsEzC,OAAO,CAAC,IAAI;IAsBZ,OAAO,CAAC,KAAK;IAgBb,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,mBAAmB;CAY5B"}

package/dist/infrastructure/cli-metadata/update/NpmPackageVersionGateway.js

@@ -0,0 +1,103 @@
+import { CliUpdateFailureReason } from "../../../application/cli-metadata/update/CliUpdateFailureReason.js";
+import { CLI_UPDATE_TEST_VERSION_ENV, } from "./CliUpdateTestMode.js";
+const NPM_REGISTRY_BASE_URL = "https://registry.npmjs.org";
+const NPM_REGISTRY_TIMEOUT_MS = 3000;
+const NPM_LATEST_VERSION_LOOKUP_COMPLETED_EVENT = "npm_latest_version_lookup_completed";
+export class NpmPackageVersionGateway {
+    constructor(telemetryClient, logger, fetchImplementation = fetch, testLatestVersion = process.env[CLI_UPDATE_TEST_VERSION_ENV] ?? null) {
+        this.telemetryClient = telemetryClient;
+        this.logger = logger;
+        this.fetchImplementation = fetchImplementation;
+        this.testLatestVersion = testLatestVersion;
+    }
+    async getLatestVersion(packageName) {
+        const startedAt = Date.now();
+        if (this.testLatestVersion !== null) {
+            const result = {
+                ok: true,
+                version: this.testLatestVersion,
+            };
+            this.track(packageName, startedAt, true);
+            this.logger?.info("npm latest version override enabled", {
+                packageName,
+                env: CLI_UPDATE_TEST_VERSION_ENV,
+                version: this.testLatestVersion,
+            });
+            return result;
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => {
+            controller.abort();
+        }, NPM_REGISTRY_TIMEOUT_MS);
+        try {
+            const response = await this.fetchImplementation(`${NPM_REGISTRY_BASE_URL}/${encodeURIComponent(packageName)}/latest`, { signal: controller.signal });
+            if (!response.ok) {
+                return this.fail(packageName, startedAt, CliUpdateFailureReason.RegistryError, "RegistryHttpError", `npm registry returned ${response.status}`);
+            }
+            const payload = (await response.json());
+            if (typeof payload.version !== "string") {
+                return this.fail(packageName, startedAt, CliUpdateFailureReason.VersionParseFailure, "RegistryPayloadError", "npm registry latest payload did not contain a string version");
+            }
+            const result = {
+                ok: true,
+                version: payload.version,
+            };
+            this.track(packageName, startedAt, true);
+            return result;
+        }
+        catch (error) {
+            const errorType = this.resolveErrorType(error);
+            const message = this.resolveErrorMessage(error);
+            const reason = errorType === "AbortError"
+                ? CliUpdateFailureReason.Offline
+                : CliUpdateFailureReason.RegistryError;
+            return this.fail(packageName, startedAt, reason, errorType, message);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    fail(packageName, startedAt, reason, errorType, message) {
+        this.track(packageName, startedAt, false, reason, errorType);
+        this.logger?.warn("npm latest version lookup failed", {
+            packageName,
+            reason,
+            errorType,
+        });
+        return {
+            ok: false,
+            reason,
+            errorType,
+            message,
+        };
+    }
+    track(packageName, startedAt, success, reason, errorType) {
+        this.telemetryClient?.track(NPM_LATEST_VERSION_LOOKUP_COMPLETED_EVENT, {
+            packageName,
+            success,
+            durationMs: Date.now() - startedAt,
+            ...(reason ? { reason } : {}),
+            ...(errorType ? { errorType } : {}),
+        });
+    }
+    resolveErrorType(error) {
+        if (typeof error === "object" &&
+            error !== null &&
+            "name" in error &&
+            typeof error.name === "string" &&
+            error.name.length > 0) {
+            return error.name;
+        }
+        return "UnknownError";
+    }
+    resolveErrorMessage(error) {
+        if (typeof error === "object" &&
+            error !== null &&
+            "message" in error &&
+            typeof error.message === "string") {
+            return error.message;
+        }
+        return String(error);
+    }
+}
+//# sourceMappingURL=NpmPackageVersionGateway.js.map

package/dist/infrastructure/cli-metadata/update/NpmPackageVersionGateway.js.map

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

package/dist/infrastructure/host/HostBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HostBuilder.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/host/HostBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AASxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAC;AAijBnF,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAE1B;gBAGZ,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,uBAAuB,CAAC,EAAE,CAAC,eAAe,EAAE,gBAAgB,KAAK,IAAI;IAOvE;;;;;;;OAOG;IACG,KAAK,IAAI,OAAO,CAAC,qBAAqB,CAAC;CAsrD9C"}
+{"version":3,"file":"HostBuilder.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/host/HostBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AASxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAC;AAojBnF,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAE1B;gBAGZ,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,uBAAuB,CAAC,EAAE,CAAC,eAAe,EAAE,gBAAgB,KAAK,IAAI;IAOvE;;;;;;;OAOG;IACG,KAAK,IAAI,OAAO,CAAC,qBAAqB,CAAC;CA6rD9C"}

package/dist/infrastructure/host/HostBuilder.js

@@ -276,6 +276,9 @@ import { SqliteAudiencePainContextReader } from "../context/audience-pains/query
 import { SqliteValuePropositionContextReader } from "../context/value-propositions/query/SqliteValuePropositionContextReader.js";
 // CLI Version Reader
 import { CliVersionReader } from "../cli-metadata/query/CliVersionReader.js";
+import { CliUpdateController } from "../../application/cli-metadata/update/CliUpdateController.js";
+import { NpmPackageUpgradeGateway } from "../cli-metadata/update/NpmPackageUpgradeGateway.js";
+import { NpmPackageVersionGateway } from "../cli-metadata/update/NpmPackageVersionGateway.js";
 // Brownfield Status Reader
 import { SqliteBrownfieldStatusReader } from "../context/sessions/start/SqliteBrownfieldStatusReader.js";
 // Settings Infrastructure
@@ -595,6 +598,7 @@ export class HostBuilder {
             ? new PostHogTelemetryClient(telemetryStatus.anonymousId)
             : new NoOpTelemetryClient();
         this.registerTelemetryClient?.(telemetryClient);
+        const cliUpdateController = new CliUpdateController(new NpmPackageVersionGateway(telemetryClient, logger), new NpmPackageUpgradeGateway(process.argv[1] ?? "", telemetryClient, logger), telemetryClient, logger);
         // Create worker identity components
         const hostSessionKeyResolver = new HostSessionKeyResolver();
         const workerIdentifiedEventStore = new FsWorkerIdentifiedEventStore(this.rootDir, logger);
@@ -1267,6 +1271,7 @@ export class HostBuilder {
             migrateDependenciesCommandHandler,
             // CLI Version
             cliVersionReader,
+            cliUpdateController,
             // Work Category - Session Event Stores - decomposed by use case
             sessionStartedEventStore,
             sessionEndedEventStore,