agentic-qe 3.15.15 → 3.15.16

package/dist/domains/visual-accessibility/coordinator.d.ts

@@ -25,6 +25,20 @@ export interface WorkflowStatus {
     progress: number;
     error?: string;
 }
+/**
+ * A color-contrast violation as axe-core measured it (#1228). A colour the
+ * browser did not report is null and an unreported ratio is -1, with
+ * measured: false.
+ */
+export interface ContrastIssue {
+    element: string;
+    foreground: string | null;
+    background: string | null;
+    ratio: number;
+    required: number;
+    measured: boolean;
+    notMeasuredReason?: string;
+}
 /**
  * Coordinator configuration
  */
@@ -140,13 +154,7 @@ export declare class VisualAccessibilityCoordinator extends BaseDomainCoordinato
         url: string;
         wcagLevel?: 'A' | 'AA' | 'AAA';
     }): Promise<Result<{
-        issues: Array<{
-            element: string;
-            foreground: string;
-            background: string;
-            ratio: number;
-            required: number;
-        }>;
+        issues: ContrastIssue[];
     }, Error>>;
     /**
      * Test responsive design across multiple viewports

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

@@ -11,6 +11,7 @@ import { cosineSimilarity } from '../../shared/utils/vector-math.js';
 import { createVisualTesterServiceWithDependencies, } from './services/visual-tester.js';
 import { AccessibilityTesterService, } from './services/accessibility-tester.js';
 import { ResponsiveTesterService, } from './services/responsive-tester.js';
+import { contrastValues, contrastValuesMeasured, defaultRequiredRatio } from './services/accessibility-contrast.js';
 import { A2CAlgorithm } from '../../integrations/rl-suite/algorithms/a2c.js';
 import { createQEFlashAttention } from '../../integrations/ruvector/wrappers.js';
 // CQ-002: Base domain coordinator
@@ -589,13 +590,20 @@ export class VisualAccessibilityCoordinator extends BaseDomainCoordinator {
             }
             // Filter for color contrast violations
             const contrastViolations = auditResult.value.violations.filter((v) => v.id.includes('color-contrast') || v.id.includes('contrast'));
-            const issues = contrastViolations.flatMap((violation) => violation.nodes.map((node) => ({
-                element: node.target.join(' '),
-                foreground: '#000000',
-                background: '#ffffff',
-                ratio: 1.0,
-                required: level === 'AAA' ? 7.0 : 4.5,
-            })));
+            // #1228: the colours and ratio axe-core measured; unreported values are null / -1
+            const issues = contrastViolations.flatMap((violation) => violation.nodes.map((node) => {
+                const values = node.contrast ?? contrastValues(undefined, node.failureSummary);
+                const measured = contrastValuesMeasured(values);
+                return {
+                    element: node.target.join(' '),
+                    foreground: values.foreground,
+                    background: values.background,
+                    ratio: values.ratio ?? -1,
+                    required: values.requiredRatio ?? defaultRequiredRatio(level),
+                    measured,
+                    ...(measured ? {} : { notMeasuredReason: 'axe-core did not report the colours and ratio for this element' }),
+                };
+            }));
             return ok({ issues });
         }
         catch (error) {

package/dist/domains/visual-accessibility/interfaces.d.ts

@@ -187,18 +187,36 @@ export interface ViolationNode {
     readonly target: string[];
     readonly failureSummary: string;
     readonly fixSuggestion?: string;
+    /** Colours and ratio axe-core reported for a contrast violation (#1228). */
+    readonly contrast?: ContrastValues;
+}
+/**
+ * Colours and contrast ratio as the browser measured them (#1228).
+ * A value the browser did not report is null, never a default colour or ratio.
+ */
+export interface ContrastValues {
+    readonly foreground: string | null;
+    readonly background: string | null;
+    readonly ratio: number | null;
+    /** The ratio axe-core required for this element (3:1 for large text), when reported. */
+    readonly requiredRatio: number | null;
 }
 /**
  * Color contrast analysis
  */
 export interface ContrastAnalysis {
     readonly element: string;
-    readonly foreground: string;
-    readonly background: string;
+    /** null when the browser did not report the colour (#1228). */
+    readonly foreground: string | null;
+    readonly background: string | null;
+    /** -1 when the browser did not report the ratio (#1228). */
     readonly ratio: number;
     readonly requiredRatio: number;
     readonly passes: boolean;
     readonly wcagLevel: 'A' | 'AA' | 'AAA';
+    /** false when the colours or ratio were not reported; see notMeasuredReason (#1228). */
+    readonly measured?: boolean;
+    readonly notMeasuredReason?: string;
 }
 export interface VisualRegressionDetectedEvent extends DomainEvent {
     readonly type: 'VisualRegressionDetectedEvent';
@@ -360,12 +378,18 @@ export interface KeyboardNavigationReport {
     readonly tabOrder: TabOrderItem[];
     readonly issues: KeyboardIssue[];
     readonly traps: FocusTrap[];
+    /**
+     * What this report did not measure (#1228). An empty `traps` list, or a
+     * null `hasVisibleFocus`, is not a clean result for an aspect listed here.
+     */
+    readonly notMeasured?: string[];
 }
 export interface TabOrderItem {
     readonly index: number;
     readonly selector: string;
     readonly elementType: string;
-    readonly hasVisibleFocus: boolean;
+    /** null: the focus indicator was not measured (#1228). */
+    readonly hasVisibleFocus: boolean | null;
 }
 export interface KeyboardIssue {
     readonly type: 'no-focus-indicator' | 'skip-link-missing' | 'incorrect-tab-order' | 'non-interactive-focusable';

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

@@ -0,0 +1,39 @@
+/**
+ * Agentic QE v3 - Measured colour contrast values (#1228)
+ *
+ * axe-core reports the colours and ratio it measured for each element checked
+ * by its color-contrast rules: in the check data (fgColor, bgColor,
+ * contrastRatio, expectedContrastRatio) and in the failure summary text. These
+ * helpers carry those values through. A value the browser did not report is
+ * null (or a ratio of -1 in ContrastAnalysis), never a default colour or ratio.
+ */
+import type { ContrastAnalysis, ContrastValues } from '../interfaces.js';
+/** The fields of axe-core's color-contrast check data that AQE keeps. */
+export interface AxeContrastData {
+    fgColor?: string;
+    bgColor?: string;
+    contrastRatio?: number;
+    expectedContrastRatio?: string;
+}
+/** axe-core rule ids that measure text contrast. */
+export declare const CONTRAST_RULE_IDS: readonly ["color-contrast", "color-contrast-enhanced"];
+export declare function isContrastRule(ruleId: string): boolean;
+/**
+ * Browser-side expression `(node) => AxeContrastData | undefined` for an axe-core
+ * result node. Embedded in the scripts that run axe-core in the page.
+ */
+export declare const AXE_CONTRAST_DATA_JS = "function (n) {\n  var checks = [].concat(n.any || [], n.all || [], n.none || []);\n  for (var i = 0; i < checks.length; i++) {\n    var c = checks[i];\n    if ((c.id === 'color-contrast' || c.id === 'color-contrast-enhanced') && c.data) {\n      return {\n        fgColor: c.data.fgColor,\n        bgColor: c.data.bgColor,\n        contrastRatio: c.data.contrastRatio,\n        expectedContrastRatio: c.data.expectedContrastRatio\n      };\n    }\n  }\n  return undefined;\n}";
+/**
+ * Read the values from axe-core's failure summary, e.g. "Element has insufficient
+ * color contrast of 2.32 (foreground color: #aaaaaa, background color: #ffffff,
+ * ...). Expected contrast ratio of 4.5:1".
+ */
+export declare function parseContrastFailureSummary(summary: string | undefined): ContrastValues;
+/** Values from axe-core's check data, with gaps filled from the failure summary. */
+export declare function contrastValues(data: AxeContrastData | undefined, failureSummary?: string): ContrastValues;
+export declare function contrastValuesMeasured(values: ContrastValues): boolean;
+/** The ratio WCAG requires for normal text at a level, when axe-core did not say. */
+export declare function defaultRequiredRatio(level: 'A' | 'AA' | 'AAA'): number;
+/** One element's contrast result; unreported values stay unmeasured. */
+export declare function toContrastAnalysis(element: string, values: ContrastValues, passes: boolean, wcagLevel: 'A' | 'AA' | 'AAA'): ContrastAnalysis;
+//# sourceMappingURL=accessibility-contrast.d.ts.map

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

@@ -0,0 +1,93 @@
+/**
+ * Agentic QE v3 - Measured colour contrast values (#1228)
+ *
+ * axe-core reports the colours and ratio it measured for each element checked
+ * by its color-contrast rules: in the check data (fgColor, bgColor,
+ * contrastRatio, expectedContrastRatio) and in the failure summary text. These
+ * helpers carry those values through. A value the browser did not report is
+ * null (or a ratio of -1 in ContrastAnalysis), never a default colour or ratio.
+ */
+/** axe-core rule ids that measure text contrast. */
+export const CONTRAST_RULE_IDS = ['color-contrast', 'color-contrast-enhanced'];
+export function isContrastRule(ruleId) {
+    return ruleId.includes('contrast');
+}
+/**
+ * Browser-side expression `(node) => AxeContrastData | undefined` for an axe-core
+ * result node. Embedded in the scripts that run axe-core in the page.
+ */
+export const AXE_CONTRAST_DATA_JS = `function (n) {
+  var checks = [].concat(n.any || [], n.all || [], n.none || []);
+  for (var i = 0; i < checks.length; i++) {
+    var c = checks[i];
+    if ((c.id === 'color-contrast' || c.id === 'color-contrast-enhanced') && c.data) {
+      return {
+        fgColor: c.data.fgColor,
+        bgColor: c.data.bgColor,
+        contrastRatio: c.data.contrastRatio,
+        expectedContrastRatio: c.data.expectedContrastRatio
+      };
+    }
+  }
+  return undefined;
+}`;
+const COLOR = '(#[0-9a-f]{3,8}|rgba?\\([^)]*\\))';
+/**
+ * Read the values from axe-core's failure summary, e.g. "Element has insufficient
+ * color contrast of 2.32 (foreground color: #aaaaaa, background color: #ffffff,
+ * ...). Expected contrast ratio of 4.5:1".
+ */
+export function parseContrastFailureSummary(summary) {
+    const text = summary ?? '';
+    const ratio = text.match(/contrast (?:ratio )?of\s*(\d+(?:\.\d+)?)(?![\d.]|\s*:)/i);
+    const fg = text.match(new RegExp(`foreground colou?r:?\\s*${COLOR}`, 'i'));
+    const bg = text.match(new RegExp(`background colou?r:?\\s*${COLOR}`, 'i'));
+    const expected = text.match(/expected contrast ratio of\s*(\d+(?:\.\d+)?)\s*:\s*1/i);
+    return {
+        foreground: fg?.[1] ?? null,
+        background: bg?.[1] ?? null,
+        ratio: validRatio(ratio ? parseFloat(ratio[1]) : undefined),
+        requiredRatio: validRatio(expected ? parseFloat(expected[1]) : undefined),
+    };
+}
+/** Values from axe-core's check data, with gaps filled from the failure summary. */
+export function contrastValues(data, failureSummary) {
+    const parsed = parseContrastFailureSummary(failureSummary);
+    const expected = data?.expectedContrastRatio?.match(/(\d+(?:\.\d+)?)/);
+    return {
+        foreground: nonEmpty(data?.fgColor) ?? parsed.foreground,
+        background: nonEmpty(data?.bgColor) ?? parsed.background,
+        ratio: validRatio(data?.contrastRatio) ?? parsed.ratio,
+        requiredRatio: validRatio(expected ? parseFloat(expected[1]) : undefined) ?? parsed.requiredRatio,
+    };
+}
+export function contrastValuesMeasured(values) {
+    return values.foreground !== null && values.background !== null && values.ratio !== null;
+}
+/** The ratio WCAG requires for normal text at a level, when axe-core did not say. */
+export function defaultRequiredRatio(level) {
+    return level === 'AAA' ? 7 : 4.5;
+}
+/** One element's contrast result; unreported values stay unmeasured. */
+export function toContrastAnalysis(element, values, passes, wcagLevel) {
+    const measured = contrastValuesMeasured(values);
+    return {
+        element,
+        foreground: values.foreground,
+        background: values.background,
+        ratio: values.ratio ?? -1,
+        requiredRatio: values.requiredRatio ?? defaultRequiredRatio(wcagLevel),
+        passes,
+        wcagLevel,
+        measured,
+        ...(measured ? {} : { notMeasuredReason: 'the browser did not report the colours and ratio for this element' }),
+    };
+}
+function validRatio(value) {
+    // A contrast ratio is between 1 and 21; axe-core reports 0 when it could not compute one.
+    return typeof value === 'number' && Number.isFinite(value) && value >= 1 ? value : null;
+}
+function nonEmpty(value) {
+    return typeof value === 'string' && value.trim() !== '' ? value : null;
+}
+//# sourceMappingURL=accessibility-contrast.js.map

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

@@ -6,6 +6,7 @@ import { Result } from '../../../shared/types/index.js';
 import { AccessibilityReport, WCAGCriterion, ContrastAnalysis, KeyboardNavigationReport, KeyboardIssue, AuditOptions } from '../interfaces.js';
 import type { VibiumClient, AccessibilityResult as VibiumAccessibilityResult } from '../../../integrations/vibium/index.js';
 import type { IBrowserClient, IAgentBrowserClient } from '../../../integrations/browser/index.js';
+import { type AxeContrastData } from './accessibility-contrast.js';
 /**
  * Axe-core result structure from browser evaluation
  */
@@ -22,6 +23,8 @@ export interface AxeCoreResult {
             html: string;
             target: string[];
             failureSummary?: string;
+            /** color-contrast check data: the measured colours and ratio (#1228) */
+            contrast?: AxeContrastData;
         }>;
     }>;
     passes: string[];
@@ -38,13 +41,18 @@ export declare function isAgentBrowserClient(client: IBrowserClient): client is
  */
 export declare function getAxeTagsForWcagLevel(level: 'A' | 'AA' | 'AAA'): string[];
 /**
- * Map Vibium Severity type to our impact type
+ * Map an axe-core impact or a Vibium severity to our impact type
  */
 export declare function mapImpactSeverity(severity: string): 'critical' | 'serious' | 'moderate' | 'minor';
 /**
  * Extract error message from a Result
  */
 export declare function getErrorMessage<T, E extends Error>(result: Result<T, E>): string;
+/**
+ * Browser-side statements that load axe-core into the page when it is not
+ * loaded yet. For use inside an async function.
+ */
+export declare const AXE_LOADER_JS = "\n      // Check if axe is already loaded\n      if (typeof axe === 'undefined') {\n        // Inject axe-core from CDN\n        const script = document.createElement('script');\n        script.src = 'https://cdnjs.cloudflare.com/ajax/libs/axe-core/4.8.4/axe.min.js';\n        script.crossOrigin = 'anonymous';\n        document.head.appendChild(script);\n\n        // Wait for script to load\n        await new Promise((resolve, reject) => {\n          script.onload = resolve;\n          script.onerror = () => reject(new Error('Failed to load axe-core'));\n          setTimeout(() => reject(new Error('Timeout loading axe-core')), 10000);\n        });\n      }";
 /**
  * Inject and run axe-core in the browser context
  */
@@ -62,9 +70,11 @@ export declare function mapAxeResultToReport(url: string, axeResult: AxeCoreResu
  */
 export declare function mapVibiumResultToReport(url: string, vibiumResult: VibiumAccessibilityResult, wcagLevel: 'A' | 'AA' | 'AAA'): AccessibilityReport;
 /**
- * Extract contrast analysis from Vibium accessibility result
+ * Extract contrast analysis from Vibium accessibility result.
+ * Only elements the audit reported are listed, with the values it reported
+ * (#1228). An error means the contrast rule produced no result.
  */
-export declare function extractContrastFromVibiumResult(vibiumResult: VibiumAccessibilityResult, defaultWCAGLevel: 'A' | 'AA' | 'AAA'): ContrastAnalysis[];
+export declare function extractContrastFromVibiumResult(vibiumResult: VibiumAccessibilityResult, defaultWCAGLevel: 'A' | 'AA' | 'AAA'): Result<ContrastAnalysis[], Error>;
 /**
  * Run accessibility audit using unified browser client (agent-browser or other)
  */
@@ -100,6 +110,11 @@ export declare function checkKeyboardWithVibium(vibiumClient: VibiumClient, url:
     headless: boolean;
     timeout: number;
 }): Promise<Result<KeyboardNavigationReport, Error>>;
+/**
+ * What an automated keyboard check does not measure (#1228): it lists the
+ * focusable elements and runs rule checks, but tabs through nothing.
+ */
+export declare const KEYBOARD_NOT_MEASURED: readonly string[];
 /**
  * Get element type from tag name
  */

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

@@ -6,6 +6,7 @@ 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';
+import { AXE_CONTRAST_DATA_JS, contrastValues, isContrastRule, toContrastAnalysis, } from './accessibility-contrast.js';
 /**
  * WCAG 2.2 criteria definitions (shared reference)
  */
@@ -51,11 +52,16 @@ export function getAxeTagsForWcagLevel(level) {
     return [...aaTags, 'wcag2aaa', 'wcag21aaa', 'wcag22aaa'];
 }
 /**
- * Map Vibium Severity type to our impact type
+ * Map an axe-core impact or a Vibium severity to our impact type
  */
 export function mapImpactSeverity(severity) {
     const severityMap = {
+        // axe-core impacts (#1270)
         critical: 'critical',
+        serious: 'serious',
+        moderate: 'moderate',
+        minor: 'minor',
+        // Vibium severities
         high: 'serious',
         medium: 'moderate',
         low: 'minor',
@@ -76,13 +82,10 @@ export function getErrorMessage(result) {
 // Axe-Core Injection & Execution
 // ============================================================================
 /**
- * Inject and run axe-core in the browser context
+ * Browser-side statements that load axe-core into the page when it is not
+ * loaded yet. For use inside an async function.
  */
-export async function runAxeCore(client, wcagLevel, options) {
-    const tags = getAxeTagsForWcagLevel(wcagLevel);
-    const excludeSelectors = options?.excludeSelectors ?? [];
-    const axeScript = `
-    (async function() {
+export const AXE_LOADER_JS = `
       // Check if axe is already loaded
       if (typeof axe === 'undefined') {
         // Inject axe-core from CDN
@@ -97,7 +100,16 @@ export async function runAxeCore(client, wcagLevel, options) {
           script.onerror = () => reject(new Error('Failed to load axe-core'));
           setTimeout(() => reject(new Error('Timeout loading axe-core')), 10000);
         });
-      }
+      }`;
+/**
+ * Inject and run axe-core in the browser context
+ */
+export async function runAxeCore(client, wcagLevel, options) {
+    const tags = getAxeTagsForWcagLevel(wcagLevel);
+    const excludeSelectors = options?.excludeSelectors ?? [];
+    const axeScript = `
+    (async function() {
+      ${AXE_LOADER_JS}
 
       // Configure and run axe
       const config = {
@@ -122,7 +134,8 @@ export async function runAxeCore(client, wcagLevel, options) {
             selector: n.target.join(' > '),
             html: n.html,
             target: n.target,
-            failureSummary: n.failureSummary
+            failureSummary: n.failureSummary,
+            contrast: (${AXE_CONTRAST_DATA_JS})(n)
           }))
         })),
         passes: results.passes.map(p => p.id),
@@ -188,6 +201,8 @@ export function mapAxeResultToReport(url, axeResult, wcagLevel) {
             html: n.html,
             target: n.target,
             failureSummary: n.failureSummary ?? '',
+            // #1228: keep the colours and ratio axe-core measured
+            ...(isContrastRule(v.id) ? { contrast: contrastValues(n.contrast, n.failureSummary) } : {}),
         })),
     }));
     const passes = axeResult.passes.map(ruleId => ({
@@ -271,42 +286,24 @@ export function mapVibiumResultToReport(url, vibiumResult, wcagLevel) {
     };
 }
 /**
- * Extract contrast analysis from Vibium accessibility result
+ * Extract contrast analysis from Vibium accessibility result.
+ * Only elements the audit reported are listed, with the values it reported
+ * (#1228). An error means the contrast rule produced no result.
  */
 export function extractContrastFromVibiumResult(vibiumResult, defaultWCAGLevel) {
     const analyses = [];
     for (const violation of vibiumResult.violations) {
-        if (violation.rule.includes('contrast') || violation.id.includes('contrast')) {
+        if (isContrastRule(violation.rule) || isContrastRule(violation.id)) {
             for (const node of violation.nodes) {
-                const colorMatch = node.failureSummary.match(/foreground:?\s*([#\w\d]+).*?background:?\s*([#\w\d]+)/i);
-                const ratioMatch = node.failureSummary.match(/ratio\s*[:\s]*(\d+\.?\d*)/i);
-                analyses.push({
-                    element: node.selector,
-                    foreground: colorMatch?.[1] || '#000000',
-                    background: colorMatch?.[2] || '#ffffff',
-                    ratio: ratioMatch ? parseFloat(ratioMatch[1]) : 1.0,
-                    requiredRatio: defaultWCAGLevel === 'AAA' ? 7 : 4.5,
-                    passes: false,
-                    wcagLevel: defaultWCAGLevel,
-                });
+                analyses.push(toContrastAnalysis(node.selector, contrastValues(undefined, node.failureSummary), false, defaultWCAGLevel));
             }
         }
     }
-    if (analyses.length === 0 && vibiumResult.passedRules.some(r => r.includes('contrast'))) {
-        const commonElements = ['h1', 'p', 'a', 'button'];
-        for (const element of commonElements) {
-            analyses.push({
-                element,
-                foreground: '#333333',
-                background: '#ffffff',
-                ratio: 12.63,
-                requiredRatio: defaultWCAGLevel === 'AAA' ? 7 : 4.5,
-                passes: true,
-                wcagLevel: defaultWCAGLevel,
-            });
-        }
+    if (analyses.length === 0 && !vibiumResult.passedRules.some(isContrastRule)) {
+        return err(new Error('the contrast rule reported neither a violation nor a pass'));
     }
-    return analyses;
+    // A passing rule is reported without its elements, so no element is listed for it.
+    return ok(analyses);
 }
 // ============================================================================
 // Browser Audit Methods
@@ -454,8 +451,7 @@ export async function checkContrastWithVibium(vibiumClient, url, defaultWCAGLeve
             if (!a11yResult.success) {
                 return err(new Error(`Contrast check failed: ${getErrorMessage(a11yResult)}`));
             }
-            const analyses = extractContrastFromVibiumResult(a11yResult.value, defaultWCAGLevel);
-            return ok(analyses);
+            return extractContrastFromVibiumResult(a11yResult.value, defaultWCAGLevel);
         }
         finally {
             await vibiumClient.quit();
@@ -497,7 +493,8 @@ export async function checkKeyboardWithVibium(vibiumClient, url, defaultWCAGLeve
                 index,
                 selector: elem.selector,
                 elementType: getElementType(elem.tagName),
-                hasVisibleFocus: true,
+                // #1228: the focus indicator is not checked, so it is not reported as visible
+                hasVisibleFocus: null,
             }));
             const a11yResult = await vibiumClient.checkAccessibility({
                 wcagLevel: defaultWCAGLevel,
@@ -507,6 +504,10 @@ export async function checkKeyboardWithVibium(vibiumClient, url, defaultWCAGLeve
             });
             const issues = [];
             const traps = [];
+            const notMeasured = [...KEYBOARD_NOT_MEASURED];
+            if (!a11yResult.success) {
+                notMeasured.push(`keyboard rule checks (${getErrorMessage(a11yResult)})`);
+            }
             if (a11yResult.success) {
                 for (const violation of a11yResult.value.violations) {
                     if (violation.rule.includes('focus') || violation.rule.includes('keyboard')) {
@@ -535,6 +536,7 @@ export async function checkKeyboardWithVibium(vibiumClient, url, defaultWCAGLeve
                 tabOrder,
                 issues,
                 traps,
+                notMeasured,
             };
             return ok(report);
         }
@@ -549,6 +551,14 @@ export async function checkKeyboardWithVibium(vibiumClient, url, defaultWCAGLeve
 // ============================================================================
 // Keyboard Helpers
 // ============================================================================
+/**
+ * What an automated keyboard check does not measure (#1228): it lists the
+ * focusable elements and runs rule checks, but tabs through nothing.
+ */
+export const KEYBOARD_NOT_MEASURED = [
+    'visible focus indicator (hasVisibleFocus is null)',
+    'focus traps (no element was tabbed through)',
+];
 /**
  * Get element type from tag name
  */
@@ -572,7 +582,7 @@ export function mapKeyboardIssueType(rule) {
     if (rule.includes('skip') || rule.includes('bypass')) {
         return 'skip-link-missing';
     }
-    if (rule.includes('order') || rule.includes('sequence')) {
+    if (rule.includes('order') || rule.includes('sequence') || rule.includes('tabindex')) {
         return 'incorrect-tab-order';
     }
     return 'non-interactive-focusable';

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

@@ -0,0 +1,27 @@
+/**
+ * Agentic QE v3 - Contrast and keyboard checks through the unified browser client (#1228)
+ *
+ * The page audit runs through agent-browser (the default browser for audits);
+ * these checks use the same client, so they are measured whenever the audit is.
+ * Each runs axe-core in the loaded page and reports only what it returned.
+ */
+import { Result } from '../../../shared/types/index.js';
+import type { IBrowserClient } from '../../../integrations/browser/index.js';
+import type { ContrastAnalysis, KeyboardNavigationReport } from '../interfaces.js';
+type WcagLevel = 'A' | 'AA' | 'AAA';
+type BrowserConfig = {
+    headless: boolean;
+    timeout: number;
+};
+/**
+ * Check colour contrast with axe-core's contrast rule. Lists every element the
+ * rule checked, failing and passing, with the colours and ratio it measured.
+ */
+export declare function checkContrastWithBrowserClient(client: IBrowserClient, url: string, wcagLevel: WcagLevel, browserConfig: BrowserConfig): Promise<Result<ContrastAnalysis[], Error>>;
+/**
+ * Check keyboard navigation: the focusable elements in document order and
+ * axe-core's keyboard rules. Focus indicators and traps are not measured.
+ */
+export declare function checkKeyboardWithBrowserClient(client: IBrowserClient, url: string, browserConfig: BrowserConfig): Promise<Result<KeyboardNavigationReport, Error>>;
+export {};
+//# sourceMappingURL=accessibility-tester-checks.d.ts.map