seo 0.2.4 → 0.2.6

package/dist/mcp.js

@@ -1,8 +1,8 @@
 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-B9-D646K.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";
+import { arch, homedir, platform } from "node:os";
 import { dirname, join } from "node:path";
 import { z } from "zod";
 import lockfile from "proper-lockfile";
@@ -149,6 +149,7 @@ function resolveSeoCliPaths(input = {}) {
 		configFile: join(configDir, "config.json"),
 		tokensFile: join(configDir, "tokens.json"),
 		oauthClientFile: join(configDir, "oauth-client.json"),
+		telemetryStateFile: join(configDir, "telemetry.json"),
 		cacheDbFile: join(cacheDir, "cache.db")
 	};
 }
@@ -218,6 +219,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 +227,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 +238,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 +462,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 +667,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 +731,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 +1084,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 +1107,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 +1213,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 +1256,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 +1289,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 +1325,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 +1348,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 +1370,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 +1472,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 +1531,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 +1541,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 +1566,7 @@ async function aiReferralsReport(input, dependencies = {}) {
 			detailResult = await fetchAiReferralRows({
 				property,
 				request: {
-					dateRanges: [ga4Range],
+					dateRanges: [googleAnalyticsDateRange],
 					dimensions: [
 						{ name: "date" },
 						{ name: "sessionSource" },
@@ -1586,7 +1602,7 @@ async function aiReferralsReport(input, dependencies = {}) {
 			usersResult = await fetchAiReferralRows({
 				property,
 				request: {
-					dateRanges: [ga4Range],
+					dateRanges: [googleAnalyticsDateRange],
 					metrics: [{ name: "totalUsers" }],
 					dimensionFilter
 				},
@@ -9414,7 +9430,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 +9633,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 +9646,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 +9684,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 +10090,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 +10103,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 +10128,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 +10288,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 +10304,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 +11127,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 +11171,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 +11925,7 @@ async function crawlSite(input, dependencies) {
 		const dataSources = await crawlDataSources({
 			cancelled,
 			site,
-			ga4PropertyId: input.ga4PropertyId,
+			googleAnalyticsPropertyId: input.googleAnalyticsPropertyId,
 			pages,
 			warnings,
 			searchMetricsLimit,
@@ -11964,7 +11980,7 @@ async function crawlSite(input, dependencies) {
 			config,
 			projectId: input.projectId,
 			site,
-			ga4PropertyId: input.ga4PropertyId,
+			googleAnalyticsPropertyId: input.googleAnalyticsPropertyId,
 			dataSources,
 			pages,
 			requests,
@@ -12107,7 +12123,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 +12239,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 +13877,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 +17743,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 +17766,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 +17833,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 +17848,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 +17858,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 +17886,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 +18124,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 +18210,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 +18297,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 +23882,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 +25004,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 +25606,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 +25618,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"),
@@ -25867,6 +25883,317 @@ new LocalCredentialsProvider();
 //#endregion
 //#region packages/core/dist/version.js
 const SEO_VERSION = version;
+const TELEMETRY_TIMEOUT_MS = 2e3;
+const TELEMETRY_REPORTS = [
+	"affected-urls",
+	"agent-readiness",
+	"ai-readiness",
+	"ai-referrals",
+	"ai-search-scorecard",
+	"audit-page",
+	"audit-urls",
+	"cannibalisation",
+	"community-intent",
+	"compare-crawls",
+	"content-optimization",
+	"crawl-diff",
+	"site-crawl",
+	"ctr-underperformers",
+	"decaying-pages",
+	"setup-check",
+	"entity-readiness",
+	"explain-crawl-issue",
+	"geo-gaps",
+	"crawl-report",
+	"index-coverage",
+	"index-coverage-plan",
+	"index-monitor",
+	"index-watch",
+	"internal-links",
+	"link-recovery",
+	"crawl-history",
+	"crawler-rules",
+	"llms-txt-audit",
+	"generate-llms-txt",
+	"measure-change",
+	"monthly-report",
+	"okf-build",
+	"okf-validate",
+	"page-opportunities",
+	"performance-audit",
+	"pseo-audit",
+	"query-clusters",
+	"quick-wins",
+	"redirect-trace",
+	"narrative-report",
+	"second-page",
+	"segment-impact",
+	"striking-distance",
+	"seo-to-ai-query",
+	"top-fixes",
+	"traffic-anomaly",
+	"update-correlation",
+	"search-performance-overview",
+	"monthly-action-plan",
+	"refresh-priorities",
+	"technical-watch",
+	"update-postmortem"
+];
+const RETENTION_MILESTONES = [
+	{
+		days: 1,
+		event: "active_d1"
+	},
+	{
+		days: 7,
+		event: "active_d7"
+	},
+	{
+		days: 30,
+		event: "active_d30"
+	}
+];
+const CI_ENVIRONMENT_KEYS = [
+	"GITHUB_ACTIONS",
+	"GITLAB_CI",
+	"CIRCLECI",
+	"TRAVIS",
+	"BUILDKITE",
+	"JENKINS_URL",
+	"TEAMCITY_VERSION",
+	"TF_BUILD",
+	"BITBUCKET_BUILD_NUMBER",
+	"CODEBUILD_BUILD_ID"
+];
+const TELEMETRY_NOTICE = `SEO Skill collects anonymous usage data to improve the tool (event name,
+report id, version, agent, OS, architecture, Node major, and install week;
+never URLs, report data, or identifiers of any kind).
+Docs: https://seoskill.dev/telemetry
+Disable: seo telemetry disable (or set DO_NOT_TRACK=1)\n`;
+function optionEnv(options) {
+	return options.env ?? process.env;
+}
+function optionNow(options) {
+	return options.now ?? /* @__PURE__ */ new Date();
+}
+function optionStateFile(options) {
+	return options.stateFile ?? getSeoCliPaths().telemetryStateFile;
+}
+function isEnvEnabled(value) {
+	return value === "1" || value?.toLowerCase() === "true";
+}
+function isTelemetryCi(env = process.env) {
+	return env.NODE_ENV === "test" || Boolean(env.NODE_TEST_CONTEXT) || isEnvEnabled(env.CI) || CI_ENVIRONMENT_KEYS.some((key) => Boolean(env[key]));
+}
+function environmentDisableReason(env) {
+	if (isTelemetryCi(env)) return "ci";
+	if (isEnvEnabled(env.DO_NOT_TRACK)) return "do_not_track";
+	if (isEnvEnabled(env.SEOSKILL_TELEMETRY_DISABLED) || isEnvEnabled(env.SEO_TELEMETRY_DISABLED)) return "environment";
+}
+function isTelemetryMilestone(value) {
+	return typeof value === "string" && [
+		"first_run",
+		"setup_complete",
+		"first_audit_complete",
+		"active_d1",
+		"active_d7",
+		"active_d30"
+	].includes(value);
+}
+function isTelemetryReport(value) {
+	return typeof value === "string" && TELEMETRY_REPORTS.includes(value);
+}
+function isValidCohort(value) {
+	return typeof value === "string" && /^\d{4}-W(?:0[1-9]|[1-4]\d|5[0-3])$/.test(value);
+}
+function isTelemetryState(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const state = value;
+	return typeof state.telemetryEnabled === "boolean" && typeof state.firstRunAt === "string" && Number.isFinite(Date.parse(state.firstRunAt)) && isValidCohort(state.cohort) && Array.isArray(state.sentMilestones) && state.sentMilestones.every(isTelemetryMilestone);
+}
+function readState(path) {
+	if (!existsSync(path)) return { kind: "missing" };
+	const value = readJsonFile(path);
+	return isTelemetryState(value) ? {
+		kind: "valid",
+		state: value
+	} : { kind: "invalid" };
+}
+function writeState(path, state) {
+	writeJsonAtomic(path, state, 384);
+}
+function isoWeek(date) {
+	const utc = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));
+	const day = utc.getUTCDay() || 7;
+	utc.setUTCDate(utc.getUTCDate() + 4 - day);
+	const yearStart = new Date(Date.UTC(utc.getUTCFullYear(), 0, 1));
+	const week = Math.ceil(((utc.getTime() - yearStart.getTime()) / 864e5 + 1) / 7);
+	return `${utc.getUTCFullYear()}-W${String(week).padStart(2, "0")}`;
+}
+function newState(options, enabled = true) {
+	const now = optionNow(options);
+	return {
+		telemetryEnabled: enabled,
+		firstRunAt: now.toISOString(),
+		cohort: isoWeek(now),
+		sentMilestones: []
+	};
+}
+function detectTelemetryAgent(input = {}) {
+	const env = input.env ?? process.env;
+	const clientName = input.clientName?.toLowerCase() ?? "";
+	if (clientName.includes("claude")) return "claude-code";
+	if (clientName.includes("cursor")) return "cursor";
+	if (clientName.includes("codex")) return "codex";
+	if (input.clientName) return "unknown";
+	if (env.CLAUDECODE || env.CLAUDE_CODE) return "claude-code";
+	if (env.CURSOR_AGENT || env.CURSOR_TRACE_ID || env.CURSOR_SESSION_ID) return "cursor";
+	if (env.CODEX_HOME || env.CODEX_THREAD_ID || env.CODEX_SANDBOX) return "codex";
+	return "cli";
+}
+function telemetryAgent(options) {
+	return options.agent ?? detectTelemetryAgent({
+		clientName: options.clientName,
+		env: optionEnv(options)
+	});
+}
+function nodeMajor(version) {
+	return version.replace(/^v/, "").split(".")[0] || "unknown";
+}
+function buildTelemetryPayload(event, state, fields = {}, options = {}) {
+	return {
+		event,
+		version: options.version ?? SEO_VERSION,
+		agent: telemetryAgent(options),
+		os: options.processPlatform ?? platform(),
+		arch: options.processArch ?? arch(),
+		node: nodeMajor(options.nodeVersion ?? process.version),
+		cohort: state.cohort,
+		schema: 1,
+		...fields.errorCategory ? { errorCategory: fields.errorCategory } : {},
+		...fields.report ? { report: fields.report } : {}
+	};
+}
+function dispatchTelemetry(payload, options) {
+	const fetchTelemetry = options.fetch ?? globalThis.fetch;
+	try {
+		fetchTelemetry(options.endpoint ?? "https://seoskill.dev/api/t", {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify(payload),
+			signal: AbortSignal.timeout(TELEMETRY_TIMEOUT_MS)
+		}).catch(() => void 0);
+	} catch {}
+}
+function statusFromState(options) {
+	const stateFile = optionStateFile(options);
+	const envReason = environmentDisableReason(optionEnv(options));
+	const stored = readState(stateFile);
+	if (envReason) return {
+		enabled: false,
+		reason: envReason,
+		stateFile,
+		...stored.kind === "valid" ? { state: stored.state } : {}
+	};
+	if (stored.kind === "invalid") return {
+		enabled: false,
+		reason: "invalid_state",
+		stateFile
+	};
+	if (stored.kind === "valid" && !stored.state.telemetryEnabled) return {
+		enabled: false,
+		reason: "local_setting",
+		stateFile,
+		state: stored.state
+	};
+	return {
+		enabled: true,
+		stateFile,
+		...stored.kind === "valid" ? { state: stored.state } : {}
+	};
+}
+function enabledState(options) {
+	const status = statusFromState(options);
+	return status.enabled ? status.state : void 0;
+}
+function initializeTelemetry(options = {}) {
+	const initialStatus = statusFromState(options);
+	if (!initialStatus.enabled) return initialStatus;
+	const stateFile = initialStatus.stateFile;
+	const state = initialStatus.state ?? newState(options);
+	const events = [];
+	if (!state.sentMilestones.includes("first_run")) {
+		try {
+			(options.notice ?? ((message) => process.stderr.write(message)))(TELEMETRY_NOTICE);
+		} catch {
+			return {
+				enabled: false,
+				reason: "invalid_state",
+				stateFile
+			};
+		}
+		state.sentMilestones.push("first_run");
+		events.push("first_run");
+	}
+	const daysSinceFirstRun = (optionNow(options).getTime() - Date.parse(state.firstRunAt)) / 864e5;
+	for (const milestone of RETENTION_MILESTONES) if (daysSinceFirstRun >= milestone.days && !state.sentMilestones.includes(milestone.event)) {
+		state.sentMilestones.push(milestone.event);
+		events.push(milestone.event);
+	}
+	try {
+		writeState(stateFile, state);
+	} catch {
+		return {
+			enabled: false,
+			reason: "invalid_state",
+			stateFile
+		};
+	}
+	for (const event of events) dispatchTelemetry(buildTelemetryPayload(event, state, {}, options), options);
+	return {
+		enabled: true,
+		stateFile,
+		state
+	};
+}
+function sendEvent(event, fields, options) {
+	const state = enabledState(options);
+	if (!state) return;
+	dispatchTelemetry(buildTelemetryPayload(event, state, fields, options), options);
+}
+function trackTelemetryReportStart(report, options = {}) {
+	if (!isTelemetryReport(report)) return;
+	sendEvent("audit_start", { report }, options);
+}
+function trackTelemetryReportComplete(report, options = {}) {
+	if (!isTelemetryReport(report)) return;
+	const state = enabledState(options);
+	if (!state) return;
+	dispatchTelemetry(buildTelemetryPayload("audit_complete", state, { report }, options), options);
+	if (state.sentMilestones.includes("first_audit_complete")) return;
+	state.sentMilestones.push("first_audit_complete");
+	try {
+		writeState(optionStateFile(options), state);
+	} catch {
+		return;
+	}
+	dispatchTelemetry(buildTelemetryPayload("first_audit_complete", state, { report }, options), options);
+}
+function trackTelemetryReportFailed(report, errorCategory, options = {}) {
+	if (!isTelemetryReport(report)) return;
+	sendEvent("audit_failed", {
+		errorCategory,
+		report
+	}, options);
+}
+function telemetryErrorCategory(error) {
+	if (error instanceof Error && error.name === "AbortError") return "crawl_timeout";
+	const code = error && typeof error === "object" && "code" in error ? String(error.code) : void 0;
+	if (code === "ACCESS_DENIED" || code === "AUTH_CONFIG_REQUIRED" || code === "AUTH_EXPIRED" || code === "AUTH_REQUIRED") return "auth";
+	if (code === "INVALID_INPUT" || code === "PROPERTY_NOT_FOUND") return "config";
+	if (code === "OPTIONAL_PROVIDER_UNAVAILABLE" || code === "PROVIDER_UNAVAILABLE" || code === "RATE_LIMITED") return "network";
+	return "unknown";
+}
 //#endregion
 //#region packages/mcp/src/input-schemas.ts
 const calendarDateSchema = z$1.iso.date("Use a YYYY-MM-DD date.");
@@ -25971,7 +26298,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 +26313,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 +26536,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 +26552,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 +26590,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 +26600,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 +27375,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 +27388,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 +27401,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 +27410,7 @@ function registerExperimentTools(server) {
 				target,
 				title,
 				changedAt,
-				ga4PropertyId,
+				googleAnalyticsPropertyId,
 				controlScope,
 				controlTarget,
 				controlTitle,
@@ -27737,7 +28064,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 +28219,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 +28725,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 +29043,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 +29162,7 @@ const REPORT_DEPTH = {
 		related: [
 			{
 				id: "ai-referrals",
-				reason: "Adds GA4 referral evidence."
+				reason: "Adds Google Analytics referral evidence."
 			},
 			{
 				id: "community-intent",
@@ -29082,9 +29409,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 +30090,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 +30100,7 @@ function registerWorkflowTools(server) {
 				recentDays,
 				limit,
 				includeBrand,
-				ga4PropertyId,
+				googleAnalyticsPropertyId,
 				verifyContent,
 				verifyLimit,
 				refresh
@@ -30038,7 +30365,8 @@ async function runReport(id, params = {}) {
 //#endregion
 //#region packages/mcp/src/discovery-tools.ts
 const openOutputSchema = z$1.looseObject({});
-function registerDiscoveryTools(server) {
+const reportIds = new Set(listReports().map((report) => report.id));
+function registerDiscoveryTools(server, options = {}) {
 	server.registerTool("seo_list_reports", {
 		description: "List compact SEO report ids, names, and purposes, optionally by category",
 		inputSchema: { category: z$1.enum(REPORT_CATEGORIES).optional() },
@@ -30082,17 +30410,31 @@ function registerDiscoveryTools(server) {
 		outputSchema: openOutputSchema,
 		annotations: { destructiveHint: false }
 	}, async ({ id, params }) => {
-		return runReport(id, params);
+		const telemetry = reportIds.has(id) ? options.telemetry?.() : void 0;
+		if (telemetry) trackTelemetryReportStart(id, telemetry);
+		try {
+			const result = await runReport(id, params);
+			if (telemetry) if (result.isError) trackTelemetryReportFailed(id, telemetryErrorCategory(result.structuredContent?.error), telemetry);
+			else trackTelemetryReportComplete(id, telemetry);
+			return result;
+		} catch (error) {
+			if (telemetry) trackTelemetryReportFailed(id, telemetryErrorCategory(error), telemetry);
+			throw error;
+		}
 	});
 }
 //#endregion
 //#region packages/mcp/src/index.ts
-function createServer() {
+function createServer(options = {}) {
 	const server = new McpServer({
 		name: "seo",
 		version: SEO_VERSION
 	}, { capabilities: { logging: {} } });
-	registerDiscoveryTools(server);
+	const telemetryOptions = () => ({ clientName: server.server.getClientVersion()?.name });
+	registerDiscoveryTools(server, { telemetry: options.telemetry === false ? void 0 : telemetryOptions });
+	if (options.telemetry !== false) server.server.oninitialized = () => {
+		initializeTelemetry(telemetryOptions());
+	};
 	return server;
 }
 async function startMcpServer(opts = {}) {