rcf-lite 0.26.0 → 0.28.0

package/blueprints/application-charts/CHANGELOG.md

@@ -1,12 +1,59 @@
 # application-charts CHANGELOG
 
-## 1.0.0 (visual round T-2, spec 2026-09-04)
+## 1.0.10 - 2026-09-12
 
-- First ratified version of the shelf's charts blueprint. Four REQs (chart form set, non-colour distinction, text-alternative table, keyboard traversal), six USs binding runtime-observable ACs, two TACs (render shell, keyboard traversal), three ADRs (elicited chart engine with canvas-only refusal, accessible palette light and dark, reduced motion via application-spa tokens). No new global topics.
-- Ships `probe-packs/application-charts.pack.mjs`: three browser-verify checks anchored to AC-18102-1 (non-colour distinction), AC-18103-1 (text-alternative table with cell-per-value contract), AC-18104-1 (keyboard traversal contract with reduced-motion suppression). Every check carries a description field per spec section 9. Second blueprint on the shelf that ships a Playwright probe pack under the T-0 runner extension; first leaf blueprint the T-3 application-dashboard consumes.
+- Positive-evidence row shape tightened in the anatomy helper: a positive row now requires a non-empty engine-returned `requestId` AND (a non-empty `bodyExcerpt` OR a non-empty `derived` object); a `{derived:{}}` alone or a `requestId` alone no longer counts, with two new negative-case tests covering the empty-derived and id-only patterns. No probe or fixture behaviour changes on this blueprint (charts probes already carry both request-id and non-empty derived on every positive row).
+
+## 1.0.9 - 2026-09-12
+
+- Rule-7d shape fix on the three de-claimed conformance rows across text-alternative-table (AC-18103-1), non-colour-distinction (AC-18102-1) and keyboard-traversal (AC-18104-3): each row now carries `anchorAcId: null` and names the anchored AC in the `limitation` field per the shipped shape (a `conformanceOnly:true` row must not simultaneously claim an anchor). Fixture README env-var manifest now declares `PROBE_BREAK` (the fixture reads it as an alternate to a per-request `?break=`) and the probe-utils `DECLARED_ENV` list mirrors the addition. Anatomy shape check tightened to reject an anchored `conformanceOnly` row (a positive evidence field no longer bypasses the null-anchor + limitation contract); a new negative-case test constructs an anchored `conformanceOnly` row and asserts the shape helper throws.
+
+## 1.0.8 - 2026-09-11
+
+- Shared `aggregate()` no longer promotes warn rows to pass: any row with verdict warn (including honest de-claim rows) lifts the aggregate to warn; a probe whose rows are all warn aggregates to warn, not pass. Shared teardown propagates a SIGKILL failure through the returned kill() promise instead of swallowing it. Overclaiming rows across every probe are de-claimed to `conformanceOnly:true` with `verdict:'warn'` on the observable half and a `limitation` field naming the anchored AC and the browser-only or varied-input clause that lives outside the Node HTTP probe. Positive-observation rows kept on `application-charts-AC-18103-3` (paired table cell-vs-coordinate equality) and on the anatomy-only fixture shape assertions. Anatomy test extended with a negative-variant assertion that each shipped fixture break switch drives the affected probe aggregate to fail.
+
+## 1.0.7 - 2026-09-11
+
+- keyboard-traversal AC-18104-1 row de-claimed to conformance-only (null anchor + `limitation` naming the AC clause NOT observed here: browser Tab focus movement is not observable by a Node HTTP probe; the DOM source-order walk of `[.chartDataPoint tabindex=0]` elements is a proxy but not authoritative). AC-18104-3 row keeps the AC anchor (aria-label token derivation is server-observable). Anatomy test extended to (a) enumerate the shipped AC/REQ id set from `contributions/user-stories/*.json` and `contributions/requirements/*.json` and refuse any row whose `anchorAcId` or `notObservableAcId` is not in that set, and (b) accept the conformance-only row shape (null anchor + non-empty `limitation`).
+
+## 1.0.6 - 2026-09-11
+
+- Rule-10 sweep on every probe row detail: each row now opens with the verbatim first eight words of its anchored AC's description (AC-18102-1, AC-18103-1, AC-18103-3, AC-18104-1, AC-18104-3) so the property claimed sits next to the observation made. Register cleanup on probe-utils.mjs, the anatomy test and the fixture README: reworded citations that carried banned register-label tokens to describe the rule by name.
+
+
+## 1.0.5 - 2026-09-11
+
+- Added a criterion-e probe pack (`contributions/probes/`) covering 3 properties the fixture engine at `packages/rcf-lite/test/fixtures/probe-pack-application-charts/server.js` answers: `non-colour-distinction`, `text-alternative-table`, `keyboard-traversal`. Every response now carries an `x-fixture-request-id` header; probes record the id, the HTTP status and a body excerpt as positive evidence per rule 7d. Fixture README declares every env var the pack reads. Anatomy test at `packages/rcf-lite/test/blueprint/application-charts-anatomy.test.js` pins the new pack files and asserts each result carries one of the four 7d evidence shapes.
+
+
+## 1.0.4 - 2026-09-10
+
+Fixes: Template-AC fill-in clauses on AC-18105-1, AC-18105-2, AC-18106-1, AC-18106-2 and AC-18106-3 now enumerate the specific applying-project substitutions (applied light and dark backgrounds and any operator brand-token overrides on `blueprint.json:elicits[palette-overrides]`, the elicited palette-overrides string value, the elicited engine token, the elicited engine choice failing the text-alternative check) in place of the generic phrasing. TAC-1901-application-charts-render-shell patch-bumped to 1.0.3: responsibilities[6] fixes the `data-chart-engine` attribute referenced from AC-18106-2, and responsibilities[5] now owns the render-log refusal-record shape (one warning entry per refused chart declaration, keyed to the accessible-name and naming the engine and the missing text-alternative surface) referenced from AC-18106-3 and AC-18106-4 in place of the shape restatement on AC-18106-4. ADR-1902 fixes the palette fallback expectation.
+
+
+## 1.0.3 (register-sweep patch, 2026-09-10)
+
+- Register: neutral wording in shipped prose (no capability change).
+
+## 1.0.2 (2026-09-09)
+
+- Adds top-level elicits[] block on blueprint.json declaring the two apply-time answers (chart-engine, palette-overrides); each option value backed by a must REQ description with a runtime clause per section 7c. REQ-001 gains the chart-engine token set (recharts, echarts, chart-js, d3-primitives, hand-authored-svg) and the canvas-only refusal clause.
+- Adds refusal-path ACs to US-18101 (per-form binder check, specialised-form CALLS MADE, empty-data-set labelled block), US-18102 (deuteranopia simulation check, direct-label rule vs legend-only, unique colour+pattern combination), US-18103 (cell-value match check, same-landmark rule, visually-hidden-vs-display:none), US-18104 (announced-string field order, series-by-series traversal, prefers-reduced-motion), US-18105 (dark-background contrast, undersupplied palette warning, runtime theme flip). Every story now at the 7a floor (4-5 ACs per story, 29 ACs total).
+- vendorCitation added to AC-18102-2 (WCAG 1.4.1 use-of-color) and AC-18105-3 (WCAG 1.4.11 non-text contrast). Applying agent sets clause appended to AC-18101-4 naming the specialised chart form, the CALLS MADE entry text and the superseding REQ id. REQ-002 (priority must) extended to name the `palette-overrides` elicit contract with runtime clauses per option value (empty override resolves to accessible defaults with no warnings; a malformed override is refused when the applying project inspects the manifest) and AC-18105-2 and AC-18105-4 now reference `blueprint.json:elicits[].palette-overrides` verbatim so the section-7c option coverage binds. Chart-engine canonical option tokens (owned by the manifest as `recharts`, `echarts`, `chart-js`, `d3-primitives`, `hand-authored-svg`) now appear verbatim in AC-18106-1 and AC-18106-2 so a section-7c string-scan matches every option.
+
+## 1.0.1 (2026-09-09)
+
+- Added deliveredBy to every REQ, added ownerRef and disposition to every AC per section 7b.
+- Added AC-18106-3 and AC-18106-4 (mount refusal before any DOM attaches and the render-log warning contract with one entry per refused declaration and no duplication on compliant re-mount) covering the mount-time refusal branch on TAC-1901.responsibilities[5].
+
+
+## 1.0.0 (2026-09-04)
+
+- Initial shipped version of the shelf's charts blueprint. Four REQs (chart form set, non-colour distinction, text-alternative table, keyboard traversal), six USs binding runtime-observable ACs, two TACs (render shell, keyboard traversal), three ADRs (elicited chart engine with canvas-only refusal, accessible palette light and dark, reduced motion via application-spa tokens). No new global topics.
+- Ships `probe-packs/application-charts.pack.mjs`: three browser-verify checks anchored to AC-18102-1 (non-colour distinction), AC-18103-1 (text-alternative table with cell-per-value contract), AC-18104-1 (keyboard traversal contract with reduced-motion suppression). Every check carries a description field per spec section 9. Second blueprint on the shelf that ships a Playwright probe pack under the runner extension; first leaf blueprint the application-dashboard consumes.
 - Ships a sample-app fixture at `packages/rcf-lite/test/fixtures/probe-pack-application-charts/` (dependency-free Node HTTP server) so the pack can be probed at the shelf's own gate; the fixture is the golden the gate reviewer drives, with `?break=table`, `?break=pattern` and `?break=keyboard` query switches for the negative runs.
-- Suggests the `logging` and `errorHandling` companions with the ratified spec's reasons.
+- Suggests the `logging` and `errorHandling` companions with the shipped spec's reasons.
 
-### Patch note (2026-09-04, T-3 gate follow-up)
+### Patch note (2026-09-04, gate follow-up)
 
-- `probe-packs/application-charts.pack.mjs`: navigate with `new URL('', runtimeUrl).toString()` instead of `runtimeUrl + '/'` on the three goto call sites (AC-18102-1, AC-18103-1, AC-18104-1). The concat form stripped a reviewer-supplied `?break=<mode>` from a CLI `--url`; the URL-resolver form preserves the runtime URL verbatim so a reviewer pointing the CLI at `?break=<mode>` sees the negative run naturally. Version stays at 1.0.0; behaviour unchanged on the default apply-side runtime URL.
+- `probe-packs/application-charts.pack.mjs`: navigate with `new URL('', runtimeUrl).toString()` instead of `runtimeUrl + '/'` on the three goto call sites (AC-18102-1, AC-18103-1, AC-18104-1). The concat form stripped an operator-supplied `?break=<mode>` from a CLI `--url`; the URL-resolver form preserves the runtime URL verbatim so an operator pointing the CLI at `?break=<mode>` sees the negative run naturally. Version stays at 1.0.0; behaviour unchanged on the default apply-side runtime URL.

package/blueprints/application-charts/README.md

@@ -1,6 +1,6 @@
-# Charts blueprint (v1.0.0)
+# Charts blueprint (v1.0.4)
 
-Vendor-neutral chart-component contract for a rcf-lite application. Ships the accessibility, palette, text-alternative and keyboard-traversal discipline every chart on the shipped surface must meet. Ships a Playwright probe pack under `probe-packs/application-charts.pack.mjs` whose three checks are the runtime gate the delivery-ci-workflows runner drives (visual round spec 2026-09-04, section 5.2). No new global topics; suggests the `logging` and `errorHandling` companions. Leaf blueprint: application-dashboard (visual round T-3) consumes it; no other blueprint in this round does.
+Vendor-neutral chart-component contract for a rcf-lite application. Ships the accessibility, palette, text-alternative and keyboard-traversal discipline every chart on the shipped surface must meet. Ships a Playwright probe pack under `probe-packs/application-charts.pack.mjs` whose three checks are the runtime gate the delivery-ci-workflows runner drives (section 5.2 of the visual specification). No new global topics; suggests the `logging` and `errorHandling` companions. Leaf blueprint: application-dashboard consumes it; no other blueprint on the shelf does.
 
 ## Apply
 
@@ -31,7 +31,7 @@ Deliberately not contributed: a choice of chart engine (Recharts, ECharts, Chart
 `ADR-1901` elicits the chart engine at apply, and refuses a canvas-only engine that offers no text-alternative surface. The refusal is documented here on the blueprint's README so applying projects and gate reviewers see the rule in one place:
 
 - Recharts, ECharts, Chart.js and D3 primitives all satisfy the shell contract when paired with the shell's text-alternative table slot. Chart.js's canvas surface is paired with the shell's `<table>` slot; the shell renders both, so screen readers reach the values.
-- A chart engine that renders exclusively to a `<canvas>` and does NOT offer either a shell-rendered `<table>` or an equivalent DOM path is refused at project-side review. The applying project either replaces the engine or supersedes this blueprint with a project-authored engine contract naming the residuals.
+- A chart engine that renders exclusively to a `<canvas>` and does NOT offer either a shell-rendered `<table>` or an equivalent DOM path is refused at project-side check. The applying project either replaces the engine or supersedes this blueprint with a project-authored engine contract naming the residuals.
 
 ## The one runtime gate
 
@@ -56,18 +56,18 @@ Every chart on the shipped surface mounts through the render shell (TAC-1901). E
 
 ## Known mechanism-reach gaps
 
-Every runtime-observable AC that is not bound to a pack check appears here individually per the T-1 gate discipline (`blueprint-authoring-checklist.md` section 6.g): categories are not enough. The pack has three checks; every other runtime-observable AC on this blueprint is a mechanism-reach gap named below.
+Every runtime-observable AC that is not bound to a pack check appears here individually per the gate discipline (`blueprint-authoring-checklist.md` section 6.g): categories are not enough. The pack has three checks; every other runtime-observable AC on this blueprint is a mechanism-reach gap named below.
 
-- **AC-18101-1 form-set membership**. the pack does not inspect a chart's declared form against the six-form set. A project-side review is the current mechanism. A v1.1 minor bump could add a fourth pack check reading the `data-chart-form` attribute the shell emits and asserting membership.
-- **AC-18101-2 shell-mount routing**. the pack does not inspect the mount seam; a chart bypass to the raw chart-library mount is caught at project-side review. A build-scan pre-check in a v1.1 minor bump can grep the applying project's source for engine-specific mount calls.
+- **AC-18101-1 form-set membership**. the pack does not inspect a chart's declared form against the six-form set. A project-side check is the current mechanism. A v1.1 minor bump could add a fourth pack check reading the `data-chart-form` attribute the shell emits and asserting membership.
+- **AC-18101-2 shell-mount routing**. the pack does not inspect the mount seam; a chart bypass to the raw chart-library mount is caught at project-side check. A build-scan pre-check in a v1.1 minor bump can grep the applying project's source for engine-specific mount calls.
 - **AC-18102-2 single-series exemption**. the pack does not skip single-series charts explicitly today; the runner reports `applicable: false` for the check on a surface with only single-series charts based on the DOM inspection. A v1.1 minor bump can formalise the skip on the pack seam.
 - **AC-18103-2 show-table control label and reading order**. the pack asserts the control is present but does not assert the control's accessible-name text or its position in tab order before the chart's data points. A v1.1 minor bump can add a pack check that tabs into the region and reads the tab order.
-- **AC-18104-2 non-interactive-chart exemption**. the pack does not skip non-interactive charts explicitly today; the check fails on a surface whose data points miss `tabindex="0"`, whether or not the chart is interactive. Project-side review names non-interactive charts and the reviewer skips the check by hand.
+- **AC-18104-2 non-interactive-chart exemption**. the pack does not skip non-interactive charts explicitly today; the check fails on a surface whose data points miss `tabindex="0"`, whether or not the chart is interactive. Project-side check names non-interactive charts and the operator skips the check by hand.
 - **AC-18105-1 palette contrast**. the pack does not measure contrast ratios today. Palette contrast is a build-scan surface (colour tokens are inspectable from the applied palette module). A v1.1 minor bump can add a Node build-scan pre-check that reads the applied palette and checks the ratios against WCAG 1.4.3 and 1.4.11.
 - **AC-18105-2 palette override fallback**. the fallback behaviour is exercised by the applying project's own tests, not this blueprint's pack. The applying project owns the assertion.
-- **AC-18106-1 canvas-only refusal**. the refusal is documented in the README's engine-refusal rule; project-side review enforces it. A v1.1 minor bump could add a pack pre-check that reads the applied engine and refuses on a canvas-only engine with no `<table>` companion.
-- **AC-18106-2 engine-name marker**. the applying project ships a `data-chart-engine` attribute or an equivalent DOM marker. The pack does not assert this today; a v1.1 minor bump could read the marker and add it to the pack record for downstream tooling.
+- **AC-18106-1 canvas-only refusal**. the refusal is documented in the README's engine-refusal rule; project-side check enforces it. A v1.1 minor bump could add a pack pre-check that reads the applied engine and refuses on a canvas-only engine with no `<table>` companion.
+- **AC-18106-2 engine-name marker**. the applying project ships the `data-chart-engine` attribute fixed on TAC-1901-application-charts-render-shell.responsibilities[6]. The pack does not assert this today; a v1.1 minor bump could read the marker and add it to the pack record for downstream tooling.
 
 ## Vision-deficiency emulation is a runner-seam gap
 
-The runner has no `emulateVisionDeficiency` seam on the pack browser today (`goto`, `snapshot`, `evaluate`, `click`, `type`, `press`, `screenshot` is the current API). AC-18102-1 is therefore proven at the DOM level: every series carries a non-colour cue AND a direct label. A future runner minor that adds `emulateVisionDeficiency` to the seam lets this pack add a deuteranopia render pass; that follow-up is named under CONCERNS in the T-2 dispatch report as the smallest runner change that would close the class.
+The runner has no `emulateVisionDeficiency` seam on the pack browser today (`goto`, `snapshot`, `evaluate`, `click`, `type`, `press`, `screenshot` is the current API). AC-18102-1 is therefore proven at the DOM level: every series carries a non-colour cue AND a direct label. A future runner minor that adds `emulateVisionDeficiency` to the seam lets this pack add a deuteranopia render pass; that follow-up covers the smallest runner change that would close the class.

package/blueprints/application-charts/blueprint.json

@@ -1,26 +1,122 @@
 {
   "slug": "application-charts",
-  "version": "1.0.0",
+  "version": "1.0.10",
   "category": "application",
   "suggestedCompanions": [
-    { "role": "logging", "reason": "Chart rendering telemetry (data-point activation, keyboard traversal) rides the same log surface as the rest of the client; a logging companion supplies the factory the client-side telemetry uses." },
-    { "role": "errorHandling", "reason": "A chart that fails to load surfaces a client-side error record; an error-handling companion supplies the boundary and the record factory." }
+    {
+      "role": "logging",
+      "reason": "Chart rendering telemetry (data-point activation, keyboard traversal) rides the same log surface as the rest of the client; a logging companion supplies the factory the client-side telemetry uses."
+    },
+    {
+      "role": "errorHandling",
+      "reason": "A chart that fails to load surfaces a client-side error record; an error-handling companion supplies the boundary and the record factory."
+    }
+  ],
+  "elicits": [
+    {
+      "id": "chart-engine",
+      "prompt": "Chart engine the applying project ships. One of recharts, echarts, chart-js, d3-primitives or hand-authored-svg. A canvas-only engine that offers no text-alternative surface is refused at project-side check (ADR-1901).",
+      "kind": "enum",
+      "options": [
+        "recharts",
+        "echarts",
+        "chart-js",
+        "d3-primitives",
+        "hand-authored-svg"
+      ],
+      "default": "recharts"
+    },
+    {
+      "id": "palette-overrides",
+      "prompt": "Optional brand-token overrides for the categorical palette, supplied through the shell palette accessor. Missing tokens fall back to the accessible-defaults palette (light and dark) at the same index and the render log records a warning (ADR-1902).",
+      "kind": "string",
+      "default": ""
+    }
   ],
   "contributions": [
-    { "id": "application-charts-REQ-001", "kind": "req", "path": "requirements/application-charts-req-001.json" },
-    { "id": "application-charts-REQ-002", "kind": "req", "path": "requirements/application-charts-req-002.json" },
-    { "id": "application-charts-REQ-003", "kind": "req", "path": "requirements/application-charts-req-003.json" },
-    { "id": "application-charts-REQ-004", "kind": "req", "path": "requirements/application-charts-req-004.json" },
-    { "id": "application-charts-US-18101", "kind": "us", "path": "user-stories/application-charts-us-18101.json" },
-    { "id": "application-charts-US-18102", "kind": "us", "path": "user-stories/application-charts-us-18102.json" },
-    { "id": "application-charts-US-18103", "kind": "us", "path": "user-stories/application-charts-us-18103.json" },
-    { "id": "application-charts-US-18104", "kind": "us", "path": "user-stories/application-charts-us-18104.json" },
-    { "id": "application-charts-US-18105", "kind": "us", "path": "user-stories/application-charts-us-18105.json" },
-    { "id": "application-charts-US-18106", "kind": "us", "path": "user-stories/application-charts-us-18106.json" },
-    { "id": "TAC-1901-application-charts-render-shell", "kind": "tac", "path": "tacs/tac-1901-application-charts-render-shell.json" },
-    { "id": "TAC-1902-application-charts-keyboard-traversal", "kind": "tac", "path": "tacs/tac-1902-application-charts-keyboard-traversal.json" },
-    { "id": "ADR-1901-application-charts-engine-choice", "kind": "adr", "path": "adrs/adr-1901-application-charts-engine-choice.json", "elicited": true, "standardsTraceClause": "WCAG 1.4.1 / WCAG 2.1.1" },
-    { "id": "ADR-1902-application-charts-accessible-palette", "kind": "adr", "path": "adrs/adr-1902-application-charts-accessible-palette.json", "recommendedDefault": true, "elicited": true, "standardsTraceClause": "WCAG 1.4.3 / WCAG 1.4.11" },
-    { "id": "ADR-1903-application-charts-motion", "kind": "adr", "path": "adrs/adr-1903-application-charts-motion.json", "recommendedDefault": true, "standardsTraceClause": "WCAG 2.3.3" }
-  ]
+    {
+      "id": "application-charts-REQ-001",
+      "kind": "req",
+      "path": "requirements/application-charts-req-001.json"
+    },
+    {
+      "id": "application-charts-REQ-002",
+      "kind": "req",
+      "path": "requirements/application-charts-req-002.json"
+    },
+    {
+      "id": "application-charts-REQ-003",
+      "kind": "req",
+      "path": "requirements/application-charts-req-003.json"
+    },
+    {
+      "id": "application-charts-REQ-004",
+      "kind": "req",
+      "path": "requirements/application-charts-req-004.json"
+    },
+    {
+      "id": "application-charts-US-18101",
+      "kind": "us",
+      "path": "user-stories/application-charts-us-18101.json"
+    },
+    {
+      "id": "application-charts-US-18102",
+      "kind": "us",
+      "path": "user-stories/application-charts-us-18102.json"
+    },
+    {
+      "id": "application-charts-US-18103",
+      "kind": "us",
+      "path": "user-stories/application-charts-us-18103.json"
+    },
+    {
+      "id": "application-charts-US-18104",
+      "kind": "us",
+      "path": "user-stories/application-charts-us-18104.json"
+    },
+    {
+      "id": "application-charts-US-18105",
+      "kind": "us",
+      "path": "user-stories/application-charts-us-18105.json"
+    },
+    {
+      "id": "application-charts-US-18106",
+      "kind": "us",
+      "path": "user-stories/application-charts-us-18106.json"
+    },
+    {
+      "id": "TAC-1901-application-charts-render-shell",
+      "kind": "tac",
+      "path": "tacs/tac-1901-application-charts-render-shell.json"
+    },
+    {
+      "id": "TAC-1902-application-charts-keyboard-traversal",
+      "kind": "tac",
+      "path": "tacs/tac-1902-application-charts-keyboard-traversal.json"
+    },
+    {
+      "id": "ADR-1901-application-charts-engine-choice",
+      "kind": "adr",
+      "path": "adrs/adr-1901-application-charts-engine-choice.json",
+      "elicited": true,
+      "standardsTraceClause": "WCAG 1.4.1 / WCAG 2.1.1"
+    },
+    {
+      "id": "ADR-1902-application-charts-accessible-palette",
+      "kind": "adr",
+      "path": "adrs/adr-1902-application-charts-accessible-palette.json",
+      "recommendedDefault": true,
+      "elicited": true,
+      "standardsTraceClause": "WCAG 1.4.3 / WCAG 1.4.11"
+    },
+    {
+      "id": "ADR-1903-application-charts-motion",
+      "kind": "adr",
+      "path": "adrs/adr-1903-application-charts-motion.json",
+      "recommendedDefault": true,
+      "standardsTraceClause": "WCAG 2.3.3"
+    }
+  ],
+  "updatedAt": "2026-09-12T00:45:12Z",
+  "updatedIso": "2026-09-11T22:30:00Z"
 }

package/blueprints/application-charts/contributions/adrs/adr-1901-application-charts-engine-choice.json

@@ -2,11 +2,11 @@
   "adrId": "ADR-1901-application-charts-engine-choice",
   "prdId": "PRD-001",
   "tadId": "TAD-001",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "accepted",
   "title": "Elicit the chart engine at apply, and refuse a canvas-only engine that offers no text-alternative surface",
   "context": "Chart engines have wildly different accessibility postures. Recharts and ECharts render to SVG with keyboard-focusable data points and a DOM the shell can read; Chart.js renders to canvas and needs a paired data-table to reach a screen reader; D3 primitives leave the accessibility contract to the author. A blueprint that hard-picks one engine locks the applying project into that engine's accessibility posture; a blueprint that leaves it wide open lets the project ship a canvas-only chart with no text-alternative path.",
-  "decision": "The chart engine is elicited at apply (Recharts, ECharts, Chart.js, D3 primitives or an operator-named alternative). The shell contract stands regardless of engine (a paired text-alternative table in the same landmark; a keyboard traversal path on interactive charts; a colour-plus-pattern-plus-label series distinction). A chart engine that renders exclusively to a `<canvas>` and offers no text-alternative surface is refused at project-side review; the refusal is documented on the blueprint's README under the engine-refusal rule.",
+  "decision": "The chart engine is elicited at apply (Recharts, ECharts, Chart.js, D3 primitives or an operator-named alternative). The shell contract stands regardless of engine (a paired text-alternative table in the same landmark; a keyboard traversal path on interactive charts; a colour-plus-pattern-plus-label series distinction). A chart engine that renders exclusively to a `<canvas>` and offers no text-alternative surface is refused at project-side check; the refusal is documented on the blueprint's README under the engine-refusal rule.",
   "consequences": "Applying projects pick the engine that fits their existing stack (a Chart.js-heavy project keeps Chart.js and pairs every chart with the text-alternative table the shell renders). A canvas-only engine is refused with a clear reason; the applying project either replaces the engine or supersedes the blueprint with a project-authored engine contract naming the residuals.",
   "alternativesConsidered": [
     {

package/blueprints/application-charts/contributions/adrs/adr-1902-application-charts-accessible-palette.json

@@ -2,7 +2,7 @@
   "adrId": "ADR-1902-application-charts-accessible-palette",
   "prdId": "PRD-001",
   "tadId": "TAD-001",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "accepted",
   "title": "Ship an accessible-defaults categorical palette (light and dark) with elicited operator overrides",
   "context": "Categorical palettes are the most common source of colour-blindness defects on chart libraries: many popular defaults (rainbow gradients, the classic ten-colour categorical from d3-scale v1) fail deuteranopia readability at the second and third series. Operators bring brand tokens they want to see on the shipped surface; the tension between brand palette and accessible palette is real.",

package/blueprints/application-charts/contributions/adrs/adr-1903-application-charts-motion.json

@@ -2,7 +2,7 @@
   "adrId": "ADR-1903-application-charts-motion",
   "prdId": "PRD-001",
   "tadId": "TAD-001",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "accepted",
   "title": "Honour prefers-reduced-motion via the application-spa motion tokens on every chart transition",
   "context": "Chart libraries default to animated entry and update transitions (bars grow from zero, lines sweep left-to-right). `prefers-reduced-motion: reduce` is the WCAG 2.3.3 signal the operator's platform preferences carry; failing to honour it is a common accessibility defect on chart libraries and a hard-to-diagnose vestibular trigger.",

package/blueprints/application-charts/contributions/probes/keyboard-traversal.mjs

@@ -0,0 +1,151 @@
+// application-charts probe: keyboard focus reaches every data point
+// in the required reading order (AC-18104-1) and the announced
+// string carries series name, x-value, y-value and unit
+// (AC-18104-3).
+//
+// AC-18104-1 wording: "keyboard focus reaches each data point in
+// reading order (left-to-right, top-to-bottom for single-series;
+// series-by-series for multi-series)". The probe walks the DOM in
+// source order to construct the Tab sequence a browser would follow,
+// then asserts:
+//   - every .chartDataPoint is tabbable (tabindex="0")
+//   - the source-order walk groups points series-by-series for the
+//     multi-series charts (all Prod x-values, then all Staging
+//     x-values, and so on)
+//   - the reduced-motion CSS rule zeros the transition duration
+// The Tab sequence a browser follows on a static SVG document IS
+// source-order across focusable elements when no tabindex reorders
+// them, so a source-order walk faithfully represents the observed
+// order.
+
+import { fixtureFetch, startFixture, excerpt } from './probe-utils.mjs';
+
+export const anchorAcId = 'application-charts-AC-18104-1';
+export const accountBound = false;
+
+function walkFocusOrder(body) {
+  // Enumerate focusable data-point elements in DOM source order.
+  // Emits { series, x, y, tag } tuples.
+  const order = [];
+  const re = /<(rect|circle) class="chartDataPoint"[^>]*data-series="([^"]+)"[^>]*data-x="([^"]+)"[^>]*data-y="([^"]+)"[^>]*tabindex="0"[^>]*aria-label="([^"]+)"/g;
+  let m;
+  while ((m = re.exec(body)) !== null) {
+    order.push({ tag: m[1], series: m[2], x: m[3], y: m[4], label: m[5] });
+  }
+  return order;
+}
+
+function isSeriesByX(order) {
+  // Split by chart form (rect=bar, circle=line) so the two charts on
+  // one page do not blur into one sequence, then confirm that within
+  // each chart the walk emits all points of series A before any
+  // points of series B (series-by-series in x order).
+  const byForm = { rect: [], circle: [] };
+  for (const p of order) byForm[p.tag].push(p);
+  for (const list of Object.values(byForm)) {
+    if (list.length === 0) continue;
+    // Group by series in encounter order.
+    const seenSeries = [];
+    for (const p of list) if (!seenSeries.includes(p.series)) seenSeries.push(p.series);
+    // Assert each series appears in one contiguous block.
+    let idx = 0;
+    for (const s of seenSeries) {
+      while (idx < list.length && list[idx].series === s) idx += 1;
+      // Any later element with the same series would mean interleave.
+      for (let j = idx; j < list.length; j += 1) {
+        if (list[j].series === s) return { ok: false, seenSeries, interleaveAt: j, list };
+      }
+    }
+  }
+  return { ok: true, byForm };
+}
+
+function announcedShape(label) {
+  // "seriesName, xValue, yValue unit"  -  three parts, third part
+  // "<number> <unit>".
+  const parts = label.split(',').map((s) => s.trim());
+  if (parts.length !== 3) return { ok: false, parts };
+  const [seriesName, xValue, yUnit] = parts;
+  const yUnitMatch = yUnit.match(/^(-?\d+(?:\.\d+)?)(\s+)(\S+)$/);
+  if (!yUnitMatch) return { ok: false, parts };
+  return { ok: true, seriesName, xValue, yValue: yUnitMatch[1], unit: yUnitMatch[3] };
+}
+
+export default async function runProbe() {
+  const fixture = await startFixture();
+  const results = [];
+  try {
+    const golden = await fixtureFetch(fixture.url, '/');
+    const order = walkFocusOrder(golden.body);
+    const totalDataPoints = (golden.body.match(/class="chartDataPoint"/g) || []).length;
+    const traversal = isSeriesByX(order);
+    const reducedMotion = /@media \(prefers-reduced-motion: reduce\)[^}]*\{[^}]*transition-duration:\s*0s[^}]*\}/.test(golden.body);
+    const reachedAll = order.length === totalDataPoints;
+    const shapeObserved = golden.status === 200 && !!golden.requestId
+      && reachedAll && traversal.ok && reducedMotion && totalDataPoints > 0;
+    // Conformance-only: DOM source-order walk of focusable data-point
+    // elements is a partial observation of AC-18104-1; the AC's
+    // authoritative property (browser Tab focus movement) requires a
+    // running browser and is not observed here. Null anchor per rule
+    // 11; limitation names the shipped AC and the browser-only clause.
+    results.push({
+      anchorAcId: null,
+      conformanceOnly: true,
+      verdict: shapeObserved ? 'warn' : 'fail',
+      limitation: 'application-charts-AC-18104-1: browser Tab focus sequence is not observed by this Node HTTP probe; the DOM source-order walk is a proxy for Tab order (true when no tabindex reorders focusable elements) but not a browser-observed focus movement',
+      detail: shapeObserved
+        ? `Given an interactive chart (data points are clickable): DOM source-order walk of focusable [.chartDataPoint tabindex=0] elements returned ${order.length}/${totalDataPoints} points, grouped series-by-series per chart (${JSON.stringify(traversal.byForm && Object.fromEntries(Object.entries(traversal.byForm).map(([f, l]) => [f, [...new Set(l.map((p) => p.series))].join(' then ')])))}); reduced-motion rule zeros transition-duration on the surface; conformance-only observation of the DOM-shape half of AC-18104-1; x-fixture-request-id=${golden.requestId}`
+        : `Given an interactive chart (data points are clickable) gap: focusable=${order.length}/${totalDataPoints} seriesOrderOk=${traversal.ok} reducedMotion=${reducedMotion} rid=${golden.requestId}`,
+      evidence: {
+        requestId: golden.requestId,
+        responseStatus: golden.status,
+        bodyExcerpt: excerpt(JSON.stringify(order.slice(0, 4))),
+        derived: {
+          focusableCount: order.length,
+          totalDataPoints,
+          seriesOrderOk: traversal.ok,
+          reducedMotion,
+          firstFive: order.slice(0, 5).map((p) => ({ series: p.series, x: p.x, tag: p.tag })),
+        },
+      },
+    });
+
+    // AC-18104-3 announced-string contract on every focusable point.
+    let allShapesOk = true;
+    let firstBad = null;
+    for (const p of order) {
+      const s = announcedShape(p.label);
+      if (!s.ok) { allShapesOk = false; firstBad = { label: p.label, parts: s.parts }; break; }
+      // Series/x/y must match the DOM data attributes on the same
+      // element (announced string is derived from the point's own
+      // series/x/y and unit, per AC-18104-3).
+      if (s.seriesName !== p.series || s.xValue !== p.x || s.yValue !== p.y) {
+        allShapesOk = false; firstBad = { label: p.label, expectedSeries: p.series, expectedX: p.x, expectedY: p.y, parsed: s }; break;
+      }
+    }
+    const shapePass = order.length > 0 && allShapesOk;
+    // AC-18104-3 is a derived-value contract on the announced string
+    // format ("seriesName, xValue, yValue unit"). The aria-label
+    // attribute IS server-observable, so this row keeps the AC anchor;
+    // the ORAL announcement (assistive-tech reads the label aloud) is
+    // browser + AT territory and not asserted here.
+    results.push({
+      anchorAcId: null,
+      conformanceOnly: true,
+      limitation: 'application-charts-AC-18104-3: assistive-tech announcement of the derived string on keyboard focus (the AC clause beyond the DOM-attribute derivation) is browser + AT driven and not observed by this Node HTTP probe; the aria-label derivation walk is a partial observation of AC-18104-3',
+      verdict: shapePass ? 'warn' : 'fail',
+      detail: shapePass
+        ? `Given an interactive chart, when the keyboard focus; Every one of ${order.length} focusable data points renders an aria-label of the form "<seriesName>, <xValue>, <yValue> <unit>" where each token matches the point's own data-series / data-x / data-y attributes (derived-output check); x-fixture-request-id=${golden.requestId}`
+        : `Given an interactive chart, when the keyboard focus; AC-18104-3 gap: firstBad=${JSON.stringify(firstBad)}`,
+      evidence: {
+        requestId: golden.requestId,
+        responseStatus: golden.status,
+        bodyExcerpt: excerpt(order[0] ? order[0].label : ''),
+        derived: { checkedLabels: order.length, firstBad },
+      },
+    });
+  } finally {
+    await fixture.kill();
+  }
+  return { results };
+}

package/blueprints/application-charts/contributions/probes/non-colour-distinction.mjs

@@ -0,0 +1,67 @@
+// application-charts probe: series distinction combines colour with
+// a non-colour attribute AND a direct label AT EVERY SERIES
+// (AC-18102-1). The observation runs per-series (not by aggregate
+// counts): each series must carry a data-pattern attribute AND a
+// labelled text node bearing its name. A series with two patterns
+// and another with none does not satisfy the AC  -  the per-series
+// check's false-pass path.
+
+import { fixtureFetch, startFixture, excerpt } from './probe-utils.mjs';
+
+export const anchorAcId = 'application-charts-AC-18102-1';
+export const accountBound = false;
+
+function distinctSeriesNames(body) {
+  const set = new Set();
+  const re = /data-series="([^"]+)"/g;
+  let m;
+  while ((m = re.exec(body)) !== null) set.add(m[1]);
+  return [...set];
+}
+
+function seriesHasPattern(body, name) {
+  // A series has a pattern attribute if any element that carries
+  // data-series="name" also carries data-pattern="…" (on the same
+  // element or on a wrapping <g class="chartSeriesLine"> for line
+  // charts).
+  const elemRe = new RegExp(`<[^>]*data-series="${name.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')}"[^>]*data-pattern="[^"]+"`, 'g');
+  return elemRe.test(body);
+}
+
+function seriesHasLabel(body, name) {
+  return body.includes(`data-series-label="${name}"`);
+}
+
+export default async function runProbe() {
+  const fixture = await startFixture();
+  const results = [];
+  try {
+    const golden = await fixtureFetch(fixture.url, '/');
+    const seriesNames = distinctSeriesNames(golden.body);
+    const perSeries = seriesNames.map((name) => ({
+      name,
+      hasPattern: seriesHasPattern(golden.body, name),
+      hasLabel: seriesHasLabel(golden.body, name),
+    }));
+    const everyOne = perSeries.length >= 2 && perSeries.every((s) => s.hasPattern && s.hasLabel);
+    const goldenPass = golden.status === 200 && !!golden.requestId && everyOne;
+    results.push({
+      anchorAcId: null,
+      conformanceOnly: true,
+      limitation: 'application-charts-AC-18102-1: browser layout of the label adjacent to the series and rendered-colour distinguishability at applied colour choices (the AC clauses beyond DOM shape) are browser-driven and not observed by this Node HTTP probe; the per-series DOM-attribute walk is a partial observation of AC-18102-1',
+      verdict: goldenPass ? 'warn' : 'fail',
+      detail: goldenPass
+        ? `Given a rendered chart with N series, the; Per-series check on ${perSeries.length} series (${perSeries.map((s) => s.name).join(', ')}): every series carries a data-pattern attribute AND a data-series-label text node  -  the AC-18102-1 non-colour distinction contract is satisfied at every series; x-fixture-request-id=${golden.requestId}`
+        : `Given a rendered chart with N series, the; AC-18102-1 per-series gap: ${JSON.stringify(perSeries)} rid=${golden.requestId}`,
+      evidence: {
+        requestId: golden.requestId,
+        responseStatus: golden.status,
+        bodyExcerpt: excerpt((golden.body.match(/data-series="[^"]+"[^>]*data-pattern="[^"]+"/) || [''])[0]),
+        derived: { perSeries },
+      },
+    });
+  } finally {
+    await fixture.kill();
+  }
+  return { results };
+}