feat: improve error capture UX with filtered stack traces and cleaner logs

- Remove verbose console logs on error capture server startup
- Add server-side cleanup for _clientParsedStack field (client-only data)
- Keep filtered stack traces (show local source only, hide framework code)
- Improve code documentation and comments

Author: dmungamuri

src/lwc-dev-server/errorMiddleware.ts

@@ -72,6 +72,13 @@ export function createErrorMiddleware(
 
       const error = payload;
 
+      // Clean up client-only fields (used for browser logging, not needed on server)
+      // eslint-disable-next-line no-underscore-dangle
+      if ('_clientParsedStack' in error.error) {
+        // eslint-disable-next-line no-underscore-dangle
+        delete (error.error as Record<string, unknown>)._clientParsedStack;
+      }
+
       // Enhance stack trace with project context
       if (error.error.stack && error.error.sanitizedStack.length === 0) {
         error.error.sanitizedStack = parseStackTrace(error.error.stack, projectRoot);
@@ -84,7 +91,7 @@ export function createErrorMiddleware(
       if (logToConsole) {
         const formatted = formatErrorForCLI(error, {
           colorize: true,
-          showFullStack: false,
+          showFullStack: false, // Only show local source frames, hide framework/library code
           compact: false,
         });
         // eslint-disable-next-line no-console

src/lwc-dev-server/index.ts

@@ -47,9 +47,9 @@ async function createLWCServerConfig(
 
   const ports = serverPorts ??
     (await ConfigUtils.getLocalDevServerPorts()) ?? {
-      httpPort: LOCAL_DEV_SERVER_DEFAULT_HTTP_PORT,
-      httpsPort: LOCAL_DEV_SERVER_DEFAULT_HTTP_PORT + 1,
-    };
+    httpPort: LOCAL_DEV_SERVER_DEFAULT_HTTP_PORT,
+    httpsPort: LOCAL_DEV_SERVER_DEFAULT_HTTP_PORT + 1,
+  };
 
   const serverConfig: ServerConfig = {
     rootDir,
@@ -107,31 +107,19 @@ export async function startLWCServer(
       localhostOnly: true, // Bind to localhost only for security
     });
 
-    // eslint-disable-next-line no-console
-    console.log('\n✅ [ErrorCapture] Error capture system initialized');
-    // eslint-disable-next-line no-console
-    console.log(`📡 [ErrorCapture] LWC Dev Server (WebSocket): ws://localhost:${config.port}`);
-    // eslint-disable-next-line no-console
-    console.log(`🔍 [ErrorCapture] Error Capture Server (HTTP): http://localhost:${errorCapturePort}`);
-    // eslint-disable-next-line no-console
-    console.log('💡 [ErrorCapture] Tip: Errors clear automatically on server restart');
-    // eslint-disable-next-line no-console
-    console.log(`   Or manually: curl -X DELETE http://localhost:${errorCapturePort}/_dev/errors\n`);
     logger.info('[ErrorCapture] Error capture system initialized');
   } catch (err) {
     // eslint-disable-next-line no-console
     console.log(
-      `\n⚠️  [ErrorCapture] Failed to start error capture server on port ${errorCapturePort}: ${
-        err instanceof Error ? err.message : String(err)
+      `\n⚠️  [ErrorCapture] Failed to start error capture server on port ${errorCapturePort}: ${err instanceof Error ? err.message : String(err)
       }`
     );
     // eslint-disable-next-line no-console
     console.log(
       '⚠️  [ErrorCapture] Error capture will not be available. This does not affect LWC dev server functionality.\n'
     );
     logger.warn(
-      `[ErrorCapture] Failed to start error capture server on port ${errorCapturePort}: ${
-        err instanceof Error ? err.message : String(err)
+      `[ErrorCapture] Failed to start error capture server on port ${errorCapturePort}: ${err instanceof Error ? err.message : String(err)
       }`
     );
   }