Plans — Track Progress

Live progress banner, per-piece status pills, plus Pause/Resume/Cancel/Stop-everything controls — everything you need while the queue is running.

What is it?

The Plan Detail page in execution mode. The header swaps to a control toolbar that changes by status. The banner above the tabs shows live counts (done / generating / queued), a progress bar, and a $ spent / $ cap meter that turns amber at 80% and rose at 100%. Each piece in the Pieces tab carries a status pill: Generating, Done, Failed, or Skipped.

When should I use it?

The plan is in Running, Paused, Review, or Cap reached state and you want to watch or steer it.
A piece failed and you want to retry it.
You want to stop everything immediately because the output looks wrong.

How to use it

Open the running plan. The progress banner appears above the tabs.
Pause halts the queue at the next tick (an in-flight piece still finishes its draft).
Resume restarts a paused plan.
Continue with the rest appears in Review status — click it after reviewing the first piece in Asset Library.
Lift cap appears in Cap reached status — opens a dialog to raise the cap or remove it entirely.
Cancel terminates the queue politely (current piece finishes; the rest are abandoned).
Stop everything is the red two-click kill button — it halts immediately and any in-flight draft saves with an ORPHAN badge in Asset Library.
On a single failed piece, click the inline retry link next to its status pill.
When multiple pieces fail, click Retry N failed in the header — flips every failed piece back to pending in one transaction and resumes the queue.

Tips and best practices

The cost meter is the single most important thing to watch — if it climbs faster than the progress bar, your average piece is more expensive than estimated.
After clicking Pause/Cancel/Kill, the banner explains the grace behaviour ("piece N is finishing its current tick").
Refresh-safe: leave the page, come back later — every status comes from Firestore, nothing is in-memory only.
Once a plan is running you don't have to stay on this page — the sidebar footer shows a running plans pill with a count and a popover listing every active plan across every client. Click any row in the popover to jump back to that plan's detail page. See Sidebar navigation for the full behaviour.

Gotchas and limits

Pieces hit a maximum of 3 retry attempts (across CF crashes + manual retries). After that the piece hard-fails — you have to fix the underlying issue or skip it.
A stuck piece (in Generating for over 10 minutes) auto-resets on the next queue tick. Bumps the attempts counter.
Kill orphans the in-flight draft to Asset Library as an ORPHAN; the rest of the queue stops. Orphans aren't deleted automatically — clean them up when you're sure.