@gscdump/analysis 0.35.2 → 0.35.3

package/dist/analyzer/index.d.mts

@@ -338,9 +338,11 @@ interface DecayResult {
   previousClicks: number;
   lostClicks: number;
   declinePercent: number;
-  currentPosition: number;
+  /** `null` when the page had no ranking data in the current period (not "position 0"). */
+  currentPosition: number | null;
   previousPosition: number;
-  positionDrop: number;
+  /** `null` unless both currentPosition and previousPosition exist. */
+  positionDrop: number | null;
   series?: DecaySeriesPoint[];
 }
 declare const decayAnalyzer: import("@gscdump/engine/analyzer").DefinedAnalyzer;
@@ -443,11 +445,13 @@ interface MoverData {
   recentPosition: number;
   baselineClicks: number;
   baselineImpressions: number;
-  baselinePosition: number;
+  /** `null` when the keyword has no previous-period data (a genuinely new query), not "position 0". */
+  baselinePosition: number | null;
   clicksChange: number;
   clicksChangePercent: number;
   impressionsChangePercent: number;
-  positionChange: number;
+  /** `null` unless both recentPosition and baselinePosition exist. */
+  positionChange: number | null;
 }
 interface MoversResult {
   rising: MoverData[];
@@ -467,7 +471,7 @@ interface MoversResultRow extends MoverData {
   position: number;
   prevClicks: number;
   prevImpressions: number;
-  prevPosition: number;
+  prevPosition: number | null;
   series?: MoversSeriesPoint[];
 }
 declare const moversAnalyzer: import("@gscdump/engine/analyzer").DefinedAnalyzer;

package/dist/analyzer/index.mjs

@@ -914,6 +914,7 @@ const changePointAnalyzer = defineAnalyzer({
 		const metric = params.metric === "clicks" || params.metric === "impressions" ? params.metric : "position";
 		const limit = params.limit ?? 100;
 		const valueExpr = metric === "position" ? METRIC_EXPR.position : `CAST(SUM(${metric}) AS DOUBLE)`;
+		const weightExpr = metric === "position" ? METRIC_EXPR.impressions : "1.0";
 		return {
 			sql: `
     WITH daily AS (
@@ -926,7 +927,8 @@ const changePointAnalyzer = defineAnalyzer({
         CAST(date AS DATE) AS date,
         ${METRIC_EXPR.clicks} AS clicks,
         ${METRIC_EXPR.impressions} AS impressions,
-        ${valueExpr} AS value
+        ${valueExpr} AS value,
+        ${weightExpr} AS weight
       FROM read_parquet({{FILES}}, union_by_name = true)
       WHERE date >= ? AND date <= ?
         AND query IS NOT NULL AND query <> ''
@@ -938,8 +940,9 @@ const changePointAnalyzer = defineAnalyzer({
       SELECT query, page,
         COUNT(*) AS n_total,
         SUM(impressions) AS total_impressions,
-        SUM(value) AS sum_total,
-        SUM(value * value) AS sumsq_total
+        SUM(weight) AS w_total,
+        SUM(value * weight) AS sum_total,
+        SUM(value * value * weight) AS sumsq_total
       FROM daily
       GROUP BY query, page
       HAVING COUNT(*) >= ${Number(minDays)}
@@ -947,15 +950,16 @@ const changePointAnalyzer = defineAnalyzer({
     ),
     filtered AS (
       SELECT d.*,
-        e.n_total, e.sum_total, e.sumsq_total, e.total_impressions
+        e.n_total, e.w_total, e.sum_total, e.sumsq_total, e.total_impressions
       FROM daily d
       JOIN entity_stats e USING (query, page)
     ),
     cumulated AS (
       SELECT *,
         COUNT(*) OVER w AS n_left,
-        SUM(value) OVER w AS sum_left,
-        SUM(value * value) OVER w AS sumsq_left
+        SUM(weight) OVER w AS w_left,
+        SUM(value * weight) OVER w AS sum_left,
+        SUM(value * value * weight) OVER w AS sumsq_left
       FROM filtered
       WINDOW w AS (
         PARTITION BY query, page
@@ -966,22 +970,23 @@ const changePointAnalyzer = defineAnalyzer({
     llr_scored AS (
       SELECT *,
         (n_total - n_left) AS n_right,
+        (w_total - w_left) AS w_right,
         (sum_total - sum_left) AS sum_right,
         (sumsq_total - sumsq_left) AS sumsq_right,
         GREATEST(
-          (sumsq_left / NULLIF(n_left, 0))
-            - (sum_left / NULLIF(n_left, 0)) * (sum_left / NULLIF(n_left, 0)),
+          (sumsq_left / NULLIF(w_left, 0))
+            - (sum_left / NULLIF(w_left, 0)) * (sum_left / NULLIF(w_left, 0)),
           1e-9
         ) AS var_left,
         GREATEST(
-          ((sumsq_total - sumsq_left) / NULLIF(n_total - n_left, 0))
-            - ((sum_total - sum_left) / NULLIF(n_total - n_left, 0))
-              * ((sum_total - sum_left) / NULLIF(n_total - n_left, 0)),
+          ((sumsq_total - sumsq_left) / NULLIF(w_total - w_left, 0))
+            - ((sum_total - sum_left) / NULLIF(w_total - w_left, 0))
+              * ((sum_total - sum_left) / NULLIF(w_total - w_left, 0)),
           1e-9
         ) AS var_right,
         GREATEST(
-          (sumsq_total / NULLIF(n_total, 0))
-            - (sum_total / NULLIF(n_total, 0)) * (sum_total / NULLIF(n_total, 0)),
+          (sumsq_total / NULLIF(w_total, 0))
+            - (sum_total / NULLIF(w_total, 0)) * (sum_total / NULLIF(w_total, 0)),
           1e-9
         ) AS var_single
       FROM cumulated
@@ -1001,8 +1006,8 @@ const changePointAnalyzer = defineAnalyzer({
       SELECT query, page, n_total, total_impressions,
         arg_max(date, llr) AS change_date,
         MAX(llr) AS best_llr,
-        arg_max(sum_left / NULLIF(n_left, 0), llr) AS left_mean,
-        arg_max((sum_total - sum_left) / NULLIF(n_total - n_left, 0), llr) AS right_mean,
+        arg_max(sum_left / NULLIF(w_left, 0), llr) AS left_mean,
+        arg_max((sum_total - sum_left) / NULLIF(w_total - w_left, 0), llr) AS right_mean,
         arg_max(sqrt(var_left), llr) AS left_std,
         arg_max(sqrt(var_right), llr) AS right_std
       FROM llr
@@ -1159,7 +1164,15 @@ function analyzeClustering(keywords, options = {}) {
 		if (data.keywords.length < minClusterSize) continue;
 		const totalClicks = data.keywords.reduce((sum, k) => sum + num(k.clicks), 0);
 		const totalImpressions = data.keywords.reduce((sum, k) => sum + num(k.impressions), 0);
-		const avgPosition = data.keywords.reduce((sum, k) => sum + num(k.position), 0) / data.keywords.length;
+		const weightedPositionSum = data.keywords.reduce((sum, k) => {
+			const impressions = num(k.impressions);
+			return impressions > 0 ? sum + (num(k.position) - 1) * impressions : sum;
+		}, 0);
+		const positionWeight = data.keywords.reduce((sum, k) => {
+			const impressions = num(k.impressions);
+			return impressions > 0 ? sum + impressions : sum;
+		}, 0);
+		const avgPosition = positionWeight > 0 ? weightedPositionSum / positionWeight + 1 : data.keywords.reduce((sum, k) => sum + num(k.position), 0) / data.keywords.length;
 		clusters.push({
 			clusterName: name,
 			clusterType: data.type,
@@ -1224,7 +1237,7 @@ const clusteringAnalyzer = defineAnalyzer({
         CAST(COUNT(*) AS DOUBLE) AS keywordCount,
         ${METRIC_EXPR.clicks} AS totalClicks,
         ${METRIC_EXPR.impressions} AS totalImpressions,
-        AVG(position) AS avgPosition,
+        SUM((position - 1) * impressions) / NULLIF(SUM(impressions), 0) + 1 AS avgPosition,
         to_json(list({ 'query': query, 'clicks': clicks, 'impressions': impressions, 'ctr': ctr, 'position': position })) AS keywords
       FROM keyed
       GROUP BY cluster_name
@@ -1577,7 +1590,11 @@ const ctrAnomalyAnalyzer = defineAnalyzer({
       SELECT *,
         AVG(day_ctr)           OVER w AS rolling_ctr,
         STDDEV_POP(day_ctr)    OVER w AS rolling_stddev,
-        AVG(day_position)      OVER w AS rolling_position,
+        -- Impression-weighted rolling mean: day_position is already a recovered
+        -- 1-based daily weighted mean, so weighting by day impressions directly
+        -- is algebraically exact (no -1/+1 dance needed).
+        SUM(day_position * day_impressions) OVER w
+          / NULLIF(SUM(day_impressions) OVER w, 0) AS rolling_position,
         COUNT(*)               OVER w AS rolling_n
       FROM daily
       WINDOW w AS (
@@ -1626,7 +1643,8 @@ const ctrAnomalyAnalyzer = defineAnalyzer({
         END) AS severity_raw,
         MAX(CASE WHEN is_breach THEN ABS(z_score) ELSE 0.0 END) AS max_z,
         AVG(rolling_ctr) FILTER (WHERE rolling_n >= ${Number(minRollingN)}) AS baseline_ctr,
-        AVG(rolling_position) FILTER (WHERE rolling_n >= ${Number(minRollingN)}) AS baseline_position,
+        SUM(rolling_position * day_impressions) FILTER (WHERE rolling_n >= ${Number(minRollingN)})
+          / NULLIF(SUM(day_impressions) FILTER (WHERE rolling_n >= ${Number(minRollingN)}), 0) AS baseline_position,
         SUM(day_impressions) AS total_impressions,
         SUM(day_clicks) AS total_clicks
       FROM breaches
@@ -1746,7 +1764,7 @@ const ctrCurveAnalyzer = defineAnalyzer({
           ELSE '20+'
         END AS bucket,
         AVG(CAST(clicks AS DOUBLE) / NULLIF(impressions, 0)) AS avgCtr,
-        AVG(avg_pos) AS medianPosition,
+        (SUM(sum_position) / NULLIF(SUM(impressions), 0) + 1) AS medianPosition,
         CAST(COUNT(DISTINCT query) AS DOUBLE) AS keywordCount,
         ${METRIC_EXPR.clicks} AS totalClicks,
         ${METRIC_EXPR.impressions} AS totalImpressions
@@ -2380,21 +2398,20 @@ function analyzeDecay(input, options = {}) {
 	}), (r) => num(r.clicks) >= minPreviousClicks);
 	const results = [];
 	for (const [page, prev] of previousMap) {
-		const curr = currentMap.get(page) || {
-			clicks: 0,
-			position: 0
-		};
-		const lostClicks = prev.clicks - curr.clicks;
+		const curr = currentMap.get(page);
+		const currentClicks = curr?.clicks ?? 0;
+		const currentPosition = curr?.position ?? null;
+		const lostClicks = prev.clicks - currentClicks;
 		const declinePercent = prev.clicks > 0 ? lostClicks / prev.clicks : 0;
 		if (declinePercent >= threshold && lostClicks > 0) results.push({
 			page,
-			currentClicks: curr.clicks,
+			currentClicks,
 			previousClicks: prev.clicks,
 			lostClicks,
 			declinePercent,
-			currentPosition: curr.position,
+			currentPosition,
 			previousPosition: prev.position,
-			positionDrop: curr.position - prev.position
+			positionDrop: currentPosition != null ? currentPosition - prev.position : null
 		});
 	}
 	return sortResults$1(results, sortBy);
@@ -2456,9 +2473,9 @@ const decayAnalyzer = defineAnalyzer({
           p.clicks AS previousClicks,
           (p.clicks - COALESCE(c.clicks, 0.0)) AS lostClicks,
           (p.clicks - COALESCE(c.clicks, 0.0)) / NULLIF(p.clicks, 0) AS declinePercent,
-          COALESCE(c.position, 0.0) AS currentPosition,
+          c.position AS currentPosition,
           p.position AS previousPosition,
-          (COALESCE(c.position, 0.0) - p.position) AS positionDrop,
+          CASE WHEN c.position IS NOT NULL THEN (c.position - p.position) ELSE NULL END AS positionDrop,
           s.seriesJson
         FROM prev p
         LEFT JOIN cur c ON p.url = c.url
@@ -2499,9 +2516,9 @@ const decayAnalyzer = defineAnalyzer({
 			previousClicks: num(r.previousClicks),
 			lostClicks: num(r.lostClicks),
 			declinePercent: num(r.declinePercent),
-			currentPosition: num(r.currentPosition),
+			currentPosition: r.currentPosition == null ? null : num(r.currentPosition),
 			previousPosition: num(r.previousPosition),
-			positionDrop: num(r.positionDrop),
+			positionDrop: r.positionDrop == null ? null : num(r.positionDrop),
 			series: parseJsonRows(r.seriesJson).map((s) => ({
 				week: rowString(s.week),
 				clicks: num(s.clicks),
@@ -2786,7 +2803,7 @@ const intentAtlasAnalyzer = defineAnalyzer({
       SUM(impressions) AS totalImpressions,
       SUM(clicks) AS totalClicks,
       SUM(clicks) / NULLIF(SUM(impressions), 0) AS ctr,
-      AVG(position) AS avgPosition,
+      SUM((position - 1) * impressions) / NULLIF(SUM(impressions), 0) + 1 AS avgPosition,
       to_json(list({
         'query': query,
         'impressions': impressions,
@@ -3150,27 +3167,25 @@ function analyzeMovers(input, options = {}) {
 		const clicks = num(row.clicks);
 		const position = num(row.position);
 		if (impressions < minImpressions) continue;
-		const baseline = baselineMap.get(row.query) || {
-			clicks: 0,
-			impressions: 0,
-			position: 0,
-			page: null
-		};
-		const clicksChangePercent = percentDifference(clicks, baseline.clicks);
-		const impressionsChangePercent = percentDifference(impressions, baseline.impressions);
+		const baseline = baselineMap.get(row.query);
+		const baselineClicksRaw = baseline?.clicks ?? 0;
+		const baselineImpressionsRaw = baseline?.impressions ?? 0;
+		const baselinePosition = baseline?.position ?? null;
+		const clicksChangePercent = percentDifference(clicks, baselineClicksRaw);
+		const impressionsChangePercent = percentDifference(impressions, baselineImpressionsRaw);
 		const data = {
 			keyword: row.query,
 			page: pageMap.get(row.query) ?? null,
 			recentClicks: clicks,
 			recentImpressions: impressions,
 			recentPosition: position,
-			baselineClicks: Math.round(baseline.clicks),
-			baselineImpressions: Math.round(baseline.impressions),
-			baselinePosition: baseline.position,
-			clicksChange: clicks - Math.round(baseline.clicks),
+			baselineClicks: Math.round(baselineClicksRaw),
+			baselineImpressions: Math.round(baselineImpressionsRaw),
+			baselinePosition,
+			clicksChange: clicks - Math.round(baselineClicksRaw),
 			clicksChangePercent,
 			impressionsChangePercent,
-			positionChange: position - baseline.position
+			positionChange: baselinePosition != null ? position - baselinePosition : null
 		};
 		const absChange = Math.abs(clicksChangePercent / 100);
 		if (clicksChangePercent > 0 && absChange >= changeThreshold) rising.push(data);
@@ -3183,7 +3198,7 @@ function analyzeMovers(input, options = {}) {
 			case "impressions": return b.recentImpressions - a.recentImpressions;
 			case "clicksChange": return Math.abs(b.clicksChangePercent) - Math.abs(a.clicksChangePercent);
 			case "impressionsChange": return Math.abs(b.impressionsChangePercent) - Math.abs(a.impressionsChangePercent);
-			case "positionChange": return Math.abs(b.positionChange) - Math.abs(a.positionChange);
+			case "positionChange": return Math.abs(b.positionChange ?? 0) - Math.abs(a.positionChange ?? 0);
 			default: return Math.abs(b.clicksChangePercent) - Math.abs(a.clicksChangePercent);
 		}
 	};
@@ -3257,7 +3272,7 @@ const moversAnalyzer = defineAnalyzer({
           c.position AS recentPosition,
           COALESCE(p.clicks, 0.0) AS baselineClicks,
           COALESCE(p.impressions, 0.0) AS baselineImpressions,
-          COALESCE(p.position, 0.0) AS baselinePosition,
+          p.position AS baselinePosition,
           (c.clicks - COALESCE(p.clicks, 0.0)) AS clicksChange,
           CASE
             WHEN COALESCE(p.clicks, 0.0) = 0 THEN CASE WHEN c.clicks > 0 THEN 100.0 ELSE 0.0 END
@@ -3267,7 +3282,7 @@ const moversAnalyzer = defineAnalyzer({
             WHEN COALESCE(p.impressions, 0.0) = 0 THEN CASE WHEN c.impressions > 0 THEN 100.0 ELSE 0.0 END
             ELSE (c.impressions - p.impressions) * 100.0 / p.impressions
           END AS impressionsChangePercent,
-          (c.position - COALESCE(p.position, 0.0)) AS positionChange,
+          CASE WHEN p.position IS NOT NULL THEN (c.position - p.position) ELSE NULL END AS positionChange,
           s.seriesJson
         FROM cur c
         LEFT JOIN prev p ON c.query = p.query AND c.url = p.url
@@ -3314,7 +3329,7 @@ const moversAnalyzer = defineAnalyzer({
 			const recentPosition = num(r.recentPosition);
 			const baselineClicks = Math.round(num(r.baselineClicks));
 			const baselineImpressions = Math.round(num(r.baselineImpressions));
-			const baselinePosition = num(r.baselinePosition);
+			const baselinePosition = r.baselinePosition == null ? null : num(r.baselinePosition);
 			return {
 				keyword: rowString(r.keyword),
 				page: r.page == null ? null : rowString(r.page),
@@ -3327,7 +3342,7 @@ const moversAnalyzer = defineAnalyzer({
 				clicksChange: num(r.clicksChange),
 				clicksChangePercent: num(r.clicksChangePercent),
 				impressionsChangePercent: num(r.impressionsChangePercent),
-				positionChange: num(r.positionChange),
+				positionChange: r.positionChange == null ? null : num(r.positionChange),
 				direction: rowString(r.direction),
 				series: parseJsonRows(r.seriesJson).map((s) => ({
 					week: rowString(s.week),

package/dist/default-registry.mjs

@@ -914,6 +914,7 @@ const changePointAnalyzer = defineAnalyzer({
 		const metric = params.metric === "clicks" || params.metric === "impressions" ? params.metric : "position";
 		const limit = params.limit ?? 100;
 		const valueExpr = metric === "position" ? METRIC_EXPR.position : `CAST(SUM(${metric}) AS DOUBLE)`;
+		const weightExpr = metric === "position" ? METRIC_EXPR.impressions : "1.0";
 		return {
 			sql: `
     WITH daily AS (
@@ -926,7 +927,8 @@ const changePointAnalyzer = defineAnalyzer({
         CAST(date AS DATE) AS date,
         ${METRIC_EXPR.clicks} AS clicks,
         ${METRIC_EXPR.impressions} AS impressions,
-        ${valueExpr} AS value
+        ${valueExpr} AS value,
+        ${weightExpr} AS weight
       FROM read_parquet({{FILES}}, union_by_name = true)
       WHERE date >= ? AND date <= ?
         AND query IS NOT NULL AND query <> ''
@@ -938,8 +940,9 @@ const changePointAnalyzer = defineAnalyzer({
       SELECT query, page,
         COUNT(*) AS n_total,
         SUM(impressions) AS total_impressions,
-        SUM(value) AS sum_total,
-        SUM(value * value) AS sumsq_total
+        SUM(weight) AS w_total,
+        SUM(value * weight) AS sum_total,
+        SUM(value * value * weight) AS sumsq_total
       FROM daily
       GROUP BY query, page
       HAVING COUNT(*) >= ${Number(minDays)}
@@ -947,15 +950,16 @@ const changePointAnalyzer = defineAnalyzer({
     ),
     filtered AS (
       SELECT d.*,
-        e.n_total, e.sum_total, e.sumsq_total, e.total_impressions
+        e.n_total, e.w_total, e.sum_total, e.sumsq_total, e.total_impressions
       FROM daily d
       JOIN entity_stats e USING (query, page)
     ),
     cumulated AS (
       SELECT *,
         COUNT(*) OVER w AS n_left,
-        SUM(value) OVER w AS sum_left,
-        SUM(value * value) OVER w AS sumsq_left
+        SUM(weight) OVER w AS w_left,
+        SUM(value * weight) OVER w AS sum_left,
+        SUM(value * value * weight) OVER w AS sumsq_left
       FROM filtered
       WINDOW w AS (
         PARTITION BY query, page
@@ -966,22 +970,23 @@ const changePointAnalyzer = defineAnalyzer({
     llr_scored AS (
       SELECT *,
         (n_total - n_left) AS n_right,
+        (w_total - w_left) AS w_right,
         (sum_total - sum_left) AS sum_right,
         (sumsq_total - sumsq_left) AS sumsq_right,
         GREATEST(
-          (sumsq_left / NULLIF(n_left, 0))
-            - (sum_left / NULLIF(n_left, 0)) * (sum_left / NULLIF(n_left, 0)),
+          (sumsq_left / NULLIF(w_left, 0))
+            - (sum_left / NULLIF(w_left, 0)) * (sum_left / NULLIF(w_left, 0)),
           1e-9
         ) AS var_left,
         GREATEST(
-          ((sumsq_total - sumsq_left) / NULLIF(n_total - n_left, 0))
-            - ((sum_total - sum_left) / NULLIF(n_total - n_left, 0))
-              * ((sum_total - sum_left) / NULLIF(n_total - n_left, 0)),
+          ((sumsq_total - sumsq_left) / NULLIF(w_total - w_left, 0))
+            - ((sum_total - sum_left) / NULLIF(w_total - w_left, 0))
+              * ((sum_total - sum_left) / NULLIF(w_total - w_left, 0)),
           1e-9
         ) AS var_right,
         GREATEST(
-          (sumsq_total / NULLIF(n_total, 0))
-            - (sum_total / NULLIF(n_total, 0)) * (sum_total / NULLIF(n_total, 0)),
+          (sumsq_total / NULLIF(w_total, 0))
+            - (sum_total / NULLIF(w_total, 0)) * (sum_total / NULLIF(w_total, 0)),
           1e-9
         ) AS var_single
       FROM cumulated
@@ -1001,8 +1006,8 @@ const changePointAnalyzer = defineAnalyzer({
       SELECT query, page, n_total, total_impressions,
         arg_max(date, llr) AS change_date,
         MAX(llr) AS best_llr,
-        arg_max(sum_left / NULLIF(n_left, 0), llr) AS left_mean,
-        arg_max((sum_total - sum_left) / NULLIF(n_total - n_left, 0), llr) AS right_mean,
+        arg_max(sum_left / NULLIF(w_left, 0), llr) AS left_mean,
+        arg_max((sum_total - sum_left) / NULLIF(w_total - w_left, 0), llr) AS right_mean,
         arg_max(sqrt(var_left), llr) AS left_std,
         arg_max(sqrt(var_right), llr) AS right_std
       FROM llr
@@ -1159,7 +1164,15 @@ function analyzeClustering(keywords, options = {}) {
 		if (data.keywords.length < minClusterSize) continue;
 		const totalClicks = data.keywords.reduce((sum, k) => sum + num(k.clicks), 0);
 		const totalImpressions = data.keywords.reduce((sum, k) => sum + num(k.impressions), 0);
-		const avgPosition = data.keywords.reduce((sum, k) => sum + num(k.position), 0) / data.keywords.length;
+		const weightedPositionSum = data.keywords.reduce((sum, k) => {
+			const impressions = num(k.impressions);
+			return impressions > 0 ? sum + (num(k.position) - 1) * impressions : sum;
+		}, 0);
+		const positionWeight = data.keywords.reduce((sum, k) => {
+			const impressions = num(k.impressions);
+			return impressions > 0 ? sum + impressions : sum;
+		}, 0);
+		const avgPosition = positionWeight > 0 ? weightedPositionSum / positionWeight + 1 : data.keywords.reduce((sum, k) => sum + num(k.position), 0) / data.keywords.length;
 		clusters.push({
 			clusterName: name,
 			clusterType: data.type,
@@ -1224,7 +1237,7 @@ const clusteringAnalyzer = defineAnalyzer({
         CAST(COUNT(*) AS DOUBLE) AS keywordCount,
         ${METRIC_EXPR.clicks} AS totalClicks,
         ${METRIC_EXPR.impressions} AS totalImpressions,
-        AVG(position) AS avgPosition,
+        SUM((position - 1) * impressions) / NULLIF(SUM(impressions), 0) + 1 AS avgPosition,
         to_json(list({ 'query': query, 'clicks': clicks, 'impressions': impressions, 'ctr': ctr, 'position': position })) AS keywords
       FROM keyed
       GROUP BY cluster_name
@@ -1577,7 +1590,11 @@ const ctrAnomalyAnalyzer = defineAnalyzer({
       SELECT *,
         AVG(day_ctr)           OVER w AS rolling_ctr,
         STDDEV_POP(day_ctr)    OVER w AS rolling_stddev,
-        AVG(day_position)      OVER w AS rolling_position,
+        -- Impression-weighted rolling mean: day_position is already a recovered
+        -- 1-based daily weighted mean, so weighting by day impressions directly
+        -- is algebraically exact (no -1/+1 dance needed).
+        SUM(day_position * day_impressions) OVER w
+          / NULLIF(SUM(day_impressions) OVER w, 0) AS rolling_position,
         COUNT(*)               OVER w AS rolling_n
       FROM daily
       WINDOW w AS (
@@ -1626,7 +1643,8 @@ const ctrAnomalyAnalyzer = defineAnalyzer({
         END) AS severity_raw,
         MAX(CASE WHEN is_breach THEN ABS(z_score) ELSE 0.0 END) AS max_z,
         AVG(rolling_ctr) FILTER (WHERE rolling_n >= ${Number(minRollingN)}) AS baseline_ctr,
-        AVG(rolling_position) FILTER (WHERE rolling_n >= ${Number(minRollingN)}) AS baseline_position,
+        SUM(rolling_position * day_impressions) FILTER (WHERE rolling_n >= ${Number(minRollingN)})
+          / NULLIF(SUM(day_impressions) FILTER (WHERE rolling_n >= ${Number(minRollingN)}), 0) AS baseline_position,
         SUM(day_impressions) AS total_impressions,
         SUM(day_clicks) AS total_clicks
       FROM breaches
@@ -1746,7 +1764,7 @@ const ctrCurveAnalyzer = defineAnalyzer({
           ELSE '20+'
         END AS bucket,
         AVG(CAST(clicks AS DOUBLE) / NULLIF(impressions, 0)) AS avgCtr,
-        AVG(avg_pos) AS medianPosition,
+        (SUM(sum_position) / NULLIF(SUM(impressions), 0) + 1) AS medianPosition,
         CAST(COUNT(DISTINCT query) AS DOUBLE) AS keywordCount,
         ${METRIC_EXPR.clicks} AS totalClicks,
         ${METRIC_EXPR.impressions} AS totalImpressions
@@ -2374,21 +2392,20 @@ function analyzeDecay(input, options = {}) {
 	}), (r) => num(r.clicks) >= minPreviousClicks);
 	const results = [];
 	for (const [page, prev] of previousMap) {
-		const curr = currentMap.get(page) || {
-			clicks: 0,
-			position: 0
-		};
-		const lostClicks = prev.clicks - curr.clicks;
+		const curr = currentMap.get(page);
+		const currentClicks = curr?.clicks ?? 0;
+		const currentPosition = curr?.position ?? null;
+		const lostClicks = prev.clicks - currentClicks;
 		const declinePercent = prev.clicks > 0 ? lostClicks / prev.clicks : 0;
 		if (declinePercent >= threshold && lostClicks > 0) results.push({
 			page,
-			currentClicks: curr.clicks,
+			currentClicks,
 			previousClicks: prev.clicks,
 			lostClicks,
 			declinePercent,
-			currentPosition: curr.position,
+			currentPosition,
 			previousPosition: prev.position,
-			positionDrop: curr.position - prev.position
+			positionDrop: currentPosition != null ? currentPosition - prev.position : null
 		});
 	}
 	return sortResults$1(results, sortBy);
@@ -2450,9 +2467,9 @@ const decayAnalyzer = defineAnalyzer({
           p.clicks AS previousClicks,
           (p.clicks - COALESCE(c.clicks, 0.0)) AS lostClicks,
           (p.clicks - COALESCE(c.clicks, 0.0)) / NULLIF(p.clicks, 0) AS declinePercent,
-          COALESCE(c.position, 0.0) AS currentPosition,
+          c.position AS currentPosition,
           p.position AS previousPosition,
-          (COALESCE(c.position, 0.0) - p.position) AS positionDrop,
+          CASE WHEN c.position IS NOT NULL THEN (c.position - p.position) ELSE NULL END AS positionDrop,
           s.seriesJson
         FROM prev p
         LEFT JOIN cur c ON p.url = c.url
@@ -2493,9 +2510,9 @@ const decayAnalyzer = defineAnalyzer({
 			previousClicks: num(r.previousClicks),
 			lostClicks: num(r.lostClicks),
 			declinePercent: num(r.declinePercent),
-			currentPosition: num(r.currentPosition),
+			currentPosition: r.currentPosition == null ? null : num(r.currentPosition),
 			previousPosition: num(r.previousPosition),
-			positionDrop: num(r.positionDrop),
+			positionDrop: r.positionDrop == null ? null : num(r.positionDrop),
 			series: parseJsonRows(r.seriesJson).map((s) => ({
 				week: rowString(s.week),
 				clicks: num(s.clicks),
@@ -2780,7 +2797,7 @@ const intentAtlasAnalyzer = defineAnalyzer({
       SUM(impressions) AS totalImpressions,
       SUM(clicks) AS totalClicks,
       SUM(clicks) / NULLIF(SUM(impressions), 0) AS ctr,
-      AVG(position) AS avgPosition,
+      SUM((position - 1) * impressions) / NULLIF(SUM(impressions), 0) + 1 AS avgPosition,
       to_json(list({
         'query': query,
         'impressions': impressions,
@@ -3144,27 +3161,25 @@ function analyzeMovers(input, options = {}) {
 		const clicks = num(row.clicks);
 		const position = num(row.position);
 		if (impressions < minImpressions) continue;
-		const baseline = baselineMap.get(row.query) || {
-			clicks: 0,
-			impressions: 0,
-			position: 0,
-			page: null
-		};
-		const clicksChangePercent = percentDifference(clicks, baseline.clicks);
-		const impressionsChangePercent = percentDifference(impressions, baseline.impressions);
+		const baseline = baselineMap.get(row.query);
+		const baselineClicksRaw = baseline?.clicks ?? 0;
+		const baselineImpressionsRaw = baseline?.impressions ?? 0;
+		const baselinePosition = baseline?.position ?? null;
+		const clicksChangePercent = percentDifference(clicks, baselineClicksRaw);
+		const impressionsChangePercent = percentDifference(impressions, baselineImpressionsRaw);
 		const data = {
 			keyword: row.query,
 			page: pageMap.get(row.query) ?? null,
 			recentClicks: clicks,
 			recentImpressions: impressions,
 			recentPosition: position,
-			baselineClicks: Math.round(baseline.clicks),
-			baselineImpressions: Math.round(baseline.impressions),
-			baselinePosition: baseline.position,
-			clicksChange: clicks - Math.round(baseline.clicks),
+			baselineClicks: Math.round(baselineClicksRaw),
+			baselineImpressions: Math.round(baselineImpressionsRaw),
+			baselinePosition,
+			clicksChange: clicks - Math.round(baselineClicksRaw),
 			clicksChangePercent,
 			impressionsChangePercent,
-			positionChange: position - baseline.position
+			positionChange: baselinePosition != null ? position - baselinePosition : null
 		};
 		const absChange = Math.abs(clicksChangePercent / 100);
 		if (clicksChangePercent > 0 && absChange >= changeThreshold) rising.push(data);
@@ -3177,7 +3192,7 @@ function analyzeMovers(input, options = {}) {
 			case "impressions": return b.recentImpressions - a.recentImpressions;
 			case "clicksChange": return Math.abs(b.clicksChangePercent) - Math.abs(a.clicksChangePercent);
 			case "impressionsChange": return Math.abs(b.impressionsChangePercent) - Math.abs(a.impressionsChangePercent);
-			case "positionChange": return Math.abs(b.positionChange) - Math.abs(a.positionChange);
+			case "positionChange": return Math.abs(b.positionChange ?? 0) - Math.abs(a.positionChange ?? 0);
 			default: return Math.abs(b.clicksChangePercent) - Math.abs(a.clicksChangePercent);
 		}
 	};
@@ -3251,7 +3266,7 @@ const moversAnalyzer = defineAnalyzer({
           c.position AS recentPosition,
           COALESCE(p.clicks, 0.0) AS baselineClicks,
           COALESCE(p.impressions, 0.0) AS baselineImpressions,
-          COALESCE(p.position, 0.0) AS baselinePosition,
+          p.position AS baselinePosition,
           (c.clicks - COALESCE(p.clicks, 0.0)) AS clicksChange,
           CASE
             WHEN COALESCE(p.clicks, 0.0) = 0 THEN CASE WHEN c.clicks > 0 THEN 100.0 ELSE 0.0 END
@@ -3261,7 +3276,7 @@ const moversAnalyzer = defineAnalyzer({
             WHEN COALESCE(p.impressions, 0.0) = 0 THEN CASE WHEN c.impressions > 0 THEN 100.0 ELSE 0.0 END
             ELSE (c.impressions - p.impressions) * 100.0 / p.impressions
           END AS impressionsChangePercent,
-          (c.position - COALESCE(p.position, 0.0)) AS positionChange,
+          CASE WHEN p.position IS NOT NULL THEN (c.position - p.position) ELSE NULL END AS positionChange,
           s.seriesJson
         FROM cur c
         LEFT JOIN prev p ON c.query = p.query AND c.url = p.url
@@ -3308,7 +3323,7 @@ const moversAnalyzer = defineAnalyzer({
 			const recentPosition = num(r.recentPosition);
 			const baselineClicks = Math.round(num(r.baselineClicks));
 			const baselineImpressions = Math.round(num(r.baselineImpressions));
-			const baselinePosition = num(r.baselinePosition);
+			const baselinePosition = r.baselinePosition == null ? null : num(r.baselinePosition);
 			return {
 				keyword: rowString(r.keyword),
 				page: r.page == null ? null : rowString(r.page),
@@ -3321,7 +3336,7 @@ const moversAnalyzer = defineAnalyzer({
 				clicksChange: num(r.clicksChange),
 				clicksChangePercent: num(r.clicksChangePercent),
 				impressionsChangePercent: num(r.impressionsChangePercent),
-				positionChange: num(r.positionChange),
+				positionChange: r.positionChange == null ? null : num(r.positionChange),
 				direction: rowString(r.direction),
 				series: parseJsonRows(r.seriesJson).map((s) => ({
 					week: rowString(s.week),

package/dist/index.d.mts

@@ -242,9 +242,11 @@ interface DecayResult {
   previousClicks: number;
   lostClicks: number;
   declinePercent: number;
-  currentPosition: number;
+  /** `null` when the page had no ranking data in the current period (not "position 0"). */
+  currentPosition: number | null;
   previousPosition: number;
-  positionDrop: number;
+  /** `null` unless both currentPosition and previousPosition exist. */
+  positionDrop: number | null;
   series?: DecaySeriesPoint[];
 }
 /**
@@ -275,11 +277,13 @@ interface MoverData {
   recentPosition: number;
   baselineClicks: number;
   baselineImpressions: number;
-  baselinePosition: number;
+  /** `null` when the keyword has no previous-period data (a genuinely new query), not "position 0". */
+  baselinePosition: number | null;
   clicksChange: number;
   clicksChangePercent: number;
   impressionsChangePercent: number;
-  positionChange: number;
+  /** `null` unless both recentPosition and baselinePosition exist. */
+  positionChange: number | null;
 }
 interface MoversResult {
   rising: MoverData[];

package/dist/index.mjs

@@ -1146,6 +1146,7 @@ const changePointAnalyzer = defineAnalyzer$1({
 		const metric = params.metric === "clicks" || params.metric === "impressions" ? params.metric : "position";
 		const limit = params.limit ?? 100;
 		const valueExpr = metric === "position" ? METRIC_EXPR.position : `CAST(SUM(${metric}) AS DOUBLE)`;
+		const weightExpr = metric === "position" ? METRIC_EXPR.impressions : "1.0";
 		return {
 			sql: `
     WITH daily AS (
@@ -1158,7 +1159,8 @@ const changePointAnalyzer = defineAnalyzer$1({
         CAST(date AS DATE) AS date,
         ${METRIC_EXPR.clicks} AS clicks,
         ${METRIC_EXPR.impressions} AS impressions,
-        ${valueExpr} AS value
+        ${valueExpr} AS value,
+        ${weightExpr} AS weight
       FROM read_parquet({{FILES}}, union_by_name = true)
       WHERE date >= ? AND date <= ?
         AND query IS NOT NULL AND query <> ''
@@ -1170,8 +1172,9 @@ const changePointAnalyzer = defineAnalyzer$1({
       SELECT query, page,
         COUNT(*) AS n_total,
         SUM(impressions) AS total_impressions,
-        SUM(value) AS sum_total,
-        SUM(value * value) AS sumsq_total
+        SUM(weight) AS w_total,
+        SUM(value * weight) AS sum_total,
+        SUM(value * value * weight) AS sumsq_total
       FROM daily
       GROUP BY query, page
       HAVING COUNT(*) >= ${Number(minDays)}
@@ -1179,15 +1182,16 @@ const changePointAnalyzer = defineAnalyzer$1({
     ),
     filtered AS (
       SELECT d.*,
-        e.n_total, e.sum_total, e.sumsq_total, e.total_impressions
+        e.n_total, e.w_total, e.sum_total, e.sumsq_total, e.total_impressions
       FROM daily d
       JOIN entity_stats e USING (query, page)
     ),
     cumulated AS (
       SELECT *,
         COUNT(*) OVER w AS n_left,
-        SUM(value) OVER w AS sum_left,
-        SUM(value * value) OVER w AS sumsq_left
+        SUM(weight) OVER w AS w_left,
+        SUM(value * weight) OVER w AS sum_left,
+        SUM(value * value * weight) OVER w AS sumsq_left
       FROM filtered
       WINDOW w AS (
         PARTITION BY query, page
@@ -1198,22 +1202,23 @@ const changePointAnalyzer = defineAnalyzer$1({
     llr_scored AS (
       SELECT *,
         (n_total - n_left) AS n_right,
+        (w_total - w_left) AS w_right,
         (sum_total - sum_left) AS sum_right,
         (sumsq_total - sumsq_left) AS sumsq_right,
         GREATEST(
-          (sumsq_left / NULLIF(n_left, 0))
-            - (sum_left / NULLIF(n_left, 0)) * (sum_left / NULLIF(n_left, 0)),
+          (sumsq_left / NULLIF(w_left, 0))
+            - (sum_left / NULLIF(w_left, 0)) * (sum_left / NULLIF(w_left, 0)),
           1e-9
         ) AS var_left,
         GREATEST(
-          ((sumsq_total - sumsq_left) / NULLIF(n_total - n_left, 0))
-            - ((sum_total - sum_left) / NULLIF(n_total - n_left, 0))
-              * ((sum_total - sum_left) / NULLIF(n_total - n_left, 0)),
+          ((sumsq_total - sumsq_left) / NULLIF(w_total - w_left, 0))
+            - ((sum_total - sum_left) / NULLIF(w_total - w_left, 0))
+              * ((sum_total - sum_left) / NULLIF(w_total - w_left, 0)),
           1e-9
         ) AS var_right,
         GREATEST(
-          (sumsq_total / NULLIF(n_total, 0))
-            - (sum_total / NULLIF(n_total, 0)) * (sum_total / NULLIF(n_total, 0)),
+          (sumsq_total / NULLIF(w_total, 0))
+            - (sum_total / NULLIF(w_total, 0)) * (sum_total / NULLIF(w_total, 0)),
           1e-9
         ) AS var_single
       FROM cumulated
@@ -1233,8 +1238,8 @@ const changePointAnalyzer = defineAnalyzer$1({
       SELECT query, page, n_total, total_impressions,
         arg_max(date, llr) AS change_date,
         MAX(llr) AS best_llr,
-        arg_max(sum_left / NULLIF(n_left, 0), llr) AS left_mean,
-        arg_max((sum_total - sum_left) / NULLIF(n_total - n_left, 0), llr) AS right_mean,
+        arg_max(sum_left / NULLIF(w_left, 0), llr) AS left_mean,
+        arg_max((sum_total - sum_left) / NULLIF(w_total - w_left, 0), llr) AS right_mean,
         arg_max(sqrt(var_left), llr) AS left_std,
         arg_max(sqrt(var_right), llr) AS right_std
       FROM llr
@@ -1391,7 +1396,15 @@ function analyzeClustering(keywords, options = {}) {
 		if (data.keywords.length < minClusterSize) continue;
 		const totalClicks = data.keywords.reduce((sum, k) => sum + num$1(k.clicks), 0);
 		const totalImpressions = data.keywords.reduce((sum, k) => sum + num$1(k.impressions), 0);
-		const avgPosition = data.keywords.reduce((sum, k) => sum + num$1(k.position), 0) / data.keywords.length;
+		const weightedPositionSum = data.keywords.reduce((sum, k) => {
+			const impressions = num$1(k.impressions);
+			return impressions > 0 ? sum + (num$1(k.position) - 1) * impressions : sum;
+		}, 0);
+		const positionWeight = data.keywords.reduce((sum, k) => {
+			const impressions = num$1(k.impressions);
+			return impressions > 0 ? sum + impressions : sum;
+		}, 0);
+		const avgPosition = positionWeight > 0 ? weightedPositionSum / positionWeight + 1 : data.keywords.reduce((sum, k) => sum + num$1(k.position), 0) / data.keywords.length;
 		clusters.push({
 			clusterName: name,
 			clusterType: data.type,
@@ -1456,7 +1469,7 @@ const clusteringAnalyzer = defineAnalyzer$1({
         CAST(COUNT(*) AS DOUBLE) AS keywordCount,
         ${METRIC_EXPR.clicks} AS totalClicks,
         ${METRIC_EXPR.impressions} AS totalImpressions,
-        AVG(position) AS avgPosition,
+        SUM((position - 1) * impressions) / NULLIF(SUM(impressions), 0) + 1 AS avgPosition,
         to_json(list({ 'query': query, 'clicks': clicks, 'impressions': impressions, 'ctr': ctr, 'position': position })) AS keywords
       FROM keyed
       GROUP BY cluster_name
@@ -1809,7 +1822,11 @@ const ctrAnomalyAnalyzer = defineAnalyzer$1({
       SELECT *,
         AVG(day_ctr)           OVER w AS rolling_ctr,
         STDDEV_POP(day_ctr)    OVER w AS rolling_stddev,
-        AVG(day_position)      OVER w AS rolling_position,
+        -- Impression-weighted rolling mean: day_position is already a recovered
+        -- 1-based daily weighted mean, so weighting by day impressions directly
+        -- is algebraically exact (no -1/+1 dance needed).
+        SUM(day_position * day_impressions) OVER w
+          / NULLIF(SUM(day_impressions) OVER w, 0) AS rolling_position,
         COUNT(*)               OVER w AS rolling_n
       FROM daily
       WINDOW w AS (
@@ -1858,7 +1875,8 @@ const ctrAnomalyAnalyzer = defineAnalyzer$1({
         END) AS severity_raw,
         MAX(CASE WHEN is_breach THEN ABS(z_score) ELSE 0.0 END) AS max_z,
         AVG(rolling_ctr) FILTER (WHERE rolling_n >= ${Number(minRollingN)}) AS baseline_ctr,
-        AVG(rolling_position) FILTER (WHERE rolling_n >= ${Number(minRollingN)}) AS baseline_position,
+        SUM(rolling_position * day_impressions) FILTER (WHERE rolling_n >= ${Number(minRollingN)})
+          / NULLIF(SUM(day_impressions) FILTER (WHERE rolling_n >= ${Number(minRollingN)}), 0) AS baseline_position,
         SUM(day_impressions) AS total_impressions,
         SUM(day_clicks) AS total_clicks
       FROM breaches
@@ -1978,7 +1996,7 @@ const ctrCurveAnalyzer = defineAnalyzer$1({
           ELSE '20+'
         END AS bucket,
         AVG(CAST(clicks AS DOUBLE) / NULLIF(impressions, 0)) AS avgCtr,
-        AVG(avg_pos) AS medianPosition,
+        (SUM(sum_position) / NULLIF(SUM(impressions), 0) + 1) AS medianPosition,
         CAST(COUNT(DISTINCT query) AS DOUBLE) AS keywordCount,
         ${METRIC_EXPR.clicks} AS totalClicks,
         ${METRIC_EXPR.impressions} AS totalImpressions
@@ -2938,21 +2956,20 @@ function analyzeDecay(input, options = {}) {
 	}), (r) => num$1(r.clicks) >= minPreviousClicks);
 	const results = [];
 	for (const [page, prev] of previousMap) {
-		const curr = currentMap.get(page) || {
-			clicks: 0,
-			position: 0
-		};
-		const lostClicks = prev.clicks - curr.clicks;
+		const curr = currentMap.get(page);
+		const currentClicks = curr?.clicks ?? 0;
+		const currentPosition = curr?.position ?? null;
+		const lostClicks = prev.clicks - currentClicks;
 		const declinePercent = prev.clicks > 0 ? lostClicks / prev.clicks : 0;
 		if (declinePercent >= threshold && lostClicks > 0) results.push({
 			page,
-			currentClicks: curr.clicks,
+			currentClicks,
 			previousClicks: prev.clicks,
 			lostClicks,
 			declinePercent,
-			currentPosition: curr.position,
+			currentPosition,
 			previousPosition: prev.position,
-			positionDrop: curr.position - prev.position
+			positionDrop: currentPosition != null ? currentPosition - prev.position : null
 		});
 	}
 	return sortResults$1(results, sortBy);
@@ -3014,9 +3031,9 @@ const decayAnalyzer = defineAnalyzer$1({
           p.clicks AS previousClicks,
           (p.clicks - COALESCE(c.clicks, 0.0)) AS lostClicks,
           (p.clicks - COALESCE(c.clicks, 0.0)) / NULLIF(p.clicks, 0) AS declinePercent,
-          COALESCE(c.position, 0.0) AS currentPosition,
+          c.position AS currentPosition,
           p.position AS previousPosition,
-          (COALESCE(c.position, 0.0) - p.position) AS positionDrop,
+          CASE WHEN c.position IS NOT NULL THEN (c.position - p.position) ELSE NULL END AS positionDrop,
           s.seriesJson
         FROM prev p
         LEFT JOIN cur c ON p.url = c.url
@@ -3057,9 +3074,9 @@ const decayAnalyzer = defineAnalyzer$1({
 			previousClicks: num$1(r.previousClicks),
 			lostClicks: num$1(r.lostClicks),
 			declinePercent: num$1(r.declinePercent),
-			currentPosition: num$1(r.currentPosition),
+			currentPosition: r.currentPosition == null ? null : num$1(r.currentPosition),
 			previousPosition: num$1(r.previousPosition),
-			positionDrop: num$1(r.positionDrop),
+			positionDrop: r.positionDrop == null ? null : num$1(r.positionDrop),
 			series: parseJsonRows(r.seriesJson).map((s) => ({
 				week: rowString(s.week),
 				clicks: num$1(s.clicks),
@@ -3344,7 +3361,7 @@ const intentAtlasAnalyzer = defineAnalyzer$1({
       SUM(impressions) AS totalImpressions,
       SUM(clicks) AS totalClicks,
       SUM(clicks) / NULLIF(SUM(impressions), 0) AS ctr,
-      AVG(position) AS avgPosition,
+      SUM((position - 1) * impressions) / NULLIF(SUM(impressions), 0) + 1 AS avgPosition,
       to_json(list({
         'query': query,
         'impressions': impressions,
@@ -3704,27 +3721,25 @@ function analyzeMovers(input, options = {}) {
 		const clicks = num$1(row.clicks);
 		const position = num$1(row.position);
 		if (impressions < minImpressions) continue;
-		const baseline = baselineMap.get(row.query) || {
-			clicks: 0,
-			impressions: 0,
-			position: 0,
-			page: null
-		};
-		const clicksChangePercent = percentDifference(clicks, baseline.clicks);
-		const impressionsChangePercent = percentDifference(impressions, baseline.impressions);
+		const baseline = baselineMap.get(row.query);
+		const baselineClicksRaw = baseline?.clicks ?? 0;
+		const baselineImpressionsRaw = baseline?.impressions ?? 0;
+		const baselinePosition = baseline?.position ?? null;
+		const clicksChangePercent = percentDifference(clicks, baselineClicksRaw);
+		const impressionsChangePercent = percentDifference(impressions, baselineImpressionsRaw);
 		const data = {
 			keyword: row.query,
 			page: pageMap.get(row.query) ?? null,
 			recentClicks: clicks,
 			recentImpressions: impressions,
 			recentPosition: position,
-			baselineClicks: Math.round(baseline.clicks),
-			baselineImpressions: Math.round(baseline.impressions),
-			baselinePosition: baseline.position,
-			clicksChange: clicks - Math.round(baseline.clicks),
+			baselineClicks: Math.round(baselineClicksRaw),
+			baselineImpressions: Math.round(baselineImpressionsRaw),
+			baselinePosition,
+			clicksChange: clicks - Math.round(baselineClicksRaw),
 			clicksChangePercent,
 			impressionsChangePercent,
-			positionChange: position - baseline.position
+			positionChange: baselinePosition != null ? position - baselinePosition : null
 		};
 		const absChange = Math.abs(clicksChangePercent / 100);
 		if (clicksChangePercent > 0 && absChange >= changeThreshold) rising.push(data);
@@ -3737,7 +3752,7 @@ function analyzeMovers(input, options = {}) {
 			case "impressions": return b.recentImpressions - a.recentImpressions;
 			case "clicksChange": return Math.abs(b.clicksChangePercent) - Math.abs(a.clicksChangePercent);
 			case "impressionsChange": return Math.abs(b.impressionsChangePercent) - Math.abs(a.impressionsChangePercent);
-			case "positionChange": return Math.abs(b.positionChange) - Math.abs(a.positionChange);
+			case "positionChange": return Math.abs(b.positionChange ?? 0) - Math.abs(a.positionChange ?? 0);
 			default: return Math.abs(b.clicksChangePercent) - Math.abs(a.clicksChangePercent);
 		}
 	};
@@ -3811,7 +3826,7 @@ const moversAnalyzer = defineAnalyzer$1({
           c.position AS recentPosition,
           COALESCE(p.clicks, 0.0) AS baselineClicks,
           COALESCE(p.impressions, 0.0) AS baselineImpressions,
-          COALESCE(p.position, 0.0) AS baselinePosition,
+          p.position AS baselinePosition,
           (c.clicks - COALESCE(p.clicks, 0.0)) AS clicksChange,
           CASE
             WHEN COALESCE(p.clicks, 0.0) = 0 THEN CASE WHEN c.clicks > 0 THEN 100.0 ELSE 0.0 END
@@ -3821,7 +3836,7 @@ const moversAnalyzer = defineAnalyzer$1({
             WHEN COALESCE(p.impressions, 0.0) = 0 THEN CASE WHEN c.impressions > 0 THEN 100.0 ELSE 0.0 END
             ELSE (c.impressions - p.impressions) * 100.0 / p.impressions
           END AS impressionsChangePercent,
-          (c.position - COALESCE(p.position, 0.0)) AS positionChange,
+          CASE WHEN p.position IS NOT NULL THEN (c.position - p.position) ELSE NULL END AS positionChange,
           s.seriesJson
         FROM cur c
         LEFT JOIN prev p ON c.query = p.query AND c.url = p.url
@@ -3868,7 +3883,7 @@ const moversAnalyzer = defineAnalyzer$1({
 			const recentPosition = num$1(r.recentPosition);
 			const baselineClicks = Math.round(num$1(r.baselineClicks));
 			const baselineImpressions = Math.round(num$1(r.baselineImpressions));
-			const baselinePosition = num$1(r.baselinePosition);
+			const baselinePosition = r.baselinePosition == null ? null : num$1(r.baselinePosition);
 			return {
 				keyword: rowString(r.keyword),
 				page: r.page == null ? null : rowString(r.page),
@@ -3881,7 +3896,7 @@ const moversAnalyzer = defineAnalyzer$1({
 				clicksChange: num$1(r.clicksChange),
 				clicksChangePercent: num$1(r.clicksChangePercent),
 				impressionsChangePercent: num$1(r.impressionsChangePercent),
-				positionChange: num$1(r.positionChange),
+				positionChange: r.positionChange == null ? null : num$1(r.positionChange),
 				direction: rowString(r.direction),
 				series: parseJsonRows(r.seriesJson).map((s) => ({
 					week: rowString(s.week),
@@ -5893,7 +5908,7 @@ function buildMoversSection(res, direction, max, minChange) {
 			clicks: r.recentClicks,
 			clicksChange: r.clicksChange,
 			clicksChangePercent: r.clicksChangePercent,
-			positionChange: r.positionChange
+			...r.positionChange != null ? { positionChange: r.positionChange } : {}
 		},
 		delta: {
 			metric: "clicks",

package/dist/report/index.mjs

@@ -596,7 +596,7 @@ function buildMoversSection(res, direction, max, minChange) {
 			clicks: r.recentClicks,
 			clicksChange: r.clicksChange,
 			clicksChangePercent: r.clicksChangePercent,
-			positionChange: r.positionChange
+			...r.positionChange != null ? { positionChange: r.positionChange } : {}
 		},
 		delta: {
 			metric: "clicks",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/analysis",
   "type": "module",
-  "version": "0.35.2",
+  "version": "0.35.3",
   "description": "GSC analyzers — striking-distance, opportunity, movers, decay, brand, clustering, concentration, seasonality. Pure row-based + DuckDB-native.",
   "author": {
     "name": "Harlan Wilton",
@@ -76,9 +76,9 @@
   "dependencies": {
     "drizzle-orm": "1.0.0-rc.3",
     "pluralize": "^8.0.0",
-    "@gscdump/engine": "0.35.2",
-    "@gscdump/engine-gsc-api": "0.35.2",
-    "gscdump": "0.35.2"
+    "@gscdump/engine-gsc-api": "0.35.3",
+    "@gscdump/engine": "0.35.3",
+    "gscdump": "0.35.3"
   },
   "devDependencies": {
     "vitest": "^4.1.9"