ultra11y 5.9.0 → 5.9.1

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "name": "ultra11y",
       "source": "./",
       "description": "Automatic accessibility review of the code under change before every commit, push and pull request, plus full WCAG 2.2 AA / RGAA audits and conformance deliverables on demand.",
-      "version": "5.9.0",
+      "version": "5.9.1",
       "author": { "name": "maxgfr" },
       "homepage": "https://github.com/maxgfr/ultra11y",
       "repository": "https://github.com/maxgfr/ultra11y",

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ultra11y",
   "description": "Accessibility for WCAG 2.2 AA and country standards (RGAA…): an automatic review of the code under change before every commit, push and pull request, plus full audits and conformance deliverables on demand.",
-  "version": "5.9.0",
+  "version": "5.9.1",
   "author": { "name": "maxgfr" },
   "homepage": "https://github.com/maxgfr/ultra11y",
   "repository": "https://github.com/maxgfr/ultra11y",

package/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ultra11y",
   "description": "Accessibility for WCAG 2.2 AA and country standards (RGAA…): an automatic review of the code under change before every commit, push and pull request, plus full audits and conformance deliverables on demand.",
-  "version": "5.9.0",
+  "version": "5.9.1",
   "author": { "name": "maxgfr", "url": "https://github.com/maxgfr" },
   "homepage": "https://github.com/maxgfr/ultra11y",
   "repository": "https://github.com/maxgfr/ultra11y",

package/.opencode/plugins/ultra11y.js

@@ -27,7 +27,7 @@ import { fileURLToPath } from "node:url";
 // Ownership marker: `ultra11y install --opencode` refuses to overwrite a plugin file that
 // does not carry it, so a user's own ultra11y.js is never clobbered.
 const ULTRA11Y_OPENCODE_PLUGIN = "ULTRA11Y_OPENCODE_PLUGIN";
-const ULTRA11Y_PLUGIN_VERSION = "5.9.0";
+const ULTRA11Y_PLUGIN_VERSION = "5.9.1";
 
 const here = dirname(fileURLToPath(import.meta.url));
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultra11y",
-  "version": "5.9.0",
+  "version": "5.9.1",
   "description": "Audit HTML/CSS/JSX against WCAG 2.2 AA and produce a dated compliance report, or author/review accessible markup (native-HTML-first). A skills.sh agent skill: an install-free static engine (bundled, no npm install) plus the agent's judgment, with check/verify gates against hallucinated non-conformities, and pluggable in-repo standards packs (RGAA France first; Section 508 & EN 301 549 next).",
   "type": "module",
   "packageManager": "pnpm@10.33.0",

package/scripts/ultra11y.mjs

@@ -6,7 +6,7 @@ import { join as join51, relative as relative5, resolve as resolve16, sep as sep
 import { fileURLToPath as fileURLToPath5, pathToFileURL as pathToFileURL3 } from "url";
 
 // src/types.ts
-var VERSION = "5.9.0";
+var VERSION = "5.9.1";
 var SCHEMA_VERSION = 2;
 
 // src/audit.ts
@@ -57794,10 +57794,11 @@ function applyAdjudication(audit2, adj, opts = {}) {
   let scopeCache;
   const { citationDrift } = adjudicationLimits(opts.cwd);
   const scopeFiles = () => scopeCache ??= auditFiles(audit2, opts.cwd);
-  const toGround = (criteriaId, g) => {
+  const toGround = (criteriaId, g, fallback) => {
+    const entry = { g, ...fallback ? { fallback } : {} };
     const list = groundInputs.get(criteriaId);
-    if (list) list.push(g);
-    else groundInputs.set(criteriaId, [g]);
+    if (list) list.push(entry);
+    else groundInputs.set(criteriaId, [entry]);
   };
   for (const it of adj.items) {
     const v = it.verdict;
@@ -57831,18 +57832,15 @@ function applyAdjudication(audit2, adj, opts = {}) {
             blame(it.criteriaId, `criterion ${it.criteriaId}: citation ${c2.file}:${c2.line} is not among this criterion's harvested evidence (fabricated?)`);
           }
           const anchor = anchorFor(it.evidence, c2, citationDrift);
-          if (anchor && !recognisablySame(c2, anchor.at)) {
-            blame(
+          const cite = { file: c2.file, line: c2.line, selector: c2.selector, snippet: c2.snippet };
+          if (anchor && recognisablySame(c2, anchor.at)) {
+            toGround(
               it.criteriaId,
-              `criterion ${it.criteriaId}: citation ${c2.file}:${c2.line} does not describe the element harvested there (${anchor.at.snippet ? `\`${anchor.at.snippet.slice(0, 80)}\`` : `<${tagOf2(anchor.at)}>`}) \u2014 cite the element you actually read, copying its \`snippet\` from the brief`
+              cite,
+              anchor.representative ? { file: anchor.at.file, line: anchor.at.line, selector: anchor.at.selector ?? c2.selector, snippet: anchor.at.snippet } : { file: c2.file, line: c2.line, selector: anchor.at.selector ?? c2.selector }
             );
-          }
-          if (anchor?.representative) {
-            toGround(it.criteriaId, { file: anchor.at.file, line: anchor.at.line, selector: anchor.at.selector ?? c2.selector, snippet: anchor.at.snippet });
-          } else if (anchor) {
-            toGround(it.criteriaId, { file: c2.file, line: c2.line, selector: anchor.at.selector ?? c2.selector });
           } else {
-            toGround(it.criteriaId, { file: c2.file, line: c2.line, selector: c2.selector, snippet: c2.snippet });
+            toGround(it.criteriaId, cite);
           }
         }
       }
@@ -57869,8 +57867,12 @@ function applyAdjudication(audit2, adj, opts = {}) {
   }
   const grounding = { grounded: 0, moved: 0, failed: 0, issues: [] };
   for (const [criteriaId, inputs] of groundInputs) {
-    for (const input of inputs) {
-      const r = groundFinding(input, { cwd: opts.cwd });
+    for (const { g, fallback } of inputs) {
+      let r = groundFinding(g, { cwd: opts.cwd });
+      if (!r.ok && fallback) {
+        const viaAnchor = groundFinding(fallback, { cwd: opts.cwd });
+        if (viaAnchor.ok) r = { ok: true, moved: true };
+      }
       if (r.ok) {
         grounding.grounded++;
         if (r.moved) grounding.moved++;

package/skills/review-a11y/SKILL.md

@@ -5,7 +5,7 @@ when_to_use: "Invoke WITHOUT being asked whenever changed front-end code should
 allowed-tools: Bash(node ${CLAUDE_SKILL_DIR}/scripts/ultra11y.mjs *), Read, Grep, Glob
 license: MIT
 metadata:
-  version: 5.9.0
+  version: 5.9.1
 ---
 
 # review-a11y — accessibility review of changed code

package/skills/review-a11y/scripts/ultra11y.mjs

@@ -6,7 +6,7 @@ import { join as join51, relative as relative5, resolve as resolve16, sep as sep
 import { fileURLToPath as fileURLToPath5, pathToFileURL as pathToFileURL3 } from "url";
 
 // src/types.ts
-var VERSION = "5.9.0";
+var VERSION = "5.9.1";
 var SCHEMA_VERSION = 2;
 
 // src/audit.ts
@@ -57794,10 +57794,11 @@ function applyAdjudication(audit2, adj, opts = {}) {
   let scopeCache;
   const { citationDrift } = adjudicationLimits(opts.cwd);
   const scopeFiles = () => scopeCache ??= auditFiles(audit2, opts.cwd);
-  const toGround = (criteriaId, g) => {
+  const toGround = (criteriaId, g, fallback) => {
+    const entry = { g, ...fallback ? { fallback } : {} };
     const list = groundInputs.get(criteriaId);
-    if (list) list.push(g);
-    else groundInputs.set(criteriaId, [g]);
+    if (list) list.push(entry);
+    else groundInputs.set(criteriaId, [entry]);
   };
   for (const it of adj.items) {
     const v = it.verdict;
@@ -57831,18 +57832,15 @@ function applyAdjudication(audit2, adj, opts = {}) {
             blame(it.criteriaId, `criterion ${it.criteriaId}: citation ${c2.file}:${c2.line} is not among this criterion's harvested evidence (fabricated?)`);
           }
           const anchor = anchorFor(it.evidence, c2, citationDrift);
-          if (anchor && !recognisablySame(c2, anchor.at)) {
-            blame(
+          const cite = { file: c2.file, line: c2.line, selector: c2.selector, snippet: c2.snippet };
+          if (anchor && recognisablySame(c2, anchor.at)) {
+            toGround(
               it.criteriaId,
-              `criterion ${it.criteriaId}: citation ${c2.file}:${c2.line} does not describe the element harvested there (${anchor.at.snippet ? `\`${anchor.at.snippet.slice(0, 80)}\`` : `<${tagOf2(anchor.at)}>`}) \u2014 cite the element you actually read, copying its \`snippet\` from the brief`
+              cite,
+              anchor.representative ? { file: anchor.at.file, line: anchor.at.line, selector: anchor.at.selector ?? c2.selector, snippet: anchor.at.snippet } : { file: c2.file, line: c2.line, selector: anchor.at.selector ?? c2.selector }
             );
-          }
-          if (anchor?.representative) {
-            toGround(it.criteriaId, { file: anchor.at.file, line: anchor.at.line, selector: anchor.at.selector ?? c2.selector, snippet: anchor.at.snippet });
-          } else if (anchor) {
-            toGround(it.criteriaId, { file: c2.file, line: c2.line, selector: anchor.at.selector ?? c2.selector });
           } else {
-            toGround(it.criteriaId, { file: c2.file, line: c2.line, selector: c2.selector, snippet: c2.snippet });
+            toGround(it.criteriaId, cite);
           }
         }
       }
@@ -57869,8 +57867,12 @@ function applyAdjudication(audit2, adj, opts = {}) {
   }
   const grounding = { grounded: 0, moved: 0, failed: 0, issues: [] };
   for (const [criteriaId, inputs] of groundInputs) {
-    for (const input of inputs) {
-      const r = groundFinding(input, { cwd: opts.cwd });
+    for (const { g, fallback } of inputs) {
+      let r = groundFinding(g, { cwd: opts.cwd });
+      if (!r.ok && fallback) {
+        const viaAnchor = groundFinding(fallback, { cwd: opts.cwd });
+        if (viaAnchor.ok) r = { ok: true, moved: true };
+      }
       if (r.ok) {
         grounding.grounded++;
         if (r.moved) grounding.moved++;

package/skills/ultra11y/SKILL.md

@@ -4,7 +4,7 @@ description: "Use to AUDIT existing HTML/CSS/JSX against WCAG 2.2 AA accessibili
 when_to_use: "Invoke when the user asks for an accessibility AUDIT or a formal deliverable: audit a repo, site or page against WCAG 2.2 AA or a country standard (RGAA, Section 508, EN 301 549); produce a dated conformance report, a criterion grid, a PRD backlog, or tickets (GitHub/GitLab/Jira); author accessible markup from scratch; wire the repo gate (init --hook/--ci) or a rendered-DOM capture pipeline. For a review of the code UNDER CHANGE (diff, branch, PR), use the `review-a11y` skill instead."
 license: MIT
 metadata:
-  version: 5.9.0
+  version: 5.9.1
 ---
 
 # ultra11y — audit WCAG 2.2 AA and write accessible markup

package/skills/ultra11y/scripts/ultra11y.mjs

@@ -6,7 +6,7 @@ import { join as join51, relative as relative5, resolve as resolve16, sep as sep
 import { fileURLToPath as fileURLToPath5, pathToFileURL as pathToFileURL3 } from "url";
 
 // src/types.ts
-var VERSION = "5.9.0";
+var VERSION = "5.9.1";
 var SCHEMA_VERSION = 2;
 
 // src/audit.ts
@@ -57794,10 +57794,11 @@ function applyAdjudication(audit2, adj, opts = {}) {
   let scopeCache;
   const { citationDrift } = adjudicationLimits(opts.cwd);
   const scopeFiles = () => scopeCache ??= auditFiles(audit2, opts.cwd);
-  const toGround = (criteriaId, g) => {
+  const toGround = (criteriaId, g, fallback) => {
+    const entry = { g, ...fallback ? { fallback } : {} };
     const list = groundInputs.get(criteriaId);
-    if (list) list.push(g);
-    else groundInputs.set(criteriaId, [g]);
+    if (list) list.push(entry);
+    else groundInputs.set(criteriaId, [entry]);
   };
   for (const it of adj.items) {
     const v = it.verdict;
@@ -57831,18 +57832,15 @@ function applyAdjudication(audit2, adj, opts = {}) {
             blame(it.criteriaId, `criterion ${it.criteriaId}: citation ${c2.file}:${c2.line} is not among this criterion's harvested evidence (fabricated?)`);
           }
           const anchor = anchorFor(it.evidence, c2, citationDrift);
-          if (anchor && !recognisablySame(c2, anchor.at)) {
-            blame(
+          const cite = { file: c2.file, line: c2.line, selector: c2.selector, snippet: c2.snippet };
+          if (anchor && recognisablySame(c2, anchor.at)) {
+            toGround(
               it.criteriaId,
-              `criterion ${it.criteriaId}: citation ${c2.file}:${c2.line} does not describe the element harvested there (${anchor.at.snippet ? `\`${anchor.at.snippet.slice(0, 80)}\`` : `<${tagOf2(anchor.at)}>`}) \u2014 cite the element you actually read, copying its \`snippet\` from the brief`
+              cite,
+              anchor.representative ? { file: anchor.at.file, line: anchor.at.line, selector: anchor.at.selector ?? c2.selector, snippet: anchor.at.snippet } : { file: c2.file, line: c2.line, selector: anchor.at.selector ?? c2.selector }
             );
-          }
-          if (anchor?.representative) {
-            toGround(it.criteriaId, { file: anchor.at.file, line: anchor.at.line, selector: anchor.at.selector ?? c2.selector, snippet: anchor.at.snippet });
-          } else if (anchor) {
-            toGround(it.criteriaId, { file: c2.file, line: c2.line, selector: anchor.at.selector ?? c2.selector });
           } else {
-            toGround(it.criteriaId, { file: c2.file, line: c2.line, selector: c2.selector, snippet: c2.snippet });
+            toGround(it.criteriaId, cite);
           }
         }
       }
@@ -57869,8 +57867,12 @@ function applyAdjudication(audit2, adj, opts = {}) {
   }
   const grounding = { grounded: 0, moved: 0, failed: 0, issues: [] };
   for (const [criteriaId, inputs] of groundInputs) {
-    for (const input of inputs) {
-      const r = groundFinding(input, { cwd: opts.cwd });
+    for (const { g, fallback } of inputs) {
+      let r = groundFinding(g, { cwd: opts.cwd });
+      if (!r.ok && fallback) {
+        const viaAnchor = groundFinding(fallback, { cwd: opts.cwd });
+        if (viaAnchor.ok) r = { ok: true, moved: true };
+      }
       if (r.ok) {
         grounding.grounded++;
         if (r.moved) grounding.moved++;

package/src/adjudicate.ts

@@ -732,15 +732,21 @@ export function applyAdjudication(
   // Per-item fail-closed validation. Grounding inputs are collected PER ITEM (not into one
   // flat list) for the same reason as `blame`: a failed citation has to condemn its own
   // criterion and no other.
-  const groundInputs = new Map<string, { file: string; line: number; selector?: string; snippet?: string }[]>();
+  type Ground = { file: string; line: number; selector?: string; snippet?: string };
+  const groundInputs = new Map<string, { g: Ground; fallback?: Ground }[]>();
   // Memoised: only a citation that missed its criterion's own anchors ever asks for it.
   let scopeCache: Set<string> | undefined;
   const { citationDrift } = adjudicationLimits(opts.cwd);
   const scopeFiles = (): Set<string> => (scopeCache ??= auditFiles(audit, opts.cwd));
-  const toGround = (criteriaId: string, g: { file: string; line: number; selector?: string; snippet?: string }) => {
+  const toGround = (
+    criteriaId: string,
+    g: { file: string; line: number; selector?: string; snippet?: string },
+    fallback?: { file: string; line: number; selector?: string; snippet?: string },
+  ) => {
+    const entry = { g, ...(fallback ? { fallback } : {}) };
     const list = groundInputs.get(criteriaId);
-    if (list) list.push(g);
-    else groundInputs.set(criteriaId, [g]);
+    if (list) list.push(entry);
+    else groundInputs.set(criteriaId, [entry]);
   };
   for (const it of adj.items) {
     const v = it.verdict;
@@ -839,19 +845,33 @@ export function applyAdjudication(
           //
           // Anything OUTSIDE the harvest keeps the strict check below, unchanged. That is where
           // a fabricated location would hide, and this must not become a way to launder one.
+          // THE CITATION FIRST, THE ANCHOR ONLY AS A FALLBACK — and the order is the whole
+          // point.
+          //
+          // Whatever the agent wrote is checked against the real file, exactly as before. That
+          // is the strongest proof there is, and it covers the case the drift window exists
+          // for: RGAA 5.2 asks about a table's summary, the harvest anchors the `<table>`, and
+          // the honest citation is the `<caption>` a line below. Grounding the anchor INSTEAD
+          // refused precisely that — measured on a real run, 5.2, 5.4, 5.5, 11.6, 11.7 and
+          // 11.9 all died on it, each a correct citation of a neighbour.
+          //
+          // Only when the citation does not ground — which is what a RETYPING looks like, and
+          // on a one-line snapshot that is most of them — does the harvested anchor stand in.
+          // It is authoritative there: the engine read it out of the file itself. And only
+          // then does recognisability have anything to say, because only then is the anchor
+          // being used to vouch for something the file did not confirm on its own.
           const anchor = anchorFor(it.evidence, c, citationDrift);
-          if (anchor && !recognisablySame(c, anchor.at)) {
-            blame(
+          const cite = { file: c.file, line: c.line, selector: c.selector, snippet: c.snippet };
+          if (anchor && recognisablySame(c, anchor.at)) {
+            toGround(
               it.criteriaId,
-              `criterion ${it.criteriaId}: citation ${c.file}:${c.line} does not describe the element harvested there (${anchor.at.snippet ? `\`${anchor.at.snippet.slice(0, 80)}\`` : `<${tagOf(anchor.at)}>`}) — cite the element you actually read, copying its \`snippet\` from the brief`,
+              cite,
+              anchor.representative
+                ? { file: anchor.at.file, line: anchor.at.line, selector: anchor.at.selector ?? c.selector, snippet: anchor.at.snippet }
+                : { file: c.file, line: c.line, selector: anchor.at.selector ?? c.selector },
             );
-          }
-          if (anchor?.representative) {
-            toGround(it.criteriaId, { file: anchor.at.file, line: anchor.at.line, selector: anchor.at.selector ?? c.selector, snippet: anchor.at.snippet });
-          } else if (anchor) {
-            toGround(it.criteriaId, { file: c.file, line: c.line, selector: anchor.at.selector ?? c.selector });
           } else {
-            toGround(it.criteriaId, { file: c.file, line: c.line, selector: c.selector, snippet: c.snippet });
+            toGround(it.criteriaId, cite);
           }
         }
       }
@@ -893,8 +913,15 @@ export function applyAdjudication(
   // flat `groundItems` produced.
   const grounding: GroundingSummary = { grounded: 0, moved: 0, failed: 0, issues: [] };
   for (const [criteriaId, inputs] of groundInputs) {
-    for (const input of inputs) {
-      const r = groundFinding(input, { cwd: opts.cwd });
+    for (const { g, fallback } of inputs) {
+      let r = groundFinding(g, { cwd: opts.cwd });
+      // The harvested anchor vouches for a citation the file could not confirm on its own —
+      // an adjudicator's retyping of an element it did read. `moved` either way: what
+      // grounded is not verbatim what was cited.
+      if (!r.ok && fallback) {
+        const viaAnchor = groundFinding(fallback, { cwd: opts.cwd });
+        if (viaAnchor.ok) r = { ok: true, moved: true };
+      }
       if (r.ok) {
         grounding.grounded++;
         if (r.moved) grounding.moved++;

package/src/types.ts

@@ -1,6 +1,6 @@
 // Single source of truth for shared types + the embedded version. sync-version.mjs
 // rewrites VERSION at release time (kept in lockstep with package.json + SKILL.md).
-export const VERSION = "5.9.0";
+export const VERSION = "5.9.1";
 export const SCHEMA_VERSION = 2;
 
 // Lang = the UI FRAME's language — the `L` localization tables each module (report,