[rush] New commands "rush link-package" and "rush bridge-package" (#5123)

* fix: ci

* chore: add lockfileid field

* chore: optimize logic

* fix: rush-link-state.json

* feat: disable cache

* fix: ci

* fix: use version parameter

* fix: ci

* fix: use semver to verify version

* Improve CLI docs and add EXPERIMENTAL notices

* replace BaseConnectPackageAction with BaseSymlinkPackageAction

---------

Co-authored-by: Pete Gonzalez <4673363+octogonz@users.noreply.github.com>

Author: L-Qun

common/changes/@microsoft/rush/feat-link-bridge-package_2025-02-22-12-46.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@microsoft/rush",
+      "comment": "(EXPERIMENTAL) Add new commands `rush link-package` and `rush bridge-package`",
+      "type": "none"
+    }
+  ],
+  "packageName": "@microsoft/rush"
+}

common/config/subspaces/build-tests-subspace/pnpm-lock.yaml

@@ -1,6 +1,6 @@
 // DO NOT MODIFY THIS FILE MANUALLY BUT DO COMMIT IT. It is generated and used by Rush.
 {
-  "pnpmShrinkwrapHash": "b48c35b584583839e5d4a9e651d78a779d206b2e",
+  "pnpmShrinkwrapHash": "716e6139e542e55da15871cb4113731bf70cf760",
   "preferredVersionsHash": "54149ea3f01558a859c96dee2052b797d4defe68",
-  "packageJsonInjectedDependenciesHash": "a8af9805efae30377fcf83e1a927721f67381aee"
+  "packageJsonInjectedDependenciesHash": "eddee15297dd4196faa2367de41611da04489b5b"
 }

common/config/subspaces/build-tests-subspace/repo-state.json

@@ -1,5 +1,5 @@
 // DO NOT MODIFY THIS FILE MANUALLY BUT DO COMMIT IT. It is generated and used by Rush.
 {
-  "pnpmShrinkwrapHash": "0ca686868eb1f0b230c0067e17c8e408fc3eafd4",
+  "pnpmShrinkwrapHash": "1091197f5a37dd2e4f7446671c2f57d872d06340",
   "preferredVersionsHash": "54149ea3f01558a859c96dee2052b797d4defe68"
 }

common/config/subspaces/default/pnpm-lock.yaml

@@ -1372,6 +1372,7 @@ export class RushConstants {
     // @deprecated
     static readonly pinnedVersionsFilename: 'pinned-versions.json';
     static readonly pnpmConfigFilename: 'pnpm-config.json';
+    static readonly pnpmDependenciesFolderName: '.pnpm';
     static readonly pnpmfileGlobalFilename: 'global-pnpmfile.cjs';
     static readonly pnpmfileV1Filename: 'pnpmfile.js';
     static readonly pnpmfileV6Filename: '.pnpmfile.cjs';
@@ -1386,6 +1387,7 @@ export class RushConstants {
     static readonly repoStateFilename: 'repo-state.json';
     static readonly rushAlertsConfigFilename: 'rush-alerts.json';
     static readonly rushJsonFilename: 'rush.json';
+    static readonly rushLinkStateFilename: 'rush-link-state.json';
     static readonly rushLogsFolderName: 'rush-logs';
     static readonly rushPackageName: '@microsoft/rush';
     static readonly rushPluginManifestFilename: 'rush-plugin-manifest.json';

common/config/subspaces/default/repo-state.json

@@ -64,7 +64,7 @@
     "tar": "~6.2.1",
     "true-case-path": "~2.2.1",
     "uuid": "~8.3.2",
-    "pnpm-sync-lib": "0.2.9"
+    "pnpm-sync-lib": "0.3.0"
   },
   "devDependencies": {
     "@pnpm/lockfile.types": "~1.0.3",

common/reviews/api/rush-lib.api.md

@@ -12,6 +12,8 @@ import type { IPhase } from './CommandLineConfiguration';
 import { OverlappingPathAnalyzer } from '../utilities/OverlappingPathAnalyzer';
 import schemaJson from '../schemas/rush-project.schema.json';
 import anythingSchemaJson from '../schemas/rush-project.schema.json';
+import { RushConnect } from '../utilities/RushConnect';
+import type { RushConfiguration } from './RushConfiguration';
 
 /**
  * Describes the file structure for the `<project root>/config/rush-project.json` config file.
@@ -345,6 +347,15 @@ export class RushProjectConfiguration {
     phaseName: string,
     isNoOp: boolean
   ): string | undefined {
+    const rushConfiguration: RushConfiguration | undefined = this.project.rushConfiguration;
+    if (rushConfiguration) {
+      const rushConnect: RushConnect = RushConnect.loadFromLinkStateFile(rushConfiguration);
+      const subspaceNameList: string[] = Object.keys(rushConnect.rushLinkState ?? {});
+      if (subspaceNameList.includes(this.project.subspace.subspaceName)) {
+        return 'Caching has been disabled for this project because it is a linked package.';
+      }
+    }
+
     // Skip no-op operations as they won't have any output/cacheable things.
     if (isNoOp) {
       return undefined;

libraries/rush-lib/package.json

@@ -1137,6 +1137,56 @@ Object {
         },
       ],
     },
+    Object {
+      "actionName": "bridge-package",
+      "parameters": Array [
+        Object {
+          "description": "The folder path of a locally built project, whose installation will be simulated using node_modules symlinks.  This folder will be the target of the symlinks.",
+          "environmentVariable": undefined,
+          "kind": "String",
+          "longName": "--path",
+          "required": true,
+          "shortName": undefined,
+        },
+        Object {
+          "description": "A list of Rush project names to connect to the external package. If not specified, uses the project in the current working directory.",
+          "environmentVariable": undefined,
+          "kind": "StringList",
+          "longName": "--project",
+          "required": false,
+          "shortName": undefined,
+        },
+        Object {
+          "description": "It will directly replace the output for the specified version of the package, which requires you to have that package installed under the specified name in advance.",
+          "environmentVariable": undefined,
+          "kind": "String",
+          "longName": "--version",
+          "required": false,
+          "shortName": undefined,
+        },
+      ],
+    },
+    Object {
+      "actionName": "link-package",
+      "parameters": Array [
+        Object {
+          "description": "The folder path of a locally built project, whose installation will be simulated using node_modules symlinks.  This folder will be the target of the symlinks.",
+          "environmentVariable": undefined,
+          "kind": "String",
+          "longName": "--path",
+          "required": true,
+          "shortName": undefined,
+        },
+        Object {
+          "description": "A list of Rush project names to connect to the external package. If not specified, uses the project in the current working directory.",
+          "environmentVariable": undefined,
+          "kind": "StringList",
+          "longName": "--project",
+          "required": false,
+          "shortName": undefined,
+        },
+      ],
+    },
     Object {
       "actionName": "import-strings",
       "parameters": Array [

libraries/rush-lib/src/api/RushProjectConfiguration.ts

@@ -62,6 +62,8 @@ import type { IBuiltInPluginConfiguration } from '../pluginFramework/PluginLoade
 import { InitSubspaceAction } from './actions/InitSubspaceAction';
 import { RushAlerts } from '../utilities/RushAlerts';
 import { InstallAutoinstallerAction } from './actions/InstallAutoinstallerAction';
+import { LinkPackageAction } from './actions/LinkPackageAction';
+import { BridgePackageAction } from './actions/BridgePackageAction';
 
 /**
  * Options for `RushCommandLineParser`.
@@ -331,6 +333,8 @@ export class RushCommandLineParser extends CommandLineParser {
       this.addAction(new UpgradeInteractiveAction(this));
       this.addAction(new VersionAction(this));
       this.addAction(new AlertAction(this));
+      this.addAction(new BridgePackageAction(this));
+      this.addAction(new LinkPackageAction(this));
 
       this._populateScriptActions();
     } catch (error) {