fix: Add comprehensive debugging for port scan error

- Added detailed console logging throughout scan process
- Check for window.portManager availability before scanning
- Improved error messages with full stack traces
- IPC handler now always returns array instead of throwing
- Added validation for scan results

This will help diagnose the "Cannot read properties of undefined" error

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: ahmadzein

src/core/services/PortService.ts

@@ -158,6 +158,8 @@ export class PortService {
     const platform = process.platform;
     let command: string;
 
+    console.log('PortService: Scanning on platform:', platform);
+
     if (platform === 'darwin' || platform === 'linux') {
       command = 'lsof -i -P -n | grep LISTEN';
     } else if (platform === 'win32') {
@@ -167,9 +169,14 @@ export class PortService {
     }
 
     try {
+      console.log('PortService: Executing command:', command);
       const { stdout } = await execAsync(command);
-      return this.parsePortScanOutput(stdout, platform);
+      console.log('PortService: Command output length:', stdout.length);
+      const ports = this.parsePortScanOutput(stdout, platform);
+      console.log('PortService: Parsed ports:', ports.length);
+      return ports;
     } catch (error) {
+      console.error('PortService: Scan error:', error);
       // Command might fail if no ports are listening
       return [];
     }

src/gui/main/ipc/handlers.ts

@@ -51,9 +51,30 @@ export function setupIpcHandlers(): void {
 
   ipcMain.handle('port:scan', async () => {
     try {
-      return await portService.scanActivePorts();
+      console.log('IPC: Scanning active ports...');
+      const result = await portService.scanActivePorts();
+      console.log('IPC: Scan result:', result);
+      
+      // Ensure we always return an array
+      if (!result) {
+        console.log('IPC: No result, returning empty array');
+        return [];
+      }
+      
+      if (!Array.isArray(result)) {
+        console.error('IPC: Result is not an array:', typeof result, result);
+        return [];
+      }
+      
+      return result;
     } catch (error) {
-      throw new Error((error as Error).message);
+      console.error('IPC: Scan error details:', {
+        message: error instanceof Error ? error.message : 'Unknown error',
+        stack: error instanceof Error ? error.stack : 'No stack trace',
+        error
+      });
+      // Return empty array instead of throwing
+      return [];
     }
   });
 

src/gui/renderer/pages/ScanView.tsx

@@ -15,6 +15,20 @@ const ScanView: React.FC = () => {
   const scanPorts = async () => {
     setIsLoading(true);
     try {
+      // Check if window.portManager exists
+      if (!window.portManager) {
+        console.error('window.portManager is undefined');
+        message.error('Port Manager API not available');
+        return;
+      }
+      
+      if (!window.portManager.port) {
+        console.error('window.portManager.port is undefined');
+        message.error('Port API not available');
+        return;
+      }
+      
+      console.log('Starting port scan...');
       const ports = await window.portManager.port.scan();
       console.log('Scanned ports:', ports); // Debug log
 
@@ -28,10 +42,22 @@ const ScanView: React.FC = () => {
 
       setActivePorts(ports);
       setFilteredPorts(ports);
-      message.success(`Found ${ports.length} active ports`);
+      
+      if (ports.length === 0) {
+        message.info('No active ports found');
+      } else {
+        message.success(`Found ${ports.length} active ports`);
+      }
     } catch (error) {
-      console.error('Scan error:', error);
-      message.error(`Scan failed: ${(error as Error).message}`);
+      console.error('Scan error full details:', {
+        error,
+        message: error instanceof Error ? error.message : 'Unknown error',
+        stack: error instanceof Error ? error.stack : 'No stack',
+        type: error?.constructor?.name
+      });
+      
+      const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+      message.error(`Scan failed: ${errorMessage}`);
       setActivePorts([]);
       setFilteredPorts([]);
     } finally {