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

[Copilot]

Bug Fix

resolveDependencyKey() handled file: specifiers differently from package context key generation, producing non-matching .pnpm paths (missing name@ prefix + different hash input). This caused createContextSerializer to fail context lookups with Missing context and emit incomplete resolver cache entries for file: dependencies.

• What was the bug?

  file: dependencies from importer specifiers were resolved directly from raw file: strings, while package contexts were keyed from canonical dependency keys (name@file:... in v9/v10 lockfile format). The mismatch broke contexts.get(contextRoot).

• How did you fix it?

  Updated the file: branch in resolveDependencyKey() to follow the same canonical-key path as other specifiers:

  • Use packageKeys passthrough when the exact key exists.
  • Otherwise build the canonical key via helpers.buildDependencyKey(key, specifier).
  • Resolve path from that canonical key so dep-path filename generation and hashing align with package context generation.

  } else if (specifier.startsWith('file:')) {
    const resolvedKey: string = packageKeys?.has(specifier)
      ? specifier
      : helpers.buildDependencyKey(key, specifier);
    return getDescriptionFileRootFromKey(lockfileFolder, resolvedKey, helpers.depPathToFilename, key);
  }

• Testing

  Added targeted regression coverage in helpers.test.ts for:

  • pnpm v9/v10-style file: specifiers with peer suffixes using canonical key shape
  • pnpm v8 compatibility path generation for file: specifiers
  • packageKeys passthrough behavior when file: key already exists

[Ian Clanton-Thuon (iclanton)]

Copilot - this needs a changelog entry.

[Copilot]

Copilot - this needs a changelog entry.

Added in commit ef2a965 with a change file at common/changes/@rushstack/rush-resolver-cache-plugin/copilot-fix-file-protocol-error_2026-06-15-18-19.json.

[Bharat Middha (bmiddha)]

Copilot rebase this PR with latest main

[Copilot]

Copilot rebase this PR with latest main

I rebased the branch locally onto the latest main (new HEAD: 7f5fae98da), but I’m blocked from updating the remote branch history from this environment because it requires a force-push after the rebase. If you can force-update the branch (or provide a push-capable path), I can proceed immediately.