diff --git a/internal/database/querier.go b/internal/database/querier.go
index 85be4d40..2f64b511 100644
--- a/internal/database/querier.go
+++ b/internal/database/querier.go
@@ -463,6 +463,9 @@ type Querier interface {
 	ListMediaItemsMissingHash(ctx context.Context) ([]MediaItems, error)
 	ListMediaItemsSorted(ctx context.Context, arg ListMediaItemsSortedParams) ([]ListMediaItemsSortedRow, error)
 	ListPendingHashConflicts(ctx context.Context) ([]ListPendingHashConflictsRow, error)
+	// DeviceID NULL = every device's pending items (the queue processor's
+	// enumerator passes NULL; a bare `device_id = NULL` never matches, which
+	// silently disabled the offline flush until 2026-10-17).
 	ListPendingSyncQueueItems(ctx context.Context, arg ListPendingSyncQueueItemsParams) ([]SyncQueue, error)
 	ListProcessingIssuesByLibrary(ctx context.Context, libraryID pgtype.UUID) ([]ListProcessingIssuesByLibraryRow, error)
 	ListSyncConflictsByMediaItem(ctx context.Context, arg ListSyncConflictsByMediaItemParams) ([]SyncConflicts, error)