* This class provides functionality to track, record, and report statistics
 * about crawler operations including timing data, performance metrics, and
 * operational events. It uses an internal cache to maintain statistics
 * objects and provides methods to begin tracking, record events, and
 * finalize statistics collection.
 *
 */
public class CrawlerStatsHelper {

    /**

            super.storeChildUrl(url, parentUrl, weight, depth);
        }
    }

    /**
     * Retrieves the appropriate crawler client for the given URL based on configured rules.
     * This method uses client rules to determine which specific client implementation
     * should be used for crawling the URL, falling back to the default client if no
     * specific rule matches.
     *

        return query -> filter.parse(query, chain);
    }

    /**
     * Creates the default filter chain that performs the actual query parsing.
     * This chain uses the Lucene query parser to parse the query string.
     *
     * @return the default filter chain
     */
    protected FilterChain createDefaultFilterChain() {
        return query -> {
            try {

 * This class provides support for executing Groovy scripts with parameter binding
 * and DI container integration.
 *
 * <p>Thread Safety: This class is thread-safe. Each cached entry holds its own
 * GroovyClassLoader. The cache uses Guava Cache with segment-based locking for
 * lock-free concurrent reads. Each evaluate() call creates a new Script instance
 * to ensure thread isolation of bindings.</p>
 *

        }
    }

    /**
     * Processes a streaming chat request using Server-Sent Events (SSE).
     * Uses the enhanced multi-phase RAG flow with intent detection and result evaluation.
     *
     * @param request the HTTP request
     * @param response the HTTP response
     * @throws IOException if an I/O error occurs

        assertNotNull(roleList, "roleList should not be null");
        assertNotNull(groupIdsForParentLookup, "groupIdsForParentLookup should not be null");
    }

    /**
     * Test that scheduleParentGroupLookup uses TimeoutManager correctly.
     * This test verifies the method signature and can be called via reflection.
     */
    @Test
    public void test_scheduleParentGroupLookup_schedulesTask() throws Exception {

 * operations in the search engine. It supports recursive crawling with configurable depth and access count limits.
 *
 * <p>The implementation uses an executor service for concurrent processing of file operations and maintains
 * a cache of URLs to be deleted for batch processing. It handles redirect following and child URL discovery
 * during the crawling process.</p>
 */

                executorService.shutdownNow();
            }
        }
    }

    /**
     * Performs a search operation using rank fusion across available searchers.
     * If only one searcher is available, uses the main searcher. Otherwise, performs
     * concurrent searches across multiple searchers and fuses the results.
     *
     * @param query the search query string

        defaultSettings.put("onelogin.saml2.contacts.support.email_address", "******@****.***");
    }

    /**
     * Builds a default URL for SAML endpoints.
     * Uses the configured base URL or defaults to http://localhost:8080 for compatibility
     * with common SAML IdP configurations.
     *
     * @param path the path to append to the base URL
     * @return the complete URL

curl -X PUT "http://localhost:8080/api/admin/documents/bulk" \
  -H "Content-Type: application/x-ndjson" \
  -u admin:admin \
  --data-binary @fess-documents.json
```

#### Index Settings Migration

Fess uses OpenSearch/Elasticsearch internally, so you can:

1. Export index mappings and settings from source
2. Apply custom analyzers in Fess's `fess_config.properties`
3. Create synonym dictionaries in Fess's dictionary directory