@lattices/cli 0.3.0 → 0.4.0

package/app/Sources/LauncherHUD.swift

@@ -0,0 +1,348 @@
+import AppKit
+import SwiftUI
+
+// MARK: - LauncherHUD (singleton window controller)
+
+final class LauncherHUD {
+    static let shared = LauncherHUD()
+
+    private var panel: NSPanel?
+    private var localMonitor: Any?
+    private var globalMonitor: Any?
+
+    var isVisible: Bool { panel?.isVisible ?? false }
+
+    func toggle() {
+        if isVisible { dismiss() } else { show() }
+    }
+
+    func show() {
+        guard panel == nil else { return }
+
+        // Ensure projects are fresh
+        ProjectScanner.shared.scan()
+
+        let view = LauncherView(dismiss: { [weak self] in self?.dismiss() })
+            .preferredColorScheme(.dark)
+
+        let hosting = NSHostingView(rootView: view)
+
+        let p = NSPanel(
+            contentRect: NSRect(x: 0, y: 0, width: 420, height: 480),
+            styleMask: [.borderless, .nonactivatingPanel],
+            backing: .buffered,
+            defer: false
+        )
+        p.isOpaque = false
+        p.backgroundColor = .clear
+        p.level = .floating
+        p.hasShadow = true
+        p.hidesOnDeactivate = false
+        p.isReleasedWhenClosed = false
+        p.isMovableByWindowBackground = false
+        p.contentView = hosting
+
+        // Center on mouse screen
+        let mouseLocation = NSEvent.mouseLocation
+        let screen = NSScreen.screens.first(where: { $0.frame.contains(mouseLocation) }) ?? NSScreen.main ?? NSScreen.screens.first!
+        let screenFrame = screen.visibleFrame
+        let x = screenFrame.midX - 210
+        let y = screenFrame.midY - 240 + (screenFrame.height * 0.08)
+        p.setFrameOrigin(NSPoint(x: x, y: y))
+
+        p.alphaValue = 0
+        p.orderFrontRegardless()
+
+        NSAnimationContext.runAnimationGroup { ctx in
+            ctx.duration = 0.12
+            p.animator().alphaValue = 1.0
+        }
+
+        self.panel = p
+        installMonitors()
+    }
+
+    func dismiss() {
+        guard let p = panel else { return }
+        removeMonitors()
+
+        NSAnimationContext.runAnimationGroup({ ctx in
+            ctx.duration = 0.15
+            p.animator().alphaValue = 0
+        }) { [weak self] in
+            p.orderOut(nil)
+            self?.panel = nil
+        }
+    }
+
+    // MARK: - Event monitors
+
+    private func installMonitors() {
+        localMonitor = NSEvent.addGlobalMonitorForEvents(matching: .keyDown) { [weak self] event in
+            if event.keyCode == 53 { // Escape
+                self?.dismiss()
+            }
+        }
+        globalMonitor = NSEvent.addGlobalMonitorForEvents(matching: [.leftMouseDown, .rightMouseDown]) { [weak self] event in
+            // Don't dismiss if clicking inside the panel
+            guard let panel = self?.panel else { return }
+            let loc = event.locationInWindow
+            if !panel.frame.contains(NSEvent.mouseLocation) {
+                self?.dismiss()
+            }
+        }
+    }
+
+    private func removeMonitors() {
+        if let m = localMonitor { NSEvent.removeMonitor(m); localMonitor = nil }
+        if let m = globalMonitor { NSEvent.removeMonitor(m); globalMonitor = nil }
+    }
+}
+
+// MARK: - LauncherView
+
+struct LauncherView: View {
+    var dismiss: () -> Void
+
+    @ObservedObject private var scanner = ProjectScanner.shared
+    @ObservedObject private var tmux = TmuxModel.shared
+    @State private var query = ""
+    @State private var selectedIndex = 0
+    @State private var hoveredId: String?
+
+    private var filtered: [Project] {
+        if query.isEmpty { return scanner.projects }
+        let q = query.lowercased()
+        return scanner.projects.filter {
+            $0.name.lowercased().contains(q) ||
+            ($0.paneSummary ?? "").lowercased().contains(q)
+        }
+    }
+
+    var body: some View {
+        VStack(spacing: 0) {
+            // Search bar
+            HStack(spacing: 10) {
+                Image(systemName: "magnifyingglass")
+                    .font(.system(size: 13))
+                    .foregroundColor(Palette.textMuted)
+
+                ZStack(alignment: .leading) {
+                    if query.isEmpty {
+                        Text("Launch a project...")
+                            .font(Typo.mono(13))
+                            .foregroundColor(Palette.textMuted)
+                    }
+                    TextField("", text: $query)
+                        .font(Typo.mono(13))
+                        .foregroundColor(Palette.text)
+                        .textFieldStyle(.plain)
+                        .onSubmit { launchSelected() }
+                }
+
+                if !query.isEmpty {
+                    Button {
+                        query = ""
+                        selectedIndex = 0
+                    } label: {
+                        Image(systemName: "xmark.circle.fill")
+                            .font(.system(size: 12))
+                            .foregroundColor(Palette.textMuted)
+                    }
+                    .buttonStyle(.plain)
+                }
+            }
+            .padding(.horizontal, 16)
+            .padding(.vertical, 12)
+
+            Rectangle().fill(Palette.border).frame(height: 0.5)
+
+            // Project list
+            if filtered.isEmpty {
+                Spacer()
+                VStack(spacing: 8) {
+                    Image(systemName: "folder.badge.questionmark")
+                        .font(.system(size: 24))
+                        .foregroundColor(Palette.textMuted)
+                    Text(scanner.projects.isEmpty ? "No projects found" : "No matches")
+                        .font(Typo.mono(12))
+                        .foregroundColor(Palette.textMuted)
+                    if scanner.projects.isEmpty {
+                        Text("Add .lattices.json to your projects")
+                            .font(Typo.mono(10))
+                            .foregroundColor(Palette.textMuted.opacity(0.6))
+                    }
+                }
+                Spacer()
+            } else {
+                ScrollViewReader { proxy in
+                    ScrollView {
+                        LazyVStack(spacing: 2) {
+                            ForEach(Array(filtered.enumerated()), id: \.element.id) { index, project in
+                                projectRow(project, index: index)
+                                    .id(project.id)
+                            }
+                        }
+                        .padding(.vertical, 6)
+                        .padding(.horizontal, 8)
+                    }
+                    .onChange(of: selectedIndex) { newVal in
+                        if let project = filtered[safe: newVal] {
+                            proxy.scrollTo(project.id, anchor: .center)
+                        }
+                    }
+                }
+            }
+
+            Rectangle().fill(Palette.border).frame(height: 0.5)
+
+            // Footer
+            HStack(spacing: 16) {
+                HStack(spacing: 4) {
+                    keyBadge("↑↓")
+                    Text("Navigate")
+                        .font(Typo.mono(10))
+                        .foregroundColor(Palette.textMuted)
+                }
+                HStack(spacing: 4) {
+                    keyBadge("↵")
+                    Text("Launch")
+                        .font(Typo.mono(10))
+                        .foregroundColor(Palette.textMuted)
+                }
+                HStack(spacing: 4) {
+                    keyBadge("ESC")
+                    Text("Close")
+                        .font(Typo.mono(10))
+                        .foregroundColor(Palette.textMuted)
+                }
+                Spacer()
+                Text("\(filtered.count) project\(filtered.count == 1 ? "" : "s")")
+                    .font(Typo.mono(10))
+                    .foregroundColor(Palette.textMuted)
+            }
+            .padding(.horizontal, 16)
+            .padding(.vertical, 8)
+        }
+        .frame(width: 420, height: 480)
+        .background(
+            RoundedRectangle(cornerRadius: 12)
+                .fill(Palette.bg)
+                .overlay(
+                    RoundedRectangle(cornerRadius: 12)
+                        .strokeBorder(Palette.borderLit, lineWidth: 0.5)
+                )
+        )
+        .clipShape(RoundedRectangle(cornerRadius: 12))
+        .onChange(of: query) { _ in selectedIndex = 0 }
+    }
+
+    // MARK: - Project row
+
+    private func projectRow(_ project: Project, index: Int) -> some View {
+        let isSelected = index == selectedIndex
+        let isHovered = hoveredId == project.id
+
+        return Button {
+            launch(project)
+        } label: {
+            HStack(spacing: 10) {
+                // Status dot
+                Circle()
+                    .fill(project.isRunning ? Palette.running : Palette.textMuted.opacity(0.3))
+                    .frame(width: 7, height: 7)
+
+                // Name + pane info
+                VStack(alignment: .leading, spacing: 2) {
+                    Text(project.name)
+                        .font(Typo.monoBold(12))
+                        .foregroundColor(Palette.text)
+                        .lineLimit(1)
+
+                    HStack(spacing: 6) {
+                        if !project.paneSummary.isEmpty {
+                            let summary = project.paneSummary
+                            Text(summary)
+                                .font(Typo.mono(10))
+                                .foregroundColor(Palette.textDim)
+                                .lineLimit(1)
+                        }
+                    }
+                }
+
+                Spacer()
+
+                // Status badge
+                if project.isRunning {
+                    Text("running")
+                        .font(Typo.mono(9))
+                        .foregroundColor(Palette.running)
+                        .padding(.horizontal, 6)
+                        .padding(.vertical, 2)
+                        .background(
+                            RoundedRectangle(cornerRadius: 3)
+                                .fill(Palette.running.opacity(0.10))
+                        )
+                } else {
+                    Image(systemName: "play.fill")
+                        .font(.system(size: 9))
+                        .foregroundColor(isSelected || isHovered ? Palette.text : Palette.textMuted)
+                }
+            }
+            .padding(.horizontal, 10)
+            .padding(.vertical, 8)
+            .background(
+                RoundedRectangle(cornerRadius: 6)
+                    .fill(isSelected ? Palette.surfaceHov : (isHovered ? Palette.surface : Color.clear))
+                    .overlay(
+                        RoundedRectangle(cornerRadius: 6)
+                            .strokeBorder(isSelected ? Palette.borderLit : Color.clear, lineWidth: 0.5)
+                    )
+            )
+        }
+        .buttonStyle(.plain)
+        .onHover { over in hoveredId = over ? project.id : nil }
+    }
+
+    // MARK: - Actions
+
+    private func moveSelection(_ delta: Int) {
+        let count = filtered.count
+        guard count > 0 else { return }
+        selectedIndex = (selectedIndex + delta + count) % count
+    }
+
+    private func launchSelected() {
+        guard let project = filtered[safe: selectedIndex] else { return }
+        launch(project)
+    }
+
+    private func launch(_ project: Project) {
+        SessionManager.launch(project: project)
+        dismiss()
+    }
+
+    private func keyBadge(_ key: String) -> some View {
+        Text(key)
+            .font(Typo.geistMonoBold(9))
+            .foregroundColor(Palette.text)
+            .padding(.horizontal, 5)
+            .padding(.vertical, 2)
+            .background(
+                RoundedRectangle(cornerRadius: 3)
+                    .fill(Palette.surface)
+                    .overlay(
+                        RoundedRectangle(cornerRadius: 3)
+                            .strokeBorder(Palette.border, lineWidth: 0.5)
+                    )
+            )
+    }
+}
+
+// MARK: - Safe array subscript
+
+private extension Array {
+    subscript(safe index: Int) -> Element? {
+        indices.contains(index) ? self[index] : nil
+    }
+}

package/app/Sources/MainView.swift

@@ -1,7 +1,13 @@
 import SwiftUI
 
+enum MainViewLayout {
+    case popover
+    case embedded
+}
+
 struct MainView: View {
     @ObservedObject var scanner: ProjectScanner
+    var layout: MainViewLayout = .popover
     @StateObject private var prefs = Preferences.shared
     @StateObject private var permChecker = PermissionChecker.shared
     @ObservedObject private var workspace = WorkspaceManager.shared
@@ -9,6 +15,8 @@ struct MainView: View {
     @State private var searchText = ""
     @State private var hasCheckedSetup = false
     @State private var bannerDismissed = false
+    @State private var tmuxBannerDismissed = false
+    @ObservedObject private var tmuxModel = TmuxModel.shared
     @State private var orphanSectionCollapsed = true
     private var filtered: [Project] {
         if searchText.isEmpty { return scanner.projects }
@@ -31,7 +39,14 @@ struct MainView: View {
         VStack(spacing: 0) {
             mainContent
         }
-        .frame(minWidth: 380, idealWidth: 380, maxWidth: 600, minHeight: 460, idealHeight: 460, maxHeight: .infinity)
+        .frame(
+            minWidth: layout == .popover ? 380 : 0,
+            idealWidth: layout == .popover ? 380 : nil,
+            maxWidth: .infinity,
+            minHeight: layout == .popover ? 520 : 0,
+            idealHeight: layout == .popover ? 560 : nil,
+            maxHeight: .infinity
+        )
         .background(PanelBackground())
         .preferredColorScheme(.dark)
         .onAppear {
@@ -61,36 +76,32 @@ struct MainView: View {
 
     private var mainContent: some View {
         VStack(spacing: 0) {
-            // Title bar
-            HStack {
-                Text("lattices")
-                    .font(Typo.title())
-                    .foregroundColor(Palette.text)
+            if layout == .popover {
+                HStack {
+                    Text("Lattices")
+                        .font(Typo.mono(14))
+                        .foregroundColor(Palette.text)
 
-                if runningCount > 0 || !inventory.orphans.isEmpty {
-                    let total = runningCount + inventory.orphans.count
-                    Text("\(total) session\(total == 1 ? "" : "s")")
-                        .font(Typo.mono(10))
-                        .foregroundColor(Palette.running)
-                        .padding(.leading, 4)
-                } else {
-                    Text("None")
-                        .font(Typo.mono(10))
-                        .foregroundColor(Palette.textMuted)
-                        .padding(.leading, 4)
-                }
-
-                Spacer()
+                    Spacer()
 
-                headerButton(icon: "arrow.up.left.and.arrow.down.right") {
-                    (NSApp.delegate as? AppDelegate)?.dismissPopover()
-                    MainWindow.shared.show()
+                    headerButton(icon: "house") {
+                        (NSApp.delegate as? AppDelegate)?.dismissPopover()
+                        ScreenMapWindowController.shared.showPage(.home)
+                    }
+                    headerButton(icon: "terminal") {
+                        (NSApp.delegate as? AppDelegate)?.dismissPopover()
+                        ScreenMapWindowController.shared.showPage(.pi)
+                    }
+                    headerButton(icon: "arrow.up.left.and.arrow.down.right") {
+                        (NSApp.delegate as? AppDelegate)?.dismissPopover()
+                        MainWindow.shared.show()
+                    }
+                    headerButton(icon: "arrow.clockwise") { scanner.scan(); inventory.refresh() }
                 }
-                headerButton(icon: "arrow.clockwise") { scanner.scan(); inventory.refresh() }
+                .padding(.horizontal, 18)
+                .padding(.top, 18)
+                .padding(.bottom, 12)
             }
-            .padding(.horizontal, 18)
-            .padding(.top, 14)
-            .padding(.bottom, 10)
 
             // Layer switcher
             if let config = workspace.config, let layers = config.layers, layers.count > 1 {
@@ -129,6 +140,11 @@ struct MainView: View {
                 permissionBanner
             }
 
+            // tmux not-found banner
+            if !tmuxModel.isAvailable && !tmuxBannerDismissed {
+                tmuxBanner
+            }
+
             Rectangle()
                 .fill(Palette.border)
                 .frame(height: 0.5)
@@ -195,6 +211,13 @@ struct MainView: View {
 
             // Actions footer
             actionsSection
+
+            Rectangle()
+                .fill(Palette.border)
+                .frame(height: 0.5)
+
+            // Bottom bar
+            bottomBar
         }
     }
 
@@ -278,38 +301,54 @@ struct MainView: View {
             ActionRow(shortcut: "6", label: "Omni Search", hotkey: hotkeyLabel(.omniSearch), icon: "magnifyingglass", accentColor: Palette.running) {
                 OmniSearchWindow.shared.toggle()
             }
+            ActionRow(shortcut: "7", label: "Voice Command", hotkey: hotkeyLabel(.voiceCommand), icon: "mic", accentColor: AudioLayer.shared.isListening ? Palette.running : Palette.textDim) {
+                let audio = AudioLayer.shared
+                if audio.isListening { audio.stopVoiceCommand() } else { audio.startVoiceCommand() }
+            }
+        }
+        .padding(.vertical, 4)
+        .background(Palette.surface.opacity(0.4))
+    }
 
-            Rectangle()
-                .fill(Palette.border)
-                .frame(height: 0.5)
-                .padding(.horizontal, 10)
-
-            ActionRow(shortcut: "S", label: "Settings", icon: "gearshape") {
+    private var bottomBar: some View {
+        HStack(spacing: 16) {
+            bottomBarButton(icon: "gearshape", label: "Settings") {
                 SettingsWindowController.shared.show()
             }
-            HStack(spacing: 0) {
-                ActionRow(shortcut: "D", label: "Diagnostics", icon: "stethoscope") {
+
+            HStack(spacing: 4) {
+                bottomBarButton(icon: "stethoscope", label: "Diagnostics") {
                     DiagnosticWindow.shared.toggle()
                 }
                 if !permChecker.allGranted {
                     Circle()
                         .fill(Palette.detach)
-                        .frame(width: 6, height: 6)
-                        .padding(.trailing, 14)
+                        .frame(width: 5, height: 5)
                 }
             }
 
-            Rectangle()
-                .fill(Palette.border)
-                .frame(height: 0.5)
-                .padding(.horizontal, 10)
+            Spacer()
 
-            ActionRow(shortcut: "Q", label: "Quit", icon: "power", accentColor: Palette.kill) {
+            bottomBarButton(icon: "power", label: "Quit", color: Palette.kill) {
                 NSApp.terminate(nil)
             }
         }
-        .padding(.vertical, 4)
-        .background(Palette.surface.opacity(0.4))
+        .padding(.horizontal, 16)
+        .padding(.vertical, 8)
+        .background(Palette.bg)
+    }
+
+    private func bottomBarButton(icon: String, label: String, color: Color = Palette.textMuted, action: @escaping () -> Void) -> some View {
+        Button(action: action) {
+            HStack(spacing: 4) {
+                Image(systemName: icon)
+                    .font(.system(size: 10, weight: .medium))
+                Text(label)
+                    .font(Typo.mono(9))
+            }
+            .foregroundColor(color)
+        }
+        .buttonStyle(.plain)
     }
 
     private func hotkeyLabel(_ action: HotkeyAction) -> String? {
@@ -381,6 +420,70 @@ struct MainView: View {
         .padding(.bottom, 10)
     }
 
+    // MARK: - tmux banner
+
+    private var tmuxBanner: some View {
+        VStack(alignment: .leading, spacing: 6) {
+            HStack {
+                Image(systemName: "terminal")
+                    .font(.system(size: 10))
+                    .foregroundColor(Palette.detach)
+                Text("TMUX NOT FOUND")
+                    .font(Typo.monoBold(10))
+                    .foregroundColor(Palette.detach)
+                Spacer()
+                Button { tmuxBannerDismissed = true } label: {
+                    Image(systemName: "xmark")
+                        .font(.system(size: 8, weight: .bold))
+                        .foregroundColor(Palette.textMuted)
+                }
+                .buttonStyle(.plain)
+            }
+
+            Text("Session management requires tmux. Install it with Homebrew:")
+                .font(Typo.mono(10))
+                .foregroundColor(Palette.text)
+
+            Button {
+                let task = Process()
+                task.executableURL = URL(fileURLWithPath: "/bin/zsh")
+                task.arguments = ["-lc", "brew install tmux"]
+                task.standardOutput = FileHandle.nullDevice
+                task.standardError = FileHandle.nullDevice
+                try? task.run()
+            } label: {
+                HStack(spacing: 6) {
+                    Image(systemName: "arrow.down.circle")
+                        .font(.system(size: 10))
+                    Text("brew install tmux")
+                        .font(Typo.monoBold(10))
+                }
+                .padding(.vertical, 4)
+                .padding(.horizontal, 8)
+                .background(
+                    RoundedRectangle(cornerRadius: 4)
+                        .fill(Palette.detach.opacity(0.06))
+                )
+            }
+            .buttonStyle(.plain)
+
+            Text("Window tiling, search, and OCR work without tmux.")
+                .font(Typo.mono(9))
+                .foregroundColor(Palette.textMuted)
+        }
+        .padding(12)
+        .background(
+            RoundedRectangle(cornerRadius: 5)
+                .fill(Palette.detach.opacity(0.08))
+                .overlay(
+                    RoundedRectangle(cornerRadius: 5)
+                        .strokeBorder(Palette.detach.opacity(0.20), lineWidth: 0.5)
+                )
+        )
+        .padding(.horizontal, 14)
+        .padding(.bottom, 10)
+    }
+
     private func permissionRow(_ name: String, granted: Bool, open: @escaping () -> Void) -> some View {
         Button(action: { if !granted { open() } }) {
             HStack(spacing: 6) {

package/app/Sources/OcrModel.swift

@@ -60,8 +60,11 @@ final class OcrModel: ObservableObject {
             return
         }
         let deepInterval = prefs.ocrDeepInterval
-        // Defer initial scan — let the first timer tick handle it (grace period on launch)
         DiagnosticLog.shared.info("OcrModel: starting (quick=\(self.interval)s/\(prefs.ocrQuickLimit)win, deep=\(deepInterval)s/\(prefs.ocrDeepLimit)win)")
+        // Run initial scan immediately so search works right away
+        DispatchQueue.global(qos: .userInitiated).asyncAfter(deadline: .now() + 2) { [weak self] in
+            self?.quickScan()
+        }
         timer = Timer.scheduledTimer(withTimeInterval: self.interval, repeats: true) { [weak self] _ in
             guard let self, self.enabled else { return }
             self.quickScan()
@@ -90,6 +93,36 @@ final class OcrModel: ObservableObject {
         }
     }
 
+    // MARK: - Single Window Scan
+
+    /// Scan a single window by wid (AX extraction, instant).
+    func scanSingle(wid: UInt32) {
+        guard let entry = DesktopModel.shared.windows[wid] else { return }
+        queue.async { [weak self] in
+            guard let self else { return }
+            if let axResult = self.axExtractor.extract(pid: entry.pid, wid: wid) {
+                let blocks = axResult.texts.map { text in
+                    OcrTextBlock(text: text, confidence: 1.0, boundingBox: .zero)
+                }
+                let result = OcrWindowResult(
+                    wid: wid,
+                    app: entry.app,
+                    title: entry.title,
+                    frame: entry.frame,
+                    texts: blocks,
+                    fullText: axResult.fullText,
+                    timestamp: Date(),
+                    source: .accessibility
+                )
+                OcrStore.shared.insert(results: [result])
+                DispatchQueue.main.async {
+                    self.results[wid] = result
+                    DiagnosticLog.shared.info("OcrModel: single scan wid=\(wid) → \(axResult.texts.count) blocks")
+                }
+            }
+        }
+    }
+
     // MARK: - Scan
 
     /// Quick scan: AX-only text extraction for topmost windows (called every 60s).