wcag-a11y 0.3.6 → 0.4.1

package/README.md

@@ -2,17 +2,17 @@
 
 [![CI](https://github.com/Dannyplusplus12/WCAG-A11y/actions/workflows/ci.yml/badge.svg)](https://github.com/Dannyplusplus12/WCAG-A11y/actions/workflows/ci.yml)
 
-Most accessibility auditors stop at detection — they tell you *what* is broken and leave the rest to you. `wcag-a11y` goes further. It crawls your running dev server with Playwright, runs 40+ WCAG 2.1/2.2 checks, and uses AI to generate ready-to-paste fix prompts **or write the fixes directly into your source files**.
+Most accessibility auditors stop at detection — they tell you *what* is broken and leave the rest to you. `wcag-a11y` crawls your running dev server with Playwright, runs 40+ WCAG 2.1/2.2 checks, and uses AI to generate ready-to-paste fix prompts **or write the fixes directly into your source files**.
 
 Two modes:
-- **`scan`** — find violations + generate AI prompts you paste into Cursor, Copilot, or Claude
+- **`scan`** — find violations + get AI prompts you paste into Cursor, Copilot, or Claude
 - **`fix`** — find violations + patch source files automatically (dry-run by default, `--apply` to write)
 
 ---
 
 ## Try it instantly
 
-No dev server, no config, no setup:
+No dev server, no config:
 
 ```bash
 npx wcag-a11y demo
@@ -22,41 +22,50 @@ npx wcag-a11y demo
 
 ## What the output looks like
 
-Running a scan prints a violation summary per page, then AI-generated fixes for each rule:
-
 ```
-Scanning http://localhost:3000...
-
-  /
-  ✖  critical   img-alt                  3 violations
-  ✖  serious    color-contrast-text      2 violations
-  ✖  serious    label-missing            1 violation
-  ✖  moderate   no-positive-tabindex     1 violation
-
-  7 violations across 1 page
-
-Generating AI fixes for 7 violations...
-
-────────────────────────────────────────────
-[img-alt] — 3 elements affected
-  #hero-img  #logo  #banner
-
-  Why it matters:
-  Screen readers cannot describe the image to blind users without an alt attribute.
-  Users relying on assistive technology receive no information about the image content.
-
-  Fixed HTML:
-  <img src="banner.jpg" alt="Summer sale — up to 50% off">
-
-  Prompt for your AI editor:
-  Fix accessibility: 3 <img> elements (#hero-img, #logo, #banner) are missing alt
-  attributes, violating WCAG 1.1.1. Add descriptive alt text to each image.
-────────────────────────────────────────────
+WCAG A11y — scan complete
+────────────────────────────────────────────────────────────
+
+  ✖  http://localhost:3000  3 critical  4 serious  3 moderate
+
+     [CRITICAL] Images must have an alt attribute  WCAG 1.1.1
+     → img
+     [CRITICAL] Form inputs must have an associated label  WCAG 1.3.1
+     → input[type="email"]
+     [CRITICAL] Buttons must have an accessible name  WCAG 4.1.2
+     → button[type="submit"]
+     [SERIOUS]  Normal text must meet 4.5:1 contrast ratio  WCAG 1.4.3
+     → p
+     [SERIOUS]  Links must have descriptive text  WCAG 2.4.4
+     → a[href="/sale"]
+     … and 5 more
+
+────────────────────────────────────────────────────────────
+Total: 3 critical · 4 serious · 3 moderate
+
+AI Fix Prompts — paste any of these into Cursor, Copilot, or Claude
+────────────────────────────────────────────────────────────
+
+[img-alt]
+  → img
+  Screen reader users hear nothing for this image — branding, instructions,
+  or data it conveys is completely invisible to them.
+┌─ Copy this prompt ──────────────────────────────────────
+│ Fix WCAG 1.1.1 (Level A) — img is missing an alt attribute
+│
+│ Current HTML:
+│   <img src="banner.jpg">
+│
+│ How to fix:
+│   Add alt text describing the image content.
+│   Use alt="" if the image is purely decorative.
+│   Example: <img src="banner.jpg" alt="Summer sale — 50% off">
+└─────────────────────────────────────────────────────────
+
+… 9 more prompts — full report saved to a11y-report.md
 ```
 
-The **prompt** at the end of each fix is what you copy into Cursor, Copilot, or Claude. It includes the affected selectors, the WCAG rule, and exactly what needs to change — no rewriting needed.
-
-With `--report`, the full output is also saved to `a11y-report.md`.
+Each prompt tells you the WCAG criterion, shows the broken element, and gives the exact fix — ready to paste into your AI editor.
 
 ---
 
@@ -66,56 +75,21 @@ With `--report`, the full output is also saved to `a11y-report.md`.
 npm install -g wcag-a11y
 ```
 
-## Setup
+## Quick start
 
 ```bash
-wcag-a11y init                       # Gemini (free, default)
-wcag-a11y init --provider openai     # OpenAI
-wcag-a11y init --provider ollama     # Local — no API key needed
-```
+# 1. Configure your AI provider (Gemini is free, no credit card)
+wcag-a11y init
 
-Each command creates an `a11y.config.json` pre-wired for that provider. Fill in your API key, then scan.
-
-**Get a free Gemini key:** https://aistudio.google.com  
-**Get an OpenAI key:** https://platform.openai.com/api-keys  
-**Ollama (local):** install from https://ollama.com, then run `ollama serve`
-
----
-
-## Commands
-
-### `wcag-a11y demo`
-
-Scan a built-in page with 10 intentional violations. No dev server or config required — useful for trying the tool before pointing it at your own project.
-
-```bash
-wcag-a11y demo                  # violations + AI fixes (default, requires config)
-wcag-a11y demo --no-ai          # violations only, no AI — faster
-wcag-a11y demo --report         # + save a11y-report.md
+# 2. Start your dev server, then scan
+wcag-a11y scan -u http://localhost:3000
 ```
 
-| Flag | Description |
-|---|---|
-| `--no-ai` | Skip AI fix generation — prints violations only, no prompts |
-| `-r, --report` | Save the full report to `a11y-report.md` in the current directory |
+Add `--pages / /about /contact` to scan specific routes, or `--crawl` to follow links automatically.
 
 ---
 
-### `wcag-a11y init`
-
-Create `a11y.config.json` in the current directory, pre-configured for your chosen provider.
-
-```bash
-wcag-a11y init                       # Gemini (default)
-wcag-a11y init --provider openai     # OpenAI
-wcag-a11y init --provider ollama     # Ollama (local)
-```
-
-| Flag | Description |
-|---|---|
-| `--provider <name>` | Which provider to configure: `gemini` (default), `openai`, or `ollama`. Determines which fields are written to the config file. |
-
----
+## Commands
 
 ### `wcag-a11y scan`
 
@@ -124,21 +98,24 @@ Scan a running dev server for accessibility violations.
 ```bash
 wcag-a11y scan -u http://localhost:3000
 wcag-a11y scan -u http://localhost:3000 --pages / /about /contact
-wcag-a11y scan -u http://localhost:3000 --crawl --report
+wcag-a11y scan -u http://localhost:3000 --crawl
 wcag-a11y scan -u http://localhost:3000 --no-ai --ci
+wcag-a11y scan -u http://localhost:3000 --terminal --fast-mode
 ```
 
 | Flag | Default | Description |
 |---|---|---|
 | `-u, --url <url>` | required | Base URL of your running dev server |
-| `-p, --pages <pages...>` | `/` | One or more paths to scan. Separate with spaces: `--pages / /about /contact` |
-| `-c, --crawl` | off | Follow same-origin links and scan all reachable pages automatically |
-| `-r, --report` | off | Save the full scan output to `a11y-report.md` |
-| `--no-ai` | on | Skip AI fix generation — scan runs faster and prints violations only |
-| `--no-explain` | off | Print only the ready-to-paste prompt for each fix, without the AI explanation |
-| `--group <strategy>` | `rule` | `rule` (default) groups all violations of the same type into one fix prompt. `none` produces a separate prompt per element. Use `none` when violations of the same rule need different fixes |
-| `--ci` | off | Exit with code `1` if any violations are found. Use this to fail a CI pipeline |
-| `--provider <name>` | from config | Override the AI provider for this run: `gemini`, `openai`, or `ollama`. Does not modify the config file |
+| `-p, --pages <paths...>` | `/` | Paths to scan. Space-separated: `--pages / /about /contact` |
+| `-c, --crawl` | off | Follow same-origin links and scan all reachable pages |
+| `--no-ai` | — | Skip AI fix generation — scan runs faster, violations only |
+| `--no-report` | — | Skip saving `a11y-report.md` |
+| `--no-explain` | — | Omit explanations, show prompts only |
+| `--terminal` | off | Print violations and AI prompts to terminal |
+| `--fast-mode` | off | Output only the raw prompts — no summaries or decoration |
+| `--group <strategy>` | `rule` | `rule`: one prompt per rule type. `none`: one prompt per element |
+| `--ci` | off | Exit with code `1` if any violations are found |
+| `--provider <name>` | from config | Override AI provider for this run |
 
 ---
 
@@ -147,34 +124,13 @@ wcag-a11y scan -u http://localhost:3000 --no-ai --ci
 Scan for violations and apply AI-generated patches directly to your source files. Works with any framework — React, Vue, Angular, Svelte, or plain HTML.
 
 ```bash
-# Dry-run: scan and show what would change (safe, no files written)
-wcag-a11y fix -u http://localhost:3000
-
-# Preview specific pages
-wcag-a11y fix -u http://localhost:3000 --pages / /about /contact
-
-# Write fixes to disk
-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
+wcag-a11y fix -u http://localhost:3000               # dry-run: show diff, nothing written
+wcag-a11y fix -u http://localhost:3000 --apply       # write fixes to disk
+wcag-a11y fix --from-report --apply                  # patch from an existing report
 ```
 
-**How it works:**
-
-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
-5. Shows a colored diff before writing anything
-6. With `--apply`, overwrites the file; without it, only prints the diff
-
 ```
-src/components/Navbar.jsx — 2 violation(s)
+src/components/Navbar.jsx — 2 violations
   · [button-name] Buttons must have an accessible name
   · [aria-valid-role] Elements must use valid ARIA roles
 
@@ -188,39 +144,85 @@ src/components/Navbar.jsx — 2 violation(s)
   +     <li>Home</li>
 ```
 
+**Common workflow:** scan first to review, then patch:
+
+```bash
+wcag-a11y scan -u http://localhost:3000   # generates a11y-report.md
+wcag-a11y fix --from-report --apply       # patches files from that report, no second crawl
+```
+
 | Flag | Default | Description |
 |---|---|---|
-| `-u, --url <url>` | — | Base URL of your running dev server. Required unless `--from-report` is used |
-| `-p, --pages <pages...>` | `/` | Specific pages to scan |
+| `-u, --url <url>` | — | Base URL. Required unless `--from-report` is used |
+| `-p, --pages <paths...>` | `/` | Paths 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` |
+| `--from-report [path]` | `a11y-report.md` | Load violations from an existing report instead of rescanning |
+| `--apply` | off | Write fixes to disk (dry-run without this flag) |
+| `--provider <name>` | from config | Override AI provider for this run |
+
+---
 
-> **Tip:** Always run without `--apply` first to review the diff. The dry-run is safe — nothing is written to disk.
+### `wcag-a11y init`
 
-**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.
+Create `a11y.config.json` pre-configured for your chosen provider.
 
 ```bash
-wcag-a11y scan -u http://localhost:3000 --report   # review a11y-report.md
-wcag-a11y fix --from-report --apply                 # patch files from that report
+wcag-a11y init                          # Gemini (free, default)
+wcag-a11y init --provider openai
+wcag-a11y init --provider anthropic
+wcag-a11y init --provider ollama        # local — no API key needed
+# … and 8 more providers
+```
+
+---
+
+### `wcag-a11y demo`
+
+Scan a built-in page with 10 intentional violations. No dev server or config required — useful for trying the tool before pointing it at your own project.
+
+```bash
+wcag-a11y demo           # violations + AI fix prompts (requires config)
+wcag-a11y demo --no-ai  # violations only, no AI
 ```
 
 ---
 
 ## AI Providers
 
-| Provider | Model | Cost | API Key |
-|---|---|---|---|
-| `gemini` (default) | `gemini-2.5-flash` | Free tier | [aistudio.google.com](https://aistudio.google.com) |
-| `openai` | `gpt-4o-mini` | Pay-per-use | [platform.openai.com](https://platform.openai.com/api-keys) |
-| `ollama` | `llama3` | Free (local) | None — run `ollama serve` |
+12 providers supported. Configure once in `a11y.config.json`, or override per-run with `--provider`.
 
-Set your provider in `a11y.config.json` or override it per-run with `--provider`. If the AI response is unparseable, the tool generates a fix prompt directly from the violation data so you always get something actionable.
+| Provider | `--provider` | Default model | Notes |
+|---|---|---|---|
+| Google Gemini | `gemini` *(default)* | `gemini-2.5-flash` | Free tier available |
+| OpenAI | `openai` | `gpt-4o-mini` | |
+| Anthropic | `anthropic` | `claude-sonnet-4-6` | |
+| Mistral | `mistral` | `mistral-large-latest` | |
+| Groq | `groq` | `llama-3.3-70b-versatile` | Fast inference |
+| Cohere | `cohere` | `command-r-plus` | |
+| xAI | `xai` | `grok-2` | |
+| DeepSeek | `deepseek` | `deepseek-chat` | |
+| Together AI | `together` | `meta-llama/Llama-3-70b-chat-hf` | Open-source models |
+| Perplexity | `perplexity` | `llama-3.1-sonar-large-128k-online` | |
+| Azure OpenAI | `azure-openai` | *(your deployment)* | |
+| Ollama | `ollama` | `llama3` | Local — no API key |
+
+All models are configurable. If the AI response is unparseable, the tool generates a fix prompt directly from the violation data — you always get something actionable.
 
 ---
 
-## Config (`a11y.config.json`)
+## Config
+
+Run `wcag-a11y init` to generate `a11y.config.json`. Only fill in the fields for your chosen provider. This file is gitignored by default.
+
+```json
+{
+  "provider": "gemini",
+  "apiKey": "YOUR_GEMINI_API_KEY"
+}
+```
+
+<details>
+<summary>Full config reference (all 12 providers)</summary>
 
 ```json
 {
@@ -232,18 +234,50 @@ Set your provider in `a11y.config.json` or override it per-run with `--provider`
   "openaiApiKey": "YOUR_OPENAI_API_KEY",
   "openaiModel": "gpt-4o-mini",
 
+  "anthropicApiKey": "YOUR_ANTHROPIC_API_KEY",
+  "anthropicModel": "claude-sonnet-4-6",
+
+  "mistralApiKey": "YOUR_MISTRAL_API_KEY",
+  "mistralModel": "mistral-large-latest",
+
+  "groqApiKey": "YOUR_GROQ_API_KEY",
+  "groqModel": "llama-3.3-70b-versatile",
+
+  "cohereApiKey": "YOUR_COHERE_API_KEY",
+  "cohereModel": "command-r-plus",
+
+  "xaiApiKey": "YOUR_XAI_API_KEY",
+  "xaiModel": "grok-2",
+
+  "deepseekApiKey": "YOUR_DEEPSEEK_API_KEY",
+  "deepseekModel": "deepseek-chat",
+
+  "togetherApiKey": "YOUR_TOGETHER_API_KEY",
+  "togetherModel": "meta-llama/Llama-3-70b-chat-hf",
+
+  "perplexityApiKey": "YOUR_PERPLEXITY_API_KEY",
+  "perplexityModel": "llama-3.1-sonar-large-128k-online",
+
+  "azureOpenaiApiKey": "YOUR_AZURE_KEY",
+  "azureOpenaiEndpoint": "https://YOUR_RESOURCE.openai.azure.com",
+  "azureOpenaiDeployment": "YOUR_DEPLOYMENT_NAME",
+  "azureOpenaiApiVersion": "2024-10-01-preview",
+
   "ollamaBaseUrl": "http://localhost:11434",
   "ollamaModel": "llama3"
 }
 ```
 
-Only the fields for your active provider are required. This file is gitignored by default.
+</details>
 
 ---
 
 ## What it checks
 
-40+ rules across 10 categories, mapped to WCAG 2.1/2.2 success criteria.
+40+ rules across 10 WCAG 2.1/2.2 categories: Text Alternatives, Color Contrast, Forms, Keyboard, ARIA, Structure, Links, Media, Tables, and Language.
+
+<details>
+<summary>Full rule list</summary>
 
 ### Text Alternatives — WCAG 1.1.1
 
@@ -346,6 +380,8 @@ Only the fields for your active provider are required. This file is gitignored b
 | `html-lang` | serious | `<html>` must have a `lang` attribute |
 | `html-lang-valid` | serious | `lang` attribute must be a valid BCP 47 language tag |
 
+</details>
+
 ---
 
 ## Use in CI/CD

package/dist/ai/anthropic.js

@@ -0,0 +1,59 @@
+import { buildPrompt } from './prompt.js';
+import { buildPatchPrompt } from './patch-prompt.js';
+import { groupViolations } from './group.js';
+import { BaseAIProvider } from './base.js';
+export class AnthropicProvider extends BaseAIProvider {
+    apiKey;
+    model;
+    constructor(apiKey, model = 'claude-sonnet-4-6') {
+        super();
+        this.apiKey = apiKey;
+        this.model = model;
+    }
+    get headers() {
+        return {
+            'Content-Type': 'application/json',
+            'x-api-key': this.apiKey,
+            'anthropic-version': '2023-06-01',
+        };
+    }
+    async generateFixes(violations, strategy = 'rule', framework) {
+        if (violations.length === 0)
+            return [];
+        const groups = groupViolations(violations, strategy);
+        const prompt = buildPrompt(groups, framework);
+        const response = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: this.headers,
+            body: JSON.stringify({
+                model: this.model,
+                max_tokens: 8192,
+                temperature: 0.2,
+                messages: [{ role: 'user', content: prompt }],
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Anthropic API error: ${response.status} ${await response.text()}`);
+        }
+        const data = await response.json();
+        const text = data.content?.[0]?.text ?? '[]';
+        return this.parse(text, groups, framework);
+    }
+    async generateFilePatch(fileContent, violations, filePath, framework) {
+        const prompt = buildPatchPrompt(fileContent, violations, filePath, framework);
+        const response = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: this.headers,
+            body: JSON.stringify({
+                model: this.model,
+                max_tokens: 16384,
+                temperature: 0.1,
+                messages: [{ role: 'user', content: prompt }],
+            }),
+        });
+        if (!response.ok)
+            throw new Error(`Anthropic API error: ${response.status} ${await response.text()}`);
+        const data = await response.json();
+        return data.content?.[0]?.text ?? '';
+    }
+}

package/dist/ai/azure-openai.js

@@ -0,0 +1,17 @@
+import { OpenAICompatProvider } from './openai-compat.js';
+export class AzureOpenAIProvider extends OpenAICompatProvider {
+    apiVersion;
+    constructor(endpoint, apiKey, deployment, apiVersion = '2024-10-01-preview') {
+        super(`${endpoint}/openai/deployments/${deployment}`, apiKey, deployment, 'Azure OpenAI');
+        this.apiVersion = apiVersion;
+    }
+    buildUrl(path) {
+        return `${this.baseUrl}${path}?api-version=${this.apiVersion}`;
+    }
+    buildHeaders() {
+        return {
+            'Content-Type': 'application/json',
+            'api-key': this.apiKey,
+        };
+    }
+}

package/dist/ai/base.js

@@ -0,0 +1,45 @@
+import { fallbackExplanation } from './fallback-explanation.js';
+import { getFix, getFixCategory } from './fallback-fix.js';
+export class BaseAIProvider {
+    parse(text, groups, framework) {
+        try {
+            const jsonMatch = text.match(/\[[\s\S]*\]/);
+            const fixes = jsonMatch ? JSON.parse(jsonMatch[0]) : [];
+            return groups.map((g) => {
+                const found = fixes.find((f) => f.ruleId === g.ruleId);
+                return found
+                    ? { ...found, selectors: g.selectors, instanceCount: g.count, fixCategory: getFixCategory(g.ruleId) }
+                    : this.fallbackFix(g, framework);
+            });
+        }
+        catch {
+            return groups.map((g) => this.fallbackFix(g, framework));
+        }
+    }
+    fallback(groups, framework) {
+        return groups.map((g) => this.fallbackFix(g, framework));
+    }
+    fallbackFix(g, framework) {
+        const v = g.representative;
+        const selectorList = g.selectors.map((s) => `- \`${s}\``).join('\n');
+        const explanation = fallbackExplanation(g.ruleId, g.description, g.wcag, g.level);
+        const fwNote = framework ? `This project uses ${framework}.\n\n` : '';
+        const fixInstructions = getFix(g.ruleId);
+        const fixSection = fixInstructions ? `\n\nHow to fix:\n${fixInstructions}` : '';
+        const prompt = g.count > 1
+            ? `${fwNote}Fix WCAG 2.1 SC ${g.wcag} (Level ${g.level}) — ${g.description}\n\nAffected elements (${g.count} instances):\n${selectorList}\n\nRepresentative HTML:\n\`\`\`html\n${v.html.slice(0, 400)}\n\`\`\`${fixSection}\n\nApply this fix to all ${g.count} instances across the codebase.`
+            : `${fwNote}Fix WCAG 2.1 SC ${g.wcag} (Level ${g.level}) — ${g.description}\n\nAffected element:\n- Selector: \`${g.selectors[0]}\`\n\nCurrent HTML:\n\`\`\`html\n${v.html.slice(0, 400)}\n\`\`\`${fixSection}`;
+        const category = getFixCategory(g.ruleId);
+        const fixedCode = category === 'edit-element' || !category ? v.html : undefined;
+        return {
+            ruleId: g.ruleId,
+            selectors: g.selectors,
+            instanceCount: g.count,
+            explanation,
+            fixedCode,
+            fixCategory: getFixCategory(g.ruleId),
+            wcagReference: `WCAG 2.1 SC ${g.wcag}`,
+            optimalPrompt: prompt,
+        };
+    }
+}

package/dist/ai/cohere.js

@@ -0,0 +1,58 @@
+import { buildPrompt } from './prompt.js';
+import { buildPatchPrompt } from './patch-prompt.js';
+import { groupViolations } from './group.js';
+import { BaseAIProvider } from './base.js';
+export class CohereProvider extends BaseAIProvider {
+    apiKey;
+    model;
+    constructor(apiKey, model = 'command-r-plus') {
+        super();
+        this.apiKey = apiKey;
+        this.model = model;
+    }
+    get headers() {
+        return {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${this.apiKey}`,
+        };
+    }
+    async generateFixes(violations, strategy = 'rule', framework) {
+        if (violations.length === 0)
+            return [];
+        const groups = groupViolations(violations, strategy);
+        const prompt = buildPrompt(groups, framework);
+        const response = await fetch('https://api.cohere.com/v2/chat', {
+            method: 'POST',
+            headers: this.headers,
+            body: JSON.stringify({
+                model: this.model,
+                messages: [{ role: 'user', content: prompt }],
+                max_tokens: 8192,
+                temperature: 0.2,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Cohere API error: ${response.status} ${await response.text()}`);
+        }
+        const data = await response.json();
+        const text = data.message?.content?.[0]?.text ?? '[]';
+        return this.parse(text, groups, framework);
+    }
+    async generateFilePatch(fileContent, violations, filePath, framework) {
+        const prompt = buildPatchPrompt(fileContent, violations, filePath, framework);
+        const response = await fetch('https://api.cohere.com/v2/chat', {
+            method: 'POST',
+            headers: this.headers,
+            body: JSON.stringify({
+                model: this.model,
+                messages: [{ role: 'user', content: prompt }],
+                max_tokens: 16384,
+                temperature: 0.1,
+            }),
+        });
+        if (!response.ok)
+            throw new Error(`Cohere API error: ${response.status} ${await response.text()}`);
+        const data = await response.json();
+        return data.message?.content?.[0]?.text ?? '';
+    }
+}

package/dist/ai/deepseek.js

@@ -0,0 +1,6 @@
+import { OpenAICompatProvider } from './openai-compat.js';
+export class DeepSeekProvider extends OpenAICompatProvider {
+    constructor(apiKey, model = 'deepseek-chat') {
+        super('https://api.deepseek.com/v1', apiKey, model, 'DeepSeek');
+    }
+}