External resource support for media-server items (Jellyfin / AudiobookShelf)

.github/claude/reviewer/review.mjs

@@ -102,6 +102,36 @@ function extractJson(text) {
   return JSON.parse(candidate.slice(start, end + 1));
 }
 
+/// One-shot, tool-less model call that fixes the reviewer's own malformed JSON (typically an
+/// unescaped quote or raw newline inside a finding's comment). Content is preserved; only
+/// syntax is repaired. Costs one cheap turn instead of discarding a completed review pass.
+async function repairJsonWithModel(brokenText) {
+  let repaired = '';
+  const iterator = query({
+    prompt:
+      'The following text should be exactly one valid JSON object but fails to parse. ' +
+      'Reply with ONLY the corrected, valid JSON object — no code fences, no commentary. ' +
+      'Preserve every property and value; fix escaping/syntax only.\n\n' + brokenText,
+    options: {
+      model: MODEL,
+      allowedTools: [],
+      permissionMode: 'bypassPermissions',
+      maxTurns: 1,
+    },
+  });
+  for await (const msg of iterator) {
+    if (msg.type === 'assistant') {
+      const content = msg.message?.content;
+      if (Array.isArray(content)) {
+        for (const block of content) {
+          if (block.type === 'text' && block.text) repaired = block.text;
+        }
+      }
+    }
+  }
+  return extractJson(repaired);
+}
+
 async function runAgent() {
   let finalText = '';
   let turns = 0;
@@ -210,7 +240,13 @@ async function main() {
   let parsed;
   try {
     if (!finalText) throw new Error('agent produced no text output');
-    parsed = extractJson(finalText);
+    try {
+      parsed = extractJson(finalText);
+    } catch (parseError) {
+      // A finished review with broken JSON is worth one repair attempt before discarding.
+      console.warn(`Agent JSON malformed (${parseError.message}); attempting model repair…`);
+      parsed = await repairJsonWithModel(finalText);
+    }
     if (!parsed.verdict || !parsed.summary || !Array.isArray(parsed.findings)) {
       throw new Error('JSON missing verdict/summary/findings');
     }

.github/workflows/ci.yml

@@ -9,14 +9,14 @@ on:
 jobs:
   build:
     # https://github.com/actions/runner-images/tree/main/images/macos
-    runs-on: macos-26
+    runs-on: xcode-27
     timeout-minutes: 30
     steps:
       - uses: actions/checkout@v4
-      - name: Select Xcode 26.0
+      - name: Select Xcode 27.0
         run: |
-          ls -1 /Applications | grep -E '^Xcode_26\.' || true
-          sudo xcode-select -s "/Applications/Xcode_26.4.app"
+          ls -1 /Applications | grep -E '^Xcode_27' || true
+          sudo xcode-select -s "/Applications/Xcode_27.0.app"
           xcodebuild -version
           xcrun simctl list runtimes
 
@@ -29,7 +29,7 @@ jobs:
       - name: Reset Simulator
         run: |
           set -x
-          export DEVELOPER_DIR="/Applications/Xcode_26.4.app"
+          export DEVELOPER_DIR="/Applications/Xcode_27.0.app"
           xcrun simctl shutdown all || true
           xcrun simctl erase all || true
           launchctl kickstart -k gui/$UID/com.apple.CoreSimulator.CoreSimulatorService || true

.github/workflows/claude-review.yml

@@ -59,6 +59,6 @@ jobs:
           BASE_REF: ${{ github.event.pull_request.base.ref }}
           RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
           REVIEW_MODEL: claude-opus-4-8
-          REVIEW_MAX_TURNS: '50'   # agent only reads/reports (posting is done by the script), so turns go far
+          REVIEW_MAX_TURNS: '100'  # agent only reads/reports (posting is done by the script), so turns go far
           IS_SANDBOX: '1'
         run: node .github/claude/reviewer/review.mjs

BookPlayer.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict/>
+</plist>

BookPlayer/AppDelegate.swift

@@ -22,7 +22,7 @@ import WatchConnectivity
 
 @UIApplicationMain
 class AppDelegate: UIResponder, UIApplicationDelegate, BPLogger {
-  static weak var shared: AppDelegate?
+  static weak var shared: AppDelegate?    
 
   var window: UIWindow?
 
@@ -48,6 +48,8 @@ class AppDelegate: UIResponder, UIApplicationDelegate, BPLogger {
   /// Database backup task identifier
   private lazy var databaseBackupTaskIdentifier =
     "\(Bundle.main.configurationString(for: .bundleIdentifier)).background.database.backup"
+  /// Answers iOS's relaunches and wakes for the background transfer sessions
+  private lazy var backgroundSessionWakes = BackgroundSessionWakeCoordinator()
 
   func application(
     _ application: UIApplication,
@@ -63,13 +65,24 @@ class AppDelegate: UIResponder, UIApplicationDelegate, BPLogger {
       Constants.UserDefaults.videoPictureInPictureEnabled: false,
     ])
 
+    // Hardcover settings live in the shared (app group) suite. Register their defaults
+    // there so the service (`bool/object(forKey:)`) and the settings UI (`@AppStorage`)
+    // resolve to the same value before the user explicitly saves anything.
+    UserDefaults.sharedDefaults.register(defaults: [
+      Constants.UserDefaults.hardcoverAutoAddWantToRead: true,
+      Constants.UserDefaults.hardcoverReadingThreshold: 1.0,
+    ])
+
     NotificationCenter.default.addObserver(
       self,
       selector: #selector(self.messageReceived),
       name: .messageReceived,
       object: nil
     )
 
+    // Before anything can wake a session: a session's "finished events" may arrive before
+    // iOS hands over its handler, and must not find no one listening
+    _ = backgroundSessionWakes
     // register background refresh tasks
     self.setupBackgroundRefreshTasks()
     // register for remote events
@@ -81,9 +94,29 @@ class AppDelegate: UIResponder, UIApplicationDelegate, BPLogger {
     // Setup core services
     AppServices.shared.setupCoreServices()
 
+    // The extension-safe framework can't reach UIApplication.shared itself; the SSO flow's
+    // presentation anchor comes from here, the one process that owns windows.
+    WebAuthenticationSession.foregroundWindowProvider = {
+      let scenes = UIApplication.shared.connectedScenes.compactMap { $0 as? UIWindowScene }
+      guard let scene = scenes.first(where: { $0.activationState == .foregroundActive }) else {
+        return nil
+      }
+      return scene.keyWindow ?? scene.windows.first
+    }
+
     return true
   }
 
+  /// Stays on the app delegate with scenes (TN3187). The handler is called once the
+  /// session's events are handled — for uploads, once the next parts are queued.
+  func application(
+    _ application: UIApplication,
+    handleEventsForBackgroundURLSession identifier: String,
+    completionHandler: @escaping () -> Void
+  ) {
+    backgroundSessionWakes.handleEvents(forSession: identifier, completionHandler: completionHandler)
+  }
+
   func application(
     _ application: UIApplication,
     handle intent: INIntent,
@@ -412,6 +445,9 @@ extension AppDelegate {
       self.handleAppRefresh(task: refreshTask)
     }
 
+    // At launch, so a task iOS runs for an earlier submit finds its handler
+    UploadContinuationController.register { AppServices.shared.uploadContinuation }
+
     BGTaskScheduler.shared.register(
       forTaskWithIdentifier: databaseBackupTaskIdentifier,
       using: nil
@@ -429,13 +465,45 @@ extension AppDelegate {
     let request = BGAppRefreshTaskRequest(identifier: refreshTaskIdentifier)
     request.earliestBeginDate = Date(timeIntervalSinceNow: 15 * 60)
 
-    try? BGTaskScheduler.shared.submit(request)
+    Self.submitBackgroundTask(request)
+  }
+
+  /// `submit(_:)` is deprecated from iOS 27 in favor of `submitTaskRequest`.
+  static func submitBackgroundTask(
+    _ request: BGTaskRequest,
+    completion: @escaping @Sendable ((any Error)?) -> Void = { _ in }
+  ) {
+    if #available(iOS 27, *) {
+      // Its header: not from the main thread
+      DispatchQueue.global(qos: .utility).async {
+        BGTaskScheduler.shared.submitTaskRequest(request, completionHandler: completion)
+      }
+    } else {
+      do {
+        try BGTaskScheduler.shared.submit(request)
+        completion(nil)
+      } catch {
+        completion(error)
+      }
+    }
   }
 
   func handleAppRefresh(task: BGAppRefreshTask) {
-    guard let syncService = AppServices.shared.coreServices?.syncService else { return }
+    guard let syncQueueService = AppServices.shared.coreServices?.syncQueueService else { return }
 
-    let refreshOperation = RefreshTaskOperation(syncService: syncService)
+    // A gated sync lane (sync off) never drains, so waiting on it would only hold the
+    // window open until expiration
+    guard syncQueueService.serverLanesEnabled else {
+      task.setTaskCompleted(success: true)
+      return
+    }
+
+    // Sync lane only: metadata pushes are what the refresh window is for. Provider pushes
+    // retry forever against an unreachable home server, and S3 uploads already run on a
+    // background URLSession — neither should keep the process awake until expiration.
+    let refreshOperation = RefreshTaskOperation(
+      queueDrained: syncQueueService.observeQueueCounts().laneDrained(TaskQueueKey.sync)
+    )
 
     refreshOperation.completionBlock = { [weak self] in
       let success = !refreshOperation.isCancelled
@@ -486,11 +554,13 @@ extension AppDelegate {
       request.earliestBeginDate = Date(timeIntervalSinceNow: 24 * 60 * 60)
     }
 
-    do {
-      try BGTaskScheduler.shared.submit(request)
-      Self.logger.info("Database backup scheduled for: \(request.earliestBeginDate?.description ?? "unknown")")
-    } catch {
-      Self.logger.error("Failed to schedule database backup: \(error.localizedDescription)")
+    let scheduledFor = request.earliestBeginDate?.description ?? "unknown"
+    Self.submitBackgroundTask(request) { error in
+      if let error {
+        Self.logger.error("Failed to schedule database backup: \(error.localizedDescription)")
+      } else {
+        Self.logger.info("Database backup scheduled for: \(scheduledFor)")
+      }
     }
   }
 
@@ -515,4 +585,4 @@ extension AppDelegate {
 
     queue.addOperation(backupOperation)
   }
-}
+}

BookPlayer/AppIntents/BPAppShortcuts.swift

@@ -9,7 +9,7 @@
 import Foundation
 import AppIntents
 
-@available(iOS 16.4, macOS 14.0, watchOS 10.0, *)
+@available(macOS 14.0, watchOS 10.0, *)
 struct BPAppShortcuts: AppShortcutsProvider {
   static var appShortcuts: [AppShortcut] {
     return [

BookPlayer/AppIntents/CancelSleepTimerIntent.swift

@@ -9,7 +9,7 @@
 import Foundation
 import AppIntents
 
-@available(iOS 16.4, macOS 14.0, watchOS 10.0, *)
+@available(macOS 14.0, watchOS 10.0, *)
 struct CancelSleepTimerIntent: AppIntent {
   static var title: LocalizedStringResource = "intent_sleeptimer_cancel"
 

BookPlayer/AppIntents/EndChapterSleepTimerIntent.swift

@@ -9,7 +9,7 @@
 import Foundation
 import AppIntents
 
-@available(iOS 16.4, macOS 14.0, watchOS 10.0, *)
+@available(macOS 14.0, watchOS 10.0, *)
 struct EndChapterSleepTimerIntent: AppIntent {
   static var title: LocalizedStringResource = "intent_sleeptimer_eoc_title"
 

BookPlayer/Assets.xcassets/audiobookshelf-icon.symbolset/Contents.json

@@ -0,0 +1,12 @@
+{
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  },
+  "symbols" : [
+    {
+      "filename" : "audiobookshelf.svg",
+      "idiom" : "universal"
+    }
+  ]
+}