tui: generation queue overlay

charles commented

2026-04-11 13:03:30 +00:00

Owner

User story

As a user generating images, I want a queue overlay showing all pending, running, and finished jobs with live progress, so that I can cancel, retry, or jump to results without losing my place.

Acceptance criteria

Overlay

Opened from any screen with Ctrl+Q; Esc closes
Lists jobs with: id (short), prompt (truncated to available width), status (queued / running / done / failed), progress bar, duration
Subscribes to loom-core generation events; updates live without user input
Sorts: running → queued → finished (most recent first)

Actions

d cancels a queued or running job via the loom-core control API
r retries a failed job (re-enqueues with the original params)
Enter on a finished job navigates to Gallery and selects the resulting image
c clears all finished jobs from the list (not from the gallery)

Status-bar integration

Current queue depth and a single-running-job progress percentage are mirrored in the status bar (wired from the global navigation ticket)

Tests

Unit test: a mock loom-core event stream drives the overlay through queued → running → done transitions
Unit test: cancel action sends the expected control message

Out of scope

Generating images (Generate screen tickets)
Gallery navigation target (Gallery ticket)

References

Spec §4.1.2 "Generation queue"
Spec §4.8 "Queue Overlay"

## User story As a user generating images, I want a queue overlay showing all pending, running, and finished jobs with live progress, so that I can cancel, retry, or jump to results without losing my place. ## Acceptance criteria ### Overlay - [ ] Opened from any screen with `Ctrl+Q`; `Esc` closes - [ ] Lists jobs with: id (short), prompt (truncated to available width), status (queued / running / done / failed), progress bar, duration - [ ] Subscribes to `loom-core` generation events; updates live without user input - [ ] Sorts: running → queued → finished (most recent first) ### Actions - [ ] `d` cancels a queued or running job via the `loom-core` control API - [ ] `r` retries a failed job (re-enqueues with the original params) - [ ] `Enter` on a finished job navigates to Gallery and selects the resulting image - [ ] `c` clears all finished jobs from the list (not from the gallery) ### Status-bar integration - [ ] Current queue depth and a single-running-job progress percentage are mirrored in the status bar (wired from the global navigation ticket) ### Tests - [ ] Unit test: a mock `loom-core` event stream drives the overlay through queued → running → done transitions - [ ] Unit test: cancel action sends the expected control message ## Out of scope - Generating images (Generate screen tickets) - Gallery navigation target (Gallery ticket) ## References - Spec §4.1.2 "Generation queue" - Spec §4.8 "Queue Overlay"

charles added this to the loom-tui v0.1.0 milestone

2026-04-11 13:03:30 +00:00

charles added the

area:generate

type:user-story

labels

2026-04-11 13:03:30 +00:00

charles referenced this issue

2026-04-11 13:07:50 +00:00

tui: tracking — loom-tui v0.1.0 roadmap & implementation order #47

charles referenced this issue

2026-04-11 16:10:05 +00:00