@diegovelasquezweb/a11y-engine 0.7.3 → 0.7.5

package/package.json

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

package/src/ai/enrich.mjs

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+/**
+ * @file enrich.mjs
+ * @description CLI script that reads a11y-findings.json, enriches Critical/Serious
+ * findings using the Claude AI module, and writes the result back.
+ * Runs as a child process from audit.mjs after the analyzer step.
+ */
+
+import { fileURLToPath } from "node:url";
+import { log, getInternalPath, writeJson } from "../core/utils.mjs";
+import { enrichWithAI } from "./claude.mjs";
+
+async function main() {
+  const apiKey = process.env.ANTHROPIC_API_KEY;
+  if (!apiKey) {
+    log.warn("No ANTHROPIC_API_KEY found — skipping AI enrichment.");
+    process.exit(0);
+  }
+
+  const findingsPath = getInternalPath("a11y-findings.json");
+
+  let payload;
+  try {
+    const { readFileSync } = await import("node:fs");
+    payload = JSON.parse(readFileSync(findingsPath, "utf-8"));
+  } catch (err) {
+    log.warn(`Could not read findings file — skipping AI enrichment: ${err.message}`);
+    process.exit(0);
+  }
+
+  const findings = payload.findings ?? [];
+  if (findings.length === 0) {
+    log.info("No findings to enrich.");
+    process.exit(0);
+  }
+
+  const stack = payload.metadata?.projectContext ?? {};
+  const repoUrl = process.env.A11Y_REPO_URL || payload.metadata?.repoUrl || null;
+  const githubToken = process.env.GH_TOKEN || undefined;
+
+  log.info(`AI enrichment: processing up to 20 Critical/Serious findings...`);
+
+  const enriched = await enrichWithAI(findings, { stack, repoUrl }, {
+    enabled: true,
+    apiKey,
+    githubToken,
+  });
+
+  writeJson(findingsPath, { ...payload, findings: enriched });
+
+  const improved = enriched.filter((f, i) =>
+    f.fixDescription !== findings[i]?.fixDescription ||
+    f.fixCode !== findings[i]?.fixCode
+  ).length;
+
+  log.success(`AI enrichment complete. ${improved} finding(s) improved.`);
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  main().catch((err) => {
+    log.warn(`AI enrichment failed (non-fatal): ${err.message}`);
+    process.exit(0); // non-fatal — never block the pipeline
+  });
+}

package/src/cli/audit.mjs

@@ -143,6 +143,28 @@ async function main() {
   const repoUrl = getArgValue("repo-url");
   const githubToken = getArgValue("github-token");
 
+  let remotePackageJson = null;
+  let detectedFramework = null;
+  if (repoUrl) {
+    try {
+      const { fetchPackageJson } = await import("../core/github-api.mjs");
+      remotePackageJson = await fetchPackageJson(repoUrl, githubToken || undefined);
+      if (remotePackageJson) {
+        const { detectProjectContext } = await import("../pipeline/dom-scanner.mjs");
+        const ctx = detectProjectContext(null, remotePackageJson);
+        if (ctx.framework) {
+          detectedFramework = ctx.framework;
+          log.info(`Detected framework from repository: ${ctx.framework}`);
+        }
+        if (ctx.uiLibraries.length) {
+          log.info(`Detected UI libraries: ${ctx.uiLibraries.join(", ")}`);
+        }
+      }
+    } catch (err) {
+      log.warn(`Could not fetch package.json from repo: ${err.message}`);
+    }
+  }
+
   const sessionFile = getInternalPath("a11y-session.json");
   let projectDir = getArgValue("project-dir");
   if (projectDir) {
@@ -268,9 +290,18 @@ async function main() {
 
     const analyzerArgs = [];
     if (ignoreFindings) analyzerArgs.push("--ignore-findings", ignoreFindings);
-    if (framework) analyzerArgs.push("--framework", framework);
+    const resolvedFramework = framework || detectedFramework;
+    if (resolvedFramework) analyzerArgs.push("--framework", resolvedFramework);
     await runScript("../enrichment/analyzer.mjs", analyzerArgs);
 
+    if (process.env.ANTHROPIC_API_KEY) {
+      await runScript("../ai/enrich.mjs", [], {
+        ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY,
+        ...(repoUrl ? { A11Y_REPO_URL: repoUrl } : {}),
+        ...(githubToken ? { GH_TOKEN: githubToken } : {}),
+      });
+    }
+
     if ((projectDir || repoUrl) && !skipPatterns) {
       const patternArgs = [];
       if (projectDir) {
@@ -279,7 +310,7 @@ async function main() {
         patternArgs.push("--repo-url", repoUrl);
         if (githubToken) patternArgs.push("--github-token", githubToken);
       }
-      let resolvedFramework = framework;
+      let resolvedFramework = framework || detectedFramework;
       if (!resolvedFramework) {
         try {
           const findings = JSON.parse(fs.readFileSync(getInternalPath("a11y-findings.json"), "utf-8"));

package/src/reports/renderers/html.mjs

@@ -107,15 +107,7 @@ export function buildIssueCard(finding) {
       </div>`
     : "";
 
-  const implNotesHtml = finding.fixDifficultyNotes
-    ? `<div class="mt-4 pt-3 border-t border-indigo-100/50">
-        <h4 class="text-[10px] font-black text-amber-700 uppercase tracking-widest mb-2 flex items-center gap-1.5">
-          <svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"></path></svg>
-          Implementation Notes
-        </h4>
-        <p class="text-[12px] text-amber-900/80 leading-relaxed bg-amber-50/60 border border-amber-100/60 rounded-lg p-3">${escapeHtml(finding.fixDifficultyNotes)}</p>
-      </div>`
-    : "";
+  const implNotesHtml = "";
 
   const problemPanelHtml = `
     <div class="grid grid-cols-1 gap-6">