From e51ee0070ed346f3c68e455e22011ea0bb641d21 Mon Sep 17 00:00:00 2001
From: Chuck <33324927+ChuckBuilds@users.noreply.github.com>
Date: Thu, 29 Oct 2026 14:19:15 -0400
Subject: [PATCH] chore: prepare the 3.9.0 release (#803)

Bumps src.__version__ to 3.9.0 and turns Unreleased into ## 3.9.0:
per-plugin schedules (#799), the removal of the cache-key mailboxes (#773,
breaking), the Vegas pause fix (#798) and the Update Code index.lock fix
(#801, #802).

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 CHANGELOG.md    | 21 +++++++++++++++++++++
 src/__init__.py |  2 +-
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 02687de2..7d76e9b0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -19,6 +19,27 @@ accepts both, but the store flags the old spelling as deprecated
 
 ## Unreleased
 
+## 3.9.0
+
+Per-plugin schedules (#799), the end of the cache-key mailboxes (#773,
+**breaking**: see "Removed" below; restart the display and the web interface
+together after updating), a Vegas pause fix (#798), and a fix for Update Code
+failing with `.git/index.lock: File exists` on a slow Pi (#801, #802).
+
+### Fixed: Update Code left `.git/index.lock` behind
+
+A git that Python's timeout killed could not remove `.git/index.lock`, so
+every later update failed with "Unable to create '.../.git/index.lock': File
+exists", and removing the file by hand only lasted until the next timeout.
+Update Code now runs git in its own process group, stops it with SIGTERM
+before SIGKILL and clears the lock it left; pulls get 600 s instead of 60 s;
+the read-only version and status checks set `GIT_OPTIONAL_LOCKS=0` so a
+timed-out poll cannot take the lock. A rebase in progress (detached HEAD) now
+stops Update Code with a message instead of failing inside git; an abandoned
+one is quit first. If a device is already stuck on an older release, stop
+the services, kill any running git, remove `.git/index.lock` and pull by hand
+once. (#801, #802)
+
 ### Added: plugin schedules
 
 Schedule → Plugin Schedules sets when each plugin may show, per day or with
diff --git a/src/__init__.py b/src/__init__.py
index 6efbbd48..3b6ac1a7 100644
--- a/src/__init__.py
+++ b/src/__init__.py
@@ -4,5 +4,5 @@ LEDMatrix Display System
 Core source package for the LED Matrix Display project.
 """
 
-__version__ = "3.8.7"
+__version__ = "3.9.0"