@gscdump/analysis 0.32.12 → 0.33.3

package/dist/report/index.mjs

@@ -111,6 +111,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",
@@ -160,7 +181,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: {
@@ -182,16 +203,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",
@@ -209,15 +227,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;
@@ -283,7 +295,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 {
@@ -292,16 +304,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 {
@@ -310,32 +319,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,
@@ -364,16 +367,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;
@@ -430,7 +427,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) => ({
@@ -456,20 +453,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: {
@@ -488,20 +479,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: {
@@ -520,16 +505,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;
@@ -605,7 +584,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) => ({
@@ -637,21 +616,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",
@@ -710,7 +683,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: {
@@ -731,16 +704,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;
@@ -806,7 +773,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: {
@@ -828,20 +795,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",
@@ -862,11 +823,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 ? {
@@ -878,14 +836,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: {
@@ -905,20 +860,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",
@@ -936,16 +885,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;
@@ -996,7 +939,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;
@@ -1019,23 +962,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: {
@@ -1055,16 +992,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")
 	};
 }
 function clamp01(value) {
@@ -1439,7 +1370,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) => ({
@@ -1469,11 +1400,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: {
@@ -1483,14 +1411,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;
@@ -1513,20 +1438,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) => ({
@@ -1546,20 +1465,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",
@@ -1579,16 +1492,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) {
@@ -1695,7 +1602,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: {
@@ -1714,20 +1621,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: {
@@ -1746,20 +1647,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: {
@@ -1778,16 +1673,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 = [

package/dist/semantic/index.d.mts

@@ -1,4 +1,11 @@
 import { AnalysisQuerySource } from "@gscdump/engine/source";
+interface ContentGapQueryCandidate {
+  query: string;
+  impressions: number;
+  clicks: number;
+  avgPosition: number;
+  currentUrl: string;
+}
 interface ContentGapResult {
   query: string;
   impressions: number;
@@ -55,16 +62,9 @@ interface ContentGapAnalysis {
     modelId: string;
   };
 }
-interface QueryCandidate {
-  query: string;
-  impressions: number;
-  clicks: number;
-  avgPosition: number;
-  currentUrl: string;
-}
 declare function normalizeUrl(u: string): string;
 declare function deriveUrlText(url: string): string;
 declare function cosineNormalized(a: Float32Array, b: Float32Array): number;
-declare function rankContentGaps(queries: QueryCandidate[], urls: string[], queryEmbeddings: Float32Array[], urlEmbeddings: Float32Array[], minDivergence: number): ContentGapResult[];
+declare function rankContentGaps(queries: ContentGapQueryCandidate[], urls: string[], queryEmbeddings: Float32Array[], urlEmbeddings: Float32Array[], minDivergence: number): ContentGapResult[];
 declare function analyzeContentGap(source: AnalysisQuerySource, opts?: ContentGapOptions): Promise<ContentGapAnalysis>;
 export { type ContentGapAnalysis, type ContentGapOptions, type ContentGapProgress, type ContentGapResult, ContentGapSourceUnsupportedError, analyzeContentGap, cosineNormalized, deriveUrlText, normalizeUrl, rankContentGaps };