@canonry/canonry 7.65.0 → 7.66.0

package/dist/{chunk-M3OZL6PQ.js → chunk-IPF2S5G2.js}

@@ -2,13 +2,13 @@ import {
   bucketCliCommandDuration,
   isTelemetryEnabled,
   trackEvent
-} from "./chunk-XMKXXWMO.js";
+} from "./chunk-IHOVPHUW.js";
 import {
   getConfigDir
-} from "./chunk-C2PYKUD3.js";
+} from "./chunk-EYWC24VC.js";
 import {
   currentOutcomeAttribution
-} from "./chunk-IJKKK7F4.js";
+} from "./chunk-YRX5UOM3.js";
 import {
   AGENT_NONE,
   OutcomeSurfaces,
@@ -19,7 +19,7 @@ import {
   integrationConnectionPropertiesSchema,
   normalizeAgentSlug,
   usageSurfaceSchema
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 
 // src/outcome-telemetry.ts
 import fs from "fs";

package/dist/{chunk-3QKKHU7D.js → chunk-J5YZXRD5.js}

@@ -7,27 +7,27 @@ import {
   reparseStoredResult4,
   reparseStoredResult5,
   resolveStoredApiResponse
-} from "./chunk-HPUZMBS6.js";
+} from "./chunk-OSF27DCY.js";
 import {
   loadConfig
-} from "./chunk-C2PYKUD3.js";
+} from "./chunk-EYWC24VC.js";
 import {
   isMachineFormat
 } from "./chunk-HGMYEDAQ.js";
 import {
   determineCitationState
-} from "./chunk-S4VCXCRQ.js";
+} from "./chunk-QRBZBJ4U.js";
 import {
   backfillProjectAnswerMentions,
   competitorIdentityColumns,
   createRunCompetitorResolver,
   readMarketCompetitorNames,
   refreshSnapshotMentionIdentity
-} from "./chunk-Z2EENWM3.js";
+} from "./chunk-JYOMHNRP.js";
 import {
   classifyAiUserFetch,
   classifyCrawler
-} from "./chunk-Q2WZAD5W.js";
+} from "./chunk-BCRRAH5C.js";
 import {
   aiUserFetchEventsHourly,
   auditLog,
@@ -42,7 +42,7 @@ import {
   querySnapshots,
   rawEventSamples,
   runs
-} from "./chunk-XOMUSIM7.js";
+} from "./chunk-JALKQREN.js";
 import {
   ProviderNames,
   RetrievalContracts,
@@ -59,7 +59,7 @@ import {
   extractRecommendedCompetitors,
   normalizeUrlPath,
   openRouterRouteModel
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 
 // src/commands/backfill.ts
 import { setImmediate as yieldToEventLoop } from "timers/promises";
@@ -437,7 +437,7 @@ No DB writes performed. Re-run without --dry-run to apply.`);
   }
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-IAUGKMDO.js");
+  const { IntelligenceService } = await import("./intelligence-service-U4NSGZUH.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);

package/dist/{chunk-XOMUSIM7.js → chunk-JALKQREN.js}

@@ -20,7 +20,7 @@ import {
   templateLinkRatio,
   templateLinkUbiquityAvailable,
   validationError
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 import {
   __export
 } from "./chunk-MLKGABMK.js";

package/dist/{chunk-Z2EENWM3.js → chunk-JYOMHNRP.js}

@@ -9,14 +9,14 @@ import {
   normalizeCloudflareWorkerEvent,
   sessionizeJourneyRequests,
   verifyRequestSignature
-} from "./chunk-Q2WZAD5W.js";
+} from "./chunk-BCRRAH5C.js";
 import {
   currentOutcomeAttribution,
   getRequestContext,
   registerRequestContext,
   requestAuditIdentity,
   sanitizeRequestContext
-} from "./chunk-IJKKK7F4.js";
+} from "./chunk-YRX5UOM3.js";
 import {
   SentimentIdempotencyConflict,
   SentimentRepository,
@@ -154,7 +154,7 @@ import {
   userSessions,
   users,
   writeNegativeReviewMaxStars
-} from "./chunk-XOMUSIM7.js";
+} from "./chunk-JALKQREN.js";
 import {
   ADS_ACTIVATE_SCOPE,
   ADS_ACTIVATION_ABSOLUTE_MAX_ENTITIES,
@@ -338,6 +338,8 @@ import {
   SENTIMENT_ATTEMPT_PAGE_DEFAULT,
   SENTIMENT_INTERVAL_LIMITATION,
   SENTIMENT_QUERY_PAGE_DEFAULT,
+  SEO_MARKET_RANKING_MAX_SEARCHES,
+  SEO_PROJECT_MARKET_KEY,
   SEO_RUN_SCOPE,
   SEO_WRITE_SCOPE,
   SITE_AUDIT_ISSUES_DEFAULT_LIMIT,
@@ -949,6 +951,7 @@ import {
   providersFailing,
   qualifiedNameIncludesName,
   queryClassFilterSchema,
+  queryClassSchema,
   queryDtoSchema,
   queryGenerateRequestSchema,
   queryGenerateResponseSchema,
@@ -1042,6 +1045,8 @@ import {
   seoDomainIntelligenceListSchema,
   seoEvidenceQuerySchema,
   seoKeywordMetricsListSchema,
+  seoMarketRankingListSchema,
+  seoMarketRankingQuerySchema,
   seoOperatorTaskSchema,
   seoOverviewSchema,
   seoProfileInputSchema,
@@ -1055,6 +1060,7 @@ import {
   seoRunDetailSchema,
   seoRunListSchema,
   seoRunSchema,
+  seoSearchTextForQuery,
   seoStatusSchema,
   seoSyncInputSchema,
   serializeRunError,
@@ -1167,7 +1173,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 
 // ../api-routes/src/user-session.ts
 import crypto2 from "crypto";
@@ -15214,7 +15220,10 @@ function runDto(job, counts2) {
   return { id: job.id, projectId: job.projectKey, profileId: job.profileId, profileRevision: job.profileRevision, locationCode: job.profile.locationCode, languageCode: job.profile.languageCode, cancelRequested: job.cancelRequested, status: job.status, capabilities: job.profile.capabilities, scope: job.profile.scope, taskCount: counts2.reduce((sum, group) => sum + group.count, 0), completedTasks: counts2.filter((group) => group.status === SeoRunStatuses.completed || group.status === SeoRunStatuses.partial).reduce((sum, group) => sum + group.count, 0), failedTasks: counts2.filter((group) => group.status === SeoRunStatuses.failed).reduce((sum, group) => sum + group.count, 0), createdAt: job.createdAt, startedAt: job.startedAt, finishedAt: job.finishedAt, error: job.error };
 }
 function resultRows(tasks) {
-  return tasks.filter((task) => task.reconciliation?.outcome !== SeoAdapterOutcomes.failed).reduce((results, task) => ({ keywordMetrics: results.keywordMetrics.concat(task.results.keywordMetrics), domainIntelligence: results.domainIntelligence.concat(task.results.domainIntelligence), rankedKeywords: results.rankedKeywords.concat(task.results.rankedKeywords) }), emptySeoResults());
+  return tasks.filter((task) => task.reconciliation?.outcome !== SeoAdapterOutcomes.failed).reduce((results, task) => ({ keywordMetrics: results.keywordMetrics.concat(task.results.keywordMetrics), domainIntelligence: results.domainIntelligence.concat(task.results.domainIntelligence), rankedKeywords: results.rankedKeywords.concat(task.results.rankedKeywords), marketRankings: results.marketRankings.concat(task.results.marketRankings ?? []) }), emptySeoResults());
+}
+function compareMarketRankings(a, b) {
+  return compareText(a.regionLabel ?? "", b.regionLabel ?? "") || compareText(a.marketLabel, b.marketLabel) || compareText(a.searchText, b.searchText) || compareText(a.queryText, b.queryText);
 }
 function scopedPlanTargets(plan, scope) {
   const market = scope.kind === SeoScopeKinds.market ? plan.reportingScopes?.find((market2) => market2.stableKey === scope.key) : void 0;
@@ -15222,9 +15231,14 @@ function scopedPlanTargets(plan, scope) {
   return { targets: plan.targets.filter((target) => targetKeys.includes(target.stableKey)), market, targetKeys };
 }
 function scopeCapabilities(kind, targets) {
-  if (kind === SeoScopeKinds.project) return [SeoCapabilities["keyword-metrics"], SeoCapabilities["domain-intelligence"], SeoCapabilities["ranked-keywords"]];
+  if (kind === SeoScopeKinds.project) return [SeoCapabilities["keyword-metrics"], SeoCapabilities["domain-intelligence"], SeoCapabilities["ranked-keywords"], SeoCapabilities["market-rankings"]];
   const exactHosts = targets.length > 0 && targets.every((target) => target.urlMatchers.length > 0 && target.urlMatchers.every((matcher) => matcher.kind === "host"));
-  return exactHosts ? [SeoCapabilities["keyword-metrics"], SeoCapabilities["ranked-keywords"]] : [SeoCapabilities["keyword-metrics"]];
+  const markets = kind === SeoScopeKinds.group || kind === SeoScopeKinds.market ? [SeoCapabilities["market-rankings"]] : [];
+  return exactHosts ? [SeoCapabilities["keyword-metrics"], SeoCapabilities["ranked-keywords"], ...markets] : [SeoCapabilities["keyword-metrics"], ...markets];
+}
+function scopeReason(capabilities) {
+  const markets = capabilities.includes(SeoCapabilities["market-rankings"]);
+  return capabilities.includes(SeoCapabilities["ranked-keywords"]) ? `Supports explicit keyword metrics${markets ? ", market rankings" : ""} and exact-host ranked keywords. Whole-domain intelligence requires project scope.` : `Supports explicit keyword metrics${markets ? " and market rankings" : " only"}. Path and entity Properties cannot be replaced by whole-domain data.`;
 }
 function cancelSeoRefresh(db, projectId, id) {
   db.transaction((tx) => {
@@ -15252,7 +15266,7 @@ function resolveScope2(db, projectId, input) {
     if (supported.includes(SeoCapabilities["ranked-keywords"])) throw validationError("Domain intelligence requires project scope with a whole-domain Target. This Advanced scope supports exact-host ranked keywords and explicit keyword metrics.");
     throw validationError("This Advanced scope contains path or entity Properties and supports explicit keyword metrics only. Select a host-only scope for ranked keywords, or project scope for whole-domain intelligence.");
   }
-  if (input.scope.kind !== SeoScopeKinds.project && input.capabilities.some((capability) => capability !== SeoCapabilities["keyword-metrics"])) {
+  if (input.scope.kind !== SeoScopeKinds.project && input.capabilities.includes(SeoCapabilities["ranked-keywords"])) {
     const matchers = targets.flatMap((target) => target.urlMatchers).filter((matcher) => matcher.kind === "host");
     if (input.targets.some((target) => target.kind !== SeoTargetKinds.host || target.includeSubdomains || !matchers.some((matcher) => matchesMeasurementTargetUrl(`https://${target.value}/`, matcher)))) throw validationError("Ranked keywords in this Advanced scope require an exact host Target belonging to a selected Property. Other hosts and broader domains are not supported.");
   }
@@ -15271,12 +15285,128 @@ function normalizeProfile(input) {
   const keywords = [...new Set(input.keywords)];
   if (input.capabilities.includes(SeoCapabilities["keyword-metrics"]) && !keywords.length) throw validationError("Keyword metrics requires at least one explicit keyword.");
   if (input.capabilities.some((capability) => capability !== SeoCapabilities["keyword-metrics"]) && !targets.length) throw validationError("Domain capabilities require at least one explicit Target.");
+  if (input.capabilities.includes(SeoCapabilities["market-rankings"])) {
+    if (input.capabilities.length !== 1) throw validationError("Keep market rankings in their own profile: they run one search for each tracked query and market.");
+    if (!input.rankings) throw validationError("Market rankings need search settings: market locations, result depth, device and search text.");
+    if (targets.length !== 1) throw validationError("Market rankings need exactly one Target: the site whose position they report.");
+    if (keywords.length) throw validationError("Market rankings search the project's tracked queries. Leave keywords empty.");
+    const keys = input.rankings.locations.map((location) => location.key);
+    if (new Set(keys).size !== keys.length) throw validationError("Set each market location once.");
+  } else if (input.rankings) {
+    throw validationError("Search settings apply only to market rankings.");
+  }
   return { ...input, targets, keywords };
 }
-function taskRequests(profile) {
-  return profile.capabilities.flatMap((capability) => (capability === SeoCapabilities["keyword-metrics"] ? [null] : profile.targets).map((target) => ({ capability, target, keywords: capability === SeoCapabilities["keyword-metrics"] ? profile.keywords : [], locationCode: profile.locationCode, languageCode: profile.languageCode, limit: profile.limit, tag: "" })));
+var NO_MARKET_RANKINGS = { searches: [] };
+function advancedMarketQueries(plan, scope) {
+  const groups = new Map(plan.groups.map((group) => [group.stableKey, group]));
+  const lineage = (groupKey) => {
+    const keys = [];
+    for (let key = groupKey; key && !keys.includes(key); key = groups.get(key)?.parentGroupKey) keys.push(key);
+    return keys;
+  };
+  const nonBrandEdge = new Set(plan.assignments.filter((assignment) => assignment.queryClass === queryClassSchema.enum["non-brand"]).map((assignment) => `${assignment.targetKey}\0${assignment.queryId}`));
+  const queryText = new Map(plan.querySnapshots.map((snapshot) => [snapshot.queryId, snapshot.queryText]));
+  const queriesFor = (edges) => {
+    const nodes = /* @__PURE__ */ new Map();
+    for (const edge of edges) nodes.set(edge.queryId, (nodes.get(edge.queryId) ?? /* @__PURE__ */ new Set()).add(edge.executionNodeKey));
+    return [...nodes].flatMap(([id, keys]) => {
+      const text = queryText.get(id);
+      return text ? [{ id, text, executionNodeKeys: [...keys] }] : [];
+    });
+  };
+  const markets = plan.reportingScopes ?? [];
+  if (!markets.length) {
+    const { targetKeys } = scopedPlanTargets(plan, scope);
+    return [{ context: { marketKey: SEO_PROJECT_MARKET_KEY, marketLabel: "Project", regionKey: null, regionLabel: null }, locationKeys: [SEO_PROJECT_MARKET_KEY], queries: queriesFor(plan.assignments.filter((assignment) => targetKeys.includes(assignment.targetKey) && nonBrandEdge.has(`${assignment.targetKey}\0${assignment.queryId}`))) }];
+  }
+  return markets.flatMap((market) => {
+    const chain = lineage(market.groupKey);
+    const inScope = scope.kind === SeoScopeKinds.project || (scope.kind === SeoScopeKinds.market ? market.stableKey === scope.key : scope.kind === SeoScopeKinds.group && chain.includes(scope.key));
+    if (!inScope) return [];
+    const region = chain.at(-1);
+    return [{
+      context: { marketKey: market.stableKey, marketLabel: market.label, regionKey: region ?? null, regionLabel: region ? groups.get(region)?.label ?? region : null },
+      locationKeys: [market.stableKey, ...chain],
+      queries: queriesFor(market.usageEdges.filter((edge) => nonBrandEdge.has(`${edge.targetKey}\0${edge.queryId}`)))
+    }];
+  });
 }
-function planSeoTasks(opts, input) {
+function simpleMarketQueries(db, project) {
+  const rows = db.select({ id: queries.id, query: queries.query }).from(queries).where(eq32(queries.projectId, project.id)).all();
+  const classes = readQueryClasses(db, project, rows);
+  if (rows.length > 0 && rows.every((row) => classes.get(row.id) == null)) {
+    throw validationError("Canonry cannot tell this project's branded queries apart without a brand name. Add one before setting up market rankings.");
+  }
+  const nonBrand = rows.filter((row) => classes.get(row.id) === queryClassSchema.enum["non-brand"]).map((row) => ({ id: row.id, text: row.query, executionNodeKeys: [] }));
+  const locations = project.locations.length > 0 ? project.locations.map((location) => ({ key: location.label, label: location.label })) : [{ key: SEO_PROJECT_MARKET_KEY, label: "Project" }];
+  return locations.map((location) => ({ context: { marketKey: location.key, marketLabel: location.label, regionKey: null, regionLabel: null }, locationKeys: [location.key], queries: nonBrand }));
+}
+function marketRankingPlan(db, projectId, input) {
+  if (!input.capabilities.includes(SeoCapabilities["market-rankings"]) || !input.rankings) return NO_MARKET_RANKINGS;
+  const settings = input.rankings;
+  const project = db.select().from(projects).where(eq32(projects.id, projectId)).get();
+  if (!project) throw notFound("Project", projectId);
+  const own = new Set(effectiveDomains({ canonicalDomain: project.canonicalDomain, ownedDomains: project.ownedDomains }).map((domain) => registrableDomain(domain)).filter(Boolean));
+  const target = input.targets[0];
+  if (!target || !own.has(registrableDomain(target.value))) throw validationError("The market-rankings Target must be one of this project's own domains.");
+  const active = activeMeasurementPlan(db, projectId);
+  const advanced = active?.plan.schemaVersion === 2 ? { versionId: active.version.id, plan: active.plan } : null;
+  const markets = advanced ? advancedMarketQueries(advanced.plan, input.scope) : simpleMarketQueries(db, project);
+  const rival = (domain) => {
+    const registrable = registrableDomain(normalizeHostname(domain) ?? domain);
+    return registrable && !own.has(registrable) ? [registrable] : [];
+  };
+  const projectCompetitors = db.select({ domain: competitors.domain }).from(competitors).where(eq32(competitors.projectId, projectId)).all().flatMap((row) => rival(row.domain));
+  const pinnedFor = createPlanPinLookup(db);
+  const competitorsFor = (query) => [.../* @__PURE__ */ new Set([...projectCompetitors, ...query.executionNodeKeys.flatMap((key) => pinnedFor(advanced?.versionId, key)).flatMap(rival)])].sort(compareText);
+  const locations = new Map(settings.locations.map((location) => [location.key, location]));
+  const searches = /* @__PURE__ */ new Map();
+  const unmapped = [];
+  for (const market of markets) {
+    const mapped = market.locationKeys.map((key) => locations.get(key)).find((location2) => location2 !== void 0);
+    const location = mapped ?? (market.context.marketKey === SEO_PROJECT_MARKET_KEY ? { locationCode: input.locationCode, label: `Location ${input.locationCode}` } : void 0);
+    if (!location) {
+      unmapped.push(market.context.marketLabel);
+      continue;
+    }
+    for (const query of market.queries) {
+      const searchText = seoSearchTextForQuery(query.text, market.context.marketKey === SEO_PROJECT_MARKET_KEY ? null : market.context.marketLabel, settings.searchText);
+      if (!searchText) continue;
+      const answers = {
+        context: { ...market.context, queryId: query.id, queryText: query.text, queryClass: queryClassSchema.enum["non-brand"] },
+        competitors: competitorsFor(query)
+      };
+      const key = `${location.locationCode}\0${searchText.toLowerCase()}`;
+      const existing = searches.get(key);
+      if (existing) existing.markets.push(answers);
+      else searches.set(key, { searchText, locationCode: location.locationCode, locationLabel: location.label, markets: [answers] });
+    }
+  }
+  if (unmapped.length) throw validationError(`Set a search location for ${unmapped.length === 1 ? "1 market" : `${unmapped.length} markets`} or their groups: ${unmapped.slice(0, 5).join("; ")}${unmapped.length > 5 ? "; \u2026" : ""}.`);
+  if (!searches.size) throw validationError("There are no non-brand tracked queries to search in this scope.");
+  if (searches.size > SEO_MARKET_RANKING_MAX_SEARCHES) throw validationError(`One market-rankings refresh runs at most ${SEO_MARKET_RANKING_MAX_SEARCHES} searches; this scope needs ${searches.size}. Select a narrower scope.`);
+  return { searches: [...searches.values()].sort((a, b) => compareText(a.locationLabel, b.locationLabel) || compareText(a.searchText, b.searchText)) };
+}
+function taskRequests(profile, rankings) {
+  return profile.capabilities.flatMap((capability) => {
+    if (capability === SeoCapabilities["market-rankings"]) {
+      const settings = profile.rankings;
+      return rankings.searches.map((search) => ({
+        capability,
+        target: profile.targets[0],
+        keywords: [search.searchText],
+        locationCode: search.locationCode,
+        languageCode: profile.languageCode,
+        limit: profile.limit,
+        tag: "",
+        search: { device: settings.device, depth: settings.depth, locationLabel: search.locationLabel, markets: search.markets }
+      }));
+    }
+    return (capability === SeoCapabilities["keyword-metrics"] ? [null] : profile.targets).map((target) => ({ capability, target, keywords: capability === SeoCapabilities["keyword-metrics"] ? profile.keywords : [], locationCode: profile.locationCode, languageCode: profile.languageCode, limit: profile.limit, tag: "" }));
+  });
+}
+function planSeoTasks(opts, input, rankings = NO_MARKET_RANKINGS) {
   const runtime = opts.getSeoRuntime?.() ?? null;
   const connection = runtime?.connections.find((connection2) => connection2.id === input.connectionId);
   if (!runtime || !opts.onSeoRunRequested) throw missingDependency("SEO execution is not configured on this host.");
@@ -15284,7 +15414,7 @@ function planSeoTasks(opts, input) {
   if (input.capabilities.some((capability) => !connection.adapter.capabilities.includes(capability))) throw validationError("The selected SEO connection does not support every requested capability. Select capabilities listed for this connection in SEO context.");
   let planned;
   try {
-    planned = taskRequests(input).map((request) => {
+    planned = taskRequests(input, rankings).map((request) => {
       const estimate = connection.adapter.estimate(request);
       return { request, reservedMicros: estimate.maxCostMicros, catalogRevision: estimate.catalogRevision };
     });
@@ -15322,7 +15452,7 @@ function startScheduledSeoRefreshes(db, opts, input) {
     if (prior?.runId) return { profileId: profile.id, status: "replayed", runId: prior.runId };
     try {
       const scopeSnapshot = resolveScope2(db, input.projectId, profile);
-      const runtime = planSeoTasks(opts, profile);
+      const runtime = planSeoTasks(opts, profile, marketRankingPlan(db, input.projectId, profile));
       const now = (/* @__PURE__ */ new Date()).toISOString();
       const account = runtime.connection.adapter.accountKey;
       const requestedId = crypto17.randomUUID();
@@ -15394,7 +15524,7 @@ async function seoRoutes(app, opts) {
     const available = !!runtime?.connections.length && !!opts.onSeoRunRequested;
     return { available, reason: available ? null : "SEO execution is not configured on this host.", capabilities: [...new Set(runtime?.connections.flatMap((connection) => [...connection.adapter.capabilities]) ?? [])], profileCount: profiles(projectId).length, latestRunId: latest?.id ?? null, latestRunStatus: latest?.status ?? null, lastCompletedAt: last?.finishedAt ?? null };
   };
-  const planTasks = (input) => planSeoTasks(opts, input);
+  const planTasks = (projectId, input) => planSeoTasks(opts, input, marketRankingPlan(app.db, projectId, input));
   app.get("/seo/operator/tasks/:id", async (request) => {
     requireOperator(request);
     const task = app.db.select().from(seoTasks).where(eq32(seoTasks.id, request.params.id)).get();
@@ -15422,7 +15552,7 @@ async function seoRoutes(app, opts) {
     const plan = active?.plan.schemaVersion === 2 ? active.plan : null;
     const scopes = plan ? planScopeOptions(plan, { marketLinks: true }).map((option) => {
       const capabilities = scopeCapabilities(option.kind, scopedPlanTargets(plan, { kind: option.kind, ...option.kind === SeoScopeKinds.project ? {} : { key: option.id } }).targets).filter((capability) => current.capabilities.includes(capability));
-      return { kind: option.kind, key: option.kind === SeoScopeKinds.project ? null : option.id, label: option.label, planRevision: active.version.revision, capabilities, supported: capabilities.length > 0, reason: !capabilities.length ? current.reason ?? "No configured connection supports this scope." : option.kind === SeoScopeKinds.project ? null : capabilities.includes(SeoCapabilities["ranked-keywords"]) ? "Supports explicit keyword metrics and exact-host ranked keywords. Whole-domain intelligence requires project scope." : "Supports explicit keyword metrics only. Path and entity Properties cannot be replaced by whole-domain data." };
+      return { kind: option.kind, key: option.kind === SeoScopeKinds.project ? null : option.id, label: option.label, planRevision: active.version.revision, capabilities, supported: capabilities.length > 0, reason: !capabilities.length ? current.reason ?? "No configured connection supports this scope." : option.kind === SeoScopeKinds.project ? null : scopeReason(capabilities) };
     }) : [{ kind: SeoScopeKinds.project, key: null, label: "Project", capabilities: active ? [] : current.capabilities, supported: !active && current.capabilities.length > 0, reason: active ? "Publish a current Advanced Measurement plan first." : current.reason }];
     return { available: current.available, reason: current.reason, connections: getRuntime()?.connections.map((connection) => ({ id: connection.id, label: connection.label, provider: connection.adapter.provider, capabilities: [...connection.adapter.capabilities] })) ?? [], scopes, access: { canRun: can(request, SEO_RUN_SCOPE), canWrite: can(request, SEO_WRITE_SCOPE) } };
   });
@@ -15438,7 +15568,7 @@ async function seoRoutes(app, opts) {
     if (!parsed.success) throw validationError("Invalid SEO profile.", { issues: parsed.error.issues });
     const input = normalizeProfile(parsed.data);
     resolveScope2(app.db, project.id, input);
-    planTasks(input);
+    planTasks(project.id, input);
     const now = (/* @__PURE__ */ new Date()).toISOString();
     app.db.transaction((tx) => {
       const current = tx.select().from(seoProfiles).where(and24(eq32(seoProfiles.projectId, project.id), eq32(seoProfiles.id, request.params.id))).get();
@@ -15454,7 +15584,7 @@ async function seoRoutes(app, opts) {
     if (!parsed.success) throw validationError("Select an SEO profile.");
     const saved = profile(project.id, parsed.data.profileId);
     const scope = resolveScope2(app.db, project.id, saved);
-    const planned = planTasks(saved);
+    const planned = planTasks(project.id, saved);
     const expiresAt = new Date(Date.now() + 5 * 6e4).toISOString();
     const payload = Buffer.from(JSON.stringify({ projectId: project.id, actor: actor(request), profileId: saved.id, revision: saved.revision, scopeHash: hash2(JSON.stringify(scope)), intentHash: planned.intentHash, nonce: crypto17.randomUUID(), expiresAt })).toString("base64url");
     const signature = crypto17.createHmac("sha256", intentSecret).update(payload).digest("base64url");
@@ -15491,7 +15621,7 @@ async function seoRoutes(app, opts) {
     const saved = profile(project.id, claims.profileId);
     const scopeSnapshot = resolveScope2(app.db, project.id, saved);
     if (saved.revision !== claims.revision || hash2(JSON.stringify(scopeSnapshot)) !== claims.scopeHash) throw validationError("This SEO profile or measurement scope changed. Create a new refresh intent.");
-    const runtime = planTasks(saved);
+    const runtime = planTasks(project.id, saved);
     if (runtime.intentHash !== claims.intentHash) throw validationError("The SEO connection or host policy changed. Create a new refresh intent.");
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const account = runtime.connection.adapter.accountKey;
@@ -15515,7 +15645,7 @@ async function seoRoutes(app, opts) {
     const row = job(resolveProject(app.db, request.params.name).id, request.params.id);
     const rows = tasks(row.id);
     const results = resultRows(rows);
-    return { ...runDto(row, rows.map((task) => ({ status: task.status, count: 1 }))), tasks: rows.map((task) => ({ id: task.id, capability: task.request.capability, target: task.request.target, status: task.status, error: task.error, remoteTaskId: task.receipts[0]?.remoteTaskId ?? null })), results: { keywordMetrics: results.keywordMetrics.slice(0, 20), domainIntelligence: results.domainIntelligence.slice(0, 20), rankedKeywords: results.rankedKeywords.slice(0, 20) }, resultCounts: { keywordMetrics: results.keywordMetrics.length, domainIntelligence: results.domainIntelligence.length, rankedKeywords: results.rankedKeywords.length }, resultsTruncated: Object.values(results).some((items) => items.length > 20) };
+    return { ...runDto(row, rows.map((task) => ({ status: task.status, count: 1 }))), tasks: rows.map((task) => ({ id: task.id, capability: task.request.capability, target: task.request.target, status: task.status, error: task.error, remoteTaskId: task.receipts[0]?.remoteTaskId ?? null })), results: { keywordMetrics: results.keywordMetrics.slice(0, 20), domainIntelligence: results.domainIntelligence.slice(0, 20), rankedKeywords: results.rankedKeywords.slice(0, 20), marketRankings: [...results.marketRankings].sort(compareMarketRankings).slice(0, 20) }, resultCounts: { keywordMetrics: results.keywordMetrics.length, domainIntelligence: results.domainIntelligence.length, rankedKeywords: results.rankedKeywords.length, marketRankings: results.marketRankings.length }, resultsTruncated: Object.values(results).some((items) => items.length > 20) };
   });
   app.post("/projects/:name/seo/runs/:id/cancel", { config: { paidRead: true, writeScope: SEO_RUN_SCOPE } }, async (request) => {
     requireScope(request, SEO_RUN_SCOPE);
@@ -15534,7 +15664,7 @@ async function seoRoutes(app, opts) {
     const results = resultRows(rows);
     const primary = row?.profile.targets[0];
     const domain = primary ? results.domainIntelligence.find((result) => result.target.kind === primary.kind && result.target.value === primary.value && result.target.includeSubdomains === primary.includeSubdomains) : null;
-    return { status: status(project.id), profiles: profiles(project.id), latestRun: latest ? runSummary(latest) : null, evidenceRunId: row?.id ?? null, evidenceRun: row ? runDto(row, rows.map((task) => ({ status: task.status, count: 1 }))) : null, keywordMetricsCount: results.keywordMetrics.length, domainIntelligenceCount: results.domainIntelligence.length, rankedKeywordCount: results.rankedKeywords.length, summary: domain ? { target: domain.target, organicKeywords: domain.organicKeywords, inTop10: domain.top1 !== null && domain.top2To3 !== null && domain.top4To10 !== null ? domain.top1 + domain.top2To3 + domain.top4To10 : null, estimatedOrganicTraffic: domain.estimatedOrganicTraffic, provenance: domain.provenance } : null };
+    return { status: status(project.id), profiles: profiles(project.id), latestRun: latest ? runSummary(latest) : null, evidenceRunId: row?.id ?? null, evidenceRun: row ? runDto(row, rows.map((task) => ({ status: task.status, count: 1 }))) : null, keywordMetricsCount: results.keywordMetrics.length, domainIntelligenceCount: results.domainIntelligence.length, rankedKeywordCount: results.rankedKeywords.length, marketRankingCount: results.marketRankings.length, summary: domain ? { target: domain.target, organicKeywords: domain.organicKeywords, inTop10: domain.top1 !== null && domain.top2To3 !== null && domain.top4To10 !== null ? domain.top1 + domain.top2To3 + domain.top4To10 : null, estimatedOrganicTraffic: domain.estimatedOrganicTraffic, provenance: domain.provenance } : null };
   });
   for (const [path8, key] of [["keyword-metrics", "keywordMetrics"], ["domain-intelligence", "domainIntelligence"], ["ranked-keywords", "rankedKeywords"]]) app.get(`/projects/:name/seo/${path8}`, async (request) => {
     const query = queryInput(request.query);
@@ -15544,6 +15674,17 @@ async function seoRoutes(app, opts) {
     const offset = query.offset ?? 0;
     return { runId: row?.id ?? null, items: items.slice(offset, offset + limit), total: items.length, limit, offset };
   });
+  app.get("/projects/:name/seo/market-rankings", async (request) => {
+    const raw = request.query ?? {};
+    const parsed = seoMarketRankingQuerySchema.safeParse({ ...raw, ...raw.limit === void 0 ? {} : { limit: Number(raw.limit) }, ...raw.offset === void 0 ? {} : { offset: Number(raw.offset) } });
+    if (!parsed.success) throw validationError("Invalid SEO evidence selection.");
+    const query = parsed.data;
+    const row = selected(resolveProject(app.db, request.params.name).id, query, true);
+    const items = (row ? resultRows(tasks(row.id)).marketRankings : []).filter((item2) => (query.marketKey === void 0 || item2.marketKey === query.marketKey) && (query.regionKey === void 0 || item2.regionKey === query.regionKey)).sort(compareMarketRankings);
+    const limit = query.limit ?? 50;
+    const offset = query.offset ?? 0;
+    return { runId: row?.id ?? null, items: items.slice(offset, offset + limit), total: items.length, limit, offset };
+  });
 }
 
 // ../api-routes/src/runs.ts
@@ -33750,6 +33891,7 @@ var SCHEMA_TABLE = {
   SeoKeywordMetricsList: seoKeywordMetricsListSchema,
   SeoDomainIntelligenceList: seoDomainIntelligenceListSchema,
   SeoRankedKeywordList: seoRankedKeywordListSchema,
+  SeoMarketRankingList: seoMarketRankingListSchema,
   SentimentSummary: sentimentSummarySchema,
   SentimentSettings: sentimentSettingsSchema,
   SentimentSettingsUpdate: sentimentSettingsUpdateSchema,
@@ -34977,6 +35119,26 @@ var routeCatalog = [
       409: errorResponse("Selection, intent or execution identity changed.")
     }
   },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/seo/market-rankings",
+    summary: "Read stored market rankings",
+    tags: ["seo"],
+    description: "Stored evidence only; never calls a provider. The project's position for each tracked non-brand query, searched on Google from its market's location, ordered by region, market and search text. A null rank means the site was not in the checked results.",
+    parameters: [
+      nameParameter,
+      ...seoEvidenceParameters,
+      { name: "marketKey", in: "query", description: "Only rows for this market (an Advanced market key or a Simple location label).", schema: stringSchema },
+      { name: "regionKey", in: "query", description: "Only rows whose market sits under this top-level group.", schema: stringSchema }
+    ],
+    responses: {
+      200: jsonResponse("SEO response.", "SeoMarketRankingList"),
+      400: errorResponse("Invalid scope or input."),
+      403: errorResponse("Insufficient authority."),
+      404: errorResponse("Project or selected evidence not found."),
+      409: errorResponse("Selection, intent or execution identity changed.")
+    }
+  },
   {
     method: "put",
     path: "/api/v1/projects/{name}/seo/profiles/{id}",

package/dist/{chunk-66DPEVLJ.js → chunk-K2HDTMRI.js}

@@ -1,13 +1,13 @@
 import {
   createApiClient
-} from "./chunk-F7NZEUXP.js";
+} from "./chunk-EIMXB6UH.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
 import {
   measurementDraftOperationSchema,
   runMeasurementDraftAction
-} from "./chunk-ZPRJCSSR.js";
+} from "./chunk-CKTA5374.js";
 import {
   isMachineFormat,
   systemError
@@ -37,7 +37,7 @@ import {
   unattributedAnswersLabel,
   uncheckedSourcesLabel,
   visibilityReportRequestSchema
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 
 // src/commands/measurement-plan.ts
 import crypto from "crypto";

package/dist/{chunk-O3INLME6.js → chunk-L7DQYID4.js}

@@ -1,10 +1,10 @@
 import {
   registeredProviderNames
-} from "./chunk-IYB3EGSD.js";
+} from "./chunk-YJYLFIVT.js";
 import {
   configExists,
   loadConfigRaw
-} from "./chunk-C2PYKUD3.js";
+} from "./chunk-EYWC24VC.js";
 
 // src/setup-state.ts
 import fs from "fs";
@@ -28,7 +28,7 @@ async function buildSetupState() {
   }
   if (dbPath && fs.existsSync(dbPath)) {
     try {
-      const { createClient, projects, queries: queriesTable } = await import("./src-WIOU5G4V.js");
+      const { createClient, projects, queries: queriesTable } = await import("./src-NOTQWGYV.js");
       const db = createClient(dbPath);
       project_count = db.select({ id: projects.id }).from(projects).all().length;
       const firstQuery = db.select({ id: queriesTable.id }).from(queriesTable).limit(1).all();
@@ -47,7 +47,7 @@ function queueServeHandoff() {
 async function runPendingServeHandoff(format) {
   if (!pendingServeHandoff) return;
   pendingServeHandoff = false;
-  const { serveCommand } = await import("./serve-R2CI3RWQ.js");
+  const { serveCommand } = await import("./serve-2LTQZPEK.js");
   await serveCommand(format);
 }
 

package/dist/{chunk-HO5W6QC7.js → chunk-LBRG6RKI.js}

@@ -5,7 +5,7 @@ import {
   AppError,
   parseWindowIn,
   resolveDateRange
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 
 // src/cli-access.ts
 var CLI_ACCESS_BY_ID = Object.freeze({
@@ -331,6 +331,7 @@ var CLI_ACCESS_BY_ID = Object.freeze({
   "seo.context": "stored",
   "seo.domain-intelligence": "stored",
   "seo.keyword-metrics": "stored",
+  "seo.market-rankings": "stored",
   "seo.operator.reconcile": "write",
   "seo.operator.task": "stored",
   "seo.overview": "stored",

package/dist/{chunk-HPUZMBS6.js → chunk-OSF27DCY.js}

@@ -1,6 +1,6 @@
 import {
   parseJsonColumn
-} from "./chunk-XOMUSIM7.js";
+} from "./chunk-JALKQREN.js";
 import {
   AI_ENGINE_DOMAINS,
   AI_ENGINE_SELF_DOMAINS,
@@ -26,7 +26,7 @@ import {
   retryAfterDelayMs,
   usageCount,
   withRetry
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 
 // ../provider-openai/src/normalize.ts
 import OpenAI from "openai";

package/dist/{chunk-737TOG2F.js → chunk-PFKBQTYD.js}

@@ -28,7 +28,7 @@ import {
   unknownUsageObservation,
   usdToMicros,
   withRetry
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 
 // ../provider-answer-services/src/core/http.ts
 var MAX_RESPONSE_BYTES = 8 * 1024 * 1024;

package/dist/{chunk-S4VCXCRQ.js → chunk-QRBZBJ4U.js}

@@ -1,6 +1,6 @@
 import {
   hostMatchesDomain
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 
 // src/citation-utils.ts
 function pickProjectCitedDomain(citedDomains, projectDomains) {

package/dist/{chunk-X4AHYJCE.js → chunk-SGZWOUIZ.js}

@@ -1,6 +1,6 @@
 import {
   pickProjectCitedDomain
-} from "./chunk-S4VCXCRQ.js";
+} from "./chunk-QRBZBJ4U.js";
 import {
   GBP_INSIGHT_PROVIDER,
   PERSISTENT_GAP_THRESHOLD,
@@ -14,10 +14,10 @@ import {
   mergeGscQueryTotalsWithFallback,
   readGscQueryDailyRows,
   readLatestGscDataDate
-} from "./chunk-Z2EENWM3.js";
+} from "./chunk-JYOMHNRP.js";
 import {
   getRequestContext
-} from "./chunk-IJKKK7F4.js";
+} from "./chunk-YRX5UOM3.js";
 import {
   competitors,
   gbpDailyMetrics,
@@ -35,7 +35,7 @@ import {
   queries,
   querySnapshots,
   runs
-} from "./chunk-XOMUSIM7.js";
+} from "./chunk-JALKQREN.js";
 import {
   CitationStates,
   RunKinds,
@@ -45,7 +45,7 @@ import {
   effectiveDomains,
   redactLogString,
   redactLogValue
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 
 // src/intelligence-service.ts
 import { eq, desc, asc, and, ne, or, inArray, gte, lte, isNull, sql, exists } from "drizzle-orm";

package/dist/{chunk-AE6HJZBU.js → chunk-TJZLICMB.js}

@@ -3,7 +3,7 @@ import {
   resolveCliAccess,
   resolveCliAccessForInvocation,
   windowOptions
-} from "./chunk-HO5W6QC7.js";
+} from "./chunk-LBRG6RKI.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
@@ -14,7 +14,7 @@ import {
 } from "./chunk-HGMYEDAQ.js";
 import {
   OperationAccesses
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 
 // src/cli-catalog.ts
 import { createRequire } from "module";
@@ -111,7 +111,7 @@ async function dispatchRegisteredCommand(args, fallbackFormat, specs) {
     const accessValue = accessFilterFromArgs(argsWithoutHelp);
     validateAccessFilter(accessValue);
     if (fallbackFormat !== "text") {
-      const { printCliCatalog: printCliCatalog2 } = await import("./cli-catalog-6XYQY3PI.js");
+      const { printCliCatalog: printCliCatalog2 } = await import("./cli-catalog-IZJXAHFQ.js");
       const group2 = argsWithoutHelp.find((arg) => !arg.startsWith("--"));
       printCliCatalog2(specs, fallbackFormat, group2, accessValue);
       return true;