@canonry/canonry 7.67.0 → 7.68.0

package/dist/{chunk-MD5PHJBX.js → chunk-33LH4ZGF.js}

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

package/dist/{chunk-VR4MYSEH.js → chunk-4KMUJOYL.js}

@@ -6,12 +6,12 @@ import {
 import {
   createApiClient,
   runWithUsageTags
-} from "./chunk-XEPEMON2.js";
+} from "./chunk-FDRZQH3Y.js";
 import {
   canonryMcpTools,
   mcpOutputSchema,
   toolOperationAccess
-} from "./chunk-37R6GTU7.js";
+} from "./chunk-YIIIYNPW.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
@@ -24,7 +24,7 @@ import {
   isReadOnlyKey,
   restrictedWriteScopes,
   upgradeCaveatFor
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/mcp/server.ts
 import { randomUUID } from "crypto";
@@ -258,7 +258,7 @@ var OPERATIONS_GUIDE = {
         "canonry_seo_sync",
         "canonry_seo_run_cancel"
       ],
-      "guidance": "Read saved SEO evidence first. Preserve profile, exact domain or host, market, language, plan revision, dataset and collection date. Market rankings (canonry_seo_market_rankings) are the site's Google position for its tracked queries by market, the same queries AI visibility measures. SEO traffic and keyword metrics are third-party estimates, separate from Search Console observations and AI citation and mention coverage. Refresh requires explicit approval for the profile and work, a fresh refresh intent and an idempotency key. Hosted financial controls are internal; no credential or billing information belongs in the response."
+      "guidance": "Read saved SEO evidence first. Preserve profile, exact domain or host, market, language, plan revision, dataset and collection date. Market rankings (canonry_seo_market_rankings) are the site's Google position for its tracked queries by market, the same queries AI visibility measures; start with canonry_seo_market_summary for counts by outcome, and treat failed or unsearched queries as missing data. SEO traffic and keyword metrics are third-party estimates, separate from Search Console observations and AI citation and mention coverage. Refresh requires explicit approval for the profile and work, a fresh refresh intent and an idempotency key. Hosted financial controls are internal; no credential or billing information belongs in the response."
     },
     "operations": {
       "keywords": [

package/dist/{chunk-WSYLDPYF.js → chunk-5SK27UE7.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-HGMYEDAQ.js";
 import {
   describeError
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/gsc-sitemap-submission.ts
 function dedupeGscSitemapUrls(urls) {

package/dist/{chunk-AVISYPUU.js → chunk-6W3ENB2X.js}

@@ -9,14 +9,14 @@ import {
   normalizeCloudflareWorkerEvent,
   sessionizeJourneyRequests,
   verifyRequestSignature
-} from "./chunk-HX3WLTZU.js";
+} from "./chunk-J4CNNYRQ.js";
 import {
   currentOutcomeAttribution,
   getRequestContext,
   registerRequestContext,
   requestAuditIdentity,
   sanitizeRequestContext
-} from "./chunk-UXTNDZKM.js";
+} from "./chunk-7SGZHGZ2.js";
 import {
   SentimentIdempotencyConflict,
   SentimentRepository,
@@ -156,7 +156,7 @@ import {
   userSessions,
   users,
   writeNegativeReviewMaxStars
-} from "./chunk-6DJN7HCK.js";
+} from "./chunk-ARIYTYOM.js";
 import {
   ADS_ACTIVATE_SCOPE,
   ADS_ACTIVATION_ABSOLUTE_MAX_ENTITIES,
@@ -369,6 +369,7 @@ import {
   SeoAvailability,
   SeoCapabilities,
   SeoMarketRankingSearchStatuses,
+  SeoMarketRankingSorts,
   SeoRunStatuses,
   SeoScopeKinds,
   SeoTargetKinds,
@@ -527,6 +528,7 @@ import {
   clusterByCosine,
   coerceSkillManifest,
   compactDateToIso,
+  compareMarketRankingsBy,
   compareSemver,
   compareText,
   competitorAliasBlockRequestSchema,
@@ -570,6 +572,7 @@ import {
   conversionTrackingOptionsDtoSchema,
   cosineSimilarity,
   countAdsActivationManifestEntities,
+  countMarketRankings,
   countedLeadEventNames,
   countsAsMention,
   countsKeyEvents,
@@ -699,6 +702,7 @@ import {
   googleOAuthStartResponseSchema,
   gradedReportMonths,
   groupIsoDateRanges,
+  groupMarketRankings,
   gscCoverageSnapshotDtoSchema,
   gscCoverageSummaryDtoSchema,
   gscDeindexedRowSchema,
@@ -773,9 +777,12 @@ import {
   makesInstallMeasurable,
   mapWithConcurrency,
   marketPinAliasClaims,
+  marketRankingRow,
   matchOperationTemplate,
   matchedAliasKeys,
   matcherMatchesText,
+  matchesMarketRankingFilter,
+  matchesMarketRankingText,
   matchesMeasurementTargetUrl,
   measurementChangesQuerySchema,
   measurementChangesResponseSchema,
@@ -1048,8 +1055,12 @@ import {
   seoDomainIntelligenceListSchema,
   seoEvidenceQuerySchema,
   seoKeywordMetricsListSchema,
+  seoMarketRankingFilterSchema,
   seoMarketRankingListSchema,
   seoMarketRankingQuerySchema,
+  seoMarketRankingSortSchema,
+  seoMarketRankingSummaryQuerySchema,
+  seoMarketRankingSummarySchema,
   seoOperatorTaskSchema,
   seoOverviewSchema,
   seoProfileInputSchema,
@@ -1176,7 +1187,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // ../api-routes/src/user-session.ts
 import crypto2 from "crypto";
@@ -15724,11 +15735,29 @@ async function seoRoutes(app, opts) {
     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 items = (row ? resultRows(tasks(row.id)).marketRankings.map(marketRankingRow) : []).filter((item2) => (query.marketKey === void 0 || item2.marketKey === query.marketKey) && (query.regionKey === void 0 || item2.regionKey === query.regionKey) && (query.outcome === void 0 || matchesMarketRankingFilter(item2, query.outcome)) && (query.q === void 0 || matchesMarketRankingText(item2, query.q))).sort(compareMarketRankingsBy(query.sort ?? SeoMarketRankingSorts.market));
     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 };
   });
+  app.get("/projects/:name/seo/market-rankings/summary", async (request) => {
+    const parsed = seoMarketRankingSummaryQuerySchema.safeParse(request.query ?? {});
+    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 rows = (row ? resultRows(tasks(row.id)).marketRankings.map(marketRankingRow) : []).filter((item2) => (query.marketKey === void 0 || item2.marketKey === query.marketKey) && (query.regionKey === void 0 || item2.regionKey === query.regionKey));
+    return {
+      // The depth each search asked for; a partial search's rows say how far they reached.
+      runId: row?.id ?? null,
+      depth: row?.profile.rankings?.depth ?? null,
+      regionKey: query.regionKey ?? null,
+      marketKey: query.marketKey ?? null,
+      regionLabel: query.regionKey === void 0 ? null : rows[0]?.regionLabel ?? null,
+      marketLabel: query.marketKey === void 0 ? null : rows[0]?.marketLabel ?? null,
+      totals: countMarketRankings(rows),
+      groups: groupMarketRankings(rows, { regionKey: query.regionKey, marketKey: query.marketKey })
+    };
+  });
 }
 
 // ../api-routes/src/runs.ts
@@ -33937,6 +33966,7 @@ var SCHEMA_TABLE = {
   SeoDomainIntelligenceList: seoDomainIntelligenceListSchema,
   SeoRankedKeywordList: seoRankedKeywordListSchema,
   SeoMarketRankingList: seoMarketRankingListSchema,
+  SeoMarketRankingSummary: seoMarketRankingSummarySchema,
   SentimentSummary: sentimentSummarySchema,
   SentimentSettings: sentimentSettingsSchema,
   SentimentSettingsUpdate: sentimentSettingsUpdateSchema,
@@ -35169,12 +35199,15 @@ var routeCatalog = [
     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. searchStatus says how each search ended: in a completed or partial row a null rank means the site was not in the checked results (depth, which is lower when only part of the results came back); a failed or cancelled search keeps its rows with no rank.",
+    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. searchStatus says how each search ended: in a completed or partial row a null rank means the site was not in the checked results (depth, which is lower when only part of the results came back); a failed or cancelled search keeps its rows with no rank. outcome says where each row landed (a partial search without the site is partly-checked, never not-ranked) and rivalAhead whether a tracked competitor ranks above the site.",
     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 }
+      { name: "regionKey", in: "query", description: "Only rows whose market sits under this top-level group.", schema: stringSchema },
+      { name: "outcome", in: "query", description: "Only rows with this outcome. `partly-checked` is a partial search that did not reach the site, so ranks past its depth are unknown; `needs-work` is ranks 11 and deeper, not ranked or partly checked; `rival-ahead` is rows where a tracked competitor ranks above the site.", schema: { type: "string", enum: [...seoMarketRankingFilterSchema.options] } },
+      { name: "q", in: "query", description: "Only rows whose query, searched text or market label contains this text, ignoring case.", schema: { type: "string", minLength: 1, maxLength: 200 } },
+      { name: "sort", in: "query", description: "`market` (default): region, market, search text. `rank`: best rank first, then partly checked rows, then rows not in the results with the strongest rival first, then searches with no result. `-rank`: rows not in the results first, then partly checked rows, then the worst rank. `query` / `-query`: by query text.", schema: { type: "string", enum: [...seoMarketRankingSortSchema.options], default: "market" } }
     ],
     responses: {
       200: jsonResponse("SEO response.", "SeoMarketRankingList"),
@@ -35184,6 +35217,27 @@ var routeCatalog = [
       409: errorResponse("Selection, intent or execution identity changed.")
     }
   },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/seo/market-rankings/summary",
+    summary: "Summarize stored market rankings by outcome",
+    tags: ["seo"],
+    description: "Stored evidence only; never calls a provider. Outcome counts for the selected scope (the whole profile, one region or one market) and for the groups under it: regions for the whole profile, markets within one region, none within one market. Groups come in needs-work order: most ranks 11-20, then most ranks 21 and deeper.",
+    parameters: [
+      nameParameter,
+      { name: "profileId", in: "query", description: "Exact saved profile. Required when multiple profiles exist.", schema: stringSchema },
+      { name: "runId", in: "query", description: "Exact historical refresh. Omit for latest saved evidence for the selected profile.", schema: stringSchema },
+      { name: "marketKey", in: "query", description: "Summarize one market (an Advanced market key or a Simple location label).", schema: stringSchema },
+      { name: "regionKey", in: "query", description: "Summarize one top-level group and the markets under it.", schema: stringSchema }
+    ],
+    responses: {
+      200: jsonResponse("SEO response.", "SeoMarketRankingSummary"),
+      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-ZGUR4AZM.js → chunk-7AXVACK6.js}

@@ -5,7 +5,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-UNCOK6DA.js";
+} from "./chunk-MVRPFLEL.js";
 import {
   CANONRY_NPM_PACKAGE_URL,
   compareSemver,
@@ -18,7 +18,7 @@ import {
   updateCheckEnvOptOut,
   upgradeCaveatFor,
   upgradeCommandFor
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/runtime-context.ts
 function cliRuntimeContext(env = process.env, stdio = process) {

package/dist/{chunk-WZ4LUM26.js → chunk-7NMCRHQL.js}

@@ -3,7 +3,7 @@ import {
   resolveCliAccess,
   resolveCliAccessForInvocation,
   windowOptions
-} from "./chunk-MD5PHJBX.js";
+} from "./chunk-33LH4ZGF.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
@@ -14,7 +14,7 @@ import {
 } from "./chunk-HGMYEDAQ.js";
 import {
   OperationAccesses
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.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-J2HUCGJL.js");
+      const { printCliCatalog: printCliCatalog2 } = await import("./cli-catalog-ONYERYPV.js");
       const group2 = argsWithoutHelp.find((arg) => !arg.startsWith("--"));
       printCliCatalog2(specs, fallbackFormat, group2, accessValue);
       return true;

package/dist/{chunk-UXTNDZKM.js → chunk-7SGZHGZ2.js}

@@ -1,7 +1,7 @@
 import {
   USAGE_TELEMETRY_HEADERS,
   redactLogString
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // ../api-routes/src/request-context.ts
 import { AsyncLocalStorage } from "async_hooks";

package/dist/{chunk-6DJN7HCK.js → chunk-ARIYTYOM.js}

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

package/dist/{chunk-XMIKSCAO.js → chunk-ARYBII44.js}

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

package/dist/{chunk-CBYKQRDH.js → chunk-CZUPNWLH.js}

@@ -1,6 +1,6 @@
 import {
   createApiClient
-} from "./chunk-XEPEMON2.js";
+} from "./chunk-FDRZQH3Y.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
@@ -19,7 +19,7 @@ import {
   formatMicros,
   formatRunErrorOneLine,
   resolveProviderInput
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/commands/run.ts
 function getClient() {

package/dist/{chunk-XEPEMON2.js → chunk-FDRZQH3Y.js}

@@ -1,6 +1,6 @@
 import {
   loadConfig
-} from "./chunk-UNCOK6DA.js";
+} from "./chunk-MVRPFLEL.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
@@ -36,7 +36,7 @@ import {
   sentimentSettingsReadSchema,
   sentimentSummaryReadSchema,
   upgradeCommandFor
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // ../api-client-generated/src/generated/core/bodySerializer.gen.ts
 var jsonBodySerializer = {
@@ -905,6 +905,11 @@ var getApiV1ProjectsByNameSeoMarketRankings = (options) => (options.client ?? cl
   url: "/api/v1/projects/{name}/seo/market-rankings",
   ...options
 });
+var getApiV1ProjectsByNameSeoMarketRankingsSummary = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/api/v1/projects/{name}/seo/market-rankings/summary",
+  ...options
+});
 var postApiV1ProjectsByNameSeoRefreshIntents = (options) => (options.client ?? client).post({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/api/v1/projects/{name}/seo/refresh-intents",
@@ -6200,6 +6205,13 @@ var ApiClient = class {
       query
     }));
   }
+  async getSeoMarketRankingSummary(project, query) {
+    return this.invoke(() => getApiV1ProjectsByNameSeoMarketRankingsSummary({
+      client: this.heyClient,
+      path: { name: project },
+      query
+    }));
+  }
   async getResearchRun(project, runId) {
     return this.invoke(
       () => getApiV1ProjectsByNameResearchRunsByRunId({

package/dist/{chunk-5DMESZDF.js → chunk-IVBJEVHS.js}

@@ -1,6 +1,6 @@
 import {
   parseJsonColumn
-} from "./chunk-6DJN7HCK.js";
+} from "./chunk-ARIYTYOM.js";
 import {
   AI_ENGINE_DOMAINS,
   AI_ENGINE_SELF_DOMAINS,
@@ -26,7 +26,7 @@ import {
   retryAfterDelayMs,
   usageCount,
   withRetry
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // ../provider-openai/src/normalize.ts
 import OpenAI from "openai";

package/dist/{chunk-HX3WLTZU.js → chunk-J4CNNYRQ.js}

@@ -8,7 +8,7 @@ import {
   classifyJourneyEntry,
   hostMatchesDomain,
   hostOf
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // ../integration-traffic/src/ip-ranges/amazonbot.json
 var amazonbot_default = {

package/dist/{chunk-Y54PMWBH.js → chunk-JPVG5LIE.js}

@@ -2,18 +2,18 @@ import {
   configExists,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-UNCOK6DA.js";
+} from "./chunk-MVRPFLEL.js";
 import {
   BUNDLED_SKILL_NAMES,
   installSkills
-} from "./chunk-MLOGEXIO.js";
+} from "./chunk-2D7O5UHJ.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
 import {
   SKILL_MANIFEST_FILENAME,
   SkillsClients
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/skills-autosync.ts
 import fs from "fs";

package/dist/{chunk-EKSXR7RJ.js → chunk-K2P2XO6P.js}

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