[rush-resolver-cache-plugin] Fix file: dependency context resolution mismatch (pnpm v9/v10) (#5802)

* fix: normalize file dependency key resolution

* test: cover additional file dependency key edge cases

* refactor: extract repeated specifier strings into variables in tests

* chore: add changefile for resolver cache plugin file: fix

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>

Author: Copilot

common/changes/@microsoft/rush/pr-5802_2026-08-13-00-09-36.json

@@ -0,0 +1,11 @@
+{
+  "changes": [
+    {
+      "comment": "Fix `file:` dependency context resolution to use canonical dependency keys for pnpm v9/v10.",
+      "type": "patch",
+      "packageName": "@microsoft/rush"
+    }
+  ],
+  "packageName": "@microsoft/rush",
+  "email": "5100938+bmiddha@users.noreply.github.com"
+}

rush-plugins/rush-resolver-cache-plugin/src/helpers.ts

@@ -31,7 +31,10 @@ export function resolveDependencyKey(
       specifier.slice(5)
     );
   } else if (specifier.startsWith('file:')) {
-    return getDescriptionFileRootFromKey(lockfileFolder, specifier, helpers.depPathToFilename, key);
+    const resolvedKey: string = packageKeys?.has(specifier)
+      ? specifier
+      : helpers.buildDependencyKey(key, specifier);
+    return getDescriptionFileRootFromKey(lockfileFolder, resolvedKey, helpers.depPathToFilename, key);
   } else {
     const resolvedKey: string = packageKeys?.has(specifier)
       ? specifier

rush-plugins/rush-resolver-cache-plugin/src/test/helpers.test.ts

@@ -282,10 +282,11 @@ describe(resolveDependencyKey.name, () => {
   });
 
   it('resolves link: specifier for project context', () => {
+    const specifier: string = 'link:../bar';
     const result: string = resolveDependencyKey(
       lockfileFolder,
       'bar',
-      'link:../bar',
+      specifier,
       makeProjectContext(),
       v9Helpers
     );
@@ -294,10 +295,11 @@ describe(resolveDependencyKey.name, () => {
   });
 
   it('resolves link: specifier for non-project context', () => {
+    const specifier: string = 'link:../bar';
     const result: string = resolveDependencyKey(
       lockfileFolder,
       'bar',
-      'link:../bar',
+      specifier,
       makePackageContext(),
       v9Helpers
     );
@@ -306,23 +308,82 @@ describe(resolveDependencyKey.name, () => {
   });
 
   it('resolves file: specifier', () => {
+    const specifier: string = 'file:../../../rigs/local-node-rig';
     const result: string = resolveDependencyKey(
       lockfileFolder,
       'my-rig',
-      'file:../../../rigs/local-node-rig',
+      specifier,
       makeProjectContext(),
       v9Helpers
     );
     expect(result).toContain('node_modules/.pnpm/');
     expect(result).toContain('/node_modules/my-rig');
   });
 
+  it('resolves file: specifier using canonical dependency key shape', () => {
+    const specifier: string =
+      'file:../../a/b/c/my-local-package-1.0.0.tgz(react-dom@17.0.1(react@17.0.1))(react@17.0.1)';
+    const result: string = resolveDependencyKey(
+      lockfileFolder,
+      'my-local-package',
+      specifier,
+      makeProjectContext(),
+      v9Helpers
+    );
+    const expected: string = getDescriptionFileRootFromKey(
+      lockfileFolder,
+      v9Helpers.buildDependencyKey('my-local-package', specifier),
+      v9Helpers.depPathToFilename,
+      'my-local-package'
+    );
+    expect(result).toBe(expected);
+  });
+
+  it('resolves file: specifier using canonical dependency key shape (v8)', () => {
+    const specifier: string = 'file:../../../rigs/local-node-rig';
+    const result: string = resolveDependencyKey(
+      lockfileFolder,
+      'my-rig',
+      specifier,
+      makeProjectContext(),
+      v8Helpers
+    );
+    const expected: string = getDescriptionFileRootFromKey(
+      lockfileFolder,
+      v8Helpers.buildDependencyKey('my-rig', specifier),
+      v8Helpers.depPathToFilename,
+      'my-rig'
+    );
+    expect(result).toBe(expected);
+  });
+
+  it('uses file: specifier directly when packageKeys already contains it', () => {
+    const specifier: string = 'file:../../../rigs/local-node-rig';
+    const packageKeys: Set<string> = new Set([specifier]);
+    const result: string = resolveDependencyKey(
+      lockfileFolder,
+      'my-rig',
+      specifier,
+      makeProjectContext(),
+      v9Helpers,
+      packageKeys
+    );
+    const expected: string = getDescriptionFileRootFromKey(
+      lockfileFolder,
+      specifier,
+      v9Helpers.depPathToFilename,
+      'my-rig'
+    );
+    expect(result).toBe(expected);
+  });
+
   it('resolves specifier found in packageKeys (v6)', () => {
-    const packageKeys: Set<string> = new Set(['/autoprefixer@9.8.8']);
+    const specifier: string = '/autoprefixer@9.8.8';
+    const packageKeys: Set<string> = new Set([specifier]);
     const result: string = resolveDependencyKey(
       lockfileFolder,
       'autoprefixer',
-      '/autoprefixer@9.8.8',
+      specifier,
       makeProjectContext(),
       v8Helpers,
       packageKeys
@@ -332,11 +393,12 @@ describe(resolveDependencyKey.name, () => {
   });
 
   it('resolves specifier found in packageKeys (v9)', () => {
-    const packageKeys: Set<string> = new Set(['autoprefixer@9.8.8']);
+    const specifier: string = 'autoprefixer@9.8.8';
+    const packageKeys: Set<string> = new Set([specifier]);
     const result: string = resolveDependencyKey(
       lockfileFolder,
       'autoprefixer',
-      'autoprefixer@9.8.8',
+      specifier,
       makeProjectContext(),
       v9Helpers,
       packageKeys
@@ -346,10 +408,11 @@ describe(resolveDependencyKey.name, () => {
   });
 
   it('builds dependency key for plain version specifiers (v9)', () => {
+    const specifier: string = '9.8.8';
     const result: string = resolveDependencyKey(
       lockfileFolder,
       'autoprefixer',
-      '9.8.8',
+      specifier,
       makeProjectContext(),
       v9Helpers
     );
@@ -358,10 +421,11 @@ describe(resolveDependencyKey.name, () => {
   });
 
   it('builds dependency key for plain version specifiers (v8)', () => {
+    const specifier: string = '9.8.8';
     const result: string = resolveDependencyKey(
       lockfileFolder,
       'autoprefixer',
-      '9.8.8',
+      specifier,
       makeProjectContext(),
       v8Helpers
     );