@diegovelasquezweb/a11y-engine 0.11.5 → 0.11.7

package/package.json

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

package/src/enrichment/analyzer.mjs

@@ -608,13 +608,18 @@ function deduplicateFindings(findings) {
     if (group.length === 1) {
       result.push(group[0]);
     } else {
-      const representative = group.reduce((best, f) =>
+      // Confirmed findings (needs_verification=false) always take priority over incomplete ones.
+      // Among confirmed, pick the one with most instances; same for incomplete-only groups.
+      const confirmed = group.filter((f) => !f.needs_verification);
+      const pool = confirmed.length > 0 ? confirmed : group;
+      const representative = pool.reduce((best, f) =>
         (f.total_instances || 1) >= (best.total_instances || 1) ? f : best,
       );
       const affectedUrls = [...new Set(group.map((f) => f.url))];
       const totalInstances = group.reduce((sum, f) => sum + (f.total_instances || 1), 0);
       result.push({
         ...representative,
+        needs_verification: confirmed.length === 0,
         total_instances: totalInstances,
         pages_affected: affectedUrls.length,
         affected_urls: affectedUrls,
@@ -853,11 +858,13 @@ function buildFindings(inputPayload, cliArgs) {
         const fixInfo = ruleInfo.fix || {};
         const resolvedGuardrails = resolveGuardrails(ruleInfo, null);
 
-        let recFix = apgUrl
-          ? `Reference: ${apgUrl}`
-          : v.helpUrl
-            ? `See ${v.helpUrl}`
-            : "Fix the violation.";
+        let recFix = fixInfo.description
+          ? fixInfo.description
+          : apgUrl
+            ? apgUrl
+            : v.helpUrl
+              ? v.helpUrl
+              : null;
 
         const codeLang = detectCodeLang(fixInfo.code);
         const fileSearchPattern = getFileSearchPattern(ctx.framework, codeLang);
@@ -930,7 +937,7 @@ function buildFindings(inputPayload, cliArgs) {
           primary_source_scope: ownership.primarySourceScope,
           search_strategy: ownership.searchStrategy,
           component_hint: extractComponentHint(bestSelector) ?? derivePageHint(route.path),
-          needs_verification: !!v._fromIncomplete,
+          needs_verification: !!v._fromIncomplete || !!v.needs_verification,
           verification_command: `pnpm a11y --base-url ${route.url} --routes ${route.path} --only-rule ${v.id} --max-routes 1`,
           verification_command_fallback: `node scripts/audit.mjs --base-url ${route.url} --routes ${route.path} --only-rule ${v.id} --max-routes 1`,
           pm_summary: ruleInfo.pm?.summary ?? null,