feat: auto-update checker, 28 tools, 274 tests

- Check for updates on launch via GitHub Releases API
- 'Check for Updates' in app menu + Settings About tab
- Update alert with direct DMG download link
- Version comparison (semver)
- Orange DX icon matching app theme
- 28 tools, 274 tests, all passing

Author: noahalorwu

DXTools/DXToolsApp.swift

@@ -26,6 +26,12 @@ struct DXToolsApp: App {
                 .keyboardShortcut("t", modifiers: .command)
             }
 
+            CommandGroup(after: .appInfo) {
+                Button("Check for Updates…") {
+                    appState.checkForUpdate()
+                }
+            }
+
             CommandGroup(after: .toolbar) {
                 Button("Command Palette") {
                     appState.showCommandPalette.toggle()

DXTools/Services/UpdateService.swift

@@ -0,0 +1,64 @@
+import Foundation
+
+struct UpdateService {
+    struct Release {
+        let version: String
+        let url: String
+        let notes: String
+        let publishedAt: String
+    }
+
+    static let currentVersion: String = {
+        Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String ?? "0.0.0"
+    }()
+
+    static func checkForUpdate() async -> Release? {
+        guard let url = URL(string: "https://api.github.com/repos/OpenStruct/dx-tools/releases/latest") else { return nil }
+
+        var request = URLRequest(url: url)
+        request.setValue("application/vnd.github+json", forHTTPHeaderField: "Accept")
+        request.timeoutInterval = 10
+
+        do {
+            let (data, response) = try await URLSession.shared.data(for: request)
+            guard let http = response as? HTTPURLResponse, http.statusCode == 200 else { return nil }
+            guard let json = try JSONSerialization.jsonObject(with: data) as? [String: Any] else { return nil }
+
+            guard let tagName = json["tag_name"] as? String else { return nil }
+            let latestVersion = tagName.hasPrefix("v") ? String(tagName.dropFirst()) : tagName
+            let notes = json["body"] as? String ?? ""
+            let publishedAt = json["published_at"] as? String ?? ""
+            let htmlURL = json["html_url"] as? String ?? "https://github.com/OpenStruct/dx-tools/releases/latest"
+
+            // Find DMG download URL
+            var dmgURL = htmlURL
+            if let assets = json["assets"] as? [[String: Any]] {
+                for asset in assets {
+                    if let name = asset["name"] as? String, name.hasSuffix(".dmg"),
+                       let downloadURL = asset["browser_download_url"] as? String {
+                        dmgURL = downloadURL
+                        break
+                    }
+                }
+            }
+
+            guard isNewer(latestVersion, than: currentVersion) else { return nil }
+
+            return Release(version: latestVersion, url: dmgURL, notes: notes, publishedAt: publishedAt)
+        } catch {
+            return nil
+        }
+    }
+
+    static func isNewer(_ remote: String, than local: String) -> Bool {
+        let r = remote.split(separator: ".").compactMap { Int($0) }
+        let l = local.split(separator: ".").compactMap { Int($0) }
+        for i in 0..<max(r.count, l.count) {
+            let rv = i < r.count ? r[i] : 0
+            let lv = i < l.count ? l[i] : 0
+            if rv > lv { return true }
+            if rv < lv { return false }
+        }
+        return false
+    }
+}

DXTools/ViewModels/AppState.swift

@@ -71,6 +71,10 @@ class AppState {
         Tool.allCases.filter { favorites.contains($0.rawValue) }
     }
 
+    // Update
+    var availableUpdate: UpdateService.Release?
+    var showUpdateAlert: Bool = false
+
     // Dropped file content to pass to tool
     var pendingDropContent: String?
 
@@ -129,6 +133,17 @@ class AppState {
         }
     }
 
+    func checkForUpdate() {
+        Task {
+            if let release = await UpdateService.checkForUpdate() {
+                await MainActor.run {
+                    self.availableUpdate = release
+                    self.showUpdateAlert = true
+                }
+            }
+        }
+    }
+
     func checkClipboard() {
         guard let content = NSPasteboard.general.string(forType: .string),
               content != lastClipboardContent,

DXTools/Views/ContentView.swift

@@ -112,6 +112,21 @@ struct ContentView: View {
         .onReceive(clipboardTimer) { _ in
             appState.checkClipboard()
         }
+        .onAppear {
+            appState.checkForUpdate()
+        }
+        .alert("Update Available", isPresented: $state.showUpdateAlert) {
+            Button("Download") {
+                if let url = URL(string: appState.availableUpdate?.url ?? "") {
+                    NSWorkspace.shared.open(url)
+                }
+            }
+            Button("Later", role: .cancel) {}
+        } message: {
+            if let update = appState.availableUpdate {
+                Text("DX Tools v\(update.version) is available. You're on v\(UpdateService.currentVersion).")
+            }
+        }
     }
 
     private func handleDrop(_ providers: [NSItemProvider]) {

DXTools/Views/SettingsView.swift

@@ -60,10 +60,20 @@ struct SettingsView: View {
                     .shadow(color: .black.opacity(0.3), radius: 10, y: 4)
                 Text("DX Tools").font(.title2).fontWeight(.bold)
                 Text("Developer Experience Toolkit").foregroundStyle(.secondary)
-                Text("Version 2.0.0").font(.caption).foregroundStyle(.tertiary)
+                Text("Version \(UpdateService.currentVersion)").font(.caption).foregroundStyle(.tertiary)
                 Divider().frame(width: 200)
                 Text("\(Tool.allCases.count) tools · Built with SwiftUI").font(.caption).foregroundStyle(.tertiary)
-                Text("© 2024 OpenStruct").font(.caption2).foregroundStyle(.quaternary)
+                Text("© 2025 OpenStruct").font(.caption2).foregroundStyle(.quaternary)
+
+                Button("Check for Updates") {
+                    appState.checkForUpdate()
+                    if appState.availableUpdate == nil {
+                        appState.showToast("You're up to date!", icon: "checkmark.circle")
+                    }
+                }
+                .buttonStyle(.bordered)
+                .controlSize(.small)
+
                 Spacer()
             }
             .frame(maxWidth: .infinity)

DXToolsTests/UpdateServiceTests.swift

@@ -0,0 +1,35 @@
+import XCTest
+@testable import DX_Tools
+
+final class UpdateServiceTests: XCTestCase {
+    func testNewerMajor() {
+        XCTAssertTrue(UpdateService.isNewer("3.0.0", than: "2.0.0"))
+    }
+
+    func testNewerMinor() {
+        XCTAssertTrue(UpdateService.isNewer("2.1.0", than: "2.0.0"))
+    }
+
+    func testNewerPatch() {
+        XCTAssertTrue(UpdateService.isNewer("2.0.1", than: "2.0.0"))
+    }
+
+    func testSameVersion() {
+        XCTAssertFalse(UpdateService.isNewer("2.0.0", than: "2.0.0"))
+    }
+
+    func testOlderVersion() {
+        XCTAssertFalse(UpdateService.isNewer("1.9.0", than: "2.0.0"))
+    }
+
+    func testDifferentLengths() {
+        XCTAssertTrue(UpdateService.isNewer("2.1", than: "2.0.0"))
+        XCTAssertFalse(UpdateService.isNewer("2.0", than: "2.0.1"))
+    }
+
+    func testCurrentVersionExists() {
+        // Should return a valid version string
+        let v = UpdateService.currentVersion
+        XCTAssertFalse(v.isEmpty)
+    }
+}

project.yml

@@ -10,7 +10,7 @@ settings:
   base:
     SWIFT_VERSION: "5.9"
     MACOSX_DEPLOYMENT_TARGET: "14.0"
-    MARKETING_VERSION: "2.0.0"
+    MARKETING_VERSION: "2.1.0"
     CURRENT_PROJECT_VERSION: 1
 
 targets: