@gscdump/analysis 2.2.0 → 3.0.0

package/README.md

@@ -41,7 +41,7 @@ const movers = analyzeMovers(currentRows, previousRows)
 const decay = analyzeDecay(currentRows, previousRows)
 ```
 
-Meta-analyses live in the report layer. Run a composed, ranked priority list via `runReport`:
+Meta-analyses live in the report layer. Run a composed evidence report via `runReport`:
 
 ```ts
 import {
@@ -51,14 +51,14 @@ import {
 } from '@gscdump/analysis'
 import { resolveWindow } from '@gscdump/engine/period'
 
-const report = defaultReportRegistry.getReport('priority')!
-const window = resolveWindow({ preset: 'last-28d', comparison: 'prev-period' })
+const report = defaultReportRegistry.getReport('health')!
+const window = resolveWindow({ preset: 'last-28d', comparison: 'none' })
 const result = await runReport(report, {
   source,
   analyzers: defaultAnalyzerRegistry,
   ctx: { site: siteUrl, window, params: {}, registryVersion: defaultReportRegistry.version },
 })
-// result.sections[0].findings — ranked priority actions, page+query keyed.
+// result.sections[0].findings — bounded evidence, page+query keyed.
 ```
 
 Source adapters compose a GSC client + analyzer in one call:

package/dist/analyzers/movers.mjs

@@ -1,7 +1,7 @@
-import { percentDifference } from "../scoring.mjs";
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { queriesQueryState } from "../analyzer/adapt-rows.mjs";
 import { buildPeriodMap } from "../types.mjs";
+import { percentDifference } from "../scoring.mjs";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { comparisonOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";

package/dist/index.d.mts

@@ -2,7 +2,6 @@ import { ROW_ANALYZERS } from "./analyzer/row-analyzers.mjs";
 import { SQL_ANALYZERS } from "./sql-analyzers.mjs";
 import { defaultAnalyzerRegistry } from "./default-registry.mjs";
 import { AnalysisError, AnalysisErrorKind, analysisErrorToException, analysisErrors, formatAnalysisError, isAnalysisError } from "./errors.mjs";
-import { ActionPriorityResult, ActionPrioritySourceState, ActionPrioritySourceStatus, ActionSource, DEFAULT_PRIORITY_SOURCES, Effort, PriorityAction, mergePriorityActions, normalizePriorityActions, scorePriorityActions } from "./action-priority.mjs";
 import { BaseMetrics, DateRow, PageRow, QueriesRow, QueryPageRow, SortOrder, createSorter } from "./types.mjs";
 import { BrandSegmentationOptions, BrandSegmentationResult, BrandSegmentationRow, BrandSummary, analyzeBrandSegmentation } from "./analyzers/brand.mjs";
 import { CannibalizationCompetitor, CannibalizationEvent, CannibalizationOptions, CannibalizationPage, CannibalizationResult, CannibalizationSortMetric, analyzeCannibalization } from "./analyzers/cannibalization.mjs";
@@ -29,5 +28,5 @@ import { Analyzer, AnalyzerCapabilityError, AnalyzerRegistry, AnalyzerRegistryIn
 import { AnalysisPeriod, ComparisonMode, ComparisonPeriod, PadTimeseriesOptions, ResolveWindowOptions, ResolvedWindow, WindowPreset, comparisonOf, padTimeseries, periodOf, resolveWindow } from "@gscdump/engine/period";
 import { AnalysisParams, AnalysisResult, AnalysisTool, num } from "@gscdump/engine/analysis-types";
 import { AnalysisQuerySource, AnalysisSourceKind, ENGINE_QUERY_CAPABILITIES, EngineQuerySourceOptions, ExecuteSqlOptions, FileSet, QueryRow, SourceCapabilities, createEngineQuerySource, queryRows, runAnalyzerWithEngine } from "@gscdump/engine/source";
-import { DefineReportOptions, DefinedReport, ReportAction, ReportContext, ReportFinding, ReportPlanStep, ReportResult, ReportSection } from "@gscdump/engine/report";
-export { type ActionPriorityResult, type ActionPrioritySourceState, type ActionPrioritySourceStatus, type ActionSource, type AnalysisError, type AnalysisErrorKind, type AnalysisParams, type AnalysisPeriod, type AnalysisQuerySource, type AnalysisResult, type AnalysisSourceKind, type AnalysisTool, type Analyzer, AnalyzerCapabilityError, type AnalyzerRegistry, type AnalyzerRegistryInit, type AnalyzerRunner, type AnalyzerVariants, type BaseMetrics, type BrandSegmentationOptions, type BrandSegmentationResult, type BrandSegmentationRow, type BrandSummary, type BrowserAnalyzeOptions, type CannibalizationCompetitor, type CannibalizationEvent, type CannibalizationOptions, type CannibalizationPage, type CannibalizationResult, type CannibalizationSortMetric, type ClusterType, type ClusteringOptions, type ClusteringResult, type ComparisonMode, type ComparisonPeriod, type CompositeSourceOptions, type ConcentrationInput, type ConcentrationItem, type ConcentrationOptions, type ConcentrationResult, type ConcentrationRiskLevel, type CurrentSitemapScope, DEFAULT_PRIORITY_SOURCES, type DateRow, type DecayInput, type DecayOptions, type DecayResult, type DecaySeriesPoint, type DecaySortMetric, type DefineAnalyzerOptions, type DefineReportOptions, type DefinedAnalyzer, type DefinedReport, type DryRunReportResult, ENGINE_QUERY_CAPABILITIES, type Effort, type EngineQuerySourceOptions, type ExecuteSqlOptions, type FileSet, type FormatReportOptions, INTENT_CLASSIFIER_VERSION, IN_MEMORY_DEFAULT_CAPABILITIES, type InMemoryQuerySourceOptions, type IntentClassification, type KeywordCluster, type MonthlyData, type MoverData, type MoversInput, type MoversOptions, type MoversResult, type MoversSortMetric, NORMALIZER_VERSION, type OpportunityFactors, type OpportunityOptions, type OpportunityResult, type OpportunitySortMetric, type OpportunityWeights, type PadTimeseriesOptions, type PageRow, type Plan, type PriorityAction, type QueriesRow, type QueryPageRow, type QueryRow, REPORTS, ROW_ANALYZERS, type ReduceContext, type ReduceCtx, type Reducer, type ReportAction, type ReportContext, type ReportFinding, type ReportPlanStep, type ReportResult, type ReportSection, type RequiredCapability, type ResolveWindowOptions, type ResolvedWindow, type RowQueriesPlan, type RunReportOptions, SEARCH_INTENT_CODE, SITEMAP_SYNC_COLLAPSE_POLICY, SITEMAP_TRUST_COLLAPSE_POLICY, SQL_ANALYZERS, type SearchIntent, type SeasonalityMetric, type SeasonalityOptions, type SeasonalityResult, type SitemapCollapsePolicy, type SitemapCollapseState, type SitemapDelta, type SitemapHealthDiff, type SitemapHealthInput, type SitemapHealthRow, type SitemapHealthTotals, type SortOrder, type SourceCapabilities, type SqlExtraQuery, type SqlPlan, type SqlPlanSpec, type StrikingDistanceInputRow, type StrikingDistanceOptions, type StrikingDistanceResult, type TypedRowQuery, type WindowPreset, type ZeroClickOptions, type ZeroClickResult, analysisErrorToException, analysisErrors, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzeOpportunity, analyzePageConcentration, analyzeSeasonality, analyzeStrikingDistance, analyzeZeroClick, classifyQueryIntent, classifySitemapCollapse, compareCurrentSitemapScope, comparisonOf, createAnalyzerRegistry, createCompositeSource, createEngineQuerySource, createInMemoryQuerySource, createSorter, defaultAnalyzerRegistry, defaultReportRegistry, defineAnalyzer, diffSitemapHealth, dryRunReport, encodeIntent, formatAnalysisError, formatReport, isAnalysisError, mergePriorityActions, normalizePriorityActions, normalizeQuery, num, padTimeseries, periodOf, queryRows, resolveWindow, runAnalyzerFromSource, runAnalyzerWithEngine, runReport, runReportResult, scorePriorityActions, sitemapHistoryHasCollapse };
+import { DefineReportOptions, DefinedReport, ReportContext, ReportFinding, ReportPlanStep, ReportResult, ReportSection } from "@gscdump/engine/report";
+export { type AnalysisError, type AnalysisErrorKind, type AnalysisParams, type AnalysisPeriod, type AnalysisQuerySource, type AnalysisResult, type AnalysisSourceKind, type AnalysisTool, type Analyzer, AnalyzerCapabilityError, type AnalyzerRegistry, type AnalyzerRegistryInit, type AnalyzerRunner, type AnalyzerVariants, type BaseMetrics, type BrandSegmentationOptions, type BrandSegmentationResult, type BrandSegmentationRow, type BrandSummary, type BrowserAnalyzeOptions, type CannibalizationCompetitor, type CannibalizationEvent, type CannibalizationOptions, type CannibalizationPage, type CannibalizationResult, type CannibalizationSortMetric, type ClusterType, type ClusteringOptions, type ClusteringResult, type ComparisonMode, type ComparisonPeriod, type CompositeSourceOptions, type ConcentrationInput, type ConcentrationItem, type ConcentrationOptions, type ConcentrationResult, type ConcentrationRiskLevel, type CurrentSitemapScope, type DateRow, type DecayInput, type DecayOptions, type DecayResult, type DecaySeriesPoint, type DecaySortMetric, type DefineAnalyzerOptions, type DefineReportOptions, type DefinedAnalyzer, type DefinedReport, type DryRunReportResult, ENGINE_QUERY_CAPABILITIES, type EngineQuerySourceOptions, type ExecuteSqlOptions, type FileSet, type FormatReportOptions, INTENT_CLASSIFIER_VERSION, IN_MEMORY_DEFAULT_CAPABILITIES, type InMemoryQuerySourceOptions, type IntentClassification, type KeywordCluster, type MonthlyData, type MoverData, type MoversInput, type MoversOptions, type MoversResult, type MoversSortMetric, NORMALIZER_VERSION, type OpportunityFactors, type OpportunityOptions, type OpportunityResult, type OpportunitySortMetric, type OpportunityWeights, type PadTimeseriesOptions, type PageRow, type Plan, type QueriesRow, type QueryPageRow, type QueryRow, REPORTS, ROW_ANALYZERS, type ReduceContext, type ReduceCtx, type Reducer, type ReportContext, type ReportFinding, type ReportPlanStep, type ReportResult, type ReportSection, type RequiredCapability, type ResolveWindowOptions, type ResolvedWindow, type RowQueriesPlan, type RunReportOptions, SEARCH_INTENT_CODE, SITEMAP_SYNC_COLLAPSE_POLICY, SITEMAP_TRUST_COLLAPSE_POLICY, SQL_ANALYZERS, type SearchIntent, type SeasonalityMetric, type SeasonalityOptions, type SeasonalityResult, type SitemapCollapsePolicy, type SitemapCollapseState, type SitemapDelta, type SitemapHealthDiff, type SitemapHealthInput, type SitemapHealthRow, type SitemapHealthTotals, type SortOrder, type SourceCapabilities, type SqlExtraQuery, type SqlPlan, type SqlPlanSpec, type StrikingDistanceInputRow, type StrikingDistanceOptions, type StrikingDistanceResult, type TypedRowQuery, type WindowPreset, type ZeroClickOptions, type ZeroClickResult, analysisErrorToException, analysisErrors, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzeOpportunity, analyzePageConcentration, analyzeSeasonality, analyzeStrikingDistance, analyzeZeroClick, classifyQueryIntent, classifySitemapCollapse, compareCurrentSitemapScope, comparisonOf, createAnalyzerRegistry, createCompositeSource, createEngineQuerySource, createInMemoryQuerySource, createSorter, defaultAnalyzerRegistry, defaultReportRegistry, defineAnalyzer, diffSitemapHealth, dryRunReport, encodeIntent, formatAnalysisError, formatReport, isAnalysisError, normalizeQuery, num, padTimeseries, periodOf, queryRows, resolveWindow, runAnalyzerFromSource, runAnalyzerWithEngine, runReport, runReportResult, sitemapHistoryHasCollapse };

package/dist/index.mjs

@@ -1,4 +1,3 @@
-import { DEFAULT_PRIORITY_SOURCES, mergePriorityActions, normalizePriorityActions, scorePriorityActions } from "./action-priority.mjs";
 import { analysisErrorToException, analysisErrors, formatAnalysisError, isAnalysisError } from "./errors.mjs";
 import { analyzeBrandSegmentation } from "./analyzers/brand.mjs";
 import { createSorter } from "./types.mjs";
@@ -29,4 +28,4 @@ import { AnalyzerCapabilityError, createAnalyzerRegistry, defineAnalyzer, runAna
 import { comparisonOf, padTimeseries, periodOf, resolveWindow } from "@gscdump/engine/period";
 import { num } from "@gscdump/engine/analysis-types";
 import { ENGINE_QUERY_CAPABILITIES, createEngineQuerySource, queryRows, runAnalyzerWithEngine } from "@gscdump/engine/source";
-export { AnalyzerCapabilityError, DEFAULT_PRIORITY_SOURCES, ENGINE_QUERY_CAPABILITIES, INTENT_CLASSIFIER_VERSION, IN_MEMORY_DEFAULT_CAPABILITIES, NORMALIZER_VERSION, REPORTS, ROW_ANALYZERS, SEARCH_INTENT_CODE, SITEMAP_SYNC_COLLAPSE_POLICY, SITEMAP_TRUST_COLLAPSE_POLICY, SQL_ANALYZERS, analysisErrorToException, analysisErrors, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzeOpportunity, analyzePageConcentration, analyzeSeasonality, analyzeStrikingDistance, analyzeZeroClick, classifyQueryIntent, classifySitemapCollapse, compareCurrentSitemapScope, comparisonOf, createAnalyzerRegistry, createCompositeSource, createEngineQuerySource, createInMemoryQuerySource, createSorter, defaultAnalyzerRegistry, defaultReportRegistry, defineAnalyzer, diffSitemapHealth, dryRunReport, encodeIntent, formatAnalysisError, formatReport, isAnalysisError, mergePriorityActions, normalizePriorityActions, normalizeQuery, num, padTimeseries, periodOf, queryRows, resolveWindow, runAnalyzerFromSource, runAnalyzerWithEngine, runReport, runReportResult, scorePriorityActions, sitemapHistoryHasCollapse };
+export { AnalyzerCapabilityError, ENGINE_QUERY_CAPABILITIES, INTENT_CLASSIFIER_VERSION, IN_MEMORY_DEFAULT_CAPABILITIES, NORMALIZER_VERSION, REPORTS, ROW_ANALYZERS, SEARCH_INTENT_CODE, SITEMAP_SYNC_COLLAPSE_POLICY, SITEMAP_TRUST_COLLAPSE_POLICY, SQL_ANALYZERS, analysisErrorToException, analysisErrors, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzeOpportunity, analyzePageConcentration, analyzeSeasonality, analyzeStrikingDistance, analyzeZeroClick, classifyQueryIntent, classifySitemapCollapse, compareCurrentSitemapScope, comparisonOf, createAnalyzerRegistry, createCompositeSource, createEngineQuerySource, createInMemoryQuerySource, createSorter, defaultAnalyzerRegistry, defaultReportRegistry, defineAnalyzer, diffSitemapHealth, dryRunReport, encodeIntent, formatAnalysisError, formatReport, isAnalysisError, normalizeQuery, num, padTimeseries, periodOf, queryRows, resolveWindow, runAnalyzerFromSource, runAnalyzerWithEngine, runReport, runReportResult, sitemapHistoryHasCollapse };

package/dist/report/format.mjs

@@ -30,11 +30,6 @@ function renderSection(section, cap) {
 		lines.push(`   - [${f.entity.kind}] ${f.entity.value} ${metricsStr}${f.why ? ` — ${f.why}` : ""}`);
 	}
 	if (section.truncated && section.truncated.kept < section.truncated.total) lines.push(`   … +${section.truncated.total - section.truncated.kept} more`);
-	for (const a of section.actions) {
-		const target = a.target ? ` ${a.target.kind}=${a.target.value}` : "";
-		lines.push(`   → ${a.kind}${target}: ${a.rationale}`);
-		if (a.cliHint) lines.push(`     $ ${a.cliHint}`);
-	}
 	lines.push("");
 	return lines;
 }

package/dist/report/registry.mjs

@@ -4,7 +4,6 @@ import { healthReport } from "./reports/health.mjs";
 import { moversReport } from "./reports/movers.mjs";
 import { opportunitiesReport } from "./reports/opportunities.mjs";
 import { prePublishReport } from "./reports/pre-publish.mjs";
-import { priorityReport } from "./reports/priority.mjs";
 import { risksReport } from "./reports/risks.mjs";
 import { triageReport } from "./reports/triage.mjs";
 import { createReportRegistry } from "@gscdump/engine/report";
@@ -15,7 +14,6 @@ const REPORTS = [
 	moversReport,
 	opportunitiesReport,
 	prePublishReport,
-	priorityReport,
 	risksReport,
 	triageReport
 ];

package/dist/report/reports/brand.mjs

@@ -74,7 +74,6 @@ function buildBrandSplitSection(res, max) {
 		summary: { magnitudeLabel: summary ? `brand share ${(brandShare * 100).toFixed(1)}% (${summary.brandClicks} brand vs ${summary.nonBrandClicks} non-brand clicks)` : "no summary available" },
 		findings,
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "brand")
 	};
 }
@@ -98,7 +97,6 @@ function buildConcentrationSection(res, max) {
 		summary: head ? { magnitudeLabel: `HHI ${head.hhi.toFixed(0)} (${head.riskLevel}); top-N share ${(head.topNConcentration * 100).toFixed(1)}%` } : {},
 		findings,
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "concentration", { dimension: "keywords" })
 	};
 }

package/dist/report/reports/growth.mjs

@@ -73,7 +73,6 @@ function buildContentVelocity(res) {
 		summary: { magnitudeLabel: `${totalNew} new keywords across ${rows.length} weeks (avg ${avgPerWeek.toFixed(1)}/wk)` },
 		findings: [],
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "content-velocity")
 	};
 }
@@ -88,7 +87,6 @@ function buildKeywordBreadth(res) {
 		summary: { magnitudeLabel: top ? `${totalPages} pages; modal bucket "${top.bucket}" (${top.pageCount} pages)` : "no data" },
 		findings: [],
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "keyword-breadth")
 	};
 }
@@ -101,7 +99,6 @@ function buildIntentAtlas(res) {
 		summary: { magnitudeLabel: `${rows.length} clusters covering ${rows.reduce((s, r) => s + r.keywordCount, 0)} keywords` },
 		findings: [],
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "intent-atlas")
 	};
 }
@@ -137,7 +134,6 @@ function buildLongTail(res, max) {
 		findings,
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "long-tail")
 	};
 }

package/dist/report/reports/health.mjs

@@ -82,7 +82,6 @@ function buildCtrAnomalySection(res, max) {
 		findings,
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "ctr-anomaly")
 	};
 }
@@ -108,7 +107,6 @@ function buildChangePointSection(res, max) {
 		findings,
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "change-point")
 	};
 }
@@ -134,7 +132,6 @@ function buildPositionVolatilitySection(res, max) {
 		findings,
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "position-volatility")
 	};
 }

package/dist/report/reports/movers.mjs

@@ -111,7 +111,6 @@ function buildMoversSection(res, direction, max, minChange) {
 		findings,
 		truncated: truncation(total, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "movers")
 	};
 }
@@ -162,17 +161,7 @@ function buildDeclinersSection(moversRes, decayRes, max, minChange) {
 			magnitudeLabel: `${Math.round(totalLost)} clicks lost`
 		},
 		findings,
-		coverage: decayRes && moversRes ? "full" : "partial",
-		actions: lostPages.slice(0, 1).map((r) => ({
-			kind: "analyzer",
-			target: {
-				kind: "page",
-				value: r.page
-			},
-			params: { type: "change-point" },
-			rationale: "Investigate the change-point on the worst-affected page",
-			cliHint: `gscdump analyze change-point --start <date> --end <date>`
-		}))
+		coverage: decayRes && moversRes ? "full" : "partial"
 	};
 }
 function buildStrikingSection(res, max) {
@@ -199,7 +188,6 @@ function buildStrikingSection(res, max) {
 		findings,
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "striking-distance")
 	};
 }

package/dist/report/reports/opportunities.mjs

@@ -89,7 +89,6 @@ function buildStrikingSection(res, max) {
 		findings,
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "striking-distance")
 	};
 }
@@ -117,17 +116,6 @@ function buildOpportunitySection(res, max) {
 		})),
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: kept.slice(0, 1).map((r) => ({
-			kind: "fix",
-			target: r.page ? {
-				kind: "page",
-				value: r.page
-			} : {
-				kind: "query",
-				value: r.keyword
-			},
-			rationale: "Rewrite title/description to lift CTR at this position"
-		})),
 		artifact: sectionArtifact(res, "opportunity")
 	};
 }
@@ -154,7 +142,6 @@ function buildZeroClickSection(res, max) {
 		findings,
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "zero-click")
 	};
 }
@@ -179,7 +166,6 @@ function buildMigrationSection(res, max) {
 		})),
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "query-migration")
 	};
 }

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

@@ -76,10 +76,6 @@ function buildCannibalizationSection(res, matches, max) {
 		findings,
 		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: sectionArtifact(res, "cannibalization")
 	};
 }
@@ -106,7 +102,6 @@ function buildStrikingPeersSection(res, matches, max, topic) {
 		findings,
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "striking-distance")
 	};
 }

package/dist/report/reports/risks.mjs

@@ -102,15 +102,6 @@ function buildDecaySection(res, max) {
 		findings,
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: kept.slice(0, 1).map((r) => ({
-			kind: "analyzer",
-			target: {
-				kind: "page",
-				value: r.page
-			},
-			params: { type: "change-point" },
-			rationale: "Investigate change-point on the worst-affected page"
-		})),
 		artifact: sectionArtifact(res, "decay")
 	};
 }
@@ -140,7 +131,6 @@ function buildCannibalizationSection(res, max) {
 		findings,
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "cannibalization")
 	};
 }
@@ -167,7 +157,6 @@ function buildDarkTrafficSection(res, max) {
 		findings,
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "dark-traffic")
 	};
 }
@@ -194,7 +183,6 @@ function buildDeviceGapSection(res, max) {
 		})),
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "device-gap")
 	};
 }

package/dist/report/reports/triage.mjs

@@ -96,7 +96,6 @@ function buildChangePointSection(res, kind, matches, max) {
 		findings,
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "change-point")
 	};
 }
@@ -122,7 +121,6 @@ function buildMigrationSection(res, kind, matches, max, _rawTarget) {
 		findings,
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "query-migration")
 	};
 }
@@ -148,7 +146,6 @@ function buildVolatilitySection(res, kind, matches, max) {
 		findings,
 		truncated: truncation(rows.length, kept.length),
 		coverage: sectionCoverage(res),
-		actions: [],
 		artifact: sectionArtifact(res, "position-volatility")
 	};
 }

package/dist/report/runtime.mjs

@@ -34,8 +34,7 @@ function unavailableSection(section, failedKeys) {
 		severity: "unknown",
 		summary: { magnitudeLabel: `unavailable — ${failedKeys.join(", ")} failed` },
 		findings: [],
-		coverage: "partial",
-		actions: []
+		coverage: "partial"
 	};
 }
 function markUnavailableSections(sections, steps, outcomes) {

package/dist/scoring.mjs

@@ -1,15 +1,5 @@
-function clamp01(value) {
-	if (value < 0) return 0;
-	if (value > 1) return 1;
-	return value;
-}
-function clamp(value, min, max) {
-	if (value < min) return min;
-	if (value > max) return max;
-	return value;
-}
 function percentDifference(current, previous) {
 	if (previous === 0) return current > 0 ? 100 : 0;
 	return (current - previous) / previous * 100;
 }
-export { clamp, clamp01, percentDifference };
+export { percentDifference };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/analysis",
   "type": "module",
-  "version": "2.2.0",
+  "version": "3.0.0",
   "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": "^2.2.0",
-    "@gscdump/engine-gsc-api": "^2.2.0",
-    "gscdump": "^2.2.0"
+    "@gscdump/engine": "^3.0.0",
+    "@gscdump/engine-gsc-api": "^3.0.0",
+    "gscdump": "^3.0.0"
   },
   "devDependencies": {
     "vitest": "^4.1.10"

package/dist/action-priority.d.mts

@@ -1,34 +0,0 @@
-import { AnalysisResult } from "@gscdump/engine/analysis-types";
-type ActionSource = 'cannibalization' | 'striking-distance' | 'ctr-anomaly' | 'change-point' | 'opportunity';
-type Effort = 'low' | 'medium' | 'high';
-interface PriorityAction {
-  id: string;
-  title: string;
-  keyword: string;
-  page: string;
-  sources: ActionSource[];
-  severity: number;
-  impressions: number;
-  impact: number;
-  why: string;
-  effort: Effort;
-  priorityScore: number;
-  data: Partial<Record<ActionSource, Record<string, unknown>>>;
-}
-type ActionPrioritySourceStatus = 'pending' | 'running' | 'done' | 'skipped' | 'error';
-interface ActionPrioritySourceState {
-  source: ActionSource;
-  status: ActionPrioritySourceStatus;
-  count: number;
-  error?: string;
-}
-interface ActionPriorityResult {
-  actions: PriorityAction[];
-  totalSignals: number;
-  sources: ActionPrioritySourceState[];
-}
-declare const DEFAULT_PRIORITY_SOURCES: ActionSource[];
-declare function normalizePriorityActions(source: ActionSource, result: AnalysisResult): PriorityAction[];
-declare function mergePriorityActions(all: PriorityAction[]): PriorityAction[];
-declare function scorePriorityActions(actions: PriorityAction[]): PriorityAction[];
-export { ActionPriorityResult, ActionPrioritySourceState, ActionPrioritySourceStatus, ActionSource, DEFAULT_PRIORITY_SOURCES, Effort, PriorityAction, mergePriorityActions, normalizePriorityActions, scorePriorityActions };

package/dist/action-priority.mjs

@@ -1,201 +0,0 @@
-import { clamp, clamp01 } from "./scoring.mjs";
-const DEFAULT_PRIORITY_SOURCES = [
-	"striking-distance",
-	"opportunity",
-	"cannibalization",
-	"ctr-anomaly",
-	"change-point"
-];
-const EFFORT_BY_SOURCE = {
-	"striking-distance": "low",
-	"opportunity": "low",
-	"cannibalization": "medium",
-	"ctr-anomaly": "high",
-	"change-point": "high"
-};
-const EFFORT_MULTIPLIER = {
-	low: 1.3,
-	medium: 1,
-	high: .7
-};
-const EFFORT_RANK = {
-	low: 0,
-	medium: 1,
-	high: 2
-};
-function idKey(keyword, page) {
-	return `${keyword.toLowerCase()}|${page.toLowerCase()}`;
-}
-function truncate(s, n) {
-	return s.length <= n ? s : `${s.slice(0, n - 1)}...`;
-}
-function buildAction(spec) {
-	return {
-		id: idKey(spec.keyword, spec.page),
-		title: spec.title,
-		keyword: spec.keyword,
-		page: spec.page,
-		sources: [spec.source],
-		severity: spec.severity,
-		impressions: spec.impressions,
-		impact: spec.impact,
-		effort: EFFORT_BY_SOURCE[spec.source],
-		why: spec.why,
-		priorityScore: 0,
-		data: { [spec.source]: spec.data }
-	};
-}
-function fromStrikingDistance(rows) {
-	const out = [];
-	for (const r of rows) {
-		if (r.page == null) continue;
-		const impact = Math.max(0, r.potentialClicks);
-		if (impact <= 0) continue;
-		const posScore = clamp01((20 - r.position) / 16);
-		const imprScore = Math.min(1, r.impressions / 5e3);
-		out.push(buildAction({
-			source: "striking-distance",
-			keyword: r.keyword,
-			page: r.page,
-			title: `Push "${truncate(r.keyword, 40)}" onto page 1`,
-			why: `Ranks #${r.position.toFixed(1)} with ${Math.round(r.impressions)} impressions; small gains unlock page-1 clicks.`,
-			severity: Math.round(100 * Math.sqrt(posScore * imprScore)),
-			impressions: r.impressions,
-			impact,
-			data: r
-		}));
-	}
-	return out;
-}
-function fromOpportunity(rows) {
-	const out = [];
-	for (const r of rows) {
-		if (r.page == null) continue;
-		const impact = Math.max(0, r.potentialClicks);
-		if (impact <= 0) continue;
-		out.push(buildAction({
-			source: "opportunity",
-			keyword: r.keyword,
-			page: r.page,
-			title: `Improve on-page for "${truncate(r.keyword, 40)}"`,
-			why: `Opportunity score ${Math.round(r.opportunityScore)}; CTR ${(r.ctr * 100).toFixed(1)}% vs expected at pos ${r.position.toFixed(1)}.`,
-			severity: Math.round(r.opportunityScore),
-			impressions: r.impressions,
-			impact,
-			data: r
-		}));
-	}
-	return out;
-}
-function fromCannibalization(events) {
-	const out = [];
-	for (const ev of events) {
-		if (ev.severity < 30) continue;
-		out.push(buildAction({
-			source: "cannibalization",
-			keyword: ev.keyword,
-			page: ev.leaderUrl,
-			title: `Consolidate cannibalization on "${truncate(ev.keyword, 36)}"`,
-			why: `${ev.competitorCount} URLs split ${Math.round(ev.totalImpressions)} impressions; leader loses ~${Math.round(ev.stolenClicks)} clicks to siblings.`,
-			severity: Math.round(ev.severity),
-			impressions: ev.totalImpressions,
-			impact: Math.max(0, ev.stolenClicks),
-			data: ev
-		}));
-	}
-	return out;
-}
-function fromCtrAnomaly(rows) {
-	const out = [];
-	let maxRaw = 0;
-	for (const r of rows) if (r.severity > maxRaw) maxRaw = r.severity;
-	for (const r of rows) {
-		const impact = Math.max(0, r.clicksLost);
-		if (impact <= 0) continue;
-		out.push(buildAction({
-			source: "ctr-anomaly",
-			keyword: r.keyword,
-			page: r.page,
-			title: `Lift CTR on "${truncate(r.keyword, 36)}"`,
-			why: `CTR collapsed ${r.breachDaysDown} days at flat position; ~${Math.round(r.clicksLost)} clicks lost vs baseline ${(r.baselineCtr * 100).toFixed(1)}%.`,
-			severity: maxRaw > 0 ? Math.round(r.severity / maxRaw * 100) : 0,
-			impressions: r.totalImpressions,
-			impact,
-			data: r
-		}));
-	}
-	return out;
-}
-function fromChangePoint(rows) {
-	const out = [];
-	for (const r of rows) {
-		if (r.direction !== "worsened") continue;
-		const days = Math.max(1, r.totalDays / 2);
-		const impact = Math.abs(r.leftMean - r.rightMean) * days;
-		if (impact <= 0) continue;
-		out.push(buildAction({
-			source: "change-point",
-			keyword: r.keyword,
-			page: r.page,
-			title: `Diagnose drop on "${truncate(r.keyword, 34)}"`,
-			why: `Significant regression around ${r.changeDate} (${r.leftMean.toFixed(1)} -> ${r.rightMean.toFixed(1)}, LLR ${r.llr.toFixed(0)}).`,
-			severity: clamp(Math.round(Math.log10(Math.max(10, r.llr)) / 3 * 100), 0, 100),
-			impressions: r.totalImpressions,
-			impact,
-			data: r
-		}));
-	}
-	return out;
-}
-function normalizePriorityActions(source, result) {
-	const rows = result.results;
-	if (source === "striking-distance") return fromStrikingDistance(rows);
-	if (source === "opportunity") return fromOpportunity(rows);
-	if (source === "cannibalization") return fromCannibalization(rows);
-	if (source === "ctr-anomaly") return fromCtrAnomaly(rows);
-	return fromChangePoint(rows);
-}
-function mergePriorityActions(all) {
-	const byId = /* @__PURE__ */ new Map();
-	for (const a of all) {
-		const existing = byId.get(a.id);
-		if (existing == null) {
-			byId.set(a.id, {
-				...a,
-				sources: [...a.sources],
-				data: { ...a.data }
-			});
-			continue;
-		}
-		const mergedSources = [.../* @__PURE__ */ new Set([...existing.sources, ...a.sources])];
-		const preferNew = a.severity > existing.severity;
-		const mergedEffort = EFFORT_RANK[a.effort] < EFFORT_RANK[existing.effort] ? a.effort : existing.effort;
-		byId.set(a.id, {
-			id: existing.id,
-			title: preferNew ? a.title : existing.title,
-			keyword: existing.keyword,
-			page: existing.page,
-			sources: mergedSources,
-			severity: Math.max(existing.severity, a.severity),
-			impressions: Math.max(existing.impressions, a.impressions),
-			impact: existing.impact + a.impact,
-			why: preferNew ? a.why : existing.why,
-			effort: mergedEffort,
-			priorityScore: 0,
-			data: {
-				...existing.data,
-				...a.data
-			}
-		});
-	}
-	return [...byId.values()];
-}
-function scorePriorityActions(actions) {
-	for (const a of actions) {
-		const mult = EFFORT_MULTIPLIER[a.effort];
-		a.priorityScore = a.impact * (1 + a.severity / 100) * mult;
-	}
-	actions.sort((a, b) => b.priorityScore - a.priorityScore);
-	return actions;
-}
-export { DEFAULT_PRIORITY_SOURCES, mergePriorityActions, normalizePriorityActions, scorePriorityActions };

package/dist/report/reports/priority.mjs

@@ -1,98 +0,0 @@
-import { DEFAULT_PRIORITY_SOURCES, mergePriorityActions, normalizePriorityActions, scorePriorityActions } from "../../action-priority.mjs";
-import { defineReport } from "@gscdump/engine/report";
-const DEFAULT_LIMIT = 40;
-const DEFAULT_ACTIONS = 10;
-const priorityReport = defineReport({
-	id: "priority",
-	description: "Ranked priority actions composed from striking-distance, opportunity, cannibalization, ctr-anomaly, and change-point signals.",
-	defaultPeriod: "last-28d",
-	defaultComparison: "prev-period",
-	argsSpec: {
-		"limit": {
-			type: "number",
-			description: "Max actions in the section",
-			default: DEFAULT_LIMIT
-		},
-		"max-actions": {
-			type: "number",
-			description: "Top-N rendered as ReportAction",
-			default: DEFAULT_ACTIONS
-		}
-	},
-	plan: (_params, window) => {
-		const dates = {
-			startDate: window.start,
-			endDate: window.end
-		};
-		const cmp = window.comparison ? {
-			prevStartDate: window.comparison.start,
-			prevEndDate: window.comparison.end
-		} : {};
-		return DEFAULT_PRIORITY_SOURCES.map((source) => ({
-			key: source,
-			type: source,
-			params: {
-				...dates,
-				...cmp,
-				limit: 100
-			},
-			required: false,
-			feeds: ["priority"]
-		}));
-	},
-	reduce: (results, ctx) => {
-		const limit = ctx.params.limit ?? DEFAULT_LIMIT;
-		const maxActions = ctx.params.maxActions ?? DEFAULT_ACTIONS;
-		const all = [];
-		let anyMissing = false;
-		for (const source of DEFAULT_PRIORITY_SOURCES) {
-			const r = results[source];
-			if (!r) {
-				anyMissing = true;
-				continue;
-			}
-			all.push(...normalizePriorityActions(source, r));
-		}
-		const ranked = scorePriorityActions(mergePriorityActions(all)).slice(0, limit);
-		const findings = ranked.map((a) => ({
-			entity: {
-				kind: "query",
-				value: a.keyword
-			},
-			metrics: {
-				priorityScore: a.priorityScore,
-				severity: a.severity,
-				impact: a.impact,
-				impressions: a.impressions
-			},
-			why: `${a.title} — ${a.why} (page: ${a.page})`
-		}));
-		const actions = ranked.slice(0, maxActions).map((a) => {
-			const primarySource = a.sources[0];
-			return {
-				kind: primarySource === "cannibalization" ? "fix" : "analyzer",
-				target: {
-					kind: "page",
-					value: a.page
-				},
-				params: { type: primarySource },
-				rationale: a.title
-			};
-		});
-		const topSeverity = ranked[0]?.severity ?? 0;
-		return { sections: [{
-			id: "priority",
-			title: "Priority actions",
-			severity: topSeverity >= 70 ? "high" : topSeverity >= 40 ? "medium" : ranked.length ? "low" : "info",
-			summary: { magnitudeLabel: `${ranked.length} actions ranked` },
-			findings,
-			truncated: all.length > ranked.length ? {
-				kept: ranked.length,
-				total: all.length
-			} : void 0,
-			coverage: anyMissing ? "partial" : "full",
-			actions
-		}] };
-	}
-});
-export { priorityReport };