Enhance sorting of installable files to prioritize shallower paths in getProjectInstallable function

[eleanorjboyd]

helps with #1429

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Improves the ordering of detected installable files so that shallower (more top-level) dependency files are prioritized, addressing sorting issues in getProjectInstallable (helps with #1429).

Changes:

• Add depth-based sorting for matched installable URIs in getProjectInstallable.
• Add a unit test validating shallower paths are ordered before deeper ones.

Show a summary per file

File	Description
src/managers/builtin/pipUtils.ts	Replaces default sort with a comparator that prioritizes shallower filesystem paths.
src/test/managers/builtin/pipUtils.unit.test.ts	Adds a regression test ensuring shallower requirements files appear first.

Copilot's findings

Comments suppressed due to low confidence (1)

src/managers/builtin/pipUtils.ts:337

• The new depth sort implies the returned installables order matters, but this block mutates installable from concurrent async tasks. If any .toml entries are present, await tomlParse(...) can cause later push(...) calls to occur out of the sorted order, making the final installables ordering nondeterministic. To keep ordering deterministic, build per-URI results (e.g., return an Installable[] from each mapper) and then flatten in filtered order, or process filtered sequentially when ordering is required.

            await Promise.all(
                filtered.map(async (uri) => {
                    if (uri.fsPath.endsWith('.toml')) {
                        const toml = await tomlParse(uri.fsPath);

                        // Validate pyproject.toml
                        if (!validationError) {
                            const error = validatePyprojectToml(toml);
                            if (error) {
                                validationError = {
                                    message: error,
                                    fileUri: uri,
                                };
                            }
                        }

                        installable.push(...getTomlInstallable(toml, uri));
                    } else {
                        const name = path.basename(uri.fsPath);
                        installable.push({
                            name,
                            uri,
                            displayName: name,
                            group: 'Requirements',
                            args: ['-r', uri.fsPath],
                        });
                    }
                }),
            );

• Files reviewed: 2/2 changed files
• Comments generated: 2

[StellaHuang95]

looks good.