@diegovelasquezweb/a11y-engine 0.11.20 → 0.11.22

package/package.json

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

package/src/fixes/apply-finding-fix.mjs

@@ -249,8 +249,10 @@ async function callClaudeForPatch({ apiKey, model, aiInput }) {
   const system = [
     "You are an accessibility fix engine.",
     "Return JSON only.",
-    "Generate deterministic text replacements for provided files.",
+    "Generate text replacements that fix the accessibility issue described in the finding.",
     "Do not create files. Do not modify paths outside provided filePath values.",
+    "CRITICAL: The 'replace' value MUST differ from the 'search' value — never return a no-op change.",
+    "CRITICAL: For missing attributes (e.g. alt, aria-label), you MUST add them with a descriptive value derived from context (filename, surrounding text, or role). Use empty string alt=\"\" only for purely decorative images.",
     "Schema:",
     "{\"changes\":[{\"filePath\":\"...\",\"search\":\"...\",\"replace\":\"...\"}],\"verifyRule\":\"...\",\"verifyRoute\":\"...\",\"notes\":\"...\"}",
   ].join("\n");
@@ -301,6 +303,7 @@ function validateAiPatchOutput(output, projectDir, fileSet) {
     const replace = typeof change.replace === "string" ? change.replace : "";
     if (!filePath || !search) return { ok: false, reason: "Change is missing filePath/search" };
     if (!fileSet.has(filePath)) return { ok: false, reason: `Change file not in candidate set: ${filePath}` };
+    if (search === replace) return { ok: false, reason: `AI generated a no-op patch for ${filePath} — search and replace are identical` };
 
     const abs = path.resolve(projectDir, filePath);
     if (!isWithin(projectDir, abs) && abs !== path.resolve(projectDir, filePath)) {