@lattices/cli 0.4.7 → 0.4.9

package/README.md

@@ -81,11 +81,11 @@ Close your laptop, reboot, come back a week later — your editor, dev
 server, and test runner are exactly where you left them.
 
 ```sh
-cd my-project && lattices
+cd my-project && lattices start
 ```
 
-No config? It reads your `package.json` and picks the right dev command
-automatically.
+No config? It opens a shell in the project and, when it can, starts your
+detected dev command in a second pane.
 
 ### Configuration
 
@@ -95,7 +95,7 @@ Drop a `.lattices.json` in your project root:
 {
   "ensure": true,
   "panes": [
-    { "name": "claude", "cmd": "claude", "size": 60 },
+    { "name": "shell", "size": 60 },
     { "name": "server", "cmd": "pnpm dev" },
     { "name": "tests",  "cmd": "pnpm test --watch" }
   ]
@@ -108,7 +108,7 @@ Drop a `.lattices.json` in your project root:
 2 panes              3+ panes
 
 ┌──────────┬───────┐ ┌──────────┬───────┐
-│  claude  │server │ │  claude  │server │
+│  shell   │server │ │  shell   │server │
 │  (60%)   │(40%)  │ │  (60%)   ├───────┤
 └──────────┴───────┘ │          │tests  │
                      └──────────┴───────┘
@@ -193,7 +193,9 @@ desktop the same way you do.
 ## CLI
 
 ```
-lattices                    Create or reattach to session
+lattices                    Show workspace status and common commands
+lattices start              Create or reattach to current project session
+lattices tmux               Alias for lattices start
 lattices init               Generate .lattices.json
 lattices ls                 List active sessions
 lattices kill [name]        Kill a session

package/app/Info.plist

@@ -14,10 +14,21 @@
     <string>AppIcon</string>
     <key>CFBundlePackageType</key>
     <string>APPL</string>
+    <key>CFBundleURLTypes</key>
+    <array>
+        <dict>
+            <key>CFBundleURLName</key>
+            <string>com.arach.lattices</string>
+            <key>CFBundleURLSchemes</key>
+            <array>
+                <string>lattices</string>
+            </array>
+        </dict>
+    </array>
     <key>CFBundleVersion</key>
-    <string>0.4.7</string>
+    <string>0.4.8</string>
     <key>CFBundleShortVersionString</key>
-    <string>0.4.7</string>
+    <string>0.4.8</string>
     <key>LSMinimumSystemVersion</key>
     <string>13.0</string>
     <key>LSUIElement</key>

package/app/Lattices.app/Contents/Info.plist

@@ -14,10 +14,21 @@
     <string>AppIcon</string>
     <key>CFBundlePackageType</key>
     <string>APPL</string>
+    <key>CFBundleURLTypes</key>
+    <array>
+        <dict>
+            <key>CFBundleURLName</key>
+            <string>com.arach.lattices</string>
+            <key>CFBundleURLSchemes</key>
+            <array>
+                <string>lattices</string>
+            </array>
+        </dict>
+    </array>
     <key>CFBundleVersion</key>
-    <string>0.4.7</string>
+    <string>0.4.9</string>
     <key>CFBundleShortVersionString</key>
-    <string>0.4.7</string>
+    <string>0.4.9</string>
     <key>LSMinimumSystemVersion</key>
     <string>13.0</string>
     <key>LSUIElement</key>

package/app/Sources/AppShell/App.swift

@@ -5,7 +5,13 @@ struct LatticesApp: App {
     @NSApplicationDelegateAdaptor(AppDelegate.self) var delegate
 
     var body: some Scene {
-        Settings { EmptyView() }
+        Settings {
+            SettingsContentView(
+                prefs: Preferences.shared,
+                scanner: ProjectScanner.shared
+            )
+            .frame(width: 900, height: 640)
+        }
             .commands {
                 CommandGroup(after: .appInfo) {
                     Button("Update Lattices…") {

package/app/Sources/AppShell/AppDelegate.swift

@@ -1,4 +1,5 @@
 import AppKit
+import Carbon
 import SwiftUI
 
 extension Notification.Name {
@@ -69,6 +70,7 @@ class AppDelegate: NSObject, NSApplicationDelegate, NSPopoverDelegate {
         Self.shared = self
         NSApp.setActivationPolicy(.accessory)
         NSApp.appearance = NSAppearance(named: .darkAqua)
+        registerDeepLinkHandler()
 
         // --- Status item ---
         statusItem = NSStatusBar.system.statusItem(withLength: NSStatusItem.squareLength)
@@ -124,6 +126,7 @@ class AppDelegate: NSObject, NSApplicationDelegate, NSPopoverDelegate {
         store.register(action: .omniSearch) { OmniSearchWindow.shared.toggle() }
         WindowDragSnapController.shared.start()
         MouseGestureController.shared.start()
+        KeyboardRemapController.shared.start()
 
         // Session layer cycling
         store.register(action: .layerNext) { SessionLayerStore.shared.cycleNext() }
@@ -183,10 +186,18 @@ class AppDelegate: NSObject, NSApplicationDelegate, NSPopoverDelegate {
         ProcessModel.shared.start()
         LatticesApi.setup()
         DaemonServer.shared.start()
-        LatticesCompanionBridgeServer.shared.start()
+        if Preferences.shared.companionBridgeEnabled {
+            LatticesCompanionBridgeServer.shared.start()
+        } else {
+            diag.info("CompanionBridge: disabled by preference")
+        }
         AgentPool.shared.start()
         diag.finish(tBoot)
 
+        Task {
+            await AppUpdater.shared.checkIfNeeded()
+        }
+
         // --diagnostics flag: auto-open diagnostics panel on launch
         if CommandLine.arguments.contains("--diagnostics") {
             DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
@@ -203,6 +214,7 @@ class AppDelegate: NSObject, NSApplicationDelegate, NSPopoverDelegate {
     }
 
     func applicationWillTerminate(_ notification: Notification) {
+        KeyboardRemapController.shared.stop()
         LatticesCompanionBridgeServer.shared.stop()
         DaemonServer.shared.stop()
     }
@@ -333,6 +345,57 @@ class AppDelegate: NSObject, NSApplicationDelegate, NSPopoverDelegate {
     @objc private func menuSettings() { SettingsWindowController.shared.show() }
     @objc private func menuQuit() { NSApp.terminate(nil) }
 
+    // MARK: - Deep Links
+
+    private func registerDeepLinkHandler() {
+        NSAppleEventManager.shared().setEventHandler(
+            self,
+            andSelector: #selector(handleGetURLEvent(_:withReplyEvent:)),
+            forEventClass: AEEventClass(kInternetEventClass),
+            andEventID: AEEventID(kAEGetURL)
+        )
+    }
+
+    @objc private func handleGetURLEvent(
+        _ event: NSAppleEventDescriptor,
+        withReplyEvent replyEvent: NSAppleEventDescriptor
+    ) {
+        guard
+            let value = event.paramDescriptor(forKeyword: keyDirectObject)?.stringValue,
+            let url = URL(string: value)
+        else {
+            return
+        }
+        handleDeepLink(url)
+    }
+
+    private func handleDeepLink(_ url: URL) {
+        guard url.scheme?.localizedCaseInsensitiveCompare("lattices") == .orderedSame else {
+            return
+        }
+
+        let host = url.host?.lowercased()
+        let action = url.pathComponents
+            .first { $0 != "/" }?
+            .lowercased()
+
+        guard host == "companion" else {
+            SettingsWindowController.shared.show()
+            return
+        }
+
+        switch action {
+        case "enable", "start":
+            Preferences.shared.companionBridgeEnabled = true
+            SettingsWindowController.shared.showCompanion()
+        case "disable", "stop":
+            Preferences.shared.companionBridgeEnabled = false
+            SettingsWindowController.shared.showCompanion()
+        default:
+            SettingsWindowController.shared.showCompanion()
+        }
+    }
+
     private static func showWorkspaceInspector() {
         guard let entry = DesktopModel.shared.frontmostWindow(),
               entry.app != "Lattices" else {

package/app/Sources/AppShell/AppShellView.swift

@@ -8,6 +8,7 @@ enum AppPage: String, CaseIterable {
     case desktopInventory
     case pi
     case settings
+    case companionSettings
     case docs
 
     var label: String {
@@ -17,6 +18,7 @@ enum AppPage: String, CaseIterable {
         case .desktopInventory: return "Desktop Inventory"
         case .pi:               return "Pi"
         case .settings:         return "Settings"
+        case .companionSettings:return "Settings"
         case .docs:             return "Docs"
         }
     }
@@ -28,6 +30,7 @@ enum AppPage: String, CaseIterable {
         case .desktopInventory: return "macwindow.on.rectangle"
         case .pi:               return "terminal"
         case .settings:         return "gearshape"
+        case .companionSettings:return "ipad.and.iphone"
         case .docs:             return "book"
         }
     }
@@ -129,6 +132,13 @@ struct AppShellView: View {
                 scanner: ProjectScanner.shared,
                 onBack: { windowController.activePage = .screenMap; controller.enter() }
             )
+        case .companionSettings:
+            SettingsContentView(
+                page: .companionSettings,
+                prefs: Preferences.shared,
+                scanner: ProjectScanner.shared,
+                onBack: { windowController.activePage = .screenMap; controller.enter() }
+            )
         case .docs:
             SettingsContentView(
                 page: .docs,

package/app/Sources/AppShell/AppUpdater.swift

@@ -1,6 +1,15 @@
 import AppKit
 import Combine
 import Foundation
+import SwiftUI
+
+struct LatticesUpdateInfo: Equatable {
+    let version: String
+    let downloadURL: URL
+    let releaseNotes: String
+    let publishedAt: Date
+    let htmlURL: URL
+}
 
 @MainActor
 final class AppUpdater: ObservableObject {
@@ -8,6 +17,16 @@ final class AppUpdater: ObservableObject {
 
     @Published private(set) var isUpdating = false
     @Published private(set) var statusMessage: String?
+    @Published private(set) var availableUpdate: LatticesUpdateInfo?
+    @Published private(set) var isChecking = false
+    @Published private(set) var lastChecked: Date?
+    @Published private(set) var lastError: String?
+
+    @AppStorage("appUpdater.autoCheck") var autoCheckEnabled = true
+    @AppStorage("appUpdater.lastCheckTime") private var lastCheckTimeInterval: Double = 0
+    @AppStorage("appUpdater.skippedVersion") private var skippedVersion = ""
+
+    private let checkInterval: TimeInterval = 24 * 60 * 60
 
     private init() {}
 
@@ -27,6 +46,62 @@ final class AppUpdater: ObservableObject {
         return nil
     }
 
+    func checkIfNeeded() async {
+        guard autoCheckEnabled else { return }
+
+        let now = Date()
+        let lastCheck = Date(timeIntervalSince1970: lastCheckTimeInterval)
+        if now.timeIntervalSince(lastCheck) < checkInterval { return }
+
+        await check()
+    }
+
+    func check() async {
+        guard !isChecking else { return }
+
+        isChecking = true
+        lastError = nil
+
+        defer {
+            isChecking = false
+            lastChecked = Date()
+            lastCheckTimeInterval = Date().timeIntervalSince1970
+        }
+
+        do {
+            let release = try await fetchLatestRelease()
+            guard let update = parseRelease(release), isNewerVersion(update.version) else {
+                availableUpdate = nil
+                return
+            }
+
+            if update.version == skippedVersion {
+                availableUpdate = nil
+                return
+            }
+
+            availableUpdate = update
+        } catch UpdateCheckError.noRelease {
+            availableUpdate = nil
+        } catch {
+            lastError = error.localizedDescription
+        }
+    }
+
+    func skipCurrentUpdate() {
+        guard let update = availableUpdate else { return }
+        skippedVersion = update.version
+        availableUpdate = nil
+    }
+
+    func viewCurrentRelease() {
+        if let update = availableUpdate {
+            NSWorkspace.shared.open(update.htmlURL)
+        } else if let url = URL(string: "https://github.com/arach/lattices/releases/latest") {
+            NSWorkspace.shared.open(url)
+        }
+    }
+
     func promptForUpdate() {
         guard canUpdate else {
             presentAlert(
@@ -36,11 +111,50 @@ final class AppUpdater: ObservableObject {
             return
         }
 
+        guard availableUpdate != nil else {
+            Task {
+                await check()
+                if availableUpdate != nil {
+                    presentUpdateConfirmation()
+                } else if let error = lastError {
+                    presentAlert(
+                        title: "Could Not Check for Updates",
+                        message: error
+                    )
+                } else {
+                    presentAlert(
+                        title: "Lattices Is Up to Date",
+                        message: "You’re running \(currentVersion), which is the latest published release."
+                    )
+                }
+            }
+            return
+        }
+
+        presentUpdateConfirmation()
+    }
+
+    private func presentUpdateConfirmation() {
         let alert = NSAlert()
         alert.alertStyle = .informational
-        alert.messageText = "Install the latest Lattices app update?"
-        alert.informativeText = "Lattices will download the latest released app bundle, close, and relaunch when the update is ready."
-        alert.addButton(withTitle: "Update")
+        if let update = availableUpdate {
+            alert.messageText = "Update Lattices?"
+            alert.informativeText = """
+            Current version: \(currentVersion)
+            New version: \(update.version)
+
+            Lattices will download the signed release, quit briefly, replace the app, and relaunch when the update is ready.
+            """
+        } else {
+            alert.messageText = "Check and update Lattices?"
+            alert.informativeText = """
+            Current version: \(currentVersion)
+            New version: latest published release
+
+            Lattices will download the signed release, quit briefly, replace the app, and relaunch when the update is ready.
+            """
+        }
+        alert.addButton(withTitle: availableUpdate == nil ? "Check & Update" : "Update")
         alert.addButton(withTitle: "Cancel")
 
         guard alert.runModal() == .alertFirstButtonReturn else { return }
@@ -72,7 +186,11 @@ final class AppUpdater: ObservableObject {
         do {
             try proc.run()
             isUpdating = true
-            statusMessage = "Updating to the latest release. Lattices will relaunch when it's ready."
+            if let update = availableUpdate {
+                statusMessage = "Preparing Lattices \(update.version). The app will relaunch when the update is ready."
+            } else {
+                statusMessage = "Preparing the latest Lattices release. The app will relaunch when the update is ready."
+            }
         } catch {
             presentAlert(
                 title: "Update Failed",
@@ -89,4 +207,98 @@ final class AppUpdater: ObservableObject {
         alert.addButton(withTitle: "OK")
         alert.runModal()
     }
+
+    private func fetchLatestRelease() async throws -> GitHubRelease {
+        let url = URL(string: "https://api.github.com/repos/arach/lattices/releases/latest")!
+        var request = URLRequest(url: url)
+        request.setValue("application/vnd.github+json", forHTTPHeaderField: "Accept")
+        request.setValue("Lattices/\(currentVersion)", forHTTPHeaderField: "User-Agent")
+
+        let (data, response) = try await URLSession.shared.data(for: request)
+        guard let http = response as? HTTPURLResponse else {
+            throw UpdateCheckError.invalidResponse
+        }
+
+        switch http.statusCode {
+        case 200:
+            let decoder = JSONDecoder()
+            decoder.keyDecodingStrategy = .convertFromSnakeCase
+            decoder.dateDecodingStrategy = .iso8601
+            return try decoder.decode(GitHubRelease.self, from: data)
+        case 404:
+            throw UpdateCheckError.noRelease
+        case 403:
+            throw UpdateCheckError.rateLimited
+        default:
+            throw UpdateCheckError.httpError(http.statusCode)
+        }
+    }
+
+    private func parseRelease(_ release: GitHubRelease) -> LatticesUpdateInfo? {
+        guard !release.draft, !release.prerelease else { return nil }
+
+        let asset = release.assets.first { asset in
+            asset.name == "Lattices.dmg" ||
+            (asset.name.hasPrefix("Lattices") && asset.name.hasSuffix(".dmg"))
+        }
+
+        guard let asset,
+              let downloadURL = URL(string: asset.browserDownloadUrl),
+              let htmlURL = URL(string: release.htmlUrl) else {
+            return nil
+        }
+
+        let version = release.tagName.hasPrefix("v")
+            ? String(release.tagName.dropFirst())
+            : release.tagName
+
+        return LatticesUpdateInfo(
+            version: version,
+            downloadURL: downloadURL,
+            releaseNotes: release.body ?? "",
+            publishedAt: release.publishedAt,
+            htmlURL: htmlURL
+        )
+    }
+
+    private func isNewerVersion(_ remoteVersion: String) -> Bool {
+        guard currentVersion != "unknown" else { return false }
+        return remoteVersion.compare(currentVersion, options: .numeric) == .orderedDescending
+    }
+}
+
+private struct GitHubRelease: Decodable {
+    let tagName: String
+    let name: String
+    let body: String?
+    let htmlUrl: String
+    let publishedAt: Date
+    let assets: [GitHubAsset]
+    let prerelease: Bool
+    let draft: Bool
+}
+
+private struct GitHubAsset: Decodable {
+    let name: String
+    let browserDownloadUrl: String
+}
+
+private enum UpdateCheckError: LocalizedError {
+    case invalidResponse
+    case noRelease
+    case rateLimited
+    case httpError(Int)
+
+    var errorDescription: String? {
+        switch self {
+        case .invalidResponse:
+            return "Invalid response from GitHub."
+        case .noRelease:
+            return "No published release found."
+        case .rateLimited:
+            return "GitHub rate limited the update check."
+        case .httpError(let code):
+            return "GitHub returned HTTP \(code)."
+        }
+    }
 }

package/app/Sources/AppShell/CliActionLauncher.swift

@@ -24,7 +24,7 @@ enum CliActionLauncher {
         ) else { return }
 
         Preferences.shared.terminal.launch(
-            command: "lattices init && lattices",
+            command: "lattices init && lattices start",
             in: directory
         )
     }
@@ -36,7 +36,7 @@ enum CliActionLauncher {
         ) else { return }
 
         Preferences.shared.terminal.launch(
-            command: "lattices",
+            command: "lattices start",
             in: directory
         )
     }

package/app/Sources/AppShell/MainView.swift

@@ -490,7 +490,7 @@ struct MainView: View {
                 .buttonStyle(.plain)
             }
 
-            Text("Initialize runs  lattices init && lattices  in the folder you choose.")
+            Text("Initialize runs  lattices init && lattices start  in the folder you choose.")
                 .font(Typo.mono(9))
                 .foregroundColor(Palette.textMuted)
                 .multilineTextAlignment(.center)

package/app/Sources/AppShell/Preferences.swift

@@ -10,6 +10,7 @@ class Preferences: ObservableObject {
     static let shared = Preferences()
 
     private enum CompanionDefaultsKey {
+        static let bridgeEnabled = "companion.bridge.enabled"
         static let trackpadEnabled = "companion.trackpad.enabled"
         static let cockpitLayout = "companion.cockpit.layout"
     }
@@ -30,6 +31,17 @@ class Preferences: ObservableObject {
         didSet { UserDefaults.standard.set(dragSnapEnabled, forKey: "windowSnap.enabled") }
     }
 
+    @Published var companionBridgeEnabled: Bool {
+        didSet {
+            UserDefaults.standard.set(companionBridgeEnabled, forKey: CompanionDefaultsKey.bridgeEnabled)
+            if companionBridgeEnabled {
+                LatticesCompanionBridgeServer.shared.start()
+            } else {
+                LatticesCompanionBridgeServer.shared.stop()
+            }
+        }
+    }
+
     @Published var companionTrackpadEnabled: Bool {
         didSet { UserDefaults.standard.set(companionTrackpadEnabled, forKey: CompanionDefaultsKey.trackpadEnabled) }
     }
@@ -41,6 +53,10 @@ class Preferences: ObservableObject {
         didSet { UserDefaults.standard.set(mouseGesturesEnabled, forKey: "mouseGestures.enabled") }
     }
 
+    @Published var keyboardRemapsEnabled: Bool {
+        didSet { UserDefaults.standard.set(keyboardRemapsEnabled, forKey: "keyboardRemaps.enabled") }
+    }
+
     // MARK: - AI / Claude
 
     @Published var claudePath: String {
@@ -155,10 +171,16 @@ class Preferences: ObservableObject {
             self.dragSnapEnabled = true
         }
 
+        if UserDefaults.standard.object(forKey: CompanionDefaultsKey.bridgeEnabled) != nil {
+            self.companionBridgeEnabled = UserDefaults.standard.bool(forKey: CompanionDefaultsKey.bridgeEnabled)
+        } else {
+            self.companionBridgeEnabled = false
+        }
+
         if UserDefaults.standard.object(forKey: CompanionDefaultsKey.trackpadEnabled) != nil {
             self.companionTrackpadEnabled = UserDefaults.standard.bool(forKey: CompanionDefaultsKey.trackpadEnabled)
         } else {
-            self.companionTrackpadEnabled = true
+            self.companionTrackpadEnabled = false
         }
 
         self.companionCockpitLayout = Self.loadCompanionCockpitLayout()
@@ -167,6 +189,12 @@ class Preferences: ObservableObject {
         } else {
             self.mouseGesturesEnabled = false
         }
+
+        if UserDefaults.standard.object(forKey: "keyboardRemaps.enabled") != nil {
+            self.keyboardRemapsEnabled = UserDefaults.standard.bool(forKey: "keyboardRemaps.enabled")
+        } else {
+            self.keyboardRemapsEnabled = true
+        }
         // AI / Claude
         self.claudePath = UserDefaults.standard.string(forKey: "claude.path") ?? ""
         self.advisorModel = UserDefaults.standard.string(forKey: "claude.advisorModel") ?? "haiku"