Docs drift - updates needed for the next Maintainerr release

[maintainerr-docs-automation]

📚 Docs drift report

Comparing v3.26.0 → HEAD against Maintainerr_docs. Informational only - maintainers decide what needs doc updates before release.

Rule glossary parity

• Code rule keys (rules.constants.ts): 216
• Documented keys (docs/Glossary.md): 216

Glossary is in sync with the code.

New migrations on this branch

• 1788246979873-AddCollectionMediaPendingDirection.ts

Each migration typically introduces a setting or schema change. Confirm Configuration.md and Migration.md still reflect user-facing behaviour.

Rule constants

• rules.constants.ts changed: +34 / -0 lines
• Review rule tables in docs/Rules.mdx and entries in docs/Glossary.md.

Public contracts (@maintainerr/contracts)

• Modified (2):
  • packages/contracts/src/media-server/enums.ts
  • packages/contracts/src/media-server/features.ts

Public DTO changes may affect docs/API.md and the OpenAPI spec in static/openapi-spec/maintainerr_api_specs.yaml.

New HTTP controllers

No new controllers.

feat: commits on this branch

• 5f843bf8 feat(rules): add watcher lists since media was added

Behavioral fixes worth reviewing

• bc04b4ef fix: let deletes wait for the server instead of timing out (#3673)
  • touched: apps/server/src/modules/api/lib/httpTimeouts.ts, apps/server/src/modules/api/lib/plexApi.spec.ts, apps/server/src/modules/api/lib/plexApi.ts, apps/server/src/modules/api/media-server/emby/emby-adapter.service.spec.ts, apps/server/src/modules/api/media-server/emby/emby-adapter.service.ts, apps/server/src/modules/api/media-server/jellyfin/jellyfin-adapter.service.spec.ts, apps/server/src/modules/api/media-server/jellyfin/jellyfin-adapter.service.ts, apps/server/src/modules/api/plex-api/plex-api.service.spec.ts, apps/server/src/modules/api/plex-api/plex-api.service.ts, apps/server/src/modules/api/servarr-api/common/servarr-api.service.spec.ts, apps/server/src/modules/api/servarr-api/common/servarr-api.service.ts, apps/server/src/modules/api/servarr-api/helpers/sportarr.helper.spec.ts, apps/server/src/modules/api/servarr-api/helpers/sportarr.helper.ts
• a3c74f4f fix(rules): batch the Emby episode history sweep and pin the target boundary
  • touched: apps/server/src/modules/api/media-server/emby/emby-adapter.service.spec.ts, apps/server/src/modules/api/media-server/emby/emby-adapter.service.ts, apps/server/src/modules/api/media-server/emby/emby.constants.ts, apps/server/src/modules/rules/getter/emby-getter.service.spec.ts, apps/server/src/modules/rules/getter/emby-getter.service.ts, apps/server/src/modules/rules/getter/jellyfin-getter.service.spec.ts, apps/server/src/modules/rules/getter/plex-getter.service.spec.ts
• 50a42a3c fix(plex): handle empty every-episode targets
  • touched: apps/server/src/modules/rules/getter/plex-getter.service.spec.ts, apps/server/src/modules/rules/getter/plex-getter.service.ts
• d7d86d0b fix(ui): say why a bulk action failed instead of one catch-all
  • touched: apps/ui/src/api/bulkMediaAction.spec.ts, apps/ui/src/api/bulkMediaAction.ts, apps/ui/src/locales/cs.po, apps/ui/src/locales/da.po, apps/ui/src/locales/de.po, apps/ui/src/locales/en.po, apps/ui/src/locales/es.po, apps/ui/src/locales/fi.po, apps/ui/src/locales/fr.po, apps/ui/src/locales/it.po, apps/ui/src/locales/nb.po, apps/ui/src/locales/nl.po, apps/ui/src/locales/pl.po, apps/ui/src/locales/pt.po, apps/ui/src/locales/sv.po
• e0f04112 fix(collections): drop rule-removal markers when a collection stops syncing
  • touched: apps/server/src/modules/collections/collections.service.spec.ts, apps/server/src/modules/collections/collections.service.ts, apps/server/src/modules/collections/stop-media-server-sync.integration.spec.ts
• d64acd1e fix(collections): count a custom collection as a sibling when guarding adoption
  • touched: apps/server/src/modules/collections/collections.service.spec.ts, apps/server/src/modules/collections/collections.service.ts
• 6e78f585 fix(plex): drop the cached collection children after a collection mutation
  • touched: apps/server/src/modules/api/lib/plexApi.ts, apps/server/src/modules/api/plex-api/plex-api.service.spec.ts, apps/server/src/modules/api/plex-api/plex-api.service.ts
• 271e99a3 fix(collections): treat an unset deletion window as never, and stop clearing it
  • touched: apps/server/src/modules/collections/collection-worker.server.spec.ts, apps/server/src/modules/collections/collection-worker.service.ts, apps/server/src/modules/rules/rules.service.ts, apps/server/src/modules/rules/rules.service.updateRules.spec.ts
• b4ce6f02 fix(collections): report adds that had no media server collection to add to
  • touched: apps/server/src/modules/collections/collections.controller.ts, apps/server/src/modules/collections/collections.service.spec.ts, apps/server/src/modules/collections/collections.service.ts
• c6993d19 fix(rules): stop the stale-link resync marking a manual collection's members as manual
  • touched: apps/server/src/modules/collections/collections.service.ts, apps/server/src/modules/rules/tasks/rule-executor.service.spec.ts, apps/server/src/modules/rules/tasks/rule-executor.service.ts
• ad88fb7a fix(collections): address the three review findings on unconfirmed writes
  • touched: apps/server/src/modules/collections/collection-media-rule-removal.integration.spec.ts, apps/server/src/modules/collections/collections.controller.spec.ts, apps/server/src/modules/collections/collections.controller.ts, apps/server/src/modules/collections/collections.service.spec.ts, apps/server/src/modules/collections/collections.service.ts
• 904fe61e fix(collections): stop recording an unanswered media server write as a refusal
  • touched: apps/server/src/modules/api/media-server/emby/emby-adapter.service.spec.ts, apps/server/src/modules/api/media-server/emby/emby-adapter.service.ts, apps/server/src/modules/api/media-server/jellyfin/jellyfin-adapter.service.spec.ts, apps/server/src/modules/api/media-server/jellyfin/jellyfin-adapter.service.ts, apps/server/src/modules/api/media-server/media-server.interface.ts, apps/server/src/modules/api/media-server/mutation-outcome.util.ts, apps/server/src/modules/api/media-server/plex/plex-adapter.service.spec.ts, apps/server/src/modules/api/media-server/plex/plex-adapter.service.ts, apps/server/src/modules/api/plex-api/plex-api.service.ts, apps/server/src/modules/collections/collections.service.spec.ts, apps/server/src/modules/collections/collections.service.ts, apps/server/src/modules/collections/entities/collection_media_rule_removal.entities.ts
• c23b4acb fix(ui): prevent calendar month skipping
  • touched: apps/ui/src/components/Calendar/index.spec.tsx, apps/ui/src/components/Calendar/index.tsx

fix: commits that touched a doc-worthy surface - the UI, any server module except internal-only events/logging, any controller, or the README. Worth scanning to decide whether observable behavior changed enough to warrant a docs note.

Documentation-labeled issues & PRs

No open issues or in-range merged PRs carry the documentation label.

🤖 Documentation-labeled issues resolved by merged PRs

No merged PRs resolving documentation-labeled issues in this range.

🤖 Guidance for Copilot opening the docs PR

Open a PR on Maintainerr_docs that addresses this drift report, following these rules:

• Always work from local clones, not github.com web views (they can be cached or truncated).
  Clone Maintainerr/Maintainerr and Maintainerr/Maintainerr_docs before anything else.
• Read complete files, not excerpts or partial reads. Coverage you would otherwise miss often
  sits past the first screenful - read each doc file and each commit diff end-to-end.
• Source of truth: the upstream Maintainerr commits and file diffs listed above.
  Use the prose summary as guidance, but always confirm against the local clone
  (git show <sha>) before editing.
• Skip what's already documented: read the current main branch of Maintainerr_docs
  and the most recent merged docs PRs first. If something is already covered, do not
  re-document it.
• Minimal edits only: make only the doc updates that are still missing for the Next
  release. No speculative additions, no broad rewrites.
• Doc-only changes: restrict edits to files under docs/ and static/openapi-spec/.
  Do not touch sidebars, config, or unrelated assets unless strictly required by a doc edit.
• PR description structure:
  1. What was added - one short bullet per doc edit, citing the upstream commit or PR.
  2. Already covered by prior PRs - list anything from this drift that earlier merged
     docs PRs already documented, so reviewers can confirm it's intentionally skipped.
• Keep the PR focused and tied to the actual code diff rather than the issue summary alone.