Carlos Florêncio
102 lines
4.1 KiB
Markdown
102 lines
4.1 KiB
Markdown
---
|
|
status: current
|
|
system: tasks
|
|
requirements:
|
|
- REQ-TASKS-COMMAND-PANEL-ARCHIVED-TASKS-001
|
|
---
|
|
|
|
# Command Panel Archived Task Results System Design
|
|
|
|
## Purpose and boundaries
|
|
|
|
This design defines the task-system contract for archive state in command-panel
|
|
task results. It does not change archive state or task navigation.
|
|
|
|
The workspace task-list response already includes `archived_at`. No backend,
|
|
WebSocket, or persistence change is necessary.
|
|
|
|
## Requirement mapping
|
|
|
|
| Requirement | Design sections |
|
|
| --- | --- |
|
|
| `REQ-TASKS-COMMAND-PANEL-ARCHIVED-TASKS-001` | [Archive classification](#archive-classification), [Result-row presentation](#result-row-presentation), [Responsive behavior](#responsive-behavior), [Tests](#tests) |
|
|
|
|
## Components and responsibilities
|
|
|
|
- `useInlineTaskSearchEffect` queries unarchived matches first and requests only the remaining archived matches when needed.
|
|
- `TaskResultItem` derives archive presentation from the HTTP task result.
|
|
- The existing task-list `Archived` translation supplies the visible and accessible label.
|
|
- The existing command item remains the only interactive element in the result row.
|
|
|
|
## Archive classification
|
|
|
|
`Task.archived_at` is the only archive source for command-panel task results.
|
|
Terminal workflow states do not mean that a task is archived.
|
|
|
|
`fetchMatchingTasks` first requests page one with the default archive filter and
|
|
the requested display limit. If fewer non-archived matches are returned, it
|
|
requests page one in `onlyArchived` mode with the remaining limit. It
|
|
concatenates the two responses, preserving backend order within each group.
|
|
This keeps the search bounded to at most two requests and ensures an active
|
|
match remains visible when archived matches are newer.
|
|
|
|
The empty-query task preview continues to request active tasks only. Its
|
|
defensive filter also uses `archived_at` and does not exclude terminal states.
|
|
|
|
## Result-row presentation
|
|
|
|
When `archived_at` is present, `TaskResultItem` changes three visual cues:
|
|
|
|
- An `IconArchive` glyph replaces `TaskStateIcon` in the leading icon slot.
|
|
- An outline **Archived** badge replaces the workflow-step badge.
|
|
- Semantic muted-foreground classes replace active task colors for the icon, title, badge, and metadata.
|
|
|
|
The archive glyph uses `role="img"` and the localized **Archived** label. It
|
|
also has a stable test identifier.
|
|
|
|
The command item keeps its selected background and focus behavior. Muted
|
|
classes do not use row opacity because opacity also weakens selection feedback.
|
|
|
|
Non-archived results keep the shared activity icon and workflow-step badge.
|
|
Selection continues to call the existing task navigation handler.
|
|
|
|
## Responsive behavior
|
|
|
|
Desktop and phone layouts continue to use the same command-panel result row.
|
|
The archived badge replaces one existing badge, so the row gains no new width.
|
|
|
|
The title remains the flexible, truncated element. Metadata remains hidden on a
|
|
phone, and the command panel remains the scroll owner.
|
|
|
|
The nearest phone example is the task row in
|
|
`mobile-command-palette-scopes.spec.ts`. This change affects content and color
|
|
only.
|
|
|
|
## Failure and recovery
|
|
|
|
If `archived_at` is absent, the result uses its normal activity icon and
|
|
workflow-step badge. Unknown optional task fields do not remove the result.
|
|
|
|
If an archived task is selected, the existing task route shows the archived
|
|
detail and its current recovery action.
|
|
|
|
## Tests
|
|
|
|
Hook tests cover archive ordering, bounded active-then-archived requests, and
|
|
prove that terminal workflow state does not imply archive state.
|
|
|
|
Component tests cover the archive icon, accessible label, badge replacement,
|
|
muted classes, and unchanged selection callback.
|
|
|
|
Desktop Playwright coverage searches for active and archived matches. It proves
|
|
their order and the archive cues before selection.
|
|
|
|
Phone Playwright coverage proves the same cues, readable title space, and no
|
|
document-level horizontal overflow.
|
|
|
|
## Related specifications
|
|
|
|
- [Task Archive Confirmation](archive-confirmation.md)
|
|
- [Task Activity Icons](../../ui/system-design/command-panel-task-activity-icons.md)
|
|
- [Task Workspace Content Search](../../ui/requirements/task-workspace-content-search.md)
|