refactor: remove ~70 low-value comments across 13 files

- Remove empty section markers (// === ... ===, // --- ... ---) that duplicate JSDoc or function names
- Remove "what" comments that restate the next line of code (e.g. // Save to disk, // Check for retryable patterns)
- Remove file-level descriptions that restate the filename (e.g. // Pure functions for formatting console output)
- Fix "Added by client" comment referencing implementation history → "Used for audit correlation"
- Preserve all WHY comments: error classification groups, billing/session limit explanations, ESM interop, exactOptionalPropertyTypes, mutex reasoning

src/audit/audit-session.ts

@@ -112,24 +112,19 @@ export class AuditSession {
       await AgentLogger.savePrompt(this.sessionMetadata, agentName, promptContent);
     }
 
-    // Track current agent name for workflow logging
     this.currentAgentName = agentName;
 
-    // Create and initialize logger for this attempt
     this.currentLogger = new AgentLogger(this.sessionMetadata, agentName, attemptNumber);
     await this.currentLogger.initialize();
 
-    // Start metrics tracking
     this.metricsTracker.startAgent(agentName, attemptNumber);
 
-    // Log start event
     await this.currentLogger.logEvent('agent_start', {
       agentName,
       attemptNumber,
       timestamp: formatTimestamp(),
     });
 
-    // Log to unified workflow log
     await this.workflowLogger.logAgent(agentName, 'start', { attemptNumber });
   }
 
@@ -177,7 +172,6 @@ export class AuditSession {
    * End agent execution (mutex-protected)
    */
   async endAgent(agentName: string, result: AgentEndResult): Promise<void> {
-    // Log end event
     if (this.currentLogger) {
       await this.currentLogger.logEvent('agent_end', {
         agentName,
@@ -187,15 +181,12 @@ export class AuditSession {
         timestamp: formatTimestamp(),
       });
 
-      // Close logger
       await this.currentLogger.close();
       this.currentLogger = null;
     }
 
-    // Reset current agent name
     this.currentAgentName = null;
 
-    // Log to unified workflow log
     const agentLogDetails: AgentLogDetails = {
       attemptNumber: result.attemptNumber,
       duration_ms: result.duration_ms,
@@ -211,7 +202,6 @@ export class AuditSession {
       // Reload inside mutex to prevent lost updates during parallel exploitation phase
       await this.metricsTracker.reload();
 
-      // Update metrics
       await this.metricsTracker.endAgent(agentName, result);
     } finally {
       unlock();

src/audit/logger.ts

@@ -42,7 +42,6 @@ export class AgentLogger {
     this.attemptNumber = attemptNumber;
     this.timestamp = Date.now();
 
-    // Generate log file path and create stream
     const logPath = generateLogPath(sessionMetadata, agentName, this.timestamp, attemptNumber);
     this.logStream = new LogStream(logPath);
   }

src/audit/metrics-tracker.ts

@@ -227,7 +227,6 @@ export class MetricsTracker {
     // Recalculate aggregations
     this.recalculateAggregations();
 
-    // Save to disk
     await this.save();
   }
 

src/audit/workflow-logger.ts

@@ -59,7 +59,6 @@ export class WorkflowLogger {
       return;
     }
 
-    // Open the stream (LogStream.open() handles directory creation)
     await this.logStream.open();
 
     // Write header only if file is new (empty)