@canonry/canonry 4.136.2 → 4.137.0

package/assets/assets/{trash-2-C50OeBAV.js → trash-2-BE5oH1Tj.js}

@@ -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};
+import{c as a}from"./index-BNulljlk.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

@@ -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-BPpSrJY0.js"></script>
+    <script type="module" crossorigin src="./assets/index-BNulljlk.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">

package/dist/{chunk-GGIRLRAY.js → chunk-7RF5EDUO.js}

@@ -53,6 +53,22 @@ function quotaExceeded(metric, details) {
 function providerError(message, details) {
   return new AppError("PROVIDER_ERROR", message, 502, details);
 }
+function noProvider(projectName, details) {
+  return new AppError(
+    "NO_PROVIDER",
+    `No runnable answer provider is configured for '${projectName}'. Configure a provider before starting a run.`,
+    503,
+    { projectName, ...details }
+  );
+}
+function noQueries(projectName) {
+  return new AppError(
+    "NO_QUERIES",
+    `Project '${projectName}' has no tracked queries. Add at least one query before starting a run.`,
+    422,
+    { projectName }
+  );
+}
 function runInProgress(projectName) {
   return new AppError("RUN_IN_PROGRESS", `A run is already in progress for '${projectName}'`, 409);
 }
@@ -9364,14 +9380,14 @@ function round(value, dp = 4) {
   const f = 10 ** dp;
   return (Math.round(value * f) + 0) / f;
 }
-function wilsonInterval(successes, n, z39 = 1.96) {
+function wilsonInterval(successes, n, z40 = 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 = z39 * z39;
+  const z210 = z40 * z40;
   const denom = 1 + z210 / n;
   const center = (p + z210 / (2 * n)) / denom;
-  const margin = z39 / denom * Math.sqrt(p * (1 - p) / n + z210 / (4 * n * n));
+  const margin = z40 / 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))
@@ -10471,6 +10487,80 @@ function serializeForInlineScript(value) {
 }
 
 // ../contracts/src/telemetry.ts
+import { z as z39 } from "zod";
+var ONBOARDING_FLOW_VERSION = 1;
+var onboardingStepSchema = z39.enum([
+  "system",
+  "project",
+  "queries",
+  "competitors",
+  "run"
+]);
+var onboardingCountBucketSchema = z39.enum([
+  "0",
+  "1",
+  "2-3",
+  "4-5",
+  "6-10",
+  "11+"
+]);
+function bucketOnboardingCount(value) {
+  if (!Number.isFinite(value) || value <= 0) return "0";
+  if (value < 2) return "1";
+  if (value < 4) return "2-3";
+  if (value < 6) return "4-5";
+  if (value < 11) return "6-10";
+  return "11+";
+}
+var onboardingBlockReasonSchema = z39.enum([
+  "api_unavailable",
+  "database_unavailable",
+  "worker_unavailable",
+  "no_provider",
+  "no_queries",
+  "provider_save_failed",
+  "project_create_failed",
+  "query_save_failed",
+  "run_rejected",
+  "run_failed",
+  "run_cancelled",
+  "unknown"
+]);
+var onboardingEventBaseSchema = z39.object({
+  eventId: z39.string().uuid(),
+  flowVersion: z39.literal(ONBOARDING_FLOW_VERSION),
+  onboardingSessionId: z39.string().uuid()
+});
+var onboardingTelemetryEventSchema = z39.discriminatedUnion("event", [
+  onboardingEventBaseSchema.extend({
+    event: z39.literal("onboarding.started"),
+    step: onboardingStepSchema,
+    resumed: z39.boolean()
+  }).strict(),
+  onboardingEventBaseSchema.extend({
+    event: z39.literal("onboarding.step_completed"),
+    step: onboardingStepSchema,
+    method: z39.enum(["existing", "inline", "manual", "generated", "skipped", "automatic"]),
+    countBucket: onboardingCountBucketSchema.optional()
+  }).strict(),
+  onboardingEventBaseSchema.extend({
+    event: z39.literal("onboarding.blocked"),
+    step: onboardingStepSchema,
+    action: z39.enum(["continue", "configure_provider", "generate_queries", "save", "launch_run", "retry_run"]),
+    reasonCode: onboardingBlockReasonSchema
+  }).strict(),
+  onboardingEventBaseSchema.extend({
+    event: z39.literal("run.requested"),
+    origin: z39.literal("dashboard_setup"),
+    result: z39.enum(["queued", "rejected"]),
+    providerCountBucket: onboardingCountBucketSchema,
+    queryCountBucket: onboardingCountBucketSchema,
+    reasonCode: onboardingBlockReasonSchema.optional()
+  }).strict()
+]);
+var telemetryEventAcceptedDtoSchema = z39.object({
+  accepted: z39.boolean()
+});
 var GHOST_TELEMETRY_TEST_LOCATIONS = /* @__PURE__ */ new Set(["nyc", "lax", "chi"]);
 function isGhostTelemetryEvent(eventName, properties) {
   if (eventName !== "run.completed" && eventName !== "run.aborted") return false;
@@ -10505,6 +10595,8 @@ export {
   forbidden,
   quotaExceeded,
   providerError,
+  noProvider,
+  noQueries,
   runInProgress,
   operationInProgress,
   runNotCancellable,
@@ -10901,5 +10993,9 @@ export {
   normalizeIdTokens,
   embedClientConfigForRequest,
   serializeForInlineScript,
+  ONBOARDING_FLOW_VERSION,
+  bucketOnboardingCount,
+  onboardingTelemetryEventSchema,
+  telemetryEventAcceptedDtoSchema,
   isGhostTelemetryEvent
 };

package/dist/{chunk-YVMQWVNY.js → chunk-PBTB3FCN.js}

@@ -264,6 +264,8 @@ import {
   mentionStateFromAnswerMentioned,
   missingDependency,
   modelIdsEquivalent,
+  noProvider,
+  noQueries,
   normalizeIdTokens,
   normalizeModelId,
   normalizeProjectAliases,
@@ -273,6 +275,7 @@ import {
   notFound,
   notImplemented,
   notificationDtoSchema,
+  onboardingTelemetryEventSchema,
   operationInProgress,
   orderLocationsDefaultFirst,
   organicEvidenceDtoSchema,
@@ -338,6 +341,7 @@ import {
   summarizeCheckResults,
   surfaceClassFromCompetitorType,
   surfaceClassLabel,
+  telemetryEventAcceptedDtoSchema,
   textContainsAnyBrandAlias,
   textContainsBrandAlias,
   textContainsDomain,
@@ -373,7 +377,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-GGIRLRAY.js";
+} from "./chunk-7RF5EDUO.js";
 
 // src/intelligence-service.ts
 import { eq as eq44, desc as desc21, asc as asc9, and as and35, ne as ne6, or as or10, inArray as inArray15, gte as gte12, lte as lte8 } from "drizzle-orm";
@@ -7969,9 +7973,20 @@ async function runRoutes(app, opts) {
       rawProviders.splice(0, rawProviders.length, ...normalized);
     }
     const providers = rawProviders?.length ? rawProviders : void 0;
+    const shouldPreflight = trigger !== RunTriggers.probe && opts.getRunnableProviderNames !== void 0;
+    const trackedRows = body.queries?.length || shouldPreflight ? app.db.select({ query: queries.query }).from(queries).where(eq8(queries.projectId, project.id)).all() : [];
+    if (shouldPreflight) {
+      const preflightError = answerVisibilityPreflightError({
+        projectName: project.name,
+        projectProviders: project.providers,
+        requestedProviders: providers,
+        runnableProviderNames: opts.getRunnableProviderNames(),
+        trackedQueryCount: trackedRows.length
+      });
+      if (preflightError) throw preflightError;
+    }
     let scopedQueries = null;
     if (body.queries?.length) {
-      const trackedRows = app.db.select({ query: queries.query }).from(queries).where(eq8(queries.projectId, project.id)).all();
       const tracked = new Set(trackedRows.map((r) => r.query));
       const missing = body.queries.filter((q) => !tracked.has(q));
       if (missing.length) {
@@ -8135,7 +8150,28 @@ async function runRoutes(app, opts) {
     const providers = rawProviders?.length ? rawProviders : void 0;
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const results = [];
+    const runnableProviderNames = opts.getRunnableProviderNames?.();
     for (const project of allProjects) {
+      if (runnableProviderNames) {
+        const trackedQuery = app.db.select({ id: queries.id }).from(queries).where(eq8(queries.projectId, project.id)).limit(1).get();
+        const preflightError = answerVisibilityPreflightError({
+          projectName: project.name,
+          projectProviders: project.providers,
+          requestedProviders: providers,
+          runnableProviderNames,
+          trackedQueryCount: trackedQuery ? 1 : 0
+        });
+        if (preflightError) {
+          results.push({
+            projectName: project.name,
+            projectId: project.id,
+            status: "error",
+            error: preflightError.message,
+            errorCode: preflightError.code
+          });
+          continue;
+        }
+      }
       const projectLocations = project.locations;
       let resolvedLocation;
       if (project.defaultLocation) {
@@ -8199,6 +8235,26 @@ async function runRoutes(app, opts) {
     return reply.send(loadRunDetail(app, run));
   });
 }
+function answerVisibilityPreflightError(input) {
+  if (input.trackedQueryCount === 0) {
+    return noQueries(input.projectName);
+  }
+  const availableProviders = normalizeProviderNames(input.runnableProviderNames);
+  const requestedProviders = normalizeProviderNames(input.requestedProviders ?? []);
+  const projectProviders = normalizeProviderNames(input.projectProviders);
+  const selectedProviders = requestedProviders.length > 0 ? requestedProviders : projectProviders.length > 0 ? projectProviders : availableProviders;
+  const available = new Set(availableProviders);
+  const runnableProviders = selectedProviders.filter((provider) => available.has(provider));
+  if (runnableProviders.length > 0) return null;
+  return noProvider(input.projectName, {
+    availableProviders,
+    selectedProviders,
+    selectionSource: requestedProviders.length > 0 ? "request" : projectProviders.length > 0 ? "project" : "instance"
+  });
+}
+function normalizeProviderNames(providerNames) {
+  return [...new Set(providerNames.map((name) => name.trim().toLowerCase()).filter(Boolean))];
+}
 function parseRunTriggerRequest(value) {
   const result = runTriggerRequestSchema.safeParse(value);
   if (result.success) return result.data;
@@ -17456,6 +17512,7 @@ var SCHEMA_TABLE = {
   LatestProjectRunDto: latestProjectRunDtoSchema,
   LocationContext: locationContextSchema,
   NotificationDto: notificationDtoSchema,
+  OnboardingTelemetryEvent: onboardingTelemetryEventSchema,
   OrganicEvidenceDto: organicEvidenceDtoSchema,
   ProjectDto: projectDtoSchema,
   ProjectUpsertRequest: projectUpsertRequestSchema,
@@ -17477,6 +17534,7 @@ var SCHEMA_TABLE = {
   SnapshotListResponse: snapshotListResponseSchema,
   SnapshotReportDto: snapshotReportSchema,
   SourceBreakdownDto: sourceBreakdownDtoSchema,
+  TelemetryEventAcceptedDto: telemetryEventAcceptedDtoSchema,
   TrafficBackfillResponse: trafficBackfillResponseSchema,
   TrafficEventsResponse: trafficEventsResponseSchema,
   TrafficSourceDetailDto: trafficSourceDetailDtoSchema,
@@ -18502,7 +18560,9 @@ var routeCatalog = [
     },
     responses: {
       201: jsonResponse("Run queued.", "RunDto"),
-      409: errorResponse("Run already in progress.")
+      422: errorResponse("Project has no tracked queries."),
+      409: errorResponse("Run already in progress."),
+      503: errorResponse("No runnable answer provider is configured.")
     }
   },
   {
@@ -19127,6 +19187,24 @@ var routeCatalog = [
       501: errorResponse("Telemetry configuration is not available.")
     }
   },
+  {
+    method: "post",
+    path: "/api/v1/telemetry/onboarding",
+    summary: "Record a privacy-safe onboarding milestone",
+    tags: ["telemetry"],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: { $ref: "#/components/schemas/OnboardingTelemetryEvent" }
+        }
+      }
+    },
+    responses: {
+      202: jsonResponse("Onboarding milestone accepted.", "TelemetryEventAcceptedDto"),
+      400: errorResponse("Invalid onboarding telemetry event.")
+    }
+  },
   {
     method: "get",
     path: "/api/v1/screenshots/{snapshotId}",
@@ -22777,6 +22855,19 @@ async function telemetryRoutes(app, opts) {
       anonymousId: status?.anonymousId ? status.anonymousId.slice(0, 8) + "..." : void 0
     };
   });
+  app.post("/telemetry/onboarding", async (request, reply) => {
+    const parsed = onboardingTelemetryEventSchema.safeParse(request.body);
+    if (!parsed.success) {
+      throw validationError("Invalid onboarding telemetry event", {
+        issues: parsed.error.issues.map((issue) => ({
+          code: issue.code,
+          path: issue.path.join(".")
+        }))
+      });
+    }
+    opts.recordOnboardingEvent?.(parsed.data);
+    return reply.status(202).send({ accepted: Boolean(opts.recordOnboardingEvent) });
+  });
 }
 
 // ../api-routes/src/schedules.ts
@@ -24798,6 +24889,24 @@ function stableStringify3(value) {
 }
 
 // ../api-routes/src/google.ts
+var GOOGLE_OAUTH_COMPLETE_MESSAGE = "canonry:google-oauth-complete";
+function googleOAuthSuccessHtml(type) {
+  const message = JSON.stringify({
+    type: GOOGLE_OAUTH_COMPLETE_MESSAGE,
+    connectionType: type
+  });
+  return `<html><body style="font-family:system-ui;text-align:center;padding:60px">
+    <h2>Connected successfully!</h2>
+    <p>Google ${type.toUpperCase()} has been linked to your domain.</p>
+    <p style="color:#888">This window closes automatically.</p>
+    <script>
+      if (window.opener && !window.opener.closed) {
+        window.opener.postMessage(${message}, '*')
+        window.close()
+      }
+    </script>
+  </body></html>`;
+}
 function isOnProjectDomain(url, projectDomain) {
   const urlHost = hostOf(url);
   const projectHost = hostOf(projectDomain);
@@ -25123,13 +25232,7 @@ async function googleRoutes(app, opts) {
       entityId: type,
       diff: { domain, type, propertyId }
     });
-    return reply.type("text/html").send(
-      `<html><body style="font-family:system-ui;text-align:center;padding:60px">
-        <h2>Connected successfully!</h2>
-        <p>Google ${type.toUpperCase()} has been linked to your domain.</p>
-        <p style="color:#888">You can close this tab.</p>
-      </body></html>`
-    );
+    return reply.type("text/html").send(googleOAuthSuccessHtml(type));
   }
   app.get("/google/callback", async (request, reply) => {
     return handleOAuthCallback(request, reply);
@@ -44159,7 +44262,8 @@ async function apiRoutes(app, opts) {
     await api.register(competitorRoutes);
     await api.register(runRoutes, {
       onRunCreated: opts.onRunCreated,
-      validProviderNames: opts.providerAdapters?.map((a) => a.name)
+      validProviderNames: opts.providerAdapters?.map((a) => a.name),
+      getRunnableProviderNames: opts.getRunnableProviderNames
     });
     await api.register(applyRoutes, {
       onScheduleUpdated: opts.onScheduleUpdated,
@@ -44210,7 +44314,8 @@ async function apiRoutes(app, opts) {
     });
     await api.register(telemetryRoutes, {
       getTelemetryStatus: opts.getTelemetryStatus,
-      setTelemetryEnabled: opts.setTelemetryEnabled
+      setTelemetryEnabled: opts.setTelemetryEnabled,
+      recordOnboardingEvent: opts.recordOnboardingEvent
     });
     await api.register(adsRoutes, {
       adsCredentialStore: opts.adsCredentialStore,

package/dist/{chunk-SMFUCXHI.js → chunk-UVWI6VPP.js}

@@ -42,7 +42,7 @@ import {
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema,
   trafficSeriesGranularitySchema
-} from "./chunk-GGIRLRAY.js";
+} from "./chunk-7RF5EDUO.js";
 
 // src/config.ts
 import fs from "fs";

package/dist/{chunk-MXR3GI5L.js → chunk-XEX5CLQW.js}

@@ -10,7 +10,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-SMFUCXHI.js";
+} from "./chunk-UVWI6VPP.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -119,7 +119,7 @@ import {
   siteAuditPages,
   siteAuditSnapshots,
   usageCounters
-} from "./chunk-YVMQWVNY.js";
+} from "./chunk-PBTB3FCN.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -135,6 +135,7 @@ import {
   LLM_CAPABILITIES,
   LlmCapabilities,
   MemorySources,
+  ONBOARDING_FLOW_VERSION,
   ProviderNames,
   ResearchQueryStatuses,
   ResearchRunStatuses,
@@ -159,6 +160,7 @@ import {
   agentMemoryUpsertRequestSchema,
   authInvalid,
   authRequired,
+  bucketOnboardingCount,
   buildRunErrorFromMessages,
   classifySkillFile,
   coerceSkillManifest,
@@ -199,7 +201,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-GGIRLRAY.js";
+} from "./chunk-7RF5EDUO.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -214,8 +216,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 +367,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 +384,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 +3112,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";
@@ -3278,10 +3319,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;
   }
@@ -3553,6 +3602,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 +3703,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 +3769,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 +7119,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-JEFHUGVX.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -11930,7 +12017,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 +13151,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 +13289,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 +13531,7 @@ function parseQueryResponse(raw, count) {
 }
 
 export {
+  trackCliCommandFinished,
   setTelemetrySource,
   isTelemetryEnabled,
   getOrCreateAnonymousId,