fix: update CID warning hybrid guidance

Author: LocNguyenSGU

java/opendataloader-pdf-core/src/main/java/org/opendataloader/pdf/processors/ContentFilterProcessor.java

@@ -78,7 +78,7 @@ public static List<IObject> getFilteredContents(String inputPdfName, List<IChunk
             LOGGER.log(Level.WARNING,
                 "Page {0}: {1,number,#.#%} of characters are replacement characters (U+FFFD). "
                 + "This PDF likely contains CID-keyed fonts without ToUnicode mappings. "
-                + "Text extraction may be incomplete. Consider using --hybrid-mode for OCR fallback.",
+                + "Text extraction may be incomplete. Consider enabling hybrid OCR fallback with --hybrid docling-fast.",
                 new Object[]{pageNumber + 1, replacementCharRatio});
         }
         TextProcessor.replaceUndefinedCharacters(pageContents, config.getReplaceInvalidChars());

java/opendataloader-pdf-core/src/test/java/org/opendataloader/pdf/processors/CidFontDetectionTest.java

@@ -120,9 +120,11 @@ public void testCidPdfWarningLogEmitted() throws IOException {
             );
 
             boolean hasReplacementWarning = warnings.stream()
-                .anyMatch(w -> w.contains("replacement characters"));
+                .anyMatch(w -> w.contains("replacement characters")
+                    && w.contains("--hybrid docling-fast")
+                    && !w.contains("--hybrid-mode for OCR fallback"));
             Assertions.assertTrue(hasReplacementWarning,
-                "Expected WARNING log about replacement characters");
+                "Expected WARNING log about replacement characters with actionable hybrid guidance");
         } finally {
             logger.removeHandler(handler);
         }