feat(event): add 'sentry event list' command for issue-scoped event listing (#671)

## Summary

Adds `sentry event list <issue-id>` as a top-level command for listing
events belonging to a Sentry issue. This is functionally equivalent to
`sentry issue events` but lives in the `event` route with its own
command identity.

The `sentry events` plural alias now uses Pattern A (points to the list
command directly), matching how `sentry issues` → `issue list`, `sentry
traces` → `trace list`, etc.

### Changes

- **`src/commands/event/shared-events.ts`** (new) — Shared types,
constants, formatters, table columns, and flag definitions extracted
from `issue/events.ts`
- **`src/commands/event/list.ts`** (new) — The `event list` command with
correct command identity (pagination hints, error messages)
- **`src/commands/issue/events.ts`** — Refactored to import shared parts
(no behavior change)
- **`src/commands/issue/utils.ts`** — `buildCommandHint` and
`resolveIssue` accept optional `commandBase` parameter
- **`src/commands/event/index.ts`** — Added `list` route alongside
`view`
- **`src/app.ts`** — Changed `events` alias from `eventRoute` (Pattern
B) to `eventListCommand` (Pattern A)
- **`src/lib/command-suggestions.ts`** — Removed `event/list` synonym
(now a real command)

### Usage

```bash
sentry event list CLI-G5
sentry event list @latest --limit 50
sentry event list CLI-G5 --full --json
sentry event list CLI-G5 -q "user.email:foo@bar.com"
sentry events CLI-G5          # plural alias → event list
```

### Follow-up: org-scoped event listing

This PR covers issue-scoped event listing only. A follow-up issue will
track expanding `event list` to support org-scoped queries via the
Discover/Events API (`/organizations/{org}/events/`), enabling patterns
like `sentry event list <org>/ --dataset errors`.

Closes #632

---------

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

Author: BYK

docs/src/content/docs/commands/dashboard.md

@@ -22,7 +22,7 @@ List dashboards
 | Option | Description |
 |--------|-------------|
 | `-w, --web` | Open in browser |
-| `-n, --limit <limit>` | Maximum number of dashboards to list (default: "30") |
+| `-n, --limit <limit>` | Maximum number of dashboards to list (default: "25") |
 | `-f, --fresh` | Bypass cache, re-detect projects, and fetch fresh data |
 | `-c, --cursor <cursor>` | Navigate pages: "next", "prev", "first" (or raw cursor string) |
 

docs/src/content/docs/commands/event.md

@@ -3,7 +3,7 @@ title: event
 description: Event commands for the Sentry CLI
 ---
 
-View Sentry events
+View and list Sentry events
 
 ## Commands
 
@@ -25,6 +25,27 @@ View details of a specific event
 | `--spans <spans>` | Span tree depth limit (number, "all" for unlimited, "no" to disable) (default: "3") |
 | `-f, --fresh` | Bypass cache, re-detect projects, and fetch fresh data |
 
+### `sentry event list <issue>`
+
+List events for an issue
+
+**Arguments:**
+
+| Argument | Description |
+|----------|-------------|
+| `<issue>` | Issue: @latest, @most_frequent, &lt;org&gt;/ID, &lt;project&gt;-suffix, ID, or suffix |
+
+**Options:**
+
+| Option | Description |
+|--------|-------------|
+| `-n, --limit <limit>` | Number of events (1-1000) (default: "25") |
+| `-q, --query <query>` | Search query (Sentry search syntax) |
+| `--full` | Include full event body (stacktraces) |
+| `-t, --period <period>` | Time period (e.g., "1h", "24h", "7d", "30d") (default: "7d") |
+| `-f, --fresh` | Bypass cache, re-detect projects, and fetch fresh data |
+| `-c, --cursor <cursor>` | Navigate pages: "next", "prev", "first" (or raw cursor string) |
+
 All commands support `--json` for machine-readable output and `--fields` to select specific JSON fields.
 
 <!-- GENERATED:END -->

docs/src/content/docs/commands/index.md

@@ -18,7 +18,7 @@ The Sentry CLI provides commands for interacting with various Sentry resources.
 | [`repo`](./repo/) | Work with Sentry repositories |
 | [`team`](./team/) | Work with Sentry teams |
 | [`issue`](./issue/) | Manage Sentry issues |
-| [`event`](./event/) | View Sentry events |
+| [`event`](./event/) | View and list Sentry events |
 | [`log`](./log/) | View Sentry logs |
 | [`sourcemap`](./sourcemap/) | Manage sourcemaps |
 | [`span`](./span/) | List and view spans in projects or traces |

docs/src/content/docs/commands/org.md

@@ -15,7 +15,7 @@ List organizations
 
 | Option | Description |
 |--------|-------------|
-| `-n, --limit <limit>` | Maximum number of organizations to list (default: "30") |
+| `-n, --limit <limit>` | Maximum number of organizations to list (default: "25") |
 | `-f, --fresh` | Bypass cache, re-detect projects, and fetch fresh data |
 
 ### `sentry org view <org>`

docs/src/content/docs/commands/project.md

@@ -57,7 +57,7 @@ List projects
 
 | Option | Description |
 |--------|-------------|
-| `-n, --limit <limit>` | Maximum number of projects to list (default: "30") |
+| `-n, --limit <limit>` | Maximum number of projects to list (default: "25") |
 | `-p, --platform <platform>` | Filter by platform (e.g., javascript, python) |
 | `-f, --fresh` | Bypass cache, re-detect projects, and fetch fresh data |
 | `-c, --cursor <cursor>` | Navigate pages: "next", "prev", "first" (or raw cursor string) |

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

@@ -21,7 +21,7 @@ List releases
 
 | Option | Description |
 |--------|-------------|
-| `-n, --limit <limit>` | Maximum number of releases to list (default: "30") |
+| `-n, --limit <limit>` | Maximum number of releases to list (default: "25") |
 | `-f, --fresh` | Bypass cache, re-detect projects, and fetch fresh data |
 | `-c, --cursor <cursor>` | Navigate pages: "next", "prev", "first" (or raw cursor string) |
 

docs/src/content/docs/commands/repo.md

@@ -21,7 +21,7 @@ List repositories
 
 | Option | Description |
 |--------|-------------|
-| `-n, --limit <limit>` | Maximum number of repositories to list (default: "30") |
+| `-n, --limit <limit>` | Maximum number of repositories to list (default: "25") |
 | `-f, --fresh` | Bypass cache, re-detect projects, and fetch fresh data |
 | `-c, --cursor <cursor>` | Navigate pages: "next", "prev", "first" (or raw cursor string) |
 

docs/src/content/docs/commands/team.md

@@ -21,7 +21,7 @@ List teams
 
 | Option | Description |
 |--------|-------------|
-| `-n, --limit <limit>` | Maximum number of teams to list (default: "30") |
+| `-n, --limit <limit>` | Maximum number of teams to list (default: "25") |
 | `-f, --fresh` | Bypass cache, re-detect projects, and fetch fresh data |
 | `-c, --cursor <cursor>` | Navigate pages: "next", "prev", "first" (or raw cursor string) |
 

docs/src/content/docs/commands/trace.md

@@ -21,7 +21,7 @@ List recent traces in a project
 
 | Option | Description |
 |--------|-------------|
-| `-n, --limit <limit>` | Number of traces (1-1000) (default: "20") |
+| `-n, --limit <limit>` | Number of traces (1-1000) (default: "25") |
 | `-q, --query <query>` | Search query (Sentry search syntax) |
 | `-s, --sort <sort>` | Sort by: date, duration (default: "date") |
 | `-t, --period <period>` | Time period (e.g., "1h", "24h", "7d", "30d") (default: "7d") |

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

@@ -303,9 +303,10 @@ Manage Sentry issues
 
 ### Event
 
-View Sentry events
+View and list Sentry events
 
 - `sentry event view <org/project/event-id...>` — View details of a specific event
+- `sentry event list <issue>` — List events for an issue
 
 → Full flags and examples: `references/event.md`