npm - @ainyc/canonry - Versions diffs - 4.102.0 → 4.103.0 - Mend

@ainyc/canonry 4.102.0 → 4.103.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (24) hide show

package/assets/assets/{trash-2-CLkUNdvb.js → trash-2-BARaYs9Y.js} RENAMED Viewed

	@@ -1 +1 @@
1	- import{c}from"./index-~~DSSLug80~~.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};
1	+ 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 CHANGED Viewed

@@ -12,12 +12,12 @@
     <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-DSSLug80.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">
     <link rel="modulepreload" crossorigin href="./assets/vendor-markdown-6dwjPOKK.js">
-    <link rel="stylesheet" crossorigin href="./assets/index-BCuWbxUj.css">
+    <link rel="stylesheet" crossorigin href="./assets/index-LsyRFLMG.css">
   </head>
   <body>
     <div id="root"></div>

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

@@ -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} RENAMED Viewed

@@ -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} RENAMED Viewed

@@ -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} RENAMED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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} RENAMED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.102.0",
+  "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",
@@ -63,26 +63,26 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-client": "0.0.0",
+    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
-    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-integration-openai-ads": "0.0.0",
     "@ainyc/canonry-integration-google": "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-traffic": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-api-routes": "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-cdp": "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",