@plumbus/core 0.2.9 → 0.3.1

package/dist/data/__tests__/drift-inspector.test.js

@@ -0,0 +1,170 @@
+import { describe, expect, it } from 'vitest';
+import { extractCreateTableNames, FRAMEWORK_TABLE_NAMES, formatDriftReport, } from '../drift-inspector.js';
+describe('FRAMEWORK_TABLE_NAMES', () => {
+    it('contains all 9 framework table names', () => {
+        expect(FRAMEWORK_TABLE_NAMES).toHaveLength(9);
+    });
+    it('includes expected table names', () => {
+        expect(FRAMEWORK_TABLE_NAMES).toContain('audit_records');
+        expect(FRAMEWORK_TABLE_NAMES).toContain('event_outbox');
+        expect(FRAMEWORK_TABLE_NAMES).toContain('event_idempotency');
+        expect(FRAMEWORK_TABLE_NAMES).toContain('event_dead_letter');
+        expect(FRAMEWORK_TABLE_NAMES).toContain('flow_executions');
+        expect(FRAMEWORK_TABLE_NAMES).toContain('flow_dead_letter');
+        expect(FRAMEWORK_TABLE_NAMES).toContain('flow_schedules');
+        expect(FRAMEWORK_TABLE_NAMES).toContain('documents');
+        expect(FRAMEWORK_TABLE_NAMES).toContain('document_chunks');
+    });
+});
+describe('extractCreateTableNames', () => {
+    it('extracts quoted table names', () => {
+        const sql = 'CREATE TABLE "event_outbox" ("id" uuid PRIMARY KEY);';
+        expect(extractCreateTableNames(sql)).toEqual(['event_outbox']);
+    });
+    it('extracts unquoted table names', () => {
+        const sql = 'CREATE TABLE flow_executions (id uuid PRIMARY KEY);';
+        expect(extractCreateTableNames(sql)).toEqual(['flow_executions']);
+    });
+    it('extracts multiple CREATE TABLE statements', () => {
+        const sql = [
+            'CREATE TABLE "event_outbox" ("id" uuid PRIMARY KEY);',
+            '--> statement-breakpoint',
+            'CREATE TABLE "flow_executions" ("id" uuid PRIMARY KEY);',
+        ].join('\n');
+        expect(extractCreateTableNames(sql)).toEqual(['event_outbox', 'flow_executions']);
+    });
+    it('handles IF NOT EXISTS syntax', () => {
+        const sql = 'CREATE TABLE IF NOT EXISTS "audit_records" ("id" uuid PRIMARY KEY);';
+        expect(extractCreateTableNames(sql)).toEqual(['audit_records']);
+    });
+    it('returns empty for SQL without CREATE TABLE', () => {
+        const sql = 'ALTER TABLE "event_outbox" ADD COLUMN "new_col" text;';
+        expect(extractCreateTableNames(sql)).toEqual([]);
+    });
+    it('handles mixed case CREATE TABLE keywords', () => {
+        const sql = 'create table "documents" ("id" varchar PRIMARY KEY);';
+        expect(extractCreateTableNames(sql)).toEqual(['documents']);
+    });
+    it('handles extra whitespace in CREATE TABLE', () => {
+        const sql = 'CREATE   TABLE   "event_outbox"  ("id" uuid);';
+        expect(extractCreateTableNames(sql)).toEqual(['event_outbox']);
+    });
+});
+describe('formatDriftReport', () => {
+    it('lists pre-existing framework tables', () => {
+        const report = {
+            hasDrift: false,
+            existingFrameworkTables: ['event_outbox', 'flow_executions'],
+            missingFrameworkTables: [],
+            tables: [
+                { tableName: 'event_outbox', exists: true, columnDrifts: [] },
+                { tableName: 'flow_executions', exists: true, columnDrifts: [] },
+            ],
+        };
+        const lines = formatDriftReport(report);
+        expect(lines[0]).toContain('event_outbox');
+        expect(lines[0]).toContain('flow_executions');
+    });
+    it('reports missing columns', () => {
+        const report = {
+            hasDrift: true,
+            existingFrameworkTables: ['event_outbox'],
+            missingFrameworkTables: [],
+            tables: [
+                {
+                    tableName: 'event_outbox',
+                    exists: true,
+                    columnDrifts: [{ column: 'correlation_id', kind: 'missing_in_db', expected: 'text' }],
+                },
+            ],
+        };
+        const output = formatDriftReport(report).join('\n');
+        expect(output).toContain('correlation_id');
+        expect(output).toContain('missing');
+    });
+    it('reports type mismatches', () => {
+        const report = {
+            hasDrift: true,
+            existingFrameworkTables: ['event_outbox'],
+            missingFrameworkTables: [],
+            tables: [
+                {
+                    tableName: 'event_outbox',
+                    exists: true,
+                    columnDrifts: [
+                        {
+                            column: 'retry_count',
+                            kind: 'type_mismatch',
+                            expected: 'text',
+                            actual: 'integer',
+                        },
+                    ],
+                },
+            ],
+        };
+        const output = formatDriftReport(report).join('\n');
+        expect(output).toContain('retry_count');
+        expect(output).toContain('type mismatch');
+        expect(output).toContain('text');
+        expect(output).toContain('integer');
+    });
+    it('reports extra columns in DB', () => {
+        const report = {
+            hasDrift: true,
+            existingFrameworkTables: ['event_outbox'],
+            missingFrameworkTables: [],
+            tables: [
+                {
+                    tableName: 'event_outbox',
+                    exists: true,
+                    columnDrifts: [{ column: 'extra_col', kind: 'extra_in_db', actual: 'text' }],
+                },
+            ],
+        };
+        const output = formatDriftReport(report).join('\n');
+        expect(output).toContain('extra_col');
+        expect(output).toContain('exists in DB but not in schema');
+    });
+    it('includes recovery instructions', () => {
+        const report = {
+            hasDrift: true,
+            existingFrameworkTables: ['event_outbox'],
+            missingFrameworkTables: [],
+            tables: [
+                {
+                    tableName: 'event_outbox',
+                    exists: true,
+                    columnDrifts: [{ column: 'x', kind: 'missing_in_db', expected: 'text' }],
+                },
+            ],
+        };
+        const output = formatDriftReport(report).join('\n');
+        expect(output).toContain('Recovery');
+        expect(output).toContain('plumbus migrate reconcile');
+    });
+    it('reports nullability mismatch', () => {
+        const report = {
+            hasDrift: true,
+            existingFrameworkTables: ['flow_executions'],
+            missingFrameworkTables: [],
+            tables: [
+                {
+                    tableName: 'flow_executions',
+                    exists: true,
+                    columnDrifts: [
+                        {
+                            column: 'status',
+                            kind: 'nullability_mismatch',
+                            expected: 'not null',
+                            actual: 'nullable',
+                        },
+                    ],
+                },
+            ],
+        };
+        const output = formatDriftReport(report).join('\n');
+        expect(output).toContain('status');
+        expect(output).toContain('nullability');
+    });
+});
+//# sourceMappingURL=drift-inspector.test.js.map

package/dist/data/__tests__/drift-inspector.test.js.map

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

package/dist/data/__tests__/framework-migration-rewriter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=framework-migration-rewriter.test.d.ts.map

package/dist/data/__tests__/framework-migration-rewriter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-migration-rewriter.test.d.ts","sourceRoot":"","sources":["../../../src/data/__tests__/framework-migration-rewriter.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,329 @@
+import { describe, expect, it } from 'vitest';
+import { formatRewriteSummary, rewriteFrameworkDriftMigration, rewriteHadEffect, } from '../framework-migration-rewriter.js';
+function makeReport(overrides) {
+    return {
+        hasDrift: false,
+        existingFrameworkTables: [],
+        missingFrameworkTables: [],
+        tables: [],
+        ...overrides,
+    };
+}
+describe('rewriteFrameworkDriftMigration', () => {
+    it('rewrites CREATE TABLE for an existing framework table to ALTER TABLE ADD COLUMN for missing columns only', () => {
+        const stmts = [
+            `CREATE TABLE "flow_executions" (
+\t"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+\t"flow_name" text NOT NULL,
+\t"status" text DEFAULT 'created' NOT NULL,
+\t"lease_owner" text,
+\t"lease_expires_at" timestamp with time zone
+);`,
+            `CREATE INDEX "flow_exec_lease_idx" ON "flow_executions" USING btree ("status","lease_expires_at");`,
+        ];
+        const report = makeReport({
+            hasDrift: true,
+            existingFrameworkTables: ['flow_executions'],
+            tables: [
+                {
+                    tableName: 'flow_executions',
+                    exists: true,
+                    columnDrifts: [
+                        { column: 'lease_owner', kind: 'missing_in_db', expected: 'text' },
+                        {
+                            column: 'lease_expires_at',
+                            kind: 'missing_in_db',
+                            expected: 'timestamp with time zone',
+                        },
+                    ],
+                },
+            ],
+        });
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, report);
+        const joined = statements.join('\n');
+        expect(joined).not.toMatch(/CREATE\s+TABLE\s+"flow_executions"/i);
+        expect(statements).toContain(`ALTER TABLE "flow_executions" ADD COLUMN "lease_owner" text;`);
+        expect(statements).toContain(`ALTER TABLE "flow_executions" ADD COLUMN "lease_expires_at" timestamp with time zone;`);
+        expect(joined).toMatch(/CREATE INDEX IF NOT EXISTS "flow_exec_lease_idx" ON "flow_executions"/);
+        expect(summary.alteredTables).toEqual([
+            { table: 'flow_executions', addedColumns: ['lease_owner', 'lease_expires_at'] },
+        ]);
+        expect(summary.droppedCreateTables).toEqual([]);
+        expect(summary.wrappedIndexes).toEqual(['flow_exec_lease_idx']);
+        expect(summary.warnings).toEqual([]);
+        expect(rewriteHadEffect(summary)).toBe(true);
+    });
+    it('drops CREATE TABLE entirely for an existing framework table with no missing columns', () => {
+        const stmts = [
+            `CREATE TABLE "event_outbox" (
+\t"id" uuid PRIMARY KEY,
+\t"event_type" text NOT NULL
+);`,
+            `CREATE INDEX "event_outbox_status_idx" ON "event_outbox" USING btree ("status");`,
+        ];
+        const report = makeReport({
+            existingFrameworkTables: ['event_outbox'],
+            tables: [{ tableName: 'event_outbox', exists: true, columnDrifts: [] }],
+        });
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, report);
+        const joined = statements.join('\n');
+        expect(joined).not.toMatch(/CREATE\s+TABLE\s+"event_outbox"/i);
+        expect(joined).toContain('CREATE INDEX IF NOT EXISTS "event_outbox_status_idx"');
+        expect(summary.droppedCreateTables).toEqual(['event_outbox']);
+        expect(summary.alteredTables).toEqual([]);
+    });
+    it('preserves CREATE TABLE for framework tables that do NOT exist in the live DB', () => {
+        const stmts = [
+            `CREATE TABLE "documents" (
+\t"id" varchar(255) PRIMARY KEY NOT NULL,
+\t"source" varchar(1024) NOT NULL
+);`,
+        ];
+        const report = makeReport({
+            missingFrameworkTables: ['documents'],
+            tables: [{ tableName: 'documents', exists: false, columnDrifts: [] }],
+        });
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, report);
+        expect(statements.join('\n')).toMatch(/CREATE\s+TABLE\s+"documents"/i);
+        expect(summary.droppedCreateTables).toEqual([]);
+        expect(summary.alteredTables).toEqual([]);
+    });
+    it('passes user entity tables through unchanged', () => {
+        const stmts = [
+            `CREATE TABLE "project" (
+\t"id" uuid PRIMARY KEY,
+\t"name" text NOT NULL
+);`,
+        ];
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, makeReport({}));
+        expect(statements).toEqual(stmts);
+        expect(rewriteHadEffect(summary)).toBe(false);
+    });
+    it('wraps CREATE INDEX with IF NOT EXISTS', () => {
+        const stmts = [`CREATE INDEX "idx_name" ON "tbl" USING btree ("col");`];
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, makeReport({}));
+        expect(statements[0]).toContain('CREATE INDEX IF NOT EXISTS "idx_name"');
+        expect(summary.wrappedIndexes).toEqual(['idx_name']);
+    });
+    it('wraps CREATE UNIQUE INDEX with IF NOT EXISTS', () => {
+        const stmts = [`CREATE UNIQUE INDEX "ux_name" ON "tbl" ("col");`];
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, makeReport({}));
+        expect(statements[0]).toContain('CREATE UNIQUE INDEX IF NOT EXISTS "ux_name"');
+        expect(summary.wrappedIndexes).toEqual(['ux_name']);
+    });
+    it('does not double-wrap CREATE INDEX IF NOT EXISTS', () => {
+        const stmts = [`CREATE INDEX IF NOT EXISTS "idx_name" ON "tbl" ("col");`];
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, makeReport({}));
+        expect(statements).toEqual(stmts);
+        expect(summary.wrappedIndexes).toEqual([]);
+    });
+    it('warns when a framework CREATE TABLE contains table-level constraints', () => {
+        const stmts = [
+            `CREATE TABLE "flow_dead_letter" (
+\t"id" uuid PRIMARY KEY,
+\t"execution_id" text NOT NULL,
+\t"new_col" text,
+\tCONSTRAINT "flow_dead_letter_execution_id_unique" UNIQUE("execution_id")
+);`,
+        ];
+        const report = makeReport({
+            existingFrameworkTables: ['flow_dead_letter'],
+            tables: [
+                {
+                    tableName: 'flow_dead_letter',
+                    exists: true,
+                    columnDrifts: [{ column: 'new_col', kind: 'missing_in_db', expected: 'text' }],
+                },
+            ],
+        });
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, report);
+        const joined = statements.join('\n');
+        expect(joined).toContain(`ALTER TABLE "flow_dead_letter" ADD COLUMN "new_col" text`);
+        expect(joined).not.toContain('CONSTRAINT');
+        expect(summary.warnings.some((w) => w.includes('flow_dead_letter'))).toBe(true);
+    });
+    it('warns and skips when the drift report names a column that the generated CREATE TABLE does not include', () => {
+        const stmts = [
+            `CREATE TABLE "flow_executions" (
+\t"id" uuid PRIMARY KEY
+);`,
+        ];
+        const report = makeReport({
+            existingFrameworkTables: ['flow_executions'],
+            tables: [
+                {
+                    tableName: 'flow_executions',
+                    exists: true,
+                    columnDrifts: [{ column: 'lease_owner', kind: 'missing_in_db', expected: 'text' }],
+                },
+            ],
+        });
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, report);
+        expect(statements.join('\n')).not.toContain('ALTER TABLE');
+        expect(summary.warnings.some((w) => w.includes('lease_owner'))).toBe(true);
+        expect(summary.droppedCreateTables).toEqual(['flow_executions']);
+    });
+    it('handles mixed migrations: rewrite + new framework table + entity table + index wrapping in one go', () => {
+        const stmts = [
+            // Existing framework table needs columns added
+            `CREATE TABLE "flow_executions" (
+\t"id" uuid PRIMARY KEY,
+\t"lease_owner" text,
+\t"lease_expires_at" timestamp with time zone
+);`,
+            // New framework table — should be preserved
+            `CREATE TABLE "documents" (
+\t"id" varchar(255) PRIMARY KEY,
+\t"source" varchar(1024) NOT NULL
+);`,
+            // User entity table — passes through
+            `CREATE TABLE "project" (
+\t"id" uuid PRIMARY KEY,
+\t"name" text
+);`,
+            // Index — wrapped
+            `CREATE INDEX "flow_exec_lease_idx" ON "flow_executions" ("status","lease_expires_at");`,
+            // Another index — wrapped
+            `CREATE INDEX "documents_tenant_id_idx" ON "documents" ("tenant_id");`,
+        ];
+        const report = makeReport({
+            hasDrift: true,
+            existingFrameworkTables: ['flow_executions'],
+            missingFrameworkTables: ['documents'],
+            tables: [
+                {
+                    tableName: 'flow_executions',
+                    exists: true,
+                    columnDrifts: [
+                        { column: 'lease_owner', kind: 'missing_in_db', expected: 'text' },
+                        {
+                            column: 'lease_expires_at',
+                            kind: 'missing_in_db',
+                            expected: 'timestamp with time zone',
+                        },
+                    ],
+                },
+                { tableName: 'documents', exists: false, columnDrifts: [] },
+            ],
+        });
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, report);
+        const joined = statements.join('\n');
+        expect(joined).not.toMatch(/CREATE\s+TABLE\s+"flow_executions"/i);
+        expect(joined).toMatch(/CREATE\s+TABLE\s+"documents"/i);
+        expect(joined).toMatch(/CREATE\s+TABLE\s+"project"/i);
+        expect(statements).toContain('ALTER TABLE "flow_executions" ADD COLUMN "lease_owner" text;');
+        expect(statements).toContain('ALTER TABLE "flow_executions" ADD COLUMN "lease_expires_at" timestamp with time zone;');
+        expect(joined).toContain('CREATE INDEX IF NOT EXISTS "flow_exec_lease_idx"');
+        expect(joined).toContain('CREATE INDEX IF NOT EXISTS "documents_tenant_id_idx"');
+        expect(summary.alteredTables).toEqual([
+            { table: 'flow_executions', addedColumns: ['lease_owner', 'lease_expires_at'] },
+        ]);
+        expect(summary.wrappedIndexes).toEqual(['flow_exec_lease_idx', 'documents_tenant_id_idx']);
+    });
+    it('emits one statement per ALTER (not a concatenated string) so the caller can join freely', () => {
+        const stmts = [
+            `CREATE TABLE "flow_executions" (
+\t"id" uuid PRIMARY KEY,
+\t"lease_owner" text,
+\t"lease_expires_at" timestamp with time zone
+);`,
+            `CREATE INDEX "flow_exec_lease_idx" ON "flow_executions" ("lease_expires_at");`,
+        ];
+        const report = makeReport({
+            existingFrameworkTables: ['flow_executions'],
+            tables: [
+                {
+                    tableName: 'flow_executions',
+                    exists: true,
+                    columnDrifts: [
+                        { column: 'lease_owner', kind: 'missing_in_db', expected: 'text' },
+                        {
+                            column: 'lease_expires_at',
+                            kind: 'missing_in_db',
+                            expected: 'timestamp with time zone',
+                        },
+                    ],
+                },
+            ],
+        });
+        const { statements } = rewriteFrameworkDriftMigration(stmts, report);
+        // 2 ALTERs + 1 CREATE INDEX = 3 array entries
+        expect(statements).toHaveLength(3);
+        for (const s of statements) {
+            expect(s).not.toContain('--> statement-breakpoint');
+        }
+    });
+    it('leaves statements untouched when there is no framework drift and no indexes to wrap', () => {
+        const stmts = [
+            `CREATE TABLE "project" (
+\t"id" uuid PRIMARY KEY,
+\t"name" text
+);`,
+        ];
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, makeReport({}));
+        expect(statements).toEqual(stmts);
+        expect(rewriteHadEffect(summary)).toBe(false);
+    });
+    it('skips empty/whitespace-only input statements', () => {
+        const stmts = ['', '   \n  ', `CREATE TABLE "project" ("id" uuid PRIMARY KEY);`];
+        const { statements } = rewriteFrameworkDriftMigration(stmts, makeReport({}));
+        expect(statements).toEqual([`CREATE TABLE "project" ("id" uuid PRIMARY KEY);`]);
+    });
+});
+describe('ADD COLUMN idempotency', () => {
+    it('rewrites ALTER TABLE … ADD COLUMN to ADD COLUMN IF NOT EXISTS', () => {
+        const stmts = [`ALTER TABLE "timeline_event" ADD COLUMN "evidence" jsonb;`];
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, makeReport({}));
+        expect(statements[0]).toBe(`ALTER TABLE "timeline_event" ADD COLUMN IF NOT EXISTS "evidence" jsonb;`);
+        expect(summary.idempotentAddColumns).toEqual(['"timeline_event"."evidence"']);
+    });
+    it('does not double-wrap ADD COLUMN IF NOT EXISTS', () => {
+        const stmts = [`ALTER TABLE "x" ADD COLUMN IF NOT EXISTS "y" text;`];
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, makeReport({}));
+        expect(statements).toEqual(stmts);
+        expect(summary.idempotentAddColumns).toEqual([]);
+    });
+    it('handles multiple ADD COLUMN clauses in a single ALTER TABLE statement', () => {
+        const stmts = [`ALTER TABLE "x" ADD COLUMN "a" text, ADD COLUMN "b" int;`];
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, makeReport({}));
+        expect(statements[0]).toBe(`ALTER TABLE "x" ADD COLUMN IF NOT EXISTS "a" text, ADD COLUMN IF NOT EXISTS "b" int;`);
+        expect(summary.idempotentAddColumns).toEqual(['"x"."a","b"']);
+    });
+    it('does not rewrite ALTER TABLE … ADD CONSTRAINT or ALTER COLUMN', () => {
+        const stmts = [
+            `ALTER TABLE "x" ADD CONSTRAINT "c" UNIQUE ("a");`,
+            `ALTER TABLE "x" ALTER COLUMN "a" SET NOT NULL;`,
+            `ALTER TABLE "x" DROP COLUMN "b";`,
+        ];
+        const { statements, summary } = rewriteFrameworkDriftMigration(stmts, makeReport({}));
+        expect(statements).toEqual(stmts);
+        expect(summary.idempotentAddColumns).toEqual([]);
+    });
+});
+describe('formatRewriteSummary', () => {
+    it('produces empty output when nothing was rewritten', () => {
+        expect(formatRewriteSummary({
+            alteredTables: [],
+            droppedCreateTables: [],
+            wrappedIndexes: [],
+            idempotentAddColumns: [],
+            warnings: [],
+        })).toEqual([]);
+    });
+    it('formats altered, dropped, wrapped, idempotent, and warning sections', () => {
+        const lines = formatRewriteSummary({
+            alteredTables: [{ table: 'flow_executions', addedColumns: ['lease_owner'] }],
+            droppedCreateTables: ['event_outbox'],
+            wrappedIndexes: ['idx_a', 'idx_b'],
+            idempotentAddColumns: ['"timeline_event"."evidence"'],
+            warnings: ['something is off'],
+        });
+        const out = lines.join('\n');
+        expect(out).toContain('flow_executions: lease_owner');
+        expect(out).toContain('event_outbox');
+        expect(out).toContain('2 CREATE INDEX');
+        expect(out).toContain('1 ALTER TABLE ADD COLUMN');
+        expect(out).toContain('something is off');
+    });
+});
+//# sourceMappingURL=framework-migration-rewriter.test.js.map

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

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

package/dist/data/__tests__/migration.test.js

@@ -1,7 +1,11 @@
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
 import { getTableName } from 'drizzle-orm';
-import { describe, expect, it } from 'vitest';
+import { afterEach, describe, expect, it, vi } from 'vitest';
 import { field } from '../../fields/index.js';
-import { collectSchemas } from '../migration.js';
+import { collectSchemas, readPendingMigrations, reconcileMigrationHistory } from '../migration.js';
 function makeEntity(name) {
     return {
         name,
@@ -16,6 +20,34 @@ function getSchema(schemas, key) {
     expect(table).toBeDefined();
     return table;
 }
+function writeMigrationFixture(baseDir, files) {
+    const metaDir = path.join(baseDir, 'meta');
+    fs.mkdirSync(metaDir, { recursive: true });
+    for (const file of files) {
+        fs.writeFileSync(path.join(baseDir, `${file.tag}.sql`), file.sql, 'utf-8');
+    }
+    fs.writeFileSync(path.join(metaDir, '_journal.json'), JSON.stringify({
+        entries: files.map((file, index) => ({
+            idx: index,
+            version: '7',
+            when: file.when,
+            tag: file.tag,
+            breakpoints: true,
+        })),
+    }, null, 2), 'utf-8');
+}
+function sha256(input) {
+    return crypto.createHash('sha256').update(input).digest('hex');
+}
+const tempDirs = [];
+afterEach(() => {
+    while (tempDirs.length > 0) {
+        const dir = tempDirs.pop();
+        if (dir) {
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+    }
+});
 describe('collectSchemas', () => {
     it('includes user-defined entity tables', () => {
         const schemas = collectSchemas([makeEntity('Order'), makeEntity('Customer')]);
@@ -49,4 +81,63 @@ describe('collectSchemas', () => {
         expect(frameworkKeys).toHaveLength(9);
     });
 });
+describe('migration history helpers', () => {
+    it('reads only unapplied migrations from the journal', async () => {
+        const migrationsDir = fs.mkdtempSync(path.join(os.tmpdir(), 'plumbus-migrations-'));
+        tempDirs.push(migrationsDir);
+        const firstSql = 'CREATE TABLE "orders" ("id" uuid PRIMARY KEY);';
+        const secondSql = [
+            'ALTER TABLE "orders" ADD COLUMN "slug" text;',
+            '--> statement-breakpoint',
+            'CREATE INDEX "orders_slug_idx" ON "orders" ("slug");',
+        ].join('\n');
+        writeMigrationFixture(migrationsDir, [
+            { tag: '0001_init', sql: firstSql, when: 1000 },
+            { tag: '0002_slug', sql: secondSql, when: 2000 },
+        ]);
+        const db = {
+            execute: vi
+                .fn()
+                .mockResolvedValueOnce([])
+                .mockResolvedValueOnce([{ hash: sha256(firstSql) }]),
+        };
+        const pending = await readPendingMigrations({
+            db: db,
+            migrationsFolder: migrationsDir,
+        });
+        expect(pending).toHaveLength(1);
+        expect(pending[0]?.tag).toBe('0002_slug');
+        expect(pending[0]?.statements).toHaveLength(2);
+    });
+    it('reconciles only missing migration records', async () => {
+        const migrationsDir = fs.mkdtempSync(path.join(os.tmpdir(), 'plumbus-migrations-'));
+        tempDirs.push(migrationsDir);
+        const firstSql = 'CREATE TABLE "orders" ("id" uuid PRIMARY KEY);';
+        const secondSql = 'ALTER TABLE "orders" ADD COLUMN "slug" text;';
+        writeMigrationFixture(migrationsDir, [
+            { tag: '0001_init', sql: firstSql, when: 1000 },
+            { tag: '0002_slug', sql: secondSql, when: 2000 },
+        ]);
+        const tx = {
+            execute: vi.fn(async () => []),
+        };
+        const db = {
+            execute: vi
+                .fn()
+                .mockResolvedValueOnce([])
+                .mockResolvedValueOnce([{ hash: sha256(firstSql) }]),
+            transaction: vi.fn(async (callback) => callback(tx)),
+        };
+        const result = await reconcileMigrationHistory({
+            db: db,
+            migrationsFolder: migrationsDir,
+        });
+        expect(result).toEqual({
+            adopted: 1,
+            alreadyApplied: 1,
+            adoptedTags: ['0002_slug'],
+        });
+        expect(tx.execute).toHaveBeenCalledTimes(1);
+    });
+});
 //# sourceMappingURL=migration.test.js.map