feat(versioning): bump to v2.2.0, enhance changelog automation, and improve ArtistSearch initialization

- Updated to version 2.2.0 across all projects and documentation.
- Adjusted changelog logic to prevent relocation of the `[Unreleased]` section above Jekyll front matter.
- Enhanced ArtistSearch initialization to support relational migrations and schema creation for non-relational providers.

Author: sphildreth

docs/VERSION

@@ -1 +1 @@
-2.1.4
+2.2.0

docs/pages/changelog.md

@@ -23,6 +23,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.2.0] - 2026-07-11
+
 ### Added
 
 - Admin health checks now recognize DecentDB error 8 and automatically open a
@@ -46,6 +48,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   stores them as `BLOB`, and `ALTER COLUMN TYPE` to `UUID` is unsupported by DecentDB
   (only `INT64`, `FLOAT64`, `TEXT`, `BOOL`). The no-op migration records itself as applied
   without attempting the unsupported `ALTER`, keeping `MigrateAsync` stable.
+- Updated the DecentDB providers to `2.16.1`, SkiaSharp managed and Linux native
+  assets to `4.150.0`, Radzen to `11.1.3`, and related runtime, UI, test, and
+  tooling dependencies.
+- Chart editing, user, user-group, and podcast detail routes now bind public
+  GUID API keys directly instead of internal numeric IDs or custom string
+  parsing.
+- Enabled solution-wide XML documentation output so build-time unused-using
+  analysis runs consistently, and corrected malformed API documentation and
+  formatter configuration.
 
 ### Fixed
 
@@ -57,6 +68,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - ArtistSearch database is now auto-created on first use when the `.ddb` file is absent,
   eliminating the "database is empty or not initialized" error that previously required
   manual intervention.
+- Paged ArtistSearch queries now retrieve the requested page before counting
+  results, preventing DecentDB positional parameters from carrying across
+  commands and causing missing-parameter failures.
+- Chart edit navigation now uses the chart API key, and missing chart album
+  matching is accent-insensitive.
+- Aligned the SkiaSharp managed and Linux native packages and moved image
+  drawing to the supported sampling API, preventing native `119.0` and managed
+  `150.0` incompatibility failures during image processing.
+- Solution Debug and CI analyzer builds now complete without dependency,
+  obsolete API, or XML documentation warnings.
+- Version bump automation now promotes release notes without moving the fresh
+  Unreleased heading above the changelog's Jekyll front matter.
+- ArtistSearch initialization now uses migrations for relational databases and
+  schema creation for non-relational providers, preventing OpenSubsonic
+  `getTopSongs` failures in in-memory hosts.
+
+### Security
+
+- Pinned `Microsoft.OpenApi` to patched version `2.7.5`, preventing crafted
+  circular schema references from terminating the process during OpenAPI
+  document parsing.
 
 ## [2.1.4] - 2026-06-16
 

scripts/bump_version.sh

@@ -149,13 +149,9 @@ if [[ -f "$CHANGELOG" ]]; then
 
     # Check if [Unreleased] section exists
     if grep -q "^## \[Unreleased\]" "$CHANGELOG"; then
-      # Replace [Unreleased] header with versioned header + date
-      sed -i "s|^## \[Unreleased\]|## [${VERSION}] - ${today}|" "$CHANGELOG"
-
-      # Insert a fresh [Unreleased] section before the new version header
-      sed -i "1i\\
-## [Unreleased]\\
-" "$CHANGELOG"
+      # Keep the fresh Unreleased section at the existing content location so
+      # Jekyll front matter remains the first block in the document.
+      sed -i "s|^## \[Unreleased\]|## [Unreleased]\\n\\n## [${VERSION}] - ${today}|" "$CHANGELOG"
 
       log_update "$CHANGELOG" "promoted [Unreleased] → [$VERSION] - $today"
     else

src/Melodee.Blazor/Melodee.Blazor.csproj

@@ -16,7 +16,7 @@
 
     <!-- Auto-incrementing version -->
 
-    <VersionPrefix>2.1.4</VersionPrefix>
+    <VersionPrefix>2.2.0</VersionPrefix>
 
     <VersionSuffix>build$([System.DateTime]::UtcNow.ToString("yyyyMMddHHmmss"))</VersionSuffix>
     <AssemblyVersion>$(VersionPrefix).0</AssemblyVersion>

src/Melodee.Cli/Melodee.Cli.csproj

@@ -9,7 +9,7 @@
     <Deterministic>false</Deterministic>
     <NoWarn>$(NoWarn);NU1507</NoWarn>
 
-    <VersionPrefix>2.1.4</VersionPrefix>
+    <VersionPrefix>2.2.0</VersionPrefix>
 
     <VersionSuffix>build$([System.DateTime]::UtcNow.ToString("yyyyMMddHHmmss"))</VersionSuffix>
     <AssemblyVersion>$(VersionPrefix).0</AssemblyVersion>

src/Melodee.Common/Melodee.Common.csproj

@@ -9,7 +9,7 @@
     <NoWarn>$(NoWarn);NU1507</NoWarn>
 
     <!-- Auto-incrementing version -->
-    <VersionPrefix>2.1.4</VersionPrefix>
+    <VersionPrefix>2.2.0</VersionPrefix>
     <VersionSuffix>build$([System.DateTime]::UtcNow.ToString("yyyyMMddHHmmss"))</VersionSuffix>
     <AssemblyVersion>$(VersionPrefix).0</AssemblyVersion>
     <FileVersion>$(VersionPrefix).0</FileVersion>

src/Melodee.Common/Services/SearchEngines/ArtistSearchEngineService.cs

@@ -87,7 +87,15 @@ public async Task InitializeAsync(IMelodeeConfiguration? configuration = null,
 
         await using (var scopedContext = await artistSearchEngineServiceDbContextFactory.CreateDbContextAsync(cancellationToken).ConfigureAwait(false))
         {
-            await scopedContext.Database.MigrateAsync(cancellationToken);
+            if (scopedContext.Database.IsRelational())
+            {
+                await scopedContext.Database.MigrateAsync(cancellationToken).ConfigureAwait(false);
+            }
+            else
+            {
+                await scopedContext.Database.EnsureCreatedAsync(cancellationToken).ConfigureAwait(false);
+            }
+
             await BackfillLocalArtistAliasLookupAsync(scopedContext, cancellationToken).ConfigureAwait(false);
         }
 

src/Melodee.Mql/Melodee.Mql.csproj

@@ -7,7 +7,7 @@
     <GenerateAssemblyInfo>true</GenerateAssemblyInfo>
     <NoWarn>$(NoWarn);NU1507</NoWarn>
 
-    <VersionPrefix>2.1.4</VersionPrefix>
+    <VersionPrefix>2.2.0</VersionPrefix>
     <VersionSuffix>build$([System.DateTime]::UtcNow.ToString("yyyyMMddHHmmss"))</VersionSuffix>
     <AssemblyVersion>$(VersionPrefix).0</AssemblyVersion>
     <FileVersion>$(VersionPrefix).0</FileVersion>

tests/Melodee.Tests.Common/Services/SearchEngines/ArtistSearchEngineServiceTests.cs

@@ -7,6 +7,7 @@
 using Melodee.Common.Filtering;
 using Melodee.Common.Models;
 using Melodee.Common.Models.SearchEngines;
+using Melodee.Common.Models.SearchEngines.ArtistSearchEngineServiceData;
 using Melodee.Common.Services.SearchEngines;
 using Microsoft.EntityFrameworkCore;
 using Moq;
@@ -32,6 +33,28 @@ public async Task InitializeAsync_WhenCalled_InitializesService()
         Assert.True(true);
     }
 
+    [Fact]
+    public async Task InitializeAsync_WithNonRelationalProvider_CreatesDatabaseWithoutMigrations()
+    {
+        var databaseName = $"artist-search-{Guid.NewGuid():N}";
+        var options = new DbContextOptionsBuilder<ArtistSearchEngineServiceDbContext>()
+            .UseInMemoryDatabase(databaseName)
+            .Options;
+        var contextFactory = new Mock<IDbContextFactory<ArtistSearchEngineServiceDbContext>>();
+        contextFactory
+            .Setup(x => x.CreateDbContextAsync(It.IsAny<CancellationToken>()))
+            .ReturnsAsync(() => new ArtistSearchEngineServiceDbContext(options));
+        var service = CreateArtistSearchEngineService(
+            MockConfigurationFactory(),
+            MockHttpClientFactory(),
+            contextFactory.Object);
+
+        await service.InitializeAsync();
+
+        await using var context = new ArtistSearchEngineServiceDbContext(options);
+        Assert.True(await context.Database.CanConnectAsync());
+    }
+
     [Fact]
     public async Task InitializeAsync_WhenCalledMultipleTimes_OnlyInitializesOnce()
     {
@@ -603,7 +626,8 @@ private static Album NewAlbum(Artist artist, string name, int year)
 
     private ArtistSearchEngineService CreateArtistSearchEngineService(
         IMelodeeConfigurationFactory configFactory,
-        IHttpClientFactory httpClientFactory)
+        IHttpClientFactory httpClientFactory,
+        IDbContextFactory<ArtistSearchEngineServiceDbContext>? artistSearchEngineContextFactory = null)
     {
         return new ArtistSearchEngineService(
             Logger,
@@ -612,7 +636,7 @@ private ArtistSearchEngineService CreateArtistSearchEngineService(
             MockSpotifyClientBuilder(),
             configFactory,
             MockFactory(),
-            MockArtistSearchEngineFactory(),
+            artistSearchEngineContextFactory ?? MockArtistSearchEngineFactory(),
             GetMusicBrainzRepository(),
             Serializer,
             httpClientFactory);