diff --git a/Documentation drift report [2026-06-17].md b/Documentation drift report [2026-06-17].md
new file mode 100644
index 0000000..d04597b
--- /dev/null
+++ b/Documentation drift report [2026-06-17].md	
@@ -0,0 +1,50 @@
+# Documentation drift report [2026-06-17]
+
+## README.md vs docs/whitepaper.md
+
+### [VARIATION] Design Principles (Structured Data)
+
+- **README.md** (Line 101):
+
+> Layer 3: Structured Data (schema.org, JSON-LD) → Level 1-3
+
+- **docs/whitepaper.md** (Line 257):
+
+> Layer 3: Structured Data (schema.org, JSON-LD, OG) → Level 1-3 agents
+
+## README.md vs tools/validators/fr1-checker.js
+
+### [DRIFT] FR-1 Checker scope definition
+
+- **README.md** (Line 271):
+
+> - **FR-1 Checker** (`fr1-checker.js`) — comprehensive Layer 1-2 audit with
+
+- **tools/validators/fr1-checker.js** (Line 9):
+
+> \* FR-1 Checker - Test Initial Payload Accessibility
+
+## README.md vs examples/
+
+### [DRIFT] Code snippet parity
+
+- **README.md** (Lines 162-169):
+
+> <!-- Layer 2: Semantic structure with ARIA -->
+> <article class="product-card" itemscope itemtype="https://schema.org/Product">
+>   <h2 itemprop="name">Pro Agent License</h2>
+>   <div itemprop="offers" itemscope itemtype="https://schema.org/Offer">
+>     <span itemprop="price" content="99.00">$99/mo</span>
+>     <meta itemprop="priceCurrency" content="USD" />
+>   </div>
+
+- **examples/ssr-pass-example.html** (Lines 210-216):
+
+> <article class="product-card" itemscope itemtype="https://schema.org/Product">
+>   <img src="https://via.placeholder.com/250x200/4A90E2/fff?text=Headphones" alt="Wireless Headphones" />
+>   <h2 class="product-title" itemprop="name">Wireless Headphones</h2>
+>   <p class="product-description" itemprop="description">Premium noise-cancelling over-ear headphones</p>
+>   <div class="product-price" itemprop="offers" itemscope itemtype="https://schema.org/Offer">
+>     <span itemprop="price" content="99.99">$99.99</span>
+>     <meta itemprop="priceCurrency" content="USD" />
+>   </div>
diff --git a/package-lock.json b/package-lock.json
index 7c01eca..0109681 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1124,16 +1124,6 @@
         "node": ">=8"
       }
     },
-    "node_modules/@istanbuljs/load-nyc-config/node_modules/argparse": {
-      "version": "1.0.10",
-      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
-      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "sprintf-js": "~1.0.2"
-      }
-    },
     "node_modules/@istanbuljs/load-nyc-config/node_modules/find-up": {
       "version": "4.1.0",
       "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz",
@@ -1148,20 +1138,6 @@
         "node": ">=8"
       }
     },
-    "node_modules/@istanbuljs/load-nyc-config/node_modules/js-yaml": {
-      "version": "3.14.2",
-      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.2.tgz",
-      "integrity": "sha512-PMSmkqxr106Xa156c2M265Z+FTrPl+oxd/rgOQy2tijQeK5TxQ43psO1ZCwhVOSdnn+RzkzlRz/eY4BgJBYVpg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "argparse": "^1.0.7",
-        "esprima": "^4.0.0"
-      },
-      "bin": {
-        "js-yaml": "bin/js-yaml.js"
-      }
-    },
     "node_modules/@istanbuljs/load-nyc-config/node_modules/locate-path": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz",
@@ -2542,6 +2518,13 @@
         "url": "https://github.com/sponsors/jonschlinkert"
       }
     },
+    "node_modules/argparse": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
+      "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
+      "dev": true,
+      "license": "Python-2.0"
+    },
     "node_modules/babel-jest": {
       "version": "30.4.1",
       "resolved": "https://registry.npmjs.org/babel-jest/-/babel-jest-30.4.1.tgz",
@@ -3325,20 +3308,6 @@
         "url": "https://opencollective.com/eslint"
       }
     },
-    "node_modules/esprima": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
-      "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==",
-      "dev": true,
-      "license": "BSD-2-Clause",
-      "bin": {
-        "esparse": "bin/esparse.js",
-        "esvalidate": "bin/esvalidate.js"
-      },
-      "engines": {
-        "node": ">=4"
-      }
-    },
     "node_modules/esquery": {
       "version": "1.7.0",
       "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.7.0.tgz",
@@ -4602,6 +4571,29 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/js-yaml": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.2.0.tgz",
+      "integrity": "sha512-ePWsvanv0DWuDRsW8dnt+R4jQ31SCRCQ7hhNcPXZPsoBZiemuZNYGf7adZdqX2D86j6rvKp3RpCxVTSb8WQlOw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/puzrin"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/nodeca"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "argparse": "^2.0.1"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
     "node_modules/jsdom": {
       "version": "29.1.1",
       "resolved": "https://registry.npmjs.org/jsdom/-/jsdom-29.1.1.tgz",
@@ -5503,13 +5495,6 @@
         "source-map": "^0.6.0"
       }
     },
-    "node_modules/sprintf-js": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
-      "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==",
-      "dev": true,
-      "license": "BSD-3-Clause"
-    },
     "node_modules/stack-utils": {
       "version": "2.0.6",
       "resolved": "https://registry.npmjs.org/stack-utils/-/stack-utils-2.0.6.tgz",
diff --git a/package.json b/package.json
index 4f767b1..e597d11 100644
--- a/package.json
+++ b/package.json
@@ -80,5 +80,8 @@
   },
   "optionalDependencies": {
     "puppeteer": "25.1.0"
+  },
+  "overrides": {
+    "js-yaml": "^4.1.0"
   }
 }