Skip to content

feat(dashboard): add layout guidance and widget type reference for agents#521

Merged
betegon merged 9 commits intomainfrom
feat/dashboard-widget-types
Mar 20, 2026
Merged

feat(dashboard): add layout guidance and widget type reference for agents#521
betegon merged 9 commits intomainfrom
feat/dashboard-widget-types

Conversation

@betegon
Copy link
Member

@betegon betegon commented Mar 20, 2026

Summary

Agents creating dashboards don't know about the 6-column grid layout, available display types, or their default sizes. This surfaces all that info where agents naturally look:

  • sentry dashboard widget --help now includes display types with default grid sizes, datasets, aggregate functions, aliases, and row-filling examples
  • Agent guidance (embedded in SKILL.md) gets a "Dashboard Layout" section with the full display type table and examples
  • --display flag brief expanded to show 8 types instead of 4

Test plan

  • bun test test/commands/dashboard/ — all dashboard tests pass
  • bun run typecheck && bun run lint — clean
  • bun src/bin.ts dashboard widget --help — shows full layout/types/aggregates info
  • bun run check:skill — skill files up to date

🤖 Generated with Claude Code

betegon and others added 4 commits March 20, 2026 20:48
…gents

Agents creating dashboards don't know about the 6-column grid or available
display types. This adds a `sentry dashboard widget types` command that
outputs display types with default sizes, datasets, aggregate functions,
and aliases. Also surfaces layout info in `widget --help` and expands the
`--display` flag brief to show more types.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Adds a "Dashboard Layout" section to agent-guidance.md explaining the
6-column grid, display type categories, default sizes, and row-filling
patterns. Also documents the new `widget types` command.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Covers grid columns, display type sizes and categories, datasets,
aggregate functions, aliases, and human output rendering.

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

github-actions bot commented Mar 20, 2026

Semver Impact of This PR

🟡 Minor (new features)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).


New Features ✨

Dashboard

  • Add layout guidance and widget type reference for agents by betegon in #521
  • Add widget add, edit, and delete commands by betegon in #407

Telemetry

  • Include user email in Sentry telemetry context by BYK in #513
  • Track TTY vs non-TTY invocations via metric by betegon in #482

Other

  • (help) Fuzzy "Did you mean?" suggestions for command typos by BYK in #516
  • (upgrade) Add progress spinners for version check and download phases by BYK in #515
  • External sourcemap upload for compiled binaries by BYK in #518
  • Dynamic cache-backed shell completions with fuzzy matching by BYK in #465

Bug Fixes 🐛

  • (completions) Populate project cache from listProjects by betegon in #517
  • (help) Hide ASCII banner when stdout is not a TTY by betegon in #501
  • (json) Flatten view command JSON output for --fields filtering by BYK in #495
  • (polling) Throw TimeoutError instead of bare Error on timeout by BYK in #503
  • (project) Fallback to org listing when bare slug matches an organization by betegon in #475
  • (setup) Auto-configure zsh fpath for shell completions by betegon in #509
  • (skill) Include widget subcommands in generated skill files by betegon in #519
  • Isolate multiregion 403 tests from env-var auth tokens by BYK in #514
  • Only mention token scopes in 403 errors for env-var tokens by BYK in #512
  • Suggest similar projects on project-search miss (CLI-A4) by BYK in #511
  • Preserve ApiError type in Seer handler + suggest trial start command (CLI-N, CLI-1D/BW/98) by BYK in #510
  • Add 403 scope guidance to issue list error handling (CLI-97) by BYK in #508
  • Propagate 403 from multi-region fan-out instead of returning empty list (CLI-89) by BYK in #507
  • Lowercase project slug in URL-parsed issue short IDs (CLI-C8 follow-up) by BYK in #506
  • Handle EIO stream errors gracefully in bin.ts by BYK in #505
  • Use fuzzyMatch for similar project suggestions and add tests (CLI-C0) by BYK in #504
  • Use resolved org in numeric issue ID 404 hint (CLI-BT) by BYK in #502
  • Include API endpoint in error messages for better diagnostics (CLI-BS) by BYK in #500
  • Enrich 403 on org listing with token scope guidance (CLI-89) by BYK in #498
  • Add 400 suggestions to org-all issue list path (CLI-BY) by BYK in #497
  • Lowercase project slug in issue arg parsing (CLI-C8) by BYK in #496
  • Enrich short ID 404 with org context and suggestions (CLI-A1) by BYK in #494
  • Suggest similar projects when project not found in org (CLI-C0) by BYK in #493
  • Event 404 hint should suggest different project, not repeat failing command by BYK in #492
  • Enrich event 404 errors with retention and format suggestions (CLI-6F) by BYK in #491
  • Add actionable suggestions for 400 Bad Request on issue list (CLI-BM, CLI-7B) by BYK in #489
  • Detect issue short IDs passed to issue list (CLI-C3) by BYK in #488
  • Add Glob.match() polyfill + improve auto-detect diagnostics (CLI-7T) by BYK in #487
  • Add org-slug pre-check to dispatchOrgScopedList (CLI-9A) by BYK in #485

Documentation 📚

  • (dashboard) Add documentation for dashboard and widget commands by betegon in #520

Internal Changes 🔧

  • (init) Run org detection in background during preamble by MathurAditya724 in #443
  • (issue) Skip getProject round-trip in project-search resolution by betegon in #473
  • (resolve) Carry project data through resolution to eliminate redundant getProject calls by BYK in #486
  • (telemetry) Convert is_tty metric to span tag by betegon in #499
  • HTTP latency optimizations — diagnostics, cache warming, concurrency limits by BYK in #490
  • Switch from @sentry/bun to @sentry/node-core/light (~170ms startup savings) by BYK in #474
  • Regenerate skill files by github-actions[bot] in b7b240ec

🤖 This preview updates automatically when you update the PR.

@github-actions
Copy link
Contributor

github-actions bot commented Mar 20, 2026

PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://cli.sentry.dev/pr-preview/pr-521/

Built to branch gh-pages at 2026-03-20 20:08 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@github-actions
Copy link
Contributor

github-actions bot commented Mar 20, 2026

Codecov Results 📊

126 passed | Total: 126 | Pass Rate: 100% | Execution Time: 0ms

📊 Comparison with Base Branch

Metric Change
Total Tests
Passed Tests
Failed Tests
Skipped Tests

✨ No test changes detected

All tests are passing successfully.

✅ Patch coverage is 100.00%. Project has 1075 uncovered lines.
✅ Project coverage is 95.79%. Comparing base (base) to head (head).

Coverage diff
@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
+ Coverage    95.79%    95.79%        —%
==========================================
  Files          185       185         —
  Lines        25524     25534       +10
  Branches         0         0         —
==========================================
+ Hits         24449     24459       +10
- Misses        1075      1075         —
- Partials         0         0         —

Generated by Codecov Action

betegon and others added 2 commits March 20, 2026 20:52
Previously only 5 common types were in the table with the rest mentioned
in text. Now all display types are listed with their sizes and categories.

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

The widget --help and widget types --help now show all 14 display types
with their default grid dimensions, matching the agent guidance table.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@betegon betegon marked this pull request as ready for review March 20, 2026 19:55
betegon and others added 2 commits March 20, 2026 20:59
Move formatWidgetTypes from human.ts into the types.ts command file,
matching the pattern used by dashboard list. Removes the unusual
command→formatter cross-import from human.ts.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…get --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>
@betegon betegon changed the title feat(dashboard): add widget types command and layout guidance for agents feat(dashboard): add layout guidance and widget type reference for agents Mar 20, 2026
…lipsis

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@betegon betegon merged commit ccabec3 into main Mar 20, 2026
23 checks passed
@betegon betegon deleted the feat/dashboard-widget-types branch March 20, 2026 20:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant