diff --git a/src/terminal_colors.rs b/src/terminal_colors.rs
index 9be5d61..4c80353 100644
--- a/src/terminal_colors.rs
+++ b/src/terminal_colors.rs
@@ -7,6 +7,10 @@ use std::{
 use crossterm::event::{Event, KeyCode, KeyEventKind, KeyEventState, KeyModifiers};
 
 const QUERY_TIMEOUT: Duration = Duration::from_millis(250);
+// TODO: Remove periodic polling once a released Herdr fix reliably delivers palette-ready
+// DEC 2031 notifications, including changes with unchanged light/dark preference.
+// Verify notification-triggered queries return fresh colors before removing this fallback.
+// Upstream: https://github.com/herdrdev/herdr/issues/4183
 const REFRESH_INTERVAL: Duration = Duration::from_secs(1);
 const ESCAPE_TIMEOUT: Duration = Duration::from_millis(25);
 const HEADERS: [&[u8]; 3] = [b"11;", b"4;1;", b"4;2;"];