chkit 0.1.0-beta.10

package/dist/bin/commands/check.js

@@ -0,0 +1,131 @@
+import { mkdir } from 'node:fs/promises';
+import { summarizeDriftReasons } from '../../drift.js';
+import { emitJson } from '../json-output.js';
+import { createJournalStoreFromConfig } from '../journal-store.js';
+import { findChecksumMismatches, listMigrations, readSnapshot } from '../migration-store.js';
+import { buildDriftPayload } from './drift.js';
+export const checkCommand = {
+    name: 'check',
+    description: 'Run policy checks for CI and release gates',
+    flags: [
+        { name: '--strict', type: 'boolean', description: 'Enable all policy checks' },
+    ],
+    run: cmdCheck,
+};
+async function cmdCheck(ctx) {
+    const { flags, config, configPath, dirs, pluginRuntime } = ctx;
+    const strict = flags['--strict'] === true;
+    const jsonMode = flags['--json'] === true;
+    const { migrationsDir, metaDir } = dirs;
+    await mkdir(migrationsDir, { recursive: true });
+    if (!config.clickhouse) {
+        throw new Error('clickhouse config is required for check (journal is stored in ClickHouse)');
+    }
+    const { journalStore } = createJournalStoreFromConfig(config.clickhouse);
+    const files = await listMigrations(migrationsDir);
+    const journal = await journalStore.readJournal();
+    const appliedNames = new Set(journal.applied.map((entry) => entry.name));
+    const pending = files.filter((f) => !appliedNames.has(f));
+    const checksumMismatches = await findChecksumMismatches(migrationsDir, journal);
+    const snapshot = await readSnapshot(metaDir);
+    const drift = snapshot && config.clickhouse ? await buildDriftPayload(config, metaDir, snapshot) : null;
+    const policy = {
+        failOnPending: strict ? true : config.check?.failOnPending ?? true,
+        failOnChecksumMismatch: strict ? true : config.check?.failOnChecksumMismatch ?? true,
+        failOnDrift: strict ? true : config.check?.failOnDrift ?? true,
+    };
+    await pluginRuntime.runOnConfigLoaded({
+        command: 'check',
+        config,
+        configPath,
+        flags,
+    });
+    const pluginResults = await pluginRuntime.runOnCheck({
+        command: 'check',
+        config,
+        configPath,
+        jsonMode,
+        flags,
+    });
+    const failedChecks = [];
+    if (policy.failOnPending && pending.length > 0)
+        failedChecks.push('pending_migrations');
+    if (policy.failOnChecksumMismatch && checksumMismatches.length > 0)
+        failedChecks.push('checksum_mismatch');
+    if (policy.failOnDrift && drift?.drifted)
+        failedChecks.push('schema_drift');
+    for (const result of pluginResults) {
+        const hasErrorFinding = result.findings.some((finding) => finding.severity === 'error');
+        if (result.evaluated && !result.ok && hasErrorFinding) {
+            failedChecks.push(`plugin:${result.plugin}`);
+        }
+    }
+    const ok = failedChecks.length === 0;
+    const driftReasonSummary = drift
+        ? summarizeDriftReasons({
+            objectDrift: drift.objectDrift,
+            tableDrift: drift.tableDrift,
+        })
+        : { counts: {}, total: 0, object: 0, table: 0 };
+    const payload = {
+        strict,
+        policy,
+        ok,
+        failedChecks,
+        pendingCount: pending.length,
+        checksumMismatchCount: checksumMismatches.length,
+        drifted: drift?.drifted ?? false,
+        driftEvaluated: drift !== null,
+        driftReasonCounts: driftReasonSummary.counts,
+        driftReasonTotals: {
+            total: driftReasonSummary.total,
+            object: driftReasonSummary.object,
+            table: driftReasonSummary.table,
+        },
+        plugins: Object.fromEntries(pluginResults.map((result) => [
+            result.plugin,
+            {
+                evaluated: result.evaluated,
+                ok: result.ok,
+                findingCodes: result.findings.map((finding) => finding.code),
+                ...(result.metadata ?? {}),
+            },
+        ])),
+    };
+    if (jsonMode) {
+        emitJson('check', payload);
+        if (!ok)
+            process.exitCode = 1;
+        return;
+    }
+    console.log(`Check status: ${ok ? 'ok' : 'failed'}`);
+    console.log(`Policy: pending=${policy.failOnPending ? 'on' : 'off'}, checksum=${policy.failOnChecksumMismatch ? 'on' : 'off'}, drift=${policy.failOnDrift ? 'on' : 'off'}`);
+    console.log(`Pending migrations: ${pending.length}`);
+    console.log(`Checksum mismatches: ${checksumMismatches.length}`);
+    if (drift === null) {
+        console.log('Schema drift: not evaluated (missing snapshot or clickhouse config)');
+    }
+    else {
+        console.log(`Schema drift: ${drift.drifted ? 'yes' : 'no'}`);
+        const summary = summarizeDriftReasons({
+            objectDrift: drift.objectDrift,
+            tableDrift: drift.tableDrift,
+        });
+        console.log(`Drift reasons: total=${summary.total}, object=${summary.object}, table=${summary.table}`);
+    }
+    if (pluginResults.length > 0) {
+        console.log('Plugin checks:');
+        for (const result of pluginResults) {
+            const findingCodes = result.findings.map((finding) => finding.code);
+            console.log(`- ${result.plugin}: ${result.ok ? 'ok' : 'failed'}${findingCodes.length > 0 ? ` (${findingCodes.join(', ')})` : ''}`);
+        }
+        await pluginRuntime.runOnCheckReport(pluginResults, (line) => {
+            console.log(line);
+        });
+    }
+    if (!ok) {
+        console.log(`Failed checks: ${failedChecks.join(', ')}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/bin/commands/check.js.map

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

package/dist/bin/commands/codegen.d.ts

@@ -0,0 +1,2 @@
+export declare function cmdCodegen(args: string[]): Promise<void>;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/bin/commands/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/codegen.ts"],"names":[],"mappings":"AAEA,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB9D"}

package/dist/bin/commands/codegen.js

@@ -0,0 +1,25 @@
+import { buildPluginLikeContext, runPluginLikeCommand } from './plugin-like.js';
+export async function cmdCodegen(args) {
+    const context = await buildPluginLikeContext({
+        args,
+        command: 'codegen',
+        handleInvalidPluginOptions: true,
+    });
+    if (!context)
+        return;
+    const pluginName = 'codegen';
+    const commandName = 'codegen';
+    await runPluginLikeCommand({
+        context,
+        pluginName,
+        commandName,
+        commandArgs: context.commandArgs,
+        missingPluginMessage() {
+            return 'Codegen plugin is not configured. Add a plugin with manifest.name "codegen" to config.plugins.';
+        },
+        missingCommandMessage({ availableCommands }) {
+            return `Codegen plugin is configured but does not expose command "${commandName}". Available: ${availableCommands.length > 0 ? availableCommands.join(', ') : '(none)'}.`;
+        },
+    });
+}
+//# sourceMappingURL=codegen.js.map

package/dist/bin/commands/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../../../src/bin/commands/codegen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAE/E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAc;IAC7C,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC;QAC3C,IAAI;QACJ,OAAO,EAAE,SAAS;QAClB,0BAA0B,EAAE,IAAI;KACjC,CAAC,CAAA;IACF,IAAI,CAAC,OAAO;QAAE,OAAM;IAEpB,MAAM,UAAU,GAAG,SAAS,CAAA;IAC5B,MAAM,WAAW,GAAG,SAAS,CAAA;IAC7B,MAAM,oBAAoB,CAAC;QACzB,OAAO;QACP,UAAU;QACV,WAAW;QACX,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,oBAAoB;YAClB,OAAO,gGAAgG,CAAA;QACzG,CAAC;QACD,qBAAqB,CAAC,EAAE,iBAAiB,EAAE;YACzC,OAAO,6DAA6D,WAAW,iBAAiB,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAA;QAC3K,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/bin/commands/drift.d.ts

@@ -0,0 +1,23 @@
+import type { ChxConfig, Snapshot } from '@chkit/core';
+import { type CommandDef } from '../../plugins.js';
+import { type ObjectDriftDetail, type TableDriftDetail } from '../../drift.js';
+import { type TableScope } from '../table-scope.js';
+export interface DriftPayload {
+    scope?: TableScope;
+    snapshotFile: string;
+    expectedCount: number;
+    actualCount: number;
+    drifted: boolean;
+    missing: string[];
+    extra: string[];
+    kindMismatches: Array<{
+        expected: string;
+        actual: string;
+        object: string;
+    }>;
+    objectDrift: ObjectDriftDetail[];
+    tableDrift: TableDriftDetail[];
+}
+export declare const driftCommand: CommandDef;
+export declare function buildDriftPayload(config: ChxConfig, metaDir: string, snapshot: Snapshot, scope?: TableScope): Promise<DriftPayload>;
+//# sourceMappingURL=drift.d.ts.map

package/dist/bin/commands/drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/drift.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAmB,MAAM,aAAa,CAAA;AAEvE,OAAO,EAAc,KAAK,UAAU,EAA0B,MAAM,kBAAkB,CAAA;AAEtF,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EAA+C,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEhG,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,cAAc,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC3E,WAAW,EAAE,iBAAiB,EAAE,CAAA;IAChC,UAAU,EAAE,gBAAgB,EAAE,CAAA;CAC/B;AAED,eAAO,MAAM,YAAY,EAAE,UAK1B,CAAA;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,KAAK,CAAC,EAAE,UAAU,GACjB,OAAO,CAAC,YAAY,CAAC,CA6DvB"}

package/dist/bin/commands/drift.js

@@ -0,0 +1,179 @@
+import { join } from 'node:path';
+import { createClickHouseExecutor } from '@chkit/clickhouse';
+import { typedFlags } from '../../plugins.js';
+import { GLOBAL_FLAGS } from '../global-flags.js';
+import { compareSchemaObjects, compareTableShape, } from '../../drift.js';
+import { emitJson } from '../json-output.js';
+import { readSnapshot } from '../migration-store.js';
+import { resolveTableScope, tableKeysFromDefinitions } from '../table-scope.js';
+export const driftCommand = {
+    name: 'drift',
+    description: 'Compare snapshot state with current ClickHouse objects',
+    flags: [],
+    run: cmdDrift,
+};
+export async function buildDriftPayload(config, metaDir, snapshot, scope) {
+    const selectedTables = scope?.enabled && scope.matchCount > 0 ? new Set(scope.matchedTables) : undefined;
+    if (!config.clickhouse)
+        throw new Error('clickhouse config is required for drift checks');
+    const db = createClickHouseExecutor(config.clickhouse);
+    const actualObjects = await db.listSchemaObjects();
+    const expectedObjects = snapshot.definitions
+        .filter((def) => {
+        if (!selectedTables)
+            return true;
+        if (def.kind !== 'table')
+            return true;
+        return selectedTables.has(`${def.database}.${def.name}`);
+    })
+        .map((def) => ({
+        kind: def.kind,
+        database: def.database,
+        name: def.name,
+    }));
+    const expectedDatabases = new Set(expectedObjects.map((def) => def.database));
+    const actualInScope = actualObjects.filter((item) => expectedDatabases.has(item.database));
+    const { missing, extra, kindMismatches, objectDrift } = compareSchemaObjects(expectedObjects, actualInScope);
+    const expectedTables = snapshot.definitions.filter((def) => {
+        if (def.kind !== 'table')
+            return false;
+        if (!selectedTables)
+            return true;
+        return selectedTables.has(`${def.database}.${def.name}`);
+    });
+    const expectedTableMap = new Map(expectedTables.map((table) => [`${table.database}.${table.name}`, table]));
+    const actualTables = await db.listTableDetails([...expectedDatabases]);
+    const tableDrift = actualTables
+        .map((actual) => {
+        const expected = expectedTableMap.get(`${actual.database}.${actual.name}`);
+        if (!expected)
+            return null;
+        return compareTableShape(expected, actual);
+    })
+        .filter((item) => item !== null)
+        .sort((a, b) => a.table.localeCompare(b.table));
+    const drifted = missing.length > 0 ||
+        extra.length > 0 ||
+        kindMismatches.length > 0 ||
+        objectDrift.length > 0 ||
+        tableDrift.length > 0;
+    return {
+        scope,
+        snapshotFile: join(metaDir, 'snapshot.json'),
+        expectedCount: expectedObjects.length,
+        actualCount: actualInScope.length,
+        drifted,
+        missing,
+        extra,
+        kindMismatches,
+        objectDrift,
+        tableDrift,
+    };
+}
+async function cmdDrift(ctx) {
+    const { flags, config, dirs } = ctx;
+    const f = typedFlags(flags, GLOBAL_FLAGS);
+    const tableSelector = f['--table'];
+    const jsonMode = f['--json'] === true;
+    const { metaDir } = dirs;
+    const snapshot = await readSnapshot(metaDir);
+    if (!snapshot) {
+        throw new Error('Snapshot not found. Run `chkit generate` before drift checks.');
+    }
+    const scope = resolveTableScope(tableSelector, tableKeysFromDefinitions(snapshot.definitions));
+    if (scope.enabled && scope.matchCount === 0) {
+        const payload = {
+            scope,
+            snapshotFile: join(metaDir, 'snapshot.json'),
+            expectedCount: 0,
+            actualCount: 0,
+            drifted: false,
+            missing: [],
+            extra: [],
+            kindMismatches: [],
+            objectDrift: [],
+            tableDrift: [],
+        };
+        if (jsonMode) {
+            emitJson('drift', {
+                ...payload,
+                warning: `No tables matched selector "${scope.selector ?? ''}".`,
+            });
+            return;
+        }
+        console.log(`No tables matched selector "${scope.selector ?? ''}". Drift check is a no-op.`);
+        return;
+    }
+    const payload = await buildDriftPayload(config, metaDir, snapshot, scope);
+    if (jsonMode) {
+        emitJson('drift', payload);
+        return;
+    }
+    console.log(`Expected objects: ${payload.expectedCount}`);
+    console.log(`Actual objects:   ${payload.actualCount}`);
+    console.log(`Drifted:          ${payload.drifted ? 'yes' : 'no'}`);
+    if (payload.scope?.enabled) {
+        console.log(`Table scope:      ${payload.scope.selector ?? ''} (${payload.scope.matchCount} matched)`);
+        for (const table of payload.scope.matchedTables)
+            console.log(`- ${table}`);
+    }
+    if (payload.missing.length > 0) {
+        console.log('\nMissing objects:');
+        for (const item of payload.missing)
+            console.log(`- ${item}`);
+    }
+    if (payload.extra.length > 0) {
+        console.log('\nUnexpected objects:');
+        for (const item of payload.extra)
+            console.log(`- ${item}`);
+    }
+    if (payload.kindMismatches.length > 0) {
+        console.log('\nKind mismatches:');
+        for (const item of payload.kindMismatches) {
+            console.log(`- ${item.object}: expected=${item.expected} actual=${item.actual}`);
+        }
+    }
+    if (payload.objectDrift.length > 0) {
+        console.log('\nObject drift reasons:');
+        for (const item of payload.objectDrift) {
+            if (item.code === 'kind_mismatch') {
+                console.log(`- ${item.code} ${item.object}: expected=${item.expectedKind ?? ''} actual=${item.actualKind ?? ''}`);
+                continue;
+            }
+            console.log(`- ${item.code} ${item.object}`);
+        }
+    }
+    if (payload.tableDrift.length > 0) {
+        console.log('\nTable shape drift:');
+        for (const item of payload.tableDrift) {
+            console.log(`- ${item.table}`);
+            if (item.missingColumns.length > 0)
+                console.log(`  missingColumns=${item.missingColumns.join(',')}`);
+            if (item.extraColumns.length > 0)
+                console.log(`  extraColumns=${item.extraColumns.join(',')}`);
+            if (item.changedColumns.length > 0)
+                console.log(`  changedColumns=${item.changedColumns.join(',')}`);
+            if (item.settingDiffs.length > 0)
+                console.log(`  settingDiffs=${item.settingDiffs.join(',')}`);
+            if (item.indexDiffs.length > 0)
+                console.log(`  indexDiffs=${item.indexDiffs.join(',')}`);
+            if (item.ttlMismatch)
+                console.log('  ttlMismatch=true');
+            if (item.engineMismatch)
+                console.log('  engineMismatch=true');
+            if (item.primaryKeyMismatch)
+                console.log('  primaryKeyMismatch=true');
+            if (item.orderByMismatch)
+                console.log('  orderByMismatch=true');
+            if (item.uniqueKeyMismatch)
+                console.log('  uniqueKeyMismatch=true');
+            if (item.partitionByMismatch)
+                console.log('  partitionByMismatch=true');
+            if (item.projectionDiffs.length > 0) {
+                console.log(`  projectionDiffs=${item.projectionDiffs.join(',')}`);
+            }
+            console.log(`  reasonCodes=${item.reasonCodes.join(',')}`);
+        }
+    }
+}
+//# sourceMappingURL=drift.js.map

package/dist/bin/commands/drift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift.js","sourceRoot":"","sources":["../../../src/bin/commands/drift.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAG5D,OAAO,EAAE,UAAU,EAA2C,MAAM,kBAAkB,CAAA;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EACL,oBAAoB,EACpB,iBAAiB,GAGlB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAmB,MAAM,mBAAmB,CAAA;AAehG,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,wDAAwD;IACrE,KAAK,EAAE,EAAE;IACT,GAAG,EAAE,QAAQ;CACd,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAiB,EACjB,OAAe,EACf,QAAkB,EAClB,KAAkB;IAElB,MAAM,cAAc,GAClB,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACnF,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IACzF,MAAM,EAAE,GAAG,wBAAwB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACtD,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,iBAAiB,EAAE,CAAA;IAClD,MAAM,eAAe,GAAG,QAAQ,CAAC,WAAW;SACzC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QACd,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAA;QAChC,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,IAAI,CAAA;QACrC,OAAO,cAAc,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;IAC1D,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACb,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,IAAI,EAAE,GAAG,CAAC,IAAI;KACf,CAAC,CAAC,CAAA;IACL,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC7E,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;IAE1F,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,oBAAoB,CAC1E,eAAe,EACf,aAAa,CACd,CAAA;IAED,MAAM,cAAc,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAA0B,EAAE;QACjF,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,KAAK,CAAA;QACtC,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAA;QAChC,OAAO,cAAc,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;IACF,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAC9B,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC,CAC1E,CAAA;IACD,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,gBAAgB,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAA;IACtE,MAAM,UAAU,GAAG,YAAY;SAC5B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACd,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QAC1E,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAA;QAC1B,OAAO,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC5C,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,IAAI,EAAoC,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC;SACjE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IAEjD,MAAM,OAAO,GACX,OAAO,CAAC,MAAM,GAAG,CAAC;QAClB,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,cAAc,CAAC,MAAM,GAAG,CAAC;QACzB,WAAW,CAAC,MAAM,GAAG,CAAC;QACtB,UAAU,CAAC,MAAM,GAAG,CAAC,CAAA;IACvB,OAAO;QACL,KAAK;QACL,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC;QAC5C,aAAa,EAAE,eAAe,CAAC,MAAM;QACrC,WAAW,EAAE,aAAa,CAAC,MAAM;QACjC,OAAO;QACP,OAAO;QACP,KAAK;QACL,cAAc;QACd,WAAW;QACX,UAAU;KACX,CAAA;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAsB;IAC5C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAA;IACnC,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;IACzC,MAAM,aAAa,GAAG,CAAC,CAAC,SAAS,CAAC,CAAA;IAClC,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAA;IACrC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IACxB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAA;IAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAA;IAClF,CAAC;IACD,MAAM,KAAK,GAAG,iBAAiB,CAAC,aAAa,EAAE,wBAAwB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAA;IAC9F,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAiB;YAC5B,KAAK;YACL,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC;YAC5C,aAAa,EAAE,CAAC;YAChB,WAAW,EAAE,CAAC;YACd,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,EAAE;YACT,cAAc,EAAE,EAAE;YAClB,WAAW,EAAE,EAAE;YACf,UAAU,EAAE,EAAE;SACf,CAAA;QACD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,EAAE;gBAChB,GAAG,OAAO;gBACV,OAAO,EAAE,+BAA+B,KAAK,CAAC,QAAQ,IAAI,EAAE,IAAI;aACjE,CAAC,CAAA;YACF,OAAM;QACR,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,+BAA+B,KAAK,CAAC,QAAQ,IAAI,EAAE,4BAA4B,CAAC,CAAA;QAC5F,OAAM;IACR,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;IAEzE,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC1B,OAAM;IACR,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;IACzD,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IACvD,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IAClE,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC,UAAU,WAAW,CAAC,CAAA;QACtG,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,aAAa;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAA;IAC5E,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;QACjC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;IAC9D,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;QACpC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;IAC5D,CAAC;IACD,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;QACjC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,MAAM,cAAc,IAAI,CAAC,QAAQ,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAClF,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;QACtC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBAClC,OAAO,CAAC,GAAG,CACT,KAAK,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,cAAc,IAAI,CAAC,YAAY,IAAI,EAAE,WAAW,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,CACrG,CAAA;gBACD,SAAQ;YACV,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAC9C,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAA;QACnC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;YAC9B,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACpG,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAC9F,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACpG,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAC9F,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACxF,IAAI,IAAI,CAAC,WAAW;gBAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;YACvD,IAAI,IAAI,CAAC,cAAc;gBAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;YAC7D,IAAI,IAAI,CAAC,kBAAkB;gBAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAA;YACrE,IAAI,IAAI,CAAC,eAAe;gBAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAA;YAC/D,IAAI,IAAI,CAAC,iBAAiB;gBAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAA;YACnE,IAAI,IAAI,CAAC,mBAAmB;gBAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAA;YACvE,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACpE,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/bin/commands/generate/output.d.ts

@@ -0,0 +1,8 @@
+import type { MigrationPlan, SchemaDefinition } from '@chkit/core';
+import type { TableScope } from '../../table-scope.js';
+export declare function emitGeneratePlanOutput(plan: MigrationPlan, jsonMode: boolean, scope: TableScope): void;
+export declare function emitGenerateApplyOutput(result: {
+    migrationFile: string | null;
+    snapshotFile: string;
+}, definitions: SchemaDefinition[], plan: MigrationPlan, jsonMode: boolean, scope: TableScope): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/bin/commands/generate/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../src/bin/commands/generate/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAGlE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAoBtD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CA8BtG;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE;IAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EAC9D,WAAW,EAAE,gBAAgB,EAAE,EAC/B,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,UAAU,GAChB,IAAI,CAgCN"}

package/dist/bin/commands/generate/output.js

@@ -0,0 +1,58 @@
+import { emitJson, summarizePlan } from '../../lib.js';
+export function emitGeneratePlanOutput(plan, jsonMode, scope) {
+    const payload = {
+        scope,
+        mode: 'plan',
+        operationCount: plan.operations.length,
+        riskSummary: plan.riskSummary,
+        operations: plan.operations,
+        renameSuggestions: plan.renameSuggestions,
+    };
+    if (jsonMode) {
+        emitJson('generate', payload);
+        return;
+    }
+    console.log(`Planned operations: ${payload.operationCount}`);
+    console.log(`Risk summary: safe=${payload.riskSummary.safe}, caution=${payload.riskSummary.caution}, danger=${payload.riskSummary.danger}`);
+    for (const line of summarizePlan(payload.operations))
+        console.log(`- ${line}`);
+    if (payload.renameSuggestions.length > 0) {
+        console.log('\nRename suggestions (review and confirm manually):');
+        for (const suggestion of payload.renameSuggestions) {
+            console.log(`- ${suggestion.kind} ${suggestion.database}.${suggestion.table}: ${suggestion.from} -> ${suggestion.to} [${suggestion.confidence}]`);
+            console.log(`  ${suggestion.reason}`);
+            console.log(`  Confirm with: ${suggestion.confirmationSQL}`);
+        }
+    }
+}
+export function emitGenerateApplyOutput(result, definitions, plan, jsonMode, scope) {
+    const payload = {
+        scope,
+        migrationFile: result.migrationFile,
+        snapshotFile: result.snapshotFile,
+        definitionCount: definitions.length,
+        operationCount: plan.operations.length,
+        riskSummary: plan.riskSummary,
+    };
+    if (jsonMode) {
+        emitJson('generate', payload);
+        return;
+    }
+    if (result.migrationFile) {
+        console.log(`Generated migration: ${result.migrationFile}`);
+    }
+    else {
+        console.log('No migration generated: plan is empty.');
+    }
+    if (scope.enabled) {
+        console.log(`Table scope:        ${scope.selector ?? ''} (${scope.matchCount} matched)`);
+        for (const table of scope.matchedTables) {
+            console.log(`- ${table}`);
+        }
+    }
+    console.log(`Updated snapshot:   ${result.snapshotFile}`);
+    console.log(`Definitions:        ${definitions.length}`);
+    console.log(`Operations:         ${plan.operations.length}`);
+    console.log(`Risk summary:       safe=${plan.riskSummary.safe}, caution=${plan.riskSummary.caution}, danger=${plan.riskSummary.danger}`);
+}
+//# sourceMappingURL=output.js.map

package/dist/bin/commands/generate/output.js.map

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

package/dist/bin/commands/generate/plan-pipeline.d.ts

@@ -0,0 +1,7 @@
+import type { ColumnRenameSuggestion, MigrationPlan, SchemaDefinition } from '@chkit/core';
+import type { ColumnRenameMapping, TableRenameMapping } from './rename-mappings.js';
+export declare function applySelectedRenameSuggestions(plan: MigrationPlan, selectedSuggestions: ColumnRenameSuggestion[]): MigrationPlan;
+export declare function applyExplicitTableRenames(plan: MigrationPlan, mappings: TableRenameMapping[]): MigrationPlan;
+export declare function buildExplicitColumnRenameSuggestions(plan: MigrationPlan, mappings: ColumnRenameMapping[]): ColumnRenameSuggestion[];
+export declare function assertCliColumnMappingsResolvable(cliMappings: ColumnRenameMapping[], plan: MigrationPlan, nextDefinitions: SchemaDefinition[]): void;
+//# sourceMappingURL=plan-pipeline.d.ts.map

package/dist/bin/commands/generate/plan-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-pipeline.d.ts","sourceRoot":"","sources":["../../../../src/bin/commands/generate/plan-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EAEtB,aAAa,EAEb,gBAAgB,EACjB,MAAM,aAAa,CAAA;AAEpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAEnF,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,aAAa,EACnB,mBAAmB,EAAE,sBAAsB,EAAE,GAC5C,aAAa,CAwCf;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,kBAAkB,EAAE,GAC7B,aAAa,CA8Cf;AAED,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,sBAAsB,EAAE,CA2B1B;AAED,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,mBAAmB,EAAE,EAClC,IAAI,EAAE,aAAa,EACnB,eAAe,EAAE,gBAAgB,EAAE,GAClC,IAAI,CAsBN"}

package/dist/bin/commands/generate/plan-pipeline.js

@@ -0,0 +1,143 @@
+export function applySelectedRenameSuggestions(plan, selectedSuggestions) {
+    if (selectedSuggestions.length === 0)
+        return plan;
+    const operationKeysToRemove = new Set();
+    const renameOperations = [];
+    for (const suggestion of selectedSuggestions) {
+        operationKeysToRemove.add(suggestion.dropOperationKey);
+        operationKeysToRemove.add(suggestion.addOperationKey);
+        renameOperations.push({
+            type: 'alter_table_rename_column',
+            key: `table:${suggestion.database}.${suggestion.table}:column_rename:${suggestion.from}:${suggestion.to}`,
+            risk: 'caution',
+            sql: suggestion.confirmationSQL,
+        });
+    }
+    const operations = [
+        ...plan.operations.filter((operation) => !operationKeysToRemove.has(operation.key)),
+        ...renameOperations,
+    ].sort((a, b) => {
+        const rankOrder = rankOperation(a) - rankOperation(b);
+        if (rankOrder !== 0)
+            return rankOrder;
+        return a.key.localeCompare(b.key);
+    });
+    return {
+        operations,
+        riskSummary: summarizeRisk(operations),
+        renameSuggestions: plan.renameSuggestions.filter((suggestion) => !selectedSuggestions.some((selected) => selected.database === suggestion.database &&
+            selected.table === suggestion.table &&
+            selected.from === suggestion.from &&
+            selected.to === suggestion.to)),
+    };
+}
+export function applyExplicitTableRenames(plan, mappings) {
+    if (mappings.length === 0)
+        return plan;
+    const operationKeysToRemove = new Set();
+    const extraOperations = [];
+    const createDatabaseOps = new Set(plan.operations.filter((operation) => operation.type === 'create_database').map((operation) => operation.key));
+    for (const mapping of mappings) {
+        operationKeysToRemove.add(`table:${mapping.oldDatabase}.${mapping.oldName}`);
+        operationKeysToRemove.add(`table:${mapping.newDatabase}.${mapping.newName}`);
+        if (mapping.oldDatabase !== mapping.newDatabase) {
+            const dbKey = `database:${mapping.newDatabase}`;
+            if (!createDatabaseOps.has(dbKey)) {
+                extraOperations.push({
+                    type: 'create_database',
+                    key: dbKey,
+                    risk: 'safe',
+                    sql: `CREATE DATABASE IF NOT EXISTS ${mapping.newDatabase};`,
+                });
+                createDatabaseOps.add(dbKey);
+            }
+        }
+        extraOperations.push({
+            type: 'alter_table_rename_table',
+            key: `table:${mapping.newDatabase}.${mapping.newName}:rename_table`,
+            risk: 'caution',
+            sql: `RENAME TABLE ${mapping.oldDatabase}.${mapping.oldName} TO ${mapping.newDatabase}.${mapping.newName};`,
+        });
+    }
+    const operations = [
+        ...plan.operations.filter((operation) => !operationKeysToRemove.has(operation.key)),
+        ...extraOperations,
+    ].sort((a, b) => {
+        const rankOrder = rankOperation(a) - rankOperation(b);
+        if (rankOrder !== 0)
+            return rankOrder;
+        return a.key.localeCompare(b.key);
+    });
+    return {
+        operations,
+        riskSummary: summarizeRisk(operations),
+        renameSuggestions: plan.renameSuggestions,
+    };
+}
+export function buildExplicitColumnRenameSuggestions(plan, mappings) {
+    if (mappings.length === 0)
+        return [];
+    const operationKeys = new Set(plan.operations.map((operation) => operation.key));
+    const suggestions = [];
+    for (const mapping of mappings) {
+        const dropOperationKey = `table:${mapping.database}.${mapping.table}:column:${mapping.from}`;
+        const addOperationKey = `table:${mapping.database}.${mapping.table}:column:${mapping.to}`;
+        if (!operationKeys.has(dropOperationKey) || !operationKeys.has(addOperationKey))
+            continue;
+        suggestions.push({
+            kind: 'column',
+            database: mapping.database,
+            table: mapping.table,
+            from: mapping.from,
+            to: mapping.to,
+            confidence: 'high',
+            reason: mapping.source === 'cli'
+                ? 'Explicitly confirmed by --rename-column mapping.'
+                : 'Explicitly confirmed by schema metadata (renamedFrom).',
+            dropOperationKey,
+            addOperationKey,
+            confirmationSQL: `ALTER TABLE ${mapping.database}.${mapping.table} RENAME COLUMN \`${mapping.from}\` TO \`${mapping.to}\`;`,
+        });
+    }
+    return suggestions;
+}
+export function assertCliColumnMappingsResolvable(cliMappings, plan, nextDefinitions) {
+    for (const mapping of cliMappings) {
+        if (!tableExists(nextDefinitions, mapping.database, mapping.table)) {
+            throw new Error(`--rename-column mapping "${mapping.database}.${mapping.table}.${mapping.from}=${mapping.to}" is invalid: target table is missing from current schema.`);
+        }
+        const hasDrop = plan.operations.some((operation) => operation.type === 'alter_table_drop_column' &&
+            operation.key === `table:${mapping.database}.${mapping.table}:column:${mapping.from}`);
+        const hasAdd = plan.operations.some((operation) => operation.type === 'alter_table_add_column' &&
+            operation.key === `table:${mapping.database}.${mapping.table}:column:${mapping.to}`);
+        if (hasDrop && hasAdd)
+            continue;
+        throw new Error(`--rename-column mapping "${mapping.database}.${mapping.table}.${mapping.from}=${mapping.to}" is invalid: planner did not find both matching drop and add operations.`);
+    }
+}
+function rankOperation(op) {
+    if (op.type.startsWith('drop_'))
+        return 0;
+    if (op.type === 'create_database')
+        return 1;
+    if (op.type === 'alter_table_rename_table')
+        return 2;
+    if (op.type.startsWith('alter_'))
+        return 3;
+    if (op.type === 'create_table')
+        return 4;
+    if (op.type === 'create_view')
+        return 5;
+    return 6;
+}
+function summarizeRisk(operations) {
+    const riskSummary = { safe: 0, caution: 0, danger: 0 };
+    for (const operation of operations) {
+        riskSummary[operation.risk] = (riskSummary[operation.risk] ?? 0) + 1;
+    }
+    return riskSummary;
+}
+function tableExists(definitions, database, name) {
+    return definitions.some((definition) => definition.kind === 'table' && definition.database === database && definition.name === name);
+}
+//# sourceMappingURL=plan-pipeline.js.map