feat(sync): add CloudKit sync for dynamic sports

- Add CKSport model to parse CloudKit Sport records
- Add fetchSportsForSync() to CloudKitService for delta fetching
- Add syncSports() and mergeSport() to CanonicalSyncService
- Update DataProvider with dynamicSports support and allSports computed property
- Update MockAppDataProvider with matching dynamic sports support
- Add comprehensive documentation for adding new sports

The app can now sync sport definitions from CloudKit, enabling new sports
to be added without app updates. Sports are fetched, merged into SwiftData,
and exposed via AppDataProvider.allSports alongside built-in Sport enum cases.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

SportsTime/Core/Models/CloudKit/CKModels.swift

@@ -315,6 +315,57 @@ struct CKLeagueStructure {
     }
 }
 
+// MARK: - CKSport
+
+struct CKSport {
+    static let idKey = "sportId"
+    static let abbreviationKey = "abbreviation"
+    static let displayNameKey = "displayName"
+    static let iconNameKey = "iconName"
+    static let colorHexKey = "colorHex"
+    static let seasonStartMonthKey = "seasonStartMonth"
+    static let seasonEndMonthKey = "seasonEndMonth"
+    static let isActiveKey = "isActive"
+    static let schemaVersionKey = "schemaVersion"
+    static let lastModifiedKey = "lastModified"
+
+    let record: CKRecord
+
+    init(record: CKRecord) {
+        self.record = record
+    }
+
+    /// Convert to CanonicalSport for local storage
+    func toCanonical() -> CanonicalSport? {
+        guard let id = record[CKSport.idKey] as? String,
+              let abbreviation = record[CKSport.abbreviationKey] as? String,
+              let displayName = record[CKSport.displayNameKey] as? String,
+              let iconName = record[CKSport.iconNameKey] as? String,
+              let colorHex = record[CKSport.colorHexKey] as? String,
+              let seasonStartMonth = record[CKSport.seasonStartMonthKey] as? Int,
+              let seasonEndMonth = record[CKSport.seasonEndMonthKey] as? Int
+        else { return nil }
+
+        let isActive = (record[CKSport.isActiveKey] as? Int ?? 1) == 1
+        let schemaVersion = record[CKSport.schemaVersionKey] as? Int ?? SchemaVersion.current
+        let lastModified = record[CKSport.lastModifiedKey] as? Date ?? record.modificationDate ?? Date()
+
+        return CanonicalSport(
+            id: id,
+            abbreviation: abbreviation,
+            displayName: displayName,
+            iconName: iconName,
+            colorHex: colorHex,
+            seasonStartMonth: seasonStartMonth,
+            seasonEndMonth: seasonEndMonth,
+            isActive: isActive,
+            lastModified: lastModified,
+            schemaVersion: schemaVersion,
+            source: .cloudKit
+        )
+    }
+}
+
 // MARK: - CKStadiumAlias
 
 struct CKStadiumAlias {

SportsTime/Core/Models/Local/CanonicalModels.swift

@@ -481,6 +481,66 @@ final class CanonicalGame {
     }
 }
 
+// MARK: - Canonical Sport
+
+@Model
+final class CanonicalSport {
+    @Attribute(.unique) var id: String
+    var abbreviation: String
+    var displayName: String
+    var iconName: String
+    var colorHex: String
+    var seasonStartMonth: Int
+    var seasonEndMonth: Int
+    var isActive: Bool
+    var lastModified: Date
+    var schemaVersion: Int
+    var sourceRaw: String
+
+    init(
+        id: String,
+        abbreviation: String,
+        displayName: String,
+        iconName: String,
+        colorHex: String,
+        seasonStartMonth: Int,
+        seasonEndMonth: Int,
+        isActive: Bool = true,
+        lastModified: Date = Date(),
+        schemaVersion: Int = SchemaVersion.current,
+        source: DataSource = .cloudKit
+    ) {
+        self.id = id
+        self.abbreviation = abbreviation
+        self.displayName = displayName
+        self.iconName = iconName
+        self.colorHex = colorHex
+        self.seasonStartMonth = seasonStartMonth
+        self.seasonEndMonth = seasonEndMonth
+        self.isActive = isActive
+        self.lastModified = lastModified
+        self.schemaVersion = schemaVersion
+        self.sourceRaw = source.rawValue
+    }
+
+    var source: DataSource {
+        get { DataSource(rawValue: sourceRaw) ?? .cloudKit }
+        set { sourceRaw = newValue.rawValue }
+    }
+
+    func toDomain() -> DynamicSport {
+        DynamicSport(
+            id: id,
+            abbreviation: abbreviation,
+            displayName: displayName,
+            iconName: iconName,
+            colorHex: colorHex,
+            seasonStartMonth: seasonStartMonth,
+            seasonEndMonth: seasonEndMonth
+        )
+    }
+}
+
 // MARK: - Bundled Data Timestamps
 
 /// Timestamps for bundled data files.