@rushstack/lockfile-explorer 1.4.16 → 1.5.0

package/bin/lockfile-explorer

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-require('../lib/start.js');
+require('../lib/start-explorer.js');

package/bin/lockfile-lint

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../lib/start-lint.js');

package/lib/assets/lint-init/lockfile-lint-template.json

@@ -0,0 +1,42 @@
+/**
+ * Config file for Lockfile Lint.  For more info, please visit: https://lfx.rushstack.io
+ */
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/lockfile-explorer/lockfile-lint.schema.json",
+
+  /**
+   * The list of rules to be checked by Lockfile Lint.  For each rule configuration, the
+   * type of rule is determined by the `rule` field.
+   */
+  "rules": [
+    // /**
+    //  * The `restrict-versions` rule enforces that direct and indirect dependencies must
+    //  * satisfy a specified version range.
+    //  */
+    // {
+    //   "rule": "restrict-versions",
+    //
+    //   /**
+    //    * The name of a workspace project to analyze.
+    //    */
+    //   "project": "@my-company/my-app",
+    //
+    //   /**
+    //    * Indicates the package versions to be checked.  The `requiredVersions` key is
+    //    * the name of an NPM package, and the value is a SemVer range.  If the project has
+    //    * that NPM package as a dependency, then its version must satisfy the SemVer range.
+    //    * This check also applies to devDependencies and peerDependencies, as well as any
+    //    * indirect dependencies of the project.
+    //    */
+    //   "requiredVersions": {
+    //     /**
+    //      * For example, if `react-router` appears anywhere in the dependency graph of
+    //      * `@my-company/my-app`, then it must be version 5 or 6.
+    //      */
+    //     "react-router": "5.x || 6.x",
+    //     "react": "^18.3.0",
+    //     "react-dom": "^18.3.0"
+    //   }
+    // }
+  ]
+}

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

@@ -0,0 +1,12 @@
+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();
+    get isDebug(): boolean;
+    protected onExecute(): Promise<void>;
+}
+//# sourceMappingURL=ExplorerCommandLineParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExplorerCommandLineParser.d.ts","sourceRoot":"","sources":["../../../src/cli/explorer/ExplorerCommandLineParser.ts"],"names":[],"mappings":"AAWA,OAAO,EAA2B,KAAK,SAAS,EAAsB,MAAM,qBAAqB,CAAC;AAClG,OAAO,EAEL,iBAAiB,EAElB,MAAM,4BAA4B,CAAC;AAUpC,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;cAEe,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CA2L3C"}

package/lib/cli/explorer/ExplorerCommandLineParser.js

@@ -0,0 +1,205 @@
+"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.ExplorerCommandLineParser = void 0;
+const express_1 = __importDefault(require("express"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const cors_1 = __importDefault(require("cors"));
+const process_1 = __importDefault(require("process"));
+const open_1 = __importDefault(require("open"));
+const update_notifier_1 = __importDefault(require("update-notifier"));
+const node_core_library_1 = require("@rushstack/node-core-library");
+const terminal_1 = require("@rushstack/terminal");
+const ts_command_line_1 = require("@rushstack/ts-command-line");
+const init_1 = require("../../utils/init");
+const shrinkwrap_1 = require("../../utils/shrinkwrap");
+const EXPLORER_TOOL_FILENAME = 'lockfile-explorer';
+class ExplorerCommandLineParser extends ts_command_line_1.CommandLineParser {
+    constructor() {
+        super({
+            toolFilename: EXPLORER_TOOL_FILENAME,
+            toolDescription: 'Lockfile Explorer is a desktop app for investigating and solving version conflicts in a PNPM workspace.'
+        });
+        this._debugParameter = this.defineFlagParameter({
+            parameterLongName: '--debug',
+            parameterShortName: '-d',
+            description: 'Show the full call stack if an error occurs while executing the tool'
+        });
+        this._subspaceParameter = this.defineStringParameter({
+            parameterLongName: '--subspace',
+            argumentName: 'SUBSPACE_NAME',
+            description: 'Specifies an individual Rush subspace to check.',
+            defaultValue: 'default'
+        });
+        this._terminalProvider = new terminal_1.ConsoleTerminalProvider();
+        this.globalTerminal = new terminal_1.Terminal(this._terminalProvider);
+    }
+    get isDebug() {
+        return this._debugParameter.value;
+    }
+    async onExecute() {
+        const lockfileExplorerProjectRoot = node_core_library_1.PackageJsonLookup.instance.tryGetPackageFolderFor(__dirname);
+        const lockfileExplorerPackageJson = node_core_library_1.JsonFile.load(`${lockfileExplorerProjectRoot}/package.json`);
+        const appVersion = lockfileExplorerPackageJson.version;
+        this.globalTerminal.writeLine(terminal_1.Colorize.bold(`\nRush Lockfile Explorer ${appVersion}`) +
+            terminal_1.Colorize.cyan(' - https://lfx.rushstack.io/\n'));
+        (0, update_notifier_1.default)({
+            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
+        });
+        const PORT = 8091;
+        // Must not have a trailing slash
+        const SERVICE_URL = `http://localhost:${PORT}`;
+        const appState = (0, init_1.init)({
+            lockfileExplorerProjectRoot,
+            appVersion,
+            debugMode: this.isDebug,
+            subspaceName: this._subspaceParameter.value
+        });
+        // Important: This must happen after init() reads the current working directory
+        process_1.default.chdir(appState.lockfileExplorerProjectRoot);
+        const distFolderPath = `${appState.lockfileExplorerProjectRoot}/dist`;
+        const app = (0, express_1.default)();
+        app.use(express_1.default.json());
+        app.use((0, cors_1.default)());
+        // Variable used to check if the front-end client is still connected
+        let awaitingFirstConnect = true;
+        let isClientConnected = false;
+        let disconnected = false;
+        setInterval(() => {
+            if (!isClientConnected && !awaitingFirstConnect && !disconnected) {
+                console.log(terminal_1.Colorize.red('The client has disconnected!'));
+                console.log(`Please open a browser window at http://localhost:${PORT}/app`);
+                disconnected = true;
+            }
+            else if (!awaitingFirstConnect) {
+                isClientConnected = false;
+            }
+        }, 4000);
+        // This takes precedence over the `/app` static route, which also has an `initappcontext.js` file.
+        app.get('/initappcontext.js', (req, res) => {
+            const appContext = {
+                serviceUrl: SERVICE_URL,
+                appVersion: appState.appVersion,
+                debugMode: this.isDebug
+            };
+            const sourceCode = [
+                `console.log('Loaded initappcontext.js');`,
+                `appContext = ${JSON.stringify(appContext)}`
+            ].join('\n');
+            res.type('application/javascript').send(sourceCode);
+        });
+        app.use('/', express_1.default.static(distFolderPath));
+        app.use('/favicon.ico', express_1.default.static(distFolderPath, { index: 'favicon.ico' }));
+        app.get('/api/lockfile', async (req, res) => {
+            const pnpmLockfileText = await node_core_library_1.FileSystem.readFileAsync(appState.pnpmLockfileLocation);
+            const doc = js_yaml_1.default.load(pnpmLockfileText);
+            const { packages, lockfileVersion } = doc;
+            const shrinkwrapFileMajorVersion = (0, shrinkwrap_1.getShrinkwrapFileMajorVersion)(lockfileVersion);
+            if (packages && shrinkwrapFileMajorVersion === 6) {
+                const updatedPackages = {};
+                for (const [dependencyPath, dependency] of Object.entries(packages)) {
+                    updatedPackages[(0, shrinkwrap_1.convertLockfileV6DepPathToV5DepPath)(dependencyPath)] = dependency;
+                }
+                doc.packages = updatedPackages;
+            }
+            res.send({
+                doc,
+                subspaceName: this._subspaceParameter.value
+            });
+        });
+        app.get('/api/health', (req, res) => {
+            awaitingFirstConnect = false;
+            isClientConnected = true;
+            if (disconnected) {
+                disconnected = false;
+                console.log(terminal_1.Colorize.green('The client has reconnected!'));
+            }
+            res.status(200).send();
+        });
+        app.post('/api/package-json', async (req, res) => {
+            const { projectPath } = req.body;
+            const fileLocation = `${appState.projectRoot}/${projectPath}/package.json`;
+            let packageJsonText;
+            try {
+                packageJsonText = await node_core_library_1.FileSystem.readFileAsync(fileLocation);
+            }
+            catch (e) {
+                if (node_core_library_1.FileSystem.isNotExistError(e)) {
+                    return res.status(404).send({
+                        message: `Could not load package.json file for this package. Have you installed all the dependencies for this workspace?`,
+                        error: `No package.json in location: ${projectPath}`
+                    });
+                }
+                else {
+                    throw e;
+                }
+            }
+            res.send(packageJsonText);
+        });
+        app.get('/api/pnpmfile', async (req, res) => {
+            let pnpmfile;
+            try {
+                pnpmfile = await node_core_library_1.FileSystem.readFileAsync(appState.pnpmfileLocation);
+            }
+            catch (e) {
+                if (node_core_library_1.FileSystem.isNotExistError(e)) {
+                    return res.status(404).send({
+                        message: `Could not load pnpmfile file in this repo.`,
+                        error: `No .pnpmifile.cjs found.`
+                    });
+                }
+                else {
+                    throw e;
+                }
+            }
+            res.send(pnpmfile);
+        });
+        app.post('/api/package-spec', async (req, res) => {
+            const { projectPath } = req.body;
+            const fileLocation = `${appState.projectRoot}/${projectPath}/package.json`;
+            let packageJson;
+            try {
+                packageJson = await node_core_library_1.JsonFile.loadAsync(fileLocation);
+            }
+            catch (e) {
+                if (node_core_library_1.FileSystem.isNotExistError(e)) {
+                    return res.status(404).send({
+                        message: `Could not load package.json file in location: ${projectPath}`
+                    });
+                }
+                else {
+                    throw e;
+                }
+            }
+            const { hooks: { readPackage } } = require(appState.pnpmfileLocation);
+            const parsedPackage = readPackage(packageJson, {});
+            res.send(parsedPackage);
+        });
+        app.listen(PORT, async () => {
+            console.log(`App launched on ${SERVICE_URL}`);
+            if (!appState.debugMode) {
+                try {
+                    // Launch the web browser
+                    await (0, open_1.default)(SERVICE_URL);
+                }
+                catch (e) {
+                    this.globalTerminal.writeError('Error launching browser: ' + e.toString());
+                }
+            }
+        });
+    }
+}
+exports.ExplorerCommandLineParser = ExplorerCommandLineParser;
+//# sourceMappingURL=ExplorerCommandLineParser.js.map

package/lib/cli/explorer/ExplorerCommandLineParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExplorerCommandLineParser.js","sourceRoot":"","sources":["../../../src/cli/explorer/ExplorerCommandLineParser.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 express from 'express';\nimport yaml from 'js-yaml';\nimport cors from 'cors';\nimport process from 'process';\nimport open from 'open';\nimport updateNotifier from 'update-notifier';\n\nimport { FileSystem, type IPackageJson, JsonFile, PackageJsonLookup } from '@rushstack/node-core-library';\nimport { ConsoleTerminalProvider, type ITerminal, Terminal, Colorize } from '@rushstack/terminal';\nimport {\n  type CommandLineFlagParameter,\n  CommandLineParser,\n  type IRequiredCommandLineStringParameter\n} from '@rushstack/ts-command-line';\nimport type { IAppContext } from '@rushstack/lockfile-explorer-web/lib/AppContext';\nimport type { Lockfile } from '@pnpm/lockfile-types';\n\nimport type { IAppState } from '../../state';\nimport { init } from '../../utils/init';\nimport { convertLockfileV6DepPathToV5DepPath, getShrinkwrapFileMajorVersion } from '../../utils/shrinkwrap';\n\nconst EXPLORER_TOOL_FILENAME: 'lockfile-explorer' = 'lockfile-explorer';\n\nexport class ExplorerCommandLineParser extends CommandLineParser {\n  public readonly globalTerminal: ITerminal;\n  private readonly _terminalProvider: ConsoleTerminalProvider;\n  private readonly _debugParameter: CommandLineFlagParameter;\n\n  private readonly _subspaceParameter: IRequiredCommandLineStringParameter;\n\n  public constructor() {\n    super({\n      toolFilename: EXPLORER_TOOL_FILENAME,\n      toolDescription:\n        'Lockfile Explorer is a desktop app for investigating and solving version conflicts in a PNPM workspace.'\n    });\n\n    this._debugParameter = this.defineFlagParameter({\n      parameterLongName: '--debug',\n      parameterShortName: '-d',\n      description: 'Show the full call stack if an error occurs while executing the tool'\n    });\n\n    this._subspaceParameter = this.defineStringParameter({\n      parameterLongName: '--subspace',\n      argumentName: 'SUBSPACE_NAME',\n      description: 'Specifies an individual Rush subspace to check.',\n      defaultValue: 'default'\n    });\n\n    this._terminalProvider = new ConsoleTerminalProvider();\n    this.globalTerminal = new Terminal(this._terminalProvider);\n  }\n\n  public get isDebug(): boolean {\n    return this._debugParameter.value;\n  }\n\n  protected async onExecute(): Promise<void> {\n    const lockfileExplorerProjectRoot: string = PackageJsonLookup.instance.tryGetPackageFolderFor(__dirname)!;\n    const lockfileExplorerPackageJson: IPackageJson = JsonFile.load(\n      `${lockfileExplorerProjectRoot}/package.json`\n    );\n    const appVersion: string = lockfileExplorerPackageJson.version;\n\n    this.globalTerminal.writeLine(\n      Colorize.bold(`\\nRush Lockfile Explorer ${appVersion}`) +\n        Colorize.cyan(' - https://lfx.rushstack.io/\\n')\n    );\n\n    updateNotifier({\n      pkg: lockfileExplorerPackageJson,\n      // Normally update-notifier waits a day or so before it starts displaying upgrade notices.\n      // In debug mode, show the notice right away.\n      updateCheckInterval: this.isDebug ? 0 : undefined\n    }).notify({\n      // Make sure it says \"-g\" in the \"npm install\" example command line\n      isGlobal: true,\n      // Show the notice immediately, rather than waiting for process.onExit()\n      defer: false\n    });\n\n    const PORT: number = 8091;\n    // Must not have a trailing slash\n    const SERVICE_URL: string = `http://localhost:${PORT}`;\n\n    const appState: IAppState = init({\n      lockfileExplorerProjectRoot,\n      appVersion,\n      debugMode: this.isDebug,\n      subspaceName: this._subspaceParameter.value\n    });\n\n    // Important: This must happen after init() reads the current working directory\n    process.chdir(appState.lockfileExplorerProjectRoot);\n\n    const distFolderPath: string = `${appState.lockfileExplorerProjectRoot}/dist`;\n    const app: express.Application = express();\n    app.use(express.json());\n    app.use(cors());\n\n    // Variable used to check if the front-end client is still connected\n    let awaitingFirstConnect: boolean = true;\n    let isClientConnected: boolean = false;\n    let disconnected: boolean = false;\n    setInterval(() => {\n      if (!isClientConnected && !awaitingFirstConnect && !disconnected) {\n        console.log(Colorize.red('The client has disconnected!'));\n        console.log(`Please open a browser window at http://localhost:${PORT}/app`);\n        disconnected = true;\n      } else if (!awaitingFirstConnect) {\n        isClientConnected = false;\n      }\n    }, 4000);\n\n    // This takes precedence over the `/app` static route, which also has an `initappcontext.js` file.\n    app.get('/initappcontext.js', (req: express.Request, res: express.Response) => {\n      const appContext: IAppContext = {\n        serviceUrl: SERVICE_URL,\n        appVersion: appState.appVersion,\n        debugMode: this.isDebug\n      };\n      const sourceCode: string = [\n        `console.log('Loaded initappcontext.js');`,\n        `appContext = ${JSON.stringify(appContext)}`\n      ].join('\\n');\n\n      res.type('application/javascript').send(sourceCode);\n    });\n\n    app.use('/', express.static(distFolderPath));\n\n    app.use('/favicon.ico', express.static(distFolderPath, { index: 'favicon.ico' }));\n\n    app.get('/api/lockfile', async (req: express.Request, res: express.Response) => {\n      const pnpmLockfileText: string = await FileSystem.readFileAsync(appState.pnpmLockfileLocation);\n      const doc = yaml.load(pnpmLockfileText) as Lockfile;\n      const { packages, lockfileVersion } = doc;\n\n      const shrinkwrapFileMajorVersion: number = getShrinkwrapFileMajorVersion(lockfileVersion);\n\n      if (packages && shrinkwrapFileMajorVersion === 6) {\n        const updatedPackages: Lockfile['packages'] = {};\n        for (const [dependencyPath, dependency] of Object.entries(packages)) {\n          updatedPackages[convertLockfileV6DepPathToV5DepPath(dependencyPath)] = dependency;\n        }\n        doc.packages = updatedPackages;\n      }\n\n      res.send({\n        doc,\n        subspaceName: this._subspaceParameter.value\n      });\n    });\n\n    app.get('/api/health', (req: express.Request, res: express.Response) => {\n      awaitingFirstConnect = false;\n      isClientConnected = true;\n      if (disconnected) {\n        disconnected = false;\n        console.log(Colorize.green('The client has reconnected!'));\n      }\n      res.status(200).send();\n    });\n\n    app.post(\n      '/api/package-json',\n      async (req: express.Request<{}, {}, { projectPath: string }, {}>, res: express.Response) => {\n        const { projectPath } = req.body;\n        const fileLocation = `${appState.projectRoot}/${projectPath}/package.json`;\n        let packageJsonText: string;\n        try {\n          packageJsonText = await FileSystem.readFileAsync(fileLocation);\n        } catch (e) {\n          if (FileSystem.isNotExistError(e)) {\n            return res.status(404).send({\n              message: `Could not load package.json file for this package. Have you installed all the dependencies for this workspace?`,\n              error: `No package.json in location: ${projectPath}`\n            });\n          } else {\n            throw e;\n          }\n        }\n\n        res.send(packageJsonText);\n      }\n    );\n\n    app.get('/api/pnpmfile', async (req: express.Request, res: express.Response) => {\n      let pnpmfile: string;\n      try {\n        pnpmfile = await FileSystem.readFileAsync(appState.pnpmfileLocation);\n      } catch (e) {\n        if (FileSystem.isNotExistError(e)) {\n          return res.status(404).send({\n            message: `Could not load pnpmfile file in this repo.`,\n            error: `No .pnpmifile.cjs found.`\n          });\n        } else {\n          throw e;\n        }\n      }\n\n      res.send(pnpmfile);\n    });\n\n    app.post(\n      '/api/package-spec',\n      async (req: express.Request<{}, {}, { projectPath: string }, {}>, res: express.Response) => {\n        const { projectPath } = req.body;\n        const fileLocation = `${appState.projectRoot}/${projectPath}/package.json`;\n        let packageJson: IPackageJson;\n        try {\n          packageJson = await JsonFile.loadAsync(fileLocation);\n        } catch (e) {\n          if (FileSystem.isNotExistError(e)) {\n            return res.status(404).send({\n              message: `Could not load package.json file in location: ${projectPath}`\n            });\n          } else {\n            throw e;\n          }\n        }\n\n        const {\n          hooks: { readPackage }\n        } = require(appState.pnpmfileLocation);\n        const parsedPackage = readPackage(packageJson, {});\n        res.send(parsedPackage);\n      }\n    );\n\n    app.listen(PORT, async () => {\n      console.log(`App launched on ${SERVICE_URL}`);\n\n      if (!appState.debugMode) {\n        try {\n          // Launch the web browser\n          await open(SERVICE_URL);\n        } catch (e) {\n          this.globalTerminal.writeError('Error launching browser: ' + e.toString());\n        }\n      }\n    });\n  }\n}\n"]}

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

@@ -0,0 +1,10 @@
+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();
+    protected onExecute(): Promise<void>;
+    private _populateActions;
+}
+//# sourceMappingURL=LintCommandLineParser.d.ts.map

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

@@ -0,0 +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;AAO/D,qBAAa,qBAAsB,SAAQ,iBAAiB;IAC1D,SAAgB,cAAc,EAAE,SAAS,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0B;;cAenC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAcnD,OAAO,CAAC,gBAAgB;CAIzB"}

package/lib/cli/lint/LintCommandLineParser.js

@@ -0,0 +1,35 @@
+"use strict";
+// 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 });
+exports.LintCommandLineParser = void 0;
+const terminal_1 = require("@rushstack/terminal");
+const ts_command_line_1 = require("@rushstack/ts-command-line");
+const InitAction_1 = require("./actions/InitAction");
+const CheckAction_1 = require("./actions/CheckAction");
+const node_core_library_1 = require("@rushstack/node-core-library");
+const LINT_TOOL_FILENAME = 'lockfile-lint';
+class LintCommandLineParser extends ts_command_line_1.CommandLineParser {
+    constructor() {
+        super({
+            toolFilename: LINT_TOOL_FILENAME,
+            toolDescription: 'Lockfile Lint applies configured policies to find and report dependency issues in your PNPM workspace.'
+        });
+        this._terminalProvider = new terminal_1.ConsoleTerminalProvider();
+        this.globalTerminal = new terminal_1.Terminal(this._terminalProvider);
+        this._populateActions();
+    }
+    async onExecute() {
+        const lockfileExplorerProjectRoot = node_core_library_1.PackageJsonLookup.instance.tryGetPackageFolderFor(__dirname);
+        const lockfileExplorerPackageJson = node_core_library_1.JsonFile.load(`${lockfileExplorerProjectRoot}/package.json`);
+        const appVersion = lockfileExplorerPackageJson.version;
+        this.globalTerminal.writeLine(terminal_1.Colorize.bold(`\nRush Lockfile Lint ${appVersion}`) + terminal_1.Colorize.cyan(' - https://lfx.rushstack.io/\n'));
+        await super.onExecute();
+    }
+    _populateActions() {
+        this.addAction(new InitAction_1.InitAction(this));
+        this.addAction(new CheckAction_1.CheckAction(this));
+    }
+}
+exports.LintCommandLineParser = LintCommandLineParser;
+//# sourceMappingURL=LintCommandLineParser.js.map

package/lib/cli/lint/LintCommandLineParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LintCommandLineParser.js","sourceRoot":"","sources":["../../../src/cli/lint/LintCommandLineParser.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,kDAAkG;AAClG,gEAA+D;AAC/D,qDAAkD;AAClD,uDAAoD;AACpD,oEAA8F;AAE9F,MAAM,kBAAkB,GAAoB,eAAe,CAAC;AAE5D,MAAa,qBAAsB,SAAQ,mCAAiB;IAI1D;QACE,KAAK,CAAC;YACJ,YAAY,EAAE,kBAAkB;YAChC,eAAe,EACb,wGAAwG;SAC3G,CAAC,CAAC;QAEH,IAAI,CAAC,iBAAiB,GAAG,IAAI,kCAAuB,EAAE,CAAC;QACvD,IAAI,CAAC,cAAc,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAE3D,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAEkB,KAAK,CAAC,SAAS;QAChC,MAAM,2BAA2B,GAAW,qCAAiB,CAAC,QAAQ,CAAC,sBAAsB,CAAC,SAAS,CAAE,CAAC;QAC1G,MAAM,2BAA2B,GAAiB,4BAAQ,CAAC,IAAI,CAC7D,GAAG,2BAA2B,eAAe,CAC9C,CAAC;QACF,MAAM,UAAU,GAAW,2BAA2B,CAAC,OAAO,CAAC;QAE/D,IAAI,CAAC,cAAc,CAAC,SAAS,CAC3B,mBAAQ,CAAC,IAAI,CAAC,wBAAwB,UAAU,EAAE,CAAC,GAAG,mBAAQ,CAAC,IAAI,CAAC,gCAAgC,CAAC,CACtG,CAAC;QAEF,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;IAEO,gBAAgB;QACtB,IAAI,CAAC,SAAS,CAAC,IAAI,uBAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,CAAC,IAAI,yBAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;CACF;AAnCD,sDAmCC","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, type ITerminal, Terminal, Colorize } from '@rushstack/terminal';\nimport { CommandLineParser } from '@rushstack/ts-command-line';\nimport { InitAction } from './actions/InitAction';\nimport { CheckAction } from './actions/CheckAction';\nimport { type IPackageJson, JsonFile, PackageJsonLookup } from '@rushstack/node-core-library';\n\nconst LINT_TOOL_FILENAME: 'lockfile-lint' = 'lockfile-lint';\n\nexport class LintCommandLineParser extends CommandLineParser {\n  public readonly globalTerminal: ITerminal;\n  private readonly _terminalProvider: ConsoleTerminalProvider;\n\n  public constructor() {\n    super({\n      toolFilename: LINT_TOOL_FILENAME,\n      toolDescription:\n        'Lockfile Lint applies configured policies to find and report dependency issues in your PNPM workspace.'\n    });\n\n    this._terminalProvider = new ConsoleTerminalProvider();\n    this.globalTerminal = new Terminal(this._terminalProvider);\n\n    this._populateActions();\n  }\n\n  protected override async onExecute(): Promise<void> {\n    const lockfileExplorerProjectRoot: string = PackageJsonLookup.instance.tryGetPackageFolderFor(__dirname)!;\n    const lockfileExplorerPackageJson: IPackageJson = JsonFile.load(\n      `${lockfileExplorerProjectRoot}/package.json`\n    );\n    const appVersion: string = lockfileExplorerPackageJson.version;\n\n    this.globalTerminal.writeLine(\n      Colorize.bold(`\\nRush Lockfile Lint ${appVersion}`) + Colorize.cyan(' - https://lfx.rushstack.io/\\n')\n    );\n\n    await super.onExecute();\n  }\n\n  private _populateActions(): void {\n    this.addAction(new InitAction(this));\n    this.addAction(new CheckAction(this));\n  }\n}\n"]}

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

@@ -0,0 +1,27 @@
+import { CommandLineAction } from '@rushstack/ts-command-line';
+import type { LintCommandLineParser } from '../LintCommandLineParser';
+export interface ILintRule {
+    rule: 'restrict-versions';
+    project: string;
+    requiredVersions: Record<string, string>;
+}
+export interface ILockfileLint {
+    rules: ILintRule[];
+}
+export interface ILintIssue {
+    project: string;
+    rule: string;
+    message: string;
+}
+export declare class CheckAction extends CommandLineAction {
+    private readonly _terminal;
+    private _rushConfiguration;
+    private _checkedProjects;
+    private _docMap;
+    constructor(parser: LintCommandLineParser);
+    private _checkVersionCompatibilityAsync;
+    private _searchAndValidateDependenciesAsync;
+    private _performVersionRestrictionCheckAsync;
+    protected onExecute(): Promise<void>;
+}
+//# sourceMappingURL=CheckAction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CheckAction.d.ts","sourceRoot":"","sources":["../../../../src/cli/lint/actions/CheckAction.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAS/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAQtE,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,CAAqC;gBAEjC,MAAM,EAAE,qBAAqB;YAelC,+BAA+B;YAqC/B,mCAAmC;YA4DnC,oCAAoC;cAoBlC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAkE3C"}

package/lib/cli/lint/actions/CheckAction.js

@@ -0,0 +1,145 @@
+"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.CheckAction = void 0;
+const terminal_1 = require("@rushstack/terminal");
+const ts_command_line_1 = require("@rushstack/ts-command-line");
+const rush_sdk_1 = require("@rushstack/rush-sdk");
+const path_1 = __importDefault(require("path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const semver_1 = __importDefault(require("semver"));
+const node_core_library_1 = require("@rushstack/node-core-library");
+const lockfile_lint_schema_json_1 = __importDefault(require("../../../schemas/lockfile-lint.schema.json"));
+const common_1 = require("../../../constants/common");
+const shrinkwrap_1 = require("../../../utils/shrinkwrap");
+class CheckAction extends ts_command_line_1.CommandLineAction {
+    constructor(parser) {
+        super({
+            actionName: 'check',
+            summary: 'Check and report dependency issues in your workspace',
+            documentation: 'This command applies the policies that are configured in ' +
+                common_1.LOCKFILE_LINT_JSON_FILENAME +
+                ', reporting any problems found in your PNPM workspace.'
+        });
+        this._terminal = parser.globalTerminal;
+        this._checkedProjects = new Set();
+        this._docMap = new Map();
+    }
+    async _checkVersionCompatibilityAsync(shrinkwrapFileMajorVersion, packages, dependencyPath, requiredVersions, checkedDependencyPaths) {
+        var _a;
+        if (packages && packages[dependencyPath] && !checkedDependencyPaths.has(dependencyPath)) {
+            checkedDependencyPaths.add(dependencyPath);
+            const { name, version } = (0, shrinkwrap_1.parseDependencyPath)(shrinkwrapFileMajorVersion, dependencyPath);
+            if (name in requiredVersions && !semver_1.default.satisfies(version, requiredVersions[name])) {
+                throw new Error(`The version of "${name}" should match "${requiredVersions[name]}";` +
+                    ` actual version is "${version}"`);
+            }
+            await Promise.all(Object.entries((_a = packages[dependencyPath].dependencies) !== null && _a !== void 0 ? _a : {}).map(async ([dependencyPackageName, dependencyPackageVersion]) => {
+                await this._checkVersionCompatibilityAsync(shrinkwrapFileMajorVersion, packages, (0, shrinkwrap_1.splicePackageWithVersion)(shrinkwrapFileMajorVersion, dependencyPackageName, dependencyPackageVersion), requiredVersions, checkedDependencyPaths);
+            }));
+        }
+    }
+    async _searchAndValidateDependenciesAsync(project, requiredVersions) {
+        this._terminal.writeLine(`Checking project "${project.packageName}"`);
+        const projectFolder = project.projectFolder;
+        const subspace = project.subspace;
+        const shrinkwrapFilename = subspace.getCommittedShrinkwrapFilename();
+        let doc;
+        if (this._docMap.has(shrinkwrapFilename)) {
+            doc = this._docMap.get(shrinkwrapFilename);
+        }
+        else {
+            const pnpmLockfileText = await node_core_library_1.FileSystem.readFileAsync(shrinkwrapFilename);
+            doc = js_yaml_1.default.load(pnpmLockfileText);
+            this._docMap.set(shrinkwrapFilename, doc);
+        }
+        const { importers, lockfileVersion, packages } = doc;
+        const shrinkwrapFileMajorVersion = (0, shrinkwrap_1.getShrinkwrapFileMajorVersion)(lockfileVersion);
+        const checkedDependencyPaths = new Set();
+        await Promise.all(Object.entries(importers).map(async ([relativePath, { dependencies }]) => {
+            var _a;
+            if (path_1.default.resolve(projectFolder, relativePath) === projectFolder) {
+                const dependenciesEntries = Object.entries(dependencies !== null && dependencies !== void 0 ? dependencies : {});
+                for (const [dependencyName, dependencyValue] of dependenciesEntries) {
+                    const fullDependencyPath = (0, shrinkwrap_1.splicePackageWithVersion)(shrinkwrapFileMajorVersion, dependencyName, typeof dependencyValue === 'string'
+                        ? dependencyValue
+                        : dependencyValue.version);
+                    if (fullDependencyPath.includes('link:')) {
+                        const dependencyProject = this._rushConfiguration.getProjectByName(dependencyName);
+                        if (dependencyProject && !((_a = this._checkedProjects) === null || _a === void 0 ? void 0 : _a.has(dependencyProject))) {
+                            this._checkedProjects.add(project);
+                            await this._searchAndValidateDependenciesAsync(dependencyProject, requiredVersions);
+                        }
+                    }
+                    else {
+                        await this._checkVersionCompatibilityAsync(shrinkwrapFileMajorVersion, packages, fullDependencyPath, requiredVersions, checkedDependencyPaths);
+                    }
+                }
+            }
+        }));
+    }
+    async _performVersionRestrictionCheckAsync(requiredVersions, projectName) {
+        var _a;
+        try {
+            const project = (_a = this._rushConfiguration) === null || _a === void 0 ? void 0 : _a.getProjectByName(projectName);
+            if (!project) {
+                throw new Error(`Specified project "${projectName}" does not exist in ${common_1.LOCKFILE_LINT_JSON_FILENAME}`);
+            }
+            this._checkedProjects.add(project);
+            await this._searchAndValidateDependenciesAsync(project, requiredVersions);
+            return undefined;
+        }
+        catch (e) {
+            return e.message;
+        }
+    }
+    async onExecute() {
+        const rushConfiguration = rush_sdk_1.RushConfiguration.tryLoadFromDefaultLocation();
+        if (!rushConfiguration) {
+            throw new Error('The "lockfile-explorer check" must be executed in a folder that is under a Rush workspace folder');
+        }
+        this._rushConfiguration = rushConfiguration;
+        const lintingFile = path_1.default.resolve(this._rushConfiguration.commonFolder, 'config', common_1.LOCKFILE_EXPLORER_FOLDERNAME, common_1.LOCKFILE_LINT_JSON_FILENAME);
+        const { rules } = await node_core_library_1.JsonFile.loadAndValidateAsync(lintingFile, node_core_library_1.JsonSchema.fromLoadedObject(lockfile_lint_schema_json_1.default));
+        const issues = [];
+        await node_core_library_1.Async.forEachAsync(rules, async ({ requiredVersions, project, rule }) => {
+            switch (rule) {
+                case 'restrict-versions': {
+                    const message = await this._performVersionRestrictionCheckAsync(requiredVersions, project);
+                    if (message) {
+                        issues.push({ project, rule, message });
+                    }
+                    break;
+                }
+                default: {
+                    throw new Error('Unsupported rule name: ' + rule);
+                }
+            }
+        }, { concurrency: 50 });
+        if (issues.length > 0) {
+            this._terminal.writeLine();
+            // Deterministic order
+            for (const issue of issues.sort((a, b) => {
+                let diff = a.project.localeCompare(b.project);
+                if (diff !== 0) {
+                    return diff;
+                }
+                diff = a.rule.localeCompare(b.rule);
+                if (diff !== 0) {
+                    return diff;
+                }
+                return a.message.localeCompare(b.message);
+            })) {
+                this._terminal.writeLine(terminal_1.Colorize.red('PROBLEM: ') + terminal_1.Colorize.cyan(`[${issue.rule}] `) + issue.message + '\n');
+            }
+            throw new node_core_library_1.AlreadyReportedError();
+        }
+        this._terminal.writeLine(terminal_1.Colorize.green('SUCCESS: ') + 'All checks passed.');
+    }
+}
+exports.CheckAction = CheckAction;
+//# sourceMappingURL=CheckAction.js.map

package/lib/cli/lint/actions/CheckAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckAction.js","sourceRoot":"","sources":["../../../../src/cli/lint/actions/CheckAction.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 { Colorize, type ITerminal } from '@rushstack/terminal';\nimport { CommandLineAction } from '@rushstack/ts-command-line';\nimport { RushConfiguration, type RushConfigurationProject, type Subspace } from '@rushstack/rush-sdk';\nimport path from 'path';\nimport yaml from 'js-yaml';\nimport semver from 'semver';\nimport { AlreadyReportedError, Async, FileSystem, JsonFile, JsonSchema } from '@rushstack/node-core-library';\n\nimport lockfileLintSchema from '../../../schemas/lockfile-lint.schema.json';\nimport { LOCKFILE_EXPLORER_FOLDERNAME, LOCKFILE_LINT_JSON_FILENAME } from '../../../constants/common';\nimport type { LintCommandLineParser } from '../LintCommandLineParser';\nimport {\n  getShrinkwrapFileMajorVersion,\n  parseDependencyPath,\n  splicePackageWithVersion\n} from '../../../utils/shrinkwrap';\nimport type { Lockfile, LockfileV6 } from '@pnpm/lockfile-types';\n\nexport interface ILintRule {\n  rule: 'restrict-versions';\n  project: string;\n  requiredVersions: Record<string, string>;\n}\n\nexport interface ILockfileLint {\n  rules: ILintRule[];\n}\n\nexport interface ILintIssue {\n  project: string;\n  rule: string;\n  message: string;\n}\n\nexport class CheckAction extends CommandLineAction {\n  private readonly _terminal: ITerminal;\n\n  private _rushConfiguration!: RushConfiguration;\n  private _checkedProjects: Set<RushConfigurationProject>;\n  private _docMap: Map<string, Lockfile | LockfileV6>;\n\n  public constructor(parser: LintCommandLineParser) {\n    super({\n      actionName: 'check',\n      summary: 'Check and report dependency issues in your workspace',\n      documentation:\n        'This command applies the policies that are configured in ' +\n        LOCKFILE_LINT_JSON_FILENAME +\n        ', reporting any problems found in your PNPM workspace.'\n    });\n\n    this._terminal = parser.globalTerminal;\n    this._checkedProjects = new Set();\n    this._docMap = new Map();\n  }\n\n  private async _checkVersionCompatibilityAsync(\n    shrinkwrapFileMajorVersion: number,\n    packages: Lockfile['packages'],\n    dependencyPath: string,\n    requiredVersions: Record<string, string>,\n    checkedDependencyPaths: Set<string>\n  ): Promise<void> {\n    if (packages && packages[dependencyPath] && !checkedDependencyPaths.has(dependencyPath)) {\n      checkedDependencyPaths.add(dependencyPath);\n      const { name, version } = parseDependencyPath(shrinkwrapFileMajorVersion, dependencyPath);\n      if (name in requiredVersions && !semver.satisfies(version, requiredVersions[name])) {\n        throw new Error(\n          `The version of \"${name}\" should match \"${requiredVersions[name]}\";` +\n            ` actual version is \"${version}\"`\n        );\n      }\n\n      await Promise.all(\n        Object.entries(packages[dependencyPath].dependencies ?? {}).map(\n          async ([dependencyPackageName, dependencyPackageVersion]) => {\n            await this._checkVersionCompatibilityAsync(\n              shrinkwrapFileMajorVersion,\n              packages,\n              splicePackageWithVersion(\n                shrinkwrapFileMajorVersion,\n                dependencyPackageName,\n                dependencyPackageVersion\n              ),\n              requiredVersions,\n              checkedDependencyPaths\n            );\n          }\n        )\n      );\n    }\n  }\n\n  private async _searchAndValidateDependenciesAsync(\n    project: RushConfigurationProject,\n    requiredVersions: Record<string, string>\n  ): Promise<void> {\n    this._terminal.writeLine(`Checking project \"${project.packageName}\"`);\n\n    const projectFolder: string = project.projectFolder;\n    const subspace: Subspace = project.subspace;\n    const shrinkwrapFilename: string = subspace.getCommittedShrinkwrapFilename();\n    let doc: Lockfile | LockfileV6;\n    if (this._docMap.has(shrinkwrapFilename)) {\n      doc = this._docMap.get(shrinkwrapFilename)!;\n    } else {\n      const pnpmLockfileText: string = await FileSystem.readFileAsync(shrinkwrapFilename);\n      doc = yaml.load(pnpmLockfileText) as Lockfile | LockfileV6;\n      this._docMap.set(shrinkwrapFilename, doc);\n    }\n    const { importers, lockfileVersion, packages } = doc;\n    const shrinkwrapFileMajorVersion: number = getShrinkwrapFileMajorVersion(lockfileVersion);\n    const checkedDependencyPaths: Set<string> = new Set<string>();\n\n    await Promise.all(\n      Object.entries(importers).map(async ([relativePath, { dependencies }]) => {\n        if (path.resolve(projectFolder, relativePath) === projectFolder) {\n          const dependenciesEntries = Object.entries(dependencies ?? {});\n          for (const [dependencyName, dependencyValue] of dependenciesEntries) {\n            const fullDependencyPath = splicePackageWithVersion(\n              shrinkwrapFileMajorVersion,\n              dependencyName,\n              typeof dependencyValue === 'string'\n                ? dependencyValue\n                : (\n                    dependencyValue as {\n                      version: string;\n                      specifier: string;\n                    }\n                  ).version\n            );\n            if (fullDependencyPath.includes('link:')) {\n              const dependencyProject: RushConfigurationProject | undefined =\n                this._rushConfiguration.getProjectByName(dependencyName);\n              if (dependencyProject && !this._checkedProjects?.has(dependencyProject)) {\n                this._checkedProjects!.add(project);\n                await this._searchAndValidateDependenciesAsync(dependencyProject, requiredVersions);\n              }\n            } else {\n              await this._checkVersionCompatibilityAsync(\n                shrinkwrapFileMajorVersion,\n                packages,\n                fullDependencyPath,\n                requiredVersions,\n                checkedDependencyPaths\n              );\n            }\n          }\n        }\n      })\n    );\n  }\n\n  private async _performVersionRestrictionCheckAsync(\n    requiredVersions: Record<string, string>,\n    projectName: string\n  ): Promise<string | undefined> {\n    try {\n      const project: RushConfigurationProject | undefined =\n        this._rushConfiguration?.getProjectByName(projectName);\n      if (!project) {\n        throw new Error(\n          `Specified project \"${projectName}\" does not exist in ${LOCKFILE_LINT_JSON_FILENAME}`\n        );\n      }\n      this._checkedProjects.add(project);\n      await this._searchAndValidateDependenciesAsync(project, requiredVersions);\n      return undefined;\n    } catch (e) {\n      return e.message;\n    }\n  }\n\n  protected async onExecute(): 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    this._rushConfiguration = rushConfiguration!;\n\n    const lintingFile: string = path.resolve(\n      this._rushConfiguration.commonFolder,\n      'config',\n      LOCKFILE_EXPLORER_FOLDERNAME,\n      LOCKFILE_LINT_JSON_FILENAME\n    );\n    const { rules }: ILockfileLint = await JsonFile.loadAndValidateAsync(\n      lintingFile,\n      JsonSchema.fromLoadedObject(lockfileLintSchema)\n    );\n    const issues: ILintIssue[] = [];\n    await Async.forEachAsync(\n      rules,\n      async ({ requiredVersions, project, rule }) => {\n        switch (rule) {\n          case 'restrict-versions': {\n            const message: string | undefined = await this._performVersionRestrictionCheckAsync(\n              requiredVersions,\n              project\n            );\n            if (message) {\n              issues.push({ project, rule, message });\n            }\n            break;\n          }\n\n          default: {\n            throw new Error('Unsupported rule name: ' + rule);\n          }\n        }\n      },\n      { concurrency: 50 }\n    );\n    if (issues.length > 0) {\n      this._terminal.writeLine();\n\n      // Deterministic order\n      for (const issue of issues.sort((a, b): number => {\n        let diff: number = a.project.localeCompare(b.project);\n        if (diff !== 0) {\n          return diff;\n        }\n        diff = a.rule.localeCompare(b.rule);\n        if (diff !== 0) {\n          return diff;\n        }\n        return a.message.localeCompare(b.message);\n      })) {\n        this._terminal.writeLine(\n          Colorize.red('PROBLEM: ') + Colorize.cyan(`[${issue.rule}] `) + issue.message + '\\n'\n        );\n      }\n\n      throw new AlreadyReportedError();\n    }\n    this._terminal.writeLine(Colorize.green('SUCCESS: ') + 'All checks passed.');\n  }\n}\n"]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"InitAction.d.ts","sourceRoot":"","sources":["../../../../src/cli/lint/actions/InitAction.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAO/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;cAWhC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CA8B3C"}