@canonry/canonry 5.19.0 → 5.19.1

package/dist/{chunk-ABUO27BV.js → chunk-J3JXJIST.js}

@@ -4,14 +4,14 @@ import {
   installSkills,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-SPCEXW3B.js";
+} from "./chunk-EJXDABGU.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-YHKKCXGY.js";
+} from "./chunk-4WROKFN6.js";
 import {
   SKILL_MANIFEST_FILENAME,
   SkillsClients
-} from "./chunk-WLL7Q7JD.js";
+} from "./chunk-SOCYTKTF.js";
 
 // src/skills-autosync.ts
 import fs from "fs";

package/dist/{chunk-QJWIOCEO.js → chunk-PGOID3LE.js}

@@ -5,12 +5,12 @@ import {
   siteCrawlGraphNodes,
   siteCrawlPages,
   siteCrawlSnapshots
-} from "./chunk-P2EFPLIO.js";
+} from "./chunk-3IAIW5KH.js";
 import {
   SITE_CRAWL_GRAPH_MAX_EDGES,
   SITE_CRAWL_GRAPH_MAX_NODES,
   TEMPLATE_LINK_RATIO_THRESHOLD
-} from "./chunk-WLL7Q7JD.js";
+} from "./chunk-SOCYTKTF.js";
 
 // src/site-crawl-graph-layout.ts
 import crypto from "crypto";

package/dist/{chunk-WLL7Q7JD.js → chunk-SOCYTKTF.js}

@@ -7157,25 +7157,97 @@ var measurementDemoFilterQueryShape = {
   location: measurementDemoLocationSchema.optional()
 };
 var measurementDemoRecommendedNameSchema = z18.string().trim().min(1);
+var MEASUREMENT_PORTFOLIO_DEFAULT_LIMIT = 4;
+var MEASUREMENT_PORTFOLIO_ROW_EVIDENCE_LIMIT = 5;
+var MEASUREMENT_PORTFOLIO_ANSWER_SOURCES_LIMIT = 10;
+var MEASUREMENT_PORTFOLIO_TIE_NOTE = "tied Properties are ordered by name, not ranked";
 var measurementPortfolioSummaryQuerySchema = z18.object({
   runId: measurementDemoFilterQueryShape.runId,
   groupKey: measurementV2StableKeySchema.optional(),
   queryClass: measurementQueryClassFilterSchema.default("non-brand"),
   provider: measurementDemoFilterQueryShape.provider,
   location: measurementDemoFilterQueryShape.location,
-  limit: z18.number().int().positive().max(50).optional()
+  /** Caps every list in the response (Property rows, both mention rankings, markets). Defaults to 4. */
+  limit: z18.number().int().positive().max(50).optional(),
+  /**
+   * Off by default: `markets` holds one level only, the top-level markets (or
+   * the selected group's direct children), worst-first and capped at `limit`.
+   * True returns every market in scope at every level, uncapped, as the
+   * roll-up did before it was levelled.
+   */
+  includeNestedMarkets: z18.boolean().optional()
+}).strict();
+var measurementPortfolioMetroSchema = z18.object({
+  groupKey: measurementV2StableKeySchema,
+  label: measurementDemoLabelSchema
+}).strict();
+var measurementPortfolioPropertyContextShape = {
+  /** The top-level group holding this Property; null when it is in none. */
+  metro: measurementPortfolioMetroSchema.nullable(),
+  /** Further top-level groups holding the same Property. Present only when there are any. */
+  otherMetros: z18.array(measurementPortfolioMetroSchema).min(1).optional(),
+  /** Labels of every nested (non-top-level) group holding this Property, shallowest first. */
+  submarkets: z18.array(measurementDemoLabelSchema),
+  queries: measurementDemoCountSchema
+};
+var measurementPortfolioCountedNameSchema = z18.object({
+  name: measurementDemoRecommendedNameSchema,
+  /** Answers that wrote this name. */
+  answers: measurementDemoCountSchema
+}).strict();
+var measurementPortfolioRecommendedInsteadSchema = z18.object({
+  name: measurementDemoRecommendedNameSchema,
+  /** Answers that wrote this name, one per answer however it spells it: the same count as `namedInsteadInAnswerText[].answers`. */
+  occurrences: measurementDemoCountSchema
+}).strict();
+var measurementPortfolioCountedDomainSchema = z18.object({
+  domain: z18.string().trim().min(1),
+  /** Answers citing at least one URL on this domain. */
+  answers: measurementDemoCountSchema
 }).strict();
 var measurementPortfolioWeakestPropertySchema = measurementDemoPropertySchema.extend({
+  ...measurementPortfolioPropertyContextShape,
   mentionCoverage: measurementMetricValueSchema,
   citationCoverage: measurementMetricValueSchema,
   flags: measurementDemoCountSchema,
-  recommendedInstead: z18.array(z18.object({
-    name: measurementDemoRecommendedNameSchema,
-    occurrences: measurementDemoCountSchema
-  }).strict()).max(5),
-  recommendedInsteadTotal: measurementDemoCountSchema,
-  recommendedInsteadTruncated: z18.boolean()
+  /**
+   * Names WRITTEN IN THE ANSWER TEXT of this Property's answers that neither
+   * named nor cited it, counted by answer. These are mentions, never
+   * citations: a name here says nothing about which sources were linked.
+   * Supersedes the deprecated `recommendedInstead`, whose name read as a
+   * citation.
+   */
+  namedInsteadInAnswerText: z18.array(measurementPortfolioCountedNameSchema).max(MEASUREMENT_PORTFOLIO_ROW_EVIDENCE_LIMIT),
+  /** Distinct names across those answers; more than returned means the list was cut. */
+  namedInsteadInAnswerTextTotal: measurementDemoCountSchema,
+  /**
+   * Domains cited by this Property's stored answers in this run and class,
+   * every engine included: each answer's stored domains plus the hosts of its
+   * captured source URLs, and answers whose text was not captured count too.
+   */
+  citedDomains: z18.array(measurementPortfolioCountedDomainSchema).max(MEASUREMENT_PORTFOLIO_ROW_EVIDENCE_LIMIT),
+  /** Distinct cited domains; more than returned means the list was cut. */
+  citedDomainsTotal: measurementDemoCountSchema,
+  /**
+   * Deprecated: read `namedInsteadInAnswerText`. The same names in the same
+   * order, kept for existing consumers. `occurrences` counts answers, one per
+   * answer however it spells the name, exactly as `answers` does there.
+   */
+  recommendedInstead: z18.array(measurementPortfolioRecommendedInsteadSchema).max(MEASUREMENT_PORTFOLIO_ROW_EVIDENCE_LIMIT).meta({ deprecated: true, description: "Deprecated: read namedInsteadInAnswerText, which carries the same names in the same order. occurrences counts answers, exactly as answers does there." }),
+  /** Deprecated: read `namedInsteadInAnswerTextTotal`, which it always equals. */
+  recommendedInsteadTotal: measurementDemoCountSchema.meta({ deprecated: true, description: "Deprecated: read namedInsteadInAnswerTextTotal, which it always equals." }),
+  /** Deprecated: true when `namedInsteadInAnswerTextTotal` exceeds the names returned. */
+  recommendedInsteadTruncated: z18.boolean().meta({ deprecated: true, description: "Deprecated: true when namedInsteadInAnswerTextTotal exceeds the names returned in namedInsteadInAnswerText." })
 }).strict().superRefine((row, ctx) => {
+  if (row.namedInsteadInAnswerText.length > row.namedInsteadInAnswerTextTotal) {
+    ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["namedInsteadInAnswerTextTotal"], message: "Total cannot be smaller than the returned names" });
+  }
+  if (row.citedDomains.length > row.citedDomainsTotal) {
+    ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["citedDomainsTotal"], message: "Total cannot be smaller than the returned domains" });
+  }
+  if (row.recommendedInsteadTotal !== row.namedInsteadInAnswerTextTotal) {
+    ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["recommendedInsteadTotal"], message: "The deprecated total must equal namedInsteadInAnswerTextTotal" });
+  }
   if (row.recommendedInstead.length > row.recommendedInsteadTotal) {
     ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["recommendedInsteadTotal"], message: "Total cannot be smaller than the returned replacements" });
   }
@@ -7183,24 +7255,46 @@ var measurementPortfolioWeakestPropertySchema = measurementDemoPropertySchema.ex
     ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["recommendedInsteadTruncated"], message: "Truncation must agree with the replacement total" });
   }
 });
+var measurementPortfolioWeakestTieSchema = z18.object({
+  count: z18.number().int().min(2),
+  mentionRate: z18.number(),
+  citationRate: z18.number(),
+  note: z18.literal(MEASUREMENT_PORTFOLIO_TIE_NOTE)
+}).strict();
+var measurementPortfolioAnswerSourcesSchema = z18.object({
+  properties: measurementDemoCountSchema,
+  answers: measurementDemoCountSchema,
+  domains: z18.array(measurementPortfolioCountedDomainSchema).max(MEASUREMENT_PORTFOLIO_ANSWER_SOURCES_LIMIT),
+  domainTotal: measurementDemoCountSchema
+}).strict().superRefine((sources, ctx) => {
+  if (sources.domains.length > sources.domainTotal) {
+    ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["domainTotal"], message: "Total cannot be smaller than the returned domains" });
+  }
+  if (sources.domains.some((row) => row.answers > sources.answers)) {
+    ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["domains"], message: "A domain cannot be cited by more answers than the basis holds" });
+  }
+});
 var measurementPortfolioMarketSchema = z18.object({
   groupKey: measurementV2StableKeySchema,
   label: measurementDemoLabelSchema,
+  /** Null for a top-level market. */
+  parentGroupKey: measurementV2StableKeySchema.nullable(),
+  /** Direct child markets; read one with `groupKey` to list them. */
+  childMarketCount: measurementDemoCountSchema,
   propertyCount: measurementDemoCountSchema,
   propertiesMentioned: measurementMetricValueSchema,
   mentionCoverage: measurementMetricValueSchema,
   citationCoverage: measurementMetricValueSchema
 }).strict();
+var measurementPortfolioRankedPropertySchema = measurementDemoPropertySchema.extend({
+  ...measurementPortfolioPropertyContextShape,
+  mentionCoverage: measurementMetricValueSchema.options[0],
+  citationCoverage: measurementMetricValueSchema
+}).strict();
 var measurementPortfolioMentionRankingSchema = z18.object({
   eligiblePropertyCount: measurementDemoCountSchema,
-  strongest: z18.array(measurementDemoPropertySchema.extend({
-    mentionCoverage: measurementMetricValueSchema.options[0],
-    citationCoverage: measurementMetricValueSchema
-  }).strict()).max(50),
-  weakest: z18.array(measurementDemoPropertySchema.extend({
-    mentionCoverage: measurementMetricValueSchema.options[0],
-    citationCoverage: measurementMetricValueSchema
-  }).strict()).max(50),
+  strongest: z18.array(measurementPortfolioRankedPropertySchema).max(50),
+  weakest: z18.array(measurementPortfolioRankedPropertySchema).max(50),
   /** All excluded Properties in this scope, independent of the ranked list limit. */
   excluded: z18.array(measurementDemoPropertySchema.extend({
     reason: measurementMetricUnavailableReasonSchema
@@ -7217,23 +7311,37 @@ var measurementPortfolioSummaryResponseSchema = z18.object({
   }).strict(),
   measurement: measurementDemoRunMetadataSchema,
   queryClass: measurementQueryClassFilterSchema,
+  /** Engines behind the displayed answers, after any provider filter. Empty before a run completes. */
+  engines: z18.array(providerNameSchema),
   metrics: z18.object({
     propertiesMentioned: measurementMetricValueSchema,
     mentionCoverage: measurementMetricValueSchema,
     citationCoverage: measurementMetricValueSchema
   }).strict(),
   weakestProperties: z18.array(measurementPortfolioWeakestPropertySchema),
+  /** Set when two or more Properties share the weakest row's rates; null otherwise. */
+  tiedAtWeakest: measurementPortfolioWeakestTieSchema.nullable(),
+  /** Null before a run completes. */
+  weakestAnswerSources: measurementPortfolioAnswerSourcesSchema.nullable(),
   /** Descriptive mention ranking, using the response queryClass and scope; aggregate unavailability does not invalidate it. */
   mentionRanking: measurementPortfolioMentionRankingSchema,
   /**
-   * Every named market, worst-first. Empty when the request already narrowed to
-   * one group (a roll-up would only restate the scope) and when the plan defines
-   * no groups. Additive field.
+   * Markets worst-first. By default one level: the top-level markets, or the
+   * selected group's direct children when `groupKey` is set (empty when it has
+   * none), capped at `limit`. `includeNestedMarkets` returns every market in
+   * scope at every level, uncapped. Empty when the plan defines no groups.
    */
   markets: z18.array(measurementPortfolioMarketSchema),
+  /** Markets at the returned level before `limit`; more than returned means the list was cut. */
+  totalMarkets: measurementDemoCountSchema,
+  marketsTruncated: z18.boolean(),
   totalProperties: measurementDemoCountSchema,
   truncated: z18.boolean()
-}).strict();
+}).strict().superRefine((response, ctx) => {
+  if (response.marketsTruncated !== response.markets.length < response.totalMarkets) {
+    ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["marketsTruncated"], message: "Market truncation must agree with the market total" });
+  }
+});
 var measurementPropertyQuestionsQuerySchema = z18.object({
   targetKey: measurementV2StableKeySchema,
   runId: measurementDemoFilterQueryShape.runId,
@@ -13055,6 +13163,12 @@ var sourceRankEntrySchema = z40.object({
   count: z40.number().int(),
   /** Share of the list's `totalCitedSlots`, 0..1 (4dp). */
   percentage: z40.number(),
+  /**
+   * Share of the list's `answerTotal` (every answer in scope, including answers
+   * that cited nothing) that cite this domain, 0..1 (4dp). Optional only so an
+   * older server's response still parses.
+   */
+  answerShare: z40.number().optional(),
   category: sourceCategorySchema,
   label: z40.string(),
   surfaceClass: surfaceClassSchema
@@ -13068,8 +13182,12 @@ var surfaceClassCountSchema = z40.object({
   domainCount: z40.number().int()
 });
 var rankedSourceListSchema = z40.object({
-  /** Total cited slots (grounding citations) counted in this scope. */
+  /** Total cited slots in this scope: one per (answer, cited domain) pair. */
   totalCitedSlots: z40.number().int(),
+  /** Answers in this scope, including answers that cited nothing. Denominator of `answerShare`. */
+  answerTotal: z40.number().int().optional(),
+  /** Answers in this scope whose stored source list names at least one domain. */
+  answersWithSources: z40.number().int().optional(),
   /** Distinct domains in this scope. */
   domainTotal: z40.number().int(),
   /** Ranked domains, desc by count; truncated to the applied limit if any. */
@@ -13081,17 +13199,57 @@ var rankedSourceListSchema = z40.object({
   /** Surface-class roll-up over the FULL scope (not just `entries`). */
   bySurfaceClass: z40.array(surfaceClassCountSchema)
 });
+var sourceBreakdownQueryClassBasisSchema = z40.enum(["measurement-plan", "query-text"]);
+var sourceBreakdownQuerySchema = z40.object({
+  /** One stored answer-visibility run. Omit to pool every run in the window. */
+  runId: z40.string().trim().min(1).optional(),
+  /**
+   * Branded or non-brand answers only. With an active v2 measurement plan the
+   * class comes from each run's frozen plan assignments; otherwise from the
+   * project's brand-name classifier over the query text. `all` (the default)
+   * pools both classes.
+   */
+  queryClass: queryClassFilterSchema.optional(),
+  /** `false` omits the per-query breakdown (`byQuery`), which is large. Defaults to `true`. */
+  includeByQuery: z40.enum(["true", "false", "1", "0"]).optional()
+});
 var sourceBreakdownDtoSchema = z40.object({
-  overall: z40.array(sourceCategoryCountSchema),
-  byQuery: z40.record(z40.string(), z40.array(sourceCategoryCountSchema)),
   /** Full ranked + classified cited-domain list across all providers (#675). */
   ranked: rankedSourceListSchema,
   /** Per-provider ranked + classified breakdown, keyed by provider name (#675). */
   byProvider: z40.record(z40.string(), rankedSourceListSchema),
+  /**
+   * Providers that answered in scope but whose answers name no resolvable
+   * source. They are absent from `byProvider`; listed here so their absence is
+   * never read as missing data.
+   */
+  providersWithoutSources: z40.array(z40.string()).optional(),
+  /** Answers in scope after every filter, across all providers. */
+  answerTotal: z40.number().int().optional(),
+  /** Runs pooled into this response. More than one means several sweeps are pooled. */
+  runCount: z40.number().int().optional(),
+  /**
+   * Answers the `queryClass` filter could not place in either class (a run with
+   * no frozen v2 plan, an answer with no plan execution, or no query text).
+   * They are excluded from every count. Zero when no class filter is applied.
+   */
+  unclassifiedAnswers: z40.number().int().optional(),
+  /** Echo of the applied filters. */
+  filters: z40.object({
+    runId: z40.string().nullable(),
+    queryClass: queryClassFilterSchema,
+    /** Null when `queryClass` is `all` and no classification was applied. */
+    queryClassBasis: z40.union([sourceBreakdownQueryClassBasisSchema, z40.null()]),
+    includeByQuery: z40.boolean()
+  }).optional(),
   runId: z40.string(),
   window: metricsWindowSchema,
   /** Applied ranked-list limit; null when the full list is returned. */
-  limit: z40.number().int().nullable()
+  limit: z40.number().int().nullable(),
+  /** Legacy category breakdown (top 5 domains per category). */
+  overall: z40.array(sourceCategoryCountSchema),
+  /** Per-query category breakdown keyed by current query text. Omitted with `includeByQuery=false`. */
+  byQuery: z40.record(z40.string(), z40.array(sourceCategoryCountSchema)).optional()
 });
 var competitorLandscapeSurfaceClassSchema = z40.enum([
   "own",
@@ -13172,10 +13330,14 @@ var competitorLandscapeEvidenceSchema = z40.object({
   excludedNonCompletedResults: z40.number().int().nonnegative()
 }).strict();
 var COMPETITOR_LANDSCAPE_MODEL_GROUP_LIMIT = 50;
+var COMPETITOR_LANDSCAPE_OBSERVED_NAME_LIMIT = 50;
 var competitorLandscapeModelGroupSchema = z40.object({
   ...shareOfVoiceContextFields,
   comparison: z40.array(z40.object({ domain: z40.string(), mentions: z40.number().int().nonnegative() })).optional(),
+  /** Names written in the answer text (not cited sources), top `COMPETITOR_LANDSCAPE_OBSERVED_NAME_LIMIT` by answer count. */
   observedNames: z40.array(z40.object({ name: z40.string(), answerCount: z40.number().int().nonnegative() })).optional(),
+  /** Distinct observed names before the cap. Greater than `observedNames.length` when the list was cut. */
+  observedNamesTotal: z40.number().int().nonnegative().optional(),
   provider: z40.string().trim().min(1),
   /** Null preserves historical observations with unknown requested model identity. */
   model: modelIdSchema.nullable(),
@@ -13200,7 +13362,10 @@ var competitorLandscapeModelComparisonSchema = z40.object({
 var competitorLandscapeResponseSchema = z40.object({
   ...shareOfVoiceContextFields,
   comparison: z40.array(z40.object({ domain: z40.string(), mentions: z40.number().int().nonnegative() })).optional(),
+  /** Names written in the answer text (not cited sources), top `COMPETITOR_LANDSCAPE_OBSERVED_NAME_LIMIT` by answer count. */
   observedNames: z40.array(z40.object({ name: z40.string(), answerCount: z40.number().int().nonnegative() })).optional(),
+  /** Distinct observed names before the cap. Greater than `observedNames.length` when the list was cut. */
+  observedNamesTotal: z40.number().int().nonnegative().optional(),
   window: metricsWindowSchema,
   scope: competitorLandscapeScopeSchema,
   project: competitorLandscapeRowSchema,
@@ -19477,6 +19642,7 @@ export {
   effectiveBrandNames,
   projectConfigSchema,
   resolveConfigSpecQueries,
+  queryClassFilterSchema,
   compileQueryClassifier,
   MEASUREMENT_PLAN_V2_SCHEMA_VERSION,
   measurementV2UsageEdgeKey,
@@ -19550,6 +19716,10 @@ export {
   buildMeasurementRunManifestV1,
   measurementReportResponseSchema,
   measurementPropertyEvidenceResponseSchema,
+  MEASUREMENT_PORTFOLIO_DEFAULT_LIMIT,
+  MEASUREMENT_PORTFOLIO_ROW_EVIDENCE_LIMIT,
+  MEASUREMENT_PORTFOLIO_ANSWER_SOURCES_LIMIT,
+  MEASUREMENT_PORTFOLIO_TIE_NOTE,
   measurementPortfolioSummaryQuerySchema,
   measurementPortfolioSummaryResponseSchema,
   measurementPropertyQuestionsQuerySchema,
@@ -19912,9 +20082,11 @@ export {
   normalizeModelId,
   modelIdsEquivalent,
   brandMetricsDtoSchema,
+  sourceBreakdownQuerySchema,
   sourceBreakdownDtoSchema,
   competitorLandscapeQuerySchema,
   COMPETITOR_LANDSCAPE_MODEL_GROUP_LIMIT,
+  COMPETITOR_LANDSCAPE_OBSERVED_NAME_LIMIT,
   competitorLandscapeResponseSchema,
   parseWindow,
   windowCutoff,

package/dist/cli.js

@@ -35,11 +35,11 @@ import {
   trackCliCommandFinished,
   trackEvent,
   waitForServerRuntimeStartup
-} from "./chunk-GUJY3RIM.js";
+} from "./chunk-EJZFTNZG.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-ABUO27BV.js";
+} from "./chunk-J3JXJIST.js";
 import {
   configExists,
   createApiClient,
@@ -56,13 +56,13 @@ import {
   saveConfig,
   saveConfigPatch,
   shouldPrintServeSkillsNudge
-} from "./chunk-SPCEXW3B.js";
+} from "./chunk-EJXDABGU.js";
 import {
   DEFAULT_DEMO_TRUSTED_PROXIES,
   trustedProxiesProblem,
   trustedProxyProblem
 } from "./chunk-RB2F4D3Z.js";
-import "./chunk-QJWIOCEO.js";
+import "./chunk-PGOID3LE.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -74,7 +74,7 @@ import {
   runMeasurementDraftAction,
   systemError,
   usageError
-} from "./chunk-YHKKCXGY.js";
+} from "./chunk-4WROKFN6.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -89,7 +89,7 @@ import {
   queries,
   renderReportHtml,
   runs
-} from "./chunk-P2EFPLIO.js";
+} from "./chunk-3IAIW5KH.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -165,6 +165,7 @@ import {
   normalizeProjectAliases,
   normalizeTelemetryStatus,
   notificationEventSchema,
+  queryClassFilterSchema,
   queryTrackingCommitRequestSchema,
   queryTrackingPreviewRequestSchema,
   reportUnattributedAnswers,
@@ -176,7 +177,7 @@ import {
   snapshotProviderModeSchema,
   visibilityReportRequestSchema,
   winnabilityClassSchema
-} from "./chunk-WLL7Q7JD.js";
+} from "./chunk-SOCYTKTF.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -441,7 +442,7 @@ function parseDemoTrustedProxies(values) {
 async function demoCommand(options) {
   const { host, port } = parseDemoListenOptions(options);
   const trustProxy = parseDemoTrustedProxies(options.trustProxy);
-  const { createDemoServer } = await import("./demo-server-BOIBS74F.js");
+  const { createDemoServer } = await import("./demo-server-BLDYKCFS.js");
   const app = await createDemoServer({ trustProxy });
   let stopping = false;
   const stop = () => {
@@ -7808,7 +7809,8 @@ function printCompetitorLandscape(data) {
     `Evidence: ${data.evidence.answeredResults} answer-text result(s), ${data.evidence.sourceResults} source result(s); excluded: ${data.evidence.excludedProbeResults} probe, ${data.evidence.excludedNonCompletedResults} non-completed.`
   );
   if (data.observedNames?.length) {
-    console.log("Names observed in answers (not a comparison set):");
+    const total = data.observedNamesTotal ?? data.observedNames.length;
+    console.log(total > data.observedNames.length ? `Names observed in answers (not a comparison set), top ${data.observedNames.length} of ${total}:` : "Names observed in answers (not a comparison set):");
     for (const row of data.observedNames) console.log(`  ${row.name} \xB7 ${row.answerCount} answers`);
   }
   if (data.modelComparison) printModelComparison(data.modelComparison, data.filters.queryClass);
@@ -11435,16 +11437,46 @@ Source Origin Breakdown`);
 function getClient18() {
   return createApiClient();
 }
+var SOURCES_USAGE = "canonry sources <project> [--rank] [--limit N] [--by-provider] [--window 7d|30d|90d|all] [--query-class all|branded|non-brand] [--run-id <id>] [--include-by-query true|false] [--format json|jsonl]";
+function parseSourcesQueryClass(value) {
+  if (value === void 0) return void 0;
+  const parsed = queryClassFilterSchema.safeParse(value);
+  if (parsed.success) return parsed.data;
+  const message = `--query-class must be one of ${queryClassFilterSchema.options.join(", ")}`;
+  throw usageError(`Error: ${message}
+Usage: ${SOURCES_USAGE}`, {
+    message,
+    details: { command: "sources", usage: SOURCES_USAGE, option: "query-class", value }
+  });
+}
+function parseSourcesIncludeByQuery(value) {
+  if (value === void 0) return void 0;
+  if (value === "true") return true;
+  if (value === "false") return false;
+  const message = "--include-by-query must be true or false";
+  throw usageError(`Error: ${message}
+Usage: ${SOURCES_USAGE}`, {
+    message,
+    details: { command: "sources", usage: SOURCES_USAGE, option: "include-by-query", value }
+  });
+}
 var pct = (n) => `${(n * 100).toFixed(1)}%`;
 async function showSources(project, options) {
   if (options.limit !== void 0 && (!Number.isInteger(options.limit) || options.limit <= 0)) {
-    throw usageError("Error: --limit must be a positive integer\nUsage: canonry sources <project> [--rank] [--limit N] [--by-provider] [--window 7d|30d|90d|all] [--format json|jsonl]", {
+    throw usageError(`Error: --limit must be a positive integer
+Usage: ${SOURCES_USAGE}`, {
       message: "--limit must be a positive integer",
       details: { command: "sources", option: "limit", value: options.limit }
     });
   }
   const client = getClient18();
-  const data = await client.getAnalyticsSources(project, { window: options.window, limit: options.limit });
+  const data = await client.getAnalyticsSources(project, {
+    window: options.window,
+    limit: options.limit,
+    ...options.runId === void 0 ? {} : { runId: options.runId },
+    ...options.queryClass === void 0 ? {} : { queryClass: options.queryClass },
+    ...options.includeByQuery === void 0 ? {} : { includeByQuery: options.includeByQuery }
+  });
   if (options.format === "jsonl") {
     emitJsonl(data.ranked.entries.map((e) => ({ project, ...e })));
     return;
@@ -11459,6 +11491,8 @@ function printSourceRankings(data, options) {
   console.log(`
 Source Rankings (${data.window})`);
   console.log("\u2500".repeat(50));
+  const scope = describeScope(data);
+  if (scope) console.log(`  ${scope}`);
   if (data.ranked.totalCitedSlots === 0) {
     console.log("  No source data available");
     return;
@@ -11476,8 +11510,25 @@ Source Rankings (${data.window})`);
     ${provider} (${list.totalCitedSlots} cited slots):`);
       printRankedEntries(list, "    ");
     }
+    for (const provider of data.providersWithoutSources ?? []) {
+      console.log(`
+    ${provider}: answered, but no answer named a source`);
+    }
   }
 }
+function describeScope(data) {
+  const parts = [];
+  if (data.answerTotal !== void 0) parts.push(`${data.answerTotal} answers`);
+  if (data.filters?.runId) parts.push(`run ${data.filters.runId}`);
+  else if (data.runCount !== void 0) parts.push(`${data.runCount} ${data.runCount === 1 ? "run" : "runs"} pooled`);
+  if (data.filters) {
+    parts.push(data.filters.queryClass === "all" ? "branded and non-brand pooled" : `${data.filters.queryClass} queries only`);
+  }
+  if (data.unclassifiedAnswers) {
+    parts.push(`${data.unclassifiedAnswers} unclassified ${data.unclassifiedAnswers === 1 ? "answer" : "answers"} excluded`);
+  }
+  return parts.length > 0 ? parts.join(" \xB7 ") : null;
+}
 function printSurfaceClasses(list) {
   for (const c of list.bySurfaceClass) {
     const noun = c.domainCount === 1 ? "domain" : "domains";
@@ -11840,25 +11891,30 @@ var OPERATOR_CLI_COMMANDS = [
   },
   {
     path: ["sources"],
-    usage: "canonry sources <project> [--rank] [--limit N] [--by-provider] [--window 7d|30d|90d|all] [--format json|jsonl]",
+    usage: SOURCES_USAGE,
     options: {
       rank: { type: "boolean", default: false },
       "by-provider": { type: "boolean", default: false },
       limit: stringOption(),
-      window: stringOption()
+      window: stringOption(),
+      "query-class": stringOption(),
+      "run-id": stringOption(),
+      "include-by-query": stringOption()
     },
     run: async (input) => {
-      const usage = "canonry sources <project> [--rank] [--limit N] [--by-provider] [--window 7d|30d|90d|all] [--format json|jsonl]";
-      const project = requireProject(input, "sources", usage);
+      const project = requireProject(input, "sources", SOURCES_USAGE);
       await showSources(project, {
         rank: getBoolean(input.values, "rank"),
         byProvider: getBoolean(input.values, "by-provider"),
         limit: parseIntegerOption(input, "limit", {
           message: "--limit must be an integer",
-          usage,
+          usage: SOURCES_USAGE,
           command: "sources"
         }),
         window: getString(input.values, "window"),
+        runId: getString(input.values, "run-id"),
+        queryClass: parseSourcesQueryClass(getString(input.values, "query-class")),
+        includeByQuery: parseSourcesIncludeByQuery(getString(input.values, "include-by-query")),
         format: input.format
       });
     }

package/dist/{demo-server-BOIBS74F.js → demo-server-BLDYKCFS.js}

@@ -4,11 +4,11 @@ import {
 import {
   layoutSiteCrawlGraphInput,
   persistSiteCrawlGraphLayout
-} from "./chunk-QJWIOCEO.js";
+} from "./chunk-PGOID3LE.js";
 import {
   PACKAGE_VERSION,
   canonryMcpTools
-} from "./chunk-YHKKCXGY.js";
+} from "./chunk-4WROKFN6.js";
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService,
@@ -84,7 +84,7 @@ import {
   siteCrawlPages,
   siteCrawlSnapshots,
   trafficSources
-} from "./chunk-P2EFPLIO.js";
+} from "./chunk-3IAIW5KH.js";
 import {
   RunKinds,
   SiteCrawlFetchStates,
@@ -108,7 +108,7 @@ import {
   placementLinkDecision,
   siteAuditPageFactorSchema,
   wilsonInterval
-} from "./chunk-WLL7Q7JD.js";
+} from "./chunk-SOCYTKTF.js";
 
 // src/demo-server.ts
 import { dirname, join as join2 } from "path";

package/dist/index.js

@@ -3,14 +3,14 @@ import {
   createGoogleMarketingCredentialStore,
   createGoogleMarketingRuntime,
   createServer
-} from "./chunk-GUJY3RIM.js";
+} from "./chunk-EJZFTNZG.js";
 import {
   loadConfig
-} from "./chunk-SPCEXW3B.js";
-import "./chunk-QJWIOCEO.js";
-import "./chunk-YHKKCXGY.js";
-import "./chunk-P2EFPLIO.js";
-import "./chunk-WLL7Q7JD.js";
+} from "./chunk-EJXDABGU.js";
+import "./chunk-PGOID3LE.js";
+import "./chunk-4WROKFN6.js";
+import "./chunk-3IAIW5KH.js";
+import "./chunk-SOCYTKTF.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

package/dist/{intelligence-service-IWR2H6OW.js → intelligence-service-3MHYLKMS.js}

@@ -1,8 +1,8 @@
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService
-} from "./chunk-P2EFPLIO.js";
-import "./chunk-WLL7Q7JD.js";
+} from "./chunk-3IAIW5KH.js";
+import "./chunk-SOCYTKTF.js";
 export {
   HISTORY_WINDOW_RUNS,
   IntelligenceService

package/dist/mcp.js

@@ -1,15 +1,15 @@
 import {
   autoSyncSkills
-} from "./chunk-ABUO27BV.js";
+} from "./chunk-J3JXJIST.js";
 import {
   createApiClient,
   createCanonryMcpServer
-} from "./chunk-SPCEXW3B.js";
-import "./chunk-YHKKCXGY.js";
+} from "./chunk-EJXDABGU.js";
+import "./chunk-4WROKFN6.js";
 import {
   isReadOnlyKey,
   updateCheckEnvOptOut
-} from "./chunk-WLL7Q7JD.js";
+} from "./chunk-SOCYTKTF.js";
 
 // src/mcp/cli.ts
 import { randomUUID } from "crypto";