# CLAUDE.md - Fess Suggest Project Guide

> AI assistant guidance for the Fess Suggest project - a Java library providing intelligent search suggestions built on OpenSearch.

## Project Overview

**Fess Suggest** delivers auto-completion, search suggestions, and popular word analytics with multi-language support.

**Technology Stack:**
- Java 21+, Maven
- OpenSearch (provided dependency)
- Apache Lucene (query parsing, text analysis)

                                                    name="search"
                                                    value="<la:message key="labels.crud_button_search" />">
                                                <i class="fa fa-search" aria-hidden="true"></i>
                                                <la:message key="labels.crud_button_search"/>

                                                    name="search"
                                                    value="<la:message key="labels.crud_button_search" />">
                                                <i class="fa fa-search" aria-hidden="true"></i>
                                                <la:message key="labels.crud_button_search"/>

     * Uses caching to improve performance for repeated requests.
     *
     * @param searchRequestType the type of search request
     * @param seed the seed value for popular word generation
     * @param tags array of tags to filter results
     * @param roles array of roles to filter results
     * @param fields array of fields to search in

import jakarta.annotation.Resource;

/**
 * API action for admin related content management.
 * Provides RESTful API endpoints for managing related content settings in the Fess search engine.
 * Related content settings define content relationships and associations for search results.
 */
public class ApiAdminRelatedcontentAction extends FessApiAdminAction {

import org.lastaflute.web.ruts.multipart.MultipartFormFile;
import org.lastaflute.web.validation.Required;

/**
 * Form for uploading stopwords files to the Fess search engine.
 * Stopwords are common words that should be ignored during search indexing and querying.
 * This form is used in the admin interface to upload custom stopwords dictionary files.
 */
public class UploadForm {

    /**

/**
 * Response processor implementation for the Fess search engine.
 * This processor extends DefaultResponseProcessor to provide additional
 * processing capabilities through the ingest framework, allowing for
 * custom data transformation and enrichment during the crawling process.
 *
 * <p>It supports pluggable ingesters that can modify the result data
 * before it is stored in the search index.</p>
 */

 * This interface provides methods for storing documents, tracking processing metrics,
 * and committing changes to the search index.
 */
public interface IndexUpdateCallback {

    /**
     * Stores a document in the search index with the specified parameters and data.
     *
     * @param paramMap the data store parameters containing configuration and metadata

 */
package org.codelibs.fess.query;

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
import org.apache.lucene.search.BoostQuery;
import org.apache.lucene.search.Query;
import org.codelibs.fess.entity.QueryContext;
import org.codelibs.fess.exception.InvalidQueryException;
import org.lastaflute.core.message.UserMessages;

    private final long maxItems;

    /**
     * Constructs a Trans2FindNext2 request for continuing a file search.
     *
     * @param config the configuration to use
     * @param sid the search ID from a previous FindFirst2 response
     * @param resumeKey the resume key for continuing the search
     * @param filename the last filename from the previous response
     * @param batchCount the number of entries to return