@stacksjs/buddy 0.70.258 → 0.70.260

package/dist/commands/migrate.js

@@ -1,501 +1,33 @@
-import { closeSync, existsSync, mkdirSync, openSync, readdirSync, readFileSync, rmSync } from "node:fs";
-import process from "node:process";
-import { confirm, intro, log, onUnknownSubcommand, outro, text } from "@stacksjs/cli";
-import { Action } from "@stacksjs/enums";
-import { hasTTY, isCI } from "@stacksjs/env";
-import { appPath, frameworkPath, frameworkRuntimePath, projectPath } from "@stacksjs/path";
-import { ExitCode } from "@stacksjs/types";
-import { preflightDatabase } from "../database-preflight";
-import { DDL_CONSTRAINT_OVERRIDE_ENV, DIALECT_OVERRIDE_ENV, auditDdlConstraints, auditMigrationCorpus, dialectCapabilities, formatDdlConstraintError, formatMigrationDialectError, stripSqlNoise } from "@stacksjs/database";
-let _runAction;
-async function runAction(...args) {
-  if (!_runAction)
-    _runAction = (await import("@stacksjs/actions")).runAction;
-  return _runAction(...args);
-}
-function acquireMigrationLock() {
-  const lockDir = frameworkRuntimePath(), lockFile = `${lockDir}/migrations.lock`;
-  try {
-    if (!existsSync(lockDir))
-      mkdirSync(lockDir, { recursive: !0 });
-    const fd = openSync(lockFile, "wx");
-    try {
-      closeSync(fd);
-    } catch {}
-    return {
-      acquired: !0,
-      release: () => {
-        try {
-          rmSync(lockFile, { force: !0 });
-        } catch {}
-      }
-    };
-  } catch {
-    return {
-      acquired: !1,
-      release: () => {}
-    };
-  }
-}
-async function ensureDatabaseOrExit() {
-  try {
-    const { ensureDatabaseReady } = await import("@stacksjs/database");
-    await ensureDatabaseReady();
-  } catch (error) {
-    log.syncError(error instanceof Error ? error.message : String(error));
-    process.exit(ExitCode.FatalError);
-  }
-}
-function readMigrateMarker() {
-  const file = frameworkRuntimePath("last-migrate-result.json");
-  if (!existsSync(file))
-    return null;
-  try {
-    const raw = readFileSync(file, "utf8"), parsed = JSON.parse(raw), n = typeof parsed.appliedCount === "number" ? parsed.appliedCount : null;
-    if (n === null || !Number.isFinite(n))
-      return null;
-    return { appliedCount: Math.max(0, Math.floor(n)) };
-  } catch {
-    return null;
-  } finally {
-    try {
-      rmSync(file, { force: !0 });
-    } catch {}
-  }
-}
-function countModelFiles(dir) {
-  if (!existsSync(dir))
-    return 0;
-  let count = 0;
-  const entries = readdirSync(dir, { withFileTypes: !0 });
-  for (const entry of entries)
-    if (entry.isDirectory())
-      count += countModelFiles(`${dir}/${entry.name}`);
-    else if (entry.name.endsWith(".ts") && !entry.name.startsWith(".") && !entry.name.startsWith("index"))
-      count++;
-  return count;
-}
-function validateModelsExist() {
-  const userModelsPath = appPath("Models"), defaultModelsPath = frameworkPath("defaults/app/Models"), userModelCount = countModelFiles(userModelsPath), defaultModelCount = countModelFiles(defaultModelsPath);
-  if (userModelCount === 0 && defaultModelCount === 0)
-    return {
-      valid: !1,
-      error: "No models found. Please create models in app/Models or ensure framework defaults exist."
-    };
-  return { valid: !0 };
-}
-function validateMigrationDialect() {
-  const driver = String(process.env.DB_CONNECTION || "sqlite").toLowerCase(), dir = projectPath("database/migrations");
-  if (process.env[DIALECT_OVERRIDE_ENV] !== "1") {
-    const caps = dialectCapabilities(driver), target = caps.wire === "mysql" ? "mysql" : caps.wire === "postgres" ? "postgres" : "sqlite";
-    if (driver === "sqlite" || driver === "postgres" || caps.wire === "mysql") {
-      const audit = auditMigrationCorpus({ dir, target });
-      if (!audit.empty && audit.incompatible.length > 0)
-        return { valid: !1, error: formatMigrationDialectError(audit, target, "database/migrations") };
-    }
-  }
-  if (process.env[DDL_CONSTRAINT_OVERRIDE_ENV] !== "1") {
-    const constraints = auditDdlConstraints({ dir, dialect: driver });
-    if (!constraints.empty && constraints.violations.length > 0)
-      return { valid: !1, error: formatDdlConstraintError(constraints, driver, "database/migrations") };
-  }
-  return { valid: !0 };
-}
-async function reportMissingForeignKeys() {
-  try {
-    const { auditForeignKeys } = await import("@stacksjs/database"), result = await auditForeignKeys();
-    if (result.missing.length === 0)
-      return;
-    const sample = result.missing.slice(0, 5).map((fk) => `  \u2022 ${fk.fromTable}.${fk.fromColumn} \u2192 ${fk.toTable}.${fk.toColumn} (${fk.model})`).join(`
-`), more = result.missing.length > 5 ? `
-  + ${result.missing.length - 5} more \u2014 run \`./buddy doctor\` for the full list.` : "";
-    log.warn(`${result.missing.length} of ${result.declared.length} declared foreign keys are missing from the live schema:
+import{closeSync,existsSync,mkdirSync,openSync,readdirSync,readFileSync,rmSync}from"node:fs";import process from"node:process";import{confirm,intro,log,onUnknownSubcommand,outro,text}from"@stacksjs/cli";import{Action}from"@stacksjs/enums";import{hasTTY,isCI}from"@stacksjs/env";import{appPath,frameworkPath,frameworkRuntimePath,projectPath}from"@stacksjs/path";import{ExitCode}from"@stacksjs/types";import{preflightDatabase}from"../database-preflight";import{DDL_CONSTRAINT_OVERRIDE_ENV,DIALECT_OVERRIDE_ENV,auditDdlConstraints,auditMigrationCorpus,dialectCapabilities,formatDdlConstraintError,formatMigrationDialectError,stripSqlNoise}from"@stacksjs/database";let _runAction;async function runAction(...args){if(!_runAction)_runAction=(await import("@stacksjs/actions")).runAction;return _runAction(...args)}function acquireMigrationLock(){const lockDir=frameworkRuntimePath(),lockFile=`${lockDir}/migrations.lock`;try{if(!existsSync(lockDir))mkdirSync(lockDir,{recursive:!0});const fd=openSync(lockFile,"wx");try{closeSync(fd)}catch{}return{acquired:!0,release:()=>{try{rmSync(lockFile,{force:!0})}catch{}}}}catch{return{acquired:!1,release:()=>{}}}}async function ensureDatabaseOrExit(){try{const{ensureDatabaseReady}=await import("@stacksjs/database");await ensureDatabaseReady()}catch(error){log.syncError(error instanceof Error?error.message:String(error));process.exit(ExitCode.FatalError)}}function readMigrateMarker(){const file=frameworkRuntimePath("last-migrate-result.json");if(!existsSync(file))return null;try{const raw=readFileSync(file,"utf8"),parsed=JSON.parse(raw),n=typeof parsed.appliedCount==="number"?parsed.appliedCount:null;if(n===null||!Number.isFinite(n))return null;return{appliedCount:Math.max(0,Math.floor(n))}}catch{return null}finally{try{rmSync(file,{force:!0})}catch{}}}function countModelFiles(dir){if(!existsSync(dir))return 0;let count=0;const entries=readdirSync(dir,{withFileTypes:!0});for(const entry of entries)if(entry.isDirectory())count+=countModelFiles(`${dir}/${entry.name}`);else if(entry.name.endsWith(".ts")&&!entry.name.startsWith(".")&&!entry.name.startsWith("index"))count++;return count}function validateModelsExist(){const userModelsPath=appPath("Models"),defaultModelsPath=frameworkPath("defaults/app/Models"),userModelCount=countModelFiles(userModelsPath),defaultModelCount=countModelFiles(defaultModelsPath);if(userModelCount===0&&defaultModelCount===0)return{valid:!1,error:"No models found. Please create models in app/Models or ensure framework defaults exist."};return{valid:!0}}function validateMigrationDialect(){const driver=String(process.env.DB_CONNECTION||"sqlite").toLowerCase(),dir=projectPath("database/migrations");if(process.env[DIALECT_OVERRIDE_ENV]!=="1"){const caps=dialectCapabilities(driver),target=caps.wire==="mysql"?"mysql":caps.wire==="postgres"?"postgres":"sqlite";if(driver==="sqlite"||driver==="postgres"||caps.wire==="mysql"){const audit=auditMigrationCorpus({dir,target});if(!audit.empty&&audit.incompatible.length>0)return{valid:!1,error:formatMigrationDialectError(audit,target,"database/migrations")}}}if(process.env[DDL_CONSTRAINT_OVERRIDE_ENV]!=="1"){const constraints=auditDdlConstraints({dir,dialect:driver});if(!constraints.empty&&constraints.violations.length>0)return{valid:!1,error:formatDdlConstraintError(constraints,driver,"database/migrations")}}return{valid:!0}}async function reportMissingForeignKeys(){try{const{auditForeignKeys}=await import("@stacksjs/database"),result=await auditForeignKeys();if(result.missing.length===0)return;const sample=result.missing.slice(0,5).map((fk)=>`  \u2022 ${fk.fromTable}.${fk.fromColumn} \u2192 ${fk.toTable}.${fk.toColumn} (${fk.model})`).join(`
+`),more=result.missing.length>5?`
+  + ${result.missing.length-5} more \u2014 run \`./buddy doctor\` for the full list.`:"";log.warn(`${result.missing.length} of ${result.declared.length} declared foreign keys are missing from the live schema:
 ${sample}${more}
-` + "The model-backed create migrations may be stale for this database \u2014 run `./buddy migrate:fresh` to regenerate and replay them from the model attributes (this resets data).");
-  } catch (err) {
-    log.debug(`[migrate] FK integrity check skipped: ${err instanceof Error ? err.message : String(err)}`);
-  }
-}
-async function reportFkOrphans() {
-  try {
-    const { findFkOrphans } = await import("@stacksjs/database"), result = await findFkOrphans();
-    if (!result.supported || result.total === 0)
-      return;
-    const sample = result.orphans.slice(0, 5).map((o) => `  \u2022 ${o.table}.${o.column} \u2192 ${o.parent} (${o.count} row${o.count === 1 ? "" : "s"})`).join(`
-`), more = result.orphans.length > 5 ? `
-  + ${result.orphans.length - 5} more \u2014 run \`./buddy doctor\` for the full list.` : "", first = result.orphans[0];
-    log.warn(`${result.total} row${result.total === 1 ? "" : "s"} violate foreign keys (orphaned parents), now that SQLite enforces \`foreign_keys = ON\`:
+`+"The model-backed create migrations may be stale for this database \u2014 run `./buddy migrate:fresh` to regenerate and replay them from the model attributes (this resets data).")}catch(err){log.debug(`[migrate] FK integrity check skipped: ${err instanceof Error?err.message:String(err)}`)}}async function reportFkOrphans(){try{const{findFkOrphans}=await import("@stacksjs/database"),result=await findFkOrphans();if(!result.supported||result.total===0)return;const sample=result.orphans.slice(0,5).map((o)=>`  \u2022 ${o.table}.${o.column} \u2192 ${o.parent} (${o.count} row${o.count===1?"":"s"})`).join(`
+`),more=result.orphans.length>5?`
+  + ${result.orphans.length-5} more \u2014 run \`./buddy doctor\` for the full list.`:"",first=result.orphans[0];log.warn(`${result.total} row${result.total===1?"":"s"} violate foreign keys (orphaned parents), now that SQLite enforces \`foreign_keys = ON\`:
 ${sample}${more}
-` + "These were written under the old `foreign_keys = OFF` default (#1951). Review and clean up manually \u2014 e.g. " + `DELETE FROM ${first.table} WHERE ${first.column} IS NOT NULL AND ${first.column} NOT IN (SELECT id FROM ${first.parent}). migrate never deletes data.`);
-  } catch (err) {
-    log.debug(`[migrate] FK orphan scan skipped: ${err instanceof Error ? err.message : String(err)}`);
-  }
-}
-function describeOp(op) {
-  switch (op.kind) {
-    case "drop_table":
-      return `drop table "${op.table}" (all rows lost)`;
-    case "drop_column":
-      return `drop column "${op.table}"."${op.column}" (column data lost)`;
-    case "modify_column":
-      return `change type of "${op.table}"."${op.column}" (possible data loss)`;
-    case "rebuild_table":
-      return `rebuild table "${op.table}" (type/constraint change)`;
-    case "rename_column":
-      return `rename "${op.table}"."${op.from}" \u2192 "${op.to}"`;
-    case "rename_table":
-      return `rename table "${op.from}" \u2192 "${op.to}"`;
-    default:
-      return `${op.kind} on "${op.table}"${op.column ? `."${op.column}"` : ""}`;
-  }
-}
-async function confirmDestructiveMigrations(opts) {
-  let operations = [];
-  try {
-    const { previewPendingMigrations } = await import("@stacksjs/database");
-    operations = await previewPendingMigrations({ fromDb: opts.fromDb, applyRenames: opts.applyRenames });
-  } catch (error) {
-    log.debug(`Migration preview unavailable: ${error instanceof Error ? error.message : String(error)}`);
-    return !0;
-  }
-  const renames = operations.filter((o) => o.kind === "rename_column" || o.kind === "rename_table");
-  for (const r of renames)
-    log.info(`Detected ${describeOp(r)} \u2014 applying as a rename (data preserved). Use --no-rename to drop + add instead.`);
-  const destructive = operations.filter((o) => o.destructive);
-  if (destructive.length === 0)
-    return !0;
-  log.warn(`This migration includes ${destructive.length} potentially destructive change${destructive.length === 1 ? "" : "s"}:`);
-  for (const op of destructive)
-    log.warn(`  \u2022 ${describeOp(op)}`);
-  if (opts.force)
-    return !0;
-  if (isCI || !hasTTY) {
-    log.error("Refusing to apply destructive changes in a non-interactive environment. Re-run with --force to proceed.");
-    return !1;
-  }
-  return confirm({ message: "Apply these destructive changes?", initial: !1 });
-}
-function parseGuardBool(raw) {
-  if (raw == null || raw === "")
-    return;
-  const v = raw.toLowerCase().trim();
-  if (v === "1" || v === "true" || v === "yes" || v === "on")
-    return !0;
-  if (v === "0" || v === "false" || v === "no" || v === "off")
-    return !1;
-  return;
-}
-function parseFreshGuard(raw) {
-  const v = raw?.toLowerCase().trim();
-  return v === "allow" || v === "confirm" || v === "disabled" ? v : void 0;
-}
-async function resolveMigrationGuards() {
-  const isProd = /^prod/i.test(process.env.APP_ENV || "local");
-  let cfg = {};
-  try {
-    const { awaitConfig } = await import("@stacksjs/config");
-    cfg = (await awaitConfig()).database?.safety ?? {};
-  } catch (error) {
-    log.debug(`[migrate] safety config unavailable, using defaults: ${error instanceof Error ? error.message : String(error)}`);
-  }
-  const confirmMigrate = parseGuardBool(process.env.DB_MIGRATE_CONFIRM) ?? cfg.confirmMigrate ?? !0, migrateFresh = parseFreshGuard(process.env.DB_MIGRATE_FRESH) ?? cfg.migrateFresh ?? (isProd ? "disabled" : "allow");
-  return { confirmMigrate, migrateFresh };
-}
-function currentDatabaseLabel() {
-  if ((process.env.DB_CONNECTION || "sqlite").toLowerCase() === "sqlite")
-    return process.env.DB_DATABASE_PATH || "database/stacks.sqlite";
-  return process.env.DB_DATABASE || "stacks";
-}
-export function migrate(buddy) {
-  const descriptions = {
-    migrate: "Migrates your database",
-    fresh: "Drop all tables and re-run every migration (destroys all data)",
-    project: "Target a specific project",
-    verbose: "Enable verbose output",
-    auth: "Also migrate auth tables (oauth_clients, oauth_access_tokens, oauth_refresh_tokens, password_resets)",
-    force: "Apply destructive changes (drop column/table, lossy type change) without confirmation",
-    fromDb: "Diff against the live database schema instead of the snapshot (self-heal drift)",
-    noRename: "Treat renamed columns as drop + add instead of a data-preserving rename"
-  };
-  buddy.command("migrate", descriptions.migrate).alias("db:migrate").option("-d, --diff", "Show the SQL that would be run", { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("-a, --auth", descriptions.auth, { default: !0 }).option("--no-auth", "Skip auth/oauth table migrations").option("-f, --force", descriptions.force, { default: !1 }).option("--create-database", "Create the database if it does not exist, without asking", { default: !1 }).option("--from-db", descriptions.fromDb, { default: !1 }).option("--no-rename", descriptions.noRename).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    log.debug("Running `buddy migrate` ...", options);
-    const perf = await intro("buddy migrate"), validation = validateModelsExist();
-    if (!validation.valid) {
-      console.error(`
+`+"These were written under the old `foreign_keys = OFF` default (#1951). Review and clean up manually \u2014 e.g. "+`DELETE FROM ${first.table} WHERE ${first.column} IS NOT NULL AND ${first.column} NOT IN (SELECT id FROM ${first.parent}). migrate never deletes data.`)}catch(err){log.debug(`[migrate] FK orphan scan skipped: ${err instanceof Error?err.message:String(err)}`)}}function describeOp(op){switch(op.kind){case"drop_table":return`drop table "${op.table}" (all rows lost)`;case"drop_column":return`drop column "${op.table}"."${op.column}" (column data lost)`;case"modify_column":return`change type of "${op.table}"."${op.column}" (possible data loss)`;case"rebuild_table":return`rebuild table "${op.table}" (type/constraint change)`;case"rename_column":return`rename "${op.table}"."${op.from}" \u2192 "${op.to}"`;case"rename_table":return`rename table "${op.from}" \u2192 "${op.to}"`;default:return`${op.kind} on "${op.table}"${op.column?`."${op.column}"`:""}`}}async function confirmDestructiveMigrations(opts){let operations=[];try{const{previewPendingMigrations}=await import("@stacksjs/database");operations=await previewPendingMigrations({fromDb:opts.fromDb,applyRenames:opts.applyRenames})}catch(error){log.debug(`Migration preview unavailable: ${error instanceof Error?error.message:String(error)}`);return!0}const renames=operations.filter((o)=>o.kind==="rename_column"||o.kind==="rename_table");for(const r of renames)log.info(`Detected ${describeOp(r)} \u2014 applying as a rename (data preserved). Use --no-rename to drop + add instead.`);const destructive=operations.filter((o)=>o.destructive);if(destructive.length===0)return!0;log.warn(`This migration includes ${destructive.length} potentially destructive change${destructive.length===1?"":"s"}:`);for(const op of destructive)log.warn(`  \u2022 ${describeOp(op)}`);if(opts.force)return!0;if(isCI||!hasTTY){log.error("Refusing to apply destructive changes in a non-interactive environment. Re-run with --force to proceed.");return!1}return confirm({message:"Apply these destructive changes?",initial:!1})}function parseGuardBool(raw){if(raw==null||raw==="")return;const v=raw.toLowerCase().trim();if(v==="1"||v==="true"||v==="yes"||v==="on")return!0;if(v==="0"||v==="false"||v==="no"||v==="off")return!1;return}function parseFreshGuard(raw){const v=raw?.toLowerCase().trim();return v==="allow"||v==="confirm"||v==="disabled"?v:void 0}async function resolveMigrationGuards(){const isProd=/^prod/i.test(process.env.APP_ENV||"local");let cfg={};try{const{awaitConfig}=await import("@stacksjs/config");cfg=(await awaitConfig()).database?.safety??{}}catch(error){log.debug(`[migrate] safety config unavailable, using defaults: ${error instanceof Error?error.message:String(error)}`)}const confirmMigrate=parseGuardBool(process.env.DB_MIGRATE_CONFIRM)??cfg.confirmMigrate??!0,migrateFresh=parseFreshGuard(process.env.DB_MIGRATE_FRESH)??cfg.migrateFresh??(isProd?"disabled":"allow");return{confirmMigrate,migrateFresh}}function currentDatabaseLabel(){if((process.env.DB_CONNECTION||"sqlite").toLowerCase()==="sqlite")return process.env.DB_DATABASE_PATH||"database/stacks.sqlite";return process.env.DB_DATABASE||"stacks"}export function migrate(buddy){const descriptions={migrate:"Migrates your database",fresh:"Drop all tables and re-run every migration (destroys all data)",project:"Target a specific project",verbose:"Enable verbose output",auth:"Also migrate auth tables (oauth_clients, oauth_access_tokens, oauth_refresh_tokens, password_resets)",force:"Apply destructive changes (drop column/table, lossy type change) without confirmation",fromDb:"Diff against the live database schema instead of the snapshot (self-heal drift)",noRename:"Treat renamed columns as drop + add instead of a data-preserving rename"};buddy.command("migrate",descriptions.migrate).alias("db:migrate").option("-d, --diff","Show the SQL that would be run",{default:!1}).option("-p, --project [project]",descriptions.project,{default:!1}).option("-a, --auth",descriptions.auth,{default:!0}).option("--no-auth","Skip auth/oauth table migrations").option("-f, --force",descriptions.force,{default:!1}).option("--create-database","Create the database if it does not exist, without asking",{default:!1}).option("--from-db",descriptions.fromDb,{default:!1}).option("--no-rename",descriptions.noRename).option("--verbose",descriptions.verbose,{default:!1}).action(async(options)=>{log.debug("Running `buddy migrate` ...",options);const perf=await intro("buddy migrate"),validation=validateModelsExist();if(!validation.valid){console.error(`
 \u274C Error: ${validation.error}
-`);
-      process.exit(ExitCode.FatalError);
-    }
-    const dialectCheck = validateMigrationDialect();
-    if (!dialectCheck.valid) {
-      console.error(`
+`);process.exit(ExitCode.FatalError)}const dialectCheck=validateMigrationDialect();if(!dialectCheck.valid){console.error(`
 \u274C Error: ${dialectCheck.error}
-`);
-      process.exit(ExitCode.FatalError);
-    }
-    const applyRenames = options.rename === !1 ? !1 : void 0;
-    if (options.fromDb)
-      process.env.STACKS_MIGRATE_FROM_DB = "1";
-    if (applyRenames === !1)
-      process.env.STACKS_MIGRATE_NO_RENAME = "1";
-    if (options.diff) {
-      try {
-        const { previewPendingMigrations } = await import("@stacksjs/database"), ops = await previewPendingMigrations({ fromDb: options.fromDb, applyRenames });
-        if (ops.length === 0)
-          log.info("No pending schema changes \u2014 your models match the database.");
-        else {
-          log.info(`${ops.length} pending change${ops.length === 1 ? "" : "s"}:`);
-          for (const op of ops)
-            log.info(`  \u2022 ${describeOp(op)}${op.destructive ? "  [destructive]" : ""}`);
-        }
-      } catch (error) {
-        await log.error("Failed to preview migrations:", error);
-      }
-      await outro("Diff complete \u2014 no changes applied.", { startTime: perf, useSeconds: !0 });
-      process.exit(ExitCode.Success);
-    }
-    await preflightDatabase({ createDatabase: options.createDatabase, command: "migrate" });
-    if ((await resolveMigrationGuards()).confirmMigrate && !options.force)
-      if (isCI || !hasTTY)
-        log.debug("[migrate] confirmMigrate guard skipped \u2014 non-interactive environment.");
-      else {
-        const APP_ENV = process.env.APP_ENV || "local";
-        await log.flush();
-        if (!await confirm({
-          message: `Run migrations against the ${APP_ENV} database "${currentDatabaseLabel()}"?`,
-          initial: !0
-        })) {
-          await outro("Migration cancelled \u2014 no changes applied.", { startTime: perf, useSeconds: !0 });
-          process.exit(ExitCode.Success);
-        }
-      }
-    await ensureDatabaseOrExit();
-    const lock = acquireMigrationLock();
-    if (!lock.acquired) {
-      log.syncError("Another migration is already running (storage/framework/runtime/migrations.lock exists). Wait for it to finish, or remove the lockfile if it is stale.");
-      process.exit(ExitCode.FatalError);
-    }
-    if (!await confirmDestructiveMigrations({ force: options.force, fromDb: options.fromDb, applyRenames })) {
-      lock.release();
-      await outro("Migration cancelled \u2014 no changes applied.", { startTime: perf, useSeconds: !0 });
-      process.exit(ExitCode.Success);
-    }
-    if (options.auth !== !1) {
-      log.debug("Migrating auth tables...");
-      try {
-        const { migrateAuthTables } = await import("@stacksjs/database"), authResult = await migrateAuthTables({ verbose: options.verbose });
-        if (!authResult.success)
-          log.error(`Failed to migrate auth tables: ${authResult.error}`);
-      } catch (error) {
-        log.error("Failed to migrate auth tables:", error);
-      }
-    }
-    const result = await runAction(Action.Migrate, options).finally(() => lock.release());
-    if (result.isErr)
-      log.error("Model migrations failed \u2014 applying notification/RBAC table guarantees before exiting.");
-    if (options.auth !== !1)
-      try {
-        const { ensureUtcDatetimeColumns, migrateNotificationTables, migrateRbacTables, migrateTraitTables } = await import("@stacksjs/database"), notifResult = await migrateNotificationTables({ verbose: options.verbose });
-        if (!notifResult.success)
-          log.error(`Failed to migrate notification tables: ${notifResult.error}`);
-        const rbacResult = await migrateRbacTables({ verbose: options.verbose });
-        if (!rbacResult.success)
-          log.error(`Failed to migrate RBAC tables: ${rbacResult.error}`);
-        const traitResult = await migrateTraitTables({ verbose: options.verbose });
-        if (!traitResult.success)
-          log.error(`Failed to migrate polymorphic trait tables: ${traitResult.error}`);
-        const datetimeResult = await ensureUtcDatetimeColumns({ verbose: options.verbose });
-        if (!datetimeResult.success)
-          log.error(`Failed to convert TIMESTAMP columns to DATETIME: ${datetimeResult.error}`);
-      } catch (error) {
-        log.error("Failed to migrate notification/RBAC/trait tables:", error);
-      }
-    if (result.isErr) {
-      await outro("While running the migrate command, there was an issue", { startTime: perf, useSeconds: !0 }, result.error);
-      process.exit(ExitCode.FatalError);
-    }
-    if (options.auth !== !1)
-      try {
-        const { ensureUsersAuthColumns, sqlHelpers } = await import("@stacksjs/database"), driver = process.env.DB_CONNECTION || "sqlite";
-        await ensureUsersAuthColumns(sqlHelpers(driver), { verbose: options.verbose });
-      } catch (error) {
-        log.error("Failed to ensure users auth columns post-migration:", error);
-      }
-    try {
-      const { ensureUuidColumns, sqlHelpers } = await import("@stacksjs/database"), driver = process.env.DB_CONNECTION || "sqlite";
-      await ensureUuidColumns(sqlHelpers(driver), { verbose: options.verbose });
-    } catch (error) {
-      log.error("Failed to ensure uuid columns post-migration:", error);
-    }
-    await reportMissingForeignKeys();
-    await reportFkOrphans();
-    const APP_ENV = process.env.APP_ENV || "local", marker = readMigrateMarker(), authSuffix = options.auth !== !1 ? " (including auth tables)" : "", outroMessage = marker == null ? `Migrated your ${APP_ENV} database.${authSuffix}` : marker.appliedCount === 0 ? `Nothing to migrate \u2014 your ${APP_ENV} database is already up to date.${authSuffix}` : `Applied ${marker.appliedCount} migration${marker.appliedCount === 1 ? "" : "s"} to your ${APP_ENV} database.${authSuffix}`;
-    await outro(outroMessage, {
-      startTime: perf,
-      useSeconds: !0
-    });
-    process.exit(ExitCode.Success);
-  });
-  buddy.command("migrate:fresh", descriptions.fresh).alias("db:fresh").option("-d, --diff", "Show the SQL that would be run", { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("-s, --seed", "Run database seeders after migration", { default: !1 }).option("-a, --auth", descriptions.auth, { default: !0 }).option("--no-auth", "Skip auth/oauth table migrations").option("--create-database", "Create the database if it does not exist, without asking", { default: !1 }).option("-f, --force", 'Skip the drop-database confirmation (only honored when the migrateFresh guard is "allow")', { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    log.debug("Running `buddy migrate:fresh` ...", options);
-    const perf = await intro("buddy migrate:fresh"), validation = validateModelsExist();
-    if (!validation.valid) {
-      console.error(`
+`);process.exit(ExitCode.FatalError)}const applyRenames=options.rename===!1?!1:void 0;if(options.fromDb)process.env.STACKS_MIGRATE_FROM_DB="1";if(applyRenames===!1)process.env.STACKS_MIGRATE_NO_RENAME="1";if(options.diff){try{const{previewPendingMigrations}=await import("@stacksjs/database"),ops=await previewPendingMigrations({fromDb:options.fromDb,applyRenames});if(ops.length===0)log.info("No pending schema changes \u2014 your models match the database.");else{log.info(`${ops.length} pending change${ops.length===1?"":"s"}:`);for(const op of ops)log.info(`  \u2022 ${describeOp(op)}${op.destructive?"  [destructive]":""}`)}}catch(error){await log.error("Failed to preview migrations:",error)}await outro("Diff complete \u2014 no changes applied.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}await preflightDatabase({createDatabase:options.createDatabase,command:"migrate"});if((await resolveMigrationGuards()).confirmMigrate&&!options.force)if(isCI||!hasTTY)log.debug("[migrate] confirmMigrate guard skipped \u2014 non-interactive environment.");else{const APP_ENV=process.env.APP_ENV||"local";await log.flush();if(!await confirm({message:`Run migrations against the ${APP_ENV} database "${currentDatabaseLabel()}"?`,initial:!0})){await outro("Migration cancelled \u2014 no changes applied.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}}await ensureDatabaseOrExit();const lock=acquireMigrationLock();if(!lock.acquired){log.syncError("Another migration is already running (storage/framework/runtime/migrations.lock exists). Wait for it to finish, or remove the lockfile if it is stale.");process.exit(ExitCode.FatalError)}if(!await confirmDestructiveMigrations({force:options.force,fromDb:options.fromDb,applyRenames})){lock.release();await outro("Migration cancelled \u2014 no changes applied.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}if(options.auth!==!1){log.debug("Migrating auth tables...");try{const{migrateAuthTables}=await import("@stacksjs/database"),authResult=await migrateAuthTables({verbose:options.verbose});if(!authResult.success)log.error(`Failed to migrate auth tables: ${authResult.error}`)}catch(error){log.error("Failed to migrate auth tables:",error)}}const result=await runAction(Action.Migrate,options).finally(()=>lock.release());if(result.isErr)log.error("Model migrations failed \u2014 applying notification/RBAC table guarantees before exiting.");if(options.auth!==!1)try{const{ensureUtcDatetimeColumns,migrateNotificationTables,migrateRbacTables,migrateTraitTables}=await import("@stacksjs/database"),notifResult=await migrateNotificationTables({verbose:options.verbose});if(!notifResult.success)log.error(`Failed to migrate notification tables: ${notifResult.error}`);const rbacResult=await migrateRbacTables({verbose:options.verbose});if(!rbacResult.success)log.error(`Failed to migrate RBAC tables: ${rbacResult.error}`);const traitResult=await migrateTraitTables({verbose:options.verbose});if(!traitResult.success)log.error(`Failed to migrate polymorphic trait tables: ${traitResult.error}`);const datetimeResult=await ensureUtcDatetimeColumns({verbose:options.verbose});if(!datetimeResult.success)log.error(`Failed to convert TIMESTAMP columns to DATETIME: ${datetimeResult.error}`)}catch(error){log.error("Failed to migrate notification/RBAC/trait tables:",error)}if(result.isErr){await outro("While running the migrate command, there was an issue",{startTime:perf,useSeconds:!0},result.error);process.exit(ExitCode.FatalError)}if(options.auth!==!1)try{const{ensureUsersAuthColumns,sqlHelpers}=await import("@stacksjs/database"),driver=process.env.DB_CONNECTION||"sqlite";await ensureUsersAuthColumns(sqlHelpers(driver),{verbose:options.verbose})}catch(error){log.error("Failed to ensure users auth columns post-migration:",error)}try{const{ensureUuidColumns,sqlHelpers}=await import("@stacksjs/database"),driver=process.env.DB_CONNECTION||"sqlite";await ensureUuidColumns(sqlHelpers(driver),{verbose:options.verbose})}catch(error){log.error("Failed to ensure uuid columns post-migration:",error)}await reportMissingForeignKeys();await reportFkOrphans();const APP_ENV=process.env.APP_ENV||"local",marker=readMigrateMarker(),authSuffix=options.auth!==!1?" (including auth tables)":"",outroMessage=marker==null?`Migrated your ${APP_ENV} database.${authSuffix}`:marker.appliedCount===0?`Nothing to migrate \u2014 your ${APP_ENV} database is already up to date.${authSuffix}`:`Applied ${marker.appliedCount} migration${marker.appliedCount===1?"":"s"} to your ${APP_ENV} database.${authSuffix}`;await outro(outroMessage,{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)});buddy.command("migrate:fresh",descriptions.fresh).alias("db:fresh").option("-d, --diff","Show the SQL that would be run",{default:!1}).option("-p, --project [project]",descriptions.project,{default:!1}).option("-s, --seed","Run database seeders after migration",{default:!1}).option("-a, --auth",descriptions.auth,{default:!0}).option("--no-auth","Skip auth/oauth table migrations").option("--create-database","Create the database if it does not exist, without asking",{default:!1}).option("-f, --force",'Skip the drop-database confirmation (only honored when the migrateFresh guard is "allow")',{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(options)=>{log.debug("Running `buddy migrate:fresh` ...",options);const perf=await intro("buddy migrate:fresh"),validation=validateModelsExist();if(!validation.valid){console.error(`
 \u274C Error: ${validation.error}
-`);
-      process.exit(ExitCode.FatalError);
-    }
-    const dialectCheck = validateMigrationDialect();
-    if (!dialectCheck.valid) {
-      console.error(`
+`);process.exit(ExitCode.FatalError)}const dialectCheck=validateMigrationDialect();if(!dialectCheck.valid){console.error(`
 \u274C Error: ${dialectCheck.error}
-`);
-      process.exit(ExitCode.FatalError);
-    }
-    const guards = await resolveMigrationGuards(), dbLabel = currentDatabaseLabel(), APP_ENV = process.env.APP_ENV || "local";
-    if (guards.migrateFresh === "disabled") {
-      await log.error(`\`buddy migrate:fresh\` is disabled by your migration safety guards (it DROPS every table).
+`);process.exit(ExitCode.FatalError)}const guards=await resolveMigrationGuards(),dbLabel=currentDatabaseLabel(),APP_ENV=process.env.APP_ENV||"local";if(guards.migrateFresh==="disabled"){await log.error(`\`buddy migrate:fresh\` is disabled by your migration safety guards (it DROPS every table).
   Target: ${APP_ENV} database "${dbLabel}"
   To allow it, set database.safety.migrateFresh to 'allow' in config/database.ts,
-  or run once with: DB_MIGRATE_FRESH=allow ./buddy migrate:fresh`);
-      await outro('migrate:fresh refused \u2014 the migrateFresh guard is set to "disabled".', { startTime: perf, useSeconds: !0 });
-      process.exit(ExitCode.FatalError);
-    }
-    if (!(guards.migrateFresh === "allow" && options.force === !0)) {
-      if (isCI || !hasTTY) {
-        const hint = guards.migrateFresh === "confirm" ? 'Guard is "confirm": migrate:fresh must be run interactively.' : "Re-run with --force to drop the database non-interactively.";
-        await log.error(`Refusing to drop the ${APP_ENV} database "${dbLabel}" in a non-interactive environment. ${hint}`);
-        await outro("migrate:fresh cancelled.", { startTime: perf, useSeconds: !0 });
-        process.exit(ExitCode.FatalError);
-      }
-      log.warn(`This will DROP ALL TABLES in the ${APP_ENV} database "${dbLabel}" and rebuild them from scratch. All data will be lost.`);
-      await log.flush();
-      if ((await text({ message: `Type the database name "${dbLabel}" to confirm (blank to cancel):` })).trim() !== dbLabel) {
-        await outro("migrate:fresh cancelled \u2014 confirmation did not match.", { startTime: perf, useSeconds: !0 });
-        process.exit(ExitCode.Success);
-      }
-    }
-    await preflightDatabase({ createDatabase: options.createDatabase, command: "migrate:fresh" });
-    await ensureDatabaseOrExit();
-    const result = await runAction(Action.MigrateFresh, options);
-    if (result.isErr)
-      log.error("Model migrations failed \u2014 applying auth/notification/RBAC table guarantees before exiting.");
-    if (options.auth !== !1) {
-      log.debug("Migrating auth tables...");
-      try {
-        const { migrateAuthTables, migrateNotificationTables, migrateRbacTables, migrateTraitTables } = await import("@stacksjs/database"), authResult = await migrateAuthTables({ verbose: options.verbose });
-        if (!authResult.success)
-          log.error(`Failed to migrate auth tables: ${authResult.error}`);
-        const notifResult = await migrateNotificationTables({ verbose: options.verbose });
-        if (!notifResult.success)
-          log.error(`Failed to migrate notification tables: ${notifResult.error}`);
-        const rbacResult = await migrateRbacTables({ verbose: options.verbose });
-        if (!rbacResult.success)
-          log.error(`Failed to migrate RBAC tables: ${rbacResult.error}`);
-        const traitResult = await migrateTraitTables({ verbose: options.verbose });
-        if (!traitResult.success)
-          log.error(`Failed to migrate polymorphic trait tables: ${traitResult.error}`);
-      } catch (error) {
-        log.error("Failed to migrate auth/notification/RBAC/trait tables:", error);
-      }
-    }
-    try {
-      const { ensureUuidColumns, sqlHelpers } = await import("@stacksjs/database"), driver = process.env.DB_CONNECTION || "sqlite";
-      await ensureUuidColumns(sqlHelpers(driver), { verbose: options.verbose });
-    } catch (error) {
-      log.error("Failed to ensure uuid columns post-migration:", error);
-    }
-    if (result.isErr) {
-      await outro("While running the migrate:fresh command, there was an issue", { startTime: perf, useSeconds: !0 }, result.error);
-      process.exit(ExitCode.FatalError);
-    }
-    await reportMissingForeignKeys();
-    if (options.seed) {
-      log.info("Running database seeders...");
-      try {
-        const { seed } = await import("@stacksjs/database"), seedResult = await seed({ verbose: options.verbose, fresh: !0 });
-        if (seedResult.failed > 0) {
-          log.warn(`Seeding completed with ${seedResult.failed} failure(s)`);
-          for (const r of seedResult.results)
-            if (!r.success)
-              log.error(`  - ${r.model}: ${r.error}`);
-        } else
-          log.success(`Seeded ${seedResult.successful} model(s)`);
-      } catch (error) {
-        log.error("Failed to run seeders:", error);
-      }
-    }
-    const parts = [];
-    if (options.auth !== !1)
-      parts.push("auth tables");
-    if (options.seed)
-      parts.push("seeded");
-    const suffix = parts.length > 0 ? ` & ${parts.join(" & ")}` : "", marker = readMigrateMarker(), countPhrase = marker == null ? "" : marker.appliedCount === 0 ? " (0 applied \u2014 no migration files found?)" : ` (${marker.appliedCount} migration${marker.appliedCount === 1 ? "" : "s"} applied)`;
-    await outro(`All tables dropped successfully & migrated successfully${countPhrase}${suffix}`, {
-      startTime: perf,
-      useSeconds: !0
-    });
-    process.exit(ExitCode.Success);
-  });
-  buddy.command("migrate:dns", descriptions.migrate).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    log.debug("Running `buddy migrate:dns` ...", options);
-    const perf = await intro("buddy migrate:dns"), result = await runAction(Action.MigrateDns, { ...options });
-    if (result.isErr) {
-      await outro("While running the migrate:dns command, there was an issue", { startTime: perf, useSeconds: !0 }, result.error);
-      process.exit(ExitCode.FatalError);
-    }
-    const APP_URL = process.env.APP_URL || "undefined";
-    await outro(`Migrated your ${APP_URL} DNS.`, {
-      startTime: perf,
-      useSeconds: !0
-    });
-    process.exit(ExitCode.Success);
-  });
-  buddy.command("migrate:switch <driver>", "Pre-flight check + plan for switching DB_CONNECTION between sqlite / mysql / postgres").action(async (driver) => {
-    log.debug(`Running \`buddy migrate:switch ${driver}\` ...`);
-    const perf = await intro("buddy migrate:switch"), target = driver.toLowerCase();
-    if (!new Set(["sqlite", "mysql", "postgres"]).has(target)) {
-      console.log(`
+  or run once with: DB_MIGRATE_FRESH=allow ./buddy migrate:fresh`);await outro('migrate:fresh refused \u2014 the migrateFresh guard is set to "disabled".',{startTime:perf,useSeconds:!0});process.exit(ExitCode.FatalError)}if(!(guards.migrateFresh==="allow"&&options.force===!0)){if(isCI||!hasTTY){const hint=guards.migrateFresh==="confirm"?'Guard is "confirm": migrate:fresh must be run interactively.':"Re-run with --force to drop the database non-interactively.";await log.error(`Refusing to drop the ${APP_ENV} database "${dbLabel}" in a non-interactive environment. ${hint}`);await outro("migrate:fresh cancelled.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.FatalError)}log.warn(`This will DROP ALL TABLES in the ${APP_ENV} database "${dbLabel}" and rebuild them from scratch. All data will be lost.`);await log.flush();if((await text({message:`Type the database name "${dbLabel}" to confirm (blank to cancel):`})).trim()!==dbLabel){await outro("migrate:fresh cancelled \u2014 confirmation did not match.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}}await preflightDatabase({createDatabase:options.createDatabase,command:"migrate:fresh"});await ensureDatabaseOrExit();const result=await runAction(Action.MigrateFresh,options);if(result.isErr)log.error("Model migrations failed \u2014 applying auth/notification/RBAC table guarantees before exiting.");if(options.auth!==!1){log.debug("Migrating auth tables...");try{const{migrateAuthTables,migrateNotificationTables,migrateRbacTables,migrateTraitTables}=await import("@stacksjs/database"),authResult=await migrateAuthTables({verbose:options.verbose});if(!authResult.success)log.error(`Failed to migrate auth tables: ${authResult.error}`);const notifResult=await migrateNotificationTables({verbose:options.verbose});if(!notifResult.success)log.error(`Failed to migrate notification tables: ${notifResult.error}`);const rbacResult=await migrateRbacTables({verbose:options.verbose});if(!rbacResult.success)log.error(`Failed to migrate RBAC tables: ${rbacResult.error}`);const traitResult=await migrateTraitTables({verbose:options.verbose});if(!traitResult.success)log.error(`Failed to migrate polymorphic trait tables: ${traitResult.error}`)}catch(error){log.error("Failed to migrate auth/notification/RBAC/trait tables:",error)}}try{const{ensureUuidColumns,sqlHelpers}=await import("@stacksjs/database"),driver=process.env.DB_CONNECTION||"sqlite";await ensureUuidColumns(sqlHelpers(driver),{verbose:options.verbose})}catch(error){log.error("Failed to ensure uuid columns post-migration:",error)}if(result.isErr){await outro("While running the migrate:fresh command, there was an issue",{startTime:perf,useSeconds:!0},result.error);process.exit(ExitCode.FatalError)}await reportMissingForeignKeys();if(options.seed){log.info("Running database seeders...");try{const{seed}=await import("@stacksjs/database"),seedResult=await seed({verbose:options.verbose,fresh:!0});if(seedResult.failed>0){log.warn(`Seeding completed with ${seedResult.failed} failure(s)`);for(const r of seedResult.results)if(!r.success)log.error(`  - ${r.model}: ${r.error}`)}else log.success(`Seeded ${seedResult.successful} model(s)`)}catch(error){log.error("Failed to run seeders:",error)}}const parts=[];if(options.auth!==!1)parts.push("auth tables");if(options.seed)parts.push("seeded");const suffix=parts.length>0?` & ${parts.join(" & ")}`:"",marker=readMigrateMarker(),countPhrase=marker==null?"":marker.appliedCount===0?" (0 applied \u2014 no migration files found?)":` (${marker.appliedCount} migration${marker.appliedCount===1?"":"s"} applied)`;await outro(`All tables dropped successfully & migrated successfully${countPhrase}${suffix}`,{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)});buddy.command("migrate:dns",descriptions.migrate).option("-p, --project [project]",descriptions.project,{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(options)=>{log.debug("Running `buddy migrate:dns` ...",options);const perf=await intro("buddy migrate:dns"),result=await runAction(Action.MigrateDns,{...options});if(result.isErr){await outro("While running the migrate:dns command, there was an issue",{startTime:perf,useSeconds:!0},result.error);process.exit(ExitCode.FatalError)}const APP_URL=process.env.APP_URL||"undefined";await outro(`Migrated your ${APP_URL} DNS.`,{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)});buddy.command("migrate:switch <driver>","Pre-flight check + plan for switching DB_CONNECTION between sqlite / mysql / postgres").action(async(driver)=>{log.debug(`Running \`buddy migrate:switch ${driver}\` ...`);const perf=await intro("buddy migrate:switch"),target=driver.toLowerCase();if(!new Set(["sqlite","mysql","postgres"]).has(target)){console.log(`
   Unknown target driver "${driver}". Allowed: sqlite, mysql, postgres.
-`);
-      await outro("Aborted.", { startTime: perf, useSeconds: !0 });
-      process.exit(ExitCode.FatalError);
-    }
-    const current = (process.env.DB_CONNECTION || "sqlite").toLowerCase();
-    if (current === target) {
-      console.log(`
+`);await outro("Aborted.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.FatalError)}const current=(process.env.DB_CONNECTION||"sqlite").toLowerCase();if(current===target){console.log(`
   DB_CONNECTION is already "${target}". Nothing to switch.
-`);
-      await outro("No-op.", { startTime: perf, useSeconds: !0 });
-      process.exit(ExitCode.Success);
-    }
-    const missingEnv = ({
-      sqlite: ["DB_DATABASE"],
-      mysql: ["DB_HOST", "DB_PORT", "DB_USERNAME", "DB_PASSWORD", "DB_DATABASE"],
-      postgres: ["DB_HOST", "DB_PORT", "DB_USERNAME", "DB_PASSWORD", "DB_DATABASE"]
-    }[target] ?? []).filter((k) => !process.env[k]);
-    let alterCount = 0, uniqueIdxCount = 0;
-    try {
-      const migrationsDir = projectPath("database/migrations");
-      if (existsSync(migrationsDir)) {
-        const files = readdirSync(migrationsDir).filter((f) => f.endsWith(".sql"));
-        for (const f of files) {
-          const content = stripSqlNoise(readFileSync(`${migrationsDir}/${f}`, "utf-8")).toLowerCase();
-          if (/alter\s+table[\s\S]*add\s+constraint/.test(content))
-            alterCount++;
-          if (/^\s*create\s+unique\s+index/m.test(content))
-            uniqueIdxCount++;
-        }
-      }
-    } catch {}
-    const switchAudit = auditMigrationCorpus({ dir: projectPath("database/migrations"), target }), switchBlocked = switchAudit.incompatible.length > 0, blockedFiles = new Set(switchAudit.incompatible.map((m) => m.file)).size, dialectNote = switchBlocked ? `
-  \u26D4 ${blockedFiles} of ${switchAudit.total} migration files are ${switchAudit.inferred ?? "another dialect"}-flavoured and will NOT run on ${target}.
-     Regenerate them against ${target} before migrating, or this switch will fail on the first file.` : "", sqliteFkNote = current === "sqlite" && alterCount > 0 ? `
-    (These were skipped on SQLite per stacksjs/stacks#1916 and survive on disk for replay.)` : "", boolNote = current === "sqlite" && (target === "postgres" || target === "mysql") ? `
-  \u2022 Booleans land as 0/1 on SQLite; ${target} stores them as ${target === "postgres" ? "true/false" : "0/1 (compatible)"}.` : "", tzNote = target === "postgres" ? `
-  \u2022 PostgreSQL uses timestamptz (with TZ) where SQLite/MySQL store plain TIMESTAMP. Existing rows do NOT auto-upgrade \u2014 they ride the column's stored type.` : "", envExtras = target !== "sqlite" ? ", plus DB_HOST / DB_PORT / DB_USERNAME / DB_PASSWORD / DB_DATABASE" : "", missingNote = missingEnv.length > 0 ? `
-  \u26A0 Missing env vars for ${target}: ${missingEnv.join(", ")}` : "";
-    console.log(`
+`);await outro("No-op.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}const missingEnv=({sqlite:["DB_DATABASE"],mysql:["DB_HOST","DB_PORT","DB_USERNAME","DB_PASSWORD","DB_DATABASE"],postgres:["DB_HOST","DB_PORT","DB_USERNAME","DB_PASSWORD","DB_DATABASE"]}[target]??[]).filter((k)=>!process.env[k]);let alterCount=0,uniqueIdxCount=0;try{const migrationsDir=projectPath("database/migrations");if(existsSync(migrationsDir)){const files=readdirSync(migrationsDir).filter((f)=>f.endsWith(".sql"));for(const f of files){const content=stripSqlNoise(readFileSync(`${migrationsDir}/${f}`,"utf-8")).toLowerCase();if(/alter\s+table[\s\S]*add\s+constraint/.test(content))alterCount++;if(/^\s*create\s+unique\s+index/m.test(content))uniqueIdxCount++}}}catch{}const switchAudit=auditMigrationCorpus({dir:projectPath("database/migrations"),target}),switchBlocked=switchAudit.incompatible.length>0,blockedFiles=new Set(switchAudit.incompatible.map((m)=>m.file)).size,dialectNote=switchBlocked?`
+  \u26D4 ${blockedFiles} of ${switchAudit.total} migration files are ${switchAudit.inferred??"another dialect"}-flavoured and will NOT run on ${target}.
+     Regenerate them against ${target} before migrating, or this switch will fail on the first file.`:"",sqliteFkNote=current==="sqlite"&&alterCount>0?`
+    (These were skipped on SQLite per stacksjs/stacks#1916 and survive on disk for replay.)`:"",boolNote=current==="sqlite"&&(target==="postgres"||target==="mysql")?`
+  \u2022 Booleans land as 0/1 on SQLite; ${target} stores them as ${target==="postgres"?"true/false":"0/1 (compatible)"}.`:"",tzNote=target==="postgres"?`
+  \u2022 PostgreSQL uses timestamptz (with TZ) where SQLite/MySQL store plain TIMESTAMP. Existing rows do NOT auto-upgrade \u2014 they ride the column's stored type.`:"",envExtras=target!=="sqlite"?", plus DB_HOST / DB_PORT / DB_USERNAME / DB_PASSWORD / DB_DATABASE":"",missingNote=missingEnv.length>0?`
+  \u26A0 Missing env vars for ${target}: ${missingEnv.join(", ")}`:"";console.log(`
   Switch plan: ${current} \u2192 ${target}
   \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
   \u2022 ${alterCount} ALTER TABLE ADD CONSTRAINT migration(s) will be applied against ${target}.${sqliteFkNote}
@@ -507,42 +39,9 @@ export function migrate(buddy) {
   Next steps:
     1. Update .env:  DB_CONNECTION=${target}${envExtras}
     2. (Optional) Export data from the current ${current} database.
-    3. ${switchBlocked ? `Regenerate the migration files for ${target} FIRST \u2014 \`./buddy migrate\` will refuse until then.` : "Run `./buddy migrate` (or `migrate:fresh` to start clean)."}
+    3. ${switchBlocked?`Regenerate the migration files for ${target} FIRST \u2014 \`./buddy migrate\` will refuse until then.`:"Run `./buddy migrate` (or `migrate:fresh` to start clean)."}
     4. The post-migrate FK audit will report any constraints that didn't replay.
-`);
-    await outro("Plan rendered. Re-run after updating .env to actually switch.", {
-      startTime: perf,
-      useSeconds: !0
-    });
-    process.exit(ExitCode.Success);
-  });
-  buddy.command("migrate:regenerate [dialect]", "Rebuild database/migrations from your models for a given dialect").option("--dry-run", "Show what would change without writing anything", { default: !1 }).option("-f, --force", "Regenerate even though the database already has migrations recorded", { default: !1 }).action(async (dialect, options) => {
-    const perf = await intro("buddy migrate:regenerate"), target = (dialect || process.env.DB_CONNECTION || "sqlite").toLowerCase();
-    if (!new Set(["sqlite", "mysql", "postgres", "singlestore"]).has(target)) {
-      log.syncError(`Unknown dialect "${target}". Allowed: sqlite, mysql, postgres, singlestore.`);
-      process.exit(ExitCode.FatalError);
-    }
-    const { countAppliedMigrations, regenerateMigrationCorpus } = await import("@stacksjs/database");
-    let applied = 0;
-    try {
-      applied = await countAppliedMigrations();
-    } catch {
-      applied = 0;
-    }
-    if (applied > 0 && !options.force && !options.dryRun) {
-      log.syncError(`This database already has ${applied} migration(s) recorded.`);
-      log.syncError("Regenerating renumbers every file, and the migrations table keys on the filename,");
-      log.syncError("so already-applied migrations would look pending and run a second time.");
-      log.syncError("  Point at an empty database, or re-run with --force if you know it is safe.");
-      process.exit(ExitCode.FatalError);
-    }
-    const plan = await regenerateMigrationCorpus({ dialect: target, dryRun: !0 });
-    if (plan.isErr) {
-      log.syncError(plan.error.message);
-      process.exit(ExitCode.FatalError);
-    }
-    const { files, removed, models } = plan.value;
-    console.log(`
+`);await outro("Plan rendered. Re-run after updating .env to actually switch.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)});buddy.command("migrate:regenerate [dialect]","Rebuild database/migrations from your models for a given dialect").option("--dry-run","Show what would change without writing anything",{default:!1}).option("-f, --force","Regenerate even though the database already has migrations recorded",{default:!1}).action(async(dialect,options)=>{const perf=await intro("buddy migrate:regenerate"),target=(dialect||process.env.DB_CONNECTION||"sqlite").toLowerCase();if(!new Set(["sqlite","mysql","postgres","singlestore"]).has(target)){log.syncError(`Unknown dialect "${target}". Allowed: sqlite, mysql, postgres, singlestore.`);process.exit(ExitCode.FatalError)}const{countAppliedMigrations,regenerateMigrationCorpus}=await import("@stacksjs/database");let applied=0;try{applied=await countAppliedMigrations()}catch{applied=0}if(applied>0&&!options.force&&!options.dryRun){log.syncError(`This database already has ${applied} migration(s) recorded.`);log.syncError("Regenerating renumbers every file, and the migrations table keys on the filename,");log.syncError("so already-applied migrations would look pending and run a second time.");log.syncError("  Point at an empty database, or re-run with --force if you know it is safe.");process.exit(ExitCode.FatalError)}const plan=await regenerateMigrationCorpus({dialect:target,dryRun:!0});if(plan.isErr){log.syncError(plan.error.message);process.exit(ExitCode.FatalError)}const{files,removed,models}=plan.value;console.log(`
   Regenerate plan: ${target}
   \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
   \u2022 ${models} model(s) read from app/Models and the framework defaults
@@ -550,108 +49,11 @@ export function migrate(buddy) {
   \u2022 ${removed.length} existing file(s) will be removed
   \u2022 These files are tracked in git, so review with \`git diff\` afterwards
   \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-`);
-    if (options.dryRun) {
-      await outro("Dry run. Nothing was written.", { startTime: perf, useSeconds: !0 });
-      process.exit(ExitCode.Success);
-    }
-    if (!isCI && hasTTY && process.stdin.isTTY) {
-      await log.flush();
-      if (!await confirm({ message: `Replace ${removed.length} migration file(s) with ${files.length} generated for ${target}?`, initial: !1 })) {
-        await outro("Cancelled. Nothing was written.", { startTime: perf, useSeconds: !0 });
-        process.exit(ExitCode.Success);
-      }
-    }
-    const result = await regenerateMigrationCorpus({ dialect: target });
-    if (result.isErr) {
-      log.syncError(result.error.message);
-      process.exit(ExitCode.FatalError);
-    }
-    log.success(`Wrote ${result.value.files.length} ${target} migration file(s) to database/migrations.`);
-    if (applied > 0) {
-      const { reconcileMigrationLedger } = await import("@stacksjs/database"), fixed = await reconcileMigrationLedger();
-      if (fixed.remapped.length > 0)
-        log.info(`Repointed ${fixed.remapped.length} ledger row(s) at their renumbered file.`);
-      if (fixed.recorded.length > 0)
-        log.info(`Recorded ${fixed.recorded.length} migration(s) already present in the schema.`);
-      if (fixed.skipped.length > 0)
-        log.warn(`${fixed.skipped.length} ledger entr(ies) need a look \u2014 run \`./buddy migrate:status\`.`);
-    }
-    log.info("Review the change with `git diff`, then run `./buddy migrate`.");
-    await outro("Regenerated.", { startTime: perf, useSeconds: !0 });
-    process.exit(ExitCode.Success);
-  });
-  buddy.command("migrate:status", "Compare database/migrations, the migrations ledger, and the live schema").option("--reconcile", "Repair the ledger where the schema proves what happened", { default: !1 }).option("--include-partial", "With --reconcile, also record half-applied migrations", { default: !1 }).option("--json", "Emit the audit as JSON", { default: !1 }).action(async (options) => {
-    const perf = options.json ? void 0 : await intro("buddy migrate:status"), { auditMigrationLedger, reconcileMigrationLedger } = await import("@stacksjs/database"), audit = await auditMigrationLedger();
-    if (options.json) {
-      console.log(JSON.stringify(audit, (_k, v) => v instanceof Set ? [...v] : v, 2));
-      process.exit(audit.drift ? ExitCode.FatalError : ExitCode.Success);
-    }
-    if (!audit.supported) {
-      log.info(`Dialect "${audit.dialect}" is not audited. Nothing to compare.`);
-      await outro("Skipped.", { startTime: perf, useSeconds: !0 });
-      process.exit(ExitCode.Success);
-    }
-    const { counts, entries, orphans } = audit, list = (status) => entries.filter((e) => e.status === status).map((e) => e.file), report = [], section = (heading, files) => {
-      if (files.length === 0)
-        return;
-      if (heading)
-        report.push(`  ${heading}`);
-      for (const file of files.slice(0, 8))
-        report.push(`      ${file}`);
-      if (files.length > 8)
-        report.push(`      \u2026 +${files.length - 8} more`);
-      report.push("");
-    };
-    report.push("");
-    report.push(`  Migration status: ${audit.dialect}`);
-    report.push("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-    report.push(`  ${entries.length} file(s) on disk \xB7 ${audit.recordedCount} recorded in the ledger`);
-    report.push("");
-    if (counts.applied > 0)
-      report.push(`  ${counts.applied} applied - recorded, and present in the schema.`, "");
-    if (counts.unverifiable > 0)
-      report.push(`  ${counts.unverifiable} unverifiable - data migrations with no schema trace to check.`, "");
-    section(`${counts.pending} pending - not applied yet, will run on the next \`buddy migrate\`:`, list("pending"));
-    if (counts.stranded > 0) {
-      report.push(`  ${counts.stranded} STRANDED - already applied to the schema, but missing from the ledger.`);
-      report.push("  These re-run on the next `buddy migrate`, which is unsafe for anything not idempotent.");
-      section("", list("stranded"));
-    }
-    section(`${counts.partial} PARTIAL - some effects present, some missing. Needs a human:`, list("partial"));
-    section(`${counts.reverted} REVERTED - recorded as applied, but the effects are gone from the schema:`, list("reverted"));
-    if (orphans.length > 0)
-      section(`${orphans.length} orphaned ledger row(s) - recorded, but no such file on disk:`, orphans.map((o) => `${o.migration}${o.renamedTo ? `  -> renumbered to ${o.renamedTo}` : "  (no counterpart; migration deleted?)"}`));
-    console.log(report.join(`
-`));
-    if (!audit.drift) {
-      await outro("Ledger matches the corpus and the schema.", { startTime: perf, useSeconds: !0 });
-      process.exit(ExitCode.Success);
-    }
-    if (!options.reconcile) {
-      console.log(`
+`);if(options.dryRun){await outro("Dry run. Nothing was written.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}if(!isCI&&hasTTY&&process.stdin.isTTY){await log.flush();if(!await confirm({message:`Replace ${removed.length} migration file(s) with ${files.length} generated for ${target}?`,initial:!1})){await outro("Cancelled. Nothing was written.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}}const result=await regenerateMigrationCorpus({dialect:target});if(result.isErr){log.syncError(result.error.message);process.exit(ExitCode.FatalError)}log.success(`Wrote ${result.value.files.length} ${target} migration file(s) to database/migrations.`);if(applied>0){const{reconcileMigrationLedger}=await import("@stacksjs/database"),fixed=await reconcileMigrationLedger();if(fixed.remapped.length>0)log.info(`Repointed ${fixed.remapped.length} ledger row(s) at their renumbered file.`);if(fixed.recorded.length>0)log.info(`Recorded ${fixed.recorded.length} migration(s) already present in the schema.`);if(fixed.skipped.length>0)log.warn(`${fixed.skipped.length} ledger entr(ies) need a look \u2014 run \`./buddy migrate:status\`.`)}log.info("Review the change with `git diff`, then run `./buddy migrate`.");await outro("Regenerated.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)});buddy.command("migrate:status","Compare database/migrations, the migrations ledger, and the live schema").option("--reconcile","Repair the ledger where the schema proves what happened",{default:!1}).option("--include-partial","With --reconcile, also record half-applied migrations",{default:!1}).option("--json","Emit the audit as JSON",{default:!1}).action(async(options)=>{const perf=options.json?void 0:await intro("buddy migrate:status"),{auditMigrationLedger,reconcileMigrationLedger}=await import("@stacksjs/database"),audit=await auditMigrationLedger();if(options.json){console.log(JSON.stringify(audit,(_k,v)=>v instanceof Set?[...v]:v,2));process.exit(audit.drift?ExitCode.FatalError:ExitCode.Success)}if(!audit.supported){log.info(`Dialect "${audit.dialect}" is not audited. Nothing to compare.`);await outro("Skipped.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}const{counts,entries,orphans}=audit,list=(status)=>entries.filter((e)=>e.status===status).map((e)=>e.file),report=[],section=(heading,files)=>{if(files.length===0)return;if(heading)report.push(`  ${heading}`);for(const file of files.slice(0,8))report.push(`      ${file}`);if(files.length>8)report.push(`      \u2026 +${files.length-8} more`);report.push("")};report.push("");report.push(`  Migration status: ${audit.dialect}`);report.push("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");report.push(`  ${entries.length} file(s) on disk \xB7 ${audit.recordedCount} recorded in the ledger`);report.push("");if(counts.applied>0)report.push(`  ${counts.applied} applied - recorded, and present in the schema.`,"");if(counts.unverifiable>0)report.push(`  ${counts.unverifiable} unverifiable - data migrations with no schema trace to check.`,"");section(`${counts.pending} pending - not applied yet, will run on the next \`buddy migrate\`:`,list("pending"));if(counts.stranded>0){report.push(`  ${counts.stranded} STRANDED - already applied to the schema, but missing from the ledger.`);report.push("  These re-run on the next `buddy migrate`, which is unsafe for anything not idempotent.");section("",list("stranded"))}section(`${counts.partial} PARTIAL - some effects present, some missing. Needs a human:`,list("partial"));section(`${counts.reverted} REVERTED - recorded as applied, but the effects are gone from the schema:`,list("reverted"));if(orphans.length>0)section(`${orphans.length} orphaned ledger row(s) - recorded, but no such file on disk:`,orphans.map((o)=>`${o.migration}${o.renamedTo?`  -> renumbered to ${o.renamedTo}`:"  (no counterpart; migration deleted?)"}`));console.log(report.join(`
+`));if(!audit.drift){await outro("Ledger matches the corpus and the schema.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}if(!options.reconcile){console.log(`
   Repair with:  ./buddy migrate:status --reconcile
   That repoints renumbered ledger rows and records migrations the schema
   already proves. It never runs SQL from a migration file.
-`);
-      await outro("Drift detected.", { startTime: perf, useSeconds: !0 });
-      process.exit(ExitCode.FatalError);
-    }
-    const fixed = await reconcileMigrationLedger({ includePartial: options.includePartial });
-    if (fixed.remapped.length > 0)
-      log.success(`Repointed ${fixed.remapped.length} ledger row(s) at their renumbered file.`);
-    if (fixed.recorded.length > 0)
-      log.success(`Recorded ${fixed.recorded.length} migration(s) the schema already reflects.`);
-    if (fixed.skipped.length > 0) {
-      log.warn(`Left ${fixed.skipped.length} entr(ies) alone:`);
-      console.log(fixed.skipped.slice(0, 8).map((s) => `      ${s.file} \u2014 ${s.reason}`).join(`
-`) + (fixed.skipped.length > 8 ? `
-      \u2026 +${fixed.skipped.length - 8} more` : ""));
-    }
-    if (fixed.remapped.length === 0 && fixed.recorded.length === 0)
-      log.info("Nothing could be repaired automatically.");
-    await outro("Reconciled.", { startTime: perf, useSeconds: !0 });
-    process.exit(ExitCode.Success);
-  });
-  onUnknownSubcommand(buddy, "migrate");
-}
+`);await outro("Drift detected.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.FatalError)}const fixed=await reconcileMigrationLedger({includePartial:options.includePartial});if(fixed.remapped.length>0)log.success(`Repointed ${fixed.remapped.length} ledger row(s) at their renumbered file.`);if(fixed.recorded.length>0)log.success(`Recorded ${fixed.recorded.length} migration(s) the schema already reflects.`);if(fixed.skipped.length>0){log.warn(`Left ${fixed.skipped.length} entr(ies) alone:`);console.log(fixed.skipped.slice(0,8).map((s)=>`      ${s.file} \u2014 ${s.reason}`).join(`
+`)+(fixed.skipped.length>8?`
+      \u2026 +${fixed.skipped.length-8} more`:""))}if(fixed.remapped.length===0&&fixed.recorded.length===0)log.info("Nothing could be repaired automatically.");await outro("Reconciled.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)});onUnknownSubcommand(buddy,"migrate")}