@pseolint/core 0.7.0 → 0.7.2

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

@@ -16,8 +16,22 @@ export function resolveCanonicalUrl(canonical, pageUrl, normalizeOpts) {
     }
     return normalizeAuditUrl(resolve(dirname(pageUrl), raw), normalizeOpts);
 }
+/** Extract the hostname from a URL string, or null if unparseable. */
+function extractHost(url) {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return null;
+    }
+}
 export function canonicalConsistencyRule(pages, knownUrls, normalizeOpts) {
+    // ── Pass 1: collect out-of-scope findings per page ──────────────────────────
+    // We separate "out-of-scope" (canonical host ≠ page host, and not in knownUrls)
+    // from other findings so we can decide whether to collapse them.
     const findings = [];
+    // Map from canonical-target-host → array of (pageUrl, canonicalUrl) that had that host
+    const outOfScopeByTargetHost = new Map();
     for (const page of pages) {
         if (!page.canonical) {
             findings.push({
@@ -40,35 +54,137 @@ export function canonicalConsistencyRule(pages, knownUrls, normalizeOpts) {
             });
             continue;
         }
-        if (canonicalUrl === page.url)
+        if (canonicalUrl === page.url) {
+            // Self-canonical: still check HTTP header conflict
+            if (page.httpMeta?.linkHeader) {
+                const linkCanonicalMatch = page.httpMeta.linkHeader.match(/<([^>]+)>;\s*rel="canonical"/i);
+                if (linkCanonicalMatch) {
+                    const httpCanonical = normalizeAuditUrl(linkCanonicalMatch[1], normalizeOpts);
+                    const htmlCanonical = resolveCanonicalUrl(page.canonical, page.url, normalizeOpts);
+                    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."
+                        });
+                    }
+                }
+            }
             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."
-                    });
+        }
+        // canonical differs from page.url
+        const pageHost = extractHost(page.url);
+        const canonicalHost = extractHost(canonicalUrl);
+        const isOutOfScope = !knownUrls.has(canonicalUrl);
+        const isCrossHost = pageHost !== null && canonicalHost !== null && canonicalHost !== pageHost;
+        if (isOutOfScope && isCrossHost) {
+            // Candidate for collapsing — defer into the bucket keyed by target host
+            const bucket = outOfScopeByTargetHost.get(canonicalHost) ?? [];
+            bucket.push({ pageUrl: page.url, canonicalUrl });
+            outOfScopeByTargetHost.set(canonicalHost, bucket);
+        }
+        else {
+            // Either within-scope (warning) or same-host out-of-scope — emit per-page
+            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."
+            });
+            // HTTP header conflict check (only when we haven't already decided to collapse)
+            if (page.httpMeta?.linkHeader) {
+                const linkCanonicalMatch = page.httpMeta.linkHeader.match(/<([^>]+)>;\s*rel="canonical"/i);
+                if (linkCanonicalMatch) {
+                    const httpCanonical = normalizeAuditUrl(linkCanonicalMatch[1], normalizeOpts);
+                    const htmlCanonical = resolveCanonicalUrl(page.canonical, page.url, normalizeOpts);
+                    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."
+                        });
+                    }
+                }
+            }
+        }
+    }
+    // ── Pass 2: collapse uniform out-of-scope buckets ───────────────────────────
+    // Strategy: if ALL pages point to the SAME alternate host (one bucket with all
+    // out-of-scope cross-host pages), emit ONE site-level info. If multiple target
+    // hosts exist (inconsistent), keep per-page findings.
+    const buckets = [...outOfScopeByTargetHost.entries()];
+    if (buckets.length === 0) {
+        // Nothing to collapse
+    }
+    else if (buckets.length === 1) {
+        // Every cross-host out-of-scope canonical goes to the same alternate host → collapse
+        const [targetHost, entries] = buckets[0];
+        const count = entries.length;
+        // Infer the crawled host from the first page in the bucket
+        const crawledHost = extractHost(entries[0].pageUrl) ?? "the crawled host";
+        // If there is only ONE page total pointing to the alternate host,
+        // still emit a per-page finding (no "site-level" implication with a single page).
+        if (count === 1) {
+            const { pageUrl, canonicalUrl } = entries[0];
+            findings.push({
+                ruleId: "tech/canonical-consistency",
+                severity: "info",
+                message: `${pageUrl} canonicalizes outside the crawl scope (${canonicalUrl}).`,
+                pageUrl,
+                relatedUrls: [canonicalUrl],
+                fix: "Verify this canonical target is intentional."
+            });
+        }
+        else {
+            findings.push({
+                ruleId: "tech/canonical-consistency",
+                severity: "info",
+                message: `${count} pages canonicalize to ${targetHost}, outside the crawled host ${crawledHost} — expected if you crawled a staging/preview origin.`,
+                relatedUrls: entries.map((e) => e.canonicalUrl).slice(0, 10),
+                fix: "If this site is live at the canonical host, the canonicals are correct. If not, verify the canonical URLs."
+            });
+        }
+    }
+    else {
+        // Multiple target hosts — inconsistent cross-host canonicals → per-page findings
+        for (const [, entries] of buckets) {
+            for (const { pageUrl, canonicalUrl } of entries) {
+                findings.push({
+                    ruleId: "tech/canonical-consistency",
+                    severity: "info",
+                    message: `${pageUrl} canonicalizes outside the crawl scope (${canonicalUrl}).`,
+                    pageUrl,
+                    relatedUrls: [canonicalUrl],
+                    fix: "Verify this canonical target is intentional."
+                });
+                // HTTP header conflict check for deferred pages
+                const pageDef = pages.find((p) => p.url === pageUrl);
+                if (pageDef?.httpMeta?.linkHeader) {
+                    const linkCanonicalMatch = pageDef.httpMeta.linkHeader.match(/<([^>]+)>;\s*rel="canonical"/i);
+                    if (linkCanonicalMatch) {
+                        const httpCanonical = normalizeAuditUrl(linkCanonicalMatch[1], normalizeOpts);
+                        const htmlCanonical = resolveCanonicalUrl(pageDef.canonical, pageDef.url, normalizeOpts);
+                        if (httpCanonical && htmlCanonical && httpCanonical !== htmlCanonical) {
+                            findings.push({
+                                ruleId: "tech/canonical-consistency",
+                                severity: "error",
+                                message: `${pageUrl} has conflicting canonical URLs: HTML says ${htmlCanonical}, HTTP Link header says ${httpCanonical}.`,
+                                pageUrl,
+                                relatedUrls: [htmlCanonical, httpCanonical],
+                                fix: "Ensure the HTML <link rel='canonical'> and HTTP Link header agree on the canonical URL."
+                            });
+                        }
+                    }
                 }
             }
         }

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

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

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

@@ -6,9 +6,14 @@ import type { ParsedPage, RuleResult } from "../../types.js";
  *
  * Required: og:title, og:description, og:image.
  *
- * The rule was referenced in the v0.4.x README without ever shipping. The
- * 2026-05-03 blind-spot audit surfaced it as a tier-1 gap; this is the
- * v0.5.2 fix.
+ * Severity gradation:
+ *   - warning: og:title or og:description is missing (core social-card identity
+ *              fields that affect how a link appears in feeds and AI summaries).
+ *   - info:    only og:image is missing (cosmetic — the card still has a title
+ *              and description; the missing image is low-priority).
+ *
+ * Presence check: a field is considered MISSING when it is absent, empty, or
+ * whitespace-only (value is trimmed before evaluation).
  */
 export declare function ogCompletenessRule(pages: ParsedPage[]): RuleResult[];
 //# sourceMappingURL=og-completeness.d.ts.map

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

@@ -1 +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;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAiBpE"}
+{"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;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAsBpE"}

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

@@ -5,25 +5,33 @@
  *
  * Required: og:title, og:description, og:image.
  *
- * The rule was referenced in the v0.4.x README without ever shipping. The
- * 2026-05-03 blind-spot audit surfaced it as a tier-1 gap; this is the
- * v0.5.2 fix.
+ * Severity gradation:
+ *   - warning: og:title or og:description is missing (core social-card identity
+ *              fields that affect how a link appears in feeds and AI summaries).
+ *   - info:    only og:image is missing (cosmetic — the card still has a title
+ *              and description; the missing image is low-priority).
+ *
+ * Presence check: a field is considered MISSING when it is absent, empty, or
+ * whitespace-only (value is trimmed before evaluation).
  */
 export function ogCompletenessRule(pages) {
     const findings = [];
     for (const page of pages) {
         const missing = [];
-        if (!page.og.title)
+        if (!page.og.title.trim())
             missing.push("og:title");
-        if (!page.og.description)
+        if (!page.og.description.trim())
             missing.push("og:description");
-        if (!page.og.image)
+        if (!page.og.image.trim())
             missing.push("og:image");
         if (missing.length === 0)
             continue;
+        const missingCore = missing.some((f) => f === "og:title" || f === "og:description");
+        const severity = missingCore ? "warning" : "info";
         findings.push({
             ruleId: "tech/og-completeness",
-            severity: "warning",
+            severity,
+            confidence: missingCore ? "high" : "medium",
             message: `${page.url} is missing Open Graph tags: ${missing.join(", ")}.`,
             pageUrl: page.url,
             fix: `Add the missing meta tags inside <head>: ${missing.map((tag) => `<meta property="${tag}" content="...">`).join(" ")}.`,

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

@@ -1 +1 @@
-{"version":3,"file":"og-completeness.js","sourceRoot":"","sources":["../../../src/rules/tech/og-completeness.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,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,KAAK,CAAC;YAAE,SAAS;QACnC,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,sBAAsB;YAC9B,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,gCAAgC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACzE,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,GAAG,EAAE,4CAA4C,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;SAC7H,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"og-completeness.js","sourceRoot":"","sources":["../../../src/rules/tech/og-completeness.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE;YAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE;YAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE;YAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEnC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,gBAAgB,CAAC,CAAC;QACpF,MAAM,QAAQ,GAA2B,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAE1E,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,sBAAsB;YAC9B,QAAQ;YACR,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;YAC3C,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,gCAAgC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACzE,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,GAAG,EAAE,4CAA4C,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;SAC7H,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -1,3 +1,15 @@
-import type { ParsedPage, RuleResult } from "../../types.js";
-export declare function sitemapCompletenessRule(pages: ParsedPage[], sitemapUrls: Set<string>): RuleResult[];
+import type { NormalizeUrlOptions, ParsedPage, RuleResult } from "../../types.js";
+export interface SitemapCompletenessOptions {
+    /**
+     * True when the audit ran on a sampled or link-discovery crawl.
+     * On sampled crawls it is normal to find pages not listed in the sitemap
+     * (they were discovered via links, not sitemap), so the aggregate
+     * "missing from sitemap" finding is demoted to `warning`.
+     * Wire this from the auditor's `isSampledAudit` flag.
+     */
+    sampled?: boolean;
+    /** URL normalization options that match what the auditor used when building page.url. */
+    normalizeUrlOptions?: NormalizeUrlOptions;
+}
+export declare function sitemapCompletenessRule(pages: ParsedPage[], sitemapUrls: Set<string>, options?: SitemapCompletenessOptions): RuleResult[];
 //# sourceMappingURL=sitemap-completeness.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sitemap-completeness.d.ts","sourceRoot":"","sources":["../../../src/rules/tech/sitemap-completeness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EAAE,EACnB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,UAAU,EAAE,CA0Dd"}
+{"version":3,"file":"sitemap-completeness.d.ts","sourceRoot":"","sources":["../../../src/rules/tech/sitemap-completeness.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAElF,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yFAAyF;IACzF,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EAAE,EACnB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,OAAO,CAAC,EAAE,0BAA0B,GACnC,UAAU,EAAE,CA6Ed"}

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

@@ -1,19 +1,30 @@
-export function sitemapCompletenessRule(pages, sitemapUrls) {
+import { normalizeAuditUrl } from "../../url-normalize.js";
+export function sitemapCompletenessRule(pages, sitemapUrls, options) {
     if (sitemapUrls.size === 0)
         return [];
+    const { sampled = false, normalizeUrlOptions } = options ?? {};
+    // Normalize sitemap URLs to match the already-normalized page.url values.
+    // page.url is produced by normalizeAuditUrl (via parseHtmlPage → parser.ts),
+    // so comparing raw sitemap XML URLs against it produces false positives for
+    // trailing slashes, query strings, and hash fragments.
+    const normalizedSitemapUrls = new Set([...sitemapUrls].map((u) => normalizeAuditUrl(u, normalizeUrlOptions)));
     const findings = [];
-    const missingFromSitemap = pages.filter((p) => !sitemapUrls.has(p.url));
+    // "missing from sitemap" — demoted to `warning` because:
+    //  • on a sampled crawl many pages were found via link discovery, not sitemap
+    //  • even on a full crawl this is advisory (Google discovers via crawl too)
+    // The genuine hard-error signal is the 4xx/5xx sub-check below.
+    const missingFromSitemap = pages.filter((p) => !normalizedSitemapUrls.has(p.url));
     if (missingFromSitemap.length > 0) {
         findings.push({
             ruleId: "tech/sitemap-completeness",
-            severity: "error",
+            severity: "warning",
             message: `${missingFromSitemap.length} crawlable page(s) not in sitemap.`,
             fix: "Add these pages to your sitemap.xml to ensure Google discovers them.",
             relatedUrls: missingFromSitemap.map((p) => p.url).sort()
         });
     }
     for (const page of pages) {
-        if (!page.httpMeta || !sitemapUrls.has(page.url))
+        if (!page.httpMeta || !normalizedSitemapUrls.has(page.url))
             continue;
         if (page.httpMeta.statusCode >= 400) {
             findings.push({
@@ -35,8 +46,13 @@ export function sitemapCompletenessRule(pages, sitemapUrls) {
             });
         }
     }
+    // NOTE: the noindex-in-sitemap sub-check below duplicates `robots-noindex-conflict`
+    // and `canonical-noindex-conflict`. It is intentionally kept here because
+    // sitemap-completeness is the only rule that sees the sitemap set directly and
+    // can phrase the finding as "you're signalling two contradictory things to
+    // Google via the sitemap". Removing it would lose the sitemap-specific framing.
     for (const page of pages) {
-        if (!sitemapUrls.has(page.url))
+        if (!normalizedSitemapUrls.has(page.url))
             continue;
         const hasNoindex = /noindex/i.test(page.robotsMeta) ||
             (page.httpMeta?.xRobotsTag != null && /noindex/i.test(page.httpMeta.xRobotsTag));

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

@@ -1 +1 @@
-{"version":3,"file":"sitemap-completeness.js","sourceRoot":"","sources":["../../../src/rules/tech/sitemap-completeness.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,uBAAuB,CACrC,KAAmB,EACnB,WAAwB;IAExB,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,MAAM,kBAAkB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxE,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,2BAA2B;YACnC,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,GAAG,kBAAkB,CAAC,MAAM,oCAAoC;YACzE,GAAG,EAAE,sEAAsE;YAC3E,WAAW,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE;SACzD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QAE3D,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,2BAA2B;gBACnC,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,eAAe,IAAI,CAAC,GAAG,iBAAiB,IAAI,CAAC,QAAQ,CAAC,UAAU,GAAG;gBAC5E,OAAO,EAAE,IAAI,CAAC,GAAG;gBACjB,GAAG,EAAE,sEAAsE;aAC5E,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;YAClF,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,2BAA2B;gBACnC,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,eAAe,IAAI,CAAC,GAAG,iBAAiB,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG;gBAC1E,OAAO,EAAE,IAAI,CAAC,GAAG;gBACjB,WAAW,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACrC,GAAG,EAAE,4CAA4C,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE;aAC1E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QACzC,MAAM,UAAU,GACd,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;YAChC,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,IAAI,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QACnF,IAAI,UAAU,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,2BAA2B;gBACnC,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,iDAAiD;gBACrE,OAAO,EAAE,IAAI,CAAC,GAAG;gBACjB,GAAG,EAAE,oEAAoE;aAC1E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"sitemap-completeness.js","sourceRoot":"","sources":["../../../src/rules/tech/sitemap-completeness.ts"],"names":[],"mappings":"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"}

package/dist/rules/tech/soft-404.d.ts

@@ -1,3 +1,14 @@
 import type { ParsedPage, RuleResult } from "../../types.js";
+/**
+ * Confidence model for soft-404 detection:
+ *
+ *   Signal A — thin body (wordCount < THIN_BODY_THRESHOLD)
+ *   Signal B — soft-404 pattern in title, h1, or opening content
+ *
+ *   A AND B  → warning / high  (strong: both signals agree)
+ *   B only   → info / low      (weak: substantive body, pattern might be
+ *                                editorial, e.g. "How we handle 404 errors")
+ *   A only   → no finding      (stub/coming-soon pages are legit)
+ */
 export declare function soft404Rule(pages: ParsedPage[]): RuleResult[];
 //# sourceMappingURL=soft-404.d.ts.map

package/dist/rules/tech/soft-404.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"soft-404.d.ts","sourceRoot":"","sources":["../../../src/rules/tech/soft-404.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI7D,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAsB7D"}
+{"version":3,"file":"soft-404.d.ts","sourceRoot":"","sources":["../../../src/rules/tech/soft-404.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAe7D;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CA+C7D"}

package/dist/rules/tech/soft-404.js

@@ -1,4 +1,23 @@
-const SOFT_404_PATTERNS = /\b(not\s*found|404|page\s*missing|does\s*not\s*exist|no\s*longer\s*available)\b/i;
+// ponytail: thin-body threshold. Nav/chrome inflate raw word counts; 50 is
+// already generous — pages that are genuinely soft-404s rarely exceed it.
+const THIN_BODY_THRESHOLD = 50;
+// ponytail: how many words of contentText to scan for a pattern signal.
+// Scanning the full body risks matching editorial mentions of "404" deep in an
+// article; the first 120 words (roughly two paragraphs) is enough to catch
+// real error templates.
+const CONTENT_SCAN_WORDS = 120;
+const SOFT_404_PATTERNS = /\b(not\s*found|404|page\s*missing|does\s*not\s*exist|no\s*longer\s*available|page\s*does\s*not\s*exist)\b/i;
+/**
+ * Confidence model for soft-404 detection:
+ *
+ *   Signal A — thin body (wordCount < THIN_BODY_THRESHOLD)
+ *   Signal B — soft-404 pattern in title, h1, or opening content
+ *
+ *   A AND B  → warning / high  (strong: both signals agree)
+ *   B only   → info / low      (weak: substantive body, pattern might be
+ *                                editorial, e.g. "How we handle 404 errors")
+ *   A only   → no finding      (stub/coming-soon pages are legit)
+ */
 export function soft404Rule(pages) {
     const findings = [];
     for (const page of pages) {
@@ -7,17 +26,40 @@ export function soft404Rule(pages) {
         if (page.httpMeta.statusCode !== 200)
             continue;
         const wordCount = page.contentText.split(/\s+/).filter(Boolean).length;
-        if (wordCount >= 50)
-            continue;
-        if (SOFT_404_PATTERNS.test(page.title)) {
+        const signalA = wordCount < THIN_BODY_THRESHOLD;
+        // Signal B: check title, first h1, and opening words of contentText
+        const h1 = page.headings.h1[0] ?? "";
+        const openingText = page.contentText
+            .split(/\s+/)
+            .filter(Boolean)
+            .slice(0, CONTENT_SCAN_WORDS)
+            .join(" ");
+        const signalB = SOFT_404_PATTERNS.test(page.title) ||
+            SOFT_404_PATTERNS.test(h1) ||
+            SOFT_404_PATTERNS.test(openingText);
+        if (signalA && signalB) {
+            // Strong signal: thin body AND pattern match → warning/high
             findings.push({
                 ruleId: "tech/soft-404",
-                severity: "error",
+                severity: "warning",
+                confidence: "high",
                 message: `${page.url} returns HTTP 200 but appears to be an error page (title: "${page.title}", ${wordCount} words).`,
                 pageUrl: page.url,
                 fix: "Return a proper HTTP 404 status code for error pages instead of 200."
             });
         }
+        else if (signalB) {
+            // Weak signal: pattern match only, substantive body → info/low
+            findings.push({
+                ruleId: "tech/soft-404",
+                severity: "info",
+                confidence: "low",
+                message: `${page.url} returns HTTP 200 and mentions error-page language in its title or headings (title: "${page.title}", ${wordCount} words). Verify this is intentional content, not a misconfigured soft-404.`,
+                pageUrl: page.url,
+                fix: "If this is an error page, return HTTP 404. If the content is intentional, consider renaming the page title or heading to avoid soft-404 signals."
+            });
+        }
+        // signalA only (thin body, no pattern) → no finding; stub pages are legit
     }
     return findings;
 }

package/dist/rules/tech/soft-404.js.map

@@ -1 +1 @@
-{"version":3,"file":"soft-404.js","sourceRoot":"","sources":["../../../src/rules/tech/soft-404.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAAG,kFAAkF,CAAC;AAE7G,MAAM,UAAU,WAAW,CAAC,KAAmB;IAC7C,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,SAAS;QAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,KAAK,GAAG;YAAE,SAAS;QAE/C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QACvE,IAAI,SAAS,IAAI,EAAE;YAAE,SAAS;QAE9B,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,eAAe;gBACvB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,8DAA8D,IAAI,CAAC,KAAK,MAAM,SAAS,UAAU;gBACrH,OAAO,EAAE,IAAI,CAAC,GAAG;gBACjB,GAAG,EAAE,sEAAsE;aAC5E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"soft-404.js","sourceRoot":"","sources":["../../../src/rules/tech/soft-404.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,0EAA0E;AAC1E,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,wEAAwE;AACxE,+EAA+E;AAC/E,2EAA2E;AAC3E,wBAAwB;AACxB,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAM,iBAAiB,GACrB,4GAA4G,CAAC;AAE/G;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,KAAmB;IAC7C,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,SAAS;QAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,KAAK,GAAG;YAAE,SAAS;QAE/C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QACvE,MAAM,OAAO,GAAG,SAAS,GAAG,mBAAmB,CAAC;QAEhD,oEAAoE;QACpE,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW;aACjC,KAAK,CAAC,KAAK,CAAC;aACZ,MAAM,CAAC,OAAO,CAAC;aACf,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC;aAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,MAAM,OAAO,GACX,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAClC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEtC,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;YACvB,4DAA4D;YAC5D,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,eAAe;gBACvB,QAAQ,EAAE,SAAS;gBACnB,UAAU,EAAE,MAAM;gBAClB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,8DAA8D,IAAI,CAAC,KAAK,MAAM,SAAS,UAAU;gBACrH,OAAO,EAAE,IAAI,CAAC,GAAG;gBACjB,GAAG,EAAE,sEAAsE;aAC5E,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,EAAE,CAAC;YACnB,+DAA+D;YAC/D,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,eAAe;gBACvB,QAAQ,EAAE,MAAM;gBAChB,UAAU,EAAE,KAAK;gBACjB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,wFAAwF,IAAI,CAAC,KAAK,MAAM,SAAS,4EAA4E;gBACjN,OAAO,EAAE,IAAI,CAAC,GAAG;gBACjB,GAAG,EAAE,kJAAkJ;aACxJ,CAAC,CAAC;QACL,CAAC;QACD,0EAA0E;IAC5E,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/template-detection.d.ts

@@ -48,4 +48,5 @@ export declare function buildUrlToTemplateMap(candidates: TemplateCandidate[]):
  * Requires ≥ 2 QUALIFYING (non-longtail) templates per §15.3.
  */
 export declare function shouldActivateTemplateScoring(candidates: TemplateCandidate[]): boolean;
+export declare function normalizePathToTemplate(pathname: string): string;
 //# sourceMappingURL=template-detection.d.ts.map

package/dist/template-detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-detection.d.ts","sourceRoot":"","sources":["../src/template-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,oDAAoD;AACpD,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE,CAmDnE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ1F;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAGtF"}
+{"version":3,"file":"template-detection.d.ts","sourceRoot":"","sources":["../src/template-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,oDAAoD;AACpD,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE,CAmDnE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ1F;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAGtF;AAoBD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmBhE"}

package/dist/template-detection.js

@@ -113,7 +113,7 @@ function urlToNormalizedTemplate(url) {
         return null;
     }
 }
-function normalizePathToTemplate(pathname) {
+export function normalizePathToTemplate(pathname) {
     let p = pathname || "/";
     if (p.length > 1 && p.endsWith("/"))
         p = p.slice(0, -1);

package/dist/template-detection.js.map

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

package/dist/types.d.ts

@@ -381,6 +381,11 @@ export interface AuditSummary {
      * Present only when `truncated` is true.
      */
     truncatedKind?: "backpressure" | "coverage";
+    /** Resolved domain authority used to moderate the verdict (0–100), with sources. Absent when unavailable. */
+    authority?: {
+        score: number;
+        domain: string;
+    };
 }
 /**
  * v0.5+ change-driven monitoring summary surfaced on AuditSummary so dashboards
@@ -438,7 +443,11 @@ export interface AuditOptions {
         publicationVelocityMaxPerDayCorpusFraction?: number;
         boilerplateMaxRatio?: number;
         templateDiversityMinUniqueRatio?: number;
-        uniqueValueMinWords?: number;
+        /** content/unique-value density floors. Default { passBelow: 0.20, errorBelow: 0.12 }. */
+        uniqueValueDensity?: {
+            passBelow: number;
+            errorBelow: number;
+        };
         metaUniquenessMinJaccard?: number;
         linkDepthMaxClicks?: number;
         templateCoverageMinPages?: number;
@@ -527,6 +536,8 @@ export interface AuditOptions {
         pattern: string;
         flags?: string;
     }>;
+    /** Auto-derive entity-mask patterns from the corpus (default true). Set false to A/B compare. */
+    autoEntityMask?: boolean;
     /** Source data records for data-binding verification. */
     dataSource?: DataSourceOptions;
     /** HTTP cache configuration. When omitted, caching is disabled. */
@@ -566,6 +577,10 @@ export interface AuditOptions {
      * Omitted = no shift (back-compat).
      */
     authorityScore?: number;
+    /** OpenPageRank API key; enables live authority lookup when authorityScore is not supplied. */
+    openPageRankApiKey?: string;
+    /** Custom authority provider (overrides the default OPR/CC composite). For tests + offline corpora. */
+    authorityProvider?: import("./algorithms/authority/provider.js").AuthorityProvider;
     /** Run state persistence. When omitted, no state is written. */
     state?: StateOptions;
     /**