seo 0.2.4 → 0.2.5

package/dist/mcp.js

@@ -1,5 +1,5 @@
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import { n as load, t as version } from "./package-D6bCOqrD.js";
+import { n as load, t as version } from "./package-BF_XgK7-.js";
 import { Headers, fetch as fetch$1 } from "undici";
 import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
@@ -218,6 +218,7 @@ const siteSchema = z.object({
 	isDefault: z.boolean().optional()
 });
 const providerPreferenceSchema = z.enum(["cheap", "authoritative"]);
+const analyticsConnectionsSchema = z.object({ google: z.object({ propertyId: z.string() }).optional() }).default({});
 const clientProfileSchema = z.object({
 	id: z.string(),
 	name: z.string(),
@@ -225,7 +226,7 @@ const clientProfileSchema = z.object({
 	startUrl: z.string().optional(),
 	watchUrls: z.array(z.string()).default([]),
 	brandTerms: z.array(z.string()).default([]),
-	ga4PropertyId: z.string().optional(),
+	analytics: analyticsConnectionsSchema,
 	reportDay: z.number().int().min(1).max(31).optional(),
 	technicalWeekday: z.number().int().min(0).max(7).optional(),
 	isDefault: z.boolean().optional(),
@@ -236,14 +237,14 @@ const configSchema = z.object({
 	defaultSite: z.string().optional(),
 	sites: z.array(siteSchema).default([]),
 	clients: z.array(clientProfileSchema).default([]),
-	google: z.object({
-		defaultGa4PropertyId: z.string().optional(),
+	analytics: z.object({ google: z.object({
+		defaultPropertyId: z.string().optional(),
 		propertyMappings: z.array(z.object({
 			siteUrl: z.string(),
-			ga4PropertyId: z.string(),
+			propertyId: z.string(),
 			addedAt: z.number().int().optional()
 		})).default([])
-	}).default({ propertyMappings: [] }),
+	}).default({ propertyMappings: [] }) }).default({ google: { propertyMappings: [] } }),
 	providers: z.object({
 		semrushApiKey: z.string().optional(),
 		dataForSeoLogin: z.string().optional(),
@@ -460,6 +461,14 @@ function missingOAuthClientMessage(source) {
 //#endregion
 //#region packages/core/dist/gsc/auth/types.js
 const GOOGLE_READONLY_SCOPES = ["https://www.googleapis.com/auth/webmasters.readonly", "https://www.googleapis.com/auth/analytics.readonly"];
+const GOOGLE_READONLY_SCOPE_LABELS = {
+	"https://www.googleapis.com/auth/webmasters.readonly": "Search Console",
+	"https://www.googleapis.com/auth/analytics.readonly": "Google Analytics"
+};
+function missingGoogleReadonlyScopes(scope) {
+	const granted = new Set(scope.split(/\s+/u).filter(Boolean));
+	return GOOGLE_READONLY_SCOPES.filter((required) => !granted.has(required));
+}
 [
 	...GOOGLE_READONLY_SCOPES,
 	"openid",
@@ -657,6 +666,11 @@ function authRequired() {
 function authExpired() {
 	return new SeoError("AUTH_EXPIRED", "Google refresh token is no longer valid. Run `seo auth login` again.");
 }
+function requireReadonlyScopes(tokens) {
+	const missing = missingGoogleReadonlyScopes(tokens.scope);
+	if (missing.length === 0) return;
+	throw new SeoError("ACCESS_DENIED", `Google access is missing ${missing.map((scope) => GOOGLE_READONLY_SCOPE_LABELS[scope]).join(" and ")}. Run \`seo auth login\` again, choose Select all, and approve both permission boxes.`);
+}
 function needsRefresh(tokens, now) {
 	return !tokens.access_token || tokens.expires_at - now < REFRESH_BUFFER_MS;
 }
@@ -716,6 +730,7 @@ async function createAuthorizedClient() {
 	let tokens = await readTokens();
 	if (!tokens) throw authRequired();
 	requireClientConfig(tokens);
+	requireReadonlyScopes(tokens);
 	if (needsRefresh(tokens, Date.now())) tokens = await refreshStoredToken({ onlyIfExpiring: true });
 	return {
 		client: new LocalGoogleAccessTokenClient(tokens),
@@ -1068,8 +1083,8 @@ async function runGa4Report(propertyId, body, opts = {}) {
 		body: JSON.stringify(body)
 	});
 	if (!response.ok) {
-		if (response.status === 403) throw new Error(`GA4 report failed with 403. Check access to property ${propertyId}.`);
-		throw new Error(`GA4 report failed with ${response.status}.`);
+		if (response.status === 403) throw new Error(`Google Analytics report failed with 403. Check access to property ${propertyId}.`);
+		throw new Error(`Google Analytics report failed with ${response.status}.`);
 	}
 	const result = await response.json();
 	if (cacheable) db.prepare(`INSERT OR REPLACE INTO ga4_cache
@@ -1091,7 +1106,7 @@ function ga4RowsToObjects(result) {
 		return output;
 	});
 }
-function ga4ReportQualityWarnings(result, label = "GA4 report") {
+function ga4ReportQualityWarnings(result, label = "Google Analytics report") {
 	const warnings = [];
 	if (result.metadata?.dataLossFromOtherRow) warnings.push(`${label} grouped high-cardinality data into (other).`);
 	if (result.metadata?.subjectToThresholding) warnings.push(`${label} was subject to Google Analytics thresholding.`);
@@ -1197,11 +1212,11 @@ function compareText$16(left, right) {
 function metric(row, name) {
 	const value = row[name];
 	const parsed = Number(value);
-	if (value === void 0 || value.trim() === "" || !Number.isInteger(parsed) || parsed < 0) throw new SeoError("PROVIDER_UNAVAILABLE", `GA4 returned an invalid ${name} value.`);
+	if (value === void 0 || value.trim() === "" || !Number.isInteger(parsed) || parsed < 0) throw new SeoError("PROVIDER_UNAVAILABLE", `Google Analytics returned an invalid ${name} value.`);
 	return parsed;
 }
 function dateValue$1(value) {
-	if (!value || !/^\d{8}$/.test(value)) throw new SeoError("PROVIDER_UNAVAILABLE", "GA4 returned an invalid date value.");
+	if (!value || !/^\d{8}$/.test(value)) throw new SeoError("PROVIDER_UNAVAILABLE", "Google Analytics returned an invalid date value.");
 	return `${value.slice(0, 4)}-${value.slice(4, 6)}-${value.slice(6, 8)}`;
 }
 function addMetrics(target, source) {
@@ -1240,7 +1255,7 @@ function analyzeAiReferralRows(input) {
 	const detailTotal = emptyMetrics();
 	for (const row of input.detailRows) {
 		const definition = aiReferralSourceForValue(row.sessionSource ?? "");
-		if (!definition || !sourceTotals.has(definition.id)) throw new SeoError("PROVIDER_UNAVAILABLE", "GA4 detail rows contained an unexpected session source.");
+		if (!definition || !sourceTotals.has(definition.id)) throw new SeoError("PROVIDER_UNAVAILABLE", "Google Analytics detail rows contained an unexpected session source.");
 		const metrics = {
 			sessions: metric(row, "sessions"),
 			eventCount: metric(row, "eventCount")
@@ -1273,11 +1288,11 @@ function analyzeAiReferralRows(input) {
 		...evidenceReasons("Source discovery", input.sourceDiscovery),
 		...evidenceReasons("Landing-page detail", input.detail),
 		...evidenceReasons("Total users", input.totalUsersEvidence),
-		...detailMismatch ? ["GA4 detail totals differ from source-discovery totals; landing-page and daily breakdowns are incomplete."] : [],
-		...timeZones.size > 1 ? ["GA4 queries returned inconsistent property time zones."] : []
+		...detailMismatch ? ["Google Analytics detail totals differ from source-discovery totals; landing-page and daily breakdowns are incomplete."] : [],
+		...timeZones.size > 1 ? ["Google Analytics queries returned inconsistent property time zones."] : []
 	];
 	const dataStatus = partialReasons.length ? "partial" : "complete";
-	const generalCaveat = "GA4 only attributes visits that arrive with a recognized session source; some AI visits appear as direct, unassigned, or another source.";
+	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$16(left[0], right[0]))[0]?.[0];
@@ -1309,13 +1324,13 @@ function analyzeAiReferralRows(input) {
 		dataStatus,
 		range: input.range,
 		methodology: {
-			id: "ga4-ai-referrals",
+			id: "google-analytics-ai-referrals",
 			version: 2,
 			attributionDimension: "sessionSource",
 			sourceRulesVersion: AI_REFERRAL_SOURCES_VERSION
 		},
 		dataSource: {
-			provider: "google-analytics-4",
+			provider: "google-analytics",
 			api: "analyticsdata.v1beta.runReport",
 			maxRows: input.maxRows,
 			calls: input.sourceDiscovery.calls + input.detail.calls + input.totalUsersEvidence.calls,
@@ -1332,7 +1347,7 @@ function analyzeAiReferralRows(input) {
 			totalUsersStatus: input.totalUsers === null ? "not-reported" : "available",
 			sources: sourceTotals.size,
 			landingPages: pageTotals.size,
-			verdict: total.sessions ? dataStatus === "complete" ? "Detected AI referral traffic in GA4." : "Detected AI referral traffic; partial counts and breakdowns are lower bounds." : dataStatus === "complete" ? "No sessions attributed to the known AI session-source rules were detected." : "No AI-attributed sessions were found in retained GA4 data; this partial report cannot establish absence.",
+			verdict: total.sessions ? dataStatus === "complete" ? "Detected AI referral traffic in Google Analytics." : "Detected AI referral traffic; partial counts and breakdowns are lower bounds." : dataStatus === "complete" ? "No sessions attributed to the known AI session-source rules were detected." : "No AI-attributed sessions were found in retained Google Analytics data; this partial report cannot establish absence.",
 			caveat: generalCaveat
 		},
 		sources: [...sourceTotals.values()].map((source) => ({
@@ -1354,7 +1369,7 @@ function analyzeAiReferralRows(input) {
 		})).sort((left, right) => compareText$16(left.date, right.date)),
 		caveats: [
 			generalCaveat,
-			"Attribution uses GA4 sessionSource only; landing-page text, medium text, and event referrers are never treated as referral sources.",
+			"Attribution uses Google Analytics sessionSource only; landing-page text, medium text, and event referrers are never treated as referral sources.",
 			"Source totals come from a low-cardinality source query; landing-page and daily detail is queried separately for the exact observed source values.",
 			"Total users come from a separate filtered aggregate when AI sources are observed and are never summed across report rows; complete zero-session evidence implies zero users without another query.",
 			...selection.omittedRows > 0 ? [`Landing-page output returns the ${selection.returnedRows} highest-session pages from ${selection.retainedRows} retained detail rows; ${selection.omittedRows} lower-ranked pages are omitted. Increase resultLimit to inspect more.`] : [],
@@ -1456,7 +1471,7 @@ function reportRange(input) {
 	const endDate = input.endDate ?? "yesterday";
 	const absolute = validIsoDate$1(startDate) && validIsoDate$1(endDate);
 	const relative = validRelativeDate(startDate) && validRelativeDate(endDate);
-	if (!absolute && !relative) throw new SeoError("INVALID_INPUT", "startDate and endDate must both be YYYY-MM-DD dates or GA4 relative dates such as 28daysAgo and yesterday.");
+	if (!absolute && !relative) throw new SeoError("INVALID_INPUT", "startDate and endDate must both be YYYY-MM-DD dates or Google Analytics relative dates such as 28daysAgo and yesterday.");
 	if (absolute && startDate > endDate) throw new SeoError("INVALID_INPUT", "startDate must be on or before endDate.");
 	return {
 		startDate,
@@ -1515,7 +1530,7 @@ async function aiReferralsReport(input, dependencies = {}) {
 	const property = input.property.trim();
 	if (!property) throw new SeoError("INVALID_INPUT", "property is required.");
 	const range = reportRange(input);
-	const ga4Range = {
+	const googleAnalyticsDateRange = {
 		startDate: range.startDate,
 		endDate: range.endDate
 	};
@@ -1525,7 +1540,7 @@ async function aiReferralsReport(input, dependencies = {}) {
 	const sourceResult = await fetchAiReferralRows({
 		property,
 		request: {
-			dateRanges: [ga4Range],
+			dateRanges: [googleAnalyticsDateRange],
 			dimensions: [{ name: "sessionSource" }],
 			metrics: [{ name: "sessions" }, { name: "eventCount" }],
 			orderBys: [{
@@ -1550,7 +1565,7 @@ async function aiReferralsReport(input, dependencies = {}) {
 			detailResult = await fetchAiReferralRows({
 				property,
 				request: {
-					dateRanges: [ga4Range],
+					dateRanges: [googleAnalyticsDateRange],
 					dimensions: [
 						{ name: "date" },
 						{ name: "sessionSource" },
@@ -1586,7 +1601,7 @@ async function aiReferralsReport(input, dependencies = {}) {
 			usersResult = await fetchAiReferralRows({
 				property,
 				request: {
-					dateRanges: [ga4Range],
+					dateRanges: [googleAnalyticsDateRange],
 					metrics: [{ name: "totalUsers" }],
 					dimensionFilter
 				},
@@ -9414,7 +9429,7 @@ function crawlDefinitionId(input) {
 	const normalized = {
 		config: normalizeCrawlConfig(input.config),
 		site: input.site ?? null,
-		ga4PropertyId: input.ga4PropertyId ?? null
+		googleAnalyticsPropertyId: input.googleAnalyticsPropertyId ?? null
 	};
 	return `crawl_def_${createHash("sha256").update(JSON.stringify(normalized)).digest("hex").slice(0, 20)}`;
 }
@@ -9617,7 +9632,7 @@ function createCrawlReport(input) {
 	const definitionId = crawlDefinitionId({
 		config,
 		site: input.site,
-		ga4PropertyId: input.ga4PropertyId
+		googleAnalyticsPropertyId: input.googleAnalyticsPropertyId
 	});
 	const safePagesWithLinks = sortPages(sanitizePages(deriveInternalLinkAuthority(input.pages ?? [], input.linkGraph)));
 	const requests = sortRequests(sanitizeTenantValue(input.requests ?? []));
@@ -9630,7 +9645,7 @@ function createCrawlReport(input) {
 		definitionId,
 		projectId: input.projectId,
 		site: input.site,
-		ga4PropertyId: input.ga4PropertyId,
+		googleAnalyticsPropertyId: input.googleAnalyticsPropertyId,
 		generatedAt: input.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
 		status: input.status ?? "completed",
 		configHash: crawlConfigHash(config),
@@ -9668,7 +9683,7 @@ function normalizeLoadedCrawlReport(report) {
 		definitionId: report.definitionId ?? crawlDefinitionId({
 			config: report.config,
 			site: report.site,
-			ga4PropertyId: report.ga4PropertyId
+			googleAnalyticsPropertyId: report.googleAnalyticsPropertyId
 		}),
 		summary: summarizeCrawlReport({
 			pages,
@@ -10074,7 +10089,7 @@ async function joinAnalytics(input) {
 			limit: input.limit
 		});
 	} catch (error) {
-		const warning = `GA4 metrics unavailable: ${error instanceof Error ? error.message : String(error)}`;
+		const warning = `Google Analytics metrics unavailable: ${error instanceof Error ? error.message : String(error)}`;
 		input.warnings.push(warning);
 		return {
 			status: "unavailable",
@@ -10087,7 +10102,7 @@ async function joinAnalytics(input) {
 		};
 	}
 	if (analytics.warning) {
-		const warning = `GA4 metrics unavailable: ${analytics.warning}`;
+		const warning = `Google Analytics metrics unavailable: ${analytics.warning}`;
 		input.warnings.push(warning);
 		return {
 			status: "unavailable",
@@ -10112,7 +10127,7 @@ async function joinAnalytics(input) {
 	const sourceQualityKnown = analytics.source?.dataStatus !== void 0;
 	const retainedRowLimitReached = analytics.source?.retainedRowLimitReached;
 	const qualityWarnings = analytics.source?.qualityWarnings ?? [];
-	const warning = !sourceQualityKnown ? `GA4 metrics joined for ${joinedPages} of ${input.pages.length} crawled pages, but the provider did not expose row completeness; missing page metrics are not reliable zero-traffic evidence.` : retainedRowLimitReached ? `GA4 retained-row limit reached; missing page metrics are not reliable zero-traffic evidence.` : qualityWarnings.length ? `${qualityWarnings.join(" ")} Missing page metrics and relative analytics value are partial evidence.` : input.pages.length && joinedPages === 0 ? "GA4 metrics joined for 0 crawled pages." : void 0;
+	const warning = !sourceQualityKnown ? `Google Analytics metrics joined for ${joinedPages} of ${input.pages.length} crawled pages, but the provider did not expose row completeness; missing page metrics are not reliable zero-traffic evidence.` : retainedRowLimitReached ? `Google Analytics retained-row limit reached; missing page metrics are not reliable zero-traffic evidence.` : qualityWarnings.length ? `${qualityWarnings.join(" ")} Missing page metrics and relative analytics value are partial evidence.` : input.pages.length && joinedPages === 0 ? "Google Analytics metrics joined for 0 crawled pages." : void 0;
 	if (warning) input.warnings.push(warning);
 	return {
 		status: !sourceQualityKnown || analytics.source?.dataStatus === "partial" ? "partial" : joinedPages ? "joined" : "none",
@@ -10272,7 +10287,7 @@ async function crawlDataSources(input) {
 			joinedPages: 0,
 			retainedRowLimit: input.analyticsLimit,
 			retainedRowLimitReached: false,
-			warning: input.cancelled ? "GA4 join skipped because the crawl was cancelled." : "GA4 join skipped because no property was selected."
+			warning: input.cancelled ? "Google Analytics join skipped because the crawl was cancelled." : "Google Analytics join skipped because no property was selected."
 		}
 	};
 	if (!input.cancelled && input.site) dataSources.searchConsole = await joinSearchMetrics({
@@ -10288,8 +10303,8 @@ async function crawlDataSources(input) {
 		queryPagesMetricsBatch: input.queryPagesMetricsBatch,
 		queryPagesTopQueriesBatch: input.queryPagesTopQueriesBatch
 	});
-	if (!input.cancelled && input.ga4PropertyId) dataSources.analytics = await joinAnalytics({
-		propertyId: input.ga4PropertyId,
+	if (!input.cancelled && input.googleAnalyticsPropertyId) dataSources.analytics = await joinAnalytics({
+		propertyId: input.googleAnalyticsPropertyId,
 		pages: input.pages,
 		warnings: input.warnings,
 		limit: input.analyticsLimit,
@@ -11111,11 +11126,11 @@ function landingPageRankingPolicy(input) {
 	};
 	const warningSuffix = "Observed landing-page values remain visible but do not affect priority scores.";
 	const warnings = [
-		...input.warning ? [`GA4: ${input.warning}`] : [],
-		...input.source?.retainedRowLimitReached ? [`GA4: the retained-row limit was reached. ${warningSuffix}`] : [],
+		...input.warning ? [`Google Analytics: ${input.warning}`] : [],
+		...input.source?.retainedRowLimitReached ? [`Google Analytics: the retained-row limit was reached. ${warningSuffix}`] : [],
 		...input.source?.qualityWarnings?.map((warning) => `${warning} ${warningSuffix}`) ?? []
 	];
-	if (!input.source?.dataStatus && !input.warning) warnings.push(`GA4: landing-page completeness was not reported. ${warningSuffix}`);
+	if (!input.source?.dataStatus && !input.warning) warnings.push(`Google Analytics: landing-page completeness was not reported. ${warningSuffix}`);
 	return {
 		canRank: !input.warning && warnings.length === 0 && landingPageValuesCanRank(input.source),
 		warnings
@@ -11155,7 +11170,7 @@ async function fetchLandingPageValues(input, dependencies = defaultDependencies$
 		const values = landingPageValuesFromRows(rows);
 		const availableRows = result.rowCount;
 		const retainedRowLimitReached = availableRows !== void 0 && availableRows > rows.length || rows.length >= retainedRowLimit;
-		const qualityWarnings = ga4ReportQualityWarnings(result, "GA4 landing-page report");
+		const qualityWarnings = ga4ReportQualityWarnings(result, "Google Analytics landing-page report");
 		return {
 			values,
 			source: {
@@ -11909,7 +11924,7 @@ async function crawlSite(input, dependencies) {
 		const dataSources = await crawlDataSources({
 			cancelled,
 			site,
-			ga4PropertyId: input.ga4PropertyId,
+			googleAnalyticsPropertyId: input.googleAnalyticsPropertyId,
 			pages,
 			warnings,
 			searchMetricsLimit,
@@ -11964,7 +11979,7 @@ async function crawlSite(input, dependencies) {
 			config,
 			projectId: input.projectId,
 			site,
-			ga4PropertyId: input.ga4PropertyId,
+			googleAnalyticsPropertyId: input.googleAnalyticsPropertyId,
 			dataSources,
 			pages,
 			requests,
@@ -12107,7 +12122,7 @@ function searchValueForGroup(report, urls) {
 	};
 }
 function whyThisRanks(input, recommendation, searchStatus) {
-	return `${input.searchVisibleUrls ? `${input.searchVisibleUrls} affected URLs have GSC visibility (${input.clicks} clicks, ${input.impressions} impressions).` : searchStatus && !["joined", "none"].includes(searchStatus) ? `No joined GSC visibility is available for these affected URLs; Search Console evidence is ${searchStatus}.` : "No affected URL has joined GSC visibility yet."}${input.sessions ? ` GA4 adds ${input.sessions} sessions and ${input.conversions} conversions from affected landing pages.` : ""} ${recommendation === "review" ? "This is a review observation. Confirm it before scheduling implementation work." : `This ranks as a fix. Severity is ${input.severity}; ${input.affectedUrls} URL${input.affectedUrls === 1 ? " is" : "s are"} affected; estimated effort is ${input.effort}.`}`;
+	return `${input.searchVisibleUrls ? `${input.searchVisibleUrls} affected URLs have GSC visibility (${input.clicks} clicks, ${input.impressions} impressions).` : searchStatus && !["joined", "none"].includes(searchStatus) ? `No joined GSC visibility is available for these affected URLs; Search Console evidence is ${searchStatus}.` : "No affected URL has joined GSC visibility yet."}${input.sessions ? ` Google Analytics adds ${input.sessions} sessions and ${input.conversions} conversions from affected landing pages.` : ""} ${recommendation === "review" ? "This is a review observation. Confirm it before scheduling implementation work." : `This ranks as a fix. Severity is ${input.severity}; ${input.affectedUrls} URL${input.affectedUrls === 1 ? " is" : "s are"} affected; estimated effort is ${input.effort}.`}`;
 }
 function verificationCommand(report, severity) {
 	return `seo crawl ${report.config.url} --severity ${severity} --max-pages ${Math.min(report.config.maxPages, 100)}`;
@@ -12223,7 +12238,7 @@ function snapshotInput(report) {
 		generatedAt: report.generatedAt,
 		projectId: report.projectId,
 		site: report.site,
-		ga4PropertyId: report.ga4PropertyId,
+		googleAnalyticsPropertyId: report.googleAnalyticsPropertyId,
 		url: report.config.url,
 		status: report.status,
 		configHash: report.configHash,
@@ -13861,7 +13876,7 @@ const crawlReportBaseSchema = z.object({
 	definitionId: z.string(),
 	projectId: z.string().optional(),
 	site: z.string().optional(),
-	ga4PropertyId: z.string().optional(),
+	googleAnalyticsPropertyId: z.string().optional(),
 	generatedAt: z.string().datetime(),
 	status: z.enum([
 		"completed",
@@ -17727,7 +17742,7 @@ function stringMatchType(matchType) {
 	if (matchType === "equals") return "EXACT";
 	return "CONTAINS";
 }
-function ga4LandingPageFilterForChange(change, group) {
+function googleAnalyticsLandingPageFilterForChange(change, group) {
 	if (change.scope === "site") return void 0;
 	if (change.scope === "query") return void 0;
 	if (change.scope === "group") {
@@ -17750,7 +17765,7 @@ function ga4LandingPageFilterForChange(change, group) {
 		}
 	} };
 }
-function summarizeGa4Rows(rows) {
+function summarizeGoogleAnalyticsRows(rows) {
 	return rows.reduce((sum, row) => ({
 		sessions: fixed(sum.sessions + (Number(row.sessions) || 0)),
 		engagedSessions: fixed(sum.engagedSessions + (Number(row.engagedSessions) || 0)),
@@ -17817,8 +17832,8 @@ function classify(input) {
 }
 //#endregion
 //#region packages/core/dist/analyze/experiments/measurement/ga4-change-provider.js
-async function queryGa4Metrics(input) {
-	const result = await input.ga4Report(input.propertyId, {
+async function queryGoogleAnalyticsMetrics(input) {
+	const result = await input.googleAnalyticsReport(input.propertyId, {
 		dateRanges: [input.window],
 		dimensions: [{ name: "date" }],
 		metrics: [
@@ -17832,7 +17847,7 @@ async function queryGa4Metrics(input) {
 	}, { refresh: input.refresh });
 	const rows = ga4RowsToObjects(result);
 	return {
-		metrics: summarizeGa4Rows(rows),
+		metrics: summarizeGoogleAnalyticsRows(rows),
 		source: {
 			rows: rows.length,
 			rowCount: result.rowCount ?? rows.length,
@@ -17842,19 +17857,19 @@ async function queryGa4Metrics(input) {
 		warnings: ga4ReportQualityWarnings(result, input.label)
 	};
 }
-async function queryGa4ChangeWindows(input) {
-	const [before, after] = await Promise.all([queryGa4Metrics({
+async function queryGoogleAnalyticsChangeWindows(input) {
+	const [before, after] = await Promise.all([queryGoogleAnalyticsMetrics({
 		...input,
 		window: input.before,
-		label: "GA4 before window"
-	}), queryGa4Metrics({
+		label: "Google Analytics before window"
+	}), queryGoogleAnalyticsMetrics({
 		...input,
 		window: input.after,
-		label: "GA4 after window"
+		label: "Google Analytics after window"
 	})]);
 	const metadataWarnings = [];
-	if (before.source.timeZone && after.source.timeZone && before.source.timeZone !== after.source.timeZone) metadataWarnings.push("GA4 returned different property timezones across the two windows.");
-	if (before.source.currencyCode && after.source.currencyCode && before.source.currencyCode !== after.source.currencyCode) metadataWarnings.push("GA4 returned different currency codes across the two windows.");
+	if (before.source.timeZone && after.source.timeZone && before.source.timeZone !== after.source.timeZone) metadataWarnings.push("Google Analytics returned different property timezones across the two windows.");
+	if (before.source.currencyCode && after.source.currencyCode && before.source.currencyCode !== after.source.currencyCode) metadataWarnings.push("Google Analytics returned different currency codes across the two windows.");
 	return {
 		report: {
 			propertyId: input.propertyId,
@@ -17870,7 +17885,7 @@ async function queryGa4ChangeWindows(input) {
 				before: before.metrics,
 				after: after.metrics
 			}),
-			note: "GA4 attribution is landing-page based. Query-level tests use GSC only."
+			note: "Google Analytics attribution is landing-page based. Query-level tests use GSC only."
 		},
 		source: {
 			before: before.source,
@@ -18108,7 +18123,7 @@ function measurementWindow(input) {
 //#region packages/core/dist/analyze/experiments/measure-change.js
 const defaultDependencies$5 = {
 	searchAnalytics: querySearchAnalytics,
-	ga4Report: runGa4Report,
+	googleAnalyticsReport: runGa4Report,
 	contentGroup: getContentGroup,
 	now: () => /* @__PURE__ */ new Date()
 };
@@ -18194,15 +18209,15 @@ async function measureChange(input, dependencies = defaultDependencies$5) {
 		confidence: "medium",
 		note: `${classified.note} Confidence is capped because Search Console evidence is partial.`
 	} : classified;
-	const ga4Filter = ga4LandingPageFilterForChange(change, group);
+	const googleAnalyticsFilter = googleAnalyticsLandingPageFilterForChange(change, group);
 	const queryDimension = change.scope === "query" || group?.dimension === "query";
-	const analytics = input.ga4PropertyId && !queryDimension ? await queryGa4ChangeWindows({
-		propertyId: input.ga4PropertyId,
+	const analytics = input.googleAnalyticsPropertyId && !queryDimension ? await queryGoogleAnalyticsChangeWindows({
+		propertyId: input.googleAnalyticsPropertyId,
 		before,
 		after,
-		filter: ga4Filter,
+		filter: googleAnalyticsFilter,
 		refresh: input.refresh,
-		ga4Report: dependencies.ga4Report
+		googleAnalyticsReport: dependencies.googleAnalyticsReport
 	}) : void 0;
 	const warnings = [
 		...measured.warnings,
@@ -18281,7 +18296,7 @@ async function measureChange(input, dependencies = defaultDependencies$5) {
 			...window.afterWindowTruncated ? [`The requested ${window.requestedDays}-day after window is incomplete, so this run is partial and has no directional verdict.`] : [],
 			...shortWindow ? ["Fewer than 7 finalized days per window is too short for a directional verdict."] : [],
 			...measured.completeness === "retained-query-date-aggregates" ? ["Query-scoped Search Console data can omit anonymized queries; an absent retained row is not zero traffic."] : [],
-			...analytics ? [`GA4 attribution uses landing pages and the GA4 property timezone${analytics.source.before.timeZone ? ` (${analytics.source.before.timeZone})` : ""}; its day boundaries may differ from Search Console Pacific dates.`] : []
+			...analytics ? [`Google Analytics attribution uses landing pages and the Google Analytics property timezone${analytics.source.before.timeZone ? ` (${analytics.source.before.timeZone})` : ""}; its day boundaries may differ from Search Console Pacific dates.`] : []
 		]
 	};
 }
@@ -23866,7 +23881,7 @@ function reportCaveats(input) {
 		`Brand queries: ${input.includeBrand ? "included" : input.brandTerms?.length ? "excluded where saved brand terms matched" : "no saved brand terms, so no brand filter was applied"}.`,
 		`Data freshness: ${input.refresh ? "fresh fetch requested; local cache bypassed where supported" : "local cache allowed; rerun with --refresh to bypass cached GSC/HTTP data"}.`,
 		input.skipSearchData ? "Search Console: skipped because no property was selected. Run `seo start` to add performance evidence." : "Search Console: included where the selected property returned usable data.",
-		"GA4: not included in this narrative; use refresh-priorities when GA4 value should influence prioritisation.",
+		"Google Analytics: not included in this narrative; use refresh-priorities when Google Analytics value should influence prioritisation.",
 		input.skipSearchData ? "Content verification: not run because Search Console did not provide page candidates for this report." : input.verifyContent ? `Content verification: checked ${input.verified} of ${countLabel(input.quickWinCount, "quick-win candidate")}, limit ${input.verifyLimit ?? 3}.` : "Content verification: not run; recommendations are based on GSC/query data unless stated otherwise."
 	];
 }
@@ -24988,12 +25003,12 @@ async function refreshPrioritiesWorkflow(input) {
 	});
 	const range = defaultDateRange$1(input.days ?? 28);
 	const analytics = await fetchLandingPageValues({
-		propertyId: input.ga4PropertyId,
+		propertyId: input.googleAnalyticsPropertyId,
 		startDate: range.startDate,
 		endDate: range.endDate
 	});
 	const analyticsPolicy = landingPageRankingPolicy({
-		propertyId: input.ga4PropertyId,
+		propertyId: input.googleAnalyticsPropertyId,
 		source: analytics.source,
 		warning: analytics.warning
 	});
@@ -25590,7 +25605,7 @@ async function runDoctor() {
 	const grantedScopes = new Set(tokens?.scope.split(/\s+/).filter(Boolean) ?? []);
 	for (const scope of REQUIRED_SCOPES) checks.push({
 		id: `scope:${scope}`,
-		label: scope.endsWith("webmasters.readonly") ? "GSC scope" : "GA4 scope",
+		label: scope.endsWith("webmasters.readonly") ? "Search Console scope" : "Google Analytics scope",
 		status: serviceAccount.configured || tokens && grantedScopes.has(scope) ? "pass" : tokens ? "fail" : "warn",
 		detail: serviceAccount.configured ? `${scope} requested by the service account.` : tokens ? grantedScopes.has(scope) ? scope : `Missing ${scope}.` : "Cannot inspect scopes until login is complete.",
 		fix: !serviceAccount.configured && tokens && !grantedScopes.has(scope) ? "Run `seo auth logout` then `seo auth login`." : void 0
@@ -25602,10 +25617,10 @@ async function runDoctor() {
 		detail: config.defaultSite ?? "No saved default. Human CLI commands will prompt; agents can pass --site."
 	});
 	checks.push({
-		id: "default-ga4",
-		label: "Saved GA4 property",
+		id: "default-google-analytics",
+		label: "Saved Google Analytics property",
 		status: "pass",
-		detail: config.google.defaultGa4PropertyId ?? "No saved default. Human CLI commands will prompt; agents can pass --property."
+		detail: config.analytics.google.defaultPropertyId ?? "No saved default. Human CLI commands will prompt; agents can pass --property."
 	});
 	return {
 		ok: checks.every((check) => check.status !== "fail"),
@@ -25971,7 +25986,7 @@ function toolSuccess(summaryText, structuredContent, options = {}) {
 }
 //#endregion
 //#region packages/mcp/src/ai-opportunity-tools.ts
-const ga4DateSchema = z$1.union([calendarDateSchema, z$1.string().regex(/^(?:today|yesterday|\d+daysAgo)$/)]).describe("Use YYYY-MM-DD or a GA4 relative date.");
+const googleAnalyticsDateSchema = z$1.union([calendarDateSchema, z$1.string().regex(/^(?:today|yesterday|\d+daysAgo)$/)]).describe("Use YYYY-MM-DD or a Google Analytics relative date.");
 const queryOpportunitySchema = {
 	site: z$1.string().trim().min(1),
 	days: z$1.number().int().min(1).max(548).optional(),
@@ -25986,12 +26001,12 @@ const queryOpportunitySchema = {
 };
 function registerAiOpportunityTools(server, dependencies = {}) {
 	server.registerTool("seo_ai_referrals", {
-		description: "Find AI referral traffic detected in GA4. maxRows bounds retained provider rows; resultLimit bounds returned landing pages.",
+		description: "Find AI referral traffic detected in Google Analytics. maxRows bounds retained provider rows; resultLimit bounds returned landing pages.",
 		inputSchema: {
 			property: z$1.string().trim().min(1),
-			startDate: ga4DateSchema.optional(),
-			endDate: ga4DateSchema.optional(),
-			maxRows: z$1.number().int().min(1).max(1e5).describe("Maximum retained GA4 rows. If limit is also supplied, both values must match.").optional(),
+			startDate: googleAnalyticsDateSchema.optional(),
+			endDate: googleAnalyticsDateSchema.optional(),
+			maxRows: z$1.number().int().min(1).max(1e5).describe("Maximum retained Google Analytics rows. If limit is also supplied, both values must match.").optional(),
 			limit: z$1.number().int().min(1).max(1e5).describe("Legacy alias for maxRows. If maxRows is also supplied, both values must match.").optional(),
 			resultLimit: z$1.number().int().min(1).max(1e3).describe("Maximum ranked landing pages returned. Defaults to 25.").optional(),
 			refresh: z$1.boolean().optional()
@@ -26209,7 +26224,7 @@ function registerCrawlerTools(server) {
 		inputSchema: {
 			url: z$1.string().url(),
 			site: z$1.string().optional(),
-			ga4PropertyId: z$1.string().optional(),
+			googleAnalyticsPropertyId: z$1.string().optional(),
 			maxPages: z$1.number().int().positive().optional(),
 			maxDepth: z$1.number().int().nonnegative().optional(),
 			concurrency: z$1.number().int().positive().optional(),
@@ -26225,12 +26240,12 @@ function registerCrawlerTools(server) {
 			includeIssues: z$1.boolean().optional(),
 			saveReport: z$1.boolean().optional()
 		}
-	}, async ({ url, site, ga4PropertyId, maxPages, maxDepth, concurrency, fetchIntervalCap, fetchIntervalMs, refresh, include, exclude, useSitemap, respectRobots, js, includePages, includeIssues, saveReport }) => {
+	}, async ({ url, site, googleAnalyticsPropertyId, maxPages, maxDepth, concurrency, fetchIntervalCap, fetchIntervalMs, refresh, include, exclude, useSitemap, respectRobots, js, includePages, includeIssues, saveReport }) => {
 		try {
 			const report = await crawlSite({
 				url,
 				site,
-				ga4PropertyId,
+				googleAnalyticsPropertyId,
 				maxPages,
 				maxDepth,
 				concurrency,
@@ -26263,7 +26278,7 @@ function registerCrawlerTools(server) {
 		inputSchema: {
 			urls: z$1.array(z$1.string().url()).min(1),
 			site: z$1.string().optional(),
-			ga4PropertyId: z$1.string().optional(),
+			googleAnalyticsPropertyId: z$1.string().optional(),
 			maxPages: z$1.number().int().positive().optional(),
 			concurrency: z$1.number().int().positive().optional(),
 			fetchIntervalCap: z$1.number().int().positive().optional(),
@@ -26273,14 +26288,14 @@ function registerCrawlerTools(server) {
 			includeIssues: z$1.boolean().optional(),
 			saveReport: z$1.boolean().optional()
 		}
-	}, async ({ urls, site, ga4PropertyId, maxPages, concurrency, fetchIntervalCap, fetchIntervalMs, refresh, includePages, includeIssues, saveReport }) => {
+	}, async ({ urls, site, googleAnalyticsPropertyId, maxPages, concurrency, fetchIntervalCap, fetchIntervalMs, refresh, includePages, includeIssues, saveReport }) => {
 		try {
 			const report = await crawlSite({
 				url: urls[0] ?? "",
 				urls,
 				mode: "list",
 				site,
-				ga4PropertyId,
+				googleAnalyticsPropertyId,
 				maxPages: maxPages ?? urls.length,
 				concurrency,
 				refresh,
@@ -27048,7 +27063,7 @@ function registerExperimentTools(server) {
 		}
 	});
 	server.registerTool("seo_measure_change", {
-		description: "Measure a saved or ad hoc SEO change with equal finalized GSC windows and optional GA4/control evidence",
+		description: "Measure a saved or ad hoc SEO change with equal finalized GSC windows and optional Google Analytics/control evidence",
 		inputSchema: {
 			id: z$1.string().min(1).optional(),
 			site: z$1.string().min(1).optional(),
@@ -27061,7 +27076,7 @@ function registerExperimentTools(server) {
 			target: z$1.string().min(1).optional(),
 			title: z$1.string().min(1).optional(),
 			changedAt: calendarDateSchema.optional(),
-			ga4PropertyId: z$1.string().min(1).optional(),
+			googleAnalyticsPropertyId: z$1.string().min(1).optional(),
 			controlScope: z$1.enum([
 				"site",
 				"page",
@@ -27074,7 +27089,7 @@ function registerExperimentTools(server) {
 			afterDays: z$1.number().int().min(1).max(548).optional(),
 			refresh: z$1.boolean().optional()
 		}
-	}, async ({ id, site, scope, target, title, changedAt, ga4PropertyId, controlScope, controlTarget, controlTitle, beforeDays, afterDays, refresh }) => {
+	}, async ({ id, site, scope, target, title, changedAt, googleAnalyticsPropertyId, controlScope, controlTarget, controlTitle, beforeDays, afterDays, refresh }) => {
 		try {
 			const result = await measureChange({
 				id,
@@ -27083,7 +27098,7 @@ function registerExperimentTools(server) {
 				target,
 				title,
 				changedAt,
-				ga4PropertyId,
+				googleAnalyticsPropertyId,
 				controlScope,
 				controlTarget,
 				controlTitle,
@@ -27737,7 +27752,7 @@ const REPORT_DEPTH = {
 			"Referral sessions did not necessarily cause conversions and are not all AI traffic.",
 			"totalUsers is not additive and must not be reconstructed by summing rows."
 		],
-		verify: "Compare complete like-for-like GA4 periods and check whether high-session landing pages answer the referring context.",
+		verify: "Compare complete like-for-like Google Analytics periods and check whether high-session landing pages answer the referring context.",
 		related: [{
 			id: "seo-to-ai-query",
 			reason: "Builds monitoring prompts."
@@ -27892,7 +27907,7 @@ const REPORT_DEPTH = {
 		],
 		doNotClaim: [
 			"An absent page from a capped, skipped, failed, or differently scoped crawl is not proven removed.",
-			"Source row caps limit joined GSC or GA4 evidence even when the document crawl completed.",
+			"Source row caps limit joined GSC or Google Analytics evidence even when the document crawl completed.",
 			"A change between snapshots is not proof the release caused it."
 		],
 		verify: "Re-run the same definition and request scope after deployment and confirm the delta.",
@@ -28398,7 +28413,7 @@ const REPORT_DEPTH = {
 			"dataStatus, window, source, warnings, and caveats",
 			"window.effectiveDays versus requestedDays and afterWindowTruncated",
 			"GSC before and after metrics",
-			"GA4 source.analytics.status and timezone and any control adjusted deltas"
+			"Google Analytics source.analytics.status and timezone and any control adjusted deltas"
 		],
 		doNotClaim: [
 			"Timing does not prove the recorded change caused the movement.",
@@ -28716,8 +28731,8 @@ const REPORT_DEPTH = {
 			"the top few URLs manually"
 		],
 		doNotClaim: [
-			"A click decline, low CTR, second-page position, and GA4 session signal have different semantics and are not interchangeable.",
-			"Missing GA4 or failed fetches stay unavailable, not zero-weight proof.",
+			"A click decline, low CTR, second-page position, and Google Analytics session signal have different semantics and are not interchangeable.",
+			"Missing Google Analytics or failed fetches stay unavailable, not zero-weight proof.",
 			"The score is not expected clicks, revenue, ranking lift, or causal confidence."
 		],
 		verify: "Confirm query intent, current content, and internal links for the top URLs before choosing a bounded edit.",
@@ -28835,7 +28850,7 @@ const REPORT_DEPTH = {
 		related: [
 			{
 				id: "ai-referrals",
-				reason: "Adds GA4 referral evidence."
+				reason: "Adds Google Analytics referral evidence."
 			},
 			{
 				id: "community-intent",
@@ -29082,9 +29097,9 @@ const REPORT_GUIDANCE = {
 	},
 	"ai-referrals": {
 		name: "AI referral traffic",
-		description: "Find visits from known AI products in GA4 and see a ranked, bounded set of landing pages that received them.",
-		useWhen: ["You want measured AI referral traffic from GA4.", "You need the landing pages and sources behind those visits."],
-		avoidWhen: ["GA4 is not connected or does not track the site.", "You want to measure citations or unclicked mentions inside AI answers."],
+		description: "Find visits from known AI products in Google Analytics and see a ranked, bounded set of landing pages that received them.",
+		useWhen: ["You want measured AI referral traffic from Google Analytics.", "You need the landing pages and sources behind those visits."],
+		avoidWhen: ["Google Analytics is not connected or does not track the site.", "You want to measure citations or unclicked mentions inside AI answers."],
 		outcome: "A source and landing-page breakdown of identifiable AI referrals."
 	},
 	"ai-search-scorecard": {
@@ -29763,9 +29778,9 @@ function registerWorkflowTools(server) {
 				"verifyLimit",
 				"refresh"
 			]),
-			ga4PropertyId: z$1.string().optional()
+			googleAnalyticsPropertyId: z$1.string().optional()
 		}
-	}, async ({ site, days, recentDays, limit, includeBrand, ga4PropertyId, verifyContent, verifyLimit, refresh }) => {
+	}, async ({ site, days, recentDays, limit, includeBrand, googleAnalyticsPropertyId, verifyContent, verifyLimit, refresh }) => {
 		try {
 			return workflowSuccess(await refreshPrioritiesWorkflow({
 				site,
@@ -29773,7 +29788,7 @@ function registerWorkflowTools(server) {
 				recentDays,
 				limit,
 				includeBrand,
-				ga4PropertyId,
+				googleAnalyticsPropertyId,
 				verifyContent,
 				verifyLimit,
 				refresh