@pseolint/core 0.1.0

package/dist/rules/cannibal/keyword-collision.js

@@ -0,0 +1,25 @@
+import { buildCorpus, extractKeywords } from "../../algorithms/tf-idf.js";
+export function keywordCollisionRule(pages, minShared = 6) {
+    const findings = [];
+    const corpus = buildCorpus(pages.map((page) => page.contentText));
+    const keywordsPerPage = pages.map((page) => extractKeywords(page.contentText, corpus, 10));
+    for (let i = 0; i < pages.length; i += 1) {
+        for (let j = i + 1; j < pages.length; j += 1) {
+            const setA = new Set(keywordsPerPage[i]);
+            const shared = keywordsPerPage[j].filter((kw) => setA.has(kw));
+            if (shared.length >= minShared) {
+                findings.push({
+                    ruleId: "cannibal/keyword-collision",
+                    severity: "warning",
+                    message: `${pages[i].url} and ${pages[j].url} share ${shared.length} of their top 10 keywords: ${shared.join(", ")}.`,
+                    pageUrl: pages[i].url,
+                    relatedUrls: [pages[j].url],
+                    similarity: shared.length / 10,
+                    fix: `These pages target the same keywords. Consolidate them into one page or differentiate their content focus.`
+                });
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=keyword-collision.js.map

package/dist/rules/cannibal/keyword-collision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-collision.js","sourceRoot":"","sources":["../../../src/rules/cannibal/keyword-collision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG1E,MAAM,UAAU,oBAAoB,CAClC,KAAmB,EACnB,YAAoB,CAAC;IAErB,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAClE,MAAM,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IAE3F,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,IAAI,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/D,IAAI,MAAM,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;gBAC/B,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,4BAA4B;oBACpC,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,MAAM,CAAC,MAAM,8BAA8B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBACrH,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG;oBACrB,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;oBAC3B,UAAU,EAAE,MAAM,CAAC,MAAM,GAAG,EAAE;oBAC9B,GAAG,EAAE,4GAA4G;iBAClH,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/cannibal/title-overlap.d.ts

@@ -0,0 +1,3 @@
+import type { EntityMaskPattern, ParsedPage, RuleResult } from "../../types.js";
+export declare function titleOverlapRule(pages: ParsedPage[], patterns: EntityMaskPattern[], threshold: number): RuleResult[];
+//# sourceMappingURL=title-overlap.d.ts.map

package/dist/rules/cannibal/title-overlap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-overlap.d.ts","sourceRoot":"","sources":["../../../src/rules/cannibal/title-overlap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AA0BhF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EAAE,EACnB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,SAAS,EAAE,MAAM,GAChB,UAAU,EAAE,CAsBd"}

package/dist/rules/cannibal/title-overlap.js

@@ -0,0 +1,43 @@
+import { maskEntities } from "../../algorithms/entity-mask.js";
+function tokenize(text) {
+    return new Set(text
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}\s]+/gu, " ")
+        .split(/\s+/)
+        .filter(Boolean));
+}
+function jaccardSimilarity(a, b) {
+    if (a.size === 0 && b.size === 0) {
+        return 0;
+    }
+    let intersection = 0;
+    for (const token of a) {
+        if (b.has(token)) {
+            intersection += 1;
+        }
+    }
+    const union = a.size + b.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+export function titleOverlapRule(pages, patterns, threshold) {
+    const findings = [];
+    const maskedTokens = pages.map((page) => tokenize(maskEntities(page.title, patterns)));
+    for (let i = 0; i < pages.length; i += 1) {
+        for (let j = i + 1; j < pages.length; j += 1) {
+            const similarity = jaccardSimilarity(maskedTokens[i], maskedTokens[j]);
+            if (similarity > threshold) {
+                findings.push({
+                    ruleId: "cannibal/title-overlap",
+                    severity: "warning",
+                    message: `${pages[i].url} and ${pages[j].url} have overlapping titles after entity masking (${(similarity * 100).toFixed(1)}% Jaccard similarity).`,
+                    pageUrl: pages[i].url,
+                    relatedUrls: [pages[j].url],
+                    similarity,
+                    fix: `Differentiate page titles by including unique, page-specific keywords or angles.`
+                });
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=title-overlap.js.map

package/dist/rules/cannibal/title-overlap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-overlap.js","sourceRoot":"","sources":["../../../src/rules/cannibal/title-overlap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAG/D,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,GAAG,CACZ,IAAI;SACD,WAAW,EAAE;SACb,OAAO,CAAC,oBAAoB,EAAE,GAAG,CAAC;SAClC,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,OAAO,CAAC,CACnB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAc,EAAE,CAAc;IACvD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,KAAK,IAAI,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACjB,YAAY,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,YAAY,CAAC;IAC7C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAmB,EACnB,QAA6B,EAC7B,SAAiB;IAEjB,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEvF,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,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YACvE,IAAI,UAAU,GAAG,SAAS,EAAE,CAAC;gBAC3B,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,wBAAwB;oBAChC,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,kDAAkD,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB;oBACnJ,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG;oBACrB,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;oBAC3B,UAAU;oBACV,GAAG,EAAE,kFAAkF;iBACxF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/cannibal/url-pattern.d.ts

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

package/dist/rules/cannibal/url-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-pattern.d.ts","sourceRoot":"","sources":["../../../src/rules/cannibal/url-pattern.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAqB7D,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAgChE"}

package/dist/rules/cannibal/url-pattern.js

@@ -0,0 +1,48 @@
+function lastSegment(url) {
+    let pathname;
+    try {
+        pathname = new URL(url).pathname;
+    }
+    catch {
+        pathname = url;
+    }
+    const stripped = pathname.replace(/\/+$/, "");
+    const lastSlash = stripped.lastIndexOf("/");
+    const directory = lastSlash >= 0 ? stripped.slice(0, lastSlash) : "";
+    const segment = lastSlash >= 0 ? stripped.slice(lastSlash + 1) : stripped;
+    return {
+        directory,
+        tokens: segment.split("-").filter(Boolean).sort()
+    };
+}
+export function urlPatternRule(pages) {
+    const findings = [];
+    const parsed = pages.map((page) => ({ url: page.url, ...lastSegment(page.url) }));
+    for (let i = 0; i < parsed.length; i += 1) {
+        for (let j = i + 1; j < parsed.length; j += 1) {
+            const a = parsed[i];
+            const b = parsed[j];
+            if (a.directory !== b.directory || a.directory === "") {
+                continue;
+            }
+            if (a.tokens.length === 0 || b.tokens.length === 0) {
+                continue;
+            }
+            if (a.url === b.url) {
+                continue;
+            }
+            if (a.tokens.join("-") === b.tokens.join("-")) {
+                findings.push({
+                    ruleId: "cannibal/url-pattern",
+                    severity: "info",
+                    message: `${pages[i].url} and ${pages[j].url} have the same URL tokens in different order, creating ambiguous intent overlap.`,
+                    pageUrl: pages[i].url,
+                    relatedUrls: [pages[j].url],
+                    fix: "These URLs have the same tokens in different order. Consolidate to one canonical URL pattern."
+                });
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=url-pattern.js.map

package/dist/rules/cannibal/url-pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-pattern.js","sourceRoot":"","sources":["../../../src/rules/cannibal/url-pattern.ts"],"names":[],"mappings":"AAEA,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAE1E,OAAO;QACL,SAAS;QACT,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAElF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YAEpB,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,KAAK,EAAE,EAAE,CAAC;gBACtD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;gBACpB,SAAS;YACX,CAAC;YACD,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9C,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,sBAAsB;oBAC9B,QAAQ,EAAE,MAAM;oBAChB,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,kFAAkF;oBAC9H,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG;oBACrB,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;oBAC3B,GAAG,EAAE,+FAA+F;iBACrG,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/content/eeat-signals.d.ts

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

package/dist/rules/content/eeat-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eeat-signals.d.ts","sourceRoot":"","sources":["../../../src/rules/content/eeat-signals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAiC7D,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAsBjE"}

package/dist/rules/content/eeat-signals.js

@@ -0,0 +1,46 @@
+const EEAT_HTML_PATTERNS = [
+    /last\s+updated/i,
+    /last\s+modified/i,
+    /reviewed\s+by/i,
+    /\bsources:/i,
+    /\breferences:/i
+];
+function countSignalCategories(page) {
+    let count = 0;
+    if (page.resolvedHrefs.some((href) => /\/about\b/i.test(href))) {
+        count += 1;
+    }
+    const { metaAuthor, schemaAuthor, bylineElement, relAuthorLink } = page.authorSignals;
+    if (metaAuthor !== "" || schemaAuthor || bylineElement || relAuthorLink) {
+        count += 1;
+    }
+    if (page.publishedDate) {
+        count += 1;
+    }
+    if (EEAT_HTML_PATTERNS.some((pattern) => pattern.test(page.html))) {
+        count += 1;
+    }
+    return count;
+}
+export function eeatSignalsRule(pages) {
+    const lacking = pages.filter((page) => countSignalCategories(page) < 2);
+    if (lacking.length === 0)
+        return [];
+    if (lacking.length === pages.length && pages.length > 3) {
+        return [{
+                ruleId: "content/eeat-signals",
+                severity: "info",
+                message: `All ${lacking.length} pages have fewer than 2 out of 4 E-E-A-T signal categories. Site-wide trust signals are missing.`,
+                fix: `Add trust signals site-wide: author info, publication dates, about page links, sources, or "last updated" markers.`,
+                relatedUrls: lacking.map((p) => p.url).sort()
+            }];
+    }
+    return lacking.map((page) => ({
+        ruleId: "content/eeat-signals",
+        severity: "info",
+        message: `${page.url} has fewer than 2 out of 4 E-E-A-T signal categories.`,
+        pageUrl: page.url,
+        fix: `Add trust signals: author info, publication dates, about page links, sources, or "last updated" markers.`
+    }));
+}
+//# sourceMappingURL=eeat-signals.js.map

package/dist/rules/content/eeat-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eeat-signals.js","sourceRoot":"","sources":["../../../src/rules/content/eeat-signals.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAAG;IACzB,iBAAiB;IACjB,kBAAkB;IAClB,gBAAgB;IAChB,aAAa;IACb,gBAAgB;CACjB,CAAC;AAEF,SAAS,qBAAqB,CAAC,IAAgB;IAC7C,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC/D,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;IACtF,IAAI,UAAU,KAAK,EAAE,IAAI,YAAY,IAAI,aAAa,IAAI,aAAa,EAAE,CAAC;QACxE,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAClE,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAmB;IACjD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAExE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC;gBACN,MAAM,EAAE,sBAAsB;gBAC9B,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,OAAO,OAAO,CAAC,MAAM,mGAAmG;gBACjI,GAAG,EAAE,oHAAoH;gBACzH,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE;aAC9C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5B,MAAM,EAAE,sBAAsB;QAC9B,QAAQ,EAAE,MAAe;QACzB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,uDAAuD;QAC3E,OAAO,EAAE,IAAI,CAAC,GAAG;QACjB,GAAG,EAAE,0GAA0G;KAChH,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/rules/content/heading-uniqueness.d.ts

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

package/dist/rules/content/heading-uniqueness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-uniqueness.d.ts","sourceRoot":"","sources":["../../../src/rules/content/heading-uniqueness.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAMhF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EAAE,EACnB,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,UAAU,EAAE,CAmDd"}

package/dist/rules/content/heading-uniqueness.js

@@ -0,0 +1,56 @@
+import { maskEntities } from "../../algorithms/entity-mask.js";
+function norm(value, patterns) {
+    return maskEntities(value.toLowerCase().trim(), patterns);
+}
+export function headingUniquenessRule(pages, patterns) {
+    const h1Groups = new Map();
+    const h2Groups = new Map();
+    for (const page of pages) {
+        const h1Key = page.headings.h1.map((h) => norm(h, patterns)).join(" | ");
+        const h2Key = page.headings.h2.map((h) => norm(h, patterns)).join(" | ");
+        if (h1Key) {
+            const group = h1Groups.get(h1Key) ?? [];
+            group.push(page.url);
+            h1Groups.set(h1Key, group);
+        }
+        if (h2Key) {
+            const group = h2Groups.get(h2Key) ?? [];
+            group.push(page.url);
+            h2Groups.set(h2Key, group);
+        }
+    }
+    const findings = [];
+    const emitted = new Set();
+    for (const [heading, urls] of h1Groups) {
+        if (urls.length < 2)
+            continue;
+        const key = `h1::${heading}`;
+        if (emitted.has(key))
+            continue;
+        emitted.add(key);
+        findings.push({
+            ruleId: "content/heading-uniqueness",
+            severity: "warning",
+            message: `${urls.length} pages share identical normalized H1 heading.`,
+            relatedUrls: urls.sort(),
+            fix: "Write unique headings for each page that reflect its specific content."
+        });
+    }
+    for (const [heading, urls] of h2Groups) {
+        if (urls.length < 2)
+            continue;
+        const key = `h2::${heading}`;
+        if (emitted.has(key))
+            continue;
+        emitted.add(key);
+        findings.push({
+            ruleId: "content/heading-uniqueness",
+            severity: "warning",
+            message: `${urls.length} pages share identical normalized H2 headings.`,
+            relatedUrls: urls.sort(),
+            fix: "Write unique headings for each page that reflect its specific content."
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=heading-uniqueness.js.map

package/dist/rules/content/heading-uniqueness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-uniqueness.js","sourceRoot":"","sources":["../../../src/rules/content/heading-uniqueness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAG/D,SAAS,IAAI,CAAC,KAAa,EAAE,QAA6B;IACxD,OAAO,YAAY,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAmB,EACnB,QAA6B;IAE7B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzE,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC9B,MAAM,GAAG,GAAG,OAAO,OAAO,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,4BAA4B;YACpC,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,+CAA+C;YACtE,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE;YACxB,GAAG,EAAE,wEAAwE;SAC9E,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC9B,MAAM,GAAG,GAAG,OAAO,OAAO,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,4BAA4B;YACpC,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,gDAAgD;YACvE,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE;YACxB,GAAG,EAAE,wEAAwE;SAC9E,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/content/meta-uniqueness.d.ts

@@ -0,0 +1,3 @@
+import type { EntityMaskPattern, ParsedPage, RuleResult } from "../../types.js";
+export declare function metaUniquenessRule(pages: ParsedPage[], patterns: EntityMaskPattern[], _minJaccardForCollision: number): RuleResult[];
+//# sourceMappingURL=meta-uniqueness.d.ts.map

package/dist/rules/content/meta-uniqueness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-uniqueness.d.ts","sourceRoot":"","sources":["../../../src/rules/content/meta-uniqueness.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEhF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EAAE,EACnB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,uBAAuB,EAAE,MAAM,GAC9B,UAAU,EAAE,CA0Bd"}

package/dist/rules/content/meta-uniqueness.js

@@ -0,0 +1,28 @@
+import { maskEntities } from "../../algorithms/entity-mask.js";
+export function metaUniquenessRule(pages, patterns, _minJaccardForCollision) {
+    const groups = new Map();
+    for (const page of pages) {
+        if (!page.metaDescription)
+            continue;
+        const masked = maskEntities(page.metaDescription, patterns).toLowerCase().trim();
+        if (!masked)
+            continue;
+        const group = groups.get(masked) ?? [];
+        group.push(page.url);
+        groups.set(masked, group);
+    }
+    const findings = [];
+    for (const [, urls] of groups) {
+        if (urls.length < 2)
+            continue;
+        findings.push({
+            ruleId: "content/meta-uniqueness",
+            severity: "error",
+            message: `${urls.length} pages share the same meta description template after entity masking.`,
+            relatedUrls: urls.sort(),
+            fix: "Write a unique meta description for each page that highlights what makes it specifically different."
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=meta-uniqueness.js.map

package/dist/rules/content/meta-uniqueness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-uniqueness.js","sourceRoot":"","sources":["../../../src/rules/content/meta-uniqueness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAG/D,MAAM,UAAU,kBAAkB,CAChC,KAAmB,EACnB,QAA6B,EAC7B,uBAA+B;IAE/B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,SAAS;QACpC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QACjF,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC9B,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,yBAAyB;YACjC,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,uEAAuE;YAC9F,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE;YACxB,GAAG,EAAE,qGAAqG;SAC3G,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/content/missing-author.d.ts

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

package/dist/rules/content/missing-author.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-author.d.ts","sourceRoot":"","sources":["../../../src/rules/content/missing-author.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAO7D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAsBnE"}

package/dist/rules/content/missing-author.js

@@ -0,0 +1,26 @@
+function hasAuthorSignal(page) {
+    const { metaAuthor, schemaAuthor, bylineElement, relAuthorLink } = page.authorSignals;
+    return metaAuthor !== "" || schemaAuthor || bylineElement || relAuthorLink;
+}
+export function missingAuthorRule(pages) {
+    const missing = pages.filter((page) => !hasAuthorSignal(page));
+    if (missing.length === 0)
+        return [];
+    if (missing.length === pages.length && pages.length > 3) {
+        return [{
+                ruleId: "content/missing-author",
+                severity: "warning",
+                message: `All ${missing.length} pages have no author signals (meta author, schema author, byline, or rel="author" link). This is a site-wide E-E-A-T risk.`,
+                fix: `Add author attribution site-wide: <meta name="author" content="Name">, a visible byline, or author data in your JSON-LD schema.`,
+                relatedUrls: missing.map((p) => p.url).sort()
+            }];
+    }
+    return missing.map((page) => ({
+        ruleId: "content/missing-author",
+        severity: "warning",
+        message: `${page.url} has no author signals. This is an E-E-A-T risk.`,
+        pageUrl: page.url,
+        fix: `Add author attribution: <meta name="author" content="Name">, a visible byline, or author data in your JSON-LD schema.`
+    }));
+}
+//# sourceMappingURL=missing-author.js.map

package/dist/rules/content/missing-author.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-author.js","sourceRoot":"","sources":["../../../src/rules/content/missing-author.ts"],"names":[],"mappings":"AAEA,SAAS,eAAe,CAAC,IAAgB;IACvC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;IACtF,OAAO,UAAU,KAAK,EAAE,IAAI,YAAY,IAAI,aAAa,IAAI,aAAa,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC;gBACN,MAAM,EAAE,wBAAwB;gBAChC,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,OAAO,OAAO,CAAC,MAAM,6HAA6H;gBAC3J,GAAG,EAAE,iIAAiI;gBACtI,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE;aAC9C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5B,MAAM,EAAE,wBAAwB;QAChC,QAAQ,EAAE,SAAkB;QAC5B,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,kDAAkD;QACtE,OAAO,EAAE,IAAI,CAAC,GAAG;QACjB,GAAG,EAAE,uHAAuH;KAC7H,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/rules/content/unique-value.d.ts

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

package/dist/rules/content/unique-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique-value.d.ts","sourceRoot":"","sources":["../../../src/rules/content/unique-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAM7D,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,UAAU,EAAE,CA0BzF"}

package/dist/rules/content/unique-value.js

@@ -0,0 +1,26 @@
+function tokenize(text) {
+    return text.toLowerCase().split(/\s+/).filter(Boolean);
+}
+export function uniqueValueRule(pages, minUniqueWords) {
+    const frequencies = new Map();
+    const pageTokens = pages.map((page) => tokenize(page.contentText));
+    for (const tokens of pageTokens) {
+        for (const token of new Set(tokens)) {
+            frequencies.set(token, (frequencies.get(token) ?? 0) + 1);
+        }
+    }
+    const findings = [];
+    pages.forEach((page, idx) => {
+        const uniqueCount = new Set(pageTokens[idx].filter((token) => (frequencies.get(token) ?? 0) === 1)).size;
+        if (uniqueCount < minUniqueWords) {
+            findings.push({
+                ruleId: "content/unique-value",
+                severity: "error",
+                message: `${page.url} has only ${uniqueCount} unique words (min ${minUniqueWords}).`,
+                fix: `Add ${minUniqueWords - uniqueCount} more words of content not found on any other page.`
+            });
+        }
+    });
+    return findings;
+}
+//# sourceMappingURL=unique-value.js.map

package/dist/rules/content/unique-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique-value.js","sourceRoot":"","sources":["../../../src/rules/content/unique-value.ts"],"names":[],"mappings":"AAEA,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAmB,EAAE,cAAsB;IACzE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAEnE,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC1B,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CACvE,CAAC,IAAI,CAAC;QACP,IAAI,WAAW,GAAG,cAAc,EAAE,CAAC;YACjC,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,sBAAsB;gBAC9B,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,aAAa,WAAW,sBAAsB,cAAc,IAAI;gBACpF,GAAG,EAAE,OAAO,cAAc,GAAG,WAAW,qDAAqD;aAC9F,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/links/cluster-connectivity.d.ts

@@ -0,0 +1,7 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+/**
+ * Flags clusters (same parent directory) with 2+ pages that are siloed: no outbound
+ * internal crawl link to another cluster and no inbound from another cluster.
+ */
+export declare function clusterConnectivityRule(pages: ParsedPage[], knownUrls: Set<string>): RuleResult[];
+//# sourceMappingURL=cluster-connectivity.d.ts.map

package/dist/rules/links/cluster-connectivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-connectivity.d.ts","sourceRoot":"","sources":["../../../src/rules/links/cluster-connectivity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAyB7D;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,UAAU,EAAE,CA0Dd"}

package/dist/rules/links/cluster-connectivity.js

@@ -0,0 +1,73 @@
+import { clusterKeyForUrl } from "./cluster-key.js";
+function hasCrossClusterInbound(clusterDir, urlsInCluster, pages, knownUrls) {
+    for (const page of pages) {
+        if (urlsInCluster.has(page.url)) {
+            continue;
+        }
+        for (const link of page.resolvedHrefs) {
+            if (!knownUrls.has(link)) {
+                continue;
+            }
+            if (urlsInCluster.has(link)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Flags clusters (same parent directory) with 2+ pages that are siloed: no outbound
+ * internal crawl link to another cluster and no inbound from another cluster.
+ */
+export function clusterConnectivityRule(pages, knownUrls) {
+    if (pages.length < 2) {
+        return [];
+    }
+    const clusterPages = new Map();
+    for (const p of pages) {
+        const key = clusterKeyForUrl(p.url);
+        const set = clusterPages.get(key) ?? new Set();
+        set.add(p.url);
+        clusterPages.set(key, set);
+    }
+    if (clusterPages.size < 2) {
+        return [];
+    }
+    const findings = [];
+    for (const [clusterDir, urls] of clusterPages.entries()) {
+        if (urls.size < 2) {
+            continue;
+        }
+        let hasCrossClusterOutbound = false;
+        for (const page of pages) {
+            if (!urls.has(page.url)) {
+                continue;
+            }
+            for (const link of page.resolvedHrefs) {
+                if (!knownUrls.has(link)) {
+                    continue;
+                }
+                const targetCluster = clusterKeyForUrl(link);
+                if (targetCluster !== clusterDir) {
+                    hasCrossClusterOutbound = true;
+                    break;
+                }
+            }
+            if (hasCrossClusterOutbound) {
+                break;
+            }
+        }
+        const hasInbound = hasCrossClusterInbound(clusterDir, urls, pages, knownUrls);
+        if (!hasCrossClusterOutbound && !hasInbound) {
+            findings.push({
+                ruleId: "links/cluster-connectivity",
+                severity: "warning",
+                message: `Cluster ${clusterDir} (${urls.size} pages) has no crawl links to or from other clusters.`,
+                relatedUrls: Array.from(urls).sort(),
+                fix: "Add cross-links between this cluster and other sections of your site to build topical authority."
+            });
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=cluster-connectivity.js.map

package/dist/rules/links/cluster-connectivity.js.map

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

package/dist/rules/links/cluster-key.d.ts

@@ -0,0 +1,3 @@
+/** Directory-style cluster key: same parent path = same cluster. */
+export declare function clusterKeyForUrl(pageUrl: string): string;
+//# sourceMappingURL=cluster-key.d.ts.map

package/dist/rules/links/cluster-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-key.d.ts","sourceRoot":"","sources":["../../../src/rules/links/cluster-key.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAiBxD"}

package/dist/rules/links/cluster-key.js

@@ -0,0 +1,22 @@
+import { dirname } from "node:path";
+/** Directory-style cluster key: same parent path = same cluster. */
+export function clusterKeyForUrl(pageUrl) {
+    if (/^https?:\/\//i.test(pageUrl)) {
+        try {
+            const u = new URL(pageUrl);
+            let pathname = u.pathname;
+            if (pathname.length > 1 && pathname.endsWith("/")) {
+                pathname = pathname.slice(0, -1);
+            }
+            const path = pathname.replace(/\/[^/]+$/, "") || "/";
+            const dir = path.endsWith("/") ? path : `${path}/`;
+            return `${u.origin}${dir}`;
+        }
+        catch {
+            return pageUrl;
+        }
+    }
+    const dir = dirname(pageUrl);
+    return dir.endsWith("\\") || dir.endsWith("/") ? dir : `${dir}\\`;
+}
+//# sourceMappingURL=cluster-key.js.map

package/dist/rules/links/cluster-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-key.js","sourceRoot":"","sources":["../../../src/rules/links/cluster-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,oEAAoE;AACpE,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;YAC3B,IAAI,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;YAC1B,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClD,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACnC,CAAC;YACD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;YACrD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;YACnD,OAAO,GAAG,CAAC,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;AACpE,CAAC"}

package/dist/rules/links/dead-ends.d.ts

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

package/dist/rules/links/dead-ends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-ends.d.ts","sourceRoot":"","sources":["../../../src/rules/links/dead-ends.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,UAAU,EAAE,CAcd"}

package/dist/rules/links/dead-ends.js

@@ -0,0 +1,13 @@
+export function deadEndsRule(pages, knownUrls, rootUrl) {
+    return pages
+        .filter((page) => !rootUrl || page.url !== rootUrl)
+        .filter((page) => page.resolvedHrefs.filter((link) => knownUrls.has(link) && link !== page.url).length === 0)
+        .map((page) => ({
+        ruleId: "links/dead-ends",
+        severity: "warning",
+        message: `${page.url} has no outbound links to other pages in this crawl.`,
+        pageUrl: page.url,
+        fix: "Add outbound links to related pages on your site to help users and crawlers discover more content."
+    }));
+}
+//# sourceMappingURL=dead-ends.js.map

package/dist/rules/links/dead-ends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-ends.js","sourceRoot":"","sources":["../../../src/rules/links/dead-ends.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAC1B,KAAmB,EACnB,SAAsB,EACtB,OAAgB;IAEhB,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC;SAClD,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAC7F;SACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,MAAM,EAAE,iBAAiB;QACzB,QAAQ,EAAE,SAAkB;QAC5B,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,sDAAsD;QAC1E,OAAO,EAAE,IAAI,CAAC,GAAG;QACjB,GAAG,EAAE,oGAAoG;KAC1G,CAAC,CAAC,CAAC;AACR,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+/**
+ * Hub/index coverage for medium-sized directories, plus info when a cluster is skipped
+ * because it exceeds `maxSiblings`.
+ */
+export declare function hubPagesRule(pages: ParsedPage[], knownUrls: Set<string>, minSiblings: number, maxSiblings: number): RuleResult[];
+//# sourceMappingURL=hub-pages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hub-pages.d.ts","sourceRoot":"","sources":["../../../src/rules/links/hub-pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAmB7D;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,UAAU,EAAE,CA8Dd"}