feat: auto-connect to CDP browser on server startup

Adds automatic browser connection when the server starts, eliminating
the need to manually reconnect after restarts. Respects the existing
autoConnect config setting and includes retry logic for concurrent
PM2 startup scenarios.

Author: atomantic

server/src/index.ts

@@ -10,6 +10,7 @@ import { pathRoutes } from './routes/path.routes.js';
 import { indexerRoutes } from './routes/indexer.routes.js';
 import { exportRoutes } from './routes/export.routes.js';
 import { browserRouter } from './routes/browser.routes.js';
+import { browserService } from './services/browser.service.js';
 import { augmentationRouter } from './routes/augmentation.routes.js';
 import { genealogyProviderRouter } from './routes/genealogy-provider.routes.js';
 import { providerRouter } from './routes/provider.routes.js';
@@ -79,4 +80,7 @@ app.use(errorHandler);
 
 httpServer.listen(PORT, '0.0.0.0', () => {
   console.log(`🚀 Server running on http://localhost:${PORT}`);
+
+  // Auto-connect to browser if enabled and browser is running
+  browserService.autoConnectIfEnabled();
 });

server/src/services/browser.service.ts

@@ -248,6 +248,45 @@ export const browserService = {
     return checkBrowserProcessRunning();
   },
 
+  async autoConnectIfEnabled(): Promise<void> {
+    if (!browserConfig.autoConnect) {
+      console.log('[browser] Auto-connect disabled in config');
+      return;
+    }
+
+    if (connectedBrowser?.isConnected()) {
+      console.log('[browser] Already connected');
+      return;
+    }
+
+    // Wait briefly for browser process to be ready (handles concurrent startup)
+    const maxAttempts = 5;
+    const delayMs = 2000;
+
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      const isRunning = await checkBrowserProcessRunning();
+
+      if (isRunning) {
+        console.log('[browser] Auto-connecting to CDP...');
+        await this.connect().catch(err => {
+          console.log(`[browser] Auto-connect attempt ${attempt} failed: ${err.message}`);
+        });
+
+        if (connectedBrowser?.isConnected()) {
+          console.log('[browser] Auto-connect successful');
+          return;
+        }
+      }
+
+      if (attempt < maxAttempts) {
+        console.log(`[browser] Browser not ready, retrying in ${delayMs}ms (attempt ${attempt}/${maxAttempts})`);
+        await new Promise(resolve => setTimeout(resolve, delayMs));
+      }
+    }
+
+    console.log('[browser] Auto-connect: browser process not available after retries');
+  },
+
   async getFamilySearchToken(): Promise<{ token: string | null; cookies: Array<{ name: string; value: string }> }> {
     if (!connectedBrowser?.isConnected()) {
       return { token: null, cookies: [] };