@yarnpkg/plugin-essentials 4.0.0-rc.5 → 4.0.0-rc.51

package/lib/commands/install.js

@@ -7,7 +7,21 @@ const fslib_1 = require("@yarnpkg/fslib");
 const parsers_1 = require("@yarnpkg/parsers");
 const ci_info_1 = tslib_1.__importDefault(require("ci-info"));
 const clipanion_1 = require("clipanion");
+const semver_1 = tslib_1.__importDefault(require("semver"));
 const t = tslib_1.__importStar(require("typanion"));
+const LOCKFILE_MIGRATION_RULES = [{
+        selector: v => v === -1,
+        name: `nodeLinker`,
+        value: `node-modules`,
+    }, {
+        selector: v => v !== -1 && v < 8,
+        name: `enableGlobalCache`,
+        value: false,
+    }, {
+        selector: v => v !== -1 && v < 8,
+        name: `compressionLevel`,
+        value: `mixed`,
+    }];
 // eslint-disable-next-line arca/no-default-export
 class YarnCommand extends cli_1.BaseCommand {
     constructor() {
@@ -49,7 +63,6 @@ class YarnCommand extends cli_1.BaseCommand {
         this.networkTimeout = clipanion_1.Option.String(`--network-timeout`, { hidden: true });
     }
     async execute() {
-        var _a, _b, _c;
         const configuration = await core_1.Configuration.find(this.context.cwd, this.context.plugins);
         if (typeof this.inlineBuilds !== `undefined`)
             configuration.useWithSource(`<cli>`, { enableInlineBuilds: this.inlineBuilds }, configuration.startingCwd, { overwrite: true });
@@ -163,7 +176,7 @@ class YarnCommand extends cli_1.BaseCommand {
         const updateMode = this.mode === core_1.InstallMode.UpdateLockfile;
         if (updateMode && (this.immutable || this.immutableCache))
             throw new clipanion_1.UsageError(`${core_1.formatUtils.pretty(configuration, `--immutable`, core_1.formatUtils.Type.CODE)} and ${core_1.formatUtils.pretty(configuration, `--immutable-cache`, core_1.formatUtils.Type.CODE)} cannot be used with ${core_1.formatUtils.pretty(configuration, `--mode=update-lockfile`, core_1.formatUtils.Type.CODE)}`);
-        const immutable = ((_a = this.immutable) !== null && _a !== void 0 ? _a : configuration.get(`enableImmutableInstalls`)) && !updateMode;
+        const immutable = (this.immutable ?? configuration.get(`enableImmutableInstalls`)) && !updateMode;
         const immutableCache = this.immutableCache && !updateMode;
         if (configuration.projectCwd !== null) {
             const fixReport = await core_1.StreamReport.start({
@@ -172,8 +185,16 @@ class YarnCommand extends cli_1.BaseCommand {
                 stdout: this.context.stdout,
                 includeFooter: false,
             }, async (report) => {
+                let changed = false;
+                if (await autofixLegacyPlugins(configuration, immutable)) {
+                    report.reportInfo(core_1.MessageName.AUTOMERGE_SUCCESS, `Automatically removed core plugins that are now builtins 👍`);
+                    changed = true;
+                }
                 if (await autofixMergeConflicts(configuration, immutable)) {
                     report.reportInfo(core_1.MessageName.AUTOMERGE_SUCCESS, `Automatically fixed merge conflicts 👍`);
+                    changed = true;
+                }
+                if (changed) {
                     report.reportSeparator();
                 }
             });
@@ -181,34 +202,6 @@ class YarnCommand extends cli_1.BaseCommand {
                 return fixReport.exitCode();
             }
         }
-        if (configuration.projectCwd !== null && typeof configuration.sources.get(`nodeLinker`) === `undefined`) {
-            const projectCwd = configuration.projectCwd;
-            let content;
-            try {
-                content = await fslib_1.xfs.readFilePromise(fslib_1.ppath.join(projectCwd, fslib_1.Filename.lockfile), `utf8`);
-            }
-            catch { }
-            // If migrating from a v1 install, we automatically enable the node-modules linker,
-            // since that's likely what the author intended to do.
-            if (content === null || content === void 0 ? void 0 : content.includes(`yarn lockfile v1`)) {
-                const nmReport = await core_1.StreamReport.start({
-                    configuration,
-                    json: this.json,
-                    stdout: this.context.stdout,
-                    includeFooter: false,
-                }, async (report) => {
-                    report.reportInfo(core_1.MessageName.AUTO_NM_SUCCESS, `Migrating from Yarn 1; automatically enabling the compatibility node-modules linker 👍`);
-                    report.reportSeparator();
-                    configuration.use(`<compat>`, { nodeLinker: `node-modules` }, projectCwd, { overwrite: true });
-                    await core_1.Configuration.updateConfiguration(projectCwd, {
-                        nodeLinker: `node-modules`,
-                    });
-                });
-                if (nmReport.hasErrors()) {
-                    return nmReport.exitCode();
-                }
-            }
-        }
         if (configuration.projectCwd !== null) {
             const telemetryReport = await core_1.StreamReport.start({
                 configuration,
@@ -216,18 +209,72 @@ class YarnCommand extends cli_1.BaseCommand {
                 stdout: this.context.stdout,
                 includeFooter: false,
             }, async (report) => {
-                var _a;
-                if ((_a = core_1.Configuration.telemetry) === null || _a === void 0 ? void 0 : _a.isNew) {
+                if (core_1.Configuration.telemetry?.isNew) {
+                    core_1.Configuration.telemetry.commitTips();
                     report.reportInfo(core_1.MessageName.TELEMETRY_NOTICE, `Yarn will periodically gather anonymous telemetry: https://yarnpkg.com/advanced/telemetry`);
                     report.reportInfo(core_1.MessageName.TELEMETRY_NOTICE, `Run ${core_1.formatUtils.pretty(configuration, `yarn config set --home enableTelemetry 0`, core_1.formatUtils.Type.CODE)} to disable`);
                     report.reportSeparator();
                 }
+                else if (core_1.Configuration.telemetry?.shouldShowTips) {
+                    const data = await core_1.httpUtils.get(`https://repo.yarnpkg.com/tags`, { configuration, jsonResponse: true }).catch(() => null);
+                    if (data !== null) {
+                        let newVersion = null;
+                        if (core_1.YarnVersion !== null) {
+                            const isRcBinary = semver_1.default.prerelease(core_1.YarnVersion);
+                            const releaseType = isRcBinary ? `canary` : `stable`;
+                            const candidate = data.latest[releaseType];
+                            if (semver_1.default.gt(candidate, core_1.YarnVersion)) {
+                                newVersion = [releaseType, candidate];
+                            }
+                        }
+                        if (newVersion) {
+                            core_1.Configuration.telemetry.commitTips();
+                            report.reportInfo(core_1.MessageName.VERSION_NOTICE, `${core_1.formatUtils.applyStyle(configuration, `A new ${newVersion[0]} version of Yarn is available:`, core_1.formatUtils.Style.BOLD)} ${core_1.structUtils.prettyReference(configuration, newVersion[1])}!`);
+                            report.reportInfo(core_1.MessageName.VERSION_NOTICE, `Upgrade now by running ${core_1.formatUtils.pretty(configuration, `yarn set version ${newVersion[1]}`, core_1.formatUtils.Type.CODE)}`);
+                            report.reportSeparator();
+                        }
+                        else {
+                            const tip = core_1.Configuration.telemetry.selectTip(data.tips);
+                            if (tip) {
+                                report.reportInfo(core_1.MessageName.TIPS_NOTICE, core_1.formatUtils.pretty(configuration, tip.message, core_1.formatUtils.Type.MARKDOWN_INLINE));
+                                if (tip.url)
+                                    report.reportInfo(core_1.MessageName.TIPS_NOTICE, `Learn more at ${tip.url}`);
+                                report.reportSeparator();
+                            }
+                        }
+                    }
+                }
             });
             if (telemetryReport.hasErrors()) {
                 return telemetryReport.exitCode();
             }
         }
         const { project, workspace } = await core_1.Project.find(configuration, this.context.cwd);
+        const lockfileLastVersion = project.lockfileLastVersion;
+        if (lockfileLastVersion !== null) {
+            const compatReport = await core_1.StreamReport.start({
+                configuration,
+                json: this.json,
+                stdout: this.context.stdout,
+                includeFooter: false,
+            }, async (report) => {
+                const newSettings = {};
+                for (const rule of LOCKFILE_MIGRATION_RULES) {
+                    if (rule.selector(lockfileLastVersion) && typeof configuration.sources.get(rule.name) === `undefined`) {
+                        configuration.use(`<compat>`, { [rule.name]: rule.value }, project.cwd, { overwrite: true });
+                        newSettings[rule.name] = rule.value;
+                    }
+                }
+                if (Object.keys(newSettings).length > 0) {
+                    await core_1.Configuration.updateConfiguration(project.cwd, newSettings);
+                    report.reportInfo(core_1.MessageName.MIGRATION_SUCCESS, `Migrated your project to the latest Yarn version 🚀`);
+                    report.reportSeparator();
+                }
+            });
+            if (compatReport.hasErrors()) {
+                return compatReport.exitCode();
+            }
+        }
         const cache = await core_1.Cache.find(configuration, { immutable: immutableCache, check: this.checkCache });
         if (!workspace)
             throw new cli_1.WorkspaceRequiredError(project.cwd, this.context.cwd);
@@ -235,9 +282,9 @@ class YarnCommand extends cli_1.BaseCommand {
             restoreResolutions: false,
         });
         const enableHardenedMode = configuration.get(`enableHardenedMode`);
-        if ((_b = this.refreshLockfile) !== null && _b !== void 0 ? _b : enableHardenedMode)
+        if (this.refreshLockfile ?? enableHardenedMode)
             project.lockfileNeedsRefresh = true;
-        const checkResolutions = (_c = this.checkResolutions) !== null && _c !== void 0 ? _c : enableHardenedMode;
+        const checkResolutions = this.checkResolutions ?? enableHardenedMode;
         // Important: Because other commands also need to run installs, if you
         // get in a situation where you need to change this file in order to
         // customize the install it's very likely you're doing something wrong.
@@ -245,18 +292,17 @@ class YarnCommand extends cli_1.BaseCommand {
         // install logic should be implemented elsewhere (probably in either of
         // the Configuration and Install classes). Feel free to open an issue
         // in order to ask for design feedback before writing features.
-        const report = await core_1.StreamReport.start({
-            configuration,
+        return await project.installWithNewReport({
             json: this.json,
             stdout: this.context.stdout,
-            includeLogs: true,
-        }, async (report) => {
-            await project.install({ cache, report, immutable, checkResolutions, mode: this.mode });
+        }, {
+            cache,
+            immutable,
+            checkResolutions,
+            mode: this.mode,
         });
-        return report.exitCode();
     }
 }
-exports.default = YarnCommand;
 YarnCommand.paths = [
     [`install`],
     clipanion_1.Command.Default,
@@ -288,7 +334,7 @@ YarnCommand.usage = clipanion_1.Command.Usage({
 
       If the \`--mode=<mode>\` option is set, Yarn will change which artifacts are generated. The modes currently supported are:
 
-      - \`skip-build\` will not run the build scripts at all. Note that this is different from setting \`enableScripts\` to false because the later will disable build scripts, and thus affect the content of the artifacts generated on disk, whereas the former will just disable the build step - but not the scripts themselves, which just won't run.
+      - \`skip-build\` will not run the build scripts at all. Note that this is different from setting \`enableScripts\` to false because the latter will disable build scripts, and thus affect the content of the artifacts generated on disk, whereas the former will just disable the build step - but not the scripts themselves, which just won't run.
 
       - \`update-lockfile\` will skip the link step altogether, and only fetch packages that are missing from the lockfile (or that have no associated checksums). This mode is typically used by tools like Renovate or Dependabot to keep a lockfile up-to-date without incurring the full install cost.
     `,
@@ -303,14 +349,12 @@ YarnCommand.usage = clipanion_1.Command.Usage({
             `$0 install --immutable --immutable-cache --check-cache`,
         ]],
 });
-const MERGE_CONFLICT_ANCESTOR = `|||||||`;
-const MERGE_CONFLICT_END = `>>>>>>>`;
-const MERGE_CONFLICT_SEP = `=======`;
+exports.default = YarnCommand;
 const MERGE_CONFLICT_START = `<<<<<<<`;
 async function autofixMergeConflicts(configuration, immutable) {
     if (!configuration.projectCwd)
         return false;
-    const lockfilePath = fslib_1.ppath.join(configuration.projectCwd, configuration.get(`lockfileFilename`));
+    const lockfilePath = fslib_1.ppath.join(configuration.projectCwd, fslib_1.Filename.lockfile);
     if (!await fslib_1.xfs.existsPromise(lockfilePath))
         return false;
     const file = await fslib_1.xfs.readFilePromise(lockfilePath, `utf8`);
@@ -318,22 +362,74 @@ async function autofixMergeConflicts(configuration, immutable) {
         return false;
     if (immutable)
         throw new core_1.ReportError(core_1.MessageName.AUTOMERGE_IMMUTABLE, `Cannot autofix a lockfile when running an immutable install`);
-    const [left, right] = getVariants(file);
-    let parsedLeft;
-    let parsedRight;
-    try {
-        parsedLeft = (0, parsers_1.parseSyml)(left);
-        parsedRight = (0, parsers_1.parseSyml)(right);
+    let commits = await core_1.execUtils.execvp(`git`, [`rev-parse`, `MERGE_HEAD`, `HEAD`], {
+        cwd: configuration.projectCwd,
+    });
+    if (commits.code !== 0) {
+        commits = await core_1.execUtils.execvp(`git`, [`rev-parse`, `REBASE_HEAD`, `HEAD`], {
+            cwd: configuration.projectCwd,
+        });
     }
-    catch (error) {
-        throw new core_1.ReportError(core_1.MessageName.AUTOMERGE_FAILED_TO_PARSE, `The individual variants of the lockfile failed to parse`);
+    if (commits.code !== 0) {
+        commits = await core_1.execUtils.execvp(`git`, [`rev-parse`, `CHERRY_PICK_HEAD`, `HEAD`], {
+            cwd: configuration.projectCwd,
+        });
     }
-    const merged = {
-        ...parsedLeft,
-        ...parsedRight,
-    };
+    if (commits.code !== 0)
+        throw new core_1.ReportError(core_1.MessageName.AUTOMERGE_GIT_ERROR, `Git returned an error when trying to find the commits pertaining to the conflict`);
+    let variants = await Promise.all(commits.stdout.trim().split(/\n/).map(async (hash) => {
+        const content = await core_1.execUtils.execvp(`git`, [`show`, `${hash}:./${fslib_1.Filename.lockfile}`], {
+            cwd: configuration.projectCwd,
+        });
+        if (content.code !== 0)
+            throw new core_1.ReportError(core_1.MessageName.AUTOMERGE_GIT_ERROR, `Git returned an error when trying to access the lockfile content in ${hash}`);
+        try {
+            return (0, parsers_1.parseSyml)(content.stdout);
+        }
+        catch {
+            throw new core_1.ReportError(core_1.MessageName.AUTOMERGE_FAILED_TO_PARSE, `A variant of the conflicting lockfile failed to parse`);
+        }
+    }));
     // Old-style lockfiles should be filtered out (for example when switching
-    // from a Yarn 2 branch to a Yarn 1 branch). Fortunately (?), they actually
+    // from a Yarn 2 branch to a Yarn 1 branch).
+    variants = variants.filter(variant => {
+        return !!variant.__metadata;
+    });
+    for (const variant of variants) {
+        // Pre-lockfile v7, the entries weren't normalized (ie we had "foo@x.y.z"
+        // in the lockfile rather than "foo@npm:x.y.z")
+        if (variant.__metadata.version < 7) {
+            for (const key of Object.keys(variant)) {
+                if (key === `__metadata`)
+                    continue;
+                const descriptor = core_1.structUtils.parseDescriptor(key, true);
+                const normalizedDescriptor = configuration.normalizeDependency(descriptor);
+                const newKey = core_1.structUtils.stringifyDescriptor(normalizedDescriptor);
+                if (newKey !== key) {
+                    variant[newKey] = variant[key];
+                    delete variant[key];
+                }
+            }
+        }
+        // We encode the cacheKeys inside the checksums so that the reconciliation
+        // can merge the data together
+        for (const key of Object.keys(variant)) {
+            if (key === `__metadata`)
+                continue;
+            const checksum = variant[key].checksum;
+            if (typeof checksum === `string` && checksum.includes(`/`))
+                continue;
+            variant[key].checksum = `${variant.__metadata.cacheKey}/${checksum}`;
+        }
+    }
+    const merged = Object.assign({}, ...variants);
+    // We must keep the lockfile version as small as necessary to force Yarn to
+    // refresh the merged-in lockfile metadata that may be missing.
+    merged.__metadata.version = `${Math.min(...variants.map(variant => {
+        return parseInt(variant.__metadata.version ?? 0);
+    }))}`;
+    // It shouldn't matter, since the cacheKey have been embed within the checksums
+    merged.__metadata.cacheKey = `merged`;
     // parse as valid YAML except that the objects become strings. We can use
     // that to detect them. Damn, it's really ugly though.
     for (const [key, value] of Object.entries(merged))
@@ -344,52 +440,37 @@ async function autofixMergeConflicts(configuration, immutable) {
     });
     return true;
 }
-function getVariants(file) {
-    const variants = [[], []];
-    const lines = file.split(/\r?\n/g);
-    let skip = false;
-    while (lines.length > 0) {
-        const line = lines.shift();
-        if (typeof line === `undefined`)
-            throw new Error(`Assertion failed: Some lines should remain`);
-        if (line.startsWith(MERGE_CONFLICT_START)) {
-            // get the first variant
-            while (lines.length > 0) {
-                const conflictLine = lines.shift();
-                if (typeof conflictLine === `undefined`)
-                    throw new Error(`Assertion failed: Some lines should remain`);
-                if (conflictLine === MERGE_CONFLICT_SEP) {
-                    skip = false;
-                    break;
-                }
-                else if (skip || conflictLine.startsWith(MERGE_CONFLICT_ANCESTOR)) {
-                    skip = true;
-                    continue;
-                }
-                else {
-                    variants[0].push(conflictLine);
-                }
-            }
-            // get the second variant
-            while (lines.length > 0) {
-                const conflictLine = lines.shift();
-                if (typeof conflictLine === `undefined`)
-                    throw new Error(`Assertion failed: Some lines should remain`);
-                if (conflictLine.startsWith(MERGE_CONFLICT_END)) {
-                    break;
-                }
-                else {
-                    variants[1].push(conflictLine);
-                }
-            }
-        }
-        else {
-            variants[0].push(line);
-            variants[1].push(line);
-        }
-    }
-    return [
-        variants[0].join(`\n`),
-        variants[1].join(`\n`),
-    ];
+async function autofixLegacyPlugins(configuration, immutable) {
+    if (!configuration.projectCwd)
+        return false;
+    const legacyPlugins = [];
+    const yarnPluginDir = fslib_1.ppath.join(configuration.projectCwd, `.yarn/plugins/@yarnpkg`);
+    const changed = await core_1.Configuration.updateConfiguration(configuration.projectCwd, {
+        plugins: plugins => {
+            if (!Array.isArray(plugins))
+                return plugins;
+            const filteredPlugins = plugins.filter((plugin) => {
+                if (!plugin.path)
+                    return true;
+                const resolvedPath = fslib_1.ppath.resolve(configuration.projectCwd, plugin.path);
+                const isLegacy = core_1.LEGACY_PLUGINS.has(plugin.spec) && fslib_1.ppath.contains(yarnPluginDir, resolvedPath);
+                if (isLegacy)
+                    legacyPlugins.push(resolvedPath);
+                return !isLegacy;
+            });
+            if (filteredPlugins.length === 0)
+                return core_1.Configuration.deleteProperty;
+            if (filteredPlugins.length === plugins.length)
+                return plugins;
+            return filteredPlugins;
+        },
+    }, {
+        immutable,
+    });
+    if (!changed)
+        return false;
+    await Promise.all(legacyPlugins.map(async (pluginPath) => {
+        await fslib_1.xfs.removePromise(pluginPath);
+    }));
+    return true;
 }

package/lib/commands/link.d.ts

@@ -6,6 +6,6 @@ export default class LinkCommand extends BaseCommand {
     all: boolean;
     private: boolean;
     relative: boolean;
-    destination: string;
-    execute(): Promise<1 | 0>;
+    destinations: string[];
+    execute(): Promise<0 | 1>;
 }

package/lib/commands/link.js

@@ -9,15 +9,15 @@ class LinkCommand extends cli_1.BaseCommand {
     constructor() {
         super(...arguments);
         this.all = clipanion_1.Option.Boolean(`-A,--all`, false, {
-            description: `Link all workspaces belonging to the target project to the current one`,
+            description: `Link all workspaces belonging to the target projects to the current one`,
         });
         this.private = clipanion_1.Option.Boolean(`-p,--private`, false, {
-            description: `Also link private workspaces belonging to the target project to the current one`,
+            description: `Also link private workspaces belonging to the target projects to the current one`,
         });
         this.relative = clipanion_1.Option.Boolean(`-r,--relative`, false, {
             description: `Link workspaces using relative paths instead of absolute paths`,
         });
-        this.destination = clipanion_1.Option.String();
+        this.destinations = clipanion_1.Option.Rest();
     }
     async execute() {
         const configuration = await core_1.Configuration.find(this.context.cwd, this.context.plugins);
@@ -28,32 +28,38 @@ class LinkCommand extends cli_1.BaseCommand {
         await project.restoreInstallState({
             restoreResolutions: false,
         });
-        const absoluteDestination = fslib_1.ppath.resolve(this.context.cwd, fslib_1.npath.toPortablePath(this.destination));
-        const configuration2 = await core_1.Configuration.find(absoluteDestination, this.context.plugins, { useRc: false, strict: false });
-        const { project: project2, workspace: workspace2 } = await core_1.Project.find(configuration2, absoluteDestination);
-        if (project.cwd === project2.cwd)
-            throw new clipanion_1.UsageError(`Invalid destination; Can't link the project to itself`);
-        if (!workspace2)
-            throw new cli_1.WorkspaceRequiredError(project2.cwd, absoluteDestination);
         const topLevelWorkspace = project.topLevelWorkspace;
         const linkedWorkspaces = [];
-        if (this.all) {
-            for (const workspace of project2.workspaces)
-                if (workspace.manifest.name && (!workspace.manifest.private || this.private))
-                    linkedWorkspaces.push(workspace);
-            if (linkedWorkspaces.length === 0) {
-                throw new clipanion_1.UsageError(`No workspace found to be linked in the target project`);
+        for (const destination of this.destinations) {
+            const absoluteDestination = fslib_1.ppath.resolve(this.context.cwd, fslib_1.npath.toPortablePath(destination));
+            const configuration2 = await core_1.Configuration.find(absoluteDestination, this.context.plugins, { useRc: false, strict: false });
+            const { project: project2, workspace: workspace2 } = await core_1.Project.find(configuration2, absoluteDestination);
+            if (project.cwd === project2.cwd)
+                throw new clipanion_1.UsageError(`Invalid destination '${destination}'; Can't link the project to itself`);
+            if (!workspace2)
+                throw new cli_1.WorkspaceRequiredError(project2.cwd, absoluteDestination);
+            if (this.all) {
+                let found = false;
+                for (const workspace of project2.workspaces) {
+                    if (workspace.manifest.name && (!workspace.manifest.private || this.private)) {
+                        linkedWorkspaces.push(workspace);
+                        found = true;
+                    }
+                }
+                if (!found) {
+                    throw new clipanion_1.UsageError(`No workspace found to be linked in the target project: ${destination}`);
+                }
+            }
+            else {
+                if (!workspace2.manifest.name)
+                    throw new clipanion_1.UsageError(`The target workspace at '${destination}' doesn't have a name and thus cannot be linked`);
+                if (workspace2.manifest.private && !this.private)
+                    throw new clipanion_1.UsageError(`The target workspace at '${destination}' is marked private - use the --private flag to link it anyway`);
+                linkedWorkspaces.push(workspace2);
             }
-        }
-        else {
-            if (!workspace2.manifest.name)
-                throw new clipanion_1.UsageError(`The target workspace doesn't have a name and thus cannot be linked`);
-            if (workspace2.manifest.private && !this.private)
-                throw new clipanion_1.UsageError(`The target workspace is marked private - use the --private flag to link it anyway`);
-            linkedWorkspaces.push(workspace2);
         }
         for (const workspace of linkedWorkspaces) {
-            const fullName = core_1.structUtils.stringifyIdent(workspace.locator);
+            const fullName = core_1.structUtils.stringifyIdent(workspace.anchoredLocator);
             const target = this.relative
                 ? fslib_1.ppath.relative(project.cwd, workspace.cwd)
                 : workspace.cwd;
@@ -62,16 +68,13 @@ class LinkCommand extends cli_1.BaseCommand {
                 reference: `portal:${target}`,
             });
         }
-        const report = await core_1.StreamReport.start({
-            configuration,
+        return await project.installWithNewReport({
             stdout: this.context.stdout,
-        }, async (report) => {
-            await project.install({ cache, report });
+        }, {
+            cache,
         });
-        return report.exitCode();
     }
 }
-exports.default = LinkCommand;
 LinkCommand.paths = [
     [`link`],
 ];
@@ -81,10 +84,11 @@ LinkCommand.usage = clipanion_1.Command.Usage({
       This command will set a new \`resolutions\` field in the project-level manifest and point it to the workspace at the specified location (even if part of another project).
     `,
     examples: [[
-            `Register a remote workspace for use in the current project`,
-            `$0 link ~/ts-loader`,
+            `Register one or more remote workspaces for use in the current project`,
+            `$0 link ~/ts-loader ~/jest`,
         ], [
             `Register all workspaces from a remote project for use in the current project`,
             `$0 link ~/jest --all`,
         ]],
 });
+exports.default = LinkCommand;

package/lib/commands/node.js

@@ -12,7 +12,6 @@ class NodeCommand extends cli_1.BaseCommand {
         return this.cli.run([`exec`, `node`, ...this.args]);
     }
 }
-exports.default = NodeCommand;
 NodeCommand.paths = [
     [`node`],
 ];
@@ -28,3 +27,4 @@ NodeCommand.usage = clipanion_1.Command.Usage({
             `$0 node ./my-script.js`,
         ]],
 });
+exports.default = NodeCommand;

package/lib/commands/plugin/check.d.ts

@@ -0,0 +1,8 @@
+import { BaseCommand } from '@yarnpkg/cli';
+import { Usage } from 'clipanion';
+export default class PluginCheckCommand extends BaseCommand {
+    static paths: string[][];
+    static usage: Usage;
+    json: boolean;
+    execute(): Promise<0 | 1>;
+}

package/lib/commands/plugin/check.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("@yarnpkg/cli");
+const core_1 = require("@yarnpkg/core");
+const clipanion_1 = require("clipanion");
+// eslint-disable-next-line arca/no-default-export
+class PluginCheckCommand extends cli_1.BaseCommand {
+    constructor() {
+        super(...arguments);
+        this.json = clipanion_1.Option.Boolean(`--json`, false, {
+            description: `Format the output as an NDJSON stream`,
+        });
+    }
+    async execute() {
+        const configuration = await core_1.Configuration.find(this.context.cwd, this.context.plugins);
+        const rcFiles = await core_1.Configuration.findRcFiles(this.context.cwd);
+        const report = await core_1.StreamReport.start({
+            configuration,
+            json: this.json,
+            stdout: this.context.stdout,
+        }, async (report) => {
+            for (const rcFile of rcFiles) {
+                if (!rcFile.data?.plugins)
+                    continue;
+                for (const plugin of rcFile.data.plugins) {
+                    if (!plugin.checksum)
+                        continue;
+                    if (!plugin.spec.match(/^https?:/))
+                        continue;
+                    const newBuffer = await core_1.httpUtils.get(plugin.spec, { configuration });
+                    const newChecksum = core_1.hashUtils.makeHash(newBuffer);
+                    if (plugin.checksum === newChecksum)
+                        continue;
+                    const prettyPath = core_1.formatUtils.pretty(configuration, plugin.path, core_1.formatUtils.Type.PATH);
+                    const prettySpec = core_1.formatUtils.pretty(configuration, plugin.spec, core_1.formatUtils.Type.URL);
+                    const prettyMessage = `${prettyPath} is different from the file provided by ${prettySpec}`;
+                    report.reportJson({ ...plugin, newChecksum });
+                    report.reportError(core_1.MessageName.UNNAMED, prettyMessage);
+                }
+            }
+        });
+        return report.exitCode();
+    }
+}
+PluginCheckCommand.paths = [
+    [`plugin`, `check`],
+];
+PluginCheckCommand.usage = clipanion_1.Command.Usage({
+    category: `Plugin-related commands`,
+    description: `find all third-party plugins that differ from their own spec`,
+    details: `
+      Check only the plugins from https.
+
+      If this command detects any plugin differences in the CI environment, it will throw an error.
+    `,
+    examples: [[
+            `find all third-party plugins that differ from their own spec`,
+            `$0 plugin check`,
+        ]],
+});
+exports.default = PluginCheckCommand;

package/lib/commands/plugin/import/sources.d.ts

@@ -3,7 +3,7 @@ import { Report, CommandContext } from '@yarnpkg/core';
 import { Project } from '@yarnpkg/core';
 import { PortablePath } from '@yarnpkg/fslib';
 import { Usage } from 'clipanion';
-export default class PluginDlSourcesCommand extends BaseCommand {
+export default class PluginImportSourcesCommand extends BaseCommand {
     static paths: string[][];
     static usage: Usage;
     installPath: string | undefined;
@@ -12,9 +12,9 @@ export default class PluginDlSourcesCommand extends BaseCommand {
     noMinify: boolean;
     force: boolean;
     name: string;
-    execute(): Promise<1 | 0>;
+    execute(): Promise<0 | 1>;
 }
-export declare type BuildAndSavePluginsSpec = {
+export type BuildAndSavePluginsSpec = {
     context: CommandContext;
     noMinify: boolean;
 };