Carlos Florêncio
97 lines
3.8 KiB
Markdown
97 lines
3.8 KiB
Markdown
---
|
|
id: "04-sidebar-queue-position"
|
|
title: "Show sidebar queue position"
|
|
status: completed
|
|
wave: 4
|
|
depends_on: ["03-kanban-queue-sections"]
|
|
plan: "plan.md"
|
|
spec: "../../specs/tasks/system-design/wip-limit-pull-system.md"
|
|
---
|
|
|
|
# Task 04: Show Sidebar Queue Position
|
|
|
|
## Acceptance
|
|
|
|
- `useWorkspaceSidebarTasks` derives each destination-resident queued task's
|
|
position, total queue size, and destination title from workspace workflow
|
|
snapshots using the shared queue helper.
|
|
- `TaskSwitcherItem` carries WIP queue status in a field distinct from the
|
|
existing `queuedCount`, which remains the pending-agent-prompt count.
|
|
- Desktop and mobile sidebar mappers pass the same queue object to shared
|
|
`TaskItem` rendering for tasks and subtasks.
|
|
- All pointer presentations show one compact localized queue icon whose tooltip
|
|
states `Position N of M in STEP queue`. Its focusable trigger supports hover,
|
|
keyboard focus, and touch focus, so the position does not depend on hover.
|
|
- The icon is accessible status information, remains shrink-safe, and does not
|
|
create horizontal overflow or a second scroll owner.
|
|
- Live task updates and queue promotions update or remove the chip without a
|
|
reload.
|
|
- Unit/component tests prove mapping, ordering, render/hide behavior, icon and
|
|
tooltip accessibility, subtasks, and separation from the queued-prompt badge.
|
|
|
|
## TDD Sequence
|
|
|
|
1. Add hook, mapper, and `TaskItem` tests for WIP queue status. Run RED.
|
|
2. Add the distinct item type and derive queue data once in the workspace hook.
|
|
3. Render the responsive localized chip in shared task rows.
|
|
4. Run focused tests and frontend gates GREEN.
|
|
|
|
## Verification
|
|
|
|
```bash
|
|
cd apps
|
|
pnpm --filter @kandev/web exec vitest run \
|
|
lib/kanban/wip-queue.test.ts \
|
|
hooks/domains/kanban/use-workspace-sidebar-tasks.test.ts \
|
|
components/task/task-session-sidebar-item.test.ts \
|
|
components/task/mobile/session-task-switcher-sheet-hooks.test.ts \
|
|
components/task/task-item.test.tsx
|
|
pnpm --filter @kandev/web run typecheck
|
|
pnpm --filter @kandev/web run lint
|
|
pnpm --filter @kandev/web run i18n:check
|
|
pnpm --filter @kandev/web run i18n:ratchet
|
|
```
|
|
|
|
## Implementation Result
|
|
|
|
- `useWorkspaceSidebarTasks` derives WIP queue positions from the shared
|
|
helper and carries them separately from the existing queued-agent-prompt
|
|
count.
|
|
- Desktop and mobile task switchers share the same queue status mapping and
|
|
focusable queue icon. The icon tooltip states `Position N of M in STEP queue`.
|
|
- Focused mapper and component tests passed with the exact 5-file, 71-test
|
|
Vitest run above. The queue icon disappears after promotion and preserves
|
|
mobile width constraints in managed E2E coverage.
|
|
- The SSR Kanban boot payload includes WIP limits and task admission metadata,
|
|
so the initial column count does not wait for a later snapshot refresh.
|
|
|
|
## Files Likely Touched
|
|
|
|
- `apps/web/hooks/domains/kanban/use-workspace-sidebar-tasks.ts`
|
|
- `apps/web/hooks/domains/kanban/use-workspace-sidebar-tasks.test.ts`
|
|
- `apps/web/components/task/task-switcher-types.ts`
|
|
- `apps/web/components/task/task-session-sidebar-item.ts`
|
|
- `apps/web/components/task/mobile/session-task-switcher-sheet-hooks.ts`
|
|
- `apps/web/components/task/task-item.tsx`
|
|
- `apps/web/components/task/task-item-stats-row.tsx`
|
|
- related focused test files
|
|
- `apps/web/src/locales/en/sidebar.json`
|
|
- `apps/web/src/locales/pseudo/sidebar.json`
|
|
- `apps/web/src/locales/pt-pt/sidebar.json`
|
|
- `apps/web/src/locales/zh-cn/sidebar.json`
|
|
|
|
## Dependencies
|
|
|
|
Task 03 supplies the shared queue-order helper and Kanban terminology.
|
|
|
|
## Parallelism
|
|
|
|
`sequential`
|
|
|
|
## Output Contract
|
|
|
|
Record RED/GREEN evidence, the distinct queue type, fine/coarse-pointer
|
|
behavior, live-update behavior, i18n and type/lint results, files changed, and
|
|
exact command results. Update this task and `plan.md` status in the same
|
|
implementation conversation.
|