feat: Implement badge notifications (#238)

Author: charlesvien

apps/array/src/main/index.ts

@@ -12,6 +12,7 @@ import {
 } from "electron";
 import "./lib/logger";
 import { ANALYTICS_EVENTS } from "../types/analytics.js";
+import { dockBadgeService } from "./services/dockBadge.js";
 import {
   cleanupAgentSessions,
   registerAgentIpc,
@@ -214,6 +215,9 @@ app.whenReady().then(() => {
   createWindow();
   ensureClaudeConfigDir();
 
+  // Initialize dock badge service for notification badges
+  dockBadgeService.initialize(() => mainWindow);
+
   // Initialize PostHog analytics
   initializePostHog();
   trackAppEvent(ANALYTICS_EVENTS.APP_STARTED);

apps/array/src/main/preload.ts

@@ -508,4 +508,8 @@ contextBridge.exposeInMainWorld("electronAPI", {
     setTerminalLayout: (mode: "split" | "tabbed"): Promise<void> =>
       ipcRenderer.invoke("settings:set-terminal-layout", mode),
   },
+  // Dock Badge API
+  dockBadge: {
+    show: (): Promise<void> => ipcRenderer.invoke("dock-badge:show"),
+  },
 });

apps/array/src/main/services/dockBadge.ts

@@ -0,0 +1,42 @@
+import { app, type BrowserWindow, ipcMain } from "electron";
+import { logger } from "../lib/logger";
+
+const log = logger.scope("dock-badge");
+
+class DockBadgeService {
+  private hasBadge = false;
+
+  initialize(_getMainWindow: () => BrowserWindow | null): void {
+    app.on("browser-window-focus", () => {
+      this.clearBadge();
+    });
+
+    ipcMain.handle("dock-badge:show", () => {
+      this.showBadge();
+    });
+
+    log.info("Dock badge service initialized");
+  }
+
+  showBadge(): void {
+    if (!this.hasBadge) {
+      this.hasBadge = true;
+      if (process.platform === "darwin" || process.platform === "linux") {
+        app.setBadgeCount(1);
+      }
+      log.info("Dock badge shown");
+    }
+  }
+
+  private clearBadge(): void {
+    if (this.hasBadge) {
+      log.info("Clearing dock badge");
+      this.hasBadge = false;
+      if (process.platform === "darwin" || process.platform === "linux") {
+        app.setBadgeCount(0);
+      }
+    }
+  }
+}
+
+export const dockBadgeService = new DockBadgeService();

apps/array/src/main/services/index.ts

@@ -4,6 +4,7 @@
  */
 
 import "./contextMenu.js";
+import "./dockBadge.js";
 import "./externalApps.js";
 import "./fileWatcher.js";
 import "./folders.js";

apps/array/src/renderer/features/task-detail/components/TaskLogsPanel.tsx

@@ -76,6 +76,11 @@ export function TaskLogsPanel({ taskId, task }: TaskLogsPanelProps) {
         if (isViewingTask) {
           markAsViewed(taskId);
         }
+
+        const isWindowFocused = document.hasFocus();
+        if (!isWindowFocused) {
+          window.electronAPI.dockBadge.show();
+        }
       } catch (error) {
         log.error("Failed to send prompt", error);
       }

apps/array/src/renderer/types/electron.d.ts

@@ -326,6 +326,9 @@ declare global {
       getTerminalLayout: () => Promise<"split" | "tabbed">;
       setTerminalLayout: (mode: "split" | "tabbed") => Promise<void>;
     };
+    dockBadge: {
+      show: () => Promise<void>;
+    };
   }
 
   interface Window {