@canonry/canonry 7.95.0 → 7.96.0

package/dist/{chunk-KMT7I5KZ.js → chunk-N4SEITGT.js}

@@ -1,9 +1,9 @@
 import {
   pickProjectCitedDomain
-} from "./chunk-YTRXALSU.js";
+} from "./chunk-3FHPUOMW.js";
 import {
   createLogger
-} from "./chunk-T3FYWUQL.js";
+} from "./chunk-IO4BZLM7.js";
 import {
   GBP_INSIGHT_PROVIDER,
   PERSISTENT_GAP_THRESHOLD,
@@ -17,7 +17,7 @@ import {
   mergeGscQueryTotalsWithFallback,
   readGscQueryDailyRows,
   readLatestGscDataDate
-} from "./chunk-7PUUMJXY.js";
+} from "./chunk-PSCXQGJE.js";
 import {
   competitors,
   gbpDailyMetrics,
@@ -35,14 +35,14 @@ import {
   queries,
   querySnapshots,
   runs
-} from "./chunk-J3NS6NGM.js";
+} from "./chunk-JGLX5WU6.js";
 import {
   CitationStates,
   RunKinds,
   RunStatuses,
   RunTriggers,
   effectiveDomains
-} from "./chunk-CVCUADCM.js";
+} from "./chunk-W4ZRFNOX.js";
 
 // src/intelligence-service.ts
 import { eq, desc, asc, and, ne, or, inArray, gte, lte, isNull, sql, exists } from "drizzle-orm";

package/dist/{chunk-MKLAX5KY.js → chunk-OCXDY2DG.js}

@@ -15,7 +15,7 @@ import {
   hostMatchesDomain,
   hostOf,
   isLocationRedirectStatus
-} from "./chunk-CVCUADCM.js";
+} from "./chunk-W4ZRFNOX.js";
 
 // ../integration-traffic/src/agent-trust.ts
 var AGENT_TRUST_RULES_VERSION = 2;

package/dist/{chunk-FWY5HUSB.js → chunk-PC7ZUW2H.js}

@@ -5,7 +5,7 @@ import {
   siteCrawlGraphNodes,
   siteCrawlPages,
   siteCrawlSnapshots
-} from "./chunk-J3NS6NGM.js";
+} from "./chunk-JGLX5WU6.js";
 import {
   SITE_CRAWL_GRAPH_MAX_EDGES,
   SITE_CRAWL_GRAPH_MAX_NODES,
@@ -15,7 +15,7 @@ import {
   factorStatusFromDistribution,
   factorStatusFromScore,
   roundPreservingTotal
-} from "./chunk-CVCUADCM.js";
+} from "./chunk-W4ZRFNOX.js";
 
 // src/site-audit-factors.ts
 function recordedSharePct(factor) {

package/dist/{chunk-7PUUMJXY.js → chunk-PSCXQGJE.js}

@@ -17,14 +17,14 @@ import {
   normalizeTrafficPathPattern,
   sessionizeJourneyRequests,
   verifyRequestSignature
-} from "./chunk-MKLAX5KY.js";
+} from "./chunk-OCXDY2DG.js";
 import {
   currentOutcomeAttribution,
   getRequestContext,
   registerRequestContext,
   requestAuditIdentity,
   sanitizeRequestContext
-} from "./chunk-EWSVH5TU.js";
+} from "./chunk-SDCH5EBA.js";
 import {
   RawEventSampleEventTypes,
   SentimentIdempotencyConflict,
@@ -184,7 +184,7 @@ import {
   userSessions,
   users,
   writeNegativeReviewMaxStars
-} from "./chunk-J3NS6NGM.js";
+} from "./chunk-JGLX5WU6.js";
 import {
   ADS_ACTIVATE_SCOPE,
   ADS_ACTIVATION_ABSOLUTE_MAX_ENTITIES,
@@ -1240,6 +1240,7 @@ import {
   trafficSampleClassifierSchema,
   trafficSamplesQuerySchema,
   trafficSamplesResponseSchema,
+  trafficSeriesGranularitySchema,
   trafficSourceDetailDtoSchema,
   trafficSourceDtoSchema,
   trafficSourceListResponseSchema,
@@ -1283,7 +1284,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-CVCUADCM.js";
+} from "./chunk-W4ZRFNOX.js";
 
 // ../api-routes/src/user-session.ts
 import crypto2 from "crypto";
@@ -31585,17 +31586,7 @@ function emptyAiCounts() {
 }
 var AI_ATTRIBUTION_PREFERRED_DIMENSION = "session";
 function pickWinningAttributionDimension(sessionsByDimension) {
-  let winner;
-  let winnerSessions = -1;
-  for (const [dimension, sessions] of sessionsByDimension) {
-    const beatsOnCount = sessions > winnerSessions;
-    const winsTie = sessions === winnerSessions && dimension === AI_ATTRIBUTION_PREFERRED_DIMENSION;
-    if (beatsOnCount || winsTie) {
-      winnerSessions = sessions;
-      winner = dimension;
-    }
-  }
-  return winner;
+  return sessionsByDimension.has(AI_ATTRIBUTION_PREFERRED_DIMENSION) ? AI_ATTRIBUTION_PREFERRED_DIMENSION : void 0;
 }
 function resolveWinningDimensions(rows) {
   const groups = /* @__PURE__ */ new Map();
@@ -44010,7 +44001,7 @@ var routeCatalog = [
       { name: "kind", in: "query", description: 'Filter to "crawler", "ai-user-fetch", "ai-referral", a comma-separated list of them (e.g. "ai-user-fetch,ai-referral"), or "all" (default). Rows, totals and series cover only the kinds asked for.', schema: stringSchema },
       { name: "limit", in: "query", description: "Max newest combined detail rows in the events array (default 500, max 5000).", schema: stringSchema },
       { name: "sourceId", in: "query", description: "Restrict to a single traffic source.", schema: stringSchema },
-      { name: "granularity", in: "query", description: 'Full-window series bucket size: "hour" (default) or "day".', schema: { type: "string", enum: ["hour", "day"] } }
+      { name: "granularity", in: "query", description: 'Full-window series bucket size: "hour" (default), "day" or "month" (UTC calendar months).', schema: { type: "string", enum: ["hour", "day", "month"] } }
     ],
     responses: {
       200: jsonResponse("Events returned with windowed totals.", "TrafficEventsResponse"),
@@ -60049,9 +60040,10 @@ function withSessionShares(rows) {
 }
 var DAY_MS4 = 864e5;
 var GA_TREND_FILLING_DAYS = 2;
+var gaFillingFrom = (now) => new Date(Date.parse(now.toISOString().slice(0, 10)) - (GA_TREND_FILLING_DAYS - 1) * DAY_MS4).toISOString().slice(0, 10);
 function aiReferralDailyTrend(days, measuredDates, firstAiDate, now) {
   if (!firstAiDate) return null;
-  const fillingFrom = new Date(Date.parse(now.toISOString().slice(0, 10)) - (GA_TREND_FILLING_DAYS - 1) * DAY_MS4).toISOString().slice(0, 10);
+  const fillingFrom = gaFillingFrom(now);
   const usable = [...new Set(measuredDates)].filter((date) => date >= firstAiDate && date < fillingFrom).sort();
   if (usable.length < 2) return null;
   const sessionsByDate = new Map(days.map((day) => [day.date, day.sessions]));
@@ -60062,6 +60054,49 @@ function aiReferralDailyTrend(days, measuredDates, firstAiDate, now) {
   const fit = linearTrend(axis.map((date) => measured.has(date) ? sessionsByDate.get(date) ?? 0 : null));
   return fit ? { ...fit, startDate: axis[fit.startIndex], endDate: axis[fit.endIndex] } : null;
 }
+var addMonths = (month, n) => {
+  const [y, m] = month.split("-").map(Number);
+  return new Date(Date.UTC(y, m - 1 + n, 1)).toISOString().slice(0, 7);
+};
+var lastDayOf = (month) => new Date(Date.parse(`${addMonths(month, 1)}-01T00:00:00.000Z`) - DAY_MS4).toISOString().slice(0, 10);
+function aiReferralMonthlySeries(input) {
+  const today = input.now.toISOString().slice(0, 10);
+  const fillingFrom = gaFillingFrom(input.now);
+  const firstDay = input.range.startDate ?? [...input.days.map((day) => day.date), ...input.measuredDates].sort()[0];
+  if (!firstDay) return { months: [], monthlyTrend: null };
+  const lastDay = input.range.endDate && input.range.endDate < today ? input.range.endDate : today;
+  const labels = new Map(input.byEngine.series.map((s) => [s.key, s.label]));
+  const measured = new Set(input.measuredDates);
+  const months = [];
+  for (let month = firstDay.slice(0, 7); month <= lastDay.slice(0, 7); month = addMonths(month, 1)) {
+    const inMonth = (date) => date.startsWith(month);
+    const monthStart = `${month}-01`;
+    const monthEnd = lastDayOf(month);
+    const monthDates = calendarDateRange(monthStart, monthEnd);
+    const days = input.days.filter((day) => inMonth(day.date));
+    const reported = days.length > 0 || monthDates.some((date) => measured.has(date));
+    const engines = /* @__PURE__ */ new Map();
+    for (const day of input.byEngine.days) {
+      if (!inMonth(day.date)) continue;
+      for (const [key, value] of Object.entries(day.values)) engines.set(key, (engines.get(key) ?? 0) + value);
+    }
+    months.push({
+      month,
+      sessions: reported ? days.reduce((sum, day) => sum + day.sessions, 0) : null,
+      complete: reported && monthStart >= firstDay && monthEnd <= lastDay && monthEnd < fillingFrom && monthDates.every((date) => measured.has(date)),
+      engines: [...engines].filter(([, v]) => v > 0).sort((a, b) => b[1] - a[1]).map(([key, sessions]) => ({ key, label: labels.get(key) ?? key, sessions }))
+    });
+  }
+  const fromMonth = input.firstAiDate?.slice(0, 7);
+  const fit = fromMonth ? linearTrend(months.map((m) => m.complete && m.month >= fromMonth ? m.sessions : null)) : null;
+  const monthlyTrend = fit ? {
+    ...fit,
+    startMonth: months[fit.startIndex].month,
+    endMonth: months[fit.endIndex].month,
+    changePct: fit.start > 0 ? deltaPercent(fit.end, fit.start) : null
+  } : null;
+  return { months, monthlyTrend };
+}
 function dateRangeConditions(column, range) {
   const conditions = [];
   if (range.startDate) conditions.push(sql37`${column} >= ${range.startDate}`);
@@ -61207,9 +61242,8 @@ async function ga4Routes(app, opts) {
       // every date in the window) counted one visitor once per row. Withdrawn
       // in 4.135.0; see `ga-ai-referral-aggregation.ts` for why no correct
       // figure can be computed or fetched.
-      // Shares of the rows' own sum, not of `aiSessionsDeduped`: that total
-      // keeps the winning lens per day, these rows one lens per source over the
-      // window, so it can exceed what the rows add up to.
+      // Shares of the rows' own sum, which agrees with `aiSessionsDeduped`:
+      // both count only the session lens across the same window.
       aiReferrals: aiReferralDtos,
       aiEngines: groupAiEngines(aiReferralDtos),
       aiReferralLandingPages: aiReferralLandingPages.map((r) => ({
@@ -61319,7 +61353,12 @@ async function ga4Routes(app, opts) {
     const series = buildAiReferralDailySeries(rows);
     const measuredDates = app.db.selectDistinct({ date: gaDailyTotals.date }).from(gaDailyTotals).where(and74(eq86(gaDailyTotals.projectId, project.id), ...dateRangeConditions(gaDailyTotals.date, range))).all().map((row) => row.date);
     const firstAiDate = app.db.select({ date: sql37`MIN(${gaAiReferrals.date})` }).from(gaAiReferrals).where(eq86(gaAiReferrals.projectId, project.id)).get()?.date ?? null;
-    return { ...series, trend: aiReferralDailyTrend(series.days, measuredDates, firstAiDate, /* @__PURE__ */ new Date()) };
+    const now = /* @__PURE__ */ new Date();
+    return {
+      ...series,
+      trend: aiReferralDailyTrend(series.days, measuredDates, firstAiDate, now),
+      ...aiReferralMonthlySeries({ days: series.days, byEngine: series.byEngine, measuredDates, range, firstAiDate, now })
+    };
   });
   app.get("/projects/:name/ga/social-referral-history", async (request, _reply) => {
     const project = resolveProject(app.db, request.params.name);
@@ -65733,22 +65772,39 @@ function assertCloudflareIngestUrlOutsideWorkerRoute(ingestUrl, workerRouteHost)
 function emptyTrafficSeriesPoint(bucket) {
   return { bucket, crawlerHits: 0, aiUserFetchHits: 0, aiReferralHits: 0, aiReferralLandedHits: 0, crawlerContentHits: 0, measured: true };
 }
-function completeTrafficSeries(windowStart, windowEnd, granularity, pointsByBucket) {
-  const cursor = new Date(windowStart);
-  const last = new Date(windowEnd);
-  if (granularity === TrafficSeriesGranularities.day) {
-    cursor.setUTCHours(0, 0, 0, 0);
-    last.setUTCHours(0, 0, 0, 0);
-  } else {
-    cursor.setUTCMinutes(0, 0, 0);
-    last.setUTCMinutes(0, 0, 0);
+var SERIES_BUCKET_LENGTH = {
+  [TrafficSeriesGranularities.hour]: null,
+  [TrafficSeriesGranularities.day]: 10,
+  [TrafficSeriesGranularities.month]: 7
+};
+function seriesBucketSql(tsHour, granularity) {
+  const length = SERIES_BUCKET_LENGTH[granularity];
+  return length === null ? tsHour : sql40`substr(${tsHour}, 1, ${sql40.raw(String(length))})`;
+}
+function seriesBucketOf(iso2, granularity) {
+  const length = SERIES_BUCKET_LENGTH[granularity];
+  return length === null ? iso2.slice(0, 13) : iso2.slice(0, length);
+}
+function seriesBucketStartMs(bucket, granularity) {
+  if (granularity === TrafficSeriesGranularities.month) return Date.parse(`${bucket}-01T00:00:00.000Z`);
+  if (granularity === TrafficSeriesGranularities.day) return Date.parse(`${bucket}T00:00:00.000Z`);
+  return Date.parse(bucket.length === 13 ? `${bucket}:00:00.000Z` : bucket);
+}
+function nextSeriesBucketStartMs(startMs, granularity) {
+  if (granularity === TrafficSeriesGranularities.month) {
+    const start = new Date(startMs);
+    return Date.UTC(start.getUTCFullYear(), start.getUTCMonth() + 1, 1);
   }
+  return startMs + (granularity === TrafficSeriesGranularities.day ? 864e5 : 36e5);
+}
+function completeTrafficSeries(windowStart, windowEnd, granularity, pointsByBucket) {
+  const firstBucket = seriesBucketOf(windowStart.toISOString(), granularity);
+  const lastBucketStartMs = seriesBucketStartMs(seriesBucketOf(windowEnd.toISOString(), granularity), granularity);
   const points = [];
-  while (cursor <= last) {
-    const bucket = granularity === TrafficSeriesGranularities.day ? cursor.toISOString().slice(0, 10) : cursor.toISOString();
+  for (let ms = seriesBucketStartMs(firstBucket, granularity); ms <= lastBucketStartMs; ms = nextSeriesBucketStartMs(ms, granularity)) {
+    const iso2 = new Date(ms).toISOString();
+    const bucket = granularity === TrafficSeriesGranularities.hour ? iso2 : seriesBucketOf(iso2, granularity);
     points.push(pointsByBucket.get(bucket) ?? emptyTrafficSeriesPoint(bucket));
-    if (granularity === TrafficSeriesGranularities.day) cursor.setUTCDate(cursor.getUTCDate() + 1);
-    else cursor.setUTCHours(cursor.getUTCHours() + 1);
   }
   return points;
 }
@@ -68794,11 +68850,12 @@ async function trafficRoutes(app, opts) {
     const granularityParam = request.query?.granularity;
     let granularity = TrafficSeriesGranularities.hour;
     if (granularityParam !== void 0) {
-      if (granularityParam === TrafficSeriesGranularities.hour || granularityParam === TrafficSeriesGranularities.day) {
-        granularity = granularityParam;
+      const parsed = trafficSeriesGranularitySchema.safeParse(granularityParam);
+      if (parsed.success) {
+        granularity = parsed.data;
       } else {
         throw validationError(
-          `"granularity" must be one of: ${TrafficSeriesGranularities.hour}, ${TrafficSeriesGranularities.day}`
+          `"granularity" must be one of: ${trafficSeriesGranularitySchema.options.join(", ")}`
         );
       }
     }
@@ -68833,7 +68890,7 @@ async function trafficRoutes(app, opts) {
       );
       crawlerTotal = crawlerSegments.content + crawlerSegments.sitemap + crawlerSegments.robots + crawlerSegments.asset + crawlerSegments.other;
       totalEventRows += pathTotals.reduce((sum, row) => sum + Number(row.rows), 0);
-      const crawlerSeriesBucket = granularity === TrafficSeriesGranularities.day ? sql40`substr(${crawlerEventsHourly.tsHour}, 1, 10)` : crawlerEventsHourly.tsHour;
+      const crawlerSeriesBucket = seriesBucketSql(crawlerEventsHourly.tsHour, granularity);
       const distinctPaths = pathTotals.map((r) => ({ pathNormalized: r.pathNormalized }));
       const contentPaths = [];
       const infraPaths = [];
@@ -68904,7 +68961,7 @@ async function trafficRoutes(app, opts) {
       }).from(aiUserFetchEventsHourly).where(userFetchWhere).get();
       aiUserFetchTotal = Number(total?.total ?? 0);
       totalEventRows += Number(total?.rows ?? 0);
-      const userFetchSeriesBucket = granularity === TrafficSeriesGranularities.day ? sql40`substr(${aiUserFetchEventsHourly.tsHour}, 1, 10)` : aiUserFetchEventsHourly.tsHour;
+      const userFetchSeriesBucket = seriesBucketSql(aiUserFetchEventsHourly.tsHour, granularity);
       const userFetchSeries = app.db.select({
         bucket: userFetchSeriesBucket,
         hits: sql40`COALESCE(SUM(${aiUserFetchEventsHourly.hits}), 0)`
@@ -68954,7 +69011,7 @@ async function trafficRoutes(app, opts) {
         Number(total?.organic ?? 0)
       );
       totalEventRows += Number(total?.rows ?? 0);
-      const referralSeriesBucket = granularity === TrafficSeriesGranularities.day ? sql40`substr(${aiReferralEventsHourly.tsHour}, 1, 10)` : aiReferralEventsHourly.tsHour;
+      const referralSeriesBucket = seriesBucketSql(aiReferralEventsHourly.tsHour, granularity);
       const referralSeries = app.db.select({
         bucket: referralSeriesBucket,
         hits: sql40`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
@@ -69020,32 +69077,34 @@ async function trafficRoutes(app, opts) {
         const referralCountingChangedAt = aiReferralOlderCountUntil(app.db, { projectId: project.id, sourceId: sourceIdParam });
         const referralCountingChangedMs = referralCountingChangedAt === null ? null : Date.parse(referralCountingChangedAt);
         const coverageStart = firsts.length ? firsts.slice().sort()[0] : null;
-        const bucketStartMs = (bucket) => Date.parse(
-          granularity === TrafficSeriesGranularities.day ? `${bucket}T00:00:00.000Z` : bucket
-        );
-        const bucketMs = granularity === TrafficSeriesGranularities.day ? 864e5 : 36e5;
+        const bucketStartMs = (bucket) => seriesBucketStartMs(bucket, granularity);
         const lastBucket = points.length ? points[points.length - 1].bucket : null;
         const lastBucketStartMs = lastBucket === null ? null : bucketStartMs(lastBucket);
-        const trailingBucketIsPartial = lastBucketStartMs !== null && Number.isFinite(lastBucketStartMs) && until.getTime() < lastBucketStartMs + bucketMs;
-        const coverageKey = coverageStart === null ? null : granularity === TrafficSeriesGranularities.day ? coverageStart.slice(0, 10) : coverageStart.slice(0, 13);
+        const trailingBucketIsPartial = lastBucketStartMs !== null && Number.isFinite(lastBucketStartMs) && until.getTime() < nextSeriesBucketStartMs(lastBucketStartMs, granularity);
+        const coverageKey = coverageStart === null ? null : seriesBucketOf(coverageStart, granularity);
         for (const pt of points) {
-          pt.measured = coverageKey === null ? false : (granularity === TrafficSeriesGranularities.day ? pt.bucket.slice(0, 10) : pt.bucket.slice(0, 13)) >= coverageKey;
+          pt.measured = coverageKey === null ? false : seriesBucketOf(pt.bucket, granularity) >= coverageKey;
         }
         const firstMeasuredIdx = points.findIndex((pt) => pt.measured);
         const coverageStartMs = coverageStart === null ? null : Date.parse(coverageStart);
-        const leadingBucketIsPartial = firstMeasuredIdx >= 0 && coverageStartMs !== null && Number.isFinite(coverageStartMs) && coverageStartMs > bucketStartMs(points[firstMeasuredIdx].bucket);
+        const leadingBucketIsPartial = firstMeasuredIdx >= 0 && coverageStartMs !== null && Number.isFinite(coverageStartMs) && Math.max(coverageStartMs, since.getTime()) > bucketStartMs(points[firstMeasuredIdx].bucket);
         return {
           granularity,
           points,
           coverageStart,
           aiReferralCountingChangedAt: referralCountingChangedAt,
+          // The same two edges the fits leave out, named for a chart to draw as partial.
+          partialBuckets: [
+            ...firstMeasuredIdx >= 0 && leadingBucketIsPartial ? [points[firstMeasuredIdx].bucket] : [],
+            ...trailingBucketIsPartial && lastBucket !== null && !(points.length - 1 === firstMeasuredIdx && leadingBucketIsPartial) ? [lastBucket] : []
+          ],
           // Two edges are excluded from the fit, both for the same reason: a
           // bucket that is not a full reading must not be treated as one.
           //
           // Leading: unmeasured buckets predate recording, so they are the
           // ABSENCE of a reading, not a reading of zero. The first MEASURED
-          // bucket goes too when recording began inside it, since a fraction of
-          // a bucket read as a whole one slopes the fit up out of nothing.
+          // bucket goes too when recording or the range began inside it, since
+          // a fraction of a bucket read as a whole slopes the fit up out of nothing.
           //
           // Trailing: `until` defaults to now, so the newest bucket holds only
           // the elapsed fraction of the current period. A site flat at 500/day

package/dist/{chunk-NJG6WFRK.js → chunk-QBIIQF3J.js}

@@ -15,7 +15,7 @@ import {
   formatCanonryPluginUpdateHint,
   formatCanonryPluginVersionMismatch,
   skillsClientSchema
-} from "./chunk-CVCUADCM.js";
+} from "./chunk-W4ZRFNOX.js";
 
 // src/commands/skills.ts
 import crypto from "crypto";

package/dist/{chunk-TS5Q63NE.js → chunk-S3HNS2YJ.js}

@@ -2,18 +2,18 @@ import {
   configExists,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-5TPLZD4I.js";
+} from "./chunk-ZZVRDHSK.js";
 import {
   BUNDLED_SKILL_NAMES,
   installSkills
-} from "./chunk-NJG6WFRK.js";
+} from "./chunk-QBIIQF3J.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
 import {
   SKILL_MANIFEST_FILENAME,
   SkillsClients
-} from "./chunk-CVCUADCM.js";
+} from "./chunk-W4ZRFNOX.js";
 
 // src/skills-autosync.ts
 import fs from "fs";

package/dist/{chunk-EWSVH5TU.js → chunk-SDCH5EBA.js}

@@ -1,7 +1,7 @@
 import {
   USAGE_TELEMETRY_HEADERS,
   redactLogString
-} from "./chunk-CVCUADCM.js";
+} from "./chunk-W4ZRFNOX.js";
 
 // ../api-routes/src/request-context.ts
 import { AsyncLocalStorage } from "async_hooks";