turbine-orm 0.39.0 → 0.40.0

package/dist/cjs/cli/index.js

@@ -7,7 +7,7 @@
  *   turbine init                  — Initialize a Turbine project
  *   turbine generate | pull       — Introspect database and generate TypeScript types
  *   turbine push                  - Apply schema-builder definitions to database (destructive ops gated)
- *   turbine migrate create <name> - Create a new SQL migration file (--auto | --recipe <name>)
+ *   turbine migrate create <name> - Create a new SQL migration file (--auto | --from-diff | --recipe <name>)
  *   turbine migrate up            — Apply pending migrations
  *   turbine migrate deploy        — Apply pending migrations without prompts
  *   turbine migrate down          — Rollback last migration
@@ -62,6 +62,7 @@ exports.parseArgs = parseArgs;
 exports.loadDotEnvForCli = loadDotEnvForCli;
 exports.dotEnvUrlConflictWarning = dotEnvUrlConflictWarning;
 exports.detectConsumerModuleType = detectConsumerModuleType;
+exports.planInitSteps = planInitSteps;
 exports.buildMigrateDeployOptions = buildMigrateDeployOptions;
 exports.getSeedExecutionPlan = getSeedExecutionPlan;
 exports.isLoopbackHost = isLoopbackHost;
@@ -129,6 +130,25 @@ function parseArgs(argv = process.argv.slice(2)) {
             case '--auto':
                 result.auto = true;
                 break;
+            case '--from-diff':
+                result.fromDiff = true;
+                break;
+            case '--yes':
+            case '-y':
+                result.yes = true;
+                break;
+            case '--skip-schema':
+                result.skipSchema = true;
+                break;
+            case '--skip-seed':
+                result.skipSeed = true;
+                break;
+            case '--skip-push':
+                result.skipPush = true;
+                break;
+            case '--skip-generate':
+                result.skipGenerate = true;
+                break;
             case '--allow-drift':
                 result.allowDrift = true;
                 break;
@@ -422,90 +442,103 @@ function detectConsumerModuleType(cwd = process.cwd()) {
         return 'none';
     }
 }
-// ---------------------------------------------------------------------------
-// Command: init
-// ---------------------------------------------------------------------------
-async function cmdInit(args, config) {
-    (0, ui_js_1.banner)();
-    (0, ui_js_1.header)('Initializing Turbine project');
-    // Detect environment. main() has already auto-loaded a local `.env` into
-    // process.env (when DATABASE_URL was not otherwise set), so these messages
-    // describe the real, post-load state, no more "if set" hand-waving.
-    const envUrl = process.env.DATABASE_URL;
-    const hasEnvFile = (0, node_fs_1.existsSync)('.env');
-    const hasEnvLocal = (0, node_fs_1.existsSync)('.env.local');
-    // On Node < 20.12 (no process.loadEnvFile) main() could not auto-load .env, so
-    // we cannot claim it "has no DATABASE_URL"; we simply could not read it.
-    const canAutoLoadEnv = typeof process.loadEnvFile === 'function';
-    if (envUrl) {
-        (0, ui_js_1.success)(`Detected ${(0, ui_js_1.cyan)('DATABASE_URL')} in the environment`);
-    }
-    else if (hasEnvFile && !canAutoLoadEnv) {
-        (0, ui_js_1.info)(`Found ${(0, ui_js_1.cyan)('.env')} ${(0, ui_js_1.dim)('(this Node version cannot auto-load it. Upgrade to Node 20.12+ or export')} ${(0, ui_js_1.cyan)('DATABASE_URL')}${(0, ui_js_1.dim)(')')}`);
-    }
-    else if (hasEnvFile) {
-        // .env exists but did not provide DATABASE_URL; if it had, the auto-load
-        // in main() would have populated envUrl above.
-        (0, ui_js_1.info)(`Found ${(0, ui_js_1.cyan)('.env')} ${(0, ui_js_1.dim)('(no')} ${(0, ui_js_1.cyan)('DATABASE_URL')} ${(0, ui_js_1.dim)('set in it yet)')}`);
-    }
-    else if (hasEnvLocal) {
-        (0, ui_js_1.info)(`Found ${(0, ui_js_1.cyan)('.env.local')} ${(0, ui_js_1.dim)('(note: Turbine only auto-loads')} ${(0, ui_js_1.cyan)('.env')}${(0, ui_js_1.dim)(')')}`);
-    }
-    else {
-        (0, ui_js_1.info)(`No ${(0, ui_js_1.cyan)('DATABASE_URL')} found in environment`);
-    }
-    (0, ui_js_1.newline)();
-    // Heads-up (not an edit) about the consumer's module system. A CommonJS
-    // project (`npm init -y` default, or no "type" field) works fine now that the
-    // config loader unwraps the CJS-interop double-wrapped default, but ESM is the
-    // smoother path for a TypeScript config file.
-    const moduleType = detectConsumerModuleType();
-    if (moduleType === 'commonjs') {
-        (0, ui_js_1.info)(`Your ${(0, ui_js_1.cyan)('package.json')} is a CommonJS project ${(0, ui_js_1.dim)('(no')} ${(0, ui_js_1.cyan)('"type": "module"')}${(0, ui_js_1.dim)(').')}`);
-        console.log(`  ${(0, ui_js_1.dim)('Turbine works either way. For the smoothest TypeScript config experience, consider adding')} ${(0, ui_js_1.cyan)('"type": "module"')}${(0, ui_js_1.dim)('.')}`);
-        (0, ui_js_1.newline)();
-    }
-    const configPath = (0, config_js_1.findConfigFile)();
-    // Create config file
-    if (configPath && !args.force) {
-        (0, ui_js_1.warn)(`Config file already exists: ${(0, ui_js_1.dim)(configPath)}`);
-        console.log(`  ${(0, ui_js_1.dim)('Run with')} ${(0, ui_js_1.cyan)('--force')} ${(0, ui_js_1.dim)('to overwrite')}`);
-    }
-    else {
-        const urlForConfig = args.url ?? undefined;
-        const configContent = (0, config_js_1.configTemplate)(urlForConfig);
-        (0, node_fs_1.writeFileSync)('turbine.config.ts', configContent, 'utf-8');
-        if (configPath) {
-            (0, ui_js_1.success)(`Overwrote ${(0, ui_js_1.cyan)('turbine.config.ts')}`);
-        }
-        else {
-            (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)('turbine.config.ts')}`);
-        }
+/**
+ * Pure step planner for `turbine init`. Given the detected project state and the
+ * effective flags, decide for each step whether to run it, prompt for it, or
+ * skip it (and why). No IO: every input is precomputed by the caller: so the
+ * whole decision matrix is unit-testable without a TTY or a database.
+ *
+ * Three modes:
+ *  - `prompt`      (interactive TTY, no `--yes`): scaffold + DB steps are prompted.
+ *  - `auto-yes`    (`--yes`): accept each step's default; the yes-defaults run.
+ *  - `auto-legacy` (non-TTY, no `--yes`): reproduce the pre-existing init
+ *    behavior. Scaffold files + generate run; push + seed-run do not.
+ *
+ * Steps that create files (config, schema, seed) are skipped when the file
+ * already exists, so re-runs are safe. DB steps (push, generate, seed-run) are
+ * skipped when there is no URL or the database is unreachable.
+ */
+function planInitSteps(state, flags) {
+    const mode = flags.interactive && !flags.yes ? 'prompt' : flags.yes ? 'auto-yes' : 'auto-legacy';
+    const steps = [];
+    // config: core scaffold, never prompted.
+    steps.push(state.configExists && !flags.force
+        ? { id: 'config', action: 'skip', defaultYes: true, skipReason: 'exists' }
+        : { id: 'config', action: 'run', defaultYes: true });
+    // Scaffold files (schema, seed): created by default; prompted interactively.
+    const scaffold = (id, exists, skipFlag) => {
+        if (skipFlag)
+            return { id, action: 'skip', defaultYes: true, skipReason: 'flag' };
+        if (exists)
+            return { id, action: 'skip', defaultYes: true, skipReason: 'exists' };
+        return { id, action: mode === 'prompt' ? 'prompt' : 'run', defaultYes: true };
+    };
+    steps.push(scaffold('schema', state.schemaExists, flags.skipSchema));
+    steps.push(scaffold('seed-file', state.seedFileExists, flags.skipSeed));
+    // seed-run needs a seed file: either one that already exists, or one this run
+    // is about to create.
+    const seedWillExist = state.seedFileExists || steps.find((s) => s.id === 'seed-file')?.action !== 'skip';
+    // DB steps: need a reachable database.
+    const dbStep = (id, skipFlag, opts) => {
+        const { defaultYes } = opts;
+        if (skipFlag)
+            return { id, action: 'skip', defaultYes, skipReason: 'flag' };
+        if (!state.hasUrl)
+            return { id, action: 'skip', defaultYes, skipReason: 'no-url' };
+        if (!state.dbReachable)
+            return { id, action: 'skip', defaultYes, skipReason: 'unreachable' };
+        if (opts.extraSkip)
+            return { id, action: 'skip', defaultYes, skipReason: opts.extraSkip };
+        if (mode === 'prompt')
+            return { id, action: 'prompt', defaultYes };
+        if (mode === 'auto-yes') {
+            return defaultYes
+                ? { id, action: 'run', defaultYes }
+                : { id, action: 'skip', defaultYes, skipReason: 'default-no' };
+        }
+        // auto-legacy
+        return opts.legacyRun
+            ? { id, action: 'run', defaultYes }
+            : { id, action: 'skip', defaultYes, skipReason: 'non-interactive' };
+    };
+    steps.push(dbStep('push', flags.skipPush, { legacyRun: false, defaultYes: true }));
+    steps.push(dbStep('generate', flags.skipGenerate, { legacyRun: true, defaultYes: true }));
+    steps.push(dbStep('seed-run', flags.skipSeed, {
+        legacyRun: false,
+        defaultYes: false,
+        extraSkip: seedWillExist ? undefined : 'no-seed-file',
+    }));
+    return steps;
+}
+/** Prompt for a yes/no answer on an interactive TTY. */
+async function promptYesNo(question, defaultYes) {
+    const { createInterface } = await Promise.resolve().then(() => __importStar(require('node:readline/promises')));
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const suffix = defaultYes ? '[Y/n]' : '[y/N]';
+        const raw = (await rl.question(`  ${question} ${(0, ui_js_1.dim)(suffix)} `)).trim().toLowerCase();
+        if (raw === '')
+            return defaultYes;
+        return raw === 'y' || raw === 'yes';
     }
-    // Create migrations directory
-    const migrDir = config.migrationsDir;
-    if (!(0, node_fs_1.existsSync)(migrDir)) {
-        (0, node_fs_1.mkdirSync)(migrDir, { recursive: true });
-        // Create .gitkeep
-        (0, node_fs_1.writeFileSync)(`${migrDir}/.gitkeep`, '', 'utf-8');
-        (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(`${migrDir}/`)}`);
+    finally {
+        rl.close();
     }
-    else {
-        (0, ui_js_1.info)(`Migrations dir already exists: ${(0, ui_js_1.dim)(migrDir)}`);
+}
+/** Probe database reachability with a short-lived connection. Never throws. */
+async function probeDatabase(url) {
+    try {
+        const { default: pg } = await Promise.resolve().then(() => __importStar(require('pg')));
+        const client = new pg.Client({ connectionString: url });
+        await client.connect();
+        await client.end();
+        return true;
     }
-    // Create output directory
-    if (!(0, node_fs_1.existsSync)(config.out)) {
-        (0, node_fs_1.mkdirSync)(config.out, { recursive: true });
-        (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(`${config.out}/`)}`);
+    catch {
+        return false;
     }
-    // Create seed file template
-    const initSeedFile = config.seedFile ?? './seed.ts';
-    const seedDir = (0, node_path_1.dirname)(initSeedFile);
-    if (!(0, node_fs_1.existsSync)(initSeedFile)) {
-        if (!(0, node_fs_1.existsSync)(seedDir)) {
-            (0, node_fs_1.mkdirSync)(seedDir, { recursive: true });
-        }
-        (0, node_fs_1.writeFileSync)(initSeedFile, `/**
+}
+const INIT_SEED_TEMPLATE = `/**
  * Turbine seed file
  *
  * Run with: npx turbine seed
@@ -521,16 +554,8 @@ export default defineSeed(async (db) => {
 
   console.log('Done!');
 });
-`, 'utf-8');
-        (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(initSeedFile)}`);
-    }
-    // Create schema builder template
-    if (!(0, node_fs_1.existsSync)(config.schemaFile)) {
-        const schemaDir = config.schemaFile.substring(0, config.schemaFile.lastIndexOf('/'));
-        if (!(0, node_fs_1.existsSync)(schemaDir)) {
-            (0, node_fs_1.mkdirSync)(schemaDir, { recursive: true });
-        }
-        (0, node_fs_1.writeFileSync)(config.schemaFile, `/**
+`;
+const INIT_SCHEMA_TEMPLATE = `/**
  * Turbine schema definition
  *
  * Define your database schema in TypeScript.
@@ -550,54 +575,298 @@ export default defineSchema({
   //   created_at: { type: 'timestamp', default: 'NOW()' },
   // },
 });
-`, 'utf-8');
-        (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(config.schemaFile)}`);
+`;
+/** Create supporting directories + .gitignore entries (unconditional, unprompted). */
+function ensureInitScaffoldDirs(config) {
+    const migrDir = config.migrationsDir;
+    if (!(0, node_fs_1.existsSync)(migrDir)) {
+        (0, node_fs_1.mkdirSync)(migrDir, { recursive: true });
+        (0, node_fs_1.writeFileSync)(`${migrDir}/.gitkeep`, '', 'utf-8');
+        (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(`${migrDir}/`)}`);
+    }
+    if (!(0, node_fs_1.existsSync)(config.out)) {
+        (0, node_fs_1.mkdirSync)(config.out, { recursive: true });
+        (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(`${config.out}/`)}`);
     }
-    // Add .gitignore entries for generated output and config (may contain connection strings)
     const gitignorePath = '.gitignore';
     if ((0, node_fs_1.existsSync)(gitignorePath)) {
         const gitignoreContent = (0, node_fs_1.readFileSync)(gitignorePath, 'utf-8');
         const additions = [];
-        if (!gitignoreContent.includes('generated/turbine')) {
+        if (!gitignoreContent.includes('generated/turbine'))
             additions.push('generated/turbine/');
-        }
-        if (!gitignoreContent.includes('turbine.config.ts')) {
+        if (!gitignoreContent.includes('turbine.config.ts'))
             additions.push('turbine.config.ts');
-        }
         if (additions.length > 0) {
             (0, node_fs_1.appendFileSync)(gitignorePath, `\n# Turbine generated client & config\n${additions.join('\n')}\n`);
             (0, ui_js_1.success)(`Added ${(0, ui_js_1.cyan)(additions.join(', '))} to ${(0, ui_js_1.cyan)('.gitignore')}`);
         }
     }
-    // If we have a URL, run initial generate
-    const url = args.url ?? envUrl ?? config.url;
-    if (url) {
-        (0, ui_js_1.newline)();
-        (0, ui_js_1.divider)();
+}
+function writeInitSchemaTemplate(config) {
+    const schemaDir = (0, node_path_1.dirname)(config.schemaFile);
+    if (schemaDir && !(0, node_fs_1.existsSync)(schemaDir))
+        (0, node_fs_1.mkdirSync)(schemaDir, { recursive: true });
+    (0, node_fs_1.writeFileSync)(config.schemaFile, INIT_SCHEMA_TEMPLATE, 'utf-8');
+    (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(config.schemaFile)}`);
+}
+function writeInitSeedTemplate(seedFilePath) {
+    const seedDir = (0, node_path_1.dirname)(seedFilePath);
+    if (seedDir && !(0, node_fs_1.existsSync)(seedDir))
+        (0, node_fs_1.mkdirSync)(seedDir, { recursive: true });
+    (0, node_fs_1.writeFileSync)(seedFilePath, INIT_SEED_TEMPLATE, 'utf-8');
+    (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(seedFilePath)}`);
+}
+/** Push the code-first schema to the database, preserving the destructive typed confirm. */
+async function runInitPush(config, url) {
+    if (!(0, node_fs_1.existsSync)(config.schemaFile)) {
+        (0, ui_js_1.warn)(`No schema file at ${(0, ui_js_1.cyan)(config.schemaFile)}: skipping push.`);
+        return;
+    }
+    const schemaDef = await loadSchemaFile(config.schemaFile);
+    const spinner = new ui_js_1.Spinner('Computing schema diff').start();
+    const diff = await (0, schema_sql_js_1.schemaDiff)(schemaDef, url);
+    if (diff.statements.length === 0) {
+        spinner.succeed('Database already in sync: nothing to push');
+        return;
+    }
+    spinner.succeed(`Found ${(0, ui_js_1.bold)(String(diff.statements.length))} change(s) to apply`);
+    const pushSpinner = new ui_js_1.Spinner('Applying schema').start();
+    try {
+        const result = await (0, schema_sql_js_1.schemaPush)(schemaDef, url, { precomputedDiff: diff });
+        pushSpinner.succeed(`Applied ${(0, ui_js_1.bold)(String(result.statementsExecuted))} statement(s)`);
+    }
+    catch (err) {
+        if (!(err instanceof schema_sql_js_1.DestructivePushRefusal))
+            throw err;
+        pushSpinner.stop();
+        if (!(await confirmDestructive(err.message))) {
+            (0, ui_js_1.warn)('Push aborted: no schema changes were applied.');
+            return;
+        }
+        const result = await (0, schema_sql_js_1.schemaPush)(schemaDef, url, { allowDestructive: true, precomputedDiff: diff });
+        (0, ui_js_1.success)(`Applied ${(0, ui_js_1.bold)(String(result.statementsExecuted))} statement(s)`);
+    }
+}
+/** Introspect the database and generate the typed client. */
+async function runInitGenerate(config, url) {
+    const spinner = new ui_js_1.Spinner('Introspecting database').start();
+    try {
+        const schema = await (0, introspect_js_1.introspect)({
+            connectionString: url,
+            schema: config.schema,
+            include: config.include.length ? config.include : undefined,
+            exclude: config.exclude.length ? config.exclude : undefined,
+        });
+        spinner.succeed(`Found ${(0, ui_js_1.bold)(String(Object.keys(schema.tables).length))} tables`);
+        const genSpinner = new ui_js_1.Spinner('Generating TypeScript client').start();
+        const result = (0, generate_js_1.generate)({ schema, outDir: config.out, connectionString: url });
+        genSpinner.succeed(`Generated ${(0, ui_js_1.bold)(String(result.files.length))} files to ${(0, ui_js_1.cyan)(`${config.out}/`)}`);
+    }
+    catch (err) {
+        spinner.fail('Could not generate client');
+        if (err instanceof Error)
+            console.log(`  ${(0, ui_js_1.dim)((0, ui_js_1.redactUrl)(err.message))}`);
+        (0, ui_js_1.info)(`Run generation later with: ${(0, ui_js_1.cyan)('npx turbine generate')}`);
+    }
+}
+/** Run the seed file. */
+async function runInitSeed(config) {
+    const seedFile = (0, config_js_1.resolveSeedFile)(config);
+    if (!seedFile || !(0, node_fs_1.existsSync)(seedFile)) {
+        (0, ui_js_1.warn)('No seed file found: skipping seed run.');
+        return;
+    }
+    const spinner = new ui_js_1.Spinner('Running seed file').start();
+    try {
+        await runSeedPlan(getSeedExecutionPlan(seedFile), config);
+        spinner.succeed('Seed completed');
+    }
+    catch (err) {
+        spinner.fail('Seed failed');
+        if (err instanceof Error)
+            console.log(`  ${(0, ui_js_1.dim)((0, ui_js_1.redactUrl)(err.message))}`);
+    }
+}
+/** Human label for a step, used in prompts and skip messages. */
+function initStepLabel(id) {
+    switch (id) {
+        case 'config':
+            return 'config file';
+        case 'schema':
+            return 'schema file';
+        case 'seed-file':
+            return 'seed file';
+        case 'push':
+            return 'schema push';
+        case 'generate':
+            return 'client generation';
+        case 'seed-run':
+            return 'seed run';
+    }
+}
+/** Report a skipped step with its reason. Existence skips are the quiet common case. */
+function reportInitSkip(step) {
+    const label = initStepLabel(step.id);
+    switch (step.skipReason) {
+        case 'exists':
+            (0, ui_js_1.info)(`${label} already exists ${(0, ui_js_1.dim)('- skipped')}`);
+            break;
+        case 'flag':
+            console.log(`  ${(0, ui_js_1.dim)(`${ui_js_1.symbols.dot} ${label} skipped (flag)`)}`);
+            break;
+        case 'no-url':
+            console.log(`  ${(0, ui_js_1.dim)(`${ui_js_1.symbols.dot} ${label} skipped (no database URL)`)}`);
+            break;
+        case 'unreachable':
+            console.log(`  ${(0, ui_js_1.dim)(`${ui_js_1.symbols.dot} ${label} skipped (database unreachable)`)}`);
+            break;
+        case 'no-seed-file':
+            console.log(`  ${(0, ui_js_1.dim)(`${ui_js_1.symbols.dot} ${label} skipped (no seed file)`)}`);
+            break;
+        case 'non-interactive':
+            console.log(`  ${(0, ui_js_1.dim)(`${ui_js_1.symbols.dot} ${label} skipped (non-interactive: pass --yes to run it)`)}`);
+            break;
+        case 'default-no':
+            console.log(`  ${(0, ui_js_1.dim)(`${ui_js_1.symbols.dot} ${label} skipped (default no)`)}`);
+            break;
+        default:
+            console.log(`  ${(0, ui_js_1.dim)(`${ui_js_1.symbols.dot} ${label} skipped`)}`);
+    }
+}
+/** The interactive prompt question for a promptable step. */
+function initPromptQuestion(step, config, seedFilePath) {
+    switch (step.id) {
+        case 'schema':
+            return `Create a starter schema file (${config.schemaFile})?`;
+        case 'seed-file':
+            return `Create a starter seed file (${seedFilePath})?`;
+        case 'push':
+            return 'Push your schema to the database now?';
+        case 'generate':
+            return 'Generate the typed client from the database now?';
+        case 'seed-run':
+            return 'Run the seed file now?';
+        default:
+            return `Run ${initStepLabel(step.id)}?`;
+    }
+}
+async function cmdInit(args, config) {
+    (0, ui_js_1.banner)();
+    (0, ui_js_1.header)('Initializing Turbine project');
+    // Detect environment. main() has already auto-loaded a local `.env` into
+    // process.env (when DATABASE_URL was not otherwise set), so these messages
+    // describe the real, post-load state, no more "if set" hand-waving.
+    const envUrl = process.env.DATABASE_URL;
+    const hasEnvFile = (0, node_fs_1.existsSync)('.env');
+    const hasEnvLocal = (0, node_fs_1.existsSync)('.env.local');
+    // On Node < 20.12 (no process.loadEnvFile) main() could not auto-load .env, so
+    // we cannot claim it "has no DATABASE_URL"; we simply could not read it.
+    const canAutoLoadEnv = typeof process.loadEnvFile === 'function';
+    if (envUrl) {
+        (0, ui_js_1.success)(`Detected ${(0, ui_js_1.cyan)('DATABASE_URL')} in the environment`);
+    }
+    else if (hasEnvFile && !canAutoLoadEnv) {
+        (0, ui_js_1.info)(`Found ${(0, ui_js_1.cyan)('.env')} ${(0, ui_js_1.dim)('(this Node version cannot auto-load it. Upgrade to Node 20.12+ or export')} ${(0, ui_js_1.cyan)('DATABASE_URL')}${(0, ui_js_1.dim)(')')}`);
+    }
+    else if (hasEnvFile) {
+        // .env exists but did not provide DATABASE_URL; if it had, the auto-load
+        // in main() would have populated envUrl above.
+        (0, ui_js_1.info)(`Found ${(0, ui_js_1.cyan)('.env')} ${(0, ui_js_1.dim)('(no')} ${(0, ui_js_1.cyan)('DATABASE_URL')} ${(0, ui_js_1.dim)('set in it yet)')}`);
+    }
+    else if (hasEnvLocal) {
+        (0, ui_js_1.info)(`Found ${(0, ui_js_1.cyan)('.env.local')} ${(0, ui_js_1.dim)('(note: Turbine only auto-loads')} ${(0, ui_js_1.cyan)('.env')}${(0, ui_js_1.dim)(')')}`);
+    }
+    else {
+        (0, ui_js_1.info)(`No ${(0, ui_js_1.cyan)('DATABASE_URL')} found in environment`);
+    }
+    (0, ui_js_1.newline)();
+    // Heads-up (not an edit) about the consumer's module system. A CommonJS
+    // project (`npm init -y` default, or no "type" field) works fine now that the
+    // config loader unwraps the CJS-interop double-wrapped default, but ESM is the
+    // smoother path for a TypeScript config file.
+    const moduleType = detectConsumerModuleType();
+    if (moduleType === 'commonjs') {
+        (0, ui_js_1.info)(`Your ${(0, ui_js_1.cyan)('package.json')} is a CommonJS project ${(0, ui_js_1.dim)('(no')} ${(0, ui_js_1.cyan)('"type": "module"')}${(0, ui_js_1.dim)(').')}`);
+        console.log(`  ${(0, ui_js_1.dim)('Turbine works either way. For the smoothest TypeScript config experience, consider adding')} ${(0, ui_js_1.cyan)('"type": "module"')}${(0, ui_js_1.dim)('.')}`);
         (0, ui_js_1.newline)();
-        const spinner = new ui_js_1.Spinner('Introspecting database').start();
-        try {
-            const schema = await (0, introspect_js_1.introspect)({
-                connectionString: url,
-                schema: config.schema,
-                include: config.include.length ? config.include : undefined,
-                exclude: config.exclude.length ? config.exclude : undefined,
-            });
-            const tableCount = Object.keys(schema.tables).length;
-            spinner.succeed(`Found ${(0, ui_js_1.bold)(String(tableCount))} tables`);
-            const genSpinner = new ui_js_1.Spinner('Generating TypeScript client').start();
-            const result = (0, generate_js_1.generate)({ schema, outDir: config.out, connectionString: url });
-            genSpinner.succeed(`Generated ${(0, ui_js_1.bold)(String(result.files.length))} files to ${(0, ui_js_1.cyan)(`${config.out}/`)}`);
-        }
-        catch (err) {
-            spinner.fail('Could not connect to database');
-            if (err instanceof Error) {
-                console.log(`  ${(0, ui_js_1.dim)((0, ui_js_1.redactUrl)(err.message))}`);
-            }
-            (0, ui_js_1.newline)();
-            (0, ui_js_1.info)(`You can run generation later with: ${(0, ui_js_1.cyan)('npx turbine generate')}`);
+    }
+    // Resolve the effective URL and detect current project state.
+    const url = args.url ?? envUrl ?? config.url;
+    const hasUrl = Boolean(url);
+    const interactive = Boolean(process.stdin.isTTY);
+    const yes = args.yes === true;
+    const seedFilePath = config.seedFile ?? './seed.ts';
+    const configPath = (0, config_js_1.findConfigFile)();
+    const state = {
+        configExists: Boolean(configPath),
+        schemaExists: (0, node_fs_1.existsSync)(config.schemaFile),
+        seedFileExists: (0, node_fs_1.existsSync)(seedFilePath),
+        hasUrl,
+        dbReachable: false,
+    };
+    // Probe the database once, up front, so the planner can decide the DB steps.
+    // Skip the probe entirely when every DB step is already flag-skipped.
+    const anyDbStepPossible = !(args.skipPush && args.skipGenerate && args.skipSeed);
+    if (hasUrl && anyDbStepPossible) {
+        const probe = new ui_js_1.Spinner('Checking database connection').start();
+        state.dbReachable = await probeDatabase(url);
+        if (state.dbReachable)
+            probe.succeed('Database is reachable');
+        else
+            probe.info('Database not reachable: push / generate / seed steps will be skipped');
+    }
+    const flags = {
+        yes,
+        force: args.force === true,
+        interactive,
+        skipSchema: args.skipSchema === true,
+        skipSeed: args.skipSeed === true,
+        skipPush: args.skipPush === true,
+        skipGenerate: args.skipGenerate === true,
+    };
+    const plan = planInitSteps(state, flags);
+    const degraded = !interactive && !yes;
+    // Supporting dirs + .gitignore, regardless of prompts (unchanged behavior).
+    ensureInitScaffoldDirs(config);
+    (0, ui_js_1.newline)();
+    // Execute the plan in order. `run` proceeds; `prompt` asks; `skip` reports.
+    for (const step of plan) {
+        if (step.action === 'skip') {
+            reportInitSkip(step);
+            continue;
+        }
+        const shouldRun = step.action === 'run' ? true : await promptYesNo(initPromptQuestion(step, config, seedFilePath), step.defaultYes);
+        if (!shouldRun) {
+            (0, ui_js_1.info)(`Skipped ${initStepLabel(step.id)}`);
+            continue;
+        }
+        switch (step.id) {
+            case 'config':
+                (0, node_fs_1.writeFileSync)('turbine.config.ts', (0, config_js_1.configTemplate)(args.url ?? undefined), 'utf-8');
+                (0, ui_js_1.success)(state.configExists ? `Overwrote ${(0, ui_js_1.cyan)('turbine.config.ts')}` : `Created ${(0, ui_js_1.cyan)('turbine.config.ts')}`);
+                break;
+            case 'schema':
+                writeInitSchemaTemplate(config);
+                break;
+            case 'seed-file':
+                writeInitSeedTemplate(seedFilePath);
+                break;
+            case 'push':
+                await runInitPush(config, url);
+                break;
+            case 'generate':
+                await runInitGenerate(config, url);
+                break;
+            case 'seed-run':
+                await runInitSeed(config);
+                break;
         }
     }
+    if (degraded) {
+        (0, ui_js_1.newline)();
+        (0, ui_js_1.info)('Non-interactive shell: interactive prompts were skipped.');
+        console.log(`  ${(0, ui_js_1.dim)('Re-run in a terminal, pass')} ${(0, ui_js_1.cyan)('--yes')} ${(0, ui_js_1.dim)('to accept defaults, or use')} ${(0, ui_js_1.cyan)('--skip-*')} ${(0, ui_js_1.dim)('flags to control each step.')}`);
+    }
     // Next steps
     (0, ui_js_1.newline)();
     (0, ui_js_1.divider)();
@@ -850,9 +1119,10 @@ async function cmdMigrate(args, config) {
         console.log(`  ${(0, ui_js_1.bold)('turbine migrate')} ${(0, ui_js_1.dim)('— SQL-first migration system')}`);
         (0, ui_js_1.newline)();
         console.log(`  ${(0, ui_js_1.bold)('Commands:')}`);
-        console.log(`    ${(0, ui_js_1.cyan)('create <name>')}            Create a new migration file`);
-        console.log(`    ${(0, ui_js_1.cyan)('create <name> --auto')}     Auto-generate from schema diff`);
-        console.log(`    ${(0, ui_js_1.cyan)('create <name> --recipe')}   Scaffold a named recipe (e.g. backfill)`);
+        console.log(`    ${(0, ui_js_1.cyan)('create <name>')}             Create a new migration file`);
+        console.log(`    ${(0, ui_js_1.cyan)('create <name> --auto')}      Auto-generate from schema diff`);
+        console.log(`    ${(0, ui_js_1.cyan)('create <name> --from-diff')} Generate from schema diff, destructive statements flagged`);
+        console.log(`    ${(0, ui_js_1.cyan)('create <name> --recipe')}    Scaffold a named recipe (e.g. backfill)`);
         console.log(`    ${(0, ui_js_1.cyan)('up')}                       Apply pending migrations`);
         console.log(`    ${(0, ui_js_1.cyan)('deploy')}                   Apply pending migrations without prompts`);
         console.log(`    ${(0, ui_js_1.cyan)('down')}                     Rollback last migration`);
@@ -860,6 +1130,7 @@ async function cmdMigrate(args, config) {
         (0, ui_js_1.newline)();
         console.log(`  ${(0, ui_js_1.bold)('Options:')}`);
         console.log(`    ${(0, ui_js_1.cyan)('--auto')}             Auto-generate UP/DOWN SQL from schema diff`);
+        console.log(`    ${(0, ui_js_1.cyan)('--from-diff')}        Like --auto, but flags destructive statements in the file`);
         console.log(`    ${(0, ui_js_1.cyan)('--recipe <name>')}    Scaffold a sanctioned migration pattern`);
         console.log(`    ${(0, ui_js_1.cyan)('--step, -n')}         Number of migrations to apply/rollback`);
         console.log(`    ${(0, ui_js_1.cyan)('--dry-run')}          Show SQL without executing`);
@@ -873,6 +1144,7 @@ async function cmdMigrate(args, config) {
         console.log(`  ${(0, ui_js_1.bold)('Examples:')}`);
         console.log(`    ${(0, ui_js_1.dim)('npx turbine migrate create add_users_table')}`);
         console.log(`    ${(0, ui_js_1.dim)('npx turbine migrate create add_email_index --auto')}`);
+        console.log(`    ${(0, ui_js_1.dim)('npx turbine migrate create sync_schema --from-diff')}`);
         console.log(`    ${(0, ui_js_1.dim)('npx turbine migrate create backfill_full_name --recipe backfill')}`);
         console.log(`    ${(0, ui_js_1.dim)('npx turbine migrate up')}`);
         console.log(`    ${(0, ui_js_1.dim)('npx turbine migrate deploy --dry-run')}`);
@@ -915,6 +1187,20 @@ async function cmdMigrateCreate(args, config) {
         (0, ui_js_1.newline)();
         process.exit(1);
     }
+    // The scaffold strategies each own the file body, so combining them is
+    // ambiguous. Refuse up front (before any of the strategy blocks run).
+    if (args.fromDiff && args.recipe) {
+        (0, ui_js_1.error)('--from-diff cannot be combined with --recipe.');
+        console.log(`  ${(0, ui_js_1.dim)('Pick one: --from-diff generates from the schema diff, --recipe scaffolds a pattern.')}`);
+        (0, ui_js_1.newline)();
+        process.exit(1);
+    }
+    if (args.fromDiff && args.auto) {
+        (0, ui_js_1.error)('--from-diff cannot be combined with --auto.');
+        console.log(`  ${(0, ui_js_1.dim)('Both generate from the schema diff; --from-diff also flags destructive statements.')}`);
+        (0, ui_js_1.newline)();
+        process.exit(1);
+    }
     if (args.auto) {
         // Auto-generate migration from schema diff
         const url = requireUrl(config);
@@ -925,7 +1211,7 @@ async function cmdMigrateCreate(args, config) {
         const diffSpinner = new ui_js_1.Spinner('Computing schema diff').start();
         const diff = await (0, schema_sql_js_1.schemaDiff)(schemaDef, url);
         if (diff.statements.length === 0) {
-            diffSpinner.succeed('Database is already in sync — nothing to migrate');
+            diffSpinner.succeed('Database is already in sync: nothing to migrate');
             (0, ui_js_1.newline)();
             return;
         }
@@ -966,6 +1252,78 @@ async function cmdMigrateCreate(args, config) {
         (0, ui_js_1.newline)();
         return;
     }
+    if (args.fromDiff) {
+        // Load the code-first schema (same file `push` uses). loadSchemaFile exits
+        // with a clear message when the project has no schema-builder file.
+        const url = requireUrl(config);
+        (0, ui_js_1.label)('Database', (0, ui_js_1.redactUrl)(url));
+        (0, ui_js_1.label)('Schema file', config.schemaFile);
+        (0, ui_js_1.newline)();
+        const schemaDef = await loadSchemaFile(config.schemaFile);
+        const diffSpinner = new ui_js_1.Spinner('Computing schema diff').start();
+        const diff = await (0, schema_sql_js_1.schemaDiff)(schemaDef, url);
+        if (diff.statements.length === 0) {
+            diffSpinner.succeed('Database is already in sync: nothing to migrate');
+            (0, ui_js_1.newline)();
+            return;
+        }
+        diffSpinner.succeed(`Found ${(0, ui_js_1.bold)(String(diff.statements.length))} change(s)`);
+        (0, ui_js_1.newline)();
+        const body = (0, migrate_js_1.buildDiffMigrationBody)(diff);
+        const file = (0, migrate_js_1.createMigration)(config.migrationsDir, name, { up: body.up, down: body.down });
+        const relPath = (0, node_path_1.relative)(process.cwd(), file.path);
+        (0, ui_js_1.success)(`Created diff migration: ${(0, ui_js_1.bold)(file.filename)}`);
+        (0, ui_js_1.newline)();
+        console.log(`  ${(0, ui_js_1.dim)('File:')} ${(0, ui_js_1.cyan)(relPath)}`);
+        (0, ui_js_1.newline)();
+        // Summarize the changes, mirroring --auto's output.
+        if (diff.create.length > 0) {
+            console.log(`  ${(0, ui_js_1.green)('+ Create')} ${diff.create.length} table(s): ${diff.create.map((t) => t.name).join(', ')}`);
+        }
+        if (diff.alter.length > 0) {
+            console.log(`  ${(0, ui_js_1.yellow)('~ Alter')} ${diff.alter.length} table(s):`);
+            for (const a of diff.alter) {
+                for (const col of a.columns) {
+                    const actionLabel = col.action === 'add'
+                        ? (0, ui_js_1.green)('+ add')
+                        : col.action === 'drop'
+                            ? (0, ui_js_1.red)('- drop')
+                            : col.action === 'add_unique'
+                                ? (0, ui_js_1.green)('+ unique')
+                                : col.action === 'drop_unique'
+                                    ? (0, ui_js_1.red)('- unique')
+                                    : (0, ui_js_1.yellow)(`~ ${col.action.replace(/_/g, ' ')}`);
+                    console.log(`    ${actionLabel} ${a.table}.${col.column}`);
+                }
+            }
+        }
+        (0, ui_js_1.newline)();
+        // Loudly flag destructive statements written into the file. They stay in the
+        // migration (so `migrate up`'s gate still refuses them by default) but the
+        // operator must know they are there before running.
+        const destructiveCount = body.destructiveUp.length + body.destructiveDown.length;
+        if (destructiveCount > 0) {
+            (0, ui_js_1.warn)(`This migration contains ${(0, ui_js_1.bold)(String(destructiveCount))} DESTRUCTIVE statement(s), flagged in the file.`);
+            for (const h of body.destructiveUp) {
+                console.log(`    ${(0, ui_js_1.red)(ui_js_1.symbols.warning)} ${(0, ui_js_1.dim)('UP')}   [${h.kind}] ${h.target}`);
+            }
+            for (const h of body.destructiveDown) {
+                console.log(`    ${(0, ui_js_1.red)(ui_js_1.symbols.warning)} ${(0, ui_js_1.dim)('DOWN')} [${h.kind}] ${h.target}`);
+            }
+            (0, ui_js_1.newline)();
+            console.log(`  ${(0, ui_js_1.dim)('`migrate up` refuses destructive statements by default: confirm interactively or pass')} ${(0, ui_js_1.cyan)('--allow-destructive')}${(0, ui_js_1.dim)('.')}`);
+            (0, ui_js_1.newline)();
+        }
+        if (diff.warnings && diff.warnings.length > 0) {
+            for (const w of diff.warnings)
+                (0, ui_js_1.warn)(w);
+            (0, ui_js_1.newline)();
+        }
+        console.log(`  ${(0, ui_js_1.dim)('Review the migration, then run:')}`);
+        console.log(`  ${(0, ui_js_1.cyan)('npx turbine migrate up')}`);
+        (0, ui_js_1.newline)();
+        return;
+    }
     if (args.recipe) {
         if (!migrate_js_1.MIGRATION_RECIPES[args.recipe]) {
             (0, ui_js_1.error)(`Unknown migration recipe: ${args.recipe}`);
@@ -1724,12 +2082,22 @@ function showInitHelp() {
     console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
     console.log(`    npx turbine init ${(0, ui_js_1.dim)('[options]')}`);
     (0, ui_js_1.newline)();
-    console.log(`  Creates ${(0, ui_js_1.cyan)('turbine.config.ts')}, migrations directory, seed file template,`);
-    console.log(`  and schema file template.`);
+    console.log(`  Sequenced, interactive bootstrap. Detects project state and runs only`);
+    console.log(`  the needed steps: writes ${(0, ui_js_1.cyan)('turbine.config.ts')}, offers a starter schema +`);
+    console.log(`  seed file, and (when a reachable database is configured) offers to push`);
+    console.log(`  the schema, generate the typed client, and run the seed file.`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.dim)('Re-runs skip completed steps. A non-interactive shell runs the safe')}`);
+    console.log(`  ${(0, ui_js_1.dim)('scaffold + generate steps only; pass --yes to accept every default.')}`);
     (0, ui_js_1.newline)();
     console.log(`  ${(0, ui_js_1.bold)('Options:')}`);
     console.log(`    ${(0, ui_js_1.cyan)('--url, -u')} ${(0, ui_js_1.dim)('<url>')}   Postgres connection string to embed in config`);
     console.log(`    ${(0, ui_js_1.cyan)('--force, -f')}        Overwrite existing config file`);
+    console.log(`    ${(0, ui_js_1.cyan)('--yes, -y')}          Accept every step's default (non-interactive)`);
+    console.log(`    ${(0, ui_js_1.cyan)('--skip-schema')}      Don't create the starter schema file`);
+    console.log(`    ${(0, ui_js_1.cyan)('--skip-seed')}        Don't create the seed file or run the seed`);
+    console.log(`    ${(0, ui_js_1.cyan)('--skip-push')}        Don't push the schema to the database`);
+    console.log(`    ${(0, ui_js_1.cyan)('--skip-generate')}    Don't generate the typed client`);
     (0, ui_js_1.newline)();
 }
 function showGenerateHelp() {
@@ -1791,6 +2159,7 @@ function showMigrateHelp() {
     console.log(`  ${(0, ui_js_1.bold)('Options:')}`);
     console.log(`    ${(0, ui_js_1.cyan)('--url, -u')} ${(0, ui_js_1.dim)('<url>')}   Postgres connection string`);
     console.log(`    ${(0, ui_js_1.cyan)('--auto')}            Auto-generate UP/DOWN SQL from schema diff ${(0, ui_js_1.dim)('(create only)')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--from-diff')}       Generate from schema diff, flagging destructive statements ${(0, ui_js_1.dim)('(create only)')}`);
     console.log(`    ${(0, ui_js_1.cyan)('--recipe')} ${(0, ui_js_1.dim)('<name>')}   Scaffold a sanctioned migration pattern ${(0, ui_js_1.dim)('(create only, e.g. backfill)')}`);
     console.log(`    ${(0, ui_js_1.cyan)('--step, -n')} ${(0, ui_js_1.dim)('<N>')}    Number of migrations to apply/rollback`);
     console.log(`    ${(0, ui_js_1.cyan)('--dry-run')}         Show SQL without executing`);
@@ -1801,6 +2170,7 @@ function showMigrateHelp() {
     console.log(`  ${(0, ui_js_1.bold)('Examples:')}`);
     console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate create add_users_table`);
     console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate create add_email_index --auto`);
+    console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate create sync_schema --from-diff`);
     console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate create backfill_full_name --recipe backfill`);
     console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate up`);
     console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate deploy --dry-run`);