@diegovelasquezweb/a11y-engine 0.11.36 → 0.11.38

package/package.json

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

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

@@ -150,7 +150,7 @@ function getPatternCandidateFile(projectDir, finding) {
   return { abs, rel: finding.file, content };
 }
 
-function buildPatternAiInput({ finding, candidate }) {
+function buildPatternAiInput({ finding, candidate, projectHints }) {
   // Extract the exact line(s) containing the pattern match so Claude has an
   // unambiguous search anchor instead of inferring it from the full file.
   const fileLines = candidate.content.split("\n");
@@ -181,6 +181,7 @@ function buildPatternAiInput({ finding, candidate }) {
       fixCode: finding.fix_code || "",
     },
     files: [{ filePath: candidate.rel, content: candidate.content.slice(0, 12000) }],
+    ...(projectHints ? { projectContext: projectHints } : {}),
   };
 }
 
@@ -385,7 +386,28 @@ function parseJsonBlock(text) {
   }
 }
 
-async function callClaudeForPatch({ apiKey, model, aiInput }) {
+function extractRemediationContext(remediationPath) {
+  if (!remediationPath || !fs.existsSync(remediationPath)) return null;
+  try {
+    const content = fs.readFileSync(remediationPath, "utf8");
+    const sections = [];
+    const guardrailsMatch = content.match(/## Agent Operating Procedures \(Guardrails\)([\s\S]*?)(?=\n---|\n##|$)/);
+    if (guardrailsMatch) {
+      sections.push("## Project Guardrails (from audit)\n" + guardrailsMatch[1].trim());
+    }
+    const sourceMatch = content.match(/## Source File Locations([\s\S]*?)(?=\n---|\n##|$)/);
+    if (sourceMatch) {
+      sections.push("## Source File Locations (from audit)\n" + sourceMatch[1].trim());
+    }
+    return sections.length > 0 ? sections.join("\n\n") : null;
+  } catch {
+    return null;
+  }
+}
+
+async function callClaudeForPatch({ apiKey, model, aiInput, remediationPath }) {
+  const remediationContext = extractRemediationContext(remediationPath);
+
   const system = [
     "You are an accessibility fix engine.",
     "Return JSON only — no markdown fences, no extra text.",
@@ -397,6 +419,7 @@ async function callClaudeForPatch({ apiKey, model, aiInput }) {
     "For insertions (new element not yet in the file), anchor the search on the nearest existing surrounding element and include it in both search and replace.",
     "Do not create new files. Only write changes for filePaths listed in the files array.",
     "CSS files are never in the files array. Fix visual issues (touch targets, sizing) using inline style attributes or markup changes in the HTML file — never reference or create .css files.",
+    ...(remediationContext ? ["", "## Project Context (from audit report)", remediationContext] : []),
     "Schema:",
     "{\"changes\":[{\"filePath\":\"...\",\"search\":\"...\",\"replace\":\"...\"}],\"verifyRule\":\"...\",\"verifyRoute\":\"...\",\"notes\":\"...\"}",
   ].join("\n");
@@ -521,6 +544,7 @@ export async function applyFindingFix(input) {
   const findingId = typeof input.findingId === "string" ? input.findingId.trim() : "";
   const projectDir = typeof input.projectDir === "string" ? input.projectDir.trim() : "";
   const projectHints = typeof input.projectHints === "string" ? input.projectHints.trim() : "";
+  const remediationPath = typeof input.remediationPath === "string" ? input.remediationPath.trim() : (process.env.REMEDIATION_PATH || "");
 
   if (!findingId || !projectDir) {
     return buildResult({
@@ -573,14 +597,14 @@ export async function applyFindingFix(input) {
       });
     }
 
-    const aiInput = buildPatternAiInput({ finding, candidate });
+    const aiInput = buildPatternAiInput({ finding, candidate, projectHints });
     const candidateSet = new Set([candidate.rel]);
 
     let patchOutput = null;
     let claudeUsage = { input_tokens: 0, output_tokens: 0 };
     if (apiKey) {
       try {
-        const { patch, usage } = await callClaudeForPatch({ apiKey, model, aiInput });
+        const { patch, usage } = await callClaudeForPatch({ apiKey, model, aiInput, remediationPath });
         patchOutput = patch;
         claudeUsage = usage;
       } catch {
@@ -781,6 +805,7 @@ export async function applyFindingsFix(input) {
     : [];
   const projectDir = typeof input.projectDir === "string" ? input.projectDir.trim() : "";
   const projectHints = typeof input.projectHints === "string" ? input.projectHints.trim() : "";
+  const remediationPath = typeof input.remediationPath === "string" ? input.remediationPath.trim() : (process.env.REMEDIATION_PATH || "");
   const apiKey = input.ai?.apiKey || process.env.ANTHROPIC_API_KEY || "";
   const model = input.ai?.model || DEFAULT_MODEL;
 
@@ -889,7 +914,7 @@ export async function applyFindingsFix(input) {
     let claudeUsage = { input_tokens: 0, output_tokens: 0 };
     if (apiKey) {
       try {
-        const { patch, usage } = await callClaudeForPatch({ apiKey, model, aiInput });
+        const { patch, usage } = await callClaudeForPatch({ apiKey, model, aiInput, remediationPath });
         patchOutput = patch;
         claudeUsage = usage;
       } catch {