{"id":"quality","relativePath":"quality.md","title":"Quality & Performance","markdown":"# Quality & Performance\n\nMeasured, CI-enforced quality signals. The numbers below come from CI and the evidence pipeline — they are gated, not hand-asserted: if a score regresses below its threshold, the build fails.\n\n## Accessibility — WCAG 2.1 AA\n\nTwo independent checks run on every CI build (`.github/workflows/ci.yml`).\n\n### Lighthouse accessibility — **100 / 100** (gate: ≥ 95)\n\n| Page | Score |\n|---|:--:|\n| Home `/` | **100** |\n| Explore `/explore` | **100** |\n| Artwork `/artwork/[id]` | **100** |\n\n`scripts/lighthouse-a11y.mjs` fails the build if any page scores below 95. Run: `pnpm lighthouse:ci`.\n\n### axe-core — **0 severe violations** across 18 routes\n\nZero critical / serious / moderate WCAG 2A + 2AA violations across **18 public routes**: home, explore, records, linked-art, patterns, insights, graph, entities, iiif, issues, agents, automation, etl/mapper, roadmap, getty, curator/reconciliation, plus dynamic `/artwork/[id]` and `/entity/[id]`. `scripts/a11y-check.ts` fails the build on any severe violation. Run: `pnpm a11y:ci`.\n\n## Performance budget — k6 SLOs\n\n`scripts/k6-slo.js` enforces a per-scenario latency + error-rate budget under load (16 req/s, up to 24 VUs). Latest measured run (`artifacts/performance/k6-slo-summary.json`) — all measured scenarios comfortably within budget:\n\n| Scenario | p95 budget | measured p95 | error budget | measured |\n|---|:--:|:--:|:--:|:--:|\n| Cached record read | < 200 ms | **73.5 ms** | < 1% | **0.00%** |\n| Cold record read | < 500 ms | **56.1 ms** | < 1% | **0.00%** |\n| Keyword / facet search | < 300 ms | **55.1 ms** | < 1% | **0.00%** |\n| SPARQL (whitelisted) | < 2000 ms | _needs GraphDB_ | < 1% | — |\n| IIIF tile serving | < 100 ms | _needs IIIF infra_ | < 1% | — |\n\nThe k6 thresholds abort the run on any breach. Enforced by `pnpm k6:slo:ci` in the evidence pipeline (`.github/workflows/era-c-exit-gate-evidence.yml`).\n\n## Test coverage\n\n`pnpm test:coverage` (c8) — **89.4% lines · 92.1% functions · 75.5% branches** across 1,116 tests, gated in CI (floor 85 / 85 / 70). Core application code: `src/services` 91.9%, `src/adapters` 91.3%, `src/gateway` 100%.\n\n## Other CI gates\n\n- **Types & lint** — TypeScript `strict`, ESLint (`pnpm lint`).\n- **Linked Art conformance** — protocol MUSTs + per-provider SHACL shapes (`shacl-conformance.yml`) + a generated, drift-gated conformance matrix.\n- **Supply chain** — `pnpm audit --prod` (fails on high/critical) + Dependabot.\n- **Visual** — public-trust Playwright smoke with screenshot diffing.\n\n_Last refreshed: 2026-06-24. Accessibility and coverage numbers are reproduced on every CI run; performance numbers are from the latest evidence-pipeline run._\n","sections":[{"level":2,"heading":"Accessibility — WCAG 2.1 AA","anchor":"accessibility-wcag-2-1-aa"},{"level":3,"heading":"Lighthouse accessibility — **100 / 100** (gate: ≥ 95)","anchor":"lighthouse-accessibility-100-100-gate-95"},{"level":3,"heading":"axe-core — **0 severe violations** across 18 routes","anchor":"axe-core-0-severe-violations-across-18-routes"},{"level":2,"heading":"Performance budget — k6 SLOs","anchor":"performance-budget-k6-slos"},{"level":2,"heading":"Test coverage","anchor":"test-coverage"},{"level":2,"heading":"Other CI gates","anchor":"other-ci-gates"}],"html":"

Quality & Performance

\n

Measured, CI-enforced quality signals. The numbers below come from CI and the evidence pipeline — they are gated, not hand-asserted: if a score regresses below its threshold, the build fails.

\n

Accessibility — WCAG 2.1 AA

\n

Two independent checks run on every CI build (`.github/workflows/ci.yml`).

\n

Lighthouse accessibility — 100 / 100 (gate: ≥ 95)

\n

| Page | Score |

\n

|---|:--:|

\n

| Home `/` | 100 |

\n

| Explore `/explore` | 100 |

\n

| Artwork `/artwork/[id]` | 100 |

\n

`scripts/lighthouse-a11y.mjs` fails the build if any page scores below 95. Run: `pnpm lighthouse:ci`.

\n

axe-core — 0 severe violations across 18 routes

\n

Zero critical / serious / moderate WCAG 2A + 2AA violations across 18 public routes: home, explore, records, linked-art, patterns, insights, graph, entities, iiif, issues, agents, automation, etl/mapper, roadmap, getty, curator/reconciliation, plus dynamic `/artwork/[id]` and `/entity/[id]`. `scripts/a11y-check.ts` fails the build on any severe violation. Run: `pnpm a11y:ci`.

\n

Performance budget — k6 SLOs

\n

`scripts/k6-slo.js` enforces a per-scenario latency + error-rate budget under load (16 req/s, up to 24 VUs). Latest measured run (`artifacts/performance/k6-slo-summary.json`) — all measured scenarios comfortably within budget:

\n

| Scenario | p95 budget | measured p95 | error budget | measured |

\n

|---|:--:|:--:|:--:|:--:|

\n

| Cached record read | < 200 ms | 73.5 ms | < 1% | 0.00% |

\n

| Cold record read | < 500 ms | 56.1 ms | < 1% | 0.00% |

\n

| Keyword / facet search | < 300 ms | 55.1 ms | < 1% | 0.00% |

\n

| SPARQL (whitelisted) | < 2000 ms | _needs GraphDB_ | < 1% | — |

\n

| IIIF tile serving | < 100 ms | _needs IIIF infra_ | < 1% | — |

\n

The k6 thresholds abort the run on any breach. Enforced by `pnpm k6:slo:ci` in the evidence pipeline (`.github/workflows/era-c-exit-gate-evidence.yml`).

\n

Test coverage

\n

`pnpm test:coverage` (c8) — 89.4% lines · 92.1% functions · 75.5% branches across 1,116 tests, gated in CI (floor 85 / 85 / 70). Core application code: `src/services` 91.9%, `src/adapters` 91.3%, `src/gateway` 100%.

\n

Other CI gates

\n\n

_Last refreshed: 2026-06-24. Accessibility and coverage numbers are reproduced on every CI run; performance numbers are from the latest evidence-pipeline run._

","updatedAt":"2018-10-20T01:46:40.000Z","checksum":"174add04096060c0a58045e311d73eff53233f53119abf354e903b3b7664d300","checksumPrefix":"174add040960","anchorCount":6,"lineCount":49,"rawUrl":"/api/docs/content?path=quality.md","htmlUrl":"/docs?doc=quality.md","apiUrl":"/api/docs/content?path=quality.md"}