gencow 0.1.182 → 0.1.185

package/lib/dev-cloud-command.mjs

@@ -13,12 +13,15 @@ import {
   normalizeDiagnosticLogLines,
 } from "./app-diagnostics.mjs";
 import { buildDeployClaimFromArchive } from "./deploy-package-claim.mjs";
+import { formatDeployCorrelationId } from "./deploy-correlation-diagnostic.mjs";
 import { hasProjectDatabaseSchemaSource } from "./project-migration-manifest.mjs";
 import {
   extractActionableMigrationDiagnostic,
   isActionableMigrationDiagnostic,
+  normalizeRetiredMigrationGateDiagnostic,
   renderMigrationDiagnosticLines,
 } from "./migration-diagnostic.mjs";
+import { emitMigrationAdvisories, emitMigrationResponsibilityNotice } from "./migration-advisory.mjs";
 import { resolveCreatedAppResponse } from "./app-create-response.mjs";
 
 export function resolveDevCloudAppName({
@@ -259,6 +262,7 @@ export function createDevCloudCommand(deps) {
       const form = new FormData();
       form.append("bundle", new Blob([bundle], { type: "application/gzip" }), "bundle.tar.gz");
 
+      if (schemaExists) emitMigrationResponsibilityNotice(deps.warnImpl);
       const res = await deps.platformFetchImpl(creds, `/platform/apps/${appName}/deploy`, {
         method: "POST",
         body: form,
@@ -276,7 +280,7 @@ export function createDevCloudCommand(deps) {
         deps.logImpl(`${deps.DIM}${ts2}${deps.RESET} ${deps.RED}[deploy]${deps.RESET} ✗ Deploy failed!`);
         const errMsg = data.error || "Unknown error";
         const migrationDiagnostic = isActionableMigrationDiagnostic(data?.diagnostic)
-          ? extractActionableMigrationDiagnostic(data.diagnostic)
+          ? normalizeRetiredMigrationGateDiagnostic(extractActionableMigrationDiagnostic(data.diagnostic))
           : null;
         if (migrationDiagnostic) {
           for (const line of renderMigrationDiagnosticLines(migrationDiagnostic)) {
@@ -284,6 +288,8 @@ export function createDevCloudCommand(deps) {
           }
         } else {
           deps.logImpl(`         ${deps.RED}${errMsg}${deps.RESET}`);
+          const correlationLine = formatDeployCorrelationId(data?.correlationId);
+          if (correlationLine) deps.logImpl(`         ${correlationLine}`);
         }
 
         let diagnosticLines = normalizeDiagnosticLogLines(data.crashLogs);
@@ -315,6 +321,7 @@ export function createDevCloudCommand(deps) {
         return;
       }
 
+      emitMigrationAdvisories(data?.warnings, deps.warnImpl);
       const ts2 = new Date().toLocaleTimeString("en-US", { hour12: false });
       deps.logImpl(
         `${deps.DIM}${ts2}${deps.RESET} ${deps.GREEN}[deploy]${deps.RESET} ✔ Deploy complete ${deps.DIM}(${sizeKB}KB, ${elapsed}s)${deps.RESET}`,
@@ -395,10 +402,12 @@ export function createDevCloudCommand(deps) {
       }, delayMs);
     }
 
-    const { readdirSync, watch } = await import("fs");
+    const fsModule = deps.readdirSyncImpl && deps.watchImpl ? null : await import("fs");
+    const readdirSyncImpl = deps.readdirSyncImpl ?? fsModule.readdirSync;
+    const watchImpl = deps.watchImpl ?? fsModule.watch;
     const watchedFiles = [];
     try {
-      const files = readdirSync(absoluteFunctions).filter(
+      const files = readdirSyncImpl(absoluteFunctions).filter(
         (file) => file.endsWith(".ts") && !file.startsWith(".") && file !== "api.ts",
       );
       watchedFiles.push(...files);
@@ -428,7 +437,7 @@ ${deps.BOLD}${deps.CYAN}🚀 Gencow Cloud Dev${deps.RESET}
     let debounceTimer = null;
     let pendingFile = null;
     const GENERATED_FILES = new Set(["api.ts", "README.md"]);
-    watch(absoluteFunctions, { recursive: true }, (_eventType, filename) => {
+    watchImpl(absoluteFunctions, { recursive: true }, (_eventType, filename) => {
       if (!filename || filename.includes("node_modules")) return;
       if (isServerCodegenWatchPath(filename, cwd, config, { resolvePathImpl: deps.resolvePathImpl })) return;
       const base = (filename.includes("/") ? filename.split("/").pop() : filename) ?? filename;

package/lib/migration-advisory.mjs

@@ -0,0 +1,41 @@
+const ADVISORY_SUMMARIES = Object.freeze({
+  MIGRATION_POTENTIAL_DATA_LOSS: "The pending migration may remove tenant data.",
+  MIGRATION_LOCK_RISK: "The pending migration may take a blocking PostgreSQL lock.",
+  MIGRATION_COMPATIBILITY_RISK: "Coordinate this schema change with application rollout compatibility.",
+  MIGRATION_BACKUP_NOT_CREATED:
+    "Gencow could not create an automatic backup; verify your own recovery point.",
+});
+
+export function extractMigrationAdvisories(value) {
+  if (!Array.isArray(value)) return [];
+  const advisories = [];
+  const seen = new Set();
+  for (const item of value.slice(0, 16)) {
+    const code = typeof item?.code === "string" ? item.code : "";
+    if (!(code in ADVISORY_SUMMARIES) || seen.has(code)) continue;
+    seen.add(code);
+    advisories.push({
+      code,
+      severity: "warning",
+      responsibility: "user",
+      summary: ADVISORY_SUMMARIES[code],
+    });
+  }
+  return advisories;
+}
+
+export function emitMigrationAdvisories(value, warnImpl) {
+  const advisories = extractMigrationAdvisories(value);
+  for (const advisory of advisories) {
+    warnImpl(
+      `Migration warning [${advisory.code}]: ${advisory.summary} Review and proceed at your discretion.`,
+    );
+  }
+  return advisories;
+}
+
+export function emitMigrationResponsibilityNotice(warnImpl) {
+  warnImpl(
+    "Migration responsibility: review pending SQL and verify your own recovery point before execution; automatic backups are best-effort.",
+  );
+}

package/lib/migration-diagnostic.mjs

@@ -8,6 +8,56 @@ export {
   isActionableMigrationDiagnostic,
 } from "./migration-diagnostic-contract.mjs";
 
+const RETIRED_PLATFORM_GATES = new Set([
+  "MIGRATION_BUNDLE_GENERATOR_UNSUPPORTED",
+  "MIGRATION_SQL_DESTRUCTIVE",
+  "MIGRATION_SQL_UNSUPPORTED",
+  "PRE_DEPLOY_SAFETY_BACKUP_REQUIRED",
+  "MIGRATION_CHECK_STATE_UNAVAILABLE",
+]);
+
+export function normalizeRetiredMigrationGateDiagnostic(diagnostic) {
+  if (
+    !diagnostic ||
+    !RETIRED_PLATFORM_GATES.has(diagnostic.code) ||
+    diagnostic.databaseState !== "UNCHANGED" ||
+    !["PREFLIGHT", "AUDIT", "REHEARSAL", "VERIFY"].includes(diagnostic.phase)
+  ) {
+    return diagnostic;
+  }
+  if (
+    diagnostic.failureClass === "RETRYABLE_INFRA" &&
+    diagnostic.retryPolicy === "AFTER_DELAY" &&
+    diagnostic.nextAction?.kind === "WAIT"
+  ) {
+    return diagnostic;
+  }
+  return {
+    diagnosticVersion: 1,
+    code: diagnostic.code,
+    failureClass: "RETRYABLE_INFRA",
+    phase: diagnostic.phase,
+    databaseState: "UNCHANGED",
+    safeToRetryNow: false,
+    retryPolicy: "AFTER_DELAY",
+    retryAfterSeconds: 15,
+    retryCondition: "Retry the same immutable bundle after the Blue-Green platform rollout converges.",
+    correlationId: diagnostic.correlationId,
+    reason: {
+      code: "retired_platform_gate",
+      summary: "An older platform slot applied a migration gate that is no longer enforced.",
+      detail:
+        "No tenant database mutation occurred. Keep the project unchanged while the current platform policy finishes rolling out.",
+    },
+    suggestedFixes: [],
+    nextAction: { kind: "WAIT" },
+    forbiddenActions: [],
+    redaction: { serverReturnedRawSql: false, localExcerpt: "NONE" },
+    ...(diagnostic.docsUrl ? { docsUrl: diagnostic.docsUrl } : {}),
+    ...(diagnostic.supportedCliRange ? { supportedCliRange: diagnostic.supportedCliRange } : {}),
+  };
+}
+
 function skipSingleQuoted(sql, start) {
   let index = start + 1;
   while (index < sql.length) {
@@ -161,6 +211,7 @@ export function enrichMigrationDiagnostic(
     projectRoot,
     functionsDir,
     retryCommand,
+    inspectionCommand,
     readFileSyncImpl = readFileSync,
     realpathSyncImpl = realpathSync,
   },
@@ -171,9 +222,12 @@ export function enrichMigrationDiagnostic(
     diagnostic.safeToRetryNow === true &&
     diagnostic.retryPolicy !== "BLOCKED" &&
     (diagnostic.nextAction?.kind === "EDIT_AND_CHECK" || diagnostic.nextAction?.kind === "RETRY");
+  const canAttachInspectionCommand = inspectionCommand && diagnostic.nextAction?.kind === "INSPECT_STATE";
   const nextAction = canAttachRetryCommand
     ? { kind: diagnostic.nextAction.kind, command: retryCommand }
-    : { kind: diagnostic.nextAction?.kind };
+    : canAttachInspectionCommand
+      ? { kind: "INSPECT_STATE", command: inspectionCommand }
+      : { kind: diagnostic.nextAction?.kind };
   const base = {
     ...diagnostic,
     ...(diagnostic.migration
@@ -230,9 +284,30 @@ export function enrichMigrationDiagnostic(
   }
 }
 
+function migrationDiagnosticTitle(diagnostic) {
+  if (diagnostic.failureClass === "RECOVERY_REQUIRED" || diagnostic.databaseState === "RECOVERY_REQUIRED") {
+    return "Migration outcome verification required";
+  }
+  if (diagnostic.databaseState === "ROLLED_BACK") return "Migration rolled back";
+  if (diagnostic.failureClass === "USER_FIXABLE") return "Migration input needs attention";
+  if (diagnostic.code === "SCHEMA_PUSH_IN_PROGRESS") return "Migration waiting for an active operation";
+  if (diagnostic.nextAction?.kind === "INSPECT_STATE") return "Migration state inspection required";
+  if (diagnostic.failureClass === "RETRYABLE_INFRA") return "Migration check temporarily unavailable";
+  return "Migration action required";
+}
+
+function shouldRenderForbiddenActions(diagnostic) {
+  return (
+    diagnostic.failureClass === "RECOVERY_REQUIRED" ||
+    /(?:HASH_DRIFT|FILE_MISSING|HISTORY|JOURNAL|POLICY_VIOLATION|SECURITY_BOUNDARY)/u.test(
+      diagnostic.code ?? "",
+    )
+  );
+}
+
 export function renderMigrationDiagnosticLines(diagnostic) {
   const lines = [
-    "Migration blocked",
+    migrationDiagnosticTitle(diagnostic),
     "",
     `Code: ${diagnostic.code}`,
     `Responsibility: ${diagnostic.failureClass}`,
@@ -267,12 +342,13 @@ export function renderMigrationDiagnosticLines(diagnostic) {
       lines.push(`  ${index + 1}. ${fix.title}`, `     ${fix.detail}`),
     );
   }
-  if (diagnostic.forbiddenActions?.length > 0) {
+  if (shouldRenderForbiddenActions(diagnostic) && diagnostic.forbiddenActions?.length > 0) {
     lines.push("", "Do not:");
     diagnostic.forbiddenActions.forEach((action) => lines.push(`  - ${action}`));
   }
   const nextText =
-    diagnostic.nextAction?.kind === "VIEW_STATUS" && diagnostic.nextAction?.command
+    (diagnostic.nextAction?.kind === "VIEW_STATUS" || diagnostic.nextAction?.kind === "INSPECT_STATE") &&
+    diagnostic.nextAction?.command
       ? diagnostic.nextAction.command
       : diagnostic.safeToRetryNow && diagnostic.nextAction?.command
         ? diagnostic.nextAction.command
@@ -282,7 +358,7 @@ export function renderMigrationDiagnosticLines(diagnostic) {
             INSPECT_STATE:
               diagnostic.code === "MIGRATION_LOCAL_EXECUTION_FAILED"
                 ? "Inspect the local Drizzle journal and database catalog before retrying"
-                : "Run read-only gencow db:check for the same app before any new mutation request",
+                : "Run the platform's read-only migration-state inspection before any new mutation request",
             UPDATE_CLI: "Update the CLI to the exact supported range shown above",
             VIEW_STATUS: "View the exact operation receipt before any new mutation request",
             RETRY: "Regenerate a stable bundle and retry from a fresh plan",

package/lib/migration-operation-client.mjs

@@ -3,6 +3,7 @@ import {
   extractMigrationSchemaOperationReceipt,
   extractPrimaryMigrationExecutionResult,
 } from "@gencow/migration-contract";
+import { extractMigrationAdvisories } from "./migration-advisory.mjs";
 
 const RECEIPT_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/u;
 
@@ -53,7 +54,7 @@ export function extractMigrationPushSuccess(data, expected) {
   ) {
     return null;
   }
-  return { migration, receipt };
+  return { migration, receipt, warnings: extractMigrationAdvisories(data?.warnings) };
 }
 
 export async function fetchMigrationOperationStatus({

package/lib/project-config-selection.mjs

@@ -0,0 +1,32 @@
+export const PROJECT_CONFIG_CANDIDATES = Object.freeze(["gencow.config.js", "gencow.config.ts"]);
+
+const reportedSelections = new Set();
+
+export function selectProjectConfigFile(availableFiles) {
+  const available = new Set(availableFiles);
+  const detectedFiles = PROJECT_CONFIG_CANDIDATES.filter((file) => available.has(file));
+  return {
+    selectedFile: detectedFiles[0] ?? null,
+    ignoredFiles: detectedFiles.slice(1),
+  };
+}
+
+export function detectProjectConfigFile({ cwd, existsSyncImpl, resolvePathImpl }) {
+  return selectProjectConfigFile(
+    PROJECT_CONFIG_CANDIDATES.filter((file) => existsSyncImpl(resolvePathImpl(cwd, file))),
+  );
+}
+
+export function formatProjectConfigSelectionWarning(selection) {
+  if (!selection.selectedFile || selection.ignoredFiles.length === 0) return null;
+  return `[gencow] Multiple project config files found. Using \`${selection.selectedFile}\`; ignoring deprecated \`${selection.ignoredFiles.join("`, `")}\`.`;
+}
+
+export function warnProjectConfigSelectionOnce({ cwd, selection, warnImpl }) {
+  const warning = formatProjectConfigSelectionWarning(selection);
+  if (!warning) return;
+  const key = `${cwd}\0${selection.selectedFile}\0${selection.ignoredFiles.join("\0")}`;
+  if (reportedSelections.has(key)) return;
+  reportedSelections.add(key);
+  warnImpl(warning);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gencow",
-  "version": "0.1.182",
+  "version": "0.1.185",
   "description": "Gencow — AI Backend Engine",
   "type": "module",
   "bin": {
@@ -24,10 +24,10 @@
     "drizzle-orm": "1.0.0-rc.4",
     "esbuild": "^0.27.7",
     "open": "^10.2.0",
-    "tar": "^7.5.21",
+    "tar": "7.5.15",
     "ws": "^8.21.1",
     "zod": "^4.4.3",
-    "@gencow/migration-contract": "0.1.2"
+    "@gencow/migration-contract": "0.1.8"
   },
   "devDependencies": {
     "@types/node": "^25.9.5",

package/runtime/config.mjs

@@ -14611,9 +14611,6 @@ var gencowConfigSchema = rawConfigSchema.transform((v) => {
   const trimPath = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
   const rootDir = trimPath(v.rootDir);
   const functionsDir = trimPath(v.functionsDir);
-  if (rootDir && functionsDir) {
-    throw new Error("[gencow] Invalid gencow.config: set either `rootDir` or `functionsDir`, not both.");
-  }
   const resolvedRootDir = rootDir ?? functionsDir ?? GENCOW_CONFIG_DEFAULTS.rootDir;
   const envFile = trimPath(v.envFile) ?? `${resolvedRootDir.replace(/[\\/]+$/, "")}/.env`;
   const clientCodegenDir = trimPath(v.codegen?.clientOutDir) ?? trimPath(v.codegen?.outDir) ?? GENCOW_CONFIG_DEFAULTS.codegen.clientOutDir;