@DisplayName("StrategyOrchestrator")
class StrategyOrchestratorTest {

    private StrategyOrchestrator orchestrator;
    private List<UpgradeStrategy> mockStrategies;

    @BeforeEach
    void setUp() {
        mockStrategies = List.of(mock(UpgradeStrategy.class), mock(UpgradeStrategy.class), mock(UpgradeStrategy.class));
        orchestrator = new StrategyOrchestrator(mockStrategies);
    }

    private UpgradeContext createMockContext() {

 * </ul>
 */
public abstract class AbstractUpgradeGoal implements Goal {

    private final StrategyOrchestrator orchestrator;

    @Inject
    public AbstractUpgradeGoal(StrategyOrchestrator orchestrator) {
        this.orchestrator = orchestrator;
    }

    /**
     * Executes the upgrade goal.
     * Template method that calls doUpgrade and optionally saves modifications.
     */

import org.apache.maven.api.di.Inject;
import org.apache.maven.api.di.Named;
import org.apache.maven.api.di.Singleton;
import org.apache.maven.cling.invoker.mvnup.UpgradeContext;

/**
 * domtrip-based orchestrator for executing different upgrade strategies.
 *
 * <p>This class provides the same functionality as StrategyOrchestrator but works
 * with domtrip-based strategies for superior formatting preservation.
 *

     */
    private static class TestableAbstractUpgradeGoal extends AbstractUpgradeGoal {

        TestableAbstractUpgradeGoal(StrategyOrchestrator orchestrator) {
            super(orchestrator);
        }

        @Override
        protected boolean shouldSaveModifications() {
            return true; // Enable actual file operations for tests
        }

import jakarta.annotation.Resource;
import jakarta.servlet.http.HttpServletRequest;

/**
 * Client class for RAG (Retrieval-Augmented Generation) chat functionality.
 *
 * Orchestrates the multi-phase RAG workflow including session management,
 * document search, and delegation to LlmClientManager for LLM operations.
 * Prompt construction and LLM-specific logic is handled by LlmClient implementations.
 *