Files
kandev/docs/specs/ui/sidebar-task-completion-icons.md
T
2026-07-30 14:47:49 +01:00

52 lines
2.5 KiB
Markdown

---
status: shipped
created: 2026-07-30
owner: kandev
---
# Sidebar Task Completion Icons
## Why
The task sidebar currently gives every finished turn the same green circled check, so users
cannot tell whether the agent merely finished its current turn or the task also reached the end
of its workflow.
## What
- A task with a finished turn that is not on the last step of its workflow shows the green
`progress-check` icon with a dashed circular outline.
- A task with a finished turn that is on the last step of its workflow keeps the current green
`circle-check` icon with a continuous circular outline.
- The last step is the final ordered step of the workflow that owns the task.
- Only an exact match between the task's current step and its workflow's last known step is
treated as workflow completion. Missing workflow or step data uses the progress-check icon
rather than claiming the workflow is complete.
- Desktop sidebar rows and the mobile task-switcher drawer expose the same distinction through
their shared task-row rendering.
- Running, background work, scheduling, pending clarification, pending permission, backlog,
failure, and cancellation icon precedence remains unchanged.
## Scenarios
- **GIVEN** a task whose turn is finished on a non-final workflow step, **WHEN** the task appears
in the desktop sidebar, **THEN** its green status icon is `progress-check` with a dashed circle.
- **GIVEN** a task whose turn is finished on the final workflow step, **WHEN** the task appears in
the desktop sidebar, **THEN** its green status icon is the existing continuous
`circle-check`.
- **GIVEN** finished tasks on non-final and final workflow steps, **WHEN** the user opens the
mobile task-switcher drawer, **THEN** the rows show the same progress-versus-complete icon
distinction as desktop.
- **GIVEN** a finished task whose workflow steps are unavailable or do not contain its current
step, **WHEN** the row renders, **THEN** it shows `progress-check`.
- **GIVEN** a task with a higher-priority active or pending state, **WHEN** the row renders,
**THEN** that existing state icon is shown regardless of the task's workflow position.
## Out of scope
- Changing task or session lifecycle states, workflow transitions, or step ordering.
- Changing status icons on kanban cards, graphs, task headers, recent-task switchers, or Office
surfaces.
- Adding backend, API, persistence, or feature-flag state.
- Changing sidebar or mobile task-switcher layout, navigation, touch targets, or scroll behavior.