Command-panel Sidebar Task Reveal Requirements

Overview

When the desktop task list overflows, a task opened from Cmd+K can be outside the visible part of the sidebar. The UI owns the scroll and visual-feedback contract that helps the user find the newly active task without changing task state or sidebar preferences.

Requirements

REQ-UI-COMMAND-PANEL-SIDEBAR-TASK-REVEAL-001: Command-panel Sidebar Task Reveal

Intent: Keep the command-selected task visible and easy to locate in the desktop sidebar after navigation.

Acceptance criteria

AC-UI-COMMAND-PANEL-SIDEBAR-TASK-REVEAL-001.1: Selecting a task from Cmd+K shall open the task's canonical route.
AC-UI-COMMAND-PANEL-SIDEBAR-TASK-REVEAL-001.2: When the selected task has a rendered row outside the visible desktop task-list viewport, the sidebar shall scroll smoothly. It shall use the minimum distance that makes the row visible.
AC-UI-COMMAND-PANEL-SIDEBAR-TASK-REVEAL-001.3: After navigation, the selected row shall keep the normal active-task state and show a transient reveal cue that distinguishes it from adjacent rows.
AC-UI-COMMAND-PANEL-SIDEBAR-TASK-REVEAL-001.4: When the row is already fully visible, the sidebar shall not reposition it, but the transient reveal cue shall still identify it.
AC-UI-COMMAND-PANEL-SIDEBAR-TASK-REVEAL-001.5: The reveal shall not move keyboard focus, scroll the document, reset the task list, or change a saved sidebar view or collapse preference.
AC-UI-COMMAND-PANEL-SIDEBAR-TASK-REVEAL-001.6: The reveal shall wait through bounded asynchronous route and sidebar rendering. It shall start only after the canonical route and matching active-task state render.
AC-UI-COMMAND-PANEL-SIDEBAR-TASK-REVEAL-001.7: When another task is selected before an earlier reveal finishes, the latest request shall cancel the earlier request. The stale row shall not scroll or receive the cue.
AC-UI-COMMAND-PANEL-SIDEBAR-TASK-REVEAL-001.8: When the active sidebar view, a collapsed branch, or a hidden desktop sidebar omits the row, task navigation shall still succeed without changing sidebar preferences.
AC-UI-COMMAND-PANEL-SIDEBAR-TASK-REVEAL-001.9: When the user prefers reduced motion, the sidebar shall use immediate minimum-distance scrolling and a non-animated transient cue.
AC-UI-COMMAND-PANEL-SIDEBAR-TASK-REVEAL-001.10: On a phone viewport, Cmd+K shall keep the existing direct task-route outcome and shall not target the CSS-hidden desktop sidebar.

Out of scope

Changing task search, task-route loading, or backend task APIs.
Changing filters, saved views, task ordering, or collapsed branches so a row renders.
Expanding the desktop sidebar rail when the user has collapsed it.
Opening or redesigning the mobile task-switcher sheet.

3.1 KiB Raw Blame History