rcf-lite 0.26.0 → 0.28.0

package/blueprints/application-charts/contributions/probes/probe-utils.mjs

@@ -0,0 +1,177 @@
+// Shared helpers for application-charts contributions/probes/.
+//
+// The real engine for every probe in this pack is the fixture HTTP
+// server at packages/rcf-lite/test/fixtures/probe-pack-application-charts/server.js
+// booted on a scratch port from the family range 47650-47659.
+// The fixture echoes a per-request x-fixture-request-id header on
+// every response; probes record that id and a response body excerpt
+// as positive evidence per rule 7d.
+//
+// No account credentials or network calls: every probe is
+// local-fixture-driven, so no probe carries an account-bound branch
+// or a CI_HAS_* gate. Declared env vars are the fixture's own
+// PORT and (where the fixture reads them) the CAPS/state switches
+// the probes drive via query string.
+
+import { spawn } from 'node:child_process';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { createServer } from 'node:net';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+
+export const SLUG = 'application-charts';
+export const PROJECT_ROOT = resolve(HERE, '..', '..', '..', '..');
+export const FIXTURE_DIR = resolve(PROJECT_ROOT, 'packages/rcf-lite/test/fixtures/probe-pack-application-charts');
+export const REPORT_DIR = resolve(PROJECT_ROOT, '.rcf/reports/blueprints/application-charts');
+export const PORT_RANGE_START = 47650;
+export const PORT_RANGE_END = 47659;
+export const DECLARED_ENV = Object.freeze(['PORT', 'PROBE_BREAK']);
+export const REQUEST_ID_HEADER = 'x-fixture-request-id';
+
+// Pick a free port from the fixture family range. Falls back to
+// asking the OS for an ephemeral port only if the whole range is
+// held by other workers (never expected on a single-machine run).
+export async function pickPort() {
+  for (let port = PORT_RANGE_START; port <= PORT_RANGE_END; port += 1) {
+    if (await canBind(port)) return port;
+  }
+  return await bindEphemeral();
+}
+
+function canBind(port) {
+  return new Promise((res) => {
+    const s = createServer();
+    s.once('error', () => res(false));
+    s.listen(port, '127.0.0.1', () => {
+      const bound = s.address();
+      s.close(() => res(!!bound));
+    });
+  });
+}
+
+function bindEphemeral() {
+  return new Promise((res) => {
+    const s = createServer();
+    s.listen(0, '127.0.0.1', () => {
+      const port = s.address().port;
+      s.close(() => res(port));
+    });
+  });
+}
+
+// Spawns the fixture server as a child on `port` with the given
+// env overlay; resolves once the fixture has printed LISTENING and
+// returns { child, url, kill } (kill is synchronous best-effort).
+export async function startFixture({ port, env = {} } = {}) {
+  const boundPort = port ?? await pickPort();
+  const child = spawn(process.execPath, ['server.js'], {
+    cwd: FIXTURE_DIR,
+    env: { ...process.env, PORT: String(boundPort), ...env },
+    stdio: ['ignore', 'pipe', 'pipe'],
+  });
+  await new Promise((res, rej) => {
+    const timer = setTimeout(() => rej(new Error(`fixture did not print LISTENING within 4s on port ${boundPort}`)), 4000);
+    let stderrBuf = '';
+    child.stderr.on('data', (chunk) => { stderrBuf += String(chunk); });
+    child.on('exit', (code) => rej(new Error(`fixture exited early (code=${code}) stderr=${stderrBuf.slice(0, 400)}`)));
+    child.stdout.on('data', (chunk) => {
+      if (String(chunk).includes(`LISTENING ${boundPort}`)) { clearTimeout(timer); res(); }
+    });
+  });
+  const url = new URL(`http://127.0.0.1:${boundPort}`);
+  return {
+    child,
+    url,
+    port: boundPort,
+    // Await child exit and propagate any error. A teardown failure
+    // must fail the verdict (the teardown-propagation rule);
+    // no swallowed errors here.
+    kill: () => new Promise((res, rej) => {
+      let settled = false;
+      const done = (err) => { if (settled) return; settled = true; err ? rej(err) : res(); };
+      child.once('exit', () => done());
+      child.once('error', (err) => done(err));
+      try { child.kill('SIGTERM'); } catch (err) { return done(err); }
+      setTimeout(() => {
+        if (settled) return;
+        try { child.kill('SIGKILL'); } catch (err) { return done(err); }
+      }, 4000);
+    }),
+  };
+}
+
+// Issue an HTTP request against the fixture and return
+// { status, headers, body, requestId }.
+export async function fixtureFetch(url, pathAndQuery, init = {}) {
+  const target = new URL(pathAndQuery, url);
+  const res = await fetch(target, init);
+  const body = await res.text();
+  const requestId = res.headers.get(REQUEST_ID_HEADER);
+  return { status: res.status, headers: Object.fromEntries(res.headers.entries()), body, requestId };
+}
+
+export function excerpt(body, maxLen = 240) {
+  if (typeof body !== 'string') return '';
+  return body.length <= maxLen ? body : body.slice(0, maxLen) + '…';
+}
+
+export function aggregate(results) {
+  // Positive-evidence rule: no-checks-ran is a fail.
+  if (!Array.isArray(results) || results.length === 0) return 'fail';
+  if (results.some((r) => r.verdict === 'fail')) return 'fail';
+  // Any warn row lifts the aggregate to warn, including honest
+  // notObservableHere de-claims. A probe whose rows are all warn
+  // aggregates to warn, not pass; the shelf reads amber and the tally
+  // accepts a warn aggregate as problems=0 when no fail row is present.
+  if (results.some((r) => r && r.verdict === 'warn')) return 'warn';
+  return 'pass';
+}
+
+export async function writeReport({ probeName, engine, results, extra }) {
+  await mkdir(REPORT_DIR, { recursive: true });
+  const report = {
+    slug: SLUG,
+    probeName,
+    runAt: new Date().toISOString(),
+    engine,
+    results,
+    aggregateVerdict: aggregate(results),
+    ...(extra ?? {}),
+  };
+  const filepath = resolve(REPORT_DIR, `${probeName}.json`);
+  await writeFile(filepath, JSON.stringify(report, null, 2) + '\n', 'utf8');
+  return { report, path: filepath };
+}
+
+export async function runShim(probeName, engine, mainFn) {
+  try {
+    const outcome = (await mainFn()) ?? { results: [] };
+    const { results, extra } = outcome;
+    const { report, path: filepath } = await writeReport({ probeName, engine, results, extra });
+    process.stdout.write(JSON.stringify(report, null, 2) + '\n');
+    process.stdout.write(`report written to ${filepath}\n`);
+    if (report.aggregateVerdict === 'fail') process.exitCode = 1;
+  } catch (err) {
+    // Positive-evidence rule (exception fallback): exception rows have no
+    // observed AC; anchor null (never a fabricated id like
+    // "unknown"), carry an evidence object with the error excerpt.
+    const message = err && err.message ? err.message : String(err);
+    const stack = err && err.stack ? err.stack : String(err);
+    const results = [{
+      anchorAcId: null,
+      verdict: 'fail',
+      detail: `probe threw: ${message}`,
+      evidence: {
+        errorMessage: message,
+        errorExcerpt: excerpt(stack, 480),
+      },
+    }];
+    const { report, path: filepath } = await writeReport({ probeName, engine, results });
+    process.stdout.write(JSON.stringify(report, null, 2) + '\n');
+    process.stderr.write(`probe error: ${stack}\n`);
+    process.stderr.write(`report written to ${filepath}\n`);
+    process.exitCode = 1;
+  }
+}

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

@@ -0,0 +1,5 @@
+import runProbe from './keyboard-traversal.mjs';
+import { runShim } from './probe-utils.mjs';
+
+const engine = { kind: 'fixture', image: 'test/fixtures/probe-pack-application-charts/server.js', healthy: true };
+runShim('keyboard-traversal', engine, runProbe);

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

@@ -0,0 +1,5 @@
+import runProbe from './non-colour-distinction.mjs';
+import { runShim } from './probe-utils.mjs';
+
+const engine = { kind: 'fixture', image: 'test/fixtures/probe-pack-application-charts/server.js', healthy: true };
+runShim('non-colour-distinction', engine, runProbe);

package/blueprints/application-charts/contributions/probes/run-text-alternative-table.mjs

@@ -0,0 +1,5 @@
+import runProbe from './text-alternative-table.mjs';
+import { runShim } from './probe-utils.mjs';
+
+const engine = { kind: 'fixture', image: 'test/fixtures/probe-pack-application-charts/server.js', healthy: true };
+runShim('text-alternative-table', engine, runProbe);

package/blueprints/application-charts/contributions/probes/text-alternative-table.mjs

@@ -0,0 +1,139 @@
+// application-charts probe: paired text-alternative table lives in
+// the chart's landmark (AC-18103-1) and every cell matches the
+// chart's rendered value for the same (x, series) coordinate to the
+// same precision (AC-18103-3).
+//
+// The probe extracts the (series, x, value) tuple from every SVG
+// data-point element (data-series/data-x/data-y on
+// .chartDataPoint) as the render's own source of truth, then walks
+// the paired <table> and confirms every cell holds the same numeric
+// text at the same (x, series) coordinate. A single mismatch or a
+// missing coordinate fails the row (AC-18103-3 wording: "every
+// cell's text value matches the chart's rendered value for the same
+// (x, series) coordinate to the same precision the chart renders;
+// a mismatched or missing cell fails the pack check").
+
+import { fixtureFetch, startFixture, excerpt } from './probe-utils.mjs';
+
+export const anchorAcId = 'application-charts-AC-18103-1';
+export const accountBound = false;
+
+function parseChartRegions(body) {
+  // Each <section class="chartRegion"> holds one SVG and (unless
+  // broken) one <table class="chartAltTable"> in the same landmark.
+  const regions = [];
+  const regionRe = /<section class="chartRegion"[^>]*>([\s\S]*?)<\/section>/g;
+  let m;
+  while ((m = regionRe.exec(body)) !== null) regions.push(m[1]);
+  return regions;
+}
+
+function extractRenderedPoints(regionHtml) {
+  // The SVG data-points are the render's source of truth. Each
+  // element carries data-series="<name>" data-x="<xLabel>"
+  // data-y="<numeric value>". Return a Map keyed as "series|x".
+  const points = new Map();
+  const dpRe = /class="chartDataPoint"[^>]*data-series="([^"]+)"[^>]*data-x="([^"]+)"[^>]*data-y="([^"]+)"/g;
+  let m;
+  while ((m = dpRe.exec(regionHtml)) !== null) {
+    points.set(`${m[1]}|${m[2]}`, m[3]);
+  }
+  return points;
+}
+
+function extractTableCells(regionHtml) {
+  // Parse <thead><tr><th>Day</th><th>SeriesA (unit)</th>...</tr></thead>
+  // <tbody><tr><th>Mon</th><td>30</td>...</tr>...</tbody>
+  // and produce a Map keyed as "series|x" to cell text.
+  const tableMatch = regionHtml.match(/<table class="chartAltTable"[\s\S]*?<\/table>/);
+  if (!tableMatch) return null;
+  const table = tableMatch[0];
+  const headers = [...table.matchAll(/<th scope="col">([^<]+)<\/th>/g)].map((h) => h[1]);
+  // Column 0 is the row heading (e.g. "Day"); subsequent columns are
+  // series columns like "Prod (requests)". Strip the trailing unit
+  // in parens to isolate the series name.
+  const seriesCols = headers.slice(1).map((h) => h.replace(/\s*\(.*\)\s*$/, '').trim());
+  const rows = [...table.matchAll(/<tr>([\s\S]*?)<\/tr>/g)];
+  const cells = new Map();
+  for (const [_, rowInner] of rows) {
+    const rowHead = rowInner.match(/<th scope="row">([^<]+)<\/th>/);
+    if (!rowHead) continue;
+    const xLabel = rowHead[1];
+    const tdMatches = [...rowInner.matchAll(/<td>([^<]*)<\/td>/g)].map((c) => c[1]);
+    tdMatches.forEach((cellText, i) => {
+      const series = seriesCols[i];
+      if (series) cells.set(`${series}|${xLabel}`, cellText.trim());
+    });
+  }
+  return cells;
+}
+
+export default async function runProbe() {
+  const fixture = await startFixture();
+  const results = [];
+  try {
+    const golden = await fixtureFetch(fixture.url, '/');
+    const regions = parseChartRegions(golden.body);
+    const landmarkPass = golden.status === 200 && !!golden.requestId
+      && regions.length >= 2
+      && regions.every((r) => /<table class="chartAltTable"/.test(r));
+    results.push({
+      anchorAcId: null,
+      conformanceOnly: true,
+      limitation: 'application-charts-AC-18103-1: browser focus movement onto the paired table and assistive-tech traversal (the AC clauses beyond DOM shape) are browser-driven and not observed by this Node HTTP probe; the DOM landmark walk is a partial observation of AC-18103-1',
+      verdict: landmarkPass ? 'warn' : 'fail',
+      detail: landmarkPass
+        ? `Given a rendered chart, a \`<table>\` element carrying; GET / carries ${regions.length} <section class="chartRegion" role="region"> landmarks; every landmark holds one <table class="chartAltTable"> as AC-18103-1 requires ("a <table> element carrying the same data lives in the same landmark"); x-fixture-request-id=${golden.requestId}`
+        : `Given a rendered chart, a \`<table>\` element carrying; landmark evidence gap: status=${golden.status} rid=${golden.requestId} regions=${regions.length}`,
+      evidence: {
+        requestId: golden.requestId,
+        responseStatus: golden.status,
+        bodyExcerpt: excerpt((golden.body.match(/<section class="chartRegion"[^]{0,140}/) || [''])[0]),
+        derived: { regionCount: regions.length, tablesPerRegion: regions.map((r) => (r.match(/<table class="chartAltTable"/g) || []).length) },
+      },
+    });
+
+    // AC-18103-3: every cell matches the (series, x) coordinate.
+    const perRegion = [];
+    let allMatch = true;
+    let totalCoords = 0;
+    let mismatches = [];
+    for (let ri = 0; ri < regions.length; ri += 1) {
+      const rendered = extractRenderedPoints(regions[ri]);
+      const cells = extractTableCells(regions[ri]);
+      if (!cells) { allMatch = false; mismatches.push({ region: ri, reason: 'no table' }); continue; }
+      for (const [key, renderedValue] of rendered) {
+        totalCoords += 1;
+        const cellText = cells.get(key);
+        if (cellText === undefined) { allMatch = false; mismatches.push({ region: ri, key, renderedValue, cellText: null }); continue; }
+        // Same-precision comparison: the render emits the raw numeric
+        // token in data-y, the table emits the same text; compare as
+        // strings so a 30 vs 30.0 divergence is a fail.
+        if (cellText !== renderedValue) { allMatch = false; mismatches.push({ region: ri, key, renderedValue, cellText }); }
+      }
+      // Also refuse extra table cells the chart has no coordinate
+      // for (missing chart point / spurious cell): iterate cells.
+      for (const [key, cellText] of cells) {
+        if (!rendered.has(key)) { allMatch = false; mismatches.push({ region: ri, key, renderedValue: null, cellText }); }
+      }
+      perRegion.push({ region: ri, coords: rendered.size, tableCells: cells.size });
+    }
+    const cellPass = golden.status === 200 && !!golden.requestId && totalCoords > 0 && allMatch;
+    results.push({
+      anchorAcId: 'application-charts-AC-18103-3',
+      verdict: cellPass ? 'pass' : 'fail',
+      detail: cellPass
+        ? `Given a rendered chart, when the pack inspects; Every one of ${totalCoords} rendered (series, x) coordinates matches its paired <td> cell text at the same precision the chart emits (per-region counts: ${JSON.stringify(perRegion)}); a mismatched or missing cell would fail per AC-18103-3; x-fixture-request-id=${golden.requestId}`
+        : `Given a rendered chart, when the pack inspects; AC-18103-3 evidence gap: total coords=${totalCoords} mismatches=${JSON.stringify(mismatches.slice(0, 4))}`,
+      evidence: {
+        requestId: golden.requestId,
+        responseStatus: golden.status,
+        bodyExcerpt: excerpt(`per-region=${JSON.stringify(perRegion)}`),
+        derived: { totalCoords, mismatchCount: mismatches.length, perRegion },
+      },
+    });
+  } finally {
+    await fixture.kill();
+  }
+  return { results };
+}

package/blueprints/application-charts/contributions/requirements/application-charts-req-001.json

@@ -2,14 +2,21 @@
   "reqId": "application-charts-REQ-001",
   "prdId": "PRD-001",
   "title": "The application ships the small set of chart forms an operator SaaS actually shows",
-  "description": "The application realises the chart-form set the shelf's spec commits: bar, line, area, pie or donut, single-value with sparkline, and heatmap. Every rendered chart on the shipped surface picks one of these forms and honours the render-shell contract (TAC-1901). A form outside this set is refused at project-side review; a specialised form the applying project needs (a candlestick, a Sankey) supersedes this REQ with a project-authored REQ and is documented as a known deviation.",
+  "description": "The application realises the chart-form set the shelf's spec commits: bar, line, area, pie or donut, single-value with sparkline, and heatmap. Every rendered chart on the shipped surface picks one of these forms and honours the render-shell contract (TAC-1901). A form outside this set is refused at project-side check; a specialised form the applying project needs (a candlestick, a Sankey) supersedes this REQ with a project-authored REQ and is documented as a known deviation. The chart engine is elicited at apply (`recharts`, `echarts`, `chart-js`, `d3-primitives` or `hand-authored-svg` per ADR-1901); a canvas-only engine that offers no text-alternative surface is refused at project-side check and the refusal is documented on the blueprint README under the engine-refusal rule.",
   "category": "functional",
   "domain": "application",
   "priority": "must",
   "rationale": "The form set is where teams reach for a chart library and pick the wrong tool. Enumerating the forms in the contract closes the ambiguity at ship: every rendered chart on the surface names one of the six forms and inherits its rendering discipline, its accessibility affordances and its text-alternative shape from the shell.",
-  "tags": ["blueprint:application-charts", "category:01-form-set"],
-  "version": "1.0.0",
+  "tags": [
+    "blueprint:application-charts",
+    "category:01-form-set"
+  ],
+  "version": "1.0.1",
   "status": "approved",
   "createdAt": "2026-09-04T21:00:00Z",
-  "updatedAt": "2026-09-04T21:00:00Z"
+  "updatedAt": "2026-09-09T00:00:00Z",
+  "deliveredBy": {
+    "tacId": "TAC-1901-application-charts-render-shell",
+    "field": "responsibilities"
+  }
 }

package/blueprints/application-charts/contributions/requirements/application-charts-req-002.json

@@ -2,14 +2,21 @@
   "reqId": "application-charts-REQ-002",
   "prdId": "PRD-001",
   "title": "Every chart series distinguishes on colour plus pattern plus direct label (non-colour distinction, WCAG 1.4.1)",
-  "description": "Every rendered chart with two or more series distinguishes the series through more than colour alone: colour is paired with a pattern (a dashed line, a hatched fill, a marker shape) and a direct label placed at the series (a legend entry alone does not satisfy the AC). A vision-deficiency simulation (deuteranopia is the shelf's default screen) still reads the series distinction. The blueprint's accessible palette (ADR-1902) is the colour default; the pattern and label rules apply regardless of palette.",
+  "description": "Every rendered chart with two or more series distinguishes the series through more than colour alone: colour is paired with a pattern (a dashed line, a hatched fill, a marker shape) and a direct label placed at the series (a legend entry alone does not satisfy the AC). A vision-deficiency simulation (deuteranopia is the shelf's default screen) still reads the series distinction. The blueprint's accessible palette (ADR-1902) is the colour default; the pattern and label rules apply regardless of palette. The elicited `palette-overrides` value on `blueprint.json:elicits[]` supplies operator-authored brand tokens keyed by series role or index; the render shell applies each supplied token verbatim, falls back to the accessible-defaults palette at the same series index for any missing token, and the render log records exactly one warning per unpaletted series naming the missing token (ADR-1902). An empty override string (the default) is legal and resolves to the accessible-defaults palette with no warnings; a malformed override (non-JSON, or a shape the shell cannot key by series role or index) is refused at project-side check and the refusal is recorded on the render log.",
   "category": "functional",
   "domain": "application",
   "priority": "must",
   "rationale": "Colour blindness is the most common visual disability and colour-only series distinction is the most common accessibility defect on chart libraries; the tri-cue (colour, pattern, label) is what WCAG 1.4.1 asks for and what a build-scan or runtime check can prove at the DOM level.",
-  "tags": ["blueprint:application-charts", "category:02-non-colour-distinction"],
-  "version": "1.0.0",
+  "tags": [
+    "blueprint:application-charts",
+    "category:02-non-colour-distinction"
+  ],
+  "version": "1.0.1",
   "status": "approved",
   "createdAt": "2026-09-04T21:00:00Z",
-  "updatedAt": "2026-09-04T21:00:00Z"
+  "updatedAt": "2026-09-04T21:00:00Z",
+  "deliveredBy": {
+    "tacId": "TAC-1901-application-charts-render-shell",
+    "field": "responsibilities"
+  }
 }

package/blueprints/application-charts/contributions/requirements/application-charts-req-003.json

@@ -7,9 +7,16 @@
   "domain": "application",
   "priority": "must",
   "rationale": "A chart is a visual encoding of data; a text-alternative table is the only assistive-tech-reachable form of the same data that fits the existing table-navigation vocabulary. Screen-reader users receive the same information; a canvas-only chart with no text-alternative is inaccessible.",
-  "tags": ["blueprint:application-charts", "category:03-text-alternative"],
-  "version": "1.0.0",
+  "tags": [
+    "blueprint:application-charts",
+    "category:03-text-alternative"
+  ],
+  "version": "1.0.1",
   "status": "approved",
   "createdAt": "2026-09-04T21:00:00Z",
-  "updatedAt": "2026-09-04T21:00:00Z"
+  "updatedAt": "2026-09-04T21:00:00Z",
+  "deliveredBy": {
+    "tacId": "TAC-1901-application-charts-render-shell",
+    "field": "responsibilities"
+  }
 }

package/blueprints/application-charts/contributions/requirements/application-charts-req-004.json

@@ -7,9 +7,16 @@
   "domain": "application",
   "priority": "must",
   "rationale": "Keyboard-only users need the same data-point granularity a pointer user has, and the announced string is the assistive-tech-visible surface. Reduced-motion respect is the WCAG 2.3.3 clause the shelf inherits from application-spa's motion tokens; a chart that does not honour it fails the same clause.",
-  "tags": ["blueprint:application-charts", "category:04-keyboard-traversal"],
-  "version": "1.0.0",
+  "tags": [
+    "blueprint:application-charts",
+    "category:04-keyboard-traversal"
+  ],
+  "version": "1.0.1",
   "status": "approved",
   "createdAt": "2026-09-04T21:00:00Z",
-  "updatedAt": "2026-09-04T21:00:00Z"
+  "updatedAt": "2026-09-04T21:00:00Z",
+  "deliveredBy": {
+    "tacId": "TAC-1901-application-charts-render-shell",
+    "field": "responsibilities"
+  }
 }

package/blueprints/application-charts/contributions/tacs/tac-1901-application-charts-render-shell.json

@@ -2,7 +2,7 @@
   "tacId": "TAC-1901-application-charts-render-shell",
   "prdId": "PRD-001",
   "tadId": "TAD-001",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "status": "approved",
   "name": "Chart render shell",
   "purpose": "Owns the rendered chart surface: the mount seam every chart on the shipped surface routes through, the accessible-defaults palette hook (ADR-1902), the text-alternative slot (a `<table>` in the same landmark as the chart), and the reduced-motion respect via the application-spa motion tokens (ADR-1903). The shell is the substitutable interface every AC in this blueprint anchors on, and the applying project's chosen chart engine (ADR-1901) mounts against this contract.",
@@ -12,7 +12,8 @@
     "Render a paired `<table>` element in the same landmark as the chart (`role=\"region\"` wrapping both, or the same `<section>`), with a row per x-value or category and a column per series (AC-18103-1), and expose a labelled control that moves focus to the table when the table is visually-hidden (AC-18103-2).",
     "Expose the accessible-defaults palette (light and dark) as the recommended default and accept operator brand tokens as overrides with a fallback to the defaults on missing tokens (AC-18105-1, AC-18105-2).",
     "Honour `prefers-reduced-motion: reduce` by suppressing entry and update transitions on the chart surface (AC-18104-1, ADR-1903).",
-    "Route text-alternative refusals: a chart engine that renders canvas-only with no text-alternative path is refused at mount (AC-18106-1) and the shell writes a warning to the render log."
+    "Route text-alternative refusals: a chart engine that renders canvas-only with no text-alternative path is refused at mount (AC-18106-1) and the shell writes one warning entry to the render log per refused chart declaration, keyed to the chart declaration's accessible-name and naming the engine and the missing text-alternative surface; a compliant re-mount clears the surface without duplicating the warning (AC-18106-3, AC-18106-4).",
+    "Attach a `data-chart-engine` attribute on the rendered chart mount whose value equals the elicited engine token from `blueprint.json:elicits[chart-engine]` (AC-18106-2)."
   ],
   "internalStructure": "One shell module that mounts the surface, plus small internal helpers per chart form (form binders that translate the chart declaration into engine-specific mount calls). Every form binder writes to the same DOM landmark shape and reads from the same palette API. The framework is not prescribed; the shell interfaces are what the project realises against Recharts, ECharts, Chart.js, D3 primitives or a hand-authored SVG.",
   "interfaces": [

package/blueprints/application-charts/contributions/tacs/tac-1902-application-charts-keyboard-traversal.json

@@ -2,7 +2,7 @@
   "tacId": "TAC-1902-application-charts-keyboard-traversal",
   "prdId": "PRD-001",
   "tadId": "TAD-001",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "approved",
   "name": "Chart keyboard traversal contract",
   "purpose": "Owns the keyboard traversal contract for interactive charts: each data point receives focus in reading order, the announced string carries the series name, x-value, y-value and unit, and the traversal path composes cleanly with the shell's text-alternative table so a keyboard-only user reaches every value through either surface.",

package/blueprints/application-charts/contributions/user-stories/application-charts-us-18101.json

@@ -2,7 +2,7 @@
   "usId": "application-charts-US-18101",
   "prdId": "PRD-001",
   "reqId": "application-charts-REQ-001",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "status": "approved",
   "title": "Every chart on the shipped surface names one of the six committed forms and honours the render-shell contract",
   "asA": "product owner responsible for the shipped surface's data affordances",
@@ -11,25 +11,69 @@
   "acceptanceCriteria": [
     {
       "id": "AC-18101-1",
-      "description": "Given a rendered chart on the surface, the chart's declared form matches one of {bar, line, area, pie, donut, single-value, sparkline, heatmap}; a form outside this set is refused at project-side review or documented on the blueprint's README as a project-authored deviation.",
+      "description": "Given a rendered chart on the surface, the chart's declared form matches one of {bar, line, area, pie, donut, single-value, sparkline, heatmap}; a form outside this set is refused at project-side check or documented on the blueprint's README as a project-authored deviation.",
       "given": "a rendered chart on the shipped surface",
       "when": "the surface is reviewed against the shelf",
       "then": "the chart's declared form is one of the six committed forms or a documented project deviation",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-18101-2",
-      "description": "Given a rendered chart, the chart mounts through the render-shell contract (TAC-1901): the shell exposes the accessible-defaults palette hook (ADR-1902) and the text-alternative slot; a chart that skips the shell contract (renders through a raw chart-library mount) is refused at project-side review.",
+      "description": "Given a rendered chart, the chart mounts through the render-shell contract (TAC-1901): the shell exposes the accessible-defaults palette hook (ADR-1902) and the text-alternative slot; a chart that skips the shell contract (renders through a raw chart-library mount) is refused at project-side check.",
       "given": "a rendered chart",
       "when": "the mount seam is inspected",
       "then": "the chart is mounted through TAC-1901's render shell",
       "testable": true,
-      "scope": "library"
+      "scope": "library",
+      "disposition": "fixed"
+    },
+    {
+      "id": "AC-18101-3",
+      "description": "Given a rendered chart, when the chart's declared form matches one of the six committed forms (bar, line, area, pie, donut, single-value, sparkline, heatmap), the shell exposes a per-form binder resolving the values to the form's DOM primitives (rects for bar, path for line and area, arcs for pie or donut, one text node for single-value, mini-path for sparkline, grid cells for heatmap); a form whose binder is absent fails the pack check.",
+      "given": "a rendered chart of one of the six committed forms",
+      "when": "the pack inspects the shell's form binder",
+      "then": "the shell exposes the per-form binder resolving values to the form's DOM primitives; a missing binder fails the check",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[0]"
+      }
+    },
+    {
+      "id": "AC-18101-4",
+      "description": "Given a specialised form the applying project needs (a candlestick, a Sankey), the project's README carries a CALLS MADE entry naming the deviation and the project supersedes REQ-001 with a project-authored REQ that names the deviating form; a specialised form without a documented CALLS MADE + superseding REQ fails project-side check. Applying agent sets: the specialised chart form the project needs (a candlestick, a Sankey), the CALLS MADE entry text (the deviation from the six-form set quoted verbatim and the project's reason), and the project-authored superseding REQ id that names the deviating form.",
+      "given": "an applying project shipping a form outside the six committed",
+      "when": "the check inspects the project's CALLS MADE and REQ set",
+      "then": "the deviation is documented with a project-authored superseding REQ; an undocumented deviation fails the check",
+      "testable": true,
+      "scope": "unclassified",
+      "disposition": "template"
+    },
+    {
+      "id": "AC-18101-5",
+      "description": "Given a rendered chart whose form is declared correctly but whose data set is empty (no series values), the shell renders a labelled empty-state block (`role=\"region\"` with an accessible name naming the empty condition) inside the same landmark as the chart; a shell that renders a blank chart canvas with no announcement fails the pack check.",
+      "given": "a rendered chart with an empty data set",
+      "when": "the pack inspects the shell's render",
+      "then": "the shell renders a labelled empty-state block with an accessible name inside the chart's landmark; a silent blank chart fails",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[0]"
+      }
     }
   ],
-  "tacIds": ["TAC-1901-application-charts-render-shell"],
-  "tags": ["blueprint:application-charts"],
+  "tacIds": [
+    "TAC-1901-application-charts-render-shell"
+  ],
+  "tags": [
+    "blueprint:application-charts"
+  ],
   "createdAt": "2026-09-04T21:00:00Z",
-  "updatedAt": "2026-09-04T21:00:00Z"
+  "updatedAt": "2026-09-09T00:00:00Z"
 }

package/blueprints/application-charts/contributions/user-stories/application-charts-us-18102.json

@@ -2,7 +2,7 @@
   "usId": "application-charts-US-18102",
   "prdId": "PRD-001",
   "reqId": "application-charts-REQ-002",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "status": "approved",
   "title": "Series distinction combines colour, pattern and direct label so a colour-blind reader reads the same distinction",
   "asA": "reader with a colour-vision deficiency using the shipped surface",
@@ -16,7 +16,8 @@
       "when": "the DOM is inspected",
       "then": "every series carries colour plus a non-colour pattern attribute plus a direct label",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-18102-2",
@@ -25,11 +26,62 @@
       "when": "the pack runs",
       "then": "the AC-18102-1 rule does not apply and the pack records applicable false",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed",
+      "vendorCitation": {
+        "url": "https://www.w3.org/WAI/WCAG22/Understanding/use-of-color.html",
+        "verifiedOn": "2026-09-09"
+      }
+    },
+    {
+      "id": "AC-18102-3",
+      "description": "Given a rendered multi-series chart whose series distinction relies on the shipped accessible palette AND a distinguishing pattern, when the deuteranopia simulation is applied to a screenshot of the surface, the series remain visually distinct (a pattern still parses through the simulation); a chart whose only distinction is a colour indistinguishable under the simulation fails the pack check.",
+      "given": "a rendered multi-series chart under a deuteranopia simulation",
+      "when": "the pack inspects the simulated screenshot",
+      "then": "the series remain visually distinct through the pattern and label; a colour-only distinction fails",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[1]"
+      }
+    },
+    {
+      "id": "AC-18102-4",
+      "description": "Given a rendered multi-series chart whose legend is present but no series carries a direct label at the series, the pack fails the check per REQ-002 (a legend entry alone does not satisfy the AC); a passing chart carries a direct label at each series either inside the plot area or immediately adjacent to the series line, bar or slice.",
+      "given": "a rendered multi-series chart with a legend but no direct series labels",
+      "when": "the pack inspects the DOM",
+      "then": "the check fails; a passing chart carries a direct series label at each series (not only in the legend)",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[1]"
+      }
+    },
+    {
+      "id": "AC-18102-5",
+      "description": "Given a rendered multi-series chart with more series than the shipped palette provides colours for (a 20-series chart against an 8-colour palette), the shell cycles the palette AND changes the pattern so the pattern-plus-index combination stays unique across series; two series that share both colour AND pattern fail the pack check.",
+      "given": "a rendered chart with more series than the palette carries colours",
+      "when": "the pack inspects series colour and pattern combinations",
+      "then": "each series has a unique (colour, pattern) combination; two series sharing both fail the check",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1901-application-charts-render-shell",
+        "field": "responsibilities[1]"
+      }
     }
   ],
-  "tacIds": ["TAC-1901-application-charts-render-shell"],
-  "tags": ["blueprint:application-charts"],
+  "tacIds": [
+    "TAC-1901-application-charts-render-shell"
+  ],
+  "tags": [
+    "blueprint:application-charts"
+  ],
   "createdAt": "2026-09-04T21:00:00Z",
-  "updatedAt": "2026-09-04T21:00:00Z"
+  "updatedAt": "2026-09-10T07:07:28Z"
 }