feat: implement native recursive version command

[kairosci]

Description

Implement version natively in pnpm to support workspaces and workspace: protocols correctly.

Changes

• Implemented version command in @pnpm/plugin-commands-script-runners.
• Registered version command in pnpm CLI.
• Removed hardcoded passthrough to npm version in pnpm CLI.
• Added support for --recursive versioning.

Checklist

• Related issue is linked (Fixes pnpm version -ws leads to npm error Unsupported URL Type "workspace:": workspace:^ #10703)
• Tests are added
• Changeset is added

[Copilot]

Pull request overview

Implements a native pnpm version command (including pnpm -r version) so version bumps run with pnpm’s workspace context instead of being passed through to npm version (which breaks on workspace: protocol deps).

Changes:

• Register version as a pnpm command via @pnpm/plugin-commands-script-runners and stop passing version through to npm.
• Update CLI arg parsing to treat version similarly to run/dlx for passthrough-style args.
• Add regression tests and a small repro workspace fixture for the workspace:^ dependency case.

Reviewed changes

Copilot reviewed 14 out of 16 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
repro-workspace-version-issue/pnpm-workspace.yaml	Adds a minimal workspace manifest for the repro fixture.
repro-workspace-version-issue/pnpm-lock.yaml	Adds a minimal lockfile capturing workspace:^ dependency usage.
repro-workspace-version-issue/package.json	Adds root package.json for the repro fixture.
repro-workspace-version-issue/packages/pkg-a/package.json	Adds pkg-a fixture package.
repro-workspace-version-issue/packages/pkg-b/package.json	Adds pkg-b fixture package depending on pkg-a via workspace:^.
pnpm/test/version.test.ts	Adds an integration test asserting pnpm -r version minor succeeds with workspace: deps.
pnpm/src/pnpm.ts	Removes version from the npm pass-through command list.
pnpm/src/parseCliArgs.ts	Treats version as an escaped-args command at the pnpm CLI wrapper level.
pnpm/src/cmd/index.ts	Registers the new version command from script-runners.
pnpm-lock.yaml	Adds @pnpm/run-npm workspace dependency (for the new command).
exec/plugin-commands-script-runners/tsconfig.json	Adds TS project reference for run-npm.
exec/plugin-commands-script-runners/package.json	Adds @pnpm/run-npm dependency.
exec/plugin-commands-script-runners/src/index.ts	Exports the new version command module.
exec/plugin-commands-script-runners/src/version.ts	New implementation of the version command (recursive + non-recursive).
exec/plugin-commands-script-runners/test/version.test.ts	Unit test ensuring version delegates to runNpm with correct args/options.
cli/parse-cli-args/src/index.ts	Treats version like run/dlx for special escaping behavior.

Files not reviewed (2)

• pnpm-lock.yaml: Language not supported
• repro-workspace-version-issue/pnpm-lock.yaml: Language not supported

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[saudademjj]

I pulled this PR locally and fixed the failing import-sort errors in a follow-up branch on my fork:

• branch: saudademjj:codex/fix-pr-10879-version-command
• commit: 395729fb1

Validated locally with:

• pnpm run lint
• pnpm --filter @pnpm/plugin-commands-script-runners run _test -- --runTestsByPath test/version.test.ts --runInBand
• pnpm --filter pnpm run _test -- --runTestsByPath test/version.test.ts --runInBand

If helpful, feel free to cherry-pick 395729fb1.

[saudademjj]

Follow-up fix for the remaining review feedback is available on saudademjj:codex/fix-pr-10879-version-command at commit 1d659a5c5.

Addressed in this update:

• pnpm version --help now goes through pnpm's help path, while arguments after a real version argument still pass through to npm.
• pnpm help version now works in the bundled CLI by using the standard render-help import.
• version now advertises the CLI options it actually supports (npm-path, sort, recursive, reverse).
• Removed the misleading concurrency wrapper around synchronous runNpm() calls and execute recursive version bumps sequentially.

Validated locally:

• pnpm run compile-only
• pnpm --filter @pnpm/parse-cli-args run _test -- --runTestsByPath test/index.ts --runInBand
• pnpm --filter @pnpm/plugin-commands-script-runners run _test -- --runTestsByPath test/version.test.ts --runInBand
• pnpm --filter pnpm run _test -- --runTestsByPath test/version.test.ts --runInBand
• ./node_modules/.bin/eslint cli/parse-cli-args/src/index.ts cli/parse-cli-args/test/index.ts exec/plugin-commands-script-runners/src/version.ts exec/plugin-commands-script-runners/test/version.test.ts pnpm/test/version.test.ts

[kairosci]

@gluxon @zkochan PTAL, thank you!