kandev/docs/plans/queued-task-moves/task-04-sidebar-queue-position.md

id, title, status, wave, depends_on, plan, spec

id	title	status	wave	depends_on	plan	spec
04-sidebar-queue-position	Show sidebar queue position	completed	4	03-kanban-queue-sections	plan.md	../../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

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.