@rivi-software/agentic-seo-check 0.0.0-stage → 0.1.1

package/dist/core/rules/links.js

@@ -0,0 +1,107 @@
+import { isGenericAnchor } from "../html/text.js";
+import { cap, defineRule, GOOGLE_DOCS } from "./rule.js";
+export const linkRules = [
+    defineRule({
+        id: "links.no-internal",
+        category: "links",
+        severity: "warning",
+        description: "The page has no internal links, so crawlers cannot reach other pages from it and it passes no authority onward.",
+        recommendation: "Link to related pages and the main navigation with plain <a href> elements.",
+        docs: GOOGLE_DOCS.links,
+    }, ({ page }, make) => page.links.some((l) => l.internal)
+        ? null
+        : make("Page contains no internal links.", {
+            evidence: { totalLinks: page.links.length },
+        })),
+    defineRule({
+        id: "links.empty-anchor",
+        category: "links",
+        severity: "warning",
+        description: "Links without any accessible name (no text, aria-label, title or image alt).",
+        recommendation: "Add descriptive link text, or aria-label for icon links. Empty links tell crawlers nothing about the target page.",
+        docs: GOOGLE_DOCS.links,
+    }, ({ page }, make) => {
+        const empty = page.links.filter((l) => l.url && !l.hasAccessibleName);
+        return empty.length
+            ? make(`${empty.length} link(s) have no accessible text.`, {
+                evidence: {
+                    count: empty.length,
+                    examples: cap(empty.map((l) => l.href)),
+                },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "links.generic-anchor-text",
+        category: "links",
+        severity: "info",
+        description: 'Links whose text is generic ("click here", "read more", "learn more").',
+        recommendation: 'Use anchor text that describes the destination, e.g. "pricing plans" instead of "click here".',
+        docs: GOOGLE_DOCS.links,
+    }, ({ page }, make) => {
+        const generic = page.links.filter((l) => l.url && l.text && isGenericAnchor(l.text));
+        return generic.length
+            ? make(`${generic.length} link(s) use generic anchor text.`, {
+                evidence: {
+                    count: generic.length,
+                    examples: cap(generic.map((l) => ({ text: l.text, href: l.href }))),
+                },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "links.uncrawlable-href",
+        category: "links",
+        severity: "info",
+        description: 'Anchors whose href is "#", empty, or a javascript: URL. Crawlers cannot follow them.',
+        recommendation: "Use <button> for actions. For navigation, give the anchor a real URL even when JavaScript intercepts the click.",
+        docs: GOOGLE_DOCS.links,
+    }, ({ page }, make) => {
+        const bad = page.links.filter((l) => l.href === "" || l.href === "#" || /^javascript:/iu.test(l.href));
+        return bad.length
+            ? make(`${bad.length} anchor(s) have an uncrawlable href.`, {
+                evidence: {
+                    count: bad.length,
+                    examples: cap(bad.map((l) => ({ href: l.href, text: l.text }))),
+                },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "links.insecure-internal",
+        category: "links",
+        severity: "warning",
+        description: "Internal links use http:// while the page is served over https://.",
+        recommendation: "Update internal links to https:// (or use relative URLs) to avoid an extra redirect on every click and crawl.",
+        docs: GOOGLE_DOCS.redirects,
+    }, ({ page, source }, make) => {
+        if (source !== "url" || !page.url.startsWith("https://")) {
+            return null;
+        }
+        const insecure = page.links.filter((l) => l.internal && l.url?.startsWith("http://"));
+        return insecure.length
+            ? make(`${insecure.length} internal link(s) point to http:// URLs.`, {
+                evidence: {
+                    count: insecure.length,
+                    examples: cap(insecure.map((l) => l.url)),
+                },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "links.nofollow-internal",
+        category: "links",
+        severity: "info",
+        description: 'Internal links carry rel="nofollow".',
+        recommendation: "Remove nofollow from internal links unless the target is intentionally kept out of the index; nofollow on internal links wastes crawl signals.",
+        docs: GOOGLE_DOCS.links,
+    }, ({ page }, make) => {
+        const nf = page.links.filter((l) => l.internal && l.nofollow);
+        return nf.length
+            ? make(`${nf.length} internal link(s) are rel="nofollow".`, {
+                evidence: { count: nf.length, examples: cap(nf.map((l) => l.url)) },
+            })
+            : null;
+    }),
+];
+//# sourceMappingURL=links.js.map

package/dist/core/rules/links.js.map

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

package/dist/core/rules/meta.d.ts

@@ -0,0 +1 @@
+export declare const metaRules: import("./rule.js").Rule[];

package/dist/core/rules/meta.js

@@ -0,0 +1,81 @@
+import { normalizeForComparison } from "../html/text.js";
+import { defineRule, GOOGLE_DOCS } from "./rule.js";
+const SELECTOR = 'head > meta[name="description"]';
+export const metaRules = [
+    defineRule({
+        id: "meta-description.missing",
+        category: "meta",
+        severity: "warning",
+        description: 'No <meta name="description"> is present or it is empty.',
+        recommendation: "Add a unique meta description (about 70-160 characters) that summarises the page and invites the click. Search engines may show it as the snippet.",
+        docs: GOOGLE_DOCS.snippets,
+    }, ({ page }, make) => page.metaDescription
+        ? null
+        : make("Page has no meta description.", { selector: SELECTOR })),
+    defineRule({
+        id: "meta-description.multiple",
+        category: "meta",
+        severity: "warning",
+        description: "More than one meta description is present.",
+        recommendation: "Keep a single meta description; remove or merge the others.",
+        docs: GOOGLE_DOCS.snippets,
+    }, ({ page }, make) => page.metaDescriptions.length > 1
+        ? make(`Page has ${page.metaDescriptions.length} meta description tags.`, {
+            selector: SELECTOR,
+            evidence: { descriptions: page.metaDescriptions },
+        })
+        : null),
+    defineRule({
+        id: "meta-description.too-long",
+        category: "meta",
+        severity: "warning",
+        description: "Meta description exceeds the configured maximum (default 160 characters) and will be truncated.",
+        recommendation: "Trim the description to about 160 characters, front-loading the key message.",
+        docs: GOOGLE_DOCS.snippets,
+    }, ({ page, thresholds }, make) => page.metaDescription &&
+        page.metaDescription.length > thresholds.descriptionMaxChars
+        ? make(`Meta description is ${page.metaDescription.length} characters (max ${thresholds.descriptionMaxChars}).`, {
+            selector: SELECTOR,
+            evidence: {
+                description: page.metaDescription,
+                length: page.metaDescription.length,
+                max: thresholds.descriptionMaxChars,
+            },
+        })
+        : null),
+    defineRule({
+        id: "meta-description.too-short",
+        category: "meta",
+        severity: "info",
+        description: "Meta description is shorter than the configured minimum (default 70 characters).",
+        recommendation: "Expand the description so it summarises the page content and its value to the visitor.",
+        docs: GOOGLE_DOCS.snippets,
+    }, ({ page, thresholds }, make) => page.metaDescription &&
+        page.metaDescription.length < thresholds.descriptionMinChars
+        ? make(`Meta description is only ${page.metaDescription.length} characters (recommended at least ${thresholds.descriptionMinChars}).`, {
+            selector: SELECTOR,
+            evidence: {
+                description: page.metaDescription,
+                length: page.metaDescription.length,
+                min: thresholds.descriptionMinChars,
+            },
+        })
+        : null),
+    defineRule({
+        id: "meta-description.same-as-title",
+        category: "meta",
+        severity: "info",
+        description: "Meta description is identical to the title.",
+        recommendation: "Write a description that adds information beyond the title instead of repeating it.",
+        docs: GOOGLE_DOCS.snippets,
+    }, ({ page }, make) => page.metaDescription &&
+        page.title &&
+        normalizeForComparison(page.metaDescription) ===
+            normalizeForComparison(page.title)
+        ? make("Meta description repeats the title verbatim.", {
+            selector: SELECTOR,
+            evidence: { title: page.title },
+        })
+        : null),
+];
+//# sourceMappingURL=meta.js.map

package/dist/core/rules/meta.js.map

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

package/dist/core/rules/response.d.ts

@@ -0,0 +1 @@
+export declare const responseRules: import("./rule.js").Rule[];

package/dist/core/rules/response.js

@@ -0,0 +1,93 @@
+import { isLocalHost } from "./canonical.js";
+import { defineRule, GOOGLE_DOCS } from "./rule.js";
+export const responseRules = [
+    defineRule({
+        id: "response.error-status",
+        category: "response",
+        severity: "error",
+        description: "The URL returned a 4xx or 5xx status code.",
+        recommendation: "Fix the route or server error. If the page was removed on purpose, return 410 (or 404) and remove internal links and sitemap entries pointing to it.",
+    }, ({ response }, make) => response?.status && response.status >= 400
+        ? make(`URL returned HTTP ${response.status}.`, {
+            evidence: { status: response.status, finalUrl: response.finalUrl },
+        })
+        : null),
+    defineRule({
+        id: "response.redirected",
+        category: "response",
+        severity: "info",
+        description: "The requested URL redirected to another URL.",
+        recommendation: "Link directly to the final URL (internal links, sitemap, canonical) so crawlers and users skip the redirect.",
+        docs: GOOGLE_DOCS.redirects,
+    }, ({ response }, make) => {
+        const [hop] = response?.redirectChain ?? [];
+        return response && hop && response.redirectChain.length === 1
+            ? make(`Request redirected (${hop.status}) to ${response.finalUrl}.`, {
+                evidence: {
+                    chain: response.redirectChain,
+                    finalUrl: response.finalUrl,
+                },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "response.redirect-chain",
+        category: "response",
+        severity: "warning",
+        description: "The URL goes through two or more redirects before reaching the final page.",
+        recommendation: "Collapse the chain so the first URL redirects straight to the final destination. Each hop costs crawl budget and loses some signal.",
+        docs: GOOGLE_DOCS.redirects,
+    }, ({ response }, make) => response && response.redirectChain.length >= 2
+        ? make(`Redirect chain of ${response.redirectChain.length} hops ends at ${response.finalUrl}.`, {
+            evidence: {
+                chain: response.redirectChain,
+                finalUrl: response.finalUrl,
+            },
+        })
+        : null),
+    defineRule({
+        id: "response.slow",
+        category: "response",
+        severity: "warning",
+        description: "The HTML response took longer than the configured threshold (default 2000 ms).",
+        recommendation: "Reduce server response time: cache the HTML, avoid blocking data fetches during render, use a CDN. Google recommends TTFB under 800 ms.",
+        docs: GOOGLE_DOCS.cwv,
+    }, ({ response, thresholds }, make) => response?.timeMs !== null &&
+        response?.timeMs !== undefined &&
+        response.timeMs > thresholds.slowResponseMs
+        ? make(`HTML response took ${response.timeMs} ms (single measurement; threshold ${thresholds.slowResponseMs} ms).`, { evidence: { timeMs: response.timeMs } })
+        : null),
+    defineRule({
+        id: "response.not-html",
+        category: "response",
+        severity: "warning",
+        description: "The response Content-Type is not HTML.",
+        recommendation: "Serve pages with Content-Type: text/html; charset=utf-8.",
+    }, ({ response }, make) => {
+        const contentType = response?.contentType;
+        if (!contentType) {
+            return null;
+        }
+        const ct = contentType.toLowerCase();
+        return !ct.includes("html") && !ct.includes("xhtml")
+            ? make(`Content-Type is "${contentType}", not HTML.`, {
+                evidence: { contentType },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "response.not-https",
+        category: "response",
+        severity: "warning",
+        description: "The final URL is served over plain http.",
+        recommendation: "Serve the site over https and redirect http to https. HTTPS is a (light) ranking signal and required for many browser features.",
+    }, ({ response, source }, make) => source === "url" &&
+        response &&
+        response.finalUrl.startsWith("http://") &&
+        !isLocalHost(response.finalUrl)
+        ? make("Page is served over http:// instead of https://.", {
+            evidence: { finalUrl: response.finalUrl },
+        })
+        : null),
+];
+//# sourceMappingURL=response.js.map

package/dist/core/rules/response.js.map

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

package/dist/core/rules/rule.d.ts

@@ -0,0 +1,42 @@
+import type { ExtractedPage, Finding, PageSource, ResponseInfo, RuleMeta, Severity, Thresholds } from "../types.js";
+export interface PageContext {
+    page: ExtractedPage;
+    source: PageSource;
+    response?: ResponseInfo;
+    keyword?: string;
+    thresholds: Thresholds;
+    depth?: number;
+}
+export interface Rule {
+    meta: RuleMeta;
+    check: (ctx: PageContext) => Finding[];
+}
+export interface FindingExtras {
+    severity?: Severity;
+    recommendation?: string;
+    selector?: string;
+    evidence?: Finding["evidence"];
+}
+/** Build a finding from rule metadata, overriding only what differs for this instance. */
+export declare const finding: (meta: RuleMeta, message: string, extras?: FindingExtras) => Finding;
+export declare const defineRule: (meta: RuleMeta, check: (ctx: PageContext, make: (message: string, extras?: FindingExtras) => Finding) => Finding[] | Finding | null | undefined) => Rule;
+export declare const cap: <T>(items: T[], max?: number) => T[];
+export declare const GOOGLE_DOCS: {
+    readonly titles: "https://developers.google.com/search/docs/appearance/title-link";
+    readonly snippets: "https://developers.google.com/search/docs/appearance/snippet";
+    readonly canonical: "https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls";
+    readonly robotsMeta: "https://developers.google.com/search/docs/crawling-indexing/robots-meta-tag";
+    readonly robotsTxt: "https://developers.google.com/search/docs/crawling-indexing/robots/intro";
+    readonly sitemaps: "https://developers.google.com/search/docs/crawling-indexing/sitemaps/overview";
+    readonly hreflang: "https://developers.google.com/search/docs/specialty/international/localized-versions";
+    readonly images: "https://developers.google.com/search/docs/appearance/google-images";
+    readonly links: "https://developers.google.com/search/docs/crawling-indexing/links-crawlable";
+    readonly structuredData: "https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data";
+    readonly javascript: "https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics";
+    readonly cwv: "https://web.dev/articles/vitals";
+    readonly mobile: "https://developers.google.com/search/docs/crawling-indexing/mobile/mobile-sites-mobile-first-indexing";
+    readonly redirects: "https://developers.google.com/search/docs/crawling-indexing/301-redirects";
+    readonly softs404: "https://developers.google.com/search/docs/crawling-indexing/http-network-errors#soft-404-errors";
+    readonly og: "https://ogp.me/";
+    readonly twitter: "https://developer.x.com/en/docs/x-for-websites/cards/overview/markup";
+};

package/dist/core/rules/rule.js

@@ -0,0 +1,51 @@
+/** Build a finding from rule metadata, overriding only what differs for this instance. */
+export const finding = (meta, message, extras = {}) => {
+    const f = {
+        rule: meta.id,
+        severity: extras.severity ?? meta.severity,
+        category: meta.category,
+        message,
+        recommendation: extras.recommendation ?? meta.recommendation,
+    };
+    if (extras.selector) {
+        f.selector = extras.selector;
+    }
+    if (extras.evidence) {
+        f.evidence = extras.evidence;
+    }
+    if (meta.docs) {
+        f.docs = meta.docs;
+    }
+    return f;
+};
+export const defineRule = (meta, check) => ({
+    meta,
+    check(ctx) {
+        const result = check(ctx, (message, extras) => finding(meta, message, extras));
+        if (!result) {
+            return [];
+        }
+        return Array.isArray(result) ? result : [result];
+    },
+});
+export const cap = (items, max = 10) => items.length > max ? items.slice(0, max) : items;
+export const GOOGLE_DOCS = {
+    titles: "https://developers.google.com/search/docs/appearance/title-link",
+    snippets: "https://developers.google.com/search/docs/appearance/snippet",
+    canonical: "https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls",
+    robotsMeta: "https://developers.google.com/search/docs/crawling-indexing/robots-meta-tag",
+    robotsTxt: "https://developers.google.com/search/docs/crawling-indexing/robots/intro",
+    sitemaps: "https://developers.google.com/search/docs/crawling-indexing/sitemaps/overview",
+    hreflang: "https://developers.google.com/search/docs/specialty/international/localized-versions",
+    images: "https://developers.google.com/search/docs/appearance/google-images",
+    links: "https://developers.google.com/search/docs/crawling-indexing/links-crawlable",
+    structuredData: "https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data",
+    javascript: "https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics",
+    cwv: "https://web.dev/articles/vitals",
+    mobile: "https://developers.google.com/search/docs/crawling-indexing/mobile/mobile-sites-mobile-first-indexing",
+    redirects: "https://developers.google.com/search/docs/crawling-indexing/301-redirects",
+    softs404: "https://developers.google.com/search/docs/crawling-indexing/http-network-errors#soft-404-errors",
+    og: "https://ogp.me/",
+    twitter: "https://developer.x.com/en/docs/x-for-websites/cards/overview/markup",
+};
+//# sourceMappingURL=rule.js.map

package/dist/core/rules/rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../../src/core/rules/rule.ts"],"names":[],"mappings":"AA+BA,0FAA0F;AAC1F,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,IAAc,EACd,OAAe,EACf,MAAM,GAAkB,EAAE,EACjB,EAAE;IACX,MAAM,CAAC,GAAY;QACjB,IAAI,EAAE,IAAI,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ;QAC1C,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO;QACP,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc;KAC7D,CAAC;IAEF,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,IAAc,EACd,KAG2C,EACrC,EAAE,CAAC,CAAC;IACV,IAAI;IACJ,KAAK,CAAC,GAAG;QACP,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAC5C,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAC/B,CAAC;QAEF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAI,KAAU,EAAE,GAAG,GAAG,EAAE,EAAO,EAAE,CAClD,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAEnD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,iEAAiE;IACzE,QAAQ,EAAE,8DAA8D;IACxE,SAAS,EACP,wFAAwF;IAC1F,UAAU,EACR,6EAA6E;IAC/E,SAAS,EACP,0EAA0E;IAC5E,QAAQ,EACN,+EAA+E;IACjF,QAAQ,EACN,sFAAsF;IACxF,MAAM,EAAE,oEAAoE;IAC5E,KAAK,EACH,6EAA6E;IAC/E,cAAc,EACZ,4FAA4F;IAC9F,UAAU,EACR,8FAA8F;IAChG,GAAG,EAAE,iCAAiC;IACtC,MAAM,EACJ,uGAAuG;IACzG,SAAS,EACP,2EAA2E;IAC7E,QAAQ,EACN,iGAAiG;IACnG,EAAE,EAAE,iBAAiB;IACrB,OAAO,EACL,sEAAsE;CAChE,CAAC"}

package/dist/core/rules/social.d.ts

@@ -0,0 +1 @@
+export declare const socialRules: import("./rule.js").Rule[];

package/dist/core/rules/social.js

@@ -0,0 +1,115 @@
+import { normalizeUrl } from "../url.js";
+import { defineRule, GOOGLE_DOCS } from "./rule.js";
+const OG_CORE = ["title", "description", "image"];
+const OG_RECOMMENDED = [
+    "title",
+    "description",
+    "image",
+    "url",
+    "type",
+];
+const TWITTER_CARDS = new Set([
+    "summary",
+    "summary_large_image",
+    "app",
+    "player",
+]);
+export const socialRules = [
+    defineRule({
+        id: "og.missing",
+        category: "social",
+        severity: "warning",
+        description: "No Open Graph tags (og:title, og:description, og:image) are present.",
+        recommendation: "Add og:title, og:description, og:image (absolute URL, at least 1200x630), og:url and og:type so shares on social platforms and chat apps render a rich preview.",
+        docs: GOOGLE_DOCS.og,
+    }, ({ page }, make) => OG_CORE.some((k) => page.og[k])
+        ? null
+        : make("Page has no Open Graph tags.", {
+            selector: 'head > meta[property^="og:"]',
+        })),
+    defineRule({
+        id: "og.incomplete",
+        category: "social",
+        severity: "info",
+        description: "Some Open Graph tags are present but one or more of og:title, og:description, og:image, og:url, og:type is missing.",
+        recommendation: "Fill in the missing Open Graph properties. og:image and og:description have the biggest effect on share previews.",
+        docs: GOOGLE_DOCS.og,
+    }, ({ page }, make) => {
+        if (!OG_CORE.some((k) => page.og[k])) {
+            return null;
+        }
+        const missing = OG_RECOMMENDED.filter((k) => !page.og[k]);
+        return missing.length
+            ? make(`Open Graph is missing: ${missing.map((m) => `og:${m}`).join(", ")}.`, {
+                selector: 'head > meta[property^="og:"]',
+                evidence: { missing, present: Object.keys(page.og) },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "og.image-not-absolute",
+        category: "social",
+        severity: "warning",
+        description: "og:image is not an absolute URL.",
+        recommendation: "Use a full https:// URL for og:image; most platforms ignore relative image paths.",
+        docs: GOOGLE_DOCS.og,
+    }, ({ page }, make) => {
+        const img = page.og["image"];
+        return img && !/^https?:\/\//iu.test(img)
+            ? make(`og:image "${img}" is not an absolute URL.`, {
+                selector: 'head > meta[property="og:image"]',
+                evidence: { image: img },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "og.url-mismatch",
+        category: "social",
+        severity: "info",
+        description: "og:url differs from the canonical URL.",
+        recommendation: "Set og:url to the same URL as the canonical so share counts and previews consolidate.",
+        docs: GOOGLE_DOCS.og,
+    }, ({ page }, make) => {
+        const ogUrl = page.og["url"];
+        if (!ogUrl || !page.canonical) {
+            return null;
+        }
+        const a = normalizeUrl(ogUrl);
+        const b = normalizeUrl(page.canonical);
+        return a && b && a !== b
+            ? make("og:url does not match the canonical URL.", {
+                selector: 'head > meta[property="og:url"]',
+                evidence: { ogUrl, canonical: page.canonical },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "twitter.card-missing",
+        category: "social",
+        severity: "info",
+        description: "No twitter:card meta tag is present.",
+        recommendation: 'Add <meta name="twitter:card" content="summary_large_image">; X/Twitter falls back to Open Graph for the other fields.',
+        docs: GOOGLE_DOCS.twitter,
+    }, ({ page }, make) => page.twitter["card"]
+        ? null
+        : make("Page has no twitter:card tag.", {
+            selector: 'head > meta[name="twitter:card"]',
+        })),
+    defineRule({
+        id: "twitter.card-invalid",
+        category: "social",
+        severity: "warning",
+        description: "twitter:card has a value other than summary, summary_large_image, app or player.",
+        recommendation: "Use one of the supported card types, usually summary_large_image.",
+        docs: GOOGLE_DOCS.twitter,
+    }, ({ page }, make) => {
+        const { card } = page.twitter;
+        return card && !TWITTER_CARDS.has(card.toLowerCase())
+            ? make(`twitter:card "${card}" is not a valid card type.`, {
+                selector: 'head > meta[name="twitter:card"]',
+                evidence: { card },
+            })
+            : null;
+    }),
+];
+//# sourceMappingURL=social.js.map

package/dist/core/rules/social.js.map

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

package/dist/core/rules/structured-data.d.ts

@@ -0,0 +1,25 @@
+import type { StructuredDataItem } from "../types.js";
+interface SchemaSpec {
+    required: string[];
+    recommended: string[];
+    /** At least one of these groups must be present (each group = list of alternatives). */
+    oneOf?: string[][];
+    docs?: string;
+}
+export declare const SCHEMA_SPECS: Record<string, SchemaSpec>;
+interface Issue {
+    type: string;
+    missing: string[];
+    path: string;
+}
+/** What one structured-data item lacks or gets wrong, against the specs above. */
+export interface ItemValidation {
+    required: Issue[];
+    recommended: Issue[];
+    badDates: string[];
+    unknownTypes: string[];
+}
+/** Walk one structured-data item (and nested typed objects) collecting spec violations. */
+export declare const validateItem: (item: StructuredDataItem) => ItemValidation;
+export declare const structuredDataRules: import("./rule.js").Rule[];
+export {};