@rgaaudit/mcp-server 0.2.1 → 0.3.1

package/dist/index.js

@@ -23,10 +23,27 @@ const API_URL = process.env.RGAA_API_URL || 'https://app.rgaaudit.fr';
 const API_KEY = process.env.RGAA_API_KEY || '';
 const server = new McpServer({
     name: 'rgaaudit',
-    version: '0.2.0',
+    version: '0.3.1',
 });
+// ── Cache d'audit (TTL 10 min, évite double consommation de quota) ──
+const CACHE_TTL_MS = 10 * 60 * 1000;
+const auditCache = new Map();
 /**
- * Appelle POST /api/ci/scan
+ * Nettoie les entrées expirées du cache
+ */
+function cleanCache() {
+    const now = Date.now();
+    for (const [key, entry] of auditCache) {
+        if (now - entry.timestamp > CACHE_TTL_MS)
+            auditCache.delete(key);
+    }
+}
+/**
+ * Appelle POST /api/ci/scan — toujours via l'API (règles custom + patterns + mapping RGAA).
+ * Cache intelligent : réutilise l'auditId si un audit récent existe (0 quota).
+ *
+ * @param url - URL à auditer
+ * @param options - details, threshold, auditId (pour réutiliser un audit existant)
  */
 async function callScan(url, options) {
     if (!API_KEY) {
@@ -36,6 +53,16 @@ async function callScan(url, options) {
             '3. Générez une clé API\n' +
             '4. Configurez : RGAA_API_KEY=rga_...');
     }
+    cleanCache();
+    // Vérifier le cache : si un audit récent existe, réutiliser l'auditId (0 quota)
+    const cacheKey = url.toLowerCase().replace(/\/+$/, '');
+    const cached = auditCache.get(cacheKey);
+    if (cached && !options?.auditId) {
+        if (!options?.details || cached.result.violationDetails) {
+            return cached.result;
+        }
+    }
+    const auditId = options?.auditId || cached?.result.auditId;
     const res = await fetch(`${API_URL}/api/ci/scan`, {
         method: 'POST',
         headers: {
@@ -46,12 +73,41 @@ async function callScan(url, options) {
             url,
             details: options?.details ?? false,
             threshold: options?.threshold ?? 0,
+            ...(auditId ? { auditId } : {}),
         }),
     });
     if (!res.ok) {
         const body = await res.json().catch(() => ({}));
         throw new Error(`API erreur ${res.status}: ${body.message || res.statusText}`);
     }
+    const result = await res.json();
+    // Mettre en cache
+    auditCache.set(cacheKey, { result, timestamp: Date.now() });
+    return result;
+}
+/**
+ * Appelle POST /api/ci/recheck — re-scanne les mêmes pages d'un audit existant.
+ * Smart re-audit : pas de discovery, pas de crawl. Consomme 1 token.
+ * Retourne le delta (score, violations résolues/nouvelles).
+ *
+ * @param auditId - ID de l'audit à re-checker
+ */
+async function callRecheck(auditId) {
+    if (!API_KEY) {
+        throw new Error('RGAA_API_KEY non configurée.');
+    }
+    const res = await fetch(`${API_URL}/api/ci/recheck`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'X-API-Key': API_KEY,
+        },
+        body: JSON.stringify({ auditId }),
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(`API erreur ${res.status}: ${body.message || res.statusText}`);
+    }
     return res.json();
 }
 // ── Outil 1 : rgaa_audit ──
@@ -64,10 +120,20 @@ server.tool('rgaa_audit', 'Lancer un audit d\'accessibilité RGAA 4.1 complet su
         const critique = violations.filter(v => v.impact === 'critical').length;
         const serieux = violations.filter(v => v.impact === 'serious').length;
         const modere = violations.filter(v => v.impact === 'moderate').length;
+        const uniqueViolations = result.violationsInSharedZones
+            ? result.violations - result.violationsInSharedZones
+            : result.violations;
+        const sharedInfo = result.violationsInSharedZones
+            ? ` (dont ${result.violationsInSharedZones} dans des zones partagées nav/header/footer)`
+            : '';
         let text = `# Audit RGAA 4.1 — ${url}\n\n` +
             `**Score** : ${result.score}% — ${result.conformity}\n` +
-            `**${result.violations} non-conformités** sur ${result.pages} pages\n` +
-            `- ${critique} critique(s), ${serieux} sérieuse(s), ${modere} modérée(s)\n\n`;
+            `**${result.violations} non-conformités**${sharedInfo} sur ${result.pages} pages\n` +
+            `- ${critique} critique(s), ${serieux} sérieuse(s), ${modere} modérée(s)\n`;
+        if (result.coverage) {
+            text += `- **Couverture RGAA** : ${result.coverage.percentage}% (${result.coverage.mappedCriteria}/${result.coverage.totalCriteria} critères testés)\n`;
+        }
+        text += '\n';
         if (result.patterns && result.patterns.length > 0) {
             text += `## Patterns de correction (${result.patterns.length})\n\n`;
             for (const p of result.patterns) {
@@ -76,20 +142,52 @@ server.tool('rgaa_audit', 'Lancer un audit d\'accessibilité RGAA 4.1 complet su
             text += '\n';
         }
         if (violations.length > 0) {
-            text += `## Détail des violations\n\n`;
-            for (const [i, v] of violations.entries()) {
-                text += `### ${i + 1}. ${v.criteriaTitle || v.description}\n`;
-                text += `- **Critère RGAA** : ${v.criteria || 'N/A'}${v.theme ? ` (${v.theme})` : ''}\n`;
-                text += `- **Impact** : ${v.impact}\n`;
-                text += `- **Éléments** : ${v.nodesCount} nœuds\n`;
-                if (v.zone)
-                    text += `- **Zone** : ${v.zone}\n`;
-                if (v.suggestion)
-                    text += `- **Suggestion** : ${v.suggestion}\n`;
-                if (v.nodes.length > 0) {
-                    text += `- **Exemple** : \`${v.nodes[0].target}\`\n`;
+            // Regrouper les violations par zone partagée
+            const sharedZones = ['header', 'nav', 'footer'];
+            const inSharedZone = violations.filter(v => v.zone && sharedZones.includes(v.zone));
+            const inContent = violations.filter(v => !v.zone || !sharedZones.includes(v.zone));
+            if (inSharedZone.length > 0) {
+                text += `## Violations en zones partagées (${inSharedZone.length})\n\n`;
+                text += `> Ces violations sont dans des zones répétées sur toutes les pages (nav, header, footer).\n`;
+                text += `> **Corrigez le composant layout une seule fois** pour résoudre toutes les pages.\n\n`;
+                // Grouper par zone
+                const byZone = new Map();
+                for (const v of inSharedZone) {
+                    const zone = v.zone;
+                    if (!byZone.has(zone))
+                        byZone.set(zone, []);
+                    byZone.get(zone).push(v);
+                }
+                for (const [zone, zoneViolations] of byZone) {
+                    text += `### Zone : ${zone}\n`;
+                    text += `Fichier probable : \`layouts/*.vue\` ou \`components/${zone === 'nav' ? 'AppNav' : zone === 'footer' ? 'AppFooter' : 'AppHeader'}.vue\`\n\n`;
+                    for (const v of zoneViolations) {
+                        text += `- **${v.criteriaTitle || v.description}** (${v.impact}, ${v.nodesCount} nœuds)`;
+                        if (v.nodes.length > 0)
+                            text += ` — \`${v.nodes[0].target}\``;
+                        text += '\n';
+                        if (v.suggestion)
+                            text += `  ${v.suggestion}\n`;
+                    }
+                    text += '\n';
+                }
+            }
+            if (inContent.length > 0) {
+                text += `## Violations de contenu (${inContent.length})\n\n`;
+                for (const [i, v] of inContent.entries()) {
+                    text += `### ${i + 1}. ${v.criteriaTitle || v.description}\n`;
+                    text += `- **Critère RGAA** : ${v.criteria || 'N/A'}${v.theme ? ` (${v.theme})` : ''}\n`;
+                    text += `- **Impact** : ${v.impact}\n`;
+                    text += `- **Éléments** : ${v.nodesCount} nœuds\n`;
+                    if (v.zone)
+                        text += `- **Zone** : ${v.zone}\n`;
+                    if (v.suggestion)
+                        text += `- **Suggestion** : ${v.suggestion}\n`;
+                    if (v.nodes.length > 0) {
+                        text += `- **Exemple** : \`${v.nodes[0].target}\`\n`;
+                    }
+                    text += '\n';
                 }
-                text += '\n';
             }
         }
         text += `\n🔗 Rapport complet : ${result.auditUrl}`;
@@ -104,13 +202,29 @@ server.tool('rgaa_score', 'Score de conformité RGAA rapide pour une URL. Retour
     url: z.string().url().describe('URL du site web'),
 }, async ({ url }) => {
     try {
-        const result = await callScan(url);
-        const text = `**Score RGAA** : ${result.score}%\n` +
+        // Appeler avec details pour inclure un résumé des top violations
+        const result = await callScan(url, { details: true });
+        const violations = result.violationDetails || [];
+        // Top 5 violations triées par impact (critique > sérieux > modéré)
+        const impactOrder = { critical: 0, critique: 0, serious: 1, serieux: 1, moderate: 2, modere: 2, minor: 3, mineur: 3 };
+        const top5 = [...violations]
+            .sort((a, b) => (impactOrder[a.impact] ?? 9) - (impactOrder[b.impact] ?? 9))
+            .slice(0, 5);
+        let text = `**Score RGAA** : ${result.score}%\n` +
             `**Conformité** : ${result.conformity}\n` +
             `**Violations** : ${result.violations}\n` +
-            `**Pages analysées** : ${result.pages}\n` +
-            `**URL** : ${url}\n\n` +
-            `🔗 Détails : ${result.auditUrl}`;
+            `**Pages analysées** : ${result.pages}\n`;
+        if (result.coverage) {
+            text += `**Couverture** : ${result.coverage.percentage}% des critères RGAA testés\n`;
+        }
+        text += `**URL** : ${url}\n`;
+        if (top5.length > 0) {
+            text += `\n**Top violations** :\n`;
+            for (const v of top5) {
+                text += `- [${v.impact}] ${v.criteria || ''} ${v.criteriaTitle || v.description} (${v.nodesCount} nœuds)\n`;
+            }
+        }
+        text += `\n🔗 Détails : ${result.auditUrl}`;
         return { content: [{ type: 'text', text }] };
     }
     catch (error) {
@@ -171,7 +285,428 @@ server.tool('rgaa_explain', 'Explique un critère RGAA 4.1 avec sa description,
         (info.exemple ? `## Exemple\n${info.exemple}\n` : '');
     return { content: [{ type: 'text', text }] };
 });
-// ── Outil 5 : rgaa_report ──
+// ── Outil 5 : rgaa_fix (local, pas d'API) ──
+/**
+ * Base de corrections pour les règles axe-core / RGAA les plus courantes.
+ * Chaque entrée contient des exemples de code avant/après pour HTML, Vue et React.
+ */
+const RGAA_FIXES = {
+    'image-alt': {
+        rule: 'image-alt',
+        criteria: '1.1',
+        description: 'Image sans alternative textuelle',
+        fixes: {
+            html: '```html\n<!-- Avant -->\n<img src="photo.jpg">\n\n<!-- Après (informative) -->\n<img src="photo.jpg" alt="Description de l\'image">\n\n<!-- Après (décorative) -->\n<img src="decoration.svg" alt="" role="presentation">\n```',
+            vue: '```vue\n<!-- Avant -->\n<img :src="imageUrl" />\n\n<!-- Après -->\n<img :src="imageUrl" :alt="imageAlt" />\n\n<!-- Décorative -->\n<img :src="bgUrl" alt="" role="presentation" />\n```',
+            react: '```tsx\n// Avant\n<img src={imageUrl} />\n\n// Après\n<img src={imageUrl} alt="Description de l\'image" />\n\n// Décorative\n<img src={bgUrl} alt="" role="presentation" />\n```',
+        },
+    },
+    'color-contrast': {
+        rule: 'color-contrast',
+        criteria: '3.3',
+        description: 'Contraste insuffisant entre texte et fond',
+        fixes: {
+            html: '```css\n/* Avant — ratio 2.1:1 */\ncolor: #999; background: #fff;\n\n/* Après — ratio 7.4:1 */\ncolor: #333; background: #fff;\n\n/* Vérifier : https://webaim.org/resources/contrastchecker/ */\n/* Minimum : 4.5:1 (texte normal), 3:1 (texte ≥18pt ou 14pt gras) */\n```',
+            vue: '```vue\n<!-- Utiliser des tokens sémantiques au lieu de couleurs hardcodées -->\n<p class="text-foreground">Texte principal</p>\n<p class="text-muted-foreground">Texte secondaire</p>\n\n<!-- Vérifier dans tailwind.config.ts que les tokens respectent le ratio 4.5:1 -->\n```',
+            react: '```tsx\n// Utiliser des tokens CSS au lieu de couleurs inline\n<p className="text-foreground">Texte principal</p>\n<p className="text-muted-foreground">Texte secondaire</p>\n```',
+        },
+    },
+    'link-name': {
+        rule: 'link-name',
+        criteria: '6.1',
+        description: 'Lien sans intitulé accessible',
+        fixes: {
+            html: '```html\n<!-- Avant (lien icône sans texte) -->\n<a href="/menu"><svg>...</svg></a>\n\n<!-- Après — aria-label -->\n<a href="/menu" aria-label="Ouvrir le menu"><svg aria-hidden="true">...</svg></a>\n\n<!-- Après — texte sr-only -->\n<a href="/menu"><svg aria-hidden="true">...</svg><span class="sr-only">Ouvrir le menu</span></a>\n\n<!-- Après — SVG title -->\n<a href="/menu"><svg><title>Ouvrir le menu</title>...</svg></a>\n```',
+            vue: '```vue\n<!-- Avant -->\n<a :href="url"><Icon name="menu" /></a>\n\n<!-- Après -->\n<a :href="url" aria-label="Ouvrir le menu"><Icon name="menu" aria-hidden="true" /></a>\n\n<!-- Avec composant -->\n<NuxtLink :to="url" aria-label="Ouvrir le menu"><Icon name="menu" aria-hidden="true" /></NuxtLink>\n```',
+            react: '```tsx\n// Avant\n<a href={url}><MenuIcon /></a>\n\n// Après\n<a href={url} aria-label="Ouvrir le menu"><MenuIcon aria-hidden /></a>\n```',
+        },
+    },
+    'label': {
+        rule: 'label',
+        criteria: '11.1',
+        description: 'Champ de formulaire sans étiquette',
+        fixes: {
+            html: '```html\n<!-- Avant -->\n<input type="email" placeholder="Email">\n\n<!-- Après — label explicite -->\n<label for="email">Adresse email</label>\n<input id="email" type="email" placeholder="ex: nom@domaine.fr">\n\n<!-- Après — aria-label (si label visuel impossible) -->\n<input type="search" aria-label="Rechercher sur le site" placeholder="Rechercher...">\n```',
+            vue: '```vue\n<!-- Avant -->\n<Input type="email" placeholder="Email" />\n\n<!-- Après -->\n<div class="space-y-1">\n  <Label for="email">Adresse email</Label>\n  <Input id="email" type="email" placeholder="ex: nom@domaine.fr" />\n</div>\n```',
+            react: '```tsx\n// Avant\n<input type="email" placeholder="Email" />\n\n// Après\n<label htmlFor="email">Adresse email</label>\n<input id="email" type="email" placeholder="ex: nom@domaine.fr" />\n```',
+        },
+    },
+    'button-name': {
+        rule: 'button-name',
+        criteria: '11.9',
+        description: 'Bouton sans intitulé accessible',
+        fixes: {
+            html: '```html\n<!-- Avant -->\n<button><svg>...</svg></button>\n\n<!-- Après -->\n<button aria-label="Fermer"><svg aria-hidden="true">...</svg></button>\n\n<!-- Ou avec texte visible -->\n<button><svg aria-hidden="true">...</svg> Fermer</button>\n```',
+            vue: '```vue\n<!-- Avant -->\n<Button size="icon"><X /></Button>\n\n<!-- Après -->\n<Button size="icon" aria-label="Fermer"><X aria-hidden="true" /></Button>\n```',
+            react: '```tsx\n// Avant\n<button><XIcon /></button>\n\n// Après\n<button aria-label="Fermer"><XIcon aria-hidden /></button>\n```',
+        },
+    },
+    'html-has-lang': {
+        rule: 'html-has-lang',
+        criteria: '8.3',
+        description: 'Langue de la page non déclarée',
+        fixes: {
+            html: '```html\n<!-- Avant -->\n<html>\n\n<!-- Après -->\n<html lang="fr">\n```',
+            vue: '```typescript\n// nuxt.config.ts\nexport default defineNuxtConfig({\n  app: {\n    head: {\n      htmlAttrs: { lang: \'fr\' },\n    },\n  },\n})\n```',
+            react: '```tsx\n// Avant\n<html>\n\n// Après\n<html lang="fr">\n\n// Next.js — layout.tsx\nexport default function RootLayout({ children }) {\n  return <html lang="fr">{children}</html>\n}\n```',
+        },
+    },
+    'bypass': {
+        rule: 'bypass',
+        criteria: '12.7',
+        description: 'Pas de lien d\'évitement vers le contenu principal',
+        fixes: {
+            html: '```html\n<!-- Ajouter en tout premier dans <body> -->\n<a href="#main-content" class="sr-only focus:not-sr-only focus:absolute focus:top-2 focus:left-2 focus:z-50 focus:bg-background focus:p-2 focus:rounded">\n  Aller au contenu principal\n</a>\n\n<!-- Ajouter id sur le contenu principal -->\n<main id="main-content">...</main>\n```',
+            vue: '```vue\n<!-- layouts/default.vue ou app.vue -->\n<template>\n  <a href="#main-content" class="sr-only focus:not-sr-only focus:absolute focus:top-2 focus:left-2 focus:z-50 focus:bg-background focus:p-2 focus:rounded">\n    Aller au contenu principal\n  </a>\n  <header>...</header>\n  <main id="main-content"><slot /></main>\n</template>\n```',
+            react: '```tsx\n// Layout.tsx\nexport default function Layout({ children }) {\n  return (\n    <>\n      <a href="#main-content" className="sr-only focus:not-sr-only ...">\n        Aller au contenu principal\n      </a>\n      <Header />\n      <main id="main-content">{children}</main>\n    </>\n  )\n}\n```',
+        },
+    },
+    'landmark-one-main': {
+        rule: 'landmark-one-main',
+        criteria: '12.9',
+        description: 'Page sans élément <main>',
+        fixes: {
+            html: '```html\n<!-- Avant -->\n<body>\n  <div class="content">...</div>\n</body>\n\n<!-- Après -->\n<body>\n  <header>...</header>\n  <nav>...</nav>\n  <main>...</main>\n  <footer>...</footer>\n</body>\n```',
+            vue: '```vue\n<!-- layouts/default.vue -->\n<template>\n  <header><AppNav /></header>\n  <main><slot /></main>\n  <footer><AppFooter /></footer>\n</template>\n```',
+            react: '```tsx\n// Layout.tsx\nexport default function Layout({ children }) {\n  return (\n    <>\n      <header><Nav /></header>\n      <main>{children}</main>\n      <footer><Footer /></footer>\n    </>\n  )\n}\n```',
+        },
+    },
+    'link-in-text-block': {
+        rule: 'link-in-text-block',
+        criteria: '10.6',
+        description: 'Liens non distinguables du texte environnant',
+        fixes: {
+            html: '```css\n/* Ajouter un soulignement ou un indicateur non-couleur */\na { text-decoration: underline; }\na:hover { text-decoration: none; border-bottom: 2px solid; }\n```',
+            vue: '```vue\n<!-- Tailwind -->\n<a href="/page" class="underline hover:no-underline hover:border-b-2 hover:border-current">\n  Lien dans un paragraphe\n</a>\n```',
+            react: '```tsx\n<a href="/page" className="underline hover:no-underline hover:border-b-2">\n  Lien dans un paragraphe\n</a>\n```',
+        },
+    },
+    'target-blank': {
+        rule: 'custom-new-window-warning',
+        criteria: '13.2',
+        description: 'Lien target="_blank" sans avertissement',
+        fixes: {
+            html: '```html\n<!-- Avant -->\n<a href="https://example.com" target="_blank">Site externe</a>\n\n<!-- Après — texte sr-only -->\n<a href="https://example.com" target="_blank" rel="noopener">\n  Site externe <span class="sr-only">(nouvelle fenêtre)</span>\n</a>\n\n<!-- Après — aria-label -->\n<a href="https://example.com" target="_blank" rel="noopener"\n   aria-label="Site externe (nouvelle fenêtre)">\n  Site externe\n</a>\n```',
+            vue: '```vue\n<!-- Composant réutilisable -->\n<template>\n  <a :href="href" target="_blank" rel="noopener">\n    <slot />\n    <ExternalLinkIcon class="inline h-3 w-3 ml-1" aria-hidden="true" />\n    <span class="sr-only">(nouvelle fenêtre)</span>\n  </a>\n</template>\n```',
+            react: '```tsx\n// Composant réutilisable\nfunction ExternalLink({ href, children }) {\n  return (\n    <a href={href} target="_blank" rel="noopener">\n      {children}\n      <ExternalLinkIcon className="inline h-3 w-3 ml-1" aria-hidden />\n      <span className="sr-only">(nouvelle fenêtre)</span>\n    </a>\n  )\n}\n```',
+        },
+    },
+};
+server.tool('rgaa_fix', 'Retourne le code correctif pour une violation RGAA. Fournit des exemples avant/après en HTML, Vue et React.', {
+    ruleId: z.string().describe('ID de la règle axe-core (ex: image-alt, color-contrast, link-name, label, button-name, bypass, target-blank)'),
+    framework: z.enum(['html', 'vue', 'react']).default('html').describe('Framework cible pour les exemples de code'),
+}, async ({ ruleId, framework }) => {
+    const fix = RGAA_FIXES[ruleId];
+    if (!fix) {
+        const available = Object.keys(RGAA_FIXES).join(', ');
+        return { content: [{ type: 'text', text: `Règle "${ruleId}" non trouvée dans la base de corrections.\n\nRègles disponibles : ${available}\n\nUtilisez \`rgaa_explain\` pour comprendre le critère RGAA associé.` }] };
+    }
+    const code = fix.fixes[framework] || fix.fixes['html'];
+    const text = `# Correction — ${fix.rule} (RGAA ${fix.criteria})\n\n` +
+        `**Problème** : ${fix.description}\n\n` +
+        `## Code correctif (${framework})\n\n${code}\n\n` +
+        (framework !== 'html' && fix.fixes['html'] ? `## Version HTML de référence\n\n${fix.fixes['html']}\n` : '');
+    return { content: [{ type: 'text', text }] };
+});
+// ── Outil 6 : rgaa_remediate ──
+/**
+ * Règles pour lesquelles on sait générer un fix automatique.
+ * Mappées vers les clés de RGAA_FIXES.
+ */
+const FIXABLE_RULES = new Set(Object.keys(RGAA_FIXES));
+/**
+ * Ordre de priorité des impacts pour le tri
+ */
+const IMPACT_PRIORITY = {
+    critical: 0, critique: 0,
+    serious: 1, serieux: 1,
+    moderate: 2, modere: 2,
+    minor: 3, mineur: 3,
+};
+server.tool('rgaa_remediate', 'Plan de remédiation autonome : audite, priorise les violations corrigeables, et retourne un plan d\'action structuré avec le code correctif pour chaque violation. L\'agent AI applique ensuite les fixes via ses outils (file system, browser). Sur localhost = re-audits gratuits. Sur site distant = chaque re-audit consomme le quota.', {
+    url: z.string().url().describe('URL du site à corriger'),
+    framework: z.enum(['html', 'vue', 'react']).default('html').describe('Framework cible pour le code correctif'),
+    targetScore: z.number().min(0).max(100).default(80).describe('Score cible à atteindre (défaut: 80%)'),
+    maxFixes: z.number().min(1).max(30).default(10).describe('Nombre max de violations à traiter (défaut: 10)'),
+}, async ({ url, framework, targetScore, maxFixes }) => {
+    try {
+        const result = await callScan(url, { details: true });
+        const violations = result.violationDetails || [];
+        if (violations.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `# Remédiation RGAA — ${url}\n\n` +
+                            `**Score actuel** : ${result.score}%\n` +
+                            `**Aucune violation détectée.** Le site est conforme aux critères testés.\n\n` +
+                            (result.coverage ? `Note : ${result.coverage.percentage}% des critères RGAA sont testés automatiquement. Les ${100 - result.coverage.percentage}% restants nécessitent un audit humain.` : ''),
+                    }],
+            };
+        }
+        if (result.score >= targetScore) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `# Remédiation RGAA — ${url}\n\n` +
+                            `**Score actuel** : ${result.score}% (cible : ${targetScore}%)\n` +
+                            `**Score cible déjà atteint.** ${violations.length} violation(s) restante(s) de priorité basse.\n\n` +
+                            `Pour aller plus loin, relancez avec un targetScore plus élevé.`,
+                    }],
+            };
+        }
+        // Séparer violations corrigeables (on a un fix) vs manuelles
+        const fixable = [];
+        const manual = [];
+        for (const v of violations) {
+            if (FIXABLE_RULES.has(v.ruleId)) {
+                fixable.push(v);
+            }
+            else {
+                manual.push(v);
+            }
+        }
+        // Trier par impact (critique d'abord) puis par nombre de nœuds (plus d'impact)
+        fixable.sort((a, b) => {
+            const impactDiff = (IMPACT_PRIORITY[a.impact] ?? 9) - (IMPACT_PRIORITY[b.impact] ?? 9);
+            if (impactDiff !== 0)
+                return impactDiff;
+            return b.nodesCount - a.nodesCount;
+        });
+        // Limiter au max demandé
+        const toFix = fixable.slice(0, maxFixes);
+        // Construire le plan de remédiation
+        let text = `# Plan de remédiation RGAA — ${url}\n\n`;
+        text += `| Métrique | Valeur |\n|----------|--------|\n`;
+        text += `| Score actuel | ${result.score}% |\n`;
+        text += `| Score cible | ${targetScore}% |\n`;
+        text += `| Violations totales | ${violations.length} |\n`;
+        text += `| Corrigeables auto | ${fixable.length} |\n`;
+        text += `| Manuelles | ${manual.length} |\n`;
+        text += `| Fixes dans ce plan | ${toFix.length} |\n`;
+        text += `| Re-check | 1 token (smart re-audit, pas de re-discovery) |\n`;
+        text += '\n';
+        // Score estimé après corrections
+        const estimatedGain = Math.min(30, toFix.length * 3);
+        const estimatedScore = Math.min(100, result.score + estimatedGain);
+        text += `**Score estimé après corrections** : ~${estimatedScore}% (+${estimatedGain} points)\n\n`;
+        text += `---\n\n## Corrections à appliquer (${toFix.length})\n\n`;
+        text += `Appliquez chaque fix dans l'ordre. Après le dernier fix, lancez \`rgaa_recheck("${result.auditId}")\` pour mesurer le delta.\n\n`;
+        for (const [i, v] of toFix.entries()) {
+            const fix = RGAA_FIXES[v.ruleId];
+            const code = fix.fixes[framework] || fix.fixes['html'];
+            text += `### Fix ${i + 1}/${toFix.length} — ${v.ruleId} (RGAA ${v.criteria || '?'})\n\n`;
+            text += `- **Problème** : ${fix.description}\n`;
+            text += `- **Impact** : ${v.impact}\n`;
+            text += `- **Éléments** : ${v.nodesCount} nœuds affectés\n`;
+            if (v.zone && ['header', 'nav', 'footer'].includes(v.zone)) {
+                text += `- **Zone partagée** : ${v.zone} → corrigez le composant layout (1 fix = toutes les pages)\n`;
+            }
+            else if (v.zone) {
+                text += `- **Zone** : ${v.zone}\n`;
+            }
+            // Exemples de nœuds à corriger
+            if (v.nodes.length > 0) {
+                text += `- **Éléments à corriger** :\n`;
+                for (const n of v.nodes.slice(0, 3)) {
+                    text += `  - \`${n.target}\`\n`;
+                }
+                if (v.nodes.length > 3)
+                    text += `  - ... et ${v.nodes.length - 3} autres\n`;
+            }
+            text += `\n**Code correctif (${framework})** :\n\n${code}\n\n`;
+            if (v.suggestion && v.suggestion !== fix.description) {
+                text += `**Suggestion** : ${v.suggestion}\n\n`;
+            }
+            text += `---\n\n`;
+        }
+        // Violations manuelles (pas de fix automatique)
+        if (manual.length > 0) {
+            text += `## Violations manuelles (${manual.length})\n\n`;
+            text += `Ces violations n'ont pas de fix automatique. Elles nécessitent une analyse humaine :\n\n`;
+            const manualSorted = [...manual].sort((a, b) => (IMPACT_PRIORITY[a.impact] ?? 9) - (IMPACT_PRIORITY[b.impact] ?? 9));
+            for (const v of manualSorted.slice(0, 10)) {
+                text += `- **[${v.impact}]** ${v.criteria || ''} ${v.criteriaTitle || v.description} (${v.nodesCount} nœuds)\n`;
+            }
+            if (manual.length > 10)
+                text += `- ... et ${manual.length - 10} autres\n`;
+            text += '\n';
+        }
+        // Instructions pour l'agent
+        text += `## Instructions pour l'agent\n\n`;
+        text += `1. Pour chaque fix ci-dessus, identifiez le fichier source concerné\n`;
+        text += `2. Appliquez le code correctif adapté au composant\n`;
+        text += `3. Après toutes les corrections, exécutez :\n`;
+        text += `   - \`rgaa_recheck("${result.auditId}")\` pour mesurer le delta (1 token)\n`;
+        text += `4. Si le score < ${targetScore}%, relancez \`rgaa_remediate\` pour le cycle suivant\n`;
+        text += `5. Vérifiez visuellement avec \`browser_screenshot\` que le rendu n'est pas cassé\n`;
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        return { content: [{ type: 'text', text: `Erreur : ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+    }
+});
+// ── Outil 7 : rgaa_recheck ──
+server.tool('rgaa_recheck', 'Re-check rapide : re-scanne les mêmes pages d\'un audit existant sans redécouvrir le site. Retourne le delta (score avant/après, violations résolues/nouvelles). Consomme 1 token du plan. Utilisez après avoir corrigé des violations pour mesurer l\'amélioration.', {
+    auditId: z.string().describe('ID de l\'audit à re-checker (retourné par rgaa_audit ou rgaa_report)'),
+}, async ({ auditId }) => {
+    try {
+        const result = await callRecheck(auditId);
+        const deltaSign = result.score > result.previousScore ? '+' : '';
+        const violFixedText = result.violationsDelta > 0
+            ? `${result.violationsDelta} violation(s) corrigée(s)`
+            : result.violationsDelta < 0
+                ? `${Math.abs(result.violationsDelta)} nouvelle(s) violation(s)`
+                : 'Même nombre de violations';
+        const text = `# Re-check RGAA — ${result.url}\n\n` +
+            `| Métrique | Avant | Après | Delta |\n` +
+            `|----------|-------|-------|-------|\n` +
+            `| Score | ${result.previousScore}% | ${result.score}% | ${deltaSign}${result.score - result.previousScore} |\n` +
+            `| Violations | ${result.previousViolations} | ${result.violations} | ${result.violationsDelta > 0 ? '-' : '+'}${Math.abs(result.violationsDelta)} |\n\n` +
+            `**${result.message}**\n\n` +
+            `${violFixedText}\n\n` +
+            `- Audit précédent : ${result.parentAuditId}\n` +
+            `- Nouvel audit : ${result.newAuditId}\n\n` +
+            `Pour voir le détail des violations restantes, lancez \`rgaa_audit\` avec l'URL ou consultez l'audit dans l'interface.`;
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        return { content: [{ type: 'text', text: `Erreur : ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+    }
+});
+// ── Outil 8 : rgaa_visual_check ──
+/**
+ * Checklist de vérification visuelle structurée.
+ * Chaque étape dit à l'agent quoi faire avec Browser MCP et quoi vérifier.
+ */
+const VISUAL_CHECKS = [
+    {
+        id: 'skip-link',
+        criteria: '12.7',
+        title: 'Lien d\'évitement visible au focus',
+        steps: [
+            'browser_navigate vers l\'URL',
+            'browser_press_key("Tab") — 1 fois',
+            'browser_screenshot — capturer l\'état du focus',
+        ],
+        lookFor: 'Un lien "Aller au contenu" doit apparaître en haut de page au premier Tab. S\'il est invisible ou absent, c\'est une violation.',
+    },
+    {
+        id: 'focus-visible',
+        criteria: '10.7',
+        title: 'Indicateur de focus visible sur les éléments interactifs',
+        steps: [
+            'browser_press_key("Tab") — 5 fois successives',
+            'browser_screenshot à chaque Tab',
+        ],
+        lookFor: 'Chaque élément focusé (lien, bouton, champ) doit avoir un contour/outline visible. Si le focus est invisible (pas de ring, pas de bordure), c\'est une violation.',
+    },
+    {
+        id: 'contrast-visual',
+        criteria: '3.3',
+        title: 'Contraste visuel — zones potentiellement problématiques',
+        steps: [
+            'browser_screenshot de la page complète',
+            'Examiner le footer, les badges, les textes muted/secondaires',
+        ],
+        lookFor: 'Texte gris clair sur fond blanc, texte clair sur fond coloré, badges/tags peu contrastés. Les zones footer et navigation sont souvent problématiques.',
+    },
+    {
+        id: 'responsive-320',
+        criteria: '10.11',
+        title: 'Responsive — pas de scroll horizontal à 320px',
+        steps: [
+            'browser_press_key avec Ctrl+Shift+M (toggle device mode) ou resize la fenêtre à 320px de large',
+            'browser_screenshot',
+        ],
+        lookFor: 'Aucun contenu ne doit déborder horizontalement. Pas de barre de scroll horizontal. Le texte doit rester lisible.',
+    },
+    {
+        id: 'heading-hierarchy',
+        criteria: '9.1',
+        title: 'Hiérarchie de titres logique',
+        steps: [
+            'browser_snapshot — lire l\'arbre d\'accessibilité',
+            'Lister tous les headings (h1-h6) dans l\'ordre',
+        ],
+        lookFor: 'Un seul h1, puis h2, h3 dans l\'ordre. Pas de saut (h1→h4). Pas de h1 manquant. Vérifier que le h1 décrit le contenu principal.',
+    },
+    {
+        id: 'images-alt',
+        criteria: '1.1',
+        title: 'Images informatives avec alternative textuelle',
+        steps: [
+            'browser_snapshot — chercher toutes les images dans l\'arbre d\'accessibilité',
+        ],
+        lookFor: 'Chaque image informative doit avoir un alt descriptif. Les images décoratives doivent avoir alt="". Les icônes dans les boutons/liens doivent être aria-hidden avec un texte accessible sur le parent.',
+    },
+    {
+        id: 'form-labels',
+        criteria: '11.1',
+        title: 'Champs de formulaire avec étiquettes',
+        steps: [
+            'browser_snapshot — chercher les champs input/select/textarea',
+        ],
+        lookFor: 'Chaque champ doit avoir un label associé (via for/id ou aria-label). Les placeholder seuls ne sont PAS des labels valides.',
+    },
+    {
+        id: 'new-window',
+        criteria: '13.2',
+        title: 'Liens ouvrant une nouvelle fenêtre',
+        steps: [
+            'browser_snapshot — chercher les liens avec target="_blank"',
+        ],
+        lookFor: 'Chaque lien target="_blank" doit indiquer "(nouvelle fenêtre)" en texte, sr-only, ou via une icône avec aria-label.',
+    },
+    {
+        id: 'keyboard-nav',
+        criteria: '12.8',
+        title: 'Navigation clavier complète',
+        steps: [
+            'browser_press_key("Tab") — naviguer dans toute la page',
+            'browser_press_key("Enter") sur les boutons/liens',
+            'browser_press_key("Escape") pour fermer les modales',
+        ],
+        lookFor: 'Tous les éléments interactifs doivent être atteignables au clavier. Pas de piège (impossible de sortir d\'un élément). L\'ordre de tabulation doit suivre l\'ordre visuel.',
+    },
+    {
+        id: 'landmarks',
+        criteria: '12.9',
+        title: 'Zones principales identifiées par des landmarks',
+        steps: [
+            'browser_snapshot — vérifier la structure de la page',
+        ],
+        lookFor: 'La page doit avoir : header (banner), nav (navigation), main, footer (contentinfo). Chaque zone doit être un landmark sémantique.',
+    },
+];
+server.tool('rgaa_visual_check', 'Génère une checklist de vérification visuelle pour l\'agent AI. Chaque étape indique quoi faire avec Browser MCP (navigate, screenshot, snapshot, Tab) et quoi vérifier visuellement. Couvre les critères que axe-core ne peut pas détecter automatiquement.', {
+    url: z.string().url().describe('URL de la page à vérifier visuellement'),
+    checks: z.array(z.string()).optional().describe('Liste d\'IDs de vérifications à effectuer (défaut: toutes). IDs: skip-link, focus-visible, contrast-visual, responsive-320, heading-hierarchy, images-alt, form-labels, new-window, keyboard-nav, landmarks'),
+}, async ({ url, checks }) => {
+    const selectedChecks = checks && checks.length > 0
+        ? VISUAL_CHECKS.filter(c => checks.includes(c.id))
+        : VISUAL_CHECKS;
+    let text = `# Vérification visuelle RGAA — ${url}\n\n`;
+    text += `**${selectedChecks.length} vérifications** à effectuer avec Browser MCP.\n`;
+    text += `Chaque étape indique les actions Browser MCP à exécuter et ce qu'il faut vérifier.\n\n`;
+    text += `---\n\n`;
+    for (const [i, check] of selectedChecks.entries()) {
+        text += `## ${i + 1}. ${check.title} (RGAA ${check.criteria})\n\n`;
+        text += `**Actions** :\n`;
+        for (const step of check.steps) {
+            text += `1. \`${step}\`\n`;
+        }
+        text += `\n**Ce qu'il faut vérifier** : ${check.lookFor}\n\n`;
+        text += `---\n\n`;
+    }
+    text += `## Instructions pour l'agent\n\n`;
+    text += `1. Commencez par \`browser_navigate("${url}")\`\n`;
+    text += `2. Exécutez chaque vérification dans l'ordre\n`;
+    text += `3. Pour chaque problème trouvé, notez le critère RGAA et la description\n`;
+    text += `4. Après toutes les vérifications, résumez les problèmes trouvés\n`;
+    text += `5. Utilisez \`rgaa_fix\` pour obtenir le code correctif de chaque problème\n`;
+    return { content: [{ type: 'text', text }] };
+});
+// ── Outil 9 : rgaa_report ──
 server.tool('rgaa_report', 'Génère un rapport d\'audit RGAA structuré en JSON pour intégration CI/CD ou export.', {
     url: z.string().url().describe('URL du site web'),
     threshold: z.number().min(0).max(100).default(0).describe('Score minimum pour pass/fail (0 = pas de seuil)'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rgaaudit/mcp-server",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "MCP Server RGAA 4.1 — Audit d'accessibilité pour Claude Code, Cursor, Copilot",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,16 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "keywords": ["mcp", "rgaa", "accessibility", "a11y", "wcag", "audit", "france", "rgaa4"],
+  "keywords": [
+    "mcp",
+    "rgaa",
+    "accessibility",
+    "a11y",
+    "wcag",
+    "audit",
+    "france",
+    "rgaa4"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",