@canonry/canonry 7.60.0 → 7.61.1

package/dist/{chunk-7KEIZ5OO.js → chunk-4UTPB5KB.js}

@@ -7,27 +7,27 @@ import {
   reparseStoredResult4,
   reparseStoredResult5,
   resolveStoredApiResponse
-} from "./chunk-DUYENNUI.js";
+} from "./chunk-GAA7JGB7.js";
 import {
   loadConfig
-} from "./chunk-QEG7BSLH.js";
+} from "./chunk-CZSHCZHW.js";
 import {
   isMachineFormat
 } from "./chunk-HGMYEDAQ.js";
 import {
   determineCitationState
-} from "./chunk-UHE4RLFW.js";
+} from "./chunk-G3ZNUINX.js";
 import {
   backfillProjectAnswerMentions,
   competitorIdentityColumns,
   createRunCompetitorResolver,
   readMarketCompetitorNames,
   refreshSnapshotMentionIdentity
-} from "./chunk-4IV4FO3O.js";
+} from "./chunk-QP36LXT5.js";
 import {
   classifyAiUserFetch,
   classifyCrawler
-} from "./chunk-O7KIDW4H.js";
+} from "./chunk-34HGKT6I.js";
 import {
   aiUserFetchEventsHourly,
   auditLog,
@@ -42,7 +42,7 @@ import {
   querySnapshots,
   rawEventSamples,
   runs
-} from "./chunk-3JV3PWNA.js";
+} from "./chunk-HD7AZIOP.js";
 import {
   ProviderNames,
   RetrievalContracts,
@@ -59,7 +59,7 @@ import {
   extractRecommendedCompetitors,
   normalizeUrlPath,
   openRouterRouteModel
-} from "./chunk-JDL4QAPT.js";
+} from "./chunk-IG6ISQYD.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-S5DI74LD.js");
+  const { IntelligenceService } = await import("./intelligence-service-O4BALXZK.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);

package/dist/{chunk-IDPAYZHR.js → chunk-5AV2OUCJ.js}

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

package/dist/{chunk-GLFE3Q3C.js → chunk-5PYPNDIE.js}

@@ -3,7 +3,7 @@ import {
   resolveCliAccess,
   resolveCliAccessForInvocation,
   windowOptions
-} from "./chunk-7HZ7KRHT.js";
+} from "./chunk-VHHFAAMI.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
@@ -14,7 +14,7 @@ import {
 } from "./chunk-HGMYEDAQ.js";
 import {
   OperationAccesses
-} from "./chunk-JDL4QAPT.js";
+} from "./chunk-IG6ISQYD.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-DJPRREDK.js");
+      const { printCliCatalog: printCliCatalog2 } = await import("./cli-catalog-F3IOEPJK.js");
       const group2 = argsWithoutHelp.find((arg) => !arg.startsWith("--"));
       printCliCatalog2(specs, fallbackFormat, group2, accessValue);
       return true;

package/dist/{chunk-FCPIOH6P.js → chunk-7VEXNHRX.js}

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

package/dist/{chunk-HV5MGQYI.js → chunk-B5KK54RE.js}

@@ -1,13 +1,13 @@
 import {
   createApiClient
-} from "./chunk-SJNF5GN2.js";
+} from "./chunk-SZXYGJMI.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
 import {
   measurementDraftOperationSchema,
   runMeasurementDraftAction
-} from "./chunk-D7ZU5LMK.js";
+} from "./chunk-MRNMDQRB.js";
 import {
   isMachineFormat,
   systemError
@@ -37,7 +37,7 @@ import {
   unattributedAnswersLabel,
   uncheckedSourcesLabel,
   visibilityReportRequestSchema
-} from "./chunk-JDL4QAPT.js";
+} from "./chunk-IG6ISQYD.js";
 
 // src/commands/measurement-plan.ts
 import crypto from "crypto";

package/dist/{chunk-OA6N3BI7.js → chunk-BKNIXYMI.js}

@@ -1,16 +1,16 @@
 import {
   runWithUsageTags
-} from "./chunk-SJNF5GN2.js";
+} from "./chunk-SZXYGJMI.js";
 import {
   CanonryMcpToolNames,
   canonryMcpTools
-} from "./chunk-7XSGAPN5.js";
+} from "./chunk-RL7LPPFU.js";
 import {
   CliError
 } from "./chunk-HGMYEDAQ.js";
 import {
   buildOpenApiDocument
-} from "./chunk-4IV4FO3O.js";
+} from "./chunk-QP36LXT5.js";
 import {
   DEFAULT_COMPETITOR_AUTO_ALIAS_MODE,
   MeasurementPortfolioLists,
@@ -20,7 +20,7 @@ import {
   formatPercent,
   ratioUnitSchema,
   truncateUtf16
-} from "./chunk-JDL4QAPT.js";
+} from "./chunk-IG6ISQYD.js";
 
 // src/agent/tools.ts
 import { Type as Type2 } from "@earendil-works/pi-ai";

package/dist/{chunk-QEG7BSLH.js → chunk-CZSHCZHW.js}

@@ -20,7 +20,7 @@ import {
   resolveProviderModel,
   schedulableRunKindSchema,
   sentimentEvaluatorProviderSchema
-} from "./chunk-JDL4QAPT.js";
+} from "./chunk-IG6ISQYD.js";
 
 // ../config/src/index.ts
 import { z as z4 } from "zod";

package/dist/{chunk-XJF7LMGU.js → chunk-EKY6GHJ4.js}

@@ -2,13 +2,13 @@ import {
   bucketCliCommandDuration,
   isTelemetryEnabled,
   trackEvent
-} from "./chunk-G7VJEPDZ.js";
+} from "./chunk-YHTU4XBR.js";
 import {
   getConfigDir
-} from "./chunk-QEG7BSLH.js";
+} from "./chunk-CZSHCZHW.js";
 import {
   currentOutcomeAttribution
-} from "./chunk-66C7YITH.js";
+} from "./chunk-KX5IRN55.js";
 import {
   AGENT_NONE,
   OutcomeSurfaces,
@@ -19,7 +19,7 @@ import {
   integrationConnectionPropertiesSchema,
   normalizeAgentSlug,
   usageSurfaceSchema
-} from "./chunk-JDL4QAPT.js";
+} from "./chunk-IG6ISQYD.js";
 
 // src/outcome-telemetry.ts
 import fs from "fs";

package/dist/{chunk-Z63ZR6AD.js → chunk-FWRHDY4R.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-HGMYEDAQ.js";
 import {
   describeError
-} from "./chunk-JDL4QAPT.js";
+} from "./chunk-IG6ISQYD.js";
 
 // src/commands/mcp.ts
 import fs from "fs";

package/dist/{chunk-L7WQTD3D.js → chunk-G3DZSUYD.js}

@@ -5,7 +5,7 @@ import {
   isStoredPageReadTool,
   isStoredReadTool,
   truncateToolResult
-} from "./chunk-OA6N3BI7.js";
+} from "./chunk-BKNIXYMI.js";
 import {
   CANONRY_MCP_TOOLKITS
 } from "./chunk-NCIPNVD6.js";
@@ -22,15 +22,15 @@ import {
   resolveApiKeyFor,
   resolveModelForProvider,
   validateAgentProviderRegistry
-} from "./chunk-QEG7BSLH.js";
+} from "./chunk-CZSHCZHW.js";
 import {
   CanonryMcpToolNames,
   canonryMcpTools
-} from "./chunk-7XSGAPN5.js";
+} from "./chunk-RL7LPPFU.js";
 import {
   agentToolEvents,
   llmUsageEvents
-} from "./chunk-3JV3PWNA.js";
+} from "./chunk-HD7AZIOP.js";
 import {
   MeasurementPortfolioLists,
   agentTurnLimitsSchema,
@@ -38,7 +38,7 @@ import {
   describeError,
   validationError,
   visibilityReportRequestSchema
-} from "./chunk-JDL4QAPT.js";
+} from "./chunk-IG6ISQYD.js";
 
 // src/agent/session.ts
 import fs3 from "fs";

package/dist/{chunk-UHE4RLFW.js → chunk-G3ZNUINX.js}

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

package/dist/{chunk-DUYENNUI.js → chunk-GAA7JGB7.js}

@@ -1,6 +1,6 @@
 import {
   parseJsonColumn
-} from "./chunk-3JV3PWNA.js";
+} from "./chunk-HD7AZIOP.js";
 import {
   AI_ENGINE_DOMAINS,
   AI_ENGINE_SELF_DOMAINS,
@@ -26,7 +26,7 @@ import {
   retryAfterDelayMs,
   usageCount,
   withRetry
-} from "./chunk-JDL4QAPT.js";
+} from "./chunk-IG6ISQYD.js";
 
 // ../provider-openai/src/normalize.ts
 import OpenAI from "openai";

package/dist/{chunk-3JV3PWNA.js → chunk-HD7AZIOP.js}

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

package/dist/{chunk-JDL4QAPT.js → chunk-IG6ISQYD.js}

@@ -10901,6 +10901,13 @@ var brandMetricsDtoSchema = z26.object({
   window: metricsWindowSchema,
   /** Scope that applies even when `buckets` is empty. `pooled` means classification was unavailable. */
   mentionShareScope: z26.enum(["non-brand", "pooled"]),
+  /**
+   * The answers every rate, bucket, change and query-set event in this response
+   * reads: `branded` or `non-brand` only, or `all` for both pooled. Mention
+   * share is always non-brand, so it is empty under `branded`. A server that
+   * predates the field read `all`.
+   */
+  queryClass: queryClassFilterSchema.default("all"),
   buckets: z26.array(timeBucketSchema),
   overall: providerMetricSchema,
   byProvider: z26.record(z26.string(), providerMetricSchema),
@@ -19049,6 +19056,7 @@ function classifyJourneyEntry(signal) {
   if (signal.clickNetwork) return { entryClass: "social", entryName: signal.clickNetwork, entryHost: null, paid: false };
   return { entryClass: "direct", entryName: null, entryHost: null, paid: false };
 }
+var SAFARI_FROZEN_IOS_VERSION_FROM = 26;
 function journeyDeviceLabel(userAgent) {
   const ua = userAgent ?? "";
   if (!ua) return "Unknown device";
@@ -19067,8 +19075,10 @@ function journeyDeviceLabel(userAgent) {
   })();
   const ios = /(iPhone|iPad|iPod).*?OS (\d+)_(\d+)/.exec(ua);
   if (ios) {
-    const iosBrowser = /CriOS|FxiOS|EdgiOS/.test(ua) ? browser : "Safari";
-    return [ios[1], `iOS ${ios[2]}.${ios[3]}`, iosBrowser].filter(Boolean).join(" \xB7 ");
+    const thirdParty = /CriOS|FxiOS|EdgiOS/.test(ua);
+    const safariMajor = thirdParty ? NaN : Number(/Version\/(\d+)/.exec(ua)?.[1]);
+    const iosVersion = safariMajor >= SAFARI_FROZEN_IOS_VERSION_FROM ? String(safariMajor) : `${ios[2]}.${ios[3]}`;
+    return [ios[1], `iOS ${iosVersion}`, thirdParty ? browser : "Safari"].filter(Boolean).join(" \xB7 ");
   }
   const android = /Android (\d+(?:\.\d+)?)/.exec(ua);
   if (android) return ["Android " + android[1], browser].filter(Boolean).join(" \xB7 ");

package/dist/{chunk-66C7YITH.js → chunk-KX5IRN55.js}

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

package/dist/{chunk-D7ZU5LMK.js → chunk-MRNMDQRB.js}

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

package/dist/{chunk-QCSNNKFI.js → chunk-P5DZ56CR.js}

@@ -1,7 +1,7 @@
 import {
   API_PROVIDER_NAMES,
   ProviderNames
-} from "./chunk-JDL4QAPT.js";
+} from "./chunk-IG6ISQYD.js";
 
 // src/provider-registration.ts
 function isApiProviderRegistrable(name, entry) {

package/dist/{chunk-FKQPVB5B.js → chunk-QGXPQHDN.js}

@@ -1,7 +1,7 @@
 import {
   answerServiceAdapters,
   answerServiceDescriptors
-} from "./chunk-FCPIOH6P.js";
+} from "./chunk-7VEXNHRX.js";
 import {
   AeroLlmUsageFeatures,
   aeroTurnStatus,
@@ -27,14 +27,14 @@ import {
   resolveConfiguredAgentProvider,
   resolveSessionProviderAndModel,
   setAeroSystemPrompt
-} from "./chunk-L7WQTD3D.js";
+} from "./chunk-G3DZSUYD.js";
 import {
   AeroToolProfiles,
   AeroToolScopes,
   buildAeroStateTools,
   isAeroToolProfile,
   truncateToolResult
-} from "./chunk-OA6N3BI7.js";
+} from "./chunk-BKNIXYMI.js";
 import {
   getGoogleAuthConfig,
   getGoogleConnection,
@@ -53,7 +53,7 @@ import {
   removeCloudflareTrafficConnection,
   removeCloudflareTrafficConnectionBySourceId,
   upsertCloudflareTrafficConnection
-} from "./chunk-NQTUPEBQ.js";
+} from "./chunk-XCA546YC.js";
 import {
   claudeAdapter,
   embedQueries,
@@ -64,7 +64,7 @@ import {
   openaiAdapter,
   openrouterAdapter,
   perplexityAdapter
-} from "./chunk-DUYENNUI.js";
+} from "./chunk-GAA7JGB7.js";
 import {
   classifyUsageSurface,
   createApiUsageTelemetry,
@@ -76,7 +76,7 @@ import {
   startOutcomeTimer,
   trackFeatureCompleted,
   trackInstallState
-} from "./chunk-XJF7LMGU.js";
+} from "./chunk-EKY6GHJ4.js";
 import {
   isLoopbackBindHost
 } from "./chunk-TSENU4GG.js";
@@ -84,7 +84,7 @@ import {
   isApiProviderRegistrable,
   isCdpProviderRegistrable,
   registeredProviderNames
-} from "./chunk-QCSNNKFI.js";
+} from "./chunk-P5DZ56CR.js";
 import {
   checkLatestVersionForServer,
   getOrCreateAnonymousId,
@@ -95,17 +95,17 @@ import {
   recordDashboardEvent,
   setTelemetryPreference,
   trackEvent
-} from "./chunk-G7VJEPDZ.js";
+} from "./chunk-YHTU4XBR.js";
 import {
   createCanonryMcpServer
-} from "./chunk-Z7WG6F7Q.js";
+} from "./chunk-3A7LI5KI.js";
 import {
   CANONRY_MCP_TIERS,
   CANONRY_MCP_TOOLKIT_NAMES
 } from "./chunk-NCIPNVD6.js";
 import {
   ApiClient
-} from "./chunk-SJNF5GN2.js";
+} from "./chunk-SZXYGJMI.js";
 import {
   AGENT_PROVIDERS,
   adapterSupportsBatch,
@@ -136,21 +136,21 @@ import {
   saveConfigPatch,
   sentimentInstallReadiness,
   updateSharedProviderExecutionGate
-} from "./chunk-QEG7BSLH.js";
+} from "./chunk-CZSHCZHW.js";
 import {
   getBundledSkillSnapshots
-} from "./chunk-IDPAYZHR.js";
+} from "./chunk-5AV2OUCJ.js";
 import {
   computeFactorAverages,
   deleteSiteCrawlGraphLayout,
   persistSiteCrawlGraphLayout,
   prepareSiteCrawlGraphLayout,
   recordedSharePct
-} from "./chunk-ZK5WIVGA.js";
+} from "./chunk-W5FR6AJP.js";
 import {
   CanonryMcpToolNames,
   canonryMcpTools
-} from "./chunk-7XSGAPN5.js";
+} from "./chunk-RL7LPPFU.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
@@ -162,11 +162,11 @@ import {
   addLogListener,
   createFastifyLogger,
   createLogger
-} from "./chunk-RLXNZRHD.js";
+} from "./chunk-TGZKOIZ3.js";
 import {
   computeCitedCompetitorDomains,
   determineCitationState
-} from "./chunk-UHE4RLFW.js";
+} from "./chunk-G3ZNUINX.js";
 import {
   BingApiError,
   CC_CACHE_DIR,
@@ -285,7 +285,7 @@ import {
   webhookResponseReason,
   webhookTargetRefusalReason,
   writeAuditLog
-} from "./chunk-4IV4FO3O.js";
+} from "./chunk-QP36LXT5.js";
 import {
   OperationalLogStore,
   SentimentIdempotencyConflict,
@@ -371,7 +371,7 @@ import {
   siteLivenessState,
   trafficSources,
   usageCounters
-} from "./chunk-3JV3PWNA.js";
+} from "./chunk-HD7AZIOP.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AI_ENGINE_DOMAINS,
@@ -616,7 +616,7 @@ import {
   winnabilityClassLabel,
   withRetry,
   withSkippedProviders
-} from "./chunk-JDL4QAPT.js";
+} from "./chunk-IG6ISQYD.js";
 
 // src/google-marketing-runtime.ts
 import crypto2 from "crypto";
@@ -5657,7 +5657,7 @@ function nonBlank(value) {
   return trimmed ? trimmed : void 0;
 }
 function resolveBuildCommit(env = process.env) {
-  const embedded = true ? "f07ffb8d5bf311a4b65733f81f887459cf1aa259" : void 0;
+  const embedded = true ? "702b9edacd9f89400cd610bf68d54b10bb1d246e" : void 0;
   return nonBlank(embedded) ?? nonBlank(env.CANONRY_COMMIT);
 }
 function resolveInstanceIdentity(env = process.env) {

package/dist/{chunk-4IV4FO3O.js → chunk-QP36LXT5.js}

@@ -9,14 +9,14 @@ import {
   normalizeCloudflareWorkerEvent,
   sessionizeJourneyRequests,
   verifyRequestSignature
-} from "./chunk-O7KIDW4H.js";
+} from "./chunk-34HGKT6I.js";
 import {
   currentOutcomeAttribution,
   getRequestContext,
   registerRequestContext,
   requestAuditIdentity,
   sanitizeRequestContext
-} from "./chunk-66C7YITH.js";
+} from "./chunk-KX5IRN55.js";
 import {
   SentimentIdempotencyConflict,
   SentimentRepository,
@@ -154,7 +154,7 @@ import {
   userSessions,
   users,
   writeNegativeReviewMaxStars
-} from "./chunk-3JV3PWNA.js";
+} from "./chunk-HD7AZIOP.js";
 import {
   ADS_ACTIVATE_SCOPE,
   ADS_ACTIVATION_ABSOLUTE_MAX_ENTITIES,
@@ -939,6 +939,7 @@ import {
   providerSummaryEntryDtoSchema,
   providersFailing,
   qualifiedNameIncludesName,
+  queryClassFilterSchema,
   queryDtoSchema,
   queryGenerateRequestSchema,
   queryGenerateResponseSchema,
@@ -1156,7 +1157,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-JDL4QAPT.js";
+} from "./chunk-IG6ISQYD.js";
 
 // ../api-routes/src/user-session.ts
 import crypto2 from "crypto";
@@ -27368,6 +27369,22 @@ async function analyticsRoutes(app) {
     const project = resolveProject(app.db, request.params.name);
     const classifyQuery = projectQueryClassifier(project);
     const mentionShareScope = classifyQuery ? "non-brand" : "pooled";
+    const parsedQueryClass = queryClassFilterSchema.safeParse(request.query.queryClass ?? "all");
+    if (!parsedQueryClass.success) {
+      throw validationError('"queryClass" must be one of: all, branded, non-brand', { issues: parsedQueryClass.error.issues });
+    }
+    const queryClass = parsedQueryClass.data;
+    if (queryClass !== "all" && activeMeasurementPlan(app.db, project.id)?.plan.schemaVersion === 2) {
+      throw validationError(
+        `Query class "${queryClass}" on a published measurement plan follows its assignments. Read the split from GET /projects/${project.name}/visibility-report, or omit queryClass for pooled trends.`
+      );
+    }
+    if (queryClass !== "all" && !classifyQuery) {
+      throw validationError(
+        `Query class "${queryClass}" needs a brand name or alias on this project. Add one, or omit queryClass for pooled trends.`
+      );
+    }
+    const inQueryClass = (text) => queryClass === "all" || classifyQuery(text) === queryClass;
     const window2 = parseWindow(request.query.window);
     const cutoff = windowCutoff(window2);
     const projectRuns = app.db.select().from(runs).where(and37(
@@ -27381,6 +27398,7 @@ async function analyticsRoutes(app) {
       return reply.send({
         window: window2,
         mentionShareScope,
+        queryClass,
         buckets: [],
         overall: { citationRate: 0, cited: 0, total: 0, mentionRate: 0, mentionedCount: 0 },
         byProvider: {},
@@ -27437,7 +27455,7 @@ async function analyticsRoutes(app) {
       // this far when its text matched the basket, so its key is never empty.)
       basketKey: normalizeQueryText(s.queryText ?? (s.queryId ? queryTextById.get(s.queryId) ?? "" : "")) || s.queryId || "",
       runBasketRevision: runBasketRevision.get(s.runId) ?? null
-    }));
+    })).filter((s) => queryClass === "all" || s.queryClass === queryClass);
     const mentionShareCompetitors2 = mentionShareCompetitors(
       app.db.select(competitorIdentityColumns).from(competitors).where(eq46(competitors.projectId, project.id)).orderBy(competitors.domain).all()
     );
@@ -27603,17 +27621,17 @@ async function analyticsRoutes(app) {
     const trend = computeTrend(buckets, "citationRate");
     const mentionTrend = computeTrend(buckets, "mentionRate");
     const windowChange = computeWindowChange(buckets);
-    const queryChanges = computeQueryChanges(projectQueries, cutoff);
+    const queryChanges = computeQueryChanges(projectQueries.filter((q) => inQueryClass(q.query)), cutoff);
     const basketChanges = basketRevisions.slice(1).map((rev, i) => {
       const previous = new Set(basketRevisions[i].members);
       const current = new Set(rev.members);
       return {
         revision: rev.revision,
         at: rev.createdAt,
-        added: rev.members.filter((m) => !previous.has(m)),
-        removed: basketRevisions[i].members.filter((m) => !current.has(m))
+        added: rev.members.filter((m) => !previous.has(m) && inQueryClass(m)),
+        removed: basketRevisions[i].members.filter((m) => !current.has(m) && inQueryClass(m))
       };
-    }).filter((change) => !cutoff || change.at >= cutoff);
+    }).filter((change) => queryClass === "all" || change.added.length + change.removed.length > 0).filter((change) => !cutoff || change.at >= cutoff);
     const executionIdentityChanges = [];
     let previousExecutionChecksum = null;
     for (const run of projectRuns) {
@@ -27624,7 +27642,7 @@ async function analyticsRoutes(app) {
       }
       previousExecutionChecksum = identity.checksum;
     }
-    return reply.send({ window: window2, mentionShareScope, buckets, overall, byProvider, trend, mentionTrend, windowChange, queryChanges, basketChanges, executionIdentityChanges, referenceBasketRevision: latestBasket?.revision ?? null, modelAttribution, servedModelAttribution, modelServiceMismatch, modelPointerChanges, competitorIdentityChangedAt: readCompetitorIdentityChangedAt(app.db, project.id), competitorSetChangedAt: readCompetitorSetChangedAt(app.db, project.id) });
+    return reply.send({ window: window2, mentionShareScope, queryClass, buckets, overall, byProvider, trend, mentionTrend, windowChange, queryChanges, basketChanges, executionIdentityChanges, referenceBasketRevision: latestBasket?.revision ?? null, modelAttribution, servedModelAttribution, modelServiceMismatch, modelPointerChanges, competitorIdentityChangedAt: readCompetitorIdentityChangedAt(app.db, project.id), competitorSetChangedAt: readCompetitorSetChangedAt(app.db, project.id) });
   });
   app.get("/projects/:name/analytics/gaps", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
@@ -34290,6 +34308,12 @@ var sourcesQueryClassParameter = {
   description: "Restrict to branded or non-brand answers. With an active v2 measurement plan the class comes from each run's frozen plan assignments (the same answers as the competitor landscape at scope=all-markets); otherwise from the project's brand-name classifier over the query text. Answers neither basis can place are excluded and counted in unclassifiedAnswers. Defaults to all, which pools both classes.",
   schema: { type: "string", enum: ["all", "branded", "non-brand"] }
 };
+var metricsQueryClassParameter = {
+  name: "queryClass",
+  in: "query",
+  description: "Restrict every rate, bucket, change and query-set event to branded or non-brand answers, classified from the query text by the project's brand names (the same split mention share uses). Mention share stays non-brand, so it is empty under branded. Bucket boundaries do not move with the class, so the two classes plot on the same dates. 400 when the project has no brand name or alias to classify with, or has a published v2 measurement plan (its classes live on the plan assignments; read the split from the visibility report). Defaults to all, which pools both classes.",
+  schema: { type: "string", enum: ["all", "branded", "non-brand"] }
+};
 var sourcesIncludeByQueryParameter = {
   name: "includeByQuery",
   in: "query",
@@ -36804,9 +36828,10 @@ var routeCatalog = [
     path: "/api/v1/projects/{name}/analytics/metrics",
     summary: "Get citation trend analytics",
     tags: ["analytics"],
-    parameters: [nameParameter, analyticsWindowParameter],
+    parameters: [nameParameter, analyticsWindowParameter, metricsQueryClassParameter],
     responses: {
       200: jsonResponse("Citation metrics returned.", "BrandMetricsDto"),
+      400: errorResponse("Invalid query parameters."),
       404: errorResponse("Project not found.")
     }
   },