ultra11y 5.10.0 → 5.11.0

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.10.0",
+      "version": "5.11.0",
       "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.10.0",
+  "version": "5.11.0",
   "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.10.0",
+  "version": "5.11.0",
   "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.10.0";
+const ULTRA11Y_PLUGIN_VERSION = "5.11.0";
 
 const here = dirname(fileURLToPath(import.meta.url));
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultra11y",
-  "version": "5.10.0",
+  "version": "5.11.0",
   "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.10.0";
+var VERSION = "5.11.0";
 var SCHEMA_VERSION = 2;
 
 // src/audit.ts
@@ -58208,10 +58208,16 @@ function writeAdjudication(items, outDir, opts) {
   return { todoPath, mdPath, verdictsPath, itemsDir, count: items.length };
 }
 var PREFILLED_CITATIONS = 3;
+var CITATION_SNIPPET_MAX = 120;
 function slimAdjudicationItems(items) {
   return items.map((it) => {
     const { evidence: _evidence, evidenceTruncated: _truncated, ...rest } = it;
-    const citations = it.evidence.slice(0, PREFILLED_CITATIONS).map((e) => ({ ...e }));
+    const citations = it.evidence.slice(0, PREFILLED_CITATIONS).map((e) => ({
+      file: e.file,
+      line: e.line,
+      ...e.selector ? { selector: e.selector } : {},
+      ...e.snippet ? { snippet: e.snippet.slice(0, CITATION_SNIPPET_MAX) } : {}
+    }));
     return { ...rest, evidence: [], ...citations.length ? { citations } : {} };
   });
 }

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.10.0
+  version: 5.11.0
 ---
 
 # 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.10.0";
+var VERSION = "5.11.0";
 var SCHEMA_VERSION = 2;
 
 // src/audit.ts
@@ -58208,10 +58208,16 @@ function writeAdjudication(items, outDir, opts) {
   return { todoPath, mdPath, verdictsPath, itemsDir, count: items.length };
 }
 var PREFILLED_CITATIONS = 3;
+var CITATION_SNIPPET_MAX = 120;
 function slimAdjudicationItems(items) {
   return items.map((it) => {
     const { evidence: _evidence, evidenceTruncated: _truncated, ...rest } = it;
-    const citations = it.evidence.slice(0, PREFILLED_CITATIONS).map((e) => ({ ...e }));
+    const citations = it.evidence.slice(0, PREFILLED_CITATIONS).map((e) => ({
+      file: e.file,
+      line: e.line,
+      ...e.selector ? { selector: e.selector } : {},
+      ...e.snippet ? { snippet: e.snippet.slice(0, CITATION_SNIPPET_MAX) } : {}
+    }));
     return { ...rest, evidence: [], ...citations.length ? { citations } : {} };
   });
 }

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.10.0
+  version: 5.11.0
 ---
 
 # ultra11y — audit WCAG 2.2 AA and write accessible markup

package/skills/ultra11y/references/ci.md

@@ -107,6 +107,14 @@ the refreshed ledger, and a pull-request job that only replays it.
 
 ## Adjudicating the judgment criteria in CI (`adjudicate`)
 
+> **One pass is not always enough, and not because of the criteria.** The adjudicator can stop
+> early: measured on a real run, `num_turns: 22` against a budget of 228, `is_error: false`, and
+> 42 criteria still `verdict: null` — a whole worklist abandoned with no error to show for it.
+> `adjudicate-passes: "3"` sends it round again on the residue. Each pass re-derives the worklist
+> with `verify --manual`, which by construction holds only what is still `manual` (never reached,
+> or ruled and refused by the gate, carrying its refusal), so a pass costs the remainder and
+> nothing more — and a run that decided everything skips the rest before any model is invoked.
+
 `adjudicate` is what FILLS the ledger — opt-in, in two modes. It runs **after** the replay, so a
 paid pass only ever covers what the ledger did not: on a repository whose ledger is current, it
 has nothing left to rule on and costs nothing.
@@ -126,6 +134,7 @@ steps:
 | `adjudicate` | `none` | `api` · `agent` · `none` |
 | `adjudicate-model` | *(empty)* | model id for `api`; else `$ULTRA11Y_LLM_MODEL`, else the engine default |
 | `adjudicate-max-turns` | *(empty)* | turn budget for `agent`; empty derives it from the worklist |
+| `adjudicate-passes` | `1` | how many times `agent` may go round; each pass re-derives the worklist from what is STILL undecided. Capped at 3 |
 | `gate-adjudicated` | `false` | let a model-ruled NC fail the job |
 
 **The turn budget is derived, and that matters more than it sounds.** The runbook is sequential

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.10.0";
+var VERSION = "5.11.0";
 var SCHEMA_VERSION = 2;
 
 // src/audit.ts
@@ -58208,10 +58208,16 @@ function writeAdjudication(items, outDir, opts) {
   return { todoPath, mdPath, verdictsPath, itemsDir, count: items.length };
 }
 var PREFILLED_CITATIONS = 3;
+var CITATION_SNIPPET_MAX = 120;
 function slimAdjudicationItems(items) {
   return items.map((it) => {
     const { evidence: _evidence, evidenceTruncated: _truncated, ...rest } = it;
-    const citations = it.evidence.slice(0, PREFILLED_CITATIONS).map((e) => ({ ...e }));
+    const citations = it.evidence.slice(0, PREFILLED_CITATIONS).map((e) => ({
+      file: e.file,
+      line: e.line,
+      ...e.selector ? { selector: e.selector } : {},
+      ...e.snippet ? { snippet: e.snippet.slice(0, CITATION_SNIPPET_MAX) } : {}
+    }));
     return { ...rest, evidence: [], ...citations.length ? { citations } : {} };
   });
 }

package/src/adjudicate.ts

@@ -1450,6 +1450,10 @@ export function writeAdjudication(
  *  for the population; the whole set is in the brief, and `occurrences` travels with each. */
 const PREFILLED_CITATIONS = 3;
 
+/** Characters of the snippet a pre-filled citation carries. Enough to identify the element to
+ *  a reader of the diff; the grounding matches on the anchor, not on the length. */
+const CITATION_SNIPPET_MAX = 120;
+
 export function slimAdjudicationItems(items: AdjudicationItem[]): AdjudicationItem[] {
   return items.map((it) => {
     const { evidence: _evidence, evidenceTruncated: _truncated, ...rest } = it;
@@ -1471,7 +1475,18 @@ export function slimAdjudicationItems(items: AdjudicationItem[]): AdjudicationIt
     // `population` and `evidenceComplete` are kept for the same reason they always were: they
     // are two numbers, not bulk, and they tell the adjudicator how much of the subject it is
     // actually looking at.
-    const citations = it.evidence.slice(0, PREFILLED_CITATIONS).map((e) => ({ ...e }));
+    // MINIMAL, and that is not a detail: the first cut of this pre-filled the whole Evidence
+    // object, `alsoAt` included — 167 sibling anchors on one criterion — and turned the file
+    // the prompt calls "the small one to write" into 367 KB. Measured: the adjudicator stopped
+    // after 22 turns of a 228 budget, filled nothing, and every criterion came back
+    // `unadjudicated`. A citation only ever needs to say WHICH element; the population, the
+    // siblings and the note belong to the brief, which is the file to READ.
+    const citations = it.evidence.slice(0, PREFILLED_CITATIONS).map((e) => ({
+      file: e.file,
+      line: e.line,
+      ...(e.selector ? { selector: e.selector } : {}),
+      ...(e.snippet ? { snippet: e.snippet.slice(0, CITATION_SNIPPET_MAX) } : {}),
+    }));
     return { ...rest, evidence: [], ...(citations.length ? { citations } : {}) } as AdjudicationItem;
   });
 }

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.10.0";
+export const VERSION = "5.11.0";
 export const SCHEMA_VERSION = 2;
 
 // Lang = the UI FRAME's language — the `L` localization tables each module (report,