Skip to content

Maintainerr

v3.12.1 Breaking

This release includes 2 breaking changes for platform teams planning a safe upgrade.

Published 11d Media Servers
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

docker jellyfin maintainerr maintenance movies plex
+6 more
plex-media-server radarr seerr sonarr tv-series tv-shows

Affected surfaces

breaking_upgrade deps

ReleasePort's take

Light signal
editorial:auto 11d

The release adds a `ruleEvaluationFailed` field to collection media and reduces the `RULE_EVALUATION_CONCURRENCY` setting from 16 to 8, among other performance improvements.

Why it matters: Concurrency limited to 8 prevents backend overload; tracking failures via ruleEvaluationFailed aids debugging for developers and SREs.

Summary

AI summary

Updates Breaking Changes, Internal, and Highlights across a mixed release.

Changes in this release

Breaking Medium

Renames `WATCH_HISTORY_CONCURRENCY` to `RULE_EVALUATION_CONCURRENCY` for clarity.

Renames `WATCH_HISTORY_CONCURRENCY` to `RULE_EVALUATION_CONCURRENCY` for clarity.

Source: llm_adapter@2026-05-23

Confidence: low

 —
Feature Medium

Adds `ruleEvaluationFailed` field to collection media for tracking rule evaluation failures.

Adds `ruleEvaluationFailed` field to collection media for tracking rule evaluation failures.

Source: llm_adapter@2026-05-23

Confidence: high

 —
Feature Medium

Enhances Emby image upload error handling by attaching response body to thrown errors.

Enhances Emby image upload error handling by attaching response body to thrown errors.

Source: llm_adapter@2026-05-23

Confidence: high

 —
Dependency Medium

Updated 13 dependencies, including nodemailer, glob, qs, postcss, and vite.

Updated 13 dependencies, including nodemailer, glob, qs, postcss, and vite.

Source: llm_adapter@2026-05-23

Confidence: low

 —
Performance Medium

Reduces `RULE_EVALUATION_CONCURRENCY` from 16 to 8 to prevent backend overload.

Reduces `RULE_EVALUATION_CONCURRENCY` from 16 to 8 to prevent backend overload.

Source: llm_adapter@2026-05-23

Confidence: high

 —
Performance Medium

Batches rule operand reads with bounded concurrency for improved performance.

Batches rule operand reads with bounded concurrency for improved performance.

Source: llm_adapter@2026-05-23

Confidence: high

 —
Performance Medium

Deduplicates uncached Sonarr/Radarr identity lookups during rule evaluation.

Deduplicates uncached Sonarr/Radarr identity lookups during rule evaluation.

Source: llm_adapter@2026-05-23

Confidence: high

 —
Bugfix Medium

Scoped Emby `itemExists` checks to user context to resolve overlay revert issues.

Scoped Emby `itemExists` checks to user context to resolve overlay revert issues.

Source: llm_adapter@2026-05-23

Confidence: high

 —
Bugfix Medium

Corrected overlay notification titles for Emby/Jellyfin movies.

Corrected overlay notification titles for Emby/Jellyfin movies.

Source: llm_adapter@2026-05-23

Confidence: high

 —
Bugfix Medium

Fixed collection rule group entity type in the server.

Fixed collection rule group entity type in the server.

Source: llm_adapter@2026-05-23

Confidence: high

 —
Full changelog

Highlights

  • Added ruleEvaluationFailed field to collection media, enabling tracking of rule evaluation failures.
  • Improved rule evaluation performance by batching operand reads and reducing concurrency to prevent backend overload.
  • Fixed Emby overlay issues where posters were not restored after media left a collection.

Breaking Changes

  • Renamed WATCH_HISTORY_CONCURRENCY to RULE_EVALUATION_CONCURRENCY for clarity.

Features

  • Enhanced error handling for Emby image uploads by attaching response body to thrown errors for better debugging.

Fixes

  • Scoped Emby itemExists checks to user context to resolve overlay revert issues.
  • Corrected overlay notification titles for Emby/Jellyfin movies.
  • Fixed collection rule group entity type in the server.
  • Provided production peer dependencies for the UI.

Performance

  • Reduced RULE_EVALUATION_CONCURRENCY from 16 to 8 to prevent backend overload.
  • Batched rule operand reads with bounded concurrency for improved performance.
  • Deduplicated uncached Sonarr/Radarr identity lookups during rule evaluation.

Database migrations

  • Added ruleEvaluationFailed column to the collection_media table to track rule evaluation failures.

Internal

  • Removed unused forwardRef imports in the server module after settings module refactor.
  • Renamed settings services and fields to better reflect their roles.
  • Decoupled settings service into a data store and coordinator for improved modularity.
  • Added tests for ArrLookupCache deduplication and eviction on failure.

Dependencies

  • Updated 13 dependencies, including nodemailer, glob, qs, postcss, and vite.

Breaking Changes

  • Renamed `WATCH_HISTORY_CONCURRENCY` to `RULE_EVALUATION_CONCURRENCY` for clarity.
  • Reduced `RULE_EVALUATION_CONCURRENCY` default from 16 to 8.
View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track Maintainerr

Get notified when new releases ship.

Sign up free

About Maintainerr

Looks and smells like Seerr, does the opposite. A library maintenance tool for Plex and Jellyfin.

All releases →

Related context

Earlier breaking changes

  • v3.13.0 Section without an operator is now treated as OR instead of AND; migration not reversible.
  • v3.13.0 Per-group exclusions now apply only to their own group, not globally.
  • v3.13.0 Exclusions are now either global or per-group; removing a global exclusion requires re-adding per-group ones.
  • v3.11.0 Overlay reset operations are now gated against concurrent processing runs.

Beta — feedback welcome: [email protected]