@pseolint/core 0.1.0

package/dist/rules/links/hub-pages.js

@@ -0,0 +1,73 @@
+import { clusterKeyForUrl } from "./cluster-key.js";
+const INDEX_NAMES = ["index.html", "index.htm"];
+function indexUrlsForCluster(clusterDir, pageUrl) {
+    if (/^https?:\/\//i.test(pageUrl)) {
+        try {
+            const base = new URL(clusterDir);
+            return INDEX_NAMES.map((name) => new URL(name, base).href);
+        }
+        catch {
+            return [];
+        }
+    }
+    const sep = pageUrl.includes("\\") ? "\\" : "/";
+    const d = clusterDir.replace(/[/\\]+$/, "");
+    return INDEX_NAMES.map((n) => `${d}${sep}${n}`);
+}
+/**
+ * Hub/index coverage for medium-sized directories, plus info when a cluster is skipped
+ * because it exceeds `maxSiblings`.
+ */
+export function hubPagesRule(pages, knownUrls, minSiblings, maxSiblings) {
+    if (pages.length === 0) {
+        return [];
+    }
+    const byCluster = new Map();
+    for (const p of pages) {
+        const key = clusterKeyForUrl(p.url);
+        const list = byCluster.get(key) ?? [];
+        list.push(p);
+        byCluster.set(key, list);
+    }
+    const findings = [];
+    for (const [clusterDir, group] of byCluster.entries()) {
+        if (group.length < minSiblings) {
+            continue;
+        }
+        if (group.length > maxSiblings) {
+            findings.push({
+                ruleId: "links/hub-pages-skipped",
+                severity: "info",
+                message: `Hub/index check skipped for cluster ${clusterDir} (${group.length} pages > max ${maxSiblings}).`,
+                relatedUrls: group.map((p) => p.url).sort(),
+                fix: "Create an index or hub page for this directory that links to all child pages."
+            });
+            continue;
+        }
+        const siblingUrls = new Set(group.map((p) => p.url));
+        const indexCandidates = indexUrlsForCluster(clusterDir, group[0].url);
+        const hasIndex = indexCandidates.some((u) => knownUrls.has(u));
+        const linksToAllSiblings = (page) => {
+            const linked = new Set(page.resolvedHrefs.filter((u) => knownUrls.has(u) && siblingUrls.has(u)));
+            linked.add(page.url);
+            for (const s of siblingUrls) {
+                if (!linked.has(s)) {
+                    return false;
+                }
+            }
+            return true;
+        };
+        const hasHub = hasIndex || group.some((p) => linksToAllSiblings(p));
+        if (!hasHub) {
+            findings.push({
+                ruleId: "links/hub-pages",
+                severity: "warning",
+                message: `No hub/index page detected for cluster ${clusterDir} (${group.length} pages).`,
+                relatedUrls: Array.from(siblingUrls).sort(),
+                fix: "Create an index or hub page for this directory that links to all child pages."
+            });
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=hub-pages.js.map

package/dist/rules/links/hub-pages.js.map

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

package/dist/rules/links/link-depth.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+export declare function linkDepthRule(pages: ParsedPage[], adjacency: Map<string, Set<string>>, rootUrl: string, maxDepth: number, inbound: Map<string, number>): RuleResult[];
+//# sourceMappingURL=link-depth.d.ts.map

package/dist/rules/links/link-depth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-depth.d.ts","sourceRoot":"","sources":["../../../src/rules/links/link-depth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,UAAU,EAAE,CAgDd"}

package/dist/rules/links/link-depth.js

@@ -0,0 +1,46 @@
+export function linkDepthRule(pages, adjacency, rootUrl, maxDepth, inbound) {
+    const queue = [{ url: rootUrl, depth: 0 }];
+    const visited = new Map([[rootUrl, 0]]);
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (!current) {
+            continue;
+        }
+        const neighbors = adjacency.get(current.url) ?? new Set();
+        for (const next of neighbors) {
+            const existing = visited.get(next);
+            const candidate = current.depth + 1;
+            if (existing !== undefined && existing <= candidate) {
+                continue;
+            }
+            visited.set(next, candidate);
+            queue.push({ url: next, depth: candidate });
+        }
+    }
+    const unreachable = pages
+        .filter((page) => page.url !== rootUrl)
+        .filter((page) => (inbound.get(page.url) ?? 0) > 0)
+        .filter((page) => visited.get(page.url) === undefined)
+        .map((page) => ({
+        ruleId: "links/unreachable-from-root",
+        severity: "warning",
+        message: `${page.url} is not reachable from the crawl root via internal links (but has inbound links).`,
+        pageUrl: page.url,
+        fix: "This page is unreachable from the site root. Add a navigation path to it."
+    }));
+    const deep = pages
+        .filter((page) => page.url !== rootUrl)
+        .filter((page) => {
+        const d = visited.get(page.url);
+        return d !== undefined && d > maxDepth;
+    })
+        .map((page) => ({
+        ruleId: "links/link-depth",
+        severity: "info",
+        message: `${page.url} is deeper than ${maxDepth} clicks from root.`,
+        pageUrl: page.url,
+        fix: "Reduce click depth by linking from a higher-level page."
+    }));
+    return [...unreachable, ...deep];
+}
+//# sourceMappingURL=link-depth.js.map

package/dist/rules/links/link-depth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-depth.js","sourceRoot":"","sources":["../../../src/rules/links/link-depth.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAC3B,KAAmB,EACnB,SAAmC,EACnC,OAAe,EACf,QAAgB,EAChB,OAA4B;IAE5B,MAAM,KAAK,GAA0C,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAClF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAiB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAExD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;QAClE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;YACpC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACpD,SAAS;YACX,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,KAAK;SACtB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC;SACtC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;SAClD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;SACrD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,MAAM,EAAE,6BAAsC;QAC9C,QAAQ,EAAE,SAAkB;QAC5B,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,mFAAmF;QACvG,OAAO,EAAE,IAAI,CAAC,GAAG;QACjB,GAAG,EAAE,2EAA2E;KACjF,CAAC,CAAC,CAAC;IAEN,MAAM,IAAI,GAAG,KAAK;SACf,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC;SACtC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACf,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,GAAG,QAAQ,CAAC;IACzC,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,MAAM,EAAE,kBAAkB;QAC1B,QAAQ,EAAE,MAAe;QACzB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,mBAAmB,QAAQ,oBAAoB;QACnE,OAAO,EAAE,IAAI,CAAC,GAAG;QACjB,GAAG,EAAE,yDAAyD;KAC/D,CAAC,CAAC,CAAC;IAEN,OAAO,CAAC,GAAG,WAAW,EAAE,GAAG,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/rules/links/orphan-pages.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+export declare function orphanPagesRule(pages: ParsedPage[], inboundLinks: Map<string, number>, rootUrl?: string): RuleResult[];
+//# sourceMappingURL=orphan-pages.d.ts.map

package/dist/rules/links/orphan-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-pages.d.ts","sourceRoot":"","sources":["../../../src/rules/links/orphan-pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EAAE,EACnB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,OAAO,CAAC,EAAE,MAAM,GACf,UAAU,EAAE,CAmBd"}

package/dist/rules/links/orphan-pages.js

@@ -0,0 +1,19 @@
+export function orphanPagesRule(pages, inboundLinks, rootUrl) {
+    const findings = [];
+    for (const page of pages) {
+        if (rootUrl && page.url === rootUrl) {
+            continue;
+        }
+        if ((inboundLinks.get(page.url) ?? 0) === 0) {
+            findings.push({
+                ruleId: "links/orphan-pages",
+                severity: "error",
+                message: `${page.url} has no inbound links from other pages in this crawl.`,
+                pageUrl: page.url,
+                fix: "Link to this page from a relevant hub or index page, and include it in your site navigation."
+            });
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=orphan-pages.js.map

package/dist/rules/links/orphan-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-pages.js","sourceRoot":"","sources":["../../../src/rules/links/orphan-pages.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAC7B,KAAmB,EACnB,YAAiC,EACjC,OAAgB;IAEhB,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,IAAI,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;YACpC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,oBAAoB;gBAC5B,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,uDAAuD;gBAC3E,OAAO,EAAE,IAAI,CAAC,GAAG;gBACjB,GAAG,EAAE,8FAA8F;aACpG,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/schema/consistency.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+export declare function schemaConsistencyRule(pages: ParsedPage[]): RuleResult[];
+//# sourceMappingURL=consistency.d.ts.map

package/dist/rules/schema/consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consistency.d.ts","sourceRoot":"","sources":["../../../src/rules/schema/consistency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAiDvE"}

package/dist/rules/schema/consistency.js

@@ -0,0 +1,44 @@
+export function schemaConsistencyRule(pages) {
+    const findings = [];
+    const typesByPage = new Map();
+    for (const page of pages) {
+        const types = new Set();
+        for (const entry of page.jsonLd) {
+            if (typeof entry !== "object" || entry === null) {
+                continue;
+            }
+            const obj = entry;
+            if ("__parseError" in obj && obj.__parseError === true) {
+                continue;
+            }
+            if (typeof obj["@type"] === "string" && obj["@type"].trim() !== "") {
+                types.add(obj["@type"]);
+            }
+        }
+        if (types.size > 0) {
+            typesByPage.set(page.url, types);
+        }
+    }
+    if (typesByPage.size < 2) {
+        return findings;
+    }
+    const allTypes = new Set();
+    for (const types of typesByPage.values()) {
+        for (const t of types) {
+            allTypes.add(t);
+        }
+    }
+    if (allTypes.size <= 1) {
+        return findings;
+    }
+    const typeList = Array.from(allTypes).sort().join(", ");
+    findings.push({
+        ruleId: "schema/consistency",
+        severity: "info",
+        message: `Pages use mixed schema types (${typeList}). Consider using a consistent @type across template pages.`,
+        relatedUrls: Array.from(typesByPage.keys()),
+        fix: `Use a consistent @type across all template pages, or separate pages into groups with different schema types.`
+    });
+    return findings;
+}
+//# sourceMappingURL=consistency.js.map

package/dist/rules/schema/consistency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consistency.js","sourceRoot":"","sources":["../../../src/rules/schema/consistency.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,KAAmB;IACvD,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,SAAS;YACX,CAAC;YACD,MAAM,GAAG,GAAG,KAAgC,CAAC;YAC7C,IAAI,cAAc,IAAI,GAAG,IAAI,GAAG,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;gBACvD,SAAS;YACX,CAAC;YACD,IAAI,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACnE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACnB,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,IAAI,CAAC;QACZ,MAAM,EAAE,oBAAoB;QAC5B,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,iCAAiC,QAAQ,6DAA6D;QAC/G,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAC3C,GAAG,EAAE,8GAA8G;KACpH,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/schema/json-ld-valid.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+export declare function jsonLdValidRule(pages: ParsedPage[]): RuleResult[];
+//# sourceMappingURL=json-ld-valid.d.ts.map

package/dist/rules/schema/json-ld-valid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-ld-valid.d.ts","sourceRoot":"","sources":["../../../src/rules/schema/json-ld-valid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAqDjE"}

package/dist/rules/schema/json-ld-valid.js

@@ -0,0 +1,47 @@
+export function jsonLdValidRule(pages) {
+    const findings = [];
+    for (const page of pages) {
+        for (const entry of page.jsonLd) {
+            if (typeof entry === "object" &&
+                entry !== null &&
+                "__parseError" in entry &&
+                entry.__parseError === true) {
+                findings.push({
+                    ruleId: "schema/json-ld-valid",
+                    severity: "error",
+                    message: `${page.url} contains malformed JSON-LD that could not be parsed.`,
+                    pageUrl: page.url,
+                    fix: `Fix the JSON syntax in the <script type="application/ld+json"> block. Validate it at https://validator.schema.org/.`
+                });
+                continue;
+            }
+            if (typeof entry !== "object" || entry === null) {
+                continue;
+            }
+            const obj = entry;
+            if (!obj["@context"]) {
+                findings.push({
+                    ruleId: "schema/json-ld-valid",
+                    severity: "error",
+                    message: `${page.url} has a JSON-LD block missing the required @context property.`,
+                    pageUrl: page.url,
+                    fix: `Add "@context": "https://schema.org" to the JSON-LD block.`
+                });
+            }
+            if (obj["@type"] !== undefined) {
+                const typeValue = obj["@type"];
+                if (typeof typeValue !== "string" || typeValue.trim() === "") {
+                    findings.push({
+                        ruleId: "schema/json-ld-valid",
+                        severity: "error",
+                        message: `${page.url} has a JSON-LD block with an invalid @type value.`,
+                        pageUrl: page.url,
+                        fix: `Set @type to a valid Schema.org type like "Article", "Product", or "FAQPage".`
+                    });
+                }
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=json-ld-valid.js.map

package/dist/rules/schema/json-ld-valid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-ld-valid.js","sourceRoot":"","sources":["../../../src/rules/schema/json-ld-valid.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,KAAmB;IACjD,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IACE,OAAO,KAAK,KAAK,QAAQ;gBACzB,KAAK,KAAK,IAAI;gBACd,cAAc,IAAI,KAAK;gBACtB,KAAiC,CAAC,YAAY,KAAK,IAAI,EACxD,CAAC;gBACD,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,sBAAsB;oBAC9B,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,uDAAuD;oBAC3E,OAAO,EAAE,IAAI,CAAC,GAAG;oBACjB,GAAG,EAAE,qHAAqH;iBAC3H,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,SAAS;YACX,CAAC;YAED,MAAM,GAAG,GAAG,KAAgC,CAAC;YAE7C,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACrB,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,sBAAsB;oBAC9B,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,8DAA8D;oBAClF,OAAO,EAAE,IAAI,CAAC,GAAG;oBACjB,GAAG,EAAE,4DAA4D;iBAClE,CAAC,CAAC;YACL,CAAC;YAED,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC/B,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBAC7D,QAAQ,CAAC,IAAI,CAAC;wBACZ,MAAM,EAAE,sBAAsB;wBAC9B,QAAQ,EAAE,OAAO;wBACjB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,mDAAmD;wBACvE,OAAO,EAAE,IAAI,CAAC,GAAG;wBACjB,GAAG,EAAE,+EAA+E;qBACrF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/schema/required-fields.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+export declare function requiredFieldsRule(pages: ParsedPage[]): RuleResult[];
+//# sourceMappingURL=required-fields.d.ts.map

package/dist/rules/schema/required-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-fields.d.ts","sourceRoot":"","sources":["../../../src/rules/schema/required-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAqB7D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAoDpE"}

package/dist/rules/schema/required-fields.js

@@ -0,0 +1,60 @@
+const REQUIRED_FIELDS = {
+    Article: ["headline", "author", "datePublished"],
+    Product: ["name"],
+    FAQPage: ["mainEntity"]
+};
+function hasPrice(obj) {
+    if (obj.price !== undefined && obj.price !== null && obj.price !== "") {
+        return true;
+    }
+    if (typeof obj.offers === "object" && obj.offers !== null) {
+        const offers = obj.offers;
+        if (offers.price !== undefined && offers.price !== null && offers.price !== "") {
+            return true;
+        }
+    }
+    return false;
+}
+export function requiredFieldsRule(pages) {
+    const findings = [];
+    for (const page of pages) {
+        for (const entry of page.jsonLd) {
+            if (typeof entry !== "object" || entry === null) {
+                continue;
+            }
+            const obj = entry;
+            if ("__parseError" in obj &&
+                obj.__parseError === true) {
+                continue;
+            }
+            const schemaType = typeof obj["@type"] === "string" ? obj["@type"] : null;
+            if (!schemaType) {
+                continue;
+            }
+            const required = REQUIRED_FIELDS[schemaType];
+            if (!required) {
+                continue;
+            }
+            const missing = [];
+            for (const field of required) {
+                if (obj[field] === undefined || obj[field] === null || obj[field] === "") {
+                    missing.push(field);
+                }
+            }
+            if (schemaType === "Product" && !hasPrice(obj)) {
+                missing.push("price");
+            }
+            if (missing.length > 0) {
+                findings.push({
+                    ruleId: "schema/required-fields",
+                    severity: "warning",
+                    message: `${page.url} has a ${schemaType} schema missing required fields: ${missing.join(", ")}.`,
+                    pageUrl: page.url,
+                    fix: `Add the missing fields to your ${schemaType} schema: ${missing.join(", ")}.`
+                });
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=required-fields.js.map

package/dist/rules/schema/required-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-fields.js","sourceRoot":"","sources":["../../../src/rules/schema/required-fields.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAA6B;IAChD,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,eAAe,CAAC;IAChD,OAAO,EAAE,CAAC,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,YAAY,CAAC;CACxB,CAAC;AAEF,SAAS,QAAQ,CAAC,GAA4B;IAC5C,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,GAAG,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAiC,CAAC;QACrD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;YAC/E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,SAAS;YACX,CAAC;YAED,MAAM,GAAG,GAAG,KAAgC,CAAC;YAE7C,IACE,cAAc,IAAI,GAAG;gBACpB,GAA+B,CAAC,YAAY,KAAK,IAAI,EACtD,CAAC;gBACD,SAAS;YACX,CAAC;YAED,MAAM,UAAU,GAAG,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1E,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;YAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBAC7B,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;oBACzE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;YAED,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/C,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,wBAAwB;oBAChC,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,UAAU,UAAU,oCAAoC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBACjG,OAAO,EAAE,IAAI,CAAC,GAAG;oBACjB,GAAG,EAAE,kCAAkC,UAAU,YAAY,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;iBACnF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/spam/boilerplate-ratio.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+export declare function boilerplateRatioRule(pages: ParsedPage[], maxRatio: number): RuleResult[];
+//# sourceMappingURL=boilerplate-ratio.d.ts.map

package/dist/rules/spam/boilerplate-ratio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boilerplate-ratio.d.ts","sourceRoot":"","sources":["../../../src/rules/spam/boilerplate-ratio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAS7D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAoDxF"}

package/dist/rules/spam/boilerplate-ratio.js

@@ -0,0 +1,50 @@
+function extractTextBlocks(contentText) {
+    return contentText
+        .split(/[.!?]\s+|\n+/)
+        .map((block) => block.trim().toLowerCase())
+        .filter((block) => block.length > 20);
+}
+export function boilerplateRatioRule(pages, maxRatio) {
+    if (pages.length < 2) {
+        return [];
+    }
+    const pageBlocks = pages.map((page) => extractTextBlocks(page.contentText));
+    const blockFrequency = new Map();
+    for (const blocks of pageBlocks) {
+        const unique = new Set(blocks);
+        for (const block of unique) {
+            blockFrequency.set(block, (blockFrequency.get(block) ?? 0) + 1);
+        }
+    }
+    const skeletonCutoff = Math.max(2, Math.floor(pages.length * 0.8) + 1);
+    const skeleton = new Set(Array.from(blockFrequency.entries())
+        .filter(([, count]) => count >= skeletonCutoff)
+        .map(([block]) => block));
+    if (skeleton.size === 0) {
+        return [];
+    }
+    const findings = [];
+    pages.forEach((page, index) => {
+        const blocks = pageBlocks[index];
+        if (blocks.length === 0) {
+            return;
+        }
+        const totalWords = blocks.reduce((sum, b) => sum + b.split(/\s+/).length, 0);
+        const boilerplateWords = blocks
+            .filter((b) => skeleton.has(b))
+            .reduce((sum, b) => sum + b.split(/\s+/).length, 0);
+        if (totalWords === 0)
+            return;
+        const ratio = boilerplateWords / totalWords;
+        if (ratio > maxRatio) {
+            findings.push({
+                ruleId: "spam/boilerplate-ratio",
+                severity: "error",
+                message: `${page.url} has boilerplate ratio ${(ratio * 100).toFixed(1)}% (max ${(maxRatio * 100).toFixed(1)}%).`,
+                fix: `${(ratio * 100).toFixed(1)}% of this page's content is shared template text. Reduce repeated boilerplate sections or add unique content blocks—introductions, case studies, or page-specific data—to bring the ratio below ${(maxRatio * 100).toFixed(1)}%.`
+            });
+        }
+    });
+    return findings;
+}
+//# sourceMappingURL=boilerplate-ratio.js.map

package/dist/rules/spam/boilerplate-ratio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boilerplate-ratio.js","sourceRoot":"","sources":["../../../src/rules/spam/boilerplate-ratio.ts"],"names":[],"mappings":"AAEA,SAAS,iBAAiB,CAAC,WAAmB;IAC5C,OAAO,WAAW;SACf,KAAK,CAAC,cAAc,CAAC;SACrB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;SAC1C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAmB,EAAE,QAAgB;IACxE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAE5E,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;SACjC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,cAAc,CAAC;SAC9C,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAC3B,CAAC;IAEF,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7E,MAAM,gBAAgB,GAAG,MAAM;aAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;aAC9B,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAEtD,IAAI,UAAU,KAAK,CAAC;YAAE,OAAO;QAE7B,MAAM,KAAK,GAAG,gBAAgB,GAAG,UAAU,CAAC;QAC5C,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;YACrB,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,wBAAwB;gBAChC,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,0BAA0B,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;gBAChH,GAAG,EAAE,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,mMAAmM,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;aACnQ,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/spam/doorway-pattern.d.ts

@@ -0,0 +1,4 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+import type { PairMatch } from "./near-duplicate.js";
+export declare function doorwayPatternRule(nearDuplicatePairs: PairMatch[], entitySwapPairs: PairMatch[], thinContentUrls: Set<string>, pages?: ParsedPage[]): RuleResult[];
+//# sourceMappingURL=doorway-pattern.d.ts.map

package/dist/rules/spam/doorway-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doorway-pattern.d.ts","sourceRoot":"","sources":["../../../src/rules/spam/doorway-pattern.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMrD,wBAAgB,kBAAkB,CAChC,kBAAkB,EAAE,SAAS,EAAE,EAC/B,eAAe,EAAE,SAAS,EAAE,EAC5B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,EAC5B,KAAK,CAAC,EAAE,UAAU,EAAE,GACnB,UAAU,EAAE,CAoDd"}

package/dist/rules/spam/doorway-pattern.js

@@ -0,0 +1,47 @@
+function pairKey(left, right) {
+    return left < right ? `${left}\0${right}` : `${right}\0${left}`;
+}
+export function doorwayPatternRule(nearDuplicatePairs, entitySwapPairs, thinContentUrls, pages) {
+    const entitySet = new Set(entitySwapPairs.map((pair) => pairKey(pair.leftUrl, pair.rightUrl)));
+    const findings = [];
+    const pageMap = new Map();
+    if (pages) {
+        for (const p of pages) {
+            pageMap.set(p.url, p);
+        }
+    }
+    for (const pair of nearDuplicatePairs) {
+        const key = pairKey(pair.leftUrl, pair.rightUrl);
+        if (!entitySet.has(key)) {
+            continue;
+        }
+        const left = pair.leftUrl < pair.rightUrl ? pair.leftUrl : pair.rightUrl;
+        const right = pair.leftUrl < pair.rightUrl ? pair.rightUrl : pair.leftUrl;
+        const signals = ["near-duplicate", "entity-swap"];
+        const isThin = thinContentUrls.has(left) || thinContentUrls.has(right);
+        if (isThin) {
+            signals.push("thin-content");
+        }
+        const leftPage = pageMap.get(left);
+        const rightPage = pageMap.get(right);
+        if (leftPage && rightPage && leftPage.structureSignature === rightPage.structureSignature) {
+            signals.push("identical-structure");
+        }
+        if (leftPage && rightPage && leftPage.metaDescription && rightPage.metaDescription &&
+            leftPage.metaDescription === rightPage.metaDescription) {
+            signals.push("identical-meta");
+        }
+        if (signals.length < 3) {
+            continue;
+        }
+        findings.push({
+            ruleId: "spam/doorway-pattern",
+            severity: "critical",
+            message: `${left} and ${right} match doorway-pattern signals (${signals.join(" + ")}).`,
+            relatedUrls: [left, right],
+            fix: "This page matches multiple spam signals. Prioritize adding unique, substantive content and differentiating the page structure."
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=doorway-pattern.js.map

package/dist/rules/spam/doorway-pattern.js.map

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

package/dist/rules/spam/entity-swap.d.ts

@@ -0,0 +1,7 @@
+import type { EntityMaskPattern, ParsedPage, RuleResult } from "../../types.js";
+import type { PairMatch } from "./near-duplicate.js";
+export declare function entitySwapRule(pages: ParsedPage[], patterns: EntityMaskPattern[], threshold: number): {
+    findings: RuleResult[];
+    pairs: PairMatch[];
+};
+//# sourceMappingURL=entity-swap.d.ts.map

package/dist/rules/spam/entity-swap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-swap.d.ts","sourceRoot":"","sources":["../../../src/rules/spam/entity-swap.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EAAE,EACnB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,SAAS,EAAE,MAAM,GAChB;IAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,CAwBhD"}

package/dist/rules/spam/entity-swap.js

@@ -0,0 +1,26 @@
+import { maskEntities } from "../../algorithms/entity-mask.js";
+import { hammingDistance, simHashFromText, similarityFromDistance } from "../../algorithms/simhash.js";
+export function entitySwapRule(pages, patterns, threshold) {
+    const findings = [];
+    const pairs = [];
+    const hashes = pages.map((page) => simHashFromText(maskEntities(page.contentText, patterns)));
+    for (let i = 0; i < pages.length; i += 1) {
+        for (let j = i + 1; j < pages.length; j += 1) {
+            const similarity = similarityFromDistance(hammingDistance(hashes[i], hashes[j]));
+            if (similarity >= threshold) {
+                pairs.push({ leftUrl: pages[i].url, rightUrl: pages[j].url, similarity });
+                findings.push({
+                    ruleId: "spam/entity-swap",
+                    severity: "critical",
+                    message: `${pages[i].url} and ${pages[j].url} look structurally identical after entity masking.`,
+                    pageUrl: pages[i].url,
+                    relatedUrls: [pages[j].url],
+                    similarity,
+                    fix: "These pages are identical after masking entity names. Add entity-specific content: local regulations, statistics, fees, or requirements unique to each entity."
+                });
+            }
+        }
+    }
+    return { findings, pairs };
+}
+//# sourceMappingURL=entity-swap.js.map

package/dist/rules/spam/entity-swap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-swap.js","sourceRoot":"","sources":["../../../src/rules/spam/entity-swap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIvG,MAAM,UAAU,cAAc,CAC5B,KAAmB,EACnB,QAA6B,EAC7B,SAAiB;IAEjB,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE9F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,UAAU,GAAG,sBAAsB,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACjF,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC1E,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,kBAAkB;oBAC1B,QAAQ,EAAE,UAAU;oBACpB,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,oDAAoD;oBAChG,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG;oBACrB,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;oBAC3B,UAAU;oBACV,GAAG,EAAE,gKAAgK;iBACtK,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/dist/rules/spam/near-duplicate.d.ts

@@ -0,0 +1,11 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+export interface PairMatch {
+    leftUrl: string;
+    rightUrl: string;
+    similarity: number;
+}
+export declare function nearDuplicateRule(pages: ParsedPage[], threshold: number): {
+    findings: RuleResult[];
+    pairs: PairMatch[];
+};
+//# sourceMappingURL=near-duplicate.d.ts.map

package/dist/rules/spam/near-duplicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"near-duplicate.d.ts","sourceRoot":"","sources":["../../../src/rules/spam/near-duplicate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,MAAM,GAChB;IAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,CAwBhD"}

package/dist/rules/spam/near-duplicate.js

@@ -0,0 +1,25 @@
+import { hammingDistance, simHashFromText, similarityFromDistance } from "../../algorithms/simhash.js";
+export function nearDuplicateRule(pages, threshold) {
+    const findings = [];
+    const pairs = [];
+    const hashes = pages.map((page) => simHashFromText(page.contentText));
+    for (let i = 0; i < pages.length; i += 1) {
+        for (let j = i + 1; j < pages.length; j += 1) {
+            const similarity = similarityFromDistance(hammingDistance(hashes[i], hashes[j]));
+            if (similarity >= threshold) {
+                pairs.push({ leftUrl: pages[i].url, rightUrl: pages[j].url, similarity });
+                findings.push({
+                    ruleId: "spam/near-duplicate",
+                    severity: "critical",
+                    message: `${pages[i].url} and ${pages[j].url} are near-duplicates (${(similarity * 100).toFixed(1)}% similar).`,
+                    pageUrl: pages[i].url,
+                    relatedUrls: [pages[j].url],
+                    similarity,
+                    fix: "Differentiate these pages with unique content. Add page-specific details, data, examples, or analysis that the other page doesn't have."
+                });
+            }
+        }
+    }
+    return { findings, pairs };
+}
+//# sourceMappingURL=near-duplicate.js.map

package/dist/rules/spam/near-duplicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"near-duplicate.js","sourceRoot":"","sources":["../../../src/rules/spam/near-duplicate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AASvG,MAAM,UAAU,iBAAiB,CAC/B,KAAmB,EACnB,SAAiB;IAEjB,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAEtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,UAAU,GAAG,sBAAsB,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACjF,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC1E,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,qBAAqB;oBAC7B,QAAQ,EAAE,UAAU;oBACpB,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,yBAAyB,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa;oBAC/G,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG;oBACrB,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;oBAC3B,UAAU;oBACV,GAAG,EAAE,yIAAyI;iBAC/I,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/dist/rules/spam/publication-velocity.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+export declare function publicationVelocityRule(pages: ParsedPage[], maxPerDay: number): RuleResult[];
+//# sourceMappingURL=publication-velocity.d.ts.map

package/dist/rules/spam/publication-velocity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publication-velocity.d.ts","sourceRoot":"","sources":["../../../src/rules/spam/publication-velocity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,CAyB5F"}