feat(migrate): Add migrate command and JS v10 -> v11 migration

apps/cli-docs/src/content/docs/contributing.md

@@ -86,6 +86,7 @@ cli/
 │   │   ├── help.ts      # Help command
 │   │   ├── info.ts      # Print configuration and verify authentication
 │   │   ├── init.ts      # Initialize Sentry in your project (experimental)
+│   │   ├── migrate.ts   # Upgrade a project across a Sentry SDK major version
 │   │   └── schema.ts    # Browse the Sentry API schema
 │   ├── lib/            # Shared utilities
 │   └── types/          # TypeScript types and Zod schemas

packages/cli/biome.jsonc

@@ -27,6 +27,10 @@
     // non-deterministically as error vs warning. See biome issue tracker.
     "includes": [
       "!test/init-eval/templates",
+      // Migration fixtures are intentionally v10-era code, and the `expected`
+      // files are byte-compared against codemod output. Formatting either side
+      // would rewrite the very thing under test.
+      "!test/lib/migrate/fixtures",
       "!dist-build",
       // The codemod package is a self-contained Codemod (jssg) project with
       // its own tooling/tests (`codemods/sentry-v3-to-v4`); it uses the

packages/cli/package.json

@@ -84,6 +84,8 @@
   },
   "devDependencies": {
     "@anthropic-ai/sdk": "^0.39.0",
+    "@babel/parser": "^8.0.4",
+    "@babel/types": "^8.0.4",
     "@biomejs/biome": "2.3.8",
     "@clack/prompts": "0.11.0",
     "@hono/node-server": "^2.0.10",

packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md

@@ -567,6 +567,14 @@ View Sentry logs
 
 → Full flags and examples: `references/log.md`
 
+### Migrate
+
+Upgrade a project across a Sentry SDK major version
+
+- `sentry migrate` — Upgrade a project across a Sentry SDK major version
+
+→ Full flags and examples: `references/migrate.md`
+
 ### Monitor
 
 Work with Sentry cron monitors

packages/cli/plugins/sentry-cli/skills/sentry-cli/references/migrate.md

@@ -0,0 +1,26 @@
+---
+name: sentry-cli-migrate
+version: 0.43.0-dev.0
+description: Upgrade a project across a Sentry SDK major version
+requires:
+  bins: ["sentry"]
+  auth: true
+---
+
+# Migrate Commands
+
+Upgrade a project across a Sentry SDK major version
+
+### `sentry migrate`
+
+Upgrade a project across a Sentry SDK major version
+
+**Flags:**
+- `--dry-run - Report what would change without writing anything`
+- `--allow-dirty - Run even though the working tree has uncommitted changes`
+- `--migration <value> - Run a specific migration instead of detecting one`
+- `--cwd <value> - Directory to migrate (defaults to the current directory)`
+- `--only <value> - Comma-separated task ids to run exclusively`
+- `--skip <value> - Comma-separated task ids to skip`
+
+All commands also support `--json`, `--fields`, `--help`, `--log-level`, and `--verbose` flags.

packages/cli/src/app.ts

@@ -31,6 +31,7 @@ import { listCommand as issueListCommand } from "./commands/issue/list.js";
 import { localRoute } from "./commands/local/index.js";
 import { logRoute } from "./commands/log/index.js";
 import { listCommand as logListCommand } from "./commands/log/list.js";
+import { migrateCommand } from "./commands/migrate.js";
 import { monitorRoute } from "./commands/monitor/index.js";
 import { listCommand as monitorListCommand } from "./commands/monitor/list.js";
 import { orgRoute } from "./commands/org/index.js";
@@ -133,6 +134,7 @@ export const routes = buildRouteMap({
     explore: exploreCommand,
     feedback: feedbackRoute,
     log: logRoute,
+    migrate: migrateCommand,
     monitor: monitorRoute,
     snapshots: snapshotsRoute,
     sourcemap: sourcemapRoute,