feat: migrate cmux UserDefaults keys → programa with one-time shim (Phase 6, UserDefaults)

Add a version-gated startup migration that copies every cmux-prefixed default to its
programa-prefixed key (never deletes the legacy key), so no user preference is lost by
the rebrand. Rename the standalone persisted keys (welcomeShown, surfacePoolEnabled,
devMutate…, debugBG, focusDebug, keyLatencyProbe, shortcutMonitorTrace, typingTimingLogs,
settingsFile.backups). Port keys (cmuxPortBase/Range) and socket-mode value (cmuxonly)
deferred to their own contracts (shell-integration / socket-mode). Builds green.

Author: arzafran

Sources/AppDelegate.swift

@@ -79,14 +79,14 @@ enum ProgramaTypingTiming {
             return true
         }
         let defaults = UserDefaults.standard
-        return defaults.bool(forKey: "cmuxTypingTimingLogs") || defaults.bool(forKey: "cmuxKeyLatencyProbe")
+        return defaults.bool(forKey: "programaTypingTimingLogs") || defaults.bool(forKey: "programaKeyLatencyProbe")
     }()
     static let isVerboseProbeEnabled: Bool = {
         let environment = ProcessInfo.processInfo.environment
         if environment["PROGRAMA_KEY_LATENCY_PROBE"] == "1" {
             return true
         }
-        return UserDefaults.standard.bool(forKey: "cmuxKeyLatencyProbe")
+        return UserDefaults.standard.bool(forKey: "programaKeyLatencyProbe")
     }()
     private static let delayLogThresholdMs: Double = 6.0
     private static let durationLogThresholdMs: Double = 1.0
@@ -10359,7 +10359,7 @@ final class AppDelegate: NSObject, NSApplicationDelegate, UNUserNotificationCent
                 ProgramaTypingTiming.logEventDelay(path: "appMonitor", event: event)
                 let shortcutMonitorTraceEnabled =
                     ProcessInfo.processInfo.environment["PROGRAMA_SHORTCUT_MONITOR_TRACE"] == "1"
-                    || UserDefaults.standard.bool(forKey: "cmuxShortcutMonitorTrace")
+                    || UserDefaults.standard.bool(forKey: "programaShortcutMonitorTrace")
                 if shortcutMonitorTraceEnabled {
                     let frType = NSApp.keyWindow?.firstResponder.map { String(describing: type(of: $0)) } ?? "nil"
                     dlog(

Sources/GhosttyTerminalView.swift

@@ -1343,7 +1343,7 @@ class GhosttyApp {
         if ProcessInfo.processInfo.environment["GHOSTTYTABS_DEBUG_BG"] == "1" {
             return true
         }
-        if UserDefaults.standard.bool(forKey: "cmuxDebugBG") {
+        if UserDefaults.standard.bool(forKey: "programaDebugBG") {
             return true
         }
         return UserDefaults.standard.bool(forKey: "GhosttyTabsDebugBG")
@@ -4967,7 +4967,7 @@ class GhosttyNSView: NSView, NSUserInterfaceValidations {
         if ProcessInfo.processInfo.environment["PROGRAMA_FOCUS_DEBUG"] == "1" {
             return true
         }
-        return UserDefaults.standard.bool(forKey: "cmuxFocusDebug")
+        return UserDefaults.standard.bool(forKey: "programaFocusDebug")
     }()
     internal enum DropPlan: Equatable {
         case insertText(String)
@@ -5104,7 +5104,7 @@ class GhosttyNSView: NSView, NSUserInterfaceValidations {
         if ProcessInfo.processInfo.environment["PROGRAMA_KEY_LATENCY_PROBE"] == "1" {
             return true
         }
-        return UserDefaults.standard.bool(forKey: "cmuxKeyLatencyProbe")
+        return UserDefaults.standard.bool(forKey: "programaKeyLatencyProbe")
     }()
     static var debugGhosttySurfaceKeyEventObserver: ((ghostty_input_key_s) -> Void)?
 #endif

Sources/KeyboardShortcutSettingsFileStore.swift

@@ -24,7 +24,7 @@ final class ProgramaSettingsFileStore {
     static let schemaURLString = "https://raw.githubusercontent.com/darkroomengineering/programa/main/Resources/settings.schema.json"
 
     private static let releaseBundleIdentifier = "com.darkroom.programa"
-    private static let backupsDefaultsKey = "cmux.settingsFile.backups.v1"
+    private static let backupsDefaultsKey = "programa.settingsFile.backups.v1"
     fileprivate static let trustedDirectoriesBackupIdentifier = "customCommands.trustedDirectories"
     fileprivate static let socketPasswordBackupIdentifier = "automation.socketPassword"
 

Sources/ProgramaApp.swift

@@ -171,8 +171,11 @@ struct cmuxApp: App {
         let startupAppearance = AppearanceSettings.resolvedMode()
         Self.applyAppearance(startupAppearance)
         _tabManager = StateObject(wrappedValue: TabManager())
-        // Migrate legacy and old-format socket mode values to the new enum.
         let defaults = UserDefaults.standard
+        // Rebrand: forward every legacy cmux-prefixed default to its programa key
+        // before anything reads the new keys, so existing users keep their prefs.
+        Self.migrateCmuxDefaultsToProgramaIfNeeded(defaults: defaults)
+        // Migrate legacy and old-format socket mode values to the new enum.
         if let stored = defaults.string(forKey: SocketControlSettings.appStorageKey) {
             let migrated = SocketControlSettings.migrateMode(stored)
             if migrated.rawValue != stored {
@@ -268,6 +271,22 @@ struct cmuxApp: App {
         setenv(key, updated, 1)
     }
 
+    /// One-time rebrand migration: copy every `cmux`-prefixed UserDefaults value to
+    /// the corresponding `programa`-prefixed key. Version-gated so it runs once, and
+    /// never deletes the legacy keys (a downgrade still finds its old values).
+    private static func migrateCmuxDefaultsToProgramaIfNeeded(defaults: UserDefaults) {
+        let migrationKey = "programaDefaultsRebrandMigrationVersion"
+        let targetVersion = 1
+        guard defaults.integer(forKey: migrationKey) < targetVersion else { return }
+        for (key, value) in defaults.dictionaryRepresentation() where key.hasPrefix("cmux") {
+            let newKey = "programa" + key.dropFirst("cmux".count)
+            if defaults.object(forKey: newKey) == nil {
+                defaults.set(value, forKey: newKey)
+            }
+        }
+        defaults.set(targetVersion, forKey: migrationKey)
+    }
+
     private func migrateSidebarAppearanceDefaultsIfNeeded(defaults: UserDefaults) {
         let migrationKey = "sidebarAppearanceDefaultsVersion"
         let targetVersion = 1
@@ -3828,7 +3847,7 @@ enum ClaudeCodeIntegrationSettings {
 }
 
 enum WelcomeSettings {
-    static let shownKey = "cmuxWelcomeShown"
+    static let shownKey = "programaWelcomeShown"
 }
 
 enum TelemetrySettings {

Sources/SurfacePool.swift

@@ -34,7 +34,7 @@ final class SurfacePool {
 
     /// Whether the pool is enabled. Reads user default, defaulting to true.
     var isEnabled: Bool {
-        UserDefaults.standard.object(forKey: "cmuxSurfacePoolEnabled") as? Bool ?? true
+        UserDefaults.standard.object(forKey: "programaSurfacePoolEnabled") as? Bool ?? true
     }
 
     #if DEBUG

Sources/TabManager.swift

@@ -1326,7 +1326,7 @@ class TabManager: ObservableObject {
             if let raw = env["PROGRAMA_DEV_MUTATE_WORKSPACE_SELECTION_DURING_CREATION"] {
                 return raw == "1" || raw.caseInsensitiveCompare("true") == .orderedSame
             }
-            return UserDefaults.standard.bool(forKey: "cmuxDevMutateWorkspaceSelectionDuringCreation")
+            return UserDefaults.standard.bool(forKey: "programaDevMutateWorkspaceSelectionDuringCreation")
         }()
         guard isEnabled,
               let selectedTabId = snapshot.selectedTabId,