refactor(dashboard): remove widget types command, put all info in widget --help

Removes the standalone `sentry dashboard widget types` command. All the
info (display types, sizes, datasets, aggregates, aliases, row-filling
examples) now lives directly in `sentry dashboard widget --help` so
agents get it immediately without running a separate command.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: betegon

docs/src/content/docs/agent-guidance.md

@@ -129,7 +129,7 @@ Use **common** types for general dashboards. Use **specialized** only when speci
 
 Available datasets: `spans` (default, covers most use cases), `discover`, `issue`, `error-events`, `transaction-like`, `metrics`, `logs`.
 
-Run `sentry dashboard widget types --json` for the full machine-readable list including aggregate functions.
+Run `sentry dashboard widget --help` for the full list including aggregate functions.
 
 **Row-filling examples:**
 

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

@@ -323,25 +323,3 @@ sentry dashboard widget delete 'My Dashboard' --title 'Error Count'
 # Delete by index
 sentry dashboard widget delete 12345 --index 2
 ```
-
-### `sentry dashboard widget types`
-
-Show available widget display types with default grid sizes, datasets, and aggregate functions.
-
-Sentry dashboards use a 6-column grid. This command helps you understand the available options and how widgets fit into the layout.
-
-```bash
-# Human-readable table
-sentry dashboard widget types
-
-# Machine-readable JSON (recommended for agents)
-sentry dashboard widget types --json
-```
-
-Display types are categorized as:
-
-| Category | Types | When to use |
-|----------|-------|------------|
-| common | `big_number`, `line`, `area`, `bar`, `table` | General-purpose dashboards |
-| specialized | `stacked_area`, `top_n`, `categorical_bar`, `text` | Specific use cases |
-| internal | `details`, `wheel`, `rage_and_dead_clicks`, `server_tree`, `agents_traces_table` | Sentry-internal, rarely used directly |

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

@@ -139,7 +139,7 @@ Use **common** types for general dashboards. Use **specialized** only when speci
 
 Available datasets: `spans` (default, covers most use cases), `discover`, `issue`, `error-events`, `transaction-like`, `metrics`, `logs`.
 
-Run `sentry dashboard widget types --json` for the full machine-readable list including aggregate functions.
+Run `sentry dashboard widget --help` for the full list including aggregate functions.
 
 **Row-filling examples:**
 
@@ -276,7 +276,6 @@ Manage Sentry dashboards
 - `sentry dashboard widget add <args...>` — Add a widget to a dashboard
 - `sentry dashboard widget edit <args...>` — Edit a widget in a dashboard
 - `sentry dashboard widget delete <args...>` — Delete a widget from a dashboard
-- `sentry dashboard widget types <args...>` — Show available widget display types and layout info
 
 → Full flags and examples: `references/dashboards.md`
 

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

@@ -122,8 +122,4 @@ Delete a widget from a dashboard
 - `-i, --index <value> - Widget index (0-based)`
 - `-t, --title <value> - Widget title to match`
 
-### `sentry dashboard widget types <args...>`
-
-Show available widget display types and layout info
-
 All commands also support `--json`, `--fields`, `--help`, `--log-level`, and `--verbose` flags.

src/commands/dashboard/index.ts

@@ -19,7 +19,7 @@ export const dashboardRoute = buildRouteMap({
       "  list     List dashboards\n" +
       "  view     View a dashboard\n" +
       "  create   Create a dashboard\n" +
-      "  widget   Manage dashboard widgets (add, edit, delete, types)",
+      "  widget   Manage dashboard widgets (add, edit, delete)",
     hideRoute: {},
   },
 });

src/commands/dashboard/widget/index.ts

@@ -2,14 +2,12 @@ import { buildRouteMap } from "@stricli/core";
 import { addCommand } from "./add.js";
 import { deleteCommand } from "./delete.js";
 import { editCommand } from "./edit.js";
-import { typesCommand } from "./types.js";
 
 export const widgetRoute = buildRouteMap({
   routes: {
     add: addCommand,
     edit: editCommand,
     delete: deleteCommand,
-    types: typesCommand,
   },
   docs: {
     brief: "Manage dashboard widgets",
@@ -19,13 +17,33 @@ export const widgetRoute = buildRouteMap({
       "Display types (width × height):\n" +
       "  common:      big_number (2×1), line (3×2), area (3×2), bar (3×2), table (6×2)\n" +
       "  specialized: stacked_area (3×2), top_n (3×2), categorical_bar (3×2), text (3×2)\n" +
-      "  internal:    details, wheel, rage_and_dead_clicks, server_tree, agents_traces_table (3×2)\n\n" +
-      "Default dataset: spans. Run 'sentry dashboard widget types' for the full list.\n\n" +
+      "  internal:    details (3×2), wheel (3×2), rage_and_dead_clicks (3×2),\n" +
+      "               server_tree (3×2), agents_traces_table (3×2)\n\n" +
+      "Datasets: spans (default), discover, issue, error-events, transaction-like,\n" +
+      "          metrics, logs, tracemetrics, preprod-app-size\n\n" +
+      "Aggregates (spans): count, count_unique, sum, avg, percentile, p50, p75,\n" +
+      "  p90, p95, p99, p100, eps, epm, any, min, max\n" +
+      "Aggregates (discover adds): failure_count, failure_rate, apdex,\n" +
+      "  count_miserable, user_misery, count_web_vitals, count_if, count_at_least,\n" +
+      "  last_seen, latest_event, var, stddev, cov, corr, performance_score,\n" +
+      "  opportunity_score, count_scores\n" +
+      "Aliases: spm → epm, sps → eps, tpm → epm, tps → eps\n\n" +
+      "Row-filling examples:\n" +
+      "  # 3 KPIs (2+2+2 = 6)\n" +
+      '  sentry dashboard widget add <d> "Error Count" --display big_number --query count\n' +
+      '  sentry dashboard widget add <d> "P95" --display big_number --query p95:span.duration\n' +
+      '  sentry dashboard widget add <d> "Throughput" --display big_number --query epm\n\n' +
+      "  # 2 charts (3+3 = 6)\n" +
+      '  sentry dashboard widget add <d> "Errors" --display line --query count\n' +
+      '  sentry dashboard widget add <d> "Latency" --display line --query p95:span.duration\n\n' +
+      "  # Full-width table (6 = 6)\n" +
+      '  sentry dashboard widget add <d> "Top Endpoints" --display table \\\n' +
+      "    --query count --query p95:span.duration --group-by transaction \\\n" +
+      "    --sort -count --limit 10\n\n" +
       "Commands:\n" +
       "  add    Add a widget to a dashboard\n" +
       "  edit   Edit a widget in a dashboard\n" +
-      "  delete Delete a widget from a dashboard\n" +
-      "  types  Show available display types and layout info",
+      "  delete Delete a widget from a dashboard",
     hideRoute: {},
   },
 });

src/commands/dashboard/widget/types.ts

@@ -479,10 +479,10 @@ export function prepareWidgetQueries(widget: DashboardWidget): DashboardWidget {
 // ---------------------------------------------------------------------------
 
 /** Sentry dashboard grid column count */
-export const GRID_COLUMNS = 6;
+const GRID_COLUMNS = 6;
 
 /** Default widget dimensions by displayType */
-export const DEFAULT_WIDGET_SIZE: Partial<
+const DEFAULT_WIDGET_SIZE: Partial<
   Record<DisplayType, { w: number; h: number; minH: number }>
 > = {
   big_number: { w: 2, h: 1, minH: 1 },
@@ -491,7 +491,7 @@ export const DEFAULT_WIDGET_SIZE: Partial<
   bar: { w: 3, h: 2, minH: 2 },
   table: { w: 6, h: 2, minH: 2 },
 };
-export const FALLBACK_SIZE = { w: 3, h: 2, minH: 2 };
+const FALLBACK_SIZE = { w: 3, h: 2, minH: 2 };
 
 /** Build a set of occupied grid cells and the max bottom edge from existing layouts. */
 function buildOccupiedGrid(widgets: DashboardWidget[]): {