@pseolint/core 0.2.1 → 0.3.0

package/dist/rules/aeo/crawler-access.js

@@ -0,0 +1,116 @@
+/**
+ * Default AI crawler user-agents to check. Ordered by prevalence.
+ */
+export const DEFAULT_AI_CRAWLERS = [
+    "GPTBot",
+    "ChatGPT-User",
+    "ClaudeBot",
+    "PerplexityBot",
+    "Bytespider",
+    "Google-Extended",
+    "CCBot",
+    "Applebot-Extended",
+];
+/**
+ * Parse robots.txt into a map of user-agent -> list of Disallow patterns.
+ * User-agent keys are lowercased for case-insensitive lookup.
+ * A blank Disallow value is treated as "allow all" and produces an empty array
+ * (matches the robots spec: "Disallow: " with no value means no restrictions).
+ */
+export function parseRobotsByUserAgent(robotsTxt) {
+    const lines = robotsTxt.split(/\r?\n/);
+    const result = new Map();
+    let currentAgents = [];
+    let expectingRules = false;
+    for (const raw of lines) {
+        const line = raw.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        if (/^user-agent\s*:/i.test(line)) {
+            const ua = line.replace(/^user-agent\s*:\s*/i, "").trim().toLowerCase();
+            if (!expectingRules) {
+                // Stacking consecutive User-agent lines — they all share the next rule block.
+                currentAgents.push(ua);
+            }
+            else {
+                currentAgents = [ua];
+                expectingRules = false;
+            }
+            if (!result.has(ua))
+                result.set(ua, []);
+            continue;
+        }
+        if (/^(allow|disallow|crawl-delay|sitemap)\s*:/i.test(line)) {
+            expectingRules = true;
+        }
+        if (/^disallow\s*:/i.test(line)) {
+            const value = line.replace(/^disallow\s*:\s*/i, "").trim();
+            if (!value)
+                continue;
+            for (const agent of currentAgents) {
+                const bucket = result.get(agent);
+                if (bucket)
+                    bucket.push(value);
+            }
+        }
+    }
+    return result;
+}
+/** True if the Disallow list includes a root block (`/`). */
+export function isFullyDisallowed(patterns) {
+    if (!patterns)
+        return false;
+    return patterns.some((p) => p === "/" || p === "/*");
+}
+/**
+ * Warn per blocked AI crawler; escalate to error when all configured crawlers are blocked.
+ * Wildcard blocks (`User-agent: *` + `Disallow: /`) also count as blocking each named crawler
+ * unless the crawler has its own more-permissive block.
+ */
+export function crawlerAccessRule(robotsTxtContent, options) {
+    if (!robotsTxtContent)
+        return [];
+    const crawlers = options?.crawlers ?? DEFAULT_AI_CRAWLERS;
+    const byAgent = parseRobotsByUserAgent(robotsTxtContent);
+    const wildcardBlocked = isFullyDisallowed(byAgent.get("*"));
+    const blocked = [];
+    for (const crawler of crawlers) {
+        const key = crawler.toLowerCase();
+        const ownBlock = byAgent.get(key);
+        if (ownBlock === undefined) {
+            // No explicit block for this agent — it falls back to the wildcard block.
+            if (wildcardBlocked)
+                blocked.push(crawler);
+            continue;
+        }
+        if (isFullyDisallowed(ownBlock))
+            blocked.push(crawler);
+    }
+    if (blocked.length === 0)
+        return [];
+    const findings = [];
+    const allBlocked = blocked.length === crawlers.length;
+    if (allBlocked) {
+        findings.push({
+            ruleId: "aeo/crawler-access",
+            severity: "error",
+            message: `robots.txt blocks all ${crawlers.length} configured AI crawlers: ${blocked.join(", ")}.`,
+            fix: `Blocking every AI crawler makes your pages invisible to answer engines. ` +
+                `Sites uncited in AI Overviews lose ~68% of traffic vs ~12% for cited sites. ` +
+                `Remove the Disallow rules for these crawlers unless you have a specific legal or competitive reason to block them.`,
+        });
+        return findings;
+    }
+    for (const crawler of blocked) {
+        findings.push({
+            ruleId: "aeo/crawler-access",
+            severity: "warning",
+            message: `robots.txt blocks ${crawler}.`,
+            fix: `Remove the "Disallow: /" directive for User-agent: ${crawler} in your robots.txt. ` +
+                `Blocking ${crawler} removes your pages from its answer engine's citation pool. ` +
+                `If selective blocking is intentional (e.g. admin routes only), narrow the Disallow pattern instead of blocking the whole site.`,
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=crawler-access.js.map

package/dist/rules/aeo/crawler-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawler-access.js","sourceRoot":"","sources":["../../../src/rules/aeo/crawler-access.ts"],"names":[],"mappings":"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"}

package/dist/rules/aeo/faq-coverage.d.ts

@@ -0,0 +1,9 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+export interface FaqCoverageOptions {
+    /** URL substring/glob fragments that signal question intent. */
+    questionPatterns?: string[];
+    /** Minimum number of question-style headings to trigger the check (default: 2). */
+    minQuestionHeadings?: number;
+}
+export declare function faqCoverageRule(pages: ParsedPage[], options?: FaqCoverageOptions): RuleResult[];
+//# sourceMappingURL=faq-coverage.d.ts.map

package/dist/rules/aeo/faq-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faq-coverage.d.ts","sourceRoot":"","sources":["../../../src/rules/aeo/faq-coverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,mFAAmF;IACnF,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AA6CD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,EAAE,CA8Bd"}

package/dist/rules/aeo/faq-coverage.js

@@ -0,0 +1,71 @@
+const DEFAULT_URL_PATTERNS = ["/how-to-", "/what-is-", "/guide-", "-faq", "/faq", "/questions"];
+const QUESTION_STARTERS = /^\s*(how|what|why|when|where|who|can|does|do|is|are|should|which|will|could|would|may)\b/i;
+function isQuestionHeading(heading) {
+    const trimmed = heading.trim();
+    if (!trimmed)
+        return false;
+    return trimmed.endsWith("?") || QUESTION_STARTERS.test(trimmed);
+}
+function hasFaqLikeSchema(entries) {
+    const stack = [...entries];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (node === null || typeof node !== "object")
+            continue;
+        const obj = node;
+        const type = obj["@type"];
+        if (type === "FAQPage" || type === "HowTo" || type === "QAPage")
+            return true;
+        if (Array.isArray(type) && type.some((t) => t === "FAQPage" || t === "HowTo" || t === "QAPage")) {
+            return true;
+        }
+        for (const value of Object.values(obj)) {
+            if (Array.isArray(value)) {
+                for (const item of value)
+                    stack.push(item);
+            }
+            else if (value !== null && typeof value === "object") {
+                stack.push(value);
+            }
+        }
+    }
+    return false;
+}
+function urlLooksLikeFaq(url, patterns) {
+    try {
+        const path = new URL(url).pathname.toLowerCase();
+        return patterns.some((p) => path.includes(p));
+    }
+    catch {
+        const lower = url.toLowerCase();
+        return patterns.some((p) => lower.includes(p));
+    }
+}
+export function faqCoverageRule(pages, options) {
+    const patterns = options?.questionPatterns ?? DEFAULT_URL_PATTERNS;
+    const minQuestions = options?.minQuestionHeadings ?? 2;
+    const findings = [];
+    for (const page of pages) {
+        const questionHeadings = page.headings.h2.filter(isQuestionHeading);
+        const urlSignalsFaq = urlLooksLikeFaq(page.url, patterns);
+        if (!urlSignalsFaq && questionHeadings.length < minQuestions)
+            continue;
+        if (hasFaqLikeSchema(page.jsonLd))
+            continue;
+        const sampleList = questionHeadings.slice(0, 3).map((h) => `"${h.trim()}"`).join(", ");
+        const detail = questionHeadings.length > 0
+            ? `${questionHeadings.length} question-style heading${questionHeadings.length === 1 ? "" : "s"}${sampleList ? ` (e.g. ${sampleList})` : ""}`
+            : `URL path matches an FAQ pattern`;
+        findings.push({
+            ruleId: "aeo/faq-coverage",
+            severity: "info",
+            message: `${page.url} contains FAQ-style content (${detail}) but no FAQPage/HowTo JSON-LD.`,
+            pageUrl: page.url,
+            fix: `Add FAQPage JSON-LD that mirrors the existing Q&A content. For pSEO templates, generate the ` +
+                `schema programmatically from the same data source that renders the headings — don't ship identical ` +
+                `questions with only the entity name swapped.`,
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=faq-coverage.js.map

package/dist/rules/aeo/faq-coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faq-coverage.js","sourceRoot":"","sources":["../../../src/rules/aeo/faq-coverage.ts"],"names":[],"mappings":"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"}

package/dist/rules/aeo/freshness-signals.d.ts

@@ -0,0 +1,9 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+export interface FreshnessOptions {
+    /** Flag pages with dateModified older than this many days. Default: 180. */
+    maxStaleDays?: number;
+    /** Clock override for deterministic testing. Default: Date.now(). */
+    now?: () => number;
+}
+export declare function freshnessSignalsRule(pages: ParsedPage[], options?: FreshnessOptions): RuleResult[];
+//# sourceMappingURL=freshness-signals.d.ts.map

package/dist/rules/aeo/freshness-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness-signals.d.ts","sourceRoot":"","sources":["../../../src/rules/aeo/freshness-signals.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAkED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,CAAC,EAAE,gBAAgB,GACzB,UAAU,EAAE,CAsDd"}

package/dist/rules/aeo/freshness-signals.js

@@ -0,0 +1,109 @@
+import { load } from "cheerio";
+const DAY_MS = 86_400_000;
+/**
+ * Find dateModified-specific signals in JSON-LD (recursive). Keeps `dateModified` and
+ * `datePublished` separate so callers can require a true modification signal rather than
+ * accept "published once in 2020" as evidence of freshness.
+ */
+function findDatesInJsonLd(entries) {
+    let modified = null;
+    let published = null;
+    const stack = [...entries];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (node === null || typeof node !== "object")
+            continue;
+        const obj = node;
+        const m = obj["dateModified"];
+        if (!modified && typeof m === "string" && m.length > 0)
+            modified = m;
+        const p = obj["datePublished"] ?? obj["dateCreated"];
+        if (!published && typeof p === "string" && p.length > 0)
+            published = p;
+        for (const value of Object.values(obj)) {
+            if (Array.isArray(value)) {
+                for (const item of value)
+                    stack.push(item);
+            }
+            else if (value !== null && typeof value === "object") {
+                stack.push(value);
+            }
+        }
+    }
+    return { modified, published };
+}
+/**
+ * Find modification-specific meta tags and <time> elements. Uses cheerio so attribute
+ * order does not matter (<meta content="..." property="...">` and `<meta property="..."
+ * content="...">` both work).
+ */
+function findDateModifiedInHtml(html) {
+    const $ = load(html);
+    const candidates = [
+        $('meta[property="article:modified_time"]').attr("content"),
+        $('meta[name="last-modified"]').attr("content"),
+        $('meta[name="dc.date.modified"]').attr("content"),
+        $("time[datetime]").attr("datetime"),
+    ];
+    for (const value of candidates) {
+        if (typeof value === "string" && value.length > 0)
+            return value;
+    }
+    return null;
+}
+function hasVisibleUpdateSignal(contentText) {
+    return /\b(last\s+updated|updated\s+on|revised|last\s+modified)\b/i.test(contentText);
+}
+function parseDateSafe(value) {
+    if (!value)
+        return null;
+    const t = Date.parse(value);
+    return Number.isFinite(t) ? new Date(t) : null;
+}
+export function freshnessSignalsRule(pages, options) {
+    const maxStaleDays = options?.maxStaleDays ?? 180;
+    const now = options?.now ? options.now() : Date.now();
+    const findings = [];
+    for (const page of pages) {
+        const { modified: jsonLdModified, published: jsonLdPublished } = findDatesInJsonLd(page.jsonLd);
+        const htmlModified = findDateModifiedInHtml(page.html);
+        const visibleSignal = hasVisibleUpdateSignal(page.contentText);
+        // A true modification signal is `dateModified`, a modification meta tag, or visible
+        // "Last updated" text. `datePublished` alone (a page born in 2019 and never touched)
+        // is NOT a modification signal — fall through to the no-signal warning.
+        const hasModificationSignal = Boolean(jsonLdModified || htmlModified || visibleSignal);
+        if (!hasModificationSignal) {
+            findings.push({
+                ruleId: "aeo/freshness-signals",
+                severity: "warning",
+                message: `${page.url} has no dateModified signal (no JSON-LD dateModified, no modification meta tag, no visible "Last updated").`,
+                pageUrl: page.url,
+                fix: `Add a freshness signal so AI engines know the page is current. Three recommended places: ` +
+                    `(1) dateModified in your JSON-LD schema, ` +
+                    `(2) a visible "Last updated: YYYY-MM-DD" line in the page content, ` +
+                    `(3) accurate <lastmod> in your sitemap. ` +
+                    `For pSEO templates, automate dateModified to update when your underlying data source changes.`,
+            });
+            continue;
+        }
+        const best = parseDateSafe(jsonLdModified) ??
+            parseDateSafe(htmlModified) ??
+            parseDateSafe(jsonLdPublished) ??
+            parseDateSafe(page.publishedDate);
+        if (best) {
+            const ageDays = Math.floor((now - best.getTime()) / DAY_MS);
+            if (ageDays > maxStaleDays) {
+                findings.push({
+                    ruleId: "aeo/freshness-signals",
+                    severity: "info",
+                    message: `${page.url} was last updated ${ageDays} days ago (threshold: ${maxStaleDays}).`,
+                    pageUrl: page.url,
+                    fix: `AI engines prioritize fresh content for citation. If the page is still accurate, ` +
+                        `refresh the visible date and bump dateModified. If information has changed, update the body accordingly.`,
+                });
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=freshness-signals.js.map

package/dist/rules/aeo/freshness-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness-signals.js","sourceRoot":"","sources":["../../../src/rules/aeo/freshness-signals.ts"],"names":[],"mappings":"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"}

package/dist/rules/aeo/llms-txt.d.ts

@@ -0,0 +1,24 @@
+import type { RuleResult } from "../../types.js";
+export interface LlmsTxtFetcher {
+    (url: string): Promise<string | null>;
+}
+/**
+ * Minimal shape check for the emerging llms.txt convention:
+ *   - First non-empty line is an `# H1` title
+ *   - At least one `## ` section heading
+ *   - At least one markdown link line under a section
+ * Deliberately lenient: the spec is still evolving, so only reject obvious garbage.
+ */
+export declare function validateLlmsTxt(content: string): {
+    valid: boolean;
+    reason?: string;
+};
+/**
+ * Check for /llms.txt at the origin. Site-level rule — runs once, not per page.
+ */
+export interface LlmsTxtRuleOptions {
+    /** Timeout in ms for the /llms.txt fetch. Default: 10 000. */
+    timeoutMs?: number;
+}
+export declare function llmsTxtRule(source: string, fetcherOrOptions?: LlmsTxtFetcher | LlmsTxtRuleOptions): Promise<RuleResult[]>;
+//# sourceMappingURL=llms-txt.d.ts.map

package/dist/rules/aeo/llms-txt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt.d.ts","sourceRoot":"","sources":["../../../src/rules/aeo/llms-txt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACvC;AAkBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAgCpF;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,gBAAgB,GAAE,cAAc,GAAG,kBAAuB,GACzD,OAAO,CAAC,UAAU,EAAE,CAAC,CAqCvB"}

package/dist/rules/aeo/llms-txt.js

@@ -0,0 +1,93 @@
+const DEFAULT_TIMEOUT_MS = 10_000;
+async function defaultFetch(url, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        if (!response.ok)
+            return null;
+        return await response.text();
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Minimal shape check for the emerging llms.txt convention:
+ *   - First non-empty line is an `# H1` title
+ *   - At least one `## ` section heading
+ *   - At least one markdown link line under a section
+ * Deliberately lenient: the spec is still evolving, so only reject obvious garbage.
+ */
+export function validateLlmsTxt(content) {
+    const lines = content.split(/\r?\n/);
+    let sawTitle = false;
+    let sawSection = false;
+    let sawLink = false;
+    for (const raw of lines) {
+        const line = raw.trim();
+        if (!line)
+            continue;
+        if (!sawTitle) {
+            if (/^#\s+\S/.test(line)) {
+                sawTitle = true;
+            }
+            else if (line.startsWith("#")) {
+                continue;
+            }
+            else {
+                return { valid: false, reason: "file does not start with an `# ` H1 title" };
+            }
+            continue;
+        }
+        if (/^##\s+\S/.test(line)) {
+            sawSection = true;
+            continue;
+        }
+        if (/^-\s*\[[^\]]+\]\([^)]+\)/.test(line)) {
+            sawLink = true;
+        }
+    }
+    if (!sawTitle)
+        return { valid: false, reason: "missing `# ` H1 title" };
+    if (!sawSection)
+        return { valid: false, reason: "no `## ` section headings found" };
+    if (!sawLink)
+        return { valid: false, reason: "no markdown link entries found under any section" };
+    return { valid: true };
+}
+export async function llmsTxtRule(source, fetcherOrOptions = {}) {
+    if (!/^https?:\/\//i.test(source))
+        return [];
+    const origin = new URL(source).origin;
+    const llmsUrl = `${origin}/llms.txt`;
+    const fetcher = typeof fetcherOrOptions === "function"
+        ? fetcherOrOptions
+        : (url) => defaultFetch(url, fetcherOrOptions.timeoutMs);
+    const text = await fetcher(llmsUrl);
+    if (text === null) {
+        return [{
+                ruleId: "aeo/llms-txt",
+                severity: "warning",
+                message: `No llms.txt found at ${llmsUrl}.`,
+                fix: `Create ${llmsUrl} to guide AI engines toward your most authoritative, citable content. ` +
+                    `Start with an # H1 title, a blockquote summary, then ## sections listing your key pages as markdown links. ` +
+                    `See https://llmstxt.org for the emerging convention.`,
+            }];
+    }
+    const check = validateLlmsTxt(text);
+    if (!check.valid) {
+        return [{
+                ruleId: "aeo/llms-txt",
+                severity: "warning",
+                message: `${llmsUrl} exists but is malformed: ${check.reason}.`,
+                fix: `Ensure ${llmsUrl} opens with an "# Site Name" H1, has at least one "## Section" heading, ` +
+                    `and lists pages as "- [Title](https://...): short description". See https://llmstxt.org.`,
+            }];
+    }
+    return [];
+}
+//# sourceMappingURL=llms-txt.js.map

package/dist/rules/aeo/llms-txt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt.js","sourceRoot":"","sources":["../../../src/rules/aeo/llms-txt.ts"],"names":[],"mappings":"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"}

package/dist/rules/aeo/non-replicable-value.d.ts

@@ -0,0 +1,9 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+export interface NonReplicableValueOptions {
+    /** Extra selectors that count as interactive/non-replicable. */
+    interactiveSelectors?: string[];
+    /** Severity override. Default: "warning". */
+    severity?: "info" | "warning" | "error";
+}
+export declare function nonReplicableValueRule(pages: ParsedPage[], options?: NonReplicableValueOptions): RuleResult[];
+//# sourceMappingURL=non-replicable-value.d.ts.map

package/dist/rules/aeo/non-replicable-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"non-replicable-value.d.ts","sourceRoot":"","sources":["../../../src/rules/aeo/non-replicable-value.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,WAAW,yBAAyB;IACxC,gEAAgE;IAChE,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;CACzC;AAqED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,EAAE,CA+Bd"}

package/dist/rules/aeo/non-replicable-value.js

@@ -0,0 +1,95 @@
+import { load } from "cheerio";
+const DEFAULT_INTERACTIVE_SELECTORS = [
+    "form",
+    "input:not([type=hidden])",
+    "select",
+    "textarea",
+    "iframe",
+    "button[type=submit]",
+    "canvas",
+    "[data-interactive]",
+    "[data-calculator]",
+    "[data-tool]",
+    "[data-widget]",
+    "[x-data]",
+    ".calculator",
+    ".tool",
+    ".checker",
+    ".generator",
+    ".interactive",
+    ".widget",
+    ".comparator",
+];
+const DOWNLOAD_PATTERN = /\.(pdf|docx?|xlsx?|csv|zip|pptx?)(?:$|[?#])/i;
+const GATED_PATTERNS = [
+    /\bsign\s*(in|up)\s+to\s+(read|access|view|download|continue)/i,
+    /\bpaywall\b/i,
+    /\bsubscribe\s+to\s+read\b/i,
+    /\blog\s*in\s+to\s+(read|access|view|download|continue)/i,
+];
+function hasInteractiveElement($, html, extraSelectors) {
+    const selectors = [...DEFAULT_INTERACTIVE_SELECTORS, ...extraSelectors];
+    for (const sel of selectors) {
+        try {
+            if ($(sel).length > 0)
+                return true;
+        }
+        catch {
+            // invalid selector — skip
+        }
+    }
+    // Framework-generated component markers use hashed attribute names; scan raw HTML for common patterns.
+    if (/\bdata-(reactroot|react-[\w-]+|vue-[\w-]+|v-[\w-]+|svelte-[\w-]+)\b/i.test(html))
+        return true;
+    return false;
+}
+function hasDownloadableAsset($) {
+    let found = false;
+    $("a[href]").each((_, el) => {
+        if (found)
+            return false;
+        const href = $(el).attr("href") ?? "";
+        if (DOWNLOAD_PATTERN.test(href) || /[?&]format=(pdf|docx?|xlsx?|csv)\b/i.test(href)) {
+            found = true;
+            return false;
+        }
+        if ($(el).attr("download") !== undefined) {
+            found = true;
+            return false;
+        }
+        return undefined;
+    });
+    return found;
+}
+function hasGatedContent(text) {
+    return GATED_PATTERNS.some((re) => re.test(text));
+}
+export function nonReplicableValueRule(pages, options) {
+    const extra = options?.interactiveSelectors ?? [];
+    const severity = options?.severity ?? "warning";
+    const findings = [];
+    for (const page of pages) {
+        const $ = load(page.html);
+        const interactive = hasInteractiveElement($, page.html, extra);
+        const downloadable = hasDownloadableAsset($);
+        const gated = hasGatedContent(page.contentText);
+        if (interactive || downloadable || gated)
+            continue;
+        findings.push({
+            ruleId: "aeo/non-replicable-value",
+            severity,
+            message: `${page.url} contains only text AI can fully summarize — no interactive element, downloadable asset, or gated content detected.`,
+            pageUrl: page.url,
+            fix: `Add a non-replicable value so users have a reason to click through instead of accepting the AI summary. Options: ` +
+                `(1) an interactive tool specific to this page's topic (calculator, checker, comparator, generator), ` +
+                `(2) an interactive checklist users can complete, ` +
+                `(3) a downloadable asset (PDF, spreadsheet, dataset) visible above the fold, ` +
+                `(4) a live preview / try-it-yourself widget, ` +
+                `(5) a gated resource (account required). ` +
+                `For single-page apps, ensure interactive elements are present in the server-rendered HTML ` +
+                `so crawlers see them — client-only widgets are invisible to this audit AND to most AI crawlers.`,
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=non-replicable-value.js.map

package/dist/rules/aeo/non-replicable-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"non-replicable-value.js","sourceRoot":"","sources":["../../../src/rules/aeo/non-replicable-value.ts"],"names":[],"mappings":"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"}

package/dist/rules/scope.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Declarative scope for each rule ID.
+ * - "page": output depends only on a single parsed page.
+ * - "corpus": output requires the full set of pages (clustering, cross-page comparisons).
+ *
+ * Diff-audit dispatch reads this map and skips corpus rules when `state.since` is set.
+ */
+export type RuleScope = "page" | "corpus";
+export declare const RULE_SCOPE: Record<string, RuleScope>;
+/** Returns true when the rule may run in diff (page-scoped) mode. Unknown ids default to corpus (safer). */
+export declare function isRuleAllowedInDiff(ruleId: string): boolean;
+//# sourceMappingURL=scope.d.ts.map

package/dist/rules/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/rules/scope.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1C,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAoEhD,CAAC;AAEF,4GAA4G;AAC5G,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D"}