@tryvitris/website-harness 0.0.0-stage → 0.1.0-beta.5

package/design-system/knowledge/v2/fixtures/contact-broken.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+<body>
+<form>
+  <input name="email" placeholder="Email" required>
+  <button>Send</button>
+</form>
+<script>
+document.addEventListener("keydown", (event) => {
+  if (event.key === "Tab") event.preventDefault();
+});
+</script>
+<style>.bar { position: sticky; top: 0; height: 48px; }</style>
+</body>
+</html>

package/design-system/knowledge/v2/fixtures/contact-valid.html

@@ -0,0 +1,20 @@
+<!doctype html>
+<html lang="en">
+<head>
+<style>
+  html { scroll-padding-top: 72px; }
+  .bar { position: sticky; top: 0; }
+</style>
+</head>
+<body>
+<main>
+  <h1>Request a slate estimate</h1>
+  <form>
+    <label for="email">Email</label>
+    <input id="email" name="email" type="email" required aria-describedby="email-error">
+    <p id="email-error" role="alert">Enter an email so the estimator can reply.</p>
+    <button type="submit">Request the estimate</button>
+  </form>
+</main>
+</body>
+</html>

package/design-system/knowledge/v2/fixtures/contrast-cases.html

@@ -0,0 +1,10 @@
+<!doctype html>
+<html lang="en">
+<body>
+<p style="color:#8d8d8d;background:#ffffff;font-size:16px">Hard to read</p>
+<p style="color:#595959;background:#ffffff;font-size:24px">Large enough</p>
+<p style="color:#777777;background:#ffffff" data-wcag-exception="incidental">Decoration</p>
+<button disabled style="color:#777777;background:#ffffff">Unavailable</button>
+<img src="roof.png" alt="">
+</body>
+</html>

package/design-system/knowledge/v2/island-audit.json

@@ -0,0 +1,12 @@
+{
+  "reviewed": "2026-09-22",
+  "method": "Source reading of kernel island scripts. Not a browser certification.",
+  "islands": [
+    {"id": "header", "keyboard": "Escape closes the drawer and focus moves into the panel. Tab is not captured, so this is not a keyboard trap. Focus is not restored to the toggle.", "launchBlocker": false, "gap": "Focus restoration is unimplemented. Manual check still pending."},
+    {"id": "tabs", "keyboard": "Arrow keys move and select tabs. Home and End are not implemented.", "launchBlocker": false, "gap": "Partial APG keyboard pattern."},
+    {"id": "lightbox", "keyboard": "Uses the native dialog element, which supplies a focus trap and Escape. A close control is wired.", "launchBlocker": false, "gap": "Manual screen-reader naming of the image swap is pending."},
+    {"id": "carousel", "keyboard": "Previous and next buttons and arrow keys. No autoplay in the island script. Button names depend on the site markup.", "launchBlocker": false, "gap": "Unnamed buttons would fail the form/name check in page markup, not in this script."},
+    {"id": "before-after", "keyboard": "Arrow keys change the slider. Pointer drag is also present.", "launchBlocker": false, "gap": "The control needs an accessible name in markup."},
+    {"id": "counter", "keyboard": "No keyboard interaction. Decorative count.", "launchBlocker": false, "gap": "If the number is the only expression of a fact, the text must also be present."}
+  ]
+}

package/design-system/knowledge/v2/lesson-extensions.json

@@ -0,0 +1,158 @@
+[
+  {
+    "id": "project-photography-transformations",
+    "version": 1,
+    "evidenceClass": "original-synthetic",
+    "uncertainty": "The demonstration is a generated teaching image, not a customer job and not a human preference score.",
+    "requirementIds": ["wcag-1.1.1-text-alternative", "teaching-creative-freedom"],
+    "alternatives": [
+      { "id": "dominant-plate", "summary": "One large finished-job photograph with a caption and the estimate action underneath." },
+      { "id": "indexed-jobs", "summary": "A short index of unequal jobs, with the strongest inspected job first and the others quieter." }
+    ],
+    "inspection": "project-strong.html shows the generated slope image, caption, and action. It is a teaching layout, not a full business site."
+  },
+  {
+    "id": "sparse-imagery-process",
+    "version": 1,
+    "evidenceClass": "original-synthetic",
+    "uncertainty": "A process sequence is only as specific as the harvested steps.",
+    "requirementIds": ["teaching-creative-freedom"],
+    "alternatives": [
+      { "id": "numbered-steps", "summary": "A numbered diagnostic column and one action." },
+      { "id": "question-led", "summary": "The visitor's first question as the heading, with the method in prose and no photo placeholder." }
+    ],
+    "inspection": "sparse-strong.html is synthetic. It does not prove a firm."
+  },
+  {
+    "id": "founder-team-credibility",
+    "version": 1,
+    "evidenceClass": "inspected-reference",
+    "uncertainty": "The inspected portrait reference is not this client's staff and is not a preference label.",
+    "requirementIds": ["wcag-1.1.1-text-alternative"],
+    "alternatives": [
+      { "id": "person-beside-scope", "summary": "One named person beside the work they actually do." },
+      { "id": "credentials-without-portrait", "summary": "Text credentials when no inspected portrait exists." }
+    ],
+    "inspection": "Do not import the reference face into a customer site."
+  },
+  {
+    "id": "unequal-services",
+    "version": 1,
+    "evidenceClass": "original-synthetic",
+    "uncertainty": "Priority comes from visitor questions, not from an alphabetical list.",
+    "requirementIds": ["teaching-creative-freedom"],
+    "alternatives": [
+      { "id": "primary-band", "summary": "The main service in a large band and the others in a quieter index." },
+      { "id": "primary-prose", "summary": "The main service as prose, with secondary services as a definition list." }
+    ],
+    "inspection": "Equal cards are the failure case, not a required pattern to avoid by adding decoration."
+  },
+  {
+    "id": "dense-practical-information",
+    "version": 1,
+    "evidenceClass": "original-synthetic",
+    "uncertainty": "Unverified hours and prices stay unpublished.",
+    "requirementIds": ["seo-structured-data-consistency"],
+    "alternatives": [
+      { "id": "definition-list", "summary": "A label and value list." },
+      { "id": "short-table", "summary": "A table when several comparable facts share columns." }
+    ],
+    "inspection": "The fact must be extractable without reading a slogan."
+  },
+  {
+    "id": "tangible-materials",
+    "version": 1,
+    "evidenceClass": "original-synthetic",
+    "uncertainty": "Material claims need harvested evidence.",
+    "requirementIds": ["wcag-1.1.1-text-alternative"],
+    "alternatives": [
+      { "id": "material-detail", "summary": "A close view of the material the visitor is hiring." },
+      { "id": "material-prose", "summary": "A written specification when no usable material photo exists." }
+    ],
+    "inspection": "Do not substitute a generated texture for proof."
+  },
+  {
+    "id": "location-hours-access",
+    "version": 1,
+    "evidenceClass": "original-synthetic",
+    "uncertainty": "Service geography is published only when the facts include it.",
+    "requirementIds": ["seo-structured-data-consistency"],
+    "alternatives": [
+      { "id": "visit-facts", "summary": "Address, hours, and access as a practical block." },
+      { "id": "service-area", "summary": "A service area in prose when there is no public storefront." }
+    ],
+    "inspection": "Do not invent a map pin."
+  },
+  {
+    "id": "comparison-decision-support",
+    "version": 1,
+    "evidenceClass": "original-synthetic",
+    "uncertainty": "Comparisons that need prices stay incomplete when prices were not harvested.",
+    "requirementIds": ["teaching-creative-freedom"],
+    "alternatives": [
+      { "id": "choice-table", "summary": "A table of real differences." },
+      { "id": "guided-question", "summary": "One question that routes the visitor to the fitting service." }
+    ],
+    "inspection": "Do not fabricate prices to fill a column."
+  },
+  {
+    "id": "longform-case-study",
+    "version": 1,
+    "evidenceClass": "original-synthetic",
+    "uncertainty": "Outcomes that were not verified stay omitted.",
+    "requirementIds": ["geo-visible-answers"],
+    "alternatives": [
+      { "id": "narrative-case", "summary": "A sequential account of the job, the constraint, and the evidenced result." },
+      { "id": "annotated-case", "summary": "The same facts as annotations beside the work, without a second hero." }
+    ],
+    "inspection": "Missing data is stated, not smoothed over."
+  },
+  {
+    "id": "typography-led-hierarchy",
+    "version": 1,
+    "evidenceClass": "original-synthetic",
+    "uncertainty": "Hierarchy is a relationship, not a font family.",
+    "requirementIds": ["wcag-1.4.3-contrast", "teaching-creative-freedom"],
+    "alternatives": [
+      { "id": "serif-editorial", "summary": "A quiet serif page with one display line and a practical action." },
+      { "id": "sans-brief", "summary": "A compact sans page with the same offer, proof, and action order." }
+    ],
+    "inspection": "Either expression can be right. Neither is a quota."
+  },
+  {
+    "id": "mobile-complex-composition",
+    "version": 1,
+    "evidenceClass": "original-synthetic",
+    "uncertainty": "Mobile order follows the visitor task, not a universal card stack.",
+    "requirementIds": ["wcag-2.4.11-focus-not-obscured"],
+    "alternatives": [
+      { "id": "stack-proof", "summary": "Offer, then proof, then action, full width." },
+      { "id": "stack-process", "summary": "The diagnostic steps remain in order, with the action after the step that justifies it." }
+    ],
+    "inspection": "Do not put the action above an unlabeled image."
+  },
+  {
+    "id": "purposeful-repetition",
+    "version": 1,
+    "evidenceClass": "original-synthetic",
+    "uncertainty": "Repetition is acceptable when each instance answers the same kind of question.",
+    "requirementIds": ["teaching-creative-freedom"],
+    "alternatives": [
+      { "id": "shared-project-row", "summary": "Project entries share a caption system because each is a job." },
+      { "id": "shared-service-list", "summary": "Secondary services share a list style because they are peers of each other, not of the primary offer." }
+    ],
+    "inspection": "Identical cards for unrelated jobs are the failure, not repetition itself."
+  },
+  {
+    "id": "contact-journey",
+    "version": 1,
+    "evidenceClass": "original-synthetic",
+    "uncertainty": "A form is not mandatory. Phone or email can be the right next step.",
+    "requirementIds": ["wcag-3.3.2-labels", "wcag-3.3.1-error-identification", "wcag-2.1.1-keyboard", "nng-plain-language-and-recovery"],
+    "alternatives": [
+      { "id": "labeled-form", "summary": "A short labeled form after the facts that justify the request, with errors associated to the fields." },
+      { "id": "direct-contact", "summary": "A visible phone or email as the primary action, with a form only if it reduces effort." }
+    ],
+    "inspection": "fixtures/contact-valid.html and fixtures/contact-alternate.html are both acceptable. fixtures/contact-broken.html is the failure."
+  }
+]

package/design-system/knowledge/v2/manifest.json

@@ -0,0 +1,52 @@
+{
+  "schemaVersion": 1,
+  "knowledgeRelease": "2026-09-22",
+  "labeledPreferenceData": false,
+  "purpose": "Sourced requirements, lesson extensions, and fixtures. Not a labeled preference dataset.",
+  "files": [
+    {
+      "path": "added-lessons.json",
+      "sha256": "bc6d255d318ccdfba379a71c34d82d158e760968fd30693b82d1290194ad601b"
+    },
+    {
+      "path": "assets.json",
+      "sha256": "c11e32084fc4e7de9e7a3d5b79173d45e4a6204571e6e3d149f2011778e265fa"
+    },
+    {
+      "path": "fixtures/contact-alternate.html",
+      "sha256": "f764429b51dad657812f15c8897f632985c024e6dc1932a867991b8839f0e072"
+    },
+    {
+      "path": "fixtures/contact-broken.html",
+      "sha256": "b166eb56919fdecd7e7446acb90ebae469eb8a91e6fab97b7d202fb6be2c642a"
+    },
+    {
+      "path": "fixtures/contact-valid.html",
+      "sha256": "ada3770df3a1d06693ca64b1c1012dd1b41868f53d849d241ce3ea9332627057"
+    },
+    {
+      "path": "fixtures/contrast-cases.html",
+      "sha256": "61b31b38e7bcff71a778701c82646459ad93ca308772ff5c711a018379b4d513"
+    },
+    {
+      "path": "island-audit.json",
+      "sha256": "ed8bd18fb3ba97817be4f6273b4291c265c6ee6dadeb752da47e69834df6204f"
+    },
+    {
+      "path": "lesson-extensions.json",
+      "sha256": "fac784c9020a9889d3edac37d0ea83dcf4a8227076880a754e4e520347faf63e"
+    },
+    {
+      "path": "replacements.json",
+      "sha256": "d913b3a7dc5a9f1f69ba1a6edf73481c94966d6ef02a5bf74c61dd3e005ef425"
+    },
+    {
+      "path": "requirements.json",
+      "sha256": "49185855abc209f200b167b076ed192b080034dcd4f34afb14099b787f1b9baf"
+    },
+    {
+      "path": "sources.json",
+      "sha256": "fcfc0e53430e3d1caaffc139dd4b0b4fec5a7be099132b40b8027f18463166b2"
+    }
+  ]
+}

package/design-system/knowledge/v2/replacements.json

@@ -0,0 +1,14 @@
+[
+  {"id":"project-photography-transformations","fromVersion":1,"toVersion":1,"note":"ID preserved. v2 adds evidence class and alternatives."},
+  {"id":"sparse-imagery-process","fromVersion":1,"toVersion":1,"note":"ID preserved."},
+  {"id":"founder-team-credibility","fromVersion":1,"toVersion":1,"note":"ID preserved."},
+  {"id":"unequal-services","fromVersion":1,"toVersion":1,"note":"ID preserved."},
+  {"id":"dense-practical-information","fromVersion":1,"toVersion":1,"note":"ID preserved."},
+  {"id":"tangible-materials","fromVersion":1,"toVersion":1,"note":"ID preserved."},
+  {"id":"location-hours-access","fromVersion":1,"toVersion":1,"note":"ID preserved."},
+  {"id":"comparison-decision-support","fromVersion":1,"toVersion":1,"note":"ID preserved."},
+  {"id":"longform-case-study","fromVersion":1,"toVersion":1,"note":"ID preserved."},
+  {"id":"typography-led-hierarchy","fromVersion":1,"toVersion":1,"note":"ID preserved."},
+  {"id":"mobile-complex-composition","fromVersion":1,"toVersion":1,"note":"ID preserved."},
+  {"id":"purposeful-repetition","fromVersion":1,"toVersion":1,"note":"ID preserved."}
+]

package/design-system/knowledge/v2/requirements.json

@@ -0,0 +1,345 @@
+[
+  {
+    "id": "wcag-1.1.1-text-alternative",
+    "version": 1,
+    "domains": ["accessibility"],
+    "title": "Text alternatives",
+    "instruction": "Give informative images a text alternative. Mark decorative images so assistive technology can ignore them.",
+    "rationale": "WCAG 2.2 success criterion 1.1.1, level A, with the decorative, control, and sensory exceptions in the quick reference.",
+    "authorityIds": ["src-wcag22-quickref"],
+    "authorityClass": "standard",
+    "applicability": "always",
+    "stages": ["representative", "pages", "browser"],
+    "verificationMethod": "DOM scan for missing alt, plus manual review of whether the text is equivalent.",
+    "verifierId": "text-alternative",
+    "severityPolicy": "blocker",
+    "exceptions": ["Decorative images with an empty alt", "CAPTCHA and sensory exceptions require a described purpose"],
+    "repairOwner": "pages",
+    "implementationStatus": "fixture-tested"
+  },
+  {
+    "id": "wcag-1.4.3-contrast",
+    "version": 1,
+    "domains": ["accessibility"],
+    "title": "Contrast minimum",
+    "instruction": "Body text needs at least 4.5:1. Large text needs at least 3:1. Do not collapse every contrast rule into one number.",
+    "rationale": "WCAG 2.2 success criterion 1.4.3, level AA.",
+    "authorityIds": ["src-wcag22-quickref"],
+    "authorityClass": "standard",
+    "applicability": "always",
+    "stages": ["direction", "representative", "pages"],
+    "verificationMethod": "Computed contrast for explicit color pairs.",
+    "verifierId": "contrast",
+    "severityPolicy": "blocker",
+    "exceptions": ["Large text at 3:1", "Incidental text", "Disabled controls", "Logotypes"],
+    "repairOwner": "pages",
+    "implementationStatus": "fixture-tested"
+  },
+  {
+    "id": "wcag-2.1.1-keyboard",
+    "version": 1,
+    "domains": ["accessibility"],
+    "title": "Keyboard operation",
+    "instruction": "The primary contact path must be operable by keyboard and must not trap focus.",
+    "rationale": "WCAG 2.2 success criterion 2.1.1, level A.",
+    "authorityIds": ["src-wcag22-quickref"],
+    "authorityClass": "standard",
+    "applicability": "contact-path",
+    "stages": ["representative", "pages", "browser"],
+    "verificationMethod": "Detect scripts that cancel Tab without an exit. Full keyboard testing remains manual where the verifier does not run a browser.",
+    "verifierId": "keyboard-trap",
+    "severityPolicy": "blocker",
+    "exceptions": ["A modal may hold Tab while it is open if Escape or an explicit close control releases it"],
+    "repairOwner": "pages",
+    "implementationStatus": "fixture-tested"
+  },
+  {
+    "id": "wcag-2.4.11-focus-not-obscured",
+    "version": 1,
+    "domains": ["accessibility"],
+    "title": "Focus not obscured",
+    "instruction": "Sticky or fixed interface must not cover the focused control. Reserve scroll padding for the sticky region.",
+    "rationale": "WCAG 2.2 success criterion 2.4.11, level AA.",
+    "authorityIds": ["src-wcag22-quickref"],
+    "authorityClass": "standard",
+    "applicability": "always",
+    "stages": ["representative", "pages"],
+    "verificationMethod": "Static check for sticky or fixed positioning without scroll-padding-top.",
+    "verifierId": "focus-offset",
+    "severityPolicy": "blocker",
+    "exceptions": ["Author-declared focus exception with scroll-padding-top"],
+    "repairOwner": "pages",
+    "implementationStatus": "fixture-tested"
+  },
+  {
+    "id": "wcag-3.3.2-labels",
+    "version": 1,
+    "domains": ["accessibility"],
+    "title": "Form labels",
+    "instruction": "Name every contact field in a way that states its purpose. Placeholder text is not the name.",
+    "rationale": "WCAG 2.2 success criterion 3.3.2, level A.",
+    "authorityIds": ["src-wcag22-quickref", "src-wai-aria-apg"],
+    "authorityClass": "standard",
+    "applicability": "contact-path",
+    "stages": ["copy", "representative", "pages"],
+    "verificationMethod": "Accessible name from label, aria-label, or aria-labelledby.",
+    "verifierId": "form-name",
+    "severityPolicy": "blocker",
+    "exceptions": ["Submit buttons with their own text"],
+    "repairOwner": "pages",
+    "implementationStatus": "fixture-tested"
+  },
+  {
+    "id": "wcag-3.3.1-error-identification",
+    "version": 1,
+    "domains": ["accessibility"],
+    "title": "Error identification",
+    "instruction": "When a required contact field can fail, identify the error in text associated with the field.",
+    "rationale": "WCAG 2.2 success criterion 3.3.1, level A, together with status feedback in 4.1.3.",
+    "authorityIds": ["src-wcag22-quickref"],
+    "authorityClass": "standard",
+    "applicability": "contact-path",
+    "stages": ["representative", "pages", "browser"],
+    "verificationMethod": "Required controls must point at an existing described-by or error element.",
+    "verifierId": "form-errors",
+    "severityPolicy": "blocker",
+    "exceptions": [],
+    "repairOwner": "pages",
+    "implementationStatus": "fixture-tested"
+  },
+  {
+    "id": "wcag-manual-screen-reader",
+    "version": 1,
+    "domains": ["accessibility"],
+    "title": "Screen reader evaluation",
+    "instruction": "Record that screen-reader behavior was not claimed from an accessibility-tree snapshot.",
+    "rationale": "W3C evaluation guidance says tools cannot by themselves determine conformance.",
+    "authorityIds": ["src-wai-evaluate"],
+    "authorityClass": "standard",
+    "applicability": "always",
+    "stages": ["browser", "preview"],
+    "verificationMethod": "Manual. Pending manual coverage is disclosed and is not itself a universal launch deadlock.",
+    "verifierId": null,
+    "severityPolicy": "manual-pending",
+    "exceptions": [],
+    "repairOwner": "browser",
+    "implementationStatus": "documented"
+  },
+  {
+    "id": "widget-carousel-keyboard",
+    "version": 1,
+    "domains": ["accessibility"],
+    "title": "Carousel keyboard behavior",
+    "instruction": "When a carousel is used, previous and next controls need names and keyboard operation. Do not autoplay.",
+    "rationale": "APG widget practice. Irrelevant when the page has no carousel.",
+    "authorityIds": ["src-wai-aria-apg"],
+    "authorityClass": "official-platform",
+    "applicability": "widget",
+    "stages": ["pages", "browser"],
+    "verificationMethod": "Load only when the carousel island is present. Kernel carousel uses buttons and arrow keys and does not autoplay.",
+    "verifierId": "island-audit",
+    "severityPolicy": "warning",
+    "exceptions": [],
+    "repairOwner": "pages",
+    "implementationStatus": "documented",
+    "widget": "carousel"
+  },
+  {
+    "id": "nng-plain-language-and-recovery",
+    "version": 1,
+    "domains": ["usability"],
+    "title": "Plain language and error recovery",
+    "instruction": "Use the visitor's words for the next step. If a form fails, say what went wrong and how to fix it.",
+    "rationale": "Nielsen heuristics 2 and 9. They are not a blocking standard by themselves.",
+    "authorityIds": ["src-nng-heuristics"],
+    "authorityClass": "research-heuristic",
+    "applicability": "contact-path",
+    "stages": ["copy", "representative"],
+    "verificationMethod": "Advisory. A semantic concern becomes a failure only after a verifier or a human review confirms it.",
+    "verifierId": null,
+    "severityPolicy": "warning",
+    "exceptions": [],
+    "repairOwner": "copy",
+    "implementationStatus": "documented"
+  },
+  {
+    "id": "seo-indexing-intent",
+    "version": 1,
+    "domains": ["seo"],
+    "title": "Indexing intent",
+    "instruction": "Preview may be noindex. Production noindex on a page meant to be found is a launch blocker.",
+    "rationale": "Google documents opting out of indexing. Vitris treats an accidental production noindex as a technical SEO defect.",
+    "authorityIds": ["src-google-seo-starter"],
+    "authorityClass": "official-platform",
+    "applicability": "always",
+    "stages": ["preview"],
+    "verificationMethod": "Compare robots meta with environment and the page's indexing intent.",
+    "verifierId": "indexing",
+    "severityPolicy": "blocker",
+    "exceptions": ["Pages explicitly marked nonindexable"],
+    "repairOwner": "pages",
+    "implementationStatus": "fixture-tested"
+  },
+  {
+    "id": "seo-canonical-origin",
+    "version": 1,
+    "domains": ["seo"],
+    "title": "Canonical origin",
+    "instruction": "Production canonical URLs use the configured public origin and a route that exists.",
+    "rationale": "Google's starter guide treats a preferred URL as the way to handle duplicates. A wrong host is a technical defect.",
+    "authorityIds": ["src-google-seo-starter"],
+    "authorityClass": "official-platform",
+    "applicability": "always",
+    "stages": ["preview"],
+    "verificationMethod": "Compare canonical href with publicOrigin and built routes.",
+    "verifierId": "canonical",
+    "severityPolicy": "blocker",
+    "exceptions": ["Missing publicOrigin is a preview warning and a production blocker"],
+    "repairOwner": "launch",
+    "implementationStatus": "fixture-tested"
+  },
+  {
+    "id": "seo-sitemap-exclusions",
+    "version": 1,
+    "domains": ["seo"],
+    "title": "Sitemap exclusions",
+    "instruction": "Production sitemaps use absolute URLs and omit redirects, retired URLs, and intentionally nonindexable pages.",
+    "rationale": "A sitemap should list URLs you want crawled. It is not proof that every historical URL was discovered.",
+    "authorityIds": ["src-google-seo-starter"],
+    "authorityClass": "official-platform",
+    "applicability": "always",
+    "stages": ["preview"],
+    "verificationMethod": "Compare sitemap loc values with route dispositions.",
+    "verifierId": "sitemap",
+    "severityPolicy": "blocker",
+    "exceptions": [],
+    "repairOwner": "compiler",
+    "implementationStatus": "fixture-tested"
+  },
+  {
+    "id": "seo-redirect-integrity",
+    "version": 1,
+    "domains": ["seo"],
+    "title": "Redirect integrity",
+    "instruction": "Every discovered material URL needs keep, redirect, consolidate, or retire. Reject loops, missing destinations, and accidental homepage redirects.",
+    "rationale": "URL changes need an explicit destination. Harvest coverage is not a claim that every old URL was found.",
+    "authorityIds": ["src-google-site-move"],
+    "authorityClass": "official-platform",
+    "applicability": "always",
+    "stages": ["storyboard", "preview"],
+    "verificationMethod": "Graph walk of storyboard route dispositions.",
+    "verifierId": "redirects",
+    "severityPolicy": "blocker",
+    "exceptions": ["An explicit intentional homepage redirect"],
+    "repairOwner": "storyboard",
+    "implementationStatus": "fixture-tested"
+  },
+  {
+    "id": "seo-structured-data-consistency",
+    "version": 1,
+    "domains": ["seo"],
+    "title": "Structured data consistency",
+    "instruction": "Use Organization unless a real address supports LocalBusiness. The entity must match visible content. Do not invent ratings or service areas.",
+    "rationale": "Structured data validity, visible consistency, and rich-result eligibility are different checks.",
+    "authorityIds": ["src-google-seo-starter"],
+    "authorityClass": "official-platform",
+    "applicability": "always",
+    "stages": ["pages", "preview"],
+    "verificationMethod": "Parse JSON-LD and compare name, type, and address with visible facts.",
+    "verifierId": "structured-data",
+    "severityPolicy": "blocker",
+    "exceptions": ["Eligibility for a rich result is not claimed"],
+    "repairOwner": "compiler",
+    "implementationStatus": "fixture-tested"
+  },
+  {
+    "id": "geo-visible-answers",
+    "version": 1,
+    "domains": ["geo"],
+    "title": "Answer the visitor in visible text",
+    "instruction": "Answer the questions a visitor actually has, in the page, with the business and services identified from evidence. Do not add FAQ blocks, fake credentials, or city pages to chase citations.",
+    "rationale": "Google says its AI features rely on existing SEO foundations and do not need special files. Other providers are not covered.",
+    "authorityIds": ["src-google-ai-features"],
+    "authorityClass": "official-platform",
+    "applicability": "service-site",
+    "stages": ["copy"],
+    "verificationMethod": "Advisory. No llms.txt launch requirement.",
+    "verifierId": null,
+    "severityPolicy": "warning",
+    "exceptions": ["Experimental crawler files require a separate reviewed policy"],
+    "repairOwner": "copy",
+    "implementationStatus": "documented"
+  },
+  {
+    "id": "perf-transfer-budget",
+    "version": 1,
+    "domains": ["performance"],
+    "title": "Starting transfer budget",
+    "instruction": "Keep first-party JavaScript and CSS within the versioned Vitris budgets. A broken or empty shipped resource blocks. Lab timing stays a warning while variance is calibrated.",
+    "rationale": "These limits are Vitris policy. Core Web Vitals remain field targets and are unknown until measured.",
+    "authorityIds": ["src-vitris-transfer-budget", "src-web-vitals"],
+    "authorityClass": "project-policy",
+    "applicability": "always",
+    "stages": ["pages", "browser", "preview"],
+    "verificationMethod": "Gzip and byte totals. Unavailable lab or field data stays unknown.",
+    "verifierId": "transfer-budget",
+    "severityPolicy": "blocker",
+    "exceptions": ["A stated media-heavy exception"],
+    "repairOwner": "pages",
+    "implementationStatus": "fixture-tested"
+  },
+  {
+    "id": "perf-field-cwv",
+    "version": 1,
+    "domains": ["performance"],
+    "title": "Field Core Web Vitals",
+    "instruction": "Do not mark LCP, INP, or CLS passed from a missing field sample or a single lab run.",
+    "rationale": "web.dev defines the 75th percentile field targets. Lab measurement is prelaunch evidence only.",
+    "authorityIds": ["src-web-vitals"],
+    "authorityClass": "official-platform",
+    "applicability": "always",
+    "stages": ["browser", "preview"],
+    "verificationMethod": "Record unknown when field data or the lab runner is absent.",
+    "verifierId": "field-cwv",
+    "severityPolicy": "warning",
+    "exceptions": [],
+    "repairOwner": "browser",
+    "implementationStatus": "fixture-tested"
+  },
+  {
+    "id": "vitris-launch-evidence-binding",
+    "version": 1,
+    "domains": ["publication"],
+    "title": "Bound launch evidence",
+    "instruction": "Production publication requires evidence tied to the same build and policy. A passed flag in an unbound JSON file is not evidence.",
+    "rationale": "Supported CLI, site script, CI, and Worker paths share this rule. Manual uploads outside those paths are not prevented.",
+    "authorityIds": ["src-vitris-transfer-budget"],
+    "authorityClass": "project-policy",
+    "applicability": "always",
+    "stages": ["preview"],
+    "verificationMethod": "Shared launch decision. Worker pages upload fails closed without a trusted receipt for the same build hash.",
+    "verifierId": "launch-policy",
+    "severityPolicy": "blocker",
+    "exceptions": ["An explicit scoped override is reported as waived, not passed"],
+    "repairOwner": "launch",
+    "implementationStatus": "fixture-tested"
+  },
+  {
+    "id": "teaching-creative-freedom",
+    "version": 1,
+    "domains": ["design"],
+    "title": "Creative freedom",
+    "instruction": "Accept restrained pages, purposeful repetition, and alternate accessible compositions. Flag novelty only when it creates a visitor or implementation defect.",
+    "rationale": "Teaching guidance. It does not outrank a confirmed accessibility, functionality, or indexing failure.",
+    "authorityIds": ["src-nng-heuristics"],
+    "authorityClass": "teaching",
+    "applicability": "service-site",
+    "stages": ["direction", "representative"],
+    "verificationMethod": "Critic must name a visitor problem, business mismatch, or defect.",
+    "verifierId": "creative-freedom",
+    "severityPolicy": "warning",
+    "exceptions": [],
+    "repairOwner": "direction",
+    "implementationStatus": "fixture-tested"
+  }
+]