@plumbus/core 0.2.9 → 0.3.0

package/dist/data/framework-migration-rewriter.js

@@ -0,0 +1,357 @@
+// ── Framework Migration Rewriter ──
+// Transforms drizzle-kit's raw migration SQL so that it can be safely applied
+// against a database whose framework-managed tables (flow_executions, etc.)
+// already exist but are missing newly-added framework columns.
+//
+// Why this exists:
+//   When a project upgrades `@plumbus/core`, the framework's own table schemas
+//   may have grown new columns (e.g. flow leasing added `lease_owner` and
+//   `lease_expires_at` to `flow_executions`). Drizzle-kit, which generates
+//   migrations purely from snapshot diffs, has no awareness of which tables
+//   are framework-managed and emits `CREATE TABLE` for the entire framework
+//   table — even when the table already exists in the live DB. That migration
+//   is then rejected by the `migrate apply` preflight ("framework table
+//   already exists"), leaving users with no clean upgrade path.
+//
+// What this does:
+//   Given the raw SQL drizzle-kit produced and a `DriftReport` from
+//   `inspectFrameworkDrift`, we rewrite the SQL so that:
+//     • CREATE TABLE statements for framework tables that already exist are
+//       replaced with one ALTER TABLE … ADD COLUMN per `missing_in_db`
+//       column reported by the drift inspector. Column type/null/default
+//       text is parsed verbatim out of the original CREATE TABLE body so we
+//       inherit drizzle-kit's exact serialization.
+//     • CREATE TABLE statements for framework tables whose columns already
+//       fully match the schema are dropped entirely.
+//     • CREATE INDEX / CREATE UNIQUE INDEX statements are wrapped with
+//       IF NOT EXISTS so re-running on a partially migrated DB doesn't trip
+//       on indexes that already exist (Postgres ≥ 9.5).
+//     • Everything else (entity tables, ALTERs to entity tables, constraints,
+//       etc.) passes through unchanged.
+//
+// Limitations (future work):
+//   • IF NOT EXISTS only suppresses the duplicate-name error on relations
+//     and indexes; it does NOT verify that the existing definition actually
+//     matches what the migration intends. Safe full reconciliation requires
+//     comparing columns, defaults, constraints, and indexes — see
+//     `inspectFrameworkDrift` for a starting point. We currently only act
+//     on `missing_in_db` columns; `type_mismatch`, `nullability_mismatch`,
+//     and `extra_in_db` are surfaced in the summary but not auto-rewritten,
+//     because resolving them safely usually needs human judgment.
+//   • CONSTRAINT clauses inside a rewrite-target CREATE TABLE (e.g. table-
+//     level UNIQUE / CHECK) are dropped with a warning — Postgres has no
+//     ADD CONSTRAINT IF NOT EXISTS, so we can't safely re-add idempotently.
+import { FRAMEWORK_TABLE_NAMES, } from './drift-inspector.js';
+const STATEMENT_BREAKPOINT = '--> statement-breakpoint';
+const FRAMEWORK_TABLE_SET = new Set(FRAMEWORK_TABLE_NAMES);
+/**
+ * Rewrite drizzle-kit migration statements to be safe against framework-table
+ * drift.
+ *
+ * Operates on the raw `string[]` that `drizzle-kit/api.generateMigration`
+ * returns — one element per SQL statement. Returns a new array of statements
+ * (some may be removed, some may expand into multiple ALTER TABLE …
+ * statements) along with a structured summary for logging.
+ *
+ * Pure function — no IO, no DB access.
+ *
+ * If the report contains no `existingFrameworkTables`, the input is returned
+ * unchanged apart from index IF NOT EXISTS wrapping, which is always safe.
+ */
+export function rewriteFrameworkDriftMigration(inputStatements, driftReport, _schemas) {
+    const summary = {
+        alteredTables: [],
+        droppedCreateTables: [],
+        wrappedIndexes: [],
+        idempotentAddColumns: [],
+        warnings: [],
+    };
+    const driftByTable = new Map();
+    for (const table of driftReport.tables) {
+        driftByTable.set(table.tableName, table);
+    }
+    const existingFrameworkSet = new Set(driftReport.existingFrameworkTables);
+    const out = [];
+    for (const stmt of inputStatements) {
+        const trimmed = stmt.trim();
+        if (!trimmed)
+            continue;
+        const createTableName = matchCreateTableName(trimmed);
+        if (createTableName && existingFrameworkSet.has(createTableName)) {
+            const tableDrift = driftByTable.get(createTableName);
+            const missing = tableDrift?.columnDrifts.filter((d) => d.kind === 'missing_in_db') ?? [];
+            if (missing.length === 0) {
+                // Table already fully matches — drop the CREATE TABLE.
+                summary.droppedCreateTables.push(createTableName);
+                continue;
+            }
+            const parsed = parseCreateTableBody(trimmed);
+            if (!parsed) {
+                // Couldn't parse safely — leave as-is and warn. Apply preflight will
+                // still catch the conflict; better to fail loudly than to lose data.
+                summary.warnings.push(`Could not parse CREATE TABLE for "${createTableName}"; passing through unchanged.`);
+                out.push(stmt);
+                continue;
+            }
+            const columnLineByName = new Map(parsed.columnLines.map((c) => [c.name, c.line]));
+            const altered = [];
+            const alterStatements = [];
+            for (const col of missing) {
+                const line = columnLineByName.get(col.column);
+                if (!line) {
+                    // Drift inspector reported a missing column but drizzle-kit didn't
+                    // include a definition for it — schema desync. Warn and skip.
+                    summary.warnings.push(`Drift reported missing column "${createTableName}.${col.column}" but the generated CREATE TABLE has no matching definition.`);
+                    continue;
+                }
+                alterStatements.push(`ALTER TABLE "${createTableName}" ADD COLUMN ${line};`);
+                altered.push(col.column);
+            }
+            if (parsed.constraintLines.length > 0) {
+                summary.warnings.push(`Dropped ${parsed.constraintLines.length} table-level constraint clause(s) from CREATE TABLE for "${createTableName}" because Postgres does not support ADD CONSTRAINT IF NOT EXISTS. If a new framework constraint is required, add it manually.`);
+            }
+            if (alterStatements.length === 0) {
+                summary.droppedCreateTables.push(createTableName);
+                continue;
+            }
+            summary.alteredTables.push({
+                table: createTableName,
+                addedColumns: altered,
+            });
+            // Push each ALTER as its own array element so the caller can join with
+            // any separator (including a literal newline, which is what drizzle-kit
+            // already does for migration files).
+            for (const a of alterStatements)
+                out.push(a);
+            continue;
+        }
+        const indexWrapped = wrapCreateIndexIfNotExists(trimmed);
+        if (indexWrapped !== trimmed) {
+            summary.wrappedIndexes.push(extractIndexName(trimmed) ?? '<anonymous>');
+            out.push(indexWrapped);
+            continue;
+        }
+        const addColWrapped = wrapAlterAddColumnIfNotExists(trimmed);
+        if (addColWrapped !== trimmed) {
+            summary.idempotentAddColumns.push(extractAddColumnTarget(trimmed) ?? '<unknown>');
+            out.push(addColWrapped);
+            continue;
+        }
+        out.push(stmt);
+    }
+    return {
+        statements: out,
+        summary,
+    };
+}
+// ── Internals ──
+/**
+ * Re-exported for callers that want to render rewritten statements with the
+ * same separator drizzle-kit uses internally for breakpoint-aware tooling.
+ */
+export const STATEMENT_BREAKPOINT_MARKER = STATEMENT_BREAKPOINT;
+const CREATE_TABLE_HEAD_RE = /^\s*CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?(?:"([^"]+)"|([a-zA-Z_]\w*))/i;
+function matchCreateTableName(stmt) {
+    const m = stmt.match(CREATE_TABLE_HEAD_RE);
+    if (!m)
+        return null;
+    return m[1] ?? m[2] ?? null;
+}
+const TABLE_LEVEL_CONSTRAINT_KEYWORDS = [
+    'CONSTRAINT',
+    'PRIMARY KEY',
+    'UNIQUE',
+    'CHECK',
+    'FOREIGN KEY',
+    'EXCLUDE',
+];
+/**
+ * Parse the parenthesized body of a CREATE TABLE statement into individual
+ * column definition lines. Drizzle-kit emits one column per line, separated
+ * by commas, with the column name as a quoted identifier at the start.
+ *
+ * Returns null if the body cannot be located (e.g. no opening paren).
+ */
+function parseCreateTableBody(stmt) {
+    const openIdx = stmt.indexOf('(');
+    if (openIdx < 0)
+        return null;
+    // Find the matching closing paren. Drizzle-kit-generated bodies don't
+    // contain nested parens for our purposes (no inline CHECK constraints etc.
+    // — those would surface as constraintLines). We still scan with depth so we
+    // don't get fooled by anything embedded.
+    let depth = 0;
+    let closeIdx = -1;
+    let inSingleQuote = false;
+    for (let i = openIdx; i < stmt.length; i++) {
+        const ch = stmt[i];
+        if (ch === "'" && stmt[i - 1] !== '\\')
+            inSingleQuote = !inSingleQuote;
+        if (inSingleQuote)
+            continue;
+        if (ch === '(')
+            depth++;
+        else if (ch === ')') {
+            depth--;
+            if (depth === 0) {
+                closeIdx = i;
+                break;
+            }
+        }
+    }
+    if (closeIdx < 0)
+        return null;
+    const body = stmt.slice(openIdx + 1, closeIdx);
+    // Split by top-level commas (no nesting expected in column defs, but be
+    // defensive about quoted strings and parens just in case).
+    const segments = splitTopLevelCommas(body);
+    const columnLines = [];
+    const constraintLines = [];
+    for (const raw of segments) {
+        const line = raw.trim();
+        if (!line)
+            continue;
+        if (isConstraintLine(line)) {
+            constraintLines.push(line);
+            continue;
+        }
+        const nameMatch = line.match(/^"([^"]+)"\s+(.+)$/) ?? line.match(/^([a-zA-Z_]\w*)\s+(.+)$/);
+        if (!nameMatch) {
+            // Unrecognized — treat as constraint to be safe (will trigger warning).
+            constraintLines.push(line);
+            continue;
+        }
+        const colName = nameMatch[1];
+        columnLines.push({ name: colName, line });
+    }
+    return { columnLines, constraintLines };
+}
+function splitTopLevelCommas(body) {
+    const parts = [];
+    let depth = 0;
+    let inSingleQuote = false;
+    let start = 0;
+    for (let i = 0; i < body.length; i++) {
+        const ch = body[i];
+        if (ch === "'" && body[i - 1] !== '\\')
+            inSingleQuote = !inSingleQuote;
+        if (inSingleQuote)
+            continue;
+        if (ch === '(')
+            depth++;
+        else if (ch === ')')
+            depth--;
+        else if (ch === ',' && depth === 0) {
+            parts.push(body.slice(start, i));
+            start = i + 1;
+        }
+    }
+    parts.push(body.slice(start));
+    return parts;
+}
+function isConstraintLine(line) {
+    const upper = line.toUpperCase();
+    return TABLE_LEVEL_CONSTRAINT_KEYWORDS.some((kw) => upper.startsWith(kw));
+}
+const CREATE_INDEX_RE = /^(\s*)CREATE\s+(UNIQUE\s+)?INDEX(?!\s+IF\s+NOT\s+EXISTS\b)\s+/i;
+function wrapCreateIndexIfNotExists(stmt) {
+    return stmt.replace(CREATE_INDEX_RE, (_match, leading, unique) => {
+        const u = unique ? unique : '';
+        return `${leading}CREATE ${u}INDEX IF NOT EXISTS `;
+    });
+}
+const INDEX_NAME_RE = /CREATE\s+(?:UNIQUE\s+)?INDEX\s+(?:IF\s+NOT\s+EXISTS\s+)?"?([^"\s]+)"?/i;
+function extractIndexName(stmt) {
+    const m = stmt.match(INDEX_NAME_RE);
+    return m?.[1] ?? null;
+}
+// Match `ALTER TABLE [IF EXISTS] <tbl> ADD COLUMN [IF NOT EXISTS]`. We only
+// want to rewrite when IF NOT EXISTS is *not* already present. Multiple
+// ADD COLUMN clauses can appear in one ALTER TABLE statement separated by
+// commas; we wrap every one of them.
+const ALTER_ADD_COLUMN_RE = /\bADD\s+COLUMN(?!\s+IF\s+NOT\s+EXISTS\b)\s+/gi;
+function isAlterTableStatement(stmt) {
+    return /^\s*ALTER\s+TABLE\b/i.test(stmt);
+}
+/**
+ * Rewrite `ALTER TABLE … ADD COLUMN <name> …` to `ADD COLUMN IF NOT EXISTS
+ * <name> …`. We do not touch `ADD CONSTRAINT`, `ALTER COLUMN`, etc.
+ *
+ * Why universal idempotency:
+ *   Drizzle-kit's diff-based generation depends on the snapshot in
+ *   drizzle/meta accurately reflecting the live schema. Real projects
+ *   accumulate snapshot drift (manually edited migrations, partial applies,
+ *   prod hotfixes). Making framework-emitted ADD COLUMN idempotent removes a
+ *   whole class of "column already exists" apply failures without changing
+ *   semantics: a real type/default mismatch will still surface elsewhere
+ *   (e.g. queries failing at runtime), and the apply path remains a no-op
+ *   when the column is already there.
+ *
+ * Limitation (future work, mirrors the index case):
+ *   Postgres' `IF NOT EXISTS` only suppresses the duplicate-name error; it
+ *   does NOT verify that the existing column matches the requested type,
+ *   nullability, or default. Comprehensive reconciliation requires
+ *   `inspectFrameworkDrift`-style comparison across every column for every
+ *   user-managed entity, not just the framework-managed tables.
+ */
+function wrapAlterAddColumnIfNotExists(stmt) {
+    if (!isAlterTableStatement(stmt))
+        return stmt;
+    return stmt.replace(ALTER_ADD_COLUMN_RE, 'ADD COLUMN IF NOT EXISTS ');
+}
+const ALTER_TABLE_TARGET_RE = /^\s*ALTER\s+TABLE\s+(?:IF\s+EXISTS\s+)?(?:"([^"]+)"|([a-zA-Z_]\w*))/i;
+const ADD_COLUMN_NAME_RE = /\bADD\s+COLUMN(?:\s+IF\s+NOT\s+EXISTS)?\s+(?:"([^"]+)"|([a-zA-Z_]\w*))/gi;
+function extractAddColumnTarget(stmt) {
+    const tableMatch = stmt.match(ALTER_TABLE_TARGET_RE);
+    const table = tableMatch?.[1] ?? tableMatch?.[2] ?? null;
+    if (!table)
+        return null;
+    const columns = [];
+    for (const m of stmt.matchAll(ADD_COLUMN_NAME_RE)) {
+        columns.push(m[1] ?? m[2]);
+    }
+    if (columns.length === 0)
+        return `"${table}"`;
+    return `"${table}".${columns.map((c) => `"${c}"`).join(',')}`;
+}
+/**
+ * Convenience: format the rewriter summary for human-readable CLI output.
+ * Returns an array of lines (no trailing newlines), or an empty array if no
+ * meaningful rewriting happened.
+ */
+export function formatRewriteSummary(summary) {
+    const lines = [];
+    if (summary.alteredTables.length > 0) {
+        lines.push('Framework drift rewrite: emitted ALTER TABLE ADD COLUMN for:');
+        for (const t of summary.alteredTables) {
+            lines.push(`  ${t.table}: ${t.addedColumns.join(', ')}`);
+        }
+    }
+    if (summary.droppedCreateTables.length > 0) {
+        lines.push(`Framework drift rewrite: dropped redundant CREATE TABLE for: ${summary.droppedCreateTables.join(', ')}`);
+    }
+    if (summary.wrappedIndexes.length > 0) {
+        lines.push(`Framework drift rewrite: wrapped ${summary.wrappedIndexes.length} CREATE INDEX statement(s) with IF NOT EXISTS.`);
+    }
+    if (summary.idempotentAddColumns.length > 0) {
+        lines.push(`Framework drift rewrite: made ${summary.idempotentAddColumns.length} ALTER TABLE ADD COLUMN statement(s) idempotent.`);
+    }
+    for (const w of summary.warnings) {
+        lines.push(`  warning: ${w}`);
+    }
+    return lines;
+}
+/**
+ * True if the rewriter actually changed anything beyond cosmetic whitespace.
+ * Useful for skipping noisy logs when the migration was clean already.
+ */
+export function rewriteHadEffect(summary) {
+    return (summary.alteredTables.length > 0 ||
+        summary.droppedCreateTables.length > 0 ||
+        summary.wrappedIndexes.length > 0 ||
+        summary.idempotentAddColumns.length > 0 ||
+        summary.warnings.length > 0);
+}
+// Re-export so callers can keep a single import surface.
+export { FRAMEWORK_TABLE_SET };
+//# sourceMappingURL=framework-migration-rewriter.js.map

package/dist/data/framework-migration-rewriter.js.map

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

package/dist/data/index.d.ts

@@ -1,5 +1,6 @@
 export { gte, ilike, like, lte, sql } from 'drizzle-orm';
-export { applyMigrations, collectSchemas, rollbackLastMigration, type MigrationConfig, type MigrationRecord, } from './migration.js';
+export { applyMigrations, collectSchemas, readPendingMigrations, rollbackLastMigration, type MigrationApplyResult, type MigrationConfig, type MigrationRecord, type PendingMigration, } from './migration.js';
+export { extractCreateTableNames, formatDriftReport, FRAMEWORK_TABLE_NAMES, getExistingFrameworkTables, inspectFrameworkDrift, type ColumnDrift, type DriftReport, type FrameworkTableName, type TableDrift, } from './drift-inspector.js';
 export { EntityRegistry } from './registry.js';
 export { createRepository, type RepositoryOptions } from './repository.js';
 export { generateDrizzleSchema, generateSchemas } from './schema-generator.js';

package/dist/data/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EACL,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EACL,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/data/index.js

@@ -5,7 +5,8 @@
 // Key exports: createRepository, EntityRegistry, generateDrizzleSchema, applyMigrations
 // Re-export Drizzle operators for use in query conditions
 export { gte, ilike, like, lte, sql } from 'drizzle-orm';
-export { applyMigrations, collectSchemas, rollbackLastMigration, } from './migration.js';
+export { applyMigrations, collectSchemas, readPendingMigrations, rollbackLastMigration, } from './migration.js';
+export { extractCreateTableNames, formatDriftReport, FRAMEWORK_TABLE_NAMES, getExistingFrameworkTables, inspectFrameworkDrift, } from './drift-inspector.js';
 export { EntityRegistry } from './registry.js';
 export { createRepository } from './repository.js';
 export { generateDrizzleSchema, generateSchemas } from './schema-generator.js';

package/dist/data/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,+EAA+E;AAC/E,oEAAoE;AACpE,EAAE;AACF,wFAAwF;AAExF,0DAA0D;AAC1D,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EACL,eAAe,EACf,cAAc,EACd,qBAAqB,GAGtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAA0B,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,+EAA+E;AAC/E,oEAAoE;AACpE,EAAE;AACF,wFAAwF;AAExF,0DAA0D;AAC1D,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EACL,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,qBAAqB,GAKtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,GAKtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAA0B,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/data/migration.d.ts

@@ -5,10 +5,40 @@ export interface MigrationConfig {
     db: PostgresJsDatabase;
     migrationsFolder: string;
 }
+export interface PendingMigration {
+    tag: string;
+    hash: string;
+    statements: string[];
+    rawSql: string;
+    folderMillis: number;
+}
+export interface MigrationApplyResult {
+    applied: number;
+    tags: string[];
+}
+export interface MigrationReconcileResult {
+    adopted: number;
+    alreadyApplied: number;
+    adoptedTags: string[];
+}
+/**
+ * Read the migration journal and determine which migrations are pending
+ * (not yet applied to the database).
+ */
+export declare function readPendingMigrations(config: MigrationConfig): Promise<PendingMigration[]>;
 /**
  * Apply pending migrations from the migrations folder.
+ *
+ * Each migration runs inside a transaction. On failure, the error includes
+ * the migration tag, statement index, and a SQL preview for diagnostics.
+ */
+export declare function applyMigrations(config: MigrationConfig): Promise<MigrationApplyResult>;
+/**
+ * Reconcile migration history by marking journal migrations as applied
+ * without executing schema changes. Intended for adoption/recovery when
+ * the live database already matches the current Plumbus schema.
  */
-export declare function applyMigrations(config: MigrationConfig): Promise<void>;
+export declare function reconcileMigrationHistory(config: MigrationConfig): Promise<MigrationReconcileResult>;
 /**
  * Collect all Drizzle table schemas from entity definitions,
  * plus framework-internal tables (e.g. audit_records).

package/dist/data/migration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/data/migration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAMlE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,kBAAkB,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAI5E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAmBzC;AAID,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC;IAC5E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,aAAa,GAAG,eAAe,CAAC;CACzC,CAAC,CA2BD"}
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/data/migration.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAKlE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,kBAAkB,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAYD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AA4DD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAShG;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA+B5F;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,wBAAwB,CAAC,CA+BnC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAmBzC;AAID,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC;IAC5E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,aAAa,GAAG,eAAe,CAAC;CACzC,CAAC,CA2BD"}

package/dist/data/migration.js

@@ -1,16 +1,126 @@
-import { migrate } from 'drizzle-orm/postgres-js/migrator';
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { sql } from 'drizzle-orm';
 import { documentChunksTable, documentsTable } from '../ai/rag/schema.js';
 import { auditRecords } from '../audit/schema.js';
 import { deadLetterTable, idempotencyTable, outboxTable } from '../events/outbox.js';
 import { flowDeadLetterTable, flowExecutionsTable, flowSchedulesTable } from '../flows/schema.js';
 import { generateDrizzleSchema } from './schema-generator.js';
+function readMigrationJournalEntries(migrationsFolder) {
+    const journalPath = path.join(migrationsFolder, 'meta', '_journal.json');
+    if (!fs.existsSync(journalPath)) {
+        throw new Error(`Can't find meta/_journal.json in ${migrationsFolder}`);
+    }
+    const journal = JSON.parse(fs.readFileSync(journalPath, 'utf-8'));
+    return journal.entries;
+}
+function readJournalMigrations(migrationsFolder) {
+    const journalEntries = readMigrationJournalEntries(migrationsFolder);
+    return journalEntries.map((entry) => {
+        const sqlPath = path.join(migrationsFolder, `${entry.tag}.sql`);
+        if (!fs.existsSync(sqlPath)) {
+            throw new Error(`Missing migration file: ${sqlPath}`);
+        }
+        const rawSql = fs.readFileSync(sqlPath, 'utf-8');
+        const hash = crypto.createHash('sha256').update(rawSql).digest('hex');
+        const statements = entry.breakpoints
+            ? rawSql
+                .split('--> statement-breakpoint')
+                .map((statement) => statement.trim())
+                .filter(Boolean)
+            : [rawSql];
+        return {
+            tag: entry.tag,
+            hash,
+            statements,
+            rawSql,
+            folderMillis: entry.when,
+        };
+    });
+}
+async function ensureMigrationsTable(db) {
+    await db.execute(sql `CREATE TABLE IF NOT EXISTS "__drizzle_migrations" (
+      id SERIAL PRIMARY KEY,
+      hash TEXT NOT NULL,
+      created_at BIGINT
+    )`);
+}
+async function getAppliedMigrationHashes(db) {
+    const appliedRows = (await db.execute(sql `SELECT hash FROM "__drizzle_migrations"`));
+    return new Set(appliedRows.map((row) => row.hash));
+}
+/**
+ * Read the migration journal and determine which migrations are pending
+ * (not yet applied to the database).
+ */
+export async function readPendingMigrations(config) {
+    const { db, migrationsFolder } = config;
+    await ensureMigrationsTable(db);
+    const appliedHashes = await getAppliedMigrationHashes(db);
+    const journalMigrations = readJournalMigrations(migrationsFolder);
+    return journalMigrations.filter((migration) => !appliedHashes.has(migration.hash));
+}
 /**
  * Apply pending migrations from the migrations folder.
+ *
+ * Each migration runs inside a transaction. On failure, the error includes
+ * the migration tag, statement index, and a SQL preview for diagnostics.
  */
 export async function applyMigrations(config) {
-    await migrate(config.db, {
-        migrationsFolder: config.migrationsFolder,
+    const pending = await readPendingMigrations(config);
+    if (pending.length === 0) {
+        return { applied: 0, tags: [] };
+    }
+    const appliedTags = [];
+    for (const migration of pending) {
+        await config.db.transaction(async (tx) => {
+            for (let i = 0; i < migration.statements.length; i++) {
+                const stmt = migration.statements[i] ?? '';
+                try {
+                    await tx.execute(sql.raw(stmt));
+                }
+                catch (stmtErr) {
+                    const preview = stmt.length > 200 ? `${stmt.slice(0, 200)}...` : stmt;
+                    throw new Error(`Migration "${migration.tag}" failed at statement ${i + 1}/${migration.statements.length}:\n` +
+                        `  SQL: ${preview}\n` +
+                        `  Error: ${stmtErr instanceof Error ? stmtErr.message : String(stmtErr)}`);
+                }
+            }
+            await tx.execute(sql `INSERT INTO "__drizzle_migrations" (hash, created_at) VALUES (${migration.hash}, ${migration.folderMillis})`);
+        });
+        appliedTags.push(migration.tag);
+    }
+    return { applied: appliedTags.length, tags: appliedTags };
+}
+/**
+ * Reconcile migration history by marking journal migrations as applied
+ * without executing schema changes. Intended for adoption/recovery when
+ * the live database already matches the current Plumbus schema.
+ */
+export async function reconcileMigrationHistory(config) {
+    const journalMigrations = readJournalMigrations(config.migrationsFolder);
+    await ensureMigrationsTable(config.db);
+    const appliedHashes = await getAppliedMigrationHashes(config.db);
+    const missingMigrations = journalMigrations.filter((migration) => !appliedHashes.has(migration.hash));
+    if (missingMigrations.length === 0) {
+        return {
+            adopted: 0,
+            alreadyApplied: journalMigrations.length,
+            adoptedTags: [],
+        };
+    }
+    await config.db.transaction(async (tx) => {
+        for (const migration of missingMigrations) {
+            await tx.execute(sql `INSERT INTO "__drizzle_migrations" (hash, created_at)
+            VALUES (${migration.hash}, ${migration.folderMillis})`);
+        }
     });
+    return {
+        adopted: missingMigrations.length,
+        alreadyApplied: journalMigrations.length - missingMigrations.length,
+        adoptedTags: missingMigrations.map((migration) => migration.tag),
+    };
 }
 /**
  * Collect all Drizzle table schemas from entity definitions,

package/dist/data/migration.js.map

@@ -1 +1 @@
-{"version":3,"file":"migration.js","sourceRoot":"","sources":["../../src/data/migration.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAElG,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAO9D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAuB;IAC3D,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE;QACvB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;KAC1C,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,QAA4B;IAE5B,MAAM,OAAO,GAA4C,EAAE,CAAC;IAC5D,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IACD,4BAA4B;IAC5B,OAAO,CAAC,eAAe,GAAG,YAAkD,CAAC;IAC7E,sBAAsB;IACtB,OAAO,CAAC,cAAc,GAAG,WAAiD,CAAC;IAC3E,OAAO,CAAC,mBAAmB,GAAG,gBAAsD,CAAC;IACrF,OAAO,CAAC,mBAAmB,GAAG,eAAqD,CAAC;IACpF,cAAc;IACd,OAAO,CAAC,iBAAiB,GAAG,mBAAyD,CAAC;IACtF,OAAO,CAAC,kBAAkB,GAAG,mBAAyD,CAAC;IACvF,OAAO,CAAC,gBAAgB,GAAG,kBAAwD,CAAC;IACpF,aAAa;IACb,OAAO,CAAC,WAAW,GAAG,cAAoD,CAAC;IAC3E,OAAO,CAAC,iBAAiB,GAAG,mBAAyD,CAAC;IACtF,OAAO,OAAO,CAAC;AACjB,CAAC;AAWD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAuB;IAIjE,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;IAErB,sEAAsE;IACtE,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC;QAC7B,GAAG,EAAE,oFAAoF;QACzF,MAAM,EAAE,EAAE;KACJ,CAAC,CAA2D,CAAC;IAErE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACxD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,CAAC;IAEzC,sDAAsD;IACtD,MAAM,EAAE,CAAC,OAAO,CAAC;QACf,GAAG,EAAE,kDAAkD;QACvD,MAAM,EAAE,CAAC,aAAa,CAAC;KACjB,CAAC,CAAC;IAEV,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../../src/data/migration.ts"],"names":[],"mappings":"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"}

package/dist/data/repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/data/repository.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC/B,EAAE,EAAE,kBAAkB,CAAC;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mFAAmF;IACnF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7D,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7D,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAgO7D"}
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/data/repository.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC/B,EAAE,EAAE,kBAAkB,CAAC;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mFAAmF;IACnF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7D,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7D,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAyP7D"}

package/dist/data/repository.js

@@ -76,6 +76,27 @@ export function createRepository(options) {
             await auditMutation('create', record);
             return created;
         },
+        async createMany(records) {
+            if (records.length === 0)
+                return [];
+            const prepared = records.map((data) => {
+                const record = { ...data };
+                if (isTenantScoped && !bypassTenantScope) {
+                    if (!auth.tenantId) {
+                        throw new Error(`Tenant-scoped entity "${entity.name}" requires auth.tenantId`);
+                    }
+                    record.tenantId = auth.tenantId;
+                }
+                return record;
+            });
+            const rows = await db.insert(table).values(prepared).returning();
+            // One summary audit row per batch instead of N per-row audits.
+            await auditMutation('createMany', {
+                count: prepared.length,
+                sample: maskData(prepared[0] ?? {}),
+            });
+            return rows;
+        },
         async update(id, updates) {
             const conditions = [];
             const idCol = table.id;