gencow 0.1.182 → 0.1.185

package/lib/cli-project-runtime.mjs

@@ -13,6 +13,7 @@ import { resolveCodegenServerPublishDir } from "./codegen-command.mjs";
 import { logEnvFileOperationWithType, resolveBackendEnvFile } from "./backend-env-resolver.mjs";
 import { parseEnvFile } from "./env-parser.mjs";
 import { BOLD, DIM, RESET, error, info, success, warn } from "./output.mjs";
+import { detectProjectConfigFile, warnProjectConfigSelectionOnce } from "./project-config-selection.mjs";
 import { hasWorkspaceConfigSourceRuntime } from "./runtime-mode.mjs";
 import { SUPPORTED_DRIZZLE_KIT_GENERATOR_VERSION } from "./drizzle-generate.mjs";
 
@@ -244,9 +245,9 @@ export async function loadConfig(options = {}) {
 
   // Prefer gencow.config.js. gencow.config.ts is a legacy path handled by a
   // regex parser; it will be removed once all projects migrate.
-  const jsPath = resolvePathImpl(cwd, "gencow.config.js");
-  const tsPath = resolvePathImpl(cwd, "gencow.config.ts");
-  const path = existsSyncImpl(jsPath) ? jsPath : existsSyncImpl(tsPath) ? tsPath : null;
+  const configSelection = detectProjectConfigFile({ cwd, existsSyncImpl, resolvePathImpl });
+  warnProjectConfigSelectionOnce({ cwd, selection: configSelection, warnImpl });
+  const path = configSelection.selectedFile ? resolvePathImpl(cwd, configSelection.selectedFile) : null;
 
   if (!path) {
     warnImpl("No gencow.config.js found — using defaults");
@@ -286,10 +287,19 @@ export async function loadConfig(options = {}) {
   let parsed;
   try {
     const trimPath = (value) => (typeof value === "string" && value.trim().length > 0 ? value.trim() : null);
-    if (!trimPath(raw?.rootDir) && trimPath(raw?.functionsDir) && !functionsDirDeprecationWarned) {
+    const rootDir = trimPath(raw?.rootDir);
+    const functionsDir = trimPath(raw?.functionsDir);
+    if (rootDir && functionsDir) {
+      warnImpl("[gencow] Both config paths are set. Using `rootDir`; ignoring deprecated `functionsDir`.");
+    } else if (!rootDir && functionsDir && !functionsDirDeprecationWarned) {
       warnImpl("[gencow] `functionsDir` is deprecated; use `rootDir` instead (same meaning).");
       functionsDirDeprecationWarned = true;
     }
+    if (trimPath(raw?.codegen?.clientOutDir) && trimPath(raw?.codegen?.outDir)) {
+      warnImpl(
+        "[gencow] Both codegen output paths are set. Using `codegen.clientOutDir`; ignoring deprecated `codegen.outDir`.",
+      );
+    }
     parsed = gencowConfigSchema.parse(raw ?? {});
   } catch (caught) {
     const message = `Invalid gencow.config: ${caught.message}`;

package/lib/db-command.mjs

@@ -115,6 +115,7 @@ function renderDbCheckHelp(logImpl = log) {
   logImpl(`  ${BOLD}Options:${RESET}`);
   logImpl(`    ${DIM}--prod${RESET}       Check the production DB (no mutation or confirmation)`);
   logImpl(`    ${DIM}--app, -a${RESET}    Target specific app`);
+  logImpl(`    ${DIM}--inspect-state${RESET} Run the dedicated platform read-only state inspection`);
   logImpl(`    ${DIM}--json${RESET}        Print a stable machine-readable result\n`);
   logImpl(`  ${DIM}db:check inspects committed migrations and never runs drizzle-kit.${RESET}\n`);
 }

package/lib/db-migration-command-steps.mjs

@@ -1,21 +1,12 @@
-import {
-  MIGRATION_PUSH_RESULT_VERSION,
-  isCanonicalMigrationCapabilityManifestV1,
-} from "@gencow/migration-contract";
 import {
   buildClientUserFixableDiagnostic,
   buildLocalExecutionFailureDiagnostic,
-  buildMigrationCapabilityPreflightUnsupportedDiagnostic,
 } from "./migration-client-diagnostic.mjs";
 import { resolveBackendEnvFile } from "./backend-env-resolver.mjs";
-import {
-  buildMigrationNoResponseDiagnostic,
-  enrichMigrationDiagnostic,
-  extractActionableMigrationDiagnostic,
-  isActionableMigrationDiagnostic,
-} from "./migration-diagnostic.mjs";
+import { buildMigrationNoResponseDiagnostic } from "./migration-diagnostic.mjs";
 import { buildMigrationStatusCommand, fetchMigrationOperationStatus } from "./migration-operation-client.mjs";
 import { BOLD, CYAN, DIM, RED, RESET } from "./output.mjs";
+import { emitMigrationAdvisories, extractMigrationAdvisories } from "./migration-advisory.mjs";
 
 const NO_CHANGE_MARKERS = ["No schema changes", "nothing to migrate", "No changes detected"];
 
@@ -146,50 +137,6 @@ export async function handleMigrationStatus({
   }
 }
 
-export async function checkMigrationCapability({
-  deps,
-  creds,
-  appId,
-  isCheck,
-  functionsDir,
-  retryCommand,
-  correlationId,
-  emitFailure,
-}) {
-  try {
-    const response = await deps.platformFetchImpl(creds, `/platform/apps/${appId}/migration-capabilities`, {
-      method: "GET",
-      headers: { "X-Gencow-CLI-Version": deps.cliVersion },
-    });
-    const data = await response.json().catch(() => ({}));
-    if (!response.ok) {
-      emitFailure(
-        isActionableMigrationDiagnostic(data)
-          ? enrichMigrationDiagnostic(extractActionableMigrationDiagnostic(data), {
-              projectRoot: deps.cwdImpl(),
-              functionsDir,
-              retryCommand,
-            })
-          : buildMigrationCapabilityPreflightUnsupportedDiagnostic(correlationId()),
-      );
-      return false;
-    }
-    if (
-      data?.success !== true ||
-      data?.app !== appId ||
-      !isCanonicalMigrationCapabilityManifestV1(data?.capability, deps.cliVersion) ||
-      (!isCheck && data?.pushResultVersion !== MIGRATION_PUSH_RESULT_VERSION)
-    ) {
-      emitFailure(buildMigrationCapabilityPreflightUnsupportedDiagnostic(correlationId()));
-      return false;
-    }
-    return true;
-  } catch {
-    emitFailure(buildMigrationCapabilityPreflightUnsupportedDiagnostic(correlationId()));
-    return false;
-  }
-}
-
 export function emitCloudMigrationSuccess({
   deps,
   command,
@@ -198,11 +145,13 @@ export function emitCloudMigrationSuccess({
   existingBundleMode,
   isCheck,
   checkData,
+  isInspection,
   pushSuccess,
   jsonMode,
   emitJson,
 }) {
   const migration = pushSuccess?.migration ?? null;
+  const warnings = extractMigrationAdvisories(isCheck ? checkData?.plan?.advisories : pushSuccess?.warnings);
   if (jsonMode) {
     emitJson({
       diagnosticVersion: 1,
@@ -212,17 +161,43 @@ export function emitCloudMigrationSuccess({
       environment,
       databaseState: isCheck ? "UNCHANGED" : "APPLIED",
       ...(existingBundleMode ? { projectState: "UNCHANGED" } : {}),
-      ...(isCheck ? { plan: checkData.plan, capability: checkData.capability } : {}),
+      ...(isCheck
+        ? isInspection
+          ? { inspection: checkData.inspection, capability: checkData.capability }
+          : { plan: checkData.plan, capability: checkData.capability }
+        : {}),
       ...(migration ? { migration } : {}),
       ...(pushSuccess ? { receiptId: pushSuccess.receipt.receiptId } : {}),
+      ...(warnings.length > 0 ? { warnings } : {}),
     });
     return;
   }
   if (isCheck) {
+    if (isInspection) {
+      const ready = checkData.inspection.outcome === "READY";
+      (ready ? deps.successImpl : deps.warnImpl)(
+        ready
+          ? "Migration state inspection completed; the plan is ready."
+          : "Migration state inspection completed; the plan remains blocked.",
+      );
+      deps.logImpl(
+        `  ${DIM}Code: ${checkData.inspection.code} · Next: ${checkData.inspection.nextAction} · Database unchanged${RESET}\n`,
+      );
+      return;
+    }
     deps.successImpl("Migration plan is safe to proceed.");
+    if (checkData.plan.databaseBootstrapRequired === true) {
+      deps.logImpl(`  ${DIM}Fresh database will be bootstrapped by deploy or db:push.${RESET}`);
+    }
+    if (checkData.plan.migrationStorePreparationRequired === true) {
+      deps.logImpl(
+        `  ${DIM}Gencow will prepare the classified migration store during deploy or db:push.${RESET}`,
+      );
+    }
     deps.logImpl(
       `  ${DIM}Applied verified: ${checkData.plan.appliedVerifiedCount} · Pending: ${checkData.plan.pendingCount} · Database unchanged${RESET}\n`,
     );
+    emitMigrationAdvisories(warnings, deps.warnImpl);
     return;
   }
   deps.successImpl(
@@ -231,4 +206,5 @@ export function emitCloudMigrationSuccess({
       : "Versioned migrations applied.",
   );
   deps.logImpl(`  ${DIM}Receipt: ${pushSuccess.receipt.receiptId}${RESET}\n`);
+  emitMigrationAdvisories(warnings, deps.warnImpl);
 }

package/lib/db-push-command.mjs

@@ -1,4 +1,7 @@
-import { isCanonicalMigrationCapabilityManifestV1 } from "@gencow/migration-contract";
+import {
+  MIGRATION_NEXT_ACTION_KINDS,
+  isCompatibleMigrationCapabilityManifestV1,
+} from "@gencow/migration-contract";
 import {
   resolveDrizzleKitGeneratorVersion,
   runDrizzleGenerateWithFallback,
@@ -12,6 +15,7 @@ import {
   enrichMigrationDiagnostic,
   extractActionableMigrationDiagnostic,
   isActionableMigrationDiagnostic,
+  normalizeRetiredMigrationGateDiagnostic,
   renderMigrationDiagnosticLines,
 } from "./migration-diagnostic.mjs";
 import {
@@ -31,7 +35,6 @@ import {
   readMigrationStatusReceiptId,
 } from "./migration-operation-client.mjs";
 import {
-  checkMigrationCapability,
   emitCloudMigrationSuccess,
   handleLocalMigrationCommand,
   handleMigrationStatus,
@@ -39,6 +42,7 @@ import {
   promptDbPushConfirm,
 } from "./db-migration-command-steps.mjs";
 import { resolveConfiguredSchemaPaths, resolveDrizzleSchemaPaths } from "./cli-schema-paths.mjs";
+import { emitMigrationResponsibilityNotice } from "./migration-advisory.mjs";
 
 function clientCorrelationId() {
   return globalThis.crypto?.randomUUID?.() ?? `client-${Date.now()}`;
@@ -65,6 +69,16 @@ export function buildDbMigrationRetryCommand({ command, appId, args, isProd, jso
   if (explicitAppRequested(args)) parts.push("--app", shellQuote(appId));
   if (isProd) parts.push("--prod");
   if (args.includes("--existing-bundle")) parts.push("--existing-bundle");
+  if (args.includes("--inspect-state")) parts.push("--inspect-state");
+  if (jsonMode) parts.push("--json");
+  return parts.join(" ");
+}
+
+export function buildDbMigrationInspectionCommand({ appId, args, isProd, jsonMode }) {
+  const parts = ["gencow", "db:check"];
+  if (explicitAppRequested(args)) parts.push("--app", shellQuote(appId));
+  if (isProd) parts.push("--prod");
+  parts.push("--inspect-state");
   if (jsonMode) parts.push("--json");
   return parts.join(" ");
 }
@@ -75,9 +89,65 @@ function renderFailure(diagnostic, { errorImpl, logImpl }) {
   lines.slice(1).forEach((line) => logImpl(line));
 }
 
+function extractReadOnlyMigrationInspection(data) {
+  const inspection = data?.inspection;
+  if (
+    inspection?.readOnly !== true ||
+    !["READY", "BLOCKED"].includes(inspection.outcome) ||
+    typeof inspection.code !== "string" ||
+    !/^[A-Z][A-Z0-9_]{0,127}$/u.test(inspection.code) ||
+    typeof inspection.nextAction !== "string" ||
+    !(
+      MIGRATION_NEXT_ACTION_KINDS.includes(inspection.nextAction) ||
+      inspection.nextAction === "RETRY_OR_PUSH" ||
+      inspection.nextAction === "PLATFORM_RECONCILIATION"
+    ) ||
+    (inspection.correlationId !== undefined &&
+      (typeof inspection.correlationId !== "string" ||
+        !/^[A-Za-z0-9._:-]{1,200}$/u.test(inspection.correlationId)))
+  ) {
+    return null;
+  }
+  const plan = inspection.plan;
+  if (
+    inspection.outcome === "READY" &&
+    !(
+      typeof plan?.planId === "string" &&
+      /^mig_[a-f0-9]{24}$/u.test(plan.planId) &&
+      Number.isSafeInteger(plan.appliedVerifiedCount) &&
+      plan.appliedVerifiedCount >= 0 &&
+      Number.isSafeInteger(plan.pendingCount) &&
+      plan.pendingCount >= 0
+    )
+  ) {
+    return null;
+  }
+  return {
+    readOnly: true,
+    outcome: inspection.outcome,
+    code: inspection.code,
+    nextAction: inspection.nextAction,
+    ...(inspection.correlationId ? { correlationId: inspection.correlationId } : {}),
+    ...(inspection.outcome === "READY"
+      ? {
+          plan: {
+            planId: plan.planId,
+            appliedVerifiedCount: plan.appliedVerifiedCount,
+            pendingCount: plan.pendingCount,
+            ...(plan.databaseBootstrapRequired === true ? { databaseBootstrapRequired: true } : {}),
+            ...(plan.migrationStorePreparationRequired === true
+              ? { migrationStorePreparationRequired: true }
+              : {}),
+          },
+        }
+      : {}),
+  };
+}
+
 function createDbMigrationCommand(deps, command) {
   return async (...args) => {
     const isCheck = command === "db:check";
+    const isInspection = isCheck && args.includes("--inspect-state");
     const existingBundleMode = isCheck || args.includes("--existing-bundle");
     const sourceMode = existingBundleMode ? "EXISTING_BUNDLE" : "GENERATED";
     const jsonMode = args.includes("--json");
@@ -98,7 +168,7 @@ function createDbMigrationCommand(deps, command) {
     const execute = async () => {
       let config;
       try {
-        config = await deps.loadConfig();
+        config = await deps.loadConfig(jsonMode ? { warnImpl: () => {} } : undefined);
       } catch (error) {
         if (!jsonMode) throw error;
         emitFailure(
@@ -161,6 +231,10 @@ function createDbMigrationCommand(deps, command) {
         return;
       }
 
+      if (!isCheck && !statusReceiptId && !jsonMode) {
+        emitMigrationResponsibilityNotice(deps.warnImpl);
+      }
+
       if (
         !isCheck &&
         !statusReceiptId &&
@@ -320,22 +394,7 @@ function createDbMigrationCommand(deps, command) {
       }
 
       const retryCommand = buildDbMigrationRetryCommand({ command, appId, args, isProd, jsonMode });
-      remoteRequestStarted = true;
-      const capabilityReady = await checkMigrationCapability({
-        deps,
-        creds,
-        appId,
-        isCheck,
-        functionsDir,
-        retryCommand,
-        correlationId: clientCorrelationId,
-        emitFailure,
-      });
-      remoteRequestStarted = false;
-      if (!capabilityReady) {
-        return;
-      }
-
+      const inspectionCommand = buildDbMigrationInspectionCommand({ appId, args, isProd, jsonMode });
       let stagedBundle;
       try {
         stagedBundle = await stageMigrationBundleArchive({
@@ -387,7 +446,7 @@ function createDbMigrationCommand(deps, command) {
           remoteRequestStarted = true;
           res = await deps.platformFetchImpl(
             creds,
-            `/platform/apps/${appId}/${isCheck ? "schema-check" : "schema-push"}`,
+            `/platform/apps/${appId}/${isInspection ? "schema-inspection" : isCheck ? "schema-check" : "schema-push"}`,
             {
               method: "POST",
               headers: {
@@ -431,11 +490,15 @@ function createDbMigrationCommand(deps, command) {
         const data = recoveredSuccess ? null : await res.json().catch(() => ({}));
         if (!recoveredSuccess && !res.ok) {
           const diagnostic = isActionableMigrationDiagnostic(data)
-            ? enrichMigrationDiagnostic(extractActionableMigrationDiagnostic(data), {
-                projectRoot: deps.cwdImpl(),
-                functionsDir,
-                retryCommand,
-              })
+            ? enrichMigrationDiagnostic(
+                normalizeRetiredMigrationGateDiagnostic(extractActionableMigrationDiagnostic(data)),
+                {
+                  projectRoot: deps.cwdImpl(),
+                  functionsDir,
+                  retryCommand,
+                  inspectionCommand,
+                },
+              )
             : isCheck
               ? buildMigrationCheckUnsupportedResponseDiagnostic(
                   typeof data.correlationId === "string" && data.correlationId.length <= 200
@@ -452,17 +515,29 @@ function createDbMigrationCommand(deps, command) {
           return;
         }
 
-        const validCheckSuccess =
-          isCheck &&
+        const inspectionResult = isInspection ? extractReadOnlyMigrationInspection(data) : null;
+        const validInspectionSuccess =
+          isInspection &&
           data?.dryRun === true &&
           data?.databaseState === "UNCHANGED" &&
-          typeof data?.plan?.planId === "string" &&
-          /^mig_[a-f0-9]{24}$/u.test(data.plan.planId) &&
-          Number.isSafeInteger(data?.plan?.appliedVerifiedCount) &&
-          data.plan.appliedVerifiedCount >= 0 &&
-          Number.isSafeInteger(data?.plan?.pendingCount) &&
-          data.plan.pendingCount >= 0 &&
-          isCanonicalMigrationCapabilityManifestV1(data?.capability, deps.cliVersion);
+          inspectionResult !== null &&
+          isCompatibleMigrationCapabilityManifestV1(data?.capability, deps.cliVersion);
+        const validCheckSuccess =
+          isCheck &&
+          (validInspectionSuccess ||
+            (data?.dryRun === true &&
+              data?.databaseState === "UNCHANGED" &&
+              typeof data?.plan?.planId === "string" &&
+              /^mig_[a-f0-9]{24}$/u.test(data.plan.planId) &&
+              Number.isSafeInteger(data?.plan?.appliedVerifiedCount) &&
+              data.plan.appliedVerifiedCount >= 0 &&
+              Number.isSafeInteger(data?.plan?.pendingCount) &&
+              data.plan.pendingCount >= 0 &&
+              (data.plan.databaseBootstrapRequired === undefined ||
+                data.plan.databaseBootstrapRequired === true) &&
+              (data.plan.migrationStorePreparationRequired === undefined ||
+                data.plan.migrationStorePreparationRequired === true) &&
+              isCompatibleMigrationCapabilityManifestV1(data?.capability, deps.cliVersion)));
         if (
           !recoveredSuccess &&
           (data?.success !== true || data?.app !== appId || (isCheck && !validCheckSuccess))
@@ -504,7 +579,8 @@ function createDbMigrationCommand(deps, command) {
           environment: envLabel,
           existingBundleMode,
           isCheck,
-          checkData: data,
+          checkData: isInspection ? { ...data, inspection: inspectionResult } : data,
+          isInspection,
           pushSuccess,
           jsonMode,
           emitJson,

package/lib/deploy-correlation-diagnostic.mjs

@@ -0,0 +1,7 @@
+const SAFE_DEPLOY_CORRELATION_ID = /^[A-Za-z0-9_-]{8,128}$/u;
+
+export function formatDeployCorrelationId(value) {
+  return typeof value === "string" && SAFE_DEPLOY_CORRELATION_ID.test(value)
+    ? `Correlation ID: ${value}`
+    : null;
+}

package/lib/deploy-lockfile-selection.mjs

@@ -0,0 +1,42 @@
+export const DEPLOY_LOCKFILE_CANDIDATES = Object.freeze([
+  { file: "bun.lock", packageManager: "bun" },
+  { file: "bun.lockb", packageManager: "bun" },
+  { file: "pnpm-lock.yaml", packageManager: "pnpm" },
+  { file: "package-lock.json", packageManager: "npm" },
+]);
+
+function declaredPackageManager(value) {
+  if (typeof value !== "string") return null;
+  return /^(bun|pnpm|npm)(?:@|$)/u.exec(value.trim())?.[1] ?? null;
+}
+
+export function selectDeployLockfile({ availableFiles, packageManager }) {
+  const available = new Set(availableFiles);
+  const detected = DEPLOY_LOCKFILE_CANDIDATES.filter(({ file }) => available.has(file));
+  const declared = declaredPackageManager(packageManager);
+  const declaredMatch = declared ? detected.find((candidate) => candidate.packageManager === declared) : null;
+  const selected = declaredMatch ?? detected[0] ?? null;
+
+  return {
+    selectedFile: selected?.file ?? null,
+    selectedPackageManager: selected?.packageManager ?? "none",
+    ignoredFiles: detected.filter(({ file }) => file !== selected?.file).map(({ file }) => file),
+    selectionSource: declaredMatch
+      ? "package.json#packageManager"
+      : selected
+        ? "deterministic priority"
+        : "none",
+  };
+}
+
+export function detectDeployLockfile({ cwd, packageManager, existsSyncImpl, resolvePathImpl }) {
+  const availableFiles = DEPLOY_LOCKFILE_CANDIDATES.filter(({ file }) =>
+    existsSyncImpl(resolvePathImpl(cwd, file)),
+  ).map(({ file }) => file);
+  return selectDeployLockfile({ availableFiles, packageManager });
+}
+
+export function formatDeployLockfileSelectionWarning(selection) {
+  if (!selection.selectedFile || selection.ignoredFiles.length === 0) return null;
+  return `Multiple lockfiles found. Using ${selection.selectedFile} ${selection.selectionSource === "package.json#packageManager" ? "from" : "by"} ${selection.selectionSource}; ignoring ${selection.ignoredFiles.join(", ")}.`;
+}

package/lib/deploy-package-claim.mjs

@@ -6,15 +6,13 @@ import { list } from "tar";
 import { MIGRATION_BUNDLE_CAPABILITY_V1 } from "@gencow/migration-contract";
 
 import { canonicalizeDeployClaimV1, createDeployRequestId, encodeDeployClaimV1 } from "./deploy-contract.mjs";
+import { DEPLOY_LOCKFILE_CANDIDATES } from "./deploy-lockfile-selection.mjs";
 
 const PACKAGE_MANIFEST = "package.json";
 const MIGRATION_MANIFEST = ".gencow/migration-bundle-manifest.json";
-const LOCKFILES = new Map([
-  ["pnpm-lock.yaml", "pnpm"],
-  ["package-lock.json", "npm"],
-  ["bun.lock", "bun"],
-  ["bun.lockb", "bun"],
-]);
+const LOCKFILES = new Map(
+  DEPLOY_LOCKFILE_CANDIDATES.map(({ file, packageManager }) => [file, packageManager]),
+);
 const PROJECT_AUTH = new Set(["gencow/schema-auth.ts", "gencow/schema-auth.js"]);
 const LEGACY_AUTH = new Set([
   "gencow/auth-schema.ts",

package/lib/deploy-package-runtime.mjs

@@ -27,8 +27,13 @@ import { assertToolingRuntimeCapabilities, loadToolingRuntime } from "./tooling-
 import {
   extractActionableMigrationDiagnostic,
   isActionableMigrationDiagnostic,
+  normalizeRetiredMigrationGateDiagnostic,
   renderMigrationDiagnosticLines,
 } from "./migration-diagnostic.mjs";
+import { emitMigrationAdvisories, emitMigrationResponsibilityNotice } from "./migration-advisory.mjs";
+import { formatDeployCorrelationId } from "./deploy-correlation-diagnostic.mjs";
+import { detectDeployLockfile, formatDeployLockfileSelectionWarning } from "./deploy-lockfile-selection.mjs";
+import { detectProjectConfigFile, warnProjectConfigSelectionOnce } from "./project-config-selection.mjs";
 
 async function loadInternalToolingDefault() {
   return loadToolingRuntime({
@@ -340,10 +345,11 @@ export function createDeployPackageRuntime({
     let dependencyAuditManifestPath = null;
     let dependencyAuditManifest = null;
     let dependencyVersionMessage = "";
+    let projectPkg;
     try {
       const { DEPLOY_DEPENDENCY_AUDIT_MANIFEST, auditDependencyVersions, formatDependencyVersionAuditError } =
         await (loadDeployAuditorImpl ?? loadDeployAuditorDefault)();
-      const projectPkg = JSON.parse(readFileSyncImpl(resolvePathImpl(cwd, "package.json"), "utf8"));
+      projectPkg = JSON.parse(readFileSyncImpl(resolvePathImpl(cwd, "package.json"), "utf8"));
       const dependencyVersionResult = auditDependencyVersions(projectPkg);
       dependencyVersionMessage = formatDependencyVersionAuditError(dependencyVersionResult);
       dependencyAuditManifestPath = resolvePathImpl(cwd, DEPLOY_DEPENDENCY_AUDIT_MANIFEST);
@@ -360,6 +366,17 @@ export function createDeployPackageRuntime({
       return null;
     }
 
+    const lockfileSelection = detectDeployLockfile({
+      cwd,
+      packageManager: projectPkg.packageManager,
+      existsSyncImpl,
+      resolvePathImpl,
+    });
+    const lockfileWarning = formatDeployLockfileSelectionWarning(lockfileSelection);
+    if (lockfileWarning) warnImpl(lockfileWarning);
+    const projectConfigSelection = detectProjectConfigFile({ cwd, existsSyncImpl, resolvePathImpl });
+    warnProjectConfigSelectionOnce({ cwd, selection: projectConfigSelection, warnImpl });
+
     try {
       mkdirSyncImpl(dirname(dependencyAuditManifestPath), { recursive: true });
       writeFileSyncImpl(dependencyAuditManifestPath, JSON.stringify(dependencyAuditManifest, null, 2));
@@ -438,17 +455,14 @@ export function createDeployPackageRuntime({
       exitImpl(1);
       return null;
     }
-    if (existsSyncImpl(resolvePathImpl(cwd, "gencow.config.ts"))) filesToPack.push("gencow.config.ts");
-    else if (existsSyncImpl(resolvePathImpl(cwd, "gencow.config.js"))) filesToPack.push("gencow.config.js");
+    if (projectConfigSelection.selectedFile) filesToPack.push(projectConfigSelection.selectedFile);
     if (dependencyAuditManifestPath) filesToPack.push(".gencow/deploy-dependency-audit.json");
     if (cronManifestPath) filesToPack.push(CRON_MANIFEST_RELATIVE_PATH);
-    if (existsSyncImpl(resolvePathImpl(cwd, "bun.lockb"))) filesToPack.push("bun.lockb");
-    if (existsSyncImpl(resolvePathImpl(cwd, "package-lock.json"))) filesToPack.push("package-lock.json");
+    if (lockfileSelection.selectedFile) filesToPack.push(lockfileSelection.selectedFile);
     if (existsSyncImpl(resolvePathImpl(cwd, "tsconfig.json"))) filesToPack.push("tsconfig.json");
 
     if (auditResult?.runtimeDeps?.length >= 0) {
       try {
-        const projectPkg = JSON.parse(readFileSyncImpl(resolvePathImpl(cwd, "package.json"), "utf8"));
         const allDeps = { ...projectPkg.dependencies, ...projectPkg.devDependencies };
         const runtimeDeps = {};
         for (const dependency of auditResult.runtimeDeps) {
@@ -618,6 +632,9 @@ export function createDeployPackageRuntime({
     explicitRequestId = null,
   }) {
     const cwd = cwdImpl();
+    if (deployClaim?.claim?.migrationBundle?.manifestSha256) {
+      emitMigrationResponsibilityNotice(warnImpl);
+    }
     let receipt = deployClaim
       ? acquireDeployReceipt({
           cwd,
@@ -717,7 +734,7 @@ export function createDeployPackageRuntime({
         errData?.retryClass === "retryable-infra";
       if (receipt && !retryableResponse) releaseDeployReceipt(receipt);
       const migrationDiagnostic = isActionableMigrationDiagnostic(errData?.diagnostic)
-        ? extractActionableMigrationDiagnostic(errData.diagnostic)
+        ? normalizeRetiredMigrationGateDiagnostic(extractActionableMigrationDiagnostic(errData.diagnostic))
         : null;
       if (migrationDiagnostic) {
         const lines = renderMigrationDiagnosticLines(migrationDiagnostic);
@@ -725,6 +742,8 @@ export function createDeployPackageRuntime({
         lines.slice(1).forEach((line) => logImpl(line));
       } else {
         errorImpl(`Deploy failed: ${errData.error || deployRes.statusText}`);
+        const correlationLine = formatDeployCorrelationId(errData?.correlationId);
+        if (correlationLine) errorImpl(correlationLine);
       }
       await showCrashLogs(errData, "Server startup failure cause:", targetAppId);
       exitImpl(1);
@@ -732,6 +751,7 @@ export function createDeployPackageRuntime({
     }
 
     const deployData = await deployRes.json();
+    emitMigrationAdvisories(deployData?.warnings, warnImpl);
     if (receipt) releaseDeployReceipt(receipt);
     const deployElapsed = ((Date.now() - startTime) / 1000).toFixed(1);
     logImpl("");

package/lib/dev-cloud-bundle.mjs

@@ -14,16 +14,10 @@ import {
 } from "./deploy-auditor.mjs";
 import { shouldIncludeTarEntry } from "./tar-archive.mjs";
 import { verifyMigrationBundleArchiveRoundTrip } from "./migration-bundle-roundtrip.mjs";
+import { detectDeployLockfile, formatDeployLockfileSelectionWarning } from "./deploy-lockfile-selection.mjs";
+import { detectProjectConfigFile, warnProjectConfigSelectionOnce } from "./project-config-selection.mjs";
 
-const OPTIONAL_BUNDLE_FILES = [
-  "gencow.config.js",
-  "gencow.config.ts",
-  "bun.lock",
-  "bun.lockb",
-  "package-lock.json",
-  "pnpm-lock.yaml",
-  "tsconfig.json",
-];
+const OPTIONAL_BUNDLE_FILES = ["tsconfig.json"];
 
 function readJson(path, readFileSyncImpl) {
   return JSON.parse(readFileSyncImpl(path, "utf8"));
@@ -126,6 +120,16 @@ export async function createDevCloudDeployBundle({
   if (!existsSyncImpl(functionsSource)) throw new Error(`Backend root dir not found: ${functionsSource}`);
 
   const projectPkg = readJson(resolvePathImpl(cwd, "package.json"), readFileSyncImpl);
+  const lockfileSelection = detectDeployLockfile({
+    cwd,
+    packageManager: projectPkg.packageManager,
+    existsSyncImpl,
+    resolvePathImpl,
+  });
+  const lockfileWarning = formatDeployLockfileSelectionWarning(lockfileSelection);
+  if (lockfileWarning) warnImpl(lockfileWarning);
+  const projectConfigSelection = detectProjectConfigFile({ cwd, existsSyncImpl, resolvePathImpl });
+  warnProjectConfigSelectionOnce({ cwd, selection: projectConfigSelection, warnImpl });
   const dependencyVersionResult = auditDependencyVersionsImpl(projectPkg);
   const dependencyVersionMessage = formatDependencyVersionAuditError(dependencyVersionResult);
   if (dependencyVersionMessage) throw new Error(dependencyVersionMessage);
@@ -173,6 +177,20 @@ export async function createDevCloudDeployBundle({
       existsSyncImpl,
       resolvePathImpl,
     });
+    if (projectConfigSelection.selectedFile) {
+      copyFileSyncImpl(
+        resolvePathImpl(cwd, projectConfigSelection.selectedFile),
+        resolvePathImpl(stagingDir, projectConfigSelection.selectedFile),
+      );
+      filesToPack.push(projectConfigSelection.selectedFile);
+    }
+    if (lockfileSelection.selectedFile) {
+      copyFileSyncImpl(
+        resolvePathImpl(cwd, lockfileSelection.selectedFile),
+        resolvePathImpl(stagingDir, lockfileSelection.selectedFile),
+      );
+      filesToPack.push(lockfileSelection.selectedFile);
+    }
 
     const migrationManifestStage = stageProjectMigrationManifest({
       cwd: stagingDir,