Gate socket path override by update channel

Sources/SocketControlSettings.swift

@@ -38,6 +38,7 @@ enum SocketControlMode: String, CaseIterable, Identifiable {
 struct SocketControlSettings {
     static let appStorageKey = "socketControlMode"
     static let legacyEnabledKey = "socketControlEnabled"
+    static let allowSocketPathOverrideKey = "CMUX_ALLOW_SOCKET_OVERRIDE"
 
     /// Map old persisted rawValues to the new enum.
     static func migrateMode(_ raw: String) -> SocketControlMode {
@@ -55,15 +56,83 @@ struct SocketControlSettings {
         return .cmuxOnly
     }
 
-    static func socketPath() -> String {
-        if let override = ProcessInfo.processInfo.environment["CMUX_SOCKET_PATH"], !override.isEmpty {
+    private static var isDebugBuild: Bool {
+#if DEBUG
+        true
+#else
+        false
+#endif
+    }
+
+    static func socketPath(
+        environment: [String: String] = ProcessInfo.processInfo.environment,
+        bundleIdentifier: String? = Bundle.main.bundleIdentifier,
+        isDebugBuild: Bool = SocketControlSettings.isDebugBuild
+    ) -> String {
+        let fallback = defaultSocketPath(bundleIdentifier: bundleIdentifier, isDebugBuild: isDebugBuild)
+
+        guard let override = environment["CMUX_SOCKET_PATH"], !override.isEmpty else {
+            return fallback
+        }
+
+        if shouldHonorSocketPathOverride(
+            environment: environment,
+            bundleIdentifier: bundleIdentifier,
+            isDebugBuild: isDebugBuild
+        ) {
             return override
         }
-#if DEBUG
-        return "/tmp/cmux-debug.sock"
-#else
+
+        return fallback
+    }
+
+    static func defaultSocketPath(bundleIdentifier: String?, isDebugBuild: Bool) -> String {
+        if bundleIdentifier == "com.cmuxterm.app.nightly" {
+            return "/tmp/cmux-nightly.sock"
+        }
+        if isDebugLikeBundleIdentifier(bundleIdentifier) || isDebugBuild {
+            return "/tmp/cmux-debug.sock"
+        }
+        if isStagingBundleIdentifier(bundleIdentifier) {
+            return "/tmp/cmux-staging.sock"
+        }
         return "/tmp/cmux.sock"
-#endif
+    }
+
+    static func shouldHonorSocketPathOverride(
+        environment: [String: String],
+        bundleIdentifier: String?,
+        isDebugBuild: Bool
+    ) -> Bool {
+        if isTruthy(environment[allowSocketPathOverrideKey]) {
+            return true
+        }
+        if isDebugLikeBundleIdentifier(bundleIdentifier) || isStagingBundleIdentifier(bundleIdentifier) {
+            return true
+        }
+        return isDebugBuild
+    }
+
+    static func isDebugLikeBundleIdentifier(_ bundleIdentifier: String?) -> Bool {
+        guard let bundleIdentifier else { return false }
+        return bundleIdentifier == "com.cmuxterm.app.debug"
+            || bundleIdentifier.hasPrefix("com.cmuxterm.app.debug.")
+    }
+
+    static func isStagingBundleIdentifier(_ bundleIdentifier: String?) -> Bool {
+        guard let bundleIdentifier else { return false }
+        return bundleIdentifier == "com.cmuxterm.app.staging"
+            || bundleIdentifier.hasPrefix("com.cmuxterm.app.staging.")
+    }
+
+    static func isTruthy(_ raw: String?) -> Bool {
+        guard let raw else { return false }
+        switch raw.trimmingCharacters(in: .whitespacesAndNewlines).lowercased() {
+        case "1", "true", "yes", "on":
+            return true
+        default:
+            return false
+        }
     }
 
     static func envOverrideEnabled() -> Bool? {