@ainyc/canonry 4.64.1 → 4.68.1

package/assets/assets/{server-traffic-D3aICbxr.js → server-traffic-CMFP8-x2.js}

@@ -1 +1 @@
-import{c as d,j as a,bT as S,bN as l,bU as v,au as m,l as t,bV as y,bO as i,bW as T,bX as h,bY as p,bZ as b}from"./index-DiN_mzYU.js";import{u as s,r as C,n as c,o as u}from"./vendor-tanstack-Dq7p98wZ.js";const g=[["path",{d:"M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8",key:"v9h5vc"}],["path",{d:"M21 3v5h-5",key:"1q7to0"}],["path",{d:"M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16",key:"3uifl3"}],["path",{d:"M8 16H3v5",key:"1cv678"}]],M=d("refresh-cw",g);function P(e){switch(e){case i.connected:return"positive";case i.paused:return"caution";case i.error:return"negative";case i.archived:return"neutral"}}function w(e){const r={};return e.kind&&e.kind!=="all"&&(r.kind=e.kind),e.sourceId&&(r.sourceId=e.sourceId),e.sinceMinutes!==void 0&&(r.since=new Date(Date.now()-e.sinceMinutes*6e4).toISOString()),e.limit!==void 0&&(r.limit=String(e.limit)),r}function o(e){e.invalidateQueries({predicate:r=>{const n=r.queryKey[0];return typeof n?._id=="string"&&n._id.startsWith("getApiV1ProjectsByNameTraffic")}})}function V(e){return s({...S({client:t,path:{name:e??""}}),enabled:!!e,staleTime:a})}function k(e){return s({...b({client:t,path:{name:e??""}}),enabled:!!e,staleTime:a})}function F(e,r){return s({...l({client:t,path:{name:e??"",id:r??""}}),enabled:!!(e&&r),staleTime:a})}function A(e,r){const n=C.useMemo(()=>w(r),[r.kind,r.sourceId,r.sinceMinutes,r.limit]);return s({...v({client:t,path:{name:e??""},query:n}),enabled:!!e,staleTime:a})}function E(e){const r=c();return u({mutationFn:n=>{if(!e)throw new Error("Project is required to connect a Cloud Run source");return p(e,n)},onSuccess:()=>{e&&o(r)}})}function I(e){const r=c();return u({mutationFn:n=>{if(!e)throw new Error("Project is required to connect a WordPress source");return T(e,n)},onSuccess:()=>{e&&o(r)}})}function N(e){const r=c();return u({mutationFn:n=>{if(!e)throw new Error("Project is required to connect a Vercel source");return h(e,n)},onSuccess:()=>{e&&o(r)}})}function Q(e,r){const n=c();return u({mutationFn:f=>{if(!e||!r)throw new Error("Project and sourceId are required to sync");return y(e,r,f??void 0)},onSuccess:()=>{e&&(o(n),n.invalidateQueries({queryKey:m({client:t})}))}})}export{M as R,I as a,N as b,E as c,V as d,F as e,A as f,Q as g,P as t,k as u};
+import{c as d,j as a,bU as S,bO as l,bV as v,av as m,l as t,bW as y,bP as i,bX as T,bY as h,bZ as p,b_ as b}from"./index-DFo2OL9c.js";import{u as s,r as C,n as c,o as u}from"./vendor-tanstack-Dq7p98wZ.js";const g=[["path",{d:"M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8",key:"v9h5vc"}],["path",{d:"M21 3v5h-5",key:"1q7to0"}],["path",{d:"M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16",key:"3uifl3"}],["path",{d:"M8 16H3v5",key:"1cv678"}]],B=d("refresh-cw",g);function M(e){switch(e){case i.connected:return"positive";case i.paused:return"caution";case i.error:return"negative";case i.archived:return"neutral"}}function w(e){const r={};return e.kind&&e.kind!=="all"&&(r.kind=e.kind),e.sourceId&&(r.sourceId=e.sourceId),e.sinceMinutes!==void 0&&(r.since=new Date(Date.now()-e.sinceMinutes*6e4).toISOString()),e.limit!==void 0&&(r.limit=String(e.limit)),r}function o(e){e.invalidateQueries({predicate:r=>{const n=r.queryKey[0];return typeof n?._id=="string"&&n._id.startsWith("getApiV1ProjectsByNameTraffic")}})}function V(e){return s({...S({client:t,path:{name:e??""}}),enabled:!!e,staleTime:a})}function k(e){return s({...b({client:t,path:{name:e??""}}),enabled:!!e,staleTime:a})}function F(e,r){return s({...l({client:t,path:{name:e??"",id:r??""}}),enabled:!!(e&&r),staleTime:a})}function A(e,r){const n=C.useMemo(()=>w(r),[r.kind,r.sourceId,r.sinceMinutes,r.limit]);return s({...v({client:t,path:{name:e??""},query:n}),enabled:!!e,staleTime:a})}function E(e){const r=c();return u({mutationFn:n=>{if(!e)throw new Error("Project is required to connect a Cloud Run source");return p(e,n)},onSuccess:()=>{e&&o(r)}})}function I(e){const r=c();return u({mutationFn:n=>{if(!e)throw new Error("Project is required to connect a WordPress source");return T(e,n)},onSuccess:()=>{e&&o(r)}})}function Q(e){const r=c();return u({mutationFn:n=>{if(!e)throw new Error("Project is required to connect a Vercel source");return h(e,n)},onSuccess:()=>{e&&o(r)}})}function R(e,r){const n=c();return u({mutationFn:f=>{if(!e||!r)throw new Error("Project and sourceId are required to sync");return y(e,r,f??void 0)},onSuccess:()=>{e&&(o(n),n.invalidateQueries({queryKey:m({client:t})}))}})}export{B as R,I as a,Q as b,E as c,V as d,F as e,A as f,R as g,M as t,k as u};

package/assets/assets/{trash-2-CVKno2W2.js → trash-2-C4sYVIa6.js}

@@ -1 +1 @@
-import{c}from"./index-DiN_mzYU.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-DFo2OL9c.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,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-DiN_mzYU.js"></script>
+    <script type="module" crossorigin src="./assets/index-DFo2OL9c.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/vendor-tanstack-Dq7p98wZ.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-radix-B57xfQbP.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-recharts-ClRVR6aX.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-markdown-DK7fbRNb.js">
-    <link rel="stylesheet" crossorigin href="./assets/index-yMJe1bJR.css">
+    <link rel="stylesheet" crossorigin href="./assets/index-BquJzH0t.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/{chunk-34PATQZM.js → chunk-D75O5A27.js}

@@ -1498,7 +1498,7 @@ var snapshotReportSchema = z12.object({
 
 // ../contracts/src/schedule.ts
 import { z as z13 } from "zod";
-var schedulableRunKindSchema = z13.enum(["answer-visibility", "traffic-sync", "gbp-sync", "data-refresh"]);
+var schedulableRunKindSchema = z13.enum(["answer-visibility", "traffic-sync", "gbp-sync", "data-refresh", "backlinks-sync"]);
 var SchedulableRunKinds = schedulableRunKindSchema.enum;
 var scheduleDtoSchema = z13.object({
   id: z13.string(),
@@ -1534,8 +1534,42 @@ var scheduleUpsertRequestSchema = z13.object({
 
 // ../contracts/src/analytics.ts
 import { z as z14 } from "zod";
+var metricsWindowSchema = z14.enum(["7d", "30d", "90d", "all"]);
+var trendDirectionSchema = z14.enum(["improving", "declining", "stable"]);
 var visibilityMetricModeSchema = z14.enum(["mentioned", "cited"]);
 var VisibilityMetricModes = visibilityMetricModeSchema.enum;
+var providerMetricSchema = z14.object({
+  citationRate: z14.number(),
+  cited: z14.number().int(),
+  total: z14.number().int(),
+  mentionRate: z14.number(),
+  mentionedCount: z14.number().int()
+});
+var timeBucketSchema = z14.object({
+  startDate: z14.string(),
+  endDate: z14.string(),
+  citationRate: z14.number(),
+  cited: z14.number().int(),
+  total: z14.number().int(),
+  queryCount: z14.number().int(),
+  mentionRate: z14.number(),
+  mentionedCount: z14.number().int(),
+  byProvider: z14.record(z14.string(), providerMetricSchema)
+});
+var queryChangeEventSchema = z14.object({
+  date: z14.string(),
+  delta: z14.number().int(),
+  label: z14.string()
+});
+var brandMetricsDtoSchema = z14.object({
+  window: metricsWindowSchema,
+  buckets: z14.array(timeBucketSchema),
+  overall: providerMetricSchema,
+  byProvider: z14.record(z14.string(), providerMetricSchema),
+  trend: trendDirectionSchema,
+  mentionTrend: trendDirectionSchema,
+  queryChanges: z14.array(queryChangeEventSchema)
+});
 function parseWindow(value) {
   if (value === "7d" || value === "30d" || value === "90d" || value === "all") return value;
   return "all";
@@ -4010,6 +4044,7 @@ export {
   SchedulableRunKinds,
   scheduleDtoSchema,
   scheduleUpsertRequestSchema,
+  brandMetricsDtoSchema,
   parseWindow,
   windowCutoff,
   categorizeSource,

package/dist/{chunk-MDNDIBUM.js → chunk-GZYLAE6M.js}

@@ -5,10 +5,11 @@ import {
   canonryMcpTools,
   configExists,
   getConfigPath,
+  isMachineFormat,
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-64IDABSF.js";
+} from "./chunk-YYFBMDLC.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -76,6 +77,7 @@ import {
   loadDuckdb,
   markSessionFailed,
   migrate,
+  nextRunFromCron,
   notifications,
   parseJsonColumn,
   probeLatestRelease,
@@ -93,7 +95,7 @@ import {
   runs,
   schedules,
   usageCounters
-} from "./chunk-KHN3XMOR.js";
+} from "./chunk-Y24OE7R3.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -141,7 +143,7 @@ import {
   skillsClientSchema,
   validationError,
   withRetry
-} from "./chunk-34PATQZM.js";
+} from "./chunk-D75O5A27.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -433,7 +435,7 @@ import crypto17 from "crypto";
 import fs8 from "fs";
 import path9 from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
-import { eq as eq17 } from "drizzle-orm";
+import { and as and13, eq as eq17 } from "drizzle-orm";
 import Fastify from "fastify";
 import os5 from "os";
 
@@ -5296,7 +5298,7 @@ async function backfillAnswerVisibilityCommand(opts) {
     result.dryRun = true;
     result.wouldUpdate = wouldUpdate;
   }
-  if (opts?.format === "json") {
+  if (isMachineFormat(opts?.format)) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
@@ -5366,7 +5368,7 @@ async function backfillNormalizedPathsCommand(opts) {
         updated: 0,
         unchanged: 0
       };
-      if (opts?.format === "json") {
+      if (isMachineFormat(opts?.format)) {
         console.log(JSON.stringify(result2, null, 2));
         return;
       }
@@ -5382,7 +5384,7 @@ async function backfillNormalizedPathsCommand(opts) {
     updated,
     unchanged
   };
-  if (opts?.format === "json") {
+  if (isMachineFormat(opts?.format)) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
@@ -5438,7 +5440,7 @@ async function backfillAiReferralPathsCommand(opts) {
         updated: 0,
         unchanged: 0
       };
-      if (opts?.format === "json") {
+      if (isMachineFormat(opts?.format)) {
         console.log(JSON.stringify(result2, null, 2));
         return;
       }
@@ -5454,7 +5456,7 @@ async function backfillAiReferralPathsCommand(opts) {
     updated,
     unchanged
   };
-  if (opts?.format === "json") {
+  if (isMachineFormat(opts?.format)) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
@@ -5579,7 +5581,7 @@ async function backfillAnswerMentionsCommand(opts) {
     result.dryRun = true;
     result.wouldUpdate = wouldUpdate;
   }
-  if (opts?.format === "json") {
+  if (isMachineFormat(opts?.format)) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
@@ -5616,12 +5618,12 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-SMU5JVVD.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-5V2JWQ6K.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
   const service = new IntelligenceService2(db);
-  const isJson = opts?.format === "json";
+  const isJson = isMachineFormat(opts?.format);
   const isDryRun = opts?.dryRun === true;
   if (!isJson) {
     const scope = opts?.since ? ` (since ${opts.since})` : "";
@@ -5779,7 +5781,7 @@ async function backfillSnapshotAttributionCommand(opts) {
   if (!project) {
     throw new Error(`Project "${opts.project}" not found`);
   }
-  const isJson = opts.format === "json";
+  const isJson = isMachineFormat(opts.format);
   const isDryRun = opts.dryRun === true;
   if (!isJson) {
     const mode = isDryRun ? " [DRY RUN \u2014 no writes]" : "";
@@ -5958,7 +5960,7 @@ async function backfillTrafficClassificationCommand(opts) {
   migrate(db);
   const projectFilter = opts?.project?.trim();
   const isDryRun = opts?.dryRun === true;
-  const isJson = opts?.format === "json";
+  const isJson = isMachineFormat(opts?.format);
   const scopedProjects = projectFilter ? db.select().from(projects).where(eq10(projects.name, projectFilter)).all() : db.select().from(projects).all();
   if (scopedProjects.length === 0) {
     if (projectFilter && !isJson) {
@@ -6395,7 +6397,7 @@ async function installSkills(opts = {}) {
 }
 async function listSkills(opts = {}) {
   const skills = getBundledSkills();
-  if (opts.format === "json") {
+  if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify({
       skills: skills.map((s) => ({
         name: s.name,
@@ -6416,7 +6418,7 @@ async function listSkills(opts = {}) {
   }
 }
 function emitInstallSummary(summary, format) {
-  if (format === "json") {
+  if (isMachineFormat(format)) {
     console.log(JSON.stringify(summary, null, 2));
     return;
   }
@@ -6601,7 +6603,7 @@ var Scheduler = class {
     });
     this.tasks.set(taskKey(projectId, kind), task);
     this.db.update(schedules).set({
-      nextRunAt: task.getNextRun()?.toISOString() ?? null,
+      nextRunAt: nextRunFromCron(cronExpr, timezone),
       updatedAt: (/* @__PURE__ */ new Date()).toISOString()
     }).where(eq11(schedules.id, scheduleId)).run();
     const label = schedule.preset ?? cronExpr;
@@ -6616,8 +6618,7 @@ var Scheduler = class {
         this.remove(projectId, kind);
         return;
       }
-      const task = this.tasks.get(taskKey(projectId, kind));
-      const nextRunAt = task?.getNextRun()?.toISOString() ?? null;
+      const nextRunAt = nextRunFromCron(currentSchedule.cronExpr, currentSchedule.timezone);
       const project = this.db.select().from(projects).where(eq11(projects.id, projectId)).get();
       if (!project) {
         log11.error("project.not-found", { projectId, kind, msg: "skipping scheduled run" });
@@ -6680,6 +6681,20 @@ var Scheduler = class {
         this.callbacks.onDataRefreshRequested(project.name);
         return;
       }
+      if (kind === SchedulableRunKinds["backlinks-sync"]) {
+        if (!this.callbacks.onBacklinksSyncRequested) {
+          log11.warn("backlinks-sync.no-callback", { scheduleId, projectId, msg: "host did not register onBacklinksSyncRequested" });
+          return;
+        }
+        this.db.update(schedules).set({
+          lastRunAt: now,
+          nextRunAt,
+          updatedAt: now
+        }).where(eq11(schedules.id, currentSchedule.id)).run();
+        log11.info("backlinks-sync.triggered", { projectName: project.name });
+        this.callbacks.onBacklinksSyncRequested(project.name);
+        return;
+      }
       const projectLocations = project.locations;
       let resolvedLocation;
       if (project.defaultLocation) {
@@ -9451,6 +9466,29 @@ async function createServer(opts) {
     },
     onDataRefreshRequested: (projectName) => {
       void refreshAllIntegrations(aeroClient, projectName);
+    },
+    onBacklinksSyncRequested: (projectName) => {
+      void (async () => {
+        const probed = await probeLatestRelease().catch((err) => {
+          app.log.warn({ projectName, err }, "Scheduled backlinks sync: latest-release probe failed");
+          return null;
+        });
+        if (!probed) return;
+        const alreadySynced = opts.db.select().from(ccReleaseSyncs).where(and13(
+          eq17(ccReleaseSyncs.release, probed.release),
+          eq17(ccReleaseSyncs.status, CcReleaseSyncStatuses.ready)
+        )).limit(1).get();
+        if (alreadySynced) {
+          app.log.info({ projectName, release: probed.release }, "Scheduled backlinks sync: already up to date, skipping");
+          return;
+        }
+        aeroClient.backlinksTriggerSync(probed.release).catch((err) => {
+          app.log.error(
+            { projectName, release: probed.release, err: err instanceof Error ? err.message : String(err) },
+            "Scheduled backlinks sync failed"
+          );
+        });
+      })();
     }
   });
   const providerSummary = API_ADAPTERS.map((adapter) => ({

package/dist/{chunk-KHN3XMOR.js → chunk-Y24OE7R3.js}

@@ -51,6 +51,7 @@ import {
   bingUrlInspectionDtoSchema,
   brandKeyFromText,
   brandLabelFromDomain,
+  brandMetricsDtoSchema,
   categorizeSource,
   categorizeSourceWithCompetitors,
   categoryLabel,
@@ -207,7 +208,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-34PATQZM.js";
+} from "./chunk-D75O5A27.js";
 
 // src/intelligence-service.ts
 import { eq as eq30, desc as desc15, asc as asc3, and as and23, ne as ne5, or as or5, inArray as inArray11, gte as gte6, lte as lte3 } from "drizzle-orm";
@@ -6131,6 +6132,7 @@ import crypto10 from "crypto";
 import { and as and3, eq as eq8 } from "drizzle-orm";
 
 // ../api-routes/src/schedule-utils.ts
+import { CronExpressionParser } from "cron-parser";
 var DAY_MAP = {
   sun: "0",
   mon: "1",
@@ -6217,6 +6219,17 @@ function isValidTimezone(tz) {
     return false;
   }
 }
+function nextRunFromCron(cronExpr, timezone, from = /* @__PURE__ */ new Date()) {
+  try {
+    const interval = CronExpressionParser.parse(cronExpr, {
+      currentDate: from,
+      tz: timezone
+    });
+    return interval.next().toDate().toISOString();
+  } catch {
+    return null;
+  }
+}
 
 // ../api-routes/src/webhooks.ts
 import crypto9 from "crypto";
@@ -7243,6 +7256,10 @@ function computeBuckets(snapshots, projectRuns, bucketDays, queryCreatedAt) {
       }
       const metric = computeProviderMetric(usable);
       const queryCount = new Set(usable.map((s) => s.queryId)).size;
+      const byProvider = {};
+      for (const provider of new Set(usable.map((s) => s.provider))) {
+        byProvider[provider] = computeProviderMetric(usable.filter((s) => s.provider === provider));
+      }
       buckets.push({
         startDate: startISO,
         endDate: endISO,
@@ -7251,7 +7268,8 @@ function computeBuckets(snapshots, projectRuns, bucketDays, queryCreatedAt) {
         total: metric.total,
         queryCount,
         mentionRate: metric.mentionRate,
-        mentionedCount: metric.mentionedCount
+        mentionedCount: metric.mentionedCount,
+        byProvider
       });
     }
     start = end;
@@ -12012,6 +12030,7 @@ async function compositeRoutes(app) {
     const attentionItems = buildAttentionItems(insightRows, allRuns);
     const sparklineRuns = visibilityRuns.slice(0, DEFAULT_RUN_HISTORY_LIMIT).map((r) => ({ id: r.id, createdAt: r.createdAt, status: r.status }));
     const runHistory = buildRunHistory(sparklineRuns, snapshotsByRun);
+    scores.visibility.trend = runHistory.map((p) => p.citationRate);
     const suggestedQueries = buildSuggestedQueriesFromGsc(
       app,
       project.id,
@@ -12544,6 +12563,7 @@ var SCHEMA_TABLE = {
   BingSitesResponseDto: bingSitesResponseDtoSchema,
   BingStatusDto: bingStatusDtoSchema,
   BingUrlInspectionDto: bingUrlInspectionDtoSchema,
+  BrandMetricsDto: brandMetricsDtoSchema,
   CcAvailableRelease: ccAvailableReleaseSchema,
   CcCachedRelease: ccCachedReleaseSchema,
   CcReleaseSyncDto: ccReleaseSyncDtoSchema,
@@ -12595,6 +12615,7 @@ var SCHEMA_TABLE = {
   QueryDto: queryDtoSchema,
   RunDetailDto: runDetailDtoSchema,
   RunDto: runDtoSchema,
+  SchedulableRunKind: schedulableRunKindSchema,
   ScheduleDto: scheduleDtoSchema,
   SettingsDto: settingsDtoSchema,
   SnapshotDiffResponse: snapshotDiffResponseSchema,
@@ -12630,11 +12651,20 @@ var SCHEMA_TABLE = {
     })
   })
 };
+var SHARED_ENUM_REFS = [
+  { schema: "ScheduleDto", property: "kind", component: "SchedulableRunKind" }
+];
 function buildComponentSchemas() {
   const out = {};
   for (const [name, schema] of Object.entries(SCHEMA_TABLE)) {
     out[name] = z.toJSONSchema(schema, { target: "openapi-3.0" });
   }
+  for (const { schema, property, component } of SHARED_ENUM_REFS) {
+    const properties = out[schema]?.properties;
+    if (properties && properties[property]) {
+      properties[property] = { $ref: `#/components/schemas/${component}` };
+    }
+  }
   return out;
 }
 function jsonResponse(description, schemaName) {
@@ -12680,7 +12710,6 @@ var integerSchema = { type: "integer" };
 var objectSchema = { type: "object", additionalProperties: true };
 var stringArraySchema = { type: "array", items: stringSchema };
 var googleConnectionTypeSchema = { type: "string", enum: ["gsc", "ga4", "gbp"] };
-var scheduleKindEnum = Object.values(SchedulableRunKinds);
 var locationSchema = {
   type: "object",
   required: ["label", "city", "region", "country"],
@@ -12770,7 +12799,7 @@ var scheduleKindQueryParameter = {
   name: "kind",
   in: "query",
   description: 'Schedulable run kind. Defaults to "answer-visibility" for backward compatibility.',
-  schema: { type: "string", enum: scheduleKindEnum }
+  schema: { $ref: "#/components/schemas/SchedulableRunKind" }
 };
 var runsListKindQueryParameter = {
   name: "kind",
@@ -13516,8 +13545,7 @@ var routeCatalog = [
     tags: ["analytics"],
     parameters: [nameParameter, analyticsWindowParameter],
     responses: {
-      // TODO: Add `BrandMetricsDto` Zod schema in contracts.
-      200: rawJsonResponse("Citation metrics returned.", looseObjectSchema),
+      200: jsonResponse("Citation metrics returned.", "BrandMetricsDto"),
       404: errorResponse("Project not found.")
     }
   },
@@ -13731,7 +13759,7 @@ var routeCatalog = [
           schema: {
             type: "object",
             properties: {
-              kind: { type: "string", enum: scheduleKindEnum },
+              kind: { $ref: "#/components/schemas/SchedulableRunKind" },
               preset: stringSchema,
               cron: stringSchema,
               timezone: stringSchema,
@@ -16583,6 +16611,9 @@ async function scheduleRoutes(app, opts) {
     } else if (sourceId) {
       throw validationError(`"sourceId" is only valid when kind is "traffic-sync"`);
     }
+    if (kind === SchedulableRunKinds["backlinks-sync"] && providers && providers.length > 0) {
+      throw validationError('"providers" is not valid for kind "backlinks-sync"');
+    }
     const validNames = opts.validProviderNames ?? [];
     if (validNames.length && providers?.length) {
       const invalid = providers.filter((p) => !validNames.includes(p));
@@ -22781,7 +22812,8 @@ var PLUGIN_DIR = path2.join(os2.homedir(), ".canonry", "plugins");
 var PLUGIN_PKG_JSON = path2.join(PLUGIN_DIR, "package.json");
 var DUCKDB_SPEC = process.env.CANONRY_DUCKDB_SPEC ?? "@duckdb/node-api@1.4.4-r.3";
 var CC_CACHE_DIR = process.env.CANONRY_CC_CACHE_DIR ?? path2.join(os2.homedir(), ".canonry", "cache", "commoncrawl");
-var RELEASE_ID_REGEX = /^cc-main-(\d{4})-(jan-feb-mar|apr-may-jun|jul-aug-sep|oct-nov-dec)$/;
+var CC_MONTH = "(?:jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)";
+var RELEASE_ID_REGEX = new RegExp(`^cc-main-(\\d{4})-(${CC_MONTH}-${CC_MONTH}-${CC_MONTH})$`);
 function ccReleasePaths(release) {
   const base = `${CC_BASE_URL}/${release}/domain`;
   const vertexFilename = `${release}-domain-vertices.txt.gz`;
@@ -22806,23 +22838,28 @@ function forwardDomain(revDomain) {
 function isValidReleaseId(id) {
   return RELEASE_ID_REGEX.test(id);
 }
-function formatReleaseId(year, quarter) {
-  return `cc-main-${year}-${quarter}`;
+function formatReleaseId(year, window) {
+  return `cc-main-${year}-${window}`;
 }
 
 // ../integration-commoncrawl/src/release-discovery.ts
-var QUARTERS = [
-  "oct-nov-dec",
-  "jul-aug-sep",
-  "apr-may-jun",
-  "jan-feb-mar"
-];
-function probeCandidates(now, maxBack) {
-  const year = now.getUTCFullYear();
+var MONTHS = ["jan", "feb", "mar", "apr", "may", "jun", "jul", "aug", "sep", "oct", "nov", "dec"];
+function windowSlug(firstMonthIndex) {
+  const a = MONTHS[firstMonthIndex % 12];
+  const b = MONTHS[(firstMonthIndex + 1) % 12];
+  const c = MONTHS[(firstMonthIndex + 2) % 12];
+  return `${a}-${b}-${c}`;
+}
+function probeCandidates(now, maxMonthsBack) {
+  let year = now.getUTCFullYear();
+  let month = now.getUTCMonth();
   const out = [];
-  for (let y = year; y >= year - maxBack; y--) {
-    for (const q of QUARTERS) {
-      out.push({ year: y, quarter: q });
+  for (let step = 0; step <= maxMonthsBack; step++) {
+    out.push({ year, window: windowSlug(month) });
+    month -= 1;
+    if (month < 0) {
+      month = 11;
+      year -= 1;
     }
   }
   return out;
@@ -22845,11 +22882,11 @@ async function probeRelease(release, fetchImpl = fetch) {
 }
 async function probeLatestRelease(opts = {}) {
   const now = opts.now ?? /* @__PURE__ */ new Date();
-  const maxBack = opts.maxQuartersBack ?? 3;
+  const maxBack = opts.maxMonthsBack ?? 14;
   const fetchImpl = opts.fetchImpl ?? fetch;
   const candidates = probeCandidates(now, maxBack);
-  for (const { year, quarter } of candidates) {
-    const release = formatReleaseId(year, quarter);
+  for (const { year, window } of candidates) {
+    const release = formatReleaseId(year, window);
     const result = await probeRelease(release, fetchImpl);
     if (result) return result;
   }
@@ -23312,7 +23349,7 @@ async function backlinksRoutes(app, opts) {
     if (!release) {
       if (!opts.discoverLatestRelease) {
         throw validationError(
-          "No `release` provided and auto-discovery is unavailable on this deployment. Pass an explicit release id (e.g., cc-main-2026-jan-feb-mar)."
+          "No `release` provided and auto-discovery is unavailable on this deployment. Pass an explicit release id (e.g., cc-main-2026-mar-apr-may)."
         );
       }
       const discovered = await opts.discoverLatestRelease();
@@ -23324,7 +23361,7 @@ async function backlinksRoutes(app, opts) {
       release = discovered.release;
     }
     if (!isValidReleaseId(release)) {
-      throw validationError("Invalid release id. Expected form: cc-main-YYYY-{jan-feb-mar,apr-may-jun,jul-aug-sep,oct-nov-dec}");
+      throw validationError("Invalid release id. Expected form: cc-main-YYYY-<mon>-<mon>-<mon> (a rolling 3-month window, e.g. cc-main-2026-mar-apr-may).");
     }
     if (!opts.getBacklinksStatus || !opts.onReleaseSyncRequested) {
       throw missingDependency(BACKLINKS_UNSUPPORTED_MESSAGE);
@@ -31959,6 +31996,7 @@ export {
   getPlaceDetails,
   hashPlaceDetails,
   queueRunIfProjectIdle,
+  nextRunFromCron,
   resolveWebhookTarget,
   deliverWebhook,
   redactNotificationUrl,

package/dist/{chunk-64IDABSF.js → chunk-YYFBMDLC.js}

@@ -22,7 +22,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-34PATQZM.js";
+} from "./chunk-D75O5A27.js";
 
 // src/config.ts
 import fs from "fs";
@@ -190,6 +190,9 @@ function configExists() {
 }
 
 // src/cli-error.ts
+function isMachineFormat(format) {
+  return format === "json" || format === "jsonl";
+}
 var EXIT_USER_ERROR = 1;
 var EXIT_SYSTEM_ERROR = 2;
 var CliError = class extends Error {
@@ -221,36 +224,9 @@ function isEndpointMissing(err) {
   return status === 404 || status === 405;
 }
 function printCliError(err, format) {
-  if (format === "json") {
-    if (err instanceof CliError) {
-      console.error(
-        JSON.stringify(
-          {
-            error: {
-              code: err.code,
-              message: err.message,
-              ...err.details ? { details: err.details } : {}
-            }
-          },
-          null,
-          2
-        )
-      );
-      return;
-    }
-    const message = err instanceof Error ? err.message : "An unexpected error occurred";
-    console.error(
-      JSON.stringify(
-        {
-          error: {
-            code: "CLI_ERROR",
-            message
-          }
-        },
-        null,
-        2
-      )
-    );
+  if (isMachineFormat(format)) {
+    const envelope = err instanceof CliError ? { error: { code: err.code, message: err.message, ...err.details ? { details: err.details } : {} } } : { error: { code: "CLI_ERROR", message: err instanceof Error ? err.message : "An unexpected error occurred" } };
+    console.error(JSON.stringify(envelope, null, format === "jsonl" ? 0 : 2));
     return;
   }
   if (err instanceof CliError && err.displayMessage) {
@@ -5155,6 +5131,20 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/report"],
     handler: (client2, input) => client2.getReport(input.project)
   }),
+  defineTool({
+    name: "canonry_analytics_metrics",
+    title: "Get citation & mention trend",
+    description: "Citation and mention rates over time for a project, bucketed adaptively (daily \u2192 monthly by span) and probe-excluded. Returns overall + per-provider window aggregates AND a per-bucket `byProvider` breakdown so you can read how each engine's cited/mentioned rate moved run-over-run \u2014 the same data the dashboard's \"Citations & mentions over time\" chart plots. Includes trend direction (improving/declining/stable) for both signals and query-set-change annotations. Filter the range with `window` (7d/30d/90d/all).",
+    access: "read",
+    tier: "monitoring",
+    inputSchema: z2.object({
+      project: projectNameSchema,
+      window: analyticsWindowSchema.optional().describe("Time range: 7d, 30d, 90d, or all (default all).")
+    }),
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/analytics/metrics"],
+    handler: (client2, input) => client2.getAnalyticsMetrics(input.project, input.window)
+  }),
   defineTool({
     name: "canonry_search",
     title: "Search project (composite)",
@@ -6256,6 +6246,7 @@ export {
   saveConfig,
   saveConfigPatch,
   configExists,
+  isMachineFormat,
   EXIT_USER_ERROR,
   EXIT_SYSTEM_ERROR,
   CliError,