@canonry/canonry 7.91.2 → 7.92.0

package/dist/{chunk-JKBQ3G25.js → chunk-P6ZDIVFZ.js}

@@ -5,7 +5,7 @@ import {
   AppError,
   parseWindowIn,
   resolveDateRange
-} from "./chunk-2REKLGYS.js";
+} from "./chunk-FYYOX7UY.js";
 
 // src/cli-access.ts
 var CLI_ACCESS_BY_ID = Object.freeze({

package/dist/{chunk-FX5H2PD5.js → chunk-QER7MSUH.js}

@@ -8,23 +8,23 @@ import {
   reparseStoredResult4,
   reparseStoredResult5,
   resolveStoredApiResponse
-} from "./chunk-PIOCF5GN.js";
+} from "./chunk-BZGAMJG2.js";
 import {
   loadConfig
-} from "./chunk-V4MRQPV2.js";
+} from "./chunk-4QYGB5IC.js";
 import {
   isMachineFormat
 } from "./chunk-HGMYEDAQ.js";
 import {
   determineCitationState
-} from "./chunk-SMH4FUXJ.js";
+} from "./chunk-AUC47DFW.js";
 import {
   backfillProjectAnswerMentions,
   competitorIdentityColumns,
   createRunCompetitorResolver,
   readMarketCompetitorNames,
   refreshSnapshotMentionIdentity
-} from "./chunk-T6ZYAUJX.js";
+} from "./chunk-QWEAORJG.js";
 import {
   RawEventSampleEventTypes,
   auditLog,
@@ -38,7 +38,7 @@ import {
   querySnapshots,
   rawEventSamples,
   runs
-} from "./chunk-ZR4WEKEC.js";
+} from "./chunk-H3PWMM4K.js";
 import {
   ProviderNames,
   RetrievalContracts,
@@ -51,7 +51,7 @@ import {
   extractRecommendedCompetitors,
   normalizeUrlPath,
   openRouterRouteModel
-} from "./chunk-2REKLGYS.js";
+} from "./chunk-FYYOX7UY.js";
 
 // src/commands/backfill.ts
 import { setImmediate as yieldToEventLoop } from "timers/promises";
@@ -429,7 +429,7 @@ No DB writes performed. Re-run without --dry-run to apply.`);
   }
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-LVOX33SJ.js");
+  const { IntelligenceService } = await import("./intelligence-service-CJNCXI4C.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);

package/dist/{chunk-T6ZYAUJX.js → chunk-QWEAORJG.js}

@@ -15,14 +15,14 @@ import {
   normalizeCloudflareWorkerEvent,
   sessionizeJourneyRequests,
   verifyRequestSignature
-} from "./chunk-XFVB3UCE.js";
+} from "./chunk-7534NXSP.js";
 import {
   currentOutcomeAttribution,
   getRequestContext,
   registerRequestContext,
   requestAuditIdentity,
   sanitizeRequestContext
-} from "./chunk-JC2MAKWO.js";
+} from "./chunk-K7ZG6K7J.js";
 import {
   RawEventSampleEventTypes,
   SentimentIdempotencyConflict,
@@ -180,7 +180,7 @@ import {
   userSessions,
   users,
   writeNegativeReviewMaxStars
-} from "./chunk-ZR4WEKEC.js";
+} from "./chunk-H3PWMM4K.js";
 import {
   ADS_ACTIVATE_SCOPE,
   ADS_ACTIVATION_ABSOLUTE_MAX_ENTITIES,
@@ -1275,7 +1275,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-2REKLGYS.js";
+} from "./chunk-FYYOX7UY.js";
 
 // ../api-routes/src/user-session.ts
 import crypto2 from "crypto";
@@ -33381,6 +33381,11 @@ function computeVisibilityStats(input) {
   const byQuery = /* @__PURE__ */ new Map();
   const totals = emptyAgg();
   const totalsByProvider = /* @__PURE__ */ new Map();
+  const byClass = { branded: emptyAgg(), nonBrand: emptyAgg(), unclassified: emptyAgg() };
+  const classKey = (queryId) => {
+    const queryClass = input.queryClasses?.get(queryId) ?? null;
+    return queryClass === "branded" ? "branded" : queryClass === "non-brand" ? "nonBrand" : "unclassified";
+  };
   for (const snap of input.snapshots) {
     const resolved = resolveCurrentQuery(attribution, snap);
     if (!resolved) continue;
@@ -33391,6 +33396,7 @@ function computeVisibilityStats(input) {
     }
     addSnapshot(bucket.agg, snap);
     addSnapshot(totals, snap);
+    if (input.queryClasses) addSnapshot(byClass[classKey(resolved.id)], snap);
     if (wantProviders) {
       const qpAgg = bucket.byProvider.get(snap.provider) ?? emptyAgg();
       addSnapshot(qpAgg, snap);
@@ -33406,12 +33412,14 @@ function computeVisibilityStats(input) {
     ...counts(bucket.agg),
     firstObserved: bucket.agg.first ?? "",
     lastObserved: bucket.agg.last ?? "",
+    ...input.queryClasses ? { queryClass: input.queryClasses.get(bucket.id) ?? null } : {},
     ...wantProviders ? { providers: providerEntries(bucket.byProvider) } : {}
   })).sort((a, b) => a.query.localeCompare(b.query));
   return {
     totals: counts(totals),
     ...wantProviders ? { byProvider: providerEntries(totalsByProvider) } : {},
-    queries: queryEntries
+    queries: queryEntries,
+    ...input.queryClasses ? { byQueryClass: { branded: counts(byClass.branded), nonBrand: counts(byClass.nonBrand), unclassified: counts(byClass.unclassified) } } : {}
   };
 }
 async function visibilityStatsRoutes(app) {
@@ -33493,7 +33501,8 @@ async function visibilityStatsRoutes(app) {
       answerMentioned: querySnapshots.answerMentioned,
       createdAt: querySnapshots.createdAt
     }).from(querySnapshots).where(inArray34(querySnapshots.runId, runIds)).all() : [];
-    const stats = computeVisibilityStats({ queries: projectQueries, snapshots, groupBy });
+    const queryClasses = readQueryClasses(app.db, project, projectQueries);
+    const stats = computeVisibilityStats({ queries: projectQueries, snapshots, groupBy, queryClasses });
     const queryAttribution = buildQueryAttribution(projectQueries);
     let shareOfVoice;
     if (wantShareOfVoice) {
@@ -33526,6 +33535,7 @@ async function visibilityStatsRoutes(app) {
         runCount
       },
       totals: stats.totals,
+      ...stats.byQueryClass ? { byQueryClass: stats.byQueryClass } : {},
       queries: stats.queries,
       // `groupBy` + `byProvider` appear together only when a breakdown was
       // requested; both are OMITTED otherwise (absent = no breakdown) so the
@@ -39053,7 +39063,7 @@ var routeCatalog = [
     method: "get",
     path: "/api/v1/projects/{name}/visibility-stats",
     summary: "Get aggregated mention/citation stats per query",
-    description: "Per-query mention (answer-text) and citation (source-list) counts with a sample size, pooled across many answer-visibility runs (probe-excluded). Tri-state aware: `checked` counts only snapshots where answerMentioned was recorded (null = not checked is excluded). Lets a consumer compute confidence-aware (e.g. Wilson) proportions without N+1 run fetches. With no since/until/lastRuns, EVERY completed/partial answer-visibility run is pooled \u2014 `window.runCount` reports how many; bound the window with lastRuns, since/until, or month=YYYY-MM for a recent sample. Set groupBy=provider for a per-provider breakdown whose counts sum to the pooled counts, or shareOfVoice=1 to add share of voice vs tracked competitors (non-brand queries by default; set queryClass=branded for brand recall).",
+    description: "Per-query mention (answer-text) and citation (source-list) counts with a sample size, pooled across many answer-visibility runs (probe-excluded). Tri-state aware: `checked` counts only snapshots where answerMentioned was recorded (null = not checked is excluded). Lets a consumer compute confidence-aware (e.g. Wilson) proportions without N+1 run fetches. With no since/until/lastRuns, EVERY completed/partial answer-visibility run is pooled \u2014 `window.runCount` reports how many; bound the window with lastRuns, since/until, or month=YYYY-MM for a recent sample. Set groupBy=provider for a per-provider breakdown whose counts sum to the pooled counts, or shareOfVoice=1 to add share of voice vs tracked competitors (non-brand queries by default; set queryClass=branded for brand recall). `totals` pools branded and non-brand queries; `byQueryClass` splits the same counts by each query's class (as the query list reports it), and each query carries `queryClass`. The `queryClass` parameter scopes share of voice only.",
     tags: ["analytics"],
     parameters: [
       nameParameter,

package/dist/{chunk-FYJMNYVR.js → chunk-T5DH6FEH.js}

@@ -15,7 +15,7 @@ import {
   formatCanonryPluginUpdateHint,
   formatCanonryPluginVersionMismatch,
   skillsClientSchema
-} from "./chunk-2REKLGYS.js";
+} from "./chunk-FYYOX7UY.js";
 
 // src/commands/skills.ts
 import crypto from "crypto";

package/dist/{chunk-SMSTXGJX.js → chunk-TY5YTNLU.js}

@@ -5,7 +5,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-V4MRQPV2.js";
+} from "./chunk-4QYGB5IC.js";
 import {
   CANONRY_NPM_PACKAGE_URL,
   compareSemver,
@@ -18,7 +18,7 @@ import {
   updateCheckEnvOptOut,
   upgradeCaveatFor,
   upgradeCommandFor
-} from "./chunk-2REKLGYS.js";
+} from "./chunk-FYYOX7UY.js";
 
 // src/runtime-context.ts
 function cliRuntimeContext(env = process.env, stdio = process) {

package/dist/{chunk-SC7WEHEK.js → chunk-U3T37P7H.js}

@@ -1,13 +1,13 @@
 import {
   createApiClient
-} from "./chunk-EIYNZOQA.js";
+} from "./chunk-ZPVJ5PVB.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
 import {
   measurementDraftOperationSchema,
   runMeasurementDraftAction
-} from "./chunk-IPFSY55D.js";
+} from "./chunk-XYQMPYWE.js";
 import {
   isMachineFormat,
   systemError
@@ -37,7 +37,7 @@ import {
   unattributedAnswersLabel,
   uncheckedSourcesLabel,
   visibilityReportRequestSchema
-} from "./chunk-2REKLGYS.js";
+} from "./chunk-FYYOX7UY.js";
 
 // src/commands/measurement-plan.ts
 import crypto from "crypto";

package/dist/{chunk-PAC5EE5X.js → chunk-UMTYAPCQ.js}

@@ -2,11 +2,11 @@ import {
   dedupeGscSitemapUrls,
   resolveDiscoveredGscSitemapUrls,
   submitGscSitemapBatches
-} from "./chunk-7LN6QPV7.js";
+} from "./chunk-76KBMLPR.js";
 import {
   measurementDraftOperationSchema,
   runMeasurementDraftAction
-} from "./chunk-IPFSY55D.js";
+} from "./chunk-XYQMPYWE.js";
 import {
   CliError
 } from "./chunk-HGMYEDAQ.js";
@@ -187,7 +187,7 @@ import {
   trendSurfaceSchema,
   visibilityCompareSelectionSchema,
   visibilityReportRequestSchema
-} from "./chunk-2REKLGYS.js";
+} from "./chunk-FYYOX7UY.js";
 
 // src/mcp/tool-registry.ts
 import { z as z2 } from "zod";
@@ -2087,7 +2087,7 @@ var rawCanonryMcpTools = [
       month: z2.string().optional().describe("Aggregate one calendar month (YYYY-MM), expanded to that month's inclusive UTC bounds. Mutually exclusive with since/until/lastRuns."),
       groupBy: z2.enum(["provider"]).optional().describe('Set to "provider" for a per-provider breakdown.'),
       shareOfVoice: z2.boolean().optional().describe("Include brand-mention share with tracked/observed basis and availability across the same window (non-brand queries unless queryClass says otherwise)."),
-      queryClass: z2.enum(["branded", "non-brand"]).optional().describe('Query class for shareOfVoice. Defaults to non-brand. There is no "all": branded and non-brand never share a denominator.')
+      queryClass: z2.enum(["branded", "non-brand"]).optional().describe('Query class for shareOfVoice. Defaults to non-brand. There is no "all": branded and non-brand never share a denominator. It does not filter the counts: `totals` pools both classes, and `byQueryClass` (plus `queryClass` on each query) carries the split.')
     }),
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/visibility-stats"],

package/dist/{chunk-FLP4XMWI.js → chunk-WONUYAKB.js}

@@ -2,13 +2,13 @@ import {
   bucketCliCommandDuration,
   isTelemetryEnabled,
   trackEvent
-} from "./chunk-SMSTXGJX.js";
+} from "./chunk-TY5YTNLU.js";
 import {
   getConfigDir
-} from "./chunk-V4MRQPV2.js";
+} from "./chunk-4QYGB5IC.js";
 import {
   currentOutcomeAttribution
-} from "./chunk-JC2MAKWO.js";
+} from "./chunk-K7ZG6K7J.js";
 import {
   AGENT_NONE,
   OutcomeSurfaces,
@@ -19,7 +19,7 @@ import {
   integrationConnectionPropertiesSchema,
   normalizeAgentSlug,
   usageSurfaceSchema
-} from "./chunk-2REKLGYS.js";
+} from "./chunk-FYYOX7UY.js";
 
 // src/outcome-telemetry.ts
 import fs from "fs";

package/dist/{chunk-HMNQTF3E.js → chunk-WTZZOUOJ.js}

@@ -1,9 +1,9 @@
 import {
   pickProjectCitedDomain
-} from "./chunk-SMH4FUXJ.js";
+} from "./chunk-AUC47DFW.js";
 import {
   createLogger
-} from "./chunk-PIDL7OJ4.js";
+} from "./chunk-BTYOU24P.js";
 import {
   GBP_INSIGHT_PROVIDER,
   PERSISTENT_GAP_THRESHOLD,
@@ -17,7 +17,7 @@ import {
   mergeGscQueryTotalsWithFallback,
   readGscQueryDailyRows,
   readLatestGscDataDate
-} from "./chunk-T6ZYAUJX.js";
+} from "./chunk-QWEAORJG.js";
 import {
   competitors,
   gbpDailyMetrics,
@@ -35,14 +35,14 @@ import {
   queries,
   querySnapshots,
   runs
-} from "./chunk-ZR4WEKEC.js";
+} from "./chunk-H3PWMM4K.js";
 import {
   CitationStates,
   RunKinds,
   RunStatuses,
   RunTriggers,
   effectiveDomains
-} from "./chunk-2REKLGYS.js";
+} from "./chunk-FYYOX7UY.js";
 
 // src/intelligence-service.ts
 import { eq, desc, asc, and, ne, or, inArray, gte, lte, isNull, sql, exists } from "drizzle-orm";

package/dist/{chunk-IPFSY55D.js → chunk-XYQMPYWE.js}

@@ -23,7 +23,7 @@ import {
   measurementDraftUpsertGroupRequestSchema,
   measurementDraftUpsertMarketRequestSchema,
   measurementDraftUpsertTargetRequestSchema
-} from "./chunk-2REKLGYS.js";
+} from "./chunk-FYYOX7UY.js";
 
 // src/measurement-draft-actions.ts
 import { z } from "zod";