}

    /**
     * Extracts the canonical session ID by removing any suffix after the first hyphen.
     * If the session ID contains a hyphen, returns the portion before the first hyphen.
     * Otherwise, returns the original session ID.
     *
     * @param sessionId the session ID to process
     * @return the canonical session ID (portion before first hyphen, or original if no hyphen)
     */

    }

    /**
     * Retrieves or creates the result document IDs cache from the session.
     * The cache is implemented as an LRU map to limit memory usage.
     *
     * @param session the HTTP session
     * @return the result document IDs cache map
     */
    private Map<String, String[]> getResultDocIdsCache(final HttpSession session) {
        @SuppressWarnings("unchecked")

        });
        return asJson(new ApiResponse().status(Status.OK).result());
    }

    /**
     * Deletes all old crawling info sessions except currently running ones.
     *
     * @return JSON response indicating the deletion status
     */
    // DELETE /api/admin/crawlinginfo/all
    @Execute
    public JsonResponse<ApiResult> delete$all() {

                final HttpSession session = req.getSession(false);
                if (session != null) {
                    session.setAttribute(SCREEN_WIDTH, width);
                }
            } else {
                final HttpSession session = req.getSession(false);
                if (session != null) {
                    final Integer width = (Integer) session.getAttribute(SCREEN_WIDTH);

     * This method starts crawling only for the data configurations
     * specified in the configIdList parameter.
     *
     * @param sessionId unique identifier for this crawling session
     * @param configIdList list of data configuration IDs to crawl
     */
    public void crawl(final String sessionId, final List<String> configIdList) {

    /**
     * Adds a finished session ID to the cleanup list.
     * This method is thread-safe and adds the session ID to be cleaned up later.
     *
     * @param sessionId the crawler session ID that has finished processing
     */
    public void addFinishedSessionId(final String sessionId) {
        synchronized (finishedSessionIdList) {
            finishedSessionIdList.add(sessionId);
        }
    }

    /**

        final String sessionId = "session123";
        indexUpdater.addFinishedSessionId(sessionId);
        assertTrue(indexUpdater.finishedSessionIdList.contains(sessionId));
    }

    // Test addFinishedSessionId with multiple sessions
    public void test_addFinishedSessionId_multiple() {
        indexUpdater.addFinishedSessionId("session1");
        indexUpdater.addFinishedSessionId("session2");

     */
    public static class Options {

        /** Session ID for the crawling session. If not provided, a timestamp-based ID will be generated. */
        @Option(name = "-s", aliases = "--sessionId", metaVar = "sessionId", usage = "Session ID")
        public String sessionId;

        /** Name for the crawling session for identification purposes. */

[versions]
agp = "8.12.2"
biz-aQute-bnd = "7.1.0"
checkStyle = "11.0.1"
com-squareup-moshi = "1.15.2"
com-squareup-okio = "3.16.0"
de-mannodermaus-junit5 = "1.8.0"
graalvm = "24.2.2"
#noinspection UnusedVersionCatalogEntry
junit-platform = "1.13.4"
kotlinx-serialization = "1.9.0"
ksp = "2.2.10-2.0.2"
lintGradle = "1.0.0-alpha05"
mockserverClient = "5.15.0"
org-bouncycastle = "1.81"
org-conscrypt = "2.5.2"

        if (options.sessionId != null) {
            options.sessionId = options.sessionId.replaceAll("-", "_");
        }

        // Check that sessionId was sanitized (hyphens replaced with underscores)
        assertEquals("test_session_123", options.sessionId);
    }

    public void test_process_withPropertiesPath() throws Exception {
        // Test that properties path is properly handled