@dosu/cli 0.11.0 → 0.12.1

package/bin/dosu.js

@@ -4341,7 +4341,7 @@ function getSupabaseAnonKey() {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.11.0";
+var VERSION = "0.12.1";
 
 // src/debug/logger.ts
 import {
@@ -6258,6 +6258,88 @@ var init_dist6 = __esm(() => {
   J2 = `${import_picocolors20.default.gray(o)}  `;
 });
 
+// src/setup/analytics.ts
+async function trackCliOnboardingEvent(cfg, onboardingRunID, event, properties = {}) {
+  if (!cfg.access_token)
+    return;
+  try {
+    const trpc = createTypedClient(cfg);
+    await withTimeout(trpc.user.trackCliOnboardingEvent.mutate({
+      event,
+      properties: {
+        ...baseProperties(cfg),
+        onboarding_run_id: onboardingRunID,
+        ...properties
+      }
+    }), TRACKING_TIMEOUT_MS);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    logger.debug("setup", `CLI onboarding analytics failed: ${event}: ${msg}`);
+  }
+}
+async function trackCliOnboardingPreAuthEvent(onboardingRunID, event, properties = {}) {
+  try {
+    const trpc = createAnonymousClient();
+    await withTimeout(trpc.user.trackCliOnboardingPreAuthEvent.mutate({
+      event,
+      onboarding_run_id: onboardingRunID,
+      properties: {
+        ...baseProperties({ access_token: "", refresh_token: "", expires_at: 0 }),
+        ...properties
+      }
+    }), TRACKING_TIMEOUT_MS);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    logger.debug("setup", `CLI onboarding pre-auth analytics failed: ${event}: ${msg}`);
+  }
+}
+function baseProperties(cfg) {
+  return {
+    cli_version: VERSION,
+    platform: process.platform,
+    arch: process.arch,
+    mode: cfg.mode ?? "cloud",
+    org_id: cfg.org_id,
+    deployment_id: cfg.deployment_id,
+    space_id: cfg.space_id
+  };
+}
+function createAnonymousClient() {
+  const webAppURL = getWebAppURL();
+  if (!webAppURL) {
+    throw new Error("Web app URL not configured");
+  }
+  return createTRPCClient({
+    links: [
+      httpLink({
+        url: `${webAppURL}/api/trpc`,
+        transformer: dist_default
+      })
+    ]
+  });
+}
+async function withTimeout(promise, timeoutMs) {
+  let timeout;
+  try {
+    return await Promise.race([
+      promise,
+      new Promise((_3, reject) => {
+        timeout = setTimeout(() => reject(new Error("tracking timeout")), timeoutMs);
+      })
+    ]);
+  } finally {
+    if (timeout)
+      clearTimeout(timeout);
+  }
+}
+var TRACKING_TIMEOUT_MS = 1500;
+var init_analytics = __esm(() => {
+  init_dist();
+  init_dist4();
+  init_trpc();
+  init_logger();
+});
+
 // src/setup/styles.ts
 function dim(msg) {
   return import_picocolors21.default.dim(msg);
@@ -7660,7 +7742,8 @@ ${dim(`deployment ${deployment_id}`)}`);
       has_connected_repo: true,
       deployment_id: primary.deployment_id,
       space_id: cfg.space_id,
-      created_data_source_ids: survived.map((c) => c.data_source_id)
+      created_data_source_ids: survived.map((c) => c.data_source_id),
+      created_repository_slugs: survived.map((c) => c.slug)
     };
   }
 }
@@ -8043,7 +8126,7 @@ async function stepImportGitHubDocs(cfg, opts = {}) {
   }
   if (files.length === 0) {
     M2.info("No markdown docs available to import right now. You can import them later.");
-    return { advance: true };
+    return { advance: true, imported: false, imported_count: 0 };
   }
   const repositories = buildRepositories(files);
   const selected = await promptGitHubDocsImport({ repositories });
@@ -8054,7 +8137,7 @@ async function stepImportGitHubDocs(cfg, opts = {}) {
   const fileIDs = selected;
   if (fileIDs.length === 0) {
     M2.info("Skipped importing docs for now. You can import them later.");
-    return { advance: true };
+    return { advance: true, imported: false, imported_count: 0 };
   }
   const knowledgeStoreID = await getKnowledgeStoreID(trpc, cfg.space_id);
   if (!knowledgeStoreID) {
@@ -8073,7 +8156,7 @@ async function stepImportGitHubDocs(cfg, opts = {}) {
       spinner.stop("Import task started");
       M2.success("Import task started.");
       M2.info("Your docs should finish importing in a few minutes.");
-      return { advance: true };
+      return { advance: true, imported: false, imported_count: 0, queued: true };
     }
     spinner.stop("Import task started");
     logger.info("setup", `Watching import task ${taskID}`);
@@ -8085,10 +8168,23 @@ async function stepImportGitHubDocs(cfg, opts = {}) {
       progressSpinner.stop("Stopped watching import progress");
       M2.info(`The import is still running in the background.
 Check status later with: dosu docs import-status ${taskID}`);
-      return { advance: true };
+      return {
+        advance: true,
+        imported: false,
+        imported_count: 0,
+        queued: true,
+        task_id: taskID
+      };
     }
     handleImportCompletion(finalStatus, progressSpinner);
-    return { advance: true };
+    const importedCount = finalStatus.detail?.completed ?? 0;
+    return {
+      advance: true,
+      imported: importedCount > 0,
+      imported_count: importedCount,
+      failed_count: finalStatus.detail?.failed ?? 0,
+      task_id: taskID
+    };
   } catch (err) {
     spinner.stop("Failed");
     const msg = err instanceof Error ? err.message : String(err);
@@ -8164,13 +8260,23 @@ async function waitForImportableGithubFiles(trpc, orgID, spaceID, expectedDataSo
     M2.info("This usually takes a few seconds.");
     const startedAt = Date.now();
     let latestFiles = [];
+    const waitsForExpectedDataSources = expectedDataSourceIds !== undefined && expectedDataSourceIds.length > 0;
     while (Date.now() - startedAt < DOC_SCAN_POLL_TIMEOUT_MS) {
+      const dataSources = await fetchGitHubDataSources(trpc, orgID);
+      if (waitsForExpectedDataSources) {
+        if (isScanComplete(dataSources, expectedDataSourceIds)) {
+          latestFiles = await fetchImportableGithubFiles(trpc, spaceID);
+          spinner.stop(latestFiles.length > 0 ? "Docs ready" : "No markdown docs found");
+          return latestFiles;
+        }
+        await sleep3(DOC_SCAN_POLL_INTERVAL_MS);
+        continue;
+      }
       latestFiles = await fetchImportableGithubFiles(trpc, spaceID);
       if (latestFiles.length > 0) {
         spinner.stop("Docs ready");
         return latestFiles;
       }
-      const dataSources = await fetchGitHubDataSources(trpc, orgID);
       if (isScanComplete(dataSources, expectedDataSourceIds)) {
         spinner.stop("No markdown docs found");
         return [];
@@ -8533,13 +8639,13 @@ var exports_flow = {};
 __export(exports_flow, {
   startOAuthFlow: () => startOAuthFlow
 });
-async function startOAuthFlow(signal, path2 = "/cli/auth") {
+async function startOAuthFlow(signal, path2 = "/cli/auth", params = {}) {
   const { server, tokenPromise } = await startCallbackServer();
   let timeoutId;
   try {
     const callbackURL = `http://localhost:${server.port}/callback`;
     logger.debug("auth.flow", `Callback URL: ${callbackURL}`);
-    const authURL = buildAuthURL(callbackURL, path2);
+    const authURL = buildAuthURL(callbackURL, path2, params);
     logger.info("auth.flow", `Auth URL: ${authURL}`);
     const open2 = await Promise.resolve().then(() => (init_open(), exports_open));
     await open2.default(authURL);
@@ -8565,9 +8671,9 @@ async function startOAuthFlow(signal, path2 = "/cli/auth") {
     logger.debug("auth.flow", "Cleaning up: timeout cleared, server closed");
   }
 }
-function buildAuthURL(callbackURL, path2) {
+function buildAuthURL(callbackURL, path2, extraParams) {
   const webAppURL = getWebAppURL();
-  const params = new URLSearchParams({ callback: callbackURL });
+  const params = new URLSearchParams({ callback: callbackURL, ...extraParams });
   return `${webAppURL}${path2}?${params}`;
 }
 var init_flow = __esm(() => {
@@ -8586,21 +8692,28 @@ __export(exports_flow2, {
   runInstallSkill: () => runInstallSkill,
   isStdioOnly: () => isStdioOnly
 });
+import { randomUUID } from "node:crypto";
 import { existsSync as existsSync9 } from "node:fs";
 import { join as join19 } from "node:path";
 async function runSetup(opts = {}) {
+  const onboardingRunID = randomUUID();
   logger.info("setup", `Setup flow started${opts.deploymentID ? ` deployment=${opts.deploymentID}` : ""}${opts.mode ? ` mode=${opts.mode}` : ""}`);
   Ie("Dosu CLI Setup");
+  await trackCliOnboardingPreAuthEvent(onboardingRunID, "cli_onboarding_launch_attempted", {
+    has_deployment_option: Boolean(opts.deploymentID),
+    mode_option: opts.mode
+  });
   let cfg = loadConfig();
   applyModeOverride(cfg, opts);
   if (opts.deploymentID) {
     cfg.mode = undefined;
     saveConfig(cfg);
   }
-  const authedCfg = await stepAuthenticate(cfg);
+  const authedCfg = await stepAuthenticate(cfg, onboardingRunID);
   if (!authedCfg)
     return;
   cfg = authedCfg;
+  await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_auth_completed");
   const apiClient = new Client(cfg);
   let cloudSetupContext = null;
   if (cfg.mode !== MODE_OSS) {
@@ -8608,46 +8721,102 @@ async function runSetup(opts = {}) {
     s.start("Loading your workspace...");
     cloudSetupContext = await resolveCloudSetupContext(cfg);
     if (!cloudSetupContext) {
+      await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_failed", {
+        reason: "cloud_setup_context_failed"
+      });
       s.stop("Workspace load failed");
       return;
     }
     s.stop("Workspace loaded");
   }
+  await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_started", {
+    flow_kind: cloudSetupContext?.kind ?? "oss"
+  });
   if (cfg.mode !== MODE_OSS && cloudSetupContext?.kind === "onboarding") {
     const ok = await bindOnboardingDeployment(apiClient, cfg, cloudSetupContext.targetOrg ?? null);
-    if (!ok)
+    if (!ok) {
+      await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_failed", {
+        reason: "onboarding_deployment_failed"
+      });
       return;
+    }
   } else if (!cfg.deployment_id || opts.deploymentID) {
     const ok = await resolveDeployment(apiClient, cfg, opts);
-    if (!ok)
+    if (!ok) {
+      await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_failed", {
+        reason: "deployment_resolution_failed"
+      });
       return;
+    }
   }
   const apiKey = await stepMintAPIKey(apiClient, cfg);
-  if (!apiKey)
+  if (!apiKey) {
+    await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_failed", {
+      reason: "api_key_failed"
+    });
     return;
+  }
   cfg.api_key = apiKey;
   saveConfig(cfg);
   const choices = await stepOneShotConfirm({
     includeGitHub: cloudSetupContext?.kind === "onboarding"
   });
-  if (!choices)
+  if (!choices) {
+    await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_cancelled", {
+      reason: "options_cancelled"
+    });
     return;
+  }
+  await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_options_selected", {
+    configure_mcp: choices.configureMcp,
+    install_skill: choices.installSkill,
+    connect_github: choices.connectGitHub
+  });
   let mcpConfiguredThisRun = false;
+  let mcpCompleted = false;
+  let skillCompleted = false;
+  let docsImported = false;
   if (choices.configureMcp) {
     const configured = await stepConfigureMcpTools(cfg);
-    if (configured === null)
+    if (configured === null) {
+      await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_cancelled", {
+        reason: "mcp_selection_cancelled"
+      });
       return;
+    }
     mcpConfiguredThisRun = configured.some((r) => r.action === "install" || r.action === "skip");
+    const configuredProviders = configured.filter((r) => (r.action === "install" || r.action === "skip") && !r.error);
+    mcpCompleted = configuredProviders.length > 0;
+    if (mcpCompleted) {
+      await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_mcp_configured", {
+        provider_count: configuredProviders.length,
+        providers: configuredProviders.map((r) => r.provider.id())
+      });
+    }
   }
   if (choices.installSkill) {
-    await runInstallSkill();
+    skillCompleted = await runInstallSkill();
+    if (skillCompleted) {
+      await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_skill_installed");
+    }
   }
   let githubOnboardingDone = !choices.connectGitHub;
   if (choices.connectGitHub && cloudSetupContext?.kind === "onboarding") {
     const { stepConnectGitHubRepo: stepConnectGitHubRepo2 } = await Promise.resolve().then(() => (init_github_step(), exports_github_step));
     const connectResult = await stepConnectGitHubRepo2(cfg);
-    if (!connectResult.advance)
+    if (!connectResult.advance) {
+      await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_cancelled", {
+        reason: "github_connect_not_advanced",
+        has_connected_repo: connectResult.has_connected_repo
+      });
       return;
+    }
+    if (connectResult.has_connected_repo || (connectResult.created_data_source_ids?.length ?? 0) > 0) {
+      await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_github_connected", {
+        created_data_source_count: connectResult.created_data_source_ids?.length ?? 0,
+        created_repository_slugs: connectResult.created_repository_slugs
+      });
+    }
     if (connectResult.space_id && !cfg.space_id) {
       cfg.space_id = connectResult.space_id;
       saveConfig(cfg);
@@ -8657,8 +8826,24 @@ async function runSetup(opts = {}) {
       waitForFreshDocs: Boolean(connectResult.deployment_id),
       expectedDataSourceIds: connectResult.created_data_source_ids
     });
-    if (!importResult.advance)
+    if (!importResult.advance) {
+      await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_failed", {
+        reason: "github_docs_import_failed"
+      });
       return;
+    }
+    docsImported = importResult.imported === true && (importResult.imported_count ?? 0) > 0;
+    if (docsImported) {
+      await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_docs_imported", {
+        imported_count: importResult.imported_count ?? 0,
+        failed_count: importResult.failed_count ?? 0,
+        task_id: importResult.task_id
+      });
+      await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_activated", {
+        imported_count: importResult.imported_count ?? 0,
+        failed_count: importResult.failed_count ?? 0
+      });
+    }
     githubOnboardingDone = true;
   }
   const shouldCompleteRemoteOnboarding = cloudSetupContext?.kind === "onboarding" && githubOnboardingDone;
@@ -8684,6 +8869,13 @@ async function runSetup(opts = {}) {
       hasAgentsMd: existsSync9(join19(process.cwd(), "AGENTS.md"))
     });
   }
+  if (mcpCompleted || skillCompleted || docsImported) {
+    await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_completed", {
+      completed_mcp: mcpCompleted,
+      completed_skill: skillCompleted,
+      imported_docs: docsImported
+    });
+  }
   if (cfg.mode === MODE_OSS) {
     Se("Setup complete! Using open-source libraries only.\n\nTips: Run `dosu setup --mode cloud` to connect your own repos.");
   } else {
@@ -8767,7 +8959,7 @@ async function runInstallSkill() {
     return false;
   }
 }
-async function stepAuthenticate(existingCfg) {
+async function stepAuthenticate(existingCfg, onboardingRunID) {
   logger.info("setup", "Step: authenticate");
   const cfg = existingCfg ?? loadConfig();
   if (cfg.access_token) {
@@ -8798,16 +8990,25 @@ async function stepAuthenticate(existingCfg) {
     }
   }
   const shouldLogin = await ye({ message: "Open browser to log in?" });
-  if (pD(shouldLogin) || !shouldLogin)
+  if (pD(shouldLogin) || !shouldLogin) {
+    if (onboardingRunID) {
+      await trackCliOnboardingPreAuthEvent(onboardingRunID, "cli_onboarding_auth_cancelled", {
+        reason: pD(shouldLogin) ? "prompt_cancelled" : "login_declined"
+      });
+    }
     return null;
-  return await openBrowserForSetup(cfg);
+  }
+  if (onboardingRunID) {
+    await trackCliOnboardingPreAuthEvent(onboardingRunID, "cli_onboarding_auth_started");
+  }
+  return await openBrowserForSetup(cfg, onboardingRunID);
 }
-async function openBrowserForSetup(cfg) {
+async function openBrowserForSetup(cfg, onboardingRunID) {
   try {
     const { startOAuthFlow: startOAuthFlow2 } = await Promise.resolve().then(() => (init_flow(), exports_flow));
     const s = Y2();
     s.start("Waiting for authentication...");
-    const token = await startOAuthFlow2(undefined, "/cli/auth");
+    const token = await startOAuthFlow2(undefined, "/cli/auth", onboardingRunID ? { onboarding_run_id: onboardingRunID } : {});
     s.stop("Authenticated");
     logger.info("setup", "Browser auth completed");
     cfg.access_token = token.access_token;
@@ -8819,6 +9020,11 @@ async function openBrowserForSetup(cfg) {
     const msg = err instanceof Error ? err.stack ?? err.message : String(err);
     logger.error("setup", `Auth failed: ${msg}`);
     M2.error(`Authentication failed: ${err instanceof Error ? err.message : String(err)}`);
+    if (onboardingRunID) {
+      await trackCliOnboardingPreAuthEvent(onboardingRunID, "cli_onboarding_auth_failed", {
+        reason: err instanceof Error ? err.message : String(err)
+      });
+    }
     return null;
   }
 }
@@ -8856,14 +9062,11 @@ async function resolveCloudSetupContext(cfg) {
   }
 }
 async function resolveOnboardingTargetOrg(trpc) {
-  const ownerOrgs = await trpc.organization.getOrganizations.query({
-    userRole: "OWNER",
-    exact: true
-  });
-  if (ownerOrgs.length > 0) {
-    return ownerOrgs[0];
-  }
   const accessibleOrgs = await trpc.organization.getOrganizations.query();
+  const ownerOrg = accessibleOrgs.find((org) => org.user_role === "OWNER");
+  if (ownerOrg) {
+    return ownerOrg;
+  }
   return accessibleOrgs[0] ?? null;
 }
 async function bindOnboardingDeployment(apiClient, cfg, targetOrg) {
@@ -9142,6 +9345,7 @@ var init_flow2 = __esm(() => {
   init_config();
   init_logger();
   init_providers();
+  init_analytics();
   init_styles();
 });
 
@@ -9379,7 +9583,6 @@ function analyticsCommand() {
       ["Low Confidence", String(stats.byConfidence.low)],
       ["Positive Reactions", String(stats.reactions.totalPositive)],
       ["Negative Reactions", String(stats.reactions.totalNegative)],
-      ["Reaction Rate", pct(stats.reactions.reactionRate)],
       ["Positive Rate", pct(stats.reactions.positiveRate)]
     ], { rawData: stats });
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dosu/cli",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "type": "module",
   "description": "Dosu CLI - Manage MCP servers for AI tools",
   "license": "MIT",
@@ -48,7 +48,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.10.0",
-    "@dosu/api-types": "0.0.4",
+    "@dosu/api-types": "0.0.7",
     "commander": "^13.1.0",
     "open": "^10.1.0",
     "picocolors": "^1.1.1",