seo 0.2.21 → 0.2.22

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-CSE-hgHf.js";
+import { n as version, t as load } from "./esm-insIkRuo.js";
 import { Headers, fetch as fetch$1 } from "undici";
 import { chmodSync, createReadStream, createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { arch, homedir, platform, totalmem } from "node:os";
@@ -2249,7 +2249,7 @@ function aiReferralSourceForValue(value) {
 }
 //#endregion
 //#region packages/core/src/analyze/ai-referrals-analysis.ts
-function compareText$18(left, right) {
+function compareText$19(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function metric$1(row, name) {
@@ -2338,7 +2338,7 @@ function analyzeAiReferralRows(input) {
 	const generalCaveat = "Google Analytics only attributes visits that arrive with a recognized session source; some AI visits appear as direct, unassigned, or another source.";
 	const possiblyTruncated = input.sourceDiscovery.truncated || input.detail.truncated || input.totalUsersEvidence.truncated;
 	const allLandingPages = [...pageTotals.entries()].map(([landingPage, metrics]) => {
-		const topSourceId = [...metrics.sources.entries()].sort((left, right) => right[1] - left[1] || compareText$18(left[0], right[0]))[0]?.[0];
+		const topSourceId = [...metrics.sources.entries()].sort((left, right) => right[1] - left[1] || compareText$19(left[0], right[0]))[0]?.[0];
 		const topSource = topSourceId ? sourceTotals.get(topSourceId)?.definition : void 0;
 		if (!topSource) throw new SeoError("PROVIDER_UNAVAILABLE", "Could not resolve the top AI referral source.");
 		return {
@@ -2352,7 +2352,7 @@ function analyzeAiReferralRows(input) {
 				label: topSource.label
 			}
 		};
-	}).sort((left, right) => right.sessions - left.sessions || compareText$18(left.landingPage, right.landingPage));
+	}).sort((left, right) => right.sessions - left.sessions || compareText$19(left.landingPage, right.landingPage));
 	const landingPages = allLandingPages.slice(0, input.resultLimit);
 	const selection = {
 		limit: input.resultLimit,
@@ -2397,19 +2397,19 @@ function analyzeAiReferralRows(input) {
 			id: source.definition.id,
 			label: source.definition.label,
 			source: source.definition.label,
-			observedSessionSources: [...source.observedSessionSources].sort(compareText$18),
+			observedSessionSources: [...source.observedSessionSources].sort(compareText$19),
 			sessions: source.sessions,
 			eventCount: source.eventCount,
 			totalUsers: null,
 			shareOfAiSessions: total.sessions ? source.sessions / total.sessions : 0,
 			share: total.sessions ? source.sessions / total.sessions : 0
-		})).sort((left, right) => right.sessions - left.sessions || compareText$18(left.id, right.id)),
+		})).sort((left, right) => right.sessions - left.sessions || compareText$19(left.id, right.id)),
 		landingPages,
 		daily: [...dailyTotals.entries()].map(([date, metrics]) => ({
 			date,
 			...metrics,
 			totalUsers: null
-		})).sort((left, right) => compareText$18(left.date, right.date)),
+		})).sort((left, right) => compareText$19(left.date, right.date)),
 		caveats: [
 			generalCaveat,
 			"Attribution uses Google Analytics sessionSource only; landing-page text, medium text, and event referrers are never treated as referral sources.",
@@ -2499,7 +2499,7 @@ function sessionSourceInListFilter(values) {
 //#endregion
 //#region packages/core/src/analyze/ai-referrals.ts
 const DEFAULT_MAX_ROWS$1 = 1e5;
-const MAX_ROWS = 1e5;
+const MAX_ROWS$1 = 1e5;
 const DEFAULT_RESULT_LIMIT = 25;
 const MAX_RESULT_LIMIT = 1e3;
 function validIsoDate$1(value) {
@@ -2525,7 +2525,7 @@ function reportRange(input) {
 function maxRows(input) {
 	if (input.maxRows !== void 0 && input.limit !== void 0 && input.maxRows !== input.limit) throw new SeoError("INVALID_INPUT", "Use maxRows or the legacy limit option, not both.");
 	const value = input.maxRows ?? input.limit ?? DEFAULT_MAX_ROWS$1;
-	if (!Number.isInteger(value) || value < 1 || value > MAX_ROWS) throw new SeoError("INVALID_INPUT", `maxRows must be a whole number between 1 and ${MAX_ROWS}.`);
+	if (!Number.isInteger(value) || value < 1 || value > MAX_ROWS$1) throw new SeoError("INVALID_INPUT", `maxRows must be a whole number between 1 and ${MAX_ROWS$1}.`);
 	return value;
 }
 function resultLimit(input) {
@@ -5948,7 +5948,7 @@ function tokenStem(token) {
 function tokensMatch(a, b) {
 	return a === b || tokenStem(a) === tokenStem(b);
 }
-function includesTokenSequence(queryTokens, termTokens) {
+function includesTokenSequence$1(queryTokens, termTokens) {
 	if (!termTokens.length || termTokens.length > queryTokens.length) return false;
 	for (let index = 0; index <= queryTokens.length - termTokens.length; index++) if (termTokens.every((termToken, offset) => tokensMatch(queryTokens[index + offset] ?? "", termToken))) return true;
 	return false;
@@ -5977,7 +5977,7 @@ function isBrandQuery(query, brandTerms) {
 		const compactMatches = (compactTermLength >= 6 || /[^\p{ASCII}]/u.test(compactTerm) && compactTermLength >= 2) && compactQuery.includes(compactTerm);
 		const termTokens = normalizedTerm.split(" ");
 		if (termTokens.length === 1) return queryTokens.some((queryToken) => tokensMatch(queryToken, normalizedTerm)) || compactMatches;
-		return includesTokenSequence(queryTokens, termTokens) || compactMatches;
+		return includesTokenSequence$1(queryTokens, termTokens) || compactMatches;
 	});
 }
 function shouldExcludeBrandQuery(input) {
@@ -6289,7 +6289,7 @@ function resolveQueryOpportunityInput(input, now) {
 }
 //#endregion
 //#region packages/core/src/analyze/query-opportunity-rows.ts
-function compareText$17(left, right) {
+function compareText$18(left, right) {
 	const leftPoints = [...left].map((value) => value.codePointAt(0) ?? 0);
 	const rightPoints = [...right].map((value) => value.codePointAt(0) ?? 0);
 	for (let index = 0; index < Math.min(leftPoints.length, rightPoints.length); index++) {
@@ -6299,9 +6299,9 @@ function compareText$17(left, right) {
 	return leftPoints.length - rightPoints.length;
 }
 function compareQueryOpportunityRows(left, right) {
-	return right.impressions - left.impressions || right.clicks - left.clicks || left.position - right.position || compareText$17(left.query, right.query);
+	return right.impressions - left.impressions || right.clicks - left.clicks || left.position - right.position || compareText$18(left.query, right.query);
 }
-function validRow$3(row, query) {
+function validRow$4(row, query) {
 	return row.keys.length === 1 && Boolean(query) && Number.isFinite(row.clicks) && Number.isFinite(row.impressions) && Number.isFinite(row.ctr) && Number.isFinite(row.position) && row.clicks >= 0 && row.impressions > 0 && row.clicks <= row.impressions && row.ctr >= 0 && row.ctr <= 1 && row.position > 0;
 }
 function signature(row) {
@@ -6311,7 +6311,7 @@ function normalizeQueryOpportunityRows(rows, selection) {
 	const grouped = /* @__PURE__ */ new Map();
 	for (const row of rows) {
 		const query = row.keys[0]?.trim() ?? "";
-		if (!validRow$3(row, query)) {
+		if (!validRow$4(row, query)) {
 			selection.invalidRows++;
 			continue;
 		}
@@ -7323,11 +7323,11 @@ function selectBenchmarkRows$1(input) {
 }
 //#endregion
 //#region packages/core/src/analyze/page-opportunities-analysis.ts
-function compareText$16(left, right) {
+function compareText$17(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function compareItems$2(left, right) {
-	return (right.estimatedCtrClickShortfall ?? -1) - (left.estimatedCtrClickShortfall ?? -1) || right.impressions - left.impressions || left.position - right.position || compareText$16(left.query, right.query) || compareText$16(left.url, right.url);
+	return (right.estimatedCtrClickShortfall ?? -1) - (left.estimatedCtrClickShortfall ?? -1) || right.impressions - left.impressions || left.position - right.position || compareText$17(left.query, right.query) || compareText$17(left.url, right.url);
 }
 function analyzeRow(input) {
 	const query = input.row.keys[0]?.trim() ?? "";
@@ -12024,19 +12024,19 @@ function sanitizeIssues(issues) {
 function sanitizeMessages(values = []) {
 	return values.map((value) => sanitizeTenantString(value));
 }
-function compareText$15(left, right) {
+function compareText$16(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function sortPages(pages) {
-	return [...pages].sort((left, right) => compareText$15(left.url, right.url));
+	return [...pages].sort((left, right) => compareText$16(left.url, right.url));
 }
 function sortRequests(requests) {
 	return [...requests].sort((left, right) => {
-		const byUrl = compareText$15(left.requestedUrl, right.requestedUrl);
+		const byUrl = compareText$16(left.requestedUrl, right.requestedUrl);
 		if (byUrl) return byUrl;
-		const byOutcome = compareText$15(left.outcome, right.outcome);
+		const byOutcome = compareText$16(left.outcome, right.outcome);
 		if (byOutcome) return byOutcome;
-		return compareText$15(left.outcome === "response" ? `${left.status}:${left.finalUrl}` : left.outcome === "skipped" ? left.reason : `${left.failureKind}:${left.error}`, right.outcome === "response" ? `${right.status}:${right.finalUrl}` : right.outcome === "skipped" ? right.reason : `${right.failureKind}:${right.error}`);
+		return compareText$16(left.outcome === "response" ? `${left.status}:${left.finalUrl}` : left.outcome === "skipped" ? left.reason : `${left.failureKind}:${left.error}`, right.outcome === "response" ? `${right.status}:${right.finalUrl}` : right.outcome === "skipped" ? right.reason : `${right.failureKind}:${right.error}`);
 	});
 }
 function summarizeCrawlReport(input) {
@@ -12258,8 +12258,8 @@ function createCrawlReport(input) {
 		...input.externalLinkVerification ? { externalLinkVerification: sanitizeTenantValue(input.externalLinkVerification) } : {},
 		...input.siteChecks ? { siteChecks: sanitizeTenantValue(input.siteChecks) } : {},
 		...input.agentDiscovery ? { agentDiscovery: sanitizeTenantValue(input.agentDiscovery) } : {},
-		warnings: sanitizeMessages(input.warnings).sort(compareText$15),
-		caveats: sanitizeMessages(input.caveats).sort(compareText$15)
+		warnings: sanitizeMessages(input.warnings).sort(compareText$16),
+		caveats: sanitizeMessages(input.caveats).sort(compareText$16)
 	};
 }
 function normalizeLoadedCrawlReport(report) {
@@ -12289,8 +12289,8 @@ function normalizeLoadedCrawlReport(report) {
 		pages,
 		issues,
 		issueGroups: groupCrawlIssues(issues),
-		warnings: sanitizeMessages(report.warnings).sort(compareText$15),
-		caveats: sanitizeMessages(report.caveats).sort(compareText$15)
+		warnings: sanitizeMessages(report.warnings).sort(compareText$16),
+		caveats: sanitizeMessages(report.caveats).sort(compareText$16)
 	};
 }
 //#endregion
@@ -14167,12 +14167,12 @@ function urlPath(url) {
 		return "";
 	}
 }
-function compareText$14(left, right) {
+function compareText$15(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function landingPageValuesFromRows(rows) {
 	const orderedRows = [...rows].sort((left, right) => {
-		return compareText$14(normalizePath(left.landingPagePlusQueryString ?? ""), normalizePath(right.landingPagePlusQueryString ?? "")) || compareText$14(left.landingPagePlusQueryString ?? "", right.landingPagePlusQueryString ?? "") || compareText$14(left.sessions ?? "", right.sessions ?? "") || compareText$14(left.totalUsers ?? "", right.totalUsers ?? "") || compareText$14(left.conversions ?? "", right.conversions ?? "");
+		return compareText$15(normalizePath(left.landingPagePlusQueryString ?? ""), normalizePath(right.landingPagePlusQueryString ?? "")) || compareText$15(left.landingPagePlusQueryString ?? "", right.landingPagePlusQueryString ?? "") || compareText$15(left.sessions ?? "", right.sessions ?? "") || compareText$15(left.totalUsers ?? "", right.totalUsers ?? "") || compareText$15(left.conversions ?? "", right.conversions ?? "");
 	});
 	const values = /* @__PURE__ */ new Map();
 	for (const row of orderedRows) {
@@ -16858,7 +16858,7 @@ function countLabel(count, singular, pluralLabel = `${singular}s`) {
 //#region packages/core/src/analyze/crawler/okf.ts
 const OKF_DEFAULT_CONCEPTS = 500;
 const OKF_MAX_CONCEPTS = 5e3;
-function compareText$13(left, right) {
+function compareText$14(left, right) {
 	const leftPoints = [...left].map((value) => value.codePointAt(0) ?? 0);
 	const rightPoints = [...right].map((value) => value.codePointAt(0) ?? 0);
 	for (let index = 0; index < Math.min(leftPoints.length, rightPoints.length); index++) {
@@ -16948,7 +16948,7 @@ function okfTitle(value, report) {
 }
 function selectedOkfPages(report, requestedLimit) {
 	const limit = okfConceptLimit(requestedLimit);
-	const eligible = report.pages.filter((page) => page.indexable && page.status >= 200 && page.status < 300 && !page.blocked && !page.error).sort((left, right) => (right.searchMetrics?.clicks ?? 0) - (left.searchMetrics?.clicks ?? 0) || (right.searchMetrics?.impressions ?? 0) - (left.searchMetrics?.impressions ?? 0) || (right.internalLinkAuthorityScore ?? 0) - (left.internalLinkAuthorityScore ?? 0) || (right.internalInlinkCount ?? 0) - (left.internalInlinkCount ?? 0) || compareText$13(left.finalUrl, right.finalUrl));
+	const eligible = report.pages.filter((page) => page.indexable && page.status >= 200 && page.status < 300 && !page.blocked && !page.error).sort((left, right) => (right.searchMetrics?.clicks ?? 0) - (left.searchMetrics?.clicks ?? 0) || (right.searchMetrics?.impressions ?? 0) - (left.searchMetrics?.impressions ?? 0) || (right.internalLinkAuthorityScore ?? 0) - (left.internalLinkAuthorityScore ?? 0) || (right.internalInlinkCount ?? 0) - (left.internalInlinkCount ?? 0) || compareText$14(left.finalUrl, right.finalUrl));
 	const unique = /* @__PURE__ */ new Map();
 	for (const page of eligible) if (!unique.has(page.finalUrl)) unique.set(page.finalUrl, page);
 	const uniquePages = [...unique.values()];
@@ -18446,7 +18446,7 @@ const CTR_DEFAULT_MIN_IMPRESSIONS = 200;
 const CTR_MAX_MIN_IMPRESSIONS = 1e9;
 const CTR_DEFAULT_LIMIT = 25;
 const CTR_MAX_LIMIT = 100;
-function compareText$12(left, right) {
+function compareText$13(left, right) {
 	const leftPoints = [...left].map((value) => value.codePointAt(0) ?? 0);
 	const rightPoints = [...right].map((value) => value.codePointAt(0) ?? 0);
 	for (let index = 0; index < Math.min(leftPoints.length, rightPoints.length); index++) {
@@ -18455,7 +18455,7 @@ function compareText$12(left, right) {
 	}
 	return leftPoints.length - rightPoints.length;
 }
-function boundedInteger$6(value, fallback, minimum, maximum) {
+function boundedInteger$7(value, fallback, minimum, maximum) {
 	if (value === void 0 || !Number.isFinite(value)) return fallback;
 	return Math.min(maximum, Math.max(minimum, Math.floor(value)));
 }
@@ -18494,7 +18494,7 @@ function aggregateCtrRows(rows, selection) {
 			weightedPosition: 0,
 			sourceRows: 0
 		};
-		if (compareText$12(query, group.query) < 0) group.query = query;
+		if (compareText$13(query, group.query) < 0) group.query = query;
 		group.clicks += row.clicks;
 		group.impressions += row.impressions;
 		group.weightedPosition += row.position * row.impressions;
@@ -18532,8 +18532,8 @@ function initialSelection(sourceRows) {
 	};
 }
 function analyzeCtrUnderperformersFromRows(input) {
-	const minImpressions = boundedInteger$6(input.minImpressions, 200, 1, CTR_MAX_MIN_IMPRESSIONS);
-	const limit = boundedInteger$6(input.limit, 25, 1, 100);
+	const minImpressions = boundedInteger$7(input.minImpressions, 200, 1, CTR_MAX_MIN_IMPRESSIONS);
+	const limit = boundedInteger$7(input.limit, 25, 1, 100);
 	const selection = initialSelection(input.rows.length);
 	const benchmarkRows = aggregateCtrRows(input.rows, selection).filter((row) => {
 		const query = row.keys[0] ?? "";
@@ -18598,7 +18598,7 @@ function analyzeCtrUnderperformersFromRows(input) {
 				confidence: "low"
 			}
 		};
-	}).filter((item) => item.actualCtr < item.expectedCtr * .6).sort((left, right) => right.clickShortfall - left.clickShortfall || compareText$12(left.query, right.query) || compareText$12(left.url, right.url));
+	}).filter((item) => item.actualCtr < item.expectedCtr * .6).sort((left, right) => right.clickShortfall - left.clickShortfall || compareText$13(left.query, right.query) || compareText$13(left.url, right.url));
 	const items = eligibleItems.slice(0, limit);
 	selection.eligibleUnderperformers = eligibleItems.length;
 	selection.returnedUnderperformers = items.length;
@@ -18829,7 +18829,7 @@ function diagnosisDataStatus(input) {
 function fixed$1(value) {
 	return Number(value.toFixed(3));
 }
-function compareText$11(left, right) {
+function compareText$12(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function validMetric$2(value) {
@@ -18909,8 +18909,8 @@ function compareRetainedSegmentRows(input) {
 		else unmatched.push(unmatchedRow(row, "before"));
 	}
 	for (const [key, row] of after.rows) if (!before.rows.has(key)) unmatched.push(unmatchedRow(row, "after"));
-	matched.sort((left, right) => Math.abs(right.clickDelta) - Math.abs(left.clickDelta) || compareText$11(left.key, right.key));
-	unmatched.sort((left, right) => right.clicks - left.clicks || compareText$11(left.retainedIn, right.retainedIn) || compareText$11(left.key, right.key));
+	matched.sort((left, right) => Math.abs(right.clickDelta) - Math.abs(left.clickDelta) || compareText$12(left.key, right.key));
+	unmatched.sort((left, right) => right.clicks - left.clicks || compareText$12(left.retainedIn, right.retainedIn) || compareText$12(left.key, right.key));
 	return {
 		before,
 		after,
@@ -19667,13 +19667,13 @@ const MINIMUM_PAGE_SHARE = .1;
 const MINIMUM_PAGE_IMPRESSIONS = 10;
 const MAXIMUM_DOMINANT_SHARE = .8;
 const MAX_SUPPRESSIONS = 100;
-function boundedInteger$5(value, fallback, minimum, maximum) {
+function boundedInteger$6(value, fallback, minimum, maximum) {
 	if (value === void 0 || !Number.isFinite(value)) return fallback;
 	return Math.min(maximum, Math.max(minimum, Math.floor(value)));
 }
 function analyzeCannibalRows(input) {
-	const minImpressions = boundedInteger$5(input.minImpressions, 50, 0, 1e9);
-	const limit = boundedInteger$5(input.limit, 25, 1, 100);
+	const minImpressions = boundedInteger$6(input.minImpressions, 50, 0, 1e9);
+	const limit = boundedInteger$6(input.limit, 25, 1, 100);
 	const selection = {
 		sourceRows: input.rows.length,
 		invalidRows: 0,
@@ -19999,7 +19999,7 @@ function normalizeUrl(value) {
 		return;
 	}
 }
-function validRow$2(row, query, url) {
+function validRow$3(row, query, url) {
 	return Boolean(query && url) && Number.isFinite(row.clicks) && row.clicks >= 0 && Number.isFinite(row.impressions) && row.impressions > 0 && row.clicks <= row.impressions && Number.isFinite(row.ctr) && row.ctr >= 0 && row.ctr <= 1 && Number.isFinite(row.position) && row.position > 0;
 }
 function aggregateDecayRows(rows) {
@@ -20008,7 +20008,7 @@ function aggregateDecayRows(rows) {
 	for (const row of rows) {
 		const query = row.keys[0]?.trim() ?? "";
 		const url = normalizeUrl(row.keys[1]?.trim() ?? "");
-		if (!validRow$2(row, query, url)) {
+		if (!validRow$3(row, query, url)) {
 			invalid++;
 			continue;
 		}
@@ -20415,7 +20415,7 @@ function normalizedQuery(value) {
 function groupKey$1(item) {
 	return `${item.template.id}:${normalizedQuery(item.query)}`;
 }
-function compareText$10(left, right) {
+function compareText$11(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function groupAction(input) {
@@ -20451,11 +20451,11 @@ function groupQuickWins(items) {
 			technicalUrls
 		});
 		return group;
-	}).filter((group) => group !== void 0).sort((left, right) => right.totalEstimatedCtrClickShortfall - left.totalEstimatedCtrClickShortfall || right.totalImpressions - left.totalImpressions || compareText$10(left.id, right.id));
+	}).filter((group) => group !== void 0).sort((left, right) => right.totalEstimatedCtrClickShortfall - left.totalEstimatedCtrClickShortfall || right.totalImpressions - left.totalImpressions || compareText$11(left.id, right.id));
 }
 //#endregion
 //#region packages/core/src/analyze/site-diagnostics/quick-wins-analysis-primitives.ts
-function boundedInteger$4(value, fallback, minimum, maximum) {
+function boundedInteger$5(value, fallback, minimum, maximum) {
 	if (value === void 0 || !Number.isFinite(value)) return fallback;
 	return Math.min(maximum, Math.max(minimum, Math.floor(value)));
 }
@@ -20467,7 +20467,7 @@ function validHttpUrl(value) {
 		return false;
 	}
 }
-function validRow$1(row, query, url) {
+function validRow$2(row, query, url) {
 	return row.keys.length >= 2 && Boolean(query) && validHttpUrl(url) && Number.isFinite(row.clicks) && row.clicks >= 0 && Number.isFinite(row.impressions) && row.impressions > 0 && row.clicks <= row.impressions && Number.isFinite(row.ctr) && row.ctr >= 0 && row.ctr <= 1 && Number.isFinite(row.position) && row.position >= 1;
 }
 function selectBenchmarkRows(input) {
@@ -20489,7 +20489,7 @@ function selectBenchmarkRows(input) {
 	for (const row of input.rows) {
 		const query = row.keys[0]?.trim() ?? "";
 		const url = row.keys[1]?.trim() ?? "";
-		if (!validRow$1(row, query, url)) selection.invalidRows++;
+		if (!validRow$2(row, query, url)) selection.invalidRows++;
 		else if (row.position > 10) selection.outsideBenchmarkPositionRows++;
 		else if (isLowActionabilityQuery(query)) selection.lowActionabilityRows++;
 		else if (shouldExcludeBrandQuery({
@@ -20563,11 +20563,11 @@ function quickWinItem(input) {
 		}
 	};
 }
-function compareText$9(left, right) {
+function compareText$10(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function compareQuickWinItems(left, right) {
-	return right.estimatedCtrClickShortfall - left.estimatedCtrClickShortfall || right.impressions - left.impressions || compareText$9(left.query, right.query) || compareText$9(left.url, right.url);
+	return right.estimatedCtrClickShortfall - left.estimatedCtrClickShortfall || right.impressions - left.impressions || compareText$10(left.query, right.query) || compareText$10(left.url, right.url);
 }
 function roundedSum(values) {
 	return Number(values.reduce((sum, value) => sum + value, 0).toFixed(2));
@@ -20580,8 +20580,8 @@ const DEFAULT_LIMIT$3 = 25;
 const MAX_LIMIT$3 = 100;
 const FALLBACK_SOURCE = "builtin_position_ctr_curve_v1";
 function analyzeQuickWinsFromRows(input) {
-	const minImpressions = boundedInteger$4(input.minImpressions, DEFAULT_MIN_IMPRESSIONS$2, 0, MAX_MIN_IMPRESSIONS$2);
-	const limit = boundedInteger$4(input.limit, DEFAULT_LIMIT$3, 1, MAX_LIMIT$3);
+	const minImpressions = boundedInteger$5(input.minImpressions, DEFAULT_MIN_IMPRESSIONS$2, 0, MAX_MIN_IMPRESSIONS$2);
+	const limit = boundedInteger$5(input.limit, DEFAULT_LIMIT$3, 1, MAX_LIMIT$3);
 	const selected = selectBenchmarkRows(input);
 	const benchmarkContext = createCtrBenchmarkContext(selected.rows, {
 		samplePopulation: "all_qualified_url_samples",
@@ -20682,7 +20682,7 @@ function analyzeQuickWinsFromRows(input) {
 }
 //#endregion
 //#region packages/core/src/analyze/site-diagnostics/quick-wins-templates.ts
-function compareText$8(left, right) {
+function compareText$9(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function unique$2(values) {
@@ -20708,7 +20708,7 @@ function quickWinTemplateRecommendations(items) {
 			action: technicalUrls > 0 ? `Fix verified technical issues on ${technicalUrls} affected URLs before testing shared template changes.` : `Compare live results and verified page evidence for ${urls.length} affected URLs before testing a shared title, snippet, or heading change.`,
 			evidence: `${templateItems.length} eligible rows across ${urls.length} distinct URLs share this recognised template. Example queries: ${queries.join("; ")}.`
 		};
-	}).filter((item) => item !== void 0).sort((left, right) => right.totalEstimatedCtrClickShortfall - left.totalEstimatedCtrClickShortfall || right.totalImpressions - left.totalImpressions || compareText$8(left.templateId, right.templateId));
+	}).filter((item) => item !== void 0).sort((left, right) => right.totalEstimatedCtrClickShortfall - left.totalEstimatedCtrClickShortfall || right.totalImpressions - left.totalImpressions || compareText$9(left.templateId, right.templateId));
 }
 function quickWinTemplateSummaries(items) {
 	const templates = /* @__PURE__ */ new Map();
@@ -20727,13 +20727,13 @@ function quickWinTemplateSummaries(items) {
 		label: item.label,
 		rowCount: item.rows,
 		urlCount: item.urls.size,
-		sampleUrls: [...item.urls].sort(compareText$8).slice(0, 3)
-	})).sort((left, right) => right.urlCount - left.urlCount || right.rowCount - left.rowCount || compareText$8(left.id, right.id)).slice(0, 5);
+		sampleUrls: [...item.urls].sort(compareText$9).slice(0, 3)
+	})).sort((left, right) => right.urlCount - left.urlCount || right.rowCount - left.rowCount || compareText$9(left.id, right.id)).slice(0, 5);
 }
 //#endregion
 //#region packages/core/src/analyze/site-diagnostics/quick-wins.ts
 const DEFAULT_DAYS$3 = 28;
-const MAX_DAYS$3 = 548;
+const MAX_DAYS$4 = 548;
 const DEFAULT_VERIFY_LIMIT$1 = 5;
 const MAX_VERIFY_LIMIT = 100;
 const MAX_SOURCE_ROWS$3 = 1e5;
@@ -20757,12 +20757,12 @@ function applyVerification$1(item, coverage) {
 	};
 }
 async function quickWinsReport(input, dependencies = defaultDependencies$9) {
-	const explicitRange = explicitDateRange(input, MAX_DAYS$3);
+	const explicitRange = explicitDateRange(input, MAX_DAYS$4);
 	const days = explicitRange?.days ?? integerOption$2({
 		value: input.days,
 		fallback: DEFAULT_DAYS$3,
 		minimum: 1,
-		maximum: MAX_DAYS$3,
+		maximum: MAX_DAYS$4,
 		label: "Days"
 	});
 	const verifyLimit = integerOption$2({
@@ -20912,7 +20912,7 @@ async function quickWinsReport(input, dependencies = defaultDependencies$9) {
 }
 //#endregion
 //#region packages/core/src/analyze/striking-distance-analysis-primitives.ts
-function compareText$7(left, right) {
+function compareText$8(left, right) {
 	const leftPoints = [...left].map((character) => character.codePointAt(0) ?? 0);
 	const rightPoints = [...right].map((character) => character.codePointAt(0) ?? 0);
 	const length = Math.min(leftPoints.length, rightPoints.length);
@@ -20978,7 +20978,7 @@ function strikingDistanceItem(row) {
 	};
 }
 function compareStrikingDistanceItems(left, right) {
-	return right.priority.score - left.priority.score || right.impressions - left.impressions || left.position - right.position || compareText$7(left.query, right.query) || compareText$7(left.url, right.url);
+	return right.priority.score - left.priority.score || right.impressions - left.impressions || left.position - right.position || compareText$8(left.query, right.query) || compareText$8(left.url, right.url);
 }
 function groupStrikingDistanceItems(items) {
 	const grouped = /* @__PURE__ */ new Map();
@@ -21015,7 +21015,7 @@ function groupStrikingDistanceItems(items) {
 				action: shared ? `Review the sampled ${first.template.label.toLowerCase()} URLs for a recurring technical, content, or internal-link pattern before changing the shared template.` : `Review these URLs individually; the current evidence does not support a shared-template change.`
 			}
 		};
-	}).filter((group) => group !== void 0).sort((left, right) => right.totalImpressions - left.totalImpressions || right.uniqueUrls - left.uniqueUrls || compareText$7(left.id, right.id));
+	}).filter((group) => group !== void 0).sort((left, right) => right.totalImpressions - left.totalImpressions || right.uniqueUrls - left.uniqueUrls || compareText$8(left.id, right.id));
 }
 //#endregion
 //#region packages/core/src/analyze/striking-distance-analysis.ts
@@ -21130,7 +21130,7 @@ function analyzeStrikingDistanceRows(input) {
 //#endregion
 //#region packages/core/src/analyze/striking-distance.ts
 const DEFAULT_DAYS$2 = 28;
-const MAX_DAYS$2 = 548;
+const MAX_DAYS$3 = 548;
 const DEFAULT_VERIFY_LIMIT = 5;
 const MAX_SOURCE_ROWS$2 = 1e5;
 const defaultDependencies$8 = {
@@ -21138,13 +21138,13 @@ const defaultDependencies$8 = {
 	verifyContent: verifyQueryContent,
 	now: () => /* @__PURE__ */ new Date()
 };
-function boundedInteger$3(value, fallback, minimum, maximum) {
+function boundedInteger$4(value, fallback, minimum, maximum) {
 	if (value === void 0 || !Number.isFinite(value)) return fallback;
 	return Math.min(maximum, Math.max(minimum, Math.floor(value)));
 }
 function reportDays(value) {
 	if (value === void 0) return DEFAULT_DAYS$2;
-	if (!Number.isInteger(value) || value < 1 || value > MAX_DAYS$2) throw new SeoError("INVALID_INPUT", `Days must be a whole number between 1 and ${MAX_DAYS$2}.`);
+	if (!Number.isInteger(value) || value < 1 || value > MAX_DAYS$3) throw new SeoError("INVALID_INPUT", `Days must be a whole number between 1 and ${MAX_DAYS$3}.`);
 	return value;
 }
 function dateRange(days, now) {
@@ -21202,7 +21202,7 @@ async function strikingDistance(input, dependencies = defaultDependencies$8) {
 		brandTerms: input.brandTerms,
 		includeBrand: input.includeBrand
 	});
-	const verifyLimit = boundedInteger$3(input.verifyLimit, DEFAULT_VERIFY_LIMIT, 0, analysis.limit);
+	const verifyLimit = boundedInteger$4(input.verifyLimit, DEFAULT_VERIFY_LIMIT, 0, analysis.limit);
 	const verificationRequested = input.verifyContent === true || input.verifyContent !== false && input.verifyLimit !== void 0;
 	const attempted = verificationRequested ? Math.min(verifyLimit, analysis.items.length) : 0;
 	const items = await Promise.all(analysis.items.map(async (item, index) => {
@@ -25579,7 +25579,7 @@ function resolveProvider(input) {
 //#endregion
 //#region packages/core/src/analyze/domain-research/shared.ts
 const MAX_GSC_DOMAIN_ROWS = 1e5;
-function compareText$6(left, right) {
+function compareText$7(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function normalizedKeyword$1(value) {
@@ -25696,8 +25696,8 @@ function aggregateGscQueries(rows) {
 		clicks: item.clicks,
 		impressions: item.impressions,
 		averagePosition: item.positionWeight ? item.weightedPosition / item.positionWeight : null,
-		urls: [...item.urls].sort(compareText$6).slice(0, 5)
-	})).sort((left, right) => right.impressions - left.impressions || compareText$6(left.query, right.query));
+		urls: [...item.urls].sort(compareText$7).slice(0, 5)
+	})).sort((left, right) => right.impressions - left.impressions || compareText$7(left.query, right.query));
 }
 async function acquireGscQueries(input) {
 	const range = finalGscDateRange(input.days, input.now);
@@ -26063,7 +26063,7 @@ function pseoQueryPatterns(rows) {
 //#region packages/core/src/analyze/pseo/templates.ts
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
-function compareText$5(left, right) {
+function compareText$6(left, right) {
 	const leftPoints = [...left].map((value) => value.codePointAt(0) ?? 0);
 	const rightPoints = [...right].map((value) => value.codePointAt(0) ?? 0);
 	for (let index = 0; index < Math.min(leftPoints.length, rightPoints.length); index++) {
@@ -26119,7 +26119,7 @@ function valueTokens(values) {
 		const tokens = value.normalize("NFKC").toLowerCase().match(/[\p{L}\p{N}]+/gu) ?? [];
 		for (const token of tokens.filter((item) => item.length > 1 || /[^\p{ASCII}]/u.test(item))) counts.set(token, (counts.get(token) ?? 0) + 1);
 	}
-	return [...counts.entries()].sort((a, b) => b[1] - a[1] || compareText$5(a[0], b[0])).slice(0, 8).map(([token]) => token);
+	return [...counts.entries()].sort((a, b) => b[1] - a[1] || compareText$6(a[0], b[0])).slice(0, 8).map(([token]) => token);
 }
 function templateShape(signature, urls) {
 	const signatureParts = signature.split("/").filter(Boolean);
@@ -26168,7 +26168,7 @@ function collectClusters(urls, signatures) {
 	return bySignature;
 }
 function clusterPseoTemplates(urls, opts = {}) {
-	const uniqueUrls = [...new Set(urls)].sort(compareText$5);
+	const uniqueUrls = [...new Set(urls)].sort(compareText$6);
 	const minUrls = opts.minUrls ?? 3;
 	const minShare = opts.minShare ?? .01;
 	const sampleSize = opts.sampleSize ?? 5;
@@ -26186,15 +26186,15 @@ function clusterPseoTemplates(urls, opts = {}) {
 		shape: templateShape(signature, clusterUrls),
 		urlCount: clusterUrls.length,
 		share: uniqueUrls.length ? clusterUrls.length / uniqueUrls.length : 0,
-		sampleUrls: clusterUrls.sort(compareText$5).slice(0, sampleSize)
-	})).filter((cluster) => cluster.shape.variableSegments.length > 0 && cluster.urlCount >= minUrls && cluster.share >= minShare).sort((a, b) => b.urlCount - a.urlCount || compareText$5(a.signature, b.signature)).slice(0, opts.limit ?? 50);
+		sampleUrls: clusterUrls.sort(compareText$6).slice(0, sampleSize)
+	})).filter((cluster) => cluster.shape.variableSegments.length > 0 && cluster.urlCount >= minUrls && cluster.share >= minShare).sort((a, b) => b.urlCount - a.urlCount || compareText$6(a.signature, b.signature)).slice(0, opts.limit ?? 50);
 }
 //#endregion
 //#region packages/core/src/analyze/domain-research/gap-analysis.ts
 const MAX_RELEVANCE_QUERY_REFS = 3;
 const MAX_FIRST_PARTY_PATTERN_URLS = 1e4;
 function terms(value) {
-	return [...new Set(pseoQueryTerms(value).map(canonicalPseoTerm).filter(Boolean))].sort(compareText$6);
+	return [...new Set(pseoQueryTerms(value).map(canonicalPseoTerm).filter(Boolean))].sort(compareText$7);
 }
 function observedVolume$1(row) {
 	return value(row.monthlySearchVolume) ?? -1;
@@ -26238,7 +26238,7 @@ function relevanceForKeyword(keyword, acquisition, tokenIndex) {
 		query: row.query,
 		overlap: terms(row.query).filter((token) => keywordTerms.includes(token)).length,
 		impressions: row.impressions
-	})).filter((row) => row.overlap > 0).sort((left, right) => right.overlap - left.overlap || right.impressions - left.impressions || compareText$6(left.query, right.query)).slice(0, MAX_RELEVANCE_QUERY_REFS).map((row) => row.query);
+	})).filter((row) => row.overlap > 0).sort((left, right) => right.overlap - left.overlap || right.impressions - left.impressions || compareText$7(left.query, right.query)).slice(0, MAX_RELEVANCE_QUERY_REFS).map((row) => row.query);
 	return {
 		state: sharedTokens.length >= 2 ? "observed-overlap" : sharedTokens.length === 1 ? "weak-overlap" : "unavailable",
 		sharedTokens,
@@ -26260,10 +26260,10 @@ function repeatedCompetitorPatterns(rows) {
 		urlCount: pattern.urlCount,
 		sampleUrls: pattern.sampleUrls,
 		evidenceRefs: items.flatMap((item) => pattern.sampleUrls.includes(item.row.url) ? [item.evidenceRef] : [])
-	}))).sort((left, right) => right.urlCount - left.urlCount || compareText$6(left.domain, right.domain) || compareText$6(left.signature, right.signature));
+	}))).sort((left, right) => right.urlCount - left.urlCount || compareText$7(left.domain, right.domain) || compareText$7(left.signature, right.signature));
 }
 function ownPatterns(acquisition) {
-	return clusterPseoTemplates([...new Set(acquisition.sourceRows.rows.flatMap((row) => row.urls))].sort(compareText$6).slice(0, MAX_FIRST_PARTY_PATTERN_URLS), {
+	return clusterPseoTemplates([...new Set(acquisition.sourceRows.rows.flatMap((row) => row.urls))].sort(compareText$7).slice(0, MAX_FIRST_PARTY_PATTERN_URLS), {
 		minUrls: 3,
 		minShare: 0,
 		limit: 50,
@@ -26304,10 +26304,10 @@ function analyzeCompetitorGap(acquisition) {
 		const byDomain = /* @__PURE__ */ new Map();
 		for (const item of rows) {
 			const current = byDomain.get(item.domain);
-			if (!current || item.row.rankGroup < current.row.rankGroup || item.row.rankGroup === current.row.rankGroup && compareText$6(item.row.url, current.row.url) < 0) byDomain.set(item.domain, item);
+			if (!current || item.row.rankGroup < current.row.rankGroup || item.row.rankGroup === current.row.rankGroup && compareText$7(item.row.url, current.row.url) < 0) byDomain.set(item.domain, item);
 		}
-		const retainedRows = [...byDomain.values()].sort((left, right) => left.row.rankGroup - right.row.rankGroup || compareText$6(left.domain, right.domain));
-		const best = [...retainedRows].sort((left, right) => observedVolume$1(right.row) - observedVolume$1(left.row) || left.row.rankGroup - right.row.rankGroup || compareText$6(left.domain, right.domain))[0];
+		const retainedRows = [...byDomain.values()].sort((left, right) => left.row.rankGroup - right.row.rankGroup || compareText$7(left.domain, right.domain));
+		const best = [...retainedRows].sort((left, right) => observedVolume$1(right.row) - observedVolume$1(left.row) || left.row.rankGroup - right.row.rankGroup || compareText$7(left.domain, right.domain))[0];
 		const firstParty = firstPartyByQuery.get(keyword);
 		const relevance = relevanceForKeyword(keyword, acquisition, tokenIndex.index);
 		const ownRank = ownRanks.get(keyword) ?? null;
@@ -26351,7 +26351,7 @@ function analyzeCompetitorGap(acquisition) {
 			},
 			evidenceRefs: retainedRows.map((item) => item.evidenceRef)
 		};
-	}).sort((left, right) => classificationOrder(left.classification) - classificationOrder(right.classification) || right.competitorCount - left.competitorCount || (value(right.monthlySearchVolume) ?? -1) - (value(left.monthlySearchVolume) ?? -1) || Math.min(...left.competitors.map((item) => item.rank)) - Math.min(...right.competitors.map((item) => item.rank)) || compareText$6(left.keyword, right.keyword));
+	}).sort((left, right) => classificationOrder(left.classification) - classificationOrder(right.classification) || right.competitorCount - left.competitorCount || (value(right.monthlySearchVolume) ?? -1) - (value(left.monthlySearchVolume) ?? -1) || Math.min(...left.competitors.map((item) => item.rank)) - Math.min(...right.competitors.map((item) => item.rank)) || compareText$7(left.keyword, right.keyword));
 	return {
 		rawRows,
 		candidates,
@@ -26823,7 +26823,7 @@ async function rankingPagesReport(input, dependencies = {}) {
 			impressions: row.impressions,
 			averagePosition: row.position
 		}] : [];
-	}).sort((left, right) => right.impressions - left.impressions || compareText$6(left.url, right.url));
+	}).sort((left, right) => right.impressions - left.impressions || compareText$7(left.url, right.url));
 	const firstPartyStatus = !input.site ? "not-requested" : (firstPartyResponse?.rowsFetched ?? 0) >= MAX_GSC_PAGE_ROWS ? "partial" : firstPartyResponse?.rows.length === 0 ? "empty" : "complete";
 	const findings = patterns.slice(0, 5).map((pattern, index) => ({
 		code: "repeated-ranking-page-pattern",
@@ -26904,7 +26904,7 @@ async function serpCompetitorsReport(input, dependencies = {}) {
 	const now = (dependencies.now ?? (() => /* @__PURE__ */ new Date()))();
 	const market = validatedMarket(input.market);
 	const providerId = validatedProvider(input.provider);
-	const keywords = [...new Set(input.keywords.map(normalizedKeyword$1))].filter(Boolean).sort(compareText$6);
+	const keywords = [...new Set(input.keywords.map(normalizedKeyword$1))].filter(Boolean).sort(compareText$7);
 	if (keywords.length < 2 || keywords.length > 200 || keywords.some((keyword) => keyword.length > 80 || keyword.split(/\s+/u).length > 10)) throw new SeoError("INVALID_INPUT", "SERP competitor research requires 2 to 200 keywords of at most 80 characters and 10 words.");
 	const target = input.targetDomain ? normalizeDomain$1(input.targetDomain) : null;
 	const declared = declaredCompetitors(input.declaredCompetitors);
@@ -28685,7 +28685,7 @@ function providerReportError(error) {
 	if (error.code === "rate-limit") throw new SeoError("RATE_LIMITED", error.message);
 	throw new SeoError("PROVIDER_UNAVAILABLE", error.message);
 }
-function validateInput$3(input) {
+function validateInput$4(input) {
 	if (input.keywords.length < 1 || input.keywords.length > MAX_REPORT_KEYWORDS || input.keywords.some((keyword) => {
 		const value = keyword.trim();
 		return value.length < 1 || value.length > 80 || value.split(/\s+/u).length > 10;
@@ -28719,7 +28719,7 @@ function findings$1(analysis) {
 	}).sort((left, right) => Number(right.code === "recent-demand-increase") - Number(left.code === "recent-demand-increase") || right.recentAverage - left.recentAverage || compareCodepoints$2(left.keyword, right.keyword)).slice(0, 10).map(({ recentAverage: _recentAverage, ...finding }) => finding);
 }
 async function keywordMetricsReport(input, dependencies = {}) {
-	const validated = validateInput$3(input);
+	const validated = validateInput$4(input);
 	let candidates;
 	try {
 		candidates = dependencies.candidates ?? await defaultCandidates$3();
@@ -29017,16 +29017,16 @@ function benchmarkDetails(benchmark) {
 		positiveUrlSamples: benchmark.positiveUrlSamples
 	};
 }
-function boundedInteger$2(input) {
+function boundedInteger$3(input) {
 	const value = Number.isFinite(input.value) ? input.value ?? 0 : input.fallback;
 	return Math.min(input.maximum ?? Number.POSITIVE_INFINITY, Math.max(1, Math.floor(value)));
 }
 function analyzeQueryClustersFromRows(input) {
-	const minImpressions = boundedInteger$2({
+	const minImpressions = boundedInteger$3({
 		value: input.minImpressions,
 		fallback: 25
 	});
-	const limit = boundedInteger$2({
+	const limit = boundedInteger$3({
 		value: input.limit,
 		fallback: 25,
 		maximum: 100
@@ -29145,7 +29145,7 @@ function integerInRange(value, fallback, minimum, maximum) {
 	if (value === void 0 || !Number.isFinite(value)) return fallback;
 	return Math.min(maximum, Math.max(minimum, Math.floor(value)));
 }
-function compareText$4(left, right) {
+function compareText$5(left, right) {
 	const leftPoints = [...left].map((character) => character.codePointAt(0) ?? 0);
 	const rightPoints = [...right].map((character) => character.codePointAt(0) ?? 0);
 	for (let index = 0; index < Math.min(leftPoints.length, rightPoints.length); index++) {
@@ -29164,7 +29164,7 @@ function normalizedHttpUrl(value) {
 		return;
 	}
 }
-function validRow(row, query, url) {
+function validRow$1(row, query, url) {
 	return Boolean(query && url) && Number.isFinite(row.clicks) && Number.isFinite(row.impressions) && Number.isFinite(row.ctr) && Number.isFinite(row.position) && row.clicks >= 0 && row.impressions > 0 && row.clicks <= row.impressions && row.ctr >= 0 && row.ctr <= 1 && row.position > 0;
 }
 function queryFromRow(row) {
@@ -29177,7 +29177,7 @@ function queryFromRow(row) {
 	};
 }
 function compareQueries(left, right) {
-	return right.impressions - left.impressions || left.position - right.position || right.clicks - left.clicks || compareText$4(left.query, right.query);
+	return right.impressions - left.impressions || left.position - right.position || right.clicks - left.clicks || compareText$5(left.query, right.query);
 }
 function recommendation(input) {
 	return {
@@ -29223,7 +29223,7 @@ function pageItem(url, rows) {
 	};
 }
 function compareItems$1(left, right) {
-	return right.priority.score - left.priority.score || right.impressions - left.impressions || left.position - right.position || compareText$4(left.url, right.url);
+	return right.priority.score - left.priority.score || right.impressions - left.impressions || left.position - right.position || compareText$5(left.url, right.url);
 }
 function analyzeSecondPageRows(input) {
 	const minImpressions = integerInRange(input.minImpressions, DEFAULT_MIN_IMPRESSIONS, 0, MAX_MIN_IMPRESSIONS);
@@ -29244,7 +29244,7 @@ function analyzeSecondPageRows(input) {
 	for (const row of input.rows) {
 		const query = row.keys[0]?.trim() ?? "";
 		const url = normalizedHttpUrl(row.keys[1]?.trim() ?? "");
-		if (!validRow(row, query, url)) selection.invalidRows++;
+		if (!validRow$1(row, query, url)) selection.invalidRows++;
 		else if (row.position <= 10 || row.position > 20) selection.outsidePositionRows++;
 		else if (shouldExcludeBrandQuery({
 			query,
@@ -29336,7 +29336,7 @@ function analyzeSecondPageRows(input) {
 //#endregion
 //#region packages/core/src/analyze/keyword-opportunities.ts
 const DEFAULT_DAYS$1 = 28;
-const MAX_DAYS$1 = 548;
+const MAX_DAYS$2 = 548;
 const DEFAULT_REPORT_LIMIT = 10;
 const MAX_REPORT_LIMIT = 25;
 const DEFAULT_KEYWORD_LIMIT = 30;
@@ -29353,7 +29353,7 @@ const SOURCE_ORDER = [
 	"second-page",
 	"striking-distance"
 ];
-function compareText$3(left, right) {
+function compareText$4(left, right) {
 	return left < right ? -1 : left > right ? 1 : 0;
 }
 function rounded(value, precision = 3) {
@@ -29365,7 +29365,7 @@ function integerOption$1(input) {
 	if (!Number.isInteger(input.value) || input.value < input.minimum || input.value > input.maximum) throw new SeoError("INVALID_INPUT", `${input.label} must be a whole number between ${input.minimum} and ${input.maximum}.`);
 	return input.value;
 }
-function validateInput$2(input) {
+function validateInput$3(input) {
 	const site = input.site.trim();
 	if (!site || site.length > 2048) throw new SeoError("INVALID_INPUT", "Use a valid Search Console property.");
 	if (input.minImpressions !== void 0 && (!Number.isInteger(input.minImpressions) || input.minImpressions < 0 || input.minImpressions > 1e9)) throw new SeoError("INVALID_INPUT", "Minimum impressions must be a whole number between 0 and 1000000000.");
@@ -29385,7 +29385,7 @@ function validateInput$2(input) {
 			value: input.days,
 			fallback: DEFAULT_DAYS$1,
 			minimum: 1,
-			maximum: MAX_DAYS$1,
+			maximum: MAX_DAYS$2,
 			label: "Days"
 		}),
 		limit: integerOption$1({
@@ -29497,7 +29497,7 @@ function aggregateCandidates(rows) {
 			impressions: rounded(row.impressions),
 			ctr: rounded(row.ctr, 4),
 			averagePosition: rounded(row.position, 2)
-		})).sort((left, right) => right.impressions - left.impressions || left.averagePosition - right.averagePosition || compareText$3(left.url, right.url));
+		})).sort((left, right) => right.impressions - left.impressions || left.averagePosition - right.averagePosition || compareText$4(left.url, right.url));
 		return [keyword, {
 			keyword,
 			clicks: rounded(clicks),
@@ -29731,7 +29731,7 @@ function nextSteps(input) {
 	return steps;
 }
 async function keywordOpportunitiesReport(input, dependencies = {}) {
-	const validated = validateInput$2(input);
+	const validated = validateInput$3(input);
 	const now = (dependencies.now ?? (() => /* @__PURE__ */ new Date()))();
 	const generatedAt = now.toISOString();
 	const range = finalGscDateRange(validated.days, now);
@@ -30099,7 +30099,7 @@ function providerError$3(error) {
 	if (error.code === "configuration") throw new SeoError("INVALID_INPUT", error.message);
 	throw new SeoError("PROVIDER_UNAVAILABLE", error.message);
 }
-function validateInput$1(input) {
+function validateInput$2(input) {
 	if (input.seeds.length < 1 || input.seeds.length > MAX_RESEARCH_SEEDS || input.seeds.some((seed) => {
 		const value = seed.trim();
 		return value.length < 1 || value.length > 80 || value.split(/\s+/u).length > 10;
@@ -30152,7 +30152,7 @@ async function keywordResearchReport(input, dependencies = {}) {
 		"suggestions"
 	];
 	const limit = input.limit ?? 50;
-	const validated = validateInput$1({
+	const validated = validateInput$2({
 		...input,
 		sources,
 		limit
@@ -30235,6 +30235,864 @@ async function keywordResearchReport(input, dependencies = {}) {
 	};
 }
 //#endregion
+//#region packages/core/src/analyze/local-search/intent.ts
+const NEARBY_PHRASES = [
+	"closest to me",
+	"in my area",
+	"near me",
+	"nearby"
+];
+const UK_POSTCODE = /\b[A-Z]{1,2}\d[A-Z\d]?\s*\d[A-Z]{2}\b/iu;
+const US_ZIP_CODE = /\b\d{5}(?:-\d{4})?\b/u;
+const US_ZIP_CONTEXT = /\b(?:around|near|nearby|postal(?:\s+code)?|zip(?:\s+code)?)\b/iu;
+function normalizeLocalSearchText(value) {
+	return value.normalize("NFKC").trim().replace(/\s+/gu, " ").toLowerCase();
+}
+function tokens(value) {
+	return normalizeLocalSearchText(value).match(/[\p{L}\p{N}]+/gu) ?? [];
+}
+function includesTokenSequence(source, candidate) {
+	if (candidate.length === 0 || candidate.length > source.length) return false;
+	return source.some((_, start) => candidate.every((token, offset) => source[start + offset] === token));
+}
+function termMatcher(terms) {
+	const root = {
+		children: /* @__PURE__ */ new Map(),
+		terms: []
+	};
+	for (const term of terms) {
+		let node = root;
+		for (const token of tokens(term)) {
+			const child = node.children.get(token) ?? {
+				children: /* @__PURE__ */ new Map(),
+				terms: []
+			};
+			node.children.set(token, child);
+			node = child;
+		}
+		node.terms.push(term);
+	}
+	return (source) => {
+		const matches = /* @__PURE__ */ new Set();
+		for (let start = 0; start < source.length; start++) {
+			let node = root;
+			for (let index = start; index < source.length; index++) {
+				node = node.children.get(source[index]);
+				if (!node) break;
+				for (const term of node.terms) matches.add(term);
+			}
+		}
+		return [...matches].sort((left, right) => left < right ? -1 : left > right ? 1 : 0);
+	};
+}
+function normalizeLocationTerms(values = []) {
+	return [...new Set(values.map(normalizeLocalSearchText).filter(Boolean))].sort((left, right) => left < right ? -1 : left > right ? 1 : 0);
+}
+function classifyLocalIntent(query, locationTerms) {
+	return createLocalIntentClassifier(locationTerms)(query);
+}
+function createLocalIntentClassifier(locationTerms) {
+	const matchLocations = termMatcher(locationTerms);
+	return (query) => {
+		const queryTokens = tokens(normalizeLocalSearchText(query));
+		const matchedLocations = matchLocations(queryTokens);
+		const matchedNearby = NEARBY_PHRASES.filter((phrase) => includesTokenSequence(queryTokens, tokens(phrase)));
+		const ukPostcode = UK_POSTCODE.exec(query)?.[0] ?? null;
+		const usZipCode = US_ZIP_CONTEXT.test(query) && US_ZIP_CODE.test(query) ? US_ZIP_CODE.exec(query)?.[0] ?? null : null;
+		const postalCode = ukPostcode ?? usZipCode;
+		const classes = [];
+		if (matchedLocations.length > 0) classes.push("named-location");
+		if (matchedNearby.length > 0) classes.push("nearby");
+		if (postalCode) classes.push("postal-code");
+		if (classes.length === 0) return null;
+		return {
+			heuristic: true,
+			method: "explicit-local-intent-v1",
+			classes,
+			matchedTerms: [
+				...matchedLocations,
+				...matchedNearby,
+				...postalCode ? [normalizeLocalSearchText(postalCode)] : []
+			]
+		};
+	};
+}
+//#endregion
+//#region packages/core/src/analyze/local-search/analysis.ts
+function compareText$3(left, right) {
+	return left < right ? -1 : left > right ? 1 : 0;
+}
+function validRow(row) {
+	const query = row.keys[0]?.trim() ?? "";
+	const page = row.keys[1]?.trim() ?? "";
+	let validPage = false;
+	try {
+		validPage = ["http:", "https:"].includes(new URL(page).protocol);
+	} catch {
+		validPage = false;
+	}
+	if (row.keys.length !== 2 || !query || !validPage || !Number.isFinite(row.clicks) || !Number.isFinite(row.impressions) || !Number.isFinite(row.ctr) || !Number.isFinite(row.position) || row.clicks < 0 || row.impressions <= 0 || row.clicks > row.impressions || row.ctr < 0 || row.ctr > 1 || row.position <= 0) return null;
+	return {
+		query,
+		page,
+		clicks: row.clicks,
+		impressions: row.impressions,
+		ctr: row.ctr,
+		position: row.position
+	};
+}
+function rowSignature(row) {
+	return `${row.clicks}\u0000${row.impressions}\u0000${row.ctr}\u0000${row.position}`;
+}
+function normalizeRows(rows, selection) {
+	const grouped = /* @__PURE__ */ new Map();
+	for (const source of rows) {
+		const row = validRow(source);
+		if (!row) {
+			selection.invalidRows++;
+			continue;
+		}
+		const key = `${row.query}\u0000${row.page}`;
+		grouped.set(key, [...grouped.get(key) ?? [], row]);
+	}
+	const result = [];
+	for (const group of grouped.values()) {
+		if (new Set(group.map(rowSignature)).size > 1) {
+			selection.conflictingRows += group.length;
+			continue;
+		}
+		selection.exactDuplicateRows += group.length - 1;
+		const row = group[0];
+		if (row) result.push(row);
+	}
+	return result;
+}
+function opportunityAction(position, pageCount) {
+	if (pageCount > 1) return "review-page-overlap";
+	if (position <= 3) return "protect-visibility";
+	if (position <= 20) return "improve-existing-page";
+	return "investigate-relevance";
+}
+function aggregateQueries(input) {
+	const grouped = /* @__PURE__ */ new Map();
+	for (const row of input.rows) {
+		if (isLowActionabilityQuery(row.query)) {
+			input.selection.lowActionabilityRows++;
+			continue;
+		}
+		if (shouldExcludeBrandQuery({
+			query: row.query,
+			siteUrl: input.site,
+			brandTerms: input.brandTerms,
+			includeBrand: input.includeBrand
+		})) {
+			input.selection.brandRows++;
+			continue;
+		}
+		grouped.set(row.query, [...grouped.get(row.query) ?? [], row]);
+	}
+	const opportunities = [];
+	for (const [query, rows] of grouped) {
+		const intent = input.classify(query);
+		if (!intent) {
+			input.selection.nonLocalRows += rows.length;
+			continue;
+		}
+		const impressions = rows.reduce((sum, row) => sum + row.impressions, 0);
+		if (impressions < input.minImpressions) {
+			input.selection.belowMinimumRows += rows.length;
+			continue;
+		}
+		const clicks = rows.reduce((sum, row) => sum + row.clicks, 0);
+		const averagePosition = rows.reduce((sum, row) => sum + row.position * row.impressions, 0) / impressions;
+		const pages = rows.map((row) => ({
+			url: row.page,
+			clicks: row.clicks,
+			impressions: row.impressions,
+			ctr: row.impressions ? row.clicks / row.impressions : 0,
+			averagePosition: row.position
+		})).sort((left, right) => right.impressions - left.impressions || right.clicks - left.clicks || left.averagePosition - right.averagePosition || compareText$3(left.url, right.url));
+		opportunities.push({
+			query,
+			clicks,
+			impressions,
+			ctr: impressions ? clicks / impressions : 0,
+			averagePosition,
+			intent,
+			action: opportunityAction(averagePosition, pages.length),
+			pages,
+			pageCoverage: {
+				available: pages.length,
+				returned: Math.min(3, pages.length),
+				omitted: Math.max(0, pages.length - 3)
+			}
+		});
+	}
+	return opportunities.sort((left, right) => right.impressions - left.impressions || right.clicks - left.clicks || left.averagePosition - right.averagePosition || compareText$3(left.query, right.query));
+}
+function localTemplates(opportunities) {
+	const clusters = clusterPseoTemplates(opportunities.flatMap((item) => item.pages.map((page) => page.url)), {
+		minUrls: 2,
+		minShare: 0,
+		limit: 10,
+		sampleSize: 5
+	});
+	return clusters.map((cluster) => {
+		const matched = opportunities.flatMap((item) => item.pages.filter((page) => templateForUrl(page.url, clusters) === cluster.signature).map((page) => ({
+			query: item.query,
+			page
+		})));
+		return {
+			heuristic: true,
+			signature: cluster.signature,
+			urlCount: cluster.urlCount,
+			sampleUrls: cluster.sampleUrls,
+			queryCount: new Set(matched.map((item) => item.query)).size,
+			clicks: matched.reduce((sum, item) => sum + item.page.clicks, 0),
+			impressions: matched.reduce((sum, item) => sum + item.page.impressions, 0)
+		};
+	});
+}
+function analyzeLocalSearchRows(input) {
+	const selection = {
+		sourceRows: input.rows.length,
+		invalidRows: 0,
+		exactDuplicateRows: 0,
+		conflictingRows: 0,
+		lowActionabilityRows: 0,
+		brandRows: 0,
+		nonLocalRows: 0,
+		belowMinimumRows: 0,
+		eligibleQueries: 0,
+		returnedQueries: 0,
+		omittedQueries: 0,
+		limit: input.limit,
+		minImpressions: input.minImpressions
+	};
+	const normalized = normalizeRows(input.rows, selection);
+	const eligible = aggregateQueries({
+		...input,
+		rows: normalized,
+		selection,
+		classify: createLocalIntentClassifier(input.locationTerms)
+	});
+	selection.eligibleQueries = eligible.length;
+	selection.returnedQueries = Math.min(input.limit, eligible.length);
+	selection.omittedQueries = Math.max(0, eligible.length - input.limit);
+	return {
+		selection,
+		eligibleSummary: {
+			clicks: eligible.reduce((sum, item) => sum + item.clicks, 0),
+			impressions: eligible.reduce((sum, item) => sum + item.impressions, 0),
+			namedLocationQueries: eligible.filter((item) => item.intent.classes.includes("named-location")).length,
+			nearbyQueries: eligible.filter((item) => item.intent.classes.includes("nearby")).length,
+			postalCodeQueries: eligible.filter((item) => item.intent.classes.includes("postal-code")).length,
+			pageOverlapQueries: eligible.filter((item) => item.action === "review-page-overlap").length
+		},
+		eligiblePageCount: new Set(eligible.flatMap((item) => item.pages.map((page) => page.url))).size,
+		opportunities: eligible.slice(0, input.limit).map((item) => ({
+			...item,
+			pages: item.pages.slice(0, 3)
+		})),
+		templates: localTemplates(eligible)
+	};
+}
+//#endregion
+//#region packages/core/src/providers/dataforseo/serp-snapshot.ts
+const MAX_SERP_DEPTH = 100;
+const SERP_ENDPOINT = "v3/serp/google/organic/live/advanced";
+function safeUrl$1(value) {
+	if (!value) return null;
+	try {
+		const parsed = new URL(value);
+		if (!["http:", "https:"].includes(parsed.protocol)) return null;
+		parsed.username = "";
+		parsed.password = "";
+		return parsed.toString();
+	} catch {
+		return null;
+	}
+}
+function validOrganic(item) {
+	return item.type === "organic" && Number.isSafeInteger(item.rank_group) && (item.rank_group ?? 0) > 0 && Number.isSafeInteger(item.rank_absolute) && (item.rank_absolute ?? 0) > 0 && Number.isSafeInteger(item.page) && (item.page ?? 0) > 0 && Boolean(item.domain?.trim()) && safeUrl$1(item.url) !== null;
+}
+function organicResult(item) {
+	if (!validOrganic(item)) return null;
+	const url = safeUrl$1(item.url);
+	if (!url) return null;
+	return {
+		rankGroup: item.rank_group,
+		rankAbsolute: item.rank_absolute,
+		page: item.page,
+		domain: item.domain.trim().toLowerCase(),
+		url,
+		title: item.title ?? null,
+		description: item.description ?? null,
+		isFeaturedSnippet: item.is_featured_snippet ?? null
+	};
+}
+function checkedAt(value, fallback) {
+	const timestamp = Date.parse(value);
+	return Number.isFinite(timestamp) ? new Date(timestamp).toISOString() : fallback;
+}
+function mapDataForSeoSerpSnapshot(input, snapshot, endpoint = SERP_ENDPOINT) {
+	const market = searchMarketSchema.parse(input.market);
+	const keyword = normalizedKeyword$2(input.keyword);
+	const location = locationRequest(market, "serp-snapshot");
+	const result = snapshot.response.tasks.flatMap((task) => task.result ?? []).find((item) => normalizedKeyword$2(item.keyword) === keyword);
+	if (!result) throw new ProviderError({
+		provider: "dataforseo",
+		operation: "serp-snapshot",
+		code: "invalid-response",
+		message: "DataForSEO returned no matching SERP result."
+	});
+	const warnings = [...snapshot.warnings];
+	const items = result.items ?? [];
+	const organicItems = items.filter((item) => item.type === "organic");
+	const mappedOrganicResults = organicItems.flatMap((item) => {
+		const mapped = organicResult(item);
+		return mapped ? [mapped] : [];
+	}).sort((left, right) => left.rankAbsolute - right.rankAbsolute || left.rankGroup - right.rankGroup || compareCodepoints$3(left.url, right.url));
+	const organicResults = mappedOrganicResults.slice(0, input.depth);
+	const invalidRows = organicItems.length - mappedOrganicResults.length;
+	const resultCapped = mappedOrganicResults.length > input.depth;
+	const invalidResultCount = result.se_results_count !== null && result.se_results_count !== void 0 && result.se_results_count < organicResults.length;
+	if (invalidRows > 0) warnings.push({
+		code: "invalid-organic-results",
+		field: "organicResults",
+		message: `DataForSEO returned ${invalidRows} organic result${invalidRows === 1 ? "" : "s"} without a valid rank, domain, or URL.`
+	});
+	if (!Number.isFinite(Date.parse(result.datetime))) warnings.push({
+		code: "invalid-serp-observation-time",
+		field: "checkedAt",
+		message: "DataForSEO returned an invalid SERP observation time; the local response time was retained."
+	});
+	const checkUrl = safeUrl$1(result.check_url);
+	if (result.check_url && !checkUrl) warnings.push({
+		code: "invalid-serp-check-url",
+		field: "checkUrl",
+		message: "DataForSEO returned an invalid SERP check URL."
+	});
+	if (invalidResultCount) warnings.push({
+		code: "invalid-serp-result-count",
+		field: "resultCount",
+		message: "DataForSEO returned an estimated result count below the retained organic result count; the estimate was discarded."
+	});
+	const features = [.../* @__PURE__ */ new Set([...result.item_types ?? [], ...items.map((item) => item.type)])].sort(compareCodepoints$3);
+	return {
+		schemaVersion: 1,
+		provider: "dataforseo",
+		capability: "serp-snapshot",
+		data: {
+			keyword,
+			effectiveKeyword: normalizedKeyword$2(result.spell?.keyword ?? result.keyword),
+			searchEngineDomain: result.se_domain?.trim().toLowerCase() ?? null,
+			checkedAt: checkedAt(result.datetime, snapshot.observedAt),
+			checkUrl,
+			resultCount: invalidResultCount ? null : result.se_results_count ?? null,
+			pagesCount: result.pages_count === void 0 ? null : result.pages_count,
+			features,
+			organicResults
+		},
+		observedAt: snapshot.observedAt,
+		market: {
+			...market,
+			device: market.device ?? "desktop"
+		},
+		coverage: {
+			requestedRows: input.depth,
+			returnedRows: snapshot.returnedRows,
+			retainedRows: organicResults.length,
+			invalidRows,
+			providerTotalRows: invalidResultCount ? null : result.se_results_count ?? null,
+			completeness: invalidRows > 0 || invalidResultCount ? "partial" : resultCapped ? "capped" : "complete",
+			nextCursor: null
+		},
+		cache: snapshot.cache,
+		cost: snapshot.cost,
+		request: {
+			operation: "serp-snapshot",
+			endpoint,
+			limit: input.depth,
+			filters: {
+				countryCode: market.countryCode,
+				languageCode: market.languageCode,
+				device: market.device ?? "desktop",
+				...location.locationCode !== void 0 ? { locationCode: location.locationCode } : { locationName: location.locationName }
+			},
+			sort: ["rankAbsolute:ascending", "url:codepoint-ascending"]
+		},
+		warnings
+	};
+}
+var DataForSeoSerpSnapshotProvider = class {
+	provider = "dataforseo";
+	capabilitySupport = [{
+		capability: "serp-snapshot",
+		status: "available",
+		markets: [{
+			searchEngines: ["google"],
+			devices: ["desktop", "mobile"],
+			location: "any"
+		}]
+	}];
+	client;
+	constructor(options = {}) {
+		this.client = options.client ?? new DataForSeoClient(options);
+	}
+	async serpSnapshot(input) {
+		const market = searchMarketSchema.parse(input.market);
+		if (market.searchEngine !== "google") throw new ProviderError({
+			provider: "dataforseo",
+			operation: "serp-snapshot",
+			code: "configuration",
+			message: "DataForSEO SERP snapshots currently support Google."
+		});
+		if (!Number.isSafeInteger(input.depth) || input.depth < 1 || input.depth > MAX_SERP_DEPTH) throw new ProviderError({
+			provider: "dataforseo",
+			operation: "serp-snapshot",
+			code: "configuration",
+			message: "SERP depth must be from 1 to 100."
+		});
+		const keyword = normalizedKeyword$2(input.keyword);
+		if (!keyword || keyword.length > 80 || keyword.split(/\s+/u).length > 10) throw new ProviderError({
+			provider: "dataforseo",
+			operation: "serp-snapshot",
+			code: "configuration",
+			message: "SERP snapshots require a keyword of at most 80 characters and 10 words."
+		});
+		const context = input.context ?? {
+			reportId: "serp-results",
+			reportRunId: randomUUID()
+		};
+		const location = locationRequest(market, "serp-snapshot");
+		return mapDataForSeoSerpSnapshot(input, await this.client.serpLive({
+			keyword,
+			languageCode: market.languageCode.split("-")[0],
+			...location,
+			device: market.device ?? "desktop",
+			depth: input.depth,
+			refresh: input.refresh,
+			context
+		}));
+	}
+};
+//#endregion
+//#region packages/core/src/analyze/serp-results.ts
+const MAX_REPORT_DEPTH = 100;
+function compareCodepoints(left, right) {
+	return left < right ? -1 : left > right ? 1 : 0;
+}
+function snapshotProvider(candidate) {
+	return "serpSnapshot" in candidate && typeof candidate.serpSnapshot === "function" ? candidate : null;
+}
+async function defaultCandidates$1() {
+	return [{
+		adapter: new DataForSeoSerpSnapshotProvider(),
+		connected: Boolean(await readDataForSeoCredentials()),
+		priority: 10
+	}];
+}
+function providerError$2(error) {
+	if (!(error instanceof ProviderError)) throw error;
+	if (error.code === "rate-limit") throw new SeoError("RATE_LIMITED", error.message);
+	if (error.code === "configuration") throw new SeoError("INVALID_INPUT", error.message);
+	throw new SeoError("PROVIDER_UNAVAILABLE", error.message);
+}
+function validateInput$1(input) {
+	const keyword = input.keyword.trim().replace(/\s+/gu, " ");
+	if (!keyword || keyword.length > 80 || keyword.split(/\s+/u).length > 10) throw new SeoError("INVALID_INPUT", "SERP results requires a keyword of at most 80 characters and 10 words.");
+	if (!Number.isSafeInteger(input.depth) || input.depth < 1 || input.depth > MAX_REPORT_DEPTH) throw new SeoError("INVALID_INPUT", `SERP result depth must be from 1 to ${MAX_REPORT_DEPTH}.`);
+	const market = searchMarketSchema.safeParse(input.market);
+	if (!market.success) throw new SeoError("INVALID_INPUT", "Use a valid search market.");
+	const provider = input.provider ? providerIdSchema.safeParse(input.provider) : void 0;
+	if (provider && !provider.success) throw new SeoError("INVALID_INPUT", "Use a supported SERP provider.");
+	return {
+		keyword,
+		market: market.data,
+		provider: provider?.data
+	};
+}
+function reportStatus$1(evidence) {
+	if (evidence.coverage.completeness === "unavailable" || evidence.coverage.completeness === "invalid") return "unavailable";
+	return evidence.coverage.completeness === "complete" ? "complete" : "partial";
+}
+function domainSummaries(snapshot) {
+	const byDomain = /* @__PURE__ */ new Map();
+	for (const result of snapshot.organicResults) byDomain.set(result.domain, [...byDomain.get(result.domain) ?? [], result.rankAbsolute]);
+	return [...byDomain.entries()].map(([domain, ranks]) => ({
+		domain,
+		resultCount: ranks.length,
+		ranks: [...ranks].sort((left, right) => left - right)
+	})).sort((left, right) => right.resultCount - left.resultCount || (left.ranks[0] ?? Number.MAX_SAFE_INTEGER) - (right.ranks[0] ?? Number.MAX_SAFE_INTEGER) || compareCodepoints(left.domain, right.domain));
+}
+function reportFindings(snapshot, domains) {
+	const findings = [];
+	if (snapshot.effectiveKeyword !== snapshot.keyword) findings.push({
+		code: "query-correction",
+		evidenceRef: "evidence.data.effectiveKeyword",
+		principle: "A corrected query changes the observed result context and does not prove the original wording has the same intent.",
+		detail: `The provider observed results for ${snapshot.effectiveKeyword} after the requested query ${snapshot.keyword}.`
+	});
+	for (const [index, domain] of domains.entries()) {
+		if (domain.resultCount <= 1) continue;
+		findings.push({
+			code: "repeated-domain",
+			evidenceRef: `domains[${index}]`,
+			principle: "Repeated results are descriptive snapshot evidence, not a domain strength or quality score.",
+			detail: `${domain.domain} appears ${domain.resultCount} times at absolute ranks ${domain.ranks.join(", ")}.`
+		});
+	}
+	return findings.slice(0, 10);
+}
+async function serpResultsReport(input, dependencies = {}) {
+	const depth = input.depth ?? 10;
+	const validated = validateInput$1({
+		...input,
+		depth
+	});
+	let candidates;
+	try {
+		candidates = dependencies.candidates ?? await defaultCandidates$1();
+	} catch (error) {
+		return providerError$2(error);
+	}
+	const resolution = resolveProvider({
+		capability: "serp-snapshot",
+		market: validated.market,
+		candidates,
+		provider: validated.provider
+	});
+	if (resolution.status === "unavailable") throw new SeoError("PROVIDER_UNAVAILABLE", resolution.reason === "provider-not-connected" ? "No connected provider can return live SERP results. Run `seo providers dataforseo connect` first." : validated.provider ? `${validated.provider} cannot return live SERP results for this market.` : "No configured provider can return live SERP results for this market.");
+	const provider = snapshotProvider(resolution.provider);
+	if (!provider) throw new SeoError("PROVIDER_UNAVAILABLE", "The selected provider has no live SERP implementation.");
+	let evidence;
+	try {
+		evidence = await provider.serpSnapshot({
+			keyword: validated.keyword,
+			market: validated.market,
+			depth,
+			refresh: input.refresh,
+			context: {
+				projectId: input.context?.projectId ?? input.projectId,
+				reportId: input.context?.reportId ?? "serp-results",
+				reportRunId: input.context?.reportRunId ?? randomUUID()
+			}
+		});
+	} catch (error) {
+		return providerError$2(error);
+	}
+	const domains = domainSummaries(evidence.data);
+	const dataStatus = reportStatus$1(evidence);
+	const generatedAt = (dependencies.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
+	const correctedQuery = evidence.data.effectiveKeyword !== evidence.data.keyword;
+	return {
+		schemaVersion: 1,
+		generatedAt,
+		dataStatus,
+		market: evidence.market,
+		summary: {
+			keyword: evidence.data.keyword,
+			effectiveKeyword: evidence.data.effectiveKeyword,
+			requestedDepth: depth,
+			organicResults: evidence.data.organicResults.length,
+			uniqueDomains: domains.length,
+			observedFeatures: evidence.data.features.length,
+			correctedQuery,
+			verdict: `${evidence.data.organicResults.length} organic results across ${domains.length} domains were retained from the ${evidence.market.device ?? "desktop"} snapshot.`
+		},
+		evidence,
+		domains,
+		findings: reportFindings(evidence.data, domains),
+		caveats: [
+			"This is one market, location, language, and device-specific result snapshot; it is not rank history.",
+			"Search results can change between checks and may differ from a person's signed-in or personalized results.",
+			"The provider result count is an estimate and may be missing; retained organic rows are bounded by the requested depth.",
+			"Repeated domains, result features, titles, and snippets do not establish content quality, authority, or ranking feasibility."
+		],
+		nextSteps: [
+			"Review the retained pages and result types before deciding whether the query fits an existing page, a new page, or no page.",
+			"Keep Search Console average position separate from these exact snapshot ranks when comparing first-party performance.",
+			"Repeat the same market and device check later if the decision depends on result stability."
+		]
+	};
+}
+//#endregion
+//#region packages/core/src/analyze/local-search/report.ts
+const MAX_DAYS$1 = 548;
+const MAX_ROWS = 5e4;
+function boundedInteger$2(input) {
+	const value = input.value ?? input.fallback;
+	if (!Number.isSafeInteger(value) || value < input.minimum || value > input.maximum) throw new SeoError("INVALID_INPUT", `${input.label} must be a whole number between ${input.minimum} and ${input.maximum}.`);
+	return value;
+}
+function validateInput(input) {
+	const site = input.site.trim();
+	if (!site) throw new SeoError("INVALID_INPUT", "site must not be empty.");
+	if (input.locationTerms && (input.locationTerms.length > 100 || input.locationTerms.some((term) => !term.trim() || term.length > 100))) throw new SeoError("INVALID_INPUT", "locationTerms must contain at most 100 non-empty terms of 100 characters or fewer.");
+	if (input.brandTerms && (input.brandTerms.length > 20 || input.brandTerms.some((term) => !term.trim() || term.length > 200))) throw new SeoError("INVALID_INPUT", "brandTerms must contain at most 20 non-empty terms of 200 characters or fewer.");
+	const includeSerps = input.includeSerps ?? false;
+	let market;
+	if (input.market) {
+		const parsed = searchMarketSchema.safeParse(input.market);
+		if (!parsed.success) throw new SeoError("INVALID_INPUT", "Use a valid search market.");
+		market = parsed.data;
+	}
+	if (includeSerps && !market?.location) throw new SeoError("INVALID_INPUT", "Local SERP evidence requires a country, language, and canonical location.");
+	if (!includeSerps && (input.market || input.provider || input.serpLimit !== void 0 || input.serpDepth !== void 0)) throw new SeoError("INVALID_INPUT", "Set includeSerps to true before passing market, provider, or SERP options.");
+	return {
+		site,
+		days: boundedInteger$2({
+			value: input.days,
+			fallback: 28,
+			minimum: 1,
+			maximum: MAX_DAYS$1,
+			label: "days"
+		}),
+		locationTerms: normalizeLocationTerms(input.locationTerms),
+		minImpressions: boundedInteger$2({
+			value: input.minImpressions,
+			fallback: 1,
+			minimum: 0,
+			maximum: 1e9,
+			label: "minImpressions"
+		}),
+		limit: boundedInteger$2({
+			value: input.limit,
+			fallback: 25,
+			minimum: 1,
+			maximum: 100,
+			label: "limit"
+		}),
+		maxRows: boundedInteger$2({
+			value: input.maxRows,
+			fallback: MAX_ROWS,
+			minimum: 1,
+			maximum: MAX_ROWS,
+			label: "maxRows"
+		}),
+		includeSerps,
+		market,
+		serpLimit: boundedInteger$2({
+			value: input.serpLimit,
+			fallback: 3,
+			minimum: 1,
+			maximum: 3,
+			label: "serpLimit"
+		}),
+		serpDepth: boundedInteger$2({
+			value: input.serpDepth,
+			fallback: 10,
+			minimum: 1,
+			maximum: 20,
+			label: "serpDepth"
+		})
+	};
+}
+function emptyCost() {
+	return {
+		currency: "USD",
+		estimatedMicros: 0,
+		actualMicros: 0,
+		taskIds: []
+	};
+}
+function aggregateCosts(costs) {
+	const estimated = costs.map((cost) => cost.estimatedMicros);
+	const actual = costs.map((cost) => cost.actualMicros);
+	return {
+		currency: "USD",
+		estimatedMicros: estimated.some((value) => value === null) ? null : estimated.reduce((sum, value) => sum + (value ?? 0), 0),
+		actualMicros: actual.some((value) => value === null) ? null : actual.reduce((sum, value) => sum + (value ?? 0), 0),
+		taskIds: [...new Set(costs.flatMap((cost) => cost.taskIds))].sort()
+	};
+}
+function costsWithUnknownRequest(costs) {
+	return {
+		currency: "USD",
+		estimatedMicros: null,
+		actualMicros: null,
+		taskIds: [...new Set(costs.flatMap((cost) => cost.taskIds))].sort()
+	};
+}
+async function acquireSerps(input) {
+	const selected = input.queries.slice(0, input.limit);
+	const selection = {
+		availableQueries: input.queries.length,
+		requestedQueries: selected.length,
+		omittedQueries: Math.max(0, input.queries.length - selected.length),
+		limit: input.limit,
+		depth: input.depth,
+		method: "highest-impression-local-queries-v1"
+	};
+	if (!input.requested) return {
+		requested: false,
+		status: "not-requested",
+		selection,
+		market: null,
+		reports: [],
+		cost: emptyCost(),
+		reason: "Local SERP snapshots were not requested, so no paid provider work was attempted."
+	};
+	if (selected.length === 0) return {
+		requested: true,
+		status: "skipped",
+		selection,
+		market: input.market ?? null,
+		reports: [],
+		cost: emptyCost(),
+		reason: "No retained local-intent query was available for a SERP snapshot."
+	};
+	if (!input.market) throw new SeoError("INVALID_INPUT", "Local SERP evidence requires a market.");
+	const reports = [];
+	try {
+		for (const query of selected) reports.push(await input.run({
+			keyword: query,
+			market: input.market,
+			depth: input.depth,
+			provider: input.provider,
+			projectId: input.projectId,
+			context: {
+				reportId: "local-search-demand",
+				reportRunId: input.reportRunId
+			},
+			refresh: input.refresh
+		}));
+	} catch (error) {
+		if (error instanceof SeoError && (error.code === "PROVIDER_UNAVAILABLE" || error.code === "RATE_LIMITED")) return {
+			requested: true,
+			status: reports.length > 0 ? "partial" : "unavailable",
+			selection,
+			market: input.market,
+			reports,
+			cost: costsWithUnknownRequest(reports.map((report) => report.evidence.cost)),
+			reason: "First-party local demand remains available, but not every requested SERP snapshot could be acquired.",
+			error: {
+				code: error.code,
+				message: error.message,
+				retryable: error.retryable
+			}
+		};
+		throw error;
+	}
+	return {
+		requested: true,
+		status: reports.every((report) => report.dataStatus === "complete") ? "complete" : "partial",
+		selection,
+		market: input.market,
+		reports,
+		cost: aggregateCosts(reports.map((report) => report.evidence.cost))
+	};
+}
+async function localSearchReport(input, dependencies = {}) {
+	const options = validateInput(input);
+	const now = (dependencies.now ?? (() => /* @__PURE__ */ new Date()))();
+	const generatedAt = now.toISOString();
+	const range = finalGscDateRange(options.days, now);
+	const source = await (dependencies.searchAnalytics ?? querySearchAnalytics)(options.site, {
+		...range,
+		dimensions: ["query", "page"],
+		type: "web",
+		dataState: "final",
+		maxRows: options.maxRows
+	}, { refresh: input.refresh });
+	const analysis = analyzeLocalSearchRows({
+		rows: source.rows,
+		site: options.site,
+		locationTerms: options.locationTerms,
+		brandTerms: input.brandTerms,
+		includeBrand: input.includeBrand,
+		minImpressions: options.minImpressions,
+		limit: options.limit
+	});
+	const serpEvidence = await acquireSerps({
+		requested: options.includeSerps,
+		queries: analysis.opportunities.map((item) => item.query),
+		market: options.market,
+		provider: input.provider,
+		projectId: input.projectId,
+		refresh: input.refresh,
+		limit: options.serpLimit,
+		depth: options.serpDepth,
+		reportRunId: randomUUID(),
+		run: dependencies.serpResults ?? serpResultsReport
+	});
+	const possiblyTruncated = source.rowsFetched >= options.maxRows;
+	const sourceEmpty = source.rows.length === 0;
+	const filtered = !sourceEmpty && analysis.selection.eligibleQueries === 0;
+	const partial = possiblyTruncated || serpEvidence.status === "partial" || serpEvidence.status === "unavailable";
+	const opportunities = analysis.opportunities;
+	const localPackSnapshots = serpEvidence.reports.filter((report) => report.evidence.data.features.includes("local_pack")).length;
+	const dataStatus = sourceEmpty ? "empty" : partial ? "partial" : filtered ? "filtered" : "complete";
+	const warnings = [];
+	if (possiblyTruncated) warnings.push(`Search Console reached the ${options.maxRows}-row retention cap. Lower-volume local queries may be missing.`);
+	if (analysis.selection.invalidRows > 0) warnings.push(`${analysis.selection.invalidRows} malformed Search Console rows were excluded.`);
+	if (analysis.selection.conflictingRows > 0) warnings.push(`${analysis.selection.conflictingRows} conflicting duplicate Search Console rows were excluded.`);
+	if (serpEvidence.error) warnings.push(serpEvidence.error.message);
+	const nextSteps = [];
+	if (!options.includeSerps) nextSteps.push("If the shortlisted queries justify paid verification, rerun with includeSerps true and an exact location and device to inspect current local result features and organic competitors.");
+	else if (serpEvidence.status === "unavailable") nextSteps.push("Check the provider connection, market support, and local spend limits before retrying the missing SERP snapshots.");
+	if (analysis.templates.length > 0) nextSteps.push("Run pseo-audit on the strongest repeated local page pattern before expanding it; verify source fields, page uniqueness, indexability, and representative output.");
+	if (opportunities.some((item) => item.action === "review-page-overlap")) nextSteps.push("Review overlapping pages query by query before consolidating anything; multiple retained pages do not by themselves prove harmful cannibalisation.");
+	nextSteps.push("Use location terms for the actual service area and repeat the report for materially different markets or devices instead of treating one area as representative.");
+	return {
+		schemaVersion: 1,
+		methodology: "local-search-demand-v1",
+		site: options.site,
+		generatedAt,
+		range,
+		rangeDays: options.days,
+		dataStatus,
+		source: {
+			provider: "google-search-console",
+			dimensions: ["query", "page"],
+			searchType: "web",
+			dataState: "final",
+			rowsFetched: source.rowsFetched,
+			calls: source.calls,
+			maxRows: options.maxRows,
+			possiblyTruncated,
+			completeness: possiblyTruncated ? "possibly-truncated" : "retained-query-page-rows-only"
+		},
+		methodologyDetails: {
+			intentMethod: "explicit-local-intent-v1",
+			suppliedLocationTerms: options.locationTerms,
+			automaticPatterns: [
+				"nearby-phrases",
+				"uk-postcodes",
+				"contextual-us-zip-codes"
+			],
+			opportunityOrder: "impressions-clicks-position-query-v1",
+			templateMethod: "pseo-url-template-clustering-v1"
+		},
+		selection: analysis.selection,
+		summary: {
+			localQueries: analysis.selection.eligibleQueries,
+			returnedQueries: opportunities.length,
+			pages: analysis.eligiblePageCount,
+			...analysis.eligibleSummary,
+			templates: analysis.templates.length,
+			serpSnapshots: serpEvidence.reports.length,
+			localPackSnapshots,
+			verdict: sourceEmpty ? "Search Console returned no retained query/page rows for this date window." : filtered ? "No retained query/page rows matched the supplied terms or automatic local-intent patterns." : `${countLabel(analysis.selection.eligibleQueries, "local-intent query")} found; ${countLabel(opportunities.length, "query")} returned for review.`
+		},
+		opportunities,
+		templates: analysis.templates,
+		serpEvidence,
+		warnings,
+		caveats: [
+			"Search Console exposes retained top query/page rows and does not guarantee every query. A row cap means lower-volume local demand may be missing.",
+			"Named-place, proximity, and postal-code matching are explicit heuristics. They can miss implicit local intent and postal-looking non-location terms.",
+			"A place in a query describes query wording, not the searcher's physical location. Search Console average position is not an exact local rank.",
+			"A Google Analytics city or region describes measured users under Analytics rules; it is not joined here because it cannot prove which search query brought a user.",
+			"A local_pack feature in a live snapshot proves only that the result type appeared in that market, device, and observation. It does not expose or validate every business listing.",
+			"Repeated URL patterns and page overlap are review signals, not proof that more pages should exist or that consolidation is required.",
+			input.includeBrand ? "Brand queries were included when they matched the local-intent rules." : "Brand-like queries were excluded using the site and supplied brand terms."
+		],
+		nextSteps
+	};
+}
+//#endregion
 //#region packages/core/src/analyze/monitoring/crawl-recommendations.ts
 function statusMovedToError(item) {
 	return item.kind !== "removed" && (item.after?.status ?? 0) >= 400 && (item.before?.status ?? 200) < 400;
@@ -34790,326 +35648,6 @@ function pseoOpportunityVerdict(input) {
 	return `${expansions} template-expansion candidate${expansions === 1 ? "" : "s"} and ${input.competitors.length} observed competitor domain${input.competitors.length === 1 ? "" : "s"} were retained for review.`;
 }
 //#endregion
-//#region packages/core/src/providers/dataforseo/serp-snapshot.ts
-const MAX_SERP_DEPTH = 100;
-const SERP_ENDPOINT = "v3/serp/google/organic/live/advanced";
-function safeUrl$1(value) {
-	if (!value) return null;
-	try {
-		const parsed = new URL(value);
-		if (!["http:", "https:"].includes(parsed.protocol)) return null;
-		parsed.username = "";
-		parsed.password = "";
-		return parsed.toString();
-	} catch {
-		return null;
-	}
-}
-function validOrganic(item) {
-	return item.type === "organic" && Number.isSafeInteger(item.rank_group) && (item.rank_group ?? 0) > 0 && Number.isSafeInteger(item.rank_absolute) && (item.rank_absolute ?? 0) > 0 && Number.isSafeInteger(item.page) && (item.page ?? 0) > 0 && Boolean(item.domain?.trim()) && safeUrl$1(item.url) !== null;
-}
-function organicResult(item) {
-	if (!validOrganic(item)) return null;
-	const url = safeUrl$1(item.url);
-	if (!url) return null;
-	return {
-		rankGroup: item.rank_group,
-		rankAbsolute: item.rank_absolute,
-		page: item.page,
-		domain: item.domain.trim().toLowerCase(),
-		url,
-		title: item.title ?? null,
-		description: item.description ?? null,
-		isFeaturedSnippet: item.is_featured_snippet ?? null
-	};
-}
-function checkedAt(value, fallback) {
-	const timestamp = Date.parse(value);
-	return Number.isFinite(timestamp) ? new Date(timestamp).toISOString() : fallback;
-}
-function mapDataForSeoSerpSnapshot(input, snapshot, endpoint = SERP_ENDPOINT) {
-	const market = searchMarketSchema.parse(input.market);
-	const keyword = normalizedKeyword$2(input.keyword);
-	const location = locationRequest(market, "serp-snapshot");
-	const result = snapshot.response.tasks.flatMap((task) => task.result ?? []).find((item) => normalizedKeyword$2(item.keyword) === keyword);
-	if (!result) throw new ProviderError({
-		provider: "dataforseo",
-		operation: "serp-snapshot",
-		code: "invalid-response",
-		message: "DataForSEO returned no matching SERP result."
-	});
-	const warnings = [...snapshot.warnings];
-	const items = result.items ?? [];
-	const organicItems = items.filter((item) => item.type === "organic");
-	const mappedOrganicResults = organicItems.flatMap((item) => {
-		const mapped = organicResult(item);
-		return mapped ? [mapped] : [];
-	}).sort((left, right) => left.rankAbsolute - right.rankAbsolute || left.rankGroup - right.rankGroup || compareCodepoints$3(left.url, right.url));
-	const organicResults = mappedOrganicResults.slice(0, input.depth);
-	const invalidRows = organicItems.length - mappedOrganicResults.length;
-	const resultCapped = mappedOrganicResults.length > input.depth;
-	const invalidResultCount = result.se_results_count !== null && result.se_results_count !== void 0 && result.se_results_count < organicResults.length;
-	if (invalidRows > 0) warnings.push({
-		code: "invalid-organic-results",
-		field: "organicResults",
-		message: `DataForSEO returned ${invalidRows} organic result${invalidRows === 1 ? "" : "s"} without a valid rank, domain, or URL.`
-	});
-	if (!Number.isFinite(Date.parse(result.datetime))) warnings.push({
-		code: "invalid-serp-observation-time",
-		field: "checkedAt",
-		message: "DataForSEO returned an invalid SERP observation time; the local response time was retained."
-	});
-	const checkUrl = safeUrl$1(result.check_url);
-	if (result.check_url && !checkUrl) warnings.push({
-		code: "invalid-serp-check-url",
-		field: "checkUrl",
-		message: "DataForSEO returned an invalid SERP check URL."
-	});
-	if (invalidResultCount) warnings.push({
-		code: "invalid-serp-result-count",
-		field: "resultCount",
-		message: "DataForSEO returned an estimated result count below the retained organic result count; the estimate was discarded."
-	});
-	const features = [.../* @__PURE__ */ new Set([...result.item_types ?? [], ...items.map((item) => item.type)])].sort(compareCodepoints$3);
-	return {
-		schemaVersion: 1,
-		provider: "dataforseo",
-		capability: "serp-snapshot",
-		data: {
-			keyword,
-			effectiveKeyword: normalizedKeyword$2(result.spell?.keyword ?? result.keyword),
-			searchEngineDomain: result.se_domain?.trim().toLowerCase() ?? null,
-			checkedAt: checkedAt(result.datetime, snapshot.observedAt),
-			checkUrl,
-			resultCount: invalidResultCount ? null : result.se_results_count ?? null,
-			pagesCount: result.pages_count === void 0 ? null : result.pages_count,
-			features,
-			organicResults
-		},
-		observedAt: snapshot.observedAt,
-		market: {
-			...market,
-			device: market.device ?? "desktop"
-		},
-		coverage: {
-			requestedRows: input.depth,
-			returnedRows: snapshot.returnedRows,
-			retainedRows: organicResults.length,
-			invalidRows,
-			providerTotalRows: invalidResultCount ? null : result.se_results_count ?? null,
-			completeness: invalidRows > 0 || invalidResultCount ? "partial" : resultCapped ? "capped" : "complete",
-			nextCursor: null
-		},
-		cache: snapshot.cache,
-		cost: snapshot.cost,
-		request: {
-			operation: "serp-snapshot",
-			endpoint,
-			limit: input.depth,
-			filters: {
-				countryCode: market.countryCode,
-				languageCode: market.languageCode,
-				device: market.device ?? "desktop",
-				...location.locationCode !== void 0 ? { locationCode: location.locationCode } : { locationName: location.locationName }
-			},
-			sort: ["rankAbsolute:ascending", "url:codepoint-ascending"]
-		},
-		warnings
-	};
-}
-var DataForSeoSerpSnapshotProvider = class {
-	provider = "dataforseo";
-	capabilitySupport = [{
-		capability: "serp-snapshot",
-		status: "available",
-		markets: [{
-			searchEngines: ["google"],
-			devices: ["desktop", "mobile"],
-			location: "any"
-		}]
-	}];
-	client;
-	constructor(options = {}) {
-		this.client = options.client ?? new DataForSeoClient(options);
-	}
-	async serpSnapshot(input) {
-		const market = searchMarketSchema.parse(input.market);
-		if (market.searchEngine !== "google") throw new ProviderError({
-			provider: "dataforseo",
-			operation: "serp-snapshot",
-			code: "configuration",
-			message: "DataForSEO SERP snapshots currently support Google."
-		});
-		if (!Number.isSafeInteger(input.depth) || input.depth < 1 || input.depth > MAX_SERP_DEPTH) throw new ProviderError({
-			provider: "dataforseo",
-			operation: "serp-snapshot",
-			code: "configuration",
-			message: "SERP depth must be from 1 to 100."
-		});
-		const keyword = normalizedKeyword$2(input.keyword);
-		if (!keyword || keyword.length > 80 || keyword.split(/\s+/u).length > 10) throw new ProviderError({
-			provider: "dataforseo",
-			operation: "serp-snapshot",
-			code: "configuration",
-			message: "SERP snapshots require a keyword of at most 80 characters and 10 words."
-		});
-		const context = input.context ?? {
-			reportId: "serp-results",
-			reportRunId: randomUUID()
-		};
-		const location = locationRequest(market, "serp-snapshot");
-		return mapDataForSeoSerpSnapshot(input, await this.client.serpLive({
-			keyword,
-			languageCode: market.languageCode.split("-")[0],
-			...location,
-			device: market.device ?? "desktop",
-			depth: input.depth,
-			refresh: input.refresh,
-			context
-		}));
-	}
-};
-//#endregion
-//#region packages/core/src/analyze/serp-results.ts
-const MAX_REPORT_DEPTH = 100;
-function compareCodepoints(left, right) {
-	return left < right ? -1 : left > right ? 1 : 0;
-}
-function snapshotProvider(candidate) {
-	return "serpSnapshot" in candidate && typeof candidate.serpSnapshot === "function" ? candidate : null;
-}
-async function defaultCandidates$1() {
-	return [{
-		adapter: new DataForSeoSerpSnapshotProvider(),
-		connected: Boolean(await readDataForSeoCredentials()),
-		priority: 10
-	}];
-}
-function providerError$2(error) {
-	if (!(error instanceof ProviderError)) throw error;
-	if (error.code === "rate-limit") throw new SeoError("RATE_LIMITED", error.message);
-	if (error.code === "configuration") throw new SeoError("INVALID_INPUT", error.message);
-	throw new SeoError("PROVIDER_UNAVAILABLE", error.message);
-}
-function validateInput(input) {
-	const keyword = input.keyword.trim().replace(/\s+/gu, " ");
-	if (!keyword || keyword.length > 80 || keyword.split(/\s+/u).length > 10) throw new SeoError("INVALID_INPUT", "SERP results requires a keyword of at most 80 characters and 10 words.");
-	if (!Number.isSafeInteger(input.depth) || input.depth < 1 || input.depth > MAX_REPORT_DEPTH) throw new SeoError("INVALID_INPUT", `SERP result depth must be from 1 to ${MAX_REPORT_DEPTH}.`);
-	const market = searchMarketSchema.safeParse(input.market);
-	if (!market.success) throw new SeoError("INVALID_INPUT", "Use a valid search market.");
-	const provider = input.provider ? providerIdSchema.safeParse(input.provider) : void 0;
-	if (provider && !provider.success) throw new SeoError("INVALID_INPUT", "Use a supported SERP provider.");
-	return {
-		keyword,
-		market: market.data,
-		provider: provider?.data
-	};
-}
-function reportStatus$1(evidence) {
-	if (evidence.coverage.completeness === "unavailable" || evidence.coverage.completeness === "invalid") return "unavailable";
-	return evidence.coverage.completeness === "complete" ? "complete" : "partial";
-}
-function domainSummaries(snapshot) {
-	const byDomain = /* @__PURE__ */ new Map();
-	for (const result of snapshot.organicResults) byDomain.set(result.domain, [...byDomain.get(result.domain) ?? [], result.rankAbsolute]);
-	return [...byDomain.entries()].map(([domain, ranks]) => ({
-		domain,
-		resultCount: ranks.length,
-		ranks: [...ranks].sort((left, right) => left - right)
-	})).sort((left, right) => right.resultCount - left.resultCount || (left.ranks[0] ?? Number.MAX_SAFE_INTEGER) - (right.ranks[0] ?? Number.MAX_SAFE_INTEGER) || compareCodepoints(left.domain, right.domain));
-}
-function reportFindings(snapshot, domains) {
-	const findings = [];
-	if (snapshot.effectiveKeyword !== snapshot.keyword) findings.push({
-		code: "query-correction",
-		evidenceRef: "evidence.data.effectiveKeyword",
-		principle: "A corrected query changes the observed result context and does not prove the original wording has the same intent.",
-		detail: `The provider observed results for ${snapshot.effectiveKeyword} after the requested query ${snapshot.keyword}.`
-	});
-	for (const [index, domain] of domains.entries()) {
-		if (domain.resultCount <= 1) continue;
-		findings.push({
-			code: "repeated-domain",
-			evidenceRef: `domains[${index}]`,
-			principle: "Repeated results are descriptive snapshot evidence, not a domain strength or quality score.",
-			detail: `${domain.domain} appears ${domain.resultCount} times at absolute ranks ${domain.ranks.join(", ")}.`
-		});
-	}
-	return findings.slice(0, 10);
-}
-async function serpResultsReport(input, dependencies = {}) {
-	const depth = input.depth ?? 10;
-	const validated = validateInput({
-		...input,
-		depth
-	});
-	let candidates;
-	try {
-		candidates = dependencies.candidates ?? await defaultCandidates$1();
-	} catch (error) {
-		return providerError$2(error);
-	}
-	const resolution = resolveProvider({
-		capability: "serp-snapshot",
-		market: validated.market,
-		candidates,
-		provider: validated.provider
-	});
-	if (resolution.status === "unavailable") throw new SeoError("PROVIDER_UNAVAILABLE", resolution.reason === "provider-not-connected" ? "No connected provider can return live SERP results. Run `seo providers dataforseo connect` first." : validated.provider ? `${validated.provider} cannot return live SERP results for this market.` : "No configured provider can return live SERP results for this market.");
-	const provider = snapshotProvider(resolution.provider);
-	if (!provider) throw new SeoError("PROVIDER_UNAVAILABLE", "The selected provider has no live SERP implementation.");
-	let evidence;
-	try {
-		evidence = await provider.serpSnapshot({
-			keyword: validated.keyword,
-			market: validated.market,
-			depth,
-			refresh: input.refresh,
-			context: {
-				projectId: input.context?.projectId ?? input.projectId,
-				reportId: input.context?.reportId ?? "serp-results",
-				reportRunId: input.context?.reportRunId ?? randomUUID()
-			}
-		});
-	} catch (error) {
-		return providerError$2(error);
-	}
-	const domains = domainSummaries(evidence.data);
-	const dataStatus = reportStatus$1(evidence);
-	const generatedAt = (dependencies.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
-	const correctedQuery = evidence.data.effectiveKeyword !== evidence.data.keyword;
-	return {
-		schemaVersion: 1,
-		generatedAt,
-		dataStatus,
-		market: evidence.market,
-		summary: {
-			keyword: evidence.data.keyword,
-			effectiveKeyword: evidence.data.effectiveKeyword,
-			requestedDepth: depth,
-			organicResults: evidence.data.organicResults.length,
-			uniqueDomains: domains.length,
-			observedFeatures: evidence.data.features.length,
-			correctedQuery,
-			verdict: `${evidence.data.organicResults.length} organic results across ${domains.length} domains were retained from the ${evidence.market.device ?? "desktop"} snapshot.`
-		},
-		evidence,
-		domains,
-		findings: reportFindings(evidence.data, domains),
-		caveats: [
-			"This is one market, location, language, and device-specific result snapshot; it is not rank history.",
-			"Search results can change between checks and may differ from a person's signed-in or personalized results.",
-			"The provider result count is an estimate and may be missing; retained organic rows are bounded by the requested depth.",
-			"Repeated domains, result features, titles, and snippets do not establish content quality, authority, or ranking feasibility."
-		],
-		nextSteps: [
-			"Review the retained pages and result types before deciding whether the query fits an existing page, a new page, or no page.",
-			"Keep Search Console average position separate from these exact snapshot ranks when comparing first-party performance.",
-			"Repeat the same market and device check later if the decision depends on result stability."
-		]
-	};
-}
-//#endregion
 //#region packages/core/src/analyze/pseo-opportunities/serps.ts
 function selectSerpKeywords(candidates, limit) {
 	const seedRefs = /* @__PURE__ */ new Set();
@@ -42988,6 +43526,7 @@ const TELEMETRY_REPORTS = [
 	"crawl-history",
 	"crawler-rules",
 	"llms-txt-audit",
+	"local-search-demand",
 	"generate-llms-txt",
 	"measure-change",
 	"monthly-report",
@@ -43331,6 +43870,6 @@ function isoDate(daysAgo = 0) {
 	return date.toISOString().slice(0, 10);
 }
 //#endregion
-export { AI_REFERRAL_SOURCES, AI_REFERRAL_SOURCES_VERSION, AI_SEARCH_SCORECARD_METHODOLOGY_ID, AI_SEARCH_SCORECARD_METHODOLOGY_VERSION, AUDIT_PAGE_RULE_IDS, AUTOMATIC_BASELINE_SITE_RETENTION, AUTOMATIC_BASELINE_TOTAL_RETENTION, BING_API_KEY_ENV, BING_API_KEY_SECRET, BROWSER_USER_AGENT, BingWebmasterClient, CANNIBAL_MAXIMUM_DOMINANT_SHARE, CANNIBAL_MINIMUM_PAGE_SHARE, CRAWL_REPORT_STORAGE_VERSION, CRAWL_RUN_RETENTION, CRAWL_SKIP_REASONS, CTR_DEFAULT_LIMIT, CTR_DEFAULT_MIN_IMPRESSIONS, CTR_MAX_LIMIT, CTR_MAX_MIN_IMPRESSIONS, DATAFORSEO_CREDENTIAL_SECRET, DATAFORSEO_LOGIN_ENV, DATAFORSEO_PASSWORD_ENV, DEFAULT_PROVIDER_SPEND_LIMITS, DataForSeoClient, DataForSeoKeywordDiscoveryProvider, DataForSeoKeywordMetricsProvider, DataForSeoLinkProvider, DataForSeoProvider, DataForSeoRankTrackingCollector, DataForSeoSerpSnapshotProvider, GSC_FINAL_DATA_LAG_DAYS, GSC_TIME_ZONE, INDEXNOW_ENDPOINT, INDEXNOW_KEYS_SECRET, INDEXNOW_KEY_ENV, INDEXNOW_MAX_URLS, INDEX_WATCH_ATTEMPT_RETENTION, INTERNAL_LINK_LEXICAL_TARGET_LIMIT, INTERNAL_LINK_MATCH_EVIDENCE_LIMIT, JsonFileStorageAdapter, KEYWORD_SET_FIELD_LIMITS, KEYWORD_SET_LIMITS, KEYWORD_SET_SCHEMA_SQL, LINK_RECOVER_RUN_RETENTION, LOG_MAX_AGE_MS, LOG_MAX_FILE_BYTES, LOG_MAX_TOTAL_BYTES, LocalCredentialsProvider, MAX_CRAWL_CONCURRENCY, MAX_CRAWL_DEPTH, MAX_CRAWL_PAGES, MAX_CRAWL_TIMEOUT_MS, OKF_DEFAULT_CONCEPTS, OKF_MAX_CONCEPTS, PROVIDER_SPEND_MAX_BYTES, PROVIDER_SPEND_MAX_ROWS, PROVIDER_SPEND_RETENTION_DAYS, ProviderError, RANK_TRACKING_LIMITS, RANK_TRACKING_SCHEMA_SQL, REPORT_BASELINE_MAX_AGE_MS, REPORT_BASELINE_MAX_DEPTH, REPORT_BASELINE_MAX_PAGES, ResponseSizeLimitError, SCORECARD_CHECK_WEIGHTS, SCORECARD_STATUS_CREDIT, SEO_CRAWLER_IDENTITY, SEO_CRAWLER_TOKEN, SEO_CRAWLER_USER_AGENT, SEO_VERSION, SERP_TITLE_REFERENCE_WIDTH_PX, SERP_TITLE_WIDTH_PROFILE, SemrushProvider, SeoError, ServiceAccountAccessTokenClient, SessionLedger, TELEMETRY_AGENTS, TELEMETRY_ENDPOINT, TELEMETRY_ERROR_CATEGORIES, TELEMETRY_EVENTS, TELEMETRY_NOTICE, TELEMETRY_REPORTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_TIMEOUT_MS, acquirePseoAuditEvidence, activeRankTrackingRun, addKeywordsToSet, addStatus, affectedUrls, agentReadiness, aiPromptsForQuery, aiReadiness, aiReferralSourceForValue, aiReferralsReport, aiSearchScorecard, allocateIndexUrlsToProperties, analyticsConnectionsSchema, analyzeAiReferralRows, analyzeBingCrawl, analyzeBingDimensions, analyzeBingTraffic, analyzeCannibalRows, analyzeCtrUnderperformersFromRows, analyzeDecay, analyzeIndexCoverageSignals, analyzeInternalLinksFromRows, analyzeKeywordTrend, analyzePageOpportunitiesFromRows, analyzeQueryClustersFromRows, analyzeQuickWinsFromRows, analyzeSecondPageRows, analyzeSegmentRows, analyzeStrikingDistanceRows, analyzeTrafficAnomalyRows, assertCrawlConfigLimits, assertUrlMatchesGscProperty, attachCrawlRecommendations, auditCrawlPages, auditCrawlRequests, auditLlmsTxt, auditPage, authStatus, bingAnalysisDefaults, bingWebmasterOverview, bingWebmasterSiteUrl, boundedSitemapInventory, buildOkfBundle, buildPseoAuditFromAcquisition, buildPseoAuditReportFromRows, buildQueryClusterReportFromRows, buildTelemetryPayload, cannibalReport, changeMeasurementCsvRows, checkDatabaseReadiness, classifyCommunityIntent, classifyCrawler, clearCache, clientProfileSchema, clusterPseoTemplates, clusterQueryRows, collectAgentDiscovery, collectBingLinkEvidence, collectDataForSeoLinkEvidence, combineRobotsValues, communityIntentReport, compareCrawlPages, compareCrawlReports, compareLinkEvidence, compareSegmentRows, competitorKeywordGapReport, configSchema, contentCoverageRecommendation, contentCoverageType, contentOptimizationFromPageOpportunities, contentOptimizationReport, countLabel, crawlConfigHash, crawlConfigSchema, crawlDefinitionId, crawlDiff, crawlFixToQueueItem, crawlImplementationQueueWorkflow, crawlIssueGroupSchema, crawlIssueSchema, crawlOne, crawlPageSnapshotSchema, crawlReportSchema, crawlReportStore, crawlReportSummarySchema, crawlRequestObservationSchema, crawlRunId, crawlSite, crawlSkipImpact, crawlSkipReasonCountsFromRecord, crawlStatusOnly, crawlTopFixSchema, crawlerJsonSchemas, crawlerRuleCategorySchema, crawlerRuleIdSchema, crawlerRuleInfoSchema, crawlerRuleRecommendationSchema, crawlerRuleSeveritySchema, crawlerSchemas, createAuthorizedClient, createBingWebmasterClient, createContentGroup, createCrawlReport, createCtrBenchmarkContext, createGoogleAccessTokenClient, createIndexNowKey, createIndexNowKeyRecord, createKeywordSet, createLogger, createPageRenderer, ctrUnderperformersReport, decayClusterDrafts, decayComparisonRange, decayingReport, deleteChange, deleteClient, deleteContentGroup, deleteCrawlReport, deleteDataForSeoCredentials, deleteKeywordSet, deleteProviderSecret, deleteTokens, deriveBrandTerms, detectBrandTerms, detectTelemetryAgent, diagnoseCsvFiles, diagnoseProperty, diagnosePropertyWorkflow, domainOverviewReport, effectiveRobotsDirectives, effectiveSnippetControl, emptyStatusBreakdown, enforceRankTrackingLogicalBytes, ensurePrivateDatabaseFiles, ensureSeoCliDirs, entityReadiness, estimateSerpTitleWidth, executeRankTracking, expectedCtrForPosition, explainOkfValidation, explainRule, failRankTrackingTask, fetchCruxFieldData, fetchPage, fetchPageStatus, fetchSearchStatusIncidents, fetchSitemapUrls, fetchText, fileSize, finalGscDateRange, finalizeProviderSpend, findOverlappingSearchUpdates, formatRelativeExpiry, ga4MatchReason, ga4PropertyIdFromName, ga4ReportQualityWarnings, ga4RequestCanUseCache, ga4RowsToObjects, generateLlmsTxt, geoGaps, geoGapsReport, getAuthModeStatus, getCacheStats, getChange, getClient, getClientConfig, getContentGroup, getDb, getKeywordProvider, getKeywordSet, getOrCreateRankTrackingConfiguration, getPreviousRun, getPrivacySnapshot, getProviderSpendLimits, getProviderSpendSummary, getRankTrackingRun, getRepeatedLinkRecoverUrls, getRunPages, getSeoCliPaths, getServiceAccountConfig, getServiceAccountStatus, getTelemetryStatus, getTokenStorageStatus, googleAnalyticsPropertyId, groupCrawlIssues, hasMetaRobotsDirective, hasRule, hasXRobotsDirective, hashKey, importLinkEvidence, importServerLog, indexCoveragePlan, indexCoverageSignals, indexMonitor, indexWatch, inferPseoTemplate, inferTemplateMovement, initializeTelemetry, insertCrawlRun, insertLinkRecoverRun, inspectUrl, internalLinksReport, interpretUpdateCorrelation, isBrandQuery, isCompatibleTechnicalBaseline, isCurrentTechnicalBaseline, isEntityEvidenceSchemaType, isSiteIdentitySchemaType, isSkippableReportError, isTelemetryCi, isTelemetryReport, isoDate, isoWeek, keywordDiscoverySourceSchema, keywordMetricsReport, keywordOpportunitiesReport, keywordResearchReport, keywordSetLogicalBytes, latestCrawlReport, latestCrawlSummaries, latestFinalGscDate, latestIndexWatchSummary, latestLinkRecoverSummary, latestRankTrackingRun, linkEntries, linkEvidenceKey, linkEvidenceReport, linkRecover, linkRecoverRecommendation, linkTargetContext, listChanges, listClients, listContentGroups, listCrawlReports, listGa4AccountSummaries, listGa4DataStreams, listIndexNowKeys, listKeywordSets, listRules, listSearchUpdates, listSites, loadCrawlReport, localCredentialsProvider, loginWithLoopback, makeRunId, mapDataForSeoSerpSnapshot, markRankTasksPosted, markRankTasksPosting, matchGa4WebStreams, measureChange, measureCoverage, metaRobotsDirectives, migrateLegacyMacConfig, missingOAuthClientMessage, missingSharedClientLoginMessage, monitoringStatus, monthlyReport, monthlyReportWorkflow, narrativeCsvFiles, normalizeCrawlConfig, normalizeCrawlSkipReasonCounts, normalizeForCoverage, normalizeHttpUrl, normalizeJavaScriptRenderingMode, normalizeLinkEvidenceRow, normalizeLoadedCrawlReport, normalizeSavedKeyword, noteCacheWrite, observedValue, okfConceptLimit, pageEvidenceRecommendation, pageOpportunitiesReport, parseCombinedLogLine, parseIndexNowSite, parseJsonLogLine, parseOlderThan, parsePseoPath, performanceAudit, performanceReportIsCacheable, planDueIndexUrls, planIndexCoverageFromUrls, plural, priorComparableRankTrackingRun, propertyMatchesUrl, providerCapabilitySchema, providerIdSchema, providerPreferenceSchema, providerRequestJson, providerRequestText, providerSpendLimitOverridesSchema, pruneIndexWatchSnapshots, pruneLogs, pseoAuditOptions, pseoAuditReport, pseoCsvFiles, pseoIndexStatus, pseoOpportunitiesReport, pseoPresentation, publicHttpFetch, queryClusterReport, queryClusterTokens, queryContentCoverageFromPage, queryContentFieldsFromPage, queryFieldCoverage, queryOpportunityRecommendation, queryPageMetrics, queryPageTopQuery, queryPagesMetrics, queryPagesMetricsBatch, queryPagesTopQueries, queryPagesTopQueriesBatch, querySearchAnalytics, quickWinsCsvRows, quickWinsReport, rankObservations, rankTrackingLogicalBytes, rankTrackingReport, rankTrackingTasks, rankedKeywordsReport, rankingPagesReport, readBoundedResponseText, readConfig, readDataForSeoCredentials, readOauthClient, readProviderSecret, readTokens, recommendCrawlDiffItem, recommendationForRule, recordChange, recoverRankTaskReceipt, redirectTrace, refreshAuthToken, refreshKeywordSet, refreshPrioritiesCsvFiles, refreshPrioritiesWorkflow, refreshRankTrackingRun, removeIndexNowKey, removeKeywordsFromSet, renderCrawlCsv, renderCrawlHtml, renderCrawlJunit, renderCrawlMarkdownTickets, renderCrawlPagesCsv, renderCrawlPretty, renderCsv, renderPresentationTablesMarkdown, renderPseoMarkdown, renderReportHtml, renderWorkflowMarkdown, reportNarrative, reportPresentation, requestHeaders, reserveProviderSpend, resolveIndexNowKey, resolveProvider, resolveSegmentRanges, resolveSeoCliPaths, resolveTechnicalBaseline, reviewObservations, roundedPosition, runDoctor, runGa4Report, safeError, saveClient, saveCrawlReport, saveIndexNowKey, saveRankObservation, saveRankObservations, savedKeywordSetReport, searchMarketSchema, secondPage, segmentComparisonRange, segmentImpact, segmentRangeDays, selectAffectedUrls, selectDueIndexUrls, seoErrorEnvelope, seoToAiQueryReport, serpCompetitorsReport, serpResultsReport, serverLogReport, sessionSourceInListFilter, setClientBingSite, setDefaultClient, setKeywordSetRefreshTime, setProviderSpendLimits, setTelemetryEnabled, setTokenStorageMode, shiftIsoDate, shouldExcludeBrandQuery, siteSchema, sqliteCrawlReportStore, startRankTrackingRun, strikingDistance, submitIndexNow, summarizeCrawlReport, targetMatchesDomain, pageTechnicalSignals as technicalPageSignals, technicalWatchWorkflow, telemetryErrorCategory, templateForUrl, toSeoError, tokenSchema, topCrawlRecommendations, topFixes, trackTelemetryReportComplete, trackTelemetryReportFailed, trackTelemetryReportStart, trackTelemetrySetupComplete, trafficAnomaly, unavailableSegmentImpactReport, unavailableValue, unicodeTokens, updateCorrelation, updatePostmortemCsvFiles, updatePostmortemWorkflow, validateIndexNowKey, validateIndexNowKeyRecord, validateOkfFiles, verifyIndexNowKey, verifyQueryContent, workflowPresentation, writeConfig, writeDataForSeoCredentials, writeOauthClient, writeProviderSecret, writeTokens, xRobotsDirectives };
+export { AI_REFERRAL_SOURCES, AI_REFERRAL_SOURCES_VERSION, AI_SEARCH_SCORECARD_METHODOLOGY_ID, AI_SEARCH_SCORECARD_METHODOLOGY_VERSION, AUDIT_PAGE_RULE_IDS, AUTOMATIC_BASELINE_SITE_RETENTION, AUTOMATIC_BASELINE_TOTAL_RETENTION, BING_API_KEY_ENV, BING_API_KEY_SECRET, BROWSER_USER_AGENT, BingWebmasterClient, CANNIBAL_MAXIMUM_DOMINANT_SHARE, CANNIBAL_MINIMUM_PAGE_SHARE, CRAWL_REPORT_STORAGE_VERSION, CRAWL_RUN_RETENTION, CRAWL_SKIP_REASONS, CTR_DEFAULT_LIMIT, CTR_DEFAULT_MIN_IMPRESSIONS, CTR_MAX_LIMIT, CTR_MAX_MIN_IMPRESSIONS, DATAFORSEO_CREDENTIAL_SECRET, DATAFORSEO_LOGIN_ENV, DATAFORSEO_PASSWORD_ENV, DEFAULT_PROVIDER_SPEND_LIMITS, DataForSeoClient, DataForSeoKeywordDiscoveryProvider, DataForSeoKeywordMetricsProvider, DataForSeoLinkProvider, DataForSeoProvider, DataForSeoRankTrackingCollector, DataForSeoSerpSnapshotProvider, GSC_FINAL_DATA_LAG_DAYS, GSC_TIME_ZONE, INDEXNOW_ENDPOINT, INDEXNOW_KEYS_SECRET, INDEXNOW_KEY_ENV, INDEXNOW_MAX_URLS, INDEX_WATCH_ATTEMPT_RETENTION, INTERNAL_LINK_LEXICAL_TARGET_LIMIT, INTERNAL_LINK_MATCH_EVIDENCE_LIMIT, JsonFileStorageAdapter, KEYWORD_SET_FIELD_LIMITS, KEYWORD_SET_LIMITS, KEYWORD_SET_SCHEMA_SQL, LINK_RECOVER_RUN_RETENTION, LOG_MAX_AGE_MS, LOG_MAX_FILE_BYTES, LOG_MAX_TOTAL_BYTES, LocalCredentialsProvider, MAX_CRAWL_CONCURRENCY, MAX_CRAWL_DEPTH, MAX_CRAWL_PAGES, MAX_CRAWL_TIMEOUT_MS, OKF_DEFAULT_CONCEPTS, OKF_MAX_CONCEPTS, PROVIDER_SPEND_MAX_BYTES, PROVIDER_SPEND_MAX_ROWS, PROVIDER_SPEND_RETENTION_DAYS, ProviderError, RANK_TRACKING_LIMITS, RANK_TRACKING_SCHEMA_SQL, REPORT_BASELINE_MAX_AGE_MS, REPORT_BASELINE_MAX_DEPTH, REPORT_BASELINE_MAX_PAGES, ResponseSizeLimitError, SCORECARD_CHECK_WEIGHTS, SCORECARD_STATUS_CREDIT, SEO_CRAWLER_IDENTITY, SEO_CRAWLER_TOKEN, SEO_CRAWLER_USER_AGENT, SEO_VERSION, SERP_TITLE_REFERENCE_WIDTH_PX, SERP_TITLE_WIDTH_PROFILE, SemrushProvider, SeoError, ServiceAccountAccessTokenClient, SessionLedger, TELEMETRY_AGENTS, TELEMETRY_ENDPOINT, TELEMETRY_ERROR_CATEGORIES, TELEMETRY_EVENTS, TELEMETRY_NOTICE, TELEMETRY_REPORTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_TIMEOUT_MS, acquirePseoAuditEvidence, activeRankTrackingRun, addKeywordsToSet, addStatus, affectedUrls, agentReadiness, aiPromptsForQuery, aiReadiness, aiReferralSourceForValue, aiReferralsReport, aiSearchScorecard, allocateIndexUrlsToProperties, analyticsConnectionsSchema, analyzeAiReferralRows, analyzeBingCrawl, analyzeBingDimensions, analyzeBingTraffic, analyzeCannibalRows, analyzeCtrUnderperformersFromRows, analyzeDecay, analyzeIndexCoverageSignals, analyzeInternalLinksFromRows, analyzeKeywordTrend, analyzeLocalSearchRows, analyzePageOpportunitiesFromRows, analyzeQueryClustersFromRows, analyzeQuickWinsFromRows, analyzeSecondPageRows, analyzeSegmentRows, analyzeStrikingDistanceRows, analyzeTrafficAnomalyRows, assertCrawlConfigLimits, assertUrlMatchesGscProperty, attachCrawlRecommendations, auditCrawlPages, auditCrawlRequests, auditLlmsTxt, auditPage, authStatus, bingAnalysisDefaults, bingWebmasterOverview, bingWebmasterSiteUrl, boundedSitemapInventory, buildOkfBundle, buildPseoAuditFromAcquisition, buildPseoAuditReportFromRows, buildQueryClusterReportFromRows, buildTelemetryPayload, cannibalReport, changeMeasurementCsvRows, checkDatabaseReadiness, classifyCommunityIntent, classifyCrawler, classifyLocalIntent, clearCache, clientProfileSchema, clusterPseoTemplates, clusterQueryRows, collectAgentDiscovery, collectBingLinkEvidence, collectDataForSeoLinkEvidence, combineRobotsValues, communityIntentReport, compareCrawlPages, compareCrawlReports, compareLinkEvidence, compareSegmentRows, competitorKeywordGapReport, configSchema, contentCoverageRecommendation, contentCoverageType, contentOptimizationFromPageOpportunities, contentOptimizationReport, countLabel, crawlConfigHash, crawlConfigSchema, crawlDefinitionId, crawlDiff, crawlFixToQueueItem, crawlImplementationQueueWorkflow, crawlIssueGroupSchema, crawlIssueSchema, crawlOne, crawlPageSnapshotSchema, crawlReportSchema, crawlReportStore, crawlReportSummarySchema, crawlRequestObservationSchema, crawlRunId, crawlSite, crawlSkipImpact, crawlSkipReasonCountsFromRecord, crawlStatusOnly, crawlTopFixSchema, crawlerJsonSchemas, crawlerRuleCategorySchema, crawlerRuleIdSchema, crawlerRuleInfoSchema, crawlerRuleRecommendationSchema, crawlerRuleSeveritySchema, crawlerSchemas, createAuthorizedClient, createBingWebmasterClient, createContentGroup, createCrawlReport, createCtrBenchmarkContext, createGoogleAccessTokenClient, createIndexNowKey, createIndexNowKeyRecord, createKeywordSet, createLocalIntentClassifier, createLogger, createPageRenderer, ctrUnderperformersReport, decayClusterDrafts, decayComparisonRange, decayingReport, deleteChange, deleteClient, deleteContentGroup, deleteCrawlReport, deleteDataForSeoCredentials, deleteKeywordSet, deleteProviderSecret, deleteTokens, deriveBrandTerms, detectBrandTerms, detectTelemetryAgent, diagnoseCsvFiles, diagnoseProperty, diagnosePropertyWorkflow, domainOverviewReport, effectiveRobotsDirectives, effectiveSnippetControl, emptyStatusBreakdown, enforceRankTrackingLogicalBytes, ensurePrivateDatabaseFiles, ensureSeoCliDirs, entityReadiness, estimateSerpTitleWidth, executeRankTracking, expectedCtrForPosition, explainOkfValidation, explainRule, failRankTrackingTask, fetchCruxFieldData, fetchPage, fetchPageStatus, fetchSearchStatusIncidents, fetchSitemapUrls, fetchText, fileSize, finalGscDateRange, finalizeProviderSpend, findOverlappingSearchUpdates, formatRelativeExpiry, ga4MatchReason, ga4PropertyIdFromName, ga4ReportQualityWarnings, ga4RequestCanUseCache, ga4RowsToObjects, generateLlmsTxt, geoGaps, geoGapsReport, getAuthModeStatus, getCacheStats, getChange, getClient, getClientConfig, getContentGroup, getDb, getKeywordProvider, getKeywordSet, getOrCreateRankTrackingConfiguration, getPreviousRun, getPrivacySnapshot, getProviderSpendLimits, getProviderSpendSummary, getRankTrackingRun, getRepeatedLinkRecoverUrls, getRunPages, getSeoCliPaths, getServiceAccountConfig, getServiceAccountStatus, getTelemetryStatus, getTokenStorageStatus, googleAnalyticsPropertyId, groupCrawlIssues, hasMetaRobotsDirective, hasRule, hasXRobotsDirective, hashKey, importLinkEvidence, importServerLog, indexCoveragePlan, indexCoverageSignals, indexMonitor, indexWatch, inferPseoTemplate, inferTemplateMovement, initializeTelemetry, insertCrawlRun, insertLinkRecoverRun, inspectUrl, internalLinksReport, interpretUpdateCorrelation, isBrandQuery, isCompatibleTechnicalBaseline, isCurrentTechnicalBaseline, isEntityEvidenceSchemaType, isSiteIdentitySchemaType, isSkippableReportError, isTelemetryCi, isTelemetryReport, isoDate, isoWeek, keywordDiscoverySourceSchema, keywordMetricsReport, keywordOpportunitiesReport, keywordResearchReport, keywordSetLogicalBytes, latestCrawlReport, latestCrawlSummaries, latestFinalGscDate, latestIndexWatchSummary, latestLinkRecoverSummary, latestRankTrackingRun, linkEntries, linkEvidenceKey, linkEvidenceReport, linkRecover, linkRecoverRecommendation, linkTargetContext, listChanges, listClients, listContentGroups, listCrawlReports, listGa4AccountSummaries, listGa4DataStreams, listIndexNowKeys, listKeywordSets, listRules, listSearchUpdates, listSites, loadCrawlReport, localCredentialsProvider, localSearchReport, loginWithLoopback, makeRunId, mapDataForSeoSerpSnapshot, markRankTasksPosted, markRankTasksPosting, matchGa4WebStreams, measureChange, measureCoverage, metaRobotsDirectives, migrateLegacyMacConfig, missingOAuthClientMessage, missingSharedClientLoginMessage, monitoringStatus, monthlyReport, monthlyReportWorkflow, narrativeCsvFiles, normalizeCrawlConfig, normalizeCrawlSkipReasonCounts, normalizeForCoverage, normalizeHttpUrl, normalizeJavaScriptRenderingMode, normalizeLinkEvidenceRow, normalizeLoadedCrawlReport, normalizeLocalSearchText, normalizeLocationTerms, normalizeSavedKeyword, noteCacheWrite, observedValue, okfConceptLimit, pageEvidenceRecommendation, pageOpportunitiesReport, parseCombinedLogLine, parseIndexNowSite, parseJsonLogLine, parseOlderThan, parsePseoPath, performanceAudit, performanceReportIsCacheable, planDueIndexUrls, planIndexCoverageFromUrls, plural, priorComparableRankTrackingRun, propertyMatchesUrl, providerCapabilitySchema, providerIdSchema, providerPreferenceSchema, providerRequestJson, providerRequestText, providerSpendLimitOverridesSchema, pruneIndexWatchSnapshots, pruneLogs, pseoAuditOptions, pseoAuditReport, pseoCsvFiles, pseoIndexStatus, pseoOpportunitiesReport, pseoPresentation, publicHttpFetch, queryClusterReport, queryClusterTokens, queryContentCoverageFromPage, queryContentFieldsFromPage, queryFieldCoverage, queryOpportunityRecommendation, queryPageMetrics, queryPageTopQuery, queryPagesMetrics, queryPagesMetricsBatch, queryPagesTopQueries, queryPagesTopQueriesBatch, querySearchAnalytics, quickWinsCsvRows, quickWinsReport, rankObservations, rankTrackingLogicalBytes, rankTrackingReport, rankTrackingTasks, rankedKeywordsReport, rankingPagesReport, readBoundedResponseText, readConfig, readDataForSeoCredentials, readOauthClient, readProviderSecret, readTokens, recommendCrawlDiffItem, recommendationForRule, recordChange, recoverRankTaskReceipt, redirectTrace, refreshAuthToken, refreshKeywordSet, refreshPrioritiesCsvFiles, refreshPrioritiesWorkflow, refreshRankTrackingRun, removeIndexNowKey, removeKeywordsFromSet, renderCrawlCsv, renderCrawlHtml, renderCrawlJunit, renderCrawlMarkdownTickets, renderCrawlPagesCsv, renderCrawlPretty, renderCsv, renderPresentationTablesMarkdown, renderPseoMarkdown, renderReportHtml, renderWorkflowMarkdown, reportNarrative, reportPresentation, requestHeaders, reserveProviderSpend, resolveIndexNowKey, resolveProvider, resolveSegmentRanges, resolveSeoCliPaths, resolveTechnicalBaseline, reviewObservations, roundedPosition, runDoctor, runGa4Report, safeError, saveClient, saveCrawlReport, saveIndexNowKey, saveRankObservation, saveRankObservations, savedKeywordSetReport, searchMarketSchema, secondPage, segmentComparisonRange, segmentImpact, segmentRangeDays, selectAffectedUrls, selectDueIndexUrls, seoErrorEnvelope, seoToAiQueryReport, serpCompetitorsReport, serpResultsReport, serverLogReport, sessionSourceInListFilter, setClientBingSite, setDefaultClient, setKeywordSetRefreshTime, setProviderSpendLimits, setTelemetryEnabled, setTokenStorageMode, shiftIsoDate, shouldExcludeBrandQuery, siteSchema, sqliteCrawlReportStore, startRankTrackingRun, strikingDistance, submitIndexNow, summarizeCrawlReport, targetMatchesDomain, pageTechnicalSignals as technicalPageSignals, technicalWatchWorkflow, telemetryErrorCategory, templateForUrl, toSeoError, tokenSchema, topCrawlRecommendations, topFixes, trackTelemetryReportComplete, trackTelemetryReportFailed, trackTelemetryReportStart, trackTelemetrySetupComplete, trafficAnomaly, unavailableSegmentImpactReport, unavailableValue, unicodeTokens, updateCorrelation, updatePostmortemCsvFiles, updatePostmortemWorkflow, validateIndexNowKey, validateIndexNowKeyRecord, validateOkfFiles, verifyIndexNowKey, verifyQueryContent, workflowPresentation, writeConfig, writeDataForSeoCredentials, writeOauthClient, writeProviderSecret, writeTokens, xRobotsDirectives };
 
 //# sourceMappingURL=index.js.map