@rushstack/lockfile-explorer 2.2.17 → 2.2.19

package/lib-commonjs/cli/lint/actions/InitAction.js

@@ -13,14 +13,14 @@ const rush_sdk_1 = require("@rushstack/rush-sdk");
 const node_core_library_1 = require("@rushstack/node-core-library");
 const common_1 = require("../../../constants/common");
 class InitAction extends ts_command_line_1.CommandLineAction {
-    constructor(parser) {
+    constructor(terminal) {
         super({
             actionName: 'init',
             summary: `Create a new ${common_1.LOCKFILE_LINT_JSON_FILENAME} config file`,
             documentation: `This command initializes a new ${common_1.LOCKFILE_LINT_JSON_FILENAME} config file.` +
                 `  The created template file includes source code comments that document the settings.`
         });
-        this._terminal = parser.globalTerminal;
+        this._terminal = terminal;
     }
     async onExecuteAsync() {
         const rushConfiguration = rush_sdk_1.RushConfiguration.tryLoadFromDefaultLocation();

package/lib-commonjs/cli/lint/actions/InitAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"InitAction.js","sourceRoot":"","sources":["../../../../src/cli/lint/actions/InitAction.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;AAE3D,0DAA6B;AAE7B,gEAA+D;AAC/D,kDAA+D;AAC/D,kDAAwD;AACxD,oEAA0D;AAG1D,sDAAsG;AAEtG,MAAa,UAAW,SAAQ,mCAAiB;IAG/C,YAAmB,MAA6B;QAC9C,KAAK,CAAC;YACJ,UAAU,EAAE,MAAM;YAClB,OAAO,EAAE,gBAAgB,oCAA2B,cAAc;YAClE,aAAa,EACX,kCAAkC,oCAA2B,eAAe;gBAC5E,uFAAuF;SAC1F,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC;IACzC,CAAC;IAEkB,KAAK,CAAC,cAAc;QACrC,MAAM,iBAAiB,GAAkC,4BAAiB,CAAC,0BAA0B,EAAE,CAAC;QACxG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,kGAAkG,CACnG,CAAC;QACJ,CAAC;QACD,MAAM,aAAa,GAAW,mBAAI,CAAC,OAAO,CACxC,SAAS,EACT,uDAAuD,CACxD,CAAC;QACF,MAAM,cAAc,GAAW,mBAAI,CAAC,OAAO,CACzC,iBAAiB,CAAC,YAAY,EAC9B,QAAQ,EACR,qCAA4B,EAC5B,oCAA2B,CAC5B,CAAC;QAEF,IAAI,MAAM,8BAAU,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,iCAAiC,CAAC,CAAC;YAC7D,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,mBAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,CAAC;QAC5E,MAAM,8BAAU,CAAC,aAAa,CAAC;YAC7B,UAAU,EAAE,aAAa;YACzB,eAAe,EAAE,cAAc;SAChC,CAAC,CAAC;IACL,CAAC;CACF;AA5CD,gCA4CC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport path from 'node:path';\n\nimport { CommandLineAction } from '@rushstack/ts-command-line';\nimport { Colorize, type ITerminal } from '@rushstack/terminal';\nimport { RushConfiguration } from '@rushstack/rush-sdk';\nimport { FileSystem } from '@rushstack/node-core-library';\n\nimport type { LintCommandLineParser } from '../LintCommandLineParser';\nimport { LOCKFILE_EXPLORER_FOLDERNAME, LOCKFILE_LINT_JSON_FILENAME } from '../../../constants/common';\n\nexport class InitAction extends CommandLineAction {\n  private readonly _terminal: ITerminal;\n\n  public constructor(parser: LintCommandLineParser) {\n    super({\n      actionName: 'init',\n      summary: `Create a new ${LOCKFILE_LINT_JSON_FILENAME} config file`,\n      documentation:\n        `This command initializes a new ${LOCKFILE_LINT_JSON_FILENAME} config file.` +\n        `  The created template file includes source code comments that document the settings.`\n    });\n    this._terminal = parser.globalTerminal;\n  }\n\n  protected override async onExecuteAsync(): Promise<void> {\n    const rushConfiguration: RushConfiguration | undefined = RushConfiguration.tryLoadFromDefaultLocation();\n    if (!rushConfiguration) {\n      throw new Error(\n        'The \"lockfile-explorer check\" must be executed in a folder that is under a Rush workspace folder'\n      );\n    }\n    const inputFilePath: string = path.resolve(\n      __dirname,\n      '../../../assets/lint-init/lockfile-lint-template.json'\n    );\n    const outputFilePath: string = path.resolve(\n      rushConfiguration.commonFolder,\n      'config',\n      LOCKFILE_EXPLORER_FOLDERNAME,\n      LOCKFILE_LINT_JSON_FILENAME\n    );\n\n    if (await FileSystem.existsAsync(outputFilePath)) {\n      this._terminal.writeError('The output file already exists:');\n      this._terminal.writeLine('\\n  ' + outputFilePath + '\\n');\n      throw new Error('Unable to write output file');\n    }\n\n    this._terminal.writeLine(Colorize.green('Writing file: ') + outputFilePath);\n    await FileSystem.copyFileAsync({\n      sourcePath: inputFilePath,\n      destinationPath: outputFilePath\n    });\n  }\n}\n"]}
+{"version":3,"file":"InitAction.js","sourceRoot":"","sources":["../../../../src/cli/lint/actions/InitAction.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;AAE3D,0DAA6B;AAE7B,gEAA+D;AAC/D,kDAA+D;AAC/D,kDAAwD;AACxD,oEAA0D;AAE1D,sDAAsG;AAEtG,MAAa,UAAW,SAAQ,mCAAiB;IAG/C,YAAmB,QAAmB;QACpC,KAAK,CAAC;YACJ,UAAU,EAAE,MAAM;YAClB,OAAO,EAAE,gBAAgB,oCAA2B,cAAc;YAClE,aAAa,EACX,kCAAkC,oCAA2B,eAAe;gBAC5E,uFAAuF;SAC1F,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAEkB,KAAK,CAAC,cAAc;QACrC,MAAM,iBAAiB,GAAkC,4BAAiB,CAAC,0BAA0B,EAAE,CAAC;QACxG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,kGAAkG,CACnG,CAAC;QACJ,CAAC;QACD,MAAM,aAAa,GAAW,mBAAI,CAAC,OAAO,CACxC,SAAS,EACT,uDAAuD,CACxD,CAAC;QACF,MAAM,cAAc,GAAW,mBAAI,CAAC,OAAO,CACzC,iBAAiB,CAAC,YAAY,EAC9B,QAAQ,EACR,qCAA4B,EAC5B,oCAA2B,CAC5B,CAAC;QAEF,IAAI,MAAM,8BAAU,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,iCAAiC,CAAC,CAAC;YAC7D,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,mBAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,CAAC;QAC5E,MAAM,8BAAU,CAAC,aAAa,CAAC;YAC7B,UAAU,EAAE,aAAa;YACzB,eAAe,EAAE,cAAc;SAChC,CAAC,CAAC;IACL,CAAC;CACF;AA5CD,gCA4CC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport path from 'node:path';\n\nimport { CommandLineAction } from '@rushstack/ts-command-line';\nimport { Colorize, type ITerminal } from '@rushstack/terminal';\nimport { RushConfiguration } from '@rushstack/rush-sdk';\nimport { FileSystem } from '@rushstack/node-core-library';\n\nimport { LOCKFILE_EXPLORER_FOLDERNAME, LOCKFILE_LINT_JSON_FILENAME } from '../../../constants/common';\n\nexport class InitAction extends CommandLineAction {\n  private readonly _terminal: ITerminal;\n\n  public constructor(terminal: ITerminal) {\n    super({\n      actionName: 'init',\n      summary: `Create a new ${LOCKFILE_LINT_JSON_FILENAME} config file`,\n      documentation:\n        `This command initializes a new ${LOCKFILE_LINT_JSON_FILENAME} config file.` +\n        `  The created template file includes source code comments that document the settings.`\n    });\n    this._terminal = terminal;\n  }\n\n  protected override async onExecuteAsync(): Promise<void> {\n    const rushConfiguration: RushConfiguration | undefined = RushConfiguration.tryLoadFromDefaultLocation();\n    if (!rushConfiguration) {\n      throw new Error(\n        'The \"lockfile-explorer check\" must be executed in a folder that is under a Rush workspace folder'\n      );\n    }\n    const inputFilePath: string = path.resolve(\n      __dirname,\n      '../../../assets/lint-init/lockfile-lint-template.json'\n    );\n    const outputFilePath: string = path.resolve(\n      rushConfiguration.commonFolder,\n      'config',\n      LOCKFILE_EXPLORER_FOLDERNAME,\n      LOCKFILE_LINT_JSON_FILENAME\n    );\n\n    if (await FileSystem.existsAsync(outputFilePath)) {\n      this._terminal.writeError('The output file already exists:');\n      this._terminal.writeLine('\\n  ' + outputFilePath + '\\n');\n      throw new Error('Unable to write output file');\n    }\n\n    this._terminal.writeLine(Colorize.green('Writing file: ') + outputFilePath);\n    await FileSystem.copyFileAsync({\n      sourcePath: inputFilePath,\n      destinationPath: outputFilePath\n    });\n  }\n}\n"]}

package/lib-commonjs/start-explorer.js

@@ -2,7 +2,9 @@
 // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
 // See LICENSE in the project root for license information.
 Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("@rushstack/terminal/lib/index");
 const ExplorerCommandLineParser_1 = require("./cli/explorer/ExplorerCommandLineParser");
-const parser = new ExplorerCommandLineParser_1.ExplorerCommandLineParser();
+const terminal = new index_1.Terminal(new index_1.ConsoleTerminalProvider());
+const parser = new ExplorerCommandLineParser_1.ExplorerCommandLineParser(terminal);
 parser.executeAsync().catch(console.error); // CommandLineParser.executeAsync() should never reject the promise
 //# sourceMappingURL=start-explorer.js.map

package/lib-commonjs/start-explorer.js.map

@@ -1 +1 @@
-{"version":3,"file":"start-explorer.js","sourceRoot":"","sources":["../src/start-explorer.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;AAE3D,wFAAqF;AAErF,MAAM,MAAM,GAA8B,IAAI,qDAAyB,EAAE,CAAC;AAE1E,MAAM,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,mEAAmE","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { ExplorerCommandLineParser } from './cli/explorer/ExplorerCommandLineParser';\n\nconst parser: ExplorerCommandLineParser = new ExplorerCommandLineParser();\n\nparser.executeAsync().catch(console.error); // CommandLineParser.executeAsync() should never reject the promise\n"]}
+{"version":3,"file":"start-explorer.js","sourceRoot":"","sources":["../src/start-explorer.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;AAE3D,yDAAkF;AAElF,wFAAqF;AAErF,MAAM,QAAQ,GAAa,IAAI,gBAAQ,CAAC,IAAI,+BAAuB,EAAE,CAAC,CAAC;AACvE,MAAM,MAAM,GAA8B,IAAI,qDAAyB,CAAC,QAAQ,CAAC,CAAC;AAElF,MAAM,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,mEAAmE","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { ConsoleTerminalProvider, Terminal } from '@rushstack/terminal/lib/index';\n\nimport { ExplorerCommandLineParser } from './cli/explorer/ExplorerCommandLineParser';\n\nconst terminal: Terminal = new Terminal(new ConsoleTerminalProvider());\nconst parser: ExplorerCommandLineParser = new ExplorerCommandLineParser(terminal);\n\nparser.executeAsync().catch(console.error); // CommandLineParser.executeAsync() should never reject the promise\n"]}

package/lib-commonjs/start-lint.js

@@ -2,7 +2,9 @@
 // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
 // See LICENSE in the project root for license information.
 Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("@rushstack/terminal/lib/index");
 const LintCommandLineParser_1 = require("./cli/lint/LintCommandLineParser");
-const parser = new LintCommandLineParser_1.LintCommandLineParser();
+const terminal = new index_1.Terminal(new index_1.ConsoleTerminalProvider());
+const parser = new LintCommandLineParser_1.LintCommandLineParser(terminal);
 parser.executeAsync().catch(console.error); // CommandLineParser.executeAsync() should never reject the promise
 //# sourceMappingURL=start-lint.js.map

package/lib-commonjs/start-lint.js.map

@@ -1 +1 @@
-{"version":3,"file":"start-lint.js","sourceRoot":"","sources":["../src/start-lint.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;AAE3D,4EAAyE;AAEzE,MAAM,MAAM,GAA0B,IAAI,6CAAqB,EAAE,CAAC;AAElE,MAAM,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,mEAAmE","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { LintCommandLineParser } from './cli/lint/LintCommandLineParser';\n\nconst parser: LintCommandLineParser = new LintCommandLineParser();\n\nparser.executeAsync().catch(console.error); // CommandLineParser.executeAsync() should never reject the promise\n"]}
+{"version":3,"file":"start-lint.js","sourceRoot":"","sources":["../src/start-lint.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;AAE3D,yDAAkF;AAElF,4EAAyE;AAEzE,MAAM,QAAQ,GAAa,IAAI,gBAAQ,CAAC,IAAI,+BAAuB,EAAE,CAAC,CAAC;AACvE,MAAM,MAAM,GAA0B,IAAI,6CAAqB,CAAC,QAAQ,CAAC,CAAC;AAE1E,MAAM,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,mEAAmE","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { ConsoleTerminalProvider, Terminal } from '@rushstack/terminal/lib/index';\n\nimport { LintCommandLineParser } from './cli/lint/LintCommandLineParser';\n\nconst terminal: Terminal = new Terminal(new ConsoleTerminalProvider());\nconst parser: LintCommandLineParser = new LintCommandLineParser(terminal);\n\nparser.executeAsync().catch(console.error); // CommandLineParser.executeAsync() should never reject the promise\n"]}

package/lib-commonjs/utils/PackageUpdateChecker.js

@@ -0,0 +1,120 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageUpdateChecker = void 0;
+const node_os_1 = require("node:os");
+const semver_1 = __importDefault(require("semver"));
+const node_core_library_1 = require("@rushstack/node-core-library");
+const REGISTRY_BASE_URL = 'https://registry.npmjs.org';
+const FETCH_TIMEOUT_MS = 5000;
+const DEFAULT_CACHE_EXPIRY_MS = 24 * 60 * 60 * 1000; // 24 hours
+const CACHE_VERSION = 1;
+const CACHE_FOLDER = `${(0, node_os_1.homedir)()}/.rushstack/update-checks`;
+async function _tryFetchLatestVersionAsync(packageName) {
+    const url = `${REGISTRY_BASE_URL}/${encodeURIComponent(packageName)}/latest`;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        if (!response.ok) {
+            return undefined;
+        }
+        const { version } = (await response.json());
+        return typeof version === 'string' ? version : undefined;
+    }
+    catch (_a) {
+        // Network errors, timeouts, and parse failures are all silent.
+        return undefined;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+async function _readCacheAsync(filePath) {
+    try {
+        const data = await node_core_library_1.JsonFile.loadAsync(filePath);
+        const { cacheVersion, ...rest } = data;
+        if (cacheVersion === CACHE_VERSION) {
+            return rest;
+        }
+    }
+    catch (_a) {
+        // Ignore
+    }
+}
+async function _writeCacheAsync(filePath, cache) {
+    try {
+        const cacheData = {
+            cacheVersion: CACHE_VERSION,
+            checkedAt: Date.now(),
+            ...cache
+        };
+        await node_core_library_1.JsonFile.saveAsync(cacheData, filePath, {
+            ensureFolderExists: true
+        });
+    }
+    catch (_a) {
+        // Cache write failures are silent — a stale or missing cache just means
+        // we'll re-fetch on the next invocation.
+    }
+}
+/**
+ * Checks npm for a newer version of a package and caches the result locally so that
+ * the registry is not queried on every invocation.
+ *
+ * @internal
+ */
+class PackageUpdateChecker {
+    constructor(options) {
+        const { packageName, currentVersion, skip = false, forceCheck = false, cacheExpiryMs = DEFAULT_CACHE_EXPIRY_MS } = options;
+        this._packageName = packageName;
+        this._currentVersion = currentVersion;
+        this._skip = skip;
+        this._forceCheck = forceCheck;
+        this._cacheExpiryMs = cacheExpiryMs;
+    }
+    /**
+     * Performs the update check and returns the result, or `undefined` if the check
+     * was skipped or the registry could not be reached.
+     */
+    async tryGetUpdateAsync() {
+        if (this._skip) {
+            return undefined;
+        }
+        const cacheFilePath = this._getCacheFilePath();
+        let latestVersion;
+        if (!this._forceCheck) {
+            const cached = await _readCacheAsync(cacheFilePath);
+            if (cached !== undefined) {
+                const { checkedAt, latestVersion: latestVersionFromCache } = cached;
+                const ageMs = Date.now() - checkedAt;
+                if (ageMs < this._cacheExpiryMs) {
+                    latestVersion = latestVersionFromCache;
+                }
+            }
+        }
+        if (latestVersion === undefined) {
+            // Cache is missing or stale — fetch from the registry.
+            latestVersion = await _tryFetchLatestVersionAsync(this._packageName);
+            if (latestVersion === undefined) {
+                return undefined;
+            }
+            await _writeCacheAsync(cacheFilePath, { latestVersion });
+        }
+        return {
+            latestVersion,
+            isOutdated: semver_1.default.gt(latestVersion, this._currentVersion)
+        };
+    }
+    _getCacheFilePath() {
+        // Replace characters that are unsafe in file names (e.g. the "/" in scoped package names).
+        const sanitizedName = this._packageName.replace(/[^a-zA-Z0-9._-]/g, '_');
+        return `${CACHE_FOLDER}/${sanitizedName}.json`;
+    }
+}
+exports.PackageUpdateChecker = PackageUpdateChecker;
+//# sourceMappingURL=PackageUpdateChecker.js.map

package/lib-commonjs/utils/PackageUpdateChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageUpdateChecker.js","sourceRoot":"","sources":["../../src/utils/PackageUpdateChecker.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { homedir } from 'node:os';\n\nimport semver from 'semver';\n\nimport { type IPackageJson, JsonFile } from '@rushstack/node-core-library';\n\n/**\n * TODO: If we end up expecting to use this elsewhere, we should move this to\n * either its own package or into `@rushstack/node-core-library`.\n */\n\n/**\n * Options for {@link _PackageUpdateChecker}.\n *\n * @internal\n */\nexport interface IPackageUpdateCheckerOptions {\n  /**\n   * The npm package name to check for updates.\n   */\n  packageName: string;\n\n  /**\n   * The currently installed version.\n   */\n  currentVersion: string;\n\n  /**\n   * If `true`, skip the update check entirely.\n   * Use this to suppress checks in CI environments or non-interactive sessions.\n   *\n   * @defaultValue false\n   */\n  skip?: boolean;\n\n  /**\n   * If `true`, bypass the cache and always fetch from the registry.\n   * Useful in debug/verbose modes where you want an immediate, authoritative answer.\n   *\n   * @defaultValue false\n   */\n  forceCheck?: boolean;\n\n  /**\n   * How long (in milliseconds) to consider a cached registry response fresh\n   * before re-fetching.\n   *\n   * @defaultValue 86400000 (24 hours)\n   */\n  cacheExpiryMs?: number;\n}\n\n/**\n * The result of an update check.\n *\n * @internal\n */\nexport interface IPackageUpdateResult {\n  /**\n   * The latest version available on the registry.\n   */\n  latestVersion: string;\n\n  /**\n   * `true` if {@link _IPackageUpdateResult.latestVersion} is strictly newer than\n   * the {@link _IPackageUpdateCheckerOptions.currentVersion} that was passed to the checker.\n   */\n  isOutdated: boolean;\n}\n\ninterface IUpdateCheckCache {\n  checkedAt: number;\n  latestVersion: string;\n}\n\ninterface IUpdateCheckCacheOnDisk extends IUpdateCheckCache {\n  cacheVersion: typeof CACHE_VERSION;\n}\n\nconst REGISTRY_BASE_URL: 'https://registry.npmjs.org' = 'https://registry.npmjs.org';\nconst FETCH_TIMEOUT_MS: 5000 = 5000;\nconst DEFAULT_CACHE_EXPIRY_MS: number = 24 * 60 * 60 * 1000; // 24 hours\nconst CACHE_VERSION: 1 = 1;\nconst CACHE_FOLDER: string = `${homedir()}/.rushstack/update-checks`;\n\nasync function _tryFetchLatestVersionAsync(packageName: string): Promise<string | undefined> {\n  const url: string = `${REGISTRY_BASE_URL}/${encodeURIComponent(packageName)}/latest`;\n  const controller: AbortController = new AbortController();\n  const timeout: NodeJS.Timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n  try {\n    const response: Response = await fetch(url, { signal: controller.signal });\n    if (!response.ok) {\n      return undefined;\n    }\n\n    const { version } = (await response.json()) as IPackageJson;\n    return typeof version === 'string' ? version : undefined;\n  } catch {\n    // Network errors, timeouts, and parse failures are all silent.\n    return undefined;\n  } finally {\n    clearTimeout(timeout);\n  }\n}\n\nasync function _readCacheAsync(filePath: string): Promise<IUpdateCheckCache | undefined> {\n  try {\n    const data: IUpdateCheckCacheOnDisk = await JsonFile.loadAsync(filePath);\n    const { cacheVersion, ...rest } = data;\n    if (cacheVersion === CACHE_VERSION) {\n      return rest;\n    }\n  } catch {\n    // Ignore\n  }\n}\n\nasync function _writeCacheAsync(\n  filePath: string,\n  cache: Omit<IUpdateCheckCache, 'checkedAt'>\n): Promise<void> {\n  try {\n    const cacheData: IUpdateCheckCacheOnDisk = {\n      cacheVersion: CACHE_VERSION,\n      checkedAt: Date.now(),\n      ...cache\n    };\n    await JsonFile.saveAsync(cacheData, filePath, {\n      ensureFolderExists: true\n    });\n  } catch {\n    // Cache write failures are silent — a stale or missing cache just means\n    // we'll re-fetch on the next invocation.\n  }\n}\n\n/**\n * Checks npm for a newer version of a package and caches the result locally so that\n * the registry is not queried on every invocation.\n *\n * @internal\n */\nexport class PackageUpdateChecker {\n  private readonly _packageName: string;\n  private readonly _currentVersion: string;\n  private readonly _skip: boolean;\n  private readonly _forceCheck: boolean;\n  private readonly _cacheExpiryMs: number;\n\n  public constructor(options: IPackageUpdateCheckerOptions) {\n    const {\n      packageName,\n      currentVersion,\n      skip = false,\n      forceCheck = false,\n      cacheExpiryMs = DEFAULT_CACHE_EXPIRY_MS\n    } = options;\n    this._packageName = packageName;\n    this._currentVersion = currentVersion;\n    this._skip = skip;\n    this._forceCheck = forceCheck;\n    this._cacheExpiryMs = cacheExpiryMs;\n  }\n\n  /**\n   * Performs the update check and returns the result, or `undefined` if the check\n   * was skipped or the registry could not be reached.\n   */\n  public async tryGetUpdateAsync(): Promise<IPackageUpdateResult | undefined> {\n    if (this._skip) {\n      return undefined;\n    }\n\n    const cacheFilePath: string = this._getCacheFilePath();\n\n    let latestVersion: string | undefined;\n    if (!this._forceCheck) {\n      const cached: IUpdateCheckCache | undefined = await _readCacheAsync(cacheFilePath);\n      if (cached !== undefined) {\n        const { checkedAt, latestVersion: latestVersionFromCache } = cached;\n        const ageMs: number = Date.now() - checkedAt;\n        if (ageMs < this._cacheExpiryMs) {\n          latestVersion = latestVersionFromCache;\n        }\n      }\n    }\n\n    if (latestVersion === undefined) {\n      // Cache is missing or stale — fetch from the registry.\n      latestVersion = await _tryFetchLatestVersionAsync(this._packageName);\n      if (latestVersion === undefined) {\n        return undefined;\n      }\n\n      await _writeCacheAsync(cacheFilePath, { latestVersion });\n    }\n\n    return {\n      latestVersion,\n      isOutdated: semver.gt(latestVersion, this._currentVersion)\n    };\n  }\n\n  private _getCacheFilePath(): string {\n    // Replace characters that are unsafe in file names (e.g. the \"/\" in scoped package names).\n    const sanitizedName: string = this._packageName.replace(/[^a-zA-Z0-9._-]/g, '_');\n    return `${CACHE_FOLDER}/${sanitizedName}.json`;\n  }\n}\n"]}

package/lib-commonjs/utils/constants.js

@@ -0,0 +1,15 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LFX_PACKAGE_ROOT = exports.LFX_PACKAGE_NAME = exports.LFX_VERSION = void 0;
+const node_core_library_1 = require("@rushstack/node-core-library");
+const package_json_1 = __importDefault(require("../../package.json"));
+exports.LFX_VERSION = package_json_1.default.version, exports.LFX_PACKAGE_NAME = package_json_1.default.name;
+let _lfxPackageRoot = node_core_library_1.Path.convertToSlashes(__dirname);
+_lfxPackageRoot = _lfxPackageRoot.slice(0, _lfxPackageRoot.lastIndexOf('/', _lfxPackageRoot.lastIndexOf('/') - 1));
+exports.LFX_PACKAGE_ROOT = node_core_library_1.Path.convertToPlatformDefault(_lfxPackageRoot);
+//# sourceMappingURL=constants.js.map

package/lib-commonjs/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;AAE3D,oEAAoD;AAEpD,sEAA6D;AAErC,mBAAW,GAA6B,sBAA2B,UAAhD,wBAAgB,GAAK,sBAA2B,MAAC;AAE5F,IAAI,eAAe,GAAW,wBAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;AAC/D,eAAe,GAAG,eAAe,CAAC,KAAK,CACrC,CAAC,EACD,eAAe,CAAC,WAAW,CAAC,GAAG,EAAE,eAAe,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CACvE,CAAC;AACW,QAAA,gBAAgB,GAAW,wBAAI,CAAC,wBAAwB,CAAC,eAAe,CAAC,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { Path } from '@rushstack/node-core-library';\n\nimport lockfileExplorerPackageJson from '../../package.json';\n\nexport const { version: LFX_VERSION, name: LFX_PACKAGE_NAME } = lockfileExplorerPackageJson;\n\nlet _lfxPackageRoot: string = Path.convertToSlashes(__dirname);\n_lfxPackageRoot = _lfxPackageRoot.slice(\n  0,\n  _lfxPackageRoot.lastIndexOf('/', _lfxPackageRoot.lastIndexOf('/') - 1)\n);\nexport const LFX_PACKAGE_ROOT: string = Path.convertToPlatformDefault(_lfxPackageRoot);\n"]}

package/lib-commonjs/utils/init.js

@@ -45,8 +45,9 @@ const node_path_1 = __importDefault(require("node:path"));
 const node_core_library_1 = require("@rushstack/node-core-library");
 const RushConfiguration_1 = require("@microsoft/rush-lib/lib/api/RushConfiguration");
 const lockfilePath = __importStar(require("../graph/lockfilePath"));
+const constants_1 = require("./constants");
 const init = (options) => {
-    const { lockfileExplorerProjectRoot, appVersion, debugMode, subspaceName } = options;
+    const { appVersion, debugMode, subspaceName } = options;
     const currentWorkingDirectory = node_path_1.default.resolve(process.cwd());
     let appState;
     let currentFolder = node_core_library_1.Path.convertToSlashes(currentWorkingDirectory);
@@ -69,7 +70,7 @@ const init = (options) => {
                 currentWorkingDirectory,
                 appVersion,
                 debugMode,
-                lockfileExplorerProjectRoot,
+                lockfileExplorerProjectRoot: constants_1.LFX_PACKAGE_ROOT,
                 pnpmLockfileLocation: pnpmLockfileAbsolutePath,
                 pnpmfileLocation: commonTempFolder + '/.pnpmfile.cjs',
                 projectRoot: currentFolder,
@@ -92,7 +93,7 @@ const init = (options) => {
                 currentWorkingDirectory,
                 appVersion,
                 debugMode,
-                lockfileExplorerProjectRoot,
+                lockfileExplorerProjectRoot: constants_1.LFX_PACKAGE_ROOT,
                 pnpmLockfileLocation: currentFolder + '/pnpm-lock.yaml',
                 pnpmfileLocation: currentFolder + '/.pnpmfile.cjs',
                 projectRoot: currentFolder,

package/lib-commonjs/utils/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/utils/init.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n// This function will read the current directory and try to figure out if it's a rush project or regular pnpm workspace\n// Currently it will throw error if neither can be determined\n\nimport path from 'node:path';\n\nimport { FileSystem, Path } from '@rushstack/node-core-library';\nimport { RushConfiguration } from '@microsoft/rush-lib/lib/api/RushConfiguration';\nimport type { Subspace } from '@microsoft/rush-lib/lib/api/Subspace';\n\nimport * as lockfilePath from '../graph/lockfilePath';\nimport type { IAppState } from '../state';\n\nexport const init = (options: {\n  lockfileExplorerProjectRoot: string;\n  appVersion: string;\n  debugMode: boolean;\n  subspaceName: string;\n}): Omit<IAppState, 'graph'> => {\n  const { lockfileExplorerProjectRoot, appVersion, debugMode, subspaceName } = options;\n  const currentWorkingDirectory: string = path.resolve(process.cwd());\n\n  let appState: IAppState | undefined;\n  let currentFolder: string = Path.convertToSlashes(currentWorkingDirectory);\n  while (currentFolder.includes('/')) {\n    // Look for a rush.json [rush project] or pnpm-lock.yaml file [regular pnpm workspace]\n    const rushJsonPath: string = currentFolder + '/rush.json';\n    const pnpmLockPath: string = currentFolder + '/pnpm-lock.yaml';\n    if (FileSystem.exists(rushJsonPath)) {\n      console.log('Found a Rush workspace: ', rushJsonPath);\n\n      const rushConfiguration: RushConfiguration = RushConfiguration.loadFromConfigurationFile(rushJsonPath);\n      const subspace: Subspace = rushConfiguration.getSubspace(subspaceName);\n      const commonTempFolder: string = subspace.getSubspaceTempFolderPath();\n      const pnpmLockfileAbsolutePath: string = path.join(commonTempFolder, 'pnpm-lock.yaml');\n\n      const relativeCommonTempFolder: string = Path.convertToSlashes(\n        path.relative(currentFolder, subspace.getSubspaceTempFolderPath())\n      );\n      const pnpmLockfileRelativePath: string = lockfilePath.join(relativeCommonTempFolder, 'pnpm-lock.yaml');\n      const pnpmFileRelativePath: string = lockfilePath.join(relativeCommonTempFolder, '.pnpmfile.cjs');\n\n      const relativeCommonConfigFolder: string = Path.convertToSlashes(\n        path.relative(currentFolder, subspace.getSubspaceConfigFolderPath())\n      );\n      const rushPnpmFileRelativePath: string = lockfilePath.join(relativeCommonConfigFolder, '.pnpmfile.cjs');\n\n      appState = {\n        currentWorkingDirectory,\n        appVersion,\n        debugMode,\n        lockfileExplorerProjectRoot,\n        pnpmLockfileLocation: pnpmLockfileAbsolutePath,\n        pnpmfileLocation: commonTempFolder + '/.pnpmfile.cjs',\n        projectRoot: currentFolder,\n        lfxWorkspace: {\n          workspaceRootFullPath: currentFolder,\n          pnpmLockfilePath: Path.convertToSlashes(pnpmLockfileRelativePath),\n          pnpmLockfileFolder: Path.convertToSlashes(path.dirname(pnpmLockfileRelativePath)),\n          pnpmfilePath: Path.convertToSlashes(pnpmFileRelativePath),\n          rushConfig: {\n            rushVersion: rushConfiguration.rushConfigurationJson.rushVersion,\n            subspaceName: subspaceName ?? '',\n            rushPnpmfilePath: rushPnpmFileRelativePath\n          }\n        }\n      };\n      break;\n    } else if (FileSystem.exists(pnpmLockPath)) {\n      appState = {\n        currentWorkingDirectory,\n        appVersion,\n        debugMode,\n        lockfileExplorerProjectRoot,\n        pnpmLockfileLocation: currentFolder + '/pnpm-lock.yaml',\n        pnpmfileLocation: currentFolder + '/.pnpmfile.cjs',\n        projectRoot: currentFolder,\n        lfxWorkspace: {\n          workspaceRootFullPath: currentFolder,\n          pnpmLockfilePath: Path.convertToSlashes(path.relative(currentFolder, pnpmLockPath)),\n          pnpmLockfileFolder: '',\n          pnpmfilePath: '.pnpmfile.cjs',\n          rushConfig: undefined\n        }\n      };\n\n      break;\n    }\n\n    currentFolder = currentFolder.substring(0, currentFolder.lastIndexOf('/'));\n  }\n\n  if (!appState) {\n    throw new Error('Could not find a Rush or PNPM workspace!');\n  }\n\n  return appState;\n};\n"]}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/utils/init.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n// This function will read the current directory and try to figure out if it's a rush project or regular pnpm workspace\n// Currently it will throw error if neither can be determined\n\nimport path from 'node:path';\n\nimport { FileSystem, Path } from '@rushstack/node-core-library';\nimport { RushConfiguration } from '@microsoft/rush-lib/lib/api/RushConfiguration';\nimport type { Subspace } from '@microsoft/rush-lib/lib/api/Subspace';\n\nimport * as lockfilePath from '../graph/lockfilePath';\nimport type { IAppState } from '../state';\nimport { LFX_PACKAGE_ROOT } from './constants';\n\nexport interface IInitOptions {\n  appVersion: string;\n  debugMode: boolean;\n  subspaceName: string;\n}\n\nexport const init = (options: IInitOptions): Omit<IAppState, 'graph'> => {\n  const { appVersion, debugMode, subspaceName } = options;\n  const currentWorkingDirectory: string = path.resolve(process.cwd());\n\n  let appState: IAppState | undefined;\n  let currentFolder: string = Path.convertToSlashes(currentWorkingDirectory);\n  while (currentFolder.includes('/')) {\n    // Look for a rush.json [rush project] or pnpm-lock.yaml file [regular pnpm workspace]\n    const rushJsonPath: string = currentFolder + '/rush.json';\n    const pnpmLockPath: string = currentFolder + '/pnpm-lock.yaml';\n    if (FileSystem.exists(rushJsonPath)) {\n      console.log('Found a Rush workspace: ', rushJsonPath);\n\n      const rushConfiguration: RushConfiguration = RushConfiguration.loadFromConfigurationFile(rushJsonPath);\n      const subspace: Subspace = rushConfiguration.getSubspace(subspaceName);\n      const commonTempFolder: string = subspace.getSubspaceTempFolderPath();\n      const pnpmLockfileAbsolutePath: string = path.join(commonTempFolder, 'pnpm-lock.yaml');\n\n      const relativeCommonTempFolder: string = Path.convertToSlashes(\n        path.relative(currentFolder, subspace.getSubspaceTempFolderPath())\n      );\n      const pnpmLockfileRelativePath: string = lockfilePath.join(relativeCommonTempFolder, 'pnpm-lock.yaml');\n      const pnpmFileRelativePath: string = lockfilePath.join(relativeCommonTempFolder, '.pnpmfile.cjs');\n\n      const relativeCommonConfigFolder: string = Path.convertToSlashes(\n        path.relative(currentFolder, subspace.getSubspaceConfigFolderPath())\n      );\n      const rushPnpmFileRelativePath: string = lockfilePath.join(relativeCommonConfigFolder, '.pnpmfile.cjs');\n\n      appState = {\n        currentWorkingDirectory,\n        appVersion,\n        debugMode,\n        lockfileExplorerProjectRoot: LFX_PACKAGE_ROOT,\n        pnpmLockfileLocation: pnpmLockfileAbsolutePath,\n        pnpmfileLocation: commonTempFolder + '/.pnpmfile.cjs',\n        projectRoot: currentFolder,\n        lfxWorkspace: {\n          workspaceRootFullPath: currentFolder,\n          pnpmLockfilePath: Path.convertToSlashes(pnpmLockfileRelativePath),\n          pnpmLockfileFolder: Path.convertToSlashes(path.dirname(pnpmLockfileRelativePath)),\n          pnpmfilePath: Path.convertToSlashes(pnpmFileRelativePath),\n          rushConfig: {\n            rushVersion: rushConfiguration.rushConfigurationJson.rushVersion,\n            subspaceName: subspaceName ?? '',\n            rushPnpmfilePath: rushPnpmFileRelativePath\n          }\n        }\n      };\n      break;\n    } else if (FileSystem.exists(pnpmLockPath)) {\n      appState = {\n        currentWorkingDirectory,\n        appVersion,\n        debugMode,\n        lockfileExplorerProjectRoot: LFX_PACKAGE_ROOT,\n        pnpmLockfileLocation: currentFolder + '/pnpm-lock.yaml',\n        pnpmfileLocation: currentFolder + '/.pnpmfile.cjs',\n        projectRoot: currentFolder,\n        lfxWorkspace: {\n          workspaceRootFullPath: currentFolder,\n          pnpmLockfilePath: Path.convertToSlashes(path.relative(currentFolder, pnpmLockPath)),\n          pnpmLockfileFolder: '',\n          pnpmfilePath: '.pnpmfile.cjs',\n          rushConfig: undefined\n        }\n      };\n\n      break;\n    }\n\n    currentFolder = currentFolder.substring(0, currentFolder.lastIndexOf('/'));\n  }\n\n  if (!appState) {\n    throw new Error('Could not find a Rush or PNPM workspace!');\n  }\n\n  return appState;\n};\n"]}

package/lib-dts/cli/explorer/ExplorerCommandLineParser.d.ts

@@ -2,10 +2,9 @@ import { type ITerminal } from '@rushstack/terminal';
 import { CommandLineParser } from '@rushstack/ts-command-line';
 export declare class ExplorerCommandLineParser extends CommandLineParser {
     readonly globalTerminal: ITerminal;
-    private readonly _terminalProvider;
     private readonly _debugParameter;
     private readonly _subspaceParameter;
-    constructor();
+    constructor(terminal: ITerminal);
     get isDebug(): boolean;
     protected onExecuteAsync(): Promise<void>;
 }

package/lib-dts/cli/explorer/ExplorerCommandLineParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExplorerCommandLineParser.d.ts","sourceRoot":"","sources":["../../../src/cli/explorer/ExplorerCommandLineParser.ts"],"names":[],"mappings":"AAmBA,OAAO,EAA2B,KAAK,SAAS,EAAsB,MAAM,qBAAqB,CAAC;AAClG,OAAO,EAEL,iBAAiB,EAElB,MAAM,4BAA4B,CAAC;AAiBpC,qBAAa,yBAA0B,SAAQ,iBAAiB;IAC9D,SAAgB,cAAc,EAAE,SAAS,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0B;IAC5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAE3D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsC;;IA0BzE,IAAW,OAAO,IAAI,OAAO,CAE5B;cAEwB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CA2NzD"}
+{"version":3,"file":"ExplorerCommandLineParser.d.ts","sourceRoot":"","sources":["../../../src/cli/explorer/ExplorerCommandLineParser.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAEL,iBAAiB,EAElB,MAAM,4BAA4B,CAAC;AAiCpC,qBAAa,yBAA0B,SAAQ,iBAAiB;IAC9D,SAAgB,cAAc,EAAE,SAAS,CAAC;IAE1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAC3D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsC;gBAEtD,QAAQ,EAAE,SAAS;IAuBtC,IAAW,OAAO,IAAI,OAAO,CAE5B;cAEwB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAsNzD"}

package/lib-dts/cli/lint/LintCommandLineParser.d.ts

@@ -2,8 +2,7 @@ import { type ITerminal } from '@rushstack/terminal';
 import { CommandLineParser } from '@rushstack/ts-command-line';
 export declare class LintCommandLineParser extends CommandLineParser {
     readonly globalTerminal: ITerminal;
-    private readonly _terminalProvider;
-    constructor();
+    constructor(terminal: ITerminal);
     protected onExecuteAsync(): Promise<void>;
     private _populateActions;
 }

package/lib-dts/cli/lint/LintCommandLineParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LintCommandLineParser.d.ts","sourceRoot":"","sources":["../../../src/cli/lint/LintCommandLineParser.ts"],"names":[],"mappings":"AAGA,OAAO,EAA2B,KAAK,SAAS,EAAsB,MAAM,qBAAqB,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAQ/D,qBAAa,qBAAsB,SAAQ,iBAAiB;IAC1D,SAAgB,cAAc,EAAE,SAAS,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0B;;cAenC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAcxD,OAAO,CAAC,gBAAgB;CAIzB"}
+{"version":3,"file":"LintCommandLineParser.d.ts","sourceRoot":"","sources":["../../../src/cli/lint/LintCommandLineParser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAQ/D,qBAAa,qBAAsB,SAAQ,iBAAiB;IAC1D,SAAgB,cAAc,EAAE,SAAS,CAAC;gBAEvB,QAAQ,EAAE,SAAS;cAYb,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAQxD,OAAO,CAAC,gBAAgB;CAKzB"}

package/lib-dts/cli/lint/actions/CheckAction.d.ts

@@ -1,5 +1,5 @@
 import { CommandLineAction } from '@rushstack/ts-command-line';
-import type { LintCommandLineParser } from '../LintCommandLineParser';
+import { type ITerminal } from '@rushstack/terminal';
 export interface ILintRule {
     rule: 'restrict-versions';
     project: string;
@@ -18,7 +18,7 @@ export declare class CheckAction extends CommandLineAction {
     private _rushConfiguration;
     private _checkedProjects;
     private _docMap;
-    constructor(parser: LintCommandLineParser);
+    constructor(terminal: ITerminal);
     private _checkVersionCompatibilityAsync;
     private _searchAndValidateDependenciesAsync;
     private _performVersionRestrictionCheckAsync;

package/lib-dts/cli/lint/actions/CheckAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CheckAction.d.ts","sourceRoot":"","sources":["../../../../src/cli/lint/actions/CheckAction.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAM/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAOtE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,WAAY,SAAQ,iBAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAEtC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,OAAO,CAA4C;gBAExC,MAAM,EAAE,qBAAqB;YAelC,+BAA+B;YAqC/B,mCAAmC;YA4DnC,oCAAoC;cAoBzB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAkEzD"}
+{"version":3,"file":"CheckAction.d.ts","sourceRoot":"","sources":["../../../../src/cli/lint/actions/CheckAction.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAW/D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,WAAY,SAAQ,iBAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAEtC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,OAAO,CAA4C;gBAExC,QAAQ,EAAE,SAAS;YAexB,+BAA+B;YAqC/B,mCAAmC;YA4DnC,oCAAoC;cAoBzB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAkEzD"}

package/lib-dts/cli/lint/actions/InitAction.d.ts

@@ -1,8 +1,8 @@
 import { CommandLineAction } from '@rushstack/ts-command-line';
-import type { LintCommandLineParser } from '../LintCommandLineParser';
+import { type ITerminal } from '@rushstack/terminal';
 export declare class InitAction extends CommandLineAction {
     private readonly _terminal;
-    constructor(parser: LintCommandLineParser);
+    constructor(terminal: ITerminal);
     protected onExecuteAsync(): Promise<void>;
 }
 //# sourceMappingURL=InitAction.d.ts.map

package/lib-dts/cli/lint/actions/InitAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InitAction.d.ts","sourceRoot":"","sources":["../../../../src/cli/lint/actions/InitAction.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAK/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGtE,qBAAa,UAAW,SAAQ,iBAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAEnB,MAAM,EAAE,qBAAqB;cAWvB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CA8BzD"}
+{"version":3,"file":"InitAction.d.ts","sourceRoot":"","sources":["../../../../src/cli/lint/actions/InitAction.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAM/D,qBAAa,UAAW,SAAQ,iBAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAEnB,QAAQ,EAAE,SAAS;cAWb,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CA8BzD"}

package/lib-dts/utils/PackageUpdateChecker.d.ts

@@ -0,0 +1,77 @@
+/**
+ * TODO: If we end up expecting to use this elsewhere, we should move this to
+ * either its own package or into `@rushstack/node-core-library`.
+ */
+/**
+ * Options for {@link _PackageUpdateChecker}.
+ *
+ * @internal
+ */
+export interface IPackageUpdateCheckerOptions {
+    /**
+     * The npm package name to check for updates.
+     */
+    packageName: string;
+    /**
+     * The currently installed version.
+     */
+    currentVersion: string;
+    /**
+     * If `true`, skip the update check entirely.
+     * Use this to suppress checks in CI environments or non-interactive sessions.
+     *
+     * @defaultValue false
+     */
+    skip?: boolean;
+    /**
+     * If `true`, bypass the cache and always fetch from the registry.
+     * Useful in debug/verbose modes where you want an immediate, authoritative answer.
+     *
+     * @defaultValue false
+     */
+    forceCheck?: boolean;
+    /**
+     * How long (in milliseconds) to consider a cached registry response fresh
+     * before re-fetching.
+     *
+     * @defaultValue 86400000 (24 hours)
+     */
+    cacheExpiryMs?: number;
+}
+/**
+ * The result of an update check.
+ *
+ * @internal
+ */
+export interface IPackageUpdateResult {
+    /**
+     * The latest version available on the registry.
+     */
+    latestVersion: string;
+    /**
+     * `true` if {@link _IPackageUpdateResult.latestVersion} is strictly newer than
+     * the {@link _IPackageUpdateCheckerOptions.currentVersion} that was passed to the checker.
+     */
+    isOutdated: boolean;
+}
+/**
+ * Checks npm for a newer version of a package and caches the result locally so that
+ * the registry is not queried on every invocation.
+ *
+ * @internal
+ */
+export declare class PackageUpdateChecker {
+    private readonly _packageName;
+    private readonly _currentVersion;
+    private readonly _skip;
+    private readonly _forceCheck;
+    private readonly _cacheExpiryMs;
+    constructor(options: IPackageUpdateCheckerOptions);
+    /**
+     * Performs the update check and returns the result, or `undefined` if the check
+     * was skipped or the registry could not be reached.
+     */
+    tryGetUpdateAsync(): Promise<IPackageUpdateResult | undefined>;
+    private _getCacheFilePath;
+}
+//# sourceMappingURL=PackageUpdateChecker.d.ts.map

package/lib-dts/utils/PackageUpdateChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageUpdateChecker.d.ts","sourceRoot":"","sources":["../../src/utils/PackageUpdateChecker.ts"],"names":[],"mappings":"AASA;;;GAGG;AAEH;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAoED;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAErB,OAAO,EAAE,4BAA4B;IAexD;;;OAGG;IACU,iBAAiB,IAAI,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;IAmC3E,OAAO,CAAC,iBAAiB;CAK1B"}

package/lib-dts/utils/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const LFX_VERSION: string, LFX_PACKAGE_NAME: string;
+export declare const LFX_PACKAGE_ROOT: string;
+//# sourceMappingURL=constants.d.ts.map

package/lib-dts/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAOA,eAAO,MAAiB,WAAW,UAAQ,gBAAgB,QAAgC,CAAC;AAO5F,eAAO,MAAM,gBAAgB,EAAE,MAAuD,CAAC"}

package/lib-dts/utils/init.d.ts

@@ -1,8 +1,8 @@
 import type { IAppState } from '../state';
-export declare const init: (options: {
-    lockfileExplorerProjectRoot: string;
+export interface IInitOptions {
     appVersion: string;
     debugMode: boolean;
     subspaceName: string;
-}) => Omit<IAppState, "graph">;
+}
+export declare const init: (options: IInitOptions) => Omit<IAppState, "graph">;
 //# sourceMappingURL=init.d.ts.map

package/lib-dts/utils/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/utils/init.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,eAAO,MAAM,IAAI,GAAI,SAAS;IAC5B,2BAA2B,EAAE,MAAM,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,KAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CA+E1B,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/utils/init.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG1C,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,IAAI,GAAI,SAAS,YAAY,KAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CA+EnE,CAAC"}

package/lib-esm/cli/explorer/ExplorerCommandLineParser.js

@@ -5,18 +5,25 @@ import * as path from 'node:path';
 import express from 'express';
 import yaml from 'js-yaml';
 import cors from 'cors';
-import updateNotifier from 'update-notifier';
-import { Executable, FileSystem, JsonFile, PackageJsonLookup } from '@rushstack/node-core-library';
-import { ConsoleTerminalProvider, Terminal, Colorize } from '@rushstack/terminal';
+import { Executable, FileSystem, JsonFile } from '@rushstack/node-core-library';
+import { Colorize } from '@rushstack/terminal';
 import { CommandLineParser } from '@rushstack/ts-command-line';
 import { lfxGraphSerializer } from '../../../build/lfx-shared';
 import * as lockfilePath from '../../graph/lockfilePath';
 import { init } from '../../utils/init';
 import { PnpmfileRunner } from '../../graph/PnpmfileRunner';
 import * as lfxGraphLoader from '../../graph/lfxGraphLoader';
+import { LFX_PACKAGE_NAME, LFX_VERSION } from '../../utils/constants';
+import { PackageUpdateChecker } from '../../utils/PackageUpdateChecker';
 const EXPLORER_TOOL_FILENAME = 'lockfile-explorer';
+function printUpdateNotification(result, terminal) {
+    if (result === null || result === void 0 ? void 0 : result.isOutdated) {
+        terminal.writeLine(Colorize.yellow(`\nUpdate available: ${LFX_VERSION} → ${result.latestVersion}\n` +
+            `Run: npm install -g ${LFX_PACKAGE_NAME}\n`));
+    }
+}
 export class ExplorerCommandLineParser extends CommandLineParser {
-    constructor() {
+    constructor(terminal) {
         super({
             toolFilename: EXPLORER_TOOL_FILENAME,
             toolDescription: 'Lockfile Explorer is a desktop app for investigating and solving version conflicts in a PNPM workspace.'
@@ -32,35 +39,29 @@ export class ExplorerCommandLineParser extends CommandLineParser {
             description: 'Specifies an individual Rush subspace to check.',
             defaultValue: 'default'
         });
-        this._terminalProvider = new ConsoleTerminalProvider();
-        this.globalTerminal = new Terminal(this._terminalProvider);
+        this.globalTerminal = terminal;
     }
     get isDebug() {
         return this._debugParameter.value;
     }
     async onExecuteAsync() {
-        const lockfileExplorerProjectRoot = PackageJsonLookup.instance.tryGetPackageFolderFor(__dirname);
-        const lockfileExplorerPackageJson = JsonFile.load(`${lockfileExplorerProjectRoot}/package.json`);
-        const appVersion = lockfileExplorerPackageJson.version;
-        this.globalTerminal.writeLine(Colorize.bold(`\nRush Lockfile Explorer ${appVersion}`) +
+        const terminal = this.globalTerminal;
+        terminal.writeLine(Colorize.bold(`\nRush Lockfile Explorer ${LFX_VERSION}`) +
             Colorize.cyan(' - https://lfx.rushstack.io/\n'));
-        updateNotifier({
-            pkg: lockfileExplorerPackageJson,
-            // Normally update-notifier waits a day or so before it starts displaying upgrade notices.
-            // In debug mode, show the notice right away.
-            updateCheckInterval: this.isDebug ? 0 : undefined
-        }).notify({
-            // Make sure it says "-g" in the "npm install" example command line
-            isGlobal: true,
-            // Show the notice immediately, rather than waiting for process.onExit()
-            defer: false
+        // Start the update check now so it runs concurrently with server setup.
+        // The result is awaited and displayed inside app.listen once the server is ready.
+        const updateChecker = new PackageUpdateChecker({
+            packageName: LFX_PACKAGE_NAME,
+            currentVersion: LFX_VERSION,
+            // In debug mode, bypass the cache so the notice appears immediately.
+            forceCheck: this.isDebug
         });
+        const updateCheckPromise = updateChecker.tryGetUpdateAsync();
         const PORT = 8091;
         // Must not have a trailing slash
         const SERVICE_URL = `http://localhost:${PORT}`;
         const appState = init({
-            lockfileExplorerProjectRoot,
-            appVersion,
+            appVersion: LFX_VERSION,
             debugMode: this.isDebug,
             subspaceName: this._subspaceParameter.value
         });
@@ -77,8 +78,8 @@ export class ExplorerCommandLineParser extends CommandLineParser {
         let disconnected = false;
         setInterval(() => {
             if (!isClientConnected && !awaitingFirstConnect && !disconnected) {
-                console.log(Colorize.red('The client has disconnected!'));
-                console.log(`Please open a browser window at http://localhost:${PORT}/app`);
+                terminal.writeLine(Colorize.red('The client has disconnected!'));
+                terminal.writeLine(`Please open a browser window at http://localhost:${PORT}/app`);
                 disconnected = true;
             }
             else if (!awaitingFirstConnect) {
@@ -105,7 +106,7 @@ export class ExplorerCommandLineParser extends CommandLineParser {
             isClientConnected = true;
             if (disconnected) {
                 disconnected = false;
-                console.log(Colorize.green('The client has reconnected!'));
+                terminal.writeLine(Colorize.green('The client has reconnected!'));
             }
             res.status(200).send();
         });
@@ -187,7 +188,8 @@ export class ExplorerCommandLineParser extends CommandLineParser {
             res.send(parsedPackage);
         });
         app.listen(PORT, async () => {
-            console.log(`App launched on ${SERVICE_URL}`);
+            terminal.writeLine(`App launched on ${SERVICE_URL}`);
+            printUpdateNotification(await updateCheckPromise, terminal);
             if (!appState.debugMode) {
                 try {
                     // Launch the default web browser using the platform-native open command.
@@ -219,7 +221,7 @@ export class ExplorerCommandLineParser extends CommandLineParser {
                     browserProcess.unref();
                 }
                 catch (e) {
-                    this.globalTerminal.writeError('Error launching browser: ' + e.toString());
+                    terminal.writeError('Error launching browser: ' + e.toString());
                 }
             }
         });