chkit 0.1.0-beta.8 → 0.1.0

package/dist/runtime/plugin-runtime/loader.js

@@ -0,0 +1,37 @@
+export function normalizePluginRegistration(entry) {
+    return {
+        plugin: entry.plugin,
+        nameHint: entry.name,
+        enabled: entry.enabled !== false,
+        options: entry.options ?? {},
+    };
+}
+function parseCliMajor(version) {
+    const major = Number(version.split('.')[0] ?? Number.NaN);
+    if (!Number.isInteger(major) || major < 0) {
+        throw new Error(`Invalid CLI version "${version}" while loading plugins.`);
+    }
+    return major;
+}
+export function validatePlugin(cliVersion, plugin, sourceLabel) {
+    const name = plugin.manifest.name;
+    if (!name || name.trim().length === 0) {
+        throw new Error(`Plugin at ${sourceLabel} has an empty manifest.name.`);
+    }
+    if (plugin.manifest.apiVersion !== 1) {
+        throw new Error(`Plugin "${name}" requires apiVersion=${String(plugin.manifest.apiVersion)} but CLI supports apiVersion=1.`);
+    }
+    const compatibility = plugin.manifest.compatibility?.cli;
+    if (!compatibility)
+        return;
+    const cliMajor = parseCliMajor(cliVersion);
+    if (compatibility.minMajor !== undefined &&
+        cliMajor < compatibility.minMajor) {
+        throw new Error(`Plugin "${name}" is incompatible with CLI ${cliVersion}. Requires cli major >= ${compatibility.minMajor}.`);
+    }
+    if (compatibility.maxMajor !== undefined &&
+        cliMajor > compatibility.maxMajor) {
+        throw new Error(`Plugin "${name}" is incompatible with CLI ${cliVersion}. Requires cli major <= ${compatibility.maxMajor}.`);
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/runtime/plugin-runtime/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/runtime/plugin-runtime/loader.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,2BAA2B,CACzC,KAA4B;IAE5B,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAmB;QACjC,QAAQ,EAAE,KAAK,CAAC,IAAI;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO,KAAK,KAAK;QAChC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;KAC7B,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAA;IACzD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,0BAA0B,CAAC,CAAA;IAC5E,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,UAAkB,EAClB,MAAiB,EACjB,WAAmB;IAEnB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAA;IACjC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,aAAa,WAAW,8BAA8B,CAAC,CAAA;IACzE,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,WAAW,IAAI,yBAAyB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,iCAAiC,CAC5G,CAAA;IACH,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAA;IACxD,IAAI,CAAC,aAAa;QAAE,OAAM;IAE1B,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,CAAA;IAC1C,IACE,aAAa,CAAC,QAAQ,KAAK,SAAS;QACpC,QAAQ,GAAG,aAAa,CAAC,QAAQ,EACjC,CAAC;QACD,MAAM,IAAI,KAAK,CACb,WAAW,IAAI,8BAA8B,UAAU,2BAA2B,aAAa,CAAC,QAAQ,GAAG,CAC5G,CAAA;IACH,CAAC;IACD,IACE,aAAa,CAAC,QAAQ,KAAK,SAAS;QACpC,QAAQ,GAAG,aAAa,CAAC,QAAQ,EACjC,CAAC;QACD,MAAM,IAAI,KAAK,CACb,WAAW,IAAI,8BAA8B,UAAU,2BAA2B,aAAa,CAAC,QAAQ,GAAG,CAC5G,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/runtime/plugin-runtime/null-executor.d.ts

@@ -0,0 +1,3 @@
+import type { ClickHouseExecutor } from '@chkit/clickhouse';
+export declare const NULL_EXECUTOR: ClickHouseExecutor;
+//# sourceMappingURL=null-executor.d.ts.map

package/dist/runtime/plugin-runtime/null-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-executor.d.ts","sourceRoot":"","sources":["../../../src/runtime/plugin-runtime/null-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAK3D,eAAO,MAAM,aAAa,EAAE,kBAcxB,CAAA"}

package/dist/runtime/plugin-runtime/null-executor.js

@@ -0,0 +1,17 @@
+const NO_CONNECTION_MESSAGE = 'No ClickHouse connection configured and no plugin provided an executor';
+export const NULL_EXECUTOR = (() => {
+    const err = () => {
+        throw new Error(NO_CONNECTION_MESSAGE);
+    };
+    return {
+        command: err,
+        query: err,
+        insert: err,
+        submit: err,
+        queryStatus: err,
+        listSchemaObjects: err,
+        listTableDetails: err,
+        close: () => Promise.resolve(),
+    };
+})();
+//# sourceMappingURL=null-executor.js.map

package/dist/runtime/plugin-runtime/null-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-executor.js","sourceRoot":"","sources":["../../../src/runtime/plugin-runtime/null-executor.ts"],"names":[],"mappings":"AAEA,MAAM,qBAAqB,GACzB,wEAAwE,CAAA;AAE1E,MAAM,CAAC,MAAM,aAAa,GAAuB,CAAC,GAAG,EAAE;IACrD,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAA;IACxC,CAAC,CAAA;IACD,OAAO;QACL,OAAO,EAAE,GAAG;QACZ,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,GAAG;QACX,WAAW,EAAE,GAAG;QAChB,iBAAiB,EAAE,GAAG;QACtB,gBAAgB,EAAE,GAAG;QACrB,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;KAC/B,CAAA;AACH,CAAC,CAAC,EAAE,CAAA"}

package/dist/runtime/safety-markers.d.ts

@@ -0,0 +1,56 @@
+import { extractExecutableStatements } from '@chkit/core';
+export { extractExecutableStatements };
+export interface DestructiveOperationMarker {
+    migration: string;
+    type: string;
+    key: string;
+    risk: string;
+    warningCode: string;
+    reason: string;
+    impact: string;
+    recommendation: string;
+    summary: string;
+}
+export type MigrationOperationMode = 'sync' | 'async';
+export interface MigrationOperationSummary {
+    type: string;
+    key: string;
+    risk: string;
+    mode: MigrationOperationMode;
+    /**
+     * SQL to run BEFORE re-attempting this operation, parsed from a
+     * `-- before-retry: <sql>` header line that follows the `-- operation:`
+     * line. Empty / null on first attempt; runs on every retry. Compensates
+     * for partial side effects left behind by a failed prior attempt
+     * (e.g. TRUNCATE a partially-loaded table before re-INSERTing).
+     */
+    beforeRetry: string | null;
+    summary: string;
+}
+export declare function migrationContainsDangerOperation(sql: string): boolean;
+export declare function extractMigrationOperationSummaries(sql: string): MigrationOperationSummary[];
+export declare function collectDestructiveOperationMarkers(migration: string, sql: string): DestructiveOperationMarker[];
+export interface ScannedDestructiveStatement {
+    type: string;
+    statement: string;
+}
+/**
+ * Scan the executable SQL (comments stripped) for destructive statements that
+ * are NOT covered by a planner `-- operation:` marker.
+ *
+ * Generated migrations emit exactly one marker per statement, in order (the same
+ * 1:1 invariant apply.ts relies on), so a marker-covered statement is governed
+ * by the planner's risk classification and is trusted — e.g. a non-danger
+ * `DROP MATERIALIZED VIEW` recreate. Only marker-less positions are flagged: a
+ * fully hand-written migration (no markers) or a destructive statement
+ * hand-appended to a generated one.
+ */
+export declare function scanDestructiveSqlStatements(sql: string): ScannedDestructiveStatement[];
+export declare function migrationContainsDestructiveSql(sql: string): boolean;
+/**
+ * Synthesize destructive-operation markers for migrations that contain
+ * destructive SQL but carry no `-- operation: risk=danger` marker (hand-written
+ * migrations). Used as a fallback so these still require --allow-destructive.
+ */
+export declare function collectUnmarkedDestructiveStatements(migration: string, sql: string): DestructiveOperationMarker[];
+//# sourceMappingURL=safety-markers.d.ts.map

package/dist/runtime/safety-markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-markers.d.ts","sourceRoot":"","sources":["../../src/runtime/safety-markers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AAEzD,OAAO,EAAE,2BAA2B,EAAE,CAAA;AAEtC,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,OAAO,CAAA;AAErD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,sBAAsB,CAAA;IAC5B;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErE;AAoCD,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,EAAE,CA0B3F;AAuDD,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,0BAA0B,EAAE,CA6B9B;AAkCD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,2BAA2B,EAAE,CAWvF;AAED,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,0BAA0B,EAAE,CAgB9B"}

package/dist/runtime/safety-markers.js

@@ -0,0 +1,211 @@
+import { extractExecutableStatements } from '@chkit/core';
+export { extractExecutableStatements };
+export function migrationContainsDangerOperation(sql) {
+    return extractDestructiveOperationSummaries(sql).length > 0;
+}
+function extractDestructiveOperationSummaries(sql) {
+    return sql
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.startsWith('-- operation:') && line.includes('risk=danger'))
+        .map((line) => line.replace(/^-- operation:\s*/, ''));
+}
+function parseOperationLine(summary, beforeRetry) {
+    const match = summary.match(/^([a-z_]+)\s+key=([^\s]+)\s+risk=([a-z_]+)(?:\s+mode=([a-z_]+))?$/);
+    if (!match)
+        return null;
+    const rawMode = match[4];
+    const mode = rawMode === 'async' ? 'async' : 'sync';
+    return {
+        type: match[1] ?? 'unknown',
+        key: match[2] ?? 'unknown',
+        risk: match[3] ?? 'unknown',
+        mode,
+        beforeRetry,
+        summary,
+    };
+}
+const BEFORE_RETRY_PREFIX = '-- before-retry:';
+function stripTrailingSemicolon(value) {
+    return value.replace(/;\s*$/, '').trim();
+}
+export function extractMigrationOperationSummaries(sql) {
+    const lines = sql.split('\n').map((line) => line.trim());
+    const summaries = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (!line?.startsWith('-- operation:'))
+            continue;
+        const summary = line.replace(/^-- operation:\s*/, '');
+        // A `-- before-retry: <sql>` line is associated with the operation if it
+        // appears in the comment block immediately following the operation line
+        // (allowing blank/comment lines in between, but not executable SQL).
+        let beforeRetry = null;
+        for (let j = i + 1; j < lines.length; j++) {
+            const next = lines[j];
+            if (next === undefined)
+                break;
+            if (next === '')
+                continue;
+            if (!next.startsWith('--'))
+                break;
+            if (next.startsWith(BEFORE_RETRY_PREFIX)) {
+                beforeRetry = stripTrailingSemicolon(next.slice(BEFORE_RETRY_PREFIX.length).trim());
+                if (beforeRetry === '')
+                    beforeRetry = null;
+                break;
+            }
+        }
+        const parsed = parseOperationLine(summary, beforeRetry);
+        if (parsed !== null)
+            summaries.push(parsed);
+    }
+    return summaries;
+}
+function describeDestructiveOperation(type, opts = {}) {
+    if (type === 'drop_table' && opts.recreate) {
+        return {
+            warningCode: 'table_recreate_data_loss',
+            reason: 'A change to engine, ORDER BY, PRIMARY KEY, PARTITION BY, or UNIQUE KEY can only be applied by dropping and recreating this table.',
+            impact: 'ALL ROWS are permanently deleted — the table is recreated empty and existing data is NOT copied over.',
+            recommendation: 'Back up the data first, or migrate via a temporary table (rename, INSERT ... SELECT, then drop) before approving.',
+        };
+    }
+    if (type === 'drop_table') {
+        return {
+            warningCode: 'drop_table_data_loss',
+            reason: 'Dropping a table removes table data and metadata from the target database.',
+            impact: 'Queries that depend on this table will fail until it is recreated and repopulated.',
+            recommendation: 'Verify backups and downstream dependencies before approving.',
+        };
+    }
+    if (type === 'alter_table_drop_column') {
+        return {
+            warningCode: 'drop_column_irreversible',
+            reason: 'Dropping a column permanently removes stored values for that column.',
+            impact: 'Applications or analytics depending on the column will break or return incomplete data.',
+            recommendation: 'Confirm the column is deprecated and no readers still require it.',
+        };
+    }
+    if (type === 'drop_view' || type === 'drop_materialized_view') {
+        return {
+            warningCode: 'drop_view_dependency_break',
+            reason: 'Dropping a view removes a query interface used by clients and pipelines.',
+            impact: 'Dependent workloads may fail until compatible replacements are in place.',
+            recommendation: 'Confirm replacement view rollout and dependency readiness.',
+        };
+    }
+    return {
+        warningCode: 'destructive_operation_review_required',
+        reason: 'This operation is marked destructive by planner risk classification.',
+        impact: 'Execution may cause irreversible schema or data changes.',
+        recommendation: 'Review SQL and dependency impact before approving.',
+    };
+}
+export function collectDestructiveOperationMarkers(migration, sql) {
+    // A table recreate emits a drop_table + create_table for the SAME key in the
+    // same migration (an engine/ORDER BY/PRIMARY KEY/PARTITION BY/UNIQUE KEY
+    // change). Flag those drops with a louder, distinct warning than a plain drop
+    // so the user knows all rows are lost and the table is recreated empty (#23).
+    const createdTableKeys = new Set(extractMigrationOperationSummaries(sql)
+        .filter((op) => op.type === 'create_table')
+        .map((op) => op.key));
+    return extractDestructiveOperationSummaries(sql).map((summary) => {
+        const parsed = parseOperationLine(summary, null);
+        const type = parsed?.type ?? 'unknown';
+        const key = parsed?.key ?? 'unknown';
+        const risk = parsed?.risk ?? 'danger';
+        const recreate = type === 'drop_table' && createdTableKeys.has(key);
+        const detail = describeDestructiveOperation(type, { recreate });
+        return {
+            migration,
+            type,
+            key,
+            risk,
+            warningCode: detail.warningCode,
+            reason: detail.reason,
+            impact: detail.impact,
+            recommendation: detail.recommendation,
+            summary,
+        };
+    });
+}
+// Defense-in-depth (#2): planner-emitted `-- operation: risk=danger` markers only
+// exist on generated migrations. A hand-written or hand-edited migration can
+// contain destructive SQL with no marker — so we also scan the executable SQL
+// itself. Comments are stripped first, so a commented-out `-- DROP TABLE` is not
+// flagged, while a real statement is.
+// Each rule requires the statement keyword that follows the verb, so a SQL
+// function such as `truncate(x)` (a ClickHouse math function) is NOT mistaken
+// for a `TRUNCATE TABLE` statement.
+const DESTRUCTIVE_SQL_RULES = [
+    { type: 'drop_database', re: /\bDROP\s+DATABASE\b/i },
+    { type: 'drop_materialized_view', re: /\bDROP\s+MATERIALIZED\s+VIEW\b/i },
+    { type: 'drop_view', re: /\bDROP\s+VIEW\b/i },
+    { type: 'drop_table', re: /\bDROP\s+(?:TEMPORARY\s+)?TABLE\b/i },
+    { type: 'alter_table_drop_column', re: /\bDROP\s+COLUMN\b/i },
+    { type: 'truncate_table', re: /\bTRUNCATE\s+(?:TABLE|DATABASE|ALL\s+TABLES)\b/i },
+    { type: 'detach', re: /\bDETACH\s+(?:TABLE|VIEW|DICTIONARY|DATABASE|PARTITION|PART)\b/i },
+];
+function classifyDestructiveStatement(statement) {
+    for (const rule of DESTRUCTIVE_SQL_RULES) {
+        if (rule.re.test(statement))
+            return rule.type;
+    }
+    return null;
+}
+function extractObjectKey(statement) {
+    const match = statement.match(/\b(?:TABLE|VIEW|DATABASE)\s+(?:IF\s+EXISTS\s+)?`?([\w.]+)`?/i);
+    return match?.[1] ?? 'unknown';
+}
+/**
+ * Scan the executable SQL (comments stripped) for destructive statements that
+ * are NOT covered by a planner `-- operation:` marker.
+ *
+ * Generated migrations emit exactly one marker per statement, in order (the same
+ * 1:1 invariant apply.ts relies on), so a marker-covered statement is governed
+ * by the planner's risk classification and is trusted — e.g. a non-danger
+ * `DROP MATERIALIZED VIEW` recreate. Only marker-less positions are flagged: a
+ * fully hand-written migration (no markers) or a destructive statement
+ * hand-appended to a generated one.
+ */
+export function scanDestructiveSqlStatements(sql) {
+    const statements = extractExecutableStatements(sql);
+    const operations = extractMigrationOperationSummaries(sql);
+    const found = [];
+    for (let i = 0; i < statements.length; i++) {
+        if (operations[i] !== undefined)
+            continue;
+        const statement = statements[i] ?? '';
+        const type = classifyDestructiveStatement(statement);
+        if (type)
+            found.push({ type, statement: statement.trim() });
+    }
+    return found;
+}
+export function migrationContainsDestructiveSql(sql) {
+    return scanDestructiveSqlStatements(sql).length > 0;
+}
+/**
+ * Synthesize destructive-operation markers for migrations that contain
+ * destructive SQL but carry no `-- operation: risk=danger` marker (hand-written
+ * migrations). Used as a fallback so these still require --allow-destructive.
+ */
+export function collectUnmarkedDestructiveStatements(migration, sql) {
+    return scanDestructiveSqlStatements(sql).map(({ type, statement }) => {
+        const detail = describeDestructiveOperation(type);
+        const preview = statement.length > 120 ? `${statement.slice(0, 117)}...` : statement;
+        return {
+            migration,
+            type,
+            key: extractObjectKey(statement),
+            risk: 'danger',
+            warningCode: detail.warningCode,
+            reason: detail.reason,
+            impact: detail.impact,
+            recommendation: detail.recommendation,
+            summary: `unmarked destructive SQL: ${preview}`,
+        };
+    });
+}
+//# sourceMappingURL=safety-markers.js.map

package/dist/runtime/safety-markers.js.map

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

package/dist/runtime/schema-loader.d.ts

@@ -0,0 +1,3 @@
+import type { SchemaDefinition } from '@chkit/core';
+export declare function loadSchemaDefinitions(schemaGlobs: string | string[]): Promise<SchemaDefinition[]>;
+//# sourceMappingURL=schema-loader.d.ts.map

package/dist/runtime/schema-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-loader.d.ts","sourceRoot":"","sources":["../../src/runtime/schema-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAGnD,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAMvG"}

package/dist/runtime/schema-loader.js

@@ -0,0 +1,11 @@
+import process from 'node:process';
+import { loadSchemaDefinitions as loadSchemaDefinitionsFromCore } from '@chkit/core/schema-loader';
+import { debug } from './debug.js';
+export async function loadSchemaDefinitions(schemaGlobs) {
+    const globs = Array.isArray(schemaGlobs) ? schemaGlobs : [schemaGlobs];
+    debug('schema', `loading definitions from globs: [${globs.join(', ')}] (cwd: ${process.cwd()})`);
+    const definitions = await loadSchemaDefinitionsFromCore(schemaGlobs, { cwd: process.cwd() });
+    debug('schema', `loaded ${definitions.length} schema definitions`);
+    return definitions;
+}
+//# sourceMappingURL=schema-loader.js.map

package/dist/runtime/schema-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-loader.js","sourceRoot":"","sources":["../../src/runtime/schema-loader.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAA;AAElC,OAAO,EAAE,qBAAqB,IAAI,6BAA6B,EAAE,MAAM,2BAA2B,CAAA;AAElG,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,WAA8B;IACxE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;IACtE,KAAK,CAAC,QAAQ,EAAE,oCAAoC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAChG,MAAM,WAAW,GAAG,MAAM,6BAA6B,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IAC5F,KAAK,CAAC,QAAQ,EAAE,UAAU,WAAW,CAAC,MAAM,qBAAqB,CAAC,CAAA;IAClE,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/dist/runtime/table-scope.d.ts

@@ -0,0 +1,33 @@
+import type { MigrationPlan, SchemaDefinition } from '@chkit/core';
+import type { TableScope } from '../plugins.js';
+export type { TableScope } from '../plugins.js';
+interface ParsedTableSelector {
+    database?: string;
+    mode: 'exact' | 'prefix';
+    value: string;
+}
+interface TableScopeFilterResult {
+    plan: MigrationPlan;
+    omittedOperationCount: number;
+}
+interface TableRenameMapping {
+    oldDatabase: string;
+    oldName: string;
+    newDatabase: string;
+    newName: string;
+}
+export declare function tableKeysFromDefinitions(definitions: SchemaDefinition[]): string[];
+export declare function parseTableSelector(input: string): ParsedTableSelector;
+export declare function resolveTableScope(selector: string | undefined, availableTables: string[]): TableScope;
+export declare function tableKeyFromOperationKey(operationKey: string): string | null;
+export declare function databaseKeyFromOperationKey(operationKey: string): string | null;
+export declare function filterPlanByTableScope(plan: MigrationPlan, matchedTables: ReadonlySet<string>, options?: {
+    renameMappings?: TableRenameMapping[];
+}): TableScopeFilterResult;
+export declare function buildScopedSnapshotDefinitions(input: {
+    previousDefinitions: SchemaDefinition[];
+    nextDefinitions: SchemaDefinition[];
+    matchedTables: ReadonlySet<string>;
+    renameMappings?: TableRenameMapping[];
+}): SchemaDefinition[];
+//# sourceMappingURL=table-scope.d.ts.map

package/dist/runtime/table-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-scope.d.ts","sourceRoot":"","sources":["../../src/runtime/table-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,gBAAgB,EAEjB,MAAM,aAAa,CAAA;AAEpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAA;IACxB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,aAAa,CAAA;IACnB,qBAAqB,EAAE,MAAM,CAAA;CAC9B;AAED,UAAU,kBAAkB;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB;AAMD,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,MAAM,EAAE,CAElF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAyDrE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,UAAU,CA4BrG;AAED,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5E;AAED,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG/E;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,EAClC,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAAO,GACtD,sBAAsB,CAqDxB;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,mBAAmB,EAAE,gBAAgB,EAAE,CAAA;IACvC,eAAe,EAAE,gBAAgB,EAAE,CAAA;IACnC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAClC,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAA;CACtC,GAAG,gBAAgB,EAAE,CAqCrB"}

package/dist/runtime/table-scope.js

@@ -0,0 +1,167 @@
+function tableKey(database, name) {
+    return `${database}.${name}`;
+}
+export function tableKeysFromDefinitions(definitions) {
+    return [...new Set(definitions.filter((def) => def.kind === 'table').map((def) => tableKey(def.database, def.name)))].sort((a, b) => a.localeCompare(b));
+}
+export function parseTableSelector(input) {
+    const selector = input.trim();
+    if (!selector) {
+        throw new Error('Invalid --table selector "". Expected <table>, <table_prefix*>, <database.table>, or <database.table_prefix*>.');
+    }
+    const dot = selector.indexOf('.');
+    const [database, tableToken] = dot === -1
+        ? [undefined, selector]
+        : [selector.slice(0, dot).trim(), selector.slice(dot + 1).trim()];
+    if (database !== undefined && (database.length === 0 || database.includes('*'))) {
+        throw new Error(`Invalid --table selector "${selector}". Database qualifier must be non-empty and cannot contain "*".`);
+    }
+    if (!tableToken || tableToken === '*') {
+        throw new Error(`Invalid --table selector "${selector}". A bare "*" is not supported; use an exact table or trailing wildcard prefix.`);
+    }
+    const wildcardCount = [...tableToken].filter((char) => char === '*').length;
+    if (wildcardCount > 1 || (wildcardCount === 1 && !tableToken.endsWith('*'))) {
+        throw new Error(`Invalid --table selector "${selector}". "*" is only allowed as a trailing suffix (for example, events_*).`);
+    }
+    if (tableToken.slice(0, -1).includes('*')) {
+        throw new Error(`Invalid --table selector "${selector}". "*" is only allowed as a trailing suffix (for example, events_*).`);
+    }
+    if (tableToken.endsWith('*')) {
+        const value = tableToken.slice(0, -1);
+        if (!value) {
+            throw new Error(`Invalid --table selector "${selector}". A bare "*" is not supported; use an exact table or trailing wildcard prefix.`);
+        }
+        return {
+            database,
+            mode: 'prefix',
+            value,
+        };
+    }
+    return {
+        database,
+        mode: 'exact',
+        value: tableToken,
+    };
+}
+export function resolveTableScope(selector, availableTables) {
+    if (!selector) {
+        return {
+            enabled: false,
+            matchedTables: [],
+            matchCount: 0,
+        };
+    }
+    const parsed = parseTableSelector(selector);
+    const normalized = [...new Set(availableTables)].sort((a, b) => a.localeCompare(b));
+    const matchedTables = normalized.filter((candidate) => {
+        const dot = candidate.indexOf('.');
+        if (dot <= 0 || dot === candidate.length - 1)
+            return false;
+        const database = candidate.slice(0, dot);
+        const table = candidate.slice(dot + 1);
+        if (parsed.database && parsed.database !== database)
+            return false;
+        if (parsed.mode === 'exact')
+            return table === parsed.value;
+        return table.startsWith(parsed.value);
+    });
+    return {
+        enabled: true,
+        selector,
+        matchedTables,
+        matchCount: matchedTables.length,
+    };
+}
+export function tableKeyFromOperationKey(operationKey) {
+    if (!operationKey.startsWith('table:'))
+        return null;
+    const target = operationKey.slice('table:'.length);
+    const nextSegment = target.indexOf(':');
+    return nextSegment === -1 ? target : target.slice(0, nextSegment);
+}
+export function databaseKeyFromOperationKey(operationKey) {
+    if (!operationKey.startsWith('database:'))
+        return null;
+    return operationKey.slice('database:'.length);
+}
+export function filterPlanByTableScope(plan, matchedTables, options = {}) {
+    if (matchedTables.size === 0) {
+        return {
+            plan: {
+                operations: [],
+                renameSuggestions: [],
+                riskSummary: { safe: 0, caution: 0, danger: 0 },
+            },
+            omittedOperationCount: plan.operations.length,
+        };
+    }
+    const selectedTables = new Set(matchedTables);
+    for (const mapping of options.renameMappings ?? []) {
+        const oldKey = tableKey(mapping.oldDatabase, mapping.oldName);
+        const newKey = tableKey(mapping.newDatabase, mapping.newName);
+        if (selectedTables.has(oldKey) || selectedTables.has(newKey)) {
+            selectedTables.add(oldKey);
+            selectedTables.add(newKey);
+        }
+    }
+    const selectedDatabases = new Set([...selectedTables].map((value) => value.split('.')[0] ?? ''));
+    const operations = plan.operations.filter((operation) => {
+        const targetTable = tableKeyFromOperationKey(operation.key);
+        if (targetTable)
+            return selectedTables.has(targetTable);
+        const targetDatabase = databaseKeyFromOperationKey(operation.key);
+        if (targetDatabase)
+            return selectedDatabases.has(targetDatabase);
+        return false;
+    });
+    const renameSuggestions = plan.renameSuggestions.filter((suggestion) => selectedTables.has(tableKey(suggestion.database, suggestion.table)));
+    const riskSummary = operations.reduce((summary, operation) => {
+        summary[operation.risk] += 1;
+        return summary;
+    }, { safe: 0, caution: 0, danger: 0 });
+    return {
+        plan: {
+            operations,
+            renameSuggestions,
+            riskSummary,
+        },
+        omittedOperationCount: plan.operations.length - operations.length,
+    };
+}
+export function buildScopedSnapshotDefinitions(input) {
+    if (input.matchedTables.size === 0)
+        return input.previousDefinitions;
+    const selectedTables = new Set(input.matchedTables);
+    for (const mapping of input.renameMappings ?? []) {
+        const oldKey = tableKey(mapping.oldDatabase, mapping.oldName);
+        const newKey = tableKey(mapping.newDatabase, mapping.newName);
+        if (selectedTables.has(oldKey) || selectedTables.has(newKey)) {
+            selectedTables.add(oldKey);
+            selectedTables.add(newKey);
+        }
+    }
+    const result = new Map();
+    for (const definition of input.previousDefinitions) {
+        result.set(`${definition.kind}:${definition.database}.${definition.name}`, definition);
+    }
+    for (const [key, definition] of [...result.entries()]) {
+        if (definition.kind !== 'table')
+            continue;
+        const currentTableKey = tableKey(definition.database, definition.name);
+        if (!selectedTables.has(currentTableKey))
+            continue;
+        const stillExists = input.nextDefinitions.some((item) => item.kind === 'table' && tableKey(item.database, item.name) === currentTableKey);
+        if (!stillExists)
+            result.delete(key);
+    }
+    for (const definition of input.nextDefinitions) {
+        if (definition.kind !== 'table')
+            continue;
+        const currentTableKey = tableKey(definition.database, definition.name);
+        if (!selectedTables.has(currentTableKey))
+            continue;
+        result.set(`${definition.kind}:${definition.database}.${definition.name}`, definition);
+    }
+    return [...result.values()];
+}
+//# sourceMappingURL=table-scope.js.map

package/dist/runtime/table-scope.js.map

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

package/dist/runtime/user-config.d.ts

@@ -0,0 +1,4 @@
+export declare function getUserConfigDir(): string;
+export declare const USER_PROFILE_CONFIG_FILE = "config.ts";
+export declare const USER_CREDENTIALS_FILE = "credentials.json";
+//# sourceMappingURL=user-config.d.ts.map

package/dist/runtime/user-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-config.d.ts","sourceRoot":"","sources":["../../src/runtime/user-config.ts"],"names":[],"mappings":"AAIA,wBAAgB,gBAAgB,IAAI,MAAM,CAIzC;AAED,eAAO,MAAM,wBAAwB,cAAc,CAAA;AACnD,eAAO,MAAM,qBAAqB,qBAAqB,CAAA"}

package/dist/runtime/user-config.js

@@ -0,0 +1,11 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import process from 'node:process';
+export function getUserConfigDir() {
+    const xdgConfig = process.env.XDG_CONFIG_HOME;
+    const configDir = xdgConfig && xdgConfig.length > 0 ? xdgConfig : join(homedir(), '.config');
+    return join(configDir, 'chkit');
+}
+export const USER_PROFILE_CONFIG_FILE = 'config.ts';
+export const USER_CREDENTIALS_FILE = 'credentials.json';
+//# sourceMappingURL=user-config.js.map

package/dist/runtime/user-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-config.js","sourceRoot":"","sources":["../../src/runtime/user-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,OAAO,MAAM,cAAc,CAAA;AAElC,MAAM,UAAU,gBAAgB;IAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAA;IAC7C,MAAM,SAAS,GAAG,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAA;IAC5F,OAAO,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;AACjC,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAA;AACnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAA"}

package/dist/runtime/version.d.ts

@@ -0,0 +1,2 @@
+export declare const CLI_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/runtime/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/runtime/version.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW,QAAc,CAAA"}