agentic-qe 3.8.4 → 3.8.6

package/dist/domains/visual-accessibility/coordinator.js

@@ -2,6 +2,7 @@
  * Agentic QE v3 - Visual & Accessibility Coordinator
  * Orchestrates the visual and accessibility testing workflows
  */
+import { LoggerFactory } from '../../logging/index.js';
 import { v4 as uuidv4 } from 'uuid';
 import { toError, toErrorMessage } from '../../shared/error-utils.js';
 import { ok, err, } from '../../shared/types/index.js';
@@ -35,6 +36,7 @@ const DEFAULT_CONFIG = {
 /**
  * CQ-002: Extends BaseDomainCoordinator
  */
+const logger = LoggerFactory.create('visual-accessibility');
 export class VisualAccessibilityCoordinator extends BaseDomainCoordinator {
     memory;
     agentCoordinator;
@@ -80,10 +82,10 @@ export class VisualAccessibilityCoordinator extends BaseDomainCoordinator {
                     numWorkers: 4,
                 });
                 // First call to predict will initialize the algorithm
-                console.log('[visual-accessibility] A2C algorithm created successfully');
+                logger.info('A2C algorithm created successfully');
             }
             catch (error) {
-                console.error('[visual-accessibility] Failed to create A2C:', error);
+                logger.error('Failed to create A2C:', error instanceof Error ? error : undefined);
                 throw new Error(`A2C creation failed: ${toErrorMessage(error)}`);
             }
         }
@@ -91,10 +93,10 @@ export class VisualAccessibilityCoordinator extends BaseDomainCoordinator {
         if (this.config.enableFlashAttention) {
             try {
                 this.flashAttention = await createQEFlashAttention('test-similarity');
-                console.log('[visual-accessibility] QEFlashAttention initialized successfully');
+                logger.info('QEFlashAttention initialized successfully');
             }
             catch (error) {
-                console.error('[visual-accessibility] Failed to initialize Flash Attention:', error);
+                logger.error('Failed to initialize Flash Attention:', error instanceof Error ? error : undefined);
                 throw new Error(`Flash Attention initialization failed: ${toErrorMessage(error)}`);
             }
         }
@@ -133,7 +135,7 @@ export class VisualAccessibilityCoordinator extends BaseDomainCoordinator {
             this.startWorkflow(workflowId, 'visual');
             // V3: Check topology health before proceeding (ADR-047)
             if (this.config.enableMinCutAwareness && !this.isTopologyHealthy()) {
-                console.warn('[VisualAccessibility] Topology degraded, using conservative strategy');
+                logger.warn('Topology degraded, using conservative strategy');
             }
             // V3: Pause operations if topology is critical and configured to pause
             if (this.minCutMixin.shouldPauseOperations()) {
@@ -176,7 +178,7 @@ export class VisualAccessibilityCoordinator extends BaseDomainCoordinator {
                         url: t.url,
                         viewport: t.viewport,
                     }));
-                    console.log(`[visual-accessibility] Using ${prioritizationResult.value.strategy} strategy for visual test order (confidence: ${prioritizationResult.value.confidence.toFixed(2)})`);
+                    logger.info(`[visual-accessibility] Using ${prioritizationResult.value.strategy} strategy for visual test order (confidence: ${prioritizationResult.value.confidence.toFixed(2)})`);
                 }
             }
             const totalTests = testList.length;
@@ -281,7 +283,7 @@ export class VisualAccessibilityCoordinator extends BaseDomainCoordinator {
             this.startWorkflow(workflowId, 'accessibility');
             // V3: Check topology health before proceeding (ADR-047)
             if (this.config.enableMinCutAwareness && !this.isTopologyHealthy()) {
-                console.warn('[VisualAccessibility] Topology degraded, using conservative strategy');
+                logger.warn('Topology degraded, using conservative strategy');
             }
             // V3: Pause operations if topology is critical and configured to pause
             if (this.minCutMixin.shouldPauseOperations()) {
@@ -925,7 +927,7 @@ export class VisualAccessibilityCoordinator extends BaseDomainCoordinator {
                 nextState: state,
                 done: true,
             });
-            console.log(`[visual-accessibility] A2C prioritized ${tests.length} visual tests using ${strategy} strategy (confidence: ${prediction.confidence.toFixed(2)})`);
+            logger.info(`[visual-accessibility] A2C prioritized ${tests.length} visual tests using ${strategy} strategy (confidence: ${prediction.confidence.toFixed(2)})`);
             return ok({
                 orderedTests: prioritized,
                 strategy,
@@ -933,7 +935,7 @@ export class VisualAccessibilityCoordinator extends BaseDomainCoordinator {
             });
         }
         catch (error) {
-            console.error('[visual-accessibility] A2C prioritization failed:', error);
+            logger.error('A2C prioritization failed:', error instanceof Error ? error : undefined);
             // Return original tests on error (graceful degradation)
             return ok({
                 orderedTests: tests.map((t) => ({ ...t, priority: t.priority ?? 5, reason: 'fallback' })),
@@ -981,7 +983,7 @@ export class VisualAccessibilityCoordinator extends BaseDomainCoordinator {
             }));
         }
         catch (error) {
-            console.error('[visual-accessibility] Flash Attention similarity search failed:', error);
+            logger.error('Flash Attention similarity search failed:', error instanceof Error ? error : undefined);
             return this.cosineSimilarityFallback(targetImageEmbedding, imageEmbeddings, topK);
         }
     }
@@ -1012,10 +1014,10 @@ export class VisualAccessibilityCoordinator extends BaseDomainCoordinator {
             const embedding = this.createVisualEmbedding(url, viewport, diffScore, passed);
             // Store in memory for future similarity searches
             await this.memory.set(`visual-accessibility:embedding:${url}:${viewport.width}x${viewport.height}`, { embedding, url, viewport, diffScore, passed, timestamp: new Date() }, { namespace: 'visual-accessibility', persist: true });
-            console.log(`[visual-accessibility] Stored visual pattern for ${url} at ${viewport.width}x${viewport.height}`);
+            logger.info(`Stored visual pattern for ${url} at ${viewport.width}x${viewport.height}`);
         }
         catch (error) {
-            console.error('[visual-accessibility] Failed to store visual pattern:', error);
+            logger.error('Failed to store visual pattern:', error instanceof Error ? error : undefined);
         }
     }
     /**

package/dist/domains/visual-accessibility/services/accessibility-tester-browser.d.ts

@@ -32,9 +32,6 @@ export interface AxeCoreResult {
  * WCAG 2.2 criteria definitions (shared reference)
  */
 export declare const WCAG_CRITERIA: Record<string, WCAGCriterion>;
-/**
- * Check if client is an IAgentBrowserClient (has getSnapshot method)
- */
 export declare function isAgentBrowserClient(client: IBrowserClient): client is IAgentBrowserClient;
 /**
  * Get axe-core tags for a WCAG conformance level

package/dist/domains/visual-accessibility/services/accessibility-tester-browser.js

@@ -2,6 +2,7 @@
  * Agentic QE v3 - Accessibility Tester Browser Mode
  * Extracted from accessibility-tester.ts - Browser-based auditing via agent-browser and Vibium
  */
+import { LoggerFactory } from '../../../logging/index.js';
 import { ok, err } from '../../../shared/types/index.js';
 import { toError } from '../../../shared/error-utils.js';
 import { safeJsonParse } from '../../../shared/safe-json.js';
@@ -30,6 +31,7 @@ export const WCAG_CRITERIA = {
 /**
  * Check if client is an IAgentBrowserClient (has getSnapshot method)
  */
+const logger = LoggerFactory.create('visual-accessibility/accessibility-tester-browser');
 export function isAgentBrowserClient(client) {
     return client.tool === 'agent-browser' && 'getSnapshot' in client;
 }
@@ -79,55 +81,55 @@ export function getErrorMessage(result) {
 export async function runAxeCore(client, wcagLevel, options) {
     const tags = getAxeTagsForWcagLevel(wcagLevel);
     const excludeSelectors = options?.excludeSelectors ?? [];
-    const axeScript = `
-    (async function() {
-      // Check if axe is already loaded
-      if (typeof axe === 'undefined') {
-        // Inject axe-core from CDN
-        const script = document.createElement('script');
-        script.src = 'https://cdnjs.cloudflare.com/ajax/libs/axe-core/4.8.4/axe.min.js';
-        script.crossOrigin = 'anonymous';
-        document.head.appendChild(script);
-
-        // Wait for script to load
-        await new Promise((resolve, reject) => {
-          script.onload = resolve;
-          script.onerror = () => reject(new Error('Failed to load axe-core'));
-          setTimeout(() => reject(new Error('Timeout loading axe-core')), 10000);
-        });
-      }
-
-      // Configure and run axe
-      const config = {
-        runOnly: {
-          type: 'tag',
-          values: ${JSON.stringify(tags)}
-        },
-        exclude: ${JSON.stringify(excludeSelectors.map(s => [s]))}
-      };
-
-      const results = await axe.run(document, config);
-
-      return JSON.stringify({
-        violations: results.violations.map(v => ({
-          id: v.id,
-          impact: v.impact,
-          description: v.description,
-          help: v.help,
-          helpUrl: v.helpUrl,
-          tags: v.tags,
-          nodes: v.nodes.map(n => ({
-            selector: n.target.join(' > '),
-            html: n.html,
-            target: n.target,
-            failureSummary: n.failureSummary
-          }))
-        })),
-        passes: results.passes.map(p => p.id),
-        incomplete: results.incomplete.map(i => i.id),
-        inapplicable: results.inapplicable.map(i => i.id)
-      });
-    })();
+    const axeScript = `
+    (async function() {
+      // Check if axe is already loaded
+      if (typeof axe === 'undefined') {
+        // Inject axe-core from CDN
+        const script = document.createElement('script');
+        script.src = 'https://cdnjs.cloudflare.com/ajax/libs/axe-core/4.8.4/axe.min.js';
+        script.crossOrigin = 'anonymous';
+        document.head.appendChild(script);
+
+        // Wait for script to load
+        await new Promise((resolve, reject) => {
+          script.onload = resolve;
+          script.onerror = () => reject(new Error('Failed to load axe-core'));
+          setTimeout(() => reject(new Error('Timeout loading axe-core')), 10000);
+        });
+      }
+
+      // Configure and run axe
+      const config = {
+        runOnly: {
+          type: 'tag',
+          values: ${JSON.stringify(tags)}
+        },
+        exclude: ${JSON.stringify(excludeSelectors.map(s => [s]))}
+      };
+
+      const results = await axe.run(document, config);
+
+      return JSON.stringify({
+        violations: results.violations.map(v => ({
+          id: v.id,
+          impact: v.impact,
+          description: v.description,
+          help: v.help,
+          helpUrl: v.helpUrl,
+          tags: v.tags,
+          nodes: v.nodes.map(n => ({
+            selector: n.target.join(' > '),
+            html: n.html,
+            target: n.target,
+            failureSummary: n.failureSummary
+          }))
+        })),
+        passes: results.passes.map(p => p.id),
+        incomplete: results.incomplete.map(i => i.id),
+        inapplicable: results.inapplicable.map(i => i.id)
+      });
+    })();
   `;
     const evalResult = await client.evaluate(axeScript);
     if (!evalResult.success) {
@@ -329,7 +331,7 @@ export async function auditWithBrowserClient(client, url, wcagLevel, browserConf
                 const snapshotResult = await client.getSnapshot({ interactive: true });
                 if (snapshotResult.success) {
                     const elementCount = snapshotResult.value.interactiveElements.length;
-                    console.debug(`[AccessibilityTester] Found ${elementCount} interactive elements`);
+                    logger.debug(`Found ${elementCount} interactive elements`);
                 }
             }
             const axeResult = await runAxeCore(client, wcagLevel, options);

package/dist/domains/visual-accessibility/services/accessibility-tester.d.ts

@@ -42,10 +42,6 @@ export interface AccessibilityTesterConfig {
     browserClient?: IBrowserClient;
     preferAgentBrowser: boolean;
 }
-/**
- * Accessibility Auditing Service Implementation
- * Provides WCAG 2.2 compliance checking with optional browser mode via Vibium
- */
 export declare class AccessibilityTesterService implements IAccessibilityAuditingService {
     private readonly memory;
     private readonly config;

package/dist/domains/visual-accessibility/services/accessibility-tester.js

@@ -19,6 +19,7 @@
  *
  * @module domains/visual-accessibility/services/accessibility-tester
  */
+import { LoggerFactory } from '../../../logging/index.js';
 import { v4 as uuidv4 } from 'uuid';
 import { ok, err } from '../../../shared/types/index.js';
 import { EUComplianceService } from './eu-compliance.js';
@@ -47,6 +48,7 @@ const DEFAULT_CONFIG = {
  * Accessibility Auditing Service Implementation
  * Provides WCAG 2.2 compliance checking with optional browser mode via Vibium
  */
+const logger = LoggerFactory.create('visual-accessibility/accessibility-tester');
 export class AccessibilityTesterService {
     memory;
     config;
@@ -96,7 +98,7 @@ export class AccessibilityTesterService {
                 }
             }
             catch (error) {
-                console.debug('[AccessibilityTester] Browser client error:', error instanceof Error ? error.message : error);
+                logger.debug('Browser client error:');
             }
         }
         return null;
@@ -116,7 +118,7 @@ export class AccessibilityTesterService {
                         return browserResult;
                     }
                     const errorMsg = getErrorMessage(browserResult);
-                    console.warn(`Browser client audit failed: ${errorMsg}`);
+                    logger.warn(`Browser client audit failed: ${errorMsg}`);
                 }
                 if (this.vibiumClient && isBrowserModeEnabled() && isAxeCoreEnabled()) {
                     const vibiumResult = await auditWithVibium(this.vibiumClient, url, wcagLevel, this.config.browserConfig, options);
@@ -125,7 +127,7 @@ export class AccessibilityTesterService {
                         return vibiumResult;
                     }
                     const errorMsg = getErrorMessage(vibiumResult);
-                    console.warn(`Vibium audit failed, falling back to heuristic mode: ${errorMsg}`);
+                    logger.warn(`Vibium audit failed, falling back to heuristic mode: ${errorMsg}`);
                 }
             }
             return this.auditWithHeuristics(url, wcagLevel, options);
@@ -142,7 +144,7 @@ export class AccessibilityTesterService {
                 return browserResult;
             }
             const errorMsg = getErrorMessage(browserResult);
-            console.warn(`Browser mode element audit failed, falling back to heuristic mode: ${errorMsg}`);
+            logger.warn(`Browser mode element audit failed, falling back to heuristic mode: ${errorMsg}`);
         }
         return this.audit(url, {
             excludeSelectors: [],
@@ -226,7 +228,7 @@ export class AccessibilityTesterService {
                 }
                 else {
                     const errorMsg = getErrorMessage(browserResult);
-                    console.warn(`Browser mode contrast check failed, falling back to heuristic mode: ${errorMsg}`);
+                    logger.warn(`Browser mode contrast check failed, falling back to heuristic mode: ${errorMsg}`);
                     analyses = analyzeContrastForElements(url);
                 }
             }
@@ -286,7 +288,7 @@ export class AccessibilityTesterService {
                 }
                 else {
                     const errorMsg = getErrorMessage(browserResult);
-                    console.warn(`Browser mode keyboard check failed, falling back to heuristic mode: ${errorMsg}`);
+                    logger.warn(`Browser mode keyboard check failed, falling back to heuristic mode: ${errorMsg}`);
                     report = generateKeyboardReportWithHeuristics(url);
                 }
             }

package/dist/domains/visual-accessibility/services/axe-core-integration.d.ts

@@ -245,9 +245,6 @@ export declare const FIX_SUGGESTIONS: Record<string, string>;
  * Using the official axe-core CDN
  */
 export declare const AXE_CORE_CDN_URL = "https://cdnjs.cloudflare.com/ajax/libs/axe-core/4.8.4/axe.min.js";
-/**
- * Error thrown when axe-core injection fails
- */
 export declare class AxeCoreInjectionError extends Error {
     readonly cause?: Error | undefined;
     constructor(message: string, cause?: Error | undefined);

package/dist/domains/visual-accessibility/services/axe-core-integration.js

@@ -10,6 +10,7 @@
  *
  * @module domains/visual-accessibility/services/axe-core-integration
  */
+import { LoggerFactory } from '../../../logging/index.js';
 import { ok, err } from '../../../shared/types/index.js';
 import { toError } from '../../../shared/error-utils.js';
 // ============================================================================
@@ -175,10 +176,10 @@ export const AXE_CORE_CDN_URL = 'https://cdnjs.cloudflare.com/ajax/libs/axe-core
  * Minified axe-core script for injection
  * This is a placeholder - in production, use the CDN or bundle axe-core
  */
-const AXE_CORE_INJECTION_CHECK = `
-  if (typeof axe === 'undefined') {
-    throw new Error('axe-core not loaded');
-  }
+const AXE_CORE_INJECTION_CHECK = `
+  if (typeof axe === 'undefined') {
+    throw new Error('axe-core not loaded');
+  }
 `;
 // ============================================================================
 // Integration Functions
@@ -186,6 +187,7 @@ const AXE_CORE_INJECTION_CHECK = `
 /**
  * Error thrown when axe-core injection fails
  */
+const logger = LoggerFactory.create('visual-accessibility/axe-core');
 export class AxeCoreInjectionError extends Error {
     cause;
     constructor(message, cause) {
@@ -231,8 +233,8 @@ export async function injectAxeCore(client, options = {}) {
     const { useCDN = true, timeout = 10000 } = options;
     try {
         // Check if axe-core is already loaded
-        const checkResult = await executeInBrowser(client, `
-      return typeof axe !== 'undefined';
+        const checkResult = await executeInBrowser(client, `
+      return typeof axe !== 'undefined';
     `, timeout);
         if (checkResult.success && checkResult.value === true) {
             // axe-core already loaded
@@ -240,21 +242,21 @@ export async function injectAxeCore(client, options = {}) {
         }
         if (useCDN) {
             // Try to load from CDN
-            const cdnResult = await executeInBrowser(client, `
-        return new Promise((resolve, reject) => {
-          const script = document.createElement('script');
-          script.src = '${AXE_CORE_CDN_URL}';
-          script.onload = () => resolve(true);
-          script.onerror = () => reject(new Error('Failed to load axe-core from CDN'));
-          document.head.appendChild(script);
-          setTimeout(() => reject(new Error('axe-core CDN load timeout')), ${timeout});
-        });
+            const cdnResult = await executeInBrowser(client, `
+        return new Promise((resolve, reject) => {
+          const script = document.createElement('script');
+          script.src = '${AXE_CORE_CDN_URL}';
+          script.onload = () => resolve(true);
+          script.onerror = () => reject(new Error('Failed to load axe-core from CDN'));
+          document.head.appendChild(script);
+          setTimeout(() => reject(new Error('axe-core CDN load timeout')), ${timeout});
+        });
       `, timeout + 1000);
             if (cdnResult.success) {
                 return ok(undefined);
             }
             // CDN failed, log and continue to fallback
-            console.warn('Failed to load axe-core from CDN, attempting inline injection');
+            logger.warn('Failed to load axe-core from CDN, attempting inline injection');
         }
         // Fallback: Check if we have inline axe-core (would need to be bundled)
         // For now, return error if CDN fails
@@ -304,8 +306,8 @@ export async function runAxeAudit(client, options = {}) {
         }
         // Build the axe.run() call with options
         const axeOptionsJson = JSON.stringify(options);
-        const auditScript = `
-      return await axe.run(document, ${axeOptionsJson});
+        const auditScript = `
+      return await axe.run(document, ${axeOptionsJson});
     `;
         const auditResult = await executeInBrowser(client, auditScript, 60000);
         if (!auditResult.success) {

package/dist/domains/visual-accessibility/services/browser-security-scanner.d.ts

@@ -56,10 +56,6 @@ export interface BrowserSecurityScannerConfig {
     /** Enable detailed logging */
     verbose?: boolean;
 }
-/**
- * Browser Security Scanner Service
- * Wraps @claude-flow/browser MCP security features with graceful fallback
- */
 export declare class BrowserSecurityScanner {
     private initialized;
     private browserAvailable;

package/dist/domains/visual-accessibility/services/browser-security-scanner.js

@@ -9,6 +9,7 @@
  *
  * @module domains/visual-accessibility/services/browser-security-scanner
  */
+import { LoggerFactory } from '../../../logging/index.js';
 import { ok, err } from '../../../shared/types/index.js';
 import { toErrorMessage } from '../../../shared/error-utils.js';
 // ============================================================================
@@ -37,6 +38,7 @@ function hasMcpTools() {
  * Browser Security Scanner Service
  * Wraps @claude-flow/browser MCP security features with graceful fallback
  */
+const logger = LoggerFactory.create('visual-accessibility/browser-security-scanner');
 export class BrowserSecurityScanner {
     initialized = false;
     browserAvailable = false;
@@ -61,7 +63,7 @@ export class BrowserSecurityScanner {
         // Check if MCP tools are available
         this.browserAvailable = hasMcpTools();
         if (this.config.verbose) {
-            console.log(`[BrowserSecurityScanner] MCP tools available: ${this.browserAvailable}`);
+            logger.info(`MCP tools available: ${this.browserAvailable}`);
         }
         this.initialized = true;
     }
@@ -112,7 +114,7 @@ export class BrowserSecurityScanner {
         }
         catch (error) {
             if (this.config.verbose) {
-                console.error('[BrowserSecurityScanner] validateUrl error:', error);
+                logger.error('validateUrl error:', error instanceof Error ? error : undefined);
             }
             return this.fallbackValidateUrl(url);
         }
@@ -154,7 +156,7 @@ export class BrowserSecurityScanner {
         }
         catch (error) {
             if (this.config.verbose) {
-                console.error('[BrowserSecurityScanner] detectPhishing error:', error);
+                logger.error('detectPhishing error:', error instanceof Error ? error : undefined);
             }
             return this.fallbackDetectPhishing(url);
         }
@@ -189,7 +191,7 @@ export class BrowserSecurityScanner {
         }
         catch (error) {
             if (this.config.verbose) {
-                console.error('[BrowserSecurityScanner] scanForPII error:', error);
+                logger.error('scanForPII error:', error instanceof Error ? error : undefined);
             }
             return this.fallbackScanForPII(content);
         }

package/dist/domains/visual-accessibility/services/browser-swarm-coordinator.d.ts

@@ -137,36 +137,6 @@ export interface BrowserSwarmConfig {
  * Standard viewport configurations for common devices
  */
 export declare const STANDARD_VIEWPORTS: Viewport[];
-/**
- * Multi-session browser coordinator for parallel viewport testing
- *
- * Manages a pool of browser sessions across different viewports,
- * enabling efficient parallel testing with resource management.
- *
- * Features:
- * - Parallel session management across multiple viewports
- * - Resource monitoring and memory management
- * - Graceful degradation to sequential execution
- * - Automatic session cleanup and recovery
- * - Support for screenshots and accessibility audits
- *
- * @example
- * ```typescript
- * const coordinator = new BrowserSwarmCoordinator(memory);
- *
- * // Initialize with standard viewports
- * await coordinator.initialize(STANDARD_VIEWPORTS);
- *
- * // Capture screenshots across all viewports in parallel
- * const screenshots = await coordinator.captureAllViewports('https://example.com');
- *
- * // Run accessibility audits
- * const audits = await coordinator.auditAllViewports('https://example.com');
- *
- * // Cleanup
- * await coordinator.shutdown();
- * ```
- */
 export declare class BrowserSwarmCoordinator {
     private readonly memory;
     private readonly config;

package/dist/domains/visual-accessibility/services/browser-swarm-coordinator.js

@@ -19,6 +19,7 @@
  *
  * @module domains/visual-accessibility/services/browser-swarm-coordinator
  */
+import { LoggerFactory } from '../../../logging/index.js';
 import { v4 as uuidv4 } from 'uuid';
 import { ok, err } from '../../../shared/types/index.js';
 import { FilePath } from '../../../shared/value-objects/index.js';
@@ -111,6 +112,7 @@ const DEFAULT_CONFIG = {
  * await coordinator.shutdown();
  * ```
  */
+const logger = LoggerFactory.create('visual-accessibility/browser-swarm');
 export class BrowserSwarmCoordinator {
     memory;
     config;
@@ -408,7 +410,7 @@ export class BrowserSwarmCoordinator {
                 }
                 catch (error) {
                     // Log but don't fail shutdown
-                    console.error(`[BrowserSwarm] Failed to close session ${session.id}:`, error);
+                    logger.error(`[BrowserSwarm] Failed to close session ${session.id}`, error instanceof Error ? error : undefined);
                 }
             });
             await Promise.all(closePromises);
@@ -512,7 +514,7 @@ export class BrowserSwarmCoordinator {
         this.memoryCheckInterval = setInterval(() => {
             const memoryUsage = this.estimateMemoryUsage();
             if (memoryUsage > this.config.memoryThresholdMB) {
-                console.warn(`[BrowserSwarm] Memory usage ${memoryUsage.toFixed(2)}MB exceeds threshold ${this.config.memoryThresholdMB}MB. Degrading to sequential execution.`);
+                logger.warn(`[BrowserSwarm] Memory usage ${memoryUsage.toFixed(2)}MB exceeds threshold ${this.config.memoryThresholdMB}MB. Degrading to sequential execution.`);
             }
             // Store metrics
             this.memory
@@ -522,7 +524,7 @@ export class BrowserSwarmCoordinator {
                 timestamp: new Date(),
             }, { namespace: 'visual-accessibility', ttl: 3600 })
                 .catch((err) => {
-                console.error('[BrowserSwarm] Failed to store memory metrics:', err);
+                logger.error('Failed to store memory metrics:', err instanceof Error ? err : undefined);
             });
         }, 30000);
     }

package/dist/domains/visual-accessibility/services/viewport-capture.d.ts

@@ -247,33 +247,6 @@ export interface SingleCaptureOptions {
     /** Hide selectors */
     hideSelectors?: string[];
 }
-/**
- * Multi-viewport screenshot capture service implementation
- *
- * Provides comprehensive screenshot capture capabilities:
- * - Capture at multiple viewports in parallel
- * - Capture at CSS breakpoints for responsive testing
- * - Screenshot comparison utilities
- * - Performance metrics tracking
- *
- * @example
- * ```typescript
- * const service = new ViewportCaptureService(memory, vibiumClient);
- *
- * // Capture at standard presets
- * const result = await service.captureWithPresets(
- *   'https://example.com',
- *   ['mobile-m', 'tablet', 'desktop']
- * );
- *
- * // Capture at responsive breakpoints
- * const analysis = await service.captureResponsiveBreakpoints(
- *   'https://example.com',
- *   320,
- *   1920
- * );
- * ```
- */
 export declare class ViewportCaptureService implements IViewportCaptureService {
     private readonly memory;
     private readonly vibiumClient?;

package/dist/domains/visual-accessibility/services/viewport-capture.js

@@ -11,6 +11,7 @@
  *
  * @module domains/visual-accessibility/services/viewport-capture
  */
+import { LoggerFactory } from '../../../logging/index.js';
 import { v4 as uuidv4 } from 'uuid';
 import { ok, err } from '../../../shared/types/index.js';
 import { FilePath } from '../../../shared/value-objects/index.js';
@@ -140,6 +141,7 @@ const DEFAULT_CONFIG = {
  * );
  * ```
  */
+const logger = LoggerFactory.create('visual-accessibility/viewport-capture');
 export class ViewportCaptureService {
     memory;
     vibiumClient;
@@ -179,7 +181,7 @@ export class ViewportCaptureService {
             }
             catch (error) {
                 // Non-critical: browser client acquisition failed
-                console.debug('[ViewportCapture] Browser client error:', error instanceof Error ? error.message : error);
+                logger.debug('Browser client error:');
             }
         }
         return null;
@@ -343,7 +345,7 @@ export class ViewportCaptureService {
                     return result;
                 }
                 // Log failure and try next option
-                console.warn(`[ViewportCapture] Browser client capture failed, trying Vibium`);
+                logger.warn(`Browser client capture failed, trying Vibium`);
             }
             // If Vibium client is available and has active session, use real browser capture
             if (this.vibiumClient) {
@@ -385,7 +387,7 @@ export class ViewportCaptureService {
             }
             else {
                 // Log warning but continue with valid presets
-                console.warn(`[ViewportCapture] Unknown preset: ${name}`);
+                logger.warn(`Unknown preset: ${name}`);
             }
         }
         if (viewports.length === 0) {
@@ -453,7 +455,7 @@ export class ViewportCaptureService {
                 // Set viewport for device emulation
                 const viewportResult = await client.setViewport(viewport.width, viewport.height);
                 if (!viewportResult.success) {
-                    console.warn(`[ViewportCapture] setViewport failed: ${viewportResult.error?.message}`);
+                    logger.warn(`setViewport failed: ${viewportResult.error?.message}`);
                 }
                 // Optionally set device preset for mobile viewports
                 if (viewport.isMobile) {