rclanan · Oct 19, 2026 · Oct 16, 2026
diff --git a/.github/workflows/deploy-pages.yml b/.github/workflows/deploy-pages.yml
@@ -32,6 +32,9 @@ jobs:
       - run: npm ci
       - run: npm run build:css
       - run: npm run build:site
+        env:
+          # PostHog project key (public by design). Unset = analytics stays off.
+          POSTHOG_KEY: ${{ secrets.POSTHOG_KEY }}
 
       - uses: actions/upload-pages-artifact@v3
         with:

diff --git a/.github/workflows/verify-pages-build.yml b/.github/workflows/verify-pages-build.yml
@@ -22,5 +22,6 @@ jobs:
       - run: npm run build:css
       - run: npm run build:pages
       - run: npm run build:site
+      - run: npm test
       - run: npm run check:links -- --internal-only
       - run: git diff --exit-code
diff --git a/404.html b/404.html
@@ -17,6 +17,7 @@
 
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/README.md b/README.md
@@ -30,6 +30,19 @@ node scripts/build-pages.js --force    # build and overwrite all root files (los
 If `--check` reports drift, port the root edits back into `src/pages/` before
 running the build, so future builds stay idempotent.
 
+## Analytics
+
+`public/analytics.js` loads PostHog (US cloud) on every page through the shared head
+block in `scripts/build-pages.js`, and tags visits referred by AI assistants (ChatGPT,
+Perplexity, Claude, Gemini, Copilot, Meta AI, Grok, DeepSeek, Mistral, You.com, Phind)
+with an `ai_referral_landing` event and an `ai_referrer` property. It is cookieless and
+does not record sessions or capture form input.
+
+The committed file keeps the placeholder `"__POSTHOG_KEY__"`, which leaves analytics off.
+`npm run build:site` swaps in the `POSTHOG_KEY` environment variable when it is set; the
+deploy workflow passes the `POSTHOG_KEY` repository secret. Run `npm test` to check the
+classifier and the build injection.
+
 ## Deployment
 
 This site is deployed using GitHub Pages:

diff --git a/compare-mockserver.html b/compare-mockserver.html
@@ -35,6 +35,7 @@
 
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/comparisons.html b/comparisons.html
@@ -10,6 +10,7 @@
 <link rel="stylesheet" href="/public/vendor/phosphor/phosphor.css" />
 <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/contact.html b/contact.html
@@ -23,6 +23,7 @@
 
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/engineering-notes.html b/engineering-notes.html
@@ -16,6 +16,7 @@
     <link rel="stylesheet" href="/public/vendor/phosphor/phosphor.css" />
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/faq.html b/faq.html
@@ -10,6 +10,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/index.html b/index.html
@@ -82,6 +82,7 @@
 
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-announcing-v1.html b/note-announcing-v1.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-api-drift-detection-and-contract-alerting.html b/note-api-drift-detection-and-contract-alerting.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-client-generation-tradeoffs.html b/note-client-generation-tradeoffs.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-cloud-launch.html b/note-cloud-launch.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-conformance-maturity.html b/note-conformance-maturity.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-conformance-testing.html b/note-conformance-testing.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-cost-cap-design.html b/note-cost-cap-design.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-fault-injection-patterns.html b/note-fault-injection-patterns.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-grpc-dynamic-routing-release.html b/note-grpc-dynamic-routing-release.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-grpc-mocking-in-ci.html b/note-grpc-mocking-in-ci.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-migration-from-static-fixtures.html b/note-migration-from-static-fixtures.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-mocking-kafka-without-broker.html b/note-mocking-kafka-without-broker.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-multi-target-conformance-and-real-world-specs.html b/note-multi-target-conformance-and-real-world-specs.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-our-saas-infrastructure.html b/note-our-saas-infrastructure.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-release-cadence-and-risk.html b/note-release-cadence-and-risk.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-reliability-update-march-2026.html b/note-reliability-update-march-2026.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-reliability-updates-conformance-and-admin.html b/note-reliability-updates-conformance-and-admin.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-scenario-switching.html b/note-scenario-switching.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-security-guardrails-v0-2x.html b/note-security-guardrails-v0-2x.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-spec-driven-openapi-conformance.html b/note-spec-driven-openapi-conformance.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-testing-failure-paths.html b/note-testing-failure-paths.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-v0-1-3-protocol-expansion.html b/note-v0-1-3-protocol-expansion.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-v0-2-0-client-generation.html b/note-v0-2-0-client-generation.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-v0-2-3-bug-fixes.html b/note-v0-2-3-bug-fixes.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-v0-2-4-client-fixes.html b/note-v0-2-4-client-fixes.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-v0-2-5-enterprise-security.html b/note-v0-2-5-enterprise-security.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-v0-2-6-security-infrastructure.html b/note-v0-2-6-security-infrastructure.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-v0-2-7-api-sync-tcp.html b/note-v0-2-7-api-sync-tcp.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-v0-3-227-release.html b/note-v0-3-227-release.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-v0-3-migration-playbook.html b/note-v0-3-migration-playbook.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-vs-postman-mock.html b/note-vs-postman-mock.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-wafbench-security-hardening.html b/note-wafbench-security-hardening.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-wafbench-sqli-detection.html b/note-wafbench-sqli-detection.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-wasm-plugins.html b/note-wasm-plugins.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-when-wiremock-isnt-enough.html b/note-when-wiremock-isnt-enough.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/note-why-multi-protocol.html b/note-why-multi-protocol.html
@@ -14,6 +14,7 @@
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/public/styles.css" />
     <link rel="alternate" type="application/rss+xml" title="MockForge Engineering Notes" href="/rss.xml" />
+    <script src="/public/analytics.js" defer></script>
     <script>
       (function () {
         try {

diff --git a/package.json b/package.json
@@ -6,7 +6,8 @@
     "build:pages": "node ./scripts/build-pages.js",
     "build:site": "node ./scripts/build-pages.js dist",
     "sync:shells": "npm run build:pages",
-    "check:links": "node ./scripts/check-links.mjs"
+    "check:links": "node ./scripts/check-links.mjs",
+    "test": "node --test scripts/analytics.test.js"
   },
   "devDependencies": {
     "tailwindcss": "3.4.17"