@lattices/cli 0.4.6 → 0.4.8

package/app/Sources/Core/Overlays/CommandMode/CommandModeState.swift

@@ -45,6 +45,11 @@ enum DesktopInventoryMode: Equatable {
     case screenMap    // m → interactive screen map editor
 }
 
+enum CommandModeLaunchMode: Equatable {
+    case normal
+    case organize(appName: String?)
+}
+
 // DisplayGeometry, ScreenMapWindowEntry, ScreenMapEditorState, ScreenMapActionLog
 // are defined in ScreenMapState.swift
 // MARK: - Filter Presets
@@ -132,10 +137,43 @@ final class CommandModeState: ObservableObject {
 
     var onDismiss: (() -> Void)?
     var onPanelResize: ((_ width: CGFloat, _ height: CGFloat) -> Void)?
+    private let launchMode: CommandModeLaunchMode
 
     /// Tracks the last item navigated to, for consistent Shift+arrow multi-select
     private var cursorWindowId: UInt32?
 
+    init(launchMode: CommandModeLaunchMode = .normal) {
+        self.launchMode = launchMode
+    }
+
+    var isOrganizeFlow: Bool {
+        if case .organize = launchMode { return true }
+        return false
+    }
+
+    var organizeSeedAppName: String? {
+        if case .organize(let appName) = launchMode { return appName }
+        return nil
+    }
+
+    var organizeSelectionSummary: String {
+        let count = selectedWindowIds.count
+        if let appName = organizeSeedAppName, !appName.isEmpty {
+            return "\(count) \(appName) window\(count == 1 ? "" : "s") selected"
+        }
+        return "\(count) window\(count == 1 ? "" : "s") selected"
+    }
+
+    var organizeGuidance: String {
+        if selectedWindowIds.count > 1 {
+            return "Press D to organize. Cmd-click adds or removes windows. Shift-click extends the selection."
+        }
+        if selectedWindowIds.count == 1 {
+            return "Cmd-click another window to add it, then press D to organize the set."
+        }
+        return "Click windows to select them. Cmd-click adds or removes windows, and D organizes the selection."
+    }
+
     // MARK: - Selection Helpers
 
     /// Backwards-compat: returns single selected ID (first element)
@@ -369,6 +407,7 @@ final class CommandModeState: ObservableObject {
         desktopMode = .browsing
         gridPreviewPlacement = nil
         phase = .desktopInventory
+        configureLaunchMode()
         // Don't call onPanelResize here — caller handles initial sizing
     }
 
@@ -576,6 +615,20 @@ final class CommandModeState: ObservableObject {
             }
             return true
 
+        case 2: // d → distribute selected
+            if isSearching && selectedWindowIds.isEmpty { return false }
+            if isSearching { deactivateSearch() }
+            guard !selectedWindowIds.isEmpty else {
+                flash("Select 2+ windows to organize")
+                return true
+            }
+            guard selectedWindowIds.count > 1 else {
+                flash("Add another window, then press D to organize")
+                return true
+            }
+            distributeSelected()
+            return true
+
         case 46: // m → screen map editor (standalone window)
             if isSearching { deactivateSearch() }
             ScreenMapWindowController.shared.show()
@@ -1050,6 +1103,54 @@ final class CommandModeState: ObservableObject {
         }
     }
 
+    private func configureLaunchMode() {
+        switch launchMode {
+        case .normal:
+            return
+        case .organize(let appName):
+            activePreset = .currentSpace
+            seedSelectionForOrganization(appName: appName)
+        }
+    }
+
+    private func seedSelectionForOrganization(appName: String?) {
+        let visibleWindows = flatWindowList.filter(\.isOnScreen)
+        let targetApp = appName ?? visibleWindows.first?.appName
+        let initialSelection = visibleWindows.filter { window in
+            guard let name = window.appName, let targetApp else { return false }
+            return name.localizedCaseInsensitiveCompare(targetApp) == .orderedSame
+        }
+
+        if initialSelection.isEmpty {
+            flash("Select windows to organize. Cmd-click adds or removes windows; D distributes.")
+            return
+        }
+
+        selectedWindowIds = Set(initialSelection.map(\.id))
+        cursorWindowId = initialSelection.first?.id
+
+        if let targetApp {
+            if initialSelection.count > 1 {
+                flash("Selected \(initialSelection.count) \(targetApp) windows. Press D to organize.")
+            } else {
+                flash("Selected the \(targetApp) window. Cmd-click more windows, then press D.")
+            }
+        } else if initialSelection.count > 1 {
+            flash("Selected \(initialSelection.count) windows. Press D to organize.")
+        } else {
+            flash("Selected 1 window. Cmd-click more windows, then press D.")
+        }
+
+        DispatchQueue.main.async { [weak self] in
+            guard let self = self else { return }
+            if self.selectedWindowIds.count > 1 {
+                self.highlightAllSelected()
+            } else {
+                self.highlightSelectedWindow()
+            }
+        }
+    }
+
     // MARK: - Inventory Builder
 
     private func buildInventory() -> CommandModeInventory {

package/app/Sources/Core/Overlays/CommandMode/CommandModeView.swift

@@ -200,10 +200,17 @@ struct CommandModeView: View {
 
     private var header: some View {
         HStack {
-            Text(isDesktopInventory ? "DESKTOP INVENTORY" : "COMMAND MODE")
+            Text(isDesktopInventory ? (state.isOrganizeFlow ? "ORGANIZE WINDOWS" : "DESKTOP INVENTORY") : "COMMAND MODE")
                 .font(Typo.monoBold(11))
                 .foregroundColor(Palette.text)
 
+            if isDesktopInventory && state.isOrganizeFlow {
+                bannerBadge("Current Space", tone: .neutral)
+                if let appName = state.organizeSeedAppName, !appName.isEmpty {
+                    bannerBadge(appName, tone: .accent)
+                }
+            }
+
             if isDesktopInventory {
                 Button(action: { state.copyInventoryToClipboard() }) {
                     HStack(spacing: 3) {
@@ -275,6 +282,11 @@ struct CommandModeView: View {
 
     private func desktopInventoryContent(contentWidth: CGFloat) -> some View {
         VStack(spacing: 0) {
+            if state.isOrganizeFlow {
+                organizeBanner
+                divider
+            }
+
             if state.isSearching {
                 searchBar
             } else {
@@ -358,6 +370,33 @@ struct CommandModeView: View {
         }
     }
 
+    private var organizeBanner: some View {
+        VStack(alignment: .leading, spacing: 6) {
+            HStack(alignment: .center, spacing: 8) {
+                Image(systemName: "rectangle.3.group")
+                    .font(.system(size: 11, weight: .medium))
+                    .foregroundColor(Palette.running)
+                Text(state.organizeSelectionSummary)
+                    .font(Typo.monoBold(10))
+                    .foregroundColor(Palette.text)
+                Spacer()
+                if state.selectedWindowIds.count > 1 {
+                    bannerBadge("Ready", tone: .accent)
+                } else {
+                    bannerBadge("Add More", tone: .neutral)
+                }
+            }
+
+            Text(state.organizeGuidance)
+                .font(Typo.mono(10))
+                .foregroundColor(Palette.textDim)
+                .lineLimit(2)
+        }
+        .padding(.horizontal, 14)
+        .padding(.vertical, 8)
+        .background(Palette.running.opacity(0.06))
+    }
+
     private var filterPillBar: some View {
         HStack(spacing: 6) {
             ForEach(FilterPreset.allCases, id: \.rawValue) { preset in
@@ -835,9 +874,17 @@ struct CommandModeView: View {
                 if indented {
                     Spacer().frame(width: 8)
                 }
-                Text(isLattices ? "●" : "•")
-                    .font(.system(size: 7))
-                    .foregroundColor(isLattices ? Palette.running : (isSelected ? Palette.text : Palette.textDim))
+                Group {
+                    if isSelected {
+                        Image(systemName: "checkmark.circle.fill")
+                            .font(.system(size: 10, weight: .semibold))
+                            .foregroundColor(Palette.running)
+                    } else {
+                        Text(isLattices ? "●" : "•")
+                            .font(.system(size: 7))
+                            .foregroundColor(isLattices ? Palette.running : Palette.textDim)
+                    }
+                }
                 if let app = appLabel {
                     Text(app)
                         .font(Typo.monoBold(10))
@@ -1242,6 +1289,9 @@ struct CommandModeView: View {
                     chordHint(key: "↩", label: "select & front")
                     chordHint(key: "⌘A", label: "select all")
                     chordHint(key: "⇧↑↓", label: "multi-select")
+                    if state.isOrganizeFlow && state.selectedWindowIds.count > 1 {
+                        chordHint(key: "d", label: "organize")
+                    }
                     if !state.selectedWindowIds.isEmpty {
                         chordHint(key: "t", label: "tile")
                     }
@@ -1279,9 +1329,42 @@ struct CommandModeView: View {
                             .foregroundColor(Palette.running)
                     }
                 }
+            } else if isDesktopInventory && state.isOrganizeFlow && state.selectedWindowIds.count > 1 {
+                HStack(spacing: 12) {
+                    chordHint(key: "d", label: "organize")
+                    chordHint(key: "⌘-click", label: "add/remove")
+                    chordHint(key: "⇧-click", label: "range")
+                    chordHint(key: "↩", label: "front")
+                    chordHint(key: "esc", label: "cancel")
+                    Spacer()
+                    Text("\(state.selectedWindowIds.count) selected")
+                        .font(Typo.mono(9))
+                        .foregroundColor(Palette.running)
+                }
+            } else if isDesktopInventory && state.isOrganizeFlow && !state.selectedWindowIds.isEmpty {
+                HStack(spacing: 12) {
+                    chordHint(key: "⌘-click", label: "add more")
+                    chordHint(key: "d", label: "need 2+")
+                    chordHint(key: "↩", label: "front")
+                    chordHint(key: "esc", label: "cancel")
+                    Spacer()
+                    Text(state.organizeSelectionSummary)
+                        .font(Typo.mono(9))
+                        .foregroundColor(Palette.textDim)
+                }
+            } else if isDesktopInventory && state.isOrganizeFlow {
+                HStack(spacing: 12) {
+                    chordHint(key: "click", label: "select")
+                    chordHint(key: "⌘-click", label: "add/remove")
+                    chordHint(key: "/", label: "search")
+                    chordHint(key: "esc", label: "cancel")
+                    Spacer()
+                }
             } else if isDesktopInventory && state.selectedWindowIds.count > 1 {
                 // Multi-selection active
                 HStack(spacing: 12) {
+                    chordHint(key: "s", label: "grid preview")
+                    chordHint(key: "d", label: "distribute")
                     chordHint(key: "s", label: "grid preview")
                     chordHint(key: "↩", label: "front")
                     chordHint(key: "t", label: "grid region")
@@ -1302,6 +1385,7 @@ struct CommandModeView: View {
             } else if isDesktopInventory && !state.selectedWindowIds.isEmpty {
                 // Single selection active — browsing hints with direct shortcuts
                 HStack(spacing: 12) {
+                    chordHint(key: "d", label: "organize")
                     chordHint(key: "s", label: "show")
                     chordHint(key: "↩", label: "front")
                     chordHint(key: "f", label: "focus+close")
@@ -1367,6 +1451,31 @@ struct CommandModeView: View {
         }
     }
 
+    private enum BannerTone {
+        case neutral
+        case accent
+    }
+
+    private func bannerBadge(_ text: String, tone: BannerTone) -> some View {
+        let foreground = tone == .accent ? Palette.running : Palette.textDim
+        let fill = tone == .accent ? Palette.running.opacity(0.10) : Palette.surface
+        let stroke = tone == .accent ? Palette.running.opacity(0.30) : Palette.border
+
+        return Text(text)
+            .font(Typo.mono(8))
+            .foregroundColor(foreground)
+            .padding(.horizontal, 6)
+            .padding(.vertical, 3)
+            .background(
+                RoundedRectangle(cornerRadius: 8)
+                    .fill(fill)
+                    .overlay(
+                        RoundedRectangle(cornerRadius: 8)
+                            .strokeBorder(stroke, lineWidth: 0.5)
+                    )
+            )
+    }
+
     private func actionButton(key: String, label: String, action: @escaping () -> Void) -> some View {
         Button(action: action) {
             HStack(spacing: 4) {

package/app/Sources/Core/Overlays/CommandMode/CommandModeWindow.swift

@@ -43,15 +43,19 @@ final class CommandModeWindow {
 
     var isVisible: Bool { isOpen }
 
-    func toggle() {
+    func toggle(launchMode: CommandModeLaunchMode = .normal) {
         if isOpen {
-            dismiss()
+            if launchMode == .normal {
+                dismiss()
+            } else {
+                show(launchMode: launchMode)
+            }
         } else {
-            show()
+            show(launchMode: launchMode)
         }
     }
 
-    func show() {
+    func show(launchMode: CommandModeLaunchMode = .normal) {
         // Always rebuild for fresh state
         dismiss()
         isOpen = true
@@ -61,7 +65,7 @@ final class CommandModeWindow {
             CommandPaletteWindow.shared.dismiss()
         }
 
-        let state = CommandModeState()
+        let state = CommandModeState(launchMode: launchMode)
         state.onDismiss = { [weak self] in
             self?.dismiss()
         }

package/app/Sources/Core/Overlays/HUD/CheatSheetHUD.swift

@@ -255,6 +255,7 @@ struct CheatSheetView: View {
             shortcutRow(action: .tileCenter)
             shortcutRow(action: .tileDistribute)
             shortcutRow(action: .tileTypeGrid)
+            shortcutRow(action: .tileOrganize)
 
             // Hovered shortcut detail
             if let hovered = hoveredAction, let binding = hotkeyStore.bindings[hovered] {

package/app/Sources/Core/Overlays/ScreenMap/ScreenMapState.swift

@@ -2035,7 +2035,6 @@ final class ScreenMapController: ObservableObject {
 
     func handleKey(_ keyCode: UInt16, modifiers: NSEvent.ModifierFlags = []) -> Bool {
         let diag = DiagnosticLog.shared
-        diag.info("[ScreenMap] key: \(keyCode)")
 
         // Tiling mode intercepts keys before anything else
         if editor?.isTilingMode == true {

package/app/Sources/Core/Overlays/ScreenMap/ScreenMapView.swift

@@ -1805,6 +1805,7 @@ struct ScreenMapView: View {
         let displays = editor?.displays ?? []
         let zoomLevel = editor?.zoomLevel ?? 1.0
         let panOffset = editor?.panOffset ?? .zero
+        let canvasShape = RoundedRectangle(cornerRadius: 6, style: .continuous)
 
         return GeometryReader { geo in
             let metrics = CanvasMetrics(editor: editor, displays: displays, viewportSize: geo.size)
@@ -1852,12 +1853,14 @@ struct ScreenMapView: View {
         }
         .padding(8)
         .frame(maxWidth: .infinity, maxHeight: .infinity)
+        .contentShape(canvasShape)
+        .clipShape(canvasShape)
         .clipped()
         .background(
             ZStack {
-                RoundedRectangle(cornerRadius: 6)
+                canvasShape
                     .fill(Color.black.opacity(0.25))
-                RoundedRectangle(cornerRadius: 6)
+                canvasShape
                     .strokeBorder(Color.white.opacity(0.06), lineWidth: 0.5)
                 Canvas { context, size in
                     let spacing: CGFloat = 20
@@ -2742,11 +2745,14 @@ struct ScreenMapView: View {
             }
             // Track space key for canvas drag-to-pan
             if event.keyCode == 49 && !controller.isSearchActive {
-                if event.type == .keyDown && !event.isARepeat {
-                    isSpaceHeld = true
-                    NSCursor.openHand.push()
+                if event.type == .keyDown {
+                    if !isSpaceHeld {
+                        isSpaceHeld = true
+                        NSCursor.openHand.push()
+                    }
                     return nil
                 } else if event.type == .keyUp {
+                    guard isSpaceHeld else { return nil }
                     isSpaceHeld = false
                     spaceDragStart = nil
                     NSCursor.pop()
@@ -2788,16 +2794,18 @@ struct ScreenMapView: View {
         mouseDownMonitor = NSEvent.addLocalMonitorForEvents(matching: .leftMouseDown) { event in
             guard let eventWindow = event.window,
                   eventWindow === ScreenMapWindowController.shared.nsWindow else { return event }
+            let flippedPt = flippedScreenPoint(event)
 
             // Space+click → begin canvas pan
-            if isSpaceHeld, let editor = controller.editor {
+            if isSpaceHeld,
+               isCanvasPoint(flippedPt),
+               let editor = controller.editor {
                 spaceDragStart = event.locationInWindow
                 spaceDragPanStart = editor.panOffset
                 NSCursor.closedHand.push()
                 return nil
             }
 
-            let flippedPt = flippedScreenPoint(event)
             if let editor = controller.editor,
                let hit = canvasHit(flippedScreenPt: flippedPt, editor: editor),
                hoveredWindowId == hit.id {
@@ -3042,6 +3050,7 @@ struct ScreenMapView: View {
     // MARK: - Hit Test / Coordinate Conversion
 
     private func canvasHit(flippedScreenPt: CGPoint, editor: ScreenMapEditorState) -> CanvasHit? {
+        guard isCanvasPoint(flippedScreenPt) else { return nil }
         let projection = CanvasProjection(editor: editor)
         guard projection.scale > 0 else { return nil }
         let canvasLocal = CGPoint(
@@ -3059,6 +3068,10 @@ struct ScreenMapView: View {
         return nil
     }
 
+    private func isCanvasPoint(_ point: CGPoint) -> Bool {
+        CGRect(origin: screenMapCanvasOrigin, size: screenMapCanvasSize).contains(point)
+    }
+
     private func detectDragMode(mapPoint: CGPoint, windowMapRect: CGRect) -> CanvasDragMode {
         let w = windowMapRect.width
         let h = windowMapRect.height

package/app/Sources/Core/Workspace/SessionManager.swift

@@ -13,7 +13,7 @@ enum SessionManager {
             }
             terminal.focusOrAttach(session: project.sessionName)
         } else {
-            terminal.launch(command: latticesPath, in: project.path)
+            terminal.launch(command: "\(latticesPath) start", in: project.path)
         }
     }
 

package/app/Sources/Core/Workspace/WorkspaceManager.swift

@@ -66,12 +66,40 @@ struct GridFile: Codable {
     let snapZones: SnapZonesConfig?
 }
 
-enum SnapModifierKey: String, Codable, Equatable {
+enum SnapModifierKey: String, Codable, Equatable, CaseIterable, Identifiable {
     case command
     case option
     case control
     case shift
 
+    var id: String { rawValue }
+
+    var label: String {
+        switch self {
+        case .command:
+            return "Command"
+        case .option:
+            return "Option"
+        case .control:
+            return "Control"
+        case .shift:
+            return "Shift"
+        }
+    }
+
+    var shortLabel: String {
+        switch self {
+        case .command:
+            return "Cmd"
+        case .option:
+            return "Opt"
+        case .control:
+            return "Ctrl"
+        case .shift:
+            return "Shift"
+        }
+    }
+
     var eventFlags: NSEvent.ModifierFlags {
         switch self {
         case .command:
@@ -98,9 +126,6 @@ enum SnapModifierKey: String, Codable, Equatable {
         }
     }
 
-    var label: String {
-        rawValue.capitalized
-    }
 }
 
 enum SnapZoneTriggerSpec: Codable, Equatable {
@@ -459,6 +484,36 @@ class WorkspaceManager: ObservableObject {
         self.snapZonesConfig = snapZones
     }
 
+    func updateSnapModifier(_ modifier: SnapModifierKey) {
+        let updated = SnapZonesConfig(
+            enabled: snapZonesConfig.enabled,
+            modifier: modifier,
+            zoneOpacity: snapZonesConfig.zoneOpacity,
+            highlightOpacity: snapZonesConfig.highlightOpacity,
+            previewOpacity: snapZonesConfig.previewOpacity,
+            cornerRadius: snapZonesConfig.cornerRadius,
+            rules: snapZonesConfig.rules
+        )
+
+        do {
+            let url = URL(fileURLWithPath: snapZonesConfigPath)
+            try FileManager.default.createDirectory(
+                at: url.deletingLastPathComponent(),
+                withIntermediateDirectories: true
+            )
+
+            let encoder = JSONEncoder()
+            encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
+            let data = try encoder.encode(updated)
+            try data.write(to: url, options: .atomic)
+
+            loadGridConfig()
+            DiagnosticLog.shared.info("WorkspaceManager: updated snap modifier to \(modifier.rawValue)")
+        } catch {
+            DiagnosticLog.shared.error("WorkspaceManager: failed to write snap-zones.json — \(error.localizedDescription)")
+        }
+    }
+
     /// Resolve a tile string to fractions: check user presets first, then built-in TilePosition
     func resolveTileFractions(_ tile: String) -> (CGFloat, CGFloat, CGFloat, CGFloat)? {
         resolvePlacement(tile)?.fractions
@@ -500,12 +555,12 @@ class WorkspaceManager: ObservableObject {
             let label = tab.label ?? (tab.path as NSString).lastPathComponent
             DispatchQueue.main.asyncAfter(deadline: .now() + Double(i) * 0.4) {
                 if i == 0 {
-                    terminal.launch(command: "/opt/homebrew/bin/lattices", in: tab.path)
+                    terminal.launch(command: "/opt/homebrew/bin/lattices start", in: tab.path)
                     DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) {
                         terminal.nameTab(label)
                     }
                 } else {
-                    terminal.launchTab(command: "/opt/homebrew/bin/lattices", in: tab.path, tabName: label)
+                    terminal.launchTab(command: "/opt/homebrew/bin/lattices start", in: tab.path, tabName: label)
                 }
             }
         }
@@ -796,7 +851,7 @@ class WorkspaceManager: ObservableObject {
                     diag.finish(t)
                 } else {
                     diag.info("  launch (direct): \(sessionName)")
-                    terminal.launch(command: "/opt/homebrew/bin/lattices", in: path)
+                    terminal.launch(command: "/opt/homebrew/bin/lattices start", in: path)
                 }
                 launchQueue.append((sessionName, position, lpScreen, {}))
             } else {

package/bin/lattices-app.ts

@@ -152,6 +152,17 @@ function writeInfoPlist(): void {
     <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>${version}</string>
     <key>CFBundleShortVersionString</key>

package/bin/lattices-dev

@@ -78,6 +78,17 @@ write_info_plist() {
     <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>$VERSION</string>
     <key>CFBundleShortVersionString</key>