@canonry/canonry 4.136.2 → 4.138.0

package/dist/cli.js

@@ -28,8 +28,9 @@ import {
   setGoogleAuthConfig,
   setTelemetrySource,
   showFirstRunNotice,
+  trackCliCommandFinished,
   trackEvent
-} from "./chunk-MXR3GI5L.js";
+} from "./chunk-3KGJ7BXW.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -46,7 +47,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-SMFUCXHI.js";
+} from "./chunk-R3GAWKHM.js";
 import {
   apiKeys,
   createClient,
@@ -54,7 +55,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-YVMQWVNY.js";
+} from "./chunk-GO24URVP.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -100,7 +101,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-GGIRLRAY.js";
+} from "./chunk-RJ7OW6W6.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -12394,6 +12395,20 @@ import crypto2 from "crypto";
 import fs13 from "fs";
 import readline from "readline";
 import path10 from "path";
+var pendingServeHandoff = false;
+function consumePendingServeHandoff() {
+  const pending = pendingServeHandoff;
+  pendingServeHandoff = false;
+  return pending;
+}
+async function promptProviderApiKey(label, envVar, promptFn = prompt, env = process.env) {
+  const fromEnv = env[envVar]?.trim();
+  if (fromEnv) {
+    const answer = await promptFn(`Found ${envVar} in your environment. Use it? [Y/n]: `);
+    if (!/^n/i.test(answer.trim())) return fromEnv;
+  }
+  return promptFn(`${label} API key (press Enter to skip): `);
+}
 function prompt(question) {
   const rl = readline.createInterface({
     input: process.stdin,
@@ -12500,22 +12515,22 @@ async function initCommand(opts) {
     console.log("GEMINI_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, PERPLEXITY_API_KEY,");
     console.log("GOOGLE_CLIENT_ID, and GOOGLE_CLIENT_SECRET env vars.");
     console.log('Or use "canonry bootstrap".\n');
-    const geminiApiKey = await prompt("Gemini API key (press Enter to skip): ");
+    const geminiApiKey = await promptProviderApiKey("Gemini", "GEMINI_API_KEY");
     if (geminiApiKey) {
       const geminiModel = await prompt("  Gemini model [gemini-2.5-flash]: ") || "gemini-2.5-flash";
       providers.gemini = { apiKey: geminiApiKey, model: geminiModel, quota: DEFAULT_QUOTA };
     }
-    const openaiApiKey = await prompt("OpenAI API key (press Enter to skip): ");
+    const openaiApiKey = await promptProviderApiKey("OpenAI", "OPENAI_API_KEY");
     if (openaiApiKey) {
       const openaiModel = await prompt("  OpenAI model [gpt-4o]: ") || "gpt-4o";
       providers.openai = { apiKey: openaiApiKey, model: openaiModel, quota: DEFAULT_QUOTA };
     }
-    const claudeApiKey = await prompt("Anthropic API key (press Enter to skip): ");
+    const claudeApiKey = await promptProviderApiKey("Anthropic", "ANTHROPIC_API_KEY");
     if (claudeApiKey) {
       const claudeModel = await prompt("  Claude model [claude-sonnet-4-6]: ") || "claude-sonnet-4-6";
       providers.claude = { apiKey: claudeApiKey, model: claudeModel, quota: DEFAULT_QUOTA };
     }
-    const perplexityApiKey = await prompt("Perplexity API key (press Enter to skip): ");
+    const perplexityApiKey = await promptProviderApiKey("Perplexity", "PERPLEXITY_API_KEY");
     if (perplexityApiKey) {
       const perplexityModel = await prompt("  Perplexity model [sonar]: ") || "sonar";
       providers.perplexity = { apiKey: perplexityApiKey, model: perplexityModel, quota: DEFAULT_QUOTA };
@@ -12684,16 +12699,39 @@ ${mcpTip}`);
       console.log(`  ${line}`);
     }
   }
-  trackEvent("cli.init", {
-    providerCount: providerNames.length,
-    providers: providerNames,
-    setupState: encodeSetupState({
-      hasProvider: !!hasProvider,
-      hasGoogle: !!google,
-      hasAgent: !!agentLLM
-    }),
-    skillsInstalled: !!skillsSummary
-  });
+  if (isTelemetryEnabled()) {
+    const postInitSetupState = buildSetupState();
+    trackEvent("cli.init", {
+      providerCount: providerNames.length,
+      providers: providerNames,
+      ...postInitSetupState ? {
+        setup_state: {
+          ...postInitSetupState,
+          // This snapshot represents a successfully completed init. The
+          // anonymous ID is persisted inside trackEvent immediately after
+          // properties are composed, so override the pre-send read here.
+          is_first_run: false
+        }
+      } : {},
+      googleConfigured: !!google,
+      agentConfigured: !!agentLLM,
+      // Deprecated compact field retained while existing telemetry reports
+      // migrate to the structured setup_state object.
+      setupState: encodeLegacySetupState({
+        hasProvider: !!hasProvider,
+        hasGoogle: !!google,
+        hasAgent: !!agentLLM
+      }),
+      skillsInstalled: !!skillsSummary
+    });
+  }
+  if (!isMachineFormat(format) && process.stdin.isTTY && process.stdout.isTTY) {
+    const answer = await prompt("\nStart the dashboard now? [Y/n]: ");
+    if (!/^n/i.test(answer.trim())) {
+      pendingServeHandoff = true;
+      console.log("Handing off to the dashboard. Finish setup at /setup once it is up.");
+    }
+  }
   return agentLLM;
 }
 function buildNextSteps() {
@@ -12716,7 +12754,7 @@ function buildNextSteps() {
     'Tip: "canonry doctor" verifies your setup before you start.'
   ];
 }
-function encodeSetupState(state) {
+function encodeLegacySetupState(state) {
   const flags = [];
   if (state.hasProvider) flags.push("provider");
   if (state.hasGoogle) flags.push("google");
@@ -15340,6 +15378,25 @@ var REGISTERED_CLI_COMMANDS = [
   ...MCP_CLI_COMMANDS
 ];
 
+// src/setup-nudge.ts
+var NUDGE_EXEMPT_ROOTS = /* @__PURE__ */ new Set([
+  "init",
+  "serve",
+  "bootstrap",
+  "settings",
+  "telemetry",
+  "unknown"
+]);
+function buildSetupNudgeLine(input) {
+  if (input.machineFormat || !input.stderrIsTTY) return null;
+  const [root = input.command] = input.command.split(".");
+  if (NUDGE_EXEMPT_ROOTS.has(root)) return null;
+  const setupState = input.getSetupState();
+  if (!setupState) return null;
+  if (setupState.provider_count > 0) return null;
+  return "\n\u2192 No AI provider is configured, so answer sweeps cannot run yet.\n  Finish setup in the dashboard:  canonry serve\n  Or by CLI:  canonry settings provider gemini --api-key <key>\n";
+}
+
 // src/cli.ts
 import { createRequire as createRequire2 } from "module";
 var USAGE6 = `
@@ -15406,6 +15463,45 @@ function extractFormat(cmdArgs) {
   if (value === "jsonl") return "jsonl";
   return "text";
 }
+function resolveCommandIdentifier(args, specs) {
+  const spec = [...specs].sort((a, b) => b.path.length - a.path.length).find(
+    (candidate) => candidate.path.every((segment, index) => args[index] === segment)
+  );
+  return spec?.path.join(".") ?? "unknown";
+}
+var TELEMETRY_ERROR_CODES = /* @__PURE__ */ new Set([
+  "NOT_FOUND",
+  "ALREADY_EXISTS",
+  "VALIDATION_ERROR",
+  "AUTH_REQUIRED",
+  "AUTH_INVALID",
+  "FORBIDDEN",
+  "QUOTA_EXCEEDED",
+  "PROVIDER_ERROR",
+  "NO_PROVIDER",
+  "NO_QUERIES",
+  "RUN_IN_PROGRESS",
+  "OPERATION_IN_PROGRESS",
+  "UNSUPPORTED_KIND",
+  "RUN_NOT_CANCELLABLE",
+  "NOT_IMPLEMENTED",
+  "INTERNAL_ERROR",
+  "DELIVERY_FAILED",
+  "AGENT_BUSY",
+  "MISSING_DEPENDENCY",
+  "RUNTIME_STATE_MISSING",
+  "API_ERROR",
+  "CLI_ERROR",
+  "CLI_USAGE_ERROR",
+  "CLI_SYSTEM_ERROR",
+  "CONNECTION_ERROR",
+  "UNEXPECTED_RESPONSE_FORMAT"
+]);
+function telemetryErrorCode(err) {
+  if (!(err instanceof CliError)) return "CLI_ERROR";
+  if (TELEMETRY_ERROR_CODES.has(err.code)) return err.code;
+  return typeof err.details?.httpStatus === "number" ? "API_ERROR" : "CLI_ERROR";
+}
 async function runCli(args = process.argv.slice(2)) {
   if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
     console.log(USAGE6);
@@ -15422,20 +15518,10 @@ async function runCli(args = process.argv.slice(2)) {
     showFirstRunNotice();
     getOrCreateAnonymousId();
   }
-  const SUBCOMMAND_COMMANDS = /* @__PURE__ */ new Set(["backfill", "project", "query", "keyword", "competitor", "schedule", "notify", "settings", "telemetry", "google", "bing", "wordpress", "cdp", "traffic"]);
-  const MIXED_SUBCOMMANDS = {
-    insights: /* @__PURE__ */ new Set(["dismiss"]),
-    run: /* @__PURE__ */ new Set(["show", "cancel"])
-  };
-  let resolvedCommand;
-  if (SUBCOMMAND_COMMANDS.has(command) && args[1] && !args[1].startsWith("-")) {
-    resolvedCommand = `${command}.${args[1]}`;
-  } else if (MIXED_SUBCOMMANDS[command] && args[1] && MIXED_SUBCOMMANDS[command].has(args[1])) {
-    resolvedCommand = `${command}.${args[1]}`;
-  } else {
-    resolvedCommand = command;
-  }
-  if (!isHelpRequest && command !== "telemetry") {
+  const resolvedCommand = resolveCommandIdentifier(args, REGISTERED_CLI_COMMANDS);
+  const shouldTrackCommand = !isHelpRequest && command !== "telemetry" && isTelemetryEnabled();
+  const shouldTrackCommandStart = shouldTrackCommand && command !== "init";
+  if (shouldTrackCommandStart) {
     detectAndTrackUpgrade();
     const setupState = buildSetupState();
     trackEvent("cli.command", {
@@ -15455,8 +15541,27 @@ async function runCli(args = process.argv.slice(2)) {
       );
     });
   }
+  const commandStartedAt = Date.now();
   try {
     if (await dispatchRegisteredCommand(args, format, REGISTERED_CLI_COMMANDS)) {
+      if (shouldTrackCommand) {
+        trackCliCommandFinished({
+          command: resolvedCommand,
+          success: true,
+          durationMs: Date.now() - commandStartedAt,
+          setupState: buildSetupState()
+        });
+      }
+      const nudge = buildSetupNudgeLine({
+        command: resolvedCommand,
+        machineFormat: isMachineFormat(format),
+        stderrIsTTY: Boolean(process.stderr.isTTY),
+        getSetupState: buildSetupState
+      });
+      if (nudge) process.stderr.write(nudge);
+      if (consumePendingServeHandoff()) {
+        await serveCommand(format);
+      }
       return 0;
     }
     throw usageError(`Error: unknown command: ${command}
@@ -15468,6 +15573,15 @@ Run "cnry --help" for usage.`, {
       }
     });
   } catch (err) {
+    if (shouldTrackCommand && command !== "init") {
+      trackCliCommandFinished({
+        command: resolvedCommand,
+        success: false,
+        durationMs: Date.now() - commandStartedAt,
+        setupState: buildSetupState(),
+        errorCode: telemetryErrorCode(err)
+      });
+    }
     printCliError(err, format);
     return err instanceof CliError ? err.exitCode : EXIT_SYSTEM_ERROR;
   }

package/dist/index.d.ts

@@ -232,6 +232,8 @@ interface CanonryConfig {
     telemetry?: boolean;
     anonymousId?: string;
     lastSeenVersion?: string;
+    /** Set once when the first-activation notice has been shown; never unset. */
+    activationNoticeShown?: boolean;
     updateCheck?: boolean;
     lastUpdateCheckAt?: string;
     lastKnownLatestVersion?: string;

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-MXR3GI5L.js";
+} from "./chunk-3KGJ7BXW.js";
 import {
   loadConfig
-} from "./chunk-SMFUCXHI.js";
-import "./chunk-YVMQWVNY.js";
-import "./chunk-GGIRLRAY.js";
+} from "./chunk-R3GAWKHM.js";
+import "./chunk-GO24URVP.js";
+import "./chunk-RJ7OW6W6.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-BD6BHTEJ.js → intelligence-service-5RJHJLYA.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-YVMQWVNY.js";
-import "./chunk-GGIRLRAY.js";
+} from "./chunk-GO24URVP.js";
+import "./chunk-RJ7OW6W6.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-SMFUCXHI.js";
+} from "./chunk-R3GAWKHM.js";
 import {
   isReadOnlyKey
-} from "./chunk-GGIRLRAY.js";
+} from "./chunk-RJ7OW6W6.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonry/canonry",
-  "version": "4.136.2",
+  "version": "4.138.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -68,24 +68,24 @@
     "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-openai-ads": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
-    "@ainyc/canonry-integration-google-places": "0.0.0",
-    "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
-    "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-integration-google-places": "0.0.0",
+    "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0"
+    "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0",
+    "@ainyc/canonry-provider-openai": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",