turbine-orm 0.27.0 → 0.28.0

package/dist/cjs/cli/index.js

@@ -9,12 +9,14 @@
  *   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 deploy        — Apply pending migrations without prompts
  *   turbine migrate down          — Rollback last migration
  *   turbine migrate status        — Show migration status
  *   turbine seed                  — Run seed file
  *   turbine status                — Show schema summary
  *   turbine doctor                — Check relations for missing FK indexes (--fix emits migration)
  *   turbine studio                — Launch local read-only web UI
+ *   turbine mcp                   — Start read-only MCP server over JSON-RPC stdio
  *   turbine observe               — Launch metrics dashboard (requires TURBINE_OBSERVE_URL)
  *
  * Usage:
@@ -56,6 +58,10 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+exports.buildMigrateDeployOptions = buildMigrateDeployOptions;
+exports.getSeedExecutionPlan = getSeedExecutionPlan;
+exports.isLoopbackHost = isLoopbackHost;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_url_1 = require("node:url");
@@ -65,12 +71,13 @@ const introspect_js_1 = require("../introspect.js");
 const schema_sql_js_1 = require("../schema-sql.js");
 const config_js_1 = require("./config.js");
 const loader_js_1 = require("./loader.js");
+const mcp_js_1 = require("./mcp.js");
 const migrate_js_1 = require("./migrate.js");
 const observe_js_1 = require("./observe.js");
 const studio_js_1 = require("./studio.js");
 const ui_js_1 = require("./ui.js");
-function parseArgs() {
-    const args = process.argv.slice(2);
+function parseArgs(argv = process.argv.slice(2)) {
+    const args = argv;
     const result = {
         command: args[0] ?? 'help',
         positional: [],
@@ -128,6 +135,12 @@ function parseArgs() {
             case '--fix':
                 result.fix = true;
                 break;
+            case '--zod':
+                result.zod = true;
+                break;
+            case '--include-views':
+                result.includeViews = true;
+                break;
             case '--allow-destructive':
                 result.allowDestructive = true;
                 break;
@@ -154,6 +167,9 @@ function parseArgs() {
             case '--no-open':
                 result.noOpen = true;
                 break;
+            case '--allow-remote':
+                result.allowRemote = true;
+                break;
             default:
                 if (!arg.startsWith('-')) {
                     result.positional.push(arg);
@@ -332,34 +348,30 @@ async function cmdInit(args, config) {
         (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)) {
+    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)(config.seedFile, `/**
+        (0, node_fs_1.writeFileSync)(initSeedFile, `/**
  * 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();
+import { defineSeed } from 'turbine-orm';
+
+export default defineSeed(async (db) => {
+  console.log('Seeding database...');
+
+  // Add your seed data here:
+  // await db.raw\`INSERT INTO users (email, name) VALUES (\${'admin@example.com'}, \${'Admin'})\`;
+
+  console.log('Done!');
+});
 `, 'utf-8');
-        (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(config.seedFile)}`);
+        (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(initSeedFile)}`);
     }
     // Create schema builder template
     if (!(0, node_fs_1.existsSync)(config.schemaFile)) {
@@ -501,6 +513,7 @@ async function cmdGenerate(args, config) {
         schema: config.schema,
         include: config.include.length ? config.include : undefined,
         exclude: config.exclude.length ? config.exclude : undefined,
+        includeViews: args.includeViews,
     });
     const tableNames = Object.keys(schema.tables);
     const totalColumns = Object.values(schema.tables).reduce((sum, t) => sum + t.columns.length, 0);
@@ -543,6 +556,7 @@ async function cmdGenerate(args, config) {
         schema,
         outDir: config.out,
         connectionString: url,
+        zod: args.zod,
     });
     genSpinner.succeed(`Generated ${(0, ui_js_1.bold)(String(result.files.length))} files in ${(0, ui_js_1.elapsed)(startTime)}`);
     // List files
@@ -656,6 +670,7 @@ async function cmdMigrate(args, config) {
         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)('deploy')}                Apply pending migrations without prompts`);
         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)();
@@ -669,6 +684,7 @@ async function cmdMigrate(args, config) {
         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 deploy --dry-run')}`);
         console.log(`    ${(0, ui_js_1.dim)('npx turbine migrate down --step 2')}`);
         (0, ui_js_1.newline)();
         return;
@@ -680,6 +696,9 @@ async function cmdMigrate(args, config) {
         case 'up':
             await cmdMigrateUp(args, config);
             break;
+        case 'deploy':
+            await cmdMigrateDeploy(args, config);
+            break;
         case 'down':
             await cmdMigrateDown(args, config);
             break;
@@ -838,6 +857,67 @@ async function cmdMigrateUp(args, config) {
     }
     (0, ui_js_1.newline)();
 }
+function buildMigrateDeployOptions(_args) {
+    return {
+        allowDrift: false,
+        allowDestructive: true,
+        step: undefined,
+    };
+}
+async function cmdMigrateDeploy(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)();
+    if (args.dryRun) {
+        const spinner = new ui_js_1.Spinner('Checking pending migrations').start();
+        const plan = await (0, migrate_js_1.inspectMigrationDeploy)(url, config.migrationsDir);
+        if (plan.mismatches.length > 0) {
+            spinner.fail('Deploy blocked by migration drift');
+            for (const mismatch of plan.mismatches) {
+                const reason = mismatch.type === 'missing' ? 'deleted from disk' : 'modified on disk';
+                console.log(`    ${(0, ui_js_1.red)(ui_js_1.symbols.cross)} ${mismatch.name}.sql ${(0, ui_js_1.dim)(`(${reason})`)}`);
+            }
+            (0, ui_js_1.newline)();
+            process.exit(1);
+        }
+        if (plan.pending.length === 0) {
+            spinner.succeed('No pending migrations');
+            (0, ui_js_1.newline)();
+            return;
+        }
+        spinner.succeed(`${(0, ui_js_1.bold)(String(plan.pending.length))} pending migration(s)`);
+        for (const file of plan.pending) {
+            console.log(`    ${(0, ui_js_1.yellow)(ui_js_1.symbols.dot)} ${file.filename}`);
+        }
+        (0, ui_js_1.newline)();
+        return;
+    }
+    const spinner = new ui_js_1.Spinner('Deploying migrations').start();
+    const result = await (0, migrate_js_1.migrateDeploy)(url, config.migrationsDir);
+    if (result.applied.length === 0 && result.errors.length === 0) {
+        spinner.succeed('0 applied — all migrations are up to date');
+        (0, ui_js_1.newline)();
+        return;
+    }
+    if (result.applied.length > 0) {
+        spinner.succeed(`${(0, ui_js_1.bold)(String(result.applied.length))} applied`);
+        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('Deploy 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)();
+}
 /** True when the error is migrate up/down's destructive-statement refusal. */
 function isDestructiveRefusal(err) {
     return err instanceof Error && err.message.includes('DESTRUCTIVE');
@@ -983,55 +1063,81 @@ async function cmdMigrateStatus(_args, config) {
         (0, ui_js_1.newline)();
     }
 }
-// ---------------------------------------------------------------------------
-// Command: seed
-// ---------------------------------------------------------------------------
+function getSeedExecutionPlan(seedFile) {
+    const ext = (0, node_path_1.extname)(seedFile).toLowerCase();
+    if (ext === '.ts' || ext === '.mts' || ext === '.cts') {
+        return { kind: 'tsx', command: 'npx', args: ['tsx', seedFile] };
+    }
+    if (ext === '.js' || ext === '.mjs' || ext === '.cjs') {
+        return { kind: 'js', file: seedFile };
+    }
+    if (ext === '.sql') {
+        return { kind: 'sql', file: seedFile };
+    }
+    throw new Error(`Unsupported seed file extension: ${ext || '(none)'}. Use seed.ts, seed.js, or seed.sql.`);
+}
+async function runSeedPlan(plan, config) {
+    const oldDatabaseUrl = process.env.DATABASE_URL;
+    if (config.url)
+        process.env.DATABASE_URL = config.url;
+    try {
+        if (plan.kind === 'tsx') {
+            if (!(0, loader_js_1.canResolveTsx)()) {
+                throw new Error('TypeScript seed files require tsx — install tsx or use seed.js/seed.sql.');
+            }
+            const { execFileSync } = await Promise.resolve().then(() => __importStar(require('node:child_process')));
+            execFileSync(plan.command, plan.args, {
+                stdio: 'inherit',
+                env: {
+                    ...process.env,
+                    DATABASE_URL: config.url || process.env.DATABASE_URL,
+                },
+            });
+            return;
+        }
+        if (plan.kind === 'js') {
+            const mod = await Promise.resolve(`${(0, node_url_1.pathToFileURL)(plan.file).href}`).then(s => __importStar(require(s)));
+            if (typeof mod.default === 'function') {
+                await mod.default();
+            }
+            return;
+        }
+        const url = requireUrl(config);
+        const { default: pg } = await Promise.resolve().then(() => __importStar(require('pg')));
+        const client = new pg.Client({ connectionString: url });
+        await client.connect();
+        try {
+            await client.query((0, node_fs_1.readFileSync)(plan.file, 'utf-8'));
+        }
+        finally {
+            await client.end();
+        }
+    }
+    finally {
+        if (oldDatabaseUrl === undefined) {
+            delete process.env.DATABASE_URL;
+        }
+        else {
+            process.env.DATABASE_URL = oldDatabaseUrl;
+        }
+    }
+}
 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);
+    const seedFile = (0, config_js_1.resolveSeedFile)(config);
+    (0, ui_js_1.label)('Seed file', seedFile ? (0, node_path_1.relative)(process.cwd(), seedFile) || seedFile : '(not found)');
     (0, ui_js_1.newline)();
-    if (!(0, node_fs_1.existsSync)(seedFile)) {
-        (0, ui_js_1.error)(`Seed file not found: ${config.seedFile}`);
+    if (!seedFile || !(0, node_fs_1.existsSync)(seedFile)) {
+        (0, ui_js_1.error)(`Seed file not found.`);
         (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')}`);
+        console.log(`  ${(0, ui_js_1.dim)('Create one of:')} ${(0, ui_js_1.cyan)('seed.ts')}${(0, ui_js_1.dim)(',')} ${(0, ui_js_1.cyan)('seed.js')}${(0, ui_js_1.dim)(',')} ${(0, ui_js_1.cyan)('seed.sql')}`);
+        console.log(`  ${(0, ui_js_1.dim)('Or set')} ${(0, ui_js_1.cyan)('seed')} ${(0, ui_js_1.dim)('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');
-        }
+        await runSeedPlan(getSeedExecutionPlan(seedFile), config);
         spinner.succeed('Seed completed');
     }
     catch (err) {
@@ -1172,6 +1278,17 @@ async function cmdDoctor(args, config) {
     }
 }
 // ---------------------------------------------------------------------------
+// Loopback host gate (Studio / Observe)
+// ---------------------------------------------------------------------------
+/**
+ * True when `host` is a loopback address Studio/Observe may bind without
+ * `--allow-remote`. Accepts IPv4, IPv6, and the common bracket form.
+ */
+function isLoopbackHost(host) {
+    const h = host.trim().toLowerCase();
+    return h === '127.0.0.1' || h === 'localhost' || h === '::1' || h === '[::1]';
+}
+// ---------------------------------------------------------------------------
 // Command: studio — local read-only web UI
 // ---------------------------------------------------------------------------
 async function cmdStudio(args, config) {
@@ -1184,11 +1301,18 @@ async function cmdStudio(args, config) {
         console.log((0, ui_js_1.red)(`✗ invalid port: ${args.port}`));
         process.exit(1);
     }
-    // Warn loudly when an explicit non-loopback --host is used — the user is
-    // opting in, so we proceed rather than refuse. Studio has no real
-    // authentication beyond a random session token, so exposing it on a LAN
-    // interface is foot-gun territory.
-    if (host !== '127.0.0.1' && host !== 'localhost' && host !== '::1') {
+    // Non-loopback binds require an explicit --allow-remote opt-in. Studio has
+    // only a random session token — exposing it on a LAN interface is foot-gun
+    // territory, so we refuse rather than warn-and-proceed.
+    if (!isLoopbackHost(host)) {
+        if (!args.allowRemote) {
+            (0, ui_js_1.error)(`Studio refuses to bind to ${(0, ui_js_1.yellow)(host)} without ${(0, ui_js_1.cyan)('--allow-remote')}.`);
+            (0, ui_js_1.newline)();
+            console.log(`  ${(0, ui_js_1.dim)('Loopback only by default')} ${(0, ui_js_1.dim)('(127.0.0.1, localhost, ::1).')}`);
+            console.log(`  ${(0, ui_js_1.dim)('Pass')} ${(0, ui_js_1.cyan)('--allow-remote')} ${(0, ui_js_1.dim)('to opt in to network exposure.')}`);
+            (0, ui_js_1.newline)();
+            process.exit(1);
+        }
         console.log((0, ui_js_1.warn)(`Studio is binding to ${(0, ui_js_1.yellow)(host)} — this is NOT loopback. ` +
             `Anyone on your network who can reach this port + guess the session token can read your database.`));
     }
@@ -1240,6 +1364,19 @@ async function cmdStudio(args, config) {
     });
 }
 // ---------------------------------------------------------------------------
+// Command: mcp — read-only JSON-RPC stdio server
+// ---------------------------------------------------------------------------
+async function cmdMcp(_args, config) {
+    const url = requireUrl(config);
+    await (0, mcp_js_1.runMcpServer)({
+        url,
+        schema: config.schema,
+        migrationsDir: config.migrationsDir,
+        include: config.include.length ? config.include : undefined,
+        exclude: config.exclude.length ? config.exclude : undefined,
+    });
+}
+// ---------------------------------------------------------------------------
 // Command: observe
 // ---------------------------------------------------------------------------
 async function cmdObserve(args) {
@@ -1260,9 +1397,17 @@ async function cmdObserve(args) {
         console.log((0, ui_js_1.red)(`✗ invalid port: ${args.port}`));
         process.exit(1);
     }
-    // Warn loudly when an explicit non-loopback --host is used — the user is
-    // opting in, so we proceed rather than refuse.
-    if (host !== '127.0.0.1' && host !== 'localhost' && host !== '::1') {
+    // Non-loopback binds require an explicit --allow-remote opt-in (same model
+    // as Studio). Refuse without the flag; warn loudly when opted in.
+    if (!isLoopbackHost(host)) {
+        if (!args.allowRemote) {
+            (0, ui_js_1.error)(`Observe refuses to bind to ${(0, ui_js_1.yellow)(host)} without ${(0, ui_js_1.cyan)('--allow-remote')}.`);
+            (0, ui_js_1.newline)();
+            console.log(`  ${(0, ui_js_1.dim)('Loopback only by default')} ${(0, ui_js_1.dim)('(127.0.0.1, localhost, ::1).')}`);
+            console.log(`  ${(0, ui_js_1.dim)('Pass')} ${(0, ui_js_1.cyan)('--allow-remote')} ${(0, ui_js_1.dim)('to opt in to network exposure.')}`);
+            (0, ui_js_1.newline)();
+            process.exit(1);
+        }
         console.log((0, ui_js_1.warn)(`Observe is binding to ${(0, ui_js_1.yellow)(host)} — this is NOT loopback. ` +
             `Anyone on your network who can reach this port + guess the session token can read your metrics.`));
     }
@@ -1313,6 +1458,7 @@ function showSubcommandHelp(command) {
         migration: showMigrateHelp,
         seed: showSeedHelp,
         status: showStatusHelp,
+        mcp: showMcpHelp,
     };
     const fn = helpMap[command];
     if (fn) {
@@ -1347,6 +1493,7 @@ function showGenerateHelp() {
     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`);
+    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('zod.ts')}      — Zod schemas ${(0, ui_js_1.dim)('(with --zod)')}`);
     (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`);
@@ -1354,6 +1501,8 @@ function showGenerateHelp() {
     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)('--zod')}                 Also emit ${(0, ui_js_1.cyan)('zod.ts')} validation schemas ${(0, ui_js_1.dim)('(needs the zod dep)')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--include-views')}       Include views + materialized views as read-only entities`);
     console.log(`    ${(0, ui_js_1.cyan)('--allow-empty')}         Generate even when introspection matches 0 tables`);
     (0, ui_js_1.newline)();
 }
@@ -1383,6 +1532,7 @@ function showMigrateHelp() {
     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)('deploy')}          Apply pending migrations without prompts`);
     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)();
@@ -1399,6 +1549,7 @@ function showMigrateHelp() {
     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 deploy --dry-run`);
     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)();
@@ -1411,7 +1562,9 @@ function showSeedHelp() {
     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)')}`);
+    console.log(`  ${(0, ui_js_1.dim)('or the first default candidate: ./seed.ts, ./seed.js, ./seed.sql')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.dim)('TypeScript seeds run with')} ${(0, ui_js_1.cyan)('npx tsx')} ${(0, ui_js_1.dim)('and can export')} ${(0, ui_js_1.cyan)('defineSeed(fn)')}${(0, ui_js_1.dim)('.')}`);
     (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`);
@@ -1432,6 +1585,23 @@ function showStatusHelp() {
     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)();
 }
+function showMcpHelp() {
+    (0, ui_js_1.banner)();
+    console.log(`  ${(0, ui_js_1.bold)('turbine mcp')} — Start read-only MCP server over stdio`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
+    console.log(`    npx turbine mcp ${(0, ui_js_1.dim)('[options]')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  Speaks newline-delimited JSON-RPC 2.0 on stdin/stdout and exposes`);
+    console.log(`  schema, migration status, doctor, EXPLAIN, and sample-row tools.`);
+    (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)')}`);
+    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)();
+}
 // ---------------------------------------------------------------------------
 // Help
 // ---------------------------------------------------------------------------
@@ -1447,12 +1617,14 @@ function showHelp() {
     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)('deploy')}           Apply pending migrations without prompts`);
     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)('doctor')}             Check relations for missing FK indexes ${(0, ui_js_1.dim)('(--fix emits migration)')}`);
     console.log(`    ${(0, ui_js_1.cyan)('studio')}             Launch local read-only web UI`);
+    console.log(`    ${(0, ui_js_1.cyan)('mcp')}                Start read-only MCP server over stdio`);
     console.log(`    ${(0, ui_js_1.cyan)('observe')}            Launch metrics dashboard ${(0, ui_js_1.dim)('(requires TURBINE_OBSERVE_URL)')}`);
     (0, ui_js_1.newline)();
     console.log(`  ${(0, ui_js_1.bold)('Options:')}`);
@@ -1474,6 +1646,7 @@ function showHelp() {
     console.log(`    ${(0, ui_js_1.cyan)('--port')} ${(0, ui_js_1.dim)('<n>')}           HTTP port ${(0, ui_js_1.dim)('(default: 4983 studio, 4984 observe)')}`);
     console.log(`    ${(0, ui_js_1.cyan)('--host')} ${(0, ui_js_1.dim)('<addr>')}        Bind address ${(0, ui_js_1.dim)('(default: 127.0.0.1)')}`);
     console.log(`    ${(0, ui_js_1.cyan)('--no-open')}            Don't auto-open the browser`);
+    console.log(`    ${(0, ui_js_1.cyan)('--allow-remote')}       Allow non-loopback --host ${(0, ui_js_1.dim)('(refused without this flag)')}`);
     (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')}`);
@@ -1484,6 +1657,7 @@ function showHelp() {
     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 migrate deploy --dry-run`);
     console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine push --dry-run`);
     (0, ui_js_1.newline)();
 }
@@ -1610,6 +1784,9 @@ async function main() {
             case 'studio':
                 await cmdStudio(args, config);
                 break;
+            case 'mcp':
+                await cmdMcp(args, config);
+                break;
             case 'observe':
                 await cmdObserve(args);
                 break;
@@ -1660,4 +1837,29 @@ async function main() {
         process.exit(1);
     }
 }
-main();
+function isCliEntry() {
+    // Decide from process.argv[1] instead of import.meta.url so the same code
+    // compiles cleanly for both the ESM and CJS builds (see showVersion above).
+    // The CLI runs via the bin shim ("turbine"), the built output
+    // (dist/[cjs/]cli/index.{js,cjs}), or tsx on the source (src/cli/index.ts).
+    // Test files import this module with their own path in argv[1], which never
+    // matches these shapes.
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    let real = entry;
+    try {
+        real = (0, node_fs_1.realpathSync)(entry);
+    }
+    catch {
+        real = (0, node_path_1.resolve)(entry);
+    }
+    const base = (0, node_path_1.basename)(real);
+    if (base === 'turbine' || base === 'turbine-orm')
+        return true;
+    const isIndexFile = base === 'index.js' || base === 'index.cjs' || base === 'index.ts';
+    return isIndexFile && (0, node_path_1.basename)((0, node_path_1.dirname)(real)) === 'cli';
+}
+if (isCliEntry()) {
+    void main();
+}