* governing permissions and limitations under the License.
 */
package org.codelibs.fess.llm;

/**
 * Represents the result of intent detection from user input.
 * Contains the detected intent type, Fess query, and other metadata.
 */
public class IntentDetectionResult {

    private final ChatIntent intent;
    private final String query;
    private final String documentUrl;

 *   <li>If a new edge needs to be created, the outgoing edges of the acquired locks are traversed
 *       to check for a cycle that reaches the lock to be acquired. If no cycle is detected, a new
 *       "safe" edge is created.
 *   <li>If a cycle is detected, an "unsafe" (cyclic) edge is created to represent a potential
 *       deadlock situation, and the appropriate Policy is executed.
 * </ul>
 *

    private StorageClientFactory() {
        // Utility class
    }

    /**
     * Auto-detect storage type from endpoint URL.
     *
     * @param endpoint the storage endpoint URL
     * @return detected storage type
     */
    public static StorageType detectStorageType(final String endpoint) {
        if (StringUtil.isBlank(endpoint)) {

async def stream_logs() -> AsyncIterable[ServerSentEvent]:
    logs = [
        "2025-01-01 INFO  Application started",
        "2025-01-01 DEBUG Connected to database",
        "2025-01-01 WARN  High memory usage detected",
    ]
    for log_line in logs:

                return l;
            }
        }
        return null;
    }

    /**
     * Sets the language detector.
     *
     * @param detector The language detector.
     */
    public void setDetector(final LanguageDetector detector) {
        this.detector = detector;
    }

    /**
     * Creates a script for updating a document with language information.
     *

 * either express or implied. See the License for the specific language
 * governing permissions and limitations under the License.
 */
package org.codelibs.fess.llm;

/**
 * Represents the intent type detected from a user's chat message.
 */
public enum ChatIntent {

    /** User wants to search for documents in Fess */
    SEARCH("search"),

    /** User wants a summary of a specific document */

     */
    boolean isAvailable();

    // RAG workflow methods

    /**
     * Detects the intent of a user message.
     *
     * @param userMessage the user's message
     * @return the detected intent with extracted keywords
     */
    IntentDetectionResult detectIntent(String userMessage);

    /**
     * Detects the intent of a user message with conversation history context.
     *

            Files.createDirectories(filePath.getParent());
            final Path realParent = filePath.getParent().toRealPath();
            if (!realParent.startsWith(realBase)) {
                logger.warn("Symlink traversal detected: url={}, realParent={}, realBase={}", url, realParent, realBase);
                return;
            }
            final byte[] bytes = content.getBytes(StandardCharsets.UTF_8);

        }

        // Validate path to prevent path traversal attacks
        if (expectedBaseDir != null && !isValidUploadPath(uploadFile, expectedBaseDir)) {
            logger.warn("Path traversal attempt detected: fileName={}", fileName);
            throwValidationError(messages -> messages.addErrorsDesignFileNameIsInvalid("designFileName"), this::asListHtml);
            return null;
        }

and there are no missing null checks.

## Decision

Use "NullAway" in JSpecify mode to check for null-related errors in Java code.

Consider improper uses of `null` detected by NullAway a compilation error (not a warning, and not a separate CI job to test).

Do not suppress NullAway errors without a justification.