@gscdump/analysis 2.3.0 → 3.1.0

package/README.md

@@ -16,8 +16,11 @@ npm install @gscdump/analysis
 
 | Subpath | Use when |
 |---|---|
-| `@gscdump/analysis` | Top-level barrel: row analyzers, source-backed analyzers, `SQL_ANALYZERS`, `analyzeInBrowser`, `defaultAnalyzerRegistry`, contract types re-exported from engine. |
+| `@gscdump/analysis` | Pure analyzers, `analyzeInBrowser`, and shared analyzer contracts. |
 | `@gscdump/analysis/registry` | Pre-built `defaultAnalyzerRegistry` (rows + sql). Convenience for callers who don't care about bundle size. |
+| `@gscdump/analysis/errors` | Typed analysis failures and rendering helpers. |
+| `@gscdump/analysis/report` | Report registry and runtime. |
+| `@gscdump/analysis/source` | Portable source factories. |
 
 The contract layer (`Analyzer`, `Plan`, `Capability`, `AnalysisParams`, `AnalysisResult`, `AnalysisQuerySource`, `runAnalyzerFromSource`, `createAnalyzerRegistry`, `defineAnalyzer`, period helpers, `createEngineQuerySource`) lives in `@gscdump/engine` under the `/analyzer`, `/analysis-types`, `/period`, `/source`, and `/resolver` subpaths. Most are re-exported from `@gscdump/analysis` for convenience.
 
@@ -41,24 +44,24 @@ 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 { defaultAnalyzerRegistry } from '@gscdump/analysis/registry'
 import {
-  defaultAnalyzerRegistry,
   defaultReportRegistry,
   runReport,
-} from '@gscdump/analysis'
+} from '@gscdump/analysis/report'
 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:
@@ -76,7 +79,7 @@ const movers = await analyzeMoversFromSource(source, { current, previous })
 SQL-native path. `SQL_ANALYZERS` dispatch through `runAnalyzerFromSource` against an engine-backed source.
 
 ```ts
-import { ROW_ANALYZERS, SQL_ANALYZERS } from '@gscdump/analysis'
+import { ROW_ANALYZERS, SQL_ANALYZERS } from '@gscdump/analysis/registry'
 import { createAnalyzerRegistry, runAnalyzerFromSource } from '@gscdump/engine/analyzer'
 import { createEngineQuerySource } from '@gscdump/engine/source'
 
@@ -145,8 +148,8 @@ Available source factories:
 
 - `createGscApiQuerySource({ client, siteUrl })` — `@gscdump/engine-gsc-api`
 - `createLiveGscSource({ accessToken, siteUrl })` — `@gscdump/engine-gsc-api`
-- `createCompositeSource({ engine, gsc })` — `@gscdump/analysis`; engine first, GSC fallback
-- `createInMemoryQuerySource({ queryRows })` — `@gscdump/analysis`
+- `createCompositeSource({ engine, gsc })` — `@gscdump/analysis/source`; engine first, GSC fallback
+- `createInMemoryQuerySource({ queryRows })` — `@gscdump/analysis/source`
 - `createEngineQuerySource({ engine, ctx })` — `@gscdump/engine/source`
 - `createSqliteQuerySource({ ... })` — `@gscdump/engine-sqlite`
 
@@ -172,7 +175,7 @@ Presets: `last-7d`, `last-28d`, `last-30d`, `last-90d`, `last-180d`, `last-365d`
 | Row analyzers (`analyzeMovers`, `analyzeDecay`, ...) | Public |
 | Source factories + `analyzeFromSource` | Public |
 | `Analyzer<P, R>` contract + `createAnalyzerRegistry` (re-exported from `@gscdump/engine/analyzer`) | Public |
-| Source factories on the package root | Public |
+| Source factories under `@gscdump/analysis/source` | Public |
 | Per-analyzer modules under `analysis/src/analyzers/<name>` | Private |
 
 ## Related

package/dist/analyzer/all.mjs

@@ -1,32 +1,32 @@
-import { bayesianCtrAnalyzer } from "../analyzers/bayesian-ctr.mjs";
-import { bipartitePagerankAnalyzer } from "../analyzers/bipartite-pagerank.mjs";
 import { brandAnalyzer } from "../analyzers/brand.mjs";
 import { cannibalizationAnalyzer } from "../analyzers/cannibalization.mjs";
-import { changePointAnalyzer } from "../analyzers/change-point.mjs";
 import { clusteringAnalyzer } from "../analyzers/clustering.mjs";
 import { concentrationAnalyzer } from "../analyzers/concentration.mjs";
+import { decayAnalyzer } from "../analyzers/decay.mjs";
+import { moversAnalyzer } from "../analyzers/movers.mjs";
+import { opportunityAnalyzer } from "../analyzers/opportunity.mjs";
+import { seasonalityAnalyzer } from "../analyzers/seasonality.mjs";
+import { strikingDistanceAnalyzer } from "../analyzers/striking-distance.mjs";
+import { zeroClickAnalyzer } from "../analyzers/zero-click.mjs";
+import { bayesianCtrAnalyzer } from "../analyzers/bayesian-ctr.mjs";
+import { bipartitePagerankAnalyzer } from "../analyzers/bipartite-pagerank.mjs";
+import { changePointAnalyzer } from "../analyzers/change-point.mjs";
 import { contentVelocityAnalyzer } from "../analyzers/content-velocity.mjs";
 import { ctrAnomalyAnalyzer } from "../analyzers/ctr-anomaly.mjs";
 import { ctrCurveAnalyzer } from "../analyzers/ctr-curve.mjs";
 import { darkTrafficAnalyzer } from "../analyzers/dark-traffic.mjs";
 import { dataDetailAnalyzer } from "../analyzers/data-detail.mjs";
 import { dataQueryAnalyzer } from "../analyzers/data-query.mjs";
-import { decayAnalyzer } from "../analyzers/decay.mjs";
 import { deviceGapAnalyzer } from "../analyzers/device-gap.mjs";
 import { intentAtlasAnalyzer } from "../analyzers/intent-atlas.mjs";
 import { keywordBreadthAnalyzer } from "../analyzers/keyword-breadth.mjs";
 import { longTailAnalyzer } from "../analyzers/long-tail.mjs";
-import { moversAnalyzer } from "../analyzers/movers.mjs";
-import { opportunityAnalyzer } from "../analyzers/opportunity.mjs";
 import { positionDistributionAnalyzer } from "../analyzers/position-distribution.mjs";
 import { positionVolatilityAnalyzer } from "../analyzers/position-volatility.mjs";
 import { queryMigrationAnalyzer } from "../analyzers/query-migration.mjs";
-import { seasonalityAnalyzer } from "../analyzers/seasonality.mjs";
 import { stlDecomposeAnalyzer } from "../analyzers/stl-decompose.mjs";
-import { strikingDistanceAnalyzer } from "../analyzers/striking-distance.mjs";
 import { survivalAnalyzer } from "../analyzers/survival.mjs";
 import { trendsAnalyzer } from "../analyzers/trends.mjs";
-import { zeroClickAnalyzer } from "../analyzers/zero-click.mjs";
 const ALL_ANALYZERS = [
 	bayesianCtrAnalyzer,
 	bipartitePagerankAnalyzer,

package/dist/analyzers/bipartite-pagerank.mjs

@@ -1,8 +1,8 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
-import { num } from "@gscdump/engine/analysis-types";
 const BIPARTITE_PAGERANK_ITERATIONS = 25;
 const BIPARTITE_PAGERANK_DAMPING = .85;
 const bipartitePagerankAnalyzer = defineAnalyzer({

package/dist/analyzers/brand.mjs

@@ -1,11 +1,11 @@
-import { rowString } from "../analyzer/row-values.mjs";
 import { queriesQueryState } from "../analyzer/adapt-rows.mjs";
+import { rowString } from "../analyzer/row-values.mjs";
 import { analysisErrorToException, analysisErrors } from "../errors.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 import { err, ok, unwrapResult } from "gscdump/result";
 function escapeRegexAlt(s) {
 	return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");

package/dist/analyzers/cannibalization.mjs

@@ -1,11 +1,11 @@
-import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { queriesQueryState } from "../analyzer/adapt-rows.mjs";
+import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { createSorter } from "../types.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 const sortRowResults = createSorter((item, metric) => {
 	switch (metric) {
 		case "clicks": return item.totalClicks;

package/dist/analyzers/clustering.mjs

@@ -1,10 +1,10 @@
-import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { queriesQueryState } from "../analyzer/adapt-rows.mjs";
+import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 const INTENT_PREFIXES_REGEX = "^(how to|what is|what are|why is|why do|where to|when to|best|top|vs|versus|compare|review|buy|cheap|free|near me)(\\s|$)";
 const INTENT_PREFIXES = [
 	"how to",

package/dist/analyzers/concentration.mjs

@@ -1,10 +1,10 @@
-import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { pagesQueryState, queriesQueryState } from "../analyzer/adapt-rows.mjs";
+import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 function analyzeConcentration(items, options = {}) {
 	const { topN = 10 } = options;
 	if (items.length === 0) return {

package/dist/analyzers/dark-traffic.mjs

@@ -1,8 +1,8 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
-import { num } from "@gscdump/engine/analysis-types";
 const darkTrafficAnalyzer = defineAnalyzer({
 	id: "dark-traffic",
 	buildSql(params) {

package/dist/analyzers/decay.mjs

@@ -1,12 +1,12 @@
-import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { pagesQueryState } from "../analyzer/adapt-rows.mjs";
+import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { buildPeriodMap, createMetricSorter } from "../types.mjs";
 import { paginateInMemory } from "../analyzer/paginate.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { comparisonOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 const sortResults = createMetricSorter("lostClicks", {
 	lostClicks: "desc",
 	declinePercent: "desc",

package/dist/analyzers/device-gap.mjs

@@ -1,8 +1,8 @@
 import { rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
-import { num } from "@gscdump/engine/analysis-types";
 const deviceGapAnalyzer = defineAnalyzer({
 	id: "device-gap",
 	buildSql(params) {

package/dist/analyzers/intent-atlas.mjs

@@ -1,9 +1,9 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { defaultEndDate } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 import { daysAgoUtc } from "gscdump/dates";
 const INTENT_ATLAS_STOP_WORDS = [
 	"the",

package/dist/analyzers/keyword-breadth.mjs

@@ -1,9 +1,9 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 const keywordBreadthAnalyzer = defineAnalyzer({
 	id: "keyword-breadth",
 	buildSql(params) {

package/dist/analyzers/long-tail.mjs

@@ -1,9 +1,9 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 function downsampleLogRank(points) {
 	const toPoint = (p) => ({
 		rank: num(p.rank),

package/dist/analyzers/movers.mjs

@@ -1,12 +1,12 @@
-import { percentDifference } from "../scoring.mjs";
-import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { queriesQueryState } from "../analyzer/adapt-rows.mjs";
+import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { buildPeriodMap } from "../types.mjs";
+import { percentDifference } from "../scoring.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { comparisonOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 function withCanonicalFields(r) {
 	return {
 		...r,

package/dist/analyzers/opportunity.mjs

@@ -1,10 +1,10 @@
 import { queriesQueryState } from "../analyzer/adapt-rows.mjs";
 import { paginateClause, paginateSortedInMemory } from "../analyzer/paginate.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 const EXPECTED_CTR_BY_POSITION = {
 	1: .3,
 	2: .15,

package/dist/analyzers/position-distribution.mjs

@@ -1,8 +1,8 @@
 import { rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
-import { num } from "@gscdump/engine/analysis-types";
 const positionDistributionAnalyzer = defineAnalyzer({
 	id: "position-distribution",
 	buildSql(params) {

package/dist/analyzers/position-volatility.mjs

@@ -1,9 +1,9 @@
 import { rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 const positionVolatilityAnalyzer = defineAnalyzer({
 	id: "position-volatility",
 	buildSql(params) {

package/dist/analyzers/query-migration.mjs

@@ -1,9 +1,9 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 import { MS_PER_DAY, toIsoDate } from "gscdump/dates";
 const queryMigrationAnalyzer = defineAnalyzer({
 	id: "query-migration",

package/dist/analyzers/seasonality.mjs

@@ -1,9 +1,9 @@
-import { rowBoolean, rowString } from "../analyzer/row-values.mjs";
 import { datesQueryState } from "../analyzer/adapt-rows.mjs";
+import { rowBoolean, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
-import { num } from "@gscdump/engine/analysis-types";
 function calculateCV(values) {
 	if (values.length === 0) return 0;
 	const mean = values.reduce((a, b) => a + b, 0) / values.length;

package/dist/analyzers/stl-decompose.mjs

@@ -1,9 +1,9 @@
 import { parseJsonRows, rowBoolean, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { defaultEndDate } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 import { daysAgoUtc } from "gscdump/dates";
 const stlDecomposeAnalyzer = defineAnalyzer({
 	id: "stl-decompose",

package/dist/analyzers/striking-distance.mjs

@@ -1,9 +1,9 @@
 import { queriesQueryState } from "../analyzer/adapt-rows.mjs";
 import { paginateSortedInMemory } from "../analyzer/paginate.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
-import { num } from "@gscdump/engine/analysis-types";
 const DEFAULT_ROW_LIMIT = 25e3;
 function paginateStrikingDistance(results, options) {
 	return paginateSortedInMemory(results, {

package/dist/analyzers/survival.mjs

@@ -1,9 +1,9 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { defaultEndDate } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 import { MS_PER_DAY, daysAgoUtc } from "gscdump/dates";
 const survivalAnalyzer = defineAnalyzer({
 	id: "survival",

package/dist/analyzers/trends.mjs

@@ -1,9 +1,9 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { defaultEndDate } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 import { MS_PER_DAY, toIsoDate } from "gscdump/dates";
 const trendsAnalyzer = defineAnalyzer({
 	id: "trends",

package/dist/analyzers/zero-click.mjs

@@ -1,9 +1,9 @@
 import { paginateClause, paginateSortedInMemory } from "../analyzer/paginate.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 import { between, date, gsc, page, query } from "gscdump/query";
 const DEFAULT_ROW_LIMIT = 25e3;
 function analyzeZeroClick(rows, options = {}) {

package/dist/browser.d.mts

@@ -1,5 +1,5 @@
-import { AnalyzerRegistry } from "@gscdump/engine/analyzer";
 import { AnalysisParams, AnalysisResult } from "@gscdump/engine/analysis-types";
+import { AnalyzerRegistry } from "@gscdump/engine/analyzer";
 import { AttachedTableRunner, AttachedTableRunner as AnalyzerRunner, AttachedTableSourceOptions, AttachedTableSourceOptions as BrowserAnalyzeOptions } from "@gscdump/engine/source";
 declare function analyzeInBrowser(runner: AttachedTableRunner, opts: AttachedTableSourceOptions, params: AnalysisParams, registry: AnalyzerRegistry): Promise<AnalysisResult>;
 export { type AnalyzerRunner, type BrowserAnalyzeOptions, analyzeInBrowser };

package/dist/index.d.mts

@@ -1,8 +1,3 @@
-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";
@@ -17,17 +12,10 @@ import { ZeroClickOptions, ZeroClickResult, analyzeZeroClick } from "./analyzers
 import { AnalyzerRunner, BrowserAnalyzeOptions, analyzeInBrowser } from "./browser.mjs";
 import { INTENT_CLASSIFIER_VERSION, IntentClassification, SEARCH_INTENT_CODE, SearchIntent, classifyQueryIntent, encodeIntent } from "./query/intent.mjs";
 import { NORMALIZER_VERSION, normalizeQuery } from "./query/normalize.mjs";
-import { FormatReportOptions, formatReport } from "./report/format.mjs";
-import { REPORTS, defaultReportRegistry } from "./report/registry.mjs";
-import { DryRunReportResult, RunReportOptions, dryRunReport, runReport, runReportResult } from "./report/runtime.mjs";
-import "./report/index.mjs";
 import { CurrentSitemapScope, SITEMAP_SYNC_COLLAPSE_POLICY, SITEMAP_TRUST_COLLAPSE_POLICY, SitemapCollapsePolicy, SitemapCollapseState, SitemapDelta, SitemapHealthDiff, SitemapHealthInput, SitemapHealthRow, SitemapHealthTotals, classifySitemapCollapse, compareCurrentSitemapScope, diffSitemapHealth, sitemapHistoryHasCollapse } from "./sitemap-health.mjs";
-import { CompositeSourceOptions, createCompositeSource } from "./source/composite.mjs";
-import { IN_MEMORY_DEFAULT_CAPABILITIES, InMemoryQuerySourceOptions, createInMemoryQuerySource } from "./source/in-memory.mjs";
-import "./source/index.mjs";
+import { AnalysisParams, AnalysisResult, AnalysisTool, num } from "@gscdump/engine/analysis-types";
 import { Analyzer, AnalyzerCapabilityError, AnalyzerRegistry, AnalyzerRegistryInit, AnalyzerVariants, DefineAnalyzerOptions, DefinedAnalyzer, Plan, ReduceContext, ReduceCtx, Reducer, RequiredCapability, RowQueriesPlan, SqlExtraQuery, SqlPlan, SqlPlanSpec, TypedRowQuery, createAnalyzerRegistry, defineAnalyzer, runAnalyzerFromSource } from "@gscdump/engine/analyzer";
 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 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 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, ENGINE_QUERY_CAPABILITIES, type EngineQuerySourceOptions, type ExecuteSqlOptions, type FileSet, INTENT_CLASSIFIER_VERSION, 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, type ReduceContext, type ReduceCtx, type Reducer, type ReportContext, type ReportFinding, type ReportPlanStep, type ReportResult, type ReportSection, type RequiredCapability, type ResolveWindowOptions, type ResolvedWindow, type RowQueriesPlan, SEARCH_INTENT_CODE, SITEMAP_SYNC_COLLAPSE_POLICY, SITEMAP_TRUST_COLLAPSE_POLICY, 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, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzeOpportunity, analyzePageConcentration, analyzeSeasonality, analyzeStrikingDistance, analyzeZeroClick, classifyQueryIntent, classifySitemapCollapse, compareCurrentSitemapScope, comparisonOf, createAnalyzerRegistry, createEngineQuerySource, createSorter, defineAnalyzer, diffSitemapHealth, encodeIntent, normalizeQuery, num, padTimeseries, periodOf, queryRows, resolveWindow, runAnalyzerFromSource, runAnalyzerWithEngine, sitemapHistoryHasCollapse };

package/dist/index.mjs

@@ -1,32 +1,20 @@
-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";
 import { analyzeCannibalization } from "./analyzers/cannibalization.mjs";
 import { analyzeClustering } from "./analyzers/clustering.mjs";
 import { analyzeConcentration, analyzeKeywordConcentration, analyzePageConcentration } from "./analyzers/concentration.mjs";
-import { INTENT_CLASSIFIER_VERSION, SEARCH_INTENT_CODE, classifyQueryIntent, encodeIntent } from "./query/intent.mjs";
-import { NORMALIZER_VERSION, normalizeQuery } from "./query/normalize.mjs";
 import { analyzeDecay } from "./analyzers/decay.mjs";
 import { analyzeMovers } from "./analyzers/movers.mjs";
 import { analyzeOpportunity } from "./analyzers/opportunity.mjs";
 import { analyzeSeasonality } from "./analyzers/seasonality.mjs";
 import { analyzeStrikingDistance } from "./analyzers/striking-distance.mjs";
 import { analyzeZeroClick } from "./analyzers/zero-click.mjs";
-import { ROW_ANALYZERS } from "./analyzer/row-analyzers.mjs";
 import { analyzeInBrowser } from "./browser.mjs";
-import { SQL_ANALYZERS } from "./sql-analyzers.mjs";
-import { defaultAnalyzerRegistry } from "./default-registry.mjs";
-import { formatReport } from "./report/format.mjs";
-import { REPORTS, defaultReportRegistry } from "./report/registry.mjs";
-import { dryRunReport, runReport, runReportResult } from "./report/runtime.mjs";
-import "./report/index.mjs";
+import { INTENT_CLASSIFIER_VERSION, SEARCH_INTENT_CODE, classifyQueryIntent, encodeIntent } from "./query/intent.mjs";
+import { NORMALIZER_VERSION, normalizeQuery } from "./query/normalize.mjs";
 import { SITEMAP_SYNC_COLLAPSE_POLICY, SITEMAP_TRUST_COLLAPSE_POLICY, classifySitemapCollapse, compareCurrentSitemapScope, diffSitemapHealth, sitemapHistoryHasCollapse } from "./sitemap-health.mjs";
-import { createCompositeSource } from "./source/composite.mjs";
-import { IN_MEMORY_DEFAULT_CAPABILITIES, createInMemoryQuerySource } from "./source/in-memory.mjs";
-import "./source/index.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { AnalyzerCapabilityError, createAnalyzerRegistry, defineAnalyzer, runAnalyzerFromSource } from "@gscdump/engine/analyzer";
 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, NORMALIZER_VERSION, SEARCH_INTENT_CODE, SITEMAP_SYNC_COLLAPSE_POLICY, SITEMAP_TRUST_COLLAPSE_POLICY, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzeOpportunity, analyzePageConcentration, analyzeSeasonality, analyzeStrikingDistance, analyzeZeroClick, classifyQueryIntent, classifySitemapCollapse, compareCurrentSitemapScope, comparisonOf, createAnalyzerRegistry, createEngineQuerySource, createSorter, defineAnalyzer, diffSitemapHealth, encodeIntent, normalizeQuery, num, padTimeseries, periodOf, queryRows, resolveWindow, runAnalyzerFromSource, runAnalyzerWithEngine, sitemapHistoryHasCollapse };

package/dist/query/index.mjs

@@ -1,4 +1,4 @@
-import { buildDataDetailPlan, buildDataDetailRows, buildDataQueryPlan, buildDataQueryRows, shapeDataDetailRowResults, shapeDataDetailRows, shapeDataQueryRowResults, shapeDataQueryRows } from "./analyzers.mjs";
 import "./intent.mjs";
 import "./normalize.mjs";
+import { buildDataDetailPlan, buildDataDetailRows, buildDataQueryPlan, buildDataQueryRows, shapeDataDetailRowResults, shapeDataDetailRows, shapeDataQueryRowResults, shapeDataQueryRows } from "./analyzers.mjs";
 export { buildDataDetailPlan, buildDataDetailRows, buildDataQueryPlan, buildDataQueryRows, shapeDataDetailRowResults, shapeDataDetailRows, shapeDataQueryRowResults, shapeDataQueryRows };

package/dist/query-dimension.d.mts

@@ -0,0 +1,3 @@
+import { INTENT_CLASSIFIER_VERSION, IntentClassification, SEARCH_INTENT_CODE, SearchIntent, classifyQueryIntent, encodeIntent } from "./query/intent.mjs";
+import { NORMALIZER_VERSION, normalizeQuery } from "./query/normalize.mjs";
+export { INTENT_CLASSIFIER_VERSION, type IntentClassification, NORMALIZER_VERSION, SEARCH_INTENT_CODE, type SearchIntent, classifyQueryIntent, encodeIntent, normalizeQuery };

package/dist/query-dimension.mjs

@@ -0,0 +1,3 @@
+import { INTENT_CLASSIFIER_VERSION, SEARCH_INTENT_CODE, classifyQueryIntent, encodeIntent } from "./query/intent.mjs";
+import { NORMALIZER_VERSION, normalizeQuery } from "./query/normalize.mjs";
+export { INTENT_CLASSIFIER_VERSION, NORMALIZER_VERSION, SEARCH_INTENT_CODE, classifyQueryIntent, encodeIntent, normalizeQuery };

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.3.0",
+  "version": "3.1.0",
   "description": "GSC analyzers — striking-distance, opportunity, movers, decay, brand, clustering, concentration, seasonality. Pure row-based + DuckDB-native.",
   "author": {
     "name": "Harlan Wilton",
@@ -36,6 +36,11 @@
       "import": "./dist/errors.mjs",
       "default": "./dist/errors.mjs"
     },
+    "./query-dimension": {
+      "types": "./dist/query-dimension.d.mts",
+      "import": "./dist/query-dimension.mjs",
+      "default": "./dist/query-dimension.mjs"
+    },
     "./report": {
       "types": "./dist/report/index.d.mts",
       "import": "./dist/report/index.mjs",
@@ -57,9 +62,9 @@
   },
   "dependencies": {
     "pluralize": "^8.0.0",
-    "@gscdump/engine": "^2.3.0",
-    "gscdump": "^2.3.0",
-    "@gscdump/engine-gsc-api": "^2.3.0"
+    "@gscdump/engine": "^3.1.0",
+    "gscdump": "^3.1.0",
+    "@gscdump/engine-gsc-api": "^3.1.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 };