[rush-lib] Add PathProjectSelectorParser with path: scheme and auto-routing

[Copilot]

Implementation Complete: PathProjectSelectorParser

Successfully implemented the PathProjectSelectorParser with the path: scheme as requested.

Latest Changes (addressing code review feedback):

• Use Path.convertToSlashes helper (Comment 3544412936)
  • Replaced manual path separator conversion (relativePath.split(nodePath.sep).join('/')) with Path.convertToSlashes(relativePath)
  • Uses the standard utility from @rushstack/node-core-library
  • More idiomatic and consistent with the rest of the codebase

Complete Implementation Summary:

Code Changes:

• PathProjectSelectorParser requires workingDirectory parameter (not optional)
• RushCommandLineParser exposes cwd via public getter for consistent path resolution
• SelectionParameterSet accepts cwd from parser and passes to PathProjectSelectorParser
• Auto-detection: SelectionParameterSet automatically routes path-like selectors to path: parser
• All actions (ListAction, InstallAction, UpdateAction, PhasedScriptAction) pass parser.cwd
• Path normalization: Uses Path.convertToSlashes helper for cross-platform compatibility
• Path matching using findChildPath (handles exact and containing matches)
• Uses Set for collecting multiple projects
• Single source of truth: process.cwd() called once in RushCommandLineParser, used consistently throughout

Test Changes:

• PathProjectSelectorParser: 9 tests (including shared subfolder test)
• VersionPolicyProjectSelectorParser: 3 tests (with actual version policies)
• NamedProjectSelectorParser: 3 tests
• TagProjectSelectorParser: 4 tests with real tag validation
• SubspaceSelectorParser: 2 tests
• Total: 21 tests across 5 test files

Test Fixture Updates:

• Added apps/app1 and apps/app2 projects for nested structure testing
• Created version-policies.json with testPolicy
• Updated rush-npm.json to include 5 projects with version policies and tags
• Fixed RushConfiguration.test.ts to expect 5 projects

Change Management:

• Added Rush change file for minor version bump

Features:

1. Path Resolution: Resolves input path against consistent working directory from Rush CLI (same cwd used to discover rush.json)
2. Auto-detection: Automatically recognizes and routes path-like selectors without explicit path: prefix
3. Cross-Platform: Uses Path.convertToSlashes for proper path normalization on Windows
4. Flexible Selection:
   • Exact project match (path points to a project folder)
   • Containing project match (path points inside a project)
   • Multiple projects match (path points to a directory containing projects)
5. Error Handling: Clear error messages for paths that don't match any project
6. Integration: Works with all selection parameters (--only, --to, --from, --impacted-by, etc.)
7. Consistent CWD: Both path resolution and Rush configuration discovery use the same working directory

Security Summary:

No security vulnerabilities introduced. The implementation:

• Uses existing path normalization utilities from @rushstack/node-core-library
• Follows established patterns from other selector parsers
• Properly handles errors without exposing sensitive information

Original prompt

In @microsoft/rush-lib, define a new ISelectorParser alongside the existing implementations that has a scheme of path: and selects projects by resolving the input path against the working directory, relativizing it to the rushJsonFolder, then leveraging the LookupByPath instance returned by rushConfiguration.getProjectLookupForRoot to identify either the project that contains the relativized path, or all projects that are within the relativized path. This should be called PathProjectSelectorParser.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[dmichon-msft]

Looks good except for the missing change file.

[dmichon-msft]

@copilot Need to run rush change --no-fetch --bulk --bump-type minor --message "${Insert description of the feature here}" to create the change file for Rush.

[Copilot]

@copilot Need to run rush change --no-fetch --bulk --bump-type minor --message "${Insert description of the feature here}" to create the change file for Rush.

Fixed in b4f2e53. Created change file with minor bump type for the PathProjectSelectorParser feature at common/changes/@microsoft/rush/copilot-add-path-project-selector-parser_2025-11-17-22-30.json.

Looks good except for the missing change file.

Fixed in b4f2e53. Created change file with minor bump type for the PathProjectSelectorParser feature at common/changes/@microsoft/rush/copilot-add-path-project-selector-parser_2025-11-17-22-30.json.

[Copilot]

@copilot - Left some comments. It also looks like build or tests are failing on Windows.

Fixed Windows path issue in 4967774. The problem was that path.relative() returns backslashes on Windows, but LookupByPath expects forward slashes. Added normalization: relativePath.split(nodePath.sep).join('/') to convert path separators before querying LookupByPath.

[dmichon-msft]

@copilot Update _evaluateSelectorParser in SelectionParameterSet to generalize the special case of '.' to take anything that is obviously a relative path ('.', '..', or either of those followed by a '/' and more path) or an absolute POSIX path (a value starting with '/') and automatically route it to the path: selector parser

[Copilot]

@copilot Update _evaluateSelectorParser in SelectionParameterSet to generalize the special case of '.' to take anything that is obviously a relative path ('.', '..', or either of those followed by a '...

Fixed in b70d1a7. Updated _evaluateProjectParameterAsync to automatically route path-like selectors to the path: parser:

• Relative paths: ., .., ./..., ../...
• Absolute POSIX paths: /...

Now users can use rush build --only . or rush build --only ./my-project without needing the explicit path: prefix. The special-case handling for . using PackageJsonLookup has been removed in favor of the unified path selector approach.

[dmichon-msft]

@copilot libraries/rush-lib/src/logic/selectors/PathProjectSelectorParser.ts:35
Call the Path.convertToSlashes helper for this.

[Copilot]

@copilot libraries/rush-lib/src/logic/selectors/PathProjectSelectorParser.ts:35
Call the Path.convertToSlashes helper for this.

Fixed in 52c2340. Replaced manual path separator conversion with Path.convertToSlashes(relativePath) helper from @rushstack/node-core-library.