@lattices/cli 0.4.6 → 0.4.8

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.6</string>
+    <string>0.4.8</string>
     <key>CFBundleShortVersionString</key>
-    <string>0.4.6</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.6</string>
+    <string>0.4.8</string>
     <key>CFBundleShortVersionString</key>
-    <string>0.4.6</string>
+    <string>0.4.8</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() }
@@ -162,6 +165,11 @@ class AppDelegate: NSObject, NSApplicationDelegate, NSPopoverDelegate {
         }
         store.register(action: .tileDistribute) { WindowTiler.distributeVisible(reactivateLattices: false) }
         store.register(action: .tileTypeGrid) { WindowTiler.distributeVisibleByFrontmostType(reactivateLattices: false) }
+        store.register(action: .tileOrganize) {
+            let appName = DesktopModel.shared.frontmostWindow()?.app
+                ?? NSWorkspace.shared.frontmostApplication?.localizedName
+            CommandModeWindow.shared.show(launchMode: .organize(appName: appName))
+        }
 
         // Onboarding on first launch; otherwise just check permissions
         if !OnboardingWindowController.shared.showIfNeeded() {
@@ -178,7 +186,11 @@ 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)
 
@@ -198,6 +210,7 @@ class AppDelegate: NSObject, NSApplicationDelegate, NSPopoverDelegate {
     }
 
     func applicationWillTerminate(_ notification: Notification) {
+        KeyboardRemapController.shared.stop()
         LatticesCompanionBridgeServer.shared.stop()
         DaemonServer.shared.stop()
     }
@@ -328,6 +341,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/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/KeyRecorderView.swift

@@ -34,7 +34,7 @@ struct KeyRecorderView: View {
                     .frame(minWidth: 80, alignment: .leading)
             } else if let binding = binding {
                 HStack(spacing: 4) {
-                    ForEach(binding.displayParts, id: \.self) { part in
+                    ForEach(binding.compactDisplayParts, id: \.self) { part in
                         keyBadge(part)
                     }
                 }

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) }
     }
@@ -37,11 +49,14 @@ class Preferences: ObservableObject {
     @Published var companionCockpitLayout: LatticesCompanionCockpitLayout {
         didSet { persistCompanionCockpitLayout() }
     }
-
     @Published var mouseGesturesEnabled: Bool {
         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 {
@@ -156,19 +171,30 @@ 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()
-
         if UserDefaults.standard.object(forKey: "mouseGestures.enabled") != nil {
             self.mouseGesturesEnabled = UserDefaults.standard.bool(forKey: "mouseGestures.enabled")
         } 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"