feat(m4): persist the download queue across restarts

The queue/scheduler lived only in renderer memory, so saved/scheduled and other
pending downloads were silently lost on quit (audit M4). Persist them:

- main: queue.ts store (proven cached-atomic createJsonStore, queue.json) +
  queue:list / queue:save IPC; QUEUE_MAX cap.
- shared: PersistedQueueItem = the durable subset of DownloadItem (runtime-only
  progress/speed/eta/sizeLabel/finishing dropped).
- renderer: mirror the persistable items on every queue change (a signature over
  the subset means progress ticks don't re-save; main's jsonStore coalesces the
  writes) and rehydrate on launch via an App useEffect. Pure mappers extracted
  to store/queuePersist.ts and unit-tested.

Restore semantics: downloading -> queued (yt-dlp continues the .part), saved +
scheduledFor survives so the promoter fires when due, paused/error return
actionable; completed/canceled are never persisted. A queueHydrated gate stops a
launch-time store change from wiping queue.json before it's read.

Reconciles ROADMAP.md. typecheck + 268 tests + eslint + prettier green.
(OS-level quit/relaunch cycle is worth a manual smoke test.)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

This commit is contained in:

Devon Bontrager

2026-07-01 09:34:55 -04:00

parent 63687aaec3

commit 0a681f864f

13 changed files with 320 additions and 10 deletions

									
										src/main/constants.ts
									
		+2
		
												View File
												
				@@ -63,3 +63,5 @@ export const ERRORLOG_MAX_ENTRIES = 200

				export const TEMPLATES_MAX = 100

				/** Indexed media items across all sources (media-items.json). */

				export const MEDIA_ITEMS_MAX = 20_000

				/** Persisted download-queue rows (queue.json, M4) — generous; a whole channel can be queued. */

				export const QUEUE_MAX = 10_000