@canonry/canonry 7.0.0 → 7.1.1

package/dist/{chunk-RRIZ5AKI.js → chunk-U2S5ABOR.js}

@@ -5,7 +5,7 @@ import {
   siteCrawlGraphNodes,
   siteCrawlPages,
   siteCrawlSnapshots
-} from "./chunk-EZ54X4XH.js";
+} from "./chunk-VDX3LYKL.js";
 import {
   SITE_CRAWL_GRAPH_MAX_EDGES,
   SITE_CRAWL_GRAPH_MAX_NODES,
@@ -13,7 +13,7 @@ import {
   TEMPLATE_LINK_RATIO_THRESHOLD,
   factorStatusFromScore,
   roundPreservingTotal
-} from "./chunk-OOUDIVIU.js";
+} from "./chunk-YGHPT5B2.js";
 
 // src/site-audit-factors.ts
 function recordedSharePct(factor) {

package/dist/{chunk-EZ54X4XH.js → chunk-VDX3LYKL.js}

@@ -726,6 +726,7 @@ import {
   stripCitationChips,
   sumInfraHits,
   summarizeCheckResults,
+  summarizeObservedQueryCounts,
   summarizeRunUsage,
   surfaceClassFromCompetitorType,
   surfaceClassLabel,
@@ -750,6 +751,7 @@ import {
   trafficSourceListResponseSchema,
   trafficStatusResponseSchema,
   trafficSyncResponseSchema,
+  uiTelemetryEventSchema,
   unsupportedKind,
   upgradeCaveatFor,
   userDtoSchema,
@@ -777,7 +779,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-OOUDIVIU.js";
+} from "./chunk-YGHPT5B2.js";
 
 // src/intelligence-service.ts
 import { eq as eq82, desc as desc36, asc as asc15, and as and69, ne as ne14, or as or19, inArray as inArray31, gte as gte22, lte as lte20, isNull as isNull16, sql as sql31, exists } from "drizzle-orm";
@@ -19061,7 +19063,7 @@ function evaluateRunFill(db, run, input = {}) {
       "The measurement plan was republished since this run, so answers added now would mix two revisions in one run."
     );
   }
-  const now = (input.now ?? /* @__PURE__ */ new Date()).getTime();
+  const now = Date.now();
   const age = runFillAgeAnchor(run, { hadProviderBatch: runHadProviderBatch(db, run.id) });
   const anchoredAt = Date.parse(age.anchor);
   if (Number.isFinite(anchoredAt) && now - anchoredAt > RUN_FILL_MAX_AGE_MS) {
@@ -19195,7 +19197,7 @@ function queueRunFill(db, runId, input = {}) {
     if (activeFill) return { kind: "fill-in-progress", fillId: activeFill.id };
     const activeSweep = activeSweepFor(txDb, run.projectId);
     if (activeSweep) return { kind: "run-in-progress", activeRunId: activeSweep.id };
-    const now = (input.now ?? /* @__PURE__ */ new Date()).toISOString();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
     const id = crypto14.randomUUID();
     txDb.insert(runFills).values({
       id,
@@ -19777,61 +19779,66 @@ function loadRunDetail(app, run) {
     rawResponse: querySnapshots.rawResponse,
     createdAt: querySnapshots.createdAt
   }).from(querySnapshots).leftJoin(queries, eq24(querySnapshots.queryId, queries.id)).where(eq24(querySnapshots.runId, run.id)).all();
+  const mappedSnapshots = snapshots.map((s) => {
+    const rawParsed = parseSnapshotRawResponse(s.rawResponse);
+    const signalGroundingSources = rawParsed.groundingSources.filter(
+      (source) => typeof source === "object" && source !== null && typeof source.uri === "string"
+    );
+    const competitiveSignals = competitiveSignalResolver.resolve({
+      citedDomains: s.citedDomains,
+      groundingSources: signalGroundingSources,
+      answerText: s.answerText
+    });
+    const answerMentioned = project ? resolveSnapshotAnswerMentioned(s, project) : s.answerMentioned ?? false;
+    return {
+      id: s.id,
+      runId: s.runId,
+      queryId: s.queryId,
+      query: s.query,
+      provider: s.provider,
+      citationState: s.citationState,
+      answerMentioned,
+      // Legacy alias of `mentionState`, retained for backwards compatibility.
+      visibilityState: project ? resolveSnapshotVisibilityState(s, project) : answerMentioned ? "visible" : "not-visible",
+      // Canonical vocabulary for answer-text presence; new consumers prefer this.
+      mentionState: project ? resolveSnapshotMentionState(s, project) : answerMentioned ? "mentioned" : "not-mentioned",
+      answerText: s.answerText,
+      citedDomains: s.citedDomains,
+      citedUrls: s.citedUrls,
+      captureStatus: s.captureStatus,
+      sourceCount: s.sourceCount,
+      resolvedCount: s.resolvedCount,
+      captureVersion: s.captureVersion,
+      ...competitiveSignals,
+      // Legacy mixed signal retained for backwards compatibility.
+      competitorOverlap: s.competitorOverlap,
+      recommendedCompetitors: s.recommendedCompetitors,
+      matchedTerms: project ? resolveSnapshotMatchedTerms(s, project) : [],
+      model: s.model ?? rawParsed.model,
+      // Column only. `model` may fall back to the stored envelope because both
+      // record the same requested value; a served id has no such equivalent —
+      // an unrecoverable one stays null rather than echoing configuration.
+      servedModel: s.servedModel,
+      location: s.location,
+      requestedContext: s.requestedContext,
+      supportedContext: s.supportedContext,
+      dispatchMode: s.dispatchMode,
+      stopReason: s.stopReason,
+      usage: s.usage,
+      groundingSources: rawParsed.groundingSources,
+      searchQueries: rawParsed.searchQueries,
+      createdAt: s.createdAt
+    };
+  });
+  const identifiedSignals = mappedSnapshots.flatMap(
+    (snapshot) => typeof snapshot.queryId === "string" && snapshot.queryId.length > 0 ? [{ queryId: snapshot.queryId, citationState: snapshot.citationState, answerMentioned: snapshot.answerMentioned }] : []
+  );
   return {
     ...formatRun(run),
     providerBatches: readRunProviderBatches(app.db, run.id),
     usage: summarizeRunUsage(snapshots),
-    snapshots: snapshots.map((s) => {
-      const rawParsed = parseSnapshotRawResponse(s.rawResponse);
-      const signalGroundingSources = rawParsed.groundingSources.filter(
-        (source) => typeof source === "object" && source !== null && typeof source.uri === "string"
-      );
-      const competitiveSignals = competitiveSignalResolver.resolve({
-        citedDomains: s.citedDomains,
-        groundingSources: signalGroundingSources,
-        answerText: s.answerText
-      });
-      const answerMentioned = project ? resolveSnapshotAnswerMentioned(s, project) : s.answerMentioned ?? false;
-      return {
-        id: s.id,
-        runId: s.runId,
-        queryId: s.queryId,
-        query: s.query,
-        provider: s.provider,
-        citationState: s.citationState,
-        answerMentioned,
-        // Legacy alias of `mentionState`, retained for backwards compatibility.
-        visibilityState: project ? resolveSnapshotVisibilityState(s, project) : answerMentioned ? "visible" : "not-visible",
-        // Canonical vocabulary for answer-text presence; new consumers prefer this.
-        mentionState: project ? resolveSnapshotMentionState(s, project) : answerMentioned ? "mentioned" : "not-mentioned",
-        answerText: s.answerText,
-        citedDomains: s.citedDomains,
-        citedUrls: s.citedUrls,
-        captureStatus: s.captureStatus,
-        sourceCount: s.sourceCount,
-        resolvedCount: s.resolvedCount,
-        captureVersion: s.captureVersion,
-        ...competitiveSignals,
-        // Legacy mixed signal retained for backwards compatibility.
-        competitorOverlap: s.competitorOverlap,
-        recommendedCompetitors: s.recommendedCompetitors,
-        matchedTerms: project ? resolveSnapshotMatchedTerms(s, project) : [],
-        model: s.model ?? rawParsed.model,
-        // Column only. `model` may fall back to the stored envelope because both
-        // record the same requested value; a served id has no such equivalent —
-        // an unrecoverable one stays null rather than echoing configuration.
-        servedModel: s.servedModel,
-        location: s.location,
-        requestedContext: s.requestedContext,
-        supportedContext: s.supportedContext,
-        dispatchMode: s.dispatchMode,
-        stopReason: s.stopReason,
-        usage: s.usage,
-        groundingSources: rawParsed.groundingSources,
-        searchQueries: rawParsed.searchQueries,
-        createdAt: s.createdAt
-      };
-    })
+    snapshots: mappedSnapshots,
+    queryCounts: identifiedSignals.length === mappedSnapshots.length ? summarizeObservedQueryCounts(identifiedSignals) : null
   };
 }
 
@@ -34050,6 +34057,11 @@ function readEarliestGscDataDate(db, projectId) {
   const dimensioned = db.select({ earliest: min(gscSearchData.date) }).from(gscSearchData).where(eq44(gscSearchData.projectId, projectId)).get()?.earliest ?? null;
   return [property, dimensioned].filter((d) => d !== null).reduce((earliest, d) => earliest === null || d < earliest ? d : earliest, null);
 }
+function readEarliestGscQueryDataDate(db, projectId) {
+  const accurate = db.select({ earliest: min(gscQueryDailyTotals.date) }).from(gscQueryDailyTotals).where(and39(eq44(gscQueryDailyTotals.projectId, projectId), sql17`${gscQueryDailyTotals.date} <> ''`)).get()?.earliest ?? null;
+  const dimensioned = db.select({ earliest: min(gscSearchData.date) }).from(gscSearchData).where(and39(eq44(gscSearchData.projectId, projectId), sql17`${gscSearchData.date} <> ''`)).get()?.earliest ?? null;
+  return [accurate, dimensioned].filter((d) => d !== null).reduce((earliest, d) => earliest === null || d < earliest ? d : earliest, null);
+}
 function readGscDailyTotals(db, projectId, startDate, endDate) {
   const rows = db.select({
     date: gscDailyTotals.date,
@@ -34588,34 +34600,17 @@ function summarizeFromSnapshots(snapshots) {
     providers: []
   };
   if (snapshots.length === 0) return empty;
-  const perQuery = /* @__PURE__ */ new Map();
-  const perQueryMentioned = /* @__PURE__ */ new Map();
+  const { totalQueries, citedQueries, mentionedQueries } = summarizeObservedQueryCounts(snapshots);
   const perProvider = /* @__PURE__ */ new Map();
   for (const snap of snapshots) {
     const cited = snap.citationState === CitationStates.cited;
-    if (!perQuery.has(snap.queryId) || cited) {
-      perQuery.set(snap.queryId, cited);
-    }
-    const mentioned = snap.answerMentioned === true;
-    if (!perQueryMentioned.has(snap.queryId) || mentioned) {
-      perQueryMentioned.set(snap.queryId, mentioned);
-    }
     const bucket = perProvider.get(snap.provider) ?? { cited: 0, total: 0 };
     bucket.total += 1;
     if (cited) bucket.cited += 1;
     perProvider.set(snap.provider, bucket);
   }
-  const totalQueries = perQuery.size;
-  let citedQueries = 0;
-  for (const wasCited of perQuery.values()) {
-    if (wasCited) citedQueries += 1;
-  }
   const notCitedQueries = totalQueries - citedQueries;
   const citedRate = totalQueries === 0 ? 0 : Number((citedQueries / totalQueries).toFixed(4));
-  let mentionedQueries = 0;
-  for (const wasMentioned of perQueryMentioned.values()) {
-    if (wasMentioned) mentionedQueries += 1;
-  }
   const notMentionedQueries = totalQueries - mentionedQueries;
   const mentionRate3 = totalQueries === 0 ? 0 : Number((mentionedQueries / totalQueries).toFixed(4));
   const providers = [...perProvider.entries()].map(([provider, { cited, total }]) => ({
@@ -36011,6 +36006,7 @@ var SCHEMA_TABLE = {
   MeasurementSetupResponse: measurementSetupResponseSchema,
   NotificationDto: notificationDtoSchema,
   OnboardingTelemetryEvent: onboardingTelemetryEventSchema,
+  UiTelemetryEvent: uiTelemetryEventSchema,
   OrganicEvidenceDto: organicEvidenceDtoSchema,
   ProjectCreateRequest: projectCreateRequestSchema,
   ProjectDto: projectDtoSchema,
@@ -38386,6 +38382,7 @@ var routeCatalog = [
     method: "get",
     path: "/api/v1/runs/{id}",
     summary: "Get a run and its snapshots",
+    description: "Includes independent citation and mention counts over distinct observed query IDs in this exact run. queryCounts is null when any snapshot lacks query identity; these counts are not planned-slot completeness.",
     tags: ["runs"],
     parameters: [runIdParameter],
     responses: {
@@ -39175,6 +39172,25 @@ var routeCatalog = [
       400: errorResponse("Invalid onboarding telemetry event.")
     }
   },
+  {
+    method: "post",
+    path: "/api/v1/telemetry/ui",
+    summary: "Record a privacy-safe dashboard usage event",
+    description: "Page views (route patterns), allowlisted feature actions, UI errors (class names and route templates only), and web vitals ratings from the dashboard. Forwarded through the opt-in anonymous telemetry path; accepted:false when this host does not collect telemetry.",
+    tags: ["telemetry"],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: { $ref: "#/components/schemas/UiTelemetryEvent" }
+        }
+      }
+    },
+    responses: {
+      202: jsonResponse("UI event accepted.", "TelemetryEventAcceptedDto"),
+      400: errorResponse("Invalid UI telemetry event.")
+    }
+  },
   {
     method: "post",
     path: "/api/v1/feedback",
@@ -39918,7 +39934,7 @@ var routeCatalog = [
     method: "get",
     path: "/api/v1/projects/{name}/google/gsc/query-totals",
     summary: "Get GSC totals per query for a date window",
-    description: "One row per search query over the window, read from stored sync data (no call to Google, no writes): clicks, impressions, CTR, impression-weighted average position (sum(position*impressions)/sum(impressions)) and the number of days the query appeared. Rows are ordered by clicks desc, impressions desc, then query ascending by code point, and paged with `limit` / `offset`; `totalMatching` counts every query and `truncated` says more rows follow. The rows cover the queries Google names only: Google leaves rare and anonymised queries out of per-query data, so their sum is below the property total (read `/google/gsc/performance/daily` for that). Each row carries `source`: `google` when every day came from Google's per-query fetch, `page-summed` when every day came from the legacy page-dimensioned table (impressions over-count), `mixed` when the window spans both.",
+    description: "One row per search query over the window, read from stored sync data (no call to Google, no writes): clicks, impressions, CTR, impression-weighted average position (sum(position*impressions)/sum(impressions)) and the number of days the query appeared. Rows are ordered by clicks desc, impressions desc, then query ascending by code point, and paged with `limit` / `offset`; `totalMatching` counts every query and `truncated` says more rows follow. The rows cover the queries Google names only: Google leaves rare and anonymised queries out of per-query data, so their sum is below the property total (read `/google/gsc/performance/daily` for that). Each row carries `source`: `google` when every day came from Google's per-query fetch, `page-summed` when every day came from the legacy page-dimensioned table (impressions over-count), `mixed` when the window spans both. `window.earliestDataDate` is the first stored per-query date (null with none): a window that starts before it is only partly covered, so its missing days were never synced rather than zero traffic.",
     tags: ["google"],
     parameters: [
       nameParameter,
@@ -43927,6 +43943,19 @@ async function telemetryRoutes(app, opts) {
     opts.recordOnboardingEvent?.(normalizeOnboardingEventForCollection(parsed.data));
     return reply.status(202).send({ accepted: Boolean(opts.recordOnboardingEvent) });
   });
+  app.post("/telemetry/ui", async (request, reply) => {
+    const parsed = uiTelemetryEventSchema.safeParse(request.body);
+    if (!parsed.success) {
+      throw validationError("Invalid UI telemetry event", {
+        issues: parsed.error.issues.map((issue) => ({
+          code: issue.code,
+          path: issue.path.join(".")
+        }))
+      });
+    }
+    const accepted = opts.recordUiEvent ? opts.recordUiEvent(parsed.data) : false;
+    return reply.status(202).send({ accepted });
+  });
 }
 
 // ../api-routes/src/feedback.ts
@@ -47362,7 +47391,9 @@ async function googleRoutes(app, opts) {
       // Measured from where this page ends, so a page past the end is not
       // reported as truncated.
       truncated: offsetVal + rows.length < totalMatching,
-      window
+      // The floor beside the frontier, so a caller can tell a window the store
+      // does not reach from one with little traffic.
+      window: { ...window, earliestDataDate: readEarliestGscQueryDataDate(app.db, project.id) }
     };
   });
   app.post("/projects/:name/google/gsc/inspect", async (request) => {
@@ -59044,7 +59075,7 @@ async function installDuckdb(opts = {}) {
   const version = readInstalledVersion({ pluginPkgJson }) ?? "unknown";
   return { alreadyPresent: false, version, path: pluginDir };
 }
-async function ensurePluginDir(pluginDir = PLUGIN_DIR, pluginPkgJson = PLUGIN_PKG_JSON) {
+async function ensurePluginDir(pluginDir, pluginPkgJson) {
   await fs4.mkdir(pluginDir, { recursive: true });
   try {
     await fs4.access(pluginPkgJson);
@@ -75230,7 +75261,6 @@ async function resolveRetainedStart(options, unservableStartMs, endMs) {
 async function drainVercelTrafficEvents(options) {
   const startMs = toMs(options.startDate);
   const endMs = toMs(options.endDate);
-  const now = options.now ?? (() => Date.now());
   const events = [];
   const seenEventIds = /* @__PURE__ */ new Set();
   if (endMs <= startMs) {
@@ -75249,7 +75279,7 @@ async function drainVercelTrafficEvents(options) {
   const truncatedSliceStartsMs = [];
   const deadlineSkippedSliceStartsMs = [];
   while (cursorMs < endMs) {
-    if (options.deadlineMs !== void 0 && now() >= options.deadlineMs) {
+    if (options.deadlineMs !== void 0 && Date.now() >= options.deadlineMs) {
       deadlineReached = true;
       if (cursorMs === effectiveStartMs && subWindowCount > 0 && cursorMs < endMs) {
         deadlineSkippedSliceStartsMs.push(cursorMs);
@@ -86928,7 +86958,8 @@ async function apiRoutes(app, opts) {
     await api.register(telemetryRoutes, {
       getTelemetryStatus: opts.getTelemetryStatus,
       setTelemetryEnabled: opts.setTelemetryEnabled,
-      recordOnboardingEvent: opts.recordOnboardingEvent
+      recordOnboardingEvent: opts.recordOnboardingEvent,
+      recordUiEvent: opts.recordUiEvent
     });
     await api.register(feedbackRoutes, {
       submitFeedback: opts.submitFeedback
@@ -88520,6 +88551,7 @@ export {
   createCredentialChecker,
   requireInstanceAdministrator,
   hashApiKey,
+  notProbeRun,
   registerAgentConversationRoutes,
   measurementSlotKey,
   measurementRunSlotState,