seo 0.15.2 → 0.16.0

package/dist/index.js

@@ -1,5 +1,5 @@
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import { n as version, t as load } from "./esm-Dt4JJZ0P.js";
+import { n as version, t as load } from "./esm-CV5s7esU.js";
 import { SEO_PROVIDER_API_VERSION } from "./provider-sdk.js";
 import crypto, { createHash, randomUUID, sign } from "node:crypto";
 import { z } from "zod";
@@ -343,6 +343,24 @@ const RULE_DEFINITIONS = [
 			suggestedCommands: ["seo crawl <url> --max-pages 1 --json"]
 		}
 	},
+	{
+		id: "crawl_single_page_reach",
+		title: "Crawl could reach only the start page",
+		category: "links",
+		defaultSeverity: "high",
+		whyItMatters: "The start page had no crawlable internal links and no sitemap returned URLs, so the crawl checked one page. Every other finding in this report covers that page only. The page probably builds its links with JavaScript.",
+		howToFix: "Rerun with `--rendering on` so the crawler reads the links a browser sees, or pass the pages to check with `--mode list`. For crawlers that do not run JavaScript, put plain `<a href>` links in the initial HTML and publish a sitemap.",
+		impactIfIgnored: "Crawlers and audits that do not run JavaScript can find only this page, so the rest of the site stays unchecked and harder to discover.",
+		howToVerify: "Rerun the crawl and confirm it retains more than one page and the start page reports internal links.",
+		agentHints: {
+			evidenceFields: [
+				"page.outgoingInternalCount",
+				"report.sitemapDiscovery.urlsReturned",
+				"page.fetchDiagnostics.rendering"
+			],
+			suggestedCommands: ["seo crawl <url> --rendering on --json", "seo crawl --mode list --urls <url>,<url> --json"]
+		}
+	},
 	{
 		id: "soft_404",
 		title: "Unknown URLs return a successful response",
@@ -351,7 +369,7 @@ const RULE_DEFINITIONS = [
 		whyItMatters: "Known-nonexistent URLs returned a successful response or redirected to another successful page. Search engines and users cannot reliably distinguish missing content from a real page.",
 		howToFix: "Return 404 or 410 for missing URLs. If a replacement exists, redirect only the specific retired URL to its closest relevant replacement rather than sending every unknown path to a generic page.",
 		impactIfIgnored: "Missing URLs can remain in crawl queues, waste crawl attention, and create confusing search or monitoring evidence.",
-		howToVerify: "Request several known-nonexistent paths and confirm each returns 404 or 410 without redirecting to a generic successful page.",
+		howToVerify: "Request several made-up paths, including one at the site root and one nested path, and confirm each returns 404 or 410 without redirecting to a generic successful page.",
 		agentHints: {
 			evidenceFields: ["report.siteChecks.soft404"],
 			suggestedCommands: ["seo crawl <url> --json"]
@@ -1803,7 +1821,7 @@ function day$3(value) {
 	const date = legacy ? new Date(Number(legacy[1])) : new Date(value);
 	return Number.isNaN(date.getTime()) ? null : date.toISOString().slice(0, 10);
 }
-const count$3 = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
+const count$4 = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
 function list$2(data, label) {
 	if (!Array.isArray(data)) throw new SeoError("OPTIONAL_PROVIDER_UNAVAILABLE", `Bing Webmaster returned an invalid ${label}.`);
 	return data.filter((item) => Boolean(item) && typeof item === "object");
@@ -1819,8 +1837,8 @@ async function bingTraffic(call, site) {
 	let invalidRows = 0;
 	for (const row of list$2(await call("GetRankAndTrafficStats", { siteUrl: site }), "traffic list")) {
 		const date = day$3(row.Date);
-		const clicks = count$3(row.Clicks);
-		const impressions = count$3(row.Impressions);
+		const clicks = count$4(row.Clicks);
+		const impressions = count$4(row.Impressions);
 		if (!date || clicks === null || impressions === null) {
 			invalidRows += 1;
 			continue;
@@ -1843,9 +1861,9 @@ async function keyed(call, method, params) {
 	for (const row of list$2(await call(method, params), "row list")) {
 		const date = day$3(row.Date);
 		const key = typeof row.Query === "string" ? row.Query.trim() : "";
-		const clicks = count$3(row.Clicks);
-		const impressions = count$3(row.Impressions);
-		const position = count$3(row.AvgImpressionPosition);
+		const clicks = count$4(row.Clicks);
+		const impressions = count$4(row.Impressions);
+		const position = count$4(row.AvgImpressionPosition);
 		if (!date || !key || clicks === null || impressions === null) {
 			invalidRows += 1;
 			continue;
@@ -2377,6 +2395,14 @@ function sharedReader(read, redirects = /* @__PURE__ */ new Map()) {
 	};
 }
 const MAX_STATUS_BYTES = 10485760;
+async function rankingUpdates() {
+	const incidents = await fetch("https://status.search.google.com/incidents.json", { signal: AbortSignal.timeout(8e3) }).then((response) => response.ok ? readJson(response, "Google Search Status", { maxBytes: MAX_STATUS_BYTES }) : null).catch(() => null);
+	if (!Array.isArray(incidents)) return "Google Search Status could not be read.";
+	return searchUpdatesFromIncidents(withRankingHistory(incidents), {
+		product: "Ranking",
+		limit: Number.POSITIVE_INFINITY
+	});
+}
 async function googleUpdates(window) {
 	if (!window) return [];
 	const incidents = await fetch("https://status.search.google.com/incidents.json", { signal: AbortSignal.timeout(8e3) }).then((response) => response.ok ? readJson(response, "Google Search Status", { maxBytes: MAX_STATUS_BYTES }) : null).catch(() => null);
@@ -8113,6 +8139,56 @@ function systemBrowserCandidates(input) {
 		product: path.includes("google-chrome") ? "Google Chrome" : "Chromium"
 	}));
 }
+function listDirectorySafely(path) {
+	try {
+		return readdirSync(path);
+	} catch {
+		return [];
+	}
+}
+function versionParts(name) {
+	return (name.match(/\d+/g) ?? []).map(Number);
+}
+function newestFirst(left, right) {
+	const a = versionParts(left);
+	const b = versionParts(right);
+	for (let index = 0; index < Math.max(a.length, b.length); index += 1) {
+		const difference = (b[index] ?? -1) - (a[index] ?? -1);
+		if (difference) return difference;
+	}
+	return left < right ? -1 : left > right ? 1 : 0;
+}
+const MAX_CACHED_BROWSER_VERSIONS = 20;
+function versionDirectories(root, prefix, listDirectory) {
+	return listDirectory(root).filter((name) => name.startsWith(prefix)).sort(newestFirst).slice(0, MAX_CACHED_BROWSER_VERSIONS).map((name) => join(root, name));
+}
+const CHROME_FOR_TESTING_APP = join("Google Chrome for Testing.app", "Contents", "MacOS", "Google Chrome for Testing");
+/**
+* Browsers that other local tools already downloaded: agent-browser keeps
+* Chrome for Testing builds and Playwright keeps one Chromium per revision.
+*/
+function cachedBrowserCandidates(input) {
+	const agentBrowserExecutables = input.platform === "darwin" ? [CHROME_FOR_TESTING_APP] : input.platform === "win32" ? ["chrome.exe"] : ["chrome"];
+	const agentBrowser = versionDirectories(join(input.homeDirectory, ".agent-browser", "browsers"), "chrome-", input.listDirectory).flatMap((directory) => agentBrowserExecutables.map((executable) => ({
+		path: join(directory, executable),
+		source: "agent-browser-cache",
+		product: "agent-browser Chrome for Testing"
+	})));
+	const configuredRoot = input.environment.PLAYWRIGHT_BROWSERS_PATH?.trim();
+	const playwrightRoot = configuredRoot && configuredRoot !== "0" ? configuredRoot : input.platform === "darwin" ? join(input.homeDirectory, "Library", "Caches", "ms-playwright") : input.platform === "win32" ? join(input.environment.LOCALAPPDATA ?? join(input.homeDirectory, "AppData", "Local"), "ms-playwright") : join(input.environment.XDG_CACHE_HOME ?? join(input.homeDirectory, ".cache"), "ms-playwright");
+	const playwrightExecutables = input.platform === "darwin" ? [
+		join("chrome-mac-arm64", CHROME_FOR_TESTING_APP),
+		join("chrome-mac-x64", CHROME_FOR_TESTING_APP),
+		join("chrome-mac", CHROME_FOR_TESTING_APP),
+		join("chrome-mac", "Chromium.app", "Contents", "MacOS", "Chromium")
+	] : input.platform === "win32" ? [join("chrome-win64", "chrome.exe"), join("chrome-win", "chrome.exe")] : [join("chrome-linux64", "chrome"), join("chrome-linux", "chrome")];
+	const playwright = versionDirectories(playwrightRoot, "chromium-", input.listDirectory).flatMap((directory) => playwrightExecutables.map((executable) => ({
+		path: join(directory, executable),
+		source: "playwright-cache",
+		product: "Playwright Chromium"
+	})));
+	return [...agentBrowser, ...playwright];
+}
 /**
 * Resolve a browser without downloading one during normal package installation.
 * The explicit path wins so CI and managed workstations can select their own
@@ -8144,11 +8220,23 @@ function resolveBrowserExecutable(playwrightExecutablePath, dependencies = {}) {
 			product: "Playwright Chromium"
 		}
 	};
-	const browser = systemBrowserCandidates({
-		platform: dependencies.platform ?? process.platform,
-		homeDirectory: dependencies.homeDirectory ?? homedir(),
+	const platform = dependencies.platform ?? process.platform;
+	const homeDirectory = dependencies.homeDirectory ?? homedir();
+	const systemBrowser = systemBrowserCandidates({
+		platform,
+		homeDirectory,
 		environment
 	}).find((candidate) => fileExists(candidate.path));
+	if (systemBrowser) return {
+		status: "available",
+		browser: systemBrowser
+	};
+	const browser = cachedBrowserCandidates({
+		platform,
+		homeDirectory,
+		environment,
+		listDirectory: dependencies.listDirectory ?? listDirectorySafely
+	}).find((candidate) => fileExists(candidate.path));
 	return browser ? {
 		status: "available",
 		browser
@@ -11312,38 +11400,61 @@ function isValuablePage(page) {
 function normalizedMetadata(value) {
 	return value?.trim().replace(/\s+/g, " ").toLowerCase() || void 0;
 }
-function metadataDuplicates(pages, read) {
-	const counts = /* @__PURE__ */ new Map();
+/**
+* A page whose canonical names another crawled page in its group is already
+* handled. A group counts only when two or more of its pages are
+* self-canonical or declare no canonical, and only those pages are reported.
+*/
+function duplicateGroups(pages, read) {
+	const grouped = /* @__PURE__ */ new Map();
 	for (const page of pages) {
 		if (!isAuditableHtmlPage(page)) continue;
-		const raw = read(page)?.trim();
-		const key = normalizedMetadata(raw);
-		if (!key || !raw) continue;
-		const existing = counts.get(key) ?? {
-			count: 0,
-			sampleUrls: [],
-			value: raw
+		const entry = read(page);
+		if (!entry) continue;
+		const group = grouped.get(entry.key) ?? {
+			value: entry.value,
+			pages: []
 		};
-		existing.count += 1;
-		if (existing.sampleUrls.length < 10) existing.sampleUrls.push(page.url);
-		counts.set(key, existing);
+		group.pages.push(page);
+		grouped.set(entry.key, group);
+	}
+	const duplicates = /* @__PURE__ */ new Map();
+	for (const [key, group] of grouped) {
+		if (group.pages.length < 2) continue;
+		const groupUrls = /* @__PURE__ */ new Set();
+		for (const page of group.pages) for (const value of [page.url, page.finalUrl]) {
+			const url = urlKey(value);
+			if (url) groupUrls.add(url);
+		}
+		const counted = group.pages.filter((page) => {
+			const canonical = urlKey(page.canonical);
+			return !canonical || canonical === urlKey(page.url) || canonical === urlKey(page.finalUrl) || !groupUrls.has(canonical);
+		});
+		if (counted.length < 2) continue;
+		duplicates.set(key, {
+			count: counted.length,
+			sampleUrls: counted.slice(0, 10).map((page) => page.url),
+			value: group.value,
+			urls: new Set(counted.map((page) => page.url))
+		});
 	}
-	return new Map([...counts].filter(([, value]) => value.count > 1));
+	return duplicates;
+}
+function metadataDuplicates(pages, read) {
+	return duplicateGroups(pages, (page) => {
+		const value = read(page)?.trim();
+		const key = normalizedMetadata(value);
+		return key && value ? {
+			key,
+			value
+		} : void 0;
+	});
 }
 function contentDuplicates(pages) {
-	const counts = /* @__PURE__ */ new Map();
-	for (const page of pages) {
-		if (!isAuditableHtmlPage(page)) continue;
-		if (page.wordCount < 20 || !page.mainContentHash) continue;
-		const existing = counts.get(page.mainContentHash) ?? {
-			count: 0,
-			sampleUrls: []
-		};
-		existing.count += 1;
-		if (existing.sampleUrls.length < 10) existing.sampleUrls.push(page.url);
-		counts.set(page.mainContentHash, existing);
-	}
-	return new Map([...counts].filter(([, value]) => value.count > 1));
+	return duplicateGroups(pages, (page) => page.wordCount >= 20 && page.mainContentHash ? {
+		key: page.mainContentHash,
+		value: page.mainContentHash
+	} : void 0);
 }
 const QUERY_STOP_WORDS = /* @__PURE__ */ new Set([
 	"a",
@@ -11553,7 +11664,7 @@ function auditCrawlPages(pages, opts = {}) {
 			title,
 			...titleWidth
 		}));
-		if (title && duplicateTitle) issues.push(issue$1("title_duplicate", page, duplicateTitle.value, {
+		if (title && duplicateTitle?.urls.has(page.url)) issues.push(issue$1("title_duplicate", page, duplicateTitle.value, {
 			title,
 			duplicateCount: duplicateTitle.count,
 			sampleUrls: duplicateTitle.sampleUrls
@@ -11561,7 +11672,7 @@ function auditCrawlPages(pages, opts = {}) {
 		const metaDescription = page.metaDescription?.trim();
 		const duplicateDescription = duplicateDescriptions.get(normalizedMetadata(metaDescription) ?? "");
 		if (!metaDescription) issues.push(issue$1("missing_meta_description", page));
-		if (metaDescription && duplicateDescription) issues.push(issue$1("meta_description_duplicate", page, duplicateDescription.value, {
+		if (metaDescription && duplicateDescription?.urls.has(page.url)) issues.push(issue$1("meta_description_duplicate", page, duplicateDescription.value, {
 			metaDescription,
 			duplicateCount: duplicateDescription.count,
 			sampleUrls: duplicateDescription.sampleUrls
@@ -11609,7 +11720,7 @@ function auditCrawlPages(pages, opts = {}) {
 			finalUrl: page.finalUrl
 		}));
 		const contentDuplicate = page.mainContentHash ? duplicateContent.get(page.mainContentHash) : void 0;
-		if (contentDuplicate) issues.push(issue$1("duplicate_content", page, "Duplicate main content", {
+		if (contentDuplicate?.urls.has(page.url)) issues.push(issue$1("duplicate_content", page, "Duplicate main content", {
 			mainContentHash: page.mainContentHash,
 			duplicateCount: contentDuplicate.count,
 			sampleUrls: contentDuplicate.sampleUrls
@@ -11684,6 +11795,7 @@ const CRAWL_SKIP_REASONS = [
 	"off-origin",
 	"origin-backpressure",
 	"queue-safety-limit",
+	"query-variant-limit",
 	"robots-disallowed",
 	"robots-uncertain",
 	"legacy-unclassified"
@@ -11697,6 +11809,7 @@ const SKIP_IMPACT = {
 	"off-origin": "non-impacting",
 	"origin-backpressure": "coverage-affecting",
 	"queue-safety-limit": "coverage-affecting",
+	"query-variant-limit": "coverage-affecting",
 	"robots-disallowed": "coverage-affecting",
 	"robots-uncertain": "coverage-affecting",
 	"legacy-unclassified": "coverage-affecting"
@@ -12351,6 +12464,10 @@ const VALUE_WEIGHT = {
 	medium: .75,
 	low: .15
 };
+const CRAWL_REACH_RULES = /* @__PURE__ */ new Set(["crawl_single_page_reach"]);
+function reachRank(ruleId) {
+	return CRAWL_REACH_RULES.has(ruleId) ? 0 : 1;
+}
 function matchesPattern(pattern, value) {
 	if (!pattern.includes("*")) return value.includes(pattern);
 	const parts = pattern.split("*");
@@ -12458,7 +12575,7 @@ function topFixes(report, filters = {}) {
 				expected: rule?.howToVerify ?? ""
 			}
 		};
-	}).sort((a, b) => b.score - a.score || SEVERITY_SCORE[b.severity] - SEVERITY_SCORE[a.severity] || b.count - a.count || a.ruleId.localeCompare(b.ruleId)).slice(0, filters.limit ?? 10);
+	}).sort((a, b) => reachRank(a.ruleId) - reachRank(b.ruleId) || b.score - a.score || SEVERITY_SCORE[b.severity] - SEVERITY_SCORE[a.severity] || b.count - a.count || a.ruleId.localeCompare(b.ruleId)).slice(0, filters.limit ?? 10);
 }
 function reviewObservations(report, filters = {}) {
 	return topFixes(report, {
@@ -13643,6 +13760,7 @@ const crawlPageSnapshotSchema = z.object({
 				source: z.enum([
 					"environment",
 					"playwright-cache",
+					"agent-browser-cache",
 					"system"
 				]),
 				product: z.string(),
@@ -14346,55 +14464,6 @@ function agentReadyIssues(input) {
 	}
 	return issues;
 }
-// packages/core/src/analyze/crawler/crawl-caveats.ts
-function crawlCaveats(input) {
-	const caveats = input.cancelled ? ["Crawl cancelled before all queued URLs finished."] : input.pageLimitReached ? [`Stopped after reaching maxPages (${input.maxPages}).`] : [];
-	if (input.queueSafetySkippedUrls > 0) caveats.push(input.queueSafetyInventoryCapped ? `Left at least ${input.queueSafetySkippedUrls} unique eligible same-origin URLs unqueued to keep this crawl bounded. The excluded-URL inventory reached its reporting cap. Increase --max-pages to inspect more.` : `Left ${input.queueSafetySkippedUrls} unique eligible same-origin URLs unqueued to keep this crawl bounded. Increase --max-pages to inspect more.`);
-	if (input.originBackpressureSkippedUrls > 0) caveats.push(`Stopped ${input.originBackpressureSkippedUrls} queued URL${input.originBackpressureSkippedUrls === 1 ? "" : "s"} because the origin stayed slow. This is incomplete crawl evidence, not a failed URL check.`);
-	if (input.memoryPressureSkippedUrls > 0) caveats.push(`Left ${input.memoryPressureSkippedUrls} eligible URL${input.memoryPressureSkippedUrls === 1 ? "" : "s"} unchecked after the local memory safety limit was reached. Start with --health or lower --max-pages.`);
-	return caveats;
-}
-// packages/core/src/analyze/crawler/crawl-control.ts
-const CRAWL_CANCELLED = Symbol("crawl-cancelled");
-function abortController(input) {
-	const controller = new AbortController();
-	const abort = () => controller.abort();
-	const timer = setTimeout(abort, Math.min(input.timeoutMs, 5e3));
-	if (input.signal?.aborted) controller.abort();
-	else input.signal?.addEventListener("abort", abort, { once: true });
-	return {
-		signal: controller.signal,
-		cleanup: () => {
-			clearTimeout(timer);
-			input.signal?.removeEventListener("abort", abort);
-		}
-	};
-}
-function cancellationRace(signal) {
-	if (signal.aborted) return Promise.resolve(CRAWL_CANCELLED);
-	return new Promise((resolve) => {
-		signal.addEventListener("abort", () => resolve(CRAWL_CANCELLED), { once: true });
-	});
-}
-// packages/core/src/analyze/crawler/crawl-memory.ts
-const MEBIBYTE$1 = 1048576;
-const MIN_CRAWL_MEMORY_LIMIT = 384 * MEBIBYTE$1;
-const MAX_CRAWL_MEMORY_LIMIT = 640 * MEBIBYTE$1;
-const MIN_CRAWL_RSS_LIMIT = 512 * MEBIBYTE$1;
-const MAX_CRAWL_RSS_LIMIT = 896 * MEBIBYTE$1;
-const SYSTEM_MEMORY_FRACTION = .1;
-const SYSTEM_RSS_FRACTION = .2;
-function crawlMemoryLimitBytes(totalMemoryBytes) {
-	if (!Number.isFinite(totalMemoryBytes) || totalMemoryBytes <= 0) return MAX_CRAWL_MEMORY_LIMIT;
-	return Math.min(MAX_CRAWL_MEMORY_LIMIT, Math.max(MIN_CRAWL_MEMORY_LIMIT, Math.floor(totalMemoryBytes * SYSTEM_MEMORY_FRACTION)));
-}
-function crawlRssLimitBytes(totalMemoryBytes) {
-	if (!Number.isFinite(totalMemoryBytes) || totalMemoryBytes <= 0) return MAX_CRAWL_RSS_LIMIT;
-	return Math.min(MAX_CRAWL_RSS_LIMIT, Math.max(MIN_CRAWL_RSS_LIMIT, Math.floor(totalMemoryBytes * SYSTEM_RSS_FRACTION)));
-}
-function crawlMemoryPressure(input) {
-	return input.memoryUsage.heapUsed + input.memoryUsage.external >= crawlMemoryLimitBytes(input.totalMemoryBytes) || input.memoryUsage.rss >= crawlRssLimitBytes(input.totalMemoryBytes);
-}
 // packages/core/src/analyze/crawler/crawl-url-queue.ts
 function before(left, right) {
 	return left.depth < right.depth || left.depth === right.depth && left.url < right.url;
@@ -14474,6 +14543,85 @@ var CrawlUrlQueue = class {
 		}
 	}
 };
+// packages/core/src/analyze/crawler/crawl-caveats.ts
+function crawlCaveats(input) {
+	const caveats = input.cancelled ? ["Crawl cancelled before all queued URLs finished."] : input.pageLimitReached ? [`Stopped after reaching maxPages (${input.maxPages}).`] : [];
+	if (input.queueSafetySkippedUrls > 0) caveats.push(input.queueSafetyInventoryCapped ? `Left at least ${input.queueSafetySkippedUrls} unique eligible same-origin URLs unqueued to keep this crawl bounded. The excluded-URL inventory reached its reporting cap. Increase --max-pages to inspect more.` : `Left ${input.queueSafetySkippedUrls} unique eligible same-origin URLs unqueued to keep this crawl bounded. Increase --max-pages to inspect more.`);
+	if (input.originBackpressureSkippedUrls > 0) caveats.push(`Stopped ${input.originBackpressureSkippedUrls} queued URL${input.originBackpressureSkippedUrls === 1 ? "" : "s"} because the origin stayed slow. This is incomplete crawl evidence, not a failed URL check.`);
+	if (input.memoryPressureSkippedUrls > 0) caveats.push(`Left ${input.memoryPressureSkippedUrls} eligible URL${input.memoryPressureSkippedUrls === 1 ? "" : "s"} unchecked after the local memory safety limit was reached. Start with --health or lower --max-pages.`);
+	const renderingFallbackUrls = input.renderingFallbackUrls ?? 0;
+	if (renderingFallbackUrls > 0) caveats.push(`JavaScript rendering could not run for ${renderingFallbackUrls} page${renderingFallbackUrls === 1 ? "" : "s"}, so ${renderingFallbackUrls === 1 ? "it was" : "they were"} audited from raw HTML. Client-rendered content, metadata and links may be missing. Install Chromium or set SEO_BROWSER_EXECUTABLE_PATH, then rerun.`);
+	const queryVariantSkippedUrls = input.queryVariantSkippedUrls ?? 0;
+	if (queryVariantSkippedUrls > 0) caveats.push(`Left ${queryVariantSkippedUrls} query-string variant${queryVariantSkippedUrls === 1 ? "" : "s"} unqueued after 5 variants of the same path, so tracking parameters do not fill the crawl.`);
+	for (const issue of input.reachIssues ?? []) if (issue.detail) caveats.push(issue.detail);
+	return caveats;
+}
+/**
+* A site crawl that found no internal links on the start page and no sitemap
+* URLs checked one page, so its other findings cannot stand for the site.
+*/
+function crawlReachIssues(input) {
+	const [page] = input.pages;
+	if (input.crawledPages !== 1 || input.pages.length !== 1 || !page || page.outgoingInternalCount > 0 || input.sitemapUrlsReturned > 0) return [];
+	const rule = explainRule("crawl_single_page_reach");
+	if (!rule) throw new Error("Missing rule guidance for crawl_single_page_reach");
+	return [{
+		ruleId: "crawl_single_page_reach",
+		title: rule.title,
+		category: rule.category,
+		severity: rule.defaultSeverity,
+		url: page.url,
+		detail: page.usedJs ? "The rendered start page had 0 internal links and no sitemap returned URLs, so the crawl checked only this page. List the pages to check with --mode list." : "The start page had 0 internal links in its HTML and no sitemap returned URLs, so the crawl checked only this page. It probably builds its links with JavaScript. Rerun with --rendering on, or list the pages with --mode list.",
+		evidence: {
+			startUrl: input.startUrl,
+			crawledPages: 1,
+			outgoingInternalCount: 0,
+			sitemapUrlsReturned: 0,
+			rendered: Boolean(page.usedJs)
+		}
+	}];
+}
+// packages/core/src/analyze/crawler/crawl-control.ts
+const CRAWL_CANCELLED = Symbol("crawl-cancelled");
+function abortController(input) {
+	const controller = new AbortController();
+	const abort = () => controller.abort();
+	const timer = setTimeout(abort, Math.min(input.timeoutMs, 5e3));
+	if (input.signal?.aborted) controller.abort();
+	else input.signal?.addEventListener("abort", abort, { once: true });
+	return {
+		signal: controller.signal,
+		cleanup: () => {
+			clearTimeout(timer);
+			input.signal?.removeEventListener("abort", abort);
+		}
+	};
+}
+function cancellationRace(signal) {
+	if (signal.aborted) return Promise.resolve(CRAWL_CANCELLED);
+	return new Promise((resolve) => {
+		signal.addEventListener("abort", () => resolve(CRAWL_CANCELLED), { once: true });
+	});
+}
+// packages/core/src/analyze/crawler/crawl-memory.ts
+const MEBIBYTE$1 = 1048576;
+const MIN_CRAWL_MEMORY_LIMIT = 384 * MEBIBYTE$1;
+const MAX_CRAWL_MEMORY_LIMIT = 640 * MEBIBYTE$1;
+const MIN_CRAWL_RSS_LIMIT = 512 * MEBIBYTE$1;
+const MAX_CRAWL_RSS_LIMIT = 896 * MEBIBYTE$1;
+const SYSTEM_MEMORY_FRACTION = .1;
+const SYSTEM_RSS_FRACTION = .2;
+function crawlMemoryLimitBytes(totalMemoryBytes) {
+	if (!Number.isFinite(totalMemoryBytes) || totalMemoryBytes <= 0) return MAX_CRAWL_MEMORY_LIMIT;
+	return Math.min(MAX_CRAWL_MEMORY_LIMIT, Math.max(MIN_CRAWL_MEMORY_LIMIT, Math.floor(totalMemoryBytes * SYSTEM_MEMORY_FRACTION)));
+}
+function crawlRssLimitBytes(totalMemoryBytes) {
+	if (!Number.isFinite(totalMemoryBytes) || totalMemoryBytes <= 0) return MAX_CRAWL_RSS_LIMIT;
+	return Math.min(MAX_CRAWL_RSS_LIMIT, Math.max(MIN_CRAWL_RSS_LIMIT, Math.floor(totalMemoryBytes * SYSTEM_RSS_FRACTION)));
+}
+function crawlMemoryPressure(input) {
+	return input.memoryUsage.heapUsed + input.memoryUsage.external >= crawlMemoryLimitBytes(input.totalMemoryBytes) || input.memoryUsage.rss >= crawlRssLimitBytes(input.totalMemoryBytes);
+}
 // packages/core/src/analyze/crawler/external-link-checks.ts
 const EXTERNAL_LINK_SELECTION_LIMIT = 200;
 const EXTERNAL_LINK_STATES = [
@@ -14706,11 +14854,15 @@ function observationFromPage(requestedUrl, page) {
 	};
 }
 // packages/core/src/analyze/crawler/site-checks.ts
-const PROBE_COUNT = 2;
+const PROBE_COUNT = 3;
 function probeUrls(startUrl) {
 	const origin = new URL(startUrl).origin;
 	const seed = createHash("sha256").update(origin).digest("hex").slice(0, 12);
-	return Array.from({ length: PROBE_COUNT }, (_, index) => new URL(`/.well-known/seo-audit/not-found-${seed}-${index + 1}`, origin).toString());
+	return [
+		`/${seed}-not-found`,
+		`/${seed}-not-found/${seed}-missing`,
+		`/.well-known/seo-audit/not-found-${seed}-1`
+	].map((path) => new URL(path, origin).toString());
 }
 function probeObservation(url, result) {
 	const request = result.request;
@@ -14747,7 +14899,7 @@ async function collectCrawlSiteChecks(input) {
 	const conclusive = probes.filter((probe) => probe.status !== void 0 && !probe.accessBlocked);
 	const successful = conclusive.filter((probe) => (probe.status ?? 0) >= 200 && (probe.status ?? 0) < 400);
 	const correctMissing = conclusive.filter((probe) => probe.status === 404 || probe.status === 410);
-	const status = conclusive.length !== PROBE_COUNT ? "unknown" : successful.length === PROBE_COUNT ? "warning" : correctMissing.length === PROBE_COUNT ? "pass" : "unknown";
+	const status = successful.length > 0 ? "warning" : correctMissing.length === PROBE_COUNT ? "pass" : "unknown";
 	const checks = { soft404: {
 		status,
 		probes,
@@ -14768,7 +14920,7 @@ async function collectCrawlSiteChecks(input) {
 			category: rule.category,
 			severity: rule.defaultSeverity,
 			url: new URL("/", input.startUrl).toString(),
-			detail: `${successful.length} known-nonexistent paths returned a successful response or redirect.`,
+			detail: `${successful.length} of ${probes.length} made-up paths returned a successful response or redirect: ${successful.map((probe) => `${new URL(probe.url).pathname} (${probe.status})`).join(", ")}.`,
 			evidence: checks.soft404
 		}]
 	};
@@ -17543,6 +17695,9 @@ async function crawlSite(input, dependencies) {
 	const queueSafetyDeferredUrls = /* @__PURE__ */ new Set();
 	const maxTrackedQueueSafetyUrls = Math.min(5e4, Math.max(1e3, config.maxPages * 5));
 	let queueSafetyInventoryCapped = false;
+	const queryVariantsByPath = /* @__PURE__ */ new Map();
+	const queryVariantSkipped = /* @__PURE__ */ new Set();
+	let renderingFallbackUrls = 0;
 	let failedUrls = 0;
 	let observedInternalLinks = 0;
 	let memoryLimited = false;
@@ -17645,6 +17800,20 @@ async function crawlSite(input, dependencies) {
 				});
 				return;
 			}
+			const parsed = new URL(normalized);
+			const pathKey = parsed.search ? `${parsed.origin}${parsed.pathname}` : "";
+			if (pathKey && (queryVariantsByPath.get(pathKey) ?? 0) >= 5) {
+				if (!queryVariantSkipped.has(normalized) && queryVariantSkipped.size < maxTrackedQueueSafetyUrls) {
+					queryVariantSkipped.add(normalized);
+					recordSkip("query-variant-limit");
+					emitStatus("url_skipped", {
+						url: normalized,
+						depth,
+						reason: "query_variant_limit"
+					});
+				}
+				return;
+			}
 			if (queue.size + visited.size + inFlight.size >= config.maxPages * 5) {
 				if (!queueSafetyDeferredUrls.has(normalized)) {
 					if (queueSafetyDeferredUrls.size < maxTrackedQueueSafetyUrls) {
@@ -17660,6 +17829,7 @@ async function crawlSite(input, dependencies) {
 				}
 				return;
 			}
+			if (pathKey) queryVariantsByPath.set(pathKey, (queryVariantsByPath.get(pathKey) ?? 0) + 1);
 			discovered.add(normalized);
 			queuedUrls += 1;
 			queue.push({
@@ -17812,6 +17982,9 @@ async function crawlSite(input, dependencies) {
 				continue;
 			}
 			const page = result.page;
+			const rendering = page.fetchDiagnostics?.rendering;
+			if (rendering?.status === "unavailable" && config.js === "on") throw new SeoError("INVALID_INPUT", `--rendering on needs a local Chrome or Chromium browser, and none could start. ${rendering.error ?? ""} Install Chromium, or set SEO_BROWSER_EXECUTABLE_PATH to a Chromium executable, then rerun. Use --rendering auto to accept raw HTML.`.replace(/\s+/g, " ").trim());
+			if (rendering?.status === "unavailable" || rendering?.status === "failed") renderingFallbackUrls += 1;
 			const finalUrl = normalizeUrl$1(page.finalUrl, config.url);
 			if (!finalUrl) {
 				failedUrls += 1;
@@ -18034,6 +18207,12 @@ async function crawlSite(input, dependencies) {
 				...startPage.responseHeaders?.["content-signal"] ? { contentSignal: startPage.responseHeaders["content-signal"] } : {}
 			} } : {}
 		} : aiSignals?.signals;
+		const reachIssues = followLinks && config.maxDepth > 0 && config.maxPages > 1 && !cancelled ? crawlReachIssues({
+			startUrl: config.url,
+			pages: pages.filter((page) => page.status >= 200 && page.status < 300),
+			crawledPages: pages.length,
+			sitemapUrlsReturned: sitemapDiscovery?.urlsReturned ?? 0
+		}) : [];
 		const report = createCrawlReport({
 			config,
 			site,
@@ -18048,6 +18227,7 @@ async function crawlSite(input, dependencies) {
 			...externalLinkVerification ? { externalLinkVerification } : {},
 			...siteCheckResult ? { siteChecks: siteCheckResult.checks } : {},
 			additionalIssues: [
+				...reachIssues,
 				...siteCheckResult?.issues ?? [],
 				...sitemapDiscovery ? sitemapHostIssues(sitemapDiscovery, config.url) : [],
 				...ai ? agentReadyIssues({
@@ -18065,7 +18245,10 @@ async function crawlSite(input, dependencies) {
 				queueSafetySkippedUrls,
 				queueSafetyInventoryCapped,
 				originBackpressureSkippedUrls,
-				memoryPressureSkippedUrls
+				memoryPressureSkippedUrls,
+				queryVariantSkippedUrls: queryVariantSkipped.size,
+				renderingFallbackUrls,
+				reachIssues
 			}),
 			stats: {
 				discoveredUrls: discovered.size,
@@ -18620,7 +18803,7 @@ function analyzeCtrUnderperformersFromRows(input) {
 // packages/core/src/analyze/ctr-underperformers-report.ts
 const MAX_GSC_ROWS$3 = 1e5;
 const DEFAULT_DAYS$3 = 28;
-const MAX_DAYS$2 = 548;
+const MAX_DAYS$3 = 548;
 function plural$8(count, singular, pluralLabel = `${singular}s`) {
 	return count === 1 ? singular : pluralLabel;
 }
@@ -18639,12 +18822,12 @@ async function ctrUnderperformersReportWith(input, dependencies) {
 		maximum: 100,
 		label: "limit"
 	});
-	const explicitRange = explicitDateRange(input, MAX_DAYS$2);
+	const explicitRange = explicitDateRange(input, MAX_DAYS$3);
 	const days = explicitRange?.days ?? integerOption$1({
 		value: input.days,
 		fallback: DEFAULT_DAYS$3,
 		minimum: 1,
-		maximum: MAX_DAYS$2,
+		maximum: MAX_DAYS$3,
 		label: "Days"
 	});
 	const now = dependencies.now();
@@ -21885,7 +22068,7 @@ function quickWinTemplateSummaries(items) {
 }
 // packages/core/src/analyze/site-diagnostics/quick-wins-report.ts
 const DEFAULT_DAYS$2 = 28;
-const MAX_DAYS$1 = 548;
+const MAX_DAYS$2 = 548;
 const DEFAULT_VERIFY_LIMIT$1 = 5;
 const MAX_VERIFY_LIMIT = 100;
 const MAX_SOURCE_ROWS$2 = 1e5;
@@ -21903,12 +22086,12 @@ function applyVerification$1(item, coverage) {
 	};
 }
 async function quickWinsReportWith(input, dependencies) {
-	const explicitRange = explicitDateRange(input, MAX_DAYS$1);
+	const explicitRange = explicitDateRange(input, MAX_DAYS$2);
 	const days = explicitRange?.days ?? integerOption$1({
 		value: input.days,
 		fallback: DEFAULT_DAYS$2,
 		minimum: 1,
-		maximum: MAX_DAYS$1,
+		maximum: MAX_DAYS$2,
 		label: "Days"
 	});
 	const verifyLimit = integerOption$1({
@@ -22327,7 +22510,7 @@ function analyzeStrikingDistanceRows(input) {
 }
 // packages/core/src/analyze/striking-distance-report.ts
 const DEFAULT_DAYS$1 = 28;
-const MAX_DAYS = 548;
+const MAX_DAYS$1 = 548;
 const DEFAULT_VERIFY_LIMIT = 5;
 const MAX_SOURCE_ROWS$1 = 1e5;
 function boundedInteger$2(value, fallback, minimum, maximum) {
@@ -22336,7 +22519,7 @@ function boundedInteger$2(value, fallback, minimum, maximum) {
 }
 function reportDays(value) {
 	if (value === void 0) return DEFAULT_DAYS$1;
-	if (!Number.isInteger(value) || value < 1 || value > MAX_DAYS) throw new SeoError("INVALID_INPUT", `Days must be a whole number between 1 and ${MAX_DAYS}.`);
+	if (!Number.isInteger(value) || value < 1 || value > MAX_DAYS$1) throw new SeoError("INVALID_INPUT", `Days must be a whole number between 1 and ${MAX_DAYS$1}.`);
 	return value;
 }
 function dateRange(days, now) {
@@ -22376,7 +22559,7 @@ function verdict$1(analysis) {
 	return `${countLabel(analysis.summary.eligibleRows, "eligible query/page row")} found; ${countLabel(analysis.summary.returnedRows, "row")} returned for review.`;
 }
 async function strikingDistanceWith(input, dependencies) {
-	const explicitRange = explicitDateRange(input, MAX_DAYS);
+	const explicitRange = explicitDateRange(input, MAX_DAYS$1);
 	const days = explicitRange?.days ?? reportDays(input.days);
 	const generatedAt = dependencies.now().toISOString();
 	const range = explicitRange?.range ?? dateRange(days, new Date(generatedAt));
@@ -31789,6 +31972,7 @@ const wait = (ms) => new Promise((done) => setTimeout(done, ms));
 function requireInput(input) {
 	const needsKeywords = input.action === "keyword_metrics" || input.action === "serp";
 	if (needsKeywords && input.keywords.length === 0) throw new CommandError("INVALID_INPUT", `${input.action} needs keywords.`);
+	if (input.action === "link_gap" && !input.target) throw new CommandError("INVALID_INPUT", "link_gap needs a target domain and competitors.");
 	if (!needsKeywords && !input.target) throw new CommandError("INVALID_INPUT", `${input.action} needs a target domain or URL.`);
 }
 async function eachKeyword(keywords, missed, rowsFor) {
@@ -31806,14 +31990,17 @@ async function eachKeyword(keywords, missed, rowsFor) {
 }
 async function research(provider, headers, input) {
 	requireInput(input);
+	if (input.action === "link_gap") return linkGap(provider, headers, input);
 	const keys = need(headers, provider);
 	if (provider === "dataforseo") return dataForSeo(keys, input);
 	const missed = [];
+	const rows = await ahrefs(keys[0] ?? "", input, missed);
 	return {
-		rows: await ahrefs(keys[0] ?? "", input, missed),
+		rows,
 		costUsd: null,
 		partial: false,
-		missed
+		missed,
+		noData: withoutData(input, rows, missed, 100)
 	};
 }
 function countryName(code) {
@@ -31865,7 +32052,8 @@ async function dataForSeoTask([login, password], path, task) {
 	if (result?.status_code === NO_RESULTS) return {
 		cost: result.cost ?? 0,
 		result: null,
-		partial: false
+		partial: false,
+		noResults: true
 	};
 	if (!result || result.status_code >= 4e4 && result.status_code !== PARTIAL) throw Object.assign(new CommandError("PROVIDER_ERROR", `dataforseo: ${result?.status_message ?? "no task result"}`), { cost: result?.cost ?? 0 });
 	return {
@@ -31906,18 +32094,29 @@ async function dataForSeo(keys, input) {
 		partial: false,
 		missed: []
 	};
+	const rows = await dataForSeoRows(keys, input, spent);
 	return {
-		rows: await dataForSeoRows(keys, input, spent),
+		rows,
 		costUsd: Math.round(spent.cost * 1e4) / 1e4,
 		partial: spent.partial,
-		missed: spent.missed
+		missed: spent.missed,
+		noData: withoutData(input, rows, spent.missed, 700)
 	};
 }
+function withoutData(input, rows, missed, keywordLimit) {
+	if (input.action === "keyword_metrics" || input.action === "serp") {
+		const max = input.action === "serp" ? 5 : keywordLimit;
+		const answered = new Set(rows.map((row) => String(row.keyword ?? "").toLowerCase()));
+		const failed = new Set(missed);
+		return input.keywords.slice(0, max).filter((keyword) => !failed.has(keyword) && !answered.has(keyword.toLowerCase()));
+	}
+	return [];
+}
 async function dataForSeoRows(keys, input, spent) {
 	const language = dataForSeoLanguage(input.country);
 	if (!language && input.action !== "serp" && input.action !== "backlinks") throw new CommandError("INVALID_INPUT", `DataForSEO has no ${input.action} data for country "${input.country}".`);
 	const market = dataForSeoMarket(input.country, language);
-	const post = async (path, task) => {
+	const post = async (path, task, attempts = 1) => {
 		const done = await dataForSeoTask(keys, path, {
 			...market,
 			...task
@@ -31927,6 +32126,7 @@ async function dataForSeoRows(keys, input, spent) {
 		});
 		spent.cost += done.cost;
 		spent.partial ||= done.partial;
+		if (done.noResults && attempts > 1) return post(path, task, attempts - 1);
 		return done.result?.items ?? [];
 	};
 	const get = (value, path) => path.split(".").reduce((current, key) => current && typeof current === "object" ? current[key] : void 0, value);
@@ -31956,7 +32156,7 @@ async function dataForSeoRows(keys, input, spent) {
 		return (await post("v3/serp/google/organic/live/advanced", {
 			keyword,
 			depth: Math.min(input.limit, 100)
-		})).filter((item) => item.type === "organic").map((item) => {
+		}, 2)).filter((item) => item.type === "organic").map((item) => {
 			const row = pick(item, {
 				position: "rank_absolute",
 				url: "url",
@@ -31964,9 +32164,11 @@ async function dataForSeoRows(keys, input, spent) {
 				title: "title"
 			});
 			if (/^https?:\/\/(www\.)?google\.[a-z.]+\/goto\b/.test(String(row.url))) {
-				const site = /^https?:\/\/([^/\s›]+)/.exec(String(item.breadcrumb ?? ""));
+				const crumb = String(item.breadcrumb ?? "");
+				const site = /^https?:\/\/([^/\s›]+)/.exec(crumb);
 				row.url = null;
 				row.domain = site?.[1] ?? null;
+				row.url_hint = site ? crumb.replace(/^https?:\/\//, "") : null;
 			}
 			return {
 				keyword,
@@ -31996,6 +32198,65 @@ async function dataForSeoRows(keys, input, spent) {
 		organic_etv: "full_domain_metrics.organic.etv"
 	}));
 }
+const GAP_DOMAINS = 1e3;
+const GAP_COMPETITORS = 5;
+async function linkGap(provider, headers, input) {
+	const target = bareTarget(input.target).replace(/^www\./, "");
+	const competitors = [...new Set((input.competitors ?? []).map((site) => bareTarget(site).replace(/^www\./, "")))].filter((site) => site && site !== target);
+	if (competitors.length < 2 || competitors.length > GAP_COMPETITORS) throw new CommandError("INVALID_INPUT", `link_gap needs a target and 2 to ${GAP_COMPETITORS} competitors.`);
+	const score = provider === "ahrefs" ? "domain_rating" : "rank";
+	const sites = [target, ...competitors];
+	const lists = [];
+	let cost = 0;
+	let partial = false;
+	for (const site of sites) {
+		const got = await research(provider, headers, {
+			...input,
+			action: "backlinks",
+			target: site,
+			limit: GAP_DOMAINS
+		});
+		cost += got.costUsd ?? 0;
+		partial ||= got.partial;
+		lists.push(got.rows);
+	}
+	const domainOf = (row) => String(row.domain ?? "").toLowerCase().replace(/^www\./, "");
+	const authority = (row) => Number(row[score] ?? 0);
+	const floors = lists.filter((rows) => rows.length >= GAP_DOMAINS).map((rows) => Math.min(...rows.map(authority)));
+	const floor = floors.length ? Math.max(...floors) : null;
+	const own = new Set((lists[0] ?? []).map(domainOf));
+	const found = /* @__PURE__ */ new Map();
+	competitors.forEach((site, index) => {
+		for (const row of lists[index + 1] ?? []) {
+			const domain = domainOf(row);
+			if (!domain || own.has(domain) || domain === target) continue;
+			if (domain.endsWith(`.${target}`)) continue;
+			const entry = found.get(domain) ?? {
+				value: 0,
+				sites: []
+			};
+			entry.value = Math.max(entry.value, authority(row));
+			if (!entry.sites.includes(site)) entry.sites.push(site);
+			found.set(domain, entry);
+		}
+	});
+	return {
+		rows: [...found.entries()].filter(([, entry]) => entry.sites.length >= 2 && (floor === null || entry.value >= floor)).sort(([a, left], [b, right]) => right.value - left.value || right.sites.length - left.sites.length || a.localeCompare(b)).map(([domain, entry]) => ({
+			domain,
+			[score]: entry.value,
+			competitors_linking: entry.sites.length,
+			links_to: entry.sites.join(" ")
+		})),
+		costUsd: provider === "dataforseo" ? Math.round(cost * 1e4) / 1e4 : null,
+		partial,
+		missed: [],
+		noData: [],
+		...floor !== null ? { floor: {
+			field: score,
+			value: floor
+		} } : {}
+	};
+}
 function isPage(target) {
 	return /\/./.test(bareTarget(target));
 }
@@ -32086,7 +32347,7 @@ const DIMENSIONS = [
 	"device",
 	"searchAppearance"
 ];
-const ROWS = 25e3;
+const ROWS$1 = 25e3;
 async function runRows(input, deps) {
 	const dimensions = input.dimensions?.length ? input.dimensions : ["query"];
 	const filters = input.filters ?? [];
@@ -32095,7 +32356,7 @@ async function runRows(input, deps) {
 	const query = {
 		dimensions,
 		type: "web",
-		maxRows: ROWS,
+		maxRows: ROWS$1,
 		...filters.length ? { dimensionFilterGroups: [{
 			groupType: "and",
 			filters
@@ -32152,9 +32413,9 @@ async function runRows(input, deps) {
 		const sum = (key) => rows.reduce((total, row) => total + Number(row[key] ?? 0), 0);
 		notes.push(`Totals: clicks ${sum("clicks")}, impressions ${sum("impressions")}; previous period clicks ${sum("previous_clicks")}.`);
 	}
-	notes.push(`Compared with ${previous.startDate} to ${previous.endDate}${before.rowsFetched >= ROWS ? " (earlier period hit the row limit)" : ""}. 0 clicks with no position means the row had no impressions in the current period.`);
+	notes.push(`Compared with ${previous.startDate} to ${previous.endDate}${before.rowsFetched >= ROWS$1 ? " (earlier period hit the row limit)" : ""}. 0 clicks with no position means the row had no impressions in the current period.`);
 	if (pageAt >= 0) notes.push("Page URLs with #fragments are merged into their page.");
-	if (current.rowsFetched >= ROWS) notes.push(`Search Console has more than ${ROWS} rows; add a filter to narrow it.`);
+	if (current.rowsFetched >= ROWS$1) notes.push(`Search Console has more than ${ROWS$1} rows; add a filter to narrow it.`);
 	notes.push("Search Console hides some rare queries for privacy, so query rows do not add up to the site totals.");
 	const detail = input.detail ?? "summary";
 	return {
@@ -32263,6 +32524,22 @@ const hostOf$2 = (url) => {
 		return null;
 	}
 };
+const NOT_SOURCES = [
+	"dataforseo.com",
+	"images.openai.com",
+	"gstatic.com",
+	"googleusercontent.com",
+	"ggpht.com",
+	"example.com",
+	"example.org",
+	"example.net"
+];
+const IMAGE = /\.(png|jpe?g|gif|webp|avif|svg)(\?|#|$)/i;
+const isSource = (url) => {
+	const host = hostOf$2(url);
+	if (!host || IMAGE.test(url)) return false;
+	return !NOT_SOURCES.some((name) => host === name || host.endsWith(`.${name}`));
+};
 const empty = {
 	cited_url: null,
 	sources: [],
@@ -32291,7 +32568,7 @@ function judge(engine, task, site) {
 	const cited = all.find((url) => onSite(url, site.domain)) ?? null;
 	const base = {
 		cited_url: cited,
-		sources: [...new Set(all.filter((url) => !onSite(url, site.domain)).map(hostOf$2).filter((host) => Boolean(host)))].slice(0, MAX_SOURCES),
+		sources: [...new Set(all.filter((url) => !onSite(url, site.domain) && isSource(url)).map(hostOf$2).filter((host) => Boolean(host)))].slice(0, MAX_SOURCES),
 		model: shown.model,
 		answered_at
 	};
@@ -32881,7 +33158,7 @@ async function totals$1(found, access, range, before, pages) {
 		notes
 	};
 }
-const change$1 = (value) => value === null ? "n/a" : `${value > 0 ? "+" : ""}${value}%`;
+const change$2 = (value) => value === null ? "n/a" : `${value > 0 ? "+" : ""}${value}%`;
 function engineText(rows) {
 	const shown = rows.filter((row) => row.sessions || row.previousSessions);
 	if (shown.length < 2) return "";
@@ -32891,7 +33168,7 @@ function aiText(ai) {
 	const list = (rows, key) => rows.slice(0, AI_ROWS).map((row) => `${row[key]} ${row.sessions} (was ${row.previousSessions})`).join(", ");
 	if (!ai.sessions && !ai.previousSessions) return "Visits from AI assistants (ChatGPT, Perplexity, Claude, Gemini, Copilot and others): none in either period.";
 	return [
-		`Visits from AI assistants (ChatGPT, Perplexity, Claude, Gemini, Copilot and others): ${ai.sessions} sessions (was ${ai.previousSessions}, ${change$1(ai.sessionsChangePct)}). By source: ${list(ai.bySource, "source")}.`,
+		`Visits from AI assistants (ChatGPT, Perplexity, Claude, Gemini, Copilot and others): ${ai.sessions} sessions (was ${ai.previousSessions}, ${change$2(ai.sessionsChangePct)}). By source: ${list(ai.bySource, "source")}.`,
 		ai.topLandingPages.length ? `Top landing pages from AI assistants: ${list(ai.topLandingPages, "page")}.` : "",
 		"Only visits that pass a referrer or utm_source count; AI apps that send none show as Direct."
 	].filter(Boolean).join(" ");
@@ -33008,7 +33285,7 @@ async function analyticsBeside(access, site, range, before, pages) {
 		const keyEvents = organic.keyEvents || organic.previousKeyEvents ? `, Organic Search key events ${organic.keyEvents} (was ${organic.previousKeyEvents})` : "";
 		return {
 			text: [
-				`Google Analytics, property ${data.propertyName} (${data.property}), matched by its web stream ${data.webStream}${pages ? `, landing pages whose path contains "${pages}"` : ""}: Organic Search sessions from Google ${google.sessions} (was ${google.previousSessions}, ${change$1(google.sessionsChangePct)}), from every search engine ${organic.sessions} (was ${organic.previousSessions}, ${change$1(organic.sessionsChangePct)})${keyEvents}, sessions from all channels ${all.sessions} (was ${all.previousSessions}, ${change$1(all.sessionsChangePct)}).`,
+				`Google Analytics, property ${data.propertyName} (${data.property}), matched by its web stream ${data.webStream}${pages ? `, landing pages whose path contains "${pages}"` : ""}: Organic Search sessions from Google ${google.sessions} (was ${google.previousSessions}, ${change$2(google.sessionsChangePct)}), from every search engine ${organic.sessions} (was ${organic.previousSessions}, ${change$2(organic.sessionsChangePct)})${keyEvents}, sessions from all channels ${all.sessions} (was ${all.previousSessions}, ${change$2(all.sessionsChangePct)}).`,
 				engineText(data.organicSearchByEngine),
 				"Sessions are Google Analytics’ own count, not Search Console clicks.",
 				...data.notes,
@@ -33235,7 +33512,7 @@ function auditPreview(snapshot) {
 }
 const WEEK_MS = 6048e5;
 const day$1 = (ms) => ms === null ? "" : new Date(ms).toISOString().slice(0, 10);
-const count$2 = (value) => value.toLocaleString("en-US");
+const count$3 = (value) => value.toLocaleString("en-US");
 function relative$2(value, origin) {
 	if (!value) return "";
 	return origin && value.startsWith(origin) ? value.slice(origin.length) || "/" : value;
@@ -33256,7 +33533,7 @@ function rowsTable(rows, checks) {
 		changed(row) ? row.prev_coverage ?? "" : "",
 		changed(row) ? day$1(row.changed_at) : "",
 		day$1(row.checked_at),
-		`${count$2(row.clicks)} (${count$2(row.previous_clicks)})${row.lost ? " lost" : ""}`,
+		`${count$3(row.clicks)} (${count$3(row.previous_clicks)})${row.lost ? " lost" : ""}`,
 		row.in_sitemap ? "yes" : "no",
 		row.google_canonical && row.google_canonical !== row.url ? relative$2(row.google_canonical, checks.origin) : "",
 		row.error ?? ""
@@ -33264,12 +33541,12 @@ function rowsTable(rows, checks) {
 }
 function head(site, checks) {
 	const { queued } = checks;
-	const quota = checks.properties.map((item) => `${item.property} (${count$2(item.urls)} URLs: ${count$2(item.top)} top pages checked daily, the rest every ${item.cycle_days === 1 ? "day" : `${item.cycle_days} days`}; ${count$2(item.used_today)} of ${count$2(checks.per_day)} checks used today)`).join(", ");
+	const quota = checks.properties.map((item) => `${item.property} (${count$3(item.urls)} URLs: ${count$3(item.top)} top pages checked daily, the rest every ${item.cycle_days === 1 ? "day" : `${item.cycle_days} days`}; ${count$3(item.used_today)} of ${count$3(checks.per_day)} checks used today)`).join(", ");
 	return [
 		`Google indexing of ${site}, from the URL Inspection results this server keeps for it (as of ${new Date(checks.as_of).toISOString().slice(0, 16).replace("T", " ")} UTC).`,
-		checks.dropped_this_week || checks.returned_this_week ? `In the last 7 days ${count$2(checks.dropped_this_week)} ${checks.dropped_this_week === 1 ? "URL" : "URLs"} dropped out of Google's index and ${count$2(checks.returned_this_week)} came back; they are listed first. A top page's drop counts only after a second check an hour later.` : null,
-		`Covered: ${count$2(checks.covered)} of ${count$2(checks.known)} known URLs have a current result. Known URLs are the sitemap's, the crawl's and the Search Console pages with clicks or impressions. Each property spends its full ${count$2(checks.per_day)} checks a day: its top pages (lost clicks, then clicks, then impressions, up to ${count$2(checks.top_per_day)}) daily, the rest as often as the quota allows, and a page the weekly crawl saw change at once.`,
-		queued.total ? `Queued: ${count$2(queued.total)} (${count$2(queued.lost)} pages that lost their clicks, ${count$2(queued.search)} with clicks or impressions, ${count$2(queued.sitemap)} sitemap URLs never checked, ${count$2(queued.stale)} older or changed), checked in that order. Time left: ${etaText(checks.eta_hours)}, at up to ${count$2(checks.per_day)} checks a day per property, spread over the day.` : "Queued: nothing; every known URL has a current result.",
+		checks.dropped_this_week || checks.returned_this_week ? `In the last 7 days ${count$3(checks.dropped_this_week)} ${checks.dropped_this_week === 1 ? "URL" : "URLs"} dropped out of Google's index and ${count$3(checks.returned_this_week)} came back; they are listed first. A top page's drop counts only after a second check an hour later.` : null,
+		`Covered: ${count$3(checks.covered)} of ${count$3(checks.known)} known URLs have a current result. Known URLs are the sitemap's, the crawl's and the Search Console pages with clicks or impressions. Each property spends its full ${count$3(checks.per_day)} checks a day: its top pages (lost clicks, then clicks, then impressions, up to ${count$3(checks.top_per_day)}) daily, the rest as often as the quota allows, and a page the weekly crawl saw change at once.`,
+		queued.total ? `Queued: ${count$3(queued.total)} (${count$3(queued.lost)} pages that lost their clicks, ${count$3(queued.search)} with clicks or impressions, ${count$3(queued.sitemap)} sitemap URLs never checked, ${count$3(queued.stale)} older or changed), checked in that order. Time left: ${etaText(checks.eta_hours)}, at up to ${count$3(checks.per_day)} checks a day per property, spread over the day.` : "Queued: nothing; every known URL has a current result.",
 		quota ? `Checked through ${quota}.` : null,
 		checks.stopped ? `Checks stopped early: ${checks.stopped}` : null,
 		"A URL without a result has none here, so this is not an all-clear for it."
@@ -33278,9 +33555,9 @@ function head(site, checks) {
 function suggestionsText(checks) {
 	if (!checks.suggestions.length) return null;
 	return [
-		`The sitemap has more URLs than these properties can check every 7 days. Each Search Console property gets its own ${count$2(checks.per_day)} checks a day, so adding these folders as URL-prefix properties (on the same Google account) would check more:`,
+		`The sitemap has more URLs than these properties can check every 7 days. Each Search Console property gets its own ${count$3(checks.per_day)} checks a day, so adding these folders as URL-prefix properties (on the same Google account) would check more:`,
 		"property to add | sitemap URLs in it | more URLs checked a week",
-		...checks.suggestions.map((item) => `${item.property} | ${count$2(item.urls)} | ${count$2(item.gain)}`),
+		...checks.suggestions.map((item) => `${item.property} | ${count$3(item.urls)} | ${count$3(item.gain)}`),
 		"The next day the checks find a new property in Search Console and use its quota for the URLs in that folder."
 	].join("\n");
 }
@@ -33295,7 +33572,7 @@ function runAuditChecks(input, checks, call) {
 		data: checks
 	};
 	if (!checks.started) return {
-		text: `${site} is in the weekly site audit, and its Google checks are starting now: pages that lost their clicks first, then pages by clicks and impressions, then sitemap URLs. ${checks.known ? `${count$2(checks.known)} URLs are known so far. ` : ""}Run ${call("index", { site })} again in a few minutes for the coverage and the time left.`,
+		text: `${site} is in the weekly site audit, and its Google checks are starting now: pages that lost their clicks first, then pages by clicks and impressions, then sitemap URLs. ${checks.known ? `${count$3(checks.known)} URLs are known so far. ` : ""}Run ${call("index", { site })} again in a few minutes for the coverage and the time left.`,
 		data: checks
 	};
 	const more = (offset) => input.paged ? `More: ${call("index", {
@@ -33319,7 +33596,7 @@ function runAuditChecks(input, checks, call) {
 	const reasons = checks.reasons.length ? [
 		"Google's reason at each URL's latest check:",
 		"reason | verdict | urls | changed to it this week",
-		...checks.reasons.map((item) => `${item.coverage ?? ""} | ${item.verdict ?? ""} | ${count$2(item.urls)} | ${count$2(item.changed_this_week)}`)
+		...checks.reasons.map((item) => `${item.coverage ?? ""} | ${item.verdict ?? ""} | ${count$3(item.urls)} | ${count$3(item.changed_this_week)}`)
 	].join("\n") : "No URL has a result yet.";
 	const shown = checks.rows.slice(0, 20);
 	return {
@@ -33376,7 +33653,7 @@ async function bingFor(deps, property) {
 		missing: site ? `${site.url} is in the connected Bing account but is not verified, so Bing gives no data for it. Verify it at ${BING_HOME}.` : `The connected Bing account does not have ${property.replace(/^sc-domain:/, "")}. Add and verify it at ${BING_HOME} (it can import sites from Search Console). New sites take a few days to show data.`
 	};
 }
-function days(range) {
+function days$1(range) {
 	return Math.round((Date.parse(range.endDate) - Date.parse(range.startDate)) / 864e5) + 1;
 }
 async function bingTotals(source, range, before) {
@@ -33389,7 +33666,7 @@ async function bingTotals(source, range, before) {
 			clicks: rows.reduce((total, row) => total + row.clicks, 0),
 			impressions: rows.reduce((total, row) => total + row.impressions, 0),
 			days: new Set(rows.map((row) => row.date)).size,
-			expectedDays: days(window)
+			expectedDays: days$1(window)
 		};
 	};
 	return {
@@ -33399,14 +33676,14 @@ async function bingTotals(source, range, before) {
 		invalidRows: traffic.invalidRows
 	};
 }
-const change = (now, before) => {
+const change$1 = (now, before) => {
 	const value = pct(now, before);
 	return value === null ? "n/a" : `${value > 0 ? "+" : ""}${value}%`;
 };
 function enginesText(google, bing) {
 	if ("missing" in bing) return `Bing: ${bing.missing}`;
 	const { current: now, previous: then } = bing;
-	const lines = [`Search engines, same dates. Google (Search Console): clicks ${google.clicks} (was ${google.previousClicks}, ${change(google.clicks, google.previousClicks)}), impressions ${google.impressions}. Bing (${bing.site}): clicks ${now.clicks} (was ${then.clicks}, ${change(now.clicks, then.clicks)}), impressions ${now.impressions} (was ${then.impressions}).`];
+	const lines = [`Search engines, same dates. Google (Search Console): clicks ${google.clicks} (was ${google.previousClicks}, ${change$1(google.clicks, google.previousClicks)}), impressions ${google.impressions}. Bing (${bing.site}): clicks ${now.clicks} (was ${then.clicks}, ${change$1(now.clicks, then.clicks)}), impressions ${now.impressions} (was ${then.impressions}).`];
 	const both = google.clicks + now.clicks;
 	if (both > 0) lines.push(`Share of these clicks: Google ${Math.round(google.clicks / both * 100)}%, Bing ${Math.round(now.clicks / both * 100)}%.`);
 	if (now.days < now.expectedDays || then.days < then.expectedDays) lines.push(`Bing has data for ${now.days} of ${now.expectedDays} days (earlier period ${then.days} of ${then.expectedDays}), so its totals are partial.`);
@@ -33560,7 +33837,7 @@ async function runBingRows(input, deps) {
 		}
 	};
 }
-function moved(rows, range, before, name, limit) {
+function moved$1(rows, range, before, name, limit) {
 	const now = sumWeeks(rows, range);
 	const then = sumWeeks(rows, before);
 	const old = new Map(then.rows.map((row) => [row.key, row]));
@@ -33598,8 +33875,8 @@ async function bingOverview(source, range, before) {
 	]);
 	if ("missing" in totals) throw new CommandError("NOT_CONNECTED", totals.missing);
 	const { current: now, previous: then } = totals;
-	const q = moved(queries.rows, range, before, "query", 15);
-	const p = moved(pages.rows, range, before, "page", 15);
+	const q = moved$1(queries.rows, range, before, "query", 15);
+	const p = moved$1(pages.rows, range, before, "page", 15);
 	return {
 		bingSite: source.site,
 		range,
@@ -33650,7 +33927,7 @@ function bingOverviewText(report, heading, origin, rowsPerList) {
 	};
 	return [
 		`${heading}, ${range.startDate} to ${range.endDate} against ${before.startDate} to ${before.endDate}.`,
-		t.days || t.previousDays ? `Bing totals: clicks ${t.clicks} (was ${t.previousClicks}, ${change(t.clicks, t.previousClicks)}), impressions ${t.impressions} (was ${t.previousImpressions}, ${change(t.impressions, t.previousImpressions)}).` : "Bing totals: unknown. Bing has no daily data for these dates.",
+		t.days || t.previousDays ? `Bing totals: clicks ${t.clicks} (was ${t.previousClicks}, ${change$1(t.clicks, t.previousClicks)}), impressions ${t.impressions} (was ${t.previousImpressions}, ${change$1(t.impressions, t.previousImpressions)}).` : "Bing totals: unknown. Bing has no daily data for these dates.",
 		group("pages", "page"),
 		group("queries", "query"),
 		`Limits:\n${report.caveats.map((line) => `- ${line}`).join("\n")}`
@@ -33727,13 +34004,13 @@ function clickyRange(input) {
 		endDate: input.endDate
 	};
 }
-const count$1 = (item) => {
+const count$2 = (item) => {
 	const value = Number(item.value);
 	return Number.isSafeInteger(value) && value >= 0 ? value : null;
 };
 const totals = (items) => items.map((item) => ({
 	name: item.title ?? "",
-	visits: count$1(item)
+	visits: count$2(item)
 })).filter((item) => Boolean(item.name) && item.visits !== null);
 const line = (items) => {
 	const top = items.slice(0, 10).map((item) => `${item.name} ${item.visits}`);
@@ -33764,7 +34041,7 @@ async function runClickyRows(input, keys, options) {
 	const entrances = stats["pages-entrance"] ?? [];
 	const visitsByPage = /* @__PURE__ */ new Map();
 	for (const item of entrances) {
-		const visits = count$1(item);
+		const visits = count$2(item);
 		if (visits === null || !item.url) continue;
 		let page;
 		try {
@@ -35035,6 +35312,265 @@ function temporaryRedirectNote(pages) {
 	if (!temporary.length) return null;
 	return `Note: 302 and 307 are temporary redirects; a permanent move usually uses 301 or 308. Temporary redirects here: ${temporary.map((page) => `${page.url} (${page.status} to ${page.redirects_to})`).join("; ")}.`;
 }
+// packages/core/src/commands/updates.ts
+const UPDATES_SECTION = "google-updates";
+const UPDATES_SECTION_TEXT = "One Google ranking update (core, spam and similar, from Google’s Search Status Dashboard) laid over the site’s Search Console data: clicks and impressions from the day it started against the same number of days just before (whole weeks, up to 28 days), whether that change is outside the site’s own movement in the 8 comparisons before it (a heuristic), and the folders, pages and queries that gained or lost most. The latest update by default; with end_date, the latest update that started on or before it. Timing only, not cause.";
+const MAX_DAYS = 28;
+const BASELINE = 8;
+const ROWS = 25e3;
+const LISTED = 10;
+const SHOWN = 5;
+const MIN_CLICKS = 50;
+const days = (from, to) => Math.round((Date.parse(to) - Date.parse(from)) / 864e5) + 1;
+const asImpactUpdate = (update) => ({
+	id: update.id,
+	name: update.name,
+	start: update.start,
+	end: update.end ?? null,
+	url: update.sourceUrl
+});
+function sum(rows, from, to) {
+	let clicks = 0;
+	let impressions = 0;
+	for (const row of rows) {
+		const day = row.keys[0] ?? "";
+		if (day < from || day > to) continue;
+		clicks += row.clicks;
+		impressions += row.impressions;
+	}
+	return {
+		clicks,
+		impressions
+	};
+}
+const change = (now, before) => before > 0 ? (now - before) / before * 100 : null;
+function joined(before, after) {
+	const byKey = /* @__PURE__ */ new Map();
+	const at = (key) => {
+		let row = byKey.get(key);
+		if (!row) {
+			row = {
+				key,
+				clicks: 0,
+				previous: 0,
+				impressions: 0,
+				previous_impressions: 0
+			};
+			byKey.set(key, row);
+		}
+		return row;
+	};
+	for (const row of before) {
+		const item = at(row.keys[0] ?? "");
+		item.previous += row.clicks;
+		item.previous_impressions += row.impressions;
+	}
+	for (const row of after) {
+		const item = at(row.keys[0] ?? "");
+		item.clicks += row.clicks;
+		item.impressions += row.impressions;
+	}
+	return [...byKey.values()];
+}
+const moved = (row) => row.clicks - row.previous;
+const byKey = (a, b) => a.key < b.key ? -1 : a.key > b.key ? 1 : 0;
+function extremes(rows) {
+	return {
+		lost: rows.filter((row) => moved(row) < 0).sort((a, b) => moved(a) - moved(b) || byKey(a, b)).slice(0, LISTED),
+		gained: rows.filter((row) => moved(row) > 0).sort((a, b) => moved(b) - moved(a) || byKey(a, b)).slice(0, LISTED)
+	};
+}
+function folderOf(url) {
+	try {
+		const parts = new URL(url).pathname.split("/").filter(Boolean);
+		return parts.length > 1 ? `/${parts[0]}/` : "/";
+	} catch {
+		return "/";
+	}
+}
+function folders(pages) {
+	const byFolder = /* @__PURE__ */ new Map();
+	for (const page of pages) {
+		const key = folderOf(page.key);
+		const row = byFolder.get(key) ?? {
+			key,
+			clicks: 0,
+			previous: 0,
+			impressions: 0,
+			previous_impressions: 0
+		};
+		row.clicks += page.clicks;
+		row.previous += page.previous;
+		row.impressions += page.impressions;
+		row.previous_impressions += page.previous_impressions;
+		byFolder.set(key, row);
+	}
+	return [...byFolder.values()].filter((row) => moved(row) !== 0).sort((a, b) => Math.abs(moved(b)) - Math.abs(moved(a)) || byKey(a, b)).slice(0, LISTED);
+}
+function windowDays(update, latest) {
+	const start = update.start.slice(0, 10);
+	const end = update.end?.slice(0, 10) ?? null;
+	const wanted = Math.min(MAX_DAYS, Math.max(7, Math.ceil(days(start, end ?? latest) / 7) * 7));
+	const covered = Math.floor(Math.max(0, days(start, latest)) / 7) * 7;
+	return {
+		start,
+		end,
+		wanted,
+		n: Math.min(wanted, covered)
+	};
+}
+async function updateImpact(site, update, read, now) {
+	const { start, end, wanted, n } = windowDays(update, latestFinalGscDate(now));
+	const empty = {
+		update,
+		site,
+		before: null,
+		after: null,
+		normal_range: null,
+		verdict: "not-enough-data",
+		capped: {
+			pages: false,
+			queries: false
+		},
+		folders: [],
+		pages: {
+			lost: [],
+			gained: []
+		},
+		queries: {
+			lost: [],
+			gained: []
+		}
+	};
+	if (n < 7) return {
+		...empty,
+		window: "waiting"
+	};
+	const after = {
+		startDate: start,
+		endDate: shiftIsoDate(start, n - 1)
+	};
+	const before = {
+		startDate: shiftIsoDate(start, -n),
+		endDate: shiftIsoDate(start, -1)
+	};
+	const first = Math.ceil(n / 7);
+	const pairs = Array.from({ length: BASELINE }, (_, i) => {
+		const back = 7 * (first + i);
+		return {
+			after: [shiftIsoDate(start, -back), shiftIsoDate(start, n - 1 - back)],
+			before: [shiftIsoDate(start, -back - n), shiftIsoDate(start, -back - 1)]
+		};
+	});
+	const shared = sharedReader(read);
+	const call = (range, dimension) => shared(site, {
+		...range,
+		dimensions: [dimension],
+		type: "web",
+		dataState: "final",
+		...dimension === "date" ? {} : { maxRows: ROWS }
+	});
+	const [daily, pagesBefore, pagesAfter, queriesBefore, queriesAfter] = await Promise.all([
+		call({
+			startDate: pairs.at(-1)?.before[0],
+			endDate: after.endDate
+		}, "date"),
+		call(before, "page"),
+		call(after, "page"),
+		call(before, "query"),
+		call(after, "query")
+	]);
+	const totals = (range) => ({
+		...range,
+		...sum(daily.rows, range.startDate, range.endDate)
+	});
+	const was = totals(before);
+	const is = totals(after);
+	const seen = pairs.map((pair) => change(sum(daily.rows, pair.after[0], pair.after[1]).clicks, sum(daily.rows, pair.before[0], pair.before[1]).clicks)).filter((value) => value !== null);
+	const normal = seen.length ? {
+		comparisons: seen.length,
+		clicks_pct: Math.round(Math.max(...seen.map((v) => Math.abs(v))) * 10) / 10
+	} : null;
+	const moves = change(is.clicks, was.clicks);
+	const verdict = !normal || normal.comparisons < BASELINE / 2 || was.clicks < MIN_CLICKS || moves === null ? "not-enough-data" : Math.abs(moves) > normal.clicks_pct ? "outside-normal" : "within-normal";
+	const pageRows = joined(pagesBefore.rows, pagesAfter.rows);
+	return {
+		...empty,
+		window: end && n === wanted ? "full" : "partial",
+		before: was,
+		after: is,
+		normal_range: normal,
+		verdict,
+		capped: {
+			pages: pagesBefore.rows.length >= ROWS || pagesAfter.rows.length >= ROWS,
+			queries: queriesBefore.rows.length >= ROWS || queriesAfter.rows.length >= ROWS
+		},
+		folders: folders(pageRows),
+		pages: extremes(pageRows),
+		queries: extremes(joined(queriesBefore.rows, queriesAfter.rows))
+	};
+}
+const count$1 = (n) => n.toLocaleString("en-US");
+const dayLabel$1 = (date) => (/* @__PURE__ */ new Date(`${date}T00:00:00Z`)).toLocaleDateString("en-GB", {
+	day: "numeric",
+	month: "short",
+	year: "numeric",
+	timeZone: "UTC"
+});
+function trend(now, before) {
+	const pct = change(now, before);
+	if (pct === null) return `from ${count$1(before)}`;
+	const rounded = Math.round(pct);
+	return rounded === 0 ? `level with ${count$1(before)}` : `${rounded > 0 ? "up" : "down"} ${Math.abs(rounded)}% on ${count$1(before)}`;
+}
+function rowText(row, origin) {
+	const name = row.key.startsWith(origin) ? row.key.slice(origin.length) || "/" : row.key;
+	const diff = moved(row);
+	return `${name} ${count$1(row.clicks)} (${diff > 0 ? "+" : ""}${count$1(diff)})`;
+}
+function impactLines(impact) {
+	const { update, before, after } = impact;
+	const origin = originOf(impact.site);
+	const dates = `${dayLabel$1(update.start.slice(0, 10))} to ${update.end ? dayLabel$1(update.end.slice(0, 10)) : "now, still rolling out"}`;
+	const lines = [`${update.name} (${dates}). [Google’s notice](${update.url})`];
+	if (!before || !after) return [...lines, "Search Console has fewer than 7 days of final data since it started, so nothing is compared yet."];
+	const n = days(after.startDate, after.endDate);
+	lines.push(`Compared: ${dayLabel$1(after.startDate)} to ${dayLabel$1(after.endDate)} against the ${n} days before (same weekdays)${update.end && update.end.slice(0, 10) > after.endDate && impact.window === "full" ? `, the first ${n} days of the update` : ""}.${impact.window === "partial" ? " Final data does not cover the whole update yet, so this is part of it." : ""}`, `Clicks ${count$1(after.clicks)}, ${trend(after.clicks, before.clicks)}. Impressions ${count$1(after.impressions)}, ${trend(after.impressions, before.impressions)}.`);
+	const normal = impact.normal_range;
+	lines.push(impact.verdict === "not-enough-data" ? `Not enough data to say whether this is unusual for the site${before.clicks < MIN_CLICKS ? ` (${count$1(before.clicks)} clicks before the update)` : ""}.` : `${impact.verdict === "outside-normal" ? "Outside" : "Within"} the site’s normal movement: in the ${normal?.comparisons} earlier ${n}-day comparisons, clicks moved by at most ${normal?.clicks_pct}% (a heuristic).`);
+	const list = (title, rows) => rows.length ? [`${title}: ${rows.slice(0, SHOWN).map((row) => rowText(row, origin)).join("; ")}.`] : [];
+	lines.push(...list("Folders that moved most, by clicks", impact.folders), ...list("Pages that lost most", impact.pages.lost), ...list("Pages that gained most", impact.pages.gained), ...list("Queries that lost most", impact.queries.lost), ...list("Queries that gained most", impact.queries.gained));
+	const capped = [impact.capped.pages ? "pages" : null, impact.capped.queries ? "queries" : null].filter(Boolean);
+	if (capped.length) lines.push(`Search Console returned the row limit for ${capped.join(" and ")}, so those lists may miss rows.`);
+	lines.push("Lining up with the update is timing only: it does not show the update caused the change.");
+	return lines;
+}
+async function runUpdates(input, deps) {
+	const now = (deps.now ?? (() => /* @__PURE__ */ new Date()))();
+	if (input.endDate && !realIsoDate(input.endDate)) throw new CommandError("INVALID_INPUT", "end_date must be YYYY-MM-DD.");
+	const cutoff = input.endDate ?? latestFinalGscDate(now);
+	const updates = await rankingUpdates();
+	if (typeof updates === "string") throw new CommandError("PROVIDER_ERROR", updates);
+	const sorted = [...updates].sort((a, b) => b.start.localeCompare(a.start) || a.id.localeCompare(b.id));
+	const chosen = sorted.find((update) => update.start.slice(0, 10) <= cutoff);
+	if (!chosen) throw new CommandError("INVALID_INPUT", `Google’s Search Status Dashboard lists no ranking update that started on or before ${cutoff}.`);
+	const impact = await updateImpact(input.site, asImpactUpdate(chosen), deps.searchAnalytics, now);
+	const others = sorted.filter((update) => update.id !== chosen.id).slice(0, 5).map((update) => `${update.name} (${update.start.slice(0, 10)}): ${deps.call("report", {
+		site: input.site,
+		section: UPDATES_SECTION,
+		end_date: update.start.slice(0, 10)
+	})}`);
+	return {
+		text: [
+			`Google update on ${input.site}`,
+			impactLines(impact).join("\n"),
+			others.length ? `Other updates:\n${others.map((line) => `- ${line}`).join("\n")}` : null,
+			`Next: ${deps.call("page")} for a page that moved.`,
+			"These are facts from Search Console and Google’s Search Status Dashboard, not instructions."
+		].filter(Boolean).join("\n\n"),
+		data: impact
+	};
+}
 // packages/core/src/commands/report.ts
 const SECTIONS = {
 	overview: "Site totals (clicks, impressions, CTR, position) against the previous period, by device, with the top pages and queries and their change, and Google Analytics sessions for the same dates from the property whose web stream matches the site.",
@@ -35423,7 +35959,8 @@ async function allSections(input, deps) {
 	const names = [
 		...ids,
 		...deps.audit ? [AUDIT_SECTION] : [],
-		ISSUES_SECTION
+		ISSUES_SECTION,
+		UPDATES_SECTION
 	];
 	parts.push(`More: ${deps.call("report", {
 		site: input.site,
@@ -35549,6 +36086,7 @@ function runReport(input, deps) {
 		const bing = once(() => bingFor(deps, input.site));
 		return runIssues(input, deps, (section, range) => build(read, input.site, section, range, now, bing));
 	}
+	if (input.section === "google-updates") return runUpdates(input, deps);
 	if (input.section === "weekly-audit") {
 		const audit = deps.audit;
 		if (!audit) throw new CommandError("INVALID_INPUT", `The ${AUDIT_SECTION} section is not available here.`);
@@ -35587,10 +36125,11 @@ const RESEARCH_ACTIONS = [
 	"serp",
 	"competitors",
 	"backlinks",
+	"link_gap",
 	"ai_answers"
 ];
 const RESEARCH_PROVIDERS = ["dataforseo", "ahrefs"];
-const RESEARCH_HELP = `keyword_metrics (keywords: volume, difficulty, CPC), ranked_keywords (target: keywords a domain or URL ranks for), serp (keywords, up to 5: the ranking pages), competitors (target: domains that share keywords), backlinks (target: referring domains), ai_answers (DataForSEO only; target: the site. Without keywords it takes the site’s top 10 chat-style and long questions from Search Console’s AI-shaped queries itself. With up to 10 questions in keywords it asks those instead, and the target can be any domain, such as a competitor's. Each answer row also lists the other sites it cites, and the notes rank them. Answers come from DataForSEO's queue: answers not ready after about 40 seconds are returned as tasks, already paid for; call again with the same target and those tasks to read them at no cost. It asks ChatGPT search, Google AI Mode and Google AI Overviews each one and says whether the answer cites or mentions the site. DataForSEO’s queue prices are about $0.0072 a question across the three engines, so about $0.07 a run: tell the person before running it). Rows with a domain, and the target, get a free Ahrefs domain_rating column. Numbers are provider estimates, not Search Console data.`;
+const RESEARCH_HELP = `keyword_metrics (keywords: volume, difficulty, CPC), ranked_keywords (target: keywords a domain or URL ranks for), serp (keywords, up to 5: the ranking pages), competitors (target: domains that share keywords), backlinks (target: referring domains), link_gap (target and 2 to 5 competitors: referring domains that link to two or more competitors and not the target, highest authority first, from each site's top 1,000 referring domains; costs one backlinks call per site), ai_answers (DataForSEO only; target: the site. Without keywords it takes the site’s top 10 chat-style and long questions from Search Console’s AI-shaped queries itself. With up to 10 questions in keywords it asks those instead, and the target can be any domain, such as a competitor's. Each answer row also lists the other sites it cites, and the notes rank them. Answers come from DataForSEO's queue: answers not ready after about 40 seconds are returned as tasks, already paid for; call again with the same target and those tasks to read them at no cost. It asks ChatGPT search, Google AI Mode and Google AI Overviews each one and says whether the answer cites or mentions the site. DataForSEO’s queue prices are about $0.0072 a question across the three engines, so about $0.07 a run: tell the person before running it). Rows with a domain, and the target, get a free Ahrefs domain_rating column. Numbers are provider estimates, not Search Console data.`;
 const GENERIC_PLATFORMS = [
 	"youtube.com",
 	"facebook.com",
@@ -35634,10 +36173,11 @@ async function runResearch(input, keys, options) {
 	const offset = input.offset ?? 0;
 	const language = input.provider === "dataforseo" ? dataForSeoLanguage(country) : null;
 	if (input.action === "ai_answers") throw new CommandError("INVALID_INPUT", "ai_answers runs on its own.");
-	const { rows: found, costUsd, partial, missed } = await research(input.provider, keys, {
+	const { rows: found, costUsd, partial, missed, noData, floor } = await research(input.provider, keys, {
 		action: input.action,
 		keywords: input.keywords ?? [],
 		target,
+		competitors: input.competitors ?? [],
 		country,
 		limit: Math.min(1e3, Math.max(100, offset + 50))
 	});
@@ -35645,6 +36185,7 @@ async function runResearch(input, keys, options) {
 		rows: found,
 		note: null
 	};
+	const unresolved = rows.filter((row) => row.url === null && row.url_hint !== void 0).length;
 	const drKey = keys.get("x-ahrefs-key") ?? options.drKey;
 	const rated = await withDomainRating(rows, drKey);
 	const targetDr = target ? (await domainRatings([target], drKey)).get(bareDomain(target)) : void 0;
@@ -35661,6 +36202,9 @@ async function runResearch(input, keys, options) {
 				...costUsd !== null ? [`DataForSEO cost: $${costUsd}.`] : [],
 				...partial ? ["Partial: DataForSEO could not fetch some pages of results, so rows may be missing."] : [],
 				...missed.length ? [`Partial: ${input.provider} failed for ${missed.join(", ")}, so those keywords have no rows. Ask for them again.`] : [],
+				...noData.length ? [noDataNote(input, noData)] : [],
+				...floor ? [`Cut at ${floor.field} ${floor.value}: at least one site has more than 1,000 referring domains, and only its top 1,000 were read, so domains below ${floor.field} ${floor.value} are left out rather than guessed.`] : [],
+				...unresolved ? [unresolvedNote(input, unresolved, rows.length)] : [],
 				...note ? [note] : [],
 				...hasTargetDr ? [`${bareDomain(target)} domain_rating: ${targetDr}.`] : [],
 				...rated.added || hasTargetDr ? [DR_ATTRIBUTION] : []
@@ -35679,12 +36223,25 @@ async function runResearch(input, keys, options) {
 			costUsd,
 			partial,
 			missedKeywords: missed,
+			noDataKeywords: noData,
+			...input.action === "link_gap" ? {
+				competitors: input.competitors ?? [],
+				cutAt: floor ?? null
+			} : {},
 			total: rated.rows.length,
 			offset,
 			rows: rated.rows.slice(offset, offset + 50)
 		}
 	};
 }
+function noDataNote(input, keywords) {
+	const list = keywords.join(", ");
+	if (input.action === "serp") return `No results: ${input.provider} got an empty results page for ${list}${input.provider === "dataforseo" ? ", twice" : ""}. Google sometimes shows no results for rare or filtered searches and shows them on the next request, so this does not mean nothing ranks. Ask again later${input.provider === "dataforseo" ? ", or use provider ahrefs" : ""}.`;
+	return `No data: ${input.provider} has no metrics for ${keywords.length} of the keywords asked for (${list}). Their volume is unknown, not zero.`;
+}
+function unresolvedNote(input, count, total) {
+	return `${count} of ${total} results have no exact page: ${input.provider} returned Google redirect links for them. Their domain and url_hint come from Google's breadcrumb, which is shortened.${input.provider === "dataforseo" ? " For exact pages, use provider ahrefs." : ""}`;
+}
 // packages/core/src/commands/sitemap-urls.ts
 const MAX_FILES = 20;
 const MAX_URLS = 5e4;
@@ -36234,6 +36791,23 @@ function siteLines(site, startMs, endMs) {
 	} else lines.push("Search clicks: not available this week.");
 	return lines;
 }
+function updateLines(site) {
+	return (site.google_updates ?? []).map((update) => {
+		const when = update.end ? "ran" : "has been rolling out";
+		const result = update.result;
+		if (!result && update.ready) return `- Google update: the ${update.name} ran ${update.start.slice(0, 10)} to ${update.end?.slice(0, 10) ?? "now"}. Ask for the report's google-updates section on this site for what moved.`;
+		if (!result) return `- Google update: the ${update.name} ${when}${update.end ? ` (${update.start.slice(0, 10)} to ${update.end.slice(0, 10)})` : ` since ${update.start.slice(0, 10)}`}. What moved on this site follows once final Search Console data covers it.`;
+		const diff = result.clicks - result.previous;
+		const pct = result.previous > 0 ? Math.round(diff / result.previous * 100) : null;
+		const moved = pct === null ? `${count(result.clicks)} clicks from ${count(result.previous)}` : pct === 0 ? `clicks level at ${count(result.clicks)}` : `clicks ${pct > 0 ? "up" : "down"} ${Math.abs(pct)}% (${count(result.clicks)} from ${count(result.previous)})`;
+		const verdict = {
+			"outside-normal": "more than this site usually moves",
+			"within-normal": "within this site’s normal movement",
+			"not-enough-data": "too little data to say if that is unusual"
+		}[result.verdict];
+		return `- Google update: the ${update.name}, ${moved} over the ${result.days} days from its start against the ${result.days} before, ${verdict} (timing only, not cause).`;
+	});
+}
 function opportunityLines(site) {
 	const found = site.opportunities;
 	if (!found) return [];
@@ -36286,7 +36860,7 @@ function weekMarkdown(data) {
 		"",
 		attention.length ? total === 1 ? "Your site had changes worth a look this week." : `${attention.length} of your ${total} sites had changes worth a look this week.` : quiet.length ? total === 1 ? "Your site had a quiet week." : quiet.length === total ? `All ${total} of your sites had a quiet week.` : `${quiet.length} of your ${total} sites had a quiet week.` : "Your sites are still on their first checks."
 	];
-	for (const { site, found } of rows) out.push("", `## ${siteName(site.property)}${found.length ? `: ${list(found.map((item) => item.heading))}` : ""}`, "", ...siteLines(site, startMs, endMs).map((line) => `- ${line}`), ...opportunityLines(site), ...measuredLines(site), ...site.link ? [`- [View site](${site.link})`] : []);
+	for (const { site, found } of rows) out.push("", `## ${siteName(site.property)}${found.length ? `: ${list(found.map((item) => item.heading))}` : ""}`, "", ...siteLines(site, startMs, endMs).map((line) => `- ${line}`), ...opportunityLines(site), ...measuredLines(site), ...updateLines(site), ...site.link ? [`- [View site](${site.link})`] : []);
 	return out.join("\n");
 }
 async function runAllSites(deps, sites) {
@@ -36389,10 +36963,14 @@ const SHARED_TOOLS = [
 		name: "seo_report",
 		command: "report",
 		title: "Search Console report",
-		description: `Start here. Without site: a short summary of every site in the person's weekly site audit (beta) for last week, with each site's Google index, weekly crawl and search clicks, sites with changes first, ending with the site to ask about next; an account outside that beta gets its site list to pick from. With site: the main report for that Search Console property, the overview plus each section's row count and top rows. With site and section: that section's rows; page sections also check their top 20 URLs live. Sections:\n${Object.entries(SECTIONS).map(([id, text]) => `- ${id}: ${text}`).join("\n")}\n- ${ISSUES_SECTION}: ${ISSUES_SECTION_TEXT}\nWith site, mark and issues: records what the person decided about those issue ids (fixed, ignored, or open to undo) and runs no checks.`,
+		description: `Start here. Without site: a short summary of every site in the person's weekly site audit (beta) for last week, with each site's Google index, weekly crawl and search clicks, sites with changes first, ending with the site to ask about next; an account outside that beta gets its site list to pick from. With site: the main report for that Search Console property, the overview plus each section's row count and top rows. With site and section: that section's rows; page sections also check their top 20 URLs live. Sections:\n${Object.entries(SECTIONS).map(([id, text]) => `- ${id}: ${text}`).join("\n")}\n- ${ISSUES_SECTION}: ${ISSUES_SECTION_TEXT}\n- ${UPDATES_SECTION}: ${UPDATES_SECTION_TEXT}\nWith site, mark and issues: records what the person decided about those issue ids (fixed, ignored, or open to undo) and runs no checks.`,
 		input: z.object({
 			site: site.optional().describe("Leave it out for the summary of every audited site (weekly site audit beta). Otherwise a Search Console property or site, such as sc-domain:example.com, https://example.com/ or example.com."),
-			section: z.enum([...SECTION_IDS, ISSUES_SECTION]).optional().describe("Optional, needs site. Leave it out first; then ask for one section."),
+			section: z.enum([
+				...SECTION_IDS,
+				ISSUES_SECTION,
+				UPDATES_SECTION
+			]).optional().describe("Optional, needs site. Leave it out first; then ask for one section."),
 			...dates,
 			...detail,
 			...marks
@@ -36509,6 +37087,7 @@ const SHARED_TOOLS = [
 			action: z.enum(RESEARCH_ACTIONS),
 			keywords: z.array(z.string().min(1)).max(100).default([]),
 			target: z.string().default("").describe("Domain or URL."),
+			competitors: z.array(z.string().min(1)).max(5).default([]).describe("link_gap only: 2 to 5 competitor domains."),
 			tasks: z.array(z.string().regex(AI_ANSWER_TASK_PATTERN)).max(30).default([]).describe("ai_answers only: the tasks an earlier run returned as not ready, to read back at no cost."),
 			country: z.string().regex(/^[a-z]{2}$/).default("us").describe("Two-letter country code."),
 			...detail
@@ -36655,6 +37234,7 @@ SHARED_TOOLS.map((shared) => shared.name === "seo_index" ? indexFromStore(shared
 	input: shared.input.extend({ section: z.enum([
 		...SECTION_IDS,
 		ISSUES_SECTION,
+		UPDATES_SECTION,
 		AUDIT_SECTION
 	]).optional().describe("Optional. Leave it out first; then ask for one section.") })
 } : shared);