Queue Management

One-Liner

The Queue Management page provides centralized control over issue execution queues with scheduler controls, status monitoring, and session pool management.

---

Pain Points Solved

Pain Point	Current State	Queue Solution
Disorganized execution	No unified task queue	Centralized queue with grouped items
Unknown scheduler status	Can't tell if scheduler is running	Real-time status indicator (idle/running/paused)
No execution control	Can't start/stop queue processing	Start/Pause/Stop controls with confirmation
Concurrency limits	Too many simultaneous sessions	Configurable max concurrent sessions
No visibility	Don't know what's queued	Stats cards + item list with status tracking
Resource waste	Idle sessions consuming resources	Session pool overview with timeout config

---

Overview

Location: ccw/frontend/src/pages/QueuePage.tsx (legacy), ccw/frontend/src/components/terminal-dashboard/QueuePanel.tsx (current)

Purpose: View and manage issue execution queues with scheduler controls, progress tracking, and session pool management.

Access: Navigation → Issues → Queue tab OR Terminal Dashboard → Queue floating panel

Layout:

+--------------------------------------------------------------------------+
|  Queue Panel Header                                                        |
+--------------------------------------------------------------------------+
|  Scheduler Status Bar                                                       |
|  +----------------+  +-------------+  +-------------------------------+         |
|  | Status Badge   |  | Progress    |  | Concurrency (2/2)            |         |
|  +----------------+  +-------------+  +-------------------------------+         |
+--------------------------------------------------------------------------+
|  Scheduler Controls                                                          |
|  +--------+  +--------+  +--------+  +-----------+                      |
|  | Start  |  | Pause  |  | Stop   |  | Config    |                      |
|  +--------+  +--------+  +--------+  +-----------+                      |
+--------------------------------------------------------------------------+
|  Queue Items List                                                           |
|  +---------------------------------------------------------------------+    |
|  | QueueItemRow (status, issue_id, session_key, actions)              |    |
|  | - Status icon (pending/executing/completed/blocked/failed)         |    |
|  | - Issue ID / Item ID display                                        |    |
|  | - Session binding info                                              |    |
|  | - Progress indicator (for executing items)                          |    |
|  +---------------------------------------------------------------------+    |
|  | [More queue items...]                                               |    |
|  +---------------------------------------------------------------------+    |
+--------------------------------------------------------------------------+
|  Session Pool Overview (optional)                                           |
|  +--------------------------------------------------------------------------+
|  | Active Sessions | Idle Sessions | Total Sessions                      |
|  +--------------------------------------------------------------------------+

---

Live Demo

QueueManagementDemo

加载中...

demo QueueItemStatusDemo #QueueItemStatusDemo.tsx :::

Scheduler Config Demo

SchedulerConfigDemo

加载中...

---

Configuration

Scheduler Config

Setting	Type	Default	Description
maxConcurrentSessions	number	2	Maximum sessions running simultaneously
sessionIdleTimeoutMs	number	60000	Idle session timeout in milliseconds
resumeKeySessionBindingTimeoutMs	number	300000	Resume key binding timeout in milliseconds

Queue Item Structure

interface QueueItem {
  item_id: string;
  issue_id?: string;
  sessionKey?: string;
  status: QueueItemStatus;
  execution_order: number;
  created_at?: number;
  updated_at?: number;
}

---

Accessibility

• Keyboard Navigation:

  • Tab - Navigate through queue items and controls
  • Enter/Space - Activate buttons
  • Escape - Close dialogs

• ARIA Attributes:

  • aria-label on control buttons
  • aria-live regions for status updates
  • aria-current for active queue item
  • role="list" on queue items list

• Screen Reader Support:

  • Status changes announced
  • Progress updates spoken
  • Error messages announced

---

Related Links

• Issue Hub - Unified issues, queue, and discovery management
• Terminal Dashboard - Terminal-first workspace with integrated queue panel
• Discovery - Discovery session tracking
• Sessions - Session management and details