@gscdump/analysis 1.4.3 → 1.4.5

package/dist/report/format.mjs

@@ -2,7 +2,8 @@ const SEVERITY_GLYPH = {
 	info: "i",
 	low: "·",
 	medium: "!",
-	high: "!!"
+	high: "!!",
+	unknown: "?"
 };
 function formatReport(report, opts = {}) {
 	const lines = [];

package/dist/report/reports/brand.mjs

@@ -33,7 +33,8 @@ const brandReport = defineReport({
 				brandTerms,
 				limit: 200
 			},
-			required: true
+			required: true,
+			feeds: ["brand-split"]
 		}, {
 			key: "concentration",
 			type: "concentration",

package/dist/report/reports/movers.mjs

@@ -39,7 +39,8 @@ const moversReport = defineReport({
 					...prev,
 					limit: 200
 				},
-				required: true
+				required: true,
+				feeds: ["rising", "decliners"]
 			},
 			{
 				key: "decay",
@@ -48,7 +49,8 @@ const moversReport = defineReport({
 					...cur,
 					...prev,
 					limit: 100
-				}
+				},
+				feeds: ["decliners"]
 			},
 			{
 				key: "striking",
@@ -56,7 +58,8 @@ const moversReport = defineReport({
 				params: {
 					...cur,
 					limit: 100
-				}
+				},
+				feeds: ["striking-distance"]
 			}
 		];
 	},

package/dist/report/reports/opportunities.mjs

@@ -24,7 +24,8 @@ const opportunitiesReport = defineReport({
 					...dates,
 					limit: 100
 				},
-				required: true
+				required: true,
+				feeds: ["striking-distance"]
 			},
 			{
 				key: "opportunity",
@@ -32,7 +33,8 @@ const opportunitiesReport = defineReport({
 				params: {
 					...dates,
 					limit: 100
-				}
+				},
+				feeds: ["low-ctr"]
 			},
 			{
 				key: "zero-click",

package/dist/report/reports/pre-publish.mjs

@@ -31,14 +31,16 @@ const prePublishReport = defineReport({
 			params: {
 				...dates,
 				limit: 200
-			}
+			},
+			feeds: ["cannibalization-risk"]
 		}, {
 			key: "striking",
 			type: "striking-distance",
 			params: {
 				...dates,
 				limit: 200
-			}
+			},
+			feeds: ["striking-peers"]
 		}];
 	},
 	reduce: (results, ctx) => {

package/dist/report/reports/priority.mjs

@@ -36,7 +36,8 @@ const priorityReport = defineReport({
 				...cmp,
 				limit: 100
 			},
-			required: false
+			required: false,
+			feeds: ["priority"]
 		}));
 	},
 	reduce: (results, ctx) => {

package/dist/report/runtime.d.mts

@@ -18,7 +18,9 @@ interface RunReportOptions<P extends ReportParams = ReportParams> {
  * Steps execute in parallel via `Promise.all`. The report's `reduce` is invoked
  * with a results bag that only contains successful steps — sections that
  * depended on a failed step should set their own `coverage: 'partial'` (the
- * runtime additionally marks `meta.degraded` when any step errored).
+ * runtime additionally marks `meta.degraded` when any step errored, and
+ * rewrites sections whose feeding steps ALL failed; see
+ * `markUnavailableSections`).
  *
  * The report's own `plan()` param-validation throws (`--target` etc.) are
  * defects from this core's perspective and still propagate; those are modelled

package/dist/report/runtime.mjs

@@ -26,6 +26,32 @@ async function executeStep(source, analyzers, step) {
 		};
 	});
 }
+function unavailableSection(section, failedKeys) {
+	return {
+		id: section.id,
+		title: section.title,
+		severity: "unknown",
+		summary: { magnitudeLabel: `unavailable — ${failedKeys.join(", ")} failed` },
+		findings: [],
+		coverage: "partial",
+		actions: []
+	};
+}
+function markUnavailableSections(sections, steps, outcomes) {
+	const failedKeys = new Set(outcomes.filter((o) => o.state.status === "error").map((o) => o.state.key));
+	if (failedKeys.size === 0) return [...sections];
+	const feedersBySection = /* @__PURE__ */ new Map();
+	for (const step of steps) for (const sectionId of step.feeds ?? [step.key]) {
+		const feeders = feedersBySection.get(sectionId);
+		if (feeders) feeders.push(step.key);
+		else feedersBySection.set(sectionId, [step.key]);
+	}
+	return sections.map((section) => {
+		const feeders = feedersBySection.get(section.id);
+		if (!feeders?.length || !feeders.every((k) => failedKeys.has(k))) return section;
+		return unavailableSection(section, feeders);
+	});
+}
 async function runReportResult(report, opts) {
 	const startedAt = Date.now();
 	const generatedAt = new Date(startedAt).toISOString();
@@ -43,7 +69,7 @@ async function runReportResult(report, opts) {
 	for (const o of errored) if (required.has(o.state.key)) return err(analysisErrors.requiredStepFailed(report.id, o.state.key, o.state.error ?? "unknown error", o.cause));
 	const resultsByKey = {};
 	for (const o of outcomes) if (o.result) resultsByKey[o.state.key] = o.result;
-	const sections = report.reduce(resultsByKey, opts.ctx).sections;
+	const sections = markUnavailableSections(report.reduce(resultsByKey, opts.ctx).sections, steps, outcomes);
 	const degraded = errored.length > 0;
 	const stepStates = outcomes.map((o) => o.state);
 	return ok({

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/analysis",
   "type": "module",
-  "version": "1.4.3",
+  "version": "1.4.5",
   "description": "GSC analyzers — striking-distance, opportunity, movers, decay, brand, clustering, concentration, seasonality. Pure row-based + DuckDB-native.",
   "author": {
     "name": "Harlan Wilton",
@@ -57,9 +57,9 @@
   },
   "dependencies": {
     "pluralize": "^8.0.0",
-    "@gscdump/engine": "^1.4.3",
-    "@gscdump/engine-gsc-api": "^1.4.3",
-    "gscdump": "^1.4.3"
+    "@gscdump/engine": "^1.4.5",
+    "@gscdump/engine-gsc-api": "^1.4.5",
+    "gscdump": "^1.4.5"
   },
   "devDependencies": {
     "vitest": "^4.1.10"