Update the build.gradle file to make the plugin compatible with latest versions of OpenSearch

Issue:
The Querqy plugin doesn't honor the user access controls provided by OpenSearch.

Access Control: https://opensearch.org/docs/latest/security-plugin/access-control/index/
More about FGAC: https://opensearch.org/blog/technical-posts/2020/10/fine-grained-access-control-for-search/

Issue:
Create CI workflows for test automation. This should include building the plugin and running unit/integration tests.
More on Plugin standards here

https://github.com/opensearch-project/opensearch-plugins

Release Steps

Preparation

• Assign this issue to a release owner(s)
• Finalize feature freeze date (Sept 16th 2022)
• Finalize release date (Sept 19th 2022)
• Merge all relevant dependabot PRs

CI/CD & Testing

• Make sure CI/CD passes over the branch being released (default: main)
• Sanity Testing: install the plugin and test functionalities

Code complete

• Make sure new features/bug fixes are complete and added
• Add release notes with the latest release number
• Verify all issues labelled 2.3.0 features are part of the release

Release

• Cut branch 2.3 from main after all related PRs are merged.
• Create a tag with pre-built package and code assets for the release
• Upload the package to maven (@JohannesDaniel)

Post-Release

• Add a retrospective issue to the repo with the release tag
• Update this release template with improvements, if any

The current readme file is outdated. It doesn't give users ability to directly install and run querqy on their OpenSearch Clusters. Below are the steps to update readme:

1. Add steps to build the code and install the plugin to OpenSearch.
2. Add sample API calls to see if the plugin works as expected for the user.

I am encountering difficulties installing a plugin in OpenSearch version 2.12. Despite following the documented installation procedures, the plugin installation process fails consistently. This issue is hindering our ability to utilize crucial functionalities within our OpenSearch environment.
It will be really appreciated.

Issue:

The current license header needs to be changed from ASF License to:

/*
 * SPDX-License-Identifier: Apache-2.0
 *
 * Querqy for OpenSearch Contributors require contributions made to
 * this file be licensed under the Apache-2.0 license or a
 * compatible open source license.
 *
 * Copyright Querqy for OpenSearch Contributors. See
 * GitHub history for details.
 */

Also, need to update the same in contributing.md document.

The project is not "Licensed to the Apache Software Foundation (ASF)" -> therefore the header must be changed

Issue:
OpenSearch released 2.4.0 on 09/15. Let's bump up the version for Querqy plugin to match the OpenSearch versioning.

Create a Querqy plugin version for OpenSearch v2.3.0

• Update OpenSearch dependency
• Deal with rewriter configurations > 32k. ES v8.2 started constraining keyword field length to this limit due to an underlying Lucene constraint. We've handled this in querqy-elasticsearch by splitting the config string and make it a multi-valued field (querqy/querqy-elasticsearch@f28482e#diff-4df2f4a9444dba31b05fec9e95c89ece96ff12ce0c0f4806142232066b38055e and querqy/querqy-elasticsearch@f28482e#diff-32be4fd4b3f6e7fdd2bad5997fd60c60b5f3e2237c3855d4e7dd1d18b5d8602d ). The issue was revealed in this integration test: https://github.com/querqy/querqy-elasticsearch/blob/d1bece60a5779f89fcd2f2f860444614d1e1d58f/src/test/java/querqy/elasticsearch/RewriterIntegrationTest.java#L103

When using the word break rewriter in a query, the following exception is thrown:

[querqy-example/t3iVrtE-TXC5S2dfxjWV9Q] QueryShardException[failed to create query: this IndexReader is closed]; nested: AlreadyClosedException[this IndexReader is closed];
	at org.opensearch.index.query.QueryShardContext.toQuery(QueryShardContext.java:402)
	at org.opensearch.index.query.QueryShardContext.toQuery(QueryShardContext.java:385)
	at org.opensearch.search.SearchService.parseSource(SearchService.java:902)
	at org.opensearch.search.SearchService.createContext(SearchService.java:739)
	at org.opensearch.search.SearchService.executeQueryPhase(SearchService.java:441)
	at org.opensearch.search.SearchService.access$500(SearchService.java:154)
	at org.opensearch.search.SearchService$2.lambda$onResponse$0(SearchService.java:414)
	at org.opensearch.action.ActionRunnable.lambda$supply$0(ActionRunnable.java:71)
	at org.opensearch.action.ActionRunnable$2.doRun(ActionRunnable.java:86)
	at org.opensearch.common.util.concurrent.AbstractRunnable.run(AbstractRunnable.java:50)
	at org.opensearch.common.util.concurrent.TimedRunnable.doRun(TimedRunnable.java:57)
	at org.opensearch.common.util.concurrent.ThreadContext$ContextPreservingAbstractRunnable.doRun(ThreadContext.java:756)
	at org.opensearch.common.util.concurrent.AbstractRunnable.run(AbstractRunnable.java:50)
	at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1130)
	at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:630)
	at java.base/java.lang.Thread.run(Thread.java:832)
Caused by: org.apache.lucene.store.AlreadyClosedException: this IndexReader is closed
	at org.apache.lucene.index.IndexReader.ensureOpen(IndexReader.java:257)
	at org.apache.lucene.index.CompositeReader.getContext(CompositeReader.java:99)
	at org.apache.lucene.index.CompositeReader.getContext(CompositeReader.java:53)
	at org.apache.lucene.search.IndexSearcher.<init>(IndexSearcher.java:183)
	at org.apache.lucene.search.IndexSearcher.<init>(IndexSearcher.java:170)
	at querqy.lucene.contrib.rewrite.wordbreak.Collector.<init>(Collector.java:142)
	at querqy.lucene.contrib.rewrite.wordbreak.MorphologicalWordBreaker.breakWord(MorphologicalWordBreaker.java:61)
	at querqy.lucene.contrib.rewrite.wordbreak.WordBreakCompoundRewriter.decompound(WordBreakCompoundRewriter.java:177)
	at querqy.lucene.contrib.rewrite.wordbreak.WordBreakCompoundRewriter.visit(WordBreakCompoundRewriter.java:161)
	at querqy.lucene.contrib.rewrite.wordbreak.WordBreakCompoundRewriter.visit(WordBreakCompoundRewriter.java:27)
	at querqy.model.Term.accept(Term.java:59)
	at querqy.lucene.contrib.rewrite.wordbreak.WordBreakCompoundRewriter.visit(WordBreakCompoundRewriter.java:145)
	at querqy.lucene.contrib.rewrite.wordbreak.WordBreakCompoundRewriter.visit(WordBreakCompoundRewriter.java:27)
	at querqy.model.DisjunctionMaxQuery.accept(DisjunctionMaxQuery.java:25)
	at querqy.model.AbstractNodeVisitor.visit(AbstractNodeVisitor.java:15)
	at querqy.lucene.contrib.rewrite.wordbreak.WordBreakCompoundRewriter.rewrite(WordBreakCompoundRewriter.java:91)
	at querqy.rewrite.RewriteChain.rewrite(RewriteChain.java:66)
	at querqy.lucene.QueryParsingController.process(QueryParsingController.java:197)
	at querqy.opensearch.QuerqyProcessor.parseQuery(QuerqyProcessor.java:76)
	at querqy.opensearch.query.QuerqyQueryBuilder.doToQuery(QuerqyQueryBuilder.java:205)
	at org.opensearch.index.query.AbstractQueryBuilder.toQuery(AbstractQueryBuilder.java:116)
	at org.opensearch.index.query.QueryShardContext.lambda$toQuery$3(QueryShardContext.java:386)
	at org.opensearch.index.query.QueryShardContext.toQuery(QueryShardContext.java:398)
	... 15 more

The word break rewriter uses the index as dictionary during the rewriting. querqy.opensearch.rewriter.WordBreakCompoundRewriterFactory#createRewriterFactory passes an IndexShard reference to the rewriter when loading it. This reference is used later to get an IndexReader reference, which is used to apply the index lookups.

Make feature querqy/querqy#328 available for Querqy for OS. This is mainly a matter of extending the rewriter configuration (see https://docs.querqy.org/querqy/rewriters/common-rules.html#configuration boostMethod for Solr).

Issue:
The Plugin installation fails using the OpenSearch Plugin CLI Tool

bin/opensearch-plugin install file:///usr/share/opensearch/querqy-opensearch.zip

Exception in thread "main" java.nio.file.NoSuchFileException: /usr/share/opensearch/plugins/.installing-12975521533611387320/plugin-descriptor.properties

Compare https://github.com/querqy/querqy/blob/master/.github/dependabot.yml

Discuss how and where to add main documentation:

• Avoid duplicate documentation?
• Documentation added to https://docs.querqy.org/ ?
• What to add to README.md?

Tests are generally skipped right now. When tests are run in Intellij (with Gradle in the background), no tests are executed with the message "Test events were not eceived".

When running tests with gradle directly, e. g. with ./gradlew :test --tests "querqy.opensearch.query.GeneratedTest", the build is done successfully, but no tests are executed and no test result reports are written.

Builds can be done without any problems (but tests are not executed).

Retrospective Issue

Initial suggestions

1. Update release step to cut a branch from main for the specific plugin version (in this release 2.3) [UPDATED]
2. Add a step to update the querqy-docs repository for plugin user related release notes
3. Add support for automated maven release

Related release steps #40

Keeping this issue thread active till end of next week for release retrospection.

• release steps
• clear old issues
• labels on readme on code etc.
• branching strategy ... GH action for auto version bumps