gencow 0.1.256 → 0.1.258

package/lib/app-command.mjs

@@ -488,6 +488,8 @@ ${dashboardLine}
       if (delData.stopErrorCode) {
         warnImpl(`App stop needs administrator review. Code: ${delData.stopErrorCode}. Handoff ID: ${delData.handoffId}`);
       }
+      // The handoff changes ownership only; the app keeps serving until an administrator processes it.
+      warnImpl(`Until an administrator processes the deletion, the app's public URL can keep responding. Request ID: ${requestId}. This request is already recorded; do not repeat the delete.`);
       return 0;
     }
 

package/lib/cli-command-runner.mjs

@@ -111,15 +111,35 @@ const SAFE_LOCAL_ERROR_CODES = new Map([
         "Retryable: no, until `npx gencow@latest codegen` passes locally — run it, fix what it reports, then rerun your deploy command.",
     },
   ],
+  [
+    "STATIC_DIR_NOT_FOUND",
+    {
+      message: (caught) => {
+        const dir = safeDisplayDir(caught);
+        return dir
+          ? `Static deploy stopped before upload: the static directory "${dir}" does not exist or is not a directory.`
+          : "Static deploy stopped before upload: the static directory does not exist or is not a directory.";
+      },
+      stage: "preflight",
+      action: (caught) => {
+        const dir = safeDisplayDir(caught) ?? "<static-dir>";
+        if (caught.staticDirSource === "config") {
+          return `Retryable: yes, after ${dir} exists as a directory — run \`ls -ld ${dir}\` to confirm, or correct the client static.dir setting in your Gencow config, then rerun the same command.`;
+        }
+        return `Retryable: yes, after ${dir} exists as a directory — run \`ls -ld ${dir}\` to confirm, then rerun the same command with a correct path, or omit the directory argument to auto-detect (dist, out, build, .next/out).`;
+      },
+    },
+  ],
   [
     "STATIC_ARTIFACT_INDEX_EMPTY",
     {
-      message: "Static deploy stopped before upload: the build output's index.html is empty.",
+      message:
+        "Static deploy stopped before upload: the build output's index.html is empty or contains only whitespace, a BOM, or HTML comments.",
       stage: "artifact",
       action: (caught) => {
         const dir = safeDisplayDir(caught);
         const target = dir ?? "<build-output-dir>";
-        return `Retryable: yes, after the build writes a non-empty index.html into ${target} — run \`ls -l ${target}/index.html\` to confirm its size is above 0 bytes, then rerun \`gencow static ${target}\`.`;
+        return `Retryable: yes, after the build writes an index.html with real content into ${target} — run \`ls -l ${target}/index.html\` to confirm its size is above 0 bytes and that it holds more than whitespace or HTML comments, then rerun \`gencow static ${target}\`.`;
       },
     },
   ],

package/lib/cloud-targets.mjs

@@ -33,6 +33,28 @@ export function readProjectAppTargets(cwd = process.cwd()) {
   }
 }
 
+// Single decision for "which prod app does --prod (+ optional --app) target".
+// acceptExplicitWithoutProdApp preserves call sites that trust an explicit app
+// when the project has no prodApp binding (legacy metadata); others fail closed.
+export function resolveProdAppTarget({ explicitAppId = null, prodApp = null, acceptExplicitWithoutProdApp = false }) {
+  if (!prodApp) {
+    if (explicitAppId && acceptExplicitWithoutProdApp) return { appId: explicitAppId };
+    return { appId: null, reason: "no_prod_app" };
+  }
+  if (explicitAppId && explicitAppId !== prodApp) {
+    return { appId: null, reason: "explicit_app_not_prod_app", prodApp };
+  }
+  return { appId: prodApp };
+}
+
+// Shared human message for a failed prod target; falls back to the call site's own text.
+export function describeProdTargetFailure(result, fallbackMessage) {
+  if (result?.reason === "explicit_app_not_prod_app") {
+    return `\`--app\` with \`--prod\` must name this project's prod app: ${result.prodApp}. Run again with --app ${result.prodApp} or without --app.`;
+  }
+  return fallbackMessage;
+}
+
 export function resolveCloudAppTarget(restArgs, options = {}) {
   const {
     cwd = process.cwd(),
@@ -59,17 +81,24 @@ export function resolveCloudAppTarget(restArgs, options = {}) {
   if (projectTargets.invalid) {
     return { error: "MIGRATION_PROJECT_CONFIG_INVALID" };
   }
+  // The project's own prod app id names the prod environment even without --prod.
+  if (explicitApp && envTarget === "dev" && projectTargets.prodApp && appId === projectTargets.prodApp) {
+    envTarget = "prod";
+  }
   if (!appId) {
     appId = envTarget === "prod" ? projectTargets.prodApp : projectTargets.appId;
   }
 
   if (envTarget === "prod") {
-    if (!projectTargets.prodApp && !explicitApp) {
-      return { error: missingProdMessage };
-    }
-    if (explicitApp && projectTargets.prodApp && appId !== projectTargets.prodApp) {
-      return { error: missingProdMessage };
+    const prodTarget = resolveProdAppTarget({
+      explicitAppId: explicitApp ? appId : null,
+      prodApp: projectTargets.prodApp,
+      acceptExplicitWithoutProdApp: true,
+    });
+    if (!prodTarget.appId) {
+      return { error: describeProdTargetFailure(prodTarget, missingProdMessage) };
     }
+    appId = prodTarget.appId;
   }
 
   if (!appId) {

package/lib/db-command.mjs

@@ -17,6 +17,7 @@ import { createDbCheckCommand, createDbPushCommand } from "./db-push-command.mjs
 import { logEnvFileOperationWithType } from "./backend-env-resolver.mjs";
 import { runDrizzleGenerateWithFallback } from "./drizzle-generate.mjs";
 import { BOLD, CYAN, DIM, GREEN, RED, RESET, error, info, log, success, warn } from "./output.mjs";
+import { describeProdTargetFailure, resolveProdAppTarget } from "./cloud-targets.mjs";
 import { platformFetch, requireCreds } from "./platform-client.mjs";
 import { readProjectMetadata } from "./project-context.mjs";
 
@@ -35,9 +36,17 @@ export function resolveDbCloudTarget(args, gencowJson = null) {
   if (gencowJson) {
     platformUrl = gencowJson.platformUrl || null;
     if (isProd) {
-      const prodApp = gencowJson.prodApp || null;
-      const appId = prodApp ? (!explicitAppId || explicitAppId === prodApp ? prodApp : null) : explicitAppId;
-      return { appId, isProd, platformUrl };
+      const prodTarget = resolveProdAppTarget({
+        explicitAppId,
+        prodApp: gencowJson.prodApp || null,
+        acceptExplicitWithoutProdApp: true,
+      });
+      return {
+        appId: prodTarget.appId,
+        isProd,
+        platformUrl,
+        prodTargetFailure: prodTarget.appId ? undefined : prodTarget,
+      };
     }
     return { appId: explicitAppId || gencowJson.appId || gencowJson.appName || null, isProd, platformUrl };
   }
@@ -369,10 +378,16 @@ export function createDbCommands({
         readFileSyncImpl,
         resolvePathImpl,
       });
-      const { appId, isProd, platformUrl } = resolveDbCloudTarget(args, gencowJson);
+      const target = resolveDbCloudTarget(args, gencowJson);
+      const { appId, isProd, platformUrl } = target;
 
       if (isProd && !appId) {
-        errorImpl("Prod app not found. Run 'gencow deploy' first to create a prod app.");
+        errorImpl(
+          describeProdTargetFailure(
+            target.prodTargetFailure,
+            "Prod app not found. Run 'gencow deploy' first to create a prod app.",
+          ),
+        );
         return 1;
       }
 

package/lib/db-push-command.mjs

@@ -53,6 +53,7 @@ import {
   resolveConfirmationMode,
 } from "./confirm-gate.mjs";
 import { emitMigrationResponsibilityNotice } from "./migration-advisory.mjs";
+import { describeProdTargetFailure } from "./cloud-targets.mjs";
 import { readProjectMetadata } from "./project-context.mjs";
 
 function clientCorrelationId() {
@@ -246,7 +247,12 @@ function createDbMigrationCommand(deps, command) {
             buildClientUserFixableDiagnostic("MIGRATION_APP_TARGET_MISSING", clientCorrelationId()),
           );
         } else if (isProd) {
-          deps.errorImpl("Prod app not found. Run 'gencow deploy' first to create a prod app.");
+          deps.errorImpl(
+            describeProdTargetFailure(
+              target.prodTargetFailure,
+              "Prod app not found. Run 'gencow deploy' first to create a prod app.",
+            ),
+          );
         } else {
           deps.errorImpl("Cloud app not found. Make sure gencow.json exists with an appId.");
           deps.infoImpl(`${DIM}Run 'gencow dev' first to create your app.${RESET}`);

package/lib/deploy-runtime.mjs

@@ -16,6 +16,7 @@ import {
   runStaticDeployFlow,
 } from "./deploy-static-fullstack-runtime.mjs";
 import { detectStaticDeployBackend, preflightStaticDeployArtifact } from "./static-deploy-command.mjs";
+import { formatCommandError } from "./cli-command-runner.mjs";
 import { prodCreateFailureMessage } from "./prod-create-failure.mjs";
 import { readJsonObjectResponse } from "./http-response-json.mjs";
 import { reconcileProductionAppTarget } from "./deploy-app-target.mjs";
@@ -528,12 +529,15 @@ export function createDeployCommand({
       try {
         staticArtifactPreflight = preflightStaticDeployArtifactImpl({
           staticDirArg: resolvedStaticDirArg,
+          // Display text is what the user typed or the client config says, never the resolved path.
+          staticDirDisplay: parsed.staticDirArg ?? selectedClient?.static?.dir ?? null,
+          staticDirSource: parsed.staticDirArg ? "argument" : "config",
           cwd: staticArtifactCwd,
           existsSyncImpl,
           resolvePathImpl,
         });
       } catch (manifestError) {
-        errorImpl(manifestError instanceof Error ? manifestError.message : String(manifestError));
+        errorImpl(formatCommandError(manifestError));
         exitImpl(1);
         return;
       }

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

@@ -5,6 +5,7 @@ import { createDeployPackageRuntime, writeProjectMetadata } from "./deploy-packa
 import { attachProductionTarget } from "./deploy-codegen-failure.mjs";
 import { BOLD, CYAN, DIM, RESET, error, info, log, success } from "./output.mjs";
 import { preflightStaticDeployArtifact } from "./static-deploy-command.mjs";
+import { formatCommandError } from "./cli-command-runner.mjs";
 
 function shouldPreserveFinalizeAttempt(error) {
   return error?.retryable === true || error?.message === "APP_SERVING_ROUTE_COMMIT_PENDING";
@@ -308,7 +309,7 @@ export async function runStaticDeployFlow({
         resolvePathImpl,
       });
     } catch (manifestError) {
-      errorImpl(manifestError instanceof Error ? manifestError.message : String(manifestError));
+      errorImpl(formatCommandError(manifestError));
       exitImpl(1);
       return;
     }

package/lib/files-command.mjs

@@ -2,6 +2,7 @@ import { basename, resolve } from "path";
 import { existsSync, readFileSync, readdirSync, statSync } from "fs";
 import { resolveProjectMetadataPath, resolveProjectSelection } from "./project-context.mjs";
 import { getAppUrl } from "./domain-helpers.mjs";
+import { describeProdTargetFailure, resolveProdAppTarget } from "./cloud-targets.mjs";
 import { BOLD, CYAN, DIM, RESET, YELLOW, error, info, log, success, warn } from "./output.mjs";
 import { requireCreds } from "./platform-client.mjs";
 
@@ -30,9 +31,7 @@ export function parseFilesCommandArgs(restArgs) {
 
 export function resolveFilesAppId({ explicitAppId = null, gencowJson = null, isProd = false }) {
   if (isProd) {
-    const prodApp = gencowJson?.prodApp || null;
-    if (!prodApp) return null;
-    return explicitAppId && explicitAppId !== prodApp ? null : prodApp;
+    return resolveProdAppTarget({ explicitAppId, prodApp: gencowJson?.prodApp || null }).appId;
   }
 
   return explicitAppId || gencowJson?.appId || gencowJson?.appName || null;
@@ -150,7 +149,12 @@ export function createFilesCommand({
     const appId = resolveFilesAppId({ explicitAppId, gencowJson, isProd });
 
     if (isProd && !appId) {
-      errorImpl("Prod app not found. Run 'gencow deploy' first to create a prod app.");
+      errorImpl(
+        describeProdTargetFailure(
+          resolveProdAppTarget({ explicitAppId, prodApp: gencowJson?.prodApp || null }),
+          "Prod app not found. Run 'gencow deploy' first to create a prod app.",
+        ),
+      );
       return;
     }
 

package/lib/jobs-command.mjs

@@ -1,4 +1,5 @@
 import { existsSync, readFileSync } from "fs";
+import { describeProdTargetFailure, resolveProdAppTarget } from "./cloud-targets.mjs";
 import { resolveProjectMetadataPath, resolveProjectSelection } from "./project-context.mjs";
 import { parseDurationToMinutes } from "./domain-helpers.mjs";
 import { BOLD, CYAN, DIM, GREEN, RED, RESET, YELLOW, error, info, log, success, warn } from "./output.mjs";
@@ -115,7 +116,7 @@ export function parseJobsCommandArgs(jobsArgs) {
   };
 }
 
-export function resolveJobsAppId(params) {
+export function resolveJobsAppTarget(params) {
   const cwd = params.cwd ?? process.cwd();
   const existsSyncImpl = params.existsSyncImpl ?? existsSync;
   const processEnv = params.processEnv ?? process.env;
@@ -133,17 +134,21 @@ export function resolveJobsAppId(params) {
   }
   const gencowJsonPath = resolveProjectMetadataPath(projectDir);
   if (!existsSyncImpl(gencowJsonPath)) {
-    return params.isProd ? null : (params.explicitAppId ?? null);
+    return params.isProd
+      ? resolveProdAppTarget({ prodApp: null })
+      : { appId: params.explicitAppId ?? null };
   }
 
   const gencowJson = JSON.parse(readFileSyncImpl(gencowJsonPath, "utf8"));
   if (params.isProd) {
-    const prodApp = gencowJson.prodApp || null;
-    if (!prodApp) return null;
-    return params.explicitAppId && params.explicitAppId !== prodApp ? null : prodApp;
+    return resolveProdAppTarget({ explicitAppId: params.explicitAppId, prodApp: gencowJson.prodApp || null });
   }
 
-  return params.explicitAppId || gencowJson.appId || gencowJson.appName || null;
+  return { appId: params.explicitAppId || gencowJson.appId || gencowJson.appName || null };
+}
+
+export function resolveJobsAppId(params) {
+  return resolveJobsAppTarget(params).appId;
 }
 
 export function getWorkflowCliDerivedStatus(run) {
@@ -680,13 +685,14 @@ export function createJobsCommand() {
 
     const creds = requireCreds();
     const parsed = parseJobsCommandArgs(jobsArgs);
-    const appId = resolveJobsAppId({
+    const appTarget = resolveJobsAppTarget({
       explicitAppId: parsed.appId,
       isProd: parsed.isProd,
     });
+    const appId = appTarget.appId;
 
     if (parsed.isProd && !appId) {
-      error("No prod app yet. Run gencow deploy --prod first.");
+      error(describeProdTargetFailure(appTarget, "No prod app yet. Run gencow deploy --prod first."));
       return;
     }
     if (!appId) {

package/lib/static-artifact-manifest.mjs

@@ -1,6 +1,66 @@
-import { lstatSync, readdirSync } from "fs";
+import { lstatSync, readFileSync, readdirSync } from "fs";
 import { join } from "path";
 
+// Mirrors the Platform policy in packages/platform/src/static-site-entrypoint-policy.ts
+// (isBlankIndexBytes, including its HTML comment states). Keep both in step; the contract test in
+// packages/platform/src/__tests__ runs the same byte cases and generated documents through both entrypoints.
+const STATIC_INDEX_BLANK_SCAN_LIMIT_BYTES = 64 * 1024;
+const UTF8_BOM = [0xef, 0xbb, 0xbf];
+const COMMENT_OPENER = [0x3c, 0x21, 0x2d, 0x2d];
+const ASCII_WHITESPACE = new Set([0x20, 0x09, 0x0a, 0x0d, 0x0c, 0x0b]);
+const LT = 0x3c;
+const GT = 0x3e;
+const BANG = 0x21;
+const DASH = 0x2d;
+
+function isBlankIndexBytes(bytes) {
+  if (bytes.length > STATIC_INDEX_BLANK_SCAN_LIMIT_BYTES) return false;
+  let index = 0;
+  if (bytes.length >= UTF8_BOM.length && UTF8_BOM.every((byte, offset) => bytes[offset] === byte)) {
+    index = UTF8_BOM.length;
+  }
+  let state = "text";
+  let openerMatched = 0;
+  for (; index < bytes.length; index += 1) {
+    const byte = bytes[index];
+    if (state === "text") {
+      if (openerMatched > 0) {
+        if (byte !== COMMENT_OPENER[openerMatched]) return false;
+        openerMatched += 1;
+        if (openerMatched === COMMENT_OPENER.length) {
+          openerMatched = 0;
+          state = "commentStart";
+        }
+      } else if (byte === LT) {
+        openerMatched = 1;
+      } else if (!ASCII_WHITESPACE.has(byte)) {
+        return false;
+      }
+    } else if (state === "commentStart") {
+      if (byte === GT) state = "text";
+      else state = byte === DASH ? "commentStartDash" : "comment";
+    } else if (state === "commentStartDash") {
+      if (byte === DASH) state = "commentEnd";
+      else if (byte === GT) state = "text";
+      else state = "comment";
+    } else if (state === "comment") {
+      if (byte === DASH) state = "commentEndDash";
+    } else if (state === "commentEndDash") {
+      state = byte === DASH ? "commentEnd" : "comment";
+    } else if (state === "commentEnd") {
+      if (byte === GT) state = "text";
+      else if (byte === BANG) state = "commentEndBang";
+      else if (byte !== DASH) state = "comment";
+    } else if (state === "commentEndBang") {
+      if (byte === GT) state = "text";
+      else state = byte === DASH ? "commentEndDash" : "comment";
+    }
+  }
+  // A partial opener at end of file ("<", "<!", "<!-") is not a comment, so it stays content.
+  // Otherwise text or an open comment at end of file renders nothing, so the file is blank.
+  return openerMatched === 0;
+}
+
 function countFiles(dir, readdirSyncImpl) {
   let count = 0;
   for (const entry of readdirSyncImpl(dir, { withFileTypes: true })) {
@@ -16,12 +76,20 @@ export function buildStaticArtifactManifest({
   displayDir = null,
   lstatSyncImpl = lstatSync,
   readdirSyncImpl = readdirSync,
+  readFileSyncImpl = readFileSync,
 }) {
-  // Mirrors the Platform's static entrypoint policy: a root index.html must be a regular file with bytes.
+  // Mirrors the Platform's static entrypoint policy: a root index.html must be a regular file that is
+  // not empty and not blank (optional BOM, ASCII whitespace, and HTML comments only).
   let entrypoint = "missing";
   try {
-    const stat = lstatSyncImpl(join(rootDir, "index.html"));
-    if (stat.isFile()) entrypoint = stat.size === 0 ? "empty" : "usable";
+    const indexPath = join(rootDir, "index.html");
+    const stat = lstatSyncImpl(indexPath);
+    if (stat.isFile()) {
+      const blank =
+        stat.size <= STATIC_INDEX_BLANK_SCAN_LIMIT_BYTES &&
+        isBlankIndexBytes(readFileSyncImpl(indexPath));
+      entrypoint = stat.size === 0 || blank ? "empty" : "usable";
+    }
   } catch {
     entrypoint = "missing";
   }
@@ -33,7 +101,9 @@ export function buildStaticArtifactManifest({
     // attached as a field (not interpolated) so the public renderer decides what is safe to show.
     if (entrypoint === "empty") {
       throw Object.assign(
-        new Error(`${source} has an empty index.html at its root. Refusing to replace the current frontend.`),
+        new Error(
+          `${source} has an empty or blank index.html at its root (only whitespace or HTML comments). Refusing to replace the current frontend.`,
+        ),
         { code: "STATIC_ARTIFACT_INDEX_EMPTY", displayDir },
       );
     }

package/lib/static-command.mjs

@@ -3,6 +3,7 @@ import { isAbsolute, resolve } from "path";
 
 import { readProjectDisplayName } from "./cli-project-runtime.mjs";
 import { formatCommandError } from "./cli-command-runner.mjs";
+import { describeProdTargetFailure, resolveProdAppTarget } from "./cloud-targets.mjs";
 import {
   getCliInvocationSelection,
   resolveProjectMetadataPath,
@@ -255,10 +256,14 @@ export function createStaticCommand(options = {}) {
         ? resolvePathImpl(frontendRoot, selectedClient.static.dir)
         : parsed.staticDir;
 
+    // The display value is what the user typed or the client config says, never the resolved absolute path.
+    const staticDirDisplay = parsed.staticDir || selectedClient?.static?.dir || null;
     let artifactPreflight;
     try {
       artifactPreflight = preflightStaticDeployArtifactImpl({
         staticDirArg: configuredStaticDir,
+        staticDirDisplay,
+        staticDirSource: parsed.staticDir ? "argument" : "config",
         cwd: selectedClient ? frontendRoot : cwdImpl(),
       });
     } catch (manifestError) {
@@ -277,6 +282,15 @@ export function createStaticCommand(options = {}) {
       selectedClient && artifactPreflight.targetDir && !isAbsolute(artifactPreflight.targetDir)
         ? resolvePathImpl(frontendRoot, artifactPreflight.targetDir)
         : artifactPreflight.targetDir;
+    if (parsed.isProd && prodAppId) {
+      // An explicit --app must be this project's prod app; it is never silently replaced by the default.
+      const prodTarget = resolveProdAppTarget({ explicitAppId: parsed.appId, prodApp: prodAppId });
+      if (!prodTarget.appId) {
+        errorImpl(describeProdTargetFailure(prodTarget, "Prod app not found. Run 'gencow deploy' first to create a prod app."));
+        exitImpl(1);
+        return;
+      }
+    }
     let deployTarget = parsed.isProd ? prodAppId || appId : appId;
     const envTarget = parsed.isProd ? "prod" : "dev";
 

package/lib/static-deploy-artifact-preflight.mjs

@@ -0,0 +1,85 @@
+import { existsSync, lstatSync, readdirSync, statSync } from "fs";
+import { isAbsolute, resolve } from "path";
+
+import { buildStaticArtifactManifest } from "./static-artifact-manifest.mjs";
+
+function isExistingDirectory(path, { existsSyncImpl, statSyncImpl }) {
+  if (!existsSyncImpl(path)) return false;
+  try {
+    return statSyncImpl(path).isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+// An explicitly named directory (CLI argument or client static.dir setting) is never silently replaced
+// by auto-detection. displayDir is only what the user typed or configured; the resolved absolute path
+// stays out of the error so the renderer cannot leak it.
+function createStaticDirNotFoundError({ staticDirArg, staticDirDisplay, staticDirSource }) {
+  const displayDir = staticDirDisplay ?? (isAbsolute(staticDirArg) ? null : staticDirArg);
+  return Object.assign(new Error("Static directory does not exist or is not a directory."), {
+    code: "STATIC_DIR_NOT_FOUND",
+    displayDir,
+    staticDirSource,
+  });
+}
+
+export function resolveStaticDeployDir({
+  staticDirArg,
+  staticDirDisplay = null,
+  staticDirSource = "argument",
+  cwd = process.cwd(),
+  autoDetectDirs = ["dist", "out", "build", ".next/out"],
+  existsSyncImpl = existsSync,
+  resolvePathImpl = resolve,
+  statSyncImpl = statSync,
+}) {
+  if (staticDirArg) {
+    if (!isExistingDirectory(resolvePathImpl(cwd, staticDirArg), { existsSyncImpl, statSyncImpl })) {
+      throw createStaticDirNotFoundError({ staticDirArg, staticDirDisplay, staticDirSource });
+    }
+    return staticDirArg;
+  }
+  for (const candidate of autoDetectDirs) {
+    if (existsSyncImpl(resolvePathImpl(cwd, candidate))) {
+      return candidate;
+    }
+  }
+  return null;
+}
+
+export function preflightStaticDeployArtifact({
+  staticDirArg,
+  staticDirDisplay = null,
+  staticDirSource = "argument",
+  cwd = process.cwd(),
+  autoDetectDirs,
+  existsSyncImpl = existsSync,
+  lstatSyncImpl = lstatSync,
+  readdirSyncImpl = readdirSync,
+  resolvePathImpl = resolve,
+  statSyncImpl = statSync,
+}) {
+  const targetDir = resolveStaticDeployDir({
+    staticDirArg,
+    staticDirDisplay,
+    staticDirSource,
+    cwd,
+    autoDetectDirs,
+    existsSyncImpl,
+    resolvePathImpl,
+    statSyncImpl,
+  });
+  if (!targetDir) return null;
+
+  return {
+    targetDir,
+    artifactManifest: buildStaticArtifactManifest({
+      rootDir: resolvePathImpl(cwd, targetDir),
+      selection: staticDirArg ? "explicit" : `auto:${targetDir}`,
+      displayDir: targetDir,
+      lstatSyncImpl,
+      readdirSyncImpl,
+    }),
+  };
+}

package/lib/static-deploy-command.mjs

@@ -12,10 +12,13 @@ import { relative, resolve } from "path";
 import { BOLD, CYAN, DIM, RESET, YELLOW, error, info, log, success, warn } from "./output.mjs";
 import { resolveCreatedAppResponse } from "./app-create-response.mjs";
 import { readJsonObjectResponse } from "./http-response-json.mjs";
+import { formatCommandError } from "./cli-command-runner.mjs";
+import { preflightStaticDeployArtifact, resolveStaticDeployDir } from "./static-deploy-artifact-preflight.mjs";
+
+export { preflightStaticDeployArtifact, resolveStaticDeployDir };
 import { platformFetch, rpcMutation } from "./platform-client.mjs";
 import { createTarGzipArchive } from "./tar-archive.mjs";
 import { buildDeployClaimFromArchive } from "./deploy-package-claim.mjs";
-import { buildStaticArtifactManifest } from "./static-artifact-manifest.mjs";
 import { getCliInvocationSelection } from "./project-context.mjs";
 import { pollAcceptedDeploymentOperation } from "./deployment-operation-poll.mjs";
 import { renderDeployFailureDiagnosticLines } from "./deploy-failure-diagnostic.mjs";
@@ -73,54 +76,6 @@ export async function postStaticDeployWithTransientProxyRetry({
   }
 }
 
-export function resolveStaticDeployDir({
-  staticDirArg,
-  cwd = process.cwd(),
-  autoDetectDirs = ["dist", "out", "build", ".next/out"],
-  existsSyncImpl = existsSync,
-  resolvePathImpl = resolve,
-}) {
-  if (staticDirArg && existsSyncImpl(resolvePathImpl(cwd, staticDirArg))) {
-    return staticDirArg;
-  }
-  for (const candidate of autoDetectDirs) {
-    if (existsSyncImpl(resolvePathImpl(cwd, candidate))) {
-      return candidate;
-    }
-  }
-  return null;
-}
-
-export function preflightStaticDeployArtifact({
-  staticDirArg,
-  cwd = process.cwd(),
-  autoDetectDirs,
-  existsSyncImpl = existsSync,
-  lstatSyncImpl = lstatSync,
-  readdirSyncImpl = readdirSync,
-  resolvePathImpl = resolve,
-}) {
-  const targetDir = resolveStaticDeployDir({
-    staticDirArg,
-    cwd,
-    autoDetectDirs,
-    existsSyncImpl,
-    resolvePathImpl,
-  });
-  if (!targetDir) return null;
-
-  return {
-    targetDir,
-    artifactManifest: buildStaticArtifactManifest({
-      rootDir: resolvePathImpl(cwd, targetDir),
-      selection: staticDirArg ? "explicit" : `auto:${targetDir}`,
-      displayDir: targetDir,
-      lstatSyncImpl,
-      readdirSyncImpl,
-    }),
-  };
-}
-
 export function detectStaticDeployBackend({
   cwd = process.cwd(),
   existsSyncImpl = existsSync,
@@ -307,7 +262,7 @@ export function createStaticDeployRuntime({
           resolvePathImpl,
         });
       } catch (manifestError) {
-        errorImpl(manifestError instanceof Error ? manifestError.message : String(manifestError));
+        errorImpl(formatCommandError(manifestError));
         exitImpl(1);
         return;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gencow",
-  "version": "0.1.256",
+  "version": "0.1.258",
   "description": "Gencow — AI Backend Engine",
   "type": "module",
   "bin": {
@@ -41,10 +41,10 @@
     "better-auth": "1.7.11",
     "postgres": "^3.4.9",
     "@gencow/client": "0.2.8",
-    "@gencow/react": "0.2.8",
-    "@gencow/shared": "0.0.0",
     "@gencow/core": "0.1.47",
-    "@gencow/server": "0.1.3"
+    "@gencow/react": "0.2.8",
+    "@gencow/server": "0.1.3",
+    "@gencow/shared": "0.0.0"
   },
   "scripts": {
     "build": "node scripts/bundle-core.mjs && node scripts/bundle-shared.mjs && node scripts/bundle-server.mjs",