seo 0.2.4 → 0.2.6

package/dist/index.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, createWriteStream, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, 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";
@@ -146,6 +146,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")
 	};
 }
@@ -222,6 +223,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(),
@@ -229,7 +231,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(),
@@ -240,14 +242,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(),
@@ -492,6 +494,12 @@ function getPrivacySnapshot() {
 			mode: fileMode(paths.oauthClientFile),
 			sizeBytes: sizeOf(paths.oauthClientFile)
 		},
+		{
+			label: "Telemetry state",
+			path: paths.telemetryStateFile,
+			mode: fileMode(paths.telemetryStateFile),
+			sizeBytes: sizeOf(paths.telemetryStateFile)
+		},
 		{
 			label: "Cache DB",
 			path: paths.cacheDbFile,
@@ -566,6 +574,14 @@ function missingOAuthClientMessage(source) {
 //#endregion
 //#region packages/core/src/gsc/auth/types.ts
 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));
+}
 const GOOGLE_SCOPE = [
 	...GOOGLE_READONLY_SCOPES,
 	"openid",
@@ -763,6 +779,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;
 }
@@ -822,6 +843,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),
@@ -879,176 +901,36 @@ async function authStatus() {
 }
 //#endregion
 //#region packages/core/src/gsc/auth/callback-page.ts
-function oauthCallbackPage() {
+function callbackCopy(options) {
+	if (options.status === "connected") return {
+		title: "Google account connected",
+		heading: "Google account connected.",
+		detail: "This tab can be closed."
+	};
+	if (options.status === "permissions-missing") return {
+		title: "Google permissions not granted",
+		heading: "Google permissions were not granted.",
+		detail: `Return to your terminal and run seo auth login again. Select all permission boxes for ${options.missing.join(" and ")}.`
+	};
+	return {
+		title: "Google connection failed",
+		heading: "Google connection failed.",
+		detail: "Return to your terminal for the error and try again."
+	};
+}
+function oauthCallbackPage(options = { status: "connected" }) {
+	const copy = callbackCopy(options);
 	return `<!doctype html>
 <html lang="en">
   <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
-    <meta name="color-scheme" content="light dark">
-    <meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'unsafe-inline'">
-    <title>seo is connected</title>
-    <style>
-      :root {
-        color-scheme: light dark;
-        --background: #fafafa;
-        --background-raised: #ffffff;
-        --foreground: #343434;
-        --foreground-muted: #737373;
-        --border: #eaeaea;
-        --primary: #2589b6;
-        --primary-soft: #e9f6fb;
-      }
-      * { box-sizing: border-box; }
-      body {
-        background: var(--background);
-        color: var(--foreground);
-        font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
-        margin: 0;
-        min-height: 100vh;
-      }
-      .frame {
-        margin: 0 auto;
-        max-width: 768px;
-        padding: 0 24px;
-        width: 100%;
-      }
-      header { border-bottom: 1px solid var(--border); }
-      .nav {
-        align-items: center;
-        display: flex;
-        gap: 8px;
-        min-height: 65px;
-      }
-      .brand {
-        align-items: center;
-        color: inherit;
-        display: inline-flex;
-        font-size: 16px;
-        font-weight: 700;
-        gap: 6px;
-        letter-spacing: -0.02em;
-        text-decoration: none;
-      }
-      .brand svg { height: 20px; width: 20px; }
-      main { min-height: calc(100vh - 65px); }
-      .hero {
-        border-bottom: 1px solid var(--border);
-        padding: clamp(72px, 15vw, 144px) 0;
-      }
-      .content { max-width: 620px; }
-      .status {
-        align-items: center;
-        color: var(--primary);
-        display: flex;
-        font-size: 15px;
-        font-weight: 650;
-        gap: 8px;
-        margin: 0 0 18px;
-      }
-      .status-mark {
-        background: var(--primary);
-        border-radius: 50%;
-        height: 8px;
-        width: 8px;
-      }
-      h1 {
-        font-size: clamp(38px, 7vw, 58px);
-        font-weight: 550;
-        letter-spacing: -0.055em;
-        line-height: 0.98;
-        margin: 0;
-        text-wrap: balance;
-      }
-      .lead {
-        color: var(--foreground-muted);
-        font-size: clamp(20px, 3vw, 24px);
-        font-weight: 500;
-        letter-spacing: -0.02em;
-        line-height: 1.35;
-        margin: 24px 0 0;
-        max-width: 600px;
-      }
-      code {
-        background: var(--background-raised);
-        border: 1px solid var(--border);
-        color: var(--foreground);
-        display: inline-block;
-        font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
-        font-size: 0.84em;
-        letter-spacing: -0.02em;
-        padding: 3px 7px;
-      }
-      .details {
-        display: grid;
-        gap: 16px;
-        grid-template-columns: repeat(2, minmax(0, 1fr));
-        padding: 36px 0 48px;
-      }
-      .detail {
-        border-left: 1px solid var(--border);
-        padding-left: 16px;
-      }
-      .detail h2 {
-        font-size: 15px;
-        font-weight: 650;
-        letter-spacing: -0.01em;
-        margin: 0;
-      }
-      .detail p {
-        color: var(--foreground-muted);
-        font-size: 15px;
-        line-height: 1.5;
-        margin: 6px 0 0;
-      }
-      @media (prefers-color-scheme: dark) {
-        :root {
-          --background: #343434;
-          --background-raised: #3d3d3d;
-          --foreground: #fafafa;
-          --foreground-muted: #b8b8b8;
-          --border: #484848;
-          --primary: #8ed2ef;
-          --primary-soft: #16485f;
-        }
-      }
-      @media (max-width: 560px) {
-        .frame { padding: 0 20px; }
-        .hero { padding: 72px 0; }
-        .details { grid-template-columns: 1fr; }
-      }
-    </style>
+    <meta http-equiv="Content-Security-Policy" content="default-src 'none'">
+    <title>${copy.title}</title>
   </head>
   <body>
-    <header>
-      <div class="frame nav">
-        <span class="brand">
-          <svg viewBox="0 0 24 24" aria-hidden="true">
-            <path fill="currentColor" d="M12,8c-2.2,0-4,1.8-4,4s1.8,4,4,4s4-1.8,4-4C16,9.8,14.2,8,12,8z M3,9L3,9c0.6,0,1-0.4,1-1V5c0-0.6,0.4-1,1-1h3 c0.6,0,1-0.4,1-1S8.6,2,8,2H5C3.3,2,2,3.3,2,5v3C2,8.6,2.4,9,3,9z M8,20H5c-0.6,0-1-0.4-1-1v-3c0-0.6-0.4-1-1-1s-1,0.4-1,1v3 c0,1.7,1.3,3,3,3h3c0.6,0,1-0.4,1-1S8.6,20,8,20z M21,15L21,15c-0.6,0-1,0.4-1,1v3c0,0.6-0.4,1-1,1h-3c-0.6,0-1,0.4-1,1s0.4,1,1,1h3 c1.7,0,3-1.3,3-3v-3C22,15.4,21.6,15,21,15z M19,2h-3c-0.6,0-1,0.4-1,1s0.4,1,1,1h3c0.6,0,1,0.4,1,1v3c0,0.6,0.4,1,1,1s1-0.4,1-1V5 C22,3.3,20.7,2,19,2z" />
-          </svg>
-          seo
-        </span>
-      </div>
-    </header>
-    <main>
-      <section class="hero">
-        <div class="frame content">
-          <p class="status"><span class="status-mark" aria-hidden="true"></span>Google account connected</p>
-          <h1>You can start your first SEO report.</h1>
-          <p class="lead">Go back to your terminal to continue, and the CLI will help you choose a site and save a project profile before future reports.</p>
-        </div>
-      </section>
-      <div class="frame details">
-        <section class="detail">
-          <h2>Safe to close</h2>
-          <p>This tab has done its job. The CLI is waiting for you in the terminal.</p>
-        </section>
-        <section class="detail">
-          <h2>Read-only access</h2>
-          <p>The seo CLI can read the Google data you choose. It cannot change your site or Google account.</p>
-        </section>
-      </div>
-    </main>
+    <p>${copy.heading}</p>
+    <p>${copy.detail}</p>
   </body>
 </html>`;
 }
@@ -1100,31 +982,50 @@ async function loginWithLoopback(clientConfig = getClientConfig()) {
 		code_challenge_method: "S256"
 	}).toString();
 	await open(authUrl.toString());
-	const tokenJson = await exchangeCode({
-		clientConfig,
-		code: await waitForCode({
+	let callback;
+	try {
+		callback = await waitForCode({
 			server,
 			redirectUri,
 			state
-		}).finally(() => server.close()),
-		redirectUri,
-		verifier
-	});
-	const accountEmail = decodeJwtEmail(tokenJson.id_token) ?? await fetchUserEmail(tokenJson.access_token);
-	if (!accountEmail) throw new Error("Google login succeeded but account email could not be determined.");
-	const tokens = {
-		provider: "google",
-		account_email: accountEmail,
-		scope: tokenJson.scope,
-		token_type: tokenJson.token_type,
-		access_token: tokenJson.access_token,
-		refresh_token: tokenJson.refresh_token,
-		expires_at: Date.now() + tokenJson.expires_in * 1e3,
-		obtained_at: Date.now(),
-		client_source: clientConfig.source
-	};
-	await writeTokens(tokens);
-	return tokens;
+		});
+		const tokenJson = await exchangeCode({
+			clientConfig,
+			code: callback.code,
+			redirectUri,
+			verifier
+		});
+		const missingScopes = missingGoogleReadonlyScopes(tokenJson.scope);
+		if (missingScopes.length > 0) {
+			const labels = missingScopes.map((scope) => GOOGLE_READONLY_SCOPE_LABELS[scope]);
+			callback.respond(400, oauthCallbackPage({
+				status: "permissions-missing",
+				missing: labels
+			}));
+			throw new SeoError("ACCESS_DENIED", `Google login did not grant ${labels.join(" and ")} read-only access. Run \`seo auth login\` again, choose Select all, and approve both permission boxes.`);
+		}
+		const accountEmail = decodeJwtEmail(tokenJson.id_token) ?? await fetchUserEmail(tokenJson.access_token);
+		if (!accountEmail) throw new Error("Google login succeeded but account email could not be determined.");
+		const tokens = {
+			provider: "google",
+			account_email: accountEmail,
+			scope: tokenJson.scope,
+			token_type: tokenJson.token_type,
+			access_token: tokenJson.access_token,
+			refresh_token: tokenJson.refresh_token,
+			expires_at: Date.now() + tokenJson.expires_in * 1e3,
+			obtained_at: Date.now(),
+			client_source: clientConfig.source
+		};
+		await writeTokens(tokens);
+		callback.respond(200, oauthCallbackPage({ status: "connected" }));
+		return tokens;
+	} catch (error) {
+		callback?.respond(400, oauthCallbackPage({ status: "failed" }));
+		throw error;
+	} finally {
+		server.close();
+	}
 }
 function waitForCode(input) {
 	return new Promise((resolve, reject) => {
@@ -1137,11 +1038,20 @@ function waitForCode(input) {
 				if (error) throw new Error(`OAuth error: ${error}`);
 				const incomingCode = reqUrl.searchParams.get("code");
 				if (!incomingCode) throw new Error("OAuth code missing.");
-				res.writeHead(200, { "content-type": "text/html; charset=utf-8" });
-				res.end(oauthCallbackPage());
+				let responded = false;
 				clearTimeout(timer);
-				resolve(incomingCode);
+				resolve({
+					code: incomingCode,
+					respond: (status, page) => {
+						if (responded) return;
+						responded = true;
+						res.writeHead(status, { "content-type": "text/html; charset=utf-8" });
+						res.end(page);
+					}
+				});
 			} catch (error) {
+				res.writeHead(400, { "content-type": "text/html; charset=utf-8" });
+				res.end(oauthCallbackPage({ status: "failed" }));
 				clearTimeout(timer);
 				reject(error);
 			}
@@ -1463,7 +1373,7 @@ function getCacheStats() {
 	const counts = {
 		sites: database.prepare("SELECT COUNT(*) AS count FROM sites").get(),
 		gsc_cache: database.prepare("SELECT COUNT(*) AS count FROM gsc_cache").get(),
-		ga4_cache: database.prepare("SELECT COUNT(*) AS count FROM ga4_cache").get(),
+		google_analytics_cache: database.prepare("SELECT COUNT(*) AS count FROM ga4_cache").get(),
 		semrush_cache: database.prepare("SELECT COUNT(*) AS count FROM semrush_cache").get(),
 		http_cache: database.prepare("SELECT COUNT(*) AS count FROM http_cache").get()
 	};
@@ -1476,7 +1386,7 @@ function getCacheStats() {
 function clearCache(provider, olderThanMs) {
 	const database = getDb();
 	const cutoff = olderThanMs ? Date.now() - olderThanMs : void 0;
-	const tables = provider === "gsc" ? ["gsc_cache"] : provider === "ga4" ? ["ga4_cache"] : provider === "semrush" ? ["semrush_cache"] : provider === "http" ? ["http_cache"] : [
+	const tables = provider === "gsc" ? ["gsc_cache"] : provider === "google-analytics" ? ["ga4_cache"] : provider === "semrush" ? ["semrush_cache"] : provider === "http" ? ["http_cache"] : [
 		"gsc_cache",
 		"ga4_cache",
 		"semrush_cache",
@@ -1520,8 +1430,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
@@ -1533,8 +1443,8 @@ async function listGa4AccountSummaries() {
 	const { client } = await createGoogleAccessTokenClient();
 	const response = await authedFetch$1(client, "https://analyticsadmin.googleapis.com/v1beta/accountSummaries");
 	if (!response.ok) {
-		if (response.status === 403) throw new Error("GA4 account summary fetch failed with 403. Enable the Google Analytics Admin API and check Analytics access.");
-		throw new Error(`GA4 account summary fetch failed with ${response.status}.`);
+		if (response.status === 403) throw new Error("Google Analytics account summary fetch failed with 403. Enable the Google Analytics Admin API and check Analytics access.");
+		throw new Error(`Google Analytics account summary fetch failed with ${response.status}.`);
 	}
 	return (await response.json()).accountSummaries ?? [];
 }
@@ -1544,14 +1454,14 @@ async function listGa4DataStreams(propertyId) {
 	let pageToken;
 	let pageCount = 0;
 	do {
-		if (pageCount >= 20) throw new Error(`GA4 data stream discovery exceeded 20 pages for property ${propertyId}.`);
+		if (pageCount >= 20) throw new Error(`Google Analytics data stream discovery exceeded 20 pages for property ${propertyId}.`);
 		const url = new URL(`https://analyticsadmin.googleapis.com/v1beta/properties/${ga4PropertyIdFromName(propertyId)}/dataStreams`);
 		url.searchParams.set("pageSize", "200");
 		if (pageToken) url.searchParams.set("pageToken", pageToken);
 		const response = await authedFetch$1(client, url.toString());
 		if (!response.ok) {
-			if (response.status === 403) throw new Error(`GA4 data stream fetch failed with 403 for property ${propertyId}. Check Analytics access.`);
-			throw new Error(`GA4 data stream fetch failed with ${response.status} for property ${propertyId}.`);
+			if (response.status === 403) throw new Error(`Google Analytics data stream fetch failed with 403 for property ${propertyId}. Check Analytics access.`);
+			throw new Error(`Google Analytics data stream fetch failed with ${response.status} for property ${propertyId}.`);
 		}
 		const json = await response.json();
 		streams.push(...json.dataStreams ?? []);
@@ -1577,7 +1487,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.`);
@@ -1683,11 +1593,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) {
@@ -1726,7 +1636,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")
@@ -1759,11 +1669,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];
@@ -1795,13 +1705,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,
@@ -1818,7 +1728,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) => ({
@@ -1840,7 +1750,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.`] : [],
@@ -1942,7 +1852,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,
@@ -2001,7 +1911,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
 	};
@@ -2011,7 +1921,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: [{
@@ -2036,7 +1946,7 @@ async function aiReferralsReport(input, dependencies = {}) {
 			detailResult = await fetchAiReferralRows({
 				property,
 				request: {
-					dateRanges: [ga4Range],
+					dateRanges: [googleAnalyticsDateRange],
 					dimensions: [
 						{ name: "date" },
 						{ name: "sessionSource" },
@@ -2072,7 +1982,7 @@ async function aiReferralsReport(input, dependencies = {}) {
 			usersResult = await fetchAiReferralRows({
 				property,
 				request: {
-					dateRanges: [ga4Range],
+					dateRanges: [googleAnalyticsDateRange],
 					metrics: [{ name: "totalUsers" }],
 					dimensionFilter
 				},
@@ -10033,7 +9943,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)}`;
 }
@@ -10236,7 +10146,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 ?? []));
@@ -10249,7 +10159,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),
@@ -10287,7 +10197,7 @@ function normalizeLoadedCrawlReport(report) {
 		definitionId: report.definitionId ?? crawlDefinitionId({
 			config: report.config,
 			site: report.site,
-			ga4PropertyId: report.ga4PropertyId
+			googleAnalyticsPropertyId: report.googleAnalyticsPropertyId
 		}),
 		summary: summarizeCrawlReport({
 			pages,
@@ -10700,7 +10610,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",
@@ -10713,7 +10623,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",
@@ -10738,7 +10648,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",
@@ -10898,7 +10808,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({
@@ -10914,8 +10824,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,
@@ -11737,11 +11647,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
@@ -11781,7 +11691,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: {
@@ -12535,7 +12445,7 @@ async function crawlSite(input, dependencies) {
 		const dataSources = await crawlDataSources({
 			cancelled,
 			site,
-			ga4PropertyId: input.ga4PropertyId,
+			googleAnalyticsPropertyId: input.googleAnalyticsPropertyId,
 			pages,
 			warnings,
 			searchMetricsLimit,
@@ -12590,7 +12500,7 @@ async function crawlSite(input, dependencies) {
 			config,
 			projectId: input.projectId,
 			site,
-			ga4PropertyId: input.ga4PropertyId,
+			googleAnalyticsPropertyId: input.googleAnalyticsPropertyId,
 			dataSources,
 			pages,
 			requests,
@@ -12679,7 +12589,7 @@ function crawlInput$1(input) {
 		url: input.url,
 		...input.searchSite ? { site: input.searchSite } : {},
 		projectId: input.projectId,
-		ga4PropertyId: input.ga4PropertyId,
+		googleAnalyticsPropertyId: input.googleAnalyticsPropertyId,
 		mode: "site",
 		maxPages: input.maxPages,
 		maxDepth: input.maxDepth,
@@ -13067,8 +12977,8 @@ const CSV_SCHEMAS = {
 		"target",
 		"template",
 		"template_count",
-		"ga4_sessions",
-		"ga4_total_users",
+		"google_analytics_sessions",
+		"google_analytics_total_users",
 		"evidence",
 		"action"
 	],
@@ -13097,7 +13007,7 @@ const CSV_SCHEMAS = {
 		"title",
 		"target",
 		"template",
-		"ga4_sessions",
+		"google_analytics_sessions",
 		"evidence",
 		"action"
 	],
@@ -13544,8 +13454,8 @@ function refreshPrioritiesCsvFiles(report) {
 				target: item.target,
 				template: item.template?.label,
 				template_count: item.template?.count,
-				ga4_sessions: item.analytics?.sessions,
-				ga4_total_users: item.analytics?.totalUsers,
+				google_analytics_sessions: item.analytics?.sessions,
+				google_analytics_total_users: item.analytics?.totalUsers,
 				evidence: item.evidence,
 				action: item.action
 			}))
@@ -13580,7 +13490,7 @@ function refreshPrioritiesCsvFiles(report) {
 				title: finding.title,
 				target: finding.target,
 				template: finding.template?.label,
-				ga4_sessions: finding.analytics?.sessions,
+				google_analytics_sessions: finding.analytics?.sessions,
 				evidence: finding.evidence,
 				action: finding.action
 			})))
@@ -13829,7 +13739,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)}`;
@@ -14139,7 +14049,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,
@@ -15780,7 +15690,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",
@@ -19715,7 +19625,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") {
@@ -19738,7 +19648,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)),
@@ -19805,8 +19715,8 @@ function classify(input) {
 }
 //#endregion
 //#region packages/core/src/analyze/experiments/measurement/ga4-change-provider.ts
-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: [
@@ -19820,7 +19730,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,
@@ -19830,19 +19740,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,
@@ -19858,7 +19768,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,
@@ -20096,7 +20006,7 @@ function measurementWindow(input) {
 //#region packages/core/src/analyze/experiments/measure-change.ts
 const defaultDependencies$5 = {
 	searchAnalytics: querySearchAnalytics,
-	ga4Report: runGa4Report,
+	googleAnalyticsReport: runGa4Report,
 	contentGroup: getContentGroup,
 	now: () => /* @__PURE__ */ new Date()
 };
@@ -20182,15 +20092,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,
@@ -20269,7 +20179,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.`] : []
 		]
 	};
 }
@@ -25940,7 +25850,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."
 	];
 }
@@ -26836,17 +26746,17 @@ async function crawlImplementationQueueWorkflow(input, dependencies) {
 				warnings: crawl.warnings
 			}),
 			joinStep({
-				tool: "seo_ga4_landing_page_values",
-				enabled: Boolean(input.ga4PropertyId),
-				warningPrefix: "GA4 metrics skipped:",
-				enabledSummary: "Joined GA4 landing-page value where URLs matched.",
-				skippedSummary: "No GA4 property was selected.",
+				tool: "seo_google_analytics_landing_page_values",
+				enabled: Boolean(input.googleAnalyticsPropertyId),
+				warningPrefix: "Google Analytics metrics skipped:",
+				enabledSummary: "Joined Google Analytics landing-page value where URLs matched.",
+				skippedSummary: "No Google Analytics property was selected.",
 				warnings: crawl.warnings
 			}),
 			{
 				tool: "seo_top_crawl_fixes",
 				status: "completed",
-				summary: "Grouped crawl issues, weighted them by severity, affected URLs, GSC visibility, GA4 value, and effort."
+				summary: "Grouped crawl issues, weighted them by severity, affected URLs, GSC visibility, Google Analytics value, and effort."
 			}
 		],
 		actions: queue.slice(0, 5).map((item) => ({
@@ -27199,12 +27109,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
 	});
@@ -27761,6 +27671,9 @@ async function updatePostmortemWorkflow(input, dependencies = {}) {
 }
 //#endregion
 //#region packages/core/src/clients.ts
+function googleAnalyticsPropertyId(client) {
+	return client?.analytics.google?.propertyId;
+}
 function slug(value) {
 	return value.toLowerCase().replace(/^https?:\/\//, "").replace(/^sc-domain:/, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60);
 }
@@ -27797,7 +27710,7 @@ function saveClient(input) {
 			name: input.name ?? existing?.name,
 			siteUrl: input.siteUrl
 		})),
-		ga4PropertyId: input.ga4PropertyId ?? existing?.ga4PropertyId,
+		analytics: input.analytics ?? existing?.analytics ?? {},
 		reportDay: input.reportDay ?? existing?.reportDay,
 		technicalWeekday: input.technicalWeekday ?? existing?.technicalWeekday,
 		isDefault: input.isDefault ?? existing?.isDefault,
@@ -27879,7 +27792,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
@@ -27891,10 +27804,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"),
@@ -28266,7 +28179,7 @@ function matchGa4WebStreams(site, candidates) {
 function ga4MatchReason(match, site) {
 	const stream = match.stream.displayName ?? match.defaultUri;
 	const location = match.match === "domain" ? "is inside" : "matches";
-	return `Matched GA4 web stream ${stream} (${match.defaultUri}): its hostname ${location} ${site}.`;
+	return `Matched Google Analytics web stream ${stream} (${match.defaultUri}): its hostname ${location} ${site}.`;
 }
 //#endregion
 //#region packages/core/src/logger.ts
@@ -28574,6 +28487,371 @@ var JsonFileStorageAdapter = class {
 };
 const localCredentialsProvider = new LocalCredentialsProvider();
 //#endregion
+//#region packages/core/src/version.ts
+const SEO_VERSION = version;
+//#endregion
+//#region packages/core/src/telemetry.ts
+const TELEMETRY_ENDPOINT = "https://seoskill.dev/api/t";
+const TELEMETRY_SCHEMA_VERSION = 1;
+const TELEMETRY_TIMEOUT_MS = 2e3;
+const TELEMETRY_EVENTS = [
+	"first_run",
+	"setup_complete",
+	"audit_start",
+	"audit_complete",
+	"audit_failed",
+	"first_audit_complete",
+	"active_d1",
+	"active_d7",
+	"active_d30"
+];
+const TELEMETRY_AGENTS = [
+	"claude-code",
+	"cursor",
+	"codex",
+	"cli",
+	"unknown"
+];
+const TELEMETRY_ERROR_CATEGORIES = [
+	"auth",
+	"crawl_timeout",
+	"network",
+	"config",
+	"unknown"
+];
+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 getTelemetryStatus(options = {}) {
+	return statusFromState(options);
+}
+function setTelemetryEnabled(enabled, options = {}) {
+	const stateFile = optionStateFile(options);
+	const stored = readState(stateFile);
+	const state = stored.kind === "valid" ? stored.state : newState(options, enabled);
+	state.telemetryEnabled = enabled;
+	writeState(stateFile, state);
+	return statusFromState(options);
+}
+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 trackTelemetrySetupComplete(options = {}) {
+	const state = enabledState(options);
+	if (!state || state.sentMilestones.includes("setup_complete")) return;
+	state.sentMilestones.push("setup_complete");
+	try {
+		writeState(optionStateFile(options), state);
+	} catch {
+		return;
+	}
+	dispatchTelemetry(buildTelemetryPayload("setup_complete", state, {}, options), 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/core/src/utils/time.ts
 function parseOlderThan(input) {
 	if (!input) return;
@@ -28608,9 +28886,6 @@ function isoDate(daysAgo = 0) {
 	return date.toISOString().slice(0, 10);
 }
 //#endregion
-//#region packages/core/src/version.ts
-const SEO_VERSION = version;
-//#endregion
-export { AI_REFERRAL_SOURCES, AI_REFERRAL_SOURCES_VERSION, AI_SEARCH_SCORECARD_METHODOLOGY_ID, AI_SEARCH_SCORECARD_METHODOLOGY_VERSION, AUDIT_PAGE_RULE_IDS, BROWSER_USER_AGENT, CANNIBAL_MAXIMUM_DOMINANT_SHARE, CANNIBAL_MINIMUM_PAGE_SHARE, CRAWL_REPORT_STORAGE_VERSION, CRAWL_SKIP_REASONS, CTR_DEFAULT_LIMIT, CTR_DEFAULT_MIN_IMPRESSIONS, CTR_MAX_LIMIT, CTR_MAX_MIN_IMPRESSIONS, DataForSeoProvider, GSC_FINAL_DATA_LAG_DAYS, GSC_TIME_ZONE, INTERNAL_LINK_LEXICAL_TARGET_LIMIT, INTERNAL_LINK_MATCH_EVIDENCE_LIMIT, JsonFileStorageAdapter, LocalCredentialsProvider, OKF_DEFAULT_CONCEPTS, OKF_MAX_CONCEPTS, REPORT_BASELINE_MAX_AGE_MS, REPORT_BASELINE_MAX_DEPTH, REPORT_BASELINE_MAX_PAGES, SCORECARD_CHECK_WEIGHTS, SCORECARD_STATUS_CREDIT, SEO_VERSION, SERP_TITLE_REFERENCE_WIDTH_PX, SERP_TITLE_WIDTH_PROFILE, SemrushProvider, SeoError, ServiceAccountAccessTokenClient, SessionLedger, affectedUrls, agentReadiness, aiPromptsForQuery, aiReadiness, aiReferralSourceForValue, aiReferralsReport, aiSearchScorecard, allocateIndexUrlsToProperties, analyzeAiReferralRows, analyzeCannibalRows, analyzeCtrUnderperformersFromRows, analyzeDecay, analyzeIndexCoverageSignals, analyzeInternalLinksFromRows, analyzePageOpportunitiesFromRows, analyzeQueryClustersFromRows, analyzeQuickWinsFromRows, analyzeSecondPageRows, analyzeSegmentRows, analyzeStrikingDistanceRows, analyzeTrafficAnomalyRows, assertUrlMatchesGscProperty, attachCrawlRecommendations, auditCrawlPages, auditCrawlRequests, auditLlmsTxt, auditPage, authStatus, boundedSitemapInventory, buildOkfBundle, buildPseoAuditReportFromRows, cannibalReport, changeMeasurementCsvRows, classifyCommunityIntent, clearCache, clientProfileSchema, clusterPseoTemplates, clusterQueryRows, collectAgentDiscovery, combineRobotsValues, communityIntentReport, compareCrawlPages, compareCrawlReports, compareSegmentRows, configSchema, contentCoverageRecommendation, contentCoverageType, contentOptimizationFromPageOpportunities, contentOptimizationReport, countLabel, crawlConfigHash, crawlConfigSchema, crawlDefinitionId, crawlDiff, crawlFixToQueueItem, crawlImplementationQueueWorkflow, crawlIssueGroupSchema, crawlIssueSchema, crawlOne, crawlPageSnapshotSchema, crawlReportSchema, crawlReportStore, crawlReportSummarySchema, crawlRequestObservationSchema, crawlRunId, crawlSite, crawlSkipImpact, crawlSkipReasonCountsFromRecord, crawlTopFixSchema, crawlerJsonSchemas, crawlerRuleCategorySchema, crawlerRuleIdSchema, crawlerRuleInfoSchema, crawlerRuleRecommendationSchema, crawlerRuleSeveritySchema, crawlerSchemas, createAuthorizedClient, createContentGroup, createCrawlReport, createCtrBenchmarkContext, createGoogleAccessTokenClient, createLogger, createPageRenderer, ctrUnderperformersReport, decayClusterDrafts, decayComparisonRange, decayingReport, deleteChange, deleteClient, deleteContentGroup, deleteCrawlReport, deleteTokens, deriveBrandTerms, detectBrandTerms, diagnoseCsvFiles, diagnoseProperty, diagnosePropertyWorkflow, effectiveRobotsDirectives, effectiveSnippetControl, ensureSeoCliDirs, entityReadiness, estimateSerpTitleWidth, expectedCtrForPosition, explainOkfValidation, explainRule, fetchCruxFieldData, fetchPage, fetchSearchStatusIncidents, fetchSitemapUrls, fileSize, finalGscDateRange, findOverlappingSearchUpdates, formatRelativeExpiry, ga4MatchReason, ga4PropertyIdFromName, ga4ReportQualityWarnings, ga4RequestCanUseCache, ga4RowsToObjects, generateLlmsTxt, geoGaps, geoGapsReport, getAuthModeStatus, getCacheStats, getChange, getClient, getClientConfig, getContentGroup, getDb, getKeywordProvider, getPreviousRun, getPrivacySnapshot, getRepeatedLinkRecoverUrls, getRunPages, getSeoCliPaths, getServiceAccountConfig, getServiceAccountStatus, getTokenStorageStatus, groupCrawlIssues, hasMetaRobotsDirective, hasRule, hasXRobotsDirective, hashKey, indexCoveragePlan, indexCoverageSignals, indexMonitor, indexWatch, inferPseoTemplate, inferTemplateMovement, insertCrawlRun, insertLinkRecoverRun, inspectUrl, internalLinksReport, interpretUpdateCorrelation, isBrandQuery, isCompatibleTechnicalBaseline, isCurrentTechnicalBaseline, isEntityEvidenceSchemaType, isSiteIdentitySchemaType, isSkippableReportError, isoDate, latestCrawlReport, latestCrawlSummaries, latestFinalGscDate, latestIndexWatchSummary, latestLinkRecoverSummary, linkRecover, linkRecoverRecommendation, listChanges, listClients, listContentGroups, listCrawlReports, listGa4AccountSummaries, listGa4DataStreams, listRules, listSearchUpdates, listSites, loadCrawlReport, localCredentialsProvider, loginWithLoopback, makeRunId, matchGa4WebStreams, measureChange, measureCoverage, metaRobotsDirectives, migrateLegacyMacConfig, missingOAuthClientMessage, missingSharedClientLoginMessage, monitoringStatus, monthlyReport, monthlyReportWorkflow, narrativeCsvFiles, normalizeCrawlConfig, normalizeCrawlSkipReasonCounts, normalizeForCoverage, normalizeHttpUrl, normalizeJavaScriptRenderingMode, normalizeLoadedCrawlReport, okfConceptLimit, pageEvidenceRecommendation, pageOpportunitiesReport, parseOlderThan, parsePseoPath, performanceAudit, performanceReportIsCacheable, planDueIndexUrls, planIndexCoverageFromUrls, plural, propertyMatchesUrl, providerPreferenceSchema, pseoAuditOptions, pseoAuditReport, pseoCsvFiles, pseoIndexStatus, pseoPresentation, publicHttpFetch, queryClusterReport, queryClusterTokens, queryContentCoverageFromPage, queryContentFieldsFromPage, queryFieldCoverage, queryOpportunityRecommendation, queryPageMetrics, queryPageTopQuery, queryPagesMetrics, queryPagesMetricsBatch, queryPagesTopQueries, queryPagesTopQueriesBatch, querySearchAnalytics, quickWinsCsvRows, quickWinsReport, readConfig, readOauthClient, readTokens, recommendCrawlDiffItem, recommendationForRule, recordChange, redirectTrace, refreshAuthToken, refreshPrioritiesCsvFiles, refreshPrioritiesWorkflow, renderCrawlCsv, renderCrawlHtml, renderCrawlMarkdownTickets, renderCrawlPagesCsv, renderCrawlPretty, renderCsv, renderPresentationTablesMarkdown, renderPseoMarkdown, renderWorkflowMarkdown, reportNarrative, reportPresentation, requestHeaders, resolveSegmentRanges, resolveSeoCliPaths, resolveTechnicalBaseline, reviewObservations, roundedPosition, runDoctor, runGa4Report, saveClient, saveCrawlReport, secondPage, segmentComparisonRange, segmentImpact, segmentRangeDays, selectAffectedUrls, selectDueIndexUrls, seoErrorEnvelope, seoToAiQueryReport, sessionSourceInListFilter, setDefaultClient, setTokenStorageMode, shiftIsoDate, shouldExcludeBrandQuery, siteSchema, sqliteCrawlReportStore, strikingDistance, summarizeCrawlReport, pageTechnicalSignals as technicalPageSignals, technicalWatchWorkflow, templateForUrl, toSeoError, tokenSchema, topCrawlRecommendations, topFixes, trafficAnomaly, unavailableSegmentImpactReport, unicodeTokens, updateCorrelation, updatePostmortemCsvFiles, updatePostmortemWorkflow, validateOkfFiles, verifyQueryContent, workflowPresentation, writeConfig, writeOauthClient, writeTokens, xRobotsDirectives };
+export { AI_REFERRAL_SOURCES, AI_REFERRAL_SOURCES_VERSION, AI_SEARCH_SCORECARD_METHODOLOGY_ID, AI_SEARCH_SCORECARD_METHODOLOGY_VERSION, AUDIT_PAGE_RULE_IDS, BROWSER_USER_AGENT, CANNIBAL_MAXIMUM_DOMINANT_SHARE, CANNIBAL_MINIMUM_PAGE_SHARE, CRAWL_REPORT_STORAGE_VERSION, CRAWL_SKIP_REASONS, CTR_DEFAULT_LIMIT, CTR_DEFAULT_MIN_IMPRESSIONS, CTR_MAX_LIMIT, CTR_MAX_MIN_IMPRESSIONS, DataForSeoProvider, GSC_FINAL_DATA_LAG_DAYS, GSC_TIME_ZONE, INTERNAL_LINK_LEXICAL_TARGET_LIMIT, INTERNAL_LINK_MATCH_EVIDENCE_LIMIT, JsonFileStorageAdapter, LocalCredentialsProvider, OKF_DEFAULT_CONCEPTS, OKF_MAX_CONCEPTS, REPORT_BASELINE_MAX_AGE_MS, REPORT_BASELINE_MAX_DEPTH, REPORT_BASELINE_MAX_PAGES, SCORECARD_CHECK_WEIGHTS, SCORECARD_STATUS_CREDIT, SEO_VERSION, SERP_TITLE_REFERENCE_WIDTH_PX, SERP_TITLE_WIDTH_PROFILE, SemrushProvider, SeoError, ServiceAccountAccessTokenClient, SessionLedger, TELEMETRY_AGENTS, TELEMETRY_ENDPOINT, TELEMETRY_ERROR_CATEGORIES, TELEMETRY_EVENTS, TELEMETRY_NOTICE, TELEMETRY_REPORTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_TIMEOUT_MS, affectedUrls, agentReadiness, aiPromptsForQuery, aiReadiness, aiReferralSourceForValue, aiReferralsReport, aiSearchScorecard, allocateIndexUrlsToProperties, analyticsConnectionsSchema, analyzeAiReferralRows, analyzeCannibalRows, analyzeCtrUnderperformersFromRows, analyzeDecay, analyzeIndexCoverageSignals, analyzeInternalLinksFromRows, analyzePageOpportunitiesFromRows, analyzeQueryClustersFromRows, analyzeQuickWinsFromRows, analyzeSecondPageRows, analyzeSegmentRows, analyzeStrikingDistanceRows, analyzeTrafficAnomalyRows, assertUrlMatchesGscProperty, attachCrawlRecommendations, auditCrawlPages, auditCrawlRequests, auditLlmsTxt, auditPage, authStatus, boundedSitemapInventory, buildOkfBundle, buildPseoAuditReportFromRows, buildTelemetryPayload, cannibalReport, changeMeasurementCsvRows, classifyCommunityIntent, clearCache, clientProfileSchema, clusterPseoTemplates, clusterQueryRows, collectAgentDiscovery, combineRobotsValues, communityIntentReport, compareCrawlPages, compareCrawlReports, compareSegmentRows, configSchema, contentCoverageRecommendation, contentCoverageType, contentOptimizationFromPageOpportunities, contentOptimizationReport, countLabel, crawlConfigHash, crawlConfigSchema, crawlDefinitionId, crawlDiff, crawlFixToQueueItem, crawlImplementationQueueWorkflow, crawlIssueGroupSchema, crawlIssueSchema, crawlOne, crawlPageSnapshotSchema, crawlReportSchema, crawlReportStore, crawlReportSummarySchema, crawlRequestObservationSchema, crawlRunId, crawlSite, crawlSkipImpact, crawlSkipReasonCountsFromRecord, crawlTopFixSchema, crawlerJsonSchemas, crawlerRuleCategorySchema, crawlerRuleIdSchema, crawlerRuleInfoSchema, crawlerRuleRecommendationSchema, crawlerRuleSeveritySchema, crawlerSchemas, createAuthorizedClient, createContentGroup, createCrawlReport, createCtrBenchmarkContext, createGoogleAccessTokenClient, createLogger, createPageRenderer, ctrUnderperformersReport, decayClusterDrafts, decayComparisonRange, decayingReport, deleteChange, deleteClient, deleteContentGroup, deleteCrawlReport, deleteTokens, deriveBrandTerms, detectBrandTerms, detectTelemetryAgent, diagnoseCsvFiles, diagnoseProperty, diagnosePropertyWorkflow, effectiveRobotsDirectives, effectiveSnippetControl, ensureSeoCliDirs, entityReadiness, estimateSerpTitleWidth, expectedCtrForPosition, explainOkfValidation, explainRule, fetchCruxFieldData, fetchPage, fetchSearchStatusIncidents, fetchSitemapUrls, fileSize, finalGscDateRange, findOverlappingSearchUpdates, formatRelativeExpiry, ga4MatchReason, ga4PropertyIdFromName, ga4ReportQualityWarnings, ga4RequestCanUseCache, ga4RowsToObjects, generateLlmsTxt, geoGaps, geoGapsReport, getAuthModeStatus, getCacheStats, getChange, getClient, getClientConfig, getContentGroup, getDb, getKeywordProvider, getPreviousRun, getPrivacySnapshot, getRepeatedLinkRecoverUrls, getRunPages, getSeoCliPaths, getServiceAccountConfig, getServiceAccountStatus, getTelemetryStatus, getTokenStorageStatus, googleAnalyticsPropertyId, groupCrawlIssues, hasMetaRobotsDirective, hasRule, hasXRobotsDirective, hashKey, indexCoveragePlan, indexCoverageSignals, indexMonitor, indexWatch, inferPseoTemplate, inferTemplateMovement, initializeTelemetry, insertCrawlRun, insertLinkRecoverRun, inspectUrl, internalLinksReport, interpretUpdateCorrelation, isBrandQuery, isCompatibleTechnicalBaseline, isCurrentTechnicalBaseline, isEntityEvidenceSchemaType, isSiteIdentitySchemaType, isSkippableReportError, isTelemetryCi, isTelemetryReport, isoDate, isoWeek, latestCrawlReport, latestCrawlSummaries, latestFinalGscDate, latestIndexWatchSummary, latestLinkRecoverSummary, linkRecover, linkRecoverRecommendation, listChanges, listClients, listContentGroups, listCrawlReports, listGa4AccountSummaries, listGa4DataStreams, listRules, listSearchUpdates, listSites, loadCrawlReport, localCredentialsProvider, loginWithLoopback, makeRunId, matchGa4WebStreams, measureChange, measureCoverage, metaRobotsDirectives, migrateLegacyMacConfig, missingOAuthClientMessage, missingSharedClientLoginMessage, monitoringStatus, monthlyReport, monthlyReportWorkflow, narrativeCsvFiles, normalizeCrawlConfig, normalizeCrawlSkipReasonCounts, normalizeForCoverage, normalizeHttpUrl, normalizeJavaScriptRenderingMode, normalizeLoadedCrawlReport, okfConceptLimit, pageEvidenceRecommendation, pageOpportunitiesReport, parseOlderThan, parsePseoPath, performanceAudit, performanceReportIsCacheable, planDueIndexUrls, planIndexCoverageFromUrls, plural, propertyMatchesUrl, providerPreferenceSchema, pseoAuditOptions, pseoAuditReport, pseoCsvFiles, pseoIndexStatus, pseoPresentation, publicHttpFetch, queryClusterReport, queryClusterTokens, queryContentCoverageFromPage, queryContentFieldsFromPage, queryFieldCoverage, queryOpportunityRecommendation, queryPageMetrics, queryPageTopQuery, queryPagesMetrics, queryPagesMetricsBatch, queryPagesTopQueries, queryPagesTopQueriesBatch, querySearchAnalytics, quickWinsCsvRows, quickWinsReport, readConfig, readOauthClient, readTokens, recommendCrawlDiffItem, recommendationForRule, recordChange, redirectTrace, refreshAuthToken, refreshPrioritiesCsvFiles, refreshPrioritiesWorkflow, renderCrawlCsv, renderCrawlHtml, renderCrawlMarkdownTickets, renderCrawlPagesCsv, renderCrawlPretty, renderCsv, renderPresentationTablesMarkdown, renderPseoMarkdown, renderWorkflowMarkdown, reportNarrative, reportPresentation, requestHeaders, resolveSegmentRanges, resolveSeoCliPaths, resolveTechnicalBaseline, reviewObservations, roundedPosition, runDoctor, runGa4Report, saveClient, saveCrawlReport, secondPage, segmentComparisonRange, segmentImpact, segmentRangeDays, selectAffectedUrls, selectDueIndexUrls, seoErrorEnvelope, seoToAiQueryReport, sessionSourceInListFilter, setDefaultClient, setTelemetryEnabled, setTokenStorageMode, shiftIsoDate, shouldExcludeBrandQuery, siteSchema, sqliteCrawlReportStore, strikingDistance, summarizeCrawlReport, pageTechnicalSignals as technicalPageSignals, technicalWatchWorkflow, telemetryErrorCategory, templateForUrl, toSeoError, tokenSchema, topCrawlRecommendations, topFixes, trackTelemetryReportComplete, trackTelemetryReportFailed, trackTelemetryReportStart, trackTelemetrySetupComplete, trafficAnomaly, unavailableSegmentImpactReport, unicodeTokens, updateCorrelation, updatePostmortemCsvFiles, updatePostmortemWorkflow, validateOkfFiles, verifyQueryContent, workflowPresentation, writeConfig, writeOauthClient, writeTokens, xRobotsDirectives };
 
 //# sourceMappingURL=index.js.map