Download File

## [2.3.0] - 2026-09-10 ### Added - **`ConfigFile`**: `asJsonObject()` / `getRoot()` returning a deep clone of the root JSON object. - **`ConfigFile`**: Path-based accessors — `getByPath`, `setByPath`, `getStringByPath`, `getIntByPath`, `getBooleanByPath`, `getDoubleByPath` (with default-value overloads). - **`ConfigFile`**: `setBackupRotation(int)` for multi-generation `.bak` rotation on corrupted config recovery. - **`ConfigFile`**: `reloadIfChanged()` to reload only when file size or mtime changed. - **`ConfigFile`**: `setStableSave(boolean)` opt-in deterministic save via `JsonLib.stableStringify`. - **`JaumlConfig`**: `invalidate(String, String)`, `invalidate(Path)`, and `clearCache()` for cache management. - **`JsonMigrator`**: `setPreferredVersionKey(String)` to control which version key is read and updated during migration. - **`JsonLib`**: `detectVersion(JsonElement, String preferredKey)` overload checking a preferred key first. - **`JaumlInitializer`**: `initializeWithDemoConfig()` for explicit demo config workflow; `initialize()` now skips demo config write in production. - **`JsonSchema`**: Optional constraint keywords — `enum`, `minimum`/`maximum`, `minLength`/`maxLength`, `additionalProperties: false`, and `minItems`/`maxItems`. Schemas that omit these keywords behave exactly as before. - **`tn.naizo.jauml.util`**: Optional utility package — `PlatformUtil`, `JaumlLogger`, `ModuleVersion`, and `Lifecycle` helpers. Additive only; core config API unchanged. ### Changed - **Build (Phase 4)**: Explicit `compileOnly` Gson and SLF4J API dependencies in all MultiLoader workspaces; `26.1.2` migrated from `buildSrc` to composite `build-logic` (aligned with `26.2`). See `BUILD.md`. - **`ConfigFile`**: `save()` now writes atomically via a temp file and `Files.move` (with `ATOMIC_MOVE` when supported). - **`JaumlInitializer`**: `initialize()` logs compatibility and library version but only writes demo config in development environments or when `-Djauml.writeDemoConfig=true`. - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.0**. - **README**: Fixed usage example to use `asJsonObject()` and typed getters instead of nonexistent `config.get()`. ### Fixed - Documentation and migration guide updated for 2.3.0 compatibility matrix while preserving 2.0 API support.