@memberjunction/cli 5.37.0 → 5.38.0

package/dist/baseline/util.js

@@ -0,0 +1,325 @@
+/**
+ * Canonical formatting helpers used by the emitter and comparator.
+ *
+ * Determinism is the contract: identical input must produce byte-identical
+ * output, regardless of host OS, locale, or run order.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/** Lower-case schema-qualified name used for sort keys and sets. */
+export function qname(schema, name) {
+    return `${schema}.${name}`.toLowerCase();
+}
+/** Quote a T-SQL identifier with brackets, escaping any embedded `]`. */
+export function quoteIdent(name) {
+    return `[${name.replace(/]/g, ']]')}]`;
+}
+/** Quote a T-SQL string literal, escaping single quotes. */
+export function quoteString(value) {
+    return `N'${value.replace(/'/g, "''")}'`;
+}
+/** Stable sort by a key extractor; preserves input order for ties. */
+export function stableSortBy(items, key) {
+    return items
+        .map((item, index) => ({ item, index, key: key(item) }))
+        .sort((a, b) => {
+        if (a.key < b.key)
+            return -1;
+        if (a.key > b.key)
+            return 1;
+        return a.index - b.index;
+    })
+        .map((wrapped) => wrapped.item);
+}
+/** Cross-platform line endings: emit LF only. Caller normalizes if needed. */
+export const NL = '\n';
+/**
+ * Tables that must never appear in the emitted baseline — they belong to the
+ * migration tool itself and get created automatically before the baseline runs.
+ * Match by table name only (schema-independent) because Skyway can be configured
+ * to put `flyway_schema_history` in any schema (MJ uses `__mj`, default is `dbo`).
+ */
+export const EXCLUDED_TABLE_NAMES = new Set(['flyway_schema_history']);
+/** Returns true if a table (by bare name) is one we never emit in a baseline. */
+export function isExcludedTable(name) {
+    return EXCLUDED_TABLE_NAMES.has(name.toLowerCase());
+}
+/** Canonical ISO-8601 UTC stamp without milliseconds: 2026-05-02T19:47:00Z. */
+export function isoUtcSeconds(date) {
+    return date.toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+/** Filename timestamp: YYYYMMDDHHMM in UTC. */
+export function fileStamp(date) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return (date.getUTCFullYear().toString() +
+        pad(date.getUTCMonth() + 1) +
+        pad(date.getUTCDate()) +
+        pad(date.getUTCHours()) +
+        pad(date.getUTCMinutes()));
+}
+/** Build the canonical filename for a baseline migration. */
+export function baselineFilename(opts) {
+    return `B${fileStamp(opts.generatedAtUtc)}__v${opts.baselineVersion}.x__Baseline.sql`;
+}
+/** Inverse of {@link fileStamp}: parses a YYYYMMDDHHMM string into a UTC Date. */
+export function parseFileStamp(stamp) {
+    if (!/^\d{12}$/.test(stamp)) {
+        throw new Error(`Invalid YYYYMMDDHHMM stamp: ${stamp}`);
+    }
+    const y = Number(stamp.slice(0, 4));
+    const mo = Number(stamp.slice(4, 6)) - 1;
+    const d = Number(stamp.slice(6, 8));
+    const h = Number(stamp.slice(8, 10));
+    const mi = Number(stamp.slice(10, 12));
+    return new Date(Date.UTC(y, mo, d, h, mi));
+}
+/** Return a new Date offset by N minutes (negative for past). */
+export function addMinutes(date, minutes) {
+    return new Date(date.getTime() + minutes * 60_000);
+}
+export function parseMigrationFilename(filename) {
+    const match = /^([VB])(\d{12})__v(\d+)\.(\d+)/.exec(filename);
+    if (!match)
+        return null;
+    return {
+        kind: match[1],
+        timestamp: match[2],
+        major: Number(match[3]),
+        minor: Number(match[4]),
+        majorMinor: `${match[3]}.${match[4]}`,
+        filename,
+    };
+}
+/**
+ * Scan a migrations source directory and return the latest V-file by timestamp.
+ * Files that don't match the expected shape are silently ignored.
+ *
+ * Used by within-major rebaseline to derive the new baseline's version + timestamp
+ * from the head of the existing V-stack.
+ */
+export function findLatestVersionedMigration(sourceDir) {
+    if (!fs.existsSync(sourceDir) || !fs.statSync(sourceDir).isDirectory()) {
+        return null;
+    }
+    const entries = fs.readdirSync(sourceDir);
+    let best = null;
+    for (const name of entries) {
+        if (!name.toLowerCase().endsWith('.sql'))
+            continue;
+        const parsed = parseMigrationFilename(name);
+        if (!parsed || parsed.kind !== 'V')
+            continue;
+        if (!best || parsed.timestamp > best.timestamp)
+            best = parsed;
+    }
+    return best;
+}
+/** Same as {@link findLatestVersionedMigration} but for `B`-prefixed baseline files. */
+export function findLatestBaselineMigration(sourceDir) {
+    if (!fs.existsSync(sourceDir) || !fs.statSync(sourceDir).isDirectory()) {
+        return null;
+    }
+    const entries = fs.readdirSync(sourceDir);
+    let best = null;
+    for (const name of entries) {
+        if (!name.toLowerCase().endsWith('.sql'))
+            continue;
+        const parsed = parseMigrationFilename(name);
+        if (!parsed || parsed.kind !== 'B')
+            continue;
+        if (!best || parsed.timestamp > best.timestamp)
+            best = parsed;
+    }
+    return best;
+}
+/**
+ * Walk up from `cwd` looking for a `migrations/` directory, then return the path
+ * to the highest-numbered `vN/` subdirectory inside it. Returns null if nothing
+ * suitable is found.
+ *
+ * Stops walking at the filesystem root. Used so the CLI can auto-locate the
+ * source dir for within-major rebaseline without forcing the caller to pass `--source-dir`.
+ */
+export function discoverMigrationsSourceDir(cwd) {
+    let dir = path.resolve(cwd);
+    for (let i = 0; i < 16; i++) {
+        const candidate = path.join(dir, 'migrations');
+        if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+            const versioned = fs
+                .readdirSync(candidate)
+                .filter((name) => /^v\d+$/i.test(name))
+                .map((name) => ({ name, n: Number(name.slice(1)) }))
+                .sort((a, b) => b.n - a.n);
+            if (versioned.length > 0) {
+                return path.join(candidate, versioned[0].name);
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/**
+ * Compute the canonical generated-at timestamp for a within-major rebaseline.
+ * The new baseline's filename timestamp is exactly 1 minute after the latest
+ * V-file's timestamp — guaranteeing the new B-file sorts after the V-stack it
+ * succeeds, while remaining deterministic across re-runs against the same input.
+ */
+export function computeAutoBaselineStamp(latestVTimestamp) {
+    const parsed = parseFileStamp(latestVTimestamp);
+    const next = addMinutes(parsed, 1);
+    return { generatedAtUtc: next, fileStamp: fileStamp(next) };
+}
+/**
+ * Format a JS value as a T-SQL literal. Used by the data dumper.
+ * Returns `NULL` for null/undefined, otherwise a typed literal.
+ */
+export function formatTsqlValue(value) {
+    if (value === null || value === undefined)
+        return 'NULL';
+    if (typeof value === 'boolean')
+        return value ? '1' : '0';
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            throw new Error(`Cannot serialize non-finite number: ${value}`);
+        }
+        return String(value);
+    }
+    if (typeof value === 'bigint')
+        return value.toString();
+    if (value instanceof Date) {
+        // datetime2 with full precision
+        const iso = value.toISOString(); // 2026-05-02T19:47:23.123Z
+        const stripped = iso.replace('T', ' ').replace('Z', '');
+        return `N'${stripped}'`;
+    }
+    if (Buffer.isBuffer(value)) {
+        return '0x' + value.toString('hex').toUpperCase();
+    }
+    if (value instanceof Uint8Array) {
+        return '0x' + Buffer.from(value).toString('hex').toUpperCase();
+    }
+    if (typeof value === 'string')
+        return quoteString(value);
+    if (typeof value === 'object') {
+        // Fallback: JSON-serialize objects (rare; mssql driver returns primitives)
+        return quoteString(JSON.stringify(value));
+    }
+    throw new Error(`Unsupported value type for T-SQL literal: ${typeof value}`);
+}
+/** Strict equality used by the comparator for column values. */
+export function deepValueEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || a === undefined)
+        return b === null || b === undefined;
+    if (b === null || b === undefined)
+        return false;
+    if (a instanceof Date && b instanceof Date)
+        return a.getTime() === b.getTime();
+    // Byte-wise compare for Buffer / Uint8Array. We avoid Buffer.equals / Buffer.compare
+    // because @types/node 20.x parameterizes them with `Uint8Array<ArrayBuffer>`, which
+    // is narrower than the `Uint8Array<ArrayBufferLike>` actually held by Buffer instances.
+    if (a instanceof Uint8Array && b instanceof Uint8Array) {
+        if (a.byteLength !== b.byteLength)
+            return false;
+        for (let i = 0; i < a.byteLength; i++) {
+            if (a[i] !== b[i])
+                return false;
+        }
+        return true;
+    }
+    if (typeof a === 'number' && typeof b === 'number') {
+        return a === b || (Number.isNaN(a) && Number.isNaN(b));
+    }
+    // Fall back to JSON for plain objects (driver-native types should already
+    // have been normalized to Date/Buffer above).
+    if (typeof a === 'object' && typeof b === 'object') {
+        return JSON.stringify(a) === JSON.stringify(b);
+    }
+    return false;
+}
+/** Truncate a string with an ellipsis for diff output. */
+export function ellipsize(value, max = 80) {
+    return value.length <= max ? value : value.slice(0, max - 1) + '…';
+}
+/**
+ * Topologically sort a list of SQL routines (views/functions/procs/triggers)
+ * by inferred dependencies. A routine A depends on B if A's `definition` text
+ * mentions B's name (case-insensitive, schema-qualified or bare with word
+ * boundaries). Stable for equal items; sorts cycles by qname so the result is
+ * still deterministic.
+ *
+ * Reference extraction is heuristic — comments and string literals are not
+ * stripped — but false positives only add edges that don't hurt correctness.
+ * MSSQL `CREATE VIEW`/`CREATE FUNCTION` reject forward references at create
+ * time, so without this sort we hit `Invalid object name` errors on apply.
+ */
+export function topoSortRoutinesByDefinition(items) {
+    if (items.length <= 1)
+        return items.slice();
+    const byKey = new Map();
+    for (const r of items)
+        byKey.set(qname(r.schema, r.name), r);
+    // Precompute lowercased bodies, with bracket-quoted identifiers normalized
+    // so that `[__mj].[vwEntities]` matches the qname `__mj.vwentities`. Without
+    // this we miss bracket-style references — which is the form MSSQL routines
+    // use almost universally.
+    const bodyLower = new Map();
+    for (const [key, r] of byKey) {
+        bodyLower.set(key, r.definition.toLowerCase().replace(/[[\]]/g, ''));
+    }
+    // Build deps: routine -> set of other routines it references.
+    const deps = new Map();
+    const allKeys = [...byKey.keys()].sort();
+    for (const key of allKeys)
+        deps.set(key, new Set());
+    for (const key of allKeys) {
+        const body = bodyLower.get(key);
+        for (const otherKey of allKeys) {
+            if (otherKey === key)
+                continue;
+            const bare = otherKey.includes('.') ? otherKey.slice(otherKey.lastIndexOf('.') + 1) : otherKey;
+            if (body.includes(otherKey) || matchBareWord(body, bare)) {
+                deps.get(key).add(otherKey);
+            }
+        }
+    }
+    // Kahn's algorithm with deterministic tie-breaking.
+    const result = [];
+    const remaining = new Map();
+    for (const [k, v] of deps)
+        remaining.set(k, new Set(v));
+    while (remaining.size > 0) {
+        const ready = [...remaining.entries()]
+            .filter(([, refs]) => refs.size === 0)
+            .map(([k]) => k)
+            .sort();
+        if (ready.length === 0) {
+            // Cycle — emit remaining in qname order so output stays deterministic.
+            for (const k of [...remaining.keys()].sort())
+                result.push(byKey.get(k));
+            break;
+        }
+        for (const k of ready) {
+            result.push(byKey.get(k));
+            remaining.delete(k);
+            for (const refs of remaining.values())
+                refs.delete(k);
+        }
+    }
+    return result;
+}
+/** Word-boundary substring search (lowercased input only). */
+function matchBareWord(haystack, needle) {
+    if (!needle)
+        return false;
+    const re = new RegExp(`(?<![\\w.])${escapeRegExp(needle)}(?!\\w)`);
+    return re.test(haystack);
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=util.js.map

package/dist/baseline/util.js.map

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

package/dist/commands/baseline/build.d.ts

@@ -0,0 +1,29 @@
+import { Command } from '@oclif/core';
+export default class BaselineBuild extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'baseline-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'source-dir': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        description: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        database: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        out: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'exclude-data': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'batch-size': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'no-data': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    /**
+     * Decide the baseline version + filename timestamp.
+     *
+     * - **Explicit mode**: caller passes `--baseline-version 6.0`. Timestamp = now (UTC).
+     * - **Auto / within-major mode**: caller omits `--baseline-version`. Scan
+     *   `--source-dir` (or auto-discover one) for the latest V-file; new baseline
+     *   inherits its `Major.Minor` and uses `latestVTimestamp + 1 minute` so the
+     *   B-file always sorts after the V-stack it succeeds.
+     */
+    private resolveVersionAndStamp;
+}
+//# sourceMappingURL=build.d.ts.map

package/dist/commands/baseline/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/commands/baseline/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAkB7C,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,OAAO;IAChD,MAAM,CAAC,WAAW,SAAmG;IAErH,MAAM,CAAC,QAAQ,WAKb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;;MA2CV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA2G1B;;;;;;;;OAQG;IACH,OAAO,CAAC,sBAAsB;CAmC/B"}

package/dist/commands/baseline/build.js

@@ -0,0 +1,188 @@
+import { Command, Flags } from '@oclif/core';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import ora from 'ora-classic';
+import chalk from 'chalk';
+import { resolveConnection, isTty } from '../../baseline/cli-helpers.js';
+import { openConnection } from '../../baseline/connection.js';
+import { introspectMssql } from '../../baseline/introspector-mssql.js';
+import { dumpTables } from '../../baseline/data-dumper.js';
+import { emitBaselineTsql } from '../../baseline/emitter.js';
+import { baselineFilename, computeAutoBaselineStamp, discoverMigrationsSourceDir, findLatestVersionedMigration, } from '../../baseline/util.js';
+export default class BaselineBuild extends Command {
+    static { this.description = 'Generate a deterministic baseline SQL script from the END-STATE of a migrated MSSQL database.'; }
+    static { this.examples = [
+        '<%= config.bin %> <%= command.id %> --out ./migrations/v5/                          # auto: within-major rebaseline',
+        '<%= config.bin %> <%= command.id %> --source-dir ./migrations/v5 --out ./migrations/v5/',
+        '<%= config.bin %> <%= command.id %> --baseline-version 6.0 --out ./migrations/v6/  # explicit major-boundary',
+        '<%= config.bin %> <%= command.id %> --baseline-version 5.32 --database MJ_BL_Stack --out /tmp/baseline/',
+    ]; }
+    static { this.flags = {
+        'baseline-version': Flags.string({
+            description: 'Baseline version stamp in Major.Minor format (literal x is appended for patch, matching the V-file convention). ' +
+                'Omit to auto-detect from --source-dir (within-major rebaseline mode).',
+        }),
+        'source-dir': Flags.string({
+            description: 'Migrations source directory (e.g. ./migrations/v5). Used to auto-detect the next baseline ' +
+                'version + timestamp when --baseline-version is omitted. Defaults to the highest migrations/v*/ ' +
+                'directory walked up from cwd.',
+        }),
+        'description': Flags.string({
+            description: 'Human-readable description embedded in the file header.',
+            default: 'MemberJunction Baseline',
+        }),
+        'database': Flags.string({
+            description: 'Override database name (host/user/password come from MJ config).',
+        }),
+        'out': Flags.string({
+            description: 'Output directory. Filename is auto-generated.',
+            default: '.',
+        }),
+        'exclude-data': Flags.string({
+            description: 'Comma-separated list of tables (schema-qualified or not) to skip data dump for.',
+            default: '',
+        }),
+        'batch-size': Flags.integer({
+            description: 'Rows per INSERT batch.',
+            default: 1000,
+        }),
+        'no-data': Flags.boolean({
+            description: 'Emit schema only, no data inserts.',
+            default: false,
+        }),
+        'verbose': Flags.boolean({
+            description: 'Print per-object progress.',
+            default: false,
+        }),
+        'dry-run': Flags.boolean({
+            description: 'Print to stdout instead of writing a file.',
+            default: false,
+        }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(BaselineBuild);
+        const { baselineVersion, generatedAtUtc, autoSource } = this.resolveVersionAndStamp(flags);
+        const connectionParams = resolveConnection({ database: flags.database }, 'mssql');
+        const excludedDataTables = new Set(flags['exclude-data']
+            .split(',')
+            .map((s) => s.trim().toLowerCase())
+            .filter(Boolean)
+            .map((s) => (s.includes('.') ? s : `dbo.${s}`)));
+        excludedDataTables.add('flyway_schema_history');
+        excludedDataTables.add('dbo.flyway_schema_history');
+        const useSpinner = isTty();
+        const spinner = useSpinner ? ora() : null;
+        const phase = (text) => {
+            if (spinner) {
+                spinner.text = text;
+                if (!spinner.isSpinning)
+                    spinner.start();
+            }
+            else {
+                this.log(`• ${text}`);
+            }
+        };
+        const succeed = (text) => spinner ? spinner.succeed(text) : this.log(`✓ ${text}`);
+        const fail = (text) => spinner ? spinner.fail(text) : this.logToStderr(`✗ ${text}`);
+        const startedAt = Date.now();
+        if (autoSource) {
+            this.log(chalk.dim(`  Auto-detected baseline: v${baselineVersion}.x (from ${autoSource.filename})`));
+            this.log(chalk.dim(`  Auto timestamp        : ${autoSource.timestamp} + 1m`));
+        }
+        phase(`Connecting to ${connectionParams.database}@${connectionParams.host}`);
+        const db = await openConnection(connectionParams);
+        try {
+            succeed(`Connected to ${connectionParams.database}`);
+            phase(`Introspecting schema`);
+            const snapshot = await introspectMssql(db, {
+                onPhase: (p) => { if (flags.verbose)
+                    this.log(`  - ${p}`); },
+            });
+            succeed(`Introspected ${snapshot.tables.length} tables, ` +
+                `${snapshot.views.length} views, ` +
+                `${snapshot.procedures.length} procs, ` +
+                `${snapshot.functions.length} functions`);
+            const dumps = flags['no-data'] ? [] : await (async () => {
+                phase(`Dumping table data (every row, every column)`);
+                const result = await dumpTables(db, snapshot.tables, { excludedTables: excludedDataTables }, {
+                    onTable: (table, count) => {
+                        if (flags.verbose)
+                            this.log(`    ${table.schema}.${table.name}: ${count} rows`);
+                        else if (spinner)
+                            spinner.text = `Dumping ${table.schema}.${table.name} (${count} rows)`;
+                    },
+                });
+                const totalRows = result.reduce((sum, d) => sum + d.rowCount, 0);
+                succeed(`Dumped ${totalRows.toLocaleString()} rows across ${result.length} tables`);
+                return result;
+            })();
+            phase('Emitting baseline SQL');
+            const sql = emitBaselineTsql({
+                snapshot,
+                dataDumps: dumps,
+                options: {
+                    baselineVersion,
+                    description: flags.description,
+                    generatedAtUtc,
+                    includeData: !flags['no-data'],
+                    excludedDataTables,
+                    batchSize: flags['batch-size'],
+                },
+            });
+            succeed(`Emitted ${sql.length.toLocaleString()} bytes of T-SQL`);
+            if (flags['dry-run']) {
+                process.stdout.write(sql);
+                return;
+            }
+            const filename = baselineFilename({ generatedAtUtc, baselineVersion });
+            fs.mkdirSync(flags.out, { recursive: true });
+            const fullPath = path.resolve(flags.out, filename);
+            fs.writeFileSync(fullPath, sql, 'utf8');
+            const elapsed = ((Date.now() - startedAt) / 1000).toFixed(1);
+            this.log('');
+            this.log(chalk.green(`✓ Baseline written: ${fullPath}`));
+            this.log(chalk.dim(`  Generated in ${elapsed}s`));
+        }
+        catch (err) {
+            fail(`Build failed: ${err.message}`);
+            throw err;
+        }
+        finally {
+            await db.close();
+        }
+    }
+    /**
+     * Decide the baseline version + filename timestamp.
+     *
+     * - **Explicit mode**: caller passes `--baseline-version 6.0`. Timestamp = now (UTC).
+     * - **Auto / within-major mode**: caller omits `--baseline-version`. Scan
+     *   `--source-dir` (or auto-discover one) for the latest V-file; new baseline
+     *   inherits its `Major.Minor` and uses `latestVTimestamp + 1 minute` so the
+     *   B-file always sorts after the V-stack it succeeds.
+     */
+    resolveVersionAndStamp(flags) {
+        const explicit = flags['baseline-version'];
+        if (explicit) {
+            if (!/^\d+\.\d+$/.test(explicit)) {
+                this.error(`--baseline-version must be Major.Minor (got "${explicit}")`);
+            }
+            return { baselineVersion: explicit, generatedAtUtc: new Date(), autoSource: null };
+        }
+        const sourceDir = flags['source-dir'] ?? discoverMigrationsSourceDir(process.cwd());
+        if (!sourceDir) {
+            this.error('No --baseline-version provided and could not auto-discover a migrations directory. ' +
+                'Pass --source-dir or --baseline-version.');
+        }
+        const latest = findLatestVersionedMigration(sourceDir);
+        if (!latest) {
+            this.error(`No V-files found in ${sourceDir}. Pass --baseline-version explicitly or point --source-dir at a folder with V<ts>__v<Major>.<Minor>...sql migrations.`);
+        }
+        const { generatedAtUtc } = computeAutoBaselineStamp(latest.timestamp);
+        return {
+            baselineVersion: latest.majorMinor,
+            generatedAtUtc,
+            autoSource: { filename: latest.filename, timestamp: latest.timestamp },
+        };
+    }
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/baseline/build.js.map

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

package/dist/commands/baseline/compare.d.ts

@@ -0,0 +1,19 @@
+import { Command } from '@oclif/core';
+export default class BaselineCompare extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        left: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        right: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        dialect: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'row-compare': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'row-hash-algo': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        ignore: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'sample-limit': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        out: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'fail-on-diff': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=compare.d.ts.map

package/dist/commands/baseline/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../../src/commands/baseline/compare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAe7C,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IAClD,MAAM,CAAC,WAAW,SAA8E;IAEhG,MAAM,CAAC,QAAQ,WAIb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;;MA6BV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoF3B"}