@gscdump/analysis 0.32.12 → 0.33.3

package/dist/index.mjs

@@ -225,15 +225,26 @@ function scorePriorityActions(actions) {
 	actions.sort((a, b) => b.priorityScore - a.priorityScore);
 	return actions;
 }
-function num$6(v) {
-	if (typeof v === "number") return v;
-	if (typeof v === "bigint") return Number(v);
-	if (v == null) return 0;
-	const n = Number(v);
+function rowNumber(value) {
+	if (typeof value === "number") return Number.isFinite(value) ? value : 0;
+	if (typeof value === "bigint") return Number(value);
+	if (value == null) return 0;
+	const n = Number(value);
 	return Number.isFinite(n) ? n : 0;
 }
-function str$23(v) {
-	return v == null ? "" : String(v);
+function rowString(value) {
+	return value == null ? "" : String(value);
+}
+function rowBoolean(value) {
+	return value === true || value === 1 || value === "true";
+}
+function parseJsonRows(value) {
+	if (Array.isArray(value)) return value;
+	if (typeof value === "string" && value.length > 0) {
+		const parsed = JSON.parse(value);
+		return Array.isArray(parsed) ? parsed : [];
+	}
+	return [];
 }
 const bayesianCtrAnalyzer = defineAnalyzer$1({
 	id: "bayesian-ctr",
@@ -373,24 +384,24 @@ const bayesianCtrAnalyzer = defineAnalyzer$1({
 		const arr = Array.isArray(rows) ? rows : [];
 		const minImpressions = params.minImpressions ?? 50;
 		const results = arr.map((r) => ({
-			keyword: str$23(r.keyword),
-			page: str$23(r.page),
-			clicks: num$6(r.clicks),
-			impressions: num$6(r.impressions),
-			observedCtr: num$6(r.observedCtr),
-			position: num$6(r.position),
-			bucket: num$6(r.bucket),
-			priorAlpha: num$6(r.priorAlpha),
-			priorBeta: num$6(r.priorBeta),
-			bucketPriorMean: num$6(r.bucketPriorMean),
-			posteriorMean: num$6(r.posteriorMean),
-			posteriorSd: num$6(r.posteriorSd),
-			ciLow: num$6(r.ciLow),
-			ciHigh: num$6(r.ciHigh),
-			shrinkageDelta: num$6(r.shrinkageDelta),
-			expectedClicksDelta: num$6(r.expectedClicksDelta),
-			significance: num$6(r.significance),
-			classification: str$23(r.classification)
+			keyword: rowString(r.keyword),
+			page: rowString(r.page),
+			clicks: rowNumber(r.clicks),
+			impressions: rowNumber(r.impressions),
+			observedCtr: rowNumber(r.observedCtr),
+			position: rowNumber(r.position),
+			bucket: rowNumber(r.bucket),
+			priorAlpha: rowNumber(r.priorAlpha),
+			priorBeta: rowNumber(r.priorBeta),
+			bucketPriorMean: rowNumber(r.bucketPriorMean),
+			posteriorMean: rowNumber(r.posteriorMean),
+			posteriorSd: rowNumber(r.posteriorSd),
+			ciLow: rowNumber(r.ciLow),
+			ciHigh: rowNumber(r.ciHigh),
+			shrinkageDelta: rowNumber(r.shrinkageDelta),
+			expectedClicksDelta: rowNumber(r.expectedClicksDelta),
+			significance: rowNumber(r.significance),
+			classification: rowString(r.classification)
 		}));
 		const under = results.filter((r) => r.classification === "underperforming").length;
 		const over = results.filter((r) => r.classification === "overperforming").length;
@@ -408,17 +419,6 @@ const bayesianCtrAnalyzer = defineAnalyzer$1({
 });
 const BIPARTITE_PAGERANK_ITERATIONS = 25;
 const BIPARTITE_PAGERANK_DAMPING = .85;
-function str$22(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$16(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const bipartitePagerankAnalyzer = defineAnalyzer$1({
 	id: "bipartite-pagerank",
 	buildSql(params) {
@@ -624,8 +624,8 @@ const bipartitePagerankAnalyzer = defineAnalyzer$1({
 		const iterations = BIPARTITE_PAGERANK_ITERATIONS;
 		const d = BIPARTITE_PAGERANK_DAMPING;
 		const results = arr.map((r) => ({
-			kind: str$22(r.kind),
-			id: str$22(r.id),
+			kind: rowString(r.kind),
+			id: rowString(r.id),
 			rank: num$1(r.rank),
 			bridging: num$1(r.bridging),
 			anchoring: num$1(r.anchoring),
@@ -635,7 +635,7 @@ const bipartitePagerankAnalyzer = defineAnalyzer$1({
 		const first = arr[0] ?? {};
 		const queryCount = num$1(first.queryCount);
 		const urlCount = num$1(first.urlCount);
-		const deltas = parseJsonList$16(first.deltasJson).map((e) => ({
+		const deltas = parseJsonRows(first.deltasJson).map((e) => ({
 			step: num$1(e.step),
 			l1: num$1(e.l1)
 		}));
@@ -735,9 +735,6 @@ function analysisErrorToException(error) {
 function escapeRegexAlt(s) {
 	return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function str$21(v) {
-	return v == null ? "" : String(v);
-}
 function requireBrandTermsResult(brandTerms) {
 	return brandTerms?.length ? ok(brandTerms) : err(analysisErrors.missingBrandTerms());
 }
@@ -813,13 +810,13 @@ const brandAnalyzer = defineAnalyzer$1({
 	},
 	reduceSql(rows) {
 		const normalized = (Array.isArray(rows) ? rows : []).map((r) => ({
-			query: str$21(r.query),
-			page: r.page == null ? void 0 : str$21(r.page),
+			query: rowString(r.query),
+			page: r.page == null ? void 0 : rowString(r.page),
 			clicks: num$1(r.clicks),
 			impressions: num$1(r.impressions),
 			ctr: num$1(r.ctr),
 			position: num$1(r.position),
-			segment: str$21(r.segment)
+			segment: rowString(r.segment)
 		}));
 		let brandClicks = 0;
 		let nonBrandClicks = 0;
@@ -896,17 +893,6 @@ const sortRowResults$1 = createSorter((item, metric) => {
 		case "pageCount": return item.pages.length;
 	}
 }, "clicks");
-function str$20(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$15(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 function analyzeCannibalization(rows, options = {}) {
 	const { minImpressions = 10, maxPositionSpread = 10, minPages = 2, sortBy = "clicks", sortOrder = "desc" } = options;
 	const queryMap = /* @__PURE__ */ new Map();
@@ -1059,19 +1045,19 @@ const cannibalizationAnalyzer = defineAnalyzer$1({
 	},
 	reduceSql(rows) {
 		const events = (Array.isArray(rows) ? rows : []).map((r) => ({
-			keyword: str$20(r.keyword),
+			keyword: rowString(r.keyword),
 			totalImpressions: num$1(r.totalImpressions),
 			totalClicks: num$1(r.totalClicks),
 			competitorCount: num$1(r.competitorCount),
-			leaderUrl: str$20(r.leaderUrl),
+			leaderUrl: rowString(r.leaderUrl),
 			leaderCtr: num$1(r.leaderCtr),
 			leaderPosition: num$1(r.leaderPosition),
 			hhi: num$1(r.hhi),
 			fragmentation: num$1(r.fragmentation),
 			stolenClicks: num$1(r.stolenClicks),
 			severity: num$1(r.severity),
-			competitors: parseJsonList$15(r.competitors).map((c) => ({
-				url: str$20(c.url),
+			competitors: parseJsonRows(r.competitors).map((c) => ({
+				url: rowString(c.url),
 				clicks: num$1(c.clicks),
 				impressions: num$1(c.impressions),
 				ctr: num$1(c.ctr),
@@ -1148,24 +1134,6 @@ const cannibalizationAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function num$5(v) {
-	if (typeof v === "number") return v;
-	if (typeof v === "bigint") return Number(v);
-	if (v == null) return 0;
-	const n = Number(v);
-	return Number.isFinite(n) ? n : 0;
-}
-function str$19(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$14(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const changePointAnalyzer = defineAnalyzer$1({
 	id: "change-point",
 	buildSql(params) {
@@ -1318,24 +1286,24 @@ const changePointAnalyzer = defineAnalyzer$1({
 		const metric = params.metric === "clicks" || params.metric === "impressions" ? params.metric : "position";
 		const lowerIsBetter = metric === "position";
 		const results = arr.map((r) => {
-			const delta = num$5(r.delta);
+			const delta = rowNumber(r.delta);
 			const improved = lowerIsBetter ? delta < 0 : delta > 0;
 			return {
-				keyword: str$19(r.keyword),
-				page: str$19(r.page),
-				totalDays: num$5(r.totalDays),
-				totalImpressions: num$5(r.totalImpressions),
-				changeDate: str$19(r.changeDate),
-				llr: num$5(r.llr),
-				leftMean: num$5(r.leftMean),
-				rightMean: num$5(r.rightMean),
+				keyword: rowString(r.keyword),
+				page: rowString(r.page),
+				totalDays: rowNumber(r.totalDays),
+				totalImpressions: rowNumber(r.totalImpressions),
+				changeDate: rowString(r.changeDate),
+				llr: rowNumber(r.llr),
+				leftMean: rowNumber(r.leftMean),
+				rightMean: rowNumber(r.rightMean),
 				delta,
-				leftStddev: num$5(r.leftStddev),
-				rightStddev: num$5(r.rightStddev),
+				leftStddev: rowNumber(r.leftStddev),
+				rightStddev: rowNumber(r.rightStddev),
 				direction: improved ? "improved" : "worsened",
-				series: parseJsonList$14(r.seriesJson).map((s) => ({
-					date: str$19(s.date),
-					value: num$5(s.value)
+				series: parseJsonRows(r.seriesJson).map((s) => ({
+					date: rowString(s.date),
+					value: rowNumber(s.value)
 				}))
 			};
 		});
@@ -1372,17 +1340,6 @@ const INTENT_PREFIXES = [
 	"near me"
 ];
 const WHITESPACE_RE$2 = /\s+/;
-function str$18(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$13(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 function extractIntentPrefix(keyword) {
 	const lower = keyword.toLowerCase();
 	for (const prefix of INTENT_PREFIXES) if (lower.startsWith(`${prefix} `) || lower.startsWith(prefix)) return prefix;
@@ -1520,14 +1477,14 @@ const clusteringAnalyzer = defineAnalyzer$1({
 	},
 	reduceSql(rows) {
 		const clusters = (Array.isArray(rows) ? rows : []).map((r) => ({
-			clusterName: str$18(r.clusterName),
-			clusterType: str$18(r.clusterType),
+			clusterName: rowString(r.clusterName),
+			clusterType: rowString(r.clusterType),
 			keywordCount: num$1(r.keywordCount),
 			totalClicks: num$1(r.totalClicks),
 			totalImpressions: num$1(r.totalImpressions),
 			avgPosition: num$1(r.avgPosition),
-			keywords: parseJsonList$13(r.keywords).map((k) => ({
-				query: str$18(k.query),
+			keywords: parseJsonRows(r.keywords).map((k) => ({
+				query: rowString(k.query),
 				clicks: num$1(k.clicks),
 				impressions: num$1(k.impressions),
 				ctr: num$1(k.ctr),
@@ -1557,17 +1514,6 @@ const clusteringAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function str$17(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$12(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 function calculateGini(values) {
 	if (values.length === 0) return 0;
 	const sorted = [...values].sort((a, b) => a - b);
@@ -1708,20 +1654,20 @@ const concentrationAnalyzer = defineAnalyzer$1({
 	},
 	reduceSql(rows, params) {
 		const r = (Array.isArray(rows) ? rows : [])[0] ?? {};
-		const topRaw = parseJsonList$12(r.topNItems);
+		const topRaw = parseJsonRows(r.topNItems);
 		return {
 			results: [{
 				giniCoefficient: num$1(r.giniCoefficient),
 				hhi: num$1(r.hhi),
 				topNConcentration: num$1(r.topNConcentration),
 				topNItems: topRaw.map((t) => ({
-					key: str$17(t.key),
+					key: rowString(t.key),
 					clicks: num$1(t.clicks),
 					share: num$1(t.share)
 				})),
 				totalItems: num$1(r.totalItems),
 				totalClicks: num$1(r.totalClicks),
-				riskLevel: str$17(r.riskLevel)
+				riskLevel: rowString(r.riskLevel)
 			}],
 			meta: {
 				total: 1,
@@ -1746,16 +1692,6 @@ const concentrationAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function num$4(v) {
-	if (typeof v === "number") return v;
-	if (typeof v === "bigint") return Number(v);
-	if (v == null) return 0;
-	const n = Number(v);
-	return Number.isFinite(n) ? n : 0;
-}
-function str$16(v) {
-	return v == null ? "" : String(v);
-}
 const contentVelocityAnalyzer = defineAnalyzer$1({
 	id: "content-velocity",
 	buildSql(params) {
@@ -1812,9 +1748,9 @@ const contentVelocityAnalyzer = defineAnalyzer$1({
 		startDateD.setUTCDate(startDateD.getUTCDate() - days);
 		const startDate = toIsoDate(startDateD);
 		const weekly = arr.map((r) => ({
-			week: str$16(r.week),
-			newKeywords: num$4(r.newKeywords),
-			totalKeywords: num$4(r.totalKeywords)
+			week: rowString(r.week),
+			newKeywords: rowNumber(r.newKeywords),
+			totalKeywords: rowNumber(r.totalKeywords)
 		}));
 		const total = weekly.reduce((s, w) => s + w.newKeywords, 0);
 		const avg = weekly.length > 0 ? total / weekly.length : 0;
@@ -1837,27 +1773,6 @@ const contentVelocityAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function num$3(v) {
-	if (typeof v === "number") return v;
-	if (typeof v === "bigint") return Number(v);
-	if (v == null) return 0;
-	const n = Number(v);
-	return Number.isFinite(n) ? n : 0;
-}
-function str$15(v) {
-	return v == null ? "" : String(v);
-}
-function bool$2(v) {
-	return v === true || v === 1 || v === "true";
-}
-function parseJsonList$11(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const ctrAnomalyAnalyzer = defineAnalyzer$1({
 	id: "ctr-anomaly",
 	buildSql(params) {
@@ -1999,26 +1914,26 @@ const ctrAnomalyAnalyzer = defineAnalyzer$1({
 		const minRollingN = 14;
 		const zThreshold = params.threshold ?? 2;
 		const anomalies = arr.map((r) => ({
-			keyword: str$15(r.keyword),
-			page: str$15(r.page),
-			breachDaysDown: num$3(r.breachDaysDown),
-			breachDaysUp: num$3(r.breachDaysUp),
-			clicksLost: num$3(r.clicksLost),
-			severity: num$3(r.severityRaw),
-			maxZ: num$3(r.maxZ),
-			baselineCtr: num$3(r.baselineCtr),
-			baselinePosition: num$3(r.baselinePosition),
-			totalImpressions: num$3(r.totalImpressions),
-			totalClicks: num$3(r.totalClicks),
-			series: parseJsonList$11(r.seriesJson).map((s) => ({
-				date: str$15(s.date),
-				ctr: num$3(s.ctr),
-				position: num$3(s.position),
-				impressions: num$3(s.impressions),
-				rollingCtr: s.rollingCtr == null ? null : num$3(s.rollingCtr),
-				rollingStddev: s.rollingStddev == null ? null : num$3(s.rollingStddev),
-				z: num$3(s.z),
-				breach: bool$2(s.breach)
+			keyword: rowString(r.keyword),
+			page: rowString(r.page),
+			breachDaysDown: rowNumber(r.breachDaysDown),
+			breachDaysUp: rowNumber(r.breachDaysUp),
+			clicksLost: rowNumber(r.clicksLost),
+			severity: rowNumber(r.severityRaw),
+			maxZ: rowNumber(r.maxZ),
+			baselineCtr: rowNumber(r.baselineCtr),
+			baselinePosition: rowNumber(r.baselinePosition),
+			totalImpressions: rowNumber(r.totalImpressions),
+			totalClicks: rowNumber(r.totalClicks),
+			series: parseJsonRows(r.seriesJson).map((s) => ({
+				date: rowString(s.date),
+				ctr: rowNumber(s.ctr),
+				position: rowNumber(s.position),
+				impressions: rowNumber(s.impressions),
+				rollingCtr: s.rollingCtr == null ? null : rowNumber(s.rollingCtr),
+				rollingStddev: s.rollingStddev == null ? null : rowNumber(s.rollingStddev),
+				z: rowNumber(s.z),
+				breach: rowBoolean(s.breach)
 			}))
 		}));
 		const totalClicksLost = anomalies.reduce((s, a) => s + a.clicksLost, 0);
@@ -2035,24 +1950,6 @@ const ctrAnomalyAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function num$2(v) {
-	if (typeof v === "number") return v;
-	if (typeof v === "bigint") return Number(v);
-	if (v == null) return 0;
-	const n = Number(v);
-	return Number.isFinite(n) ? n : 0;
-}
-function str$14(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$10(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const ctrCurveAnalyzer = defineAnalyzer$1({
 	id: "ctr-curve",
 	buildSql(params) {
@@ -2147,22 +2044,22 @@ const ctrCurveAnalyzer = defineAnalyzer$1({
 		const arr = Array.isArray(rows) ? rows : [];
 		const { startDate, endDate } = periodOf$1(params);
 		const row = arr[0] ?? {};
-		const curve = parseJsonList$10(row.curve_json).map((r) => ({
-			bucket: str$14(r.bucket),
-			avgCtr: num$2(r.avgCtr),
-			medianPosition: num$2(r.medianPosition),
-			keywordCount: num$2(r.keywordCount),
-			totalClicks: num$2(r.totalClicks),
-			totalImpressions: num$2(r.totalImpressions)
+		const curve = parseJsonRows(row.curve_json).map((r) => ({
+			bucket: rowString(r.bucket),
+			avgCtr: rowNumber(r.avgCtr),
+			medianPosition: rowNumber(r.medianPosition),
+			keywordCount: rowNumber(r.keywordCount),
+			totalClicks: rowNumber(r.totalClicks),
+			totalImpressions: rowNumber(r.totalImpressions)
 		}));
-		const outliers = parseJsonList$10(row.outliers_json).map((r) => ({
-			query: str$14(r.query),
-			clicks: num$2(r.clicks),
-			impressions: num$2(r.impressions),
-			ctr: num$2(r.ctr),
-			position: num$2(r.position),
-			expectedCtr: num$2(r.expectedCtr),
-			ctrDiff: num$2(r.ctrDiff)
+		const outliers = parseJsonRows(row.outliers_json).map((r) => ({
+			query: rowString(r.query),
+			clicks: rowNumber(r.clicks),
+			impressions: rowNumber(r.impressions),
+			ctr: rowNumber(r.ctr),
+			position: rowNumber(r.position),
+			expectedCtr: rowNumber(r.expectedCtr),
+			ctrDiff: rowNumber(r.ctrDiff)
 		}));
 		return {
 			results: curve,
@@ -2175,17 +2072,6 @@ const ctrCurveAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function str$13(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$9(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const darkTrafficAnalyzer = defineAnalyzer$1({
 	id: "dark-traffic",
 	buildSql(params) {
@@ -2287,8 +2173,8 @@ const darkTrafficAnalyzer = defineAnalyzer$1({
 		const darkClicks = Math.max(0, totalClicks - attributedClicks);
 		const darkPercent = totalClicks > 0 ? darkClicks / totalClicks : 0;
 		return {
-			results: parseJsonList$9(row.pages_json).map((r) => ({
-				url: str$13(r.url),
+			results: parseJsonRows(row.pages_json).map((r) => ({
+				url: rowString(r.url),
 				totalClicks: num$1(r.totalClicks),
 				attributedClicks: num$1(r.attributedClicks),
 				darkClicks: num$1(r.darkClicks),
@@ -3040,17 +2926,6 @@ const sortResults$1 = createMetricSorter("lostClicks", {
 	declinePercent: "desc",
 	currentClicks: "asc"
 });
-function str$12(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$8(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 function analyzeDecay(input, options = {}) {
 	const { minPreviousClicks = 50, threshold = .2, sortBy = "lostClicks" } = options;
 	const currentMap = buildPeriodMap(input.current, (r) => r.page, (r) => ({
@@ -3177,7 +3052,7 @@ const decayAnalyzer = defineAnalyzer$1({
 	},
 	reduceSql(rows, params) {
 		const mapped = (Array.isArray(rows) ? rows : []).map((r) => ({
-			page: str$12(r.page),
+			page: rowString(r.page),
 			currentClicks: num$1(r.currentClicks),
 			previousClicks: num$1(r.previousClicks),
 			lostClicks: num$1(r.lostClicks),
@@ -3185,8 +3060,8 @@ const decayAnalyzer = defineAnalyzer$1({
 			currentPosition: num$1(r.currentPosition),
 			previousPosition: num$1(r.previousPosition),
 			positionDrop: num$1(r.positionDrop),
-			series: parseJsonList$8(r.seriesJson).map((s) => ({
-				week: str$12(s.week),
+			series: parseJsonRows(r.seriesJson).map((s) => ({
+				week: rowString(s.week),
 				clicks: num$1(s.clicks),
 				impressions: num$1(s.impressions)
 			}))
@@ -3224,9 +3099,6 @@ const decayAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function str$11(v) {
-	return v == null ? "" : String(v);
-}
 const deviceGapAnalyzer = defineAnalyzer$1({
 	id: "device-gap",
 	buildSql(params) {
@@ -3277,8 +3149,8 @@ const deviceGapAnalyzer = defineAnalyzer$1({
 		const arr = Array.isArray(rows) ? rows : [];
 		const { startDate, endDate } = periodOf$1(params);
 		const typed = arr.map((r) => ({
-			date: str$11(r.date),
-			device: str$11(r.device).toUpperCase(),
+			date: rowString(r.date),
+			device: rowString(r.device).toUpperCase(),
 			clicks: num$1(r.clicks),
 			impressions: num$1(r.impressions),
 			ctr: num$1(r.ctr),
@@ -3356,17 +3228,6 @@ const deviceGapAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function str$10(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$7(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const INTENT_ATLAS_STOP_WORDS = [
 	"the",
 	"a",
@@ -3509,14 +3370,14 @@ const intentAtlasAnalyzer = defineAnalyzer$1({
 	},
 	reduceSql(rows) {
 		const clusters = (Array.isArray(rows) ? rows : []).map((r) => ({
-			clusterKey: str$10(r.clusterKey),
+			clusterKey: rowString(r.clusterKey),
 			keywordCount: num$1(r.keywordCount),
 			totalImpressions: num$1(r.totalImpressions),
 			totalClicks: num$1(r.totalClicks),
 			ctr: num$1(r.ctr),
 			avgPosition: num$1(r.avgPosition),
-			keywords: parseJsonList$7(r.keywords).slice(0, 25).map((k) => ({
-				query: str$10(k.query),
+			keywords: parseJsonRows(r.keywords).slice(0, 25).map((k) => ({
+				query: rowString(k.query),
 				impressions: num$1(k.impressions),
 				clicks: num$1(k.clicks),
 				position: num$1(k.position)
@@ -3534,17 +3395,6 @@ const intentAtlasAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function str$9(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$6(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const keywordBreadthAnalyzer = defineAnalyzer$1({
 	id: "keyword-breadth",
 	buildSql(params) {
@@ -3619,18 +3469,18 @@ const keywordBreadthAnalyzer = defineAnalyzer$1({
 		const arr = Array.isArray(rows) ? rows : [];
 		const { startDate, endDate } = periodOf$1(params);
 		const row = arr[0] ?? {};
-		const distribution = parseJsonList$6(row.distribution_json).sort((a, b) => num$1(a.sortKey) - num$1(b.sortKey)).map((r) => ({
-			bucket: str$9(r.bucket),
+		const distribution = parseJsonRows(row.distribution_json).sort((a, b) => num$1(a.sortKey) - num$1(b.sortKey)).map((r) => ({
+			bucket: rowString(r.bucket),
 			pageCount: num$1(r.pageCount)
 		}));
-		const fragile = parseJsonList$6(row.fragile_json).map((r) => ({
-			url: str$9(r.url),
+		const fragile = parseJsonRows(row.fragile_json).map((r) => ({
+			url: rowString(r.url),
 			keywordCount: num$1(r.keywordCount),
 			clicks: num$1(r.clicks),
 			impressions: num$1(r.impressions)
 		}));
-		const authority = parseJsonList$6(row.authority_json).map((r) => ({
-			url: str$9(r.url),
+		const authority = parseJsonRows(row.authority_json).map((r) => ({
+			url: rowString(r.url),
 			keywordCount: num$1(r.keywordCount),
 			clicks: num$1(r.clicks),
 			impressions: num$1(r.impressions)
@@ -3653,23 +3503,12 @@ const keywordBreadthAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function str$8(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$5(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 function downsampleLogRank(points) {
 	const all = points.map((p) => ({
 		rank: num$1(p.rank),
 		impressions: num$1(p.impressions),
 		clicks: num$1(p.clicks),
-		query: str$8(p.query)
+		query: rowString(p.query)
 	}));
 	if (all.length <= 80) return all;
 	const top = all.slice(0, 10);
@@ -3778,7 +3617,7 @@ const longTailAnalyzer = defineAnalyzer$1({
 	},
 	reduceSql(rows) {
 		const results = (Array.isArray(rows) ? rows : []).map((r) => ({
-			page: str$8(r.page),
+			page: rowString(r.page),
 			queryCount: num$1(r.queryCount),
 			totalImpressions: num$1(r.totalImpressions),
 			totalClicks: num$1(r.totalClicks),
@@ -3787,8 +3626,8 @@ const longTailAnalyzer = defineAnalyzer$1({
 			r2: num$1(r.r2),
 			headImpressions: num$1(r.headImpressions),
 			headShare: num$1(r.headShare),
-			fingerprint: str$8(r.fingerprint),
-			points: downsampleLogRank(parseJsonList$5(r.pointsJson))
+			fingerprint: rowString(r.fingerprint),
+			points: downsampleLogRank(parseJsonRows(r.pointsJson))
 		}));
 		const counts = {
 			"flat-tail": 0,
@@ -3806,17 +3645,6 @@ const longTailAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function str$7(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$4(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 function withCanonicalFields(r) {
 	return {
 		...r,
@@ -4042,8 +3870,8 @@ const moversAnalyzer = defineAnalyzer$1({
 			const baselineImpressions = Math.round(num$1(r.baselineImpressions));
 			const baselinePosition = num$1(r.baselinePosition);
 			return {
-				keyword: str$7(r.keyword),
-				page: r.page == null ? null : str$7(r.page),
+				keyword: rowString(r.keyword),
+				page: r.page == null ? null : rowString(r.page),
 				recentClicks,
 				recentImpressions,
 				recentPosition,
@@ -4054,9 +3882,9 @@ const moversAnalyzer = defineAnalyzer$1({
 				clicksChangePercent: num$1(r.clicksChangePercent),
 				impressionsChangePercent: num$1(r.impressionsChangePercent),
 				positionChange: num$1(r.positionChange),
-				direction: str$7(r.direction),
-				series: parseJsonList$4(r.seriesJson).map((s) => ({
-					week: str$7(s.week),
+				direction: rowString(r.direction),
+				series: parseJsonRows(r.seriesJson).map((s) => ({
+					week: rowString(s.week),
 					clicks: num$1(s.clicks),
 					impressions: num$1(s.impressions)
 				}))
@@ -4292,9 +4120,6 @@ const opportunityAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function str$6(v) {
-	return v == null ? "" : String(v);
-}
 const positionDistributionAnalyzer = defineAnalyzer$1({
 	id: "position-distribution",
 	buildSql(params) {
@@ -4331,7 +4156,7 @@ const positionDistributionAnalyzer = defineAnalyzer$1({
 		const { startDate, endDate } = periodOf$1(params);
 		return {
 			results: arr.map((r) => ({
-				date: str$6(r.date),
+				date: rowString(r.date),
 				pos_1_3: num$1(r.pos_1_3),
 				pos_4_10: num$1(r.pos_4_10),
 				pos_11_20: num$1(r.pos_11_20),
@@ -4346,9 +4171,6 @@ const positionDistributionAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function str$5(v) {
-	return v == null ? "" : String(v);
-}
 const positionVolatilityAnalyzer = defineAnalyzer$1({
 	id: "position-volatility",
 	buildSql(params) {
@@ -4449,8 +4271,8 @@ const positionVolatilityAnalyzer = defineAnalyzer$1({
 		const byPage = /* @__PURE__ */ new Map();
 		const allDates = /* @__PURE__ */ new Set();
 		for (const r of arr) {
-			const page = str$5(r.page);
-			const date = str$5(r.date);
+			const page = rowString(r.page);
+			const date = rowString(r.date);
 			allDates.add(date);
 			const entry = byPage.get(page) ?? {
 				page,
@@ -4485,17 +4307,6 @@ const positionVolatilityAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function str$4(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$3(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const queryMigrationAnalyzer = defineAnalyzer$1({
 	id: "query-migration",
 	buildSql(params) {
@@ -4617,17 +4428,17 @@ const queryMigrationAnalyzer = defineAnalyzer$1({
 			prevStart = toIsoDate(new Date(curStartMs - MS_PER_DAY - span));
 		}
 		const edges = arr.map((r) => ({
-			sourcePage: str$4(r.source_page),
-			targetPage: str$4(r.target_page),
+			sourcePage: rowString(r.source_page),
+			targetPage: rowString(r.target_page),
 			weight: num$1(r.weight),
 			queryCount: num$1(r.query_count),
 			exactCount: num$1(r.exact_count),
 			fuzzyCount: num$1(r.query_count) - num$1(r.exact_count),
-			examples: parseJsonList$3(r.examplesJson).slice(0, 8).map((e) => ({
-				sourceQuery: str$4(e.sourceQuery),
-				targetQuery: str$4(e.targetQuery),
+			examples: parseJsonRows(r.examplesJson).slice(0, 8).map((e) => ({
+				sourceQuery: rowString(e.sourceQuery),
+				targetQuery: rowString(e.targetQuery),
 				absorbed: num$1(e.absorbed),
-				matchType: str$4(e.matchType)
+				matchType: rowString(e.matchType)
 			}))
 		}));
 		const nodeAgg = /* @__PURE__ */ new Map();
@@ -4666,12 +4477,6 @@ const queryMigrationAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function str$3(v) {
-	return v == null ? "" : String(v);
-}
-function bool$1(v) {
-	return v === true || v === 1 || v === "true";
-}
 function calculateCV(values) {
 	if (values.length === 0) return 0;
 	const mean = values.reduce((a, b) => a + b, 0) / values.length;
@@ -4765,11 +4570,11 @@ const seasonalityAnalyzer = defineAnalyzer$1({
 	reduceSql(rows) {
 		const arr = Array.isArray(rows) ? rows : [];
 		const breakdown = arr.map((r) => ({
-			month: str$3(r.month),
+			month: rowString(r.month),
 			value: num$1(r.value),
 			vsAverage: num$1(r.vsAverage),
-			isPeak: bool$1(r.isPeak),
-			isTrough: bool$1(r.isTrough)
+			isPeak: rowBoolean(r.isPeak),
+			isTrough: rowBoolean(r.isTrough)
 		}));
 		const first = arr[0];
 		const strength = first ? num$1(first.strength) : 0;
@@ -4801,20 +4606,6 @@ const seasonalityAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function str$2(v) {
-	return v == null ? "" : String(v);
-}
-function bool(v) {
-	return v === true || v === 1 || v === "true";
-}
-function parseJsonList$2(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const stlDecomposeAnalyzer = defineAnalyzer$1({
 	id: "stl-decompose",
 	buildSql(params) {
@@ -4967,21 +4758,21 @@ const stlDecomposeAnalyzer = defineAnalyzer$1({
 		const arr = Array.isArray(rows) ? rows : [];
 		const metric = params.metric === "clicks" ? "clicks" : "impressions";
 		const results = arr.map((r) => ({
-			keyword: str$2(r.keyword),
-			page: str$2(r.page),
+			keyword: rowString(r.keyword),
+			page: rowString(r.page),
 			totalImpressions: num$1(r.totalImpressions),
 			days: num$1(r.days),
 			seasonalStrength: num$1(r.seasonalStrength),
 			trendStrength: num$1(r.trendStrength),
 			residualAnomalies: num$1(r.residualAnomalies),
 			trendSlope: num$1(r.trendSlope),
-			series: parseJsonList$2(r.seriesJson).map((s) => ({
-				date: str$2(s.date),
+			series: parseJsonRows(r.seriesJson).map((s) => ({
+				date: rowString(s.date),
 				observed: num$1(s.observed),
 				trend: s.trend == null ? null : num$1(s.trend),
 				seasonal: s.seasonal == null ? null : num$1(s.seasonal),
 				residual: s.residual == null ? null : num$1(s.residual),
-				anomaly: bool(s.anomaly)
+				anomaly: rowBoolean(s.anomaly)
 			}))
 		}));
 		return {
@@ -5064,17 +4855,6 @@ const strikingDistanceAnalyzer = defineAnalyzer$1({
 		return { queries: queriesQueryState(periodOf$1(params), params.limit ?? DEFAULT_ROW_LIMIT$1) };
 	}
 });
-function str$1(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList$1(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const survivalAnalyzer = defineAnalyzer$1({
 	id: "survival",
 	buildSql(params) {
@@ -5227,7 +5007,7 @@ const survivalAnalyzer = defineAnalyzer$1({
 		const startDate = params.startDate ?? daysAgo(183);
 		const windowDays = Math.round((new Date(endDate).getTime() - new Date(startDate).getTime()) / MS_PER_DAY) + 1;
 		const results = arr.map((r) => {
-			const curve = parseJsonList$1(r.curveJson).map((p) => ({
+			const curve = parseJsonRows(r.curveJson).map((p) => ({
 				tenure: num$1(p.tenure),
 				survival: num$1(p.survival),
 				atRisk: num$1(p.atRisk),
@@ -5250,7 +5030,7 @@ const survivalAnalyzer = defineAnalyzer$1({
 			const last = curve[curve.length - 1];
 			if (medianTenure === 0 && last && last.survival > .5) medianTenure = last.tenure;
 			return {
-				cohort: str$1(r.cohort),
+				cohort: rowString(r.cohort),
 				episodeCount: num$1(r.episodeCount),
 				censoringRate: num$1(r.censoringRate),
 				medianTenure,
@@ -5267,17 +5047,6 @@ const survivalAnalyzer = defineAnalyzer$1({
 		};
 	}
 });
-function str(v) {
-	return v == null ? "" : String(v);
-}
-function parseJsonList(v) {
-	if (Array.isArray(v)) return v;
-	if (typeof v === "string" && v.length > 0) {
-		const parsed = JSON.parse(v);
-		return Array.isArray(parsed) ? parsed : [];
-	}
-	return [];
-}
 const trendsAnalyzer = defineAnalyzer$1({
 	id: "trends",
 	buildSql(params) {
@@ -5388,20 +5157,20 @@ const trendsAnalyzer = defineAnalyzer$1({
 		const startDate = params.startDate || toIsoDate(/* @__PURE__ */ new Date(Date.parse(endDate) - (weeks * 7 - 1) * MS_PER_DAY));
 		const dim = params.dimension === "keywords" ? "keywords" : "pages";
 		const results = arr.map((r) => {
-			const series = parseJsonList(r.seriesJson).map((s) => ({
-				week: str(s.week),
+			const series = parseJsonRows(r.seriesJson).map((s) => ({
+				week: rowString(s.week),
 				clicks: num$1(s.clicks),
 				impressions: num$1(s.impressions)
 			}));
 			return {
-				[dim === "keywords" ? "query" : "page"]: str(r.entity),
+				[dim === "keywords" ? "query" : "page"]: rowString(r.entity),
 				totalClicks: num$1(r.totalClicks),
 				totalImpressions: num$1(r.totalImpressions),
 				weeksWithData: num$1(r.weeksWithData),
 				slope: num$1(r.slope),
 				growthRatio: num$1(r.growthRatio),
 				avgPosition: num$1(r.avgPosition),
-				trend: str(r.trend),
+				trend: rowString(r.trend),
 				series
 			};
 		});
@@ -5639,6 +5408,27 @@ function requireComparisonWindowResult(report, window, message) {
 function requireComparisonWindow(report, window, message) {
 	return unwrapResult(requireComparisonWindowResult(report, window, message), analysisErrorToException);
 }
+function reportRows(result) {
+	return result?.results ?? [];
+}
+function sectionCoverage(result) {
+	return result ? "full" : "partial";
+}
+function sectionArtifact(result, analyzer, params = {}) {
+	return result ? {
+		analyzer,
+		params: {
+			type: analyzer,
+			...params
+		}
+	} : void 0;
+}
+function truncation(total, kept) {
+	return total > kept ? {
+		kept,
+		total
+	} : void 0;
+}
 const DEFAULT_MAX$7 = 5;
 const brandReport = defineReport({
 	id: "brand",
@@ -5688,7 +5478,7 @@ const brandReport = defineReport({
 	}
 });
 function buildBrandSplitSection(res, max) {
-	const rows = res?.results ?? [];
+	const rows = reportRows(res);
 	const summary = res?.meta?.summary;
 	const findings = rows.filter((r) => r.segment === "brand").sort((a, b) => b.clicks - a.clicks).slice(0, max).map((r) => ({
 		entity: {
@@ -5710,16 +5500,13 @@ function buildBrandSplitSection(res, max) {
 		severity: "info",
 		summary: { magnitudeLabel: summary ? `brand share ${(brandShare * 100).toFixed(1)}% (${summary.brandClicks} brand vs ${summary.nonBrandClicks} non-brand clicks)` : "no summary available" },
 		findings,
-		coverage: res ? "full" : "partial",
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "brand",
-			params: { type: "brand" }
-		} : void 0
+		artifact: sectionArtifact(res, "brand")
 	};
 }
 function buildConcentrationSection(res, max) {
-	const head = (res?.results ?? [])[0];
+	const head = reportRows(res)[0];
 	const findings = (head?.topNItems ?? []).slice(0, max).map((it) => ({
 		entity: {
 			kind: "query",
@@ -5737,15 +5524,9 @@ function buildConcentrationSection(res, max) {
 		severity: head ? severity : "info",
 		summary: head ? { magnitudeLabel: `HHI ${head.hhi.toFixed(0)} (${head.riskLevel}); top-N share ${(head.topNConcentration * 100).toFixed(1)}%` } : {},
 		findings,
-		coverage: res ? "full" : "partial",
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "concentration",
-			params: {
-				type: "concentration",
-				dimension: "keywords"
-			}
-		} : void 0
+		artifact: sectionArtifact(res, "concentration", { dimension: "keywords" })
 	};
 }
 const DEFAULT_MAX$6 = 5;
@@ -5811,7 +5592,7 @@ const growthReport = defineReport({
 	}
 });
 function buildContentVelocity(res) {
-	const rows = res?.results ?? [];
+	const rows = reportRows(res);
 	const totalNew = rows.reduce((s, r) => s + r.newKeywords, 0);
 	const avgPerWeek = rows.length > 0 ? totalNew / rows.length : 0;
 	return {
@@ -5820,16 +5601,13 @@ function buildContentVelocity(res) {
 		severity: "info",
 		summary: { magnitudeLabel: `${totalNew} new keywords across ${rows.length} weeks (avg ${avgPerWeek.toFixed(1)}/wk)` },
 		findings: [],
-		coverage: res ? "full" : "partial",
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "content-velocity",
-			params: { type: "content-velocity" }
-		} : void 0
+		artifact: sectionArtifact(res, "content-velocity")
 	};
 }
 function buildKeywordBreadth(res) {
-	const rows = res?.results ?? [];
+	const rows = reportRows(res);
 	const totalPages = rows.reduce((s, r) => s + r.pageCount, 0);
 	const top = rows[0];
 	return {
@@ -5838,32 +5616,26 @@ function buildKeywordBreadth(res) {
 		severity: "info",
 		summary: { magnitudeLabel: top ? `${totalPages} pages; modal bucket "${top.bucket}" (${top.pageCount} pages)` : "no data" },
 		findings: [],
-		coverage: res ? "full" : "partial",
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "keyword-breadth",
-			params: { type: "keyword-breadth" }
-		} : void 0
+		artifact: sectionArtifact(res, "keyword-breadth")
 	};
 }
 function buildIntentAtlas(res) {
-	const rows = res?.results ?? [];
+	const rows = reportRows(res);
 	return {
 		id: "intent-atlas",
 		title: "Intent atlas",
 		severity: "info",
 		summary: { magnitudeLabel: `${rows.length} clusters covering ${rows.reduce((s, r) => s + r.keywordCount, 0)} keywords` },
 		findings: [],
-		coverage: res ? "full" : "partial",
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "intent-atlas",
-			params: { type: "intent-atlas" }
-		} : void 0
+		artifact: sectionArtifact(res, "intent-atlas")
 	};
 }
 function buildLongTail(res, max) {
-	const rows = (res?.results ?? []).sort((a, b) => {
+	const rows = reportRows(res).sort((a, b) => {
 		const rank = {
 			"head-heavy": 0,
 			"balanced": 1,
@@ -5892,16 +5664,10 @@ function buildLongTail(res, max) {
 		severity: headHeavy > rows.length / 3 ? "medium" : "info",
 		summary: { magnitudeLabel: `${rows.length} pages analysed; ${headHeavy} head-heavy` },
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "long-tail",
-			params: { type: "long-tail" }
-		} : void 0
+		artifact: sectionArtifact(res, "long-tail")
 	};
 }
 const DEFAULT_MAX$5 = 5;
@@ -5958,7 +5724,7 @@ const healthReport = defineReport({
 	}
 });
 function buildCtrAnomalySection(res, max) {
-	const rows = (res?.results ?? []).filter((r) => r.breachDaysDown > 0).sort((a, b) => b.clicksLost - a.clicksLost);
+	const rows = reportRows(res).filter((r) => r.breachDaysDown > 0).sort((a, b) => b.clicksLost - a.clicksLost);
 	const kept = rows.slice(0, max);
 	const totalLost = kept.reduce((s, r) => s + r.clicksLost, 0);
 	const findings = kept.map((r) => ({
@@ -5984,20 +5750,14 @@ function buildCtrAnomalySection(res, max) {
 			magnitudeLabel: `${Math.round(totalLost)} clicks lost vs baseline`
 		},
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "ctr-anomaly",
-			params: { type: "ctr-anomaly" }
-		} : void 0
+		artifact: sectionArtifact(res, "ctr-anomaly")
 	};
 }
 function buildChangePointSection$1(res, max) {
-	const rows = (res?.results ?? []).filter((r) => r.direction === "worsened").sort((a, b) => b.llr - a.llr);
+	const rows = reportRows(res).filter((r) => r.direction === "worsened").sort((a, b) => b.llr - a.llr);
 	const kept = rows.slice(0, max);
 	const findings = kept.map((r) => ({
 		entity: {
@@ -6016,20 +5776,14 @@ function buildChangePointSection$1(res, max) {
 		severity: kept.length ? "medium" : "info",
 		summary: { magnitudeLabel: `${kept.length} worsening segments` },
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "change-point",
-			params: { type: "change-point" }
-		} : void 0
+		artifact: sectionArtifact(res, "change-point")
 	};
 }
 function buildPositionVolatilitySection(res, max) {
-	const rows = (res?.results ?? []).sort((a, b) => b.peakVolatility - a.peakVolatility);
+	const rows = reportRows(res).sort((a, b) => b.peakVolatility - a.peakVolatility);
 	const kept = rows.slice(0, max);
 	const findings = kept.map((r) => ({
 		entity: {
@@ -6048,16 +5802,10 @@ function buildPositionVolatilitySection(res, max) {
 		severity: kept.length ? "low" : "info",
 		summary: {},
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "position-volatility",
-			params: { type: "position-volatility" }
-		} : void 0
+		artifact: sectionArtifact(res, "position-volatility")
 	};
 }
 const DEFAULT_MAX$4 = 5;
@@ -6133,7 +5881,7 @@ const moversReport = defineReport({
 	}
 });
 function buildMoversSection(res, direction, max, minChange) {
-	const rows = (res?.results ?? []).filter((r) => r.direction === direction && Math.abs(r.clicksChange) >= minChange).sort((a, b) => Math.abs(b.clicksChange) - Math.abs(a.clicksChange));
+	const rows = reportRows(res).filter((r) => r.direction === direction && Math.abs(r.clicksChange) >= minChange).sort((a, b) => Math.abs(b.clicksChange) - Math.abs(a.clicksChange));
 	const total = rows.length;
 	const kept = rows.slice(0, max);
 	const findings = kept.map((r) => ({
@@ -6165,21 +5913,15 @@ function buildMoversSection(res, direction, max, minChange) {
 			direction: totalDelta > 0 ? "up" : totalDelta < 0 ? "down" : "flat"
 		},
 		findings,
-		truncated: total > max ? {
-			kept: kept.length,
-			total
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(total, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "movers",
-			params: { type: "movers" }
-		} : void 0
+		artifact: sectionArtifact(res, "movers")
 	};
 }
 function buildDeclinersSection(moversRes, decayRes, max, minChange) {
-	const decliningQueries = (moversRes?.results ?? []).filter((r) => r.direction === "declining" && Math.abs(r.clicksChange) >= minChange).slice(0, max);
-	const lostPages = (decayRes?.results ?? []).sort((a, b) => b.lostClicks - a.lostClicks).slice(0, max);
+	const decliningQueries = reportRows(moversRes).filter((r) => r.direction === "declining" && Math.abs(r.clicksChange) >= minChange).slice(0, max);
+	const lostPages = reportRows(decayRes).sort((a, b) => b.lostClicks - a.lostClicks).slice(0, max);
 	const findings = [...decliningQueries.map((r) => ({
 		entity: {
 			kind: "query",
@@ -6238,7 +5980,7 @@ function buildDeclinersSection(moversRes, decayRes, max, minChange) {
 	};
 }
 function buildStrikingSection$1(res, max) {
-	const rows = (res?.results ?? []).sort((a, b) => b.potentialClicks - a.potentialClicks);
+	const rows = reportRows(res).sort((a, b) => b.potentialClicks - a.potentialClicks);
 	const kept = rows.slice(0, max);
 	const findings = kept.map((r) => ({
 		entity: {
@@ -6259,16 +6001,10 @@ function buildStrikingSection$1(res, max) {
 		severity: "low",
 		summary: { magnitudeLabel: `${kept.reduce((s, r) => s + r.potentialClicks, 0)} potential clicks` },
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "striking-distance",
-			params: { type: "striking-distance" }
-		} : void 0
+		artifact: sectionArtifact(res, "striking-distance")
 	};
 }
 const DEFAULT_MAX$3 = 5;
@@ -6334,7 +6070,7 @@ const opportunitiesReport = defineReport({
 	}
 });
 function buildStrikingSection(res, max) {
-	const rows = (res?.results ?? []).sort((a, b) => b.potentialClicks - a.potentialClicks);
+	const rows = reportRows(res).sort((a, b) => b.potentialClicks - a.potentialClicks);
 	const kept = rows.slice(0, max);
 	const findings = kept.map((r) => ({
 		entity: {
@@ -6356,20 +6092,14 @@ function buildStrikingSection(res, max) {
 		severity: "low",
 		summary: { magnitudeLabel: `${Math.round(totalPotential)} potential clicks` },
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "striking-distance",
-			params: { type: "striking-distance" }
-		} : void 0
+		artifact: sectionArtifact(res, "striking-distance")
 	};
 }
 function buildOpportunitySection(res, max) {
-	const rows = (res?.results ?? []).sort((a, b) => b.opportunityScore - a.opportunityScore);
+	const rows = reportRows(res).sort((a, b) => b.opportunityScore - a.opportunityScore);
 	const kept = rows.slice(0, max);
 	return {
 		id: "low-ctr",
@@ -6390,11 +6120,8 @@ function buildOpportunitySection(res, max) {
 			},
 			why: r.page ? `low CTR on ${r.page}` : "low CTR vs position"
 		})),
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: kept.slice(0, 1).map((r) => ({
 			kind: "fix",
 			target: r.page ? {
@@ -6406,14 +6133,11 @@ function buildOpportunitySection(res, max) {
 			},
 			rationale: "Rewrite title/description to lift CTR at this position"
 		})),
-		artifact: res ? {
-			analyzer: "opportunity",
-			params: { type: "opportunity" }
-		} : void 0
+		artifact: sectionArtifact(res, "opportunity")
 	};
 }
 function buildZeroClickSection(res, max) {
-	const rows = (res?.results ?? []).sort((a, b) => b.impressions - a.impressions);
+	const rows = reportRows(res).sort((a, b) => b.impressions - a.impressions);
 	const kept = rows.slice(0, max);
 	const findings = kept.map((r) => ({
 		entity: {
@@ -6433,20 +6157,14 @@ function buildZeroClickSection(res, max) {
 		severity: "info",
 		summary: { magnitudeLabel: `${kept.reduce((s, r) => s + r.impressions, 0)} impressions wasted` },
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "zero-click",
-			params: { type: "zero-click" }
-		} : void 0
+		artifact: sectionArtifact(res, "zero-click")
 	};
 }
 function buildMigrationSection$1(res, max) {
-	const rows = (res?.results ?? []).sort((a, b) => b.weight - a.weight);
+	const rows = reportRows(res).sort((a, b) => b.weight - a.weight);
 	const kept = rows.slice(0, max);
 	return {
 		id: "query-migration",
@@ -6464,16 +6182,10 @@ function buildMigrationSection$1(res, max) {
 			},
 			why: `migrating from ${r.sourcePage}`
 		})),
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "query-migration",
-			params: { type: "query-migration" }
-		} : void 0
+		artifact: sectionArtifact(res, "query-migration")
 	};
 }
 const DEFAULT_MAX$2 = 10;
@@ -6524,7 +6236,7 @@ const prePublishReport = defineReport({
 	}
 });
 function buildCannibalizationSection$1(res, matches, max) {
-	const rows = (res?.results ?? []).filter((r) => matches(r.keyword) || (r.competitors ?? []).some((p) => matches(p.url))).sort((a, b) => b.totalClicks - a.totalClicks);
+	const rows = reportRows(res).filter((r) => matches(r.keyword) || (r.competitors ?? []).some((p) => matches(p.url))).sort((a, b) => b.totalClicks - a.totalClicks);
 	const kept = rows.slice(0, max);
 	const findings = kept.map((r) => {
 		const pageCount = r.competitorCount ?? r.competitors?.length ?? 0;
@@ -6547,23 +6259,17 @@ function buildCannibalizationSection$1(res, matches, max) {
 		severity: kept.length ? "high" : "info",
 		summary: { magnitudeLabel: kept.length ? `${kept.length} existing competition` : "no existing competition" },
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: kept.slice(0, 1).map(() => ({
 			kind: "fix",
 			rationale: "Decide before publishing: redirect existing page, target a different angle, or accept overlap."
 		})),
-		artifact: res ? {
-			analyzer: "cannibalization",
-			params: { type: "cannibalization" }
-		} : void 0
+		artifact: sectionArtifact(res, "cannibalization")
 	};
 }
 function buildStrikingPeersSection(res, matches, max, topic) {
-	const rows = (res?.results ?? []).filter((r) => matches(r.keyword) || matches(r.page)).sort((a, b) => b.potentialClicks - a.potentialClicks);
+	const rows = reportRows(res).filter((r) => matches(r.keyword) || matches(r.page)).sort((a, b) => b.potentialClicks - a.potentialClicks);
 	const kept = rows.slice(0, max);
 	const findings = kept.map((r) => ({
 		entity: {
@@ -6583,16 +6289,10 @@ function buildStrikingPeersSection(res, matches, max, topic) {
 		severity: kept.length ? "low" : "info",
 		summary: { magnitudeLabel: kept.length ? `${kept.length} adjacent rankings for "${topic}"` : "no adjacent rankings" },
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "striking-distance",
-			params: { type: "striking-distance" }
-		} : void 0
+		artifact: sectionArtifact(res, "striking-distance")
 	};
 }
 const DEFAULT_LIMIT = 40;
@@ -6758,7 +6458,7 @@ const risksReport = defineReport({
 	}
 });
 function buildDecaySection(res, max) {
-	const rows = (res?.results ?? []).sort((a, b) => b.lostClicks - a.lostClicks);
+	const rows = reportRows(res).sort((a, b) => b.lostClicks - a.lostClicks);
 	const kept = rows.slice(0, max);
 	const totalLost = kept.reduce((s, r) => s + r.lostClicks, 0);
 	const findings = kept.map((r) => ({
@@ -6788,11 +6488,8 @@ function buildDecaySection(res, max) {
 			magnitudeLabel: `${Math.round(totalLost)} clicks lost`
 		},
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: kept.slice(0, 1).map((r) => ({
 			kind: "analyzer",
 			target: {
@@ -6802,14 +6499,11 @@ function buildDecaySection(res, max) {
 			params: { type: "change-point" },
 			rationale: "Investigate change-point on the worst-affected page"
 		})),
-		artifact: res ? {
-			analyzer: "decay",
-			params: { type: "decay" }
-		} : void 0
+		artifact: sectionArtifact(res, "decay")
 	};
 }
 function buildCannibalizationSection(res, max) {
-	const rows = (res?.results ?? []).sort((a, b) => b.totalClicks - a.totalClicks);
+	const rows = reportRows(res).sort((a, b) => b.totalClicks - a.totalClicks);
 	const kept = rows.slice(0, max);
 	const findings = kept.map((r) => {
 		const pageCount = r.competitorCount ?? r.competitors?.length ?? 0;
@@ -6832,20 +6526,14 @@ function buildCannibalizationSection(res, max) {
 		severity: kept.length ? "medium" : "info",
 		summary: {},
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "cannibalization",
-			params: { type: "cannibalization" }
-		} : void 0
+		artifact: sectionArtifact(res, "cannibalization")
 	};
 }
 function buildDarkTrafficSection(res, max) {
-	const rows = (res?.results ?? []).sort((a, b) => b.darkClicks - a.darkClicks);
+	const rows = reportRows(res).sort((a, b) => b.darkClicks - a.darkClicks);
 	const kept = rows.slice(0, max);
 	const totalDark = kept.reduce((s, r) => s + r.darkClicks, 0);
 	const findings = kept.map((r) => ({
@@ -6865,20 +6553,14 @@ function buildDarkTrafficSection(res, max) {
 		severity: kept.length ? "low" : "info",
 		summary: { magnitudeLabel: `${Math.round(totalDark)} unattributed clicks` },
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "dark-traffic",
-			params: { type: "dark-traffic" }
-		} : void 0
+		artifact: sectionArtifact(res, "dark-traffic")
 	};
 }
 function buildDeviceGapSection(res, max) {
-	const rows = (res?.results ?? []).sort((a, b) => Math.abs(b.gaps.positionGap) - Math.abs(a.gaps.positionGap));
+	const rows = reportRows(res).sort((a, b) => Math.abs(b.gaps.positionGap) - Math.abs(a.gaps.positionGap));
 	const kept = rows.slice(0, max);
 	return {
 		id: "device-gap",
@@ -6898,16 +6580,10 @@ function buildDeviceGapSection(res, max) {
 			},
 			why: `desktop vs mobile delta`
 		})),
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "device-gap",
-			params: { type: "device-gap" }
-		} : void 0
+		artifact: sectionArtifact(res, "device-gap")
 	};
 }
 function resolveTarget(opts) {
@@ -7014,7 +6690,7 @@ const triageReport = defineReport({
 	}
 });
 function buildChangePointSection(res, kind, matches, max) {
-	const rows = (res?.results ?? []).filter((r) => matches(kind === "page" ? r.page : r.keyword)).sort((a, b) => b.llr - a.llr);
+	const rows = reportRows(res).filter((r) => matches(kind === "page" ? r.page : r.keyword)).sort((a, b) => b.llr - a.llr);
 	const kept = rows.slice(0, max);
 	const findings = kept.map((r) => ({
 		entity: {
@@ -7033,20 +6709,14 @@ function buildChangePointSection(res, kind, matches, max) {
 		severity: kept.length ? "medium" : "info",
 		summary: { magnitudeLabel: `${kept.length} change-point${kept.length === 1 ? "" : "s"}` },
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "change-point",
-			params: { type: "change-point" }
-		} : void 0
+		artifact: sectionArtifact(res, "change-point")
 	};
 }
 function buildMigrationSection(res, kind, matches, max, _rawTarget) {
-	const rows = (res?.results ?? []).filter((r) => kind === "page" ? matches(r.sourcePage) || matches(r.targetPage) : false).sort((a, b) => b.weight - a.weight);
+	const rows = reportRows(res).filter((r) => kind === "page" ? matches(r.sourcePage) || matches(r.targetPage) : false).sort((a, b) => b.weight - a.weight);
 	const kept = rows.slice(0, max);
 	const findings = kept.map((r) => ({
 		entity: {
@@ -7065,20 +6735,14 @@ function buildMigrationSection(res, kind, matches, max, _rawTarget) {
 		severity: "info",
 		summary: { magnitudeLabel: kind === "page" ? `${kept.length} migration edges touching target` : "N/A for query target" },
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "query-migration",
-			params: { type: "query-migration" }
-		} : void 0
+		artifact: sectionArtifact(res, "query-migration")
 	};
 }
 function buildVolatilitySection(res, kind, matches, max) {
-	const rows = kind === "page" ? (res?.results ?? []).filter((r) => matches(r.page)) : [];
+	const rows = kind === "page" ? reportRows(res).filter((r) => matches(r.page)) : [];
 	const kept = rows.sort((a, b) => b.peakVolatility - a.peakVolatility).slice(0, max);
 	const findings = kept.map((r) => ({
 		entity: {
@@ -7097,16 +6761,10 @@ function buildVolatilitySection(res, kind, matches, max) {
 		severity: kept.length ? "low" : "info",
 		summary: { magnitudeLabel: kind === "page" ? `${kept.length} volatile day${kept.length === 1 ? "" : "s"}` : "N/A for query target" },
 		findings,
-		truncated: rows.length > max ? {
-			kept: kept.length,
-			total: rows.length
-		} : void 0,
-		coverage: res ? "full" : "partial",
+		truncated: truncation(rows.length, kept.length),
+		coverage: sectionCoverage(res),
 		actions: [],
-		artifact: res ? {
-			analyzer: "position-volatility",
-			params: { type: "position-volatility" }
-		} : void 0
+		artifact: sectionArtifact(res, "position-volatility")
 	};
 }
 const REPORTS = [