@prenta/core 5.8.0 → 5.9.0

package/dist/seo/ai-bots.js

@@ -63,26 +63,92 @@ export const AI_RETRIEVAL_BOTS = [
     'DuckAssistBot',
 ];
 /**
- * Identify a known AI crawler from a `User-Agent` string. Substring match
- * (case-insensitive) against the curated taxonomy. TRAINING tokens are checked
- * first so the more specific `*-Extended` variants win over their search-crawler
- * namesakes (e.g. `Applebot-Extended` → training, plain `Applebot` → retrieval).
- * Returns `null` for humans and unknown bots — never guesses.
+ * General web-search crawlers. Never blocked by the AI policy; recorded by GEO
+ * measurement as the baseline that makes AI crawl volume legible. Well-attested
+ * tokens only. `Applebot` is deliberately NOT here — it feeds Siri/Spotlight
+ * answers and stays in the retrieval list.
  */
-export function detectAiBot(userAgent) {
+export const SEARCH_BOTS = [
+    'Googlebot',
+    'Bingbot',
+    'DuckDuckBot',
+    'YandexBot',
+    'Baiduspider',
+];
+const REGISTRY = [
+    [AI_TRAINING_BOTS, 'training'],
+    [AI_RETRIEVAL_BOTS, 'retrieval'],
+    [SEARCH_BOTS, 'search'],
+];
+/**
+ * Identify a known crawler from a `User-Agent` string. Substring match
+ * (case-insensitive). Precedence is training → retrieval → search, so the more
+ * specific `*-Extended` variants win over their search-crawler namesakes
+ * (`Applebot-Extended` → training, `Applebot` → retrieval, `Google-Extended` →
+ * training, `Googlebot` → search). Returns `null` for humans and unknown bots.
+ */
+export function detectBot(userAgent) {
     if (!userAgent)
         return null;
     const ua = userAgent.toLowerCase();
-    for (const token of AI_TRAINING_BOTS) {
-        if (ua.includes(token.toLowerCase()))
-            return { token, category: 'training' };
+    for (const [tokens, category] of REGISTRY) {
+        for (const token of tokens) {
+            if (ua.includes(token.toLowerCase()))
+                return { token, category };
+        }
     }
-    for (const token of AI_RETRIEVAL_BOTS) {
-        if (ua.includes(token.toLowerCase()))
-            return { token, category: 'retrieval' };
+    return null;
+}
+/**
+ * Identify a known **AI** crawler (training or retrieval) — the original
+ * contract used by robots.txt and the lifetime crawler log. Search bots return
+ * `null` here; use {@link detectBot} when you want them too.
+ */
+export function detectAiBot(userAgent) {
+    const found = detectBot(userAgent);
+    if (!found || found.category === 'search')
+        return null;
+    return { token: found.token, category: found.category };
+}
+/**
+ * Exact (case-insensitive) lookup of a canonical token. This is the server-side
+ * allowlist for beacon payloads: a middleware running a different core version
+ * can only ever record tokens this build knows about.
+ */
+export function botByToken(token) {
+    if (!token)
+        return null;
+    const needle = token.toLowerCase();
+    for (const [tokens, category] of REGISTRY) {
+        for (const candidate of tokens) {
+            if (candidate.toLowerCase() === needle)
+                return { token: candidate, category };
+        }
     }
     return null;
 }
+/**
+ * Effective stance for one category. Precedence mirrors
+ * {@link buildAiBotRobotsLines}: explicit policy → legacy `blockAIBots` → allow.
+ * Search crawlers are never blocked by the AI policy.
+ */
+export function aiBotStanceFor(category, policy, legacyBlockAIBots) {
+    switch (category) {
+        case 'search':
+            return 'allow';
+        case 'training':
+        case 'retrieval': {
+            if (policy && (policy.training || policy.retrieval)) {
+                return policy[category] === 'block' ? 'block' : 'allow';
+            }
+            return legacyBlockAIBots ? 'block' : 'allow';
+        }
+        default: {
+            const _exhaustive = category;
+            return _exhaustive;
+        }
+    }
+}
 /**
  * Build the robots.txt User-agent/Disallow line groups for blocked AI bots.
  *
@@ -96,24 +162,13 @@ export function detectAiBot(userAgent) {
  * `User-agent` + `Disallow: /` + blank-line group). Pure + deterministic.
  */
 export function buildAiBotRobotsLines(policy, legacyBlockAIBots) {
-    let blockTraining;
-    let blockRetrieval;
-    if (policy && (policy.training || policy.retrieval)) {
-        blockTraining = policy.training === 'block';
-        blockRetrieval = policy.retrieval === 'block';
-    }
-    else if (legacyBlockAIBots) {
-        blockTraining = true;
-        blockRetrieval = true;
-    }
-    else {
-        return [];
-    }
     const bots = [];
-    if (blockTraining)
+    if (aiBotStanceFor('training', policy, legacyBlockAIBots) === 'block') {
         bots.push(...AI_TRAINING_BOTS);
-    if (blockRetrieval)
+    }
+    if (aiBotStanceFor('retrieval', policy, legacyBlockAIBots) === 'block') {
         bots.push(...AI_RETRIEVAL_BOTS);
+    }
     const lines = [];
     for (const bot of bots) {
         lines.push(`User-agent: ${bot}`);

package/dist/seo/ai-bots.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-bots.js","sourceRoot":"","sources":["../../src/seo/ai-bots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,WAAW;IACX,cAAc;IACd,2DAA2D;IAC3D,iBAAiB;IACjB,0CAA0C;IAC1C,OAAO;IACP,YAAY;IACZ,YAAY;IACZ,qEAAqE;IACrE,mBAAmB;IACnB,OAAO;IACP,oBAAoB;IACpB,aAAa;IACb,kCAAkC;IAClC,SAAS;IACT,WAAW;IACX,QAAQ;IACR,UAAU;IACV,UAAU;IACV,WAAW;IACX,cAAc;IACd,UAAU;CACX,CAAA;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,SAAS;IACT,eAAe;IACf,cAAc;IACd,aAAa;IACb,eAAe;IACf,iBAAiB;IACjB,sBAAsB;IACtB,YAAY;IACZ,aAAa;IACb,gCAAgC;IAChC,UAAU;IACV,iBAAiB;IACjB,WAAW;IACX,8BAA8B;IAC9B,QAAQ;IACR,eAAe;CAChB,CAAA;AAUD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,SAAoC;IAC9D,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAA;IAC3B,MAAM,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE,CAAA;IAClC,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,IAAI,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAA;IAC9E,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;QACtC,IAAI,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAA;IAC/E,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAWD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAA+B,EAC/B,iBAAsC;IAEtC,IAAI,aAAsB,CAAA;IAC1B,IAAI,cAAuB,CAAA;IAE3B,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACpD,aAAa,GAAG,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAA;QAC3C,cAAc,GAAG,MAAM,CAAC,SAAS,KAAK,OAAO,CAAA;IAC/C,CAAC;SAAM,IAAI,iBAAiB,EAAE,CAAC;QAC7B,aAAa,GAAG,IAAI,CAAA;QACpB,cAAc,GAAG,IAAI,CAAA;IACvB,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,IAAI,aAAa;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAA;IACjD,IAAI,cAAc;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,CAAA;IAEnD,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC,CAAA;QAChC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAChB,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}
+{"version":3,"file":"ai-bots.js","sourceRoot":"","sources":["../../src/seo/ai-bots.ts"],"names":[],"mappings":"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"}

package/dist/seo/ai-crawler-log.d.ts

@@ -1,4 +1,6 @@
 export type AiCrawlerSurface = 'llms' | 'llms-full' | 'md' | 'honeypot';
+/** Path recorded in the GEO daily trend for each lifetime-counter surface. */
+export declare const AI_CRAWLER_SURFACE_PATH: Record<AiCrawlerSurface, string>;
 /** Upsert one aggregated hit. Safe to await on any public route. */
 export declare function recordAiCrawlerHit(db: any, entry: {
     bot: string;

package/dist/seo/ai-crawler-log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-crawler-log.d.ts","sourceRoot":"","sources":["../../src/seo/ai-crawler-log.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI,GAAG,UAAU,CAAA;AAIvE,oEAAoE;AACpE,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,GAAG,EACP,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,EAAE,EAAE,GAAG,EACP,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAQf"}
+{"version":3,"file":"ai-crawler-log.d.ts","sourceRoot":"","sources":["../../src/seo/ai-crawler-log.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI,GAAG,UAAU,CAAA;AAIvE,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAKpE,CAAA;AAED,oEAAoE;AACpE,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,GAAG,EACP,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,EAAE,EAAE,GAAG,EACP,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/seo/ai-crawler-log.js

@@ -7,8 +7,16 @@
  * `prenta_ai_crawler_hits` table — must never break a public surface.
  */
 import { hasModel } from '../api/route-helpers.js';
-import { detectAiBot } from './ai-bots.js';
+import { botByToken, detectAiBot } from './ai-bots.js';
+import { recordGeoCrawl } from './geo-record.js';
 const MAX_BOT_LEN = 128;
+/** Path recorded in the GEO daily trend for each lifetime-counter surface. */
+export const AI_CRAWLER_SURFACE_PATH = {
+    llms: '/llms.txt',
+    'llms-full': '/llms-full.txt',
+    md: '/md',
+    honeypot: '/ai-crawlers/trap',
+};
 /** Upsert one aggregated hit. Safe to await on any public route. */
 export async function recordAiCrawlerHit(db, entry) {
     if (!db || !hasModel(db, 'aiCrawlerHit'))
@@ -29,6 +37,16 @@ export async function recordAiCrawlerHit(db, entry) {
     catch {
         // best-effort — swallow so logging can never break the response
     }
+    // Keep the daily trend in step with the lifetime counter. Only registry
+    // tokens are recorded (the honeypot's `unknown` stays lifetime-only).
+    const known = botByToken(bot);
+    if (known) {
+        await recordGeoCrawl(db, {
+            bot: known.token,
+            category: known.category,
+            path: AI_CRAWLER_SURFACE_PATH[entry.surface],
+        });
+    }
 }
 /**
  * Detect a known AI crawler from the request's User-Agent and, if found, record

package/dist/seo/ai-crawler-log.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-crawler-log.js","sourceRoot":"","sources":["../../src/seo/ai-crawler-log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAI1C,MAAM,WAAW,GAAG,GAAG,CAAA;AAEvB,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,EAAO,EACP,KAAoE;IAEpE,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;QAAE,OAAM;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;SAChC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;SACrB,IAAI,EAAE,CAAA;IACT,IAAI,CAAC,GAAG;QAAE,OAAM;IAChB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAA;IAC1C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;YAC3B,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE;YACvD,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,EAAE,QAAQ,EAAE;YACpE,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE;SAC3D,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;IAClE,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,EAAO,EACP,OAAgB,EAChB,OAAyB;IAEzB,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAA;IAC/D,IAAI,CAAC,QAAQ;QAAE,OAAM;IACrB,MAAM,kBAAkB,CAAC,EAAE,EAAE;QAC3B,GAAG,EAAE,QAAQ,CAAC,KAAK;QACnB,OAAO;QACP,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"ai-crawler-log.js","sourceRoot":"","sources":["../../src/seo/ai-crawler-log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAIhD,MAAM,WAAW,GAAG,GAAG,CAAA;AAEvB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,uBAAuB,GAAqC;IACvE,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,gBAAgB;IAC7B,EAAE,EAAE,KAAK;IACT,QAAQ,EAAE,mBAAmB;CAC9B,CAAA;AAED,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,EAAO,EACP,KAAoE;IAEpE,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;QAAE,OAAM;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;SAChC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;SACrB,IAAI,EAAE,CAAA;IACT,IAAI,CAAC,GAAG;QAAE,OAAM;IAChB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAA;IAC1C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;YAC3B,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE;YACvD,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,EAAE,QAAQ,EAAE;YACpE,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE;SAC3D,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;IAClE,CAAC;IACD,wEAAwE;IACxE,sEAAsE;IACtE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;IAC7B,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,cAAc,CAAC,EAAE,EAAE;YACvB,GAAG,EAAE,KAAK,CAAC,KAAK;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,uBAAuB,CAAC,KAAK,CAAC,OAAO,CAAC;SAC7C,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,EAAO,EACP,OAAgB,EAChB,OAAyB;IAEzB,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAA;IAC/D,IAAI,CAAC,QAAQ;QAAE,OAAM;IACrB,MAAM,kBAAkB,CAAC,EAAE,EAAE;QAC3B,GAAG,EAAE,QAAQ,CAAC,KAAK;QACnB,OAAO;QACP,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAC,CAAA;AACJ,CAAC"}

package/dist/seo/ai-referrers.d.ts

@@ -0,0 +1,25 @@
+export interface DetectedAiReferrer {
+    /** `KnownReferrer.name`, e.g. `ChatGPT`. */
+    engine: string;
+    via: 'referer' | 'utm';
+}
+/** Exact allowlist check for beacon payloads. */
+export declare function isAiReferrerEngine(name: string | null | undefined): boolean;
+/**
+ * Detects an AI-engine referral from the `Referer` header, falling back to the
+ * request URL's `utm_source`. Returns `null` (never throws) when neither signal
+ * matches or the inputs are malformed.
+ *
+ * @param input.referer - Raw `Referer` header value, if any.
+ * @param input.url - The current request URL.
+ * @param input.selfOrigin - The site's own origin, used to skip same-site
+ *   referers. Must be a full origin including the scheme (e.g.
+ *   `https://example.com`); bare hosts such as `example.com` do not parse as a
+ *   URL and are ignored, so no same-site filtering is applied.
+ */
+export declare function detectAiReferrer(input: {
+    referer?: string | null;
+    url: string | URL;
+    selfOrigin?: string | null;
+}): DetectedAiReferrer | null;
+//# sourceMappingURL=ai-referrers.d.ts.map

package/dist/seo/ai-referrers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-referrers.d.ts","sourceRoot":"","sources":["../../src/seo/ai-referrers.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,SAAS,GAAG,KAAK,CAAA;CACvB;AA2CD,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,GAAG,kBAAkB,GAAG,IAAI,CAqB5B"}

package/dist/seo/ai-referrers.js

@@ -0,0 +1,96 @@
+/**
+ * AI-engine referral detection for GEO measurement.
+ *
+ * Two signals, in order:
+ *   1. the `Referer` header's hostname, looked up in the shared attribution
+ *      registry (`KNOWN_REFERRERS`, `channel: 'ai'`);
+ *   2. failing that, the request URL's `utm_source` — ChatGPT appends
+ *      `?utm_source=chatgpt.com` to outbound links while sending no `Referer`,
+ *      and other engines tag links with their name.
+ *
+ * Pure. Never returns anything derived from the raw referrer URL or query
+ * string other than the engine name.
+ */
+import { AI_REFERRER_NAMES, lookupKnownReferrer } from '../forms/attribution.js';
+/**
+ * Explicit `utm_source` aliases (lowercased) → registry `name`. Only exact
+ * matches are accepted; word fragments of engine names (`google`, `microsoft`,
+ * `chat`, `studio`) are deliberately NOT matched — they are common paid-campaign
+ * tags and would corrupt the AI-referral metric.
+ */
+const UTM_ENGINE_ALIASES = {
+    copilot: 'Microsoft Copilot',
+    mistral: 'Le Chat (Mistral)',
+};
+function hostOf(value) {
+    try {
+        return new URL(value).hostname.toLowerCase();
+    }
+    catch {
+        return null;
+    }
+}
+function aiEngineForHost(host) {
+    const meta = lookupKnownReferrer(host);
+    return meta && meta.channel === 'ai' ? meta.name : null;
+}
+/**
+ * Matches a `utm_source` value against an engine name exactly (case-insensitive),
+ * against the name with non-alphanumerics removed (`chatgpt`, `deepseek`), or
+ * against an explicit alias. Never matches partial words.
+ */
+function aiEngineForWord(raw) {
+    const word = raw.trim().toLowerCase();
+    if (!word)
+        return null;
+    for (const name of AI_REFERRER_NAMES) {
+        const lowered = name.toLowerCase();
+        if (lowered === word)
+            return name;
+        if (lowered.replace(/[^a-z0-9]/g, '') === word)
+            return name;
+    }
+    const alias = Object.hasOwn(UTM_ENGINE_ALIASES, word) ? UTM_ENGINE_ALIASES[word] : undefined;
+    return alias ?? null;
+}
+/** Exact allowlist check for beacon payloads. */
+export function isAiReferrerEngine(name) {
+    return typeof name === 'string' && name.length > 0 && AI_REFERRER_NAMES.includes(name);
+}
+/**
+ * Detects an AI-engine referral from the `Referer` header, falling back to the
+ * request URL's `utm_source`. Returns `null` (never throws) when neither signal
+ * matches or the inputs are malformed.
+ *
+ * @param input.referer - Raw `Referer` header value, if any.
+ * @param input.url - The current request URL.
+ * @param input.selfOrigin - The site's own origin, used to skip same-site
+ *   referers. Must be a full origin including the scheme (e.g.
+ *   `https://example.com`); bare hosts such as `example.com` do not parse as a
+ *   URL and are ignored, so no same-site filtering is applied.
+ */
+export function detectAiReferrer(input) {
+    const refHost = input.referer ? hostOf(input.referer) : null;
+    if (refHost) {
+        const selfHost = input.selfOrigin ? hostOf(input.selfOrigin) : null;
+        if (!selfHost || refHost !== selfHost) {
+            const engine = aiEngineForHost(refHost);
+            if (engine)
+                return { engine, via: 'referer' };
+        }
+    }
+    let url;
+    try {
+        url = typeof input.url === 'string' ? new URL(input.url) : input.url;
+    }
+    catch {
+        return null;
+    }
+    const utm = url.searchParams.get('utm_source');
+    if (!utm)
+        return null;
+    const asHost = utm.includes('.') ? aiEngineForHost(utm.toLowerCase()) : null;
+    const engine = asHost ?? aiEngineForWord(utm);
+    return engine ? { engine, via: 'utm' } : null;
+}
+//# sourceMappingURL=ai-referrers.js.map

package/dist/seo/ai-referrers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-referrers.js","sourceRoot":"","sources":["../../src/seo/ai-referrers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAQhF;;;;;GAKG;AACH,MAAM,kBAAkB,GAAqC;IAC3D,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,mBAAmB;CAC7B,CAAA;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAA;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;IACtC,OAAO,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AACzD,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACrC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IACtB,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAClC,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QACjC,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;IAC7D,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC5F,OAAO,KAAK,IAAI,IAAI,CAAA;AACtB,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,kBAAkB,CAAC,IAA+B;IAChE,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AACxF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAIhC;IACC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC5D,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QACnE,IAAI,CAAC,QAAQ,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;YACvC,IAAI,MAAM;gBAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAA;QAC/C,CAAC;IACH,CAAC;IAED,IAAI,GAAQ,CAAA;IACZ,IAAI,CAAC;QACH,GAAG,GAAG,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAA;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAC9C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IACrB,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC5E,MAAM,MAAM,GAAG,MAAM,IAAI,eAAe,CAAC,GAAG,CAAC,CAAA;IAC7C,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAC/C,CAAC"}

package/dist/seo/config-store.d.ts

@@ -99,6 +99,10 @@ export interface SeoModuleSettings {
      * margin) halts `already_running` instead of racing the first past `maxPerDay`.
      */
     autopilotRunStartedAt: string | null;
+    /** GEO measurement (spec 2026-09-08): accept crawl/referral beacons. On by default. */
+    geoMeasurementEnabled: boolean;
+    /** Days of GeoCrawlDaily / GeoReferralDaily to keep (7–365). */
+    geoRetentionDays: number;
 }
 /** Safe defaults applied when the overrides document has no `module` block. */
 export declare const DEFAULT_SEO_MODULE_SETTINGS: SeoModuleSettings;

package/dist/seo/config-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../../src/seo/config-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../../src/seo/config-store.ts"],"names":[],"mappings":"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"}

package/dist/seo/config-store.js

@@ -17,6 +17,7 @@
  * never destructive of code-level config.
  */
 import { resolveAutopilotPolicy, } from './autopilot-policy.js';
+import { GEO_RETENTION_DEFAULT_DAYS } from './geo-retention.js';
 export const SEO_CONFIG_COLLECTION = '__seo_config__';
 /** Safe defaults applied when the overrides document has no `module` block. */
 export const DEFAULT_SEO_MODULE_SETTINGS = {
@@ -49,6 +50,8 @@ export const DEFAULT_SEO_MODULE_SETTINGS = {
     autopilotLastRunAt: null,
     autopilotLastRun: null,
     autopilotRunStartedAt: null,
+    geoMeasurementEnabled: true,
+    geoRetentionDays: GEO_RETENTION_DEFAULT_DAYS,
 };
 /** Merge stored module settings over the defaults (field-by-field). */
 export function resolveSeoModuleSettings(overrides) {

package/dist/seo/config-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-store.js","sourceRoot":"","sources":["../../src/seo/config-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config-store.js","sourceRoot":"","sources":["../../src/seo/config-store.ts"],"names":[],"mappings":"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"}

package/dist/seo/digest.d.ts

@@ -64,6 +64,27 @@ export interface SeoDigestAutopilot {
     /** Newest applied rows in the window, capped at `AUTOPILOT_DIGEST_TOP`. */
     top: SeoDigestAutopilotRow[];
 }
+/**
+ * Trailing-7-day GEO measurement summary (spec
+ * 2026-09-08-geo-measurement-design.md §8), derived from
+ * `buildSeoGeoReport(days: 7)`. `null` when measurement is off, the tables are
+ * absent, or nothing was recorded in the 14-day range.
+ */
+export interface SeoDigestGeo {
+    crawlHits7d: number;
+    crawlHitsPrev7d: number | null;
+    /** Distinct retrieval (answer-engine) bots seen in the window. */
+    retrievalBots: number;
+    aiVisits7d: number;
+    aiVisitsPrev7d: number | null;
+    /** Most-cited paths, ≤ GEO_DIGEST_TOP. */
+    topCited: Array<{
+        path: string;
+        visits: number;
+    }>;
+    /** Bots whose category is blocked in robots but that still crawled. */
+    blockedStillCrawling: string[];
+}
 export interface SeoDigest {
     generatedAt: string;
     audit: SeoDigestAudit;
@@ -79,6 +100,8 @@ export interface SeoDigest {
     };
     /** `null` when the consumer schema has no `SeoAutoApply` model. */
     autopilot: SeoDigestAutopilot | null;
+    /** `null` when GEO measurement is off/absent or recorded nothing in 14 days. */
+    geo: SeoDigestGeo | null;
 }
 export declare function buildSeoDigest(db: PrentaDB, options?: {
     now?: Date;

package/dist/seo/digest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../src/seo/digest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../src/seo/digest.ts"],"names":[],"mappings":"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"}

package/dist/seo/digest.js

@@ -1,7 +1,9 @@
+import { hasModel } from '../api/route-helpers.js';
 import { getPrentaConfig } from '../config/runtime.js';
 import { resolveEmailSenderAsync } from '../email/resolve.js';
 import { buildQuickWins } from './audit-engine.js';
 import { getSeoOverrides, patchSeoModuleSettings, resolveSeoModuleSettings, } from './config-store.js';
+import { buildSeoGeoReport } from './geo-report.js';
 import { pendingFixFromMetadata } from './issue-fix-ai.js';
 import { gradeForSeoScore } from './score.js';
 /** Latest COMPLETED run older than this ⇒ prominent staleness callout. */
@@ -12,6 +14,10 @@ const SEVERITY_RANK = { critical: 3, warning: 2, info: 1 };
 const AUTOPILOT_WINDOW_MS = 7 * DAY_MS;
 /** Max applied rows listed in the autopilot block. */
 const AUTOPILOT_DIGEST_TOP = 5;
+/** Max cited paths listed in the AI visibility block. */
+const GEO_DIGEST_TOP = 3;
+/** AI visibility block window (current 7 days; the prior 7 form the baseline). */
+const GEO_WINDOW_DAYS = 7;
 export async function buildSeoDigest(db, options = {}) {
     const now = options.now ?? new Date();
     if (!db?.seoAuditRun?.findFirst)
@@ -118,11 +124,17 @@ export async function buildSeoDigest(db, options = {}) {
         redirectSuggestions = (await db.redirectSuggestion.count({ where: { status: 'open' } })) ?? 0;
     }
     const issueFixes = openIssues.filter((i) => pendingFixFromMetadata(i.metadata) !== null).length;
+    // Module settings feed both optional blocks below (autopilot policy, GEO
+    // measurement toggle) — resolved once.
+    const hasAutopilot = hasModel(db, 'seoAutoApply');
+    const hasGeo = hasModel(db, 'geoCrawlDaily') && hasModel(db, 'geoReferralDaily');
+    const settings = hasAutopilot || hasGeo
+        ? resolveSeoModuleSettings(await getSeoOverrides(db).catch(() => null))
+        : null;
     // Autopilot ledger (optional model — consumer schemas may predate it).
     let autopilot = null;
-    if (db?.seoAutoApply?.count && db?.seoAutoApply?.findMany) {
+    if (hasAutopilot && settings) {
         const since = new Date(now.getTime() - AUTOPILOT_WINDOW_MS);
-        const settings = resolveSeoModuleSettings(await getSeoOverrides(db).catch(() => null));
         const applied = { status: 'applied', appliedAt: { gte: since } };
         const [applied7d, verifyFailed7d, reverted7d, regressed7d, conflicts7d, topRows] = await Promise.all([
             db.seoAutoApply.count({ where: applied }),
@@ -173,6 +185,50 @@ export async function buildSeoDigest(db, options = {}) {
             })),
         };
     }
+    // GEO measurement (optional tables; block is null when nothing to say).
+    // Best-effort: a failing report logs and yields `null`, never a failed digest.
+    let geo = null;
+    if (hasGeo && settings) {
+        try {
+            const report = await buildSeoGeoReport(db, {
+                days: GEO_WINDOW_DAYS,
+                now,
+                settings,
+                config: getPrentaConfig(),
+            });
+            const { total: crawl } = report.crawl;
+            const { total: referrals } = report.referrals;
+            // "Nothing recorded in the 14-day range" ⇒ no block. Prior-window rows
+            // count even when the baseline is incomparable (prev* null): in that
+            // case the first-ever row is inside the range, so `firstSeenAt` tells.
+            const rangeStart = Date.parse(report.window.from) - GEO_WINDOW_DAYS * DAY_MS;
+            const firstSeenInRange = report.firstSeenAt !== null && Date.parse(report.firstSeenAt) >= rangeStart;
+            const anyData = crawl.hits > 0 ||
+                referrals.visits > 0 ||
+                (crawl.prevHits ?? 0) > 0 ||
+                (referrals.prevVisits ?? 0) > 0 ||
+                firstSeenInRange;
+            if (report.enabled && anyData) {
+                geo = {
+                    crawlHits7d: crawl.hits,
+                    crawlHitsPrev7d: crawl.prevHits,
+                    retrievalBots: report.crawl.bots.filter((b) => b.category === 'retrieval' && b.hits > 0)
+                        .length,
+                    aiVisits7d: referrals.visits,
+                    aiVisitsPrev7d: referrals.prevVisits,
+                    topCited: report.referrals.topPaths
+                        .slice(0, GEO_DIGEST_TOP)
+                        .map((p) => ({ path: p.path, visits: p.visits })),
+                    blockedStillCrawling: report.crawl.bots
+                        .filter((b) => b.policy === 'blocked_still_crawling')
+                        .map((b) => b.bot),
+                };
+            }
+        }
+        catch (err) {
+            console.warn('[seo/digest] geo block skipped; report failed', err);
+        }
+    }
     return {
         generatedAt: now.toISOString(),
         audit: {
@@ -202,6 +258,7 @@ export async function buildSeoDigest(db, options = {}) {
         quickWins,
         pending: { redirectSuggestions, issueFixes },
         autopilot,
+        geo,
     };
 }
 // ── Email rendering ─────────────────────────────────────────────────────────
@@ -218,6 +275,15 @@ function pct(current, prev) {
     const change = Math.round(((current - prev) / prev) * 100);
     return `${change >= 0 ? '+' : ''}${change}%`;
 }
+/**
+ * Period-over-period delta for the GEO block: `prev === null` means the prior
+ * window is not comparable (rendered as "—"); a zero prior window has no
+ * meaningful percentage and renders nothing.
+ */
+function geoDelta(current, prev) {
+    return prev === null ? '—' : pct(current, prev);
+}
+const plural = (n, one, many = `${one}s`) => (n === 1 ? one : many);
 function fmtDate(iso) {
     return new Date(iso).toISOString().slice(0, 10);
 }
@@ -231,7 +297,7 @@ export function seoAdminUrl() {
     return `${siteUrl.replace(/\/$/, '')}${adminPath}/seo`;
 }
 export function renderSeoDigestEmail(digest, opts) {
-    const { audit, search, newIssues, quickWins, pending, autopilot } = digest;
+    const { audit, search, newIssues, quickWins, pending, autopilot, geo } = digest;
     const alert = audit.stale || audit.lastRunFailed;
     const deltaPart = audit.delta !== null ? ` (${audit.delta >= 0 ? '+' : ''}${audit.delta})` : '';
     const winsPart = `${quickWins.length} quick win${quickWins.length === 1 ? '' : 's'}`;
@@ -261,6 +327,26 @@ export function renderSeoDigestEmail(digest, opts) {
 <p style="margin:0;font-size:14px;color:#374151;">Clicks: <strong>${search.clicks7d}</strong>${clicksPct ? ` (${clicksPct})` : ''} · Impressions: <strong>${search.impressions7d}</strong>${imprPct ? ` (${imprPct})` : ''}</p>`);
         textParts.push(`Search (7d): ${search.clicks7d} clicks${clicksPct ? ` (${clicksPct})` : ''}, ${search.impressions7d} impressions${imprPct ? ` (${imprPct})` : ''}`);
     }
+    if (geo) {
+        const crawlPct = geoDelta(geo.crawlHits7d, geo.crawlHitsPrev7d);
+        const visitsPct = geoDelta(geo.aiVisits7d, geo.aiVisitsPrev7d);
+        const crawlPart = crawlPct ? ` (${crawlPct})` : '';
+        const visitsPart = visitsPct ? ` (${visitsPct})` : '';
+        const botsPart = `${geo.retrievalBots} retrieval ${plural(geo.retrievalBots, 'bot')}`;
+        const hitsUnit = `crawler ${plural(geo.crawlHits7d, 'hit')}`;
+        const visitsUnit = `AI referral ${plural(geo.aiVisits7d, 'visit')}`;
+        // Paths and bot names originate from the public beacon — always escape.
+        const cited = geo.topCited
+            .map((c) => `<li style="margin:0 0 4px;font-size:14px;color:#374151;">${escapeHtml(c.path)} — ${c.visits} ${plural(c.visits, 'visit')}</li>`)
+            .join('');
+        const blockedLine = geo.blockedStillCrawling.length > 0
+            ? `<p style="margin:8px 0 0;font-size:14px;color:#92400e;">Blocked in robots.txt but still crawling: ${escapeHtml(geo.blockedStillCrawling.join(', '))}.</p>`
+            : '';
+        sections.push(`<h3 style="margin:20px 0 8px;font-size:13px;font-weight:600;color:#555;text-transform:uppercase;letter-spacing:0.04em;">AI visibility (7 days)</h3>
+<p style="margin:0;font-size:14px;color:#374151;"><strong>${geo.crawlHits7d}</strong> ${hitsUnit}${crawlPart} · ${botsPart} · <strong>${geo.aiVisits7d}</strong> ${visitsUnit}${visitsPart} (${link('?tab=ai-visibility', 'view trends →')})</p>
+${cited ? `<ul style="margin:8px 0 0;padding-left:20px;">${cited}</ul>` : ''}${blockedLine}`);
+        textParts.push(`AI visibility: ${geo.crawlHits7d} ${hitsUnit}${crawlPart}, ${botsPart}, ${geo.aiVisits7d} ${visitsUnit}${visitsPart}${geo.blockedStillCrawling.length > 0 ? `\nBlocked but still crawling: ${geo.blockedStillCrawling.join(', ')}` : ''}`);
+    }
     if (quickWins.length > 0) {
         const rows = quickWins
             .map((w) => `<li style="margin:0 0 6px;font-size:14px;color:#374151;"><strong>${escapeHtml(w.title)}</strong> — ${escapeHtml(w.explanation)} <span style="color:#9ca3af;">(${escapeHtml(w.impact)} impact)</span></li>`)