Files
kandev/docs/specs/ui/requirements/command-panel-sidebar-task-reveal.md
T
2026-08-26 21:05:08 +00:00

70 lines
3.1 KiB
Markdown

---
status: active
system: ui
created: 2026-08-05
owners:
- kandev
---
# 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.
## Implementation plan
- [Initial command-panel sidebar task reveal](../../../plans/command-panel-sidebar-task-reveal/plan.md)
- [Command-center task focus repair](../../../plans/command-center-task-focus/plan.md)