gencow 0.1.192 → 0.1.194

package/bin/gencow.mjs

@@ -38,6 +38,7 @@ import {
   updateEnvLocalUrl,
 } from "../lib/cli-project-runtime.mjs";
 import { createCodegenCommand } from "../lib/codegen-command.mjs";
+import { runCliCommand } from "../lib/cli-command-runner.mjs";
 import { createDoctorCommand } from "../lib/doctor-command.mjs";
 import { maybeCheckCliVersion } from "../lib/cli-version-check.mjs";
 import { updateComponentReadme } from "../lib/component-readme.mjs";
@@ -579,13 +580,10 @@ maybeCheckCliVersion({
   warnImpl: warn,
 });
 
-if (commands[cmd]) {
-  Promise.resolve(commands[cmd](...args)).catch((e) => {
-    error(e.message || String(e));
-    process.exit(1);
-  });
-} else {
-  error(`Unknown command: ${cmd}`);
-  commands.help();
-  process.exit(1);
-}
+process.exitCode = await runCliCommand({
+  args,
+  command: cmd,
+  commands,
+  errorImpl: error,
+  helpImpl: commands.help,
+});

package/lib/app-command.mjs

@@ -24,6 +24,14 @@ import { updateEnvLocalUrl } from "./cli-project-runtime.mjs";
 // Covers the 60s runtime-observer restart grace plus multiple 5s reconciliation scans.
 const DEFAULT_DELETE_POLL_ATTEMPTS = 75;
 const DELETE_POLL_INTERVAL_MS = 1_000;
+const DEFAULT_APP_CREATE_TIMEOUT_MS = 60_000;
+
+function resolveAppCreateTimeoutMs(value) {
+  const parsed = Number(value);
+  return Number.isSafeInteger(parsed) && parsed >= 100 && parsed <= 600_000
+    ? parsed
+    : DEFAULT_APP_CREATE_TIMEOUT_MS;
+}
 
 function appResponseStatus(response) {
   return Number.isSafeInteger(response?.status) ? `HTTP ${response.status}` : "unknown HTTP status";
@@ -74,11 +82,15 @@ export function addDeployAppToConfigSource(src, appName) {
   if (src.includes("deploy:")) return src;
 
   const deployBlock = `    deploy: {\n        app: "${appName}",\n    },\n`;
-  const defineConfigSource = src.replace(/}\s*\)\s*;?\s*$/, `${deployBlock}});\n`);
-  if (defineConfigSource !== src) return defineConfigSource;
+  const insertBeforeClosingObject = (pattern) => {
+    const match = src.match(pattern);
+    if (!match || match.index == null) return null;
+    const prefix = src.slice(0, match.index).trimEnd();
+    const separator = prefix.endsWith(",") || prefix.endsWith("{") ? "\n" : ",\n";
+    return `${prefix}${separator}${deployBlock}${src.slice(match.index)}`;
+  };
 
-  const objectExportSource = src.replace(/}\s*;?\s*$/, `${deployBlock}};\n`);
-  return objectExportSource;
+  return insertBeforeClosingObject(/\}\s*\)\s*;?\s*$/u) ?? insertBeforeClosingObject(/\}\s*;?\s*$/u) ?? src;
 }
 
 export { resolveCreatedAppId };
@@ -101,23 +113,52 @@ async function confirmDelete(name) {
 }
 
 export function createAppCommand({
+  appCreateTimeoutMs = resolveAppCreateTimeoutMs(process.env.GENCOW_APP_CREATE_TIMEOUT_MS),
+  clearTimeoutImpl = clearTimeout,
+  confirmDeleteImpl = confirmDelete,
+  createAbortControllerImpl = () => new AbortController(),
   cwdImpl = () => process.cwd(),
   loadConfig,
   errorImpl = error,
   infoImpl = info,
   loadCredsImpl = loadCreds,
   logImpl = log,
-  processRef = process,
   requireCredsImpl = requireCreds,
   rpcMutationImpl = rpcMutation,
   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,
 }) {
+  const boundedAppCreateTimeoutMs = resolveAppCreateTimeoutMs(appCreateTimeoutMs);
+
+  async function requestAppCreate(creds, name) {
+    const controller = createAbortControllerImpl();
+    const timeoutError = new Error(
+      `App creation request timed out after ${boundedAppCreateTimeoutMs}ms. Please try again.`,
+    );
+    let timeoutHandle;
+    const timeoutPromise = new Promise((_resolve, reject) => {
+      timeoutHandle = setTimeoutImpl(() => {
+        controller.abort(timeoutError);
+        reject(timeoutError);
+      }, boundedAppCreateTimeoutMs);
+    });
+    try {
+      const request = (async () => {
+        const response = await rpcMutationImpl(creds, "apps.create", { name }, { signal: controller.signal });
+        return { response, data: await readJsonObjectResponse(response) };
+      })();
+      return await Promise.race([request, timeoutPromise]);
+    } finally {
+      clearTimeoutImpl(timeoutHandle);
+    }
+  }
+
   return async function app(subcmd, ...rest) {
     if (subcmd === "--help" || subcmd === "-h" || rest.includes("--help") || rest.includes("-h")) {
       logImpl(`\n${BOLD}${CYAN}gencow app${RESET} — App management\n`);
@@ -127,10 +168,10 @@ export function createAppCommand({
       logImpl(`    ${CYAN}create${RESET}    Create a new app`);
       logImpl(`    ${CYAN}delete${RESET}    Delete an app (confirmation required)`);
       logImpl(`    ${CYAN}status${RESET}    Show app status\n`);
-      return;
+      return 0;
     }
 
-    const creds = requireCredsImpl();
+    const creds = requireCredsImpl({ throwOnMissing: true });
 
     if (!subcmd || subcmd === "list") {
       logImpl(`\n${BOLD}${CYAN}Your Apps${RESET}\n`);
@@ -138,18 +179,16 @@ export function createAppCommand({
       const body = await res.json().catch(() => null);
       if (!res.ok) {
         errorImpl(appResponseError(body, invalidAppResponse("app list", res, "error")));
-        processRef.exit(1);
-        return;
+        return 1;
       }
       const apps = parseAppListResponse(body);
       if (!apps) {
         errorImpl(invalidAppResponse("app list", res, "success"));
-        processRef.exit(1);
-        return;
+        return 1;
       }
       if (!apps.length) {
         infoImpl("No apps yet. Run: gencow app create <name>");
-        return;
+        return 0;
       }
 
       logImpl(`  ${"NAME".padEnd(22)} ${"STATUS".padEnd(12)} ${"URL".padEnd(38)} DEPLOYED`);
@@ -163,29 +202,26 @@ export function createAppCommand({
         );
       }
       logImpl("");
-      return;
+      return 0;
     }
 
     if (subcmd === "create") {
       const name = rest[0];
       if (!name) {
         errorImpl("Usage: gencow app create <name>");
-        processRef.exit(1);
+        return 1;
       }
 
       logImpl(`\n${BOLD}${CYAN}Gencow App Create${RESET}\n`);
       infoImpl(`Creating app "${name}"...`);
-      const res = await rpcMutationImpl(creds, "apps.create", { name });
-      const data = await readJsonObjectResponse(res);
+      const { response: res, data } = await requestAppCreate(creds, name);
       if (!res.ok) {
         errorImpl(appResponseError(data, invalidAppResponse("app create", res, "error")));
-        processRef.exit(1);
-        return;
+        return 1;
       }
       if (!data) {
         errorImpl(invalidAppResponse("app create", res, "success"));
-        processRef.exit(1);
-        return;
+        return 1;
       }
 
       let createdApp;
@@ -193,8 +229,7 @@ export function createAppCommand({
         createdApp = resolveCreatedAppResponse(data, { platformUrl: creds.platformUrl });
       } catch (caught) {
         errorImpl(caught.message);
-        processRef.exit(1);
-        return;
+        return 1;
       }
       const { appId, appUrl } = createdApp;
 
@@ -255,7 +290,7 @@ ${dashboardLine}
 
   ${DIM}pnpm gencow dev   — watch & auto-deploy to cloud + live logs${RESET}
 `);
-      return;
+      return 0;
     }
 
     if (subcmd === "delete") {
@@ -266,15 +301,14 @@ ${dashboardLine}
       const name = rest.find((value) => !value.startsWith("-")) || loadCredsImpl()?.currentApp;
       if (!name || unsupportedOption) {
         errorImpl("Usage: gencow app delete <name> [--force]");
-        processRef.exit(1);
-        return;
+        return 1;
       }
 
       if (!force) {
-        const confirmed = await confirmDelete(name);
+        const confirmed = await confirmDeleteImpl(name);
         if (!confirmed) {
           warnImpl("Cancelled — name did not match.");
-          processRef.exit(0);
+          return 0;
         }
       }
 
@@ -300,8 +334,7 @@ ${dashboardLine}
             invalidAppResponse("app delete", delRes, delRes.ok ? "success" : "error"),
           ),
         );
-        processRef.exit(1);
-        return;
+        return 1;
       }
 
       const currentCreds = loadCredsImpl();
@@ -310,15 +343,14 @@ ${dashboardLine}
       }
 
       successImpl(`App "${name}" deleted`);
-      return;
+      return 0;
     }
 
     if (subcmd === "status") {
       const name = rest[0] || loadCredsImpl()?.currentApp;
       if (!name) {
         errorImpl("Usage: gencow app status <name>");
-        processRef.exit(1);
-        return;
+        return 1;
       }
       const res = await rpcQueryImpl(creds, "apps.get", { name });
       const decoded = await readJsonValueResponse(res);
@@ -329,24 +361,20 @@ ${dashboardLine}
             ? appNotFoundDiagnostic()
             : appResponseError(body, invalidAppResponse("app status", res, "error")),
         );
-        processRef.exit(1);
-        return;
+        return 1;
       }
       if (!decoded.parsed) {
         errorImpl(invalidAppResponse("app status", res, "success"));
-        processRef.exit(1);
-        return;
+        return 1;
       }
       const lookup = parseAppLookupResponse(body, name);
       if (lookup.kind === "not_found") {
         errorImpl(appNotFoundDiagnostic());
-        processRef.exit(1);
-        return;
+        return 1;
       }
       if (lookup.kind === "invalid_response") {
         errorImpl(invalidAppResponse("app status", res, "success"));
-        processRef.exit(1);
-        return;
+        return 1;
       }
       const data = lookup.app;
       logImpl(`\n  ${BOLD}${data.name}${RESET}`);
@@ -373,10 +401,11 @@ ${dashboardLine}
         );
       }
       logImpl("");
-      return;
+      return 0;
     }
 
     errorImpl(`Unknown app subcommand: ${subcmd}`);
     logImpl(`  Usage: gencow app [list|create|delete|status]`);
+    return 1;
   };
 }

package/lib/cli-artifact-guard.mjs

@@ -110,6 +110,7 @@ export function validateServerRuntimeBundle(source, options = {}) {
       String.raw`(?:resolve|join|new\s+URL)\([^;\n]{0,640}(?:${repositorySourcePath}|["'](?:platform|server|route-gateway)["']\s*,\s*["']src["'])`,
       "iu",
     ),
+    /resolve\([^;\n]{0,320}\bfunctionsPath\b[^;\n]{0,320}["']\.\.\/src\/platform-api-surface\.ts["']/iu,
   ];
   const errors = repositorySourceImportPatterns.some((pattern) => pattern.test(source))
     ? [

package/lib/cli-command-runner.mjs

@@ -0,0 +1,27 @@
+function commandErrorMessage(caught) {
+  if (caught instanceof Error && caught.message) return caught.message;
+  return String(caught);
+}
+
+function normalizeCommandExitCode(exitCode) {
+  if (exitCode === undefined || exitCode === 0) return 0;
+  if (exitCode === 1) return 1;
+  throw new Error("CLI command returned an invalid exit code");
+}
+
+export async function runCliCommand({ args, command, commands, errorImpl, helpImpl }) {
+  const handler = Object.hasOwn(commands, command) ? commands[command] : undefined;
+  if (typeof handler !== "function") {
+    errorImpl(`Unknown command: ${command}`);
+    helpImpl();
+    return 1;
+  }
+
+  try {
+    const exitCode = await Reflect.apply(handler, commands, args);
+    return normalizeCommandExitCode(exitCode);
+  } catch (caught) {
+    errorImpl(commandErrorMessage(caught));
+    return 1;
+  }
+}

package/lib/deploy-runtime.mjs

@@ -468,10 +468,7 @@ export function createDeployCommand({
       const declaredStaticClients = Array.isArray(workspaceConfig?.clients)
         ? workspaceConfig.clients.filter((client) => client?.static?.dir)
         : [];
-      const clientSelection = selectClient(
-        declaredStaticClients,
-        cliSelection?.client ?? null,
-      );
+      const clientSelection = selectClient(declaredStaticClients, cliSelection?.client ?? null);
       if (clientSelection.error) {
         errorImpl(clientSelection.error);
         exitImpl(1);
@@ -541,7 +538,9 @@ export function createDeployCommand({
         resolvePathImpl,
       }) || displayName;
     const backendDeployRuntime =
-      backendProjectRoot === cwd ? deployPackageRuntime : createDeployPackageRuntimeForCwd(() => backendProjectRoot);
+      backendProjectRoot === cwd
+        ? deployPackageRuntime
+        : createDeployPackageRuntimeForCwd(() => backendProjectRoot);
 
     if (parsed.existingBundleMode && !appId) {
       errorImpl("--existing-bundle requires an existing app target.");
@@ -607,7 +606,7 @@ export function createDeployCommand({
     }
 
     if (parsed.staticDeploy) {
-      return runStaticDeployFlow({
+      await runStaticDeployFlow({
         appId,
         backendRoot: backendProjectRoot,
         creds,
@@ -659,6 +658,7 @@ export function createDeployCommand({
               })
           : undefined,
       });
+      return 0;
     }
 
     logImpl(`\n${BOLD}${CYAN}Gencow Deploy${RESET}\n`);

package/lib/platform-client.mjs

@@ -42,9 +42,15 @@ export function resolveCredsFromSources({ env = process.env, loadCredsImpl = loa
   return creds;
 }
 
+export function formatPlatformCredentialsRequiredMessage({ isCi = Boolean(process.env.CI) } = {}) {
+  return isCi
+    ? "CI environment detected but no credentials found. Set GENCOW_TOKEN in your CI/CD settings."
+    : "Not logged in. Run: gencow login";
+}
+
 export class PlatformCredentialsRequiredError extends Error {
-  constructor() {
-    super("Platform credentials are required");
+  constructor(message = "Platform credentials are required") {
+    super(message);
     this.name = "PlatformCredentialsRequiredError";
   }
 }
@@ -52,7 +58,9 @@ export class PlatformCredentialsRequiredError extends Error {
 export function requireCreds({ throwOnMissing = false } = {}) {
   const creds = resolveCredsFromSources();
   if (!creds?.apiKey) {
-    if (throwOnMissing) throw new PlatformCredentialsRequiredError();
+    if (throwOnMissing) {
+      throw new PlatformCredentialsRequiredError(formatPlatformCredentialsRequiredMessage());
+    }
     if (process.env.CI) {
       error("CI environment detected but no credentials found.");
       info(`Set ${CYAN}GENCOW_TOKEN${RESET} secret in your CI/CD settings.`);
@@ -86,10 +94,11 @@ export async function rpcQuery(creds, queryName, args = {}) {
   });
 }
 
-export async function rpcMutation(creds, mutationName, args = {}) {
+export async function rpcMutation(creds, mutationName, args = {}, requestOptions = {}) {
   return platformFetch(creds, "/api/mutation", {
+    ...requestOptions,
     method: "POST",
-    headers: { "Content-Type": "application/json" },
+    headers: { ...requestOptions.headers, "Content-Type": "application/json" },
     body: JSON.stringify({ name: mutationName, args }),
   });
 }

package/lib/static-command.mjs

@@ -66,11 +66,13 @@ export function readStaticProjectContext(options = {}) {
       projectRoot = selection.projectDir;
     } else {
       const staticBackend = detectStaticDeployBackendImpl({ cwd, existsSyncImpl, resolvePathImpl });
-      projectRoot = staticBackend.detectedBackend && staticBackend.backendRoot ? staticBackend.backendRoot : cwd;
+      projectRoot =
+        staticBackend.detectedBackend && staticBackend.backendRoot ? staticBackend.backendRoot : cwd;
     }
   } catch {
     const staticBackend = detectStaticDeployBackendImpl({ cwd, existsSyncImpl, resolvePathImpl });
-    projectRoot = staticBackend.detectedBackend && staticBackend.backendRoot ? staticBackend.backendRoot : cwd;
+    projectRoot =
+      staticBackend.detectedBackend && staticBackend.backendRoot ? staticBackend.backendRoot : cwd;
   }
   const gencowJsonPath = resolveProjectMetadataPath(projectRoot, resolvePathImpl);
   let appId = explicitAppId;
@@ -201,15 +203,19 @@ export function createStaticCommand(options = {}) {
 
     const parsed = parseStaticArgs(staticArgs);
     const creds = requireCredsImpl();
-    const { appId, displayName: initialDisplayName, gencowJsonPath, prodAppId, projectRoot } = readStaticProjectContextImpl({
+    const {
+      appId,
+      displayName: initialDisplayName,
+      gencowJsonPath,
+      prodAppId,
+      projectRoot,
+    } = readStaticProjectContextImpl({
       cwd: cwdImpl(),
       explicitAppId: parsed.appId,
     });
     const processEnv = process.env;
     const cliSelection = getCliInvocationSelection();
-    const config = loadConfigImpl
-      ? await loadConfigImpl({ cwd: projectRoot, processEnv })
-      : null;
+    const config = loadConfigImpl ? await loadConfigImpl({ cwd: projectRoot, processEnv }) : null;
     const displayName = config
       ? readProjectDisplayNameImpl({
           config,
@@ -289,7 +295,7 @@ export function createStaticCommand(options = {}) {
       );
     }
 
-    return runStaticDeployRuntimeImpl({
+    await runStaticDeployRuntimeImpl({
       creds,
       appId: deployTarget,
       displayName,
@@ -302,5 +308,6 @@ export function createStaticCommand(options = {}) {
         releaseSourceRoot: projectRoot,
       },
     });
+    return 0;
   };
 }

package/lib/template-marketplace-command.mjs

@@ -53,7 +53,13 @@ async function createSourceBundle({ cwd, staticOutputDir, mkdirSyncImpl = mkdirS
   return out;
 }
 
-async function createStaticBundle({ cwd, outputDir, mkdirSyncImpl = mkdirSync, resolvePathImpl = resolve, tarCreateImpl }) {
+async function createStaticBundle({
+  cwd,
+  outputDir,
+  mkdirSyncImpl = mkdirSync,
+  resolvePathImpl = resolve,
+  tarCreateImpl,
+}) {
   const out = resolve(cwd, ".gencow", "template-static.tar.gz");
   mkdirSyncImpl(resolve(cwd, ".gencow"), { recursive: true });
   await createTarGzipArchive({
@@ -65,12 +71,7 @@ async function createStaticBundle({ cwd, outputDir, mkdirSyncImpl = mkdirSync, r
   return out;
 }
 
-async function extractTemplateArchive({
-  archive,
-  targetDir,
-  mkdirSyncImpl = mkdirSync,
-  tarExtractImpl,
-}) {
+async function extractTemplateArchive({ archive, targetDir, mkdirSyncImpl = mkdirSync, tarExtractImpl }) {
   mkdirSyncImpl(targetDir, { recursive: true });
   const extractImpl = tarExtractImpl ?? (await import("tar")).extract;
   await extractImpl({ file: archive, cwd: targetDir });
@@ -230,7 +231,10 @@ export function createTemplateMarketplaceCommand({
     if (subcommand === "publish") return publish(options);
     if (subcommand === "list") return list();
     if (subcommand === "info") return infoCommand(options._[0]);
-    if (subcommand === "download") return download(options._[0], options);
+    if (subcommand === "download") {
+      await download(options._[0], options);
+      return 0;
+    }
     if (subcommand === "clone") {
       const slug = options._[0];
       const dir = options._[1] || slug;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gencow",
-  "version": "0.1.192",
+  "version": "0.1.194",
   "description": "Gencow — AI Backend Engine",
   "type": "module",
   "bin": {
@@ -33,9 +33,9 @@
   "devDependencies": {
     "@types/node": "^25.9.5",
     "better-auth": "^1.6.23",
-    "@gencow/react": "0.2.6",
     "@gencow/core": "0.1.42",
-    "@gencow/client": "0.2.6"
+    "@gencow/client": "0.2.6",
+    "@gencow/react": "0.2.6"
   },
   "scripts": {
     "prebuild": "pnpm --filter @gencow/migration-contract run build && pnpm --filter @gencow/server run build",