Post-alpha: migration helper from turbo run -> vp run (filters + args) #206

Goal

• After Vite+ Alpha ships, add a migration aid to help users move from turbo run ... to vp run ....
• At minimum: docs + a helper (command or codemod) that translates common CLI invocations / package.json scripts.

Scope ideas

• Detect/translate common patterns in package.json scripts:
  • turbo run <task> --filter=... -> vp run <task> --filter=... (or whatever final vp syntax is)
  • Preserve -- -- <args> passthrough when applicable.
• Document non-1:1 cases and best-effort behavior.

Filter syntax notes (Turbo vs pnpm)

1. Flag position

• Turbo: turbo run build --filter=ui
• pnpm: pnpm --filter ui run build

2. Dependents vs dependencies (...)

• Dependents:
  • Turbo: --filter=...ui
  • pnpm: --filter ...ui
• Dependencies:
  • Turbo: --filter=ui...
  • pnpm: --filter ui...

3. Omit the target when using ... (^)

• pnpm has explicit forms:
  • only dependencies: foo^...
  • only dependents: ...^foo
• Turbo supports ^ as “omit the target from the selection when using ...” (same intent; placement differs from pnpm mental model).

4. Directory + git range selectors

• Turbo:
  • directory: --filter=./apps/*
  • git: --filter=[HEAD^1] or ranges like [main...HEAD]
  • when mixing directory with other filters, wrap dir in {} e.g. --filter={./apps/*}[HEAD^1]
  • --affected is effectively --filter=...[main...HEAD] by default
• pnpm:
  • directory glob: --filter "./packages/**"
  • changed-since selector: --filter "...[origin/master]"

5. Multiple filters + negation

• Turbo: multiple --filter flags union together; supports ! negation.
• pnpm: multiple --filter flags union together; supports ! negation.

Notes

• This issue is intentionally post-alpha: we should stabilize vp run UX/syntax first.