gencow 0.1.242 → 0.1.243

package/lib/app-command.mjs

@@ -10,11 +10,10 @@ import {
 import { resolveCreatedAppId, resolveCreatedAppResponse } from "./app-create-response.mjs";
 import {
   appNotFoundDiagnostic,
-  isExactAppDeleteResponse,
+  isExactAppDeleteHandoffResponse,
   parseAppListResponse,
   parseAppLookupResponse,
 } from "./app-response-contract.mjs";
-import { pollAppDeleteOperation } from "./app-delete-operation.mjs";
 import { appResponseError } from "./app-response-error.mjs";
 import { readJsonObjectResponse, readJsonValueResponse } from "./http-response-json.mjs";
 import { BOLD, CYAN, DIM, GREEN, RED, RESET, error, info, log, success, warn } from "./output.mjs";
@@ -22,10 +21,6 @@ import { loadCreds, rpcMutation, rpcQuery, saveCreds, requireCreds } from "./pla
 import { resolveProjectMetadataPath, resolveProjectSelection } from "./project-context.mjs";
 import { updateEnvLocalUrl } from "./cli-project-runtime.mjs";
 
-// Covers the 60s runtime-observer restart grace, reconciliation scans, and
-// one delayed worker acquisition without reporting a completed deletion as pending.
-const DEFAULT_DELETE_POLL_ATTEMPTS = 120;
-const DELETE_POLL_INTERVAL_MS = 1_000;
 const DEFAULT_APP_CREATE_TIMEOUT_MS = 60_000;
 
 function resolveAppCreateTimeoutMs(value) {
@@ -169,7 +164,7 @@ async function confirmDelete(name) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   const answer = await new Promise((resolveAnswer) =>
     rl.question(
-      `\n  ${RED}!${RESET} Delete "${BOLD}${name}${RESET}"? Stops process + removes data.\n  Type the app name to confirm: `,
+      `\n  ${RED}!${RESET} Remove "${BOLD}${name}${RESET}" from your account? An administrator will stop it and permanently delete its data. The name remains unavailable until then.\n  Type the app name to confirm: `,
       resolveAnswer,
     ),
   );
@@ -194,8 +189,6 @@ export function createAppCommand({
   rpcQueryImpl = rpcQuery,
   saveCredsImpl = saveCreds,
   setTimeoutImpl = setTimeout,
-  sleepImpl = (ms) => new Promise((resolvePromise) => setTimeout(resolvePromise, ms)),
-  deletePollAttempts = DEFAULT_DELETE_POLL_ATTEMPTS,
   successImpl = success,
   updateEnvLocalUrlImpl = updateEnvLocalUrl,
   warnImpl = warn,
@@ -365,12 +358,16 @@ ${dashboardLine}
 
     if (subcmd === "delete") {
       const unsupportedOption = rest.find(
-        (value) => value.startsWith("-") && value !== "--force" && value !== "-f",
+        (value) => value.startsWith("-") && value !== "--force" && value !== "-f" &&
+          !value.startsWith("--request-id="),
       );
       const force = rest.includes("--force") || rest.includes("-f");
       const name = rest.find((value) => !value.startsWith("-")) || loadCredsImpl()?.currentApp;
-      if (!name || unsupportedOption) {
-        errorImpl("Usage: gencow app delete <name> [--force]");
+      const requestIdOptions = rest.filter((value) => value.startsWith("--request-id="));
+      const suppliedRequestId = requestIdOptions[0]?.slice("--request-id=".length);
+      if (!name || unsupportedOption || requestIdOptions.length > 1 ||
+          (suppliedRequestId !== undefined && !/^[A-Za-z0-9_-]{8,128}$/u.test(suppliedRequestId))) {
+        errorImpl("Usage: gencow app delete <name> [--force] [--request-id=<id>]");
         return 1;
       }
 
@@ -382,31 +379,27 @@ ${dashboardLine}
         }
       }
 
-      infoImpl(`Deleting app "${name}"...`);
-      const requestId = createDeleteRequestIdImpl();
-      const delRes = await rpcMutationImpl(creds, "apps.delete", { name, requestId });
-      let delData = await readJsonObjectResponse(delRes);
-      if (!isExactAppDeleteResponse(delData, name)) {
-        const operationResult = await pollAppDeleteOperation({
-          creds,
-          initialBody: delData,
-          name,
-          pollAttempts: deletePollAttempts,
-          pollIntervalMs: DELETE_POLL_INTERVAL_MS,
-          rpcQueryImpl,
-          sleepImpl,
-        });
-        if (operationResult) delData = operationResult;
+      infoImpl(`Removing app "${name}" from your account...`);
+      const requestId = suppliedRequestId ?? createDeleteRequestIdImpl();
+      const retryCommand = `gencow app delete '${name.replaceAll("'", "'\\''")}' --force --request-id=${requestId}`;
+      let delRes;
+      try {
+        delRes = await rpcMutationImpl(creds, "apps.deleteAsync", { name, requestId });
+      } catch {
+        errorImpl(`APP_DELETE_ASYNC_UNCONFIRMED: The request may have completed. Retry the same request: ${retryCommand}`);
+        return 1;
       }
-      if (!isExactAppDeleteResponse(delData, name)) {
-        errorImpl(
-          appResponseError(
+      const delData = await readJsonObjectResponse(delRes);
+      if (!isExactAppDeleteHandoffResponse(delData, name, requestId)) {
+        const diagnosis = appResponseError(
             delData,
-            invalidAppResponse("app delete", delRes, delRes.ok ? "success" : "error"),
+            invalidAppResponse("app delete handoff", delRes, delRes.ok ? "success" : "error"),
             delRes,
             { expectedAppId: name },
-          ),
-        );
+          );
+        errorImpl(delRes.ok || delRes.status >= 500
+          ? `${diagnosis}\nRequest ID: ${requestId}. Retry the same request: ${retryCommand}`
+          : diagnosis);
         return 1;
       }
 
@@ -415,7 +408,10 @@ ${dashboardLine}
         saveCredsImpl({ ...currentCreds, currentApp: undefined });
       }
 
-      successImpl(`App "${name}" deleted`);
+      successImpl(`App "${name}" removed from your account. An administrator will permanently delete it. The name remains unavailable until then.`);
+      if (delData.stopErrorCode) {
+        warnImpl(`App stop needs administrator review. Code: ${delData.stopErrorCode}. Handoff ID: ${delData.handoffId}`);
+      }
       return 0;
     }
 

package/lib/app-response-contract.mjs

@@ -56,3 +56,12 @@ export function isExactAppDeleteResponse(value, expectedAppId) {
   const body = record(value);
   return body?.success === true && body.deleted === expectedAppId;
 }
+
+export function isExactAppDeleteHandoffResponse(value, expectedAppId, expectedRequestId) {
+  const body = record(value);
+  return body?.success === true && body.name === expectedAppId &&
+    body.requestId === expectedRequestId &&
+    body.ownerTransferredTo === "todelete@gencow.dev" &&
+    nonEmptyString(body.handoffId) &&
+    Number.isSafeInteger(body.transferredApps) && body.transferredApps >= 1;
+}

package/lib/app-response-error.mjs

@@ -62,6 +62,14 @@ export function appResponseError(body, fallback, response = null, options = {})
   if (/^[A-Za-z0-9_-]{8,128}$/u.test(body.correlationId ?? "")) {
     lines.push(`Correlation ID: ${body.correlationId}`);
   }
+  if (body.stage === "admission") lines.push("Stage: admission");
+  if (body.stateImpact === "This deletion request made no ownership or resource change.") {
+    lines.push(`State impact: ${body.stateImpact}`);
+  }
+  if (typeof body.retryPrecondition === "string" &&
+      /^[A-Za-z0-9 ,.;:-]{1,200}$/u.test(body.retryPrecondition)) {
+    lines.push(`Retry condition: ${body.retryPrecondition}`);
+  }
   if (APP_DELETE_OPERATION_PATTERN.test(body.operationId ?? "")) {
     lines.push(`Operation ID: ${body.operationId}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gencow",
-  "version": "0.1.242",
+  "version": "0.1.243",
   "description": "Gencow — AI Backend Engine",
   "type": "module",
   "bin": {