@canonry/canonry 4.136.1 → 4.137.0

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

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

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

@@ -10,7 +10,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-OESGFFUO.js";
+} from "./chunk-UVWI6VPP.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -119,7 +119,7 @@ import {
   siteAuditPages,
   siteAuditSnapshots,
   usageCounters
-} from "./chunk-YQ2RXMU2.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,
@@ -173,6 +175,8 @@ import {
   factorStatusFromScore,
   formatIsoDateInTimeZone,
   frameAncestorsHeaderValue,
+  hostMatchesAnyDomain,
+  hostMatchesDomain,
   hostOf,
   isAgentProviderId,
   isBrowserProvider,
@@ -185,16 +189,19 @@ import {
   notFound,
   parseOriginList,
   providerError,
+  registrableDomain,
   resolveSnapshotRequestQueries,
   serializeForInlineScript,
   serializeRunError,
   skillsClientSchema,
   splitList,
   startOfDayHourInTimeZone,
+  textContainsBrandAlias,
+  textContainsDomain,
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-PIMWEIJ3.js";
+} from "./chunk-7RF5EDUO.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -209,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;
 }
@@ -326,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,
@@ -342,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
@@ -728,17 +774,15 @@ function extractCitedDomainsFromSources(groundingSources) {
   return [...domains];
 }
 function extractDomainFromTitle(title) {
-  const trimmed = title.trim().toLowerCase();
-  if (/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\.[a-z]{2,})+$/.test(trimmed)) {
-    return trimmed.replace(/^www\./, "");
-  }
-  return null;
+  const trimmed = title.trim();
+  return registrableDomain(trimmed) ? hostOf(trimmed) : null;
 }
 function extractDomainFromUri(uri) {
   try {
     const url = new URL(uri);
-    const hostname = url.hostname.replace(/^www\./, "").toLowerCase();
-    if (AI_ENGINE_SELF_DOMAINS.chatgpt.some((self) => hostname.includes(self))) {
+    const hostname = hostOf(uri);
+    if (!hostname || !registrableDomain(hostname)) return null;
+    if (hostMatchesAnyDomain(hostname, AI_ENGINE_SELF_DOMAINS.chatgpt)) {
       return null;
     }
     if (hostname === VERTEX_AI_SEARCH_PROXY_DOMAIN) {
@@ -747,8 +791,7 @@ function extractDomainFromUri(uri) {
         try {
           const decoded = decodeURIComponent(redirectPath);
           if (decoded.startsWith("http")) {
-            const realUrl = new URL(decoded);
-            return realUrl.hostname.replace(/^www\./, "");
+            return hostOf(decoded);
           }
         } catch {
         }
@@ -1169,16 +1212,9 @@ function extractCitedDomainsFromSources2(groundingSources) {
   return [...domains];
 }
 function extractDomainFromUri2(uri) {
-  try {
-    const url = new URL(uri);
-    const hostname = url.hostname.replace(/^www\./, "").toLowerCase();
-    if (AI_ENGINE_SELF_DOMAINS.chatgpt.some((self) => hostname.includes(self))) {
-      return null;
-    }
-    return hostname;
-  } catch {
-    return null;
-  }
+  const hostname = hostOf(uri);
+  if (!hostname || !registrableDomain(hostname) || hostMatchesAnyDomain(hostname, AI_ENGINE_SELF_DOMAINS.chatgpt)) return null;
+  return hostname;
 }
 async function generateText2(prompt, config) {
   const model = config.model ?? DEFAULT_MODEL2;
@@ -1538,16 +1574,11 @@ function extractCitedDomainsFromSources3(groundingSources) {
   return [...domains];
 }
 function extractDomainFromUri3(uri) {
-  try {
-    const url = new URL(uri);
-    const hostname = url.hostname.replace(/^www\./, "").toLowerCase();
-    if (AI_ENGINE_SELF_DOMAINS.chatgpt.some((self) => hostname.includes(self))) {
-      return null;
-    }
-    return hostname;
-  } catch {
+  const hostname = hostOf(uri);
+  if (!hostname || !registrableDomain(hostname) || hostMatchesAnyDomain(hostname, AI_ENGINE_SELF_DOMAINS.chatgpt)) {
     return null;
   }
+  return hostname;
 }
 async function generateText3(prompt, config) {
   const model = resolveModel2(config);
@@ -1755,11 +1786,10 @@ async function executeTrackedQuery4(input) {
 }
 function normalizeResult4(raw) {
   const answerText = extractAnswerText2(raw.rawResponse);
-  const citedDomains = extractDomainMentions(answerText);
-  const groundingSources = citedDomains.map((domain) => ({
-    uri: `http://${domain}`,
-    title: domain
-  }));
+  const groundingSources = raw.groundingSources;
+  const citedDomains = [...new Set(
+    groundingSources.map((source) => hostOf(source.uri)).filter((domain) => domain !== null && registrableDomain(domain).length > 0)
+  )];
   return {
     provider: "local",
     answerText,
@@ -1795,19 +1825,6 @@ async function generateText4(prompt, config) {
   );
   return response.choices[0]?.message?.content ?? "";
 }
-function extractDomainMentions(text) {
-  const domains = /* @__PURE__ */ new Set();
-  const urlPattern = /https?:\/\/([a-zA-Z0-9][-a-zA-Z0-9]*(?:\.[a-zA-Z0-9][-a-zA-Z0-9]*)+)/g;
-  let match;
-  while ((match = urlPattern.exec(text)) !== null) {
-    domains.add(match[1].replace(/^www\./, "").toLowerCase());
-  }
-  const domainPattern = /(?:^|[\s(["'])((?:[a-zA-Z0-9][-a-zA-Z0-9]*\.)+(?:com|org|net|io|co|dev|ai|app|edu|gov|biz|info|tech|health|dental|legal|law|med|uk|us|ca|au|de|fr|es|it|nl|se|no|dk|fi|jp|cn|kr|br|mx|ru|in|sg|nz|za)(?:\.[a-zA-Z]{2})?)(?:[\s).,;/"']|$)/g;
-  while ((match = domainPattern.exec(text)) !== null) {
-    domains.add(match[1].replace(/^www\./, "").toLowerCase());
-  }
-  return [...domains];
-}
 function extractServedModel4(rawResponse) {
   return normalizeServedModel(rawResponse.model);
 }
@@ -2186,6 +2203,9 @@ var chatgptTarget = {
       const { result } = await client.Runtime.evaluate({
         expression: `(() => {
           const SELF_DOMAINS = ${selfDomainsLiteral};
+          const isSelfDomain = hostname => SELF_DOMAINS.some(
+            self => hostname === self || hostname.endsWith('.' + self)
+          );
           const sources = [];
           const seen = new Set();
           const turns = document.querySelectorAll('[data-message-author-role="assistant"]');
@@ -2209,7 +2229,7 @@ var chatgptTarget = {
               }
             }
 
-            if (!seen.has(href) && !SELF_DOMAINS.includes(hostname)) {
+            if (!seen.has(href) && !isSelfDomain(hostname)) {
               seen.add(href);
               sources.push({
                 uri: href,
@@ -2226,7 +2246,7 @@ var chatgptTarget = {
             if (href && !seen.has(href)) {
               let hostname = '';
               try { hostname = new URL(href).hostname.replace(/^www\\./, ''); } catch {}
-              if (!SELF_DOMAINS.includes(hostname)) {
+              if (!isSelfDomain(hostname)) {
                 seen.add(href);
                 sources.push({ uri: href, title: title || hostname || href });
               }
@@ -2313,13 +2333,10 @@ async function captureElementScreenshot(client, selector, outputPath) {
 function extractCitedDomains(groundingSources) {
   const domains = /* @__PURE__ */ new Set();
   for (const source of groundingSources) {
-    try {
-      const url = new URL(source.uri);
-      const domain = url.hostname.replace(/^www\./, "").toLowerCase();
-      if (!AI_ENGINE_SELF_DOMAINS.chatgpt.some((self) => domain.includes(self))) {
-        domains.add(domain);
-      }
-    } catch {
+    const domain = hostOf(source.uri);
+    if (domain && registrableDomain(domain)) {
+      if (!hostMatchesAnyDomain(domain, AI_ENGINE_SELF_DOMAINS.chatgpt)) domains.add(domain);
+    } else {
       const titleDomain = extractDomainFromTitle2(source.title);
       if (titleDomain) domains.add(titleDomain);
     }
@@ -2327,12 +2344,9 @@ function extractCitedDomains(groundingSources) {
   return [...domains];
 }
 function extractDomainFromTitle2(title) {
-  const domainPattern = /^(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z]{2,}$/i;
   const firstWord = title.split(/[\s\-–—|]/)[0]?.trim();
-  if (firstWord && domainPattern.test(firstWord)) {
-    return firstWord.replace(/^www\./, "").toLowerCase();
-  }
-  return void 0;
+  if (!firstWord || !registrableDomain(firstWord)) return void 0;
+  return hostOf(firstWord) ?? void 0;
 }
 function normalizeResult5(raw) {
   const answerText = typeof raw.rawResponse.answerText === "string" ? raw.rawResponse.answerText : "";
@@ -2685,16 +2699,9 @@ function extractCitedDomains2(groundingSources) {
   return [...domains];
 }
 function extractDomainFromUri4(uri) {
-  try {
-    const url = new URL(uri);
-    const hostname = url.hostname.replace(/^www\./, "").toLowerCase();
-    if (AI_ENGINE_SELF_DOMAINS.chatgpt.some((self) => hostname.includes(self))) {
-      return null;
-    }
-    return hostname;
-  } catch {
-    return null;
-  }
+  const hostname = hostOf(uri);
+  if (!hostname || !registrableDomain(hostname) || hostMatchesAnyDomain(hostname, AI_ENGINE_SELF_DOMAINS.chatgpt)) return null;
+  return hostname;
 }
 async function generateText5(prompt, config) {
   const model = config.model ?? DEFAULT_MODEL5;
@@ -3105,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";
@@ -3312,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;
   }
@@ -3587,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) => {
@@ -3675,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,
@@ -3731,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";
@@ -5930,7 +5983,7 @@ function aggregateInboundLinksByDomain(links, targetDomain) {
   for (const link of links) {
     const host = hostOf(link.Url);
     if (!host) continue;
-    if (target && (host === target || host.endsWith(`.${target}`))) continue;
+    if (target && hostMatchesDomain(host, target)) continue;
     let urls = byHost.get(host);
     if (!urls) {
       urls = /* @__PURE__ */ new Set();
@@ -7066,7 +7119,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-BKLR57RQ.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-JEFHUGVX.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -10899,16 +10952,6 @@ var FETCH_TIMEOUT_MS2 = 1e4;
 var MAX_TEXT_LENGTH = 4e3;
 var MAX_BODY_BYTES = 512e3;
 var USER_AGENT = "Canonry/1.0 (site-analysis)";
-function extractHostname(domain) {
-  let hostname = domain;
-  try {
-    if (hostname.includes("://")) {
-      hostname = new URL(hostname).hostname;
-    }
-  } catch {
-  }
-  return hostname.replace(/^www\./, "");
-}
 function fetchWithPinnedAddress(target) {
   return new Promise((resolve) => {
     const port = target.url.port ? Number(target.url.port) : 443;
@@ -10965,7 +11008,8 @@ function fetchWithPinnedAddress(target) {
   });
 }
 async function fetchSiteText(domain) {
-  const hostname = extractHostname(domain);
+  const hostname = hostOf(domain);
+  if (!hostname) return "";
   const url = `https://${hostname}`;
   const targetCheck = await resolveWebhookTarget(url);
   if (!targetCheck.ok) return "";
@@ -11084,7 +11128,7 @@ var SnapshotService = class {
   registry;
   async createReport(input) {
     const companyName = input.companyName.trim();
-    const domain = normalizeDomain(input.domain);
+    const domain = hostOf(input.domain) ?? input.domain.trim();
     const manualQueries = normalizeStringList(resolveSnapshotRequestQueries(input));
     const manualCompetitors = normalizeStringList(input.competitors ?? []);
     const providers = this.registry.getAll();
@@ -11092,14 +11136,14 @@ var SnapshotService = class {
       throw new Error("No providers configured. Add at least one provider API key before running canonry snapshot.");
     }
     const analysisProvider = pickAnalysisProvider(this.registry.getApiProviders());
-    const homepageUrl = `https://${extractHostname2(domain)}`;
+    const homepageUrl = `https://${domain}`;
     const [siteText, audit] = await Promise.all([
       fetchSiteText(domain),
       this.runAudit(homepageUrl)
     ]);
     if (manualQueries.length === 0 && !siteText) {
       throw new Error(
-        `Could not analyze https://${extractHostname2(domain)}. Try again with a reachable homepage or pass manual category queries via --queries.`
+        `Could not analyze https://${domain}. Try again with a reachable homepage or pass manual category queries via --queries.`
       );
     }
     const profile = await this.buildProfile({
@@ -11501,36 +11545,30 @@ function buildFallbackRecommendedActions(audit) {
   return uniqueStrings([...weakestFactors, ...defaults]).slice(0, 4);
 }
 function citesTargetDomain(citedDomains, groundingSources, targetDomain) {
-  const normalizedTarget = extractHostname2(targetDomain);
   for (const domain of citedDomains) {
-    if (domainMatches(domain, normalizedTarget)) {
+    if (hostMatchesDomain(domain, targetDomain)) {
       return true;
     }
   }
   for (const source of groundingSources) {
-    if (source.uri && source.uri.toLowerCase().includes(normalizedTarget.toLowerCase())) {
-      return true;
-    }
-    if (source.title && source.title.toLowerCase().includes(normalizedTarget.toLowerCase())) {
-      return true;
-    }
+    if (hostMatchesDomain(source.uri, targetDomain)) return true;
+    if (source.title && hostMatchesDomain(source.title, targetDomain)) return true;
   }
   return false;
 }
 function extractCompetitorsFromResponse(ctx) {
   const competitors2 = /* @__PURE__ */ new Set();
-  const lowerAnswer = ctx.answerText.toLowerCase();
-  const targetDomain = extractHostname2(ctx.targetDomain);
+  const targetDomain = hostOf(ctx.targetDomain) ?? ctx.targetDomain;
   for (const hint of ctx.manualCompetitors) {
     if (isDomainLike(hint)) {
-      const normalizedHint = normalizeDomain(hint);
-      if (domainMatches(normalizedHint, targetDomain)) continue;
-      if (ctx.citedDomains.some((domain) => domainMatches(domain, normalizedHint)) || lowerAnswer.includes(normalizedHint.toLowerCase())) {
+      const normalizedHint = hostOf(hint) ?? hint;
+      if (hostMatchesDomain(normalizedHint, targetDomain)) continue;
+      if (ctx.citedDomains.some((domain) => hostMatchesDomain(domain, normalizedHint)) || textContainsDomain(ctx.answerText, normalizedHint)) {
         competitors2.add(normalizedHint);
       }
       continue;
     }
-    if (hint.length >= 3 && lowerAnswer.includes(hint.toLowerCase())) {
+    if (hint.length >= 3 && textContainsBrandAlias(ctx.answerText, hint)) {
       competitors2.add(hint);
     }
   }
@@ -11579,27 +11617,8 @@ function uniqueStrings(values) {
     values.filter((value) => typeof value === "string").map((value) => value.trim()).filter(Boolean)
   )];
 }
-function normalizeDomain(value) {
-  const trimmed = value.trim();
-  if (!trimmed) return trimmed;
-  try {
-    const url = trimmed.includes("://") ? new URL(trimmed) : new URL(`https://${trimmed}`);
-    return url.hostname.replace(/^www\./, "").toLowerCase();
-  } catch {
-    return trimmed.replace(/^https?:\/\//, "").replace(/\/.*$/, "").replace(/^www\./, "").toLowerCase();
-  }
-}
-function extractHostname2(value) {
-  return normalizeDomain(value);
-}
-function domainMatches(candidate, target) {
-  const normalizedCandidate = normalizeDomain(candidate);
-  const normalizedTarget = normalizeDomain(target);
-  return normalizedCandidate === normalizedTarget || normalizedCandidate.endsWith(`.${normalizedTarget}`);
-}
 function isDomainLike(value) {
-  const normalized = normalizeDomain(value);
-  return normalized.includes(".") && !normalized.includes(" ");
+  return registrableDomain(value).length > 0;
 }
 function clipText(value, length) {
   if (value.length <= length) return value;
@@ -11998,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);
@@ -13127,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;
@@ -13264,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;
@@ -13502,6 +13531,7 @@ function parseQueryResponse(raw, count) {
 }
 
 export {
+  trackCliCommandFinished,
   setTelemetrySource,
   isTelemetryEnabled,
   getOrCreateAnonymousId,