feat(release): surface adoption and health metrics in list and view (#463) (#680)

## Summary

- Add per-project health/adoption data to `release list` and `release
view` commands
- Pass `health=1` to the releases API so adoption and crash-free metrics
are populated
- Add ADOPTION and CRASH-FREE columns to the list table; add per-project
health breakdown to view
- Closes #463

## Changes

**API layer** (`src/lib/api/releases.ts`):
- `listReleasesPaginated` gains `health?: boolean` option
- `getRelease` gains optional `{ health, adoptionStages,
healthStatsPeriod }` query params
- Export `ReleaseSortValue` type for future `--sort` support

**List command** (`src/commands/release/list.ts`):
- Always requests `health=1` in both `listForOrg` and `listPaginated`
- Replaces STATUS/RELEASED columns with ADOPTION/CRASH-FREE/ISSUES
columns
- Health data extracted from first project with `hasHealthData: true`

**View command** (`src/commands/release/view.ts`):
- Requests `health=true, adoptionStages=true` on every view
- Adds "Health by Project" table section with per-project metrics
- Color-coded crash-free rates (green ≥99%, yellow ≥95%, red <95%)
- Section gracefully omitted when no project has session data

**Tests** (`test/commands/release/view.test.ts`):
- Health data rendering (human mode): checks section header, project
slugs, percentages
- Health data in JSON: verifies `projects[].healthData` fields pass
through
- No-health fallback: verifies section is omitted when `hasHealthData:
false`

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: BYK

docs/src/fragments/commands/log.md

@@ -1,5 +1,4 @@
 
-
 ## Examples
 
 ### List logs

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

@@ -346,8 +346,8 @@ Manage Sentry dashboards
 
 Work with Sentry releases
 
-- `sentry release list <org/project>` — List releases
-- `sentry release view <org/version...>` — View release details
+- `sentry release list <org/project>` — List releases with adoption and health metrics
+- `sentry release view <org/version...>` — View release details with health metrics
 - `sentry release create <org/version...>` — Create a release
 - `sentry release finalize <org/version...>` — Finalize a release
 - `sentry release delete <org/version...>` — Delete a release

plugins/sentry-cli/skills/sentry-cli/references/release.md

@@ -13,16 +13,20 @@ Work with Sentry releases
 
 ### `sentry release list <org/project>`
 
-List releases
+List releases with adoption and health metrics
 
 **Flags:**
 - `-n, --limit <value> - Maximum number of releases to list - (default: "25")`
+- `-s, --sort <value> - Sort: date, sessions, users, crash_free_sessions (cfs), crash_free_users (cfu) - (default: "date")`
+- `-e, --environment <value>... - Filter by environment (repeatable, comma-separated)`
+- `-t, --period <value> - Health stats period (e.g., 24h, 7d, 14d, 90d) - (default: "90d")`
+- `--status <value> - Filter by status: open (default) or archived - (default: "open")`
 - `-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
+View release details with health metrics
 
 **Flags:**
 - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`