Add comprehensive performance diagnostics for macOS slowness debugging

- Add [PERF] logging to track app startup time and key events
- Add [IPC] logging to track when renderer sends messages to main
- Add performance tracking for IPC handlers (first call vs subsequent)
- Enable production logging with --enable-logging flag
- Track timing for: startup, window creation, ready-to-show, IPC handlers
- Add script to easily view performance logs

This will help identify:
- Where the 1-3 second delay occurs
- If it's in IPC communication, event handling, or renderer process
- Why first clicks are slower than subsequent clicks
- Exact timing of each operation

Author: RobbieTheWagner

electron-app/main.ts

@@ -25,11 +25,17 @@ import {
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
+// PERFORMANCE LOGGING: Track startup time
+const startupTime = Date.now();
+console.log('[PERF] App startup began');
+
 init({
   dsn: 'https://6974b46329f24dc1b9fca4507c65e942@o361681.ingest.us.sentry.io/3956140',
   release: `v${pkg.version}`,
 });
 
+console.log(`[PERF] Sentry initialized: +${Date.now() - startupTime}ms`);
+
 const store = new Store({
   defaults: {
     firstRunV1: true,
@@ -76,7 +82,7 @@ const mb = menubar({
     width: 362,
     webPreferences: {
       contextIsolation: true,
-      devTools: isDev,
+      devTools: true,
       preload: join(__dirname, 'preload.js'),
       nodeIntegration: false,
     },
@@ -96,6 +102,13 @@ mb.app.commandLine.appendSwitch(
 );
 mb.app.commandLine.appendSwitch('ignore-certificate-errors', 'true');
 
+// PERFORMANCE DIAGNOSTICS: Enable detailed logging in production
+if (!isDev) {
+  mb.app.commandLine.appendSwitch('enable-logging');
+  mb.app.commandLine.appendSwitch('v', '1');
+  console.log('[PERF] Production logging enabled');
+}
+
 let sharedPaletteLink: string | undefined;
 
 async function openSharedPalette() {
@@ -165,6 +178,8 @@ mb.app.on('window-all-closed', () => {
 });
 
 mb.on('after-create-window', () => {
+  console.log(`[PERF] Window created: +${Date.now() - startupTime}ms`);
+
   // Load the Ember application using our custom protocol/scheme
   handleFileUrls(emberAppDir);
 
@@ -176,7 +191,9 @@ mb.on('after-create-window', () => {
   });
 
   mb.window?.once('ready-to-show', function () {
+    console.log(`[PERF] Window ready-to-show: +${Date.now() - startupTime}ms`);
     setTimeout(() => {
+      console.log(`[PERF] Showing window: +${Date.now() - startupTime}ms`);
       void mb.showWindow();
     }, 750);
   });
@@ -214,6 +231,8 @@ mb.on('after-create-window', () => {
 });
 
 mb.on('ready', () => {
+  console.log(`[PERF] Menubar ready: +${Date.now() - startupTime}ms`);
+
   ipcMain.on('enableDisableAutoStart', (event, openAtLogin) => {
     // Only allow auto-start in production
     if (!isDev) {

electron-app/src/ipc-events.ts

@@ -8,12 +8,45 @@ import { type Menubar } from 'menubar';
 import { launchPicker } from './color-picker';
 import { restartDialog } from './dialogs';
 
+// PERFORMANCE LOGGING: Track first call vs subsequent calls
+const perfTracking = new Map<
+  string,
+  { count: number; firstTime?: number; totalTime: number }
+>();
+
+function trackPerf(eventName: string, fn: () => void | Promise<void>) {
+  const start = Date.now();
+  const stats = perfTracking.get(eventName) || { count: 0, totalTime: 0 };
+
+  const result = fn();
+
+  const duration = Date.now() - start;
+  stats.count++;
+  stats.totalTime += duration;
+
+  if (stats.count === 1) {
+    stats.firstTime = duration;
+    console.log(`[PERF] ${eventName} FIRST CALL: ${duration}ms`);
+  } else {
+    const avgOther =
+      (stats.totalTime - (stats.firstTime || 0)) / (stats.count - 1);
+    console.log(
+      `[PERF] ${eventName} call #${stats.count}: ${duration}ms (first: ${stats.firstTime}ms, avg others: ${avgOther.toFixed(1)}ms)`
+    );
+  }
+
+  perfTracking.set(eventName, stats);
+  return result;
+}
+
 function setupEventHandlers(
   mb: Menubar,
   store: Store<{ firstRunV1: boolean; showDockIcon: boolean }>
 ) {
+  // Log all IPC messages for debugging
   ipcMain.on('copyColorToClipboard', (_channel, color: string) => {
-    clipboard.writeText(color);
+    console.log('[IPC] Received: copyColorToClipboard');
+    trackPerf('copyColorToClipboard', () => clipboard.writeText(color));
   });
 
   ipcMain.on('exitApp', () => mb.app.quit());
@@ -63,15 +96,32 @@ function setupEventHandlers(
   });
 
   ipcMain.on('launchContrastBgPicker', () => {
-    void launchPicker(mb, 'contrastBg');
+    console.log('[IPC] Received: launchContrastBgPicker');
+    void trackPerf('launchContrastBgPicker', () =>
+      launchPicker(mb, 'contrastBg')
+    );
+  });
+
+  ipcMain.on('launchContrastFgPicker', () => {
+    console.log('[IPC] Received: launchContrastFgPicker');
+    void trackPerf('launchContrastFgPicker', () =>
+      launchPicker(mb, 'contrastFg')
+    );
+  });
+
+  ipcMain.on('launchPicker', () => {
+    console.log('[IPC] Received: launchPicker');
+    void trackPerf('launchPicker', () => launchPicker(mb));
   });
 
   ipcMain.on('launchContrastFgPicker', () => {
-    void launchPicker(mb, 'contrastFg');
+    void trackPerf('launchContrastFgPicker', () =>
+      launchPicker(mb, 'contrastFg')
+    );
   });
 
   ipcMain.on('launchPicker', () => {
-    void launchPicker(mb);
+    void trackPerf('launchPicker', () => launchPicker(mb));
   });
 
   ipcMain.handle('open-external', async (_event, url: string) => {

scripts/view-perf-logs.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+
+# Script to view performance logs from Swach
+# Run this after launching and testing the production app
+
+echo "=== Swach Performance Logs ==="
+echo ""
+echo "Recent logs (last 5 minutes):"
+echo "=============================="
+
+/usr/bin/log show --last 5m --predicate 'process == "Swach"' --style compact | grep -E "\[PERF\]|\[IPC\]" | tail -100
+
+echo ""
+echo "=============================="
+echo "To see all logs, run:"
+echo "  log show --last 10m --predicate 'process == \"Swach\"'"
+echo ""
+echo "To export to file:"
+echo "  log show --last 10m --predicate 'process == \"Swach\"' > ~/Desktop/swach-logs.txt"