turbine-orm 0.50.0 → 0.51.0

package/dist/cli/index.js

@@ -3,21 +3,21 @@
  * turbine-orm CLI
  *
  * Commands:
- *   turbine init                  — Initialize a Turbine project
- *   turbine generate | pull       — Introspect database and generate TypeScript types
+ *   turbine init                 , Initialize a Turbine project
+ *   turbine generate | pull      , Introspect database and generate TypeScript types
  *   turbine migrate-from-prisma   - Parse a schema.prisma and emit a Prisma->Turbine name map + report
  *   turbine push                  - Apply schema-builder definitions to database (destructive ops gated)
  *   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
- *   turbine migrate status        — Show migration status
- *   turbine seed                  — Run seed file
- *   turbine status                — Show schema summary
+ *   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                - Cost-aware missing-FK-index triage (--fix, --json, --no-concurrently, --unused, --audit)
  *   turbine studio                : Launch local read-only web UI (--demo for a seeded sample DB)
- *   turbine mcp                   — Start read-only MCP server over JSON-RPC stdio
- *   turbine observe               — Launch metrics dashboard (requires TURBINE_OBSERVE_URL)
+ *   turbine mcp                  , Start read-only MCP server over JSON-RPC stdio
+ *   turbine observe              , Launch metrics dashboard (requires TURBINE_OBSERVE_URL)
  *
  * Usage:
  *   DATABASE_URL=postgres://... npx turbine generate
@@ -228,7 +228,7 @@ export function parseArgs(argv = process.argv.slice(2)) {
     return result;
 }
 // ---------------------------------------------------------------------------
-// TypeScript loader — user-facing error helper
+// TypeScript loader, user-facing error helper
 // ---------------------------------------------------------------------------
 /**
  * Print a friendly error explaining how to install tsx, then exit.
@@ -244,7 +244,7 @@ function failMissingTsLoader(filePath, reason) {
     }
     else if (reason === 'failed') {
         // tsx IS installed but registering its loader threw. Report the real
-        // cause — telling the user to install tsx here would be a misdiagnosis.
+        // cause, telling the user to install tsx here would be a misdiagnosis.
         console.log(`  ${dim('tsx is installed, but registering its TypeScript loader failed:')}`);
         newline();
         console.log(`    ${getTsLoaderError() ?? '(unknown error)'}`);
@@ -758,6 +758,7 @@ async function runInitGenerate(config, url) {
             schema: config.schema,
             include: config.include.length ? config.include : undefined,
             exclude: config.exclude.length ? config.exclude : undefined,
+            relationNames: config.relationNames,
         });
         spinner.succeed(`Found ${bold(String(Object.keys(schema.tables).length))} tables`);
         const genSpinner = new Spinner('Generating TypeScript client').start();
@@ -1065,7 +1066,7 @@ async function cmdGenerate(args, config) {
     const url = requireUrl(config);
     const startTime = performance.now();
     // Guard: `schema` is the Postgres NAMESPACE to introspect (default `public`),
-    // NOT the path to your schema-builder file — that goes in `schemaFile`. If the
+    // NOT the path to your schema-builder file, that goes in `schemaFile`. If the
     // configured `schema` looks like a file path, introspection would silently
     // match zero tables and emit an empty client. Fail loudly instead.
     if (!args.allowEmpty && looksLikeSchemaFilePath(config.schema)) {
@@ -1075,7 +1076,7 @@ async function cmdGenerate(args, config) {
         console.log(`  ${dim('The path to your defineSchema() file belongs in')} ${cyan('schemaFile')}${dim('.')}`);
         newline();
         console.log(`  ${dim('Fix your')} ${cyan('turbine.config.ts')}${dim(':')}`);
-        console.log(`    ${green('schema:')} ${cyan("'public'")}${dim(",       // or omit — introspects the 'public' schema")}`);
+        console.log(`    ${green('schema:')} ${cyan("'public'")}${dim(",       // or omit, introspects the 'public' schema")}`);
         console.log(`    ${green('schemaFile:')} ${cyan(`'${config.schema}'`)}${dim(', // your defineSchema() file (used by `turbine push`)')}`);
         newline();
         console.log(`  ${dim('Re-run with')} ${cyan('--allow-empty')} ${dim('to introspect this literal schema name anyway.')}`);
@@ -1094,6 +1095,7 @@ async function cmdGenerate(args, config) {
         schema: config.schema,
         include: config.include.length ? config.include : undefined,
         exclude: config.exclude.length ? config.exclude : undefined,
+        relationNames: config.relationNames,
         includeViews: args.includeViews,
         legacyToManyUniques: config.legacyToManyUniques,
         onDefaultTableExclusion: (tables) => skippedInternalTables.push(...tables),
@@ -1113,13 +1115,13 @@ async function cmdGenerate(args, config) {
     // instead of silently emitting an empty typed client.
     if (tableNames.length === 0 && !args.allowEmpty) {
         newline();
-        error(`Introspection matched 0 tables in schema ${cyan(config.schema)} — refusing to generate an empty client.`);
+        error(`Introspection matched 0 tables in schema ${cyan(config.schema)}, refusing to generate an empty client.`);
         newline();
         console.log(`  ${dim('Common causes:')}`);
         console.log(`    ${dim('•')} ${cyan('schema')} ${dim('points at the wrong Postgres namespace')} ${dim('(it is the schema NAME, default')} ${cyan('public')}${dim(').')}`);
         console.log(`    ${dim('•')} ${dim('You meant to set')} ${cyan('schemaFile')} ${dim('(your defineSchema() file), not')} ${cyan('schema')}${dim('.')}`);
         console.log(`    ${dim('•')} ${cyan('include')}/${cyan('exclude')} ${dim('filtered out every table.')}`);
-        console.log(`    ${dim('•')} ${dim('The database has no tables yet — run')} ${cyan('turbine push')} ${dim('or a migration first.')}`);
+        console.log(`    ${dim('•')} ${dim('The database has no tables yet, run')} ${cyan('turbine push')} ${dim('or a migration first.')}`);
         newline();
         console.log(`  ${dim('If an empty client is genuinely what you want, re-run with')} ${cyan('--allow-empty')}${dim('.')}`);
         newline();
@@ -1246,6 +1248,7 @@ async function cmdMigrateFromPrisma(args, config) {
             includeViews: true,
             // Inherit the shared bookkeeping-table exclusions (Turbine + Prisma).
             exclude: [...new Set([...config.exclude, ...DEFAULT_EXCLUDED_TABLES])],
+            relationNames: config.relationNames,
         });
         spinner.succeed(`Introspected ${bold(String(Object.keys(schemaMeta.tables).length))} tables`);
     }
@@ -1381,7 +1384,7 @@ async function cmdPush(args, config) {
         newline();
     }
     if (args.dryRun) {
-        info('Dry run — no changes applied.');
+        info('Dry run, no changes applied.');
         newline();
         return;
     }
@@ -1430,7 +1433,7 @@ async function cmdMigrate(args, config) {
     const sub = args.subcommand;
     if (!sub || sub === 'help') {
         banner();
-        console.log(`  ${bold('turbine migrate')} ${dim('— SQL-first migration system')}`);
+        console.log(`  ${bold('turbine migrate')} ${dim(', SQL-first migration system')}`);
         newline();
         console.log(`  ${bold('Commands:')}`);
         console.log(`    ${cyan('create <name>')}             Create a new migration file`);
@@ -1709,16 +1712,16 @@ async function cmdMigrateUp(args, config) {
         newline();
         return;
     }
-    // Big, loud warning when bypassing drift detection — this is a deliberately
+    // Big, loud warning when bypassing drift detection, this is a deliberately
     // dangerous operation and the user should see it on every invocation.
     if (args.allowDrift) {
-        warn('--allow-drift is set — checksum validation is DISABLED for this run.');
+        warn('--allow-drift is set, checksum validation is DISABLED for this run.');
         console.log(`  ${dim('Applied migrations may have been modified or deleted on disk.')}`);
         console.log(`  ${dim('Proceed only if you are intentionally rewriting migration history.')}`);
         newline();
     }
     if (args.allowDestructive) {
-        warn('--allow-destructive is set — data-destroying statements in migrations WILL run.');
+        warn('--allow-destructive is set, data-destroying statements in migrations WILL run.');
         newline();
     }
     const spinner = new Spinner('Applying migrations').start();
@@ -1747,7 +1750,7 @@ async function cmdMigrateUp(args, config) {
             throw err;
         spinner.stop();
         if (!(await confirmDestructive(err.message))) {
-            error('Aborted — no migrations were applied and no data was touched.');
+            error('Aborted, no migrations were applied and no data was touched.');
             newline();
             process.exit(1);
         }
@@ -1895,7 +1898,7 @@ function isDestructiveRefusal(err) {
  *   1. show the full itemized report (statement kinds + targets),
  *   2. require typing the literal phrase `destroy my data`,
  *   3. require a final explicit `yes`.
- * Non-interactive shells (CI, pipes) can never pass this — they must use the
+ * Non-interactive shells (CI, pipes) can never pass this, they must use the
  * explicit `--allow-destructive` flag instead. Anything but exact answers aborts.
  */
 async function confirmDestructive(report) {
@@ -1917,7 +1920,7 @@ async function confirmDestructive(report) {
         const phrase = await rl.question(`  Type ${bold('destroy my data')} to continue, anything else to abort: `);
         if (phrase.trim() !== 'destroy my data')
             return false;
-        const finalAnswer = await rl.question(`  Final confirmation — apply the destructive statements above? Type ${bold('yes')}: `);
+        const finalAnswer = await rl.question(`  Final confirmation, apply the destructive statements above? Type ${bold('yes')}: `);
         return finalAnswer.trim() === 'yes';
     }
     finally {
@@ -1943,7 +1946,7 @@ async function cmdMigrateDown(args, config) {
             throw err;
         spinner.stop();
         if (!(await confirmDestructive(err.message))) {
-            error('Aborted — nothing was rolled back and no data was touched.');
+            error('Aborted, nothing was rolled back and no data was touched.');
             newline();
             process.exit(1);
         }
@@ -2033,7 +2036,7 @@ async function cmdMigrateStatus(_args, config) {
                     .toISOString()
                     .replace('T', ' ')
                     .replace(/\.\d+Z$/, ' UTC'))
-                : dim('—'),
+                : dim('-'),
         ];
     });
     console.log(formatTable(headers, rows));
@@ -2063,7 +2066,7 @@ async function runSeedPlan(plan, config) {
     try {
         if (plan.kind === 'tsx') {
             if (!canResolveTsx()) {
-                throw new Error('TypeScript seed files require tsx — install tsx or use seed.js/seed.sql.');
+                throw new Error('TypeScript seed files require tsx, install tsx or use seed.js/seed.sql.');
             }
             // The seed runs in a child process, so we cannot observe its callback
             // directly. Hand it a sentinel path: `defineSeed`'s runner writes the file
@@ -2164,6 +2167,7 @@ async function cmdStatus(_args, config) {
         schema: config.schema,
         include: config.include.length ? config.include : undefined,
         exclude: config.exclude.length ? config.exclude : undefined,
+        relationNames: config.relationNames,
     });
     const tableNames = Object.keys(schema.tables);
     spinner.succeed(`Found ${bold(String(tableNames.length))} tables`);
@@ -2627,7 +2631,7 @@ export function isLoopbackHost(host) {
     return h === '127.0.0.1' || h === 'localhost' || h === '::1' || h === '[::1]';
 }
 // ---------------------------------------------------------------------------
-// Command: studio — local read-only web UI
+// Command: studio, local read-only web UI
 // ---------------------------------------------------------------------------
 async function cmdStudio(args, config) {
     banner();
@@ -2643,7 +2647,7 @@ async function cmdStudio(args, config) {
         process.exit(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
+    // 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) {
@@ -2654,7 +2658,7 @@ async function cmdStudio(args, config) {
             newline();
             process.exit(1);
         }
-        console.log(warn(`Studio is binding to ${yellow(host)} — this is NOT loopback. ` +
+        console.log(warn(`Studio is binding to ${yellow(host)}, this is NOT loopback. ` +
             `Anyone on your network who can reach this port + guess the session token can read your database.`));
     }
     const spinner = new Spinner(demo ? 'Seeding demo dataset' : 'Introspecting database').start();
@@ -2754,7 +2758,7 @@ async function cmdStudio(args, config) {
     });
 }
 // ---------------------------------------------------------------------------
-// Command: mcp — read-only JSON-RPC stdio server
+// Command: mcp, read-only JSON-RPC stdio server
 // ---------------------------------------------------------------------------
 async function cmdMcp(_args, config) {
     const url = requireUrl(config);
@@ -2799,7 +2803,7 @@ async function cmdObserve(args) {
             newline();
             process.exit(1);
         }
-        console.log(warn(`Observe is binding to ${yellow(host)} — this is NOT loopback. ` +
+        console.log(warn(`Observe is binding to ${yellow(host)}, this is NOT loopback. ` +
             `Anyone on your network who can reach this port + guess the session token can read your metrics.`));
     }
     const spinner = new Spinner('Connecting to metrics database').start();
@@ -2814,7 +2818,7 @@ async function cmdObserve(args) {
     }
     newline();
     console.log(box([
-        `${bold('Turbine Observe')}  ${dim('— query metrics dashboard')}`,
+        `${bold('Turbine Observe')}  ${dim(', query metrics dashboard')}`,
         '',
         `  ${cyan('URL:')}  ${bold(handle.url)}`,
         '',
@@ -2861,7 +2865,7 @@ function showSubcommandHelp(command) {
 }
 function showInitHelp() {
     banner();
-    console.log(`  ${bold('turbine init')} — Initialize a Turbine project`);
+    console.log(`  ${bold('turbine init')}, Initialize a Turbine project`);
     newline();
     console.log(`  ${bold('Usage:')}`);
     console.log(`    npx turbine init ${dim('[options]')}`);
@@ -2886,16 +2890,16 @@ function showInitHelp() {
 }
 function showGenerateHelp() {
     banner();
-    console.log(`  ${bold('turbine generate')} — Introspect database and generate TypeScript types`);
+    console.log(`  ${bold('turbine generate')}, Introspect database and generate TypeScript types`);
     newline();
     console.log(`  ${bold('Usage:')}`);
     console.log(`    npx turbine generate ${dim('[options]')}`);
     newline();
     console.log(`  Connects to your database, reads the schema, and generates:`);
-    console.log(`    ${dim('•')} ${cyan('types.ts')}    — Entity interfaces, Create/Update input types`);
-    console.log(`    ${dim('•')} ${cyan('metadata.ts')} — Runtime schema metadata`);
-    console.log(`    ${dim('•')} ${cyan('index.ts')}    — Configured client with typed table accessors`);
-    console.log(`    ${dim('•')} ${cyan('zod.ts')}      — Zod schemas ${dim('(with --zod)')}`);
+    console.log(`    ${dim('•')} ${cyan('types.ts')}   , Entity interfaces, Create/Update input types`);
+    console.log(`    ${dim('•')} ${cyan('metadata.ts')}, Runtime schema metadata`);
+    console.log(`    ${dim('•')} ${cyan('index.ts')}   , Configured client with typed table accessors`);
+    console.log(`    ${dim('•')} ${cyan('zod.ts')}     , Zod schemas ${dim('(with --zod)')}`);
     newline();
     console.log(`  ${bold('Options:')}`);
     console.log(`    ${cyan('--url, -u')} ${dim('<url>')}       Postgres connection string`);
@@ -2943,7 +2947,7 @@ function showMigrateFromPrismaHelp() {
 }
 function showPushHelp() {
     banner();
-    console.log(`  ${bold('turbine push')} — Apply schema-builder definitions to database`);
+    console.log(`  ${bold('turbine push')}, Apply schema-builder definitions to database`);
     newline();
     console.log(`  ${bold('Usage:')}`);
     console.log(`    npx turbine push ${dim('[options]')}`);
@@ -2960,7 +2964,7 @@ function showPushHelp() {
 }
 function showMigrateHelp() {
     banner();
-    console.log(`  ${bold('turbine migrate')} — SQL migration management`);
+    console.log(`  ${bold('turbine migrate')}, SQL migration management`);
     newline();
     console.log(`  ${bold('Usage:')}`);
     console.log(`    npx turbine migrate ${cyan('<subcommand>')} ${dim('[options]')}`);
@@ -2979,7 +2983,7 @@ function showMigrateHelp() {
     console.log(`    ${cyan('--recipe')} ${dim('<name>')}   Scaffold a sanctioned migration pattern ${dim('(create only, e.g. backfill)')}`);
     console.log(`    ${cyan('--step, -n')} ${dim('<N>')}    Number of migrations to apply/rollback`);
     console.log(`    ${cyan('--dry-run')}         Show SQL without executing`);
-    console.log(`    ${cyan('--allow-drift')}     Bypass checksum validation ${dim('(migrate up only — advanced)')}`);
+    console.log(`    ${cyan('--allow-drift')}     Bypass checksum validation ${dim('(migrate up only, advanced)')}`);
     console.log(`    ${cyan('--allow-destructive')} Run data-destroying migration statements without the interactive confirm`);
     console.log(`    ${cyan('--verbose, -v')}     Show detailed output`);
     newline();
@@ -2996,7 +3000,7 @@ function showMigrateHelp() {
 }
 function showSeedHelp() {
     banner();
-    console.log(`  ${bold('turbine seed')} — Run seed file`);
+    console.log(`  ${bold('turbine seed')}, Run seed file`);
     newline();
     console.log(`  ${bold('Usage:')}`);
     console.log(`    npx turbine seed ${dim('[options]')}`);
@@ -3012,7 +3016,7 @@ function showSeedHelp() {
 }
 function showStatusHelp() {
     banner();
-    console.log(`  ${bold('turbine status')} — Show database schema summary`);
+    console.log(`  ${bold('turbine status')}, Show database schema summary`);
     newline();
     console.log(`  ${bold('Usage:')}`);
     console.log(`    npx turbine status ${dim('[options]')}`);
@@ -3027,7 +3031,7 @@ function showStatusHelp() {
 }
 function showMcpHelp() {
     banner();
-    console.log(`  ${bold('turbine mcp')} — Start read-only MCP server over stdio`);
+    console.log(`  ${bold('turbine mcp')}, Start read-only MCP server over stdio`);
     newline();
     console.log(`  ${bold('Usage:')}`);
     console.log(`    npx turbine mcp ${dim('[options]')}`);

package/dist/cli/loader.d.ts

@@ -1,5 +1,5 @@
 /**
- * turbine-orm CLI — TypeScript loader registration
+ * turbine-orm CLI, TypeScript loader registration
  *
  * The CLI loads user-supplied config and schema files via dynamic `import()`.
  * Plain Node has no built-in `.ts` loader, so importing `turbine.config.ts`
@@ -12,16 +12,16 @@
  *   2. Prefer tsx's supported programmatic API, `tsx/esm/api`'s `register()`.
  *      Calling Node's `module.register('tsx/esm', ...)` directly throws
  *      "tsx must be loaded with --import instead of --loader" on every Node
- *      version that has `module.register()` (>= 20.6) — tsx's hook file
+ *      version that has `module.register()` (>= 20.6), tsx's hook file
  *      guards against being loaded that way. The `tsx/esm/api` entry point
  *      is the documented path and works everywhere `module.register()` does.
  *   3. Fall back to `module.register('tsx/esm', ...)` only for very old tsx
  *      versions (< 4.0) that predate `tsx/esm/api`.
  *   4. If tsx isn't installed, or registration genuinely fails, surface an
- *      actionable error — including the REAL underlying error message, never
+ *      actionable error, including the REAL underlying error message, never
  *      a misdiagnosed "tsx is not installed".
  *
- * `tsx` is intentionally NOT a runtime dependency — many projects already
+ * `tsx` is intentionally NOT a runtime dependency, many projects already
  * have it, and adding a heavy dev tool to a 1-dependency ORM would be silly.
  */
 /**
@@ -45,7 +45,7 @@ export type TsLoaderStatus = 'registered' | 'already' | 'unsupported' | 'missing
 export declare function getTsLoaderError(): string | null;
 /**
  * Register the tsx ESM loader so subsequent dynamic imports of `.ts` files
- * work. Safe to call multiple times — internal flag prevents double registration.
+ * work. Safe to call multiple times, internal flag prevents double registration.
  *
  * Returns:
  *   - 'registered'  loader was successfully registered this call
@@ -53,9 +53,9 @@ export declare function getTsLoaderError(): string | null;
  *   - 'unsupported' Node lacks `module.register()` (Node < 20.6) and tsx has
  *                   no programmatic API to fall back to
  *   - 'missing'     `tsx` is not installed in the user's project
- *   - 'failed'      tsx IS installed but registration threw — see
+ *   - 'failed'      tsx IS installed but registration threw, see
  *                   {@link getTsLoaderError} for the underlying message
  */
 export declare function registerTsLoader(): Promise<TsLoaderStatus>;
-/** Reset the loader state — used by unit tests only. */
+/** Reset the loader state, used by unit tests only. */
 export declare function _resetTsLoaderStateForTests(): void;

package/dist/cli/loader.js

@@ -1,5 +1,5 @@
 /**
- * turbine-orm CLI — TypeScript loader registration
+ * turbine-orm CLI, TypeScript loader registration
  *
  * The CLI loads user-supplied config and schema files via dynamic `import()`.
  * Plain Node has no built-in `.ts` loader, so importing `turbine.config.ts`
@@ -12,16 +12,16 @@
  *   2. Prefer tsx's supported programmatic API, `tsx/esm/api`'s `register()`.
  *      Calling Node's `module.register('tsx/esm', ...)` directly throws
  *      "tsx must be loaded with --import instead of --loader" on every Node
- *      version that has `module.register()` (>= 20.6) — tsx's hook file
+ *      version that has `module.register()` (>= 20.6), tsx's hook file
  *      guards against being loaded that way. The `tsx/esm/api` entry point
  *      is the documented path and works everywhere `module.register()` does.
  *   3. Fall back to `module.register('tsx/esm', ...)` only for very old tsx
  *      versions (< 4.0) that predate `tsx/esm/api`.
  *   4. If tsx isn't installed, or registration genuinely fails, surface an
- *      actionable error — including the REAL underlying error message, never
+ *      actionable error, including the REAL underlying error message, never
  *      a misdiagnosed "tsx is not installed".
  *
- * `tsx` is intentionally NOT a runtime dependency — many projects already
+ * `tsx` is intentionally NOT a runtime dependency, many projects already
  * have it, and adding a heavy dev tool to a 1-dependency ORM would be silly.
  */
 import { createRequire } from 'node:module';
@@ -69,7 +69,7 @@ export function getTsLoaderError() {
 }
 /**
  * Register the tsx ESM loader so subsequent dynamic imports of `.ts` files
- * work. Safe to call multiple times — internal flag prevents double registration.
+ * work. Safe to call multiple times, internal flag prevents double registration.
  *
  * Returns:
  *   - 'registered'  loader was successfully registered this call
@@ -77,7 +77,7 @@ export function getTsLoaderError() {
  *   - 'unsupported' Node lacks `module.register()` (Node < 20.6) and tsx has
  *                   no programmatic API to fall back to
  *   - 'missing'     `tsx` is not installed in the user's project
- *   - 'failed'      tsx IS installed but registration threw — see
+ *   - 'failed'      tsx IS installed but registration threw, see
  *                   {@link getTsLoaderError} for the underlying message
  */
 export async function registerTsLoader() {
@@ -110,14 +110,14 @@ export async function registerTsLoader() {
             return 'failed';
         }
     }
-    // tsx/esm/api not resolvable — is tsx installed at all?
+    // tsx/esm/api not resolvable, is tsx installed at all?
     if (!canResolveTsx()) {
         tsLoaderState = 'missing';
         return 'missing';
     }
     // Legacy fallback for tsx < 4.0 (no tsx/esm/api): Node's module.register.
     // On tsx >= 4.19 this path throws ("tsx must be loaded with --import
-    // instead of --loader") — but those versions all ship tsx/esm/api, so we
+    // instead of --loader"), but those versions all ship tsx/esm/api, so we
     // only land here for genuinely old installs.
     try {
         const mod = await import('node:module');
@@ -137,7 +137,7 @@ export async function registerTsLoader() {
         return 'failed';
     }
 }
-/** Reset the loader state — used by unit tests only. */
+/** Reset the loader state, used by unit tests only. */
 export function _resetTsLoaderStateForTests() {
     tsLoaderState = null;
     tsLoaderError = null;

package/dist/cli/mcp.js

@@ -72,7 +72,7 @@ const TOOLS = [
     },
     {
         name: 'explain_query',
-        description: 'Run EXPLAIN (FORMAT JSON) for a schema-validated findMany query. Pass table + optional where/orderBy/limit/select — free-form SQL is rejected.',
+        description: 'Run EXPLAIN (FORMAT JSON) for a schema-validated findMany query. Pass table + optional where/orderBy/limit/select, free-form SQL is rejected.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -322,7 +322,7 @@ async function doctorReport(ctx) {
     });
 }
 /**
- * EXPLAIN a schema-validated findMany query. Free-form SQL is never accepted —
+ * EXPLAIN a schema-validated findMany query. Free-form SQL is never accepted -
  * table/field identifiers are checked against introspected metadata and the
  * SELECT is compiled by QueryInterface (same stance as Studio `/api/builder`).
  */
@@ -364,7 +364,7 @@ async function explainQuery(ctx, args) {
 }
 /**
  * Extract the allowed findMany subset for explain_query (no `with` / raw SQL).
- * Returns a plain object cast at the buildFindMany call site — same pattern as Studio.
+ * Returns a plain object cast at the buildFindMany call site, same pattern as Studio.
  */
 function parseExplainFindManyArgs(args) {
     const findManyArgs = {};
@@ -642,7 +642,7 @@ export function buildRelations(tableNames, columnsByTable, pkByTable, rows, enum
     for (const [tbl, cols] of columnsByTable) {
         columnFieldsByTable.set(tbl, new Set(cols.map((c) => c.field)));
         // Enum-typed columns also report tsType 'unknown', but the generated type
-        // layer gives them a concrete union — only json/jsonb qualify as shadows.
+        // layer gives them a concrete union, only json/jsonb qualify as shadows.
         unknownTypedFieldsByTable.set(tbl, new Set(cols.filter((c) => isUnknownTsType(c.tsType) && !Object.hasOwn(enums, c.pgType)).map((c) => c.field)));
     }
     const relations = buildRelationsFromForeignKeys(foreignKeys, columnFieldsByTable, undefined, unknownTypedFieldsByTable);

package/dist/cli/migrate.d.ts

@@ -1,5 +1,5 @@
 /**
- * turbine-orm CLI — Migration system
+ * turbine-orm CLI, Migration system
  *
  * SQL-first migrations with UP/DOWN sections, tracked in _turbine_migrations.
  * Migration files are timestamp-prefixed .sql files.
@@ -22,7 +22,7 @@ export interface MigrationFile {
     path: string;
     /** Extracted name portion (e.g. "20260325120000_create_users") */
     name: string;
-    /** Timestamp prefix (e.g. "20260325120000") — YYYYMMDDHHMMSS */
+    /** Timestamp prefix (e.g. "20260325120000"), YYYYMMDDHHMMSS */
     timestamp: string;
 }
 export interface AppliedMigration {
@@ -95,7 +95,7 @@ export declare function sanitizeName(name: string): string;
  */
 export declare function formatTimestamp(date: Date): string;
 /**
- * Get pending migration files — those not yet applied.
+ * Get pending migration files, those not yet applied.
  * Returns files sorted by timestamp (ascending).
  */
 export declare function getPendingMigrations(migrationsDir: string, applied: string[]): MigrationFile[];
@@ -227,7 +227,7 @@ export declare function createMigration(migrationsDir: string, name: string, aut
 /**
  * Derive a Postgres advisory lock ID (positive int4) from the database name.
  *
- * Uses FNV-1a 32-bit hash — a well-known, stable, non-cryptographic hash with
+ * Uses FNV-1a 32-bit hash, a well-known, stable, non-cryptographic hash with
  * excellent distribution over short strings (database names are typically <64
  * chars). Chosen over alternatives because it's:
  *   - deterministic (same input → same output, across processes/machines)
@@ -297,7 +297,7 @@ export declare function inspectMigrationDeploy(connectionString: string, migrati
  * Features:
  * - Idempotent: running twice is safe (already-applied migrations are skipped)
  * - Advisory lock: prevents concurrent migration runs
- * - Checksum validation: detects modified migration files (BLOCKING — use
+ * - Checksum validation: detects modified migration files (BLOCKING, use
  *   `allowDrift: true` to bypass when intentionally rewriting history)
  * - Each migration runs in its own transaction
  *

package/dist/cli/migrate.js

@@ -1,5 +1,5 @@
 /**
- * turbine-orm CLI — Migration system
+ * turbine-orm CLI, Migration system
  *
  * SQL-first migrations with UP/DOWN sections, tracked in _turbine_migrations.
  * Migration files are timestamp-prefixed .sql files.
@@ -108,7 +108,7 @@ export function formatTimestamp(date) {
     ].join('');
 }
 /**
- * Get pending migration files — those not yet applied.
+ * Get pending migration files, those not yet applied.
  * Returns files sorted by timestamp (ascending).
  */
 export function getPendingMigrations(migrationsDir, applied) {
@@ -612,7 +612,7 @@ ${autoContent.down}
 /**
  * Derive a Postgres advisory lock ID (positive int4) from the database name.
  *
- * Uses FNV-1a 32-bit hash — a well-known, stable, non-cryptographic hash with
+ * Uses FNV-1a 32-bit hash, a well-known, stable, non-cryptographic hash with
  * excellent distribution over short strings (database names are typically <64
  * chars). Chosen over alternatives because it's:
  *   - deterministic (same input → same output, across processes/machines)
@@ -729,7 +729,7 @@ export function formatChecksumMismatchError(mismatches) {
     const modified = mismatches.filter((m) => m.type === 'modified');
     const missing = mismatches.filter((m) => m.type === 'missing');
     const lines = [
-        '[turbine] Migration drift detected — refusing to apply pending migrations.',
+        '[turbine] Migration drift detected, refusing to apply pending migrations.',
         '',
         'Applied migrations should be immutable. The following files no longer match their applied state:',
         '',
@@ -751,7 +751,7 @@ export function formatChecksumMismatchError(mismatches) {
     if (missing.length > 0) {
         lines.push('     (deleted files cannot be rolled back: restore the file, then run `migrate down` if needed), OR');
     }
-    lines.push('  3. Pass `--allow-drift` to bypass this check (advanced — make sure you know what you are doing).');
+    lines.push('  3. Pass `--allow-drift` to bypass this check (advanced, make sure you know what you are doing).');
     return lines.join('\n');
 }
 /**
@@ -820,7 +820,7 @@ export async function inspectMigrationDeploy(connectionString, migrationsDir) {
  * Features:
  * - Idempotent: running twice is safe (already-applied migrations are skipped)
  * - Advisory lock: prevents concurrent migration runs
- * - Checksum validation: detects modified migration files (BLOCKING — use
+ * - Checksum validation: detects modified migration files (BLOCKING, use
  *   `allowDrift: true` to bypass when intentionally rewriting history)
  * - Each migration runs in its own transaction
  *
@@ -844,7 +844,7 @@ export async function migrateUp(connectionString, migrationsDir, options) {
         const adapter = options?.adapter;
         const gotLock = await acquireLock(client, lockId, adapter);
         if (!gotLock) {
-            throw new MigrationError('[turbine] Could not acquire migration lock — another migration is already running');
+            throw new MigrationError('[turbine] Could not acquire migration lock, another migration is already running');
         }
         try {
             await ensureTrackingTable(client, dialect);
@@ -881,7 +881,7 @@ export async function migrateUp(connectionString, migrationsDir, options) {
             // Data-loss gate: refuse to run pending migrations containing destructive
             // statements unless the caller has EXPLICITLY opted in. The CLI layers an
             // interactive typed confirmation on top of this; programmatic callers must
-            // pass `allowDestructive: true`. Safe-by-default is the whole point — a
+            // pass `allowDestructive: true`. Safe-by-default is the whole point, a
             // DROP TABLE should never run just because a file exists.
             if (!options?.allowDestructive && destructive.length > 0) {
                 const lines = ['[turbine] Refusing to apply migrations containing DESTRUCTIVE statements:', ''];
@@ -995,7 +995,7 @@ export async function migrateDown(connectionString, migrationsDir, options) {
         const adapter = options?.adapter;
         const gotLock = await acquireLock(client, lockId, adapter);
         if (!gotLock) {
-            throw new MigrationError('[turbine] Could not acquire migration lock — another migration is already running');
+            throw new MigrationError('[turbine] Could not acquire migration lock, another migration is already running');
         }
         try {
             await ensureTrackingTable(client, dialect);
@@ -1005,9 +1005,9 @@ export async function migrateDown(connectionString, migrationsDir, options) {
             }
             const allFiles = listMigrationFiles(migrationsDir);
             const fileMap = new Map(allFiles.map((f) => [f.name, f]));
-            // Reverse order — rollback most recent first
+            // Reverse order, rollback most recent first
             const toRollback = applied.reverse().slice(0, options?.step ?? 1);
-            // Same data-loss gate as migrateUp — DOWN sections routinely contain
+            // Same data-loss gate as migrateUp, DOWN sections routinely contain
             // DROP TABLE (the legitimate reverse of a CREATE), which still destroys
             // every row written since the migration ran. Explicit opt-in required.
             if (!options?.allowDestructive) {