@canonry/canonry 4.116.0 → 4.117.1

package/assets/assets/{trash-2-ap_Fa4zA.js → trash-2-3J2u0woR.js}

@@ -1 +1 @@
-import{c}from"./index-DxjY63VC.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-LjcWHaNZ.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-DxjY63VC.js"></script>
+    <script type="module" crossorigin src="./assets/index-LjcWHaNZ.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-RVH6QPTA.js → chunk-BMBHUFMI.js}

@@ -25,7 +25,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-IQPMK36Y.js";
+} from "./chunk-IAJ5TQ4S.js";
 
 // src/config.ts
 import fs from "fs";
@@ -1578,6 +1578,18 @@ var getApiV1ProjectsByNameVisibilityStats = (options) => {
     ...options
   });
 };
+var getApiV1ProjectsByNameVisibilityCompare = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/visibility-compare",
+    ...options
+  });
+};
 var getApiV1ProjectsByNameSnapshotsDiff = (options) => {
   return (options.client ?? client).get({
     security: [
@@ -3774,6 +3786,19 @@ var ApiClient = class {
 `
       );
     }
+    const contentType = result.response.headers.get("content-type");
+    if (result.response.ok && contentType?.toLowerCase().startsWith("text/html")) {
+      throw new CliError({
+        code: "UNEXPECTED_RESPONSE_FORMAT",
+        message: `Expected a JSON response from the canonry API at ${result.request.url}, but received ${contentType} (HTTP ${result.response.status}). Check the server URL and base path.`,
+        exitCode: EXIT_SYSTEM_ERROR,
+        details: {
+          requestUrl: result.request.url,
+          contentType,
+          httpStatus: result.response.status
+        }
+      });
+    }
     if (result.error !== void 0 && result.error !== null) {
       const errorObj = typeof result.error === "object" && result.error !== null && "error" in result.error && typeof result.error.error === "object" && result.error.error !== null ? result.error.error : null;
       const msg = errorObj?.message ? String(errorObj.message) : `HTTP ${result.response.status}: ${result.response.statusText}`;
@@ -5171,6 +5196,15 @@ var ApiClient = class {
       })
     );
   }
+  async getVisibilityCompare(project, from, to) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameVisibilityCompare({
+        client: this.heyClient,
+        path: { name: project },
+        query: { from, to }
+      })
+    );
+  }
   // ── Backlinks — workspace-level ────────────────────────────────────────
   async backlinksStatus() {
     return this.invoke(() => getApiV1BacklinksStatus({ client: this.heyClient }));
@@ -5915,6 +5949,21 @@ var canonryMcpTools = [
       shareOfVoice: input.shareOfVoice
     })
   }),
+  defineTool({
+    name: "canonry_visibility_compare",
+    title: "Compare AEO visibility month over month",
+    description: "Statistically honest month-over-month AEO comparison in ONE call \u2014 use this instead of hand-computing deltas from two visibility-stats calls. Share of voice (`mention-share-of-voice`, `driftRobust: true`) is less exposed to broad model-wide naming propensity than absolute rates, but it never overrides model continuity. The response restricts to common query/provider pairs, then includes only providers with exactly one known, identical configured model id in both months. `continuity` surfaces every provider, its model evidence, and whether it was excluded for a changed, mixed mid-month, or unknown model. When no provider remains, metrics return `model-discontinuous` or `model-unknown`, never a directional call. A silent upstream version bump under an unchanged configured id remains undetectable. `from` must be a month strictly before `to`.",
+    access: "read",
+    tier: "monitoring",
+    inputSchema: z2.object({
+      project: projectNameSchema,
+      from: z2.string().describe('Earlier calendar month (YYYY-MM), the baseline. Must be strictly before "to".'),
+      to: z2.string().describe('Later calendar month (YYYY-MM), compared against "from".')
+    }),
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/visibility-compare"],
+    handler: (client2, input) => client2.getVisibilityCompare(input.project, input.from, input.to)
+  }),
   defineTool({
     name: "canonry_content_targets",
     title: "Get content targets",

package/dist/{chunk-IQPMK36Y.js → chunk-IAJ5TQ4S.js}

@@ -1998,7 +1998,7 @@ var DEDUP_SIMILARITY_BAND_HIGH = 0.97;
 function computeDedupSimilarityStats(vectors, indexClusters) {
   const n = vectors.length;
   if (n < 2) return { perClusterMinSimilarity: [], bandPairFraction: null, pairsTotal: 0 };
-  const round = (v) => Math.round(v * 1e4) / 1e4;
+  const round2 = (v) => Math.round(v * 1e4) / 1e4;
   const perClusterMinSimilarity = [];
   for (const cluster of indexClusters) {
     if (cluster.length < 2) continue;
@@ -2008,7 +2008,7 @@ function computeDedupSimilarityStats(vectors, indexClusters) {
         min = Math.min(min, cosineSimilarity(vectors[cluster[a]], vectors[cluster[b]]));
       }
     }
-    perClusterMinSimilarity.push(round(min));
+    perClusterMinSimilarity.push(round2(min));
   }
   let inBand = 0;
   let pairsTotal = 0;
@@ -2019,7 +2019,7 @@ function computeDedupSimilarityStats(vectors, indexClusters) {
       if (sim >= DEDUP_SIMILARITY_BAND_LOW && sim < DEDUP_SIMILARITY_BAND_HIGH) inBand++;
     }
   }
-  return { perClusterMinSimilarity, bandPairFraction: round(inBand / pairsTotal), pairsTotal };
+  return { perClusterMinSimilarity, bandPairFraction: round2(inBand / pairsTotal), pairsTotal };
 }
 
 // ../contracts/src/url-normalize.ts
@@ -2894,6 +2894,137 @@ var visibilityStatsDtoSchema = z20.object({
   /** Pooled share of voice vs tracked competitors — present only when `shareOfVoice=1` was requested. */
   shareOfVoice: visibilityStatsShareOfVoiceSchema.optional()
 });
+var visibilityCompareVerdictSchema = z20.enum([
+  "within-noise",
+  "moved",
+  "insufficient-data",
+  "model-discontinuous",
+  "model-unknown"
+]);
+var visibilityCompareDirectionSchema = z20.enum(["up", "down", "flat"]);
+var visibilityCompareMetricPeriodSchema = z20.object({
+  /** The proportion in `[0,1]`, rounded to 4 dp; `null` when `denominator === 0` (undefined over no data). */
+  point: z20.number().nullable(),
+  /** Wilson 95% lower bound `[0,1]`; `null` when `denominator === 0`. */
+  ciLow: z20.number().nullable(),
+  /** Wilson 95% upper bound `[0,1]`; `null` when `denominator === 0`. */
+  ciHigh: z20.number().nullable(),
+  /** Successes (mentions / citations / project-brand mentions). */
+  numerator: z20.number().int(),
+  /** Sample size the proportion is over (checked snapshots / total / project+competitor brand mentions). */
+  denominator: z20.number().int()
+});
+var visibilityCompareMetricKeySchema = z20.enum([
+  "mention-share-of-voice",
+  "cited-share-of-voice",
+  "mention-rate",
+  "cited-rate"
+]);
+var visibilityCompareMetricSchema = z20.object({
+  key: visibilityCompareMetricKeySchema,
+  /** Human label ("Named share of voice", "Cited rate", …). */
+  label: z20.string(),
+  /**
+   * `true` for share of voice, which is less exposed to broad model-wide naming
+   * propensity than an absolute rate. It does not bypass model continuity: no
+   * metric can make a directional call when every provider is excluded.
+   */
+  driftRobust: z20.boolean(),
+  from: visibilityCompareMetricPeriodSchema,
+  to: visibilityCompareMetricPeriodSchema,
+  /** `to.point / from.point`; `null` when `from.point` is `0` or `null` (ratio undefined). */
+  rateRatio: z20.number().nullable(),
+  /** Sign of `to.point - from.point`; `null` when either point is `null`. */
+  direction: z20.union([visibilityCompareDirectionSchema, z20.null()]),
+  verdict: visibilityCompareVerdictSchema
+});
+var visibilityComparePeriodWindowSchema = z20.object({
+  /** The `YYYY-MM` requested. */
+  month: z20.string(),
+  /** Resolved inclusive ISO bounds the month expanded to. */
+  since: z20.string(),
+  until: z20.string(),
+  /** Completed/partial, non-probe answer-visibility runs in the month. */
+  runCount: z20.number().int(),
+  /**
+   * `true` when `runCount` is below the reliability floor (`< 5` sweeps): the
+   * intervals are wide and a `moved` verdict is unlikely to be reachable. A
+   * signal to raise the sweep schedule, surfaced so the report can caveat.
+   */
+  lowRunCount: z20.boolean()
+});
+var visibilityCompareBasketSchema = z20.object({
+  /** Distinct tracked queries with at least one common provider pair — the compared universe. */
+  queryCount: z20.number().int(),
+  /** Queries observed only in `from` (dropped from the comparison). */
+  excludedFromOnly: z20.number().int(),
+  /** Queries observed only in `to`. */
+  excludedToOnly: z20.number().int(),
+  /**
+   * The compared engine set: providers with ≥1 common query/provider pair.
+   */
+  providers: z20.array(z20.string()),
+  /** Providers observed in either period that did not make the basket (dropped from the comparison). */
+  excludedProviders: z20.array(z20.string())
+});
+var visibilityCompareModelChangeSchema = z20.object({
+  provider: z20.string(),
+  fromModels: z20.array(z20.string()),
+  toModels: z20.array(z20.string())
+});
+var visibilityCompareProviderContinuityStatusSchema = z20.enum([
+  "included",
+  "model-discontinuous",
+  "model-unknown"
+]);
+var visibilityCompareProviderContinuitySchema = z20.object({
+  provider: z20.string(),
+  /** `included` only when both months carry exactly one known model id, identical across the two, and NO snapshot with an unrecorded (null) model — a null mixed alongside a known id still marks the period `model-unknown`. */
+  status: visibilityCompareProviderContinuityStatusSchema,
+  fromModels: z20.array(z20.string()),
+  toModels: z20.array(z20.string())
+});
+var visibilityCompareContinuityStatusSchema = z20.enum([
+  "comparable",
+  "model-discontinuous",
+  "model-unknown",
+  "insufficient-data"
+]);
+var visibilityCompareContinuitySchema = z20.object({
+  status: visibilityCompareContinuityStatusSchema,
+  /** Providers retained in the directional comparison after the continuity gate. */
+  comparedProviders: z20.array(z20.string()),
+  /** Every provider with common query/provider pairs, including excluded ones and their model evidence. */
+  providers: z20.array(visibilityCompareProviderContinuitySchema)
+});
+var visibilityCompareProviderRowSchema = z20.object({
+  provider: z20.string(),
+  from: z20.object({ checked: z20.number().int(), mentioned: z20.number().int(), cited: z20.number().int() }),
+  to: z20.object({ checked: z20.number().int(), mentioned: z20.number().int(), cited: z20.number().int() })
+});
+var visibilityCompareQueriesMentionedSchema = z20.object({
+  from: z20.object({ count: z20.number().int(), of: z20.number().int() }),
+  to: z20.object({ count: z20.number().int(), of: z20.number().int() })
+});
+var visibilityCompareDtoSchema = z20.object({
+  project: z20.string(),
+  from: visibilityComparePeriodWindowSchema,
+  to: visibilityComparePeriodWindowSchema,
+  basket: visibilityCompareBasketSchema,
+  /** Ordered: mention SoV (primary), cited SoV, mention rate (level), cited rate. */
+  metrics: z20.array(visibilityCompareMetricSchema),
+  queriesMentioned: visibilityCompareQueriesMentionedSchema,
+  byProvider: z20.array(visibilityCompareProviderRowSchema),
+  /** Providers whose configured model id set changed between the periods (empty = none detected). */
+  modelChanges: z20.array(visibilityCompareModelChangeSchema),
+  /** Strict model-continuity evidence and the providers that remain comparable. */
+  continuity: visibilityCompareContinuitySchema,
+  /** Per-competitor mention counts within each period's basket (for the SoV detail). */
+  competitors: z20.object({
+    from: z20.array(visibilityStatsShareCompetitorSchema),
+    to: z20.array(visibilityStatsShareCompetitorSchema)
+  })
+});
 function calendarMonthBounds(month) {
   const match = /^(\d{4})-(\d{2})$/.exec(month);
   if (!match) throw new RangeError("month must be in YYYY-MM format");
@@ -5501,6 +5632,25 @@ function sumInfraHits(segments) {
   return segments.sitemap + segments.robots + segments.asset;
 }
 
+// ../contracts/src/statistics.ts
+function round(value, dp = 4) {
+  const f = 10 ** dp;
+  return (Math.round(value * f) + 0) / f;
+}
+function wilsonInterval(successes, n, z33 = 1.96) {
+  if (!Number.isFinite(n) || n <= 0) return null;
+  const s = Math.max(0, Math.min(successes, n));
+  const p = s / n;
+  const z210 = z33 * z33;
+  const denom = 1 + z210 / n;
+  const center = (p + z210 / (2 * n)) / denom;
+  const margin = z33 / denom * Math.sqrt(p * (1 - p) / n + z210 / (4 * n * n));
+  return {
+    low: round(Math.max(0, center - margin)),
+    high: round(Math.min(1, center + margin))
+  };
+}
+
 // ../contracts/src/ads.ts
 import { z as z32 } from "zod";
 var adsConnectRequestSchema = z32.object({
@@ -5984,6 +6134,7 @@ export {
   parseWindow,
   windowCutoff,
   visibilityStatsDtoSchema,
+  visibilityCompareDtoSchema,
   calendarMonthBounds,
   formatRatio,
   formatNumber,
@@ -6097,6 +6248,7 @@ export {
   classifyTrafficPath,
   segmentCrawlerHits,
   sumInfraHits,
+  wilsonInterval,
   adsConnectRequestSchema,
   adsConnectionStatusDtoSchema,
   adsDisconnectResponseSchema,

package/dist/{chunk-GV665WOU.js → chunk-NY7SC4ES.js}

@@ -10,7 +10,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-RVH6QPTA.js";
+} from "./chunk-BMBHUFMI.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -115,7 +115,7 @@ import {
   siteAuditPages,
   siteAuditSnapshots,
   usageCounters
-} from "./chunk-WEAXJ25Y.js";
+} from "./chunk-V4SW7SVX.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -178,7 +178,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-IQPMK36Y.js";
+} from "./chunk-IAJ5TQ4S.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -6515,7 +6515,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-HEN5HLUM.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-C5YLASIP.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -12432,7 +12432,8 @@ async function createServer(opts) {
       const url = request.url.split("?")[0];
       const isApiRoute = url.startsWith("/api/") || basePath !== void 0 && url.startsWith(`${basePath}api/`);
       if (isApiRoute) {
-        return reply.status(404).send({ error: "Not found", path: request.url });
+        const error = notFound("API route", url);
+        return reply.status(error.statusCode).send(error.toJSON());
       }
       if (basePath && !url.startsWith(basePath)) {
         return reply.status(404).send({ error: "Not found", path: request.url });