ardent-cli 0.0.1

package/dist/index.js

@@ -0,0 +1,879 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command as Command7 } from "commander";
+
+// src/commands/branch.ts
+import { Command } from "commander";
+
+// src/lib/config.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var CONFIG_DIR = join(homedir(), ".ardent");
+var CONFIG_FILE = join(CONFIG_DIR, "config.json");
+function ensureConfigDir() {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+}
+function loadConfig() {
+  try {
+    if (existsSync(CONFIG_FILE)) {
+      return JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
+    }
+  } catch {
+  }
+  return {};
+}
+function saveConfig(config) {
+  ensureConfigDir();
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+function getConfig(key) {
+  const config = loadConfig();
+  return config[key];
+}
+function setConfig(key, value) {
+  const config = loadConfig();
+  config[key] = value;
+  saveConfig(config);
+}
+function clearConfig() {
+  try {
+    if (existsSync(CONFIG_FILE)) {
+      unlinkSync(CONFIG_FILE);
+    }
+  } catch {
+  }
+}
+function getApiUrl() {
+  return getConfig("apiUrl") || process.env.ARDENT_API_URL || "https://ardentbackendwebappfinal.azurewebsites.net";
+}
+function getToken() {
+  return getConfig("token") || process.env.ARDENT_TOKEN;
+}
+function getBranches() {
+  const cached = getCacheEntry("branches");
+  return cached?.data || [];
+}
+function getBranchByName(name) {
+  return getBranches().find((branch) => branch.name === name);
+}
+function setCacheEntry(key, data) {
+  const config = loadConfig();
+  if (!config.cache) config.cache = {};
+  config.cache[key] = {
+    data,
+    updated_at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  saveConfig(config);
+}
+function getCacheEntry(key) {
+  const config = loadConfig();
+  return config.cache?.[key];
+}
+function formatCacheTime(isoString) {
+  const date = new Date(isoString);
+  const now = /* @__PURE__ */ new Date();
+  const diffMs = now.getTime() - date.getTime();
+  const diffMins = Math.floor(diffMs / 6e4);
+  if (diffMins < 1) return "just now";
+  if (diffMins < 60) return `${diffMins}m ago`;
+  const diffHours = Math.floor(diffMins / 60);
+  if (diffHours < 24) return `${diffHours}h ago`;
+  return date.toLocaleDateString();
+}
+function getCurrentBranch() {
+  return getConfig("currentBranch");
+}
+function setCurrentBranch(name) {
+  setConfig("currentBranch", name);
+}
+function clearCurrentBranch() {
+  const config = loadConfig();
+  delete config.currentBranch;
+  saveConfig(config);
+}
+
+// src/lib/api.ts
+var ApiClient = class {
+  getHeaders() {
+    const token = getToken();
+    if (!token) {
+      console.error("\u2717 Not authenticated. Run: ardent login");
+      process.exit(1);
+    }
+    return {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${token}`
+    };
+  }
+  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(`API error ${response.status}: ${text}`);
+    }
+    return response.json();
+  }
+  async post(path, body) {
+    const url = `${getApiUrl()}${path}`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: this.getHeaders(),
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`API error ${response.status}: ${text}`);
+    }
+    return response.json();
+  }
+  async delete(path, body) {
+    const url = `${getApiUrl()}${path}`;
+    const response = await fetch(url, {
+      method: "DELETE",
+      headers: this.getHeaders(),
+      body: body ? JSON.stringify(body) : void 0
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`API error ${response.status}: ${text}`);
+    }
+    return response.json();
+  }
+};
+var api = new ApiClient();
+function isNetworkError(err) {
+  if (err instanceof TypeError && err.message.includes("fetch")) {
+    return true;
+  }
+  if (err instanceof Error) {
+    const msg = err.message.toLowerCase();
+    return msg.includes("econnrefused") || msg.includes("enotfound") || msg.includes("etimedout") || msg.includes("network") || msg.includes("offline") || msg.includes("dns");
+  }
+  return false;
+}
+
+// src/commands/branch.ts
+var branchCommand = new Command("branch").description("Manage database branches");
+branchCommand.command("create <name>").description("Create a new database branch (e.g., ardent branch create my-feature)").option("-s, --service <type>", "Service type", "postgres").action(async (name, options) => {
+  try {
+    const job = await api.post("/v1/cli/jobs/create", {
+      name
+    });
+    await api.post("/v1/branch/create", {
+      job_id: job.job_id,
+      service_type: options.service
+    });
+    const apiBranches = await api.get(`/v1/branches/${job.job_id}`);
+    const apiBranch = apiBranches.find((branch2) => branch2.service_type === options.service);
+    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,
+      service_type: apiBranch.service_type,
+      branch_url: apiBranch.branch_url || "",
+      status: apiBranch.status,
+      created_at: apiBranch.created_at
+    };
+    const cached = getCacheEntry("branches");
+    const cachedBranches = cached?.data || [];
+    cachedBranches.push(branch);
+    setCacheEntry("branches", cachedBranches);
+    setCurrentBranch(name);
+    console.log(`\u2713 Branch '${name}' created and checked out`);
+    if (branch.branch_url) {
+      console.log(`
+${branch.branch_url}`);
+    }
+  } catch (err) {
+    if (isNetworkError(err)) {
+      console.error("\u2717 Cannot create branch while offline");
+      process.exit(1);
+    }
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+});
+branchCommand.command("list").description("List your branches").action(async () => {
+  let branches = [];
+  let fromCache = false;
+  let cacheTime = "";
+  try {
+    const result = await api.get("/v1/cli/branches");
+    if (!result.branches) {
+      throw new Error("API returned invalid response: missing branches array");
+    }
+    branches = result.branches;
+    setCacheEntry("branches", branches);
+  } catch (err) {
+    if (isNetworkError(err)) {
+      const cached = getCacheEntry("branches");
+      if (cached) {
+        branches = cached.data;
+        fromCache = true;
+        cacheTime = formatCacheTime(cached.updated_at);
+      } else {
+        console.error("\u2717 Offline and no cached data available");
+        process.exit(1);
+      }
+    } else {
+      console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+      process.exit(1);
+    }
+  }
+  if (fromCache) {
+    console.log(`\u26A0 Offline - showing cached data from ${cacheTime}
+`);
+  }
+  if (branches.length === 0) {
+    console.log("No branches found");
+    console.log("  Create one with: ardent branch create <name>");
+    return;
+  }
+  const current = getCurrentBranch();
+  const green2 = "\x1B[32m";
+  const dim2 = "\x1B[2m";
+  const reset2 = "\x1B[0m";
+  console.log("Branches:\n");
+  for (const branch of branches) {
+    const isCurrent = branch.name === current;
+    const icon = branch.status === "active" || branch.status === "active_degraded" ? "\u25CF" : "\u25CB";
+    if (isCurrent) {
+      console.log(`${green2}* ${icon} ${branch.name}${reset2}`);
+      if (branch.branch_url) {
+        console.log(`${green2}      ${branch.branch_url}${reset2}`);
+      }
+    } else {
+      console.log(`  ${icon} ${branch.name}`);
+      if (branch.branch_url) {
+        console.log(`${dim2}      ${branch.branch_url}${reset2}`);
+      }
+    }
+    console.log();
+  }
+});
+branchCommand.command("info [name]").description("Show branch details (defaults to current branch)").action((name) => {
+  const branchName = name || getCurrentBranch();
+  if (!branchName) {
+    console.error("\u2717 No branch specified and no current branch set");
+    console.log("  Run: ardent switch <name> or specify a branch name");
+    return;
+  }
+  const cached = getCacheEntry("branches");
+  const branch = cached?.data.find((cachedBranch) => cachedBranch.name === branchName);
+  if (!branch) {
+    console.error(`\u2717 Branch "${branchName}" not found`);
+    console.log("  Run: ardent branch list");
+    return;
+  }
+  const current = getCurrentBranch();
+  const marker = branch.name === current ? " (current)" : "";
+  console.log(`Branch: ${branch.name}${marker}
+`);
+  console.log(`  Type:    ${branch.service_type}`);
+  console.log(`  Status:  ${branch.status}`);
+  console.log(`  Created: ${new Date(branch.created_at).toLocaleString()}`);
+  if (branch.branch_url) {
+    console.log(`
+  URL: ${branch.branch_url}`);
+  }
+});
+branchCommand.command("delete <name>").description("Delete a branch (e.g., ardent branch delete my-feature)").action(async (name) => {
+  const cached = getCacheEntry("branches");
+  const branch = cached?.data.find((cachedBranch) => cachedBranch.name === name);
+  if (!branch) {
+    console.error(`\u2717 Branch "${name}" not found`);
+    console.log("  Run: ardent branch list");
+    process.exit(1);
+  }
+  try {
+    await api.delete(`/v1/cli/jobs/${branch.job_id}`);
+    const updatedBranches = cached.data.filter((cachedBranch) => cachedBranch.id !== branch.id);
+    setCacheEntry("branches", updatedBranches);
+    if (getCurrentBranch() === name) {
+      clearCurrentBranch();
+    }
+    console.log("\u2713 Branch deleted");
+  } catch (err) {
+    if (isNetworkError(err)) {
+      console.error("\u2717 Cannot delete branch while offline");
+      process.exit(1);
+    }
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+});
+
+// src/commands/connector.ts
+import { Command as Command2 } from "commander";
+function parsePostgresUrl(url) {
+  const atIndex = url.lastIndexOf("@");
+  const credentialsPart = atIndex > 0 ? url.substring(0, atIndex) : url;
+  const hostPart = atIndex > 0 ? url.substring(atIndex) : "";
+  const cleanedUrl = credentialsPart.replace(/\\!/g, "!") + hostPart;
+  const parsed = new URL(cleanedUrl);
+  const host = parsed.hostname;
+  const port = parsed.port || "5432";
+  const username = decodeURIComponent(parsed.username);
+  const password = parsed.password ? decodeURIComponent(parsed.password) : "";
+  if (!host) throw new Error("Host required in connection URL");
+  if (!username) throw new Error("Username required in connection URL");
+  return { host, port, username, password };
+}
+var connectorCommand = new Command2("connector").description("Manage database connectors");
+connectorCommand.command("create <type> <url>").description("Create a new connector (e.g., ardent connector create postgresql postgresql://user:pass@host/db)").option("-n, --name <name>", "Connector name").action(async (type, url, options) => {
+  const supportedTypes = ["postgresql"];
+  if (!supportedTypes.includes(type.toLowerCase())) {
+    console.error(`\u2717 Unsupported type: ${type}`);
+    console.error(`  Supported: ${supportedTypes.join(", ")}`);
+    process.exit(1);
+  }
+  try {
+    const parsed = parsePostgresUrl(url);
+    if (!parsed.password) {
+      console.error("\u2717 Password required in connection URL");
+      console.error("  Example: postgresql://user:password@host:5432/db");
+      process.exit(1);
+    }
+    const connectionDetails = {
+      host: parsed.host,
+      port: parsed.port,
+      username: parsed.username,
+      password: parsed.password
+    };
+    const connectorName = options.name || "My PostgreSQL Connection";
+    console.log("Creating connector...");
+    const created = await api.post("/v1/connectors", {
+      name: connectorName,
+      service_name: "postgresql",
+      connection_details: connectionDetails
+    });
+    const connectorId = created.id;
+    console.log("Discovering schema...");
+    await api.post(`/v1/connectors/${connectorId}/discover`, {});
+    console.log("Setting selection...");
+    await api.post(`/v1/connectors/${connectorId}/selection`, {
+      selected_paths: ["*"]
+    });
+    const connector = await api.get(`/v1/connectors/${connectorId}`);
+    if (connector.branching_engine_status === "configuration_verified") {
+      console.log("Setting up branching engine...");
+      await api.post(`/v1/connectors/${connectorId}/engine-setup`, {});
+    }
+    console.log("\u2713 Connector created and ready");
+    console.log(`  ID: ${connectorId}`);
+  } catch (err) {
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+});
+connectorCommand.command("list").description("List your connectors").action(async () => {
+  try {
+    const result = await api.get("/v1/cli/connectors");
+    if (!result.connectors) {
+      throw new Error("API returned invalid response: missing connectors array");
+    }
+    const connectors = result.connectors;
+    if (connectors.length === 0) {
+      console.log("No connectors found");
+      console.log("  Create one with: ardent connector create postgresql <url>");
+      return;
+    }
+    console.log("Connectors:\n");
+    for (const connector of connectors) {
+      const icon = connector.status === "healthy" ? "\u25CF" : "\u25CB";
+      console.log(`  ${icon} ${connector.name} (${connector.service_name})`);
+      console.log(`    ID: ${connector.id}`);
+      console.log();
+    }
+  } catch (err) {
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+});
+connectorCommand.command("delete <name>").description("Delete a connector by name (e.g., ardent connector delete 'My PostgreSQL Connection')").action(async (name) => {
+  try {
+    const result = await api.get("/v1/cli/connectors");
+    if (!result.connectors) {
+      throw new Error("API returned invalid response: missing connectors array");
+    }
+    const connector = result.connectors.find((existingConnector) => existingConnector.name === name);
+    if (!connector) {
+      console.error(`\u2717 Connector "${name}" not found`);
+      console.log("  Run: ardent connector list");
+      process.exit(1);
+    }
+    console.log("Deleting connector...");
+    await api.delete(`/v1/connectors/${connector.id}`);
+    console.log("\u2713 Connector deleted");
+  } catch (err) {
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+});
+
+// src/commands/diff.ts
+import { Command as Command3 } from "commander";
+var green = "\x1B[32m";
+var red = "\x1B[31m";
+var yellow = "\x1B[33m";
+var cyan = "\x1B[36m";
+var dim = "\x1B[2m";
+var bold = "\x1B[1m";
+var reset = "\x1B[0m";
+var MAX_COL_WIDTH = 24;
+var MAX_COLUMNS = 6;
+function truncate(str, maxLen) {
+  if (str.length <= maxLen) return str;
+  return str.slice(0, maxLen - 2) + "..";
+}
+var diffCommand = new Command3("diff").description("Show CDC changes on current branch").option("-b, --branch <name>", "Branch name (defaults to current)").option("--sql", "Output as replay SQL").action(async (options) => {
+  let branch;
+  if (options.branch) {
+    branch = getBranchByName(options.branch);
+  } else {
+    const currentName = getCurrentBranch();
+    if (currentName) {
+      branch = getBranchByName(currentName);
+    }
+  }
+  if (!branch) {
+    const current = getCurrentBranch();
+    if (current) {
+      console.error(`\u2717 Branch "${current}" not found in cache`);
+      console.log("  Run: ardent branch list");
+    } else {
+      console.error("\u2717 No current branch set");
+      console.log("  Run: ardent switch <name> or ardent branch create <name>");
+    }
+    return;
+  }
+  try {
+    const state = await api.get(`/v1/branches/${branch.job_id}/state`);
+    if (!state || Object.keys(state).length === 0) {
+      console.log("No changes captured");
+      return;
+    }
+    for (const [_branchId, branchState] of Object.entries(state)) {
+      const { diff, ddl, replay_sql } = branchState;
+      if (options.sql) {
+        if (replay_sql) {
+          console.log(replay_sql);
+        } else {
+          console.log("-- No replay SQL generated");
+        }
+        continue;
+      }
+      if (ddl && ddl.length > 0) {
+        console.log(`${bold}Schema Changes${reset} ${dim}(${ddl.length} DDL)${reset}
+`);
+        for (const change of ddl) {
+          const color = change.command_tag.includes("DROP") ? red : change.command_tag.includes("CREATE") ? green : yellow;
+          console.log(`  ${color}${change.command_tag}${reset} ${change.object_name}`);
+          if (change.ddl_command && change.ddl_command.length < 100) {
+            console.log(`  ${dim}${change.ddl_command}${reset}`);
+          }
+        }
+        console.log();
+      }
+      if (diff && diff.length > 0) {
+        const byTable = /* @__PURE__ */ new Map();
+        for (const row of diff) {
+          const tableName = row.table_name || `${row.schema_name}.unknown`;
+          if (!byTable.has(tableName)) {
+            byTable.set(tableName, []);
+          }
+          byTable.get(tableName).push(row);
+        }
+        const inserts = diff.filter((r) => r.last_op === "INSERT").length;
+        const updates = diff.filter((r) => r.last_op === "UPDATE").length;
+        const deletes = diff.filter((r) => r.last_op === "DELETE").length;
+        const summary = [
+          inserts > 0 ? `${green}+${inserts} added${reset}` : "",
+          updates > 0 ? `${yellow}~${updates} modified${reset}` : "",
+          deletes > 0 ? `${red}-${deletes} deleted${reset}` : ""
+        ].filter(Boolean).join("  ");
+        console.log(`${bold}Data Changes${reset} ${dim}(${byTable.size} table${byTable.size > 1 ? "s" : ""})${reset}  ${summary}
+`);
+        for (const [tableName, rows] of byTable) {
+          const tableInserts = rows.filter((r) => r.last_op === "INSERT").length;
+          const tableUpdates = rows.filter((r) => r.last_op === "UPDATE").length;
+          const tableDeletes = rows.filter((r) => r.last_op === "DELETE").length;
+          const tableSummary = [
+            tableInserts > 0 ? `${green}+${tableInserts}${reset}` : "",
+            tableUpdates > 0 ? `${yellow}~${tableUpdates}${reset}` : "",
+            tableDeletes > 0 ? `${red}-${tableDeletes}${reset}` : ""
+          ].filter(Boolean).join(" ");
+          console.log(`${cyan}${tableName}${reset}  ${tableSummary}`);
+          console.log();
+          const allColumns = /* @__PURE__ */ new Set();
+          for (const row of rows) {
+            const data = row.last_data || row.first_data || {};
+            Object.keys(data).forEach((k) => allColumns.add(k));
+            if (row.first_data) {
+              Object.keys(row.first_data).forEach((k) => allColumns.add(k));
+            }
+          }
+          let columns = Array.from(allColumns);
+          let hiddenColumns = 0;
+          if (columns.length > MAX_COLUMNS) {
+            const changedCols = /* @__PURE__ */ new Set();
+            for (const row of rows) {
+              if (row.last_op === "UPDATE" && row.first_data && row.last_data) {
+                for (const col of columns) {
+                  if (row.first_data[col] !== row.last_data[col]) {
+                    changedCols.add(col);
+                  }
+                }
+              }
+            }
+            const prioritized = [
+              ...columns.filter((c) => changedCols.has(c)),
+              ...columns.filter((c) => !changedCols.has(c))
+            ];
+            hiddenColumns = prioritized.length - MAX_COLUMNS;
+            columns = prioritized.slice(0, MAX_COLUMNS);
+          }
+          const colWidths = { Op: 2 };
+          for (const col of columns) {
+            colWidths[col] = Math.min(col.length, MAX_COL_WIDTH);
+          }
+          for (const row of rows) {
+            const data = row.last_data || row.first_data || {};
+            for (const col of columns) {
+              const val = data[col];
+              const valStr = val === void 0 ? "" : typeof val === "string" ? val : String(val);
+              colWidths[col] = Math.min(MAX_COL_WIDTH, Math.max(colWidths[col], valStr.length));
+            }
+          }
+          const vLine = `${dim}\u2502${reset}`;
+          const topParts = [
+            "\u2500".repeat(colWidths["Op"]),
+            ...columns.map((col) => "\u2500".repeat(colWidths[col]))
+          ];
+          const hiddenNote = hiddenColumns > 0 ? `  ${dim}+${hiddenColumns} more${reset}` : "";
+          console.log(`  ${dim}\u250C\u2500${topParts.join("\u2500\u252C\u2500")}\u2500\u2510${reset}${hiddenNote}`);
+          const headerParts = [
+            `${"Op".padEnd(colWidths["Op"])}`,
+            ...columns.map((col) => truncate(col, colWidths[col]).padEnd(colWidths[col]))
+          ];
+          console.log(`  ${dim}\u2502 ${headerParts.join(" \u2502 ")} \u2502${reset}`);
+          const sepParts = [
+            "\u2500".repeat(colWidths["Op"]),
+            ...columns.map((col) => "\u2500".repeat(colWidths[col]))
+          ];
+          console.log(`  ${dim}\u251C\u2500${sepParts.join("\u2500\u253C\u2500")}\u2500\u2524${reset}`);
+          for (const row of rows) {
+            const op = row.last_op;
+            const opColor = op === "INSERT" ? green : op === "DELETE" ? red : yellow;
+            const opSymbol = op === "INSERT" ? "+" : op === "DELETE" ? "-" : "~";
+            const cellParts = [];
+            cellParts.push(`${opColor}${opSymbol.padEnd(colWidths["Op"])}${reset}`);
+            for (const col of columns) {
+              const width = colWidths[col];
+              if (op === "UPDATE" && row.first_data && row.last_data) {
+                const oldVal = row.first_data[col];
+                const newVal = row.last_data[col];
+                if (oldVal !== newVal) {
+                  const halfWidth = Math.floor((width - 1) / 2);
+                  const oldStr = truncate(oldVal === void 0 ? "" : typeof oldVal === "string" ? oldVal : String(oldVal), halfWidth);
+                  const newStr = truncate(newVal === void 0 ? "" : typeof newVal === "string" ? newVal : String(newVal), halfWidth);
+                  cellParts.push(`${red}${oldStr.padEnd(halfWidth)}${reset}\u2192${green}${newStr.padEnd(width - halfWidth - 1)}${reset}`);
+                } else {
+                  const valStr = newVal === void 0 ? "" : typeof newVal === "string" ? newVal : String(newVal);
+                  cellParts.push(`${dim}${truncate(valStr, width).padEnd(width)}${reset}`);
+                }
+              } else {
+                const data = row.last_data || row.first_data || {};
+                const val = data[col];
+                const valStr = val === void 0 ? "" : typeof val === "string" ? val : String(val);
+                cellParts.push(`${opColor}${truncate(valStr, width).padEnd(width)}${reset}`);
+              }
+            }
+            console.log(`  ${vLine} ${cellParts.join(` ${vLine} `)} ${vLine}`);
+          }
+          const bottomParts = [
+            "\u2500".repeat(colWidths["Op"]),
+            ...columns.map((col) => "\u2500".repeat(colWidths[col]))
+          ];
+          console.log(`  ${dim}\u2514\u2500${bottomParts.join("\u2500\u2534\u2500")}\u2500\u2518${reset}`);
+          console.log();
+        }
+      }
+      if ((!ddl || ddl.length === 0) && (!diff || diff.length === 0)) {
+        console.log("No changes");
+      }
+    }
+  } catch (err) {
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+});
+
+// src/commands/invite.ts
+import { Command as Command4 } from "commander";
+async function sendInvite(email, role) {
+  const validRoles = ["owner", "admin", "member", "viewer"];
+  if (!validRoles.includes(role)) {
+    console.error(`\u2717 Invalid role: ${role}`);
+    console.error(`  Valid roles: ${validRoles.join(", ")}`);
+    process.exit(1);
+  }
+  try {
+    const result = await api.post("/v1/cli/invite", {
+      email,
+      role
+    });
+    console.log(`\u2713 Invitation sent to ${result.email}`);
+    console.log(`  Role: ${result.role}`);
+    console.log(`  Org: ${result.org_name}`);
+    console.log();
+    console.log("They'll receive an email with a link to join.");
+  } catch (err) {
+    if (isNetworkError(err)) {
+      console.error("\u2717 Cannot send invite while offline");
+      process.exit(1);
+    }
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+}
+var inviteCommand = new Command4("invite").description("Invite a user to your organization").argument("[email]", "Email address to invite").argument("[role]", "Role to assign (owner/admin/member/viewer)", "member").action(async (email, role) => {
+  if (!email) {
+    inviteCommand.help();
+    return;
+  }
+  await sendInvite(email, role);
+});
+inviteCommand.command("list").description("List pending invites").action(async () => {
+  try {
+    const result = await api.get("/v1/cli/invites");
+    if (!result.invites) {
+      throw new Error("API returned invalid response: missing invites array");
+    }
+    const invites = result.invites;
+    if (invites.length === 0) {
+      console.log("No pending invites");
+      return;
+    }
+    console.log("Pending invites:\n");
+    for (const inv of invites) {
+      const created = new Date(inv.created_at).toLocaleDateString();
+      console.log(`  ${inv.email}`);
+      console.log(`    Role: ${inv.role} | Sent: ${created}`);
+      console.log();
+    }
+  } catch (err) {
+    if (isNetworkError(err)) {
+      console.error("\u2717 Cannot list invites while offline");
+      process.exit(1);
+    }
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+});
+inviteCommand.command("delete <email>").description("Revoke a pending invite").action(async (email) => {
+  try {
+    await api.delete("/v1/cli/invites", { email });
+    console.log(`\u2713 Invite for ${email} deleted`);
+  } catch (err) {
+    if (isNetworkError(err)) {
+      console.error("\u2717 Cannot delete invite while offline");
+      process.exit(1);
+    }
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+});
+
+// src/commands/switch.ts
+import { Command as Command5 } from "commander";
+var switchCommand = new Command5("switch").description("Switch to a different branch").argument("<name>", "Branch name to switch to").action(async (name) => {
+  let cached = getCacheEntry("branches");
+  let branch = cached?.data.find((cachedBranch) => cachedBranch.name === name);
+  if (!branch) {
+    try {
+      const result = await api.get("/v1/cli/branches");
+      if (!result.branches) {
+        throw new Error("API returned invalid response: missing branches array");
+      }
+      setCacheEntry("branches", result.branches);
+      branch = result.branches.find((remoteBranch) => remoteBranch.name === name);
+    } catch (err) {
+      if (isNetworkError(err)) {
+        if (!branch) {
+          console.error(`\u2717 Branch "${name}" not found in cache`);
+          console.log("  Run 'ardent branch list' when online to refresh");
+          process.exit(1);
+        }
+      } else {
+        console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+        process.exit(1);
+      }
+    }
+  }
+  if (!branch) {
+    console.error(`\u2717 Branch "${name}" not found`);
+    console.log("  Run: ardent branch list");
+    process.exit(1);
+  }
+  const previous = getCurrentBranch();
+  setCurrentBranch(name);
+  if (previous && previous !== name) {
+    console.log(`Switched from '${previous}' to '${name}'`);
+  } else {
+    console.log(`Switched to branch '${name}'`);
+  }
+  if (branch.branch_url) {
+    console.log(`
+${branch.branch_url}`);
+  }
+});
+
+// src/commands/auth.ts
+import { Command as Command6 } from "commander";
+var loginCommand = new Command6("login").description("Login to Ardent").option("-t, --token <token>", "API token (skip browser login)").action(async (options) => {
+  if (options.token) {
+    setConfig("token", options.token);
+    console.log("\u2713 Logged in successfully");
+    return;
+  }
+  console.log("Opening browser for authentication...");
+  try {
+    const initResponse = await fetch(`${getApiUrl()}/v1/cli/auth/init`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" }
+    });
+    if (!initResponse.ok) {
+      const error = await initResponse.text();
+      console.error("\u2717 Failed to initialize auth:", error);
+      process.exit(1);
+    }
+    const { session_id, auth_url } = await initResponse.json();
+    const open = (await import("open")).default;
+    await open(auth_url);
+    console.log("Waiting for authentication...");
+    console.log(`(If browser didn't open, visit: ${auth_url})`);
+    const pollInterval = 2e3;
+    const maxAttempts = 150;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+      await new Promise((resolve) => setTimeout(resolve, pollInterval));
+      const pollResponse = await fetch(
+        `${getApiUrl()}/v1/cli/auth/poll?session=${session_id}`
+      );
+      if (!pollResponse.ok) {
+        console.error("\u2717 Poll failed");
+        process.exit(1);
+      }
+      const result = await pollResponse.json();
+      if (result.status === "completed") {
+        setConfig("token", result.token);
+        console.log("\n\u2713 Logged in successfully");
+        return;
+      }
+      if (result.status === "expired") {
+        console.error("\n\u2717 Session expired. Please try again.");
+        process.exit(1);
+      }
+      if (result.status === "error") {
+        console.error("\n\u2717 Error:", result.message);
+        process.exit(1);
+      }
+      process.stdout.write(".");
+    }
+    console.error("\n\u2717 Timed out. Please try again.");
+    process.exit(1);
+  } catch (error) {
+    console.error("\u2717 Login failed:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
+var logoutCommand = new Command6("logout").description("Logout from Ardent").action(() => {
+  clearConfig();
+  console.log("\u2713 Logged out");
+});
+var statusCommand = new Command6("status").description("Show status").action(() => {
+  const token = getConfig("token");
+  if (token) {
+    console.log("\u2713 Authenticated");
+    console.log(`  Token: ${token.slice(0, 8)}...${token.slice(-4)}`);
+  } else {
+    console.log("\u2717 Not authenticated");
+    console.log("  Run: ardent login");
+  }
+});
+
+// src/index.ts
+var BANNER = `
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+\u2502                                                         \u2502
+\u2502     \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2502
+\u2502    \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D  \u2502
+\u2502    \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551   \u2588\u2588\u2551     \u2502
+\u2502    \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551     \u2502
+\u2502    \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551   \u2588\u2588\u2551     \u2502
+\u2502    \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D   \u255A\u2550\u255D     \u2502
+\u2502                                                         \u2502
+\u2502              Git for your data infrastructure           \u2502
+\u2502                                                         \u2502
+\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+`;
+var HELP_TEXT = `
+USAGE
+  ardent <command> [options]
+
+COMMANDS
+  login              Login via browser (GitHub OAuth)
+  logout             Clear stored credentials
+  status             Check authentication status
+  connector create   Connect a database (postgres, snowflake, etc.)
+  connector list     List your connectors
+  connector delete   Delete a connector
+  branch create      Create a new database branch (auto-switches to it)
+  branch list        List your branches (* = current)
+  branch info        Show branch details (URL, status, etc.)
+  branch delete      Delete a branch
+  switch <name>      Switch to a different branch
+  diff               Show CDC changes on a branch
+  invite <email>     Invite a user to your organization
+  invite list        List pending invites
+  invite delete      Revoke a pending invite
+
+OPTIONS
+  --help             Show help for any command
+  --version          Show CLI version
+
+EXAMPLES
+  ardent login
+  ardent connector create postgresql postgresql://user:pass@host:5432/db
+  ardent branch create my-feature
+  ardent branch list
+  ardent invite teammate@company.com
+  ardent invite teammate@company.com admin
+
+For more help, visit https://docs.tryardent.com/cli
+`;
+var program = new Command7();
+program.name("ardent").description("CLI for Ardent database branching").version("0.0.1").configureHelp({
+  formatHelp: () => BANNER + HELP_TEXT
+});
+program.addCommand(loginCommand);
+program.addCommand(logoutCommand);
+program.addCommand(statusCommand);
+program.addCommand(connectorCommand);
+program.addCommand(branchCommand);
+program.addCommand(switchCommand);
+program.addCommand(diffCommand);
+program.addCommand(inviteCommand);
+program.parse();

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "ardent-cli",
+  "version": "0.0.1",
+  "description": "CLI for Ardent database branching",
+  "type": "module",
+  "bin": {
+    "ardent": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "start": "node dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "open": "^10.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}