@rivi-software/agentic-seo-check 0.4.0 → 0.5.0

package/dist/core/performance-rules.js

@@ -1,3 +1,5 @@
+import { cacheHtmlEdit, clsEdits, describedEdit, failedAuditEdits, lcpEdits, lcpFallbackEdit, opportunityEdits, renderBlockingEdits, scriptEdits, uniqueEdits, } from "./performance-fixes.js";
+import { addHtml, slot } from "./rules/fix.js";
 import { finding, GOOGLE_DOCS } from "./rules/rule.js";
 const meta = (id, severity, description, recommendation, docs = GOOGLE_DOCS.cwv) => ({
     id,
@@ -27,29 +29,59 @@ const m = (id) => {
     }
     return rule;
 };
+const pageOf = (result) => result.finalUrl || result.requestedUrl;
+/** `edits`, or `fallback` when Lighthouse named nothing to change. */
+const orElse = (edits, fallback) => edits.length ? uniqueEdits(edits) : [fallback()];
+const UNSIZED_FALLBACK = () => addHtml("img:not([width])", `width="${slot("width in px")}" height="${slot("height in px")}"`, "Lighthouse named no element. Give every image width and height (its pixel size, or any size with its aspect ratio) so the browser reserves its space, and keep height: auto in the CSS; reserve the space of banners, ads and embeds a script inserts.");
+/** `defer` on the head's blocking scripts, when Lighthouse named no file. */
+const DEFER_FALLBACK = () => addHtml('head > script[src]:not([async]):not([defer]):not([type="module"])', "defer", "Lighthouse named no file. defer runs these scripts after the HTML is parsed; leave one blocking only if an inline script calls it before the page has loaded.");
+const lcpFix = (result) => orElse(lcpEdits(result, pageOf(result)), lcpFallbackEdit);
+const tbtFix = (result) => orElse(scriptEdits(result.scripts ?? [], pageOf(result)), DEFER_FALLBACK);
+const fcpFix = (result) => {
+    const blocking = renderBlockingEdits(result.renderBlocking ?? [], pageOf(result));
+    const slowServer = (result.metrics.ttfbMs ?? 0) > 600;
+    return orElse([
+        ...blocking,
+        ...(slowServer ? [cacheHtmlEdit(result.metrics.ttfbMs)] : []),
+    ], DEFER_FALLBACK);
+};
+/** The edits of the opportunities with the largest savings: where a low score comes from. */
+const scoreFix = (result) => orElse(result.opportunities
+    .slice(0, 3)
+    .flatMap((o) => opportunityEdits(o, result, pageOf(result))), () => lcpFix(result)[0] ?? lcpFallbackEdit());
 /** LCP, CLS and TBT against the Core Web Vitals thresholds. */
 const vitalsFindings = (result) => {
     const out = [];
     const add = (f) => out.push(f);
     const { metrics } = result;
+    const lcp = result.lcpElement;
     if (metrics.lcpMs !== null && metrics.lcpMs > 2500) {
+        const evidence = {
+            lcpMs: Math.round(metrics.lcpMs),
+            formFactor: result.formFactor,
+        };
+        if (lcp) {
+            evidence["element"] = lcp.node.snippet;
+            evidence["phases"] = lcp.phases;
+        }
         add(finding(m("perf.lcp-slow"), `LCP is ${(metrics.lcpMs / 1000).toFixed(1)} s (${metrics.lcpMs > 4000 ? "poor" : "needs improvement"}).`, {
             severity: metrics.lcpMs > 4000 ? "error" : "warning",
-            evidence: {
-                lcpMs: Math.round(metrics.lcpMs),
-                formFactor: result.formFactor,
-            },
+            fix: lcpFix(result),
+            selector: lcp?.node.selector,
+            evidence,
         }));
     }
     if (metrics.cls !== null && metrics.cls > 0.1) {
         add(finding(m("perf.cls-high"), `CLS is ${metrics.cls.toFixed(3)} (${metrics.cls > 0.25 ? "poor" : "needs improvement"}).`, {
             severity: metrics.cls > 0.25 ? "error" : "warning",
+            fix: orElse(clsEdits(result), UNSIZED_FALLBACK),
             evidence: { cls: Number(metrics.cls.toFixed(3)) },
         }));
     }
     if (metrics.tbtMs !== null && metrics.tbtMs > 200) {
         add(finding(m("perf.tbt-high"), `TBT is ${Math.round(metrics.tbtMs)} ms (${metrics.tbtMs > 600 ? "poor" : "needs improvement"}).`, {
             severity: metrics.tbtMs > 600 ? "error" : "warning",
+            fix: tbtFix(result),
             evidence: { tbtMs: Math.round(metrics.tbtMs) },
         }));
     }
@@ -63,14 +95,19 @@ const timingFindings = (result) => {
     if (metrics.fcpMs !== null && metrics.fcpMs > 1800) {
         add(finding(m("perf.fcp-slow"), `FCP is ${(metrics.fcpMs / 1000).toFixed(1)} s.`, {
             severity: metrics.fcpMs > 3000 ? "warning" : "info",
+            fix: fcpFix(result),
             evidence: { fcpMs: Math.round(metrics.fcpMs) },
         }));
     }
     if (metrics.ttfbMs !== null && metrics.ttfbMs > 800) {
-        add(finding(m("perf.ttfb-slow"), `Server response time is ${Math.round(metrics.ttfbMs)} ms.`, { evidence: { ttfbMs: Math.round(metrics.ttfbMs) } }));
+        add(finding(m("perf.ttfb-slow"), `Server response time is ${Math.round(metrics.ttfbMs)} ms.`, {
+            fix: [cacheHtmlEdit(metrics.ttfbMs)],
+            evidence: { ttfbMs: Math.round(metrics.ttfbMs) },
+        }));
     }
     if (metrics.performanceScore !== null && metrics.performanceScore < 50) {
         add(finding(m("perf.score-low"), `Lighthouse performance score is ${metrics.performanceScore}/100.`, {
+            fix: scoreFix(result),
             evidence: {
                 performanceScore: metrics.performanceScore,
                 formFactor: result.formFactor,
@@ -92,6 +129,8 @@ const auditFindings = (result) => {
             .join(", ");
         add(finding(m("perf.opportunity"), `${opp.title}${savings ? ` (est. savings ${savings})` : ""}.`, {
             recommendation: opp.description,
+            fix: orElse(opportunityEdits(opp, result, pageOf(result)), () => describedEdit(opp.title, opp.description)),
+            key: opp.id,
             evidence: {
                 auditId: opp.id,
                 savingsMs: opp.savingsMs,
@@ -103,23 +142,32 @@ const auditFindings = (result) => {
     for (const audit of result.failedSeoAudits) {
         add(finding(m("lighthouse.seo-audit-failed"), `Lighthouse SEO audit "${audit.title}" failed${audit.displayValue ? `: ${audit.displayValue}` : ""}.`, {
             recommendation: audit.description,
+            fix: orElse(failedAuditEdits(audit, result), () => describedEdit(audit.title, audit.description)),
+            key: audit.id,
             evidence: { auditId: audit.id, score: audit.score },
         }));
     }
     for (const audit of result.agenticBrowsingAudits) {
         add(finding(m("lighthouse.agentic-audit-failed"), `Lighthouse agentic-browsing audit "${audit.title}" failed${audit.displayValue ? `: ${audit.displayValue}` : ""}.`, {
             recommendation: audit.description,
+            fix: orElse(failedAuditEdits(audit, result), () => describedEdit(audit.title, audit.description)),
+            key: audit.id,
             evidence: { auditId: audit.id, score: audit.score },
         }));
     }
     return out;
 };
 export const performanceFindings = (result) => {
-    const url = result.finalUrl || result.requestedUrl;
-    return [
+    const url = pageOf(result);
+    const findings = [
         ...vitalsFindings(result),
         ...timingFindings(result),
         ...auditFindings(result),
-    ].map((f) => ({ ...f, url }));
+    ];
+    // Set in place: a copy would lose the key a finding's id is made from.
+    for (const f of findings) {
+        f.url = url;
+    }
+    return findings;
 };
 //# sourceMappingURL=performance-rules.js.map

package/dist/core/performance-rules.js.map

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

package/dist/core/recheck.d.ts

@@ -0,0 +1,68 @@
+import type { PageRecord } from "./site-rules.js";
+import type { BaselineComparison, Finding, Requirement, RuleMeta, Severity } from "./types.js";
+/** One finding of an earlier audit. Only `id` is required: an MCP client may have nothing else. */
+export interface BaselineEntry {
+    id: string;
+    rule?: string;
+    severity?: Severity;
+    url?: string;
+    message?: string;
+}
+/** What an earlier audit reported, for a re-check. */
+export type Baseline = readonly BaselineEntry[];
+/**
+ * Gives each finding an id that stays the same while the problem does: `rule@<URL hash>`, plus
+ * `:<key hash>` when the rule reports more than one finding per page and says which one this is.
+ * Findings that would still share an id are numbered in order (`~1`, `~2`): which is which can
+ * change between audits, so a re-check never calls one of them fixed.
+ */
+export declare const assignIds: (findings: readonly Finding[]) => void;
+/** Baseline entries for finding ids, such as an MCP client passes back. */
+export declare const baselineFromIds: (ids: readonly string[]) => BaselineEntry[];
+/** What the re-check ran: which rules, on which pages. */
+export interface RecheckScope {
+    /**
+     * URLs this audit checked page rules on, in every form a finding may carry (requested, final,
+     * file URL).
+     */
+    urls: Iterable<string>;
+    /** The audit ran site rules (a crawl, a directory, an AEO audit with a site): site-wide findings count. */
+    site: boolean;
+    /** Whether a rule ran this time; the caller knows the options. */
+    ruleRan: (rule: string) => boolean;
+    /**
+     * Findings this audit made but left out of its output (info, with `includeInfo: false`): still
+     * on the page, so never fixed, and not listed as open or new either.
+     */
+    hidden?: readonly Finding[];
+}
+/**
+ * Compares this audit's findings with an earlier audit's. An earlier finding counts as fixed only
+ * when this audit could have reported it again: its rule ran, on its page. Everything else is
+ * `notChecked`, so a narrower re-check (`rules`, one page of a crawl, `includeInfo: false`) never
+ * reports a fix it did not see.
+ */
+export declare const compareWithBaseline: (findings: readonly Finding[], baseline: Baseline, scope: RecheckScope) => BaselineComparison;
+/** The rule options of an audit, for `ruleRanWith`. */
+export interface RuleSelection {
+    /** Run only these rule ids. */
+    onlyRules?: readonly string[];
+    disableRules?: readonly string[];
+    /** The capabilities the audit had: render, lighthouse, crawl, keyword, ai-bots. */
+    active: ReadonlySet<Requirement>;
+}
+/**
+ * Whether a rule ran in an audit with these options. `rules` are the rules the audit evaluates
+ * (SEO or AEO); a rule outside them, or one that needs a capability the audit did not have, did
+ * not run.
+ */
+export declare const ruleRanWith: (selection: RuleSelection, rules: readonly RuleMeta[]) => ((rule: string) => boolean);
+/**
+ * The findings of an audit the CLI or the library wrote as JSON, for `--baseline`. A site audit
+ * written with `--page-detail summary` has no page findings to compare with, so it is refused.
+ */
+export declare const baselineFromAudit: (json: string) => BaselineEntry[];
+/** `obj` with `key` set to `value` just before `before`, so the JSON reads in that order. */
+export declare const insertBefore: <T extends object, K extends keyof T>(obj: T, before: keyof T, key: K, value: T[K]) => T;
+/** Every form a crawled or scanned page's URL takes in findings. */
+export declare const recordUrls: (records: PageRecord[]) => string[];

package/dist/core/recheck.js

@@ -0,0 +1,247 @@
+import { createHash } from "node:crypto";
+import { z } from "zod";
+import { findingKey } from "./rules/rule.js";
+const hash = (text, length) => createHash("sha256").update(text).digest("hex").slice(0, length);
+/** The part of an id that names the page: a hash of the finding's URL, or of "" for a site-wide finding. */
+const urlPart = (url) => hash(url ?? "", 8);
+/** A finding's id before any numbering: its rule, page and, when it has one, its key. */
+const baseId = (f) => {
+    const key = findingKey(f);
+    return `${f.rule}@${urlPart(f.url)}${key ? `:${hash(key, 4)}` : ""}`;
+};
+/**
+ * Gives each finding an id that stays the same while the problem does: `rule@<URL hash>`, plus
+ * `:<key hash>` when the rule reports more than one finding per page and says which one this is.
+ * Findings that would still share an id are numbered in order (`~1`, `~2`): which is which can
+ * change between audits, so a re-check never calls one of them fixed.
+ */
+export const assignIds = (findings) => {
+    const count = new Map();
+    for (const f of findings) {
+        count.set(baseId(f), (count.get(baseId(f)) ?? 0) + 1);
+    }
+    const seen = new Map();
+    for (const f of findings) {
+        const id = baseId(f);
+        if ((count.get(id) ?? 0) > 1) {
+            const n = (seen.get(id) ?? 0) + 1;
+            seen.set(id, n);
+            f.id = `${id}~${n}`;
+        }
+        else {
+            f.id = id;
+        }
+    }
+};
+const ID = /^(?<base>(?<rule>[^@]+)@(?<url>[\da-f]{8})(?::[\da-f]{4})?)(?<numbered>~\d+)?$/u;
+/** An id without its number: `rule@<URL hash>[:<key hash>]`. */
+const baseOf = (id) => ID.exec(id)?.groups?.base;
+/** Baseline entries for finding ids, such as an MCP client passes back. */
+export const baselineFromIds = (ids) => ids.map((id) => ({ id }));
+const idsOf = (findings) => new Set(findings.flatMap((f) => (f.id ? [f.id] : [])));
+/**
+ * The fixed finding an earlier entry stands for, or null when this audit could not have reported
+ * it again: its rule did not run on its page, it is only hidden (`includeInfo: false`), or its id
+ * was numbered and may now belong to another finding.
+ */
+const fixedEntry = (entry, c) => {
+    const parts = ID.exec(entry.id)?.groups;
+    const rule = entry.rule ?? parts?.rule;
+    if (!parts?.url ||
+        !parts.base ||
+        !rule ||
+        parts.numbered ||
+        c.numbered.has(parts.base) ||
+        c.hiddenIds.has(entry.id) ||
+        !c.scope.ruleRan(rule)) {
+        return null;
+    }
+    const onPage = parts.url === urlPart(undefined) ? c.scope.site : c.urls.has(parts.url);
+    if (!onPage) {
+        return null;
+    }
+    const out = { id: entry.id, rule };
+    if (entry.url) {
+        out.url = entry.url;
+    }
+    if (entry.message) {
+        out.message = entry.message;
+    }
+    return out;
+};
+/**
+ * Compares this audit's findings with an earlier audit's. An earlier finding counts as fixed only
+ * when this audit could have reported it again: its rule ran, on its page. Everything else is
+ * `notChecked`, so a narrower re-check (`rules`, one page of a crawl, `includeInfo: false`) never
+ * reports a fix it did not see.
+ */
+export const compareWithBaseline = (findings, baseline, scope) => {
+    const urls = new Set();
+    for (const u of scope.urls) {
+        urls.add(urlPart(u));
+    }
+    for (const f of findings) {
+        if (f.url) {
+            urls.add(urlPart(f.url));
+        }
+    }
+    const shownIds = idsOf(findings);
+    const hiddenIds = idsOf(scope.hidden ?? []);
+    const numbered = new Set([...shownIds, ...hiddenIds].flatMap((id) => {
+        const groups = ID.exec(id)?.groups;
+        return groups?.numbered && groups.base ? [groups.base] : [];
+    }));
+    const checked = { urls, shownIds, hiddenIds, numbered, scope };
+    const fixed = [];
+    let notChecked = 0;
+    for (const entry of baseline) {
+        if (!shownIds.has(entry.id)) {
+            const out = fixedEntry(entry, checked);
+            if (out) {
+                fixed.push(out);
+            }
+            else {
+                notChecked += 1;
+            }
+        }
+    }
+    const beforeIds = new Set(baseline.map((b) => b.id));
+    // A finding numbered before or now matches no earlier id by its number, which may have moved:
+    // one whose base id the earlier audit had is still open, not new.
+    const beforeBases = new Set(baseline.flatMap((b) => {
+        const base = baseOf(b.id);
+        return base ? [base] : [];
+    }));
+    const open = [];
+    const added = [];
+    for (const f of findings) {
+        if (f.id) {
+            const base = baseOf(f.id);
+            const before = beforeIds.has(f.id) || (base !== undefined && beforeBases.has(base));
+            (before ? open : added).push(f.id);
+        }
+    }
+    return { fixed, open, new: added, notChecked };
+};
+/**
+ * Whether a rule ran in an audit with these options. `rules` are the rules the audit evaluates
+ * (SEO or AEO); a rule outside them, or one that needs a capability the audit did not have, did
+ * not run.
+ */
+export const ruleRanWith = (selection, rules) => {
+    const only = selection.onlyRules ? new Set(selection.onlyRules) : null;
+    const disabled = new Set(selection.disableRules);
+    const byId = new Map(rules.map((r) => [r.id, r]));
+    return (rule) => {
+        if ((only && !only.has(rule)) || disabled.has(rule)) {
+            return false;
+        }
+        // Findings of the tool itself: whether their check ran follows from the option they belong to.
+        if (rule === "tool.render-unavailable") {
+            return selection.active.has("render");
+        }
+        if (rule === "tool.lighthouse-unavailable") {
+            return selection.active.has("lighthouse");
+        }
+        if (rule === "tool.rule-error" || rule === "response.fetch-failed") {
+            return true;
+        }
+        const meta = byId.get(rule);
+        return (meta !== undefined &&
+            (!meta.requires || selection.active.has(meta.requires)));
+    };
+};
+const savedFinding = z.object({
+    id: z.string(),
+    rule: z.string(),
+    severity: z.enum(["error", "warning", "info"]).optional(),
+    url: z.string().optional(),
+    message: z.string().optional(),
+});
+const savedCounts = z.object({
+    error: z.number(),
+    warning: z.number(),
+    info: z.number(),
+});
+const total = (counts) => counts.error + counts.warning + counts.info;
+// Findings saved before ids existed have none; they are left out rather than failing the parse.
+const savedFindings = z
+    .array(z.unknown())
+    .default([])
+    .transform((items) => items.flatMap((item) => {
+    const parsed = savedFinding.safeParse(item);
+    return parsed.success ? [parsed.data] : [];
+}));
+const savedAudit = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("page"), findings: savedFindings }),
+    // `counts` covers every finding, also those a crawl with `--page-detail summary` leaves out.
+    z.object({
+        kind: z.literal("aeo"),
+        findings: savedFindings,
+        counts: savedCounts.optional(),
+    }),
+    z.object({
+        kind: z.literal("site"),
+        siteFindings: savedFindings,
+        pages: z
+            .array(z.object({ findings: savedFindings, counts: savedCounts.optional() }))
+            .default([]),
+    }),
+]);
+/**
+ * The findings of an audit the CLI or the library wrote as JSON, for `--baseline`. A site audit
+ * written with `--page-detail summary` has no page findings to compare with, so it is refused.
+ */
+export const baselineFromAudit = (json) => {
+    let data;
+    try {
+        data = JSON.parse(json);
+    }
+    catch {
+        throw new Error("The baseline is not JSON. Save the first audit with --format json.");
+    }
+    const parsed = savedAudit.safeParse(data);
+    if (!parsed.success) {
+        throw new Error('The baseline is not an audit: expected the JSON of an earlier run ("kind": "page", "site" or "aeo").');
+    }
+    const audit = parsed.data;
+    if (audit.kind === "page") {
+        return audit.findings;
+    }
+    // A crawl saved with `--page-detail summary` drops page findings; comparing with it would call
+    // every page finding new.
+    const summarised = audit.kind === "site"
+        ? audit.pages.some((p) => p.counts !== undefined && p.findings.length < total(p.counts))
+        : audit.counts !== undefined &&
+            audit.findings.length < total(audit.counts);
+    if (summarised) {
+        throw new Error("The baseline audit lists no page findings (it ran with --page-detail summary). Run it again with --page-detail full.");
+    }
+    return audit.kind === "site"
+        ? [...audit.siteFindings, ...audit.pages.flatMap((p) => p.findings)]
+        : audit.findings;
+};
+/** `obj` with `key` set to `value` just before `before`, so the JSON reads in that order. */
+export const insertBefore = (obj, before, key, value) => {
+    const out = {};
+    // SAFETY: Object.keys of a T lists keys of T.
+    for (const k of Object.keys(obj)) {
+        if (k === before) {
+            out[key] = value;
+        }
+        if (k !== key) {
+            out[k] = obj[k];
+        }
+    }
+    // SAFETY: `out` has every key `obj` has, plus `key`.
+    return out;
+};
+/** Every form a crawled or scanned page's URL takes in findings. */
+export const recordUrls = (records) => records.flatMap((r) => [
+    r.url,
+    r.requestedUrl,
+    r.page.url,
+    ...(r.response ? [r.response.finalUrl] : []),
+    ...(r.file ? [r.file] : []),
+]);
+//# sourceMappingURL=recheck.js.map

package/dist/core/recheck.js.map

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

package/dist/core/render-fixes.d.ts

@@ -0,0 +1,27 @@
+import type { ExtractedPage, FixEdit, ResponseInfo } from "./types.js";
+/** The server HTML (`raw`) and the rendered DOM of one page. */
+export interface RenderPages {
+    raw: ExtractedPage;
+    rendered: ExtractedPage;
+    response?: ResponseInfo;
+}
+export declare const titleFix: (s: RenderPages, title: string) => FixEdit[];
+export declare const titleChangedFix: (s: RenderPages, serverTitle: string, finalTitle: string) => FixEdit[];
+export declare const descriptionFix: (s: RenderPages, description: string) => FixEdit[];
+/**
+ * The canonical JavaScript sets, in the server HTML: added when the server sends none, in place of
+ * the server's when it sends another.
+ */
+export declare const canonicalFix: (s: RenderPages, serverCanonical: string | null, finalCanonical: string) => FixEdit[];
+/** noindex that only JavaScript adds: the tag to take out of the component that renders it. */
+export declare const noindexAddedFix: (s: RenderPages) => FixEdit[];
+/** noindex the server sends and JavaScript removes: Google keeps the server's, so remove it there. */
+export declare const noindexRemovedFix: (s: RenderPages) => FixEdit[];
+export declare const h1Fix: (s: RenderPages) => FixEdit[];
+export declare const contentFix: (s: RenderPages, words: number) => FixEdit[];
+/** Internal links only the rendered DOM has, quoted as JavaScript writes them (the first 10). */
+export declare const linksFix: (s: RenderPages, missing: number) => FixEdit[];
+/** The JSON-LD JavaScript adds, as script elements for the server HTML. */
+export declare const structuredDataFix: (s: RenderPages) => FixEdit[];
+/** The scripts that throw while the page renders, from the messages they log (the first 5). */
+export declare const consoleErrorFix: (errors: string[]) => FixEdit[];