@canonry/canonry 7.23.0 → 7.24.0

package/dist/{chunk-KWBFKTOA.js → chunk-YCPTP2NC.js}

@@ -4,14 +4,14 @@ import {
   installSkills,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-UF7MH6TU.js";
+} from "./chunk-JJBVYL45.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-5IXQAOVK.js";
+} from "./chunk-DS2ZKB3T.js";
 import {
   SKILL_MANIFEST_FILENAME,
   SkillsClients
-} from "./chunk-MRKV43TV.js";
+} from "./chunk-IM2BFAAT.js";
 
 // src/skills-autosync.ts
 import fs from "fs";

package/dist/cli.js

@@ -14,13 +14,16 @@ import {
   getOrCreateAnonymousId,
   getPrintedUpdateAvailable,
   getTelemetryStatus,
+  installAttribution,
   isAeroToolProfile,
   isFirstRun,
   isLoopbackBindHost,
   isTelemetryEnabled,
   listAgentProviders,
   notePrintedUpdateAvailable,
+  outcomeFailure,
   readCachedUpdateAvailable,
+  recordInstallRef,
   registeredProviderNames,
   reparseStoredResult,
   reparseStoredResult2,
@@ -34,12 +37,14 @@ import {
   showFirstRunNotice,
   trackCliCommandFinished,
   trackEvent,
+  trackFeatureCompleted,
+  trackIntegrationConnection,
   waitForServerRuntimeStartup
-} from "./chunk-3OPV5XBY.js";
+} from "./chunk-SG3MPCDL.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-KWBFKTOA.js";
+} from "./chunk-YCPTP2NC.js";
 import {
   clearDashboardPassword,
   configExists,
@@ -58,14 +63,16 @@ import {
   saveConfigPatch,
   shouldPrintServeSkillsNudge,
   withBootstrapProviderDefaults
-} from "./chunk-UF7MH6TU.js";
+} from "./chunk-JJBVYL45.js";
 import {
   DEFAULT_DEMO_TRUSTED_PROXIES,
   trustedProxiesProblem,
   trustedProxyProblem
 } from "./chunk-RB2F4D3Z.js";
-import "./chunk-222NAFTY.js";
+import "./chunk-7Q7QCBJ3.js";
 import {
+  CANONRY_DISCORD_URL,
+  CANONRY_ISSUES_URL,
   CliError,
   EXIT_SYSTEM_ERROR,
   EXIT_USER_ERROR,
@@ -76,7 +83,7 @@ import {
   runMeasurementDraftAction,
   systemError,
   usageError
-} from "./chunk-5IXQAOVK.js";
+} from "./chunk-DS2ZKB3T.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -109,7 +116,7 @@ import {
   rawEventSamples,
   readMarketCompetitorNames,
   runs
-} from "./chunk-46JZR2IV.js";
+} from "./chunk-O5UMRQVN.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -128,6 +135,8 @@ import {
   GaMoverChangeBases,
   MeasurementEvidenceShapes,
   OUTSTANDING_PROVIDER_BATCH_STATUSES,
+  OutcomeReasonCodes,
+  OutcomeTriggers,
   ProviderBatchStatuses,
   ProviderNames,
   ProviderReloadErrorReasons,
@@ -166,6 +175,7 @@ import {
   buildModelChangeNotice,
   canonicalizeGtmAccountId,
   canonicalizeGtmResourceSelection,
+  classifyOutcomeError,
   competitorAutoAliasModeSchema,
   competitorLandscapeQuerySchema,
   computeCompetitorOverlap,
@@ -243,7 +253,7 @@ import {
   visibilityCompareSelectionSchema,
   visibilityReportRequestSchema,
   winnabilityClassSchema
-} from "./chunk-MRKV43TV.js";
+} from "./chunk-IM2BFAAT.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -292,9 +302,9 @@ Usage:  ${spec.usage}
   if (spec.help) console.log(`${spec.help}
 `);
 }
-function matchesPath(args, path12) {
-  if (args.length < path12.length) return false;
-  return path12.every((segment, index) => args[index] === segment);
+function matchesPath(args, path13) {
+  if (args.length < path13.length) return false;
+  return path13.every((segment, index) => args[index] === segment);
 }
 function withGlobalOptions(options) {
   const base = options ? { ...options } : {};
@@ -789,7 +799,7 @@ function parseDemoTrustedProxies(values) {
 async function demoCommand(options) {
   const { host, port } = parseDemoListenOptions(options);
   const trustProxy = parseDemoTrustedProxies(options.trustProxy);
-  const { createDemoServer } = await import("./demo-server-32PU7BM6.js");
+  const { createDemoServer } = await import("./demo-server-C7UGXXN7.js");
   const app = await createDemoServer({ trustProxy });
   let stopping = false;
   const stop = () => {
@@ -1203,7 +1213,7 @@ No DB writes performed. Re-run without --dry-run to apply.`);
   }
 }
 async function backfillInsightsCommand(project2, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-256DQBVR.js");
+  const { IntelligenceService } = await import("./intelligence-service-37TX4YV7.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -2826,6 +2836,11 @@ var BING_CLI_COMMANDS = [
   }
 ];
 
+// src/cli-connection-telemetry.ts
+function trackCliConnection(properties) {
+  trackIntegrationConnection({ ...properties, surface: "cli", agent: cliRuntimeContext().agent });
+}
+
 // src/commands/cdp.ts
 function getClient3() {
   return createApiClient();
@@ -2839,7 +2854,13 @@ async function cdpConnect(opts) {
     host,
     port
   };
-  saveConfigPatch(config);
+  try {
+    saveConfigPatch(config);
+  } catch (err) {
+    trackCliConnection({ integration: "cdp", action: "connect", status: "failed", ...outcomeFailure(err) });
+    throw err;
+  }
+  trackCliConnection({ integration: "cdp", action: "connect", status: "succeeded" });
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify({
       host,
@@ -5402,9 +5423,9 @@ async function gaConnect(project2, opts) {
     propertyId: opts.propertyId
   };
   if (opts.keyFile) {
-    const fs20 = await import("fs");
+    const fs21 = await import("fs");
     try {
-      const content = fs20.readFileSync(opts.keyFile, "utf-8");
+      const content = fs21.readFileSync(opts.keyFile, "utf-8");
       JSON.parse(content);
       body.keyJson = content;
     } catch (e) {
@@ -7685,9 +7706,9 @@ async function getCommand(opts) {
     console.log(JSON.stringify(leaf, null, 2));
   }
 }
-function walkPath(value, path12) {
-  if (!path12 || path12 === ".") return value;
-  const segments = path12.split(".").flatMap((part) => {
+function walkPath(value, path13) {
+  if (!path13 || path13 === ".") return value;
+  const segments = path13.split(".").flatMap((part) => {
     const tokens = [];
     let i = 0;
     const bracketStart = part.indexOf("[");
@@ -7735,13 +7756,13 @@ var GET_CLI_COMMANDS = [
     },
     run: async (input) => {
       const project2 = requireProject(input, "get", USAGE2);
-      const path12 = requirePositional(input, 1, {
+      const path13 = requirePositional(input, 1, {
         command: "get",
         usage: USAGE2,
         message: 'path is required (e.g. "scores.mentionShare.value")'
       });
       const from = getString(input.values, "from");
-      await getCommand({ project: project2, path: path12, from, format: input.format });
+      await getCommand({ project: project2, path: path13, from, format: input.format });
     }
   }
 ];
@@ -8410,9 +8431,9 @@ async function trafficConnectWordpress(project2, opts) {
   }
   let applicationPassword = opts.appPassword?.trim() ?? "";
   if (!applicationPassword && opts.appPasswordFile) {
-    const fs20 = await import("fs");
+    const fs21 = await import("fs");
     try {
-      applicationPassword = fs20.readFileSync(opts.appPasswordFile, "utf-8").trim();
+      applicationPassword = fs21.readFileSync(opts.appPasswordFile, "utf-8").trim();
     } catch (e) {
       const msg = describeError(e);
       throw new CliError({
@@ -8468,10 +8489,10 @@ async function trafficConnectCloudRun(project2, opts) {
       details: { project: project2 }
     });
   }
-  const fs20 = await import("fs");
+  const fs21 = await import("fs");
   let keyJson;
   try {
-    keyJson = fs20.readFileSync(opts.serviceAccountKey, "utf-8");
+    keyJson = fs21.readFileSync(opts.serviceAccountKey, "utf-8");
     JSON.parse(keyJson);
   } catch (e) {
     const msg = describeError(e);
@@ -8531,9 +8552,9 @@ async function trafficConnectVercel(project2, opts) {
   }
   let token = opts.token?.trim() ?? "";
   if (!token && opts.tokenFile) {
-    const fs20 = await import("fs");
+    const fs21 = await import("fs");
     try {
-      token = fs20.readFileSync(opts.tokenFile, "utf-8").trim();
+      token = fs21.readFileSync(opts.tokenFile, "utf-8").trim();
     } catch (e) {
       const msg = describeError(e);
       throw new CliError({
@@ -17548,7 +17569,17 @@ async function bootstrapCommand(opts) {
   };
   const providersChanged = !isDeepStrictEqual(persistedValue(existingRaw?.providers ?? {}), persistedValue(mergedProviders));
   const configChanged = !existingRaw || existingRaw.apiUrl !== apiUrl || existingRaw.database !== databasePath || existingRaw.apiKey !== rawApiKey || providersChanged || !isDeepStrictEqual(persistedValue(existingRaw.google), persistedValue(mergedGoogle));
-  if (configChanged) saveConfig(nextConfig);
+  const providerConnections = Object.keys(env.providers).filter((name) => env.providers[name] && !isDeepStrictEqual(persistedValue(existingRaw?.providers?.[name]), persistedValue(mergedProviders[name]))).map((name) => ({ integration: "provider", provider: name, action: existingRaw?.providers?.[name] ? "reauth" : "connect" }));
+  if (configChanged) {
+    try {
+      saveConfig(nextConfig);
+    } catch (err) {
+      for (const connection of providerConnections) trackCliConnection({ ...connection, status: "failed", ...outcomeFailure(err) });
+      throw err;
+    }
+  }
+  if (isTelemetryEnabled()) recordInstallRef(opts?.ref);
+  for (const connection of providerConnections) trackCliConnection({ ...connection, status: "succeeded" });
   const status = !existing ? "created" : configChanged || keyChanged ? "updated" : "unchanged";
   const providerFree = registeredProviderNames(nextConfig).length === 0;
   const serverUrl = loadConfig().apiUrl;
@@ -17643,6 +17674,21 @@ async function bootstrapCommand(opts) {
   if (reloadFailure) throw reloadFailure;
 }
 
+// src/commands/support.ts
+var FEEDBACK_COMMAND = 'canonry feedback "<what happened>"';
+function supportCommand(format) {
+  if (isMachineFormat(format)) {
+    console.log(JSON.stringify({ discord: CANONRY_DISCORD_URL, issues: CANONRY_ISSUES_URL, feedbackCommand: FEEDBACK_COMMAND }, null, 2));
+    return;
+  }
+  console.log([
+    "Get help with Canonry:",
+    `  Discord:   ${CANONRY_DISCORD_URL}`,
+    `  Issues:    ${CANONRY_ISSUES_URL}`,
+    `  From here: ${FEEDBACK_COMMAND}`
+  ].join("\n"));
+}
+
 // src/commands/daemon.ts
 import { spawn as spawn2 } from "child_process";
 import fs16 from "fs";
@@ -18180,6 +18226,7 @@ ${mcpTip}`);
   }
   if (isTelemetryEnabled()) {
     const postInitSetupState = buildSetupState();
+    recordInstallRef(opts?.ref);
     trackEvent("cli.init", {
       providerCount: providerNames.length,
       providers: providerNames,
@@ -18202,8 +18249,12 @@ ${mcpTip}`);
         hasAgent: !!agentLLM
       }),
       skillsInstalled: !!skillsSummary,
+      ...installAttribution(),
       ...cliRuntimeContext()
     });
+    for (const provider of Object.keys(providers)) {
+      trackCliConnection({ integration: "provider", provider, action: "connect", status: "succeeded" });
+    }
   }
   if (!isMachineFormat(format) && process.stdin.isTTY && process.stdout.isTTY) {
     const answer = await prompt("\nStart the dashboard now? [Y/n]: ");
@@ -18477,6 +18528,80 @@ function detectCanonryAgentPlugin(opts = {}) {
   return { configuredClients, verifiedClients, verifiedClientVersions };
 }
 
+// src/server-crash-telemetry.ts
+import fs19 from "fs";
+import path12 from "path";
+var CRASH_MARKER = "crash-telemetry.json";
+var MAX_MARKER_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
+function telemetryAllowed() {
+  try {
+    return isTelemetryEnabled();
+  } catch {
+    return false;
+  }
+}
+function markerPath(configDir) {
+  return path12.join(configDir, CRASH_MARKER);
+}
+function trackServerStartFailure(err, reasonCode) {
+  try {
+    const classified = classifyOutcomeError(err);
+    const code = err?.code;
+    const reason = reasonCode ?? (code === "EADDRINUSE" ? OutcomeReasonCodes.PORT_IN_USE : classified.reasonCode);
+    trackFeatureCompleted({
+      feature: "server",
+      operation: "start",
+      status: "failed",
+      trigger: OutcomeTriggers.startup,
+      reasonCode: reason,
+      ...classified.errorName ? { errorName: classified.errorName } : {}
+    });
+  } catch {
+  }
+}
+var watched = /* @__PURE__ */ new WeakSet();
+function watchServerCrashes(configDir = getConfigDir(), proc = process, now = Date.now) {
+  if (watched.has(proc)) return;
+  watched.add(proc);
+  proc.on("uncaughtExceptionMonitor", (err, origin) => {
+    if (!telemetryAllowed()) return;
+    try {
+      const { errorName } = classifyOutcomeError(err);
+      fs19.writeFileSync(markerPath(configDir), JSON.stringify({
+        origin: origin === "unhandledRejection" ? "unhandledRejection" : "uncaughtException",
+        at: now(),
+        ...errorName ? { errorName } : {}
+      }));
+    } catch {
+    }
+  });
+}
+function reportPreviousServerCrash(configDir = getConfigDir(), now = Date.now) {
+  if (!telemetryAllowed()) return;
+  const file = markerPath(configDir);
+  let marker;
+  try {
+    marker = JSON.parse(fs19.readFileSync(file, "utf8"));
+  } catch {
+    return;
+  }
+  try {
+    fs19.rmSync(file, { force: true });
+  } catch {
+    return;
+  }
+  if (typeof marker.at !== "number" || now() - marker.at > MAX_MARKER_AGE_MS) return;
+  const errorName = typeof marker.errorName === "string" && /^[A-Z_$][\w$]{0,39}$/i.test(marker.errorName) ? marker.errorName : void 0;
+  trackFeatureCompleted({
+    feature: "server",
+    operation: "crash",
+    status: "failed",
+    trigger: OutcomeTriggers.startup,
+    reasonCode: marker.origin === "unhandledRejection" ? OutcomeReasonCodes.UNHANDLED_REJECTION : OutcomeReasonCodes.UNCAUGHT_EXCEPTION,
+    ...errorName ? { errorName } : {}
+  });
+}
+
 // src/commands/serve.ts
 function readServeOpenState(db) {
   try {
@@ -18525,7 +18650,12 @@ async function serveCommand(format = "text") {
   const host = process.env.CANONRY_HOST ?? "127.0.0.1";
   config.port = port;
   const db = createClient(config.database);
-  migrate(db);
+  try {
+    migrate(db);
+  } catch (err) {
+    trackServerStartFailure(err, "MIGRATION_FAILED");
+    throw err;
+  }
   try {
     const result = await repairNormalizedPathsOnStartup(db);
     if (result && result.updated > 0 && format === "text") {
@@ -18602,10 +18732,13 @@ Canonry server running at ${url}`);
       }, null, 2));
     }
     setTelemetrySource("cli-server");
+    watchServerCrashes();
+    reportPreviousServerCrash();
     const providerNames = registeredProviderNames(config);
     trackEvent("serve.started", {
       providerCount: providerNames.length,
       providers: providerNames,
+      ...installAttribution(),
       // Who launched the server: an agent-started install is its own funnel.
       ...cliRuntimeContext()
     });
@@ -18616,6 +18749,7 @@ Canonry server running at ${url}`);
 `);
       return;
     }
+    trackServerStartFailure(err);
     try {
       await closeWithIdleSweep(app);
     } catch (closeErr) {
@@ -18808,10 +18942,11 @@ var SYSTEM_CLI_COMMANDS = [
   },
   {
     path: ["init"],
-    usage: "canonry init [--force] [--gemini-key <key>] [--openai-key <key>] [--claude-key <key>] [--perplexity-key <key>] [--muse-key <key>] [--local-url <url>] [--local-model <name>] [--local-key <key>] [--google-client-id <id>] [--google-client-secret <key>] [--skip-skills] [--skip-mcp] [--skills-dir <path>] [--format json]",
+    usage: "canonry init [--force] [--ref <tag>] [--gemini-key <key>] [--openai-key <key>] [--claude-key <key>] [--perplexity-key <key>] [--muse-key <key>] [--local-url <url>] [--local-model <name>] [--local-key <key>] [--google-client-id <id>] [--google-client-secret <key>] [--skip-skills] [--skip-mcp] [--skills-dir <path>] [--format json]",
     help: 'Optional interactive provider and OAuth setup. First-run Page Health does not need this: use "canonry bootstrap", then "canonry serve". At least one provider is required here. --format json needs provider flags or environment variables.',
     options: {
       force: { type: "boolean", short: "f", default: false },
+      ref: stringOption(),
       "gemini-key": stringOption(),
       "openai-key": stringOption(),
       "claude-key": stringOption(),
@@ -18830,6 +18965,7 @@ var SYSTEM_CLI_COMMANDS = [
     run: async (input) => {
       await initCommand({
         force: getBoolean(input.values, "force"),
+        ref: getString(input.values, "ref"),
         geminiKey: getString(input.values, "gemini-key"),
         openaiKey: getString(input.values, "openai-key"),
         claudeKey: getString(input.values, "claude-key"),
@@ -18849,17 +18985,19 @@ var SYSTEM_CLI_COMMANDS = [
   },
   {
     path: ["bootstrap"],
-    usage: "canonry bootstrap [--format json]",
+    usage: "canonry bootstrap [--ref <tag>] [--format json]",
     help: "Create or reconcile the local config, SQLite database, and default API key from supported environment variables. Provider credentials are optional. Safe to rerun: existing settings are preserved and the result reports created, updated, or unchanged. The legacy --force/-f flag is accepted but has no effect.",
     options: {
       // Compatibility for scripts written before bootstrap became idempotent.
       // Keep this out of usage: the flag is unnecessary and has no behavior.
-      force: { type: "boolean", short: "f", default: false }
+      force: { type: "boolean", short: "f", default: false },
+      ref: stringOption()
     },
     allowPositionals: false,
     run: async (input) => {
       await bootstrapCommand({
-        format: input.format
+        format: input.format,
+        ref: getString(input.values, "ref")
       });
     }
   },
@@ -18915,6 +19053,15 @@ var SYSTEM_CLI_COMMANDS = [
       stopDaemon(input.format);
     }
   },
+  {
+    path: ["support"],
+    usage: "canonry support [--format json]",
+    help: "Where to get help: the Canonry Discord, the issue tracker, and canonry feedback.",
+    allowPositionals: false,
+    run: async (input) => {
+      supportCommand(input.format);
+    }
+  },
   {
     path: ["feedback"],
     usage: FEEDBACK_USAGE,
@@ -19927,14 +20074,14 @@ Usage: ${usage}`, {
     }
   }
 ];
-function siteHealthAlias(sourcePath, path12, usage) {
+function siteHealthAlias(sourcePath, path13, usage) {
   const source = TECHNICAL_AEO_CLI_COMMANDS_BASE.find(
     (candidate) => candidate.path.join(" ") === sourcePath.join(" ")
   );
   if (!source) throw new Error(`Missing Site Health compatibility source: ${sourcePath.join(" ")}`);
   return {
     ...source,
-    path: path12,
+    path: path13,
     usage,
     run: async (input) => {
       try {
@@ -19945,7 +20092,7 @@ function siteHealthAlias(sourcePath, path12, usage) {
         throw usageError(`${firstLine}
 Usage: ${usage}`, {
           message: error.message,
-          details: { ...error.details, command: path12.join("."), usage }
+          details: { ...error.details, command: path13.join("."), usage }
         });
       }
     }
@@ -20318,7 +20465,7 @@ var VISIBILITY_STATS_CLI_COMMANDS = [
 ];
 
 // src/cli-commands/wordpress.ts
-import fs19 from "fs";
+import fs20 from "fs";
 
 // src/commands/wordpress.ts
 function getClient28() {
@@ -20557,12 +20704,12 @@ async function wordpressSetMeta(project2, body) {
   printPageDetail(result);
 }
 async function wordpressBulkSetMeta(project2, opts) {
-  const fs20 = await import("fs/promises");
-  const path12 = await import("path");
-  const filePath = path12.resolve(opts.from);
+  const fs21 = await import("fs/promises");
+  const path13 = await import("path");
+  const filePath = path13.resolve(opts.from);
   let raw;
   try {
-    raw = await fs20.readFile(filePath, "utf8");
+    raw = await fs21.readFile(filePath, "utf8");
   } catch {
     throw new CliError({
       code: "FILE_READ_ERROR",
@@ -20659,13 +20806,13 @@ async function wordpressSetSchema(project2, body) {
   printManualAssist(`Schema update for "${body.slug}"`, result);
 }
 async function wordpressSchemaDeploy(project2, opts) {
-  const fs20 = await import("fs/promises");
-  const path12 = await import("path");
+  const fs21 = await import("fs/promises");
+  const path13 = await import("path");
   const yaml = await loadYamlModule();
-  const filePath = path12.resolve(opts.profile);
+  const filePath = path13.resolve(opts.profile);
   let raw;
   try {
-    raw = await fs20.readFile(filePath, "utf8");
+    raw = await fs21.readFile(filePath, "utf8");
   } catch {
     throw new CliError({
       code: "FILE_READ_ERROR",
@@ -20770,13 +20917,13 @@ async function wordpressOnboard(project2, opts) {
   }
   let profileData;
   if (opts.profile) {
-    const fs20 = await import("fs/promises");
-    const path12 = await import("path");
+    const fs21 = await import("fs/promises");
+    const path13 = await import("path");
     const yaml = await loadYamlModule();
-    const filePath = path12.resolve(opts.profile);
+    const filePath = path13.resolve(opts.profile);
     let raw;
     try {
-      raw = await fs20.readFile(filePath, "utf8");
+      raw = await fs21.readFile(filePath, "utf8");
     } catch {
       throw new CliError({
         code: "FILE_READ_ERROR",
@@ -20925,7 +21072,7 @@ function resolveContent(input, command, usage, options) {
   }
   if (contentFile) {
     try {
-      return fs19.readFileSync(contentFile, "utf-8");
+      return fs20.readFileSync(contentFile, "utf-8");
     } catch (error) {
       const message = describeError(error);
       throw usageError(`Error: could not read --content-file "${contentFile}": ${message}`, {
@@ -21403,6 +21550,7 @@ async function agentAttach(opts) {
   const existing = await client.listNotifications(opts.project);
   const hasAgent = existing.some((n) => n.source === "agent");
   if (hasAgent) {
+    trackCliConnection({ integration: "agent_webhook", action: "connect", status: "cancelled", reasonCode: "ALREADY_CONNECTED" });
     if (isMachineFormat(opts.format)) {
       console.log(JSON.stringify({ status: "already-attached", project: opts.project }));
     } else {
@@ -21427,6 +21575,7 @@ async function agentDetach(opts) {
   const existing = await client.listNotifications(opts.project);
   const agentNotif = existing.find((n) => n.source === "agent");
   if (!agentNotif) {
+    trackCliConnection({ integration: "agent_webhook", action: "disconnect", status: "cancelled", reasonCode: "NOT_CONNECTED" });
     if (isMachineFormat(opts.format)) {
       console.log(JSON.stringify({ status: "not-attached", project: opts.project }));
     } else {
@@ -22385,6 +22534,7 @@ Admin:
   backfill              Backfill answer visibility or insights
   telemetry             Manage anonymous telemetry
   history <project>     Show audit trail
+  support               Get help: Canonry Discord and issue tracker
 
 Global options:
   --format json         Machine-readable output: one JSON document (all commands)

package/dist/{demo-server-32PU7BM6.js → demo-server-C7UGXXN7.js}

@@ -5,11 +5,11 @@ import {
   computeFactorAverages,
   layoutSiteCrawlGraphInput,
   persistSiteCrawlGraphLayout
-} from "./chunk-222NAFTY.js";
+} from "./chunk-7Q7QCBJ3.js";
 import {
   PACKAGE_VERSION,
   canonryMcpTools
-} from "./chunk-5IXQAOVK.js";
+} from "./chunk-DS2ZKB3T.js";
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService,
@@ -85,7 +85,7 @@ import {
   siteCrawlPages,
   siteCrawlSnapshots,
   trafficSources
-} from "./chunk-46JZR2IV.js";
+} from "./chunk-O5UMRQVN.js";
 import {
   RunKinds,
   SiteCrawlFetchStates,
@@ -115,7 +115,7 @@ import {
   roundPreservingTotal,
   siteAuditPageFactorSchema,
   wilsonInterval
-} from "./chunk-MRKV43TV.js";
+} from "./chunk-IM2BFAAT.js";
 
 // src/demo-server.ts
 import { dirname, join as join2 } from "path";

package/dist/index.d.ts

@@ -423,6 +423,8 @@ interface CanonryConfig {
     research?: ResearchConfigEntry;
     telemetry?: boolean;
     anonymousId?: string;
+    /** First-touch campaign tag (`--ref` / `CANONRY_REF`), kept once and sent with install telemetry. */
+    installRef?: string;
     lastSeenVersion?: string;
     /**
      * The engine version the installed skill trees were last synced against.

package/dist/index.js

@@ -3,14 +3,14 @@ import {
   createGoogleMarketingCredentialStore,
   createGoogleMarketingRuntime,
   createServer
-} from "./chunk-3OPV5XBY.js";
+} from "./chunk-SG3MPCDL.js";
 import {
   loadConfig
-} from "./chunk-UF7MH6TU.js";
-import "./chunk-222NAFTY.js";
-import "./chunk-5IXQAOVK.js";
-import "./chunk-46JZR2IV.js";
-import "./chunk-MRKV43TV.js";
+} from "./chunk-JJBVYL45.js";
+import "./chunk-7Q7QCBJ3.js";
+import "./chunk-DS2ZKB3T.js";
+import "./chunk-O5UMRQVN.js";
+import "./chunk-IM2BFAAT.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

package/dist/{intelligence-service-256DQBVR.js → intelligence-service-37TX4YV7.js}

@@ -1,8 +1,8 @@
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService
-} from "./chunk-46JZR2IV.js";
-import "./chunk-MRKV43TV.js";
+} from "./chunk-O5UMRQVN.js";
+import "./chunk-IM2BFAAT.js";
 export {
   HISTORY_WINDOW_RUNS,
   IntelligenceService