ardent-cli 0.0.9 → 0.0.10

package/dist/index.js

@@ -224,6 +224,55 @@ function isPermissionError(err) {
   return false;
 }
 
+// src/lib/telemetry.ts
+import { randomUUID } from "crypto";
+function getAnonymousId() {
+  let anonymousId = getConfig("anonymousId");
+  if (!anonymousId) {
+    anonymousId = randomUUID();
+    setConfig("anonymousId", anonymousId);
+  }
+  return anonymousId;
+}
+function trackEvent(event, properties = {}) {
+  const distinctId = getConfig("userId") ?? getAnonymousId();
+  fetch(`${getApiUrl()}/v1/posthog/event`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      events: [{
+        event,
+        properties: {
+          ...properties,
+          distinct_id: distinctId,
+          source: "cli"
+        }
+      }]
+    })
+  }).catch(() => {
+  });
+}
+function identifyUser(userId, personProperties = {}) {
+  const anonymousId = getAnonymousId();
+  setConfig("userId", userId);
+  fetch(`${getApiUrl()}/v1/posthog/event`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      events: [{
+        event: "$identify",
+        properties: {
+          distinct_id: userId,
+          $anon_distinct_id: anonymousId,
+          source: "cli",
+          $set: personProperties
+        }
+      }]
+    })
+  }).catch(() => {
+  });
+}
+
 // src/commands/branch/create.ts
 async function createAction(name, options) {
   try {
@@ -256,6 +305,7 @@ async function createAction(name, options) {
     setCacheEntry("branches", cachedBranches);
     setCurrentBranch(name);
     const elapsed = ((performance.now() - startTime) / 1e3).toFixed(1);
+    trackEvent("CLI: branch create succeeded", { service_type: options.service, duration_seconds: parseFloat(elapsed) });
     console.log(`\u2713 Branch '${name}' created and checked out in ${elapsed}s`);
     if (branch.branch_url) {
       console.log(`
@@ -263,9 +313,11 @@ ${branch.branch_url}`);
     }
   } catch (err) {
     if (isNetworkError(err)) {
+      trackEvent("CLI: branch create failed", { reason: "offline" });
       console.error("\u2717 Cannot create branch while offline");
       process.exit(1);
     }
+    trackEvent("CLI: branch create failed", { reason: "api_error" });
     console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
     process.exit(1);
   }
@@ -290,11 +342,14 @@ async function listAction() {
         branches = cached.data;
         fromCache = true;
         cacheTime = formatCacheTime(cached.updated_at);
+        trackEvent("CLI: branch list served from cache");
       } else {
+        trackEvent("CLI: branch list failed", { reason: "offline_no_cache" });
         console.error("\u2717 Offline and no cached data available");
         process.exit(1);
       }
     } else {
+      trackEvent("CLI: branch list failed", { reason: "api_error" });
       console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
       process.exit(1);
     }
@@ -303,6 +358,7 @@ async function listAction() {
     console.log(`\u26A0 Offline - showing cached data from ${cacheTime}
 `);
   }
+  trackEvent("CLI: branch list succeeded", { branch_count: branches.length, from_cache: fromCache });
   if (branches.length === 0) {
     console.log("No branches found");
     console.log("  Create one with: ardent branch create <name>");
@@ -357,6 +413,7 @@ function infoAction(name) {
     console.log(`
   URL: ${branch.branch_url}`);
   }
+  trackEvent("CLI: branch info");
 }
 
 // src/commands/branch/delete.ts
@@ -375,12 +432,15 @@ async function deleteAction(name) {
     if (getCurrentBranch() === name) {
       clearCurrentBranch();
     }
+    trackEvent("CLI: branch delete succeeded");
     console.log("\u2713 Branch deleted");
   } catch (err) {
     if (isNetworkError(err)) {
+      trackEvent("CLI: branch delete failed", { reason: "offline" });
       console.error("\u2717 Cannot delete branch while offline");
       process.exit(1);
     }
+    trackEvent("CLI: branch delete failed", { reason: "api_error" });
     console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
     process.exit(1);
   }
@@ -427,6 +487,7 @@ async function switchAction(name) {
     console.log(`
 ${branch.branch_url}`);
   }
+  trackEvent("CLI: branch switch");
 }
 
 // src/commands/branch/diff.ts
@@ -632,8 +693,14 @@ async function diffAction(options) {
       if ((!ddl || ddl.length === 0) && (!diff || diff.length === 0)) {
         console.log("No changes");
       }
+      trackEvent("CLI: branch diff succeeded", {
+        sql_mode: Boolean(options.sql),
+        ddl_count: ddl?.length ?? 0,
+        data_change_count: diff?.length ?? 0
+      });
     }
   } catch (err) {
+    trackEvent("CLI: branch diff failed", { reason: "api_error" });
     console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
     process.exit(1);
   }
@@ -865,11 +932,13 @@ async function createAction2(type, url, options) {
     const cachedConnectors = cached?.data || [];
     cachedConnectors.push(newConnector);
     setCacheEntry("connectors", cachedConnectors);
+    trackEvent("CLI: connector create succeeded", { db_type: type, byoc: isByoc });
     console.log("\u2713 Connector created and ready");
     console.log(`  ID: ${connectorId}`);
     showNextStep();
   } catch (err) {
     if (isPermissionError(err)) {
+      trackEvent("CLI: connector create failed", { reason: "permission_denied" });
       console.error("\u2717 You don't have permission to create connectors.");
       console.error("");
       console.error("  Ask your organization admin to either:");
@@ -877,6 +946,7 @@ async function createAction2(type, url, options) {
       console.error("  \u2022 Upgrade your role to Admin");
       process.exit(1);
     }
+    trackEvent("CLI: connector create failed", { reason: "api_error" });
     console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
     process.exit(1);
   }
@@ -902,14 +972,17 @@ async function listAction2() {
         fromCache = true;
         cacheTime = formatCacheTime(cached.updated_at);
       } else {
+        trackEvent("CLI: connector list failed", { reason: "offline_no_cache" });
         console.error("\u2717 Offline and no cached data available");
         process.exit(1);
       }
     } else {
+      trackEvent("CLI: connector list failed", { reason: "api_error" });
       console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
       process.exit(1);
     }
   }
+  trackEvent("CLI: connector list succeeded", { connector_count: connectors.length, from_cache: fromCache });
   if (fromCache) {
     console.log(`\u26A0 Offline - showing cached data from ${cacheTime}
 `);
@@ -960,13 +1033,16 @@ async function deleteAction2(name) {
       const updatedConnectors = currentCache.data.filter((c) => c.id !== connector.id);
       setCacheEntry("connectors", updatedConnectors);
     }
+    trackEvent("CLI: connector delete succeeded");
     console.log("\u2713 Connector deleted");
   } catch (err) {
     if (isNetworkError(err)) {
+      trackEvent("CLI: connector delete failed", { reason: "offline" });
       console.error("\u2717 Cannot delete connector while offline");
       process.exit(1);
     }
     if (isPermissionError(err)) {
+      trackEvent("CLI: connector delete failed", { reason: "permission_denied" });
       console.error("\u2717 You don't have permission to delete connectors.");
       console.error("");
       console.error("  Ask your organization admin to either:");
@@ -974,6 +1050,7 @@ async function deleteAction2(name) {
       console.error("  \u2022 Upgrade your role to Admin");
       process.exit(1);
     }
+    trackEvent("CLI: connector delete failed", { reason: "api_error" });
     console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
     process.exit(1);
   }
@@ -1001,15 +1078,18 @@ async function sendAction(email, role) {
       email,
       role: role.toLowerCase()
     });
+    trackEvent("CLI: invite send succeeded", { role: result.role });
     console.log(`\u2713 Invite sent to ${result.email}`);
     console.log(`  Role: ${result.role}`);
     console.log(`  Org: ${result.org_name}`);
   } catch (err) {
     if (isNetworkError(err)) {
+      trackEvent("CLI: invite send failed", { reason: "offline" });
       console.error("\u2717 Cannot send invite while offline");
       process.exit(1);
     }
     if (isPermissionError(err)) {
+      trackEvent("CLI: invite send failed", { reason: "permission_denied" });
       console.error("\u2717 You don't have permission to invite users.");
       console.error("");
       console.error("  Ask your organization admin to either:");
@@ -1017,6 +1097,7 @@ async function sendAction(email, role) {
       console.error("  \u2022 Upgrade your role to Admin");
       process.exit(1);
     }
+    trackEvent("CLI: invite send failed", { reason: "api_error" });
     console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
     process.exit(1);
   }
@@ -1030,6 +1111,7 @@ async function listAction3() {
       throw new Error("API returned invalid response: missing invites array");
     }
     const invites = result.invites;
+    trackEvent("CLI: invite list succeeded", { invite_count: invites.length });
     if (invites.length === 0) {
       console.log("No pending invites");
       return;
@@ -1043,9 +1125,11 @@ async function listAction3() {
     }
   } catch (err) {
     if (isNetworkError(err)) {
+      trackEvent("CLI: invite list failed", { reason: "offline" });
       console.error("\u2717 Cannot list invites while offline");
       process.exit(1);
     }
+    trackEvent("CLI: invite list failed", { reason: "api_error" });
     console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
     process.exit(1);
   }
@@ -1055,12 +1139,15 @@ async function listAction3() {
 async function deleteAction3(email) {
   try {
     await api.delete("/v1/cli/invites", { email });
+    trackEvent("CLI: invite delete succeeded");
     console.log(`\u2713 Invite for ${email} deleted`);
   } catch (err) {
     if (isNetworkError(err)) {
+      trackEvent("CLI: invite delete failed", { reason: "offline" });
       console.error("\u2717 Cannot delete invite while offline");
       process.exit(1);
     }
+    trackEvent("CLI: invite delete failed", { reason: "api_error" });
     console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
     process.exit(1);
   }
@@ -1084,6 +1171,7 @@ import { Command as Command4 } from "commander";
 async function membersAction() {
   try {
     const result = await api.get("/v1/cli/members");
+    trackEvent("CLI: org members succeeded", { member_count: result.members?.length ?? 0 });
     if (!result.members || result.members.length === 0) {
       console.log("No members found");
       return;
@@ -1097,9 +1185,11 @@ async function membersAction() {
     }
   } catch (err) {
     if (isNetworkError(err)) {
+      trackEvent("CLI: org members failed", { reason: "offline" });
       console.error("\u2717 Cannot list members while offline");
       process.exit(1);
     }
+    trackEvent("CLI: org members failed", { reason: "api_error" });
     console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
     process.exit(1);
   }
@@ -1115,18 +1205,22 @@ async function setRoleAction(email, role) {
   }
   try {
     const result = await api.patch("/v1/cli/members/role", { email, role });
+    trackEvent("CLI: org set-role succeeded", { role: result.new_role });
     console.log(`\u2713 Updated ${result.email} to ${result.new_role}`);
   } catch (err) {
     if (isNetworkError(err)) {
+      trackEvent("CLI: org set-role failed", { reason: "offline" });
       console.error("\u2717 Cannot update role while offline");
       process.exit(1);
     }
     if (isPermissionError(err)) {
+      trackEvent("CLI: org set-role failed", { reason: "permission_denied" });
       console.error("\u2717 You don't have permission to update member roles.");
       console.error("");
       console.error("  Only org admins and owners can change roles.");
       process.exit(1);
     }
+    trackEvent("CLI: org set-role failed", { reason: "api_error" });
     console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
     process.exit(1);
   }
@@ -1136,18 +1230,22 @@ async function setRoleAction(email, role) {
 async function removeAction(email) {
   try {
     await api.delete("/v1/cli/members", { email });
+    trackEvent("CLI: org remove member succeeded");
     console.log(`\u2713 Removed ${email} from organization`);
   } catch (err) {
     if (isNetworkError(err)) {
+      trackEvent("CLI: org remove member failed", { reason: "offline" });
       console.error("\u2717 Cannot remove member while offline");
       process.exit(1);
     }
     if (isPermissionError(err)) {
+      trackEvent("CLI: org remove member failed", { reason: "permission_denied" });
       console.error("\u2717 You don't have permission to remove members.");
       console.error("");
       console.error("  Only org admins and owners can remove members.");
       process.exit(1);
     }
+    trackEvent("CLI: org remove member failed", { reason: "api_error" });
     console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
     process.exit(1);
   }
@@ -1167,8 +1265,19 @@ async function loginAction(options) {
   if (options.token) {
     setConfig("token", options.token);
     console.log("\u2713 Logged in successfully");
+    trackEvent("CLI: login succeeded", { method: "token" });
     try {
       await bootstrapCache();
+      const user = getConfig("user");
+      if (user) {
+        const tokenPersonProperties = {};
+        if (user.email) tokenPersonProperties.email = user.email;
+        if (user.full_name) tokenPersonProperties.$name = user.full_name;
+        if (user.org_name) tokenPersonProperties.org_name = user.org_name;
+        if (user.user_id) {
+          identifyUser(user.user_id, tokenPersonProperties);
+        }
+      }
     } catch {
     }
     showNextStep();
@@ -1182,6 +1291,7 @@ async function loginAction(options) {
     });
     if (!initResponse.ok) {
       const error = await initResponse.text();
+      trackEvent("CLI: login failed", { method: "browser", reason: "init_failed" });
       console.error("\u2717 Failed to initialize auth:", error);
       process.exit(1);
     }
@@ -1198,6 +1308,7 @@ async function loginAction(options) {
         `${getApiUrl()}/v1/cli/auth/poll?session=${session_id}`
       );
       if (!pollResponse.ok) {
+        trackEvent("CLI: login failed", { method: "browser", reason: "poll_failed" });
         console.error("\u2717 Poll failed");
         process.exit(1);
       }
@@ -1205,26 +1316,39 @@ async function loginAction(options) {
       if (result.status === "completed") {
         setConfig("token", result.token);
         console.log("\n\u2713 Logged in successfully");
+        trackEvent("CLI: login succeeded", { method: "browser" });
         try {
           await bootstrapCache();
         } catch {
         }
+        const user = getConfig("user");
+        const personProperties = {};
+        if (user?.email) personProperties.email = user.email;
+        if (user?.full_name) personProperties.$name = user.full_name;
+        if (user?.org_name) personProperties.org_name = user.org_name;
+        if (result.user_id) {
+          identifyUser(result.user_id, personProperties);
+        }
         showNextStep();
         return;
       }
       if (result.status === "expired") {
+        trackEvent("CLI: login failed", { method: "browser", reason: "expired" });
         console.error("\n\u2717 Session expired. Please try again.");
         process.exit(1);
       }
       if (result.status === "error") {
+        trackEvent("CLI: login failed", { method: "browser", reason: "error" });
         console.error("\n\u2717 Error:", result.message);
         process.exit(1);
       }
       process.stdout.write(".");
     }
+    trackEvent("CLI: login failed", { method: "browser", reason: "timeout" });
     console.error("\n\u2717 Timed out. Please try again.");
     process.exit(1);
   } catch (error) {
+    trackEvent("CLI: login failed", { method: "browser", reason: "network_error" });
     console.error("\u2717 Login failed:", error instanceof Error ? error.message : error);
     process.exit(1);
   }
@@ -1232,6 +1356,7 @@ async function loginAction(options) {
 
 // src/commands/auth/logout.ts
 function logoutAction() {
+  trackEvent("CLI: logout");
   clearConfig();
   console.log("\u2713 Logged out");
 }
@@ -1240,6 +1365,7 @@ function logoutAction() {
 function statusAction() {
   const token = getConfig("token");
   if (!token) {
+    trackEvent("CLI: auth status", { authenticated: false });
     console.log("\u2717 Not authenticated");
     console.log("  Run: ardent login");
     return;
@@ -1259,6 +1385,7 @@ function statusAction() {
     console.log(`  Token: ${token.slice(0, 8)}...${token.slice(-4)}`);
     console.log("  Run: ardent login to refresh profile info");
   }
+  trackEvent("CLI: auth status", { authenticated: true });
 }
 
 // src/commands/auth/index.ts
@@ -1352,4 +1479,5 @@ if (args.length === 0) {
   }
   program.help();
 }
+getAnonymousId();
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ardent-cli",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "Git for Data infrastructure",
   "type": "module",
   "bin": {