@diegovelasquezweb/a11y-engine 0.6.6 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegovelasquezweb/a11y-engine",
-  "version": "0.6.6",
+  "version": "0.7.1",
   "description": "WCAG 2.2 accessibility audit engine — scanner, analyzer, and report builders",
   "type": "module",
   "license": "MIT",

package/src/enrichment/analyzer.mjs

@@ -744,6 +744,14 @@ function computeTestingMethodology(payload) {
   const routes = payload.routes || [];
   const scanned = routes.filter((r) => !r.error).length;
   const errored = routes.filter((r) => r.error).length;
+  const tags = payload.axeTags || [];
+  const conformanceLevel = tags.includes("wcag2aaa")
+    ? "AAA"
+    : tags.includes("wcag2aa") || tags.includes("wcag21aa") || tags.includes("wcag22aa")
+      ? "AA"
+      : tags.includes("wcag2a") || tags.includes("wcag21a") || tags.includes("wcag22a")
+        ? "A"
+        : null;
   return {
     automated_tools: [
       "axe-core (via @axe-core/playwright)",
@@ -752,6 +760,9 @@ function computeTestingMethodology(payload) {
       "Playwright + Chromium",
     ],
     compliance_target: "WCAG 2.2",
+    conformance_level: conformanceLevel,
+    best_practices: tags.includes("best-practice"),
+    axe_tags: tags.length > 0 ? tags : null,
     pages_scanned: scanned,
     pages_errored: errored,
     framework_detected: payload.projectContext?.framework || "Not detected",

package/src/index.mjs

@@ -660,14 +660,17 @@ export async function runAudit(options) {
   // Fetch remote package.json via GitHub API if repoUrl is provided
   let remotePackageJson = null;
   if (options.repoUrl && !options.projectDir) {
+    if (onProgress) onProgress("repo", "running");
     try {
       const { fetchPackageJson } = await import("./core/github-api.mjs");
       remotePackageJson = await fetchPackageJson(options.repoUrl, options.githubToken);
       if (remotePackageJson) {
-        console.info("[a11y-engine] Fetched package.json from GitHub repo");
+        if (onProgress) onProgress("repo", "done", { packageJson: true });
+      } else {
+        if (onProgress) onProgress("repo", "skipped", { reason: "Could not read package.json" });
       }
     } catch (err) {
-      console.warn(`[a11y-engine] Could not fetch package.json from repo (non-fatal): ${err.message}`);
+      if (onProgress) onProgress("repo", "skipped", { reason: err.message });
     }
   }
 
@@ -708,6 +711,7 @@ export async function runAudit(options) {
   // Step 3: Source patterns (optional) — works with local projectDir or remote repoUrl
   const hasSourceContext = (options.projectDir || options.repoUrl) && !options.skipPatterns;
   if (hasSourceContext) {
+    if (onProgress) onProgress("patterns", "running");
     try {
       const { patterns } = loadAssetJson(ASSET_PATHS.remediation.codePatterns, "code-patterns.json");
 
@@ -741,21 +745,26 @@ export async function runAudit(options) {
         }
       }
 
+      const confirmed = allPatternFindings.filter((f) => f.status === "confirmed").length;
+      const potential = allPatternFindings.filter((f) => f.status === "potential").length;
+
       if (allPatternFindings.length > 0) {
         findingsPayload.patternFindings = {
           generated_at: new Date().toISOString(),
           project_dir: options.projectDir || options.repoUrl,
           findings: allPatternFindings,
-          summary: {
-            total: allPatternFindings.length,
-            confirmed: allPatternFindings.filter((f) => f.status === "confirmed").length,
-            potential: allPatternFindings.filter((f) => f.status === "potential").length,
-          },
+          summary: { total: allPatternFindings.length, confirmed, potential },
         };
       }
+
+      if (onProgress) onProgress("patterns", "done", {
+        total: allPatternFindings.length,
+        confirmed,
+        potential,
+      });
     } catch (err) {
-      // Non-fatal: source scanning is optional
       const msg = err instanceof Error ? err.message : String(err);
+      if (onProgress) onProgress("patterns", "skipped", { reason: msg });
       console.warn(`Source pattern scan failed (non-fatal): ${msg}`);
     }
   }
@@ -765,6 +774,9 @@ export async function runAudit(options) {
   // Step 4: AI enrichment (optional) — requires ANTHROPIC_API_KEY
   const aiOptions = options.ai || {};
   const aiEnabled = aiOptions.enabled !== false && !!aiOptions.apiKey;
+  if (!aiEnabled && onProgress && options.ai !== undefined) {
+    onProgress("ai", "skipped", { reason: "No API key configured" });
+  }
   if (aiEnabled) {
     try {
       if (onProgress) onProgress("ai", "running");

package/src/pipeline/dom-scanner.mjs

@@ -1184,6 +1184,10 @@ async function _runDomScannerInternal(args) {
 
     writeProgress("page", "running");
 
+    // Track which steps have already emitted "done" so multi-route scans
+    // don't reset progress back to "running" for routes after the first.
+    const emittedDone = new Set();
+
     for (let i = 0; i < routes.length; i += tabPages.length) {
       const batch = [];
       for (let j = 0; j < tabPages.length && i + j < routes.length; j++) {
@@ -1195,7 +1199,10 @@ async function _runDomScannerInternal(args) {
             log.info(`[${idx + 1}/${total}] Scanning: ${routePath}`);
             const targetUrl = new URL(routePath, baseUrl).toString();
 
-            writeProgress("page", "done");
+            if (!emittedDone.has("page")) {
+              writeProgress("page", "done");
+              emittedDone.add("page");
+            }
 
             let result = { url: targetUrl, violations: [], incomplete: [], passes: [], metadata: {} };
             let cdpViolations = [];
@@ -1203,7 +1210,7 @@ async function _runDomScannerInternal(args) {
 
             // Step 1: axe-core (conditional)
             if (args.engines.axe) {
-              writeProgress("axe", "running");
+              if (!emittedDone.has("axe")) writeProgress("axe", "running");
               result = await analyzeRoute(
                 tabPage,
                 targetUrl,
@@ -1216,7 +1223,10 @@ async function _runDomScannerInternal(args) {
                 args.axeTags,
               );
               const axeViolationCount = result.violations?.length || 0;
-              writeProgress("axe", "done", { found: axeViolationCount });
+              if (!emittedDone.has("axe")) {
+                writeProgress("axe", "done", { found: axeViolationCount });
+                emittedDone.add("axe");
+              }
               log.info(`axe-core: ${axeViolationCount} violation(s) found`);
             } else {
               // Navigate for CDP/pa11y even if axe is off
@@ -1228,9 +1238,12 @@ async function _runDomScannerInternal(args) {
 
             // Step 2: CDP checks (conditional)
             if (args.engines.cdp) {
-              writeProgress("cdp", "running");
+              if (!emittedDone.has("cdp")) writeProgress("cdp", "running");
               cdpViolations = await runCdpChecks(tabPage);
-              writeProgress("cdp", "done", { found: cdpViolations.length });
+              if (!emittedDone.has("cdp")) {
+                writeProgress("cdp", "done", { found: cdpViolations.length });
+                emittedDone.add("cdp");
+              }
               log.info(`CDP checks: ${cdpViolations.length} issue(s) found`);
             } else {
               log.info("CDP checks: skipped (disabled)");
@@ -1238,9 +1251,12 @@ async function _runDomScannerInternal(args) {
 
             // Step 3: pa11y (conditional)
             if (args.engines.pa11y) {
-              writeProgress("pa11y", "running");
+              if (!emittedDone.has("pa11y")) writeProgress("pa11y", "running");
               pa11yViolations = await runPa11yChecks(targetUrl, args.axeTags);
-              writeProgress("pa11y", "done", { found: pa11yViolations.length });
+              if (!emittedDone.has("pa11y")) {
+                writeProgress("pa11y", "done", { found: pa11yViolations.length });
+                emittedDone.add("pa11y");
+              }
               log.info(`pa11y: ${pa11yViolations.length} issue(s) found`);
             } else {
               log.info("pa11y: skipped (disabled)");
@@ -1248,18 +1264,21 @@ async function _runDomScannerInternal(args) {
 
             // Step 4: Merge results
             const axeViolationCount = result.violations?.length || 0;
-            writeProgress("merge", "running");
+            if (!emittedDone.has("merge")) writeProgress("merge", "running");
             const mergedViolations = mergeViolations(
               result.violations || [],
               cdpViolations,
               pa11yViolations,
             );
-            writeProgress("merge", "done", {
-              axe: axeViolationCount,
-              cdp: cdpViolations.length,
-              pa11y: pa11yViolations.length,
-              merged: mergedViolations.length,
-            });
+            if (!emittedDone.has("merge")) {
+              writeProgress("merge", "done", {
+                axe: axeViolationCount,
+                cdp: cdpViolations.length,
+                pa11y: pa11yViolations.length,
+                merged: mergedViolations.length,
+              });
+              emittedDone.add("merge");
+            }
             log.info(`Merged: ${mergedViolations.length} total unique violations (axe: ${axeViolationCount}, cdp: ${cdpViolations.length}, pa11y: ${pa11yViolations.length})`);
 
             // Screenshots for merged violations
@@ -1288,6 +1307,7 @@ async function _runDomScannerInternal(args) {
     base_url: baseUrl,
     onlyRule: args.onlyRule || null,
     engines: args.engines,
+    axeTags: args.axeTags || null,
     projectContext,
     routes: results,
   };