1. Always run `mvn test` after changes
2. Run `mvn formatter:format` before committing
3. Add license headers to new files with `mvn license:format`
4. Maintain backwards compatibility - deprecate before removing

/**
 * <p>
 * Encapsulates parameters of MojoExecutionListener callback methods and is meant to provide API evolution path should
 * it become necessary to introduce new parameters in the existing callbacks in the future.
 * </p>
 * <strong>Note:</strong> This class is part of work in progress and can be changed or removed without notice.
 *
 * @see MojoExecutionListener

/**
 * <p>
 * Encapsulates parameters of ProjectExecutionListener callback methods and is meant to provide API evolution path
 * should it become necessary to introduce new parameters in the existing callbacks in the future.
 * </p>
 * <strong>Note:</strong> This class is part of work in progress and can be changed or removed without notice.
 *
 * @see ProjectExecutionListener
 * @since 3.1.2
 */

    public void test_concatValues_duplicatesRemoved() {
        java.util.List<String> dest = new java.util.ArrayList<>();
        dest.add("existing");

        SuggestItem.concatValues(dest, "new", "existing", "new", "another");

        assertEquals(3, dest.size());
        assertTrue(dest.contains("existing"));
        assertTrue(dest.contains("new"));
        assertTrue(dest.contains("another"));
    }

 */
@DisplayName("UpgradeContext")
class UpgradeContextTest {

    @Test
    @DisplayName("should create context successfully")
    void shouldCreateContextSuccessfully() {
        // Use existing test utilities to create a context
        UpgradeContext context = TestUtils.createMockContext(Paths.get("/test"));

        // Verify context is created and basic methods work

    out_path.parent.mkdir(parents=True, exist_ok=True)
    original_content = en_path.read_text(encoding="utf-8")
    old_translation: str | None = None
    if out_path.exists():
        print(f"Found existing translation: {out_path}")
        old_translation = out_path.read_text(encoding="utf-8")
    print(f"Translating {en_path} to {language} ({language_name})")
    agent = Agent("openai:gpt-5")

    prompt_segments = [

will select the device:

	GOOS=ios GOARCH=arm64 CGO_ENABLED=1 CC_FOR_TARGET=$(pwd)/../misc/ios/clangwrap.sh ./all.bash

Note that the go_darwin_$GOARCH_exec wrapper uninstalls any existing app identified by
the bundle id before installing a new app. If the uninstalled app is the last app by
the developer identity, the device might also remove the permission to run apps from

        } catch (IllegalArgumentException e) {
            assertEquals("Both name and dataStore parameters are required. name: null, dataStore: null", e.getMessage());
        }
    }

    // Test getDataStore with existing name
    @Test
    public void test_getDataStore_existingName() {
        TestDataStore dataStore = new TestDataStore("TestStore");
        dataStoreFactory.add("myStore", dataStore);

mkdir -p /mnt/export/${USER}/bin

# Copy the built binary to the chroot directory
cp $(go env GOPATH)/bin/minio /mnt/export/${USER}/bin/minio
chmod +x /mnt/export/${USER}/bin/minio
```

Alternatively, if you have an existing legacy binary, you can still use it, but note that it will not receive updates.

Bind your `proc` mount to the target chroot directory

```
sudo mount --bind /proc /mnt/export/${USER}/proc
```

        assertNotNull(queryFieldConfig.notAnalyzedFieldSet);
        assertTrue(queryFieldConfig.notAnalyzedFieldSet.size() > 0);
    }

    @Test
    public void test_init_withExistingFields() {
        // Set existing fields before initialization
        String[] existingResponseFields = { "field1", "field2" };
        queryFieldConfig.setResponseFields(existingResponseFields);