@xubylele/schema-forge 1.10.0 → 1.11.0

package/README.md

@@ -210,12 +210,13 @@ Creates the necessary directory structure and configuration files.
 Generate SQL migration from schema changes.
 
 ```bash
-schema-forge generate [--name "migration description"] [--safe] [--force]
+schema-forge generate [--name "migration description"] [--migration-format hyphen|underscore] [--safe] [--force]
 ```
 
 **Options:**
 
 - `--name` - Optional name for the migration (default: "migration")
+- `--migration-format <format>` - Migration file name: `hyphen` (e.g. `20250315120000-add-users.sql`) or `underscore` (e.g. `20250315120000_add_users.sql`, Supabase CLI style). Overrides `migrationFileNameFormat` in config.
 - `--safe` - Block execution if destructive operations are detected (exits with error)
 - `--force` - Bypass safety checks and proceed with destructive operations (shows warning)
 
@@ -269,6 +270,20 @@ Behavior:
 - Ignores unsupported SQL safely and prints warnings
 - Writes a normalized SchemaForge DSL schema file
 
+### `schema-forge config`
+
+Update `schemaforge/config.json` settings without editing the file.
+
+```bash
+schema-forge config migration-format <format>
+```
+
+**Subcommands:**
+
+- **`migration-format <format>`** – Set migration file name format: `hyphen` (e.g. `20250315120000-add-users.sql`) or `underscore` (e.g. `20250315120000_add_users.sql`, Supabase CLI style). Writes `migrationFileNameFormat` to config.
+
+Requires an initialized project. Other config keys are left unchanged.
+
 ### `schema-forge validate`
 
 Detect destructive or risky schema changes before generating/applying migrations.
@@ -626,7 +641,8 @@ The `schemaforge/config.json` file contains project configuration. The `provider
 ```
 
 - **postgres**: `provider: "postgres"`, `outputDir: "migrations"`.
-- **supabase**: `provider: "supabase"`, `outputDir: "supabase/migrations"`.
+- **supabase**: `provider: "supabase"`, `outputDir: "supabase/migrations"`. Init also sets `migrationFileNameFormat: "hyphen"` so migrations are named `timestamp-name.sql` (Supabase CLI uses `timestamp_name.sql` by default; you can set `migrationFileNameFormat: "underscore"` in config or use `--migration-format underscore` to match).
+- **migrationFileNameFormat** (optional): `"hyphen"` (default) or `"underscore"`. Controls generated migration file names: `YYYYMMDDHHmmss-name.sql` vs `YYYYMMDDHHmmss_name.sql`. You can set it via **`schema-forge config migration-format <hyphen|underscore>`** instead of editing the file.
 
 ## Supported Databases
 

package/dist/api.d.ts

@@ -11,10 +11,15 @@ interface DoctorOptions {
     schema?: string;
 }
 
+/** Migration file name format: hyphen (timestamp-name.sql) or underscore (timestamp_name.sql, Supabase CLI style). */
+type MigrationFileNameFormat = 'hyphen' | 'underscore';
+
 interface GenerateOptions {
     name?: string;
     safe?: boolean;
     force?: boolean;
+    /** Override migration file name format: hyphen (timestamp-name.sql) or underscore (timestamp_name.sql). */
+    migrationFormat?: MigrationFileNameFormat;
 }
 
 interface ImportOptions {

package/dist/api.js

@@ -3241,6 +3241,10 @@ function nowTimestamp2() {
 function slugifyName2(name) {
   return name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "migration";
 }
+function migrationFileName(timestamp, slug, format = "hyphen") {
+  const sep = format === "underscore" ? "_" : "-";
+  return `${timestamp}${sep}${slug}.sql`;
+}
 
 // src/commands/generate.ts
 var REQUIRED_CONFIG_FIELDS = [
@@ -3248,6 +3252,19 @@ var REQUIRED_CONFIG_FIELDS = [
   "stateFile",
   "outputDir"
 ];
+var MIGRATION_FORMATS = ["hyphen", "underscore"];
+function resolveMigrationFormat(cliFormat, configFormat) {
+  if (cliFormat !== void 0 && cliFormat !== "") {
+    const normalized = cliFormat.trim().toLowerCase();
+    if (MIGRATION_FORMATS.includes(normalized)) {
+      return normalized;
+    }
+    throw new Error(
+      `Invalid --migration-format "${cliFormat}". Allowed: ${MIGRATION_FORMATS.join(", ")}.`
+    );
+  }
+  return configFormat ?? "hyphen";
+}
 function resolveConfigPath3(root, targetPath) {
   return import_path9.default.isAbsolute(targetPath) ? targetPath : import_path9.default.join(root, targetPath);
 }
@@ -3328,7 +3345,11 @@ Remove --safe flag or modify schema to avoid destructive changes.`
   const sql = await generateSql2(diff2, provider, config.sql);
   const timestamp = nowTimestamp2();
   const slug = slugifyName2(options.name ?? "migration");
-  const fileName = `${timestamp}-${slug}.sql`;
+  const format = resolveMigrationFormat(
+    options.migrationFormat,
+    config.migrationFileNameFormat
+  );
+  const fileName = migrationFileName(timestamp, slug, format);
   await ensureDir(outputDir);
   const migrationPath = import_path9.default.join(outputDir, fileName);
   await writeTextFile(migrationPath, sql + "\n");
@@ -3464,6 +3485,9 @@ table users {
       timestampDefault: "now()"
     }
   };
+  if (provider === "supabase") {
+    config.migrationFileNameFormat = "hyphen";
+  }
   await writeJsonFile(configPath, config);
   success(`Created ${configPath}`);
   const state = {

package/dist/cli.js

@@ -1130,14 +1130,14 @@ var init_validate = __esm({
 // node_modules/@xubylele/schema-forge-core/dist/core/fs.js
 async function ensureDir2(dirPath) {
   try {
-    await import_fs2.promises.mkdir(dirPath, { recursive: true });
+    await import_fs3.promises.mkdir(dirPath, { recursive: true });
   } catch (error2) {
     throw new Error(`Failed to create directory ${dirPath}: ${error2}`);
   }
 }
 async function fileExists2(filePath) {
   try {
-    await import_fs2.promises.access(filePath);
+    await import_fs3.promises.access(filePath);
     return true;
   } catch {
     return false;
@@ -1145,7 +1145,7 @@ async function fileExists2(filePath) {
 }
 async function readTextFile2(filePath) {
   try {
-    return await import_fs2.promises.readFile(filePath, "utf-8");
+    return await import_fs3.promises.readFile(filePath, "utf-8");
   } catch (error2) {
     throw new Error(`Failed to read file ${filePath}: ${error2}`);
   }
@@ -1154,7 +1154,7 @@ async function writeTextFile2(filePath, content) {
   try {
     const dir = import_path3.default.dirname(filePath);
     await ensureDir2(dir);
-    await import_fs2.promises.writeFile(filePath, content, "utf-8");
+    await import_fs3.promises.writeFile(filePath, content, "utf-8");
   } catch (error2) {
     throw new Error(`Failed to write file ${filePath}: ${error2}`);
   }
@@ -1182,7 +1182,7 @@ async function writeJsonFile2(filePath, data) {
 async function findFiles(dirPath, pattern) {
   const results = [];
   try {
-    const items = await import_fs2.promises.readdir(dirPath, { withFileTypes: true });
+    const items = await import_fs3.promises.readdir(dirPath, { withFileTypes: true });
     for (const item of items) {
       const fullPath = import_path3.default.join(dirPath, item.name);
       if (item.isDirectory()) {
@@ -1197,11 +1197,11 @@ async function findFiles(dirPath, pattern) {
   }
   return results;
 }
-var import_fs2, import_path3;
+var import_fs3, import_path3;
 var init_fs = __esm({
   "node_modules/@xubylele/schema-forge-core/dist/core/fs.js"() {
     "use strict";
-    import_fs2 = require("fs");
+    import_fs3 = require("fs");
     import_path3 = __toESM(require("path"), 1);
   }
 });
@@ -2204,7 +2204,7 @@ var init_schema_to_dsl = __esm({
 
 // node_modules/@xubylele/schema-forge-core/dist/core/sql/load-migrations.js
 async function loadMigrationSqlInput(inputPath) {
-  const stats = await import_fs4.promises.stat(inputPath);
+  const stats = await import_fs5.promises.stat(inputPath);
   if (stats.isFile()) {
     if (!inputPath.toLowerCase().endsWith(".sql")) {
       throw new Error(`Input file must be a .sql file: ${inputPath}`);
@@ -2225,11 +2225,11 @@ async function loadMigrationSqlInput(inputPath) {
   }
   return result;
 }
-var import_fs4, import_path5;
+var import_fs5, import_path5;
 var init_load_migrations = __esm({
   "node_modules/@xubylele/schema-forge-core/dist/core/sql/load-migrations.js"() {
     "use strict";
-    import_fs4 = require("fs");
+    import_fs5 = require("fs");
     import_path5 = __toESM(require("path"), 1);
     init_fs();
   }
@@ -2733,7 +2733,7 @@ var import_commander8 = require("commander");
 // package.json
 var package_default = {
   name: "@xubylele/schema-forge",
-  version: "1.10.0",
+  version: "1.11.0",
   description: "Universal migration generator from schema DSL",
   main: "dist/cli.js",
   type: "commonjs",
@@ -2802,10 +2802,6 @@ var package_default = {
   }
 };
 
-// src/commands/diff.ts
-var import_commander = require("commander");
-var import_path7 = __toESM(require("path"));
-
 // src/core/fs.ts
 var import_fs = require("fs");
 var import_path = __toESM(require("path"));
@@ -2884,6 +2880,95 @@ function getStatePath(root, config) {
   return import_path2.default.join(schemaForgeDir, fileName);
 }
 
+// src/utils/exitCodes.ts
+var EXIT_CODES = {
+  /** Successful operation */
+  SUCCESS: 0,
+  /** Validation error (invalid DSL syntax, config errors, missing files, etc.) */
+  VALIDATION_ERROR: 1,
+  /** Drift detected - Reserved for future use when comparing actual DB state vs schema */
+  DRIFT_DETECTED: 2,
+  /** Destructive operation detected in CI environment without --force */
+  CI_DESTRUCTIVE: 3
+};
+function shouldFailCIDestructive(isCIEnvironment, hasDestructiveFindings2, isForceEnabled) {
+  return isCIEnvironment && hasDestructiveFindings2 && !isForceEnabled;
+}
+
+// src/utils/output.ts
+var import_boxen = __toESM(require("boxen"));
+var import_chalk = require("chalk");
+var isInteractive = Boolean(process.stdout?.isTTY);
+var colorsEnabled = isInteractive && process.env.FORCE_COLOR !== "0" && !("NO_COLOR" in process.env);
+var color = new import_chalk.Chalk({ level: colorsEnabled ? 3 : 0 });
+var theme = {
+  primary: color.cyanBright,
+  success: color.hex("#00FF88"),
+  warning: color.hex("#FFD166"),
+  error: color.hex("#EF476F"),
+  accent: color.magentaBright
+};
+function success(message) {
+  const text = theme.success(`[OK] ${message}`);
+  if (!isInteractive) {
+    console.log(text);
+    return;
+  }
+  try {
+    console.log(
+      (0, import_boxen.default)(text, {
+        padding: 1,
+        borderColor: "cyan",
+        borderStyle: "round"
+      })
+    );
+  } catch {
+    console.log(text);
+  }
+}
+function info(message) {
+  console.log(theme.primary(message));
+}
+function warning(message) {
+  console.warn(theme.warning(`[WARN] ${message}`));
+}
+function error(message) {
+  console.error(theme.error(`[ERROR] ${message}`));
+}
+function forceWarning(message) {
+  console.error(theme.warning(`[FORCE] ${message}`));
+}
+
+// src/commands/config.ts
+var MIGRATION_FORMATS = ["hyphen", "underscore"];
+async function runConfig(options) {
+  const root = getProjectRoot();
+  const configPath = getConfigPath(root);
+  if (!await fileExists(configPath)) {
+    throw new Error('SchemaForge project not initialized. Run "schema-forge init" first.');
+  }
+  const config = await readJsonFile(configPath, {});
+  if (options.migrationFormat !== void 0) {
+    const format = options.migrationFormat.trim().toLowerCase();
+    if (!MIGRATION_FORMATS.includes(format)) {
+      throw new Error(
+        `Invalid migration format "${options.migrationFormat}". Allowed: ${MIGRATION_FORMATS.join(", ")}.`
+      );
+    }
+    config.migrationFileNameFormat = format;
+  }
+  await writeJsonFile(configPath, config);
+  success(`Updated ${configPath}`);
+  if (options.migrationFormat !== void 0) {
+    success(`migrationFileNameFormat set to "${config.migrationFileNameFormat}" (${config.migrationFileNameFormat === "hyphen" ? "timestamp-name.sql" : "timestamp_name.sql"})`);
+  }
+  process.exitCode = EXIT_CODES.SUCCESS;
+}
+
+// src/commands/diff.ts
+var import_commander = require("commander");
+var import_path7 = __toESM(require("path"));
+
 // src/core/provider.ts
 var DEFAULT_PROVIDER = "postgres";
 function resolveProvider(provider) {
@@ -3004,65 +3089,6 @@ async function withPostgresQueryExecutor(connectionString, run) {
   }
 }
 
-// src/utils/exitCodes.ts
-var EXIT_CODES = {
-  /** Successful operation */
-  SUCCESS: 0,
-  /** Validation error (invalid DSL syntax, config errors, missing files, etc.) */
-  VALIDATION_ERROR: 1,
-  /** Drift detected - Reserved for future use when comparing actual DB state vs schema */
-  DRIFT_DETECTED: 2,
-  /** Destructive operation detected in CI environment without --force */
-  CI_DESTRUCTIVE: 3
-};
-function shouldFailCIDestructive(isCIEnvironment, hasDestructiveFindings2, isForceEnabled) {
-  return isCIEnvironment && hasDestructiveFindings2 && !isForceEnabled;
-}
-
-// src/utils/output.ts
-var import_boxen = __toESM(require("boxen"));
-var import_chalk = require("chalk");
-var isInteractive = Boolean(process.stdout?.isTTY);
-var colorsEnabled = isInteractive && process.env.FORCE_COLOR !== "0" && !("NO_COLOR" in process.env);
-var color = new import_chalk.Chalk({ level: colorsEnabled ? 3 : 0 });
-var theme = {
-  primary: color.cyanBright,
-  success: color.hex("#00FF88"),
-  warning: color.hex("#FFD166"),
-  error: color.hex("#EF476F"),
-  accent: color.magentaBright
-};
-function success(message) {
-  const text = theme.success(`[OK] ${message}`);
-  if (!isInteractive) {
-    console.log(text);
-    return;
-  }
-  try {
-    console.log(
-      (0, import_boxen.default)(text, {
-        padding: 1,
-        borderColor: "cyan",
-        borderStyle: "round"
-      })
-    );
-  } catch {
-    console.log(text);
-  }
-}
-function info(message) {
-  console.log(theme.primary(message));
-}
-function warning(message) {
-  console.warn(theme.warning(`[WARN] ${message}`));
-}
-function error(message) {
-  console.error(theme.error(`[ERROR] ${message}`));
-}
-function forceWarning(message) {
-  console.error(theme.warning(`[FORCE] ${message}`));
-}
-
 // src/utils/prompt.ts
 var import_node_readline = __toESM(require("readline"));
 function isCI() {
@@ -3306,6 +3332,10 @@ function nowTimestamp2() {
 function slugifyName2(name) {
   return name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "migration";
 }
+function migrationFileName(timestamp, slug, format = "hyphen") {
+  const sep = format === "underscore" ? "_" : "-";
+  return `${timestamp}${sep}${slug}.sql`;
+}
 
 // src/commands/generate.ts
 var REQUIRED_CONFIG_FIELDS = [
@@ -3313,6 +3343,19 @@ var REQUIRED_CONFIG_FIELDS = [
   "stateFile",
   "outputDir"
 ];
+var MIGRATION_FORMATS2 = ["hyphen", "underscore"];
+function resolveMigrationFormat(cliFormat, configFormat) {
+  if (cliFormat !== void 0 && cliFormat !== "") {
+    const normalized = cliFormat.trim().toLowerCase();
+    if (MIGRATION_FORMATS2.includes(normalized)) {
+      return normalized;
+    }
+    throw new Error(
+      `Invalid --migration-format "${cliFormat}". Allowed: ${MIGRATION_FORMATS2.join(", ")}.`
+    );
+  }
+  return configFormat ?? "hyphen";
+}
 function resolveConfigPath3(root, targetPath) {
   return import_path9.default.isAbsolute(targetPath) ? targetPath : import_path9.default.join(root, targetPath);
 }
@@ -3393,7 +3436,11 @@ Remove --safe flag or modify schema to avoid destructive changes.`
   const sql = await generateSql2(diff, provider, config.sql);
   const timestamp = nowTimestamp2();
   const slug = slugifyName2(options.name ?? "migration");
-  const fileName = `${timestamp}-${slug}.sql`;
+  const format = resolveMigrationFormat(
+    options.migrationFormat,
+    config.migrationFileNameFormat
+  );
+  const fileName = migrationFileName(timestamp, slug, format);
   await ensureDir(outputDir);
   const migrationPath = import_path9.default.join(outputDir, fileName);
   await writeTextFile(migrationPath, sql + "\n");
@@ -3529,6 +3576,9 @@ table users {
       timestampDefault: "now()"
     }
   };
+  if (provider === "supabase") {
+    config.migrationFileNameFormat = "hyphen";
+  }
   await writeJsonFile(configPath, config);
   success(`Created ${configPath}`);
   const state = {
@@ -3752,7 +3802,7 @@ program.command("init").description(
     await handleError(error2);
   }
 });
-program.command("generate").description("Generate SQL from schema files. In CI environments (CI=true), exits with code 3 if destructive operations are detected unless --force is used.").option("--name <string>", "Schema name to generate").action(async (options) => {
+program.command("generate").description("Generate SQL from schema files. In CI environments (CI=true), exits with code 3 if destructive operations are detected unless --force is used.").option("--name <string>", "Schema name to generate").option("--migration-format <format>", "Migration file name: hyphen (timestamp-name.sql) or underscore (timestamp_name.sql, Supabase CLI style)").action(async (options) => {
   try {
     const globalOptions = program.opts();
     validateFlagExclusivity(globalOptions);
@@ -3791,6 +3841,13 @@ program.command("import").description("Import schema from SQL migrations").argum
     await handleError(error2);
   }
 });
+program.command("config").description("Update schemaforge/config.json settings").command("migration-format <format>").description("Set migration file name format: hyphen (timestamp-name.sql) or underscore (timestamp_name.sql)").action(async (format) => {
+  try {
+    await runConfig({ migrationFormat: format });
+  } catch (error2) {
+    await handleError(error2);
+  }
+});
 program.command("validate").description("Detect destructive or risky schema changes. In CI environments (CI=true), exits with code 3 if destructive operations are detected unless --force is used.").option("--json", "Output structured JSON").option("--url <string>", "PostgreSQL connection URL for live drift validation (defaults to DATABASE_URL)").option("--schema <list>", "Comma-separated schema names to introspect (default: public)").action(async (options) => {
   try {
     const globalOptions = program.opts();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xubylele/schema-forge",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Universal migration generator from schema DSL",
   "main": "dist/cli.js",
   "type": "commonjs",