ultra11y 5.44.0 → 5.45.0

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "name": "ultra11y",
       "source": "./",
       "description": "Automatic accessibility review before commit, push and pull request, plus detailed evidenced Markdown, HTML and per-page WCAG 2.2 AA / RGAA reports in Claude Code.",
-      "version": "5.44.0",
+      "version": "5.45.0",
       "author": { "name": "maxgfr" },
       "homepage": "https://github.com/SocialGouv/ultra11y",
       "repository": "https://github.com/SocialGouv/ultra11y",

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ultra11y",
   "description": "Accessibility for WCAG 2.2 AA and country standards (RGAA…): automatic review before commit, push and pull request, plus detailed evidenced Markdown, HTML and per-page conformance reports in interactive agent sessions.",
-  "version": "5.44.0",
+  "version": "5.45.0",
   "author": { "name": "maxgfr" },
   "homepage": "https://github.com/SocialGouv/ultra11y",
   "repository": "https://github.com/SocialGouv/ultra11y",

package/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ultra11y",
   "description": "Accessibility for WCAG 2.2 AA and country standards (RGAA…): automatic review before commit, push and pull request, plus detailed evidenced Markdown, HTML and per-page conformance reports in interactive agent sessions.",
-  "version": "5.44.0",
+  "version": "5.45.0",
   "author": { "name": "maxgfr", "url": "https://github.com/maxgfr" },
   "homepage": "https://github.com/SocialGouv/ultra11y",
   "repository": "https://github.com/SocialGouv/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.44.0";
+const ULTRA11Y_PLUGIN_VERSION = "5.45.0";
 
 const here = dirname(fileURLToPath(import.meta.url));
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultra11y",
-  "version": "5.44.0",
+  "version": "5.45.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 join52, relative as relative6, resolve as resolve17, sep as sep
 import { fileURLToPath as fileURLToPath5, pathToFileURL as pathToFileURL3 } from "url";
 
 // src/types.ts
-var VERSION = "5.44.0";
+var VERSION = "5.45.0";
 var SCHEMA_VERSION = 2;
 var INAPPLICABLE_STATUS = "C";
 
@@ -66879,6 +66879,13 @@ function resolveHostAnchor(file, snippet2) {
   }
   return null;
 }
+function scanPageSummary(dynamic, sampleSize) {
+  return {
+    ...sampleSize === void 0 ? {} : { sample: sampleSize },
+    recorded: dynamic.snapshots ?? [],
+    refused: (dynamic.redirected ?? []).map((r) => ({ id: r.id, reason: r.reason }))
+  };
+}
 function mergeDynamic(audit2, dynamic, lang = "en") {
   const merged = JSON.parse(JSON.stringify(audit2));
   const seenFindings = new Set(merged.findings.map(portableFindingId));
@@ -74493,7 +74500,9 @@ Options:
                      (exit 2 with the producing command if its worklist is missing)
   --eco              orchestrate: emit only RUNBOOK.md + agents/*.md \u2014 the explicit
                      sequential low-token path (also what a no-subagent harness follows)
-  --merge <file>     scan: fold dynamic findings into this AuditResult JSON
+  --merge <file>     scan: fold dynamic findings into this AuditResult JSON. With --json the
+                     printed document opens with a 'pages' summary of the run \u2014
+                     {sample, recorded, refused:[{id, reason}]} \u2014 beside the document
   --sitemap <url>    scan: scan every URL listed in a sitemap.xml
   --crawl <url>      scan: BFS same-origin links from a start URL (served HTML)
   --depth <n>        scan: crawl link-hop depth from the start URL   (default: no limit; 0 = no limit)
@@ -77216,7 +77225,19 @@ async function cmdScan(p) {
     mkdirSync18(out2, { recursive: true });
     const mergedDocument = auditDocumentFor(merged, standard, lang);
     writeFileSync21(join52(out2, "audit-latest.json"), JSON.stringify(mergedDocument, null, 2) + "\n");
-    if (p.flags.json) console.log(JSON.stringify(mergedDocument, null, 2));
+    if (p.flags.json)
+      console.log(
+        JSON.stringify(
+          // `pages` opens the printed document: what this scan recorded (the
+          // .ultra11y/pages ids) and refused, which the stderr warnings alone don't make
+          // countable. An extra top-level key the `--in` readers never look at, so the
+          // document beside it stays pipeable into report/verify — and the file above
+          // keeps the plain audit schema.
+          { pages: scanPageSummary(dynamic, sampleConfig?.pages.length), ...mergedDocument },
+          null,
+          2
+        )
+      );
     else {
       console.log(
         lang === "fr" ? `Audit statique + dynamique fusionn\xE9 \u2192 ${join52(out2, "audit-latest.json")} (${merged.conformancePct}% r\xE9ussite, ${merged.findings.length} findings).` : `Static + dynamic audit merged \u2192 ${join52(out2, "audit-latest.json")} (${merged.conformancePct}% pass rate, ${merged.findings.length} findings).`

package/skills/review-a11y/SKILL.md

@@ -3,7 +3,7 @@ name: review-a11y
 description: "Use to REVIEW changed frontend code for accessibility: staged files, a working diff, branch, or PR; prompts such as 'review a11y', 'is this accessible?', or 'anything to fix before merge?'; and hook or CI findings on a change. Run the bundled install-free engine with cross-file JSX/TSX analysis, then adjudicate candidates and return a severity-ranked WCAG 2.2 AA review with file:line fixes, residual rendering risks, and a verdict. Use `ultra11y` instead for whole-repo audits, dated conformance reports, country standards, PRD backlogs, or authoring accessible markup."
 license: MIT
 metadata:
-  version: 5.44.0
+  version: 5.45.0
 ---
 
 # review-a11y — accessibility review of changed code

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

@@ -6,7 +6,7 @@ import { join as join52, relative as relative6, resolve as resolve17, sep as sep
 import { fileURLToPath as fileURLToPath5, pathToFileURL as pathToFileURL3 } from "url";
 
 // src/types.ts
-var VERSION = "5.44.0";
+var VERSION = "5.45.0";
 var SCHEMA_VERSION = 2;
 var INAPPLICABLE_STATUS = "C";
 
@@ -66879,6 +66879,13 @@ function resolveHostAnchor(file, snippet2) {
   }
   return null;
 }
+function scanPageSummary(dynamic, sampleSize) {
+  return {
+    ...sampleSize === void 0 ? {} : { sample: sampleSize },
+    recorded: dynamic.snapshots ?? [],
+    refused: (dynamic.redirected ?? []).map((r) => ({ id: r.id, reason: r.reason }))
+  };
+}
 function mergeDynamic(audit2, dynamic, lang = "en") {
   const merged = JSON.parse(JSON.stringify(audit2));
   const seenFindings = new Set(merged.findings.map(portableFindingId));
@@ -74493,7 +74500,9 @@ Options:
                      (exit 2 with the producing command if its worklist is missing)
   --eco              orchestrate: emit only RUNBOOK.md + agents/*.md \u2014 the explicit
                      sequential low-token path (also what a no-subagent harness follows)
-  --merge <file>     scan: fold dynamic findings into this AuditResult JSON
+  --merge <file>     scan: fold dynamic findings into this AuditResult JSON. With --json the
+                     printed document opens with a 'pages' summary of the run \u2014
+                     {sample, recorded, refused:[{id, reason}]} \u2014 beside the document
   --sitemap <url>    scan: scan every URL listed in a sitemap.xml
   --crawl <url>      scan: BFS same-origin links from a start URL (served HTML)
   --depth <n>        scan: crawl link-hop depth from the start URL   (default: no limit; 0 = no limit)
@@ -77216,7 +77225,19 @@ async function cmdScan(p) {
     mkdirSync18(out2, { recursive: true });
     const mergedDocument = auditDocumentFor(merged, standard, lang);
     writeFileSync21(join52(out2, "audit-latest.json"), JSON.stringify(mergedDocument, null, 2) + "\n");
-    if (p.flags.json) console.log(JSON.stringify(mergedDocument, null, 2));
+    if (p.flags.json)
+      console.log(
+        JSON.stringify(
+          // `pages` opens the printed document: what this scan recorded (the
+          // .ultra11y/pages ids) and refused, which the stderr warnings alone don't make
+          // countable. An extra top-level key the `--in` readers never look at, so the
+          // document beside it stays pipeable into report/verify — and the file above
+          // keeps the plain audit schema.
+          { pages: scanPageSummary(dynamic, sampleConfig?.pages.length), ...mergedDocument },
+          null,
+          2
+        )
+      );
     else {
       console.log(
         lang === "fr" ? `Audit statique + dynamique fusionn\xE9 \u2192 ${join52(out2, "audit-latest.json")} (${merged.conformancePct}% r\xE9ussite, ${merged.findings.length} findings).` : `Static + dynamic audit merged \u2192 ${join52(out2, "audit-latest.json")} (${merged.conformancePct}% pass rate, ${merged.findings.length} findings).`

package/skills/ultra11y/SKILL.md

@@ -3,7 +3,7 @@ name: ultra11y
 description: "Use to AUDIT a repository, site, or page against WCAG 2.2 AA or a country standard such as RGAA; produce a dated conformance report, criterion grid, PRD backlog, or tickets; AUTHOR accessible markup; fix accessibility; or wire a repo gate and rendered-DOM capture pipeline. The bundled install-free engine runs 93 static checks tied to success criteria, while the agent adjudicates judgment criteria and routes rendering criteria to browser scans; check/verify reject invented non-conformities. Use `review-a11y` instead for a review scoped only to a diff, branch, or PR."
 license: MIT
 metadata:
-  version: 5.44.0
+  version: 5.45.0
 ---
 
 # ultra11y — audit WCAG 2.2 AA and write accessible markup

package/skills/ultra11y/references/orchestrators.md

@@ -208,6 +208,12 @@ Read exit codes from the process, **not** from a pipeline — `cmd --json | head
   standard's own conformance rate (validated ÷ validated + NC + à évaluer, NA excluded) is
   printed by the report; derive it from `criteria[]` if a number is needed in a pipeline.
 - `check --json` → `{ ok, issues[] }`.
+- `scan --merge --json` → the merged audit document, opened by a top-level `pages` summary:
+  `{ sample, recorded[], refused: [{id, reason}] }` — the declared sample's size (`--sample`),
+  the snapshot ids written under `.ultra11y/pages/`, and the pages the scan refused with
+  their reason (the refusal warnings also go to stderr). Report the rendered layer from it —
+  captured vs refused — instead of re-deriving it from directory mtimes. The document written
+  to `--out` keeps the plain audit schema; the summary travels in stdout only.
 
 ## Honesty rules an orchestrator has to carry
 

package/skills/ultra11y/scripts/ultra11y.mjs

@@ -6,7 +6,7 @@ import { join as join52, relative as relative6, resolve as resolve17, sep as sep
 import { fileURLToPath as fileURLToPath5, pathToFileURL as pathToFileURL3 } from "url";
 
 // src/types.ts
-var VERSION = "5.44.0";
+var VERSION = "5.45.0";
 var SCHEMA_VERSION = 2;
 var INAPPLICABLE_STATUS = "C";
 
@@ -66879,6 +66879,13 @@ function resolveHostAnchor(file, snippet2) {
   }
   return null;
 }
+function scanPageSummary(dynamic, sampleSize) {
+  return {
+    ...sampleSize === void 0 ? {} : { sample: sampleSize },
+    recorded: dynamic.snapshots ?? [],
+    refused: (dynamic.redirected ?? []).map((r) => ({ id: r.id, reason: r.reason }))
+  };
+}
 function mergeDynamic(audit2, dynamic, lang = "en") {
   const merged = JSON.parse(JSON.stringify(audit2));
   const seenFindings = new Set(merged.findings.map(portableFindingId));
@@ -74493,7 +74500,9 @@ Options:
                      (exit 2 with the producing command if its worklist is missing)
   --eco              orchestrate: emit only RUNBOOK.md + agents/*.md \u2014 the explicit
                      sequential low-token path (also what a no-subagent harness follows)
-  --merge <file>     scan: fold dynamic findings into this AuditResult JSON
+  --merge <file>     scan: fold dynamic findings into this AuditResult JSON. With --json the
+                     printed document opens with a 'pages' summary of the run \u2014
+                     {sample, recorded, refused:[{id, reason}]} \u2014 beside the document
   --sitemap <url>    scan: scan every URL listed in a sitemap.xml
   --crawl <url>      scan: BFS same-origin links from a start URL (served HTML)
   --depth <n>        scan: crawl link-hop depth from the start URL   (default: no limit; 0 = no limit)
@@ -77216,7 +77225,19 @@ async function cmdScan(p) {
     mkdirSync18(out2, { recursive: true });
     const mergedDocument = auditDocumentFor(merged, standard, lang);
     writeFileSync21(join52(out2, "audit-latest.json"), JSON.stringify(mergedDocument, null, 2) + "\n");
-    if (p.flags.json) console.log(JSON.stringify(mergedDocument, null, 2));
+    if (p.flags.json)
+      console.log(
+        JSON.stringify(
+          // `pages` opens the printed document: what this scan recorded (the
+          // .ultra11y/pages ids) and refused, which the stderr warnings alone don't make
+          // countable. An extra top-level key the `--in` readers never look at, so the
+          // document beside it stays pipeable into report/verify — and the file above
+          // keeps the plain audit schema.
+          { pages: scanPageSummary(dynamic, sampleConfig?.pages.length), ...mergedDocument },
+          null,
+          2
+        )
+      );
     else {
       console.log(
         lang === "fr" ? `Audit statique + dynamique fusionn\xE9 \u2192 ${join52(out2, "audit-latest.json")} (${merged.conformancePct}% r\xE9ussite, ${merged.findings.length} findings).` : `Static + dynamic audit merged \u2192 ${join52(out2, "audit-latest.json")} (${merged.conformancePct}% pass rate, ${merged.findings.length} findings).`

package/skills/ultra11y/templates/gitlab-ci.yml

@@ -27,7 +27,7 @@ variables:
   ULTRA11Y_LANG: en
   # Exact by default: a CI report must say which engine produced it. The release script keeps
   # this pin aligned with the package version; override only for a deliberate upgrade test.
-  ULTRA11Y_VERSION: '5.44.0'
+  ULTRA11Y_VERSION: '5.45.0'
   # Batches of 8 amortise the prompt; each accepted verdict is checkpointed before the next
   # batch, and later passes receive only the residue.
   ULTRA11Y_GRAIN: batch

package/src/cli.ts

@@ -82,7 +82,7 @@ import {
 import { DEFAULT_CLI_MODEL, EFFORT_LEVELS, judgeBatchCli, refuteBatchCli } from "./agent-cli.js";
 import { CODEX_EFFORT_LEVELS, judgeBatchCodex, refuteBatchCodex } from "./agent-codex.js";
 import { BATCH_SIZE, apiKeyFromEnv, applyRawVerdicts, batchWorklist, isProviderUnavailableError, judgeAll, modelFromEnv, type LlmOptions } from "./llm.js";
-import { runScan, runScanMany, runCrawlScan, runSampleScan, mergeDynamic, mergeSnapshotAudit, cleanDynamic, dockerAvailable } from "./scan.js";
+import { runScan, runScanMany, runCrawlScan, runSampleScan, mergeDynamic, mergeSnapshotAudit, cleanDynamic, dockerAvailable, scanPageSummary } from "./scan.js";
 import { runScanLocal, runScanManyLocal, runCrawlScanLocal, runSampleScanLocal, localAvailable, localTierStatus } from "./scan-local.js";
 import { validateSample, lintSample, kindLabel, proposeSamplePages, mergeSample, sampleFromSnapshots, unionSample } from "./sample.js";
 import { createAdapter } from "./external/registry.js";
@@ -493,7 +493,9 @@ Options:
                      (exit 2 with the producing command if its worklist is missing)
   --eco              orchestrate: emit only RUNBOOK.md + agents/*.md — the explicit
                      sequential low-token path (also what a no-subagent harness follows)
-  --merge <file>     scan: fold dynamic findings into this AuditResult JSON
+  --merge <file>     scan: fold dynamic findings into this AuditResult JSON. With --json the
+                     printed document opens with a 'pages' summary of the run —
+                     {sample, recorded, refused:[{id, reason}]} — beside the document
   --sitemap <url>    scan: scan every URL listed in a sitemap.xml
   --crawl <url>      scan: BFS same-origin links from a start URL (served HTML)
   --depth <n>        scan: crawl link-hop depth from the start URL   (default: no limit; 0 = no limit)
@@ -4347,7 +4349,19 @@ async function cmdScan(p: ParsedArgs): Promise<number> {
     mkdirSync(out, { recursive: true });
     const mergedDocument = auditDocumentFor(merged, standard, lang);
     writeFileSync(join(out, "audit-latest.json"), JSON.stringify(mergedDocument, null, 2) + "\n");
-    if (p.flags.json) console.log(JSON.stringify(mergedDocument, null, 2));
+    if (p.flags.json)
+      console.log(
+        JSON.stringify(
+          // `pages` opens the printed document: what this scan recorded (the
+          // .ultra11y/pages ids) and refused, which the stderr warnings alone don't make
+          // countable. An extra top-level key the `--in` readers never look at, so the
+          // document beside it stays pipeable into report/verify — and the file above
+          // keeps the plain audit schema.
+          { pages: scanPageSummary(dynamic, sampleConfig?.pages.length), ...mergedDocument },
+          null,
+          2,
+        ),
+      );
     else {
       console.log(
         lang === "fr"

package/src/scan.ts

@@ -10,7 +10,7 @@ import { mkdtempSync, writeFileSync, existsSync, statSync, readdirSync, rmSync,
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import type { AuditResult, DynamicEngine, DynamicFinding, DynamicResult, Finding, Lang, SamplePage, Severity } from "./types.js";
+import type { AuditResult, DynamicEngine, DynamicFinding, DynamicResult, Finding, Lang, SamplePage, ScanRedirect, Severity } from "./types.js";
 import { lineStartsOf, lineColAt } from "./parse/html.js";
 import { allGuidelines } from "./wcag.js";
 import { PROBE_SEVERITY, PROBE_WCAG, scForAxe, severityFromImpact, isAxeAdvisory } from "./axe-map.js";
@@ -716,6 +716,31 @@ function resolveHostAnchor(file: string, snippet: string): { line: number; col:
   return null;
 }
 
+/** The `pages` block `scan --merge --json` prints in front of the merged document. A
+ *  PRINT-side envelope only — `audit-latest.json` keeps the plain audit schema — under a
+ *  top-level key no `--in` reader of the document looks at. */
+export interface ScanPageSummary {
+  // The declared sample's page count, on a `--sample` run; absent otherwise (a plain
+  // URL/sitemap/crawl scan has no sample to be short of).
+  sample?: number;
+  // Ids of the snapshots the run persisted under `.ultra11y/pages/<id>/`.
+  recorded: string[];
+  // Pages the scan refused to record, and why (see ScanRedirect).
+  refused: Array<{ id: string; reason?: ScanRedirect["reason"] }>;
+}
+
+/** What one scan RECORDED and REFUSED, page by page. Without it the merged `--json` output
+ *  carries neither: the refusals reach the caller on stderr only, and the recorded ids would
+ *  take a listing of `.ultra11y/pages` against the run's start time to recover — exactly the
+ *  re-derivation an orchestrator reporting « N pages capturées, M refusées » must not do. */
+export function scanPageSummary(dynamic: DynamicResult, sampleSize?: number): ScanPageSummary {
+  return {
+    ...(sampleSize === undefined ? {} : { sample: sampleSize }),
+    recorded: dynamic.snapshots ?? [],
+    refused: (dynamic.redirected ?? []).map((r) => ({ id: r.id, reason: r.reason })),
+  };
+}
+
 /** Fold dynamic findings into a static AuditResult: a needs-rendering/manual or
  *  clean criterion that axe flags becomes NC; tallies + conformance recompute. */
 export function mergeDynamic(audit: AuditResult, dynamic: DynamicResult, lang: Lang = "en"): AuditResult {

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