ardent-cli 0.0.9 → 0.0.11

package/dist/index.js

@@ -1,12 +1,15 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { readFileSync as readFileSync2 } from "fs";
-import { Command as Command6 } from "commander";
+import { readFileSync as readFileSync4 } from "fs";
+import { Command as Command7 } from "commander";
 
 // src/commands/branch/index.ts
 import { Command } from "commander";
 
+// src/lib/api.ts
+import { readFileSync as readFileSync2 } from "fs";
+
 // src/lib/config.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from "fs";
 import { homedir } from "os";
@@ -104,9 +107,8 @@ async function bootstrapCache() {
     "Content-Type": "application/json",
     "Authorization": `Bearer ${token}`
   };
-  const [connectorsRes, branchesRes, meRes] = await Promise.all([
+  const [connectorsRes, meRes] = await Promise.all([
     fetch(`${apiUrl}/v1/cli/connectors`, { headers }),
-    fetch(`${apiUrl}/v1/cli/branches`, { headers }),
     fetch(`${apiUrl}/v1/cli/me`, { headers })
   ]);
   let connectorCount = 0;
@@ -117,20 +119,38 @@ async function bootstrapCache() {
     setCacheEntry("connectors", connectors);
     connectorCount = connectors.length;
   }
-  if (branchesRes.ok) {
-    const data = await branchesRes.json();
-    const branches = data.branches || [];
-    setCacheEntry("branches", branches);
-    branchCount = branches.length;
-  }
   if (meRes.ok) {
     const user = await meRes.json();
     setConfig("user", user);
   }
+  const currentConnectorId = getConfig("currentConnectorId");
+  if (currentConnectorId) {
+    const branchesRes = await fetch(
+      `${apiUrl}/v1/cli/branches?connector_id=${currentConnectorId}`,
+      { headers }
+    );
+    if (branchesRes.ok) {
+      const data = await branchesRes.json();
+      const branches = data.branches || [];
+      setCacheEntry("branches", branches);
+      branchCount = branches.length;
+    }
+  }
   return { connectors: connectorCount, branches: branchCount };
 }
 
 // src/lib/api.ts
+function getCliVersion() {
+  try {
+    const packageUrl = new URL("../package.json", import.meta.url);
+    const raw = readFileSync2(packageUrl, "utf-8");
+    const parsed = JSON.parse(raw);
+    return parsed.version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+var CLI_VERSION = getCliVersion();
 function parseApiError(status, text) {
   try {
     const json = JSON.parse(text);
@@ -139,6 +159,20 @@ function parseApiError(status, text) {
   }
   return `API error ${status}: ${text}`;
 }
+function handleUpgradeRequired(text) {
+  try {
+    const json = JSON.parse(text);
+    if (json.detail) {
+      console.error(`
+\u2717 ${json.detail}
+`);
+    }
+  } catch {
+    console.error("\n\u2717 Your CLI is outdated. Please update:\n");
+  }
+  console.error("  npm install -g ardent-cli@latest\n");
+  process.exit(1);
+}
 var ApiClient = class {
   getHeaders() {
     const token = getToken();
@@ -150,20 +184,28 @@ var ApiClient = class {
     }
     return {
       "Content-Type": "application/json",
-      "Authorization": `Bearer ${token}`
+      "Authorization": `Bearer ${token}`,
+      "X-CLI-Version": CLI_VERSION
     };
   }
+  async handleResponse(response) {
+    if (response.status === 426) {
+      const text = await response.text();
+      handleUpgradeRequired(text);
+    }
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(parseApiError(response.status, text));
+    }
+    return response.json();
+  }
   async get(path) {
     const url = `${getApiUrl()}${path}`;
     const response = await fetch(url, {
       method: "GET",
       headers: this.getHeaders()
     });
-    if (!response.ok) {
-      const text = await response.text();
-      throw new Error(parseApiError(response.status, text));
-    }
-    return response.json();
+    return this.handleResponse(response);
   }
   async post(path, body) {
     const url = `${getApiUrl()}${path}`;
@@ -172,11 +214,7 @@ var ApiClient = class {
       headers: this.getHeaders(),
       body: JSON.stringify(body)
     });
-    if (!response.ok) {
-      const text = await response.text();
-      throw new Error(parseApiError(response.status, text));
-    }
-    return response.json();
+    return this.handleResponse(response);
   }
   async delete(path, body) {
     const url = `${getApiUrl()}${path}`;
@@ -185,11 +223,7 @@ var ApiClient = class {
       headers: this.getHeaders(),
       body: body ? JSON.stringify(body) : void 0
     });
-    if (!response.ok) {
-      const text = await response.text();
-      throw new Error(parseApiError(response.status, text));
-    }
-    return response.json();
+    return this.handleResponse(response);
   }
   async patch(path, body) {
     const url = `${getApiUrl()}${path}`;
@@ -198,11 +232,7 @@ var ApiClient = class {
       headers: this.getHeaders(),
       body: JSON.stringify(body)
     });
-    if (!response.ok) {
-      const text = await response.text();
-      throw new Error(parseApiError(response.status, text));
-    }
-    return response.json();
+    return this.handleResponse(response);
   }
 };
 var api = new ApiClient();
@@ -224,27 +254,86 @@ 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 {
     const startTime = performance.now();
-    const job = await api.post("/v1/cli/jobs/create", {
-      name
-    });
+    const connectorId = getConfig("currentConnectorId");
+    if (!connectorId) {
+      console.error("\u2717 No connector selected. Run 'ardent connector switch' first.");
+      process.exit(1);
+    }
     await api.post("/v1/branch/create", {
-      job_id: job.job_id,
-      service_type: options.service
+      connector_id: connectorId,
+      service_type: options.service,
+      name
     });
-    const apiBranches = await api.get(`/v1/branches/${job.job_id}`);
-    const apiBranch = apiBranches.find((branch2) => branch2.service_type === options.service);
+    const response = await api.get(`/v1/cli/branches?connector_id=${connectorId}`);
+    const apiBranches = response.branches || [];
+    let apiBranch;
+    for (const branch2 of apiBranches) {
+      if (branch2.name === name) {
+        apiBranch = branch2;
+        break;
+      }
+    }
     if (!apiBranch) {
       console.error("\u2717 Branch created but could not fetch details");
       process.exit(1);
     }
     const branch = {
       id: apiBranch.id,
-      job_id: job.job_id,
-      name,
+      connector_id: apiBranch.connector_id,
+      name: apiBranch.name,
       service_type: apiBranch.service_type,
       branch_url: apiBranch.branch_url || "",
       status: apiBranch.status,
@@ -256,6 +345,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 +353,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);
   }
@@ -277,7 +369,12 @@ async function listAction() {
   let fromCache = false;
   let cacheTime = "";
   try {
-    const result = await api.get("/v1/cli/branches");
+    const currentConnectorId = getConfig("currentConnectorId");
+    if (!currentConnectorId) {
+      console.error("\u2717 No connector selected. Run 'ardent connector switch' first.");
+      process.exit(1);
+    }
+    const result = await api.get(`/v1/cli/branches?connector_id=${currentConnectorId}`);
     if (!result.branches) {
       throw new Error("API returned invalid response: missing branches array");
     }
@@ -290,11 +387,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 +403,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 +458,7 @@ function infoAction(name) {
     console.log(`
   URL: ${branch.branch_url}`);
   }
+  trackEvent("CLI: branch info");
 }
 
 // src/commands/branch/delete.ts
@@ -369,18 +471,21 @@ async function deleteAction(name) {
     process.exit(1);
   }
   try {
-    await api.delete(`/v1/cli/jobs/${branch.job_id}`);
+    await api.delete(`/v1/cli/branches/${branch.id}`);
     const updatedBranches = cached.data.filter((cachedBranch) => cachedBranch.id !== branch.id);
     setCacheEntry("branches", updatedBranches);
     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 +532,7 @@ async function switchAction(name) {
     console.log(`
 ${branch.branch_url}`);
   }
+  trackEvent("CLI: branch switch");
 }
 
 // src/commands/branch/diff.ts
@@ -476,7 +582,7 @@ async function diffAction(options) {
     return;
   }
   try {
-    const stateRaw = await api.get(`/v1/branches/${branch.job_id}/state`);
+    const stateRaw = await api.get(`/v1/branches/${branch.id}/state`);
     if (!stateRaw || Object.keys(stateRaw).length === 0) {
       console.log("No changes captured");
       return;
@@ -632,8 +738,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);
   }
@@ -800,12 +912,20 @@ async function createAction2(type, url, options) {
   }
   try {
     const connectorName = options.name || (isByoc ? "my-neon-connection" : "my-postgresql-connection");
+    const currentProjectId = getConfig("currentProjectId");
+    if (!currentProjectId) {
+      console.error("\u2717 No current project set. Switch to a project first:");
+      console.error("  ardent project list");
+      console.error("  ardent project switch <name>");
+      process.exit(1);
+    }
     let createPayload;
     if (isByoc) {
       console.log("Creating connector (BYOC Neon)...");
       createPayload = {
         name: connectorName,
         service_name: "postgresql",
+        project_id: currentProjectId,
         byoc: options.byoc,
         neon_api_key: options.apiKey,
         neon_project_id: options.projectId,
@@ -822,6 +942,7 @@ async function createAction2(type, url, options) {
       createPayload = {
         name: connectorName,
         service_name: "postgresql",
+        project_id: currentProjectId,
         connection_details: {
           host: parsed.host,
           port: parsed.port,
@@ -865,11 +986,15 @@ async function createAction2(type, url, options) {
     const cachedConnectors = cached?.data || [];
     cachedConnectors.push(newConnector);
     setCacheEntry("connectors", cachedConnectors);
+    setConfig("currentConnectorId", connectorId);
+    setConfig("currentConnectorName", connectorName);
+    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 +1002,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);
   }
@@ -888,7 +1014,9 @@ async function listAction2() {
   let fromCache = false;
   let cacheTime = "";
   try {
-    const result = await api.get("/v1/cli/connectors");
+    const currentProjectId = getConfig("currentProjectId");
+    const projectFilter = currentProjectId ? `?project_id=${currentProjectId}` : "";
+    const result = await api.get(`/v1/cli/connectors${projectFilter}`);
     if (!result.connectors) {
       throw new Error("API returned invalid response: missing connectors array");
     }
@@ -902,14 +1030,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}
 `);
@@ -919,11 +1050,21 @@ async function listAction2() {
     console.log("  Create one with: ardent connector create postgresql <url>");
     return;
   }
+  const currentConnectorId = getConfig("currentConnectorId");
+  const green3 = "\x1B[32m";
+  const dim3 = "\x1B[2m";
+  const reset3 = "\x1B[0m";
   console.log("Connectors:\n");
   for (const connector of connectors) {
+    const isCurrent = connector.id === currentConnectorId;
     const icon = connector.status === "healthy" ? "\u25CF" : "\u25CB";
-    console.log(`  ${icon} ${connector.service_name}`);
-    console.log(`    Name: ${connector.name}`);
+    if (isCurrent) {
+      console.log(`${green3}* ${icon} ${connector.name}${reset3}`);
+      console.log(`${green3}    ${connector.service_name}${reset3}`);
+    } else {
+      console.log(`  ${icon} ${connector.name}`);
+      console.log(`${dim3}    ${connector.service_name}${reset3}`);
+    }
     console.log();
   }
 }
@@ -960,13 +1101,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,15 +1118,70 @@ 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);
   }
 }
 
+// src/commands/connector/switch.ts
+async function switchAction2(name) {
+  const cached = getCacheEntry("connectors");
+  let connector = cached?.data.find(
+    (cachedConnector) => cachedConnector.name === name
+  );
+  if (!connector) {
+    try {
+      const result = await api.get("/v1/cli/connectors");
+      if (!result.connectors) {
+        throw new Error("API returned invalid response: missing connectors array");
+      }
+      setCacheEntry("connectors", result.connectors);
+      connector = result.connectors.find(
+        (remoteConnector) => remoteConnector.name === name
+      );
+    } catch (err) {
+      if (isNetworkError(err)) {
+        if (!connector) {
+          console.error(`\u2717 Connector "${name}" not found in cache`);
+          console.log("  Run 'ardent connector list' when online to refresh");
+          process.exit(1);
+        }
+      } else {
+        console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+        process.exit(1);
+      }
+    }
+  }
+  if (!connector) {
+    console.error(`\u2717 Connector "${name}" not found`);
+    console.log("  Run: ardent connector list");
+    process.exit(1);
+  }
+  const previousName = getConfig("currentConnectorName");
+  setConfig("currentConnectorId", connector.id);
+  setConfig("currentConnectorName", connector.name);
+  clearCurrentBranch();
+  if (previousName && previousName !== name) {
+    console.log(`Switched from '${previousName}' to '${name}'`);
+  } else {
+    console.log(`Switched to connector '${name}'`);
+  }
+  try {
+    const branchResult = await api.get(
+      `/v1/cli/branches?connector_id=${connector.id}`
+    );
+    setCacheEntry("branches", branchResult.branches || []);
+  } catch {
+  }
+  trackEvent("CLI: connector switch");
+}
+
 // src/commands/connector/index.ts
 var connectorCommand = new Command2("connector").description("Manage database connectors");
 connectorCommand.command("create <type> [url]").description("Create a new connector").option("-n, --name <name>", "Connector name").option("--byoc <provider>", "Bring your own Neon project (e.g. neon)").option("--api-key <key>", "Neon API key (required with --byoc)").option("--project-id <id>", "Neon project ID (required with --byoc)").action(createAction2);
 connectorCommand.command("list").description("List your connectors").action(listAction2);
+connectorCommand.command("switch <name>").description("Switch to a different connector").action(switchAction2);
 connectorCommand.command("delete <name>").description("Delete a connector by name").action(deleteAction2);
 
 // src/commands/invite/index.ts
@@ -1001,15 +1200,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 +1219,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 +1233,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 +1247,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 +1261,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 +1293,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 +1307,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 +1327,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 +1352,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);
   }
@@ -1159,16 +1379,203 @@ orgCommand.command("members").description("List organization members").action(me
 orgCommand.command("set-role <email> <role>").description("Update a member's role (owner/admin/member/viewer)").action(setRoleAction);
 orgCommand.command("remove <email>").description("Remove a member from the organization").action(removeAction);
 
-// src/commands/auth/index.ts
+// src/commands/project/index.ts
 import { Command as Command5 } from "commander";
 
+// src/commands/project/create.ts
+async function createAction3(name) {
+  const user = getConfig("user");
+  if (!user?.org_id) {
+    console.error("\u2717 No organization found. Run: ardent login");
+    process.exit(1);
+  }
+  try {
+    const project = await api.post("/v1/projects", {
+      name,
+      org_id: user.org_id
+    });
+    const cached = getCacheEntry("projects");
+    const cachedProjects = cached?.data || [];
+    cachedProjects.push(project);
+    setCacheEntry("projects", cachedProjects);
+    setConfig("currentProjectId", project.id);
+    setConfig("currentProjectName", project.name);
+    trackEvent("CLI: project create succeeded");
+    console.log(`\u2713 Project '${name}' created`);
+    console.log(`  ID: ${project.id}`);
+  } catch (err) {
+    if (isNetworkError(err)) {
+      trackEvent("CLI: project create failed", { reason: "offline" });
+      console.error("\u2717 Cannot create project while offline");
+      process.exit(1);
+    }
+    if (isPermissionError(err)) {
+      trackEvent("CLI: project create failed", { reason: "permission_denied" });
+      console.error("\u2717 You don't have permission to create projects.");
+      process.exit(1);
+    }
+    trackEvent("CLI: project create failed", { reason: "api_error" });
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+}
+
+// src/commands/project/list.ts
+async function listAction4() {
+  let projects = [];
+  let fromCache = false;
+  let cacheTime = "";
+  try {
+    const user = getConfig("user");
+    if (!user?.org_id) {
+      console.error("\u2717 No organization found. Run: ardent login");
+      process.exit(1);
+    }
+    const result = await api.get(
+      `/v1/projects?org_id=${user.org_id}`
+    );
+    if (!result.projects) {
+      throw new Error("API returned invalid response: missing projects array");
+    }
+    projects = result.projects;
+    setCacheEntry("projects", projects);
+  } catch (err) {
+    if (isNetworkError(err)) {
+      const cached = getCacheEntry("projects");
+      if (cached) {
+        projects = cached.data;
+        fromCache = true;
+        cacheTime = formatCacheTime(cached.updated_at);
+      } else {
+        trackEvent("CLI: project list failed", { reason: "offline_no_cache" });
+        console.error("\u2717 Offline and no cached data available");
+        process.exit(1);
+      }
+    } else {
+      trackEvent("CLI: project list failed", { reason: "api_error" });
+      console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+      process.exit(1);
+    }
+  }
+  trackEvent("CLI: project list succeeded", {
+    project_count: projects.length,
+    from_cache: fromCache
+  });
+  if (fromCache) {
+    console.log(`\u26A0 Offline - showing cached data from ${cacheTime}
+`);
+  }
+  if (projects.length === 0) {
+    console.log("No projects found");
+    return;
+  }
+  const currentProjectId = getConfig("currentProjectId");
+  const green3 = "\x1B[32m";
+  const dim3 = "\x1B[2m";
+  const reset3 = "\x1B[0m";
+  console.log("Projects:\n");
+  for (const project of projects) {
+    const isCurrent = project.id === currentProjectId;
+    if (isCurrent) {
+      console.log(`${green3}* ${project.name}${reset3}`);
+      console.log(`${green3}    ${project.id}${reset3}`);
+    } else {
+      console.log(`  ${project.name}`);
+      console.log(`${dim3}    ${project.id}${reset3}`);
+    }
+    console.log();
+  }
+}
+
+// src/commands/project/switch.ts
+async function switchAction3(name) {
+  let projects = [];
+  const cached = getCacheEntry("projects");
+  let project = cached?.data.find(
+    (cachedProject) => cachedProject.name === name
+  );
+  if (!project) {
+    try {
+      const user = getConfig("user");
+      if (!user?.org_id) {
+        console.error("\u2717 No organization found. Run: ardent login");
+        process.exit(1);
+      }
+      const result = await api.get(
+        `/v1/projects?org_id=${user.org_id}`
+      );
+      if (!result.projects) {
+        throw new Error(
+          "API returned invalid response: missing projects array"
+        );
+      }
+      projects = result.projects;
+      setCacheEntry("projects", projects);
+      project = projects.find(
+        (remoteProject) => remoteProject.name === name
+      );
+    } catch (err) {
+      if (isNetworkError(err)) {
+        if (!project) {
+          console.error(`\u2717 Project "${name}" not found in cache`);
+          console.log("  Run 'ardent project list' when online to refresh");
+          process.exit(1);
+        }
+      } else {
+        console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+        process.exit(1);
+      }
+    }
+  }
+  if (!project) {
+    console.error(`\u2717 Project "${name}" not found`);
+    console.log("  Run: ardent project list");
+    process.exit(1);
+  }
+  const previousId = getConfig("currentProjectId");
+  const previousName = getConfig("currentProjectName");
+  setConfig("currentProjectId", project.id);
+  setConfig("currentProjectName", project.name);
+  setConfig("currentConnectorId", void 0);
+  setConfig("currentConnectorName", void 0);
+  clearCurrentBranch();
+  if (previousName && previousName !== name) {
+    console.log(`Switched from '${previousName}' to '${name}'`);
+  } else {
+    console.log(`Switched to project '${name}'`);
+  }
+  trackEvent("CLI: project switch");
+}
+
+// src/commands/project/index.ts
+var projectCommand = new Command5("project").description(
+  "Manage projects"
+);
+projectCommand.command("create <name>").description("Create a new project").action(createAction3);
+projectCommand.command("list").description("List your projects").action(listAction4);
+projectCommand.command("switch <name>").description("Switch to a different project").action(switchAction3);
+
+// src/commands/auth/index.ts
+import { Command as Command6 } from "commander";
+
 // src/commands/auth/login.ts
 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 +1589,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 +1606,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 +1614,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 +1654,7 @@ async function loginAction(options) {
 
 // src/commands/auth/logout.ts
 function logoutAction() {
+  trackEvent("CLI: logout");
   clearConfig();
   console.log("\u2713 Logged out");
 }
@@ -1240,6 +1663,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,12 +1683,88 @@ 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
-var loginCommand = new Command5("login").description("Login to Ardent").option("-t, --token <token>", "API token (skip browser login)").action(loginAction);
-var logoutCommand = new Command5("logout").description("Logout from Ardent").action(logoutAction);
-var statusCommand = new Command5("status").description("Show status").action(statusAction);
+var loginCommand = new Command6("login").description("Login to Ardent").option("-t, --token <token>", "API token (skip browser login)").action(loginAction);
+var logoutCommand = new Command6("logout").description("Logout from Ardent").action(logoutAction);
+var statusCommand = new Command6("status").description("Show status").action(statusAction);
+
+// src/lib/update-check.ts
+import { existsSync as existsSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { join as join2 } from "path";
+import { homedir as homedir2 } from "os";
+var UPDATE_CHECK_FILE = join2(homedir2(), ".ardent", "update-check.json");
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var PACKAGE_NAME = "ardent-cli";
+function loadCache() {
+  try {
+    if (existsSync2(UPDATE_CHECK_FILE)) {
+      return JSON.parse(readFileSync3(UPDATE_CHECK_FILE, "utf-8"));
+    }
+  } catch {
+  }
+  return null;
+}
+function saveCache(latestVersion) {
+  try {
+    const data = {
+      latest_version: latestVersion,
+      checked_at: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    writeFileSync2(UPDATE_CHECK_FILE, JSON.stringify(data));
+  } catch {
+  }
+}
+function isNewerVersion(current, latest) {
+  const currentParts = current.split(".").map(Number);
+  const latestParts = latest.split(".").map(Number);
+  for (let i = 0; i < Math.max(currentParts.length, latestParts.length); i++) {
+    const currentPart = currentParts[i] || 0;
+    const latestPart = latestParts[i] || 0;
+    if (latestPart > currentPart) return true;
+    if (latestPart < currentPart) return false;
+  }
+  return false;
+}
+async function checkForUpdate(currentVersion) {
+  try {
+    const cache = loadCache();
+    if (cache) {
+      const elapsed = Date.now() - new Date(cache.checked_at).getTime();
+      if (elapsed < CHECK_INTERVAL_MS) {
+        if (isNewerVersion(currentVersion, cache.latest_version)) {
+          printUpdateNotice(currentVersion, cache.latest_version);
+        }
+        return;
+      }
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 3e3);
+    const response = await fetch(
+      `https://registry.npmjs.org/${PACKAGE_NAME}/latest`,
+      { signal: controller.signal }
+    );
+    clearTimeout(timeout);
+    if (!response.ok) return;
+    const data = await response.json();
+    const latestVersion = data.version;
+    saveCache(latestVersion);
+    if (isNewerVersion(currentVersion, latestVersion)) {
+      printUpdateNotice(currentVersion, latestVersion);
+    }
+  } catch {
+  }
+}
+function printUpdateNotice(current, latest) {
+  const yellow2 = "\x1B[33m";
+  const green3 = "\x1B[32m";
+  const reset3 = "\x1B[0m";
+  console.error(
+    `${yellow2}Update available: ${current} \u2192 ${latest}${reset3} \u2014 run ${green3}npm install -g ardent-cli@latest${reset3}`
+  );
+}
 
 // src/index.ts
 var HELP_TEXT = `
@@ -1276,9 +1776,15 @@ AUTHENTICATION
   logout                 Clear stored credentials
   status                 Check authentication status
 
+PROJECTS
+  project create         Create a new project
+  project list           List your projects (* = current)
+  project switch         Switch to a different project
+
 CONNECTORS
   connector create       Connect a database (postgresql, snowflake, etc.)
-  connector list         List your connectors
+  connector list         List your connectors (* = current)
+  connector switch       Switch to a different connector
   connector delete       Delete a connector
 
 BRANCHES
@@ -1308,24 +1814,25 @@ EXAMPLES
   ardent branch switch my-feature
   ardent org members
 `;
-var CLI_VERSION = getCliVersion();
-var program = new Command6();
-function getCliVersion() {
+var CLI_VERSION2 = getCliVersion2();
+var program = new Command7();
+function getCliVersion2() {
   try {
     const packageUrl = new URL("../package.json", import.meta.url);
-    const raw = readFileSync2(packageUrl, "utf-8");
+    const raw = readFileSync4(packageUrl, "utf-8");
     const parsed = JSON.parse(raw);
     return parsed.version ?? "unknown";
   } catch {
     return "unknown";
   }
 }
-program.name("ardent").description("CLI for Ardent database branching").version(CLI_VERSION).configureHelp({
+program.name("ardent").description("CLI for Ardent database branching").version(CLI_VERSION2).configureHelp({
   formatHelp: () => BANNER + HELP_TEXT
 });
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
 program.addCommand(statusCommand);
+program.addCommand(projectCommand);
 program.addCommand(connectorCommand);
 program.addCommand(branchCommand);
 program.addCommand(inviteCommand);
@@ -1352,4 +1859,6 @@ if (args.length === 0) {
   }
   program.help();
 }
+getAnonymousId();
+checkForUpdate(CLI_VERSION2);
 program.parse();

package/package.json

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