docs: added informative debug message and @todo flag for cache miss handling