fix(dashboard): add --layout flag to widget add for predictable placement

[BYK]

Summary

Fixes #691.

• Adds a --layout/-l flag to sentry dashboard widget add with two modes:
  • sequential (default) — cursor-based append that places widgets after the last one, wrapping to a new row on overflow. Interior gaps beside taller widgets are never backfilled.
  • dense — preserves the original first-fit gap-filling behavior for compact layouts.
• Existing --x/--y/--width/--height flags continue to work as explicit overrides on top of either mode.

Changes

File	What
src/types/dashboard.ts	Added WidgetLayoutMode type, extracted assignLayoutDense/assignLayoutSequential helpers, updated assignDefaultLayout signature
src/commands/dashboard/widget/add.ts	Added --layout/-l flag with validation
test/types/dashboard.test.ts	10 new unit tests (sequential + dense modes)
test/types/dashboard.property.test.ts	New property-based tests (grid bounds, no overlap, idempotency, monotonic y)
test/commands/dashboard/widget/add.test.ts	3 new tests for --layout flag

[github-actions]

Semver Impact of This PR

🟢 Patch (bug fixes)

📋 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 ✨

• (commands) Add buildRouteMap wrapper with standard subcommand aliases by BYK in #690

Bug Fixes 🐛

Dashboard

• Add --layout flag to widget add for predictable placement by BYK in #700

• Render tracemetrics widgets in dashboard view by BYK in #695

Other

• (init) Narrow command validation to actual shell injection vectors by betegon in #697
• (init,feedback) Default to tracing only in feature select and attach user email to feedback by MathurAditya724 in #688

Internal Changes 🔧

• (docs) Gitignore generated command docs, extract fragments by BYK in #696
• (eval) Replace OpenAI with Anthropic SDK in init-eval judge by betegon in #683
• (init) Use markdown pipeline for spinner messages by betegon in #686
• Regenerate skill files and command docs by github-actions[bot] in 584ec0e0

---

_{🤖 This preview updates automatically when you update the PR.}

[github-actions]

PR Preview Action v1.8.1
🚀 View preview at https://cli.sentry.dev/pr-preview/pr-700/
Built to branch gh-pages at 2026-04-09 12:28 UTC. Preview will be ready when the GitHub Pages deployment is complete.

[github-actions]

Codecov Results 📊

✅ 134 passed | Total: 134 | 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 98.53%. Project has 1480 uncovered lines.
❌ Project coverage is 95.46%. Comparing base (base) to head (head).

Files with missing lines (1)

File	Patch %	Lines
src/types/dashboard.ts	97.92%	⚠️ 1 Missing

Coverage diff

@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
- Coverage    95.47%    95.46%    -0.01%
==========================================
  Files          224       224         —
  Lines        32534     32591       +57
  Branches         0         0         —
==========================================
+ Hits         31059     31111       +52
- Misses        1475      1480        +5
- Partials         0         0         —

---

Generated by Codecov Action

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 522cb2f. Configure here.}