feat(release): add release command group and CI finalization

Add `sentry release` command group with 8 subcommands for full release
lifecycle management, plus a CI post-release script for automated
finalization.

Commands: list, view, create, finalize, delete, deploy, set-commits,
propose-version. Supports --auto (repo integration) and --local (git
history) modes for commit association via simple-git.

CI integration: script/finalize-release.ts runs in .craft.yml
postReleaseCommand before version bump to create, set commits, finalize,
and deploy releases automatically.

Ref: #600

Author: BYK

.craft.yml

@@ -4,7 +4,9 @@ changelog:
 versioning:
   policy: auto
 preReleaseCommand: node --experimental-strip-types script/bump-version.ts --pre
-postReleaseCommand: node --experimental-strip-types script/bump-version.ts --post
+postReleaseCommand: >-
+  node --experimental-strip-types script/finalize-release.ts &&
+  node --experimental-strip-types script/bump-version.ts --post
 artifactProvider:
   name: github
   config:

AGENTS.md

@@ -61,6 +61,14 @@ bun run test:unit                        # Run unit tests only
 bun run test:e2e                         # Run e2e tests only
 ```
 
+## Rules: No Runtime Dependencies
+
+**CRITICAL**: All packages must be in `devDependencies`, never `dependencies`. Everything is bundled at build time via esbuild. CI enforces this with `bun run check:deps`.
+
+When adding a package, always use `bun add -d <package>` (the `-d` flag).
+
+When the `@sentry/api` SDK provides types for an API response, import them directly from `@sentry/api` instead of creating redundant Zod schemas in `src/types/sentry.ts`.
+
 ## Rules: Use Bun APIs
 
 **CRITICAL**: This project uses Bun as runtime. Always prefer Bun-native APIs over Node.js equivalents.

bun.lock

@@ -13,6 +13,7 @@
         "references/logs.md",
         "references/organizations.md",
         "references/projects.md",
+        "references/release.md",
         "references/setup.md",
         "references/sourcemap.md",
         "references/teams.md",

docs/public/.well-known/skills/index.json

@@ -0,0 +1,80 @@
+---
+title: release
+description: Release commands for the Sentry CLI
+---
+
+Work with Sentry releases
+
+## Commands
+
+### `sentry release list <org/project>`
+
+List releases
+
+### `sentry release view <org/version>`
+
+View release details
+
+### `sentry release create <org/version>`
+
+Create a release
+
+### `sentry release finalize <org/version>`
+
+Finalize a release
+
+### `sentry release delete <org/version>`
+
+Delete a release
+
+### `sentry release deploy <org/version> <environment> [name]`
+
+Create a deploy for a release
+
+### `sentry release set-commits <org/version>`
+
+Set commits for a release
+
+### `sentry release propose-version`
+
+Propose a release version (outputs the current git HEAD SHA)
+
+All commands support `--json` for machine-readable output and `--fields` to select specific JSON fields.
+
+<!-- GENERATED:END -->
+
+## Examples
+
+```bash
+# List releases (auto-detect org)
+sentry release list
+
+# List releases in a specific org
+sentry release list my-org/
+
+# View release details
+sentry release view 1.0.0
+sentry release view my-org/1.0.0
+
+# Create and finalize a release
+sentry release create 1.0.0 --finalize
+
+# Create a release, then finalize separately
+sentry release create 1.0.0
+sentry release set-commits 1.0.0 --auto
+sentry release finalize 1.0.0
+
+# Set commits from local git history
+sentry release set-commits 1.0.0 --local
+
+# Create a deploy
+sentry release deploy 1.0.0 production
+sentry release deploy 1.0.0 staging "Deploy #42"
+
+# Propose a version from git HEAD
+sentry release create $(sentry release propose-version)
+
+# Output as JSON
+sentry release list --json
+sentry release view 1.0.0 --json
+```

docs/src/content/docs/commands/release.md

@@ -5,6 +5,7 @@
     "type": "git",
     "url": "git+https://github.com/getsentry/cli.git"
   },
+  "main": "./dist/index.cjs",
   "devDependencies": {
     "@anthropic-ai/sdk": "^0.39.0",
     "@biomejs/biome": "2.3.8",
@@ -35,6 +36,7 @@
     "pretty-ms": "^9.3.0",
     "qrcode-terminal": "^0.12.0",
     "semver": "^7.7.3",
+    "simple-git": "^3.33.0",
     "string-width": "^8.2.0",
     "tinyglobby": "^0.2.15",
     "typescript": "^5",
@@ -43,18 +45,16 @@
     "wrap-ansi": "^10.0.0",
     "zod": "^3.24.0"
   },
-  "bin": {
-    "sentry": "./dist/bin.cjs"
-  },
-  "main": "./dist/index.cjs",
-  "types": "./dist/index.d.cts",
   "exports": {
     ".": {
       "types": "./dist/index.d.cts",
       "require": "./dist/index.cjs",
       "default": "./dist/index.cjs"
     }
   },
+  "bin": {
+    "sentry": "./dist/bin.cjs"
+  },
   "description": "Sentry CLI - A command-line interface for using Sentry built by robots and humans for robots and humans",
   "engines": {
     "node": ">=22"
@@ -94,5 +94,6 @@
     "check:deps": "bun run script/check-no-deps.ts",
     "check:errors": "bun run script/check-error-patterns.ts"
   },
-  "type": "module"
+  "type": "module",
+  "types": "./dist/index.d.cts"
 }

package.json

@@ -315,6 +315,22 @@ Manage Sentry dashboards
 
 → Full flags and examples: `references/dashboards.md`
 
+### Release
+
+Work with Sentry releases
+
+- `sentry release list <org/project>` — List releases
+- `sentry release view <org/version...>` — View release details
+- `sentry release create <org/version...>` — Create a release
+- `sentry release finalize <org/version...>` — Finalize a release
+- `sentry release delete <org/version...>` — Delete a release
+- `sentry release deploy <org/version environment name...>` — Create a deploy for a release
+- `sentry release deploys <org/version...>` — List deploys for a release
+- `sentry release set-commits <org/version...>` — Set commits for a release
+- `sentry release propose-version` — Propose a release version
+
+→ Full flags and examples: `references/release.md`
+
 ### Repo
 
 Work with Sentry repositories

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

@@ -0,0 +1,119 @@
+---
+name: sentry-cli-release
+version: 0.24.0-dev.0
+description: Sentry CLI release commands
+requires:
+  bins: ["sentry"]
+  auth: true
+---
+
+# release Commands
+
+Work with Sentry releases
+
+### `sentry release list <org/project>`
+
+List releases
+
+**Flags:**
+- `-n, --limit <value> - Maximum number of releases to list - (default: "30")`
+- `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`
+- `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)`
+
+### `sentry release view <org/version...>`
+
+View release details
+
+**Flags:**
+- `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`
+
+### `sentry release create <org/version...>`
+
+Create a release
+
+**Flags:**
+- `-p, --project <value> - Associate with project(s), comma-separated`
+- `--finalize - Immediately finalize the release (set dateReleased)`
+- `--ref <value> - Git ref (branch or tag name)`
+- `--url <value> - URL to the release source`
+
+### `sentry release finalize <org/version...>`
+
+Finalize a release
+
+**Flags:**
+- `--released <value> - Custom release timestamp (ISO 8601). Defaults to now.`
+- `--url <value> - URL for the release`
+
+### `sentry release delete <org/version...>`
+
+Delete a release
+
+**Flags:**
+- `-y, --yes - Skip confirmation prompt`
+
+### `sentry release deploy <org/version environment name...>`
+
+Create a deploy for a release
+
+**Flags:**
+- `--url <value> - URL for the deploy`
+- `--started <value> - Deploy start time (ISO 8601)`
+- `--finished <value> - Deploy finish time (ISO 8601)`
+- `-t, --time <value> - Deploy duration in seconds (sets started = now - time, finished = now)`
+
+### `sentry release deploys <org/version...>`
+
+List deploys for a release
+
+### `sentry release set-commits <org/version...>`
+
+Set commits for a release
+
+**Flags:**
+- `--auto - Use repository integration to auto-discover commits (default)`
+- `--local - Read commits from local git history`
+- `--clear - Clear all commits from the release`
+- `--initial-depth <value> - Number of commits to read with --local - (default: "20")`
+
+### `sentry release propose-version`
+
+Propose a release version
+
+**Examples:**
+
+```bash
+# List releases (auto-detect org)
+sentry release list
+
+# List releases in a specific org
+sentry release list my-org/
+
+# View release details
+sentry release view 1.0.0
+sentry release view my-org/1.0.0
+
+# Create and finalize a release
+sentry release create 1.0.0 --finalize
+
+# Create a release, then finalize separately
+sentry release create 1.0.0
+sentry release set-commits 1.0.0 --auto
+sentry release finalize 1.0.0
+
+# Set commits from local git history
+sentry release set-commits 1.0.0 --local
+
+# Create a deploy
+sentry release deploy 1.0.0 production
+sentry release deploy 1.0.0 staging "Deploy #42"
+
+# Propose a version from git HEAD
+sentry release create $(sentry release propose-version)
+
+# Output as JSON
+sentry release list --json
+sentry release view 1.0.0 --json
+```
+
+All commands also support `--json`, `--fields`, `--help`, `--log-level`, and `--verbose` flags.