fix(dashboard): address Seer and Bugbot review findings

- Fix validateQueryConstraints false positive: only check group-by+limit
  when user explicitly passes --group-by, not when merely changing --query
  on an existing grouped widget (which may have auto-defaulted columns)
- Fix orphaned JSDoc: move buildWidgetFromFlags doc comment to its
  actual function definition after the validation helpers were inserted

Author: BYK

src/commands/dashboard/resolve.ts

@@ -316,15 +316,6 @@ export function resolveWidgetIndex(
   return matchIndex;
 }
 
-/**
- * Build a widget from user-provided flag values.
- *
- * Shared between `dashboard widget add` and `dashboard widget edit`.
- * Parses aggregate shorthand, sort expressions, and validates via Zod schema.
- *
- * @param opts - Widget configuration from parsed flags
- * @returns Validated widget with computed query fields
- */
 /**
  * Validate that a sort expression references an aggregate present in the query.
  * The Sentry API returns 400 when the sort field isn't in the widget's aggregates.
@@ -421,6 +412,15 @@ function warnUnknownAggregateFields(
   }
 }
 
+/**
+ * Build a widget from user-provided flag values.
+ *
+ * Shared between `dashboard widget add` and `dashboard widget edit`.
+ * Parses aggregate shorthand, sort expressions, and validates via Zod schema.
+ *
+ * @param opts - Widget configuration from parsed flags
+ * @returns Validated widget with computed query fields
+ */
 export function buildWidgetFromFlags(opts: {
   title: string;
   display: string;

src/commands/dashboard/widget/edit.ts

@@ -137,7 +137,10 @@ function validateQueryConstraints(
   mergedQueries: DashboardWidgetQuery[] | undefined,
   limit: number | null | undefined
 ): void {
-  if (flags["group-by"] || flags.query) {
+  // Only validate when user explicitly passes --group-by, not when merely
+  // changing --query on an existing grouped widget (which may have auto-defaulted
+  // columns like ["issue"] with no limit)
+  if (flags["group-by"]) {
     const columns =
       mergedQueries?.[0]?.columns ?? existing.queries?.[0]?.columns ?? [];
     validateGroupByRequiresLimit(columns, limit ?? undefined);