fix(migrate): reject workspace member targets

Author: leslieeilsel

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/migration_workspace_member_target/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "workspace-root",
+  "private": true,
+  "workspaces": [
+    "vendor/*"
+  ]
+}

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/migration_workspace_member_target/snapshots.toml

@@ -0,0 +1,64 @@
+[[case]]
+name = "migration_workspace_member_cwd"
+vp = "global"
+cwd = "vendor/sub"
+steps = [
+  { argv = [
+    "vp",
+    "migrate",
+    "--no-interactive",
+    "--no-agent",
+    "--no-editor",
+    "--no-hooks",
+  ], comment = "reject migration from a workspace member before changing files", continue-on-failure = true },
+  { argv = [
+    "vpt",
+    "print-file",
+    "../../package.json",
+  ], comment = "workspace root remains unchanged", continue-on-failure = true },
+  { argv = [
+    "vpt",
+    "print-file",
+    "package.json",
+  ], comment = "workspace member remains unchanged", continue-on-failure = true },
+  { argv = [
+    "vpt",
+    "stat-file",
+    "../../pnpm-workspace.yaml",
+    "--assert",
+    "missing",
+  ], comment = "no package-manager files are created at the workspace root" },
+]
+
+[[case]]
+name = "migration_workspace_member_explicit_path"
+vp = "global"
+cwd = "vendor/sub"
+steps = [
+  { argv = [
+    "vp",
+    "migrate",
+    ".",
+    "--no-interactive",
+    "--no-agent",
+    "--no-editor",
+    "--no-hooks",
+  ], comment = "reject an explicit workspace-member target before changing files", continue-on-failure = true },
+  { argv = [
+    "vpt",
+    "print-file",
+    "../../package.json",
+  ], comment = "workspace root remains unchanged", continue-on-failure = true },
+  { argv = [
+    "vpt",
+    "print-file",
+    "package.json",
+  ], comment = "workspace member remains unchanged", continue-on-failure = true },
+  { argv = [
+    "vpt",
+    "stat-file",
+    "../../pnpm-workspace.yaml",
+    "--assert",
+    "missing",
+  ], comment = "no package-manager files are created at the workspace root" },
+]

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/migration_workspace_member_target/snapshots/migration_workspace_member_cwd.md

@@ -0,0 +1,49 @@
+# migration_workspace_member_cwd
+
+## `vp migrate --no-interactive --no-agent --no-editor --no-hooks`
+
+reject migration from a workspace member before changing files
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Cannot migrate a workspace member independently. Run `vp migrate` from the workspace root at <workspace>.
+```
+
+## `vpt print-file ../../package.json`
+
+workspace root remains unchanged
+
+```
+{
+  "name": "workspace-root",
+  "private": true,
+  "workspaces": [
+    "vendor/*"
+  ]
+}
+```
+
+## `vpt print-file package.json`
+
+workspace member remains unchanged
+
+```
+{
+  "name": "workspace-member",
+  "private": true,
+  "devDependencies": {
+    "vitest": "<version>"
+  }
+}
+```
+
+## `vpt stat-file ../../pnpm-workspace.yaml --assert missing`
+
+no package-manager files are created at the workspace root
+
+```
+../../pnpm-workspace.yaml: missing
+```

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/migration_workspace_member_target/snapshots/migration_workspace_member_explicit_path.md

@@ -0,0 +1,49 @@
+# migration_workspace_member_explicit_path
+
+## `vp migrate . --no-interactive --no-agent --no-editor --no-hooks`
+
+reject an explicit workspace-member target before changing files
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Cannot migrate a workspace member independently. Run `vp migrate` from the workspace root at <workspace>.
+```
+
+## `vpt print-file ../../package.json`
+
+workspace root remains unchanged
+
+```
+{
+  "name": "workspace-root",
+  "private": true,
+  "workspaces": [
+    "vendor/*"
+  ]
+}
+```
+
+## `vpt print-file package.json`
+
+workspace member remains unchanged
+
+```
+{
+  "name": "workspace-member",
+  "private": true,
+  "devDependencies": {
+    "vitest": "<version>"
+  }
+}
+```
+
+## `vpt stat-file ../../pnpm-workspace.yaml --assert missing`
+
+no package-manager files are created at the workspace root
+
+```
+../../pnpm-workspace.yaml: missing
+```

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/migration_workspace_member_target/vendor/sub/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "workspace-member",
+  "private": true,
+  "devDependencies": {
+    "vitest": "4.1.10"
+  }
+}

docs/guide/migrate.md

@@ -22,6 +22,9 @@ The positional `PATH` argument is optional.
 
 - If omitted, `vp migrate` migrates the current directory
 - If provided, it migrates that target directory instead
+- For a monorepo, the target must be the workspace root. Workspace members
+  cannot be migrated independently because migration updates shared package
+  manager configuration, catalogs, and lockfiles.
 
 ```bash
 vp migrate

packages/cli/src/migration/bin.ts

@@ -1044,6 +1044,15 @@ async function main() {
   printHeader();
 
   const workspaceInfoOptional = await detectWorkspace(projectPath);
+  if (
+    workspaceInfoOptional.isMonorepo &&
+    path.resolve(projectPath) !== path.resolve(workspaceInfoOptional.rootDir)
+  ) {
+    cancelAndExit(
+      `Cannot migrate a workspace member independently. Run \`vp migrate\` from the workspace root at ${workspaceInfoOptional.rootDir}.`,
+      1,
+    );
+  }
   const initialChangedPaths = await collectChangedFormatPaths(workspaceInfoOptional.rootDir);
   const preExistingChangedPaths = initialChangedPaths ? new Set(initialChangedPaths) : undefined;
   const resolvedPackageManager = workspaceInfoOptional.packageManager ?? 'unknown';