wcag-a11y 0.3.5 → 0.3.6

package/README.md

@@ -158,11 +158,15 @@ wcag-a11y fix -u http://localhost:3000 --apply
 
 # Auto-discover pages + write fixes
 wcag-a11y fix -u http://localhost:3000 --crawl --apply
+
+# Skip rescanning — load violations from an existing report
+wcag-a11y fix --from-report
+wcag-a11y fix --from-report ./reports/a11y-report.md --apply
 ```
 
 **How it works:**
 
-1. Runs the same scan as `wcag-a11y scan`
+1. Runs the same scan as `wcag-a11y scan` (or loads an existing report with `--from-report`)
 2. For each violation, locates the source file — checks `violation.source` (React dev mode) first, then falls back to grepping `./src` for unique identifiers in the HTML snippet (`id=`, `name=`, `for=`, local `src=`, text content)
 3. Groups violations by file (multiple violations in the same file → one AI call)
 4. Sends the full file content + violation list to your configured AI provider and asks for the corrected file
@@ -186,14 +190,22 @@ src/components/Navbar.jsx — 2 violation(s)
 
 | Flag | Default | Description |
 |---|---|---|
-| `-u, --url <url>` | required | Base URL of your running dev server |
+| `-u, --url <url>` | — | Base URL of your running dev server. Required unless `--from-report` is used |
 | `-p, --pages <pages...>` | `/` | Specific pages to scan |
 | `-c, --crawl` | off | Auto-discover pages by following same-origin links |
+| `--from-report [path]` | `a11y-report.md` | Load violations from an existing report instead of scanning. Useful when you already ran `scan --report` and just want to apply fixes |
 | `--apply` | off | Write patched files to disk (dry-run without this flag) |
 | `--provider <name>` | from config | Override AI provider for this run: `gemini`, `openai`, or `ollama` |
 
 > **Tip:** Always run without `--apply` first to review the diff. The dry-run is safe — nothing is written to disk.
 
+**Common workflow:** run `scan --report` to generate a report for review, then run `fix --from-report --apply` to patch the files — no second browser crawl needed.
+
+```bash
+wcag-a11y scan -u http://localhost:3000 --report   # review a11y-report.md
+wcag-a11y fix --from-report --apply                 # patch files from that report
+```
+
 ---
 
 ## AI Providers

package/dist/cli.js

@@ -13,7 +13,7 @@ const program = new Command();
 program
     .name('wcag-a11y')
     .description('WCAG 2.1/2.2 accessibility auditor with AI-powered fixes')
-    .version('0.3.5');
+    .version('0.3.6');
 program
     .command('init')
     .description('Create a11y.config.json in the current directory')
@@ -77,21 +77,30 @@ program
 program
     .command('fix')
     .description('Scan for violations and apply AI fixes directly to source files')
-    .requiredOption('-u, --url <url>', 'Base URL of your dev server (e.g. http://localhost:3000)')
+    .option('-u, --url <url>', 'Base URL of your dev server (e.g. http://localhost:3000)')
     .option('-p, --pages <pages...>', 'Specific pages to scan', ['/'])
     .option('-c, --crawl', 'Auto-discover pages by following same-origin links', false)
+    .option('--from-report [path]', 'Use an existing report instead of scanning (default: a11y-report.md)')
     .option('--apply', 'Write fixes to source files (default: dry-run, shows diff only)', false)
     .option('--provider <name>', 'Override the AI provider from config (gemini|openai|ollama)')
     .action(async (opts) => {
+    if (!opts.url && !opts.fromReport) {
+        console.error('\nError: provide --url <url> to scan, or --from-report [path] to load an existing report.');
+        process.exit(1);
+    }
     try {
         const config = loadConfig();
         if (opts.provider)
             config.provider = opts.provider;
         const provider = createAIProvider(config);
+        const reportPath = opts.fromReport
+            ? (opts.fromReport === true ? 'a11y-report.md' : opts.fromReport)
+            : undefined;
         await runFix({
             url: opts.url,
             pages: opts.pages,
             crawl: opts.crawl,
+            reportPath,
             apply: opts.apply,
             provider,
             srcDir: resolve(process.cwd(), 'src'),

package/dist/fixer.js

@@ -5,15 +5,32 @@ import { crawl } from './crawler.js';
 const SOURCE_EXTS = new Set(['.jsx', '.tsx', '.js', '.ts', '.vue', '.svelte', '.html']);
 const SKIP_DIRS = new Set(['node_modules', 'dist', 'build', '.git', '.next', '.nuxt', 'coverage', 'public']);
 export async function runFix(opts) {
-    console.log(`\nScanning ${opts.url}...`);
-    const result = await crawl({ url: opts.url, pages: opts.pages, crawl: opts.crawl });
-    const { framework } = result;
-    if (result.totalViolations === 0) {
-        console.log(chalk.green('\nNo violations found.'));
-        return;
+    let allViolations;
+    let framework;
+    if (opts.reportPath) {
+        const absReport = resolve(process.cwd(), opts.reportPath);
+        if (!existsSync(absReport)) {
+            throw new Error(`Report file not found: ${opts.reportPath}`);
+        }
+        console.log(`\nLoading violations from ${opts.reportPath}...`);
+        allViolations = parseReportViolations(absReport);
+        if (allViolations.length === 0) {
+            console.log(chalk.green('\nNo violations found in report.'));
+            return;
+        }
+        console.log(`Found ${allViolations.length} violation(s) in report. Locating source files...\n`);
+    }
+    else {
+        console.log(`\nScanning ${opts.url}...`);
+        const result = await crawl({ url: opts.url, pages: opts.pages, crawl: opts.crawl });
+        framework = result.framework;
+        if (result.totalViolations === 0) {
+            console.log(chalk.green('\nNo violations found.'));
+            return;
+        }
+        console.log(`Found ${result.totalViolations} violation(s). Locating source files...\n`);
+        allViolations = result.pages.flatMap((p) => p.violations);
     }
-    console.log(`Found ${result.totalViolations} violation(s). Locating source files...\n`);
-    const allViolations = result.pages.flatMap((p) => p.violations);
     // Group violations by resolved source file path
     const fileGroups = new Map();
     let unlocated = 0;
@@ -97,6 +114,57 @@ export async function runFix(opts) {
         console.log(chalk.yellow(`${unlocated} violation(s) could not be located in source files.`));
     }
 }
+function parseReportViolations(reportPath) {
+    const content = readFileSync(reportPath, 'utf8');
+    const violations = [];
+    const pageParts = content.split(/^## Page:/m).slice(1);
+    for (const part of pageParts) {
+        const pageUrl = part.split('\n')[0].trim();
+        if (part.includes('✅ No violations found'))
+            continue;
+        for (const group of part.split(/^---$/m)) {
+            const headingMatch = group.match(/^###\s+\S+\s+\[(\w+)\]\s+(.+)$/m);
+            if (!headingMatch)
+                continue;
+            const impact = headingMatch[1].toLowerCase();
+            const description = headingMatch[2].trim();
+            const ruleMatch = group.match(/\*\*Rule:\*\*\s+`([^`]+)`/);
+            if (!ruleMatch)
+                continue;
+            const ruleId = ruleMatch[1];
+            let wcag = '';
+            let level = 'A';
+            const wcagStd = group.match(/\*\*WCAG:\*\*\s+SC\s+([\d.]+)\s+\(Level\s+([A-Z]+)\)/);
+            if (wcagStd) {
+                wcag = wcagStd[1];
+                level = wcagStd[2];
+            }
+            else {
+                const wcagAI = group.match(/\*\*WCAG:\*\*\s+WCAG\s+[\d.]+\s+SC\s+([\d.]+)/);
+                if (wcagAI)
+                    wcag = wcagAI[1];
+            }
+            const repMatch = group.match(/\*\*Representative element:\*\*\s*\n`([^`]+)`(?:\s+—\s+`([^`]+)`)?/);
+            if (!repMatch)
+                continue;
+            const selector = repMatch[1];
+            const source = repMatch[2];
+            const htmlMatch = group.match(/\*\*Representative element:\*\*[\s\S]*?```html\n([\s\S]*?)\n```/);
+            const html = htmlMatch?.[1] ?? '';
+            violations.push({ ruleId, wcag, level, impact, description, selector, html, page: pageUrl, ...(source ? { source } : {}) });
+            const alsoSection = group.match(/\*\*Also affects[^*]*\*\*([\s\S]*?)(?:\n\n\*\*|\n---|\n```|$)/);
+            if (alsoSection) {
+                for (const line of alsoSection[1].split('\n')) {
+                    const m = line.match(/^-\s+`([^`]+)`(?:\s+—\s+`([^`]+)`)?/);
+                    if (!m)
+                        continue;
+                    violations.push({ ruleId, wcag, level, impact, description, selector: m[1], html: '', page: pageUrl, ...(m[2] ? { source: m[2] } : {}) });
+                }
+            }
+        }
+    }
+    return violations;
+}
 export function findSourceFile(violation, srcDir) {
     // Priority 1: React dev-mode source annotation
     if (violation.source) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wcag-a11y",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "WCAG 2.1/2.2 accessibility auditor with AI-powered fixes",
   "type": "module",
   "bin": {