ardent-cli 0.0.54 → 0.0.56

package/dist/index.js

@@ -568,6 +568,9 @@ function operationStageDisplay(stage) {
   const label = STAGE_DISPLAY[base] ?? humanizeRawStage(base);
   return suffix ? `${label} (for ${suffix})` : label;
 }
+function operationStageLabel(op) {
+  return op.stage_label ?? operationStageDisplay(op.stage);
+}
 
 // src/lib/resource_name_validation.ts
 var RESERVED_SUFFIXES = ["pooler", "readonly", "direct"];
@@ -978,7 +981,7 @@ async function pollBranchCreate(operationId, idempotencyScopeKey, mode) {
     consecutiveTransientFailures = 0;
     if (op.stage && op.stage !== lastStage && mode !== "json" && mode !== "print-url") {
       const progressLabel = op.progress != null ? ` (${op.progress}%)` : "";
-      console.log(`  ${operationStageDisplay(op.stage)}${progressLabel}`);
+      console.log(`  ${operationStageLabel(op)}${progressLabel}`);
       lastStage = op.stage;
     }
     if (op.status === "completed") {
@@ -1348,7 +1351,7 @@ async function runDiscoveryWithPolling(connectorId, options) {
     }
     if (op.stage && op.stage !== lastStage) {
       const progressLabel = op.progress != null ? ` (${op.progress}%)` : "";
-      console.log(`  ${operationStageDisplay(op.stage)}${progressLabel}`);
+      console.log(`  ${operationStageLabel(op)}${progressLabel}`);
       lastStage = op.stage;
     }
     if (op.status === "completed") {
@@ -1539,7 +1542,7 @@ async function runEngineSetupWithPolling(connectorId, connectorName, options = {
     consecutiveTransientFailures = 0;
     if (op.stage && op.stage !== lastStage) {
       const progressLabel = op.progress != null ? ` (${op.progress}%)` : "";
-      console.log(`  ${operationStageDisplay(op.stage)}${progressLabel}`);
+      console.log(`  ${operationStageLabel(op)}${progressLabel}`);
       lastStage = op.stage;
     }
     if (op.status === "completed") {
@@ -2655,8 +2658,9 @@ async function listAction2() {
     if (render.kind === "engine_pending") enginePendingCount += 1;
     const warnings = connector.warnings ?? [];
     const warningSuffix = warnings.length > 0 ? `  ${yellow}\u26A0 ${warnings.length}${reset2}` : "";
+    const lockSuffix = connector.deletion_locked ? `  ${yellow}[delete locked]${reset2}` : "";
     const statusSuffix = render.kind === "ready" ? "" : `  ${render.color}[${connectorStatusDisplay(connector.status)}]${reset2}`;
-    const nameLine = isCurrent ? `${green2}* ${render.color}${render.icon}${green2} ${connector.name}${reset2}${warningSuffix}${statusSuffix}` : `  ${render.color}${render.icon}${reset2} ${connector.name}${warningSuffix}${statusSuffix}`;
+    const nameLine = isCurrent ? `${green2}* ${render.color}${render.icon}${green2} ${connector.name}${reset2}${warningSuffix}${lockSuffix}${statusSuffix}` : `  ${render.color}${render.icon}${reset2} ${connector.name}${warningSuffix}${lockSuffix}${statusSuffix}`;
     console.log(nameLine);
     if (isCurrent) {
       console.log(`${green2}    ${connector.service_name}${reset2}`);
@@ -2690,6 +2694,10 @@ async function listAction2() {
 var CONNECTOR_DELETE_MAX_WAIT_MS = 60 * 60 * 1e3;
 var CONNECTOR_DELETE_POLL_INTERVAL_MS = 5 * 1e3;
 var CONNECTOR_DELETE_TRANSIENT_WARN_EVERY = 6;
+var CONNECTOR_DELETION_LOCKED_MESSAGE = "Connector deletion is locked. Unlock this connector, then retry.";
+function stripApiErrorPrefix(message) {
+  return message.replace(/^API error \d{3}:\s*/, "");
+}
 async function deleteAction2(name, options = {}) {
   const cached = getCacheEntry("connectors");
   let connector = cached?.data.find((c) => c.name === name);
@@ -2745,6 +2753,11 @@ async function deleteAction2(name, options = {}) {
       process.exit(1);
     }
     const message = err instanceof Error ? err.message : String(err);
+    if (message.includes(CONNECTOR_DELETION_LOCKED_MESSAGE)) {
+      trackEvent("CLI: connector delete failed", { reason: "deletion_locked" });
+      console.error(`\u2717 ${stripApiErrorPrefix(message)}`);
+      process.exit(1);
+    }
     const isDrainRefusal = message.includes("Branch still has un-replicated changes") || typeof err === "object" && err !== null && "status" in err && err.status === 409;
     if (isDrainRefusal) {
       trackEvent("CLI: connector delete failed", { reason: "drain_refused" });
@@ -2780,7 +2793,7 @@ async function waitForConnectorDelete(operationId) {
     consecutiveTransientFailures = 0;
     if (operation.stage && operation.stage !== lastStage) {
       const progressLabel = operation.progress != null ? ` (${operation.progress}%)` : "";
-      console.log(`  ${operationStageDisplay(operation.stage)}${progressLabel}`);
+      console.log(`  ${operationStageLabel(operation)}${progressLabel}`);
       lastStage = operation.stage;
     }
     if (operation.status === "completed") {
@@ -3250,6 +3263,94 @@ async function updateAction(name, options = {}) {
   }
 }
 
+// src/commands/connector/lock.ts
+async function resolveConnectorByName2(name) {
+  const cached = getCacheEntry("connectors");
+  let connector = cached?.data.find((candidate) => candidate.name === name);
+  if (!connector) {
+    try {
+      const result = await api.get("/v1/cli/connectors");
+      if (result.connectors) {
+        setCacheEntry("connectors", result.connectors);
+        connector = result.connectors.find((candidate) => candidate.name === name);
+      }
+    } catch (err) {
+      if (isNetworkError(err)) {
+        console.error("\u2717 Connector not found in cache and offline");
+        process.exit(1);
+      }
+      throw err;
+    }
+  }
+  if (!connector) {
+    console.error(`\u2717 Connector "${name}" not found`);
+    console.log("  Run: ardent connector list");
+    process.exit(1);
+  }
+  return connector;
+}
+function refreshCachedConnector(updatedConnector) {
+  const currentCache = getCacheEntry("connectors");
+  if (!currentCache?.data) {
+    return;
+  }
+  const updatedConnectors = currentCache.data.map(
+    (connector) => connector.id === updatedConnector.id ? { ...connector, ...updatedConnector } : connector
+  );
+  setCacheEntry("connectors", updatedConnectors);
+}
+async function lockAction(name, options = {}) {
+  const connector = await resolveConnectorByName2(name);
+  try {
+    const response = await api.post(
+      `/v1/connectors/${connector.id}/deletion-lock`,
+      { reason: options.reason ?? null }
+    );
+    refreshCachedConnector({ ...response.connector, deletion_locked: true });
+    trackEvent("CLI: connector deletion lock succeeded");
+    console.log(`\u2713 Connector deletion locked for '${name}'`);
+  } catch (err) {
+    if (isPermissionError(err)) {
+      trackEvent("CLI: connector deletion lock failed", { reason: "permission_denied" });
+      console.error("\u2717 You don't have permission to update this connector.");
+      process.exit(1);
+    }
+    if (isNetworkError(err)) {
+      trackEvent("CLI: connector deletion lock failed", { reason: "offline" });
+      console.error("\u2717 Cannot lock connector deletion while offline");
+      process.exit(1);
+    }
+    trackEvent("CLI: connector deletion lock failed", { reason: "api_error" });
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+}
+async function unlockAction(name) {
+  const connector = await resolveConnectorByName2(name);
+  try {
+    const response = await api.delete(
+      `/v1/connectors/${connector.id}/deletion-lock`
+    );
+    refreshCachedConnector({ ...response.connector, deletion_locked: false });
+    trackEvent("CLI: connector deletion unlock succeeded");
+    console.log(`\u2713 Connector deletion unlocked for '${name}'`);
+  } catch (err) {
+    if (isPermissionError(err)) {
+      trackEvent("CLI: connector deletion unlock failed", { reason: "permission_denied" });
+      console.error("\u2717 You don't have permission to update this connector.");
+      process.exit(1);
+    }
+    if (isNetworkError(err)) {
+      trackEvent("CLI: connector deletion unlock failed", { reason: "offline" });
+      console.error("\u2717 Cannot unlock connector deletion while offline");
+      process.exit(1);
+    }
+    trackEvent("CLI: connector deletion unlock failed", { reason: "api_error" });
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+}
+
 // src/commands/connector/index.ts
 var connectorCommand = new Command2("connector").description("Manage database connectors");
 connectorCommand.command("preflight <type> [url]").description(
@@ -3300,8 +3401,10 @@ connectorCommand.command("update <name>").description("Update a connector's conf
 ).action(updateAction);
 connectorCommand.command("delete <name>").description("Delete a connector by name").option(
   "--force",
-  "Skip the in-flight WAL/Kafka drain wait. Any un-replicated changes are abandoned and recorded for operator triage."
+  "Skip the wait for in-flight changes to finish replicating. Any un-replicated changes are abandoned."
 ).action(deleteAction2);
+connectorCommand.command("lock <name>").description("Lock connector deletion").option("--reason <text>", "Optional reason for the deletion lock").action(lockAction);
+connectorCommand.command("unlock <name>").description("Unlock connector deletion").action(unlockAction);
 
 // src/commands/invite/index.ts
 import { Command as Command3 } from "commander";

package/package.json

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