* <p>Example usage:</p>
 * <pre>
 * SuggestRequest suggestRequest = new SuggestRequest();
 * suggestRequest.setIndex("my_index");
 * suggestRequest.setQuery("example query");
 * suggestRequest.setSize(5);
 * suggestRequest.addTag("tag1");
 * suggestRequest.addRole("role1");
 * suggestRequest.addField("field1");
 * suggestRequest.addKind("kind1");
 * suggestRequest.addLang("en");
 * suggestRequest.setSuggestDetail(true);

import org.opensearch.search.SearchHit;

/**
 * Creates SuggestResponse instances from OpenSearch search results.
 *
 * <p>This class encapsulates the response creation logic extracted from SuggestRequest,
 * including duplicate word handling and first-word matching prioritization.</p>
 */
public class SuggestResponseCreator {

    private final String query;
    private final int size;

import org.opensearch.index.query.functionscore.ScoreFunctionBuilders;

/**
 * Builds OpenSearch queries for suggestion requests.
 *
 * <p>This class encapsulates the query building logic extracted from SuggestRequest,
 * including reading conversion, normalization, and function score query construction.</p>
 */
public class SuggestQueryBuilder {

    private final ReadingConverter readingConverter;

import org.opensearch.index.query.QueryBuilder;
import org.opensearch.index.query.TermQueryBuilder;
import org.opensearch.index.query.functionscore.FunctionScoreQueryBuilder;

/**
 * Tests for SuggestRequest query building methods.
 * These tests focus on the buildQuery, buildFilterQuery, and buildFunctionScoreQuery methods.
 */
public class SuggestRequestQueryBuildingTest {

    private TestableSuggestRequest request;

---

## Quick Reference

### Essential Files

| File | Purpose |
|------|---------|
| `Suggester.java` | Main entry point, index management |
| `SuggestIndexer.java` | Indexing operations |
| `SuggestRequest.java` | Query building, scoring |
| `SuggestSettings.java` | Configuration |
| `SuggestItem.java` | Domain model |
| `DefaultContentsParser.java` | Text processing pipeline |

### Key Constants

```java