ardent-cli 0.0.52 → 0.0.54

package/dist/index.js

@@ -513,7 +513,7 @@ async function resolveCurrentConnectorId() {
 
 // src/lib/operation_stage_display.ts
 var STAGE_DISPLAY = {
-  // engine_setup_worker / postgres_engine_setup
+  // engine_setup_workflow / postgres_engine_setup
   "dispatched": "Queued",
   "preparing": "Preparing",
   "creating-neon-project": "Provisioning the branch target",
@@ -1469,14 +1469,32 @@ var EngineSetupTimeoutError = class extends Error {
 };
 var EngineSetupOperationFailedError = class extends Error {
   operationError;
-  constructor(operationError, connectorName) {
+  connectorId;
+  connectorName;
+  operationId;
+  constructor(operationError, connectorIdOrName, connectorName, operationId) {
+    const recoveryHandle = connectorName && operationId ? `${engineSetupRecoveryHandle(connectorIdOrName, connectorName, operationId)} ` : "";
+    const retryName = connectorName ?? connectorIdOrName;
     super(
-      `Engine setup failed: ${operationError ?? "unknown error"}. Inspect connector state with \`ardent connector list\`, then retry with \`ardent connector retry-setup ${connectorName}\` once the underlying issue is resolved.`
+      `Engine setup failed: ${operationError ?? "unknown error"}. ` + recoveryHandle + `Inspect connector state with \`ardent connector list\`, then retry with \`ardent connector retry-setup ${retryName}\` once the underlying issue is resolved.`
     );
     this.name = "EngineSetupOperationFailedError";
     this.operationError = operationError;
+    this.connectorId = connectorName ? connectorIdOrName : null;
+    this.connectorName = connectorName ?? connectorIdOrName;
+    this.operationId = operationId ?? null;
   }
 };
+function engineSetupRecoveryHandle(connectorId, connectorName, operationId) {
+  return `For recovery, reference operation id ${operationId} for connector ${connectorId} (${connectorName}).`;
+}
+function formatNextEngineSetupPollAction(pollIntervalMs) {
+  if (pollIntervalMs <= 0) {
+    return "The next check runs immediately";
+  }
+  const nextPollSeconds = Math.ceil(pollIntervalMs / 1e3);
+  return `The next check runs in ${nextPollSeconds}s`;
+}
 async function runEngineSetupWithPolling(connectorId, connectorName, options = {}) {
   let dispatch;
   try {
@@ -1511,7 +1529,7 @@ async function runEngineSetupWithPolling(connectorId, connectorName, options = {
         consecutiveTransientFailures += 1;
         if (consecutiveTransientFailures % ENGINE_SETUP_TRANSIENT_WARN_EVERY === 0) {
           console.warn(
-            `  \u26A0 Status check has failed ${consecutiveTransientFailures} times in a row. Setup is still running server-side and the CLI will keep waiting \u2014 do NOT delete the connector.`
+            `  \u26A0 Status check has failed ${consecutiveTransientFailures} times in a row. ${engineSetupRecoveryHandle(connectorId, connectorName, operationId)} Setup is still running server-side and the CLI will keep waiting \u2014 do NOT delete the connector. ${formatNextEngineSetupPollAction(pollIntervalMs)}; if this continues, contact Ardent support with that operation id.`
           );
         }
         continue;
@@ -1532,7 +1550,12 @@ async function runEngineSetupWithPolling(connectorId, connectorName, options = {
       return { dispatched: true };
     }
     if (op.status === "failed") {
-      throw new EngineSetupOperationFailedError(op.error, connectorName);
+      throw new EngineSetupOperationFailedError(
+        op.error,
+        connectorId,
+        connectorName,
+        operationId
+      );
     }
   }
   throw new EngineSetupTimeoutError(

package/package.json

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