@pseolint/core 0.1.0

package/dist/rules/spam/publication-velocity.js

@@ -0,0 +1,25 @@
+export function publicationVelocityRule(pages, maxPerDay) {
+    const byDay = new Map();
+    for (const page of pages) {
+        if (!page.publishedDate) {
+            continue;
+        }
+        const day = page.publishedDate.slice(0, 10);
+        const group = byDay.get(day) ?? [];
+        group.push(page);
+        byDay.set(day, group);
+    }
+    const findings = [];
+    for (const [day, dayPages] of byDay.entries()) {
+        if (dayPages.length > maxPerDay) {
+            findings.push({
+                ruleId: "spam/publication-velocity",
+                severity: "warning",
+                message: `${dayPages.length} pages share publish date ${day}, exceeding max/day ${maxPerDay}.`,
+                fix: "Stagger publication dates across pages to avoid appearing auto-generated."
+            });
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=publication-velocity.js.map

package/dist/rules/spam/publication-velocity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publication-velocity.js","sourceRoot":"","sources":["../../../src/rules/spam/publication-velocity.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,uBAAuB,CAAC,KAAmB,EAAE,SAAiB;IAC5E,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,IAAI,QAAQ,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,2BAA2B;gBACnC,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,GAAG,QAAQ,CAAC,MAAM,6BAA6B,GAAG,uBAAuB,SAAS,GAAG;gBAC9F,GAAG,EAAE,2EAA2E;aACjF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/spam/template-coverage.d.ts

@@ -0,0 +1,3 @@
+import type { EntityMaskPattern, ParsedPage, RuleResult } from "../../types.js";
+export declare function templateCoverageRule(pages: ParsedPage[], entityPatterns: EntityMaskPattern[], minPages: number): RuleResult[];
+//# sourceMappingURL=template-coverage.d.ts.map

package/dist/rules/spam/template-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-coverage.d.ts","sourceRoot":"","sources":["../../../src/rules/spam/template-coverage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAchF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EAAE,EACnB,cAAc,EAAE,iBAAiB,EAAE,EACnC,QAAQ,EAAE,MAAM,GACf,UAAU,EAAE,CAiFd"}

package/dist/rules/spam/template-coverage.js

@@ -0,0 +1,87 @@
+import { maskEntities } from "../../algorithms/entity-mask.js";
+import { clusterKeyForUrl } from "../links/cluster-key.js";
+function extractFilename(url) {
+    let path;
+    try {
+        path = new URL(url).pathname;
+    }
+    catch {
+        path = url.replace(/\\/g, "/");
+    }
+    const stripped = path.replace(/\/+$/, "").replace(/\.[^.]+$/, "");
+    const lastSlash = stripped.lastIndexOf("/");
+    return lastSlash >= 0 ? stripped.slice(lastSlash + 1) : stripped;
+}
+export function templateCoverageRule(pages, entityPatterns, minPages) {
+    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) {
+        if (group.length < minPages)
+            continue;
+        const maskedFilenames = group.map((p) => {
+            const filename = extractFilename(p.url);
+            return maskEntities(filename, entityPatterns);
+        });
+        // Group by segment count (different segment counts = different template patterns)
+        const bySegmentCount = new Map();
+        for (const name of maskedFilenames) {
+            const tokens = name.split("-").filter(Boolean);
+            const count = tokens.length;
+            const list = bySegmentCount.get(count) ?? [];
+            list.push(name);
+            bySegmentCount.set(count, list);
+        }
+        for (const [, names] of bySegmentCount) {
+            if (names.length < 2)
+                continue;
+            const segmentCount = names[0].split("-").filter(Boolean).length;
+            if (segmentCount === 0)
+                continue;
+            const tokenSets = Array.from({ length: segmentCount }, () => new Set());
+            for (const name of names) {
+                const tokens = name.split("-").filter(Boolean);
+                for (let pos = 0; pos < tokens.length && pos < segmentCount; pos += 1) {
+                    tokenSets[pos].add(tokens[pos]);
+                }
+            }
+            const dimensions = [];
+            for (let pos = 0; pos < tokenSets.length; pos += 1) {
+                if (tokenSets[pos].size > 1) {
+                    const samples = Array.from(tokenSets[pos]).slice(0, 3);
+                    dimensions.push({ position: pos, values: tokenSets[pos].size, samples });
+                }
+            }
+            // No template pattern if all tokens vary or no tokens vary
+            if (dimensions.length === 0)
+                continue;
+            if (dimensions.length === segmentCount)
+                continue;
+            const totalCombinations = dimensions.reduce((acc, d) => acc * d.values, 1);
+            const coverage = names.length / totalCombinations;
+            const coveragePct = (coverage * 100).toFixed(1);
+            const dimDesc = dimensions
+                .map((d) => {
+                const sampleStr = d.samples.join(", ");
+                return `${d.values} values (e.g. ${sampleStr})`;
+            })
+                .join(" x ");
+            findings.push({
+                ruleId: "spam/template-coverage",
+                severity: "info",
+                message: `${clusterDir} has ${names.length} pages across ${dimensions.length} dimensions: ${dimDesc}. Coverage: ${names.length} of ${totalCombinations} combinations (${coveragePct}%).`,
+                fix: totalCombinations > names.length * 5
+                    ? "Low coverage suggests an overly broad template matrix. Consider narrowing dimensions to combinations you can differentiate with unique content."
+                    : "Coverage is reasonable. Ensure each combination provides genuinely unique content.",
+                relatedUrls: group.map((p) => p.url).sort()
+            });
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=template-coverage.js.map

package/dist/rules/spam/template-coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-coverage.js","sourceRoot":"","sources":["../../../src/rules/spam/template-coverage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC5C,OAAO,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAmB,EACnB,cAAmC,EACnC,QAAgB;IAEhB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACb,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;QAC5C,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ;YAAE,SAAS;QAEtC,MAAM,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACtC,MAAM,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACxC,OAAO,YAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,kFAAkF;QAClF,MAAM,cAAc,GAAG,IAAI,GAAG,EAAoB,CAAC;QACnD,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;YAC5B,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChB,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;YACvC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS;YAE/B,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YAChE,IAAI,YAAY,KAAK,CAAC;gBAAE,SAAS;YAEjC,MAAM,SAAS,GAAkB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;YAEvF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC/C,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,YAAY,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;oBACtE,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;YAED,MAAM,UAAU,GAAmE,EAAE,CAAC;YAEtF,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;gBACnD,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;oBAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACvD,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC3E,CAAC;YACH,CAAC;YAED,2DAA2D;YAC3D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACtC,IAAI,UAAU,CAAC,MAAM,KAAK,YAAY;gBAAE,SAAS;YAEjD,MAAM,iBAAiB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3E,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,iBAAiB,CAAC;YAClD,MAAM,WAAW,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAEhD,MAAM,OAAO,GAAG,UAAU;iBACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACT,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvC,OAAO,GAAG,CAAC,CAAC,MAAM,iBAAiB,SAAS,GAAG,CAAC;YAClD,CAAC,CAAC;iBACD,IAAI,CAAC,KAAK,CAAC,CAAC;YAEf,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,wBAAwB;gBAChC,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,GAAG,UAAU,QAAQ,KAAK,CAAC,MAAM,iBAAiB,UAAU,CAAC,MAAM,gBAAgB,OAAO,eAAe,KAAK,CAAC,MAAM,OAAO,iBAAiB,kBAAkB,WAAW,KAAK;gBACxL,GAAG,EAAE,iBAAiB,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC;oBACvC,CAAC,CAAC,iJAAiJ;oBACnJ,CAAC,CAAC,oFAAoF;gBACxF,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE;aAC5C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/spam/template-diversity.d.ts

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

package/dist/rules/spam/template-diversity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-diversity.d.ts","sourceRoot":"","sources":["../../../src/rules/spam/template-diversity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EAAE,EACnB,cAAc,EAAE,MAAM,GACrB,UAAU,EAAE,CAmBd"}

package/dist/rules/spam/template-diversity.js

@@ -0,0 +1,19 @@
+export function templateDiversityRule(pages, minUniqueRatio) {
+    if (pages.length === 0) {
+        return [];
+    }
+    const unique = new Set(pages.map((page) => page.structureSignature)).size;
+    const ratio = unique / pages.length;
+    if (ratio >= minUniqueRatio) {
+        return [];
+    }
+    return [
+        {
+            ruleId: "spam/template-diversity",
+            severity: "warning",
+            message: `Template diversity ratio is ${ratio.toFixed(2)} (min ${minUniqueRatio.toFixed(2)}).`,
+            fix: "Vary the HTML structure across pages. Add conditional sections, different layouts, or page-specific components."
+        }
+    ];
+}
+//# sourceMappingURL=template-diversity.js.map

package/dist/rules/spam/template-diversity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-diversity.js","sourceRoot":"","sources":["../../../src/rules/spam/template-diversity.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CACnC,KAAmB,EACnB,cAAsB;IAEtB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,MAAM,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IACpC,IAAI,KAAK,IAAI,cAAc,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL;YACE,MAAM,EAAE,yBAAyB;YACjC,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,+BAA+B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;YAC9F,GAAG,EAAE,iHAAiH;SACvH;KACF,CAAC;AACJ,CAAC"}

package/dist/rules/spam/thin-content.d.ts

@@ -0,0 +1,6 @@
+import type { ParsedPage, RuleResult } from "../../types.js";
+export declare function thinContentRule(pages: ParsedPage[], minWords: number): {
+    findings: RuleResult[];
+    thinContentUrls: Set<string>;
+};
+//# sourceMappingURL=thin-content.d.ts.map

package/dist/rules/spam/thin-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thin-content.d.ts","sourceRoot":"","sources":["../../../src/rules/spam/thin-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAM7D,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EAAE,EACnB,QAAQ,EAAE,MAAM,GACf;IAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAAC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CAoB1D"}

package/dist/rules/spam/thin-content.js

@@ -0,0 +1,22 @@
+function countWords(text) {
+    return text.split(/\s+/).filter(Boolean).length;
+}
+export function thinContentRule(pages, minWords) {
+    const findings = [];
+    const thinContentUrls = new Set();
+    for (const page of pages) {
+        const words = countWords(page.contentText);
+        if (words >= minWords) {
+            continue;
+        }
+        thinContentUrls.add(page.url);
+        findings.push({
+            ruleId: "spam/thin-content",
+            severity: "error",
+            message: `${page.url} has thin content (${words} words).`,
+            fix: `Add at least ${minWords - words} more words of substantive content relevant to this page's specific topic.`
+        });
+    }
+    return { findings, thinContentUrls };
+}
+//# sourceMappingURL=thin-content.js.map

package/dist/rules/spam/thin-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thin-content.js","sourceRoot":"","sources":["../../../src/rules/spam/thin-content.ts"],"names":[],"mappings":"AAEA,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAmB,EACnB,QAAgB;IAEhB,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3C,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;YACtB,SAAS;QACX,CAAC;QAED,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,mBAAmB;YAC3B,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,sBAAsB,KAAK,UAAU;YACzD,GAAG,EAAE,gBAAgB,QAAQ,GAAG,KAAK,4EAA4E;SAClH,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;AACvC,CAAC"}

package/dist/rules/tech/canonical-consistency.d.ts

@@ -0,0 +1,4 @@
+import type { NormalizeUrlOptions, ParsedPage, RuleResult } from "../../types.js";
+export declare function resolveCanonicalUrl(canonical: string, pageUrl: string, normalizeOpts: NormalizeUrlOptions): string | null;
+export declare function canonicalConsistencyRule(pages: ParsedPage[], knownUrls: Set<string>, normalizeOpts: NormalizeUrlOptions): RuleResult[];
+//# sourceMappingURL=canonical-consistency.d.ts.map

package/dist/rules/tech/canonical-consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-consistency.d.ts","sourceRoot":"","sources":["../../../src/rules/tech/canonical-consistency.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGlF,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,mBAAmB,GACjC,MAAM,GAAG,IAAI,CAef;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,aAAa,EAAE,mBAAmB,GACjC,UAAU,EAAE,CA+Dd"}

package/dist/rules/tech/canonical-consistency.js

@@ -0,0 +1,78 @@
+import { dirname, resolve } from "node:path";
+import { normalizeAuditUrl } from "../../url-normalize.js";
+export function resolveCanonicalUrl(canonical, pageUrl, normalizeOpts) {
+    const raw = canonical.trim();
+    if (!raw)
+        return null;
+    if (/^https?:\/\//i.test(raw))
+        return normalizeAuditUrl(raw, normalizeOpts);
+    if (/^https?:\/\//i.test(pageUrl)) {
+        try {
+            return normalizeAuditUrl(new URL(raw, pageUrl).href, normalizeOpts);
+        }
+        catch {
+            return null;
+        }
+    }
+    return normalizeAuditUrl(resolve(dirname(pageUrl), raw), normalizeOpts);
+}
+export function canonicalConsistencyRule(pages, knownUrls, normalizeOpts) {
+    const findings = [];
+    for (const page of pages) {
+        if (!page.canonical) {
+            findings.push({
+                ruleId: "tech/canonical-consistency",
+                severity: "error",
+                message: `${page.url} is missing a canonical URL.`,
+                pageUrl: page.url,
+                fix: `Add <link rel="canonical" href="${page.url}" /> to the <head>.`
+            });
+            continue;
+        }
+        const canonicalUrl = resolveCanonicalUrl(page.canonical, page.url, normalizeOpts);
+        if (!canonicalUrl) {
+            findings.push({
+                ruleId: "tech/canonical-consistency",
+                severity: "error",
+                message: `${page.url} has an invalid canonical URL: ${page.canonical}.`,
+                pageUrl: page.url,
+                fix: "Fix the canonical URL syntax."
+            });
+            continue;
+        }
+        if (canonicalUrl === page.url)
+            continue;
+        findings.push({
+            ruleId: "tech/canonical-consistency",
+            severity: knownUrls.has(canonicalUrl) ? "warning" : "info",
+            message: knownUrls.has(canonicalUrl)
+                ? `${page.url} canonicalizes to another crawled page (${canonicalUrl}).`
+                : `${page.url} canonicalizes outside the crawl scope (${canonicalUrl}).`,
+            pageUrl: page.url,
+            relatedUrls: [canonicalUrl],
+            fix: "Verify this canonical target is intentional."
+        });
+        // Check HTTP Link header for canonical
+        if (page.httpMeta?.linkHeader) {
+            const linkCanonicalMatch = page.httpMeta.linkHeader.match(/<([^>]+)>;\s*rel="canonical"/i);
+            if (linkCanonicalMatch) {
+                const httpCanonical = normalizeAuditUrl(linkCanonicalMatch[1], normalizeOpts);
+                const htmlCanonical = page.canonical
+                    ? resolveCanonicalUrl(page.canonical, page.url, normalizeOpts)
+                    : null;
+                if (httpCanonical && htmlCanonical && httpCanonical !== htmlCanonical) {
+                    findings.push({
+                        ruleId: "tech/canonical-consistency",
+                        severity: "error",
+                        message: `${page.url} has conflicting canonical URLs: HTML says ${htmlCanonical}, HTTP Link header says ${httpCanonical}.`,
+                        pageUrl: page.url,
+                        relatedUrls: [htmlCanonical, httpCanonical],
+                        fix: "Ensure the HTML <link rel='canonical'> and HTTP Link header agree on the canonical URL."
+                    });
+                }
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=canonical-consistency.js.map

package/dist/rules/tech/canonical-consistency.js.map

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

package/dist/rules/tech/canonical-noindex-conflict.d.ts

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

package/dist/rules/tech/canonical-noindex-conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-noindex-conflict.d.ts","sourceRoot":"","sources":["../../../src/rules/tech/canonical-noindex-conflict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGlF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,UAAU,EAAE,EACnB,aAAa,EAAE,mBAAmB,GACjC,UAAU,EAAE,CA4Bd"}

package/dist/rules/tech/canonical-noindex-conflict.js

@@ -0,0 +1,27 @@
+import { resolveCanonicalUrl } from "./canonical-consistency.js";
+export function canonicalNoindexConflictRule(pages, normalizeOpts) {
+    const findings = [];
+    for (const page of pages) {
+        const robots = page.robotsMeta.toLowerCase();
+        if (!robots.includes("noindex") || !page.canonical) {
+            continue;
+        }
+        const canonicalUrl = resolveCanonicalUrl(page.canonical, page.url, normalizeOpts);
+        if (!canonicalUrl) {
+            continue;
+        }
+        if (canonicalUrl === page.url) {
+            continue;
+        }
+        findings.push({
+            ruleId: "tech/canonical-noindex-conflict",
+            severity: "warning",
+            message: `${page.url} is noindex but canonicalizes to ${canonicalUrl}.`,
+            pageUrl: page.url,
+            relatedUrls: [canonicalUrl],
+            fix: "Remove the noindex directive or change the canonical to self-reference."
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=canonical-noindex-conflict.js.map

package/dist/rules/tech/canonical-noindex-conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-noindex-conflict.js","sourceRoot":"","sources":["../../../src/rules/tech/canonical-noindex-conflict.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,UAAU,4BAA4B,CAC1C,KAAmB,EACnB,aAAkC;IAElC,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACnD,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAClF,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QACD,IAAI,YAAY,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,iCAAiC;YACzC,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,oCAAoC,YAAY,GAAG;YACvE,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,WAAW,EAAE,CAAC,YAAY,CAAC;YAC3B,GAAG,EAAE,yEAAyE;SAC/E,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/tech/hreflang-consistency.d.ts

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

package/dist/rules/tech/hreflang-consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hreflang-consistency.d.ts","sourceRoot":"","sources":["../../../src/rules/tech/hreflang-consistency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGlF,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EAAE,EACnB,aAAa,EAAE,mBAAmB,GACjC,UAAU,EAAE,CA0Gd"}

package/dist/rules/tech/hreflang-consistency.js

@@ -0,0 +1,99 @@
+import { normalizeAuditUrl } from "../../url-normalize.js";
+export function hreflangConsistencyRule(pages, normalizeOpts) {
+    const findings = [];
+    const hreflangMap = new Map();
+    for (const page of pages) {
+        if (page.hreflangs.length === 0) {
+            continue;
+        }
+        const seen = new Set();
+        let hasXDefault = false;
+        for (const entry of page.hreflangs) {
+            const lang = entry.lang.toLowerCase();
+            if (lang === "x-default") {
+                hasXDefault = true;
+            }
+            if (seen.has(lang)) {
+                findings.push({
+                    ruleId: "tech/hreflang-consistency",
+                    severity: "warning",
+                    message: `${page.url} has duplicate hreflang entry for ${entry.lang}.`,
+                    pageUrl: page.url,
+                    fix: `Remove the duplicate hreflang entry for ${entry.lang} on this page.`
+                });
+            }
+            seen.add(lang);
+            if (!entry.href) {
+                findings.push({
+                    ruleId: "tech/hreflang-consistency",
+                    severity: "warning",
+                    message: `${page.url} has hreflang ${entry.lang} without an href.`,
+                    pageUrl: page.url,
+                    fix: `Add a valid href to the hreflang ${entry.lang} entry on this page.`
+                });
+                continue;
+            }
+            if (!/^https?:\/\//i.test(entry.href)) {
+                findings.push({
+                    ruleId: "tech/hreflang-consistency",
+                    severity: "warning",
+                    message: `${page.url} has non-absolute hreflang href (${entry.href}) for ${entry.lang}.`,
+                    pageUrl: page.url,
+                    fix: `Change the hreflang href for ${entry.lang} to an absolute URL (starting with https://).`
+                });
+                continue;
+            }
+            const normalizedHref = normalizeAuditUrl(entry.href, normalizeOpts);
+            const pageRefs = hreflangMap.get(page.url) ?? new Map();
+            pageRefs.set(lang, normalizedHref);
+            hreflangMap.set(page.url, pageRefs);
+        }
+        if (!hasXDefault) {
+            findings.push({
+                ruleId: "tech/hreflang-consistency",
+                severity: "info",
+                message: `${page.url} has hreflang annotations but no x-default entry.`,
+                pageUrl: page.url,
+                fix: `Add <link rel="alternate" hreflang="x-default" href="..."> to specify a fallback URL for unmatched locales.`
+            });
+        }
+    }
+    const checkedPairs = new Set();
+    for (const [pageUrl, refs] of hreflangMap) {
+        for (const [lang, targetUrl] of refs) {
+            if (lang === "x-default")
+                continue;
+            if (targetUrl === pageUrl)
+                continue;
+            const pairKey = [pageUrl, targetUrl].sort().join("||");
+            if (checkedPairs.has(pairKey))
+                continue;
+            checkedPairs.add(pairKey);
+            const targetRefs = hreflangMap.get(targetUrl);
+            if (!targetRefs) {
+                findings.push({
+                    ruleId: "tech/hreflang-consistency",
+                    severity: "warning",
+                    message: `${pageUrl} declares hreflang ${lang} pointing to ${targetUrl}, but that page has no hreflang annotations back.`,
+                    pageUrl,
+                    relatedUrls: [targetUrl],
+                    fix: `Add a reciprocal hreflang annotation on ${targetUrl} pointing back to ${pageUrl}.`
+                });
+                continue;
+            }
+            const reciprocal = Array.from(targetRefs.values()).some((href) => href === pageUrl);
+            if (!reciprocal) {
+                findings.push({
+                    ruleId: "tech/hreflang-consistency",
+                    severity: "warning",
+                    message: `${pageUrl} declares hreflang ${lang} to ${targetUrl}, but ${targetUrl} does not link back.`,
+                    pageUrl,
+                    relatedUrls: [targetUrl],
+                    fix: `Add a reciprocal hreflang annotation on ${targetUrl} pointing back to ${pageUrl}.`
+                });
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=hreflang-consistency.js.map

package/dist/rules/tech/hreflang-consistency.js.map

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

package/dist/rules/tech/og-completeness.d.ts

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

package/dist/rules/tech/og-completeness.d.ts.map

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

package/dist/rules/tech/og-completeness.js

@@ -0,0 +1,35 @@
+export function ogCompletenessRule(pages) {
+    const incomplete = [];
+    for (const page of pages) {
+        const missing = [];
+        if (!page.og.title)
+            missing.push("og:title");
+        if (!page.og.description)
+            missing.push("og:description");
+        if (!page.og.image)
+            missing.push("og:image");
+        if (missing.length > 0) {
+            incomplete.push({ url: page.url, missing });
+        }
+    }
+    if (incomplete.length === 0)
+        return [];
+    if (incomplete.length === pages.length && pages.length > 3) {
+        const allMissing = new Set(incomplete.flatMap((i) => i.missing));
+        return [{
+                ruleId: "tech/og-completeness",
+                severity: "warning",
+                message: `All ${incomplete.length} pages are missing Open Graph tags (${Array.from(allMissing).join(", ")}).`,
+                fix: `Add Open Graph tags site-wide: ${Array.from(allMissing).join(", ")}.`,
+                relatedUrls: incomplete.map((i) => i.url).sort()
+            }];
+    }
+    return incomplete.map((item) => ({
+        ruleId: "tech/og-completeness",
+        severity: "warning",
+        message: `${item.url} is missing ${item.missing.join(", ")}.`,
+        pageUrl: item.url,
+        fix: `Add the missing Open Graph tags: ${item.missing.join(", ")}.`
+    }));
+}
+//# sourceMappingURL=og-completeness.js.map

package/dist/rules/tech/og-completeness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"og-completeness.js","sourceRoot":"","sources":["../../../src/rules/tech/og-completeness.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,MAAM,UAAU,GAA8C,EAAE,CAAC;IAEjE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK;YAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW;YAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK;YAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvC,IAAI,UAAU,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACjE,OAAO,CAAC;gBACN,MAAM,EAAE,sBAAsB;gBAC9B,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,OAAO,UAAU,CAAC,MAAM,uCAAuC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBAC7G,GAAG,EAAE,kCAAkC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAC3E,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE;aACjD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC/B,MAAM,EAAE,sBAA+B;QACvC,QAAQ,EAAE,SAAkB;QAC5B,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,eAAe,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC7D,OAAO,EAAE,IAAI,CAAC,GAAG;QACjB,GAAG,EAAE,oCAAoC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;KACpE,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/rules/tech/redirect-chain.d.ts

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

package/dist/rules/tech/redirect-chain.d.ts.map

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

package/dist/rules/tech/redirect-chain.js

@@ -0,0 +1,20 @@
+export function redirectChainRule(pages) {
+    const findings = [];
+    for (const page of pages) {
+        if (!page.httpMeta)
+            continue;
+        const hops = page.httpMeta.redirectChain.length;
+        if (hops <= 2)
+            continue;
+        findings.push({
+            ruleId: "tech/redirect-chain",
+            severity: "warning",
+            message: `${page.url} has a ${hops}-hop redirect chain before reaching ${page.httpMeta.finalUrl}.`,
+            pageUrl: page.url,
+            relatedUrls: [...page.httpMeta.redirectChain, page.httpMeta.finalUrl],
+            fix: `Reduce the redirect chain to a single hop. Update internal links and sitemap to point to ${page.httpMeta.finalUrl}.`
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=redirect-chain.js.map

package/dist/rules/tech/redirect-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect-chain.js","sourceRoot":"","sources":["../../../src/rules/tech/redirect-chain.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,SAAS;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC;QAChD,IAAI,IAAI,IAAI,CAAC;YAAE,SAAS;QAExB,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,qBAAqB;YAC7B,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,UAAU,IAAI,uCAAuC,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG;YAClG,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACrE,GAAG,EAAE,4FAA4F,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG;SAC3H,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/tech/robots-noindex-conflict.d.ts

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

package/dist/rules/tech/robots-noindex-conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots-noindex-conflict.d.ts","sourceRoot":"","sources":["../../../src/rules/tech/robots-noindex-conflict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,UAAU,EAAE,CAiCd"}

package/dist/rules/tech/robots-noindex-conflict.js

@@ -0,0 +1,30 @@
+export function robotsNoindexConflictRule(pages, inbound) {
+    const findings = [];
+    for (const page of pages) {
+        const htmlRobots = page.robotsMeta.toLowerCase();
+        const httpRobots = (page.httpMeta?.xRobotsTag ?? "").toLowerCase();
+        const isNoindex = htmlRobots.includes("noindex") || httpRobots.includes("noindex");
+        if (!isNoindex) {
+            continue;
+        }
+        const source = htmlRobots.includes("noindex") && httpRobots.includes("noindex")
+            ? "both HTML meta and X-Robots-Tag"
+            : htmlRobots.includes("noindex")
+                ? "HTML meta"
+                : "X-Robots-Tag header";
+        const inboundCount = inbound.get(page.url) ?? 0;
+        findings.push({
+            ruleId: "tech/robots-noindex-conflict",
+            severity: inboundCount > 0 ? "warning" : "info",
+            message: inboundCount > 0
+                ? `${page.url} is marked noindex (via ${source}) but has ${inboundCount} inbound internal links.`
+                : `${page.url} is marked noindex (via ${source}).`,
+            pageUrl: page.url,
+            fix: inboundCount > 0
+                ? "Either remove noindex or remove internal links pointing to this page."
+                : "Verify this page should be noindexed."
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=robots-noindex-conflict.js.map

package/dist/rules/tech/robots-noindex-conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots-noindex-conflict.js","sourceRoot":"","sources":["../../../src/rules/tech/robots-noindex-conflict.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,yBAAyB,CACvC,KAAmB,EACnB,OAA4B;IAE5B,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACnE,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC7E,CAAC,CAAC,iCAAiC;YACnC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC9B,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,qBAAqB,CAAC;QAE5B,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChD,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,8BAA8B;YACtC,QAAQ,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;YAC/C,OAAO,EACL,YAAY,GAAG,CAAC;gBACd,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,2BAA2B,MAAM,aAAa,YAAY,0BAA0B;gBACjG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,2BAA2B,MAAM,IAAI;YACtD,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,GAAG,EAAE,YAAY,GAAG,CAAC;gBACnB,CAAC,CAAC,uEAAuE;gBACzE,CAAC,CAAC,uCAAuC;SAC5C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/rules/tech/robots-sitemap-presence.d.ts

@@ -0,0 +1,3 @@
+import type { RuleResult } from "../../types.js";
+export declare function robotsSitemapPresenceRule(source: string): Promise<RuleResult[]>;
+//# sourceMappingURL=robots-sitemap-presence.d.ts.map

package/dist/rules/tech/robots-sitemap-presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots-sitemap-presence.d.ts","sourceRoot":"","sources":["../../../src/rules/tech/robots-sitemap-presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAcjD,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAqDrF"}