gencow 0.1.244 → 0.1.245

package/lib/app-command.mjs

@@ -164,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} 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: `,
+      `\n  ${RED}!${RESET} Remove "${BOLD}${name}${RESET}" from your account? An administrator will stop it and permanently delete its data. Redeploying this project can create a new app ID with the same display name.\n  Type the app name to confirm: `,
       resolveAnswer,
     ),
   );
@@ -408,7 +408,7 @@ ${dashboardLine}
         saveCredsImpl({ ...currentCreds, currentApp: undefined });
       }
 
-      successImpl(`App "${name}" removed from your account. An administrator will permanently delete it. The name remains unavailable until then.`);
+      successImpl(`App "${name}" removed from your account. An administrator will stop it and permanently delete it. Redeploying this project can create a new app ID with the same display name.`);
       if (delData.stopErrorCode) {
         warnImpl(`App stop needs administrator review. Code: ${delData.stopErrorCode}. Handoff ID: ${delData.handoffId}`);
       }

package/lib/deploy-app-creation.mjs

@@ -0,0 +1,71 @@
+import { resolveCreatedAppResponse } from "./app-create-response.mjs";
+import { resolveDeployAppId } from "./deploy-app-target.mjs";
+import { writeProjectMetadata } from "./deploy-project-metadata.mjs";
+import { readJsonObjectResponse } from "./http-response-json.mjs";
+import { DIM, RESET } from "./output.mjs";
+
+export function createCloudAppIfNeeded({
+  platformFetchImpl,
+  rpcMutationImpl,
+  errorImpl,
+  infoImpl,
+  exitImpl,
+  successImpl,
+  setTimeoutImpl,
+  writeFileSyncImpl,
+}) {
+  return async function createAppIfNeeded({
+    creds,
+    appId,
+    displayName,
+    envTarget = "dev",
+    gencowJsonPath,
+    allowMissingAppReplacement = true,
+  }) {
+    const resolvedAppId = await resolveDeployAppId({
+      creds,
+      appId,
+      displayName,
+      environment: envTarget,
+      platformFetchImpl,
+      allowMissingAppReplacement,
+      infoImpl,
+      errorImpl,
+      exitImpl,
+    });
+    if (resolvedAppId === false) return null;
+    if (resolvedAppId) return resolvedAppId;
+
+    infoImpl("Creating app (auto-generating ID)...");
+    const createRes = await rpcMutationImpl(creds, "apps.create", { name: displayName });
+    if (!createRes.ok) {
+      const createErr = await readJsonObjectResponse(createRes);
+      errorImpl(`App creation failed: ${createErr?.error || createRes.statusText}`);
+      exitImpl(1);
+      return null;
+    }
+
+    const createData = await readJsonObjectResponse(createRes);
+    let nextAppId;
+    try {
+      nextAppId = resolveCreatedAppResponse(createData, { platformUrl: creds.platformUrl }).appId;
+    } catch (caught) {
+      errorImpl(`App creation failed: ${caught.message}`);
+      exitImpl(1);
+      return null;
+    }
+
+    successImpl(`App "${nextAppId}" created. Waiting for provisioning...`);
+    writeProjectMetadata({
+      appId: nextAppId,
+      displayName,
+      envTarget,
+      platformUrl: creds.platformUrl,
+      gencowJsonPath,
+      writeFileSyncImpl,
+    });
+    infoImpl(`${DIM}gencow.json created (appId: ${nextAppId})${RESET}`);
+    await new Promise((resolveDelay) => setTimeoutImpl(resolveDelay, 3000));
+    return nextAppId;
+  };
+}

package/lib/deploy-app-target.mjs

@@ -0,0 +1,182 @@
+import { readJsonObjectResponse } from "./http-response-json.mjs";
+
+const PUBLIC_LOOKUP_ERROR_CODES = new Set([
+  "ACCOUNT_DELETED",
+  "ACCOUNT_DELETION_PENDING",
+  "ACCOUNT_SUSPENDED",
+  "APP_RELEASE_AUTH_REQUIRED",
+  "APP_RELEASE_CAPABILITY_UNAVAILABLE",
+  "APP_RELEASE_ENVIRONMENT_INVALID",
+  "APP_RELEASE_POLICY_READ_UNAVAILABLE",
+]);
+const SAFE_CORRELATION_ID = /^[A-Za-z0-9_-]{8,128}$/u;
+
+function publicLookupFailure(response, body) {
+  const code = PUBLIC_LOOKUP_ERROR_CODES.has(body?.code)
+    ? body.code
+    : response.status === 401
+      ? "APP_RELEASE_AUTH_REQUIRED"
+      : "APP_DEPLOY_TARGET_LOOKUP_FAILED";
+  return {
+    kind: "error",
+    code,
+    status: response.status,
+    retryable: typeof body?.retryable === "boolean" ? body.retryable : response.status >= 500,
+    ...(typeof body?.correlationId === "string" && SAFE_CORRELATION_ID.test(body.correlationId)
+      ? { correlationId: body.correlationId }
+      : {}),
+  };
+}
+
+function formatLookupFailure(failure, target) {
+  const code = failure?.kind === "error" ? failure.code : "APP_DEPLOY_TARGET_LOOKUP_FAILED";
+  const lines = [
+    `${code}: Could not verify the configured ${target} app. No replacement app was created and gencow.json was unchanged.`,
+  ];
+  if (failure?.status) lines.push(`HTTP status: ${failure.status}`);
+  if (typeof failure?.retryable === "boolean") lines.push(`Retryable: ${failure.retryable ? "yes" : "no"}`);
+  if (failure?.correlationId) lines.push(`Correlation ID: ${failure.correlationId}`);
+  if (code === "APP_RELEASE_AUTH_REQUIRED") {
+    lines.push("Action: run gencow login, or replace/unset the environment credential, then retry.");
+  } else if (code === "ACCOUNT_SUSPENDED" || code === "ACCOUNT_DELETION_PENDING" || code === "ACCOUNT_DELETED") {
+    lines.push("Action: resolve the account status in Platform before retrying.");
+  } else if (failure?.retryable) {
+    lines.push("Action: wait for Platform release capability to recover, then retry.");
+  } else {
+    lines.push("Action: check that the credential can access this app, then retry.");
+  }
+  return lines.join("\n");
+}
+
+export async function lookupOwnedApp({ creds, appId, environment, platformFetchImpl }) {
+  try {
+    const response = await platformFetchImpl(
+      creds,
+      `/platform/apps/${appId}/release-capability?environment=${environment}`,
+      { method: "GET" },
+    );
+    const body = await readJsonObjectResponse(response);
+    if (response.status === 404) {
+      if (body?.code === "APP_RELEASE_APP_NOT_FOUND") return "missing";
+      return body?.code ? publicLookupFailure(response, body) : "unsupported";
+    }
+    if (response.status === 409 && body?.code === "APP_RELEASE_VERSIONS_DISABLED") return "found";
+    if (!response.ok) return publicLookupFailure(response, body);
+    return body?.protocol === "app-release-v1" && typeof body.enabled === "boolean" ? "found" : "error";
+  } catch {
+    return {
+      kind: "error",
+      code: "APP_RELEASE_CAPABILITY_UNAVAILABLE",
+      retryable: true,
+    };
+  }
+}
+
+export async function resolveDeployAppId({
+  creds,
+  appId,
+  displayName,
+  environment = "dev",
+  platformFetchImpl,
+  allowMissingAppReplacement,
+  infoImpl,
+  errorImpl,
+  exitImpl,
+}) {
+  if (!appId || !platformFetchImpl) return appId;
+  const lookup = await lookupOwnedApp({ creds, appId, environment, platformFetchImpl });
+  if (lookup === "found" || lookup === "unsupported") return appId;
+  if (lookup?.kind === "error" || lookup === "error") {
+    errorImpl(formatLookupFailure(lookup, `"${appId}"`));
+    exitImpl(1);
+    return false;
+  }
+  if (!allowMissingAppReplacement) {
+    errorImpl(
+      `APP_NOT_FOUND: The existing app ID "${appId}" is unavailable. This deployment requires the original app; restore access before retrying. No replacement app was created.`,
+    );
+    exitImpl(1);
+    return false;
+  }
+  infoImpl(`Configured app ID is no longer available. Creating a new app named "${displayName}"...`);
+  return null;
+}
+
+export async function reconcileProductionAppTarget({
+  appId,
+  prodAppId,
+  creds,
+  displayName,
+  gencowJsonPath,
+  platformFetchImpl,
+  createCloudAppIfNeeded,
+  infoImpl,
+  errorImpl,
+  exitImpl,
+}) {
+  let productionParentAppId = appId;
+  let existingProdAppId = prodAppId;
+  if (!platformFetchImpl || (!productionParentAppId && !existingProdAppId)) {
+    return { appId: productionParentAppId, prodAppId: existingProdAppId };
+  }
+
+  const failLookup = (failure, target) => {
+    errorImpl(formatLookupFailure(failure, target));
+    exitImpl(1);
+    return null;
+  };
+
+  if (existingProdAppId) {
+    const prodState = await lookupOwnedApp({
+      creds,
+      appId: existingProdAppId,
+      environment: "prod",
+      platformFetchImpl,
+    });
+    if (prodState?.kind === "error" || prodState === "error") return failLookup(prodState, "production");
+    if (prodState === "found" || prodState === "unsupported") {
+      return { appId: productionParentAppId, prodAppId: existingProdAppId };
+    }
+    infoImpl(
+      `Configured production app ID is no longer available. Creating a production app for "${displayName}"...`,
+    );
+    existingProdAppId = null;
+  }
+
+  const parentState = productionParentAppId
+    ? await lookupOwnedApp({
+        creds,
+        appId: productionParentAppId,
+        environment: "dev",
+        platformFetchImpl,
+      })
+    : "missing";
+  if (productionParentAppId && (parentState?.kind === "error" || parentState === "error")) {
+    return failLookup(parentState, "root");
+  }
+
+  if (productionParentAppId && parentState === "missing") {
+    infoImpl(`Configured app ID is no longer available. Creating a new app named "${displayName}"...`);
+    productionParentAppId = await createCloudAppIfNeeded({
+      creds,
+      appId: null,
+      displayName,
+      envTarget: "dev",
+      gencowJsonPath,
+    });
+    if (!productionParentAppId) return null;
+  }
+
+  if (!productionParentAppId) {
+    productionParentAppId = await createCloudAppIfNeeded({
+      creds,
+      appId: null,
+      displayName,
+      envTarget: "dev",
+      gencowJsonPath,
+    });
+    if (!productionParentAppId) return null;
+  }
+
+  return { appId: productionParentAppId, prodAppId: existingProdAppId };
+}

package/lib/deploy-package-runtime.mjs

@@ -3,9 +3,8 @@ import { randomUUID } from "node:crypto";
 import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "fs";
 import { dirname, resolve } from "path";
 import { fetchAppDiagnosticLogsViaRest, normalizeDiagnosticLogLines } from "./app-diagnostics.mjs";
-import { resolveCreatedAppResponse } from "./app-create-response.mjs";
+import { createCloudAppIfNeeded as createCloudAppIfNeededImpl } from "./deploy-app-creation.mjs";
 import { resolveConfiguredAuditorImplementation } from "./auditor-mode.mjs";
-import { writeProjectMetadata } from "./deploy-project-metadata.mjs";
 import {
   loadDeployMigrationGenerationContext,
   prepareDeployCodegenArtifacts,
@@ -557,41 +556,16 @@ export function createDeployPackageRuntime({
     return { bundleBuffer, bundleSize, deployClaim, tmpBundle };
   }
 
-  async function createCloudAppIfNeeded({ creds, appId, displayName, envTarget = "dev", gencowJsonPath }) {
-    if (appId) return appId;
-
-    infoImpl("Creating app (auto-generating ID)...");
-    const createRes = await rpcMutationImpl(creds, "apps.create", { name: displayName });
-    if (!createRes.ok) {
-      const createErr = await readJsonObjectResponse(createRes);
-      errorImpl(`App creation failed: ${createErr?.error || createRes.statusText}`);
-      exitImpl(1);
-      return null;
-    }
-
-    const createData = await readJsonObjectResponse(createRes);
-    let nextAppId;
-    try {
-      nextAppId = resolveCreatedAppResponse(createData, { platformUrl: creds.platformUrl }).appId;
-    } catch (caught) {
-      errorImpl(`App creation failed: ${caught.message}`);
-      exitImpl(1);
-      return null;
-    }
-
-    successImpl(`App "${nextAppId}" created. Waiting for provisioning...`);
-    writeProjectMetadata({
-      appId: nextAppId,
-      displayName,
-      envTarget,
-      platformUrl: creds.platformUrl,
-      gencowJsonPath,
-      writeFileSyncImpl,
-    });
-    infoImpl(`${DIM}gencow.json created (appId: ${nextAppId})${RESET}`);
-    await new Promise((resolveDelay) => setTimeoutImpl(resolveDelay, 3000));
-    return nextAppId;
-  }
+  const createCloudAppIfNeeded = createCloudAppIfNeededImpl({
+    platformFetchImpl,
+    rpcMutationImpl,
+    errorImpl,
+    infoImpl,
+    exitImpl,
+    successImpl,
+    setTimeoutImpl,
+    writeFileSyncImpl,
+  });
 
   function startSpinner(label) {
     const spinnerFrames = ["⣾", "⣽", "⣻", "⢿", "⡿", "⣟", "⣯", "⣷"];

package/lib/deploy-runtime.mjs

@@ -17,6 +17,7 @@ import {
 } from "./deploy-static-fullstack-runtime.mjs";
 import { detectStaticDeployBackend, preflightStaticDeployArtifact } from "./static-deploy-command.mjs";
 import { readJsonObjectResponse } from "./http-response-json.mjs";
+import { reconcileProductionAppTarget } from "./deploy-app-target.mjs";
 
 export function parseDeployArgs(deployArgs) {
   const parsed = {
@@ -192,6 +193,8 @@ async function confirmFirstProductionDeploy({ appId, createInterfaceImpl, infoIm
 
 async function ensureProductionDeployTarget({
   appId,
+  displayName,
+  createCloudAppIfNeeded,
   createInterfaceImpl,
   creds,
   deployArgs,
@@ -209,14 +212,28 @@ async function ensureProductionDeployTarget({
   prodAppId = null,
   region = null,
 }) {
-  if (!appId || prodAppId) {
-    return prodAppId ?? appId;
-  }
+  const reconciledTarget = await reconcileProductionAppTarget({
+    appId,
+    prodAppId,
+    creds,
+    displayName,
+    gencowJsonPath,
+    platformFetchImpl,
+    createCloudAppIfNeeded,
+    infoImpl,
+    errorImpl,
+    exitImpl,
+  });
+  if (!reconciledTarget) return null;
+  const productionParentAppId = reconciledTarget.appId;
+  const existingProdAppId = reconciledTarget.prodAppId;
+  if (existingProdAppId) return existingProdAppId;
+  if (!productionParentAppId) return null;
 
   const ciMode = processEnv.CI === "true" || deployArgs.includes("--yes");
   if (!ciMode) {
     const confirmed = await confirmFirstProductionDeploy({
-      appId,
+      appId: productionParentAppId,
       createInterfaceImpl,
       infoImpl,
       logImpl,
@@ -225,11 +242,15 @@ async function ensureProductionDeployTarget({
   }
 
   infoImpl("Creating prod app...");
-  const createProdRes = await platformFetchImpl(creds, `/platform/apps/${appId}/create-prod`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(region ? { region } : {}),
-  });
+  const createProdRes = await platformFetchImpl(
+    creds,
+    `/platform/apps/${productionParentAppId}/create-prod`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(region ? { region } : {}),
+    },
+  );
 
   if (!createProdRes.ok) {
     const errData = await readJsonObjectResponse(createProdRes);
@@ -526,6 +547,7 @@ export function createDeployCommand({
       resolvePathImpl,
     });
     let { appId, displayName, gencowJsonPath, prodAppId, projectDir } = context;
+    const rootAppId = appId;
     appId = resolveEnvironmentDeployTarget({ appId, envTarget: parsed.envTarget, prodAppId });
     const backendProjectRoot = projectDir ?? projectRoot;
     const projectConfig = loadConfigImpl
@@ -588,7 +610,9 @@ export function createDeployCommand({
 
     if (parsed.envTarget === "prod" && appId && !parsed.existingBundleMode) {
       const prodTarget = await ensureProductionDeployTarget({
-        appId,
+        appId: rootAppId,
+        displayName,
+        createCloudAppIfNeeded: backendDeployRuntime.createCloudAppIfNeeded,
         createInterfaceImpl,
         creds,
         deployArgs,

package/lib/deploy-static-fullstack-runtime.mjs

@@ -124,6 +124,7 @@ export async function deployBackendPackage({
       displayName,
       envTarget,
       gencowJsonPath,
+      allowMissingAppReplacement: !existingBundleMode,
     });
     if (!activeAppId) return null;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gencow",
-  "version": "0.1.244",
+  "version": "0.1.245",
   "description": "Gencow — AI Backend Engine",
   "type": "module",
   "bin": {
@@ -37,9 +37,10 @@
     "ai": "^6.0.233",
     "@types/node": "^25.9.5",
     "better-auth": "^1.6.23",
-    "@gencow/core": "0.1.45",
+    "@typescript/native": "npm:typescript@7.0.2",
     "@gencow/client": "0.2.7",
-    "@gencow/react": "0.2.7"
+    "@gencow/react": "0.2.7",
+    "@gencow/core": "0.1.45"
   },
   "scripts": {
     "prebuild": "pnpm --filter @gencow/migration-contract run build && pnpm --filter @gencow/server run build",