@ainyc/canonry 4.102.1 → 4.103.0

package/assets/assets/{trash-2-UvZu9cfJ.js → trash-2-BARaYs9Y.js}

@@ -1 +1 @@
-import{c}from"./index-sh-T-1TA.js";const a=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],h=c("circle-check",a);const e=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3",key:"1u773s"}],["path",{d:"M12 17h.01",key:"p32p05"}]],n=c("circle-question-mark",e);const o=[["path",{d:"M12 15V3",key:"m9g1x1"}],["path",{d:"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4",key:"ih7n3h"}],["path",{d:"m7 10 5 5 5-5",key:"brsn70"}]],s=c("download",o);const t=[["path",{d:"M10 11v6",key:"nco0om"}],["path",{d:"M14 11v6",key:"outv1u"}],["path",{d:"M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6",key:"miytrc"}],["path",{d:"M3 6h18",key:"d0wm0j"}],["path",{d:"M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2",key:"e791ji"}]],r=c("trash-2",t);export{h as C,s as D,r as T,n as a};
+import{c}from"./index-CY4Xe0F8.js";const a=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],h=c("circle-check",a);const e=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3",key:"1u773s"}],["path",{d:"M12 17h.01",key:"p32p05"}]],n=c("circle-question-mark",e);const o=[["path",{d:"M12 15V3",key:"m9g1x1"}],["path",{d:"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4",key:"ih7n3h"}],["path",{d:"m7 10 5 5 5-5",key:"brsn70"}]],s=c("download",o);const t=[["path",{d:"M10 11v6",key:"nco0om"}],["path",{d:"M14 11v6",key:"outv1u"}],["path",{d:"M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6",key:"miytrc"}],["path",{d:"M3 6h18",key:"d0wm0j"}],["path",{d:"M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2",key:"e791ji"}]],r=c("trash-2",t);export{h as C,s as D,r as T,n as a};

package/assets/index.html

@@ -12,7 +12,7 @@
     <link rel="icon" type="image/png" sizes="32x32" href="./favicon-32.png" />
     <link rel="apple-touch-icon" href="./apple-touch-icon.png" />
     <title>Canonry</title>
-    <script type="module" crossorigin src="./assets/index-sh-T-1TA.js"></script>
+    <script type="module" crossorigin src="./assets/index-CY4Xe0F8.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/vendor-tanstack-Be8JdV5M.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-radix-CQ77EO2y.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-recharts-C9EZkgbP.js">

package/dist/{chunk-2FUODJQR.js → chunk-23DCY7DL.js}

@@ -24,7 +24,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-EOQXB63S.js";
+} from "./chunk-Q7FFDQU4.js";
 
 // src/config.ts
 import fs from "fs";
@@ -5163,7 +5163,9 @@ var ApiClient = class {
           since: opts.since,
           until: opts.until,
           lastRuns: opts.lastRuns,
-          groupBy: opts.groupBy
+          groupBy: opts.groupBy,
+          month: opts.month,
+          shareOfVoice: opts.shareOfVoice ? "1" : void 0
         }
       })
     );
@@ -5886,15 +5888,17 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_visibility_stats",
     title: "Get aggregated mention/citation stats",
-    description: 'Per-query mention (answer-text) and citation (source-list) counts WITH a sample size, pooled across many answer-visibility runs (probe-excluded) \u2014 the data to compute a confidence-aware (Wilson) proportion or detect drift without fetching every run. Tri-state aware: `checked` (the n for the mention proportion) counts only snapshots where answerMentioned was recorded; `null` ("not checked") is excluded, never counted as not-mentioned. Returns per-query `total`/`checked`/`mentioned`/`cited` + derived `mentionRate` (mentioned/checked) and `citedRate` (cited/total), `firstObserved`/`lastObserved`, and pooled `totals`. Window with `since`/`until` (ISO) OR `lastRuns` (mutually exclusive); with none set, EVERY completed/partial run is pooled (`window.runCount` says how many) \u2014 pass `lastRuns` for a recent sample. Set `groupBy=provider` for a per-provider breakdown whose counts sum to the pooled counts (`groupBy` is omitted from the response otherwise).',
+    description: 'Per-query mention (answer-text) and citation (source-list) counts WITH a sample size, pooled across many answer-visibility runs (probe-excluded) \u2014 the data to compute a confidence-aware (Wilson) proportion or detect drift without fetching every run. Tri-state aware: `checked` (the n for the mention proportion) counts only snapshots where answerMentioned was recorded; `null` ("not checked") is excluded, never counted as not-mentioned. Returns per-query `total`/`checked`/`mentioned`/`cited` + derived `mentionRate` (mentioned/checked) and `citedRate` (cited/total), `firstObserved`/`lastObserved`, and pooled `totals`. Window with `since`/`until` (ISO), `lastRuns`, or `month=YYYY-MM` (mutually exclusive); with none set, EVERY completed/partial run is pooled (`window.runCount` says how many) \u2014 pass `lastRuns` for a recent sample. Set `groupBy=provider` for a per-provider breakdown whose counts sum to the pooled counts (`groupBy` is omitted from the response otherwise). Set `shareOfVoice=true` for pooled project-vs-tracked-competitor brand-mention share across the same attributed snapshot set.',
     access: "read",
     tier: "monitoring",
     inputSchema: z2.object({
       project: projectNameSchema,
-      since: z2.string().optional().describe("Inclusive lower bound on run createdAt (ISO 8601). A date-only value (YYYY-MM-DD) is the start of that UTC day. Mutually exclusive with lastRuns."),
-      until: z2.string().optional().describe("Inclusive upper bound on run createdAt (ISO 8601). A date-only value (YYYY-MM-DD) covers the whole UTC day (through 23:59:59.999). Mutually exclusive with lastRuns."),
-      lastRuns: z2.number().int().positive().optional().describe("Aggregate only the most recent N answer-visibility runs. Mutually exclusive with since/until."),
-      groupBy: z2.enum(["provider"]).optional().describe('Set to "provider" for a per-provider breakdown.')
+      since: z2.string().optional().describe("Inclusive lower bound on run createdAt (ISO 8601). A date-only value (YYYY-MM-DD) is the start of that UTC day. Mutually exclusive with lastRuns/month."),
+      until: z2.string().optional().describe("Inclusive upper bound on run createdAt (ISO 8601). A date-only value (YYYY-MM-DD) covers the whole UTC day (through 23:59:59.999). Mutually exclusive with lastRuns/month."),
+      lastRuns: z2.number().int().positive().optional().describe("Aggregate only the most recent N answer-visibility runs. Mutually exclusive with since/until/month."),
+      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 pooled project-vs-tracked-competitor brand-mention share across the same window.")
     }),
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/visibility-stats"],
@@ -5902,7 +5906,9 @@ var canonryMcpTools = [
       since: input.since,
       until: input.until,
       lastRuns: input.lastRuns,
-      groupBy: input.groupBy
+      groupBy: input.groupBy,
+      month: input.month,
+      shareOfVoice: input.shareOfVoice
     })
   }),
   defineTool({

package/dist/{chunk-3PVCILSN.js → chunk-BTJY73GW.js}

@@ -10,7 +10,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-2FUODJQR.js";
+} from "./chunk-23DCY7DL.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -115,7 +115,7 @@ import {
   siteAuditPages,
   siteAuditSnapshots,
   usageCounters
-} from "./chunk-B2H2RRIT.js";
+} from "./chunk-GNMZTR6Y.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -176,7 +176,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-EOQXB63S.js";
+} from "./chunk-Q7FFDQU4.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -6438,7 +6438,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-RC4BY5HF.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-GM3RXE2F.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);

package/dist/{chunk-B2H2RRIT.js → chunk-GNMZTR6Y.js}

@@ -73,6 +73,7 @@ import {
   brandLabelFromDomain,
   brandMetricsDtoSchema,
   buildHarvestAnchorTerms,
+  calendarMonthBounds,
   categorizeSource,
   categorizeSourceWithCompetitors,
   categoryLabel,
@@ -263,7 +264,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-EOQXB63S.js";
+} from "./chunk-Q7FFDQU4.js";
 
 // src/intelligence-service.ts
 import { eq as eq38, desc as desc18, asc as asc6, and as and28, ne as ne5, or as or5, inArray as inArray14, gte as gte7, lte as lte4 } from "drizzle-orm";
@@ -13258,22 +13259,29 @@ function providerEntries(byProvider) {
     lastObserved: agg.last ?? ""
   })).sort((a, b) => a.provider.localeCompare(b.provider));
 }
+function buildQueryAttribution(projectQueries) {
+  const byId = /* @__PURE__ */ new Map();
+  const byText = /* @__PURE__ */ new Map();
+  for (const q of projectQueries) {
+    byId.set(q.id, q);
+    byText.set(q.query, q);
+  }
+  return { byId, byText };
+}
+function resolveCurrentQuery(attribution, snap) {
+  if (snap.queryId && attribution.byId.has(snap.queryId)) return attribution.byId.get(snap.queryId);
+  if (snap.queryText && attribution.byText.has(snap.queryText)) return attribution.byText.get(snap.queryText);
+  return void 0;
+}
 function computeVisibilityStats(input) {
   const { groupBy } = input;
   const wantProviders = groupBy === "provider";
-  const queryById = /* @__PURE__ */ new Map();
-  const queryByText = /* @__PURE__ */ new Map();
-  for (const q of input.queries) {
-    queryById.set(q.id, q);
-    queryByText.set(q.query, q);
-  }
+  const attribution = buildQueryAttribution(input.queries);
   const byQuery = /* @__PURE__ */ new Map();
   const totals = emptyAgg();
   const totalsByProvider = /* @__PURE__ */ new Map();
   for (const snap of input.snapshots) {
-    let resolved;
-    if (snap.queryId && queryById.has(snap.queryId)) resolved = queryById.get(snap.queryId);
-    else if (snap.queryText && queryByText.has(snap.queryText)) resolved = queryByText.get(snap.queryText);
+    const resolved = resolveCurrentQuery(attribution, snap);
     if (!resolved) continue;
     let bucket = byQuery.get(resolved.id);
     if (!bucket) {
@@ -13308,7 +13316,14 @@ function computeVisibilityStats(input) {
 async function visibilityStatsRoutes(app) {
   app.get("/projects/:name/visibility-stats", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
-    const { since: sinceRaw, until: untilRaw, lastRuns: lastRunsRaw, groupBy: groupByRaw } = request.query;
+    const {
+      since: sinceRaw,
+      until: untilRaw,
+      lastRuns: lastRunsRaw,
+      groupBy: groupByRaw,
+      month: monthRaw,
+      shareOfVoice: shareOfVoiceRaw
+    } = request.query;
     let groupBy = null;
     if (groupByRaw !== void 0 && groupByRaw !== "") {
       if (groupByRaw !== "provider") throw validationError('"groupBy" must be "provider"');
@@ -13317,11 +13332,17 @@ async function visibilityStatsRoutes(app) {
     const hasSince = sinceRaw !== void 0 && sinceRaw !== "";
     const hasUntil = untilRaw !== void 0 && untilRaw !== "";
     const hasLastRuns = lastRunsRaw !== void 0 && lastRunsRaw !== "";
+    const hasMonth = monthRaw !== void 0 && monthRaw !== "";
+    const wantShareOfVoice = shareOfVoiceRaw === "1" || shareOfVoiceRaw === "true";
     if (hasLastRuns && (hasSince || hasUntil)) {
       throw validationError('"lastRuns" cannot be combined with "since"/"until" \u2014 use one or the other');
     }
+    if (hasMonth && (hasSince || hasUntil || hasLastRuns)) {
+      throw validationError('"month" cannot be combined with "since"/"until"/"lastRuns" \u2014 use one or the other');
+    }
     let sinceMs = null;
     let untilMs = null;
+    let resolvedMonthWindow = null;
     if (hasSince) {
       const ms = Date.parse(sinceRaw);
       if (Number.isNaN(ms)) throw validationError('"since" must be an ISO 8601 date/time');
@@ -13332,6 +13353,17 @@ async function visibilityStatsRoutes(app) {
       if (ms === null) throw validationError('"until" must be an ISO 8601 date/time');
       untilMs = ms;
     }
+    if (hasMonth) {
+      let bounds;
+      try {
+        bounds = calendarMonthBounds(monthRaw);
+      } catch (err) {
+        throw validationError(err instanceof RangeError ? err.message : '"month" must be in YYYY-MM format');
+      }
+      sinceMs = Date.parse(bounds.since);
+      untilMs = Date.parse(bounds.until);
+      resolvedMonthWindow = bounds;
+    }
     if (sinceMs !== null && untilMs !== null && untilMs < sinceMs) {
       throw validationError('"until" must be on or after "since"');
     }
@@ -13357,11 +13389,44 @@ async function visibilityStatsRoutes(app) {
       createdAt: querySnapshots.createdAt
     }).from(querySnapshots).where(inArray8(querySnapshots.runId, runIds)).all() : [];
     const stats = computeVisibilityStats({ queries: projectQueries, snapshots, groupBy });
+    const queryAttribution = buildQueryAttribution(projectQueries);
+    let shareOfVoice;
+    if (wantShareOfVoice) {
+      const competitorRows = app.db.select({ domain: competitors.domain }).from(competitors).where(eq17(competitors.projectId, project.id)).all();
+      const mentionShareCompetitors = competitorRows.map((c) => ({
+        domain: c.domain,
+        brandTokens: [brandLabelFromDomain(c.domain)].filter((t) => t.length >= 3)
+      }));
+      const sovSnapshots = runIds.length > 0 ? app.db.select({
+        queryId: querySnapshots.queryId,
+        queryText: querySnapshots.queryText,
+        answerMentioned: querySnapshots.answerMentioned,
+        answerText: querySnapshots.answerText
+      }).from(querySnapshots).where(inArray8(querySnapshots.runId, runIds)).all() : [];
+      const attributedSovSnapshots = sovSnapshots.filter((s) => resolveCurrentQuery(queryAttribution, s) !== void 0);
+      const result = buildMentionShare(
+        attributedSovSnapshots.map((s) => ({ projectMentioned: s.answerMentioned === true, answerText: s.answerText })),
+        { competitors: mentionShareCompetitors }
+      );
+      const b = result.breakdown;
+      const denom = b.projectMentionSnapshots + b.competitorMentionSnapshots;
+      shareOfVoice = {
+        // `null` (not 0) when there is no competitive frame configured — a 0 here
+        // would read as "losing" when the head-to-head metric is simply undefined.
+        percent: competitorRows.length === 0 ? null : denom > 0 ? Math.round(b.projectMentionSnapshots / denom * 100) : 0,
+        projectMentions: b.projectMentionSnapshots,
+        competitorMentions: b.competitorMentionSnapshots,
+        snapshotsWithAnswerText: b.snapshotsWithAnswerText,
+        perCompetitor: b.perCompetitor.map((c) => ({ domain: c.domain, mentions: c.mentionSnapshots }))
+      };
+    }
     const response = {
       project: project.name,
       window: {
-        since: hasSince ? sinceRaw : null,
-        until: hasUntil ? untilRaw : null,
+        // A `month` request echoes the resolved inclusive bounds it expanded to,
+        // so the window is self-documenting regardless of which input was used.
+        since: resolvedMonthWindow ? resolvedMonthWindow.since : hasSince ? sinceRaw : null,
+        until: resolvedMonthWindow ? resolvedMonthWindow.until : hasUntil ? untilRaw : null,
         lastRuns,
         runCount
       },
@@ -13371,7 +13436,8 @@ async function visibilityStatsRoutes(app) {
       // requested; both are OMITTED otherwise (absent = no breakdown) so the
       // SDK types `groupBy` as `groupBy?: 'provider'` rather than a misleading
       // always-present literal.
-      ...groupBy === "provider" ? { groupBy, byProvider: stats.byProvider ?? [] } : {}
+      ...groupBy === "provider" ? { groupBy, byProvider: stats.byProvider ?? [] } : {},
+      ...shareOfVoice ? { shareOfVoice } : {}
     };
     return reply.send(response);
   });
@@ -14436,6 +14502,18 @@ var groupByProviderQueryParameter = {
   description: 'Set to "provider" to include a per-provider breakdown whose counts sum to the pooled counts.',
   schema: { type: "string", enum: ["provider"] }
 };
+var monthQueryParameter = {
+  name: "month",
+  in: "query",
+  description: `Aggregate a single calendar month (YYYY-MM), expanded to that month's inclusive UTC bounds. Mutually exclusive with "since"/"until"/"lastRuns".`,
+  schema: stringSchema
+};
+var shareOfVoiceQueryParameter = {
+  name: "shareOfVoice",
+  in: "query",
+  description: 'Set to "1" to include pooled share of voice (project vs tracked-competitor brand mentions in answer text) across the window.',
+  schema: { type: "string", enum: ["1"] }
+};
 var wordpressEnvQueryParameter = {
   name: "env",
   in: "query",
@@ -15166,9 +15244,17 @@ 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 or since/until for a recent sample. Set groupBy=provider for a per-provider breakdown whose counts sum to the pooled counts.",
+    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 pooled share of voice vs tracked competitors.",
     tags: ["analytics"],
-    parameters: [nameParameter, sinceQueryParameter, untilQueryParameter, lastRunsQueryParameter, groupByProviderQueryParameter],
+    parameters: [
+      nameParameter,
+      sinceQueryParameter,
+      untilQueryParameter,
+      lastRunsQueryParameter,
+      groupByProviderQueryParameter,
+      monthQueryParameter,
+      shareOfVoiceQueryParameter
+    ],
     responses: {
       200: jsonResponse("Aggregated visibility stats returned.", "VisibilityStatsDto"),
       400: errorResponse("Invalid query parameters."),

package/dist/{chunk-EOQXB63S.js → chunk-Q7FFDQU4.js}

@@ -2686,6 +2686,23 @@ var visibilityStatsWindowSchema = z20.object({
   runCount: z20.number().int()
 });
 var visibilityStatsGroupBySchema = z20.enum(["provider"]);
+var visibilityStatsShareCompetitorSchema = z20.object({
+  domain: z20.string(),
+  /** Snapshots (with answer text) in the window where this competitor's brand appeared. */
+  mentions: z20.number().int()
+});
+var visibilityStatsShareOfVoiceSchema = z20.object({
+  /** `projectMentions / (projectMentions + competitorMentions)` as 0-100; `null` when no competitors configured. */
+  percent: z20.number().nullable(),
+  /** Snapshots (with answer text) where the project's brand appeared in the answer. */
+  projectMentions: z20.number().int(),
+  /** Snapshots (with answer text) where any tracked competitor's brand appeared. */
+  competitorMentions: z20.number().int(),
+  /** Snapshots that carried answer text — the universe the mentions were counted over. */
+  snapshotsWithAnswerText: z20.number().int(),
+  /** Per-competitor mention counts, descending; only competitors with ≥1 mention appear. */
+  perCompetitor: z20.array(visibilityStatsShareCompetitorSchema)
+});
 var visibilityStatsDtoSchema = z20.object({
   project: z20.string(),
   /**
@@ -2704,8 +2721,21 @@ var visibilityStatsDtoSchema = z20.object({
    */
   byProvider: z20.array(visibilityStatsProviderEntrySchema).optional(),
   /** Per-query stats, sorted by query text. Only queries with ≥1 snapshot in the window appear. */
-  queries: z20.array(visibilityStatsQueryEntrySchema)
-});
+  queries: z20.array(visibilityStatsQueryEntrySchema),
+  /** Pooled share of voice vs tracked competitors — present only when `shareOfVoice=1` was requested. */
+  shareOfVoice: visibilityStatsShareOfVoiceSchema.optional()
+});
+function calendarMonthBounds(month) {
+  const match = /^(\d{4})-(\d{2})$/.exec(month);
+  if (!match) throw new RangeError("month must be in YYYY-MM format");
+  const year = Number(match[1]);
+  const mon = Number(match[2]);
+  if (mon < 1 || mon > 12) throw new RangeError("month must be between 01 and 12");
+  return {
+    since: new Date(Date.UTC(year, mon - 1, 1)).toISOString(),
+    until: new Date(Date.UTC(year, mon, 1) - 1).toISOString()
+  };
+}
 
 // ../contracts/src/ga.ts
 import { z as z21 } from "zod";
@@ -5577,6 +5607,7 @@ export {
   parseWindow,
   windowCutoff,
   visibilityStatsDtoSchema,
+  calendarMonthBounds,
   ga4StatusDtoSchema,
   ga4SyncResponseDtoSchema,
   ga4AiReferralHistoryEntrySchema,

package/dist/cli.js

@@ -29,7 +29,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-3PVCILSN.js";
+} from "./chunk-BTJY73GW.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -46,7 +46,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-2FUODJQR.js";
+} from "./chunk-23DCY7DL.js";
 import {
   apiKeys,
   createClient,
@@ -54,7 +54,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-B2H2RRIT.js";
+} from "./chunk-GNMZTR6Y.js";
 import {
   BacklinkSources,
   CcReleaseSyncStatuses,
@@ -80,7 +80,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-EOQXB63S.js";
+} from "./chunk-Q7FFDQU4.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -11447,8 +11447,10 @@ async function showVisibilityStats(project, opts) {
   const data = await client.getVisibilityStats(project, {
     since: opts.since,
     until: opts.until,
+    month: opts.month,
     lastRuns: opts.lastRuns,
-    groupBy: opts.byProvider ? "provider" : void 0
+    groupBy: opts.byProvider ? "provider" : void 0,
+    shareOfVoice: opts.shareOfVoice
   });
   if (opts.format === "jsonl") {
     emitJsonl(data.queries.map((q) => ({ project: data.project, runCount: data.window.runCount, ...q })));
@@ -11539,10 +11541,21 @@ function printVisibilityStats(data) {
       );
     }
   }
+  const sov = data.shareOfVoice;
+  if (sov) {
+    console.log("");
+    const pctStr = sov.percent === null ? "\u2014 (no competitors configured)" : `${sov.percent}%`;
+    console.log(
+      `Share of voice: ${pctStr}  (you ${sov.projectMentions} vs competitors ${sov.competitorMentions} brand mentions across ${sov.snapshotsWithAnswerText} answers)`
+    );
+    for (const c of sov.perCompetitor.slice(0, 8)) {
+      console.log(`  ${c.domain}: ${c.mentions}`);
+    }
+  }
 }
 
 // src/cli-commands/visibility-stats.ts
-var USAGE4 = "canonry visibility-stats <project> [--since <iso>] [--until <iso>] [--last-runs <n>] [--by-provider] [--format json|jsonl]";
+var USAGE4 = "canonry visibility-stats <project> [--since <iso>] [--until <iso>] [--month <YYYY-MM>] [--last-runs <n>] [--by-provider] [--share-of-voice] [--format json|jsonl]";
 var VISIBILITY_STATS_CLI_COMMANDS = [
   {
     path: ["visibility-stats"],
@@ -11550,20 +11563,24 @@ var VISIBILITY_STATS_CLI_COMMANDS = [
     options: {
       since: stringOption(),
       until: stringOption(),
+      month: stringOption(),
       "last-runs": stringOption(),
-      "by-provider": { type: "boolean", default: false }
+      "by-provider": { type: "boolean", default: false },
+      "share-of-voice": { type: "boolean", default: false }
     },
     run: async (input) => {
       const project = requireProject(input, "visibility-stats", USAGE4);
       await showVisibilityStats(project, {
         since: getString(input.values, "since"),
         until: getString(input.values, "until"),
+        month: getString(input.values, "month"),
         lastRuns: parseIntegerOption(input, "last-runs", {
           command: "visibility-stats",
           usage: USAGE4,
           message: "--last-runs must be an integer"
         }),
         byProvider: getBoolean(input.values, "by-provider"),
+        shareOfVoice: getBoolean(input.values, "share-of-voice"),
         format: input.format
       });
     }

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-3PVCILSN.js";
+} from "./chunk-BTJY73GW.js";
 import {
   loadConfig
-} from "./chunk-2FUODJQR.js";
-import "./chunk-B2H2RRIT.js";
-import "./chunk-EOQXB63S.js";
+} from "./chunk-23DCY7DL.js";
+import "./chunk-GNMZTR6Y.js";
+import "./chunk-Q7FFDQU4.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-RC4BY5HF.js → intelligence-service-GM3RXE2F.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-B2H2RRIT.js";
-import "./chunk-EOQXB63S.js";
+} from "./chunk-GNMZTR6Y.js";
+import "./chunk-Q7FFDQU4.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-2FUODJQR.js";
+} from "./chunk-23DCY7DL.js";
 import {
   isReadOnlyKey
-} from "./chunk-EOQXB63S.js";
+} from "./chunk-Q7FFDQU4.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.102.1",
+  "version": "4.103.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -68,21 +68,21 @@
     "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-integration-openai-ads": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
-    "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "0.0.0",
+    "@ainyc/canonry-integration-google-business-profile": "0.0.0",
     "@ainyc/canonry-integration-google-places": "0.0.0",
-    "@ainyc/canonry-integration-openai-ads": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-integration-traffic": "0.0.0",
-    "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
+    "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0"
+    "@ainyc/canonry-integration-traffic": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0",
+    "@ainyc/canonry-provider-openai": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",