Wait up to 6 hours for Nextcloud's borg lock before deferring the weekly media backup

AIO's borg now runs daily from 07:30 UTC for about 2 hours, so the Saturday
05:00 fire can find the lock held and skip the whole week, which trips Uptime
Kuma's 8-day push window. Poll the lock every 5 minutes for up to 6 hours and
defer only if it is still held after that.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

server/home/media-backup

@@ -81,13 +81,25 @@ mkdir -p "$DEST"
 
 # A borg run holds this lock for 2-4 hours and rewrites index/hints/integrity at the END.
 # Copying mid-run pairs new data chunks with a stale index: a repo that looks fine and
-# fails at restore. Defer rather than queue -- the next weekly run will catch it.
+# fails at restore. AIO's borg runs daily from 07:30 UTC for about 2 hours, so it can
+# still be going when the timer fires. Wait for it to finish, checking every
+# BORG_WAIT_INTERVAL, and defer only if it is still held after BORG_WAIT_MAX. The unit's
+# TimeoutStartSec=24h covers the wait plus the ~50 min sync.
+BORG_WAIT_INTERVAL=300      # 5 min
+BORG_WAIT_MAX=21600         # 6 h
+waited=0
+while [ -e "$BORG_LOCK" ] && [ "$waited" -lt "$BORG_WAIT_MAX" ]; do
+    log "borg is mid-run (lock held at $BORG_LOCK). Waited $((waited / 60)) of $((BORG_WAIT_MAX / 60)) min, checking again in $((BORG_WAIT_INTERVAL / 60)) min"
+    sleep "$BORG_WAIT_INTERVAL"
+    waited=$(( waited + BORG_WAIT_INTERVAL ))
+done
 if [ -e "$BORG_LOCK" ]; then
     log "borg is mid-run (lock held at $BORG_LOCK)"
     log "DEFERRING this week's run rather than copying a torn repo. Next fire: next Saturday."
     log "=== media-backup deferred ==="
     exit 0
 fi
+[ "$waited" -gt 0 ] && log "borg lock released after waiting $((waited / 60)) min, continuing"
 
 avail_gb=$(zfs get -Hp -o value available "$POOL" 2>/dev/null)
 avail_gb=$(( ${avail_gb:-0} / 1024 / 1024 / 1024 ))