Fix Linear integration setup and docs

.hack/hack.config.json

@@ -6,6 +6,9 @@
     "extensions": {
       "dance.hack.tickets": {
         "enabled": true
+      },
+      "dance.hack.linear": {
+        "enabled": true
       }
     },
     "gateway": {

apps/macos/App/HackDesktopApp.swift

@@ -108,9 +108,10 @@ struct HackDesktopApp: App {
 
   @MainActor
   private func handleIncomingDeepLink(url: URL) {
-    guard model.ingestGitHubOAuthDeepLink(url: url) else {
-      return
-    }
+    let handledHackAuth = model.ingestHackAuthDeepLink(url: url)
+    let handledGitHub = model.ingestGitHubOAuthDeepLink(url: url)
+    let handledLinear = model.ingestLinearOAuthDeepLink(url: url)
+    guard handledHackAuth || handledGitHub || handledLinear else { return }
 
 #if os(macOS)
     NSApp.activate(ignoringOtherApps: true)
@@ -119,7 +120,7 @@ struct HackDesktopApp: App {
       name: .hackSettingsRequested,
       object: nil,
       userInfo: [
-        "pane": "github",
+        "pane": handledHackAuth ? "account" : (handledLinear ? "linear" : "github"),
       ]
     )
   }

apps/macos/App/Info.plist

@@ -21,10 +21,16 @@
 			<string>dance.hack.desktop</string>
 			<key>CFBundleURLSchemes</key>
 			<array>
-				<string>hack</string>
+				<string>$(HACK_URL_SCHEME)</string>
 			</array>
 		</dict>
 	</array>
+	<key>HackAuthCompletionURL</key>
+	<string>$(HACK_URL_SCHEME)://auth/complete</string>
+	<key>HackGitHubOAuthCallbackURL</key>
+	<string>$(HACK_URL_SCHEME)://auth/github/callback</string>
+	<key>HackLinearOAuthCallbackURL</key>
+	<string>$(HACK_URL_SCHEME)://auth/linear/callback</string>
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>CFBundleShortVersionString</key>

apps/macos/Config/Base.xcconfig

@@ -7,6 +7,7 @@ CODE_SIGN_ENTITLEMENTS = App/HackDesktop.entitlements
 
 PRODUCT_NAME = Hack Desktop
 PRODUCT_BUNDLE_IDENTIFIER = dance.hack.desktop
+HACK_URL_SCHEME = hack
 MACOSX_DEPLOYMENT_TARGET = 14.0
 MARKETING_VERSION = 1.17.0
 CURRENT_PROJECT_VERSION = $(MARKETING_VERSION)

apps/macos/Config/Debug.xcconfig

@@ -1,3 +1,4 @@
 #include "Base.xcconfig"
 
+HACK_URL_SCHEME = hack-dev
 SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG

apps/macos/Packages/Features/DashboardFeature/Sources/DashboardFeature/CommandPalette.swift

@@ -6,6 +6,23 @@ import HackDesktopModels
 extension Notification.Name {
   public static let hackCommandPaletteRequested = Notification.Name("hack.commandPalette.requested")
   public static let hackRefreshRequested = Notification.Name("hack.refresh.requested")
+  public static let hackProjectNavigationRequested = Notification.Name("hack.projectNavigation.requested")
+  public static let hackTicketReviewQueueRequested = Notification.Name("hack.ticketReviewQueue.requested")
+  public static let hackProjectRoutingRequested = Notification.Name("hack.projectRouting.requested")
+}
+
+enum ProjectNavigationRequest {
+  static let projectIdKey = "projectId"
+  static let tabKey = "tab"
+  static let sidebarKey = "sidebar"
+}
+
+enum TicketReviewQueueRequest {
+  static let projectIdKey = "projectId"
+}
+
+enum ProjectRoutingRequest {
+  static let projectIdKey = "projectId"
 }
 
 struct CommandPaletteAction: Identifiable {
@@ -74,6 +91,16 @@ struct CommandPaletteView: View {
       }
     )
 
+    actions.append(
+      CommandPaletteAction(title: "Go to Linear Settings", subtitle: "Connected accounts + sync policy") {
+        NotificationCenter.default.post(
+          name: .hackSettingsRequested,
+          object: nil,
+          userInfo: [SettingsNavigationRequest.paneKey: SettingsSidebarItem.linear.rawValue]
+        )
+      }
+    )
+
     actions.append(
       CommandPaletteAction(title: "Go to Runtime Settings", subtitle: "System status + daemon") {
         NotificationCenter.default.post(
@@ -134,6 +161,32 @@ struct CommandPaletteView: View {
           model.selectedItem = .project(project.id)
         }
       )
+      if project.supportsTickets {
+        actions.append(
+          CommandPaletteAction(
+            title: "Open Tickets: \(project.name)",
+            subtitle: "Ticket board + manual sync tools"
+          ) {
+            openProjectTickets(project)
+          }
+        )
+        actions.append(
+          CommandPaletteAction(
+            title: "Open Review Queue: \(project.name)",
+            subtitle: "Conflicts, comments, and merge follow-up"
+          ) {
+            openProjectTicketReviewQueue(project)
+          }
+        )
+        actions.append(
+          CommandPaletteAction(
+            title: "Open Linear routing: \(project.name)",
+            subtitle: "Project account + bound Linear project"
+          ) {
+            openProjectRouting(project)
+          }
+        )
+      }
     }
 
     if let project = model.selectedProject {
@@ -149,7 +202,12 @@ struct CommandPaletteView: View {
       }
       actions.append(
         CommandPaletteAction(title: "Project: Overview", subtitle: project.name) {
-          model.selectedProjectTab = .overview
+          openProjectOverview(project)
+        }
+      )
+      actions.append(
+        CommandPaletteAction(title: "Project: Linear routing", subtitle: project.name) {
+          openProjectRouting(project)
         }
       )
       if project.isRuntimeConfigured {
@@ -181,7 +239,15 @@ struct CommandPaletteView: View {
       if project.supportsTickets {
         actions.append(
           CommandPaletteAction(title: "Project: Tickets", subtitle: project.name) {
-            model.selectedProjectTab = .tickets
+            openProjectTickets(project)
+          }
+        )
+        actions.append(
+          CommandPaletteAction(
+            title: "Project: Review queue",
+            subtitle: project.name
+          ) {
+            openProjectTicketReviewQueue(project)
           }
         )
       }
@@ -216,6 +282,27 @@ struct CommandPaletteView: View {
             Task { _ = await model.syncTickets(for: project) }
           }
         )
+        actions.append(
+          CommandPaletteAction(title: "Tickets: Pull from Linear", subtitle: project.name) {
+            Task {
+              _ = await model.syncLinearProject(
+                for: project,
+                from: "linear"
+              )
+            }
+          }
+        )
+        actions.append(
+          CommandPaletteAction(title: "Tickets: Push Hack to Linear", subtitle: project.name) {
+            Task {
+              _ = await model.syncLinearProject(
+                for: project,
+                from: "hack",
+                ownerMode: "hack"
+              )
+            }
+          }
+        )
         actions.append(
           CommandPaletteAction(title: "Tickets: Setup", subtitle: project.name) {
             Task { _ = await model.setupTickets(for: project) }
@@ -244,6 +331,38 @@ struct CommandPaletteView: View {
     return nil
   }
 
+  private func openProjectOverview(_ project: ProjectSummary) {
+    model.selectedItem = .project(project.id)
+    model.selectedProjectTab = .overview
+  }
+
+  private func openProjectTickets(_ project: ProjectSummary) {
+    model.selectedItem = .project(project.id)
+    model.selectedProjectTab = .tickets
+  }
+
+  private func openProjectTicketReviewQueue(_ project: ProjectSummary) {
+    openProjectTickets(project)
+    DispatchQueue.main.async {
+      NotificationCenter.default.post(
+        name: .hackTicketReviewQueueRequested,
+        object: nil,
+        userInfo: [TicketReviewQueueRequest.projectIdKey: project.id]
+      )
+    }
+  }
+
+  private func openProjectRouting(_ project: ProjectSummary) {
+    model.selectedItem = .project(project.id)
+    NotificationCenter.default.post(
+      name: .hackProjectRoutingRequested,
+      object: nil,
+      userInfo: [
+        ProjectRoutingRequest.projectIdKey: project.id
+      ]
+    )
+  }
+
   private func openPreferredCodingAgent(for project: ProjectSummary, path: String) {
     let command = CodingAgentIntegration.launchCommand(
       projectPath: path,