turbine-orm 0.4.0 → 0.7.0

package/dist/cjs/cli/index.js

@@ -0,0 +1,1176 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * turbine-orm CLI
+ *
+ * Commands:
+ *   turbine init                  — Initialize a Turbine project
+ *   turbine generate | pull       — Introspect database and generate TypeScript types
+ *   turbine push                  — Apply schema-builder definitions to database
+ *   turbine migrate create <name> — Create a new SQL migration file
+ *   turbine migrate up            — Apply pending migrations
+ *   turbine migrate down          — Rollback last migration
+ *   turbine migrate status        — Show migration status
+ *   turbine seed                  — Run seed file
+ *   turbine status                — Show schema summary
+ *   turbine studio                — Launch web UI (coming soon)
+ *
+ * Usage:
+ *   DATABASE_URL=postgres://... npx turbine generate
+ *   npx turbine init --url postgres://...
+ *   npx turbine migrate create add_users_table
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_url_1 = require("node:url");
+const generate_js_1 = require("../generate.js");
+const introspect_js_1 = require("../introspect.js");
+const schema_sql_js_1 = require("../schema-sql.js");
+const config_js_1 = require("./config.js");
+const migrate_js_1 = require("./migrate.js");
+const ui_js_1 = require("./ui.js");
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const result = {
+        command: args[0] ?? 'help',
+        positional: [],
+    };
+    let i = 1;
+    // Check for subcommand (e.g. "migrate create")
+    if (i < args.length && args[i] && !args[i].startsWith('-')) {
+        result.subcommand = args[i];
+        i++;
+    }
+    for (; i < args.length; i++) {
+        const arg = args[i];
+        const next = args[i + 1];
+        switch (arg) {
+            case '--url':
+            case '-u':
+                result.url = next;
+                i++;
+                break;
+            case '--out':
+            case '-o':
+                result.out = next;
+                i++;
+                break;
+            case '--schema':
+            case '-s':
+                result.schema = next;
+                i++;
+                break;
+            case '--include':
+                result.include = next?.split(',');
+                i++;
+                break;
+            case '--exclude':
+                result.exclude = next?.split(',');
+                i++;
+                break;
+            case '--step':
+            case '-n':
+                result.step = next ? parseInt(next, 10) : undefined;
+                i++;
+                break;
+            case '--dry-run':
+                result.dryRun = true;
+                break;
+            case '--auto':
+                result.auto = true;
+                break;
+            case '--force':
+            case '-f':
+                result.force = true;
+                break;
+            case '--verbose':
+            case '-v':
+                result.verbose = true;
+                break;
+            case '--help':
+            case '-h':
+                result.help = true;
+                break;
+            default:
+                if (!arg.startsWith('-')) {
+                    result.positional.push(arg);
+                }
+                break;
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function requireUrl(config) {
+    if (!config.url) {
+        (0, ui_js_1.error)('No database URL provided.');
+        (0, ui_js_1.newline)();
+        console.log(`  ${(0, ui_js_1.dim)('Set it in one of these ways:')}`);
+        console.log(`    ${(0, ui_js_1.dim)('1.')} Add ${(0, ui_js_1.cyan)('url')} to ${(0, ui_js_1.cyan)('turbine.config.ts')}`);
+        console.log(`    ${(0, ui_js_1.dim)('2.')} Set ${(0, ui_js_1.cyan)('DATABASE_URL')} environment variable`);
+        console.log(`    ${(0, ui_js_1.dim)('3.')} Pass ${(0, ui_js_1.cyan)('--url')} flag`);
+        (0, ui_js_1.newline)();
+        process.exit(1);
+    }
+    return config.url;
+}
+async function loadSchemaFile(schemaFile) {
+    const absPath = (0, node_path_1.resolve)(schemaFile);
+    if (!(0, node_fs_1.existsSync)(absPath)) {
+        (0, ui_js_1.error)(`Schema file not found: ${schemaFile}`);
+        console.log(`  ${(0, ui_js_1.dim)('Create one with:')} ${(0, ui_js_1.cyan)('turbine init')}`);
+        process.exit(1);
+    }
+    try {
+        const fileUrl = (0, node_url_1.pathToFileURL)(absPath).href;
+        const mod = await Promise.resolve(`${fileUrl}`).then(s => __importStar(require(s)));
+        const schema = mod.default ?? mod;
+        if (!schema.tables) {
+            (0, ui_js_1.error)('Schema file must export a SchemaDef with a "tables" property.');
+            process.exit(1);
+        }
+        return schema;
+    }
+    catch (err) {
+        (0, ui_js_1.error)(`Failed to load schema file: ${schemaFile}`);
+        if (err instanceof Error) {
+            console.log(`  ${(0, ui_js_1.dim)(err.message)}`);
+        }
+        process.exit(1);
+    }
+}
+// ---------------------------------------------------------------------------
+// Command: init
+// ---------------------------------------------------------------------------
+async function cmdInit(args, config) {
+    (0, ui_js_1.banner)();
+    (0, ui_js_1.header)('Initializing Turbine project');
+    // Detect environment
+    const envUrl = process.env.DATABASE_URL;
+    const hasEnvFile = (0, node_fs_1.existsSync)('.env');
+    const hasEnvLocal = (0, node_fs_1.existsSync)('.env.local');
+    if (envUrl) {
+        (0, ui_js_1.success)(`Detected ${(0, ui_js_1.cyan)('DATABASE_URL')} in environment`);
+    }
+    else if (hasEnvLocal) {
+        (0, ui_js_1.info)(`Found ${(0, ui_js_1.cyan)('.env.local')} — Turbine will use ${(0, ui_js_1.cyan)('DATABASE_URL')} from it if set`);
+    }
+    else if (hasEnvFile) {
+        (0, ui_js_1.info)(`Found ${(0, ui_js_1.cyan)('.env')} — Turbine will use ${(0, ui_js_1.cyan)('DATABASE_URL')} from it if set`);
+    }
+    else {
+        (0, ui_js_1.info)(`No ${(0, ui_js_1.cyan)('DATABASE_URL')} found in environment`);
+    }
+    (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')}`);
+        }
+    }
+    // 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}/`)}`);
+    }
+    else {
+        (0, ui_js_1.info)(`Migrations dir already exists: ${(0, ui_js_1.dim)(migrDir)}`);
+    }
+    // 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}/`)}`);
+    }
+    // Create seed file template
+    const seedDir = config.seedFile.substring(0, config.seedFile.lastIndexOf('/'));
+    if (!(0, node_fs_1.existsSync)(config.seedFile)) {
+        if (!(0, node_fs_1.existsSync)(seedDir)) {
+            (0, node_fs_1.mkdirSync)(seedDir, { recursive: true });
+        }
+        (0, node_fs_1.writeFileSync)(config.seedFile, `/**
+ * Turbine seed file
+ *
+ * Run with: npx turbine seed
+ */
+
+// import { turbine } from '${config.out.replace('./', '')}';
+//
+// const db = turbine({ connectionString: process.env.DATABASE_URL });
+//
+// async function seed() {
+//   console.log('Seeding database...');
+//
+//   // Add your seed data here:
+//   // await db.users.create({ data: { email: 'admin@example.com', name: 'Admin' } });
+//
+//   console.log('Done!');
+//   await db.disconnect();
+// }
+//
+// seed();
+`, 'utf-8');
+        (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(config.seedFile)}`);
+    }
+    // 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, `/**
+ * Turbine schema definition
+ *
+ * Define your database schema in TypeScript.
+ * Use \`npx turbine push\` to sync it to your database.
+ *
+ * @see https://turbineorm.dev
+ */
+
+import { defineSchema } from 'turbine-orm';
+
+export default defineSchema({
+  // Example:
+  // users: {
+  //   id: { type: 'serial', primaryKey: true },
+  //   email: { type: 'text', notNull: true, unique: true },
+  //   name: { type: 'text', notNull: true },
+  //   created_at: { type: 'timestamptz', default: 'NOW()' },
+  // },
+});
+`, 'utf-8');
+        (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(config.schemaFile)}`);
+    }
+    // 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')) {
+            additions.push('generated/turbine/');
+        }
+        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)();
+        (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')}`);
+        }
+    }
+    // Next steps
+    (0, ui_js_1.newline)();
+    (0, ui_js_1.divider)();
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Next steps:')}`);
+    (0, ui_js_1.newline)();
+    if (!url) {
+        console.log(`  ${(0, ui_js_1.dim)('1.')} Set your database URL in ${(0, ui_js_1.cyan)('turbine.config.ts')}`);
+        if (!hasEnvFile && !hasEnvLocal) {
+            console.log(`     ${(0, ui_js_1.dim)('or create a')} ${(0, ui_js_1.cyan)('.env')} ${(0, ui_js_1.dim)('file with')} ${(0, ui_js_1.cyan)('DATABASE_URL=postgres://...')}`);
+        }
+        console.log(`  ${(0, ui_js_1.dim)('2.')} Run ${(0, ui_js_1.cyan)('npx turbine generate')} to introspect your DB`);
+    }
+    else {
+        console.log(`  ${(0, ui_js_1.dim)('1.')} Import the generated client:`);
+        console.log(`     ${(0, ui_js_1.cyan)(`import { turbine } from './${config.out.replace('./', '')}';`)}`);
+        (0, ui_js_1.newline)();
+        console.log(`  ${(0, ui_js_1.dim)('2.')} Create a connection and query:`);
+        console.log(`     ${(0, ui_js_1.dim)('const db = turbine();')}`);
+        console.log(`     ${(0, ui_js_1.dim)('const users = await db.users.findMany();')}`);
+    }
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.dim)('3.')} Create migrations: ${(0, ui_js_1.cyan)('npx turbine migrate create <name>')}`);
+    console.log(`  ${(0, ui_js_1.dim)('4.')} Run migrations:    ${(0, ui_js_1.cyan)('npx turbine migrate up')}`);
+    console.log(`  ${(0, ui_js_1.dim)('5.')} Seed your database: ${(0, ui_js_1.cyan)('npx turbine seed')}`);
+    (0, ui_js_1.newline)();
+}
+// ---------------------------------------------------------------------------
+// Command: generate (pull)
+// ---------------------------------------------------------------------------
+async function cmdGenerate(args, config) {
+    (0, ui_js_1.banner)();
+    const url = requireUrl(config);
+    const startTime = performance.now();
+    (0, ui_js_1.label)('Database', (0, ui_js_1.redactUrl)(url));
+    (0, ui_js_1.label)('Schema', config.schema);
+    (0, ui_js_1.label)('Output', config.out);
+    (0, ui_js_1.newline)();
+    // Introspect
+    const spinner = new ui_js_1.Spinner('Introspecting database schema').start();
+    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 tableNames = Object.keys(schema.tables);
+    const totalColumns = Object.values(schema.tables).reduce((sum, t) => sum + t.columns.length, 0);
+    const totalRelations = Object.values(schema.tables).reduce((sum, t) => sum + Object.keys(t.relations).length, 0);
+    spinner.succeed(`Found ${(0, ui_js_1.bold)(String(tableNames.length))} tables, ${(0, ui_js_1.bold)(String(totalColumns))} columns, ${(0, ui_js_1.bold)(String(totalRelations))} relations`);
+    // Print table summary
+    if (args.verbose) {
+        (0, ui_js_1.newline)();
+        for (const tbl of Object.values(schema.tables)) {
+            const relCount = Object.keys(tbl.relations).length;
+            const pk = tbl.primaryKey.join(', ') || '(none)';
+            console.log(`  ${ui_js_1.symbols.tee} ${(0, ui_js_1.bold)(tbl.name)} ${(0, ui_js_1.dim)(`${tbl.columns.length} cols, PK: ${pk}`)}${relCount > 0 ? (0, ui_js_1.dim)(`, ${relCount} rels`) : ''}`);
+        }
+        (0, ui_js_1.newline)();
+    }
+    if (Object.keys(schema.enums).length > 0) {
+        (0, ui_js_1.info)(`Enums: ${Object.keys(schema.enums).join(', ')}`);
+    }
+    // Generate
+    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 in ${(0, ui_js_1.elapsed)(startTime)}`);
+    // List files
+    for (const file of result.files) {
+        console.log(`    ${(0, ui_js_1.dim)(ui_js_1.symbols.teeEnd)} ${(0, ui_js_1.cyan)(`${result.outDir}/${file}`)}`);
+    }
+    // Usage hint
+    (0, ui_js_1.newline)();
+    (0, ui_js_1.divider)();
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.cyan)(`import { turbine } from './${config.out.replace('./', '')}';`)}`);
+    console.log(`  ${(0, ui_js_1.dim)('const db = turbine({ connectionString: process.env.DATABASE_URL });')}`);
+    console.log(`  ${(0, ui_js_1.dim)('const user = await db.users.findUnique({ where: { id: 1 } });')}`);
+    (0, ui_js_1.newline)();
+}
+// ---------------------------------------------------------------------------
+// Command: push
+// ---------------------------------------------------------------------------
+async function cmdPush(args, config) {
+    (0, ui_js_1.banner)();
+    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 tableCount = Object.keys(schemaDef.tables).length;
+    (0, ui_js_1.info)(`Schema defines ${(0, ui_js_1.bold)(String(tableCount))} tables`);
+    // Compute diff
+    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 && diff.drop.length === 0) {
+        diffSpinner.succeed('Database is already in sync');
+        (0, ui_js_1.newline)();
+        return;
+    }
+    diffSpinner.succeed('Found changes');
+    (0, ui_js_1.newline)();
+    // Show what will happen
+    if (diff.create.length > 0) {
+        console.log(`  ${(0, ui_js_1.green)('+ Create')} ${(0, ui_js_1.bold)(String(diff.create.length))} table(s):`);
+        for (const t of diff.create) {
+            console.log(`    ${(0, ui_js_1.green)(ui_js_1.symbols.arrowRight)} ${t.name}`);
+        }
+        (0, ui_js_1.newline)();
+    }
+    if (diff.alter.length > 0) {
+        console.log(`  ${(0, ui_js_1.yellow)('~ Alter')} ${(0, ui_js_1.bold)(String(diff.alter.length))} table(s):`);
+        for (const a of diff.alter) {
+            console.log(`    ${(0, ui_js_1.yellow)(ui_js_1.symbols.arrowRight)} ${a.table}`);
+            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')
+                        : (0, ui_js_1.yellow)(`~ ${col.action.replace('_', ' ')}`);
+                console.log(`      ${actionLabel} ${col.column}`);
+            }
+        }
+        (0, ui_js_1.newline)();
+    }
+    if (diff.drop.length > 0) {
+        console.log(`  ${(0, ui_js_1.red)('- Extra tables')} in database (not in schema):`);
+        for (const t of diff.drop) {
+            console.log(`    ${(0, ui_js_1.dim)(ui_js_1.symbols.arrowRight)} ${t} ${(0, ui_js_1.dim)('(not dropped automatically)')}`);
+        }
+        (0, ui_js_1.newline)();
+    }
+    // Show SQL
+    if (diff.statements.length > 0) {
+        console.log(`  ${(0, ui_js_1.bold)('SQL to execute:')}`);
+        (0, ui_js_1.newline)();
+        for (const stmt of diff.statements) {
+            for (const line of stmt.split('\n')) {
+                console.log(`  ${(0, ui_js_1.dim)(ui_js_1.symbols.vertLine)} ${(0, ui_js_1.cyan)(line)}`);
+            }
+            console.log(`  ${(0, ui_js_1.dim)(ui_js_1.symbols.vertLine)}`);
+        }
+        (0, ui_js_1.newline)();
+    }
+    if (args.dryRun) {
+        (0, ui_js_1.info)('Dry run — no changes applied.');
+        (0, ui_js_1.newline)();
+        return;
+    }
+    // Execute
+    const pushSpinner = new ui_js_1.Spinner('Applying changes').start();
+    const result = await (0, schema_sql_js_1.schemaPush)(schemaDef, url);
+    pushSpinner.succeed(`Applied ${(0, ui_js_1.bold)(String(result.statementsExecuted))} statement(s)`);
+    if (result.tablesCreated.length > 0) {
+        (0, ui_js_1.success)(`Created: ${result.tablesCreated.join(', ')}`);
+    }
+    if (result.tablesAltered.length > 0) {
+        (0, ui_js_1.success)(`Altered: ${result.tablesAltered.join(', ')}`);
+    }
+    (0, ui_js_1.newline)();
+    (0, ui_js_1.info)(`Run ${(0, ui_js_1.cyan)('npx turbine generate')} to update your TypeScript types.`);
+    (0, ui_js_1.newline)();
+}
+// ---------------------------------------------------------------------------
+// Command: migrate
+// ---------------------------------------------------------------------------
+async function cmdMigrate(args, config) {
+    const sub = args.subcommand;
+    if (!sub || sub === 'help') {
+        (0, ui_js_1.banner)();
+        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)('up')}                    Apply pending migrations`);
+        console.log(`    ${(0, ui_js_1.cyan)('down')}                  Rollback last migration`);
+        console.log(`    ${(0, ui_js_1.cyan)('status')}                Show migration status`);
+        (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)('--step, -n')}     Number of migrations to apply/rollback`);
+        console.log(`    ${(0, ui_js_1.cyan)('--dry-run')}      Show SQL without executing`);
+        (0, ui_js_1.newline)();
+        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 up')}`);
+        console.log(`    ${(0, ui_js_1.dim)('npx turbine migrate down --step 2')}`);
+        (0, ui_js_1.newline)();
+        return;
+    }
+    switch (sub) {
+        case 'create':
+            await cmdMigrateCreate(args, config);
+            break;
+        case 'up':
+            await cmdMigrateUp(args, config);
+            break;
+        case 'down':
+            await cmdMigrateDown(args, config);
+            break;
+        case 'status':
+        case 'list':
+            await cmdMigrateStatus(args, config);
+            break;
+        default:
+            (0, ui_js_1.error)(`Unknown migrate subcommand: ${sub}`);
+            console.log(`  ${(0, ui_js_1.dim)('Run')} ${(0, ui_js_1.cyan)('npx turbine migrate help')} ${(0, ui_js_1.dim)('for usage.')}`);
+            process.exit(1);
+    }
+}
+async function cmdMigrateCreate(args, config) {
+    (0, ui_js_1.banner)();
+    const name = args.positional[0];
+    if (!name) {
+        (0, ui_js_1.error)('Migration name is required.');
+        (0, ui_js_1.newline)();
+        console.log(`  ${(0, ui_js_1.dim)('Usage:')} ${(0, ui_js_1.cyan)('npx turbine migrate create <name>')}`);
+        console.log(`  ${(0, ui_js_1.dim)('Example:')} ${(0, ui_js_1.cyan)('npx turbine migrate create add_users_table')}`);
+        console.log(`  ${(0, ui_js_1.dim)('Auto:')}    ${(0, ui_js_1.cyan)('npx turbine migrate create my_change --auto')}`);
+        (0, ui_js_1.newline)();
+        process.exit(1);
+    }
+    if (args.auto) {
+        // Auto-generate migration from schema diff
+        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 upSQL = diff.statements.join('\n');
+        const downSQL = diff.reverseStatements.join('\n');
+        const file = (0, migrate_js_1.createMigration)(config.migrationsDir, name, { up: upSQL, down: downSQL });
+        const relPath = (0, node_path_1.relative)(process.cwd(), file.path);
+        (0, ui_js_1.success)(`Created auto-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)();
+        // Show summary of changes
+        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)();
+        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;
+    }
+    const file = (0, migrate_js_1.createMigration)(config.migrationsDir, name);
+    const relPath = (0, node_path_1.relative)(process.cwd(), file.path);
+    (0, ui_js_1.success)(`Created 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)();
+    console.log(`  ${(0, ui_js_1.dim)('Edit the file to add your SQL, then run:')}`);
+    console.log(`  ${(0, ui_js_1.cyan)('npx turbine migrate up')}`);
+    (0, ui_js_1.newline)();
+}
+async function cmdMigrateUp(args, config) {
+    (0, ui_js_1.banner)();
+    const url = requireUrl(config);
+    (0, ui_js_1.label)('Database', (0, ui_js_1.redactUrl)(url));
+    (0, ui_js_1.label)('Migrations', config.migrationsDir);
+    (0, ui_js_1.newline)();
+    const allFiles = (0, migrate_js_1.listMigrationFiles)(config.migrationsDir);
+    if (allFiles.length === 0) {
+        (0, ui_js_1.warn)('No migration files found.');
+        console.log(`  ${(0, ui_js_1.dim)('Create one with:')} ${(0, ui_js_1.cyan)('npx turbine migrate create <name>')}`);
+        (0, ui_js_1.newline)();
+        return;
+    }
+    const spinner = new ui_js_1.Spinner('Applying migrations').start();
+    const result = await (0, migrate_js_1.migrateUp)(url, config.migrationsDir, {
+        step: args.step,
+    });
+    if (result.applied.length === 0 && result.errors.length === 0) {
+        spinner.succeed('All migrations are up to date');
+        (0, ui_js_1.newline)();
+        return;
+    }
+    if (result.applied.length > 0) {
+        spinner.succeed(`Applied ${(0, ui_js_1.bold)(String(result.applied.length))} migration(s)`);
+        for (const file of result.applied) {
+            console.log(`    ${(0, ui_js_1.green)(ui_js_1.symbols.check)} ${file.filename}`);
+        }
+    }
+    if (result.errors.length > 0) {
+        spinner.fail('Migration failed');
+        for (const { file, error: msg } of result.errors) {
+            console.log(`    ${(0, ui_js_1.red)(ui_js_1.symbols.cross)} ${file.filename}`);
+            console.log(`      ${(0, ui_js_1.dim)(msg)}`);
+        }
+        (0, ui_js_1.newline)();
+        process.exit(1);
+    }
+    (0, ui_js_1.newline)();
+}
+async function cmdMigrateDown(args, config) {
+    (0, ui_js_1.banner)();
+    const url = requireUrl(config);
+    (0, ui_js_1.label)('Database', (0, ui_js_1.redactUrl)(url));
+    (0, ui_js_1.label)('Migrations', config.migrationsDir);
+    (0, ui_js_1.newline)();
+    const spinner = new ui_js_1.Spinner('Rolling back migration(s)').start();
+    const result = await (0, migrate_js_1.migrateDown)(url, config.migrationsDir, {
+        step: args.step ?? 1,
+    });
+    if (result.rolledBack.length === 0 && result.errors.length === 0) {
+        spinner.succeed('No migrations to roll back');
+        (0, ui_js_1.newline)();
+        return;
+    }
+    if (result.rolledBack.length > 0) {
+        spinner.succeed(`Rolled back ${(0, ui_js_1.bold)(String(result.rolledBack.length))} migration(s)`);
+        for (const file of result.rolledBack) {
+            console.log(`    ${(0, ui_js_1.yellow)(ui_js_1.symbols.arrowRight)} ${file.filename}`);
+        }
+    }
+    if (result.errors.length > 0) {
+        spinner.fail('Rollback failed');
+        for (const { file, error: msg } of result.errors) {
+            console.log(`    ${(0, ui_js_1.red)(ui_js_1.symbols.cross)} ${file.filename}`);
+            console.log(`      ${(0, ui_js_1.dim)(msg)}`);
+        }
+        (0, ui_js_1.newline)();
+        process.exit(1);
+    }
+    (0, ui_js_1.newline)();
+}
+async function cmdMigrateStatus(_args, config) {
+    (0, ui_js_1.banner)();
+    const url = requireUrl(config);
+    (0, ui_js_1.label)('Database', (0, ui_js_1.redactUrl)(url));
+    (0, ui_js_1.label)('Migrations', config.migrationsDir);
+    (0, ui_js_1.newline)();
+    const allFiles = (0, migrate_js_1.listMigrationFiles)(config.migrationsDir);
+    if (allFiles.length === 0) {
+        (0, ui_js_1.warn)('No migration files found.');
+        console.log(`  ${(0, ui_js_1.dim)('Create one with:')} ${(0, ui_js_1.cyan)('npx turbine migrate create <name>')}`);
+        (0, ui_js_1.newline)();
+        return;
+    }
+    const statuses = await (0, migrate_js_1.migrateStatus)(url, config.migrationsDir);
+    const appliedCount = statuses.filter((s) => s.applied).length;
+    const pendingCount = statuses.filter((s) => !s.applied).length;
+    (0, ui_js_1.info)(`${(0, ui_js_1.bold)(String(appliedCount))} applied, ${pendingCount > 0 ? (0, ui_js_1.yellow)((0, ui_js_1.bold)(String(pendingCount))) : (0, ui_js_1.bold)(String(pendingCount))} pending`);
+    (0, ui_js_1.newline)();
+    // Check for checksum mismatches
+    const driftCount = statuses.filter((s) => s.checksumValid === false).length;
+    if (driftCount > 0) {
+        (0, ui_js_1.warn)(`${(0, ui_js_1.bold)(String(driftCount))} migration(s) have been modified after application!`);
+        console.log(`  ${(0, ui_js_1.dim)('Applied migrations should be immutable. Modifying them can cause drift.')}`);
+        (0, ui_js_1.newline)();
+    }
+    // Format as table
+    const headers = ['Status', 'Migration', 'Applied at'];
+    const rows = statuses.map((s) => {
+        let status;
+        if (s.applied && s.checksumValid === false) {
+            status = (0, ui_js_1.red)(`${ui_js_1.symbols.warning} Drifted`);
+        }
+        else if (s.applied) {
+            status = (0, ui_js_1.green)(`${ui_js_1.symbols.check} Applied`);
+        }
+        else {
+            status = (0, ui_js_1.yellow)(`${ui_js_1.symbols.dot} Pending`);
+        }
+        return [
+            status,
+            s.file.filename,
+            s.appliedAt
+                ? (0, ui_js_1.dim)(s.appliedAt
+                    .toISOString()
+                    .replace('T', ' ')
+                    .replace(/\.\d+Z$/, ' UTC'))
+                : (0, ui_js_1.dim)('—'),
+        ];
+    });
+    console.log((0, ui_js_1.table)(headers, rows));
+    (0, ui_js_1.newline)();
+    if (pendingCount > 0) {
+        console.log(`  ${(0, ui_js_1.dim)('Run')} ${(0, ui_js_1.cyan)('npx turbine migrate up')} ${(0, ui_js_1.dim)('to apply pending migrations.')}`);
+        (0, ui_js_1.newline)();
+    }
+}
+// ---------------------------------------------------------------------------
+// Command: seed
+// ---------------------------------------------------------------------------
+async function cmdSeed(_args, config) {
+    (0, ui_js_1.banner)();
+    const seedFile = (0, node_path_1.resolve)(config.seedFile);
+    (0, ui_js_1.label)('Seed file', config.seedFile);
+    (0, ui_js_1.newline)();
+    if (!(0, node_fs_1.existsSync)(seedFile)) {
+        (0, ui_js_1.error)(`Seed file not found: ${config.seedFile}`);
+        (0, ui_js_1.newline)();
+        console.log(`  ${(0, ui_js_1.dim)('Create one with:')} ${(0, ui_js_1.cyan)('npx turbine init')}`);
+        console.log(`  ${(0, ui_js_1.dim)('Or set a custom path in')} ${(0, ui_js_1.cyan)('turbine.config.ts')}`);
+        (0, ui_js_1.newline)();
+        process.exit(1);
+    }
+    const spinner = new ui_js_1.Spinner('Running seed file').start();
+    try {
+        // Use child_process to run the seed file via tsx or node
+        const { execFileSync } = await Promise.resolve().then(() => __importStar(require('node:child_process')));
+        // Try tsx first (most compatible with .ts files), fall back to node --experimental-strip-types
+        const runners = [
+            { cmd: 'npx', args: ['tsx', seedFile], name: 'tsx' },
+            { cmd: 'node', args: ['--experimental-strip-types', seedFile], name: 'node' },
+        ];
+        let ran = false;
+        for (const runner of runners) {
+            try {
+                execFileSync(runner.cmd, runner.args, {
+                    stdio: 'inherit',
+                    env: {
+                        ...process.env,
+                        DATABASE_URL: config.url || process.env.DATABASE_URL,
+                    },
+                });
+                ran = true;
+                break;
+            }
+            catch (err) {
+                // If tsx not found, try next runner
+                if (err instanceof Error && 'status' in err && err.status === null) {
+                    continue;
+                }
+                throw err;
+            }
+        }
+        if (!ran) {
+            throw new Error('Could not find tsx or compatible Node.js version to run .ts files');
+        }
+        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))}`);
+        }
+        (0, ui_js_1.newline)();
+        process.exit(1);
+    }
+    (0, ui_js_1.newline)();
+}
+// ---------------------------------------------------------------------------
+// Command: status
+// ---------------------------------------------------------------------------
+async function cmdStatus(_args, config) {
+    (0, ui_js_1.banner)();
+    const url = requireUrl(config);
+    (0, ui_js_1.label)('Database', (0, ui_js_1.redactUrl)(url));
+    (0, ui_js_1.label)('Schema', config.schema);
+    (0, ui_js_1.newline)();
+    const spinner = new ui_js_1.Spinner('Introspecting database').start();
+    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 tableNames = Object.keys(schema.tables);
+    spinner.succeed(`Found ${(0, ui_js_1.bold)(String(tableNames.length))} tables`);
+    (0, ui_js_1.newline)();
+    for (const tbl of Object.values(schema.tables)) {
+        const relCount = Object.keys(tbl.relations).length;
+        const _pk = tbl.primaryKey.join(', ') || (0, ui_js_1.dim)('(none)');
+        console.log(`  ${(0, ui_js_1.bold)((0, ui_js_1.cyan)(tbl.name))}`);
+        for (let i = 0; i < tbl.columns.length; i++) {
+            const col = tbl.columns[i];
+            const isLast = i === tbl.columns.length - 1 && relCount === 0;
+            const prefix = isLast ? ui_js_1.symbols.teeEnd : ui_js_1.symbols.tee;
+            const nullable = col.nullable ? (0, ui_js_1.dim)('?') : '';
+            const def = col.hasDefault ? (0, ui_js_1.dim)(' (default)') : '';
+            const pkLabel = tbl.primaryKey.includes(col.name) ? ` ${(0, ui_js_1.magenta)('PK')}` : '';
+            console.log(`    ${(0, ui_js_1.dim)(prefix)} ${col.field}${nullable}: ${(0, ui_js_1.green)(col.tsType)}${pkLabel}${def}  ${(0, ui_js_1.gray)(`${ui_js_1.symbols.arrow} ${col.pgType}`)}`);
+        }
+        const rels = Object.entries(tbl.relations);
+        if (rels.length > 0) {
+            for (let i = 0; i < rels.length; i++) {
+                const [relName, rel] = rels[i];
+                const isLast = i === rels.length - 1;
+                const prefix = isLast ? ui_js_1.symbols.teeEnd : ui_js_1.symbols.tee;
+                const relColor = rel.type === 'hasMany' ? ui_js_1.blue : ui_js_1.yellow;
+                console.log(`    ${(0, ui_js_1.dim)(prefix)} ${relColor(relName)} ${(0, ui_js_1.dim)(ui_js_1.symbols.arrow)} ${rel.to} ${(0, ui_js_1.dim)(`(${rel.type}, FK: ${rel.foreignKey})`)}`);
+            }
+        }
+        (0, ui_js_1.newline)();
+    }
+    if (Object.keys(schema.enums).length > 0) {
+        console.log(`  ${(0, ui_js_1.bold)('Enums:')}`);
+        for (const [enumName, labels] of Object.entries(schema.enums)) {
+            console.log(`    ${(0, ui_js_1.cyan)(enumName)}: ${labels.map((l) => (0, ui_js_1.green)(`'${l}'`)).join((0, ui_js_1.dim)(' | '))}`);
+        }
+        (0, ui_js_1.newline)();
+    }
+}
+// ---------------------------------------------------------------------------
+// Command: studio (scaffold)
+// ---------------------------------------------------------------------------
+async function cmdStudio(_args, _config) {
+    (0, ui_js_1.banner)();
+    console.log((0, ui_js_1.box)([
+        `${(0, ui_js_1.bold)('Turbine Studio')} ${(0, ui_js_1.dim)('— coming soon')}`,
+        '',
+        'A local web UI for browsing your database,',
+        'exploring relations, and managing data.',
+        '',
+        `Follow ${(0, ui_js_1.cyan)('@turbineorm')} for updates.`,
+    ].join('\n'), { title: (0, ui_js_1.bold)((0, ui_js_1.cyan)('Studio')), padding: 2 }));
+    (0, ui_js_1.newline)();
+}
+// ---------------------------------------------------------------------------
+// Subcommand help
+// ---------------------------------------------------------------------------
+function showSubcommandHelp(command) {
+    const helpMap = {
+        init: showInitHelp,
+        generate: showGenerateHelp,
+        pull: showGenerateHelp,
+        push: showPushHelp,
+        migrate: showMigrateHelp,
+        migration: showMigrateHelp,
+        seed: showSeedHelp,
+        status: showStatusHelp,
+    };
+    const fn = helpMap[command];
+    if (fn) {
+        fn();
+        return true;
+    }
+    return false;
+}
+function showInitHelp() {
+    (0, ui_js_1.banner)();
+    console.log(`  ${(0, ui_js_1.bold)('turbine init')} — Initialize a Turbine project`);
+    (0, ui_js_1.newline)();
+    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.`);
+    (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`);
+    (0, ui_js_1.newline)();
+}
+function showGenerateHelp() {
+    (0, ui_js_1.banner)();
+    console.log(`  ${(0, ui_js_1.bold)('turbine generate')} — Introspect database and generate TypeScript types`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
+    console.log(`    npx turbine generate ${(0, ui_js_1.dim)('[options]')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  Connects to your database, reads the schema, and generates:`);
+    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('types.ts')}    — Entity interfaces, Create/Update input types`);
+    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('metadata.ts')} — Runtime schema metadata`);
+    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('index.ts')}    — Configured client with typed table accessors`);
+    (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`);
+    console.log(`    ${(0, ui_js_1.cyan)('--out, -o')} ${(0, ui_js_1.dim)('<dir>')}       Output directory ${(0, ui_js_1.dim)('(default: ./generated/turbine)')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--schema, -s')} ${(0, ui_js_1.dim)('<name>')}   Postgres schema ${(0, ui_js_1.dim)('(default: public)')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--include')} ${(0, ui_js_1.dim)('<tables>')}    Comma-separated tables to include`);
+    console.log(`    ${(0, ui_js_1.cyan)('--exclude')} ${(0, ui_js_1.dim)('<tables>')}    Comma-separated tables to exclude`);
+    (0, ui_js_1.newline)();
+}
+function showPushHelp() {
+    (0, ui_js_1.banner)();
+    console.log(`  ${(0, ui_js_1.bold)('turbine push')} — Apply schema-builder definitions to database`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
+    console.log(`    npx turbine push ${(0, ui_js_1.dim)('[options]')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  Reads your ${(0, ui_js_1.cyan)('turbine/schema.ts')} file, diffs against the live database,`);
+    console.log(`  and applies CREATE/ALTER statements.`);
+    (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`);
+    console.log(`    ${(0, ui_js_1.cyan)('--dry-run')}          Show SQL without executing`);
+    console.log(`    ${(0, ui_js_1.cyan)('--verbose, -v')}      Show detailed output`);
+    (0, ui_js_1.newline)();
+}
+function showMigrateHelp() {
+    (0, ui_js_1.banner)();
+    console.log(`  ${(0, ui_js_1.bold)('turbine migrate')} — SQL migration management`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
+    console.log(`    npx turbine migrate ${(0, ui_js_1.cyan)('<subcommand>')} ${(0, ui_js_1.dim)('[options]')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Subcommands:')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('create')} ${(0, ui_js_1.dim)('<name>')}   Create a new migration file`);
+    console.log(`    ${(0, ui_js_1.cyan)('up')}              Apply pending migrations`);
+    console.log(`    ${(0, ui_js_1.cyan)('down')}            Rollback last migration`);
+    console.log(`    ${(0, ui_js_1.cyan)('status')}          Show applied/pending migrations`);
+    (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`);
+    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`);
+    console.log(`    ${(0, ui_js_1.cyan)('--verbose, -v')}      Show detailed output`);
+    (0, ui_js_1.newline)();
+    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 up`);
+    console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate down --step 2`);
+    console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate status`);
+    (0, ui_js_1.newline)();
+}
+function showSeedHelp() {
+    (0, ui_js_1.banner)();
+    console.log(`  ${(0, ui_js_1.bold)('turbine seed')} — Run seed file`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
+    console.log(`    npx turbine seed ${(0, ui_js_1.dim)('[options]')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  Runs the seed file specified in ${(0, ui_js_1.cyan)('turbine.config.ts')}`);
+    console.log(`  ${(0, ui_js_1.dim)('(default: ./turbine/seed.ts)')}`);
+    (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`);
+    (0, ui_js_1.newline)();
+}
+function showStatusHelp() {
+    (0, ui_js_1.banner)();
+    console.log(`  ${(0, ui_js_1.bold)('turbine status')} — Show database schema summary`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
+    console.log(`    npx turbine status ${(0, ui_js_1.dim)('[options]')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  Introspects your database and displays tables, columns,`);
+    console.log(`  types, relations, and indexes.`);
+    (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`);
+    console.log(`    ${(0, ui_js_1.cyan)('--schema, -s')} ${(0, ui_js_1.dim)('<name>')}   Postgres schema ${(0, ui_js_1.dim)('(default: public)')}`);
+    (0, ui_js_1.newline)();
+}
+// ---------------------------------------------------------------------------
+// Help
+// ---------------------------------------------------------------------------
+function showHelp() {
+    (0, ui_js_1.banner)();
+    console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
+    console.log(`    npx turbine ${(0, ui_js_1.cyan)('<command>')} ${(0, ui_js_1.dim)('[options]')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Commands:')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('init')}               Initialize a Turbine project`);
+    console.log(`    ${(0, ui_js_1.cyan)('generate')} ${(0, ui_js_1.dim)('| pull')}   Introspect database ${ui_js_1.symbols.arrow} generate types`);
+    console.log(`    ${(0, ui_js_1.cyan)('push')}               Apply schema definitions to database`);
+    console.log(`    ${(0, ui_js_1.cyan)('migrate')} ${(0, ui_js_1.dim)('<sub>')}     SQL migration management`);
+    console.log(`      ${(0, ui_js_1.dim)('create <name>')}     Create a new migration file`);
+    console.log(`      ${(0, ui_js_1.dim)('up')}               Apply pending migrations`);
+    console.log(`      ${(0, ui_js_1.dim)('down')}             Rollback last migration`);
+    console.log(`      ${(0, ui_js_1.dim)('status')}           Show applied/pending migrations`);
+    console.log(`    ${(0, ui_js_1.cyan)('seed')}               Run seed file`);
+    console.log(`    ${(0, ui_js_1.cyan)('status')} ${(0, ui_js_1.dim)('| info')}     Show schema summary`);
+    console.log(`    ${(0, ui_js_1.cyan)('studio')}             Launch web UI (coming soon)`);
+    (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`);
+    console.log(`    ${(0, ui_js_1.cyan)('--out, -o')} ${(0, ui_js_1.dim)('<dir>')}      Output directory ${(0, ui_js_1.dim)('(default: ./generated/turbine)')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--schema, -s')} ${(0, ui_js_1.dim)('<name>')}  Postgres schema ${(0, ui_js_1.dim)('(default: public)')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--include')} ${(0, ui_js_1.dim)('<tables>')}   Comma-separated tables to include`);
+    console.log(`    ${(0, ui_js_1.cyan)('--exclude')} ${(0, ui_js_1.dim)('<tables>')}   Comma-separated tables to exclude`);
+    console.log(`    ${(0, ui_js_1.cyan)('--dry-run')}            Show SQL without executing`);
+    console.log(`    ${(0, ui_js_1.cyan)('--verbose, -v')}        Show detailed output`);
+    console.log(`    ${(0, ui_js_1.cyan)('--force, -f')}          Overwrite existing files`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Config file:')}`);
+    console.log(`    ${(0, ui_js_1.dim)('Create')} ${(0, ui_js_1.cyan)('turbine.config.ts')} ${(0, ui_js_1.dim)('with')} ${(0, ui_js_1.cyan)('npx turbine init')}`);
+    console.log(`    ${(0, ui_js_1.dim)('CLI flags override config file values.')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Examples:')}`);
+    console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine init --url postgres://user:pass@host/db`);
+    console.log(`    ${(0, ui_js_1.dim)('$')} DATABASE_URL=postgres://... npx turbine generate`);
+    console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate create add_users_table`);
+    console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate up`);
+    console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine push --dry-run`);
+    (0, ui_js_1.newline)();
+}
+// ---------------------------------------------------------------------------
+// Version
+// ---------------------------------------------------------------------------
+function showVersion() {
+    console.log(`turbine-orm v0.5.0`);
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+    const args = parseArgs();
+    // Quick exits that don't need config
+    if (args.command === 'help' || args.command === '--help' || args.command === '-h') {
+        showHelp();
+        return;
+    }
+    // Subcommand help: e.g. `turbine migrate --help`
+    if (args.help) {
+        if (showSubcommandHelp(args.command))
+            return;
+        showHelp();
+        return;
+    }
+    if (args.command === 'version' || args.command === '--version' || args.command === '-V') {
+        showVersion();
+        return;
+    }
+    // Load config file
+    let fileConfig = {};
+    try {
+        fileConfig = await (0, config_js_1.loadConfig)();
+    }
+    catch (err) {
+        if (args.command !== 'init') {
+            (0, ui_js_1.warn)(`Could not load config: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const overrides = {
+        url: args.url,
+        out: args.out,
+        schema: args.schema,
+        include: args.include,
+        exclude: args.exclude,
+    };
+    const config = (0, config_js_1.resolveConfig)(fileConfig, overrides);
+    try {
+        switch (args.command) {
+            case 'init':
+                await cmdInit(args, config);
+                break;
+            case 'generate':
+            case 'gen':
+            case 'g':
+            case 'pull':
+                await cmdGenerate(args, config);
+                break;
+            case 'push':
+                await cmdPush(args, config);
+                break;
+            case 'migrate':
+            case 'migration':
+            case 'm':
+                await cmdMigrate(args, config);
+                break;
+            case 'seed':
+            case 's':
+                await cmdSeed(args, config);
+                break;
+            case 'status':
+            case 'info':
+                await cmdStatus(args, config);
+                break;
+            case 'studio':
+                await cmdStudio(args, config);
+                break;
+            default:
+                (0, ui_js_1.error)(`Unknown command: ${(0, ui_js_1.bold)(args.command)}`);
+                (0, ui_js_1.newline)();
+                console.log(`  ${(0, ui_js_1.dim)('Run')} ${(0, ui_js_1.cyan)('npx turbine help')} ${(0, ui_js_1.dim)('for available commands.')}`);
+                (0, ui_js_1.newline)();
+                process.exit(1);
+        }
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            if (err.message.includes('ECONNREFUSED') || err.message.includes('connection')) {
+                (0, ui_js_1.newline)();
+                (0, ui_js_1.error)(`Could not connect to database`);
+                console.log(`  ${(0, ui_js_1.dim)((0, ui_js_1.redactUrl)(err.message))}`);
+                (0, ui_js_1.newline)();
+                console.log(`  ${(0, ui_js_1.dim)('Check that:')}`);
+                console.log(`    ${(0, ui_js_1.dim)('1.')} Your database is running`);
+                console.log(`    ${(0, ui_js_1.dim)('2.')} The connection string is correct`);
+                console.log(`    ${(0, ui_js_1.dim)('3.')} Network/firewall allows the connection`);
+            }
+            else if (err.message.includes('authentication')) {
+                (0, ui_js_1.newline)();
+                (0, ui_js_1.error)(`Authentication failed`);
+                console.log(`  ${(0, ui_js_1.dim)((0, ui_js_1.redactUrl)(err.message))}`);
+            }
+            else if (err.message.includes('does not exist')) {
+                (0, ui_js_1.newline)();
+                (0, ui_js_1.error)(`Database or schema not found`);
+                console.log(`  ${(0, ui_js_1.dim)((0, ui_js_1.redactUrl)(err.message))}`);
+            }
+            else {
+                (0, ui_js_1.newline)();
+                (0, ui_js_1.error)((0, ui_js_1.redactUrl)(err.message));
+                if (args.verbose && err.stack) {
+                    (0, ui_js_1.newline)();
+                    console.log((0, ui_js_1.dim)((0, ui_js_1.redactUrl)(err.stack)));
+                }
+            }
+        }
+        else {
+            (0, ui_js_1.newline)();
+            (0, ui_js_1.error)(`Unexpected error: ${(0, ui_js_1.redactUrl)(String(err))}`);
+        }
+        (0, ui_js_1.newline)();
+        process.exit(1);
+    }
+}
+main();