Remove function comments as per expected code guidance

Author: tsvi

packages/main/src/backend/proxyConfig/agentManager.ts

@@ -15,9 +15,6 @@ interface ProxyState {
 
 let proxyState: ProxyState | null = null;
 
-/**
- * Initializes global proxy agents for HTTP/HTTPS and fetch()
- */
 export function initializeProxyAgents(proxyUrl: string): void {
   if (proxyState?.proxyUrl === proxyUrl) {
     logger.log(`Proxy already initialized with ${proxyUrl}`);
@@ -49,9 +46,6 @@ export function initializeProxyAgents(proxyUrl: string): void {
   setGlobalDispatcher(undiciProxyAgent);
 }
 
-/**
- * Restores original global agents and clears proxy configuration
- */
 export function tearDownProxyAgents(): void {
   if (!proxyState) {
     return;
@@ -74,9 +68,6 @@ export function tearDownProxyAgents(): void {
   proxyState = null;
 }
 
-/**
- * Gets current proxy URL if configured
- */
 export function getCurrentProxyUrl(): string | null {
   return proxyState?.proxyUrl ?? null;
 }

packages/main/src/backend/proxyConfig/index.ts

@@ -3,16 +3,10 @@ import { fetchPacFile, extractProxyFromPac, invalidatePacCache } from './pacFile
 import { getWindowsProxySettings } from './windowsRegistry';
 import { initializeProxyAgents, tearDownProxyAgents, getCurrentProxyUrl } from './agentManager';
 
-/**
- * Normalizes proxy URL to ensure it has a protocol
- */
 function normalizeProxyUrl(url: string): string {
   return url.startsWith('http') ? url : `http://${url}`;
 }
 
-/**
- * Attempts to extract proxy from PAC file
- */
 async function getProxyFromPacFile(pacUrl: string): Promise<string | undefined> {
   try {
     const pacContent = await fetchPacFile(pacUrl);
@@ -28,9 +22,6 @@ async function getProxyFromPacFile(pacUrl: string): Promise<string | undefined>
   return undefined;
 }
 
-/**
- * Determines proxy configuration from environment variables or Windows Registry
- */
 async function getProxyConfiguration(): Promise<string | undefined> {
   // Check environment variables first
   const envProxyUrl = process.env.HTTP_PROXY ?? process.env.HTTPS_PROXY;
@@ -58,9 +49,6 @@ async function getProxyConfiguration(): Promise<string | undefined> {
   return undefined;
 }
 
-/**
- * Initializes proxy configuration if available and not already set
- */
 export async function initProxyIfNeeded(): Promise<void> {
   const proxyUrl = await getProxyConfiguration();
   if (proxyUrl) {
@@ -70,17 +58,11 @@ export async function initProxyIfNeeded(): Promise<void> {
   }
 }
 
-/**
- * Tears down proxy configuration and clears cache for fresh start next time
- */
 export function tearDownProxy(): void {
   tearDownProxyAgents();
   invalidatePacCache();
 }
 
-/**
- * Gets proxy arguments for Chromium
- */
 export function getProxyArgs(): string[] {
   const proxyUrl = getCurrentProxyUrl();
   if (proxyUrl) {

packages/main/src/backend/proxyConfig/pacFile.ts

@@ -14,9 +14,6 @@ interface CachedPacFile {
 
 let cachedPacContent: CachedPacFile | null = null;
 
-/**
- * Fetches PAC file content from URL with caching
- */
 export async function fetchPacFile(pacUrl: string, bustCache = false): Promise<string> {
   // Return cached content if valid
   if (!bustCache && cachedPacContent?.url === pacUrl) {
@@ -59,10 +56,6 @@ export async function fetchPacFile(pacUrl: string, bustCache = false): Promise<s
   });
 }
 
-/**
- * Extracts proxy server from PAC file content
- * Looks for PROXY directives in the PAC file
- */
 export function extractProxyFromPac(pacContent: string): string | undefined {
   // Look for return statements with PROXY directives
   // Common patterns: "PROXY proxy.example.com:8080" or "PROXY host:port; DIRECT"
@@ -73,9 +66,6 @@ export function extractProxyFromPac(pacContent: string): string | undefined {
   return undefined;
 }
 
-/**
- * Invalidates cached PAC file content, forcing re-fetch on next call
- */
 export function invalidatePacCache(): void {
   cachedPacContent = null;
 }

packages/main/src/backend/proxyConfig/windowsRegistry.ts

@@ -6,10 +6,6 @@ export interface WindowsProxySettings {
   autoConfigUrl?: string;
 }
 
-/**
- * Reads proxy settings from Windows Registry
- * Checks HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings
- */
 const REGISTRY_PATH = '\\Software\\Microsoft\\Windows\\CurrentVersion\\Internet Settings';
 const REGISTRY_KEYS = {
   PROXY_SERVER: 'ProxyServer',