ddlforge 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ddlforge contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,326 @@
+# 🛡️ ddlforge
+
+> **Ultra-fast, zero-runtime-dependency PostgreSQL migration lock linter & data-loss prevention engine.**  
+> Built for Node.js 20+ and TypeScript. Designed for high-traffic Prisma, Drizzle, and raw SQL backends.
+
+[![Node.js](https://img.shields.io/badge/Node.js-20%2B-green.svg)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5%2B-blue.svg)](https://www.typescriptlang.org)
+[![Zero Dependencies](https://img.shields.io/badge/Runtime%20Dependencies-0-success.svg)](package.json)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+---
+
+## ⚡ Why ddlforge?
+
+In PostgreSQL, DDL commands take **table-level locks**. Even if a migration takes only milliseconds to run, if it requests an `ACCESS EXCLUSIVE` or `SHARE` lock while a long-running `SELECT` or transaction is open:
+1. The migration stalls waiting for the lock.
+2. **Every single query behind it is queued up**, including basic reads (`SELECT`).
+3. Connection pools instantly exhaust within seconds, crashing services and taking down production.
+
+Furthermore, ORMs like **Prisma Migrate** cannot detect column renames automatically: when you rename a field in `schema.prisma`, Prisma generates a `DROP COLUMN` followed by `ADD COLUMN`, permanently deleting all your production data!
+
+`ddlforge` catches these architectural pitfalls in your local pre-commit hooks and CI pipelines before code ever merges to main.
+
+### Design Principles
+- **Zero Runtime Dependencies**: Pure native Node.js standard library (`node:fs`, `node:path`, `node:process`, `node:child_process`). Air-gap safe.
+- **Sub-Second Performance**: Single-pass lexical scanner and linear rule evaluators. Scans 100+ migration files in **<10ms**.
+- **Deterministic Exit Codes**: Exits `0` when clean or advisory-only; exits `1` for any blocking violation (table lock or destructive data loss).
+
+---
+
+## 📊 PostgreSQL Lock Hierarchy Reference
+
+| Lock Mode | Acquired By | Conflicted Locks | Blocks Reads? | Blocks Writes? | Risk Level |
+|:---|:---|:---|:---:|:---:|:---:|
+| `ACCESS SHARE` | `SELECT` | `ACCESS EXCLUSIVE` | ❌ | ❌ | Low |
+| `ROW SHARE` | `SELECT FOR UPDATE / FOR SHARE` | `EXCLUSIVE`, `ACCESS EXCLUSIVE` | ❌ | ❌ | Low |
+| `ROW EXCLUSIVE` | `UPDATE`, `DELETE`, `INSERT` | `SHARE`, `SHARE ROW EXCLUSIVE`, `EXCLUSIVE`, `ACCESS EXCLUSIVE` | ❌ | ❌ | Medium |
+| `SHARE UPDATE EXCLUSIVE` | `CREATE INDEX CONCURRENTLY`, `VACUUM`, `ANALYZE`, `VALIDATE CONSTRAINT` | `SHARE UPDATE EXCLUSIVE`, `SHARE`, `SHARE ROW EXCLUSIVE`, `EXCLUSIVE`, `ACCESS EXCLUSIVE` | ❌ | ❌ | **Safe for Concurrency** |
+| `SHARE` | `CREATE INDEX` (non-concurrent) | `ROW EXCLUSIVE`, `SHARE ROW EXCLUSIVE`, `EXCLUSIVE`, `ACCESS EXCLUSIVE` | ❌ | **YES** | 🛑 **BLOCKER** |
+| `SHARE ROW EXCLUSIVE` | `ADD CONSTRAINT FOREIGN KEY` (without `NOT VALID`) | `ROW EXCLUSIVE`, `SHARE UPDATE EXCLUSIVE`, `SHARE`, `SHARE ROW EXCLUSIVE`, `EXCLUSIVE`, `ACCESS EXCLUSIVE` | ❌ | **YES** | 🛑 **BLOCKER** |
+| `EXCLUSIVE` | `REFRESH MATERIALIZED VIEW CONCURRENTLY` | `ROW SHARE`, `ROW EXCLUSIVE`, `SHARE UPDATE EXCLUSIVE`, `SHARE`, `SHARE ROW EXCLUSIVE`, `EXCLUSIVE`, `ACCESS EXCLUSIVE` | Row Share | **YES** | 🛑 **BLOCKER** |
+| `ACCESS EXCLUSIVE` | `ALTER TABLE`, `DROP TABLE`, `TRUNCATE`, `ALTER COLUMN SET NOT NULL` | **ALL LOCK MODES** | **YES (SELECT)** | **YES** | 🚨 **CRITICAL DOWNTIME** |
+
+---
+
+## 룰 The 7 Core Rules & Zero-Downtime Recipes
+
+### 1. `require-concurrent-index` (CREATE INDEX without CONCURRENTLY)
+- **Severity**: `BLOCKER`
+- **Lock**: `SHARE` lock (blocks all `INSERT`, `UPDATE`, `DELETE` operations on table).
+- **Dangerous**:
+  ```sql
+  CREATE INDEX idx_users_email ON users(email);
+  ```
+- **Zero-Downtime Fix**:
+  ```sql
+  CREATE INDEX CONCURRENTLY idx_users_email ON users(email);
+  ```
+
+---
+
+### 2. `concurrent-index-in-transaction` (CONCURRENTLY inside Transaction Trap)
+- **Severity**: `BLOCKER`
+- **Engine Behavior**: PostgreSQL aborts with `ERROR: CREATE INDEX CONCURRENTLY cannot run inside a transaction block`.
+- **Dangerous**:
+  ```sql
+  BEGIN;
+  CREATE INDEX CONCURRENTLY idx_users_email ON users(email);
+  COMMIT;
+  ```
+- **Prisma Caveat**: Prisma Migrate wraps all migrations in an implicit transaction by default. Running `CREATE INDEX CONCURRENTLY` in Prisma fails unless you add the `-- prisma:no-transaction` directive.
+- **Zero-Downtime Fix**:
+  ```sql
+  -- prisma:no-transaction
+  CREATE INDEX CONCURRENTLY "users_email_idx" ON "users"("email");
+  ```
+
+---
+
+### 3. `add-column-not-null-without-default` (ADD COLUMN NOT NULL without DEFAULT)
+- **Severity**: `BLOCKER`
+- **Lock**: `ACCESS EXCLUSIVE` lock.
+- **Dangerous**:
+  ```sql
+  ALTER TABLE users ADD COLUMN role VARCHAR(50) NOT NULL;
+  ```
+- **Why**: On non-empty tables, PostgreSQL immediately aborts with `ERROR: column "role" contains null values` while holding an `ACCESS EXCLUSIVE` table lock.
+- **Zero-Downtime Fix (PG 11+)**:
+  Provide a static non-volatile default (metadata-only instant operation):
+  ```sql
+  ALTER TABLE users ADD COLUMN role VARCHAR(50) DEFAULT 'user' NOT NULL;
+  ```
+  Or for dynamic/custom defaults, use the multi-step backfill pattern:
+  ```sql
+  -- Step 1: Add column nullable
+  ALTER TABLE users ADD COLUMN role VARCHAR(50);
+  -- Step 2: Batched backfill
+  -- Step 3: Add CHECK constraint NOT VALID & validate
+  ALTER TABLE users ADD CONSTRAINT chk_role_not_null CHECK (role IS NOT NULL) NOT VALID;
+  ALTER TABLE users VALIDATE CONSTRAINT chk_role_not_null;
+  ```
+
+---
+
+### 4. `foreign-key-missing-not-valid` (ADD CONSTRAINT FOREIGN KEY without NOT VALID)
+- **Severity**: `BLOCKER`
+- **Lock**: `SHARE ROW EXCLUSIVE` on referencing table + `SHARE` on referenced table.
+- **Dangerous**:
+  ```sql
+  ALTER TABLE orders ADD CONSTRAINT fk_user FOREIGN KEY (user_id) REFERENCES users(id);
+  ```
+- **Zero-Downtime Fix**:
+  Split into two non-blocking steps:
+  ```sql
+  -- Step 1: Add constraint without scanning rows (instant metadata operation)
+  ALTER TABLE orders ADD CONSTRAINT fk_user FOREIGN KEY (user_id) REFERENCES users(id) NOT VALID;
+
+  -- Step 2: Validate concurrently (takes only SHARE UPDATE EXCLUSIVE, reads & writes proceed!)
+  ALTER TABLE orders VALIDATE CONSTRAINT fk_user;
+  ```
+
+---
+
+### 5. `prisma-silent-rename-data-loss` (Prisma Silent Field Rename)
+- **Severity**: `BLOCKER` (Data-Loss Prevention)
+- **Lock**: `ACCESS EXCLUSIVE` + Table Data Loss.
+- **Dangerous**:
+  ```sql
+  ALTER TABLE "users" DROP COLUMN "old_name";
+  ALTER TABLE "users" ADD COLUMN "new_name" TEXT NOT NULL;
+  ```
+- **Why**: Prisma Migrate cannot infer renames from `schema.prisma`. It generates a column drop followed by column creation, destroying all production data.
+- **Zero-Downtime Fix**:
+  ```sql
+  ALTER TABLE "users" RENAME COLUMN "old_name" TO "new_name";
+  ```
+  Or use Prisma's `@map("old_name")` in your schema to avoid database column renames.
+
+---
+
+### 6. `set-not-null-full-scan` (ALTER COLUMN SET NOT NULL)
+- **Severity**: `WARNING` (or `BLOCKER` on PG < 12)
+- **Lock**: `ACCESS EXCLUSIVE` lock while scanning entire table for nulls.
+- **Dangerous**:
+  ```sql
+  ALTER TABLE users ALTER COLUMN email SET NOT NULL;
+  ```
+- **Zero-Downtime Fix (PG 12+)**:
+  ```sql
+  -- 1. Add CHECK constraint NOT VALID (instant)
+  ALTER TABLE users ADD CONSTRAINT chk_users_email_not_null CHECK (email IS NOT NULL) NOT VALID;
+  -- 2. Validate constraint without blocking writes
+  ALTER TABLE users VALIDATE CONSTRAINT chk_users_email_not_null;
+  -- 3. Set NOT NULL (Postgres 12+ skips table scan because validated CHECK constraint exists!)
+  ALTER TABLE users ALTER COLUMN email SET NOT NULL;
+  ```
+
+---
+
+### 7. `unbatched-dml` (Unbatched DML in Migration)
+- **Severity**: `WARNING` (or `BLOCKER` without WHERE)
+- **Lock**: `ROW EXCLUSIVE` lock on touched rows, massive transaction WAL bloat.
+- **Dangerous**:
+  ```sql
+  UPDATE users SET active = true;
+  DELETE FROM sessions;
+  ```
+- **Zero-Downtime Fix**:
+  Perform large backfills out-of-band using batched background workers. If updating a small static/seed table, exempt with an inline comment:
+  ```sql
+  -- ddlforge-ignore unbatched-dml
+  UPDATE subscription_tiers SET active = true WHERE code = 'PRO';
+  ```
+
+---
+
+## 🚀 CLI Installation & Usage
+
+### Running via npx (Zero Install)
+```bash
+npx ddlforge ./prisma/migrations
+```
+
+### Local Installation
+```bash
+npm install --save-dev ddlforge
+```
+
+### CLI Flags
+```text
+ddlforge [paths...] [flags]
+
+ARGUMENTS:
+  paths               Target migration files or directories (e.g. ./prisma/migrations, ./drizzle)
+
+FLAGS:
+  --pg <version>      Target PostgreSQL version (default: 16)
+  --format <type>     Output format: terminal | json | markdown (default: terminal)
+  --quiet, -q         Suppress advisories/warnings and emit blockers only
+  --changed-only      Use git diff to lint only staged or branch-modified migration files
+  --version, -v       Print ddlforge version and exit
+  --help, -h          Print this help message and exit
+```
+
+### Examples
+```bash
+# Lint all Prisma migrations
+npx ddlforge ./prisma/migrations
+
+# Lint only modified migration files in current git branch / PR
+npx ddlforge --changed-only
+
+# Check Drizzle migrations targeting Postgres 14 with JSON output
+npx ddlforge ./drizzle --pg 14 --format json
+
+# CI Mode: Emit blockers only with exit code 1
+npx ddlforge ./migrations --quiet
+```
+
+---
+
+## 🤖 GitHub Actions Workflow
+
+Add this copy-paste workflow to `.github/workflows/migration-lint.yml`:
+
+```yaml
+name: Migration Lock Linter
+
+on:
+  pull_request:
+    paths:
+      - '**/migrations/**'
+      - '**/*.sql'
+
+jobs:
+  lint-migrations:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Run ddlforge Lock Linter
+        run: |
+          npx ddlforge --changed-only --format terminal
+```
+
+### PR Comment Workflow (with Markdown Formatter)
+```yaml
+      - name: Generate Migration Safety Report
+        if: always()
+        run: |
+          npx ddlforge --changed-only --format markdown > report.md
+          cat report.md >> $GITHUB_STEP_SUMMARY
+```
+
+---
+
+## 💻 Programmatic TypeScript API
+
+You can also use `ddlforge` programmatically within your custom deployment scripts:
+
+```typescript
+import { analyzeSql, MigrationAnalyzer, formatTerminal } from 'ddlforge';
+
+const sql = `
+  CREATE INDEX idx_users_email ON users(email);
+`;
+
+const result = analyzeSql(sql, {
+  filePath: 'migrations/001_create_index.sql',
+  pgVersion: 16,
+});
+
+if (result.hasBlockers) {
+  console.error(`Found ${result.blockersCount} blocking migration locks!`);
+  console.log(formatTerminal([result]));
+  process.exit(1);
+}
+```
+
+---
+
+## ⚙️ Inline Directives
+
+You can suppress specific rules per statement using inline comments:
+
+```sql
+-- ddlforge-ignore require-concurrent-index
+CREATE INDEX idx_temp ON temporary_cache(key);
+
+-- ddlforge-ignore unbatched-dml
+UPDATE plan_limits SET max_seats = 100 WHERE plan_id = 'enterprise';
+```
+
+For Prisma migrations containing `CONCURRENTLY`:
+```sql
+-- prisma:no-transaction
+CREATE INDEX CONCURRENTLY "users_email_idx" ON "users"("email");
+```
+
+---
+
+## 🧪 Testing & Verification
+
+Run the native test suite:
+```bash
+npm test
+```
+
+Performance benchmark:
+```text
+✔ analyzes 100 migrations in under 100 milliseconds (9.2ms)
+```
+
+---
+
+## 📄 License
+
+MIT © [ddlforge](https://github.com/ddlforge/ddlforge)

package/dist/bin/ddlforge.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * ddlforge - Postgres migration lock linter and data-loss prevention engine
+ */
+export {};
+//# sourceMappingURL=ddlforge.d.ts.map

package/dist/bin/ddlforge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddlforge.d.ts","sourceRoot":"","sources":["../../bin/ddlforge.ts"],"names":[],"mappings":";AAEA;;GAEG"}

package/dist/bin/ddlforge.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * ddlforge - Postgres migration lock linter and data-loss prevention engine
+ */
+import { runCli } from '../src/cli.js';
+runCli(process.argv.slice(2))
+    .then(exitCode => {
+    process.exit(exitCode);
+})
+    .catch(err => {
+    console.error('Fatal ddlforge error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=ddlforge.js.map

package/dist/bin/ddlforge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddlforge.js","sourceRoot":"","sources":["../../bin/ddlforge.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KAC1B,IAAI,CAAC,QAAQ,CAAC,EAAE;IACf,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC,CAAC;KACD,KAAK,CAAC,GAAG,CAAC,EAAE;IACX,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/cli.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ddlforge - Zero-dependency custom CLI argument parser and execution engine
+ */
+export interface CliOptions {
+    targets: string[];
+    pgVersion: number;
+    format: 'terminal' | 'json' | 'markdown';
+    quiet: boolean;
+    changedOnly: boolean;
+    help: boolean;
+    version: boolean;
+}
+export declare const VERSION = "0.1.0";
+export declare function parseArgs(args: string[]): CliOptions;
+export declare function printHelp(): void;
+/**
+ * Finds all .sql files from input paths, directories, or defaults.
+ */
+export declare function discoverSqlFiles(targets: string[], changedOnly: boolean, cwd?: string): string[];
+export declare function runCli(argv?: string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAkFpD;AAED,wBAAgB,SAAS,IAAI,IAAI,CAwBhC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,EAAE,CAwB/G;AAgFD,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDpF"}

package/dist/src/cli.js

@@ -0,0 +1,262 @@
+/**
+ * ddlforge - Zero-dependency custom CLI argument parser and execution engine
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execSync } from 'node:child_process';
+import { MigrationAnalyzer } from './engine/analyzer.js';
+import { formatTerminal } from './reporters/terminal.js';
+import { formatJson } from './reporters/json.js';
+import { formatMarkdown } from './reporters/markdown.js';
+export const VERSION = '0.1.0';
+export function parseArgs(args) {
+    const options = {
+        targets: [],
+        pgVersion: 16,
+        format: 'terminal',
+        quiet: false,
+        changedOnly: false,
+        help: false,
+        version: false,
+    };
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            options.help = true;
+            i++;
+            continue;
+        }
+        if (arg === '--version' || arg === '-v') {
+            options.version = true;
+            i++;
+            continue;
+        }
+        if (arg === '--quiet' || arg === '-q') {
+            options.quiet = true;
+            i++;
+            continue;
+        }
+        if (arg === '--changed-only') {
+            options.changedOnly = true;
+            i++;
+            continue;
+        }
+        if (arg === '--pg') {
+            i++;
+            if (i < args.length) {
+                options.pgVersion = parseInt(args[i], 10) || 16;
+            }
+            i++;
+            continue;
+        }
+        if (arg.startsWith('--pg=')) {
+            options.pgVersion = parseInt(arg.slice(5), 10) || 16;
+            i++;
+            continue;
+        }
+        if (arg === '--format') {
+            i++;
+            if (i < args.length) {
+                const fmt = args[i].toLowerCase();
+                if (fmt === 'json' || fmt === 'markdown' || fmt === 'terminal') {
+                    options.format = fmt;
+                }
+            }
+            i++;
+            continue;
+        }
+        if (arg.startsWith('--format=')) {
+            const fmt = arg.slice(9).toLowerCase();
+            if (fmt === 'json' || fmt === 'markdown' || fmt === 'terminal') {
+                options.format = fmt;
+            }
+            i++;
+            continue;
+        }
+        // Positional target
+        if (!arg.startsWith('-')) {
+            options.targets.push(arg);
+        }
+        i++;
+    }
+    return options;
+}
+export function printHelp() {
+    console.log(`
+ddlforge v${VERSION} — Ultra-fast, zero-dependency Postgres migration lock linter
+
+USAGE:
+  ddlforge [paths...] [flags]
+
+ARGUMENTS:
+  paths               Target migration files or directories (e.g. ./prisma/migrations, ./drizzle)
+
+FLAGS:
+  --pg <version>      Target PostgreSQL version (default: 16)
+  --format <type>     Output format: terminal | json | markdown (default: terminal)
+  --quiet, -q         Suppress advisories/warnings and emit blockers only
+  --changed-only      Use git diff to lint only staged or branch-modified migration files
+  --version, -v       Print ddlforge version and exit
+  --help, -h          Print this help message and exit
+
+EXAMPLES:
+  $ ddlforge ./prisma/migrations
+  $ ddlforge ./drizzle --pg 14 --format json
+  $ ddlforge --changed-only
+  $ ddlforge ./migrations/001_add_index.sql
+`);
+}
+/**
+ * Finds all .sql files from input paths, directories, or defaults.
+ */
+export function discoverSqlFiles(targets, changedOnly, cwd = process.cwd()) {
+    if (changedOnly) {
+        return getChangedSqlFiles(cwd);
+    }
+    const filesToScan = [];
+    const candidateTargets = targets.length > 0
+        ? targets
+        : findDefaultMigrationTargets(cwd);
+    for (const target of candidateTargets) {
+        const fullPath = path.isAbsolute(target) ? target : path.resolve(cwd, target);
+        if (!fs.existsSync(fullPath))
+            continue;
+        const stat = fs.statSync(fullPath);
+        if (stat.isDirectory()) {
+            collectSqlFromDir(fullPath, filesToScan);
+        }
+        else if (stat.isFile() && (fullPath.endsWith('.sql') || targets.length > 0)) {
+            filesToScan.push(fullPath);
+        }
+    }
+    return filesToScan;
+}
+function findDefaultMigrationTargets(cwd) {
+    const commonDirs = [
+        'prisma/migrations',
+        'drizzle',
+        'migrations',
+        'sql',
+    ];
+    const found = [];
+    for (const dir of commonDirs) {
+        const p = path.resolve(cwd, dir);
+        if (fs.existsSync(p) && fs.statSync(p).isDirectory()) {
+            found.push(p);
+        }
+    }
+    return found.length > 0 ? found : [cwd];
+}
+function collectSqlFromDir(dir, accumulator) {
+    const IGNORED = new Set(['node_modules', '.git', 'dist', 'build', '.next', '.turbo']);
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            if (!IGNORED.has(entry.name)) {
+                collectSqlFromDir(path.join(dir, entry.name), accumulator);
+            }
+        }
+        else if (entry.isFile() && entry.name.endsWith('.sql')) {
+            accumulator.push(path.join(dir, entry.name));
+        }
+    }
+}
+function getChangedSqlFiles(cwd) {
+    const resultFiles = new Set();
+    // 1. Try git diff --name-only HEAD (staged and unstaged against HEAD)
+    try {
+        const diffHead = execSync('git diff --name-only HEAD', { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
+        diffHead
+            .split(/\r?\n/)
+            .map((f) => f.trim())
+            .filter((f) => f.endsWith('.sql') && f.length > 0)
+            .forEach((f) => {
+            const full = path.resolve(cwd, f);
+            if (fs.existsSync(full))
+                resultFiles.add(full);
+        });
+    }
+    catch {
+        // If no commits yet / no HEAD commit
+        try {
+            const unstaged = execSync('git diff --name-only', { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
+            unstaged
+                .split(/\r?\n/)
+                .map((f) => f.trim())
+                .filter((f) => f.endsWith('.sql') && f.length > 0)
+                .forEach((f) => {
+                const full = path.resolve(cwd, f);
+                if (fs.existsSync(full))
+                    resultFiles.add(full);
+            });
+        }
+        catch { }
+        try {
+            const staged = execSync('git diff --name-only --cached', { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
+            staged
+                .split(/\r?\n/)
+                .map((f) => f.trim())
+                .filter((f) => f.endsWith('.sql') && f.length > 0)
+                .forEach((f) => {
+                const full = path.resolve(cwd, f);
+                if (fs.existsSync(full))
+                    resultFiles.add(full);
+            });
+        }
+        catch { }
+    }
+    return Array.from(resultFiles);
+}
+export async function runCli(argv = process.argv.slice(2)) {
+    const options = parseArgs(argv);
+    if (options.help) {
+        printHelp();
+        return 0;
+    }
+    if (options.version) {
+        console.log(`ddlforge v${VERSION}`);
+        return 0;
+    }
+    const files = discoverSqlFiles(options.targets, options.changedOnly);
+    if (files.length === 0) {
+        if (options.format === 'json') {
+            console.log(formatJson([]));
+        }
+        else if (options.format === 'markdown') {
+            console.log(formatMarkdown([]));
+        }
+        else {
+            console.log('No migration .sql files found to analyze.');
+        }
+        return 0;
+    }
+    const analyzer = new MigrationAnalyzer();
+    const results = [];
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, 'utf-8');
+            const res = analyzer.analyze(content, {
+                filePath: file,
+                pgVersion: options.pgVersion,
+            });
+            results.push(res);
+        }
+        catch (err) {
+            console.error(`Error reading ${file}: ${err?.message ?? String(err)}`);
+        }
+    }
+    // Format and output results
+    if (options.format === 'json') {
+        console.log(formatJson(results));
+    }
+    else if (options.format === 'markdown') {
+        console.log(formatMarkdown(results));
+    }
+    else {
+        console.log(formatTerminal(results, { quiet: options.quiet }));
+    }
+    const hasBlockers = results.some(r => r.hasBlockers);
+    return hasBlockers ? 1 : 0;
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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"}