stylegallery 0.1.0 → 0.1.2

package/scripts/component-state-semantics.mjs

@@ -1,128 +0,0 @@
-function finding(code, file, message) {
-  return { code, message, path: file };
-}
-
-function duplicateValues(values, normalize = (value) => value) {
-  const seen = new Set();
-  const duplicates = new Set();
-  for (const value of values) {
-    const key = normalize(value);
-    if (seen.has(key)) duplicates.add(key);
-    seen.add(key);
-  }
-  return [...duplicates];
-}
-
-function sameSet(left, right) {
-  return JSON.stringify([...(left ?? [])].sort()) === JSON.stringify([...(right ?? [])].sort());
-}
-
-function validateApplicability(component, file, failures) {
-  for (const id of duplicateValues((component.semantic_modes ?? []).map((mode) => mode.id))) failures.push(finding("semantic_mode_duplicate", file, `semantic mode ${id} is duplicated`));
-  for (const mode of component.semantic_modes ?? []) {
-    for (const name of duplicateValues((mode.aria_states ?? []).map((state) => state.name))) failures.push(finding("aria_state_duplicate", file, `${mode.id} repeats ${name}`));
-    for (const state of mode.aria_states ?? []) {
-      if (["not_applicable", "prohibited"].includes(state.status) && !state.reason) failures.push(finding("applicability_reason_required", file, `${mode.id}.${state.name} requires a reason`));
-      if (state.status === "conditional" && (!state.condition || !state.resolution)) failures.push(finding("conditional_unresolved", file, `${mode.id}.${state.name} requires condition and resolution`));
-      if (state.status === "conditional" && ["not_applicable", "prohibited"].includes(state.resolution) && !state.reason) failures.push(finding("applicability_reason_required", file, `${mode.id}.${state.name} requires a resolution reason`));
-    }
-    const required = mode.id === "toggle" ? "pressed" : mode.id === "disclosure" ? "expanded" : mode.id === "switch" ? "checked" : undefined;
-    const state = (mode.aria_states ?? []).find((candidate) => candidate.name === required);
-    if (required && (!state || !["required", "conditional"].includes(state.status) || (state.status === "conditional" && state.resolution !== "required"))) {
-      failures.push(finding("role_required_aria_state", file, `${mode.id} requires applicable aria-${required}`));
-    }
-    if (mode.id === "switch" && (mode.aria_states ?? []).find((state) => state.name === "checked")?.values?.includes("mixed")) {
-      failures.push(finding("switch_mixed_prohibited", file, "switch aria-checked must not include mixed"));
-    }
-  }
-}
-
-function validateSurface(scenario, state, visual, aria, dom, ax, code, failures, file) {
-  const present = new Set(scenario.states ?? []).has(state);
-  const surfaces = [
-    (scenario.expected?.visual ?? []).includes(visual),
-    aria ? scenario.aria?.[aria] === "true" : present,
-    dom ? scenario.expected?.dom?.[dom] === "true" : present,
-    ax ? scenario.expected?.ax?.[ax] === true : present,
-  ];
-  if (surfaces.some((value) => value !== present)) failures.push(finding(code, file, `${scenario.id} ${state} surfaces disagree`));
-}
-
-export function validateComponentSemantics(component, file, failures) {
-  validateApplicability(component, file, failures);
-  if (component.versions?.delivery_channel === "stable" && component.versions.lifecycle !== "stable") failures.push(finding("preview_rolled_stable", file, "preview components cannot be relabeled stable"));
-}
-
-export function validateStateSemantics(states, component, file, failures) {
-  const scenarios = states.scenarios ?? [];
-  const visualEnvironments = states.visual_environments ?? [];
-  const visualEnvironmentIds = new Set(visualEnvironments.map((environment) => environment.id));
-  for (const id of duplicateValues(visualEnvironments.map((environment) => environment.id))) failures.push(finding("visual_environment_duplicate", file, `visual environment ${id} is duplicated`));
-  for (const selector of duplicateValues(visualEnvironments, (environment) => JSON.stringify(Object.entries(environment).filter(([key]) => key !== "id").sort()))) failures.push(finding("visual_environment_selector_duplicate", file, `visual environment selector ${selector} is duplicated`));
-  for (const id of duplicateValues(scenarios.map((scenario) => scenario.id))) failures.push(finding("scenario_duplicate", file, `scenario ${id} is duplicated`));
-  for (const key of duplicateValues(scenarios, (scenario) => [...(scenario.states ?? [])].sort().join("\u0000"))) failures.push(finding("state_set_duplicate", file, `state set ${key} is duplicated`));
-  const modes = new Map((component.semantic_modes ?? []).map((mode) => [mode.id, mode]));
-  for (const scenario of scenarios) {
-    const visualImages = scenario.expected?.visual_image ?? [];
-    for (const id of duplicateValues(visualImages.map((image) => image.environment_id))) failures.push(finding("visual_expectation_duplicate", file, `${scenario.id} repeats visual expectation ${id}`));
-    for (const image of visualImages) if (!visualEnvironmentIds.has(image.environment_id)) failures.push(finding("visual_environment_unknown", file, `${scenario.id} references unknown visual environment ${image.environment_id}`));
-    for (const id of visualEnvironmentIds) if (!visualImages.some((image) => image.environment_id === id)) failures.push(finding("visual_expectation_missing", file, `${scenario.id} lacks visual expectation ${id}`));
-    const stateSet = new Set(scenario.states ?? []);
-    const mode = modes.get(scenario.semantic_mode);
-    if (!mode) failures.push(finding("scenario_mode_unknown", file, `${scenario.id} references an unknown semantic mode`));
-    if (scenario.expected?.dom?.role !== mode?.role || scenario.expected?.ax?.role !== mode?.role) failures.push(finding("role_surface_mismatch", file, `${scenario.id} role surfaces disagree with its semantic mode`));
-    validateSurface(scenario, "focus", "focus", undefined, "active", "focused", "focus_surface_mismatch", failures, file);
-    validateSurface(scenario, "pressed", "pressed", "pressed", "aria-pressed", "pressed", "pressed_surface_mismatch", failures, file);
-    validateSurface(scenario, "expanded", "expanded", "expanded", "aria-expanded", "expanded", "expanded_surface_mismatch", failures, file);
-    validateSurface(scenario, "busy", "busy", "busy", "aria-busy", "busy", "busy_surface_mismatch", failures, file);
-    validateSurface(scenario, "disabled", "disabled", "disabled", "disabled", "disabled", "disabled_surface_mismatch", failures, file);
-    if (stateSet.has("loading") && (!stateSet.has("busy") || !(scenario.expected?.visual ?? []).includes("loading"))) failures.push(finding("loading_busy_state_required", file, `${scenario.id} loading requires distinct visible busy state`));
-    if (stateSet.has("loading") && (scenario.expected?.visual ?? []).includes("disabled") && !stateSet.has("disabled")) failures.push(finding("loading_disabled_conflated", file, `${scenario.id} renders loading as disabled`));
-    if (stateSet.has("disabled") && scenario.expected?.activation !== "suppressed") failures.push(finding("disabled_activation", file, `${scenario.id} disabled activation must be suppressed`));
-    if (!stateSet.has("disabled") && !stateSet.has("loading") && scenario.expected?.activation === "suppressed") failures.push(finding("normative_activation_conflict", file, `${scenario.id} suppresses activation without a suppressing state`));
-  }
-}
-
-export function validateFixtureSemantics(fixture, states, component, file, failures) {
-  const canonical = new Map((states.scenarios ?? []).map((scenario) => [scenario.id, scenario]));
-  const modes = new Map((component.semantic_modes ?? []).map((mode) => [mode.id, mode]));
-  for (const id of duplicateValues((fixture.scenarios ?? []).map((scenario) => scenario.id))) failures.push(finding("fixture_scenario_duplicate", file, `fixture scenario ${id} is duplicated`));
-  for (const scenario of fixture.scenarios ?? []) {
-    const source = canonical.get(scenario.id);
-    if (!source) failures.push(finding("fixture_scenario_missing", file, `${scenario.id} has no canonical state scenario`));
-    else if (source.semantic_mode !== scenario.semantic_mode) failures.push(finding("normative_mode_conflict", file, `${scenario.id} semantic modes disagree`));
-    if (!modes.get(scenario.semantic_mode)?.keys?.includes(scenario.activation_key)) failures.push(finding("fixture_activation_key_invalid", file, `${scenario.id} activation key is not declared by its mode`));
-  }
-  for (const id of canonical.keys()) if (!(fixture.scenarios ?? []).some((scenario) => scenario.id === id)) failures.push(finding("fixture_scenario_unexercised", file, `${id} lacks a runtime fixture`));
-}
-
-export function validateEvidenceSemantics(evidence, fixture, states, file, failures) {
-  if (Object.hasOwn(evidence, "aggregate_pass") || Object.hasOwn(evidence, "certification")) failures.push(finding("aggregate_pass_forbidden", file, "aggregate pass and certification claims are forbidden"));
-  const canonical = new Map((states.scenarios ?? []).map((scenario) => [scenario.id, scenario]));
-  const fixtures = new Map((fixture.scenarios ?? []).map((scenario) => [scenario.id, scenario]));
-  const passes = evidence.passes ?? [];
-  for (const id of duplicateValues(passes.map((pass) => pass.id))) failures.push(finding("evidence_pass_duplicate", file, `evidence pass ${id} is duplicated`));
-  for (const key of duplicateValues(passes, (pass) => `${pass.scenario_id}\u0000${pass.channel}`)) failures.push(finding("evidence_channel_duplicate", file, `scenario channel ${key} is duplicated`));
-  for (const artifact of duplicateValues(passes.map((pass) => pass.artifact?.path).filter(Boolean))) failures.push(finding("evidence_artifact_reused", file, `artifact ${artifact} is reused`));
-  for (const digest of duplicateValues(passes.map((pass) => pass.artifact?.sha256).filter(Boolean))) failures.push(finding("evidence_artifact_content_reused", file, `artifact content ${digest} is reused`));
-  const runIdentities = new Set(passes.map((pass) => JSON.stringify(pass.run)));
-  const environments = new Set(passes.map((pass) => JSON.stringify(pass.environment)));
-  if (runIdentities.size > 1 || environments.size > 1) failures.push(finding("evidence_runtime_identity_mismatch", file, "passes must share one actual run and environment"));
-  const sessions = new Set(passes.map((pass) => JSON.stringify(pass.session)));
-  if (sessions.size > 1) failures.push(finding("capture_session_mismatch", file, "passes must share one capture session"));
-  for (const pass of passes) {
-    const source = canonical.get(pass.scenario_id);
-    const scenario = fixtures.get(pass.scenario_id);
-    if (!source || !scenario) failures.push(finding("evidence_scenario_unknown", file, `${pass.id} references unknown scenario ${pass.scenario_id}`));
-    if (pass.channel === "at" || pass.environment?.kind === "assistive_technology") failures.push(finding("at_evidence_unverified", file, `${pass.id} self-asserts an AT run without external attestation`));
-    if (pass.session && (pass.run?.id !== pass.session.session_id || pass.run?.revision !== pass.session.revision || pass.run?.attempt !== pass.session.attempt || !sameSet([JSON.stringify(pass.environment)], [JSON.stringify(pass.session.environment)]))) failures.push(finding("capture_session_mismatch", file, `${pass.id} run or environment differs from its capture session`));
-    if (scenario && !(scenario.required_channels ?? []).includes(pass.channel)) failures.push(finding("evidence_channel_mismatch", file, `${pass.id} channel is not required for its scenario`));
-    if (source && (!sameSet(pass.scope?.state_set, source.states) || pass.scope?.semantic_mode !== source.semantic_mode)) failures.push(finding("evidence_scope_mismatch", file, `${pass.id} scope differs from canonical state JSON`));
-    const expectedMedia = pass.channel === "visual" ? "image/png" : ["dom", "ax"].includes(pass.channel) ? "application/json" : undefined;
-    if (expectedMedia && pass.artifact?.media_type !== expectedMedia) failures.push(finding("evidence_media_type_mismatch", file, `${pass.id} media type does not match its channel`));
-  }
-  for (const scenario of fixture.scenarios ?? []) {
-    const channels = new Set(passes.filter((pass) => pass.scenario_id === scenario.id).map((pass) => pass.channel));
-    for (const channel of scenario.required_channels ?? []) if (!channels.has(channel)) failures.push(finding("required_channel_missing", file, `${scenario.id} lacks ${channel} evidence`));
-  }
-}

package/scripts/component-state-workflow-contract.mjs

@@ -1,67 +0,0 @@
-const artifactHarness = "node scripts/test-validate-component-state-artifacts.mjs";
-const pinnedContainer = "mcr.microsoft.com/playwright:v1.61.0-noble@sha256:57b65fdc9ceabe0ef613124c7bbe2babcf9362c4d85e382fe3b03604e84b428a";
-const sharedRoot = "$STATE_EVIDENCE_ROOT";
-
-function jobSection(workflow, jobName) {
-  const marker = `  ${jobName}:\n`;
-  const start = workflow.indexOf(marker);
-  if (start === -1) return "";
-  const remainder = workflow.slice(start + marker.length);
-  const nextJob = remainder.search(/^  [a-z0-9][a-z0-9-]*:\s*$/m);
-  return nextJob === -1 ? remainder : remainder.slice(0, nextJob);
-}
-
-function normalized(line) {
-  return line.trim().replace(/\s*\\$/, "");
-}
-
-function commandCount(section, command) {
-  return section.split("\n").filter((line) => normalized(line).replace(/^(?:-\s+)?run:\s+/, "") === command).length;
-}
-
-function invocation(section, command) {
-  const lines = section.split("\n");
-  const starts = lines.flatMap((line, index) => normalized(line) === command ? [index] : []);
-  if (starts.length !== 1) return [];
-  const start = starts[0];
-  const indentation = lines[start].search(/\S/);
-  const block = [command];
-  for (let index = start + 1; index < lines.length; index += 1) {
-    if (lines[index].trim() && lines[index].search(/\S/) <= indentation) break;
-    if (lines[index].trim()) block.push(normalized(lines[index]));
-  }
-  return block;
-}
-
-function hasAdjacentLines(section, first, second) {
-  const lines = section.split("\n");
-  return lines.some((line, index) => line === first && lines[index + 1] === second);
-}
-
-export function componentStateWorkflowFailures(workflow) {
-  const failures = [];
-  const validateJob = jobSection(workflow, "validate");
-  const componentJob = jobSection(workflow, "component-state-evidence");
-  const totalHarnesses = commandCount(workflow, artifactHarness);
-  const componentHarnesses = commandCount(componentJob, artifactHarness);
-  if (commandCount(validateJob, artifactHarness) > 0) failures.push("browser-dependent artifact/session harness must not run in validate job");
-  if (componentHarnesses === 0) failures.push("component-state artifact/session harness must run in Playwright container job");
-  if (totalHarnesses !== 1 || componentHarnesses !== 1) failures.push("artifact/session harness must run exactly once and only in component-state-evidence job");
-  if (!hasAdjacentLines(componentJob, "    container:", `      image: ${pinnedContainer}`)) failures.push("component-state container.image must equal pinned Playwright digest");
-  if (/runner\.temp|RUNNER_TEMP/.test(componentJob)) failures.push("component-state Playwright container job must not use runner temp paths");
-  if (!hasAdjacentLines(componentJob, "    env:", "      STATE_EVIDENCE_ROOT: .tmp/consumer-reference-state")) failures.push("missing shared component-state workspace path STATE_EVIDENCE_ROOT: .tmp/consumer-reference-state");
-  if (!componentJob.includes(`    env:\n      STATE_EVIDENCE_ROOT: .tmp/consumer-reference-state\n      SENTINEL_CONTAINER_IMAGE: ${pinnedContainer}`)) failures.push("component-state job must export the pinned Playwright image identity");
-
-  const runtime = invocation(componentJob, `STATE_ARTIFACT_DIR="${sharedRoot}/runtime"`);
-  if (!runtime.includes(`STATE_SESSION_RECEIPT="${sharedRoot}/capture-session.json"`)) failures.push("component-state runtime must bind receipt under shared root");
-  const finalizer = invocation(componentJob, "node scripts/finalize-component-state-evidence.mjs");
-  if (!finalizer.includes(`--artifact-root "${sharedRoot}"`)) failures.push("component-state finalizer must use shared artifact root");
-  if (!finalizer.includes(`--output "${sharedRoot}/runtime-manifest.json"`)) failures.push("component-state finalizer must write manifest under shared root");
-  const validator = invocation(componentJob, "node scripts/validate-component-state.mjs");
-  if (!validator.includes(`--artifact-root "${sharedRoot}"`)) failures.push("component-state validator must use shared artifact root");
-  if (!validator.includes(`--runtime-manifest "${sharedRoot}/runtime-manifest.json"`)) failures.push("component-state validator must read manifest under shared root");
-  const creator = invocation(componentJob, "node scripts/create-component-state-session.mjs");
-  if (!creator.includes(`--output "${sharedRoot}/capture-session.json"`)) failures.push("missing shared component-state workspace path --output \"$STATE_EVIDENCE_ROOT/capture-session.json\"");
-  if (!componentJob.split("\n").includes("          path: ${{ env.STATE_EVIDENCE_ROOT }}/")) failures.push("missing shared component-state workspace path path: ${{ env.STATE_EVIDENCE_ROOT }}/");
-  return failures;
-}

package/scripts/component-state-workflow-negative-cases.mjs

@@ -1,64 +0,0 @@
-export function componentStateWorkflowCases(workflow) {
-  return [
-    {
-      name: "browser_artifact_harness_in_static_job",
-      mutate: { ".github/workflows/validate.yml": workflow.replace("  validate:\n", "  validate:\nnode scripts/test-validate-component-state-artifacts.mjs\n") },
-      expect: ".github/workflows/validate.yml: browser-dependent artifact/session harness must not run in validate job",
-    },
-    {
-      name: "browser_artifact_harness_missing_container_job",
-      mutate: { ".github/workflows/validate.yml": workflow.replace("        run: node scripts/test-validate-component-state-artifacts.mjs\n", "") },
-      expect: ".github/workflows/validate.yml: component-state artifact/session harness must run in Playwright container job",
-    },
-    {
-      name: "duplicate_artifact_harness_in_chromium_sentinel",
-      mutate: { ".github/workflows/validate.yml": workflow.replace("      - run: node scripts/test-consumer-reference-sentinel.mjs\n", "      - run: node scripts/test-consumer-reference-sentinel.mjs\n      - run: node scripts/test-validate-component-state-artifacts.mjs\n") },
-      expect: ".github/workflows/validate.yml: artifact/session harness must run exactly once and only in component-state-evidence job",
-    },
-    {
-      name: "unpinned_component_container_with_pinned_env",
-      mutate: { ".github/workflows/validate.yml": workflow.replace("      image: mcr.microsoft.com/playwright:v1.61.0-noble@sha256:57b65fdc9ceabe0ef613124c7bbe2babcf9362c4d85e382fe3b03604e84b428a", "      image: mcr.microsoft.com/playwright:v1.61.0-noble") },
-      expect: ".github/workflows/validate.yml: component-state container.image must equal pinned Playwright digest",
-    },
-    {
-      name: "session_receipt_outside_shared_root",
-      mutate: { ".github/workflows/validate.yml": workflow.replace("            STATE_SESSION_RECEIPT=\"$STATE_EVIDENCE_ROOT/capture-session.json\" \\\n", "            STATE_SESSION_RECEIPT=\"/tmp/capture-session.json\" \\\n") },
-      expect: ".github/workflows/validate.yml: component-state runtime must bind receipt under shared root",
-    },
-    {
-      name: "finalizer_output_outside_shared_root",
-      mutate: { ".github/workflows/validate.yml": workflow.replace("            --output \"$STATE_EVIDENCE_ROOT/runtime-manifest.json\" \\\n", "            --output \"/tmp/runtime-manifest.json\" \\\n") },
-      expect: ".github/workflows/validate.yml: component-state finalizer must write manifest under shared root",
-    },
-    {
-      name: "validator_manifest_outside_shared_root",
-      mutate: { ".github/workflows/validate.yml": workflow.replace("            --runtime-manifest \"$STATE_EVIDENCE_ROOT/runtime-manifest.json\" \\\n", "            --runtime-manifest \"/tmp/runtime-manifest.json\" \\\n") },
-      expect: ".github/workflows/validate.yml: component-state validator must read manifest under shared root",
-    },
-    {
-      name: "finalizer_artifact_root_outside_shared_root",
-      mutate: { ".github/workflows/validate.yml": workflow.replace("          node scripts/finalize-component-state-evidence.mjs \\\n            --artifact-root \"$STATE_EVIDENCE_ROOT\" \\\n", "          node scripts/finalize-component-state-evidence.mjs \\\n            --artifact-root \"/tmp/consumer-reference-state\" \\\n") },
-      expect: ".github/workflows/validate.yml: component-state finalizer must use shared artifact root",
-    },
-    {
-      name: "validator_artifact_root_outside_shared_root",
-      mutate: { ".github/workflows/validate.yml": workflow.replace("          node scripts/validate-component-state.mjs \\\n            --artifact-root \"$STATE_EVIDENCE_ROOT\" \\\n", "          node scripts/validate-component-state.mjs \\\n            --artifact-root \"/tmp/consumer-reference-state\" \\\n") },
-      expect: ".github/workflows/validate.yml: component-state validator must use shared artifact root",
-    },
-    {
-      name: "runner_temp_in_component_job",
-      mutate: { ".github/workflows/validate.yml": workflow.replace("STATE_EVIDENCE_ROOT: .tmp/consumer-reference-state", "STATE_EVIDENCE_ROOT: ${{ runner.temp }}/consumer-reference-state") },
-      expect: ".github/workflows/validate.yml: component-state Playwright container job must not use runner temp paths",
-    },
-    {
-      name: "component_state_workspace_root_drift",
-      mutate: { ".github/workflows/validate.yml": workflow.replaceAll(".tmp/consumer-reference-state", "state-output") },
-      expect: ".github/workflows/validate.yml: missing shared component-state workspace path STATE_EVIDENCE_ROOT: .tmp/consumer-reference-state",
-    },
-    {
-      name: "missing_component_state_image_identity",
-      mutate: { ".github/workflows/validate.yml": workflow.replace("      SENTINEL_CONTAINER_IMAGE: mcr.microsoft.com/playwright:v1.61.0-noble@sha256:57b65fdc9ceabe0ef613124c7bbe2babcf9362c4d85e382fe3b03604e84b428a\n", "") },
-      expect: ".github/workflows/validate.yml: component-state job must export the pinned Playwright image identity",
-    },
-  ];
-}

package/scripts/consumer-conformance-contract.mjs

@@ -1,198 +0,0 @@
-import { isPlainObject } from "./consumer-reference-schema.mjs";
-
-export const MIGRATION_DIMENSIONS = Object.freeze([
-  "behavior_inventory",
-  "route_parity",
-  "field_parity",
-  "action_parity",
-  "state_transitions",
-  "contract_precedence",
-  "direct_mutation",
-  "indirect_mutation",
-  "persistence_round_trip",
-  "reset_boundary",
-  "exact_time_boundary",
-  "defaults_tri_state_mapping",
-  "atomic_batch_behavior",
-]);
-
-export const RUNTIME_EVIDENCE_METHODS = Object.freeze(["unit", "integration", "browser"]);
-
-const sentencePattern = /^\S+(?:\s+\S+){2,}\s*[.!?]$/;
-const revisionPattern = /^[a-f0-9]{40}$/;
-const componentPattern = /^[A-Z][A-Za-z0-9]*(?:[._/-][A-Za-z0-9_-]+)*$/;
-const selectorPattern = /^(?:[.#][A-Za-z_][A-Za-z0-9_-]*|\[[A-Za-z_:][-A-Za-z0-9_:.]*(?:=[^\]\r\n]+)?\])$/;
-
-function finding(code, message, recordPath) {
-  return { code, message, path: recordPath };
-}
-
-function uniqueFindings(findings) {
-  return [...new Map(findings.map((entry) => [`${entry.code}:${entry.path}:${entry.message}`, entry])).values()];
-}
-
-function sameStringSet(left, right) {
-  return Array.isArray(left)
-    && Array.isArray(right)
-    && left.length === right.length
-    && new Set(left).size === left.length
-    && left.every((entry) => right.includes(entry));
-}
-
-export function isNormalizedRepositoryPath(value, { jsonOnly = false } = {}) {
-  if (typeof value !== "string" || value.length === 0 || value.startsWith("/") || value.endsWith("/") || value.includes("\\") || value.includes("//") || value.includes("?") || value.includes("#")) return false;
-  if (/^[A-Za-z][A-Za-z0-9+.-]*:/.test(value)) return false;
-  if (value.split("/").some((segment) => segment === "." || segment === ".." || segment.length === 0)) return false;
-  return !jsonOnly || value.endsWith(".json");
-}
-
-function isSentence(value) {
-  return typeof value === "string" && value.length >= 10 && sentencePattern.test(value);
-}
-
-function isConsumerTarget(target) {
-  if (!isPlainObject(target) || typeof target.identity !== "string") return false;
-  if (target.kind === "component") return componentPattern.test(target.identity);
-  if (target.kind === "selector") return selectorPattern.test(target.identity);
-  if (target.kind === "module") return isNormalizedRepositoryPath(target.identity);
-  return false;
-}
-
-function schemaCode(error) {
-  const pointer = error.instancePath ?? "";
-  const missing = error.params?.missingProperty;
-  if (pointer === "/migration_dimensions" && MIGRATION_DIMENSIONS.includes(missing)) return "migration_dimension_required";
-  if (/^\/migration_dimensions\/[^/]+\/scenario_ids$/.test(pointer) && error.keyword === "minItems") return "migration_dimension_scenario_required";
-  if (/^\/scenarios\/\d+\/evidence_method$/.test(pointer)) return "runtime_evidence_method_invalid";
-  if (/^\/adoption_mappings\/\d+\/consumer_target/.test(pointer)) return "adoption_consumer_target_invalid";
-  if (/^\/adoption_mappings\/\d+\/stylegallery\/revision$/.test(pointer)) return "adoption_stylegallery_revision_unpinned";
-  if (/^\/adoption_mappings\/\d+\/debt\/\d+/.test(pointer)) return "adoption_debt_incomplete";
-  return "consumer_conformance_schema_invalid";
-}
-
-export function consumerConformanceSchemaFindings(errors, recordPath) {
-  return uniqueFindings((errors ?? []).map((error) => finding(
-    schemaCode(error),
-    `${error.instancePath || "/"} ${error.message ?? "does not satisfy the schema"}`,
-    recordPath,
-  )));
-}
-
-export function validateConsumerConformanceSemantics(value, recordPath) {
-  const findings = [];
-  const add = (code, message) => findings.push(finding(code, message, recordPath));
-  if (!isPlainObject(value)) {
-    add("consumer_conformance_record_invalid", "consumer conformance record must be a JSON object");
-    return findings;
-  }
-
-  const scenarios = Array.isArray(value.scenarios) ? value.scenarios.filter(isPlainObject) : [];
-  const scenarioIds = scenarios.map((scenario) => scenario.id).filter((id) => typeof id === "string");
-  const scenarioSet = new Set(scenarioIds);
-  if (scenarioIds.length !== scenarioSet.size) add("runtime_scenario_id_duplicate", "runtime scenario IDs must be unique");
-  for (const scenario of scenarios) {
-    if (!RUNTIME_EVIDENCE_METHODS.includes(scenario.evidence_method)) add("runtime_evidence_method_invalid", "runtime evidence must use unit, integration, or browser execution");
-    if (["unit", "integration"].includes(scenario.evidence_method) && scenario.argv?.[0] !== "node") add("runtime_command_executable_invalid", "unit and integration evidence must use the governed Node runtime");
-    if (scenario.exit_code !== 0) add("runtime_evidence_exit_nonzero", `scenario ${scenario.id ?? "<unknown>"} must record exit code zero`);
-    if (!isNormalizedRepositoryPath(scenario.result_artifact, { jsonOnly: true })) add("runtime_result_artifact_invalid", `scenario ${scenario.id ?? "<unknown>"} requires a normalized JSON result artifact`);
-  }
-
-  const dimensions = isPlainObject(value.migration_dimensions) ? value.migration_dimensions : {};
-  for (const dimensionName of MIGRATION_DIMENSIONS) {
-    if (!Object.hasOwn(dimensions, dimensionName)) {
-      add("migration_dimension_required", `migration dimension ${dimensionName} must be explicitly classified`);
-      continue;
-    }
-    const dimension = dimensions[dimensionName];
-    if (!isPlainObject(dimension)) continue;
-    if (dimension.status === "applicable") {
-      if (!Array.isArray(dimension.scenario_ids) || dimension.scenario_ids.length === 0) {
-        add("migration_dimension_scenario_required", `applicable migration dimension ${dimensionName} requires a runtime scenario`);
-      } else {
-        for (const scenarioId of dimension.scenario_ids) {
-          if (!scenarioSet.has(scenarioId)) add("migration_dimension_scenario_unknown", `migration dimension ${dimensionName} references unknown scenario ${scenarioId}`);
-        }
-      }
-    } else if (dimension.status === "not_applicable" && !isSentence(dimension.reason)) {
-      add("migration_dimension_reason_invalid", `not-applicable migration dimension ${dimensionName} requires a sentence reason`);
-    }
-  }
-
-  const mappings = Array.isArray(value.adoption_mappings) ? value.adoption_mappings.filter(isPlainObject) : [];
-  for (const [index, mapping] of mappings.entries()) {
-    if (!isConsumerTarget(mapping.consumer_target)) add("adoption_consumer_target_invalid", `adoption mapping ${index} requires a normalized local component, selector, or module identity`);
-    if (!revisionPattern.test(mapping.stylegallery?.revision ?? "")) add("adoption_stylegallery_revision_unpinned", `adoption mapping ${index} requires a full StyleGallery revision`);
-    for (const scenarioId of Array.isArray(mapping.scenario_ids) ? mapping.scenario_ids : []) {
-      if (!scenarioSet.has(scenarioId)) add("adoption_scenario_unknown", `adoption mapping ${index} references unknown scenario ${scenarioId}`);
-    }
-    for (const debt of Array.isArray(mapping.debt) ? mapping.debt : []) {
-      if (!isPlainObject(debt) || typeof debt.owner !== "string" || debt.owner.length === 0 || !isSentence(debt.review_trigger) || typeof debt.review_by !== "string") {
-        add("adoption_debt_incomplete", `adoption mapping ${index} debt requires owner, review trigger, and review-by date`);
-      }
-    }
-  }
-
-  if (value.page_evidence?.status === "applicable" && !isNormalizedRepositoryPath(value.page_evidence.manifest, { jsonOnly: true })) {
-    add("page_evidence_manifest_path_invalid", "applicable page evidence requires a normalized JSON manifest path");
-  }
-  return uniqueFindings(findings);
-}
-
-export function validateConsumerPageIntentSemantics(value, recordPath) {
-  if (!isPlainObject(value) || value.page_evidence?.status !== "applicable") return [];
-  const findings = [];
-  const add = (code, message) => findings.push(finding(code, message, recordPath));
-  const scenarios = Array.isArray(value.scenarios) ? value.scenarios.filter(isPlainObject) : [];
-  const browserIds = scenarios.filter((scenario) => scenario.evidence_method === "browser").map((scenario) => scenario.id);
-  if (browserIds.length === 0) {
-    add("page_evidence_runtime_scenario_required", "applicable page evidence requires at least one browser runtime scenario");
-    return findings;
-  }
-  const mappingIds = new Set((Array.isArray(value.adoption_mappings) ? value.adoption_mappings : [])
-    .flatMap((mapping) => Array.isArray(mapping?.scenario_ids) ? mapping.scenario_ids : []));
-  for (const scenarioId of browserIds) {
-    if (!mappingIds.has(scenarioId)) add("page_evidence_adoption_mapping_missing", `browser scenario ${scenarioId} requires an adoption mapping`);
-  }
-  return uniqueFindings(findings);
-}
-
-export function validateConsumerPageEvidenceSemantics(value, manifest, recordPath) {
-  if (!isPlainObject(value) || !isPlainObject(manifest) || value.page_evidence?.status !== "applicable") return [];
-  const findings = [];
-  const add = (code, message) => findings.push(finding(code, message, recordPath));
-  const scenarios = Array.isArray(value.scenarios) ? value.scenarios.filter(isPlainObject) : [];
-  const scenarioById = new Map(scenarios.map((scenario) => [scenario.id, scenario]));
-  const browserScenarios = scenarios.filter((scenario) => scenario.evidence_method === "browser");
-  const browserIds = browserScenarios.map((scenario) => scenario.id);
-  const intendedIds = manifest.session?.intended_scenario_ids;
-  if (!sameStringSet(browserIds, intendedIds)) add("page_evidence_intent_scenario_mismatch", "page session intent must exactly match the conformance browser scenario catalog");
-
-  const sourcePaths = manifest.session?.source?.files?.map((entry) => entry.path);
-  if (!sameStringSet(value.consumer?.relevant_sources, sourcePaths)) add("page_evidence_source_set_mismatch", "conformance relevant sources must exactly match the page session source set");
-  if (value.consumer?.repository !== manifest.repository || value.consumer?.repository !== manifest.session?.repository || value.consumer?.repository !== manifest.run?.repository) {
-    add("page_evidence_repository_mismatch", "conformance, page session, manifest, and run repositories must agree");
-  }
-  if (value.consumer?.revision !== manifest.revision || value.consumer?.revision !== manifest.session?.revision || value.consumer?.revision !== manifest.run?.revision) {
-    add("page_evidence_revision_mismatch", "conformance, page session, manifest, and run revisions must agree");
-  }
-  if (typeof manifest.review_by !== "string" || manifest.review_by.length === 0) add("page_evidence_review_by_required", "page evidence manifest requires review_by");
-
-  const pageScenarioById = new Map((Array.isArray(manifest.scenarios) ? manifest.scenarios : []).map((scenario) => [scenario.id, scenario]));
-  const manifestDirectory = value.page_evidence.manifest.split("/").slice(0, -1).join("/");
-  for (const scenario of browserScenarios) {
-    if (scenario.source_digest !== manifest.session?.source?.sha256) add("page_evidence_source_mismatch", `browser scenario ${scenario.id} source digest must equal the page session source digest`);
-    if (scenario.session_id !== manifest.session?.session_id) add("page_evidence_session_mismatch", `browser scenario ${scenario.id} session identity must equal the page session`);
-    if (scenario.run_id !== manifest.run?.id) add("page_evidence_run_mismatch", `browser scenario ${scenario.id} run identity must equal the page run`);
-    const runnerPath = pageScenarioById.get(scenario.id)?.runner_result?.path;
-    if (scenario.result_artifact !== (runnerPath ? `${manifestDirectory}/${runnerPath}` : undefined)) add("page_evidence_result_artifact_mismatch", `browser scenario ${scenario.id} result artifact must equal its page runner result`);
-  }
-
-  const dimensions = isPlainObject(value.migration_dimensions) ? Object.values(value.migration_dimensions) : [];
-  for (const scenarioId of dimensions.flatMap((dimension) => dimension?.status === "applicable" && Array.isArray(dimension.scenario_ids) ? dimension.scenario_ids : [])) {
-    if (scenarioById.get(scenarioId)?.evidence_method === "browser" && !intendedIds?.includes(scenarioId)) add("page_evidence_dimension_scenario_missing", `browser scenario ${scenarioId} used by an applicable dimension is absent from page intent`);
-  }
-  for (const scenarioId of (Array.isArray(value.adoption_mappings) ? value.adoption_mappings : []).flatMap((mapping) => Array.isArray(mapping?.scenario_ids) ? mapping.scenario_ids : [])) {
-    if (scenarioById.get(scenarioId)?.evidence_method === "browser" && !intendedIds?.includes(scenarioId)) add("page_evidence_adoption_scenario_missing", `browser scenario ${scenarioId} used by an adoption mapping is absent from page intent`);
-  }
-  return uniqueFindings(findings);
-}