test: add unit tests for --hybrid-mode and --hybrid-ocr options

Add 16 tests covering CLI option parsing and HybridConfig behavior:
- CLIOptionsTest: 10 tests for option parsing and validation
- HybridDocumentProcessorTest: 6 tests for mode/ocr config methods

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

Author: bundolee

java/opendataloader-pdf-cli/src/test/java/org/opendataloader/pdf/cli/CLIOptionsTest.java

@@ -357,4 +357,102 @@ void testCreateConfig_withWhitespaceImageDir() throws ParseException {
 
         assertNull(config.getImageDir()); // whitespace-only treated as null (use default)
     }
+
+    // ===== Hybrid Mode Option Tests =====
+
+    @Test
+    void testDefineOptions_containsHybridModeOption() {
+        assertTrue(options.hasOption("hybrid-mode"));
+    }
+
+    @Test
+    void testDefineOptions_containsHybridOcrOption() {
+        assertTrue(options.hasOption("hybrid-ocr"));
+    }
+
+    @Test
+    void testCreateConfig_withHybridModeAuto() throws ParseException {
+        String[] args = {"--hybrid", "docling", "--hybrid-mode", "auto", testPdf.getAbsolutePath()};
+        CommandLine cmd = parser.parse(options, args);
+
+        Config config = CLIOptions.createConfigFromCommandLine(cmd);
+
+        assertEquals("auto", config.getHybridConfig().getMode());
+        assertFalse(config.getHybridConfig().isFullMode());
+    }
+
+    @Test
+    void testCreateConfig_withHybridModeFull() throws ParseException {
+        String[] args = {"--hybrid", "docling", "--hybrid-mode", "full", testPdf.getAbsolutePath()};
+        CommandLine cmd = parser.parse(options, args);
+
+        Config config = CLIOptions.createConfigFromCommandLine(cmd);
+
+        assertEquals("full", config.getHybridConfig().getMode());
+        assertTrue(config.getHybridConfig().isFullMode());
+    }
+
+    @Test
+    void testCreateConfig_withInvalidHybridMode() throws ParseException {
+        String[] args = {"--hybrid-mode", "invalid", testPdf.getAbsolutePath()};
+        CommandLine cmd = parser.parse(options, args);
+
+        assertThrows(IllegalArgumentException.class, () -> {
+            CLIOptions.createConfigFromCommandLine(cmd);
+        });
+    }
+
+    @Test
+    void testCreateConfig_withHybridOcrAuto() throws ParseException {
+        String[] args = {"--hybrid", "docling", "--hybrid-ocr", "auto", testPdf.getAbsolutePath()};
+        CommandLine cmd = parser.parse(options, args);
+
+        Config config = CLIOptions.createConfigFromCommandLine(cmd);
+
+        assertEquals("auto", config.getHybridConfig().getOcrMode());
+        assertFalse(config.getHybridConfig().isForceOcr());
+    }
+
+    @Test
+    void testCreateConfig_withHybridOcrForce() throws ParseException {
+        String[] args = {"--hybrid", "docling", "--hybrid-ocr", "force", testPdf.getAbsolutePath()};
+        CommandLine cmd = parser.parse(options, args);
+
+        Config config = CLIOptions.createConfigFromCommandLine(cmd);
+
+        assertEquals("force", config.getHybridConfig().getOcrMode());
+        assertTrue(config.getHybridConfig().isForceOcr());
+    }
+
+    @Test
+    void testCreateConfig_withInvalidHybridOcr() throws ParseException {
+        String[] args = {"--hybrid-ocr", "invalid", testPdf.getAbsolutePath()};
+        CommandLine cmd = parser.parse(options, args);
+
+        assertThrows(IllegalArgumentException.class, () -> {
+            CLIOptions.createConfigFromCommandLine(cmd);
+        });
+    }
+
+    @Test
+    void testCreateConfig_defaultHybridModeAndOcr() throws ParseException {
+        String[] args = {"--hybrid", "docling", testPdf.getAbsolutePath()};
+        CommandLine cmd = parser.parse(options, args);
+
+        Config config = CLIOptions.createConfigFromCommandLine(cmd);
+
+        assertEquals("auto", config.getHybridConfig().getMode());
+        assertEquals("auto", config.getHybridConfig().getOcrMode());
+    }
+
+    @Test
+    void testCreateConfig_withDoclingBackend() throws ParseException {
+        String[] args = {"--hybrid", "docling", testPdf.getAbsolutePath()};
+        CommandLine cmd = parser.parse(options, args);
+
+        Config config = CLIOptions.createConfigFromCommandLine(cmd);
+
+        assertEquals("docling", config.getHybrid());
+        assertTrue(config.isHybridEnabled());
+    }
 }

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

@@ -304,4 +304,58 @@ public void testHybridRequestWithHtmlOnly() {
         Assertions.assertFalse(request.wantsMarkdown());
         Assertions.assertTrue(request.wantsHtml());
     }
+
+    // ===== HybridConfig Mode Tests =====
+
+    @Test
+    public void testHybridConfigModeDefaults() {
+        HybridConfig config = new HybridConfig();
+
+        Assertions.assertEquals(HybridConfig.MODE_AUTO, config.getMode());
+        Assertions.assertFalse(config.isFullMode());
+    }
+
+    @Test
+    public void testHybridConfigModeFullMode() {
+        HybridConfig config = new HybridConfig();
+        config.setMode(HybridConfig.MODE_FULL);
+
+        Assertions.assertEquals(HybridConfig.MODE_FULL, config.getMode());
+        Assertions.assertTrue(config.isFullMode());
+    }
+
+    @Test
+    public void testHybridConfigOcrDefaults() {
+        HybridConfig config = new HybridConfig();
+
+        Assertions.assertEquals(HybridConfig.OCR_AUTO, config.getOcrMode());
+        Assertions.assertFalse(config.isForceOcr());
+    }
+
+    @Test
+    public void testHybridConfigOcrForce() {
+        HybridConfig config = new HybridConfig();
+        config.setOcrMode(HybridConfig.OCR_FORCE);
+
+        Assertions.assertEquals(HybridConfig.OCR_FORCE, config.getOcrMode());
+        Assertions.assertTrue(config.isForceOcr());
+    }
+
+    @Test
+    public void testDoclingBackendEnabled() {
+        Config config = new Config();
+        config.setHybrid("docling");
+
+        Assertions.assertTrue(config.isHybridEnabled());
+        Assertions.assertEquals("docling", config.getHybrid());
+    }
+
+    @Test
+    public void testDoclingEffectiveUrl() {
+        HybridConfig config = new HybridConfig();
+
+        // docling uses same URL as docling-fast
+        Assertions.assertEquals(HybridConfig.DOCLING_FAST_DEFAULT_URL, config.getEffectiveUrl("docling"));
+        Assertions.assertEquals(HybridConfig.DOCLING_FAST_DEFAULT_URL, config.getEffectiveUrl("docling-fast"));
+    }
 }