chore: merge main (feat/multi-source music support) into production-polish

Resolves conflicts from PR #13 landing in main. Kept HEAD versions for
AppDelegate extension architecture, thread-safe AppleMusicSource tracking
lock, and richer FEATURE_IDEAS content; accepted origin/main additions for
systemNowPlaying queue key, Last.fm/Multi-Platform feature ideas, and new
PlaybackSourceManagerTests test.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: nathanialhenniges

FEATURE_IDEAS.md

@@ -53,7 +53,16 @@ Ship multiple pre-built WebSocket overlay themes (minimal, retro, neon, glassmor
 Global keyboard shortcuts to toggle tracking, skip song, or show/hide the overlay — even when WolfWave is in the background. Configurable in Settings → Advanced.
 
 **Complexity**: Low–Medium
-**Approach**: `CGEvent` tap or a lightweight hotkey library (e.g. HotKey by github/soffes)
+**Approach**: `CGEvent` tap or a lightweight hotkey library (e.g. HotKey by GitHub/soffes)
+
+---
+
+## Last.fm Scrobbling
+
+Optional Last.fm integration to automatically scrobble tracks as they play. Uses Last.fm API with OAuth device flow (same pattern as Twitch auth).
+
+**Complexity**: Medium
+**Builds on**: `TwitchDeviceAuth` OAuth pattern, `KeychainService`
 
 ---
 
@@ -109,3 +118,11 @@ Let Twitch chat vote on the next song from the request queue. Streamer posts the
 **Complexity**: Medium
 **Builds on**: Song Request Queue feature, existing `TwitchChatService`
 
+---
+
+## Multi-Platform Chat Support
+
+Extend the bot beyond Twitch to YouTube Live chat and Kick. Same `BotCommand` protocol, different transport layer per platform.
+
+**Complexity**: High
+**Builds on**: `BotCommand` protocol, `BotCommandDispatcher`

apps/native/WolfWaveTests/MusicPlaybackMonitorTests.swift

@@ -1,5 +1,5 @@
 //
-//  MusicPlaybackMonitorTests.swift
+//  AppleMusicSourceTests.swift
 //  WolfWaveTests
 //
 //  Created by MrDemonWolf, Inc. on 2/27/26.

apps/native/WolfWaveTests/PlaybackSourceManagerTests.swift

@@ -14,6 +14,15 @@ final class PlaybackSourceManagerTests: XCTestCase {
         XCTAssertEqual(manager.currentMode, .appleMusic)
     }
 
+    func testInvalidPersistedModeFallsBackToAppleMusic() {
+        UserDefaults.standard.set("invalidMode", forKey: "playbackSourceMode")
+        let manager = PlaybackSourceManager()
+        XCTAssertEqual(manager.currentMode, .appleMusic)
+    }
+
+    // MARK: - Mode Switching
+
+
     // MARK: - Delegate Forwarding
 
     func testDelegateReceivesTrackUpdate() {

apps/native/wolfwave/Core/AppConstants.swift

@@ -391,6 +391,7 @@ enum AppConstants {
         /// Queue for WebSocket server operations
         static let websocketServer = "com.mrdemonwolf.wolfwave.websocketserver"
 
+        static let systemNowPlaying = "com.mrdemonwolf.wolfwave.systemnowplaying"
     }
 
     // MARK: - UI Dimensions

apps/native/wolfwave/Views/Shared/WhatsNewView.swift

@@ -23,10 +23,10 @@ struct WhatsNewView: View {
     private let features: [(icon: String, iconColor: Color, title: String, description: String)] = [
         ("music.note.2", .pink, "Discord Buttons", "Open in Apple Music or jump to song.link from your Discord status"),
         ("arrow.up.right.circle", .blue, "Launch at Login", "WolfWave starts automatically when your Mac does"),
-        ("sparkle", twitchPurple, "Homebrew Auto-Update", "Homebrew updates arrive automatically"),
-        ("rectangle.and.arrow.up.right.and.arrow.down.left", .green, "Polished Installer", "New drag-and-drop installer with WolfWave branding"),
-        ("paintbrush", discordIndigo, "Artwork & Links", "Album art and shareable song links added to every track"),
-        ("checkmark.shield", .orange, "Stability", "Faster reconnections, smoother updates, and better security")
+        ("sparkle", twitchPurple, "Homebrew Auto-Update", "Homebrew tap stays in sync whenever a new release ships"),
+        ("rectangle.and.arrow.up.right.and.arrow.down.left", .green, "Custom DMG", "Polished installer background with WolfWave branding"),
+        ("paintbrush", discordIndigo, "Artwork & Links", "Album art and song.link resolved automatically for every track"),
+        ("checkmark.shield", .orange, "Stability", "Tighter entitlements, fixed Sparkle updates, and smarter reconnects")
     ]
 
     // MARK: - Body