Files
kandev/docs/specs/ui/add-panel-pr-submenu.md
T

68 lines
3.0 KiB
Markdown

---
status: draft
created: 2026-07-31
owner: Kandev frontend
---
# Task Add-Panel PR Submenu
## Why
The task-view "+" add-panel menu lists every GitHub pull request linked to the
task as a flat menu row. A task can carry up to ten or more linked PRs (e.g.
multi-repo work), which makes the dropdown too tall to use — it spills past the
viewport or requires scrolling through a wall of identical rows.
## What
- The task-view "+" add-panel menu (dockview group header and empty-group
watermark) keeps its current behavior for tasks with zero or one linked
GitHub PR: a single PR renders as one inline menu row, and no PR renders
nothing.
- When a task has more than one linked GitHub PR, the menu shows a single
**Pull requests** sub-menu trigger instead of inline PR rows.
- Opening the sub-menu reveals one row per linked PR. Each row opens that PR's
dockview panel when selected, exactly as the current inline row does.
- Per-PR rows inside the sub-menu keep the current disambiguating label used for
multi-PR tasks (`PR #42 — owner/repo`), while single-PR tasks keep the plain
`PR #42` label on the inline row.
- The sub-menu trigger carries the same add-panel menu styling as other rows and
an icon consistent with the PR rows.
- Per-PR rows keep their existing stable test identifiers so automated tests can
select them from within the sub-menu.
- The sub-menu must work with the existing Radix dropdown primitives on desktop
(pointer hover and keyboard). The feature is desktop-only: mobile renders
`SessionMobileLayout`, which has no "+" add-panel entry point, so the sub-menu
has no mobile presentation.
## Scenarios
- **GIVEN** a task with no linked GitHub PRs, **WHEN** the user opens the "+"
add-panel menu, **THEN** no PR row or Pull requests trigger is shown.
- **GIVEN** a task with exactly one linked GitHub PR, **WHEN** the user opens
the "+" add-panel menu, **THEN** one inline PR row labeled `PR #N` is shown
and no Pull requests sub-menu trigger is shown.
- **GIVEN** a task with two linked GitHub PRs, **WHEN** the user opens the "+"
add-panel menu, **THEN** the menu shows a Pull requests sub-menu trigger and
no inline PR rows.
- **GIVEN** a task with two linked GitHub PRs and the Pull requests sub-menu
open, **WHEN** the user selects a PR row, **THEN** that PR's dockview panel
opens and the row is labeled `PR #N — owner/repo`.
- **GIVEN** a task with three linked GitHub PRs, **WHEN** the user opens the "+"
add-panel menu, **THEN** the main menu height is bounded by the single Pull
requests trigger instead of three PR rows.
## Out of scope
- Changing PR ordering, linking, or provider data.
- Grouping GitLab merge requests into a sub-menu; MR rows keep their current
inline rendering.
- Changing the PR top-bar button, the multi-PR CI popover, or the PR picker
dialog.
- Mobile presentation of the sub-menu: `SessionMobileLayout` has no "+"
add-panel entry point, so there is no mobile sub-menu to style.
## Implementation plan
[Task Add-Panel PR Submenu implementation plan](../../plans/add-panel-pr-submenu/plan.md)