ardent-cli 0.0.36 → 0.0.38

package/dist/index.js

@@ -740,11 +740,9 @@ function diffAction() {
   console.error(
     `${red}error:${reset2} \`ardent branch diff\` has been removed.
 
-The underlying CDC service (branching-replay-service + StarRocks) was
-deprecated in favour of pgstream. A pgstream-backed diff view is on the
-roadmap but not yet shipped.
+A replacement is on the roadmap.
 
-${yellow}If you need the current state of a branch:${reset2} \`ardent branch info <name>\`
+${yellow}To view the current state of a branch:${reset2} \`ardent branch info <name>\`
 `
   );
   process.exit(2);
@@ -798,6 +796,37 @@ function printDegradedWarnings(warnings) {
   console.log("  Review this connector with: ardent connector list");
 }
 
+// src/lib/connector_status_display.ts
+var ENGINE_STATUS_DISPLAY = {
+  healthy: "ready",
+  degraded: "ready (with warnings)",
+  configuration_verified: "setup pending",
+  configuration_failed: "configuration check failed",
+  validating: "validation in progress",
+  failed_validation: "validation failed",
+  unhealthy: "unhealthy",
+  unchecked: "not yet configured",
+  // ARD-1181: kafka2pg apply halt due to missing target relation. Phrase is
+  // deliberately operator-action-oriented and free of vendor names (Neon,
+  // Kafka, pgstream) and internal config keys per the CLAUDE.md
+  // customer-facing terseness rules. The internal error string + quarantine
+  // row count are logged by the detector for operator triage.
+  target_schema_lost: "needs reset (contact Ardent support)"
+};
+var CONNECTION_STATUS_DISPLAY = {
+  connected: "connected",
+  failed: "connection failed",
+  unknown: "unknown"
+};
+function engineStatusDisplay(status) {
+  if (!status) return "not ready";
+  return ENGINE_STATUS_DISPLAY[status] ?? "not ready";
+}
+function connectorStatusDisplay(status) {
+  if (!status) return "unknown";
+  return CONNECTION_STATUS_DISPLAY[status] ?? ENGINE_STATUS_DISPLAY[status] ?? "not ready";
+}
+
 // src/lib/engine_setup_result.ts
 var SUCCESS_ENGINE_STATUSES = /* @__PURE__ */ new Set(["healthy", "degraded"]);
 var RETRYABLE_ENGINE_STATUSES = /* @__PURE__ */ new Set(["configuration_verified"]);
@@ -836,23 +865,63 @@ function assertEngineSetupCompleted(operation, connectorName) {
     throw new EngineSetupTerminalStatusError(
       "retryable_engine_status",
       engineStatus,
-      `Engine setup needs retry (status: ${engineStatus}). Run \`ardent connector retry-setup ${connectorName}\` to retry, or \`ardent connector list\` to inspect connector state first.`
+      `Engine setup needs retry (${engineStatusDisplay(engineStatus)}). Run \`ardent connector retry-setup ${connectorName}\` to retry, or \`ardent connector list\` to inspect connector state first.`
     );
   }
   if (FAILED_ENGINE_STATUSES.has(engineStatus)) {
     throw new EngineSetupTerminalStatusError(
       "failed_engine_status",
       engineStatus,
-      `Engine setup failed (status: ${engineStatus}). Run \`ardent connector list\` to inspect connector state.`
+      `Engine setup failed (${engineStatusDisplay(engineStatus)}). Run \`ardent connector list\` to inspect connector state.`
     );
   }
   throw new EngineSetupTerminalStatusError(
     "unexpected_engine_status",
     engineStatus,
-    `Engine setup completed with unexpected status: ${engineStatus}.`
+    "Engine setup completed in an unexpected state. Contact Ardent support."
   );
 }
 
+// src/lib/operation_stage_display.ts
+var STAGE_DISPLAY = {
+  // engine_setup_worker / postgres_engine_setup
+  "dispatched": "Starting",
+  "preparing": "Preparing",
+  "creating-neon-project": "Provisioning the branch target",
+  "preparing-target-databases": "Preparing target databases",
+  "deploying-pgstream": "Starting replication",
+  "applying-rls": "Applying RLS policies",
+  "storing-credentials": "Storing connection credentials",
+  "validating": "Validating the branch target",
+  // reset_worker / reset_connector
+  "resetting": "Resetting",
+  "deleting-pgstream": "Stopping replication",
+  "rediscovering-source": "Re-checking the source database",
+  "resetting-neon-main": "Resetting the branch target",
+  "creating-target-schemas": "Recreating target schemas",
+  "redeploying-pgstream": "Restarting replication",
+  // environment deploy_worker
+  "loading_config": "Loading environment configuration",
+  "deploying_infrastructure": "Provisioning environment infrastructure",
+  "recording_success": "Finalizing environment",
+  "cleaning_failed_deploy": "Cleaning up failed environment provisioning",
+  // environment destroy_worker
+  "deleting_private_links": "Removing private network links",
+  "destroying_infrastructure": "Tearing down environment infrastructure",
+  "recording_destroy_success": "Finalizing environment teardown"
+};
+function humanizeRawStage(_raw) {
+  return "Working";
+}
+function operationStageDisplay(stage) {
+  if (!stage) return "Working";
+  const colonIndex = stage.indexOf(":");
+  const base = colonIndex === -1 ? stage : stage.slice(0, colonIndex);
+  const suffix = colonIndex === -1 ? "" : stage.slice(colonIndex + 1);
+  const label = STAGE_DISPLAY[base] ?? humanizeRawStage(base);
+  return suffix ? `${label} (for ${suffix})` : label;
+}
+
 // src/lib/engine_setup.ts
 var EngineSetupTimeoutError = class extends Error {
   constructor(message) {
@@ -904,7 +973,7 @@ async function runEngineSetupWithPolling(connectorId, connectorName) {
     }
     if (op.stage && op.stage !== lastStage) {
       const progressLabel = op.progress != null ? ` (${op.progress}%)` : "";
-      console.log(`  ${op.stage}${progressLabel}`);
+      console.log(`  ${operationStageDisplay(op.stage)}${progressLabel}`);
       lastStage = op.stage;
     }
     if (op.status === "completed") {
@@ -919,7 +988,7 @@ async function runEngineSetupWithPolling(connectorId, connectorName) {
     }
   }
   throw new EngineSetupTimeoutError(
-    `Engine setup did not complete within ${maxWaitMs / 6e4} minutes. Setup may still be running server-side \u2014 do NOT delete the connector. Check status with: ardent connector list (operation ${operationId})`
+    `Engine setup did not complete within ${maxWaitMs / 6e4} minutes. Setup may still be running server-side \u2014 do NOT delete the connector. Check status with: ardent connector list. If you contact Ardent support, reference operation id ${operationId}.`
   );
 }
 
@@ -1258,7 +1327,9 @@ function logSubmissionDisallowed() {
   console.error(
     "  Wait for the current setup attempt to finish, then retry setup if the connector still shows setup pending."
   );
-  console.error("  Contact Ardent support if the connector stays validating.");
+  console.error(
+    "  Contact Ardent support if the connector's setup does not progress within a few minutes."
+  );
 }
 function logNonInteractiveRequired(decisionsNeeded) {
   const noun = decisionsNeeded === 1 ? "table" : "tables";
@@ -1462,7 +1533,7 @@ async function promptForUnsupportedExtensions(connectorId, unsupported, alreadyP
     await api.put(`/v1/connectors/${connectorId}`, {
       drop_extensions: merged2
     });
-    console.log(`\u2713 Saved drop selection: ${merged2.join(", ")}`);
+    console.log(`\u2713 Saved extension exclusions: ${merged2.join(", ")}`);
     return "applied";
   }
   console.log(
@@ -1489,7 +1560,7 @@ async function promptForUnsupportedExtensions(connectorId, unsupported, alreadyP
   await api.put(`/v1/connectors/${connectorId}`, {
     drop_extensions: merged
   });
-  console.log(`\u2713 Saved drop selection: ${merged.join(", ")}`);
+  console.log(`\u2713 Saved extension exclusions: ${merged.join(", ")}`);
   return "applied";
 }
 function printUnloggedTablesPreflight(preflight) {
@@ -1845,7 +1916,7 @@ 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 statusSuffix = render.kind === "ready" ? "" : `  ${render.color}[${connector.status}]${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}`;
     console.log(nameLine);
     if (isCurrent) {

package/package.json

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