npm - @canonry/canonry - Versions diffs - 4.136.2 → 4.138.0 - Mend

@canonry/canonry 4.136.2 → 4.138.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 (30) hide show

package/assets/assets/{trash-2-C50OeBAV.js → trash-2-nr8RRH47.js} RENAMED Viewed

	@@ -1 +1 @@
1	- import{c as a}from"./index-~~BPpSrJY0~~.js";const c=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],d=a("circle-check",c);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"}]],k=a("circle-question-mark",e);const t=[["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=a("download",t);const o=[["path",{d:"M15 3h6v6",key:"1q9fwt"}],["path",{d:"M10 14 21 3",key:"gplh6r"}],["path",{d:"M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6",key:"a6xqqp"}]],r=a("external-link",o);const n=[["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"}]],y=a("trash-2",n);export{d as C,s as D,r as E,y as T,k as a};
1	+ import{c as a}from"./index-BZgknVrZ.js";const c=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],d=a("circle-check",c);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"}]],k=a("circle-question-mark",e);const t=[["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=a("download",t);const o=[["path",{d:"M15 3h6v6",key:"1q9fwt"}],["path",{d:"M10 14 21 3",key:"gplh6r"}],["path",{d:"M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6",key:"a6xqqp"}]],r=a("external-link",o);const n=[["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"}]],y=a("trash-2",n);export{d as C,s as D,r as E,y as T,k 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-BPpSrJY0.js"></script>
+    <script type="module" crossorigin src="./assets/index-BZgknVrZ.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-DSxTZhaH.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-markdown-6dwjPOKK.js">
-    <link rel="stylesheet" crossorigin href="./assets/index-CglduHCN.css">
+    <link rel="stylesheet" crossorigin href="./assets/index-DY7GziwY.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/{chunk-MXR3GI5L.js → chunk-3KGJ7BXW.js} RENAMED Viewed

@@ -10,7 +10,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-SMFUCXHI.js";
+} from "./chunk-R3GAWKHM.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -119,7 +119,7 @@ import {
   siteAuditPages,
   siteAuditSnapshots,
   usageCounters
-} from "./chunk-YVMQWVNY.js";
+} from "./chunk-GO24URVP.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -129,13 +129,16 @@ import {
   AdsCampaignBiddingTypes,
   AgentProviderIds,
   BacklinkSources,
+  CITED_URL_CAPTURE_VERSION,
   CcReleaseSyncStatuses,
   CodingAgents,
   DiscoveryCompetitorTypes,
   LLM_CAPABILITIES,
   LlmCapabilities,
   MemorySources,
+  ONBOARDING_FLOW_VERSION,
   ProviderNames,
+  ROUTE_CAPABLE_CITED_URL_PROVIDERS,
   ResearchQueryStatuses,
   ResearchRunStatuses,
   RunKinds,
@@ -159,18 +162,21 @@ import {
   agentMemoryUpsertRequestSchema,
   authInvalid,
   authRequired,
+  bucketOnboardingCount,
   buildRunErrorFromMessages,
   classifySkillFile,
   coerceSkillManifest,
   computeBacklinkSummaryMetrics,
   contentActionLabel,
   contentBriefDtoSchema,
+  deriveCitedUrlCandidates,
   determineAnswerMentioned,
   dollarsToMicros,
   effectiveBrandNames,
   effectiveDomains,
   embedClientConfigForRequest,
   factorStatusFromScore,
+  filterCapturedCitedUrls,
   formatIsoDateInTimeZone,
   frameAncestorsHeaderValue,
   hostMatchesAnyDomain,
@@ -180,6 +186,7 @@ import {
   isBrowserProvider,
   isGhostTelemetryEvent,
   isRetryableHttpError,
+  isVertexGroundingRedirect,
   mapWithConcurrency,
   normalizeIdTokens,
   normalizeServedModel,
@@ -199,7 +206,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-GGIRLRAY.js";
+} from "./chunk-RJ7OW6W6.js";
 // src/telemetry.ts
 import crypto from "crypto";
@@ -214,8 +221,42 @@ var ANON_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]
 function shouldDropTelemetryEvent(event, properties) {
   return isGhostTelemetryEvent(event, properties);
 }
+function bucketCliCommandDuration(durationMs) {
+  const duration = Number.isFinite(durationMs) ? Math.max(0, durationMs) : 0;
+  if (duration < 1e3) return "under_1s";
+  if (duration < 1e4) return "1s_to_10s";
+  if (duration < 6e4) return "10s_to_1m";
+  if (duration < 3e5) return "1m_to_5m";
+  if (duration < 18e5) return "5m_to_30m";
+  return "30m_or_more";
+}
+function trackCliCommandFinished(input) {
+  trackEvent(
+    "cli.command.finished",
+    {
+      command: input.command,
+      success: input.success,
+      duration_bucket: bucketCliCommandDuration(input.durationMs),
+      ...input.setupState ? { setup_state: input.setupState } : {}
+    },
+    input.errorCode ? { errorCode: input.errorCode } : void 0
+  );
+}
 var SESSION_ID = crypto.randomUUID();
 var CURRENT_SOURCE = "cli";
+var TELEMETRY_SOURCE_VALUES = /* @__PURE__ */ new Set([
+  "cli",
+  "cli-server",
+  "api",
+  "mcp-server",
+  "wp-plugin",
+  "dashboard",
+  "agent-runtime"
+]);
+function envSourceOverride() {
+  const raw = process.env.CANONRY_TELEMETRY_SOURCE?.trim();
+  return raw && TELEMETRY_SOURCE_VALUES.has(raw) ? raw : void 0;
+}
 function setTelemetrySource(source) {
   CURRENT_SOURCE = source;
 }
@@ -331,9 +372,10 @@ function trackEvent(event, properties, options) {
   const anonymousId = getOrCreateAnonymousId();
   if (!anonymousId) return;
   const payload = {
+    eventId: options?.eventId ?? crypto.randomUUID(),
     anonymousId,
     sessionId: SESSION_ID,
-    source: options?.source ?? CURRENT_SOURCE,
+    source: options?.source ?? envSourceOverride() ?? CURRENT_SOURCE,
     event,
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
     version: VERSION,
@@ -347,13 +389,17 @@ function trackEvent(event, properties, options) {
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
   timeout.unref();
-  fetch(TELEMETRY_ENDPOINT, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(payload),
-    signal: controller.signal
-  }).catch(() => {
-  }).finally(() => clearTimeout(timeout));
+  try {
+    void fetch(TELEMETRY_ENDPOINT, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload),
+      signal: controller.signal
+    }).catch(() => {
+    }).finally(() => clearTimeout(timeout));
+  } catch {
+    clearTimeout(timeout);
+  }
 }
 // src/update-check.ts
@@ -3071,7 +3117,7 @@ import crypto4 from "crypto";
 import fs2 from "fs";
 import path3 from "path";
 import os3 from "os";
-import { and as and2, eq as eq2, inArray, sql as sql2 } from "drizzle-orm";
+import { and as and2, eq as eq2, inArray, ne, sql as sql2 } from "drizzle-orm";
 // src/run-telemetry.ts
 import crypto2 from "crypto";
@@ -3205,6 +3251,87 @@ function releaseDailyQueryQuota(db, input) {
   db.update(usageCounters).set({ count: sql`MAX(0, ${usageCounters.count} - ${input.count})`, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }).where(and(eq(usageCounters.scope, input.scope), eq(usageCounters.period, input.period), eq(usageCounters.metric, "queries"))).run();
 }
+// src/cited-url-capture.ts
+var RESOLUTION_CONCURRENCY = 5;
+var RESOLUTION_TIMEOUT_MS = 5e3;
+var MAX_VERTEX_PROXY_HOPS = 3;
+var REDIRECT_STATUSES = /* @__PURE__ */ new Set([301, 302, 303, 307, 308]);
+function isRouteCapableProvider(provider) {
+  return ROUTE_CAPABLE_CITED_URL_PROVIDERS.includes(provider);
+}
+function parseHttpUrl(value, base) {
+  try {
+    const url = new URL(value, base);
+    if (url.protocol !== "http:" && url.protocol !== "https:") return void 0;
+    url.hash = "";
+    return url;
+  } catch {
+    return void 0;
+  }
+}
+async function resolveVertexGroundingRedirect(value, opts = {}) {
+  const initial = parseHttpUrl(value);
+  if (!initial || !isVertexGroundingRedirect(initial)) return void 0;
+  const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+  const timeoutMs = opts.timeoutMs ?? RESOLUTION_TIMEOUT_MS;
+  let current = initial;
+  for (let hop = 0; hop <= MAX_VERTEX_PROXY_HOPS; hop++) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let response;
+    try {
+      response = await fetchImpl(current, { redirect: "manual", signal: controller.signal });
+    } catch {
+      return void 0;
+    } finally {
+      clearTimeout(timer);
+    }
+    if (!REDIRECT_STATUSES.has(response.status)) return void 0;
+    const location = response.headers.get("location");
+    if (!location) return void 0;
+    const next = parseHttpUrl(location, current.toString());
+    if (!next) return void 0;
+    if (!isVertexGroundingRedirect(next)) return next.toString();
+    current = next;
+  }
+  return void 0;
+}
+async function captureCitedUrls(provider, sources, opts = {}) {
+  const sourceCount = sources.length;
+  if (!isRouteCapableProvider(provider)) {
+    return {
+      citedUrls: null,
+      captureStatus: "unsupported",
+      sourceCount,
+      resolvedCount: 0,
+      captureVersion: CITED_URL_CAPTURE_VERSION
+    };
+  }
+  const candidates = deriveCitedUrlCandidates(sources);
+  const candidateCount = candidates.length;
+  let resolved;
+  try {
+    resolved = await mapWithConcurrency(candidates, RESOLUTION_CONCURRENCY, async (candidate) => {
+      const parsed = parseHttpUrl(candidate);
+      if (!parsed) return void 0;
+      if (!isVertexGroundingRedirect(parsed)) return candidate;
+      return resolveVertexGroundingRedirect(candidate, opts);
+    });
+  } catch {
+    resolved = candidates.map(() => void 0);
+  }
+  const acceptedPerSource = resolved.map((value) => filterCapturedCitedUrls([value]).at(0));
+  const resolvedCount = acceptedPerSource.filter((value) => value !== void 0).length;
+  const captureStatus = resolvedCount === candidateCount ? "complete" : resolvedCount > 0 ? "partial" : "failed";
+  return {
+    citedUrls: filterCapturedCitedUrls(acceptedPerSource),
+    captureStatus,
+    sourceCount,
+    resolvedCount,
+    captureVersion: CITED_URL_CAPTURE_VERSION
+  };
+}
 // src/job-runner.ts
 var log = createLogger("JobRunner");
 var RunCancelledError = class extends Error {
@@ -3278,10 +3405,18 @@ function classifyOneProviderError(message) {
   return "UNKNOWN";
 }
 var JobRunner = class {
+  /**
+   * Invoked exactly when `activation.completed` is emitted: the project's
+   * first non-empty, non-probe answer-visibility result. The serve process
+   * uses it to thank the operator once; it is a UX hook, not telemetry, so it
+   * fires (and is given) independently of whether telemetry is enabled.
+   */
+  onFirstActivation;
   db;
   registry;
   onRunCompleted;
-  constructor(db, registry) {
+  constructor(db, registry, opts) {
+    this.onFirstActivation = opts?.onFirstActivation;
     this.db = db;
     this.registry = registry;
   }
@@ -3420,7 +3555,31 @@ var JobRunner = class {
               config
             );
             this.throwIfRunCancelled(runId);
-            const normalized = adapter.normalizeResult(raw);
+            const providerResult = adapter.normalizeResult(raw);
+            const rawGroundingSources = providerResult.groundingSources;
+            const normalized = {
+              ...providerResult,
+              groundingSources: Array.isArray(rawGroundingSources) ? rawGroundingSources : []
+            };
+            let citedUrlCapture;
+            try {
+              citedUrlCapture = await captureCitedUrls(providerName, rawGroundingSources);
+            } catch (err) {
+              citedUrlCapture = {
+                citedUrls: [],
+                captureStatus: "failed",
+                sourceCount: normalized.groundingSources.length,
+                resolvedCount: 0,
+                captureVersion: CITED_URL_CAPTURE_VERSION
+              };
+              log.warn("query.cited-url-capture-failed", {
+                runId,
+                provider: providerName,
+                query: q.query,
+                error: err instanceof Error ? err.message : String(err)
+              });
+            }
+            this.throwIfRunCancelled(runId);
             log.info("query.result", { runId, provider: providerName, query: q.query, citedDomains: normalized.citedDomains, groundingSources: normalized.groundingSources.map((s) => s.uri), matchDomains: allDomains });
             const citationState = determineCitationState(normalized, allDomains);
             const answerMentioned = determineAnswerMentioned(
@@ -3456,6 +3615,11 @@ var JobRunner = class {
                 answerMentioned,
                 answerText: normalized.answerText,
                 citedDomains: normalized.citedDomains,
+                citedUrls: citedUrlCapture.citedUrls,
+                captureStatus: citedUrlCapture.captureStatus,
+                sourceCount: citedUrlCapture.sourceCount,
+                resolvedCount: citedUrlCapture.resolvedCount,
+                captureVersion: citedUrlCapture.captureVersion,
                 competitorOverlap: overlap,
                 recommendedCompetitors: extractedCompetitors,
                 location: runLocation?.label ?? null,
@@ -3482,6 +3646,11 @@ var JobRunner = class {
                 answerMentioned,
                 answerText: normalized.answerText,
                 citedDomains: normalized.citedDomains,
+                citedUrls: citedUrlCapture.citedUrls,
+                captureStatus: citedUrlCapture.captureStatus,
+                sourceCount: citedUrlCapture.sourceCount,
+                resolvedCount: citedUrlCapture.resolvedCount,
+                captureVersion: citedUrlCapture.captureVersion,
                 competitorOverlap: overlap,
                 recommendedCompetitors: extractedCompetitors,
                 location: runLocation?.label ?? null,
@@ -3553,6 +3722,19 @@ var JobRunner = class {
         }),
         failureCode ? { errorCode: failureCode } : void 0
       );
+      if (existingRun.kind === "answer-visibility" && runTrigger !== "probe" && totalSnapshotsInserted > 0 && !this.hasPriorActivation(projectId, runId)) {
+        trackEvent("activation.completed", {
+          flowVersion: ONBOARDING_FLOW_VERSION,
+          status: finalStatus,
+          providerCountBucket: bucketOnboardingCount(executionContext.providerCount),
+          queryCountBucket: bucketOnboardingCount(executionContext.queryCount),
+          snapshotCountBucket: bucketOnboardingCount(totalSnapshotsInserted)
+        });
+        try {
+          this.onFirstActivation?.();
+        } catch {
+        }
+      }
       this.incrementUsage(projectId, "runs", 1);
       if (this.onRunCompleted) {
         this.onRunCompleted(runId, projectId).catch((err) => {
@@ -3641,8 +3823,18 @@ var JobRunner = class {
     }
     providerReservations.clear();
   }
+  hasPriorActivation(projectId, currentRunId) {
+    return this.db.select({ id: querySnapshots.id }).from(querySnapshots).innerJoin(runs, eq2(querySnapshots.runId, runs.id)).where(and2(
+      eq2(runs.projectId, projectId),
+      eq2(runs.kind, "answer-visibility"),
+      inArray(runs.status, ["completed", "partial"]),
+      ne(runs.trigger, "probe"),
+      ne(runs.id, currentRunId)
+    )).limit(1).get() !== void 0;
+  }
   getRunState(runId) {
     return this.db.select({
+      kind: runs.kind,
       status: runs.status,
       finishedAt: runs.finishedAt,
       error: runs.error,
@@ -3697,6 +3889,21 @@ function buildPhases(input) {
   return { setup_ms, provider_call_ms, total_ms };
 }
+// src/activation-notice.ts
+var ACTIVATION_NOTICE = "\n\u2605 First sweep finished. Your AI visibility baseline is in the dashboard.\n  If Canonry is useful, a GitHub star helps others find it:\n  https://github.com/Canonry/canonry\n\n";
+function maybeShowActivationNotice(io = {}) {
+  const isTTY = io.isTTY ?? Boolean(process.stderr.isTTY);
+  const write = io.write ?? ((line) => process.stderr.write(line));
+  try {
+    if (!isTTY) return;
+    const raw = loadConfigRaw();
+    if (!raw || raw.activationNoticeShown === true) return;
+    saveConfigPatch({ activationNoticeShown: true });
+    write(ACTIVATION_NOTICE);
+  } catch {
+  }
+}
 // src/gsc-sync.ts
 import crypto5 from "crypto";
 import { eq as eq3, and as and3, sql as sql3 } from "drizzle-orm";
@@ -7032,7 +7239,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-BD6BHTEJ.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-5RJHJLYA.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -11930,7 +12137,12 @@ async function createServer(opts) {
   }
   const port = opts.config.port ?? 4100;
   const serverUrl = `http://localhost:${port}`;
-  const jobRunner = new JobRunner(opts.db, registry);
+  const jobRunner = new JobRunner(opts.db, registry, {
+    // The one-time first-sweep thank-you. Lives on the serve console because
+    // runs execute here, including the foreground serve that init hands off
+    // to. TTY-gated inside, so supervised deployments never see it.
+    onFirstActivation: () => maybeShowActivationNotice()
+  });
   jobRunner.recoverStaleRuns();
   const notifier = new Notifier(opts.db, serverUrl);
   const intelligenceService = new IntelligenceService(opts.db);
@@ -13059,6 +13271,7 @@ async function createServer(opts) {
         app.log.error({ runId, err }, "Job runner failed");
       });
     },
+    getRunnableProviderNames: () => registry.getAll().map((provider) => provider.adapter.name),
     onProviderUpdate: (providerName, apiKey, model, baseUrl, incomingQuota) => {
       const name = providerName;
       if (!adapterMap[name]) return null;
@@ -13196,6 +13409,10 @@ async function createServer(opts) {
       saveConfigPatch(config);
       opts.config.telemetry = enabled;
     },
+    recordOnboardingEvent: (event) => {
+      const { event: eventName, eventId, ...properties } = event;
+      trackEvent(eventName, properties, { source: "dashboard", eventId });
+    },
     onCdpConfigure: async (host, port2) => {
       if (!opts.config.cdp) opts.config.cdp = {};
       opts.config.cdp.host = host;
@@ -13434,6 +13651,7 @@ function parseQueryResponse(raw, count) {
 }
 export {
+  trackCliCommandFinished,
   setTelemetrySource,
   isTelemetryEnabled,
   getOrCreateAnonymousId,