add dev tooling from /init: swiftlint, skills, gitignore; apply swiftformat

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

.claude/skills/build/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: build
+description: Build BrewBar with xcodebuild in Debug configuration and report any compiler errors or warnings.
+disable-model-invocation: false
+---
+
+Build the BrewBar project using xcodebuild with the Debug configuration.
+
+Run the following command from the project root:
+
+```
+xcodebuild \
+  -project BrewBar.xcodeproj \
+  -scheme BrewBar \
+  -configuration Debug \
+  -destination "platform=macOS" \
+  build \
+  2>&1
+```
+
+After running:
+1. If the build succeeds, report "Build succeeded" and note any warnings.
+2. If it fails, show the relevant error lines (not the full raw output), explain what each error means, and suggest a fix if the cause is clear.
+
+This is a zero-dependency project (no SPM, CocoaPods, or Carthage), so no package resolution step is needed.

.claude/skills/run/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: run
+description: Build and launch BrewBar.app for manual testing. Use after making changes to verify the app runs and the menu bar icon appears correctly.
+disable-model-invocation: false
+---
+
+Build and launch BrewBar for manual testing.
+
+Steps:
+1. Build the app in Debug configuration:
+   ```
+   xcodebuild \
+     -project BrewBar.xcodeproj \
+     -scheme BrewBar \
+     -configuration Debug \
+     -destination "platform=macOS" \
+     build \
+     SYMROOT=build \
+     2>&1
+   ```
+   If the build fails, stop here and report the errors with explanations.
+
+2. If the build succeeds, open the built app:
+   ```
+   open build/Debug/BrewBar.app
+   ```
+
+3. Tell the user:
+   - The app is a menu bar app (.accessory policy) — it will NOT appear in the Dock, only in the menu bar at the top right of the screen
+   - Look for the BrewBar icon in the menu bar to confirm it launched
+   - Clicking the icon opens the menu; the app runs Homebrew commands in the background
+   - To quit, use the Quit option in the app's menu
+
+Note: If a previous instance is already running, macOS may bring it forward instead of launching a new one. Quit the existing instance first if you need a fresh launch.

.gitignore

@@ -1 +1,3 @@
 *.xcuserdatad/
+CLAUDE.local.md
+.claude/settings.local.json

.swiftlint.yml

@@ -0,0 +1,35 @@
+disabled_rules:
+  - trailing_whitespace  # swiftformat handles this
+  - todo                 # todos in comments are fine
+
+opt_in_rules:
+  - force_unwrapping
+  - empty_count
+  - closure_spacing
+  - contains_over_first_not_nil
+
+included:
+  - BrewBar
+
+excluded:
+  - BrewBar.xcodeproj
+
+line_length:
+  warning: 140
+  error: 200
+
+file_length:
+  warning: 500
+  error: 800
+
+function_body_length:
+  warning: 80
+  error: 120
+
+type_body_length:
+  warning: 400
+  error: 600
+
+cyclomatic_complexity:
+  warning: 15
+  error: 25

BrewBar/BrewBarApp.swift

@@ -2,7 +2,6 @@ import Cocoa
 
 @main
 class AppDelegate: NSObject, NSApplicationDelegate {
-    
     static func main() {
         let app = NSApplication.shared
         let delegate = AppDelegate()
@@ -24,7 +23,7 @@ class AppDelegate: NSObject, NSApplicationDelegate {
     var brewPath: String?
 
     var refreshTimer: Timer?
-    //var refreshInterval: TimeInterval = 3600
+    /// var refreshInterval: TimeInterval = 3600
     var refreshInterval: TimeInterval {
         get {
             let saved = UserDefaults.standard.double(forKey: "refreshInterval")
@@ -42,8 +41,7 @@ class AppDelegate: NSObject, NSApplicationDelegate {
 
     // MARK: - Menu
 
-    func applicationDidFinishLaunching(_ notification: Notification) {
-
+    func applicationDidFinishLaunching(_: Notification) {
         statusItem = NSStatusBar.system.statusItem(withLength: NSStatusItem.variableLength)
         setMenuBarIcon("brewbar-uptodate")
 
@@ -65,8 +63,6 @@ class AppDelegate: NSObject, NSApplicationDelegate {
 
         menu.addItem(NSMenuItem.separator())
 
-        
-        
         let intervalItem = NSMenuItem(title: "⏱ Refresh Interval", action: nil, keyEquivalent: "")
         let intervalSubmenu = NSMenu()
 
@@ -102,9 +98,6 @@ class AppDelegate: NSObject, NSApplicationDelegate {
         intervalItem.submenu = intervalSubmenu
         menu.addItem(intervalItem)
 
-        
-        
-
         versionItem = NSMenuItem(title: "🏷 Brew: ...", action: nil, keyEquivalent: "")
         menu.addItem(versionItem)
 
@@ -166,7 +159,7 @@ class AppDelegate: NSObject, NSApplicationDelegate {
 
         let paths = [
             "/opt/homebrew/bin/brew",
-            "/usr/local/bin/brew"
+            "/usr/local/bin/brew",
         ]
 
         for path in paths {
@@ -182,9 +175,7 @@ class AppDelegate: NSObject, NSApplicationDelegate {
     }
 
     func runBrew(_ command: String, completion: @escaping (String) -> Void = { _ in }) {
-
         DispatchQueue.global().async {
-
             let brew = self.resolveBrewPath()
             let cleaned = command.replacingOccurrences(of: "brew ", with: "")
             let fullCommand = "\(brew) \(cleaned)"
@@ -233,9 +224,8 @@ class AppDelegate: NSObject, NSApplicationDelegate {
         }
     }
 
-    // ✅ SMART refresh (uses cache)
+    /// ✅ SMART refresh (uses cache)
     @objc func refreshOutdatedList() {
-
         // if fetched in last 5s → uses cache
         if let last = lastOutdatedFetch, Date().timeIntervalSince(last) < 5 {
             updateOutdatedMenu(with: cachedOutdated)
@@ -245,7 +235,7 @@ class AppDelegate: NSObject, NSApplicationDelegate {
         fetchOutdated()
     }
 
-    // ✅ FORCE refresh (menu button)
+    /// ✅ FORCE refresh (menu button)
     @objc func forceRefreshOutdated() {
         fetchOutdated()
     }
@@ -254,7 +244,6 @@ class AppDelegate: NSObject, NSApplicationDelegate {
         setMenuBarIcon("brewbar-updating")
 
         runBrew("outdated") { output in
-
             let lines = output.split(separator: "\n").map { String($0) }
 
             self.cachedOutdated = lines
@@ -273,7 +262,6 @@ class AppDelegate: NSObject, NSApplicationDelegate {
     }
 
     func updateOutdatedMenu(with lines: [String]) {
-
         outdatedSubmenu.removeAllItems()
         outdatedSubmenu.addItem(NSMenuItem(title: "Refresh List", action: #selector(forceRefreshOutdated), keyEquivalent: ""))
 
@@ -283,7 +271,7 @@ class AppDelegate: NSObject, NSApplicationDelegate {
         }
 
         for formula in lines {
-            let item = NSMenuItem(title: formula, action: #selector(self.upgradeSingle(_:)), keyEquivalent: "")
+            let item = NSMenuItem(title: formula, action: #selector(upgradeSingle(_:)), keyEquivalent: "")
             item.representedObject = formula
             outdatedSubmenu.addItem(item)
         }
@@ -313,7 +301,7 @@ class AppDelegate: NSObject, NSApplicationDelegate {
         }
     }
 
-    // ✅ Brew version (correct)
+    /// ✅ Brew version (correct)
     func refreshBrewVersion() {
         runBrew("--version") { output in
             let firstLine = output.split(separator: "\n").first.map(String.init) ?? "Unknown"

BrewBar/LogWindowController.swift

@@ -1,11 +1,9 @@
 import Cocoa
 
 class LogWindowController: NSWindowController {
-
     var textView: NSTextView!
 
     convenience init() {
-
         let contentRect = NSRect(x: 0, y: 0, width: 600, height: 400)
         let styleMask: NSWindow.StyleMask = [.titled, .closable, .resizable]
 
@@ -31,6 +29,7 @@ class LogWindowController: NSWindowController {
 
     func update(text: String) {
         textView.string = text
+
         textView.scrollToEndOfDocument(nil)
     }
 }