@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
        }

**Fault Tolerance**:
- `FaultTolerantClient` wrapper (retry, circuit breaker)
- Graceful degradation (e.g., robots.txt parsing continues on errors)

---

## Key Components

### Crawler (`Crawler.java`)

Main orchestrator for crawling operations.

**Key Methods**:
```java
String execute()                // Start crawling, return session ID
void addUrl(String url)         // Add URL to queue