chkit 0.1.0-beta.9 → 0.1.0

package/dist/commands/migrate/command.js

@@ -0,0 +1,207 @@
+import { mkdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { defineFlags, typedFlags } from '../../plugins.js';
+import { resolveDirs } from '../../runtime/config.js';
+import { GLOBAL_FLAGS } from '../../runtime/global-flags.js';
+import { emitJson } from '../../runtime/json-output.js';
+import { createJournalStore, resolveJournalTableName } from '../../runtime/journal-store.js';
+import { extractMigrationMetadata } from '../../runtime/migration-metadata.js';
+import { findChecksumMismatches, listMigrations, readSnapshot, } from '../../runtime/migration-store.js';
+import { resolveTableScope, tableKeysFromDefinitions, } from '../../runtime/table-scope.js';
+import { debug } from '../../runtime/debug.js';
+import { applyMigration } from './apply.js';
+import { scanDestructive } from './destructive.js';
+import { confirmApply, confirmDestructiveExecution, isBackgroundOrCI, printDestructiveOperationDetails, } from './prompts.js';
+import { filterPendingByScope } from './scope.js';
+const MIGRATE_FLAGS = defineFlags([
+    { name: '--apply', type: 'boolean', description: 'Apply pending migrations on ClickHouse (no prompt)' },
+    { name: '--execute', type: 'boolean', description: 'Alias for --apply' },
+    { name: '--allow-destructive', type: 'boolean', description: 'Allow destructive migrations tagged with risk=danger' },
+]);
+export const migrateCommand = {
+    name: 'migrate',
+    description: 'Review or execute pending migrations',
+    flags: MIGRATE_FLAGS,
+    run: cmdMigrate,
+};
+async function cmdMigrate(runCtx) {
+    const { flags, config, configPath, pluginRuntime, pluginContext } = runCtx;
+    const f = typedFlags(flags, [...GLOBAL_FLAGS, ...MIGRATE_FLAGS]);
+    const executeRequested = f['--apply'] === true || f['--execute'] === true;
+    const allowDestructive = f['--allow-destructive'] === true;
+    const tableSelector = f['--table'];
+    const jsonMode = f['--json'] === true;
+    const { migrationsDir, metaDir } = resolveDirs(config);
+    debug('migrate', `flags: execute=${executeRequested}, allowDestructive=${allowDestructive}, json=${jsonMode}`);
+    if (!pluginContext.hasExecutor) {
+        throw new Error('clickhouse config is required for migrate (journal is stored in ClickHouse)');
+    }
+    const db = pluginContext.executor;
+    const journalStore = createJournalStore(db);
+    const snapshot = await readSnapshot(metaDir);
+    const tableScope = resolveTableScope(tableSelector, tableKeysFromDefinitions(snapshot?.definitions ?? []));
+    const mode = executeRequested ? 'execute' : 'plan';
+    await pluginRuntime.runOnConfigLoaded({
+        command: 'migrate',
+        config,
+        configPath,
+        tableScope,
+        flags,
+    });
+    await mkdir(migrationsDir, { recursive: true });
+    const files = await listMigrations(migrationsDir);
+    const journal = await journalStore.readJournal();
+    const appliedNames = new Set(journal.applied.map((entry) => entry.name));
+    const pendingAll = files.filter((file) => !appliedNames.has(file));
+    debug('migrate', `migrations: total=${files.length}, applied=${journal.applied.length}, pending=${pendingAll.length}`);
+    const checksumMismatches = await findChecksumMismatches(migrationsDir, journal);
+    if (checksumMismatches.length > 0) {
+        debug('migrate', `checksum mismatches: ${checksumMismatches.map((m) => m.name).join(', ')}`);
+        if (jsonMode) {
+            emitJson('migrate', {
+                mode,
+                scope: tableScope,
+                error: 'Checksum mismatch detected on applied migrations',
+                checksumMismatches,
+            });
+            return 1;
+        }
+        throw new Error(`Checksum mismatch detected on applied migrations: ${checksumMismatches.map((item) => item.name).join(', ')}`);
+    }
+    if (tableScope.enabled && tableScope.matchCount === 0) {
+        if (jsonMode) {
+            emitJson('migrate', {
+                mode,
+                scope: tableScope,
+                pending: [],
+                applied: [],
+                warning: `No tables matched selector "${tableScope.selector ?? ''}".`,
+            });
+        }
+        else {
+            console.log(`No tables matched selector "${tableScope.selector ?? ''}". No migrations selected.`);
+        }
+        return 0;
+    }
+    let pending = pendingAll;
+    let undeterminedScope = [];
+    if (tableScope.enabled) {
+        const scoped = await filterPendingByScope(migrationsDir, pendingAll, new Set(tableScope.matchedTables));
+        pending = scoped.inScope;
+        undeterminedScope = scoped.undetermined;
+    }
+    if (pending.length === 0) {
+        if (jsonMode) {
+            emitJson('migrate', { mode, scope: tableScope, pending: [], applied: [] });
+        }
+        else {
+            console.log('No pending migrations.');
+        }
+        return 0;
+    }
+    if (jsonMode && !executeRequested) {
+        emitJson('migrate', {
+            mode,
+            scope: tableScope,
+            pending,
+            ...(undeterminedScope.length > 0 ? { undeterminedMigrations: undeterminedScope } : {}),
+        });
+        return 0;
+    }
+    if (!jsonMode) {
+        if (tableScope.enabled) {
+            console.log(`Table scope: ${tableScope.selector ?? ''} (${tableScope.matchCount} matched)`);
+            for (const table of tableScope.matchedTables)
+                console.log(`- ${table}`);
+        }
+        if (undeterminedScope.length > 0) {
+            console.log(`⚠ ${undeterminedScope.length} pending migration(s) have no table markers; ` +
+                "including them because their target tables can't be determined under --table:");
+            for (const file of undeterminedScope)
+                console.log(`  - ${file}`);
+        }
+        console.log(`Pending migrations: ${pending.length}`);
+        for (const file of pending) {
+            console.log(`- ${file}`);
+            const sql = await readFile(join(migrationsDir, file), 'utf8');
+            const meta = extractMigrationMetadata(sql);
+            if (meta.log)
+                console.log(`    ${meta.log}`);
+        }
+    }
+    if (!executeRequested) {
+        if (isBackgroundOrCI() || jsonMode) {
+            if (!jsonMode) {
+                console.log('\nPlan only. Re-run with --apply to apply and journal these migrations.');
+            }
+            return 0;
+        }
+        const confirmed = await confirmApply();
+        if (!confirmed) {
+            console.log('Migration apply cancelled by user.');
+            return 0;
+        }
+    }
+    const destructive = await scanDestructive(migrationsDir, pending);
+    let destructiveAllowed = allowDestructive || config.safety?.allowDestructive === true;
+    if (destructive.migrations.length > 0 && !destructiveAllowed) {
+        const error = 'Blocked destructive migration execution. Re-run with --allow-destructive or set safety.allowDestructive=true after review.';
+        if (jsonMode) {
+            emitJson('migrate', {
+                mode: 'execute',
+                scope: tableScope,
+                error,
+                destructiveMigrations: destructive.migrations,
+                destructiveOperations: destructive.operations,
+            });
+            return 3;
+        }
+        if (isBackgroundOrCI()) {
+            printDestructiveOperationDetails(destructive.operations);
+            throw new Error(`${error}\nDestructive migrations: ${destructive.migrations.join(', ')}\n` +
+                'Non-interactive run detected. Pass --allow-destructive to proceed.');
+        }
+        const confirmed = await confirmDestructiveExecution(destructive.operations);
+        if (!confirmed) {
+            throw new Error(`Destructive migration cancelled by user.\nDestructive migrations: ${destructive.migrations.join(', ')}`);
+        }
+        destructiveAllowed = true;
+    }
+    if (destructive.migrations.length > 0 && !destructiveAllowed) {
+        throw new Error('Blocked destructive migration execution.');
+    }
+    const appliedNow = [];
+    for (const file of pending) {
+        if (!jsonMode) {
+            const sql = await readFile(join(migrationsDir, file), 'utf8');
+            const meta = extractMigrationMetadata(sql);
+            if (meta.log)
+                console.log(`  ${meta.log}`);
+        }
+        const entry = await applyMigration({
+            db,
+            journalStore,
+            pluginRuntime,
+            config,
+            tableScope,
+            flags,
+            migrationsDir,
+            file,
+        });
+        appliedNow.push(entry);
+        if (!jsonMode)
+            console.log(`Applied: ${file}`);
+    }
+    if (jsonMode) {
+        emitJson('migrate', {
+            mode: 'execute',
+            scope: tableScope,
+            applied: appliedNow,
+            ...(undeterminedScope.length > 0 ? { undeterminedMigrations: undeterminedScope } : {}),
+        });
+        return 0;
+    }
+    console.log(`\nMigrations recorded in ClickHouse ${resolveJournalTableName()} table.`);
+    return 0;
+}
+//# sourceMappingURL=command.js.map

package/dist/commands/migrate/command.js.map

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

package/dist/commands/migrate/destructive.d.ts

@@ -0,0 +1,7 @@
+import { type DestructiveOperationMarker } from '../../runtime/safety-markers.js';
+export interface DestructiveScan {
+    migrations: string[];
+    operations: DestructiveOperationMarker[];
+}
+export declare function scanDestructive(migrationsDir: string, pending: string[]): Promise<DestructiveScan>;
+//# sourceMappingURL=destructive.d.ts.map

package/dist/commands/migrate/destructive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destructive.d.ts","sourceRoot":"","sources":["../../../src/commands/migrate/destructive.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,0BAA0B,EAChC,MAAM,iCAAiC,CAAA;AAExC,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,UAAU,EAAE,0BAA0B,EAAE,CAAA;CACzC;AAED,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,eAAe,CAAC,CAkB1B"}

package/dist/commands/migrate/destructive.js

@@ -0,0 +1,24 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { collectDestructiveOperationMarkers, collectUnmarkedDestructiveStatements, migrationContainsDangerOperation, migrationContainsDestructiveSql, } from '../../runtime/safety-markers.js';
+export async function scanDestructive(migrationsDir, pending) {
+    const migrations = [];
+    const operations = [];
+    for (const file of pending) {
+        const sql = await readFile(join(migrationsDir, file), 'utf8');
+        if (migrationContainsDangerOperation(sql)) {
+            // Generated migration with planner risk markers (unchanged behavior).
+            migrations.push(file);
+            operations.push(...collectDestructiveOperationMarkers(file, sql));
+        }
+        else if (migrationContainsDestructiveSql(sql)) {
+            // Destructive SQL at a marker-less position: a fully hand-written
+            // migration, or a statement hand-appended to a generated one. Planner-
+            // marked statements (incl. non-danger drops) are trusted and not re-scanned.
+            migrations.push(file);
+            operations.push(...collectUnmarkedDestructiveStatements(file, sql));
+        }
+    }
+    return { migrations, operations };
+}
+//# sourceMappingURL=destructive.js.map

package/dist/commands/migrate/destructive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destructive.js","sourceRoot":"","sources":["../../../src/commands/migrate/destructive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EACL,kCAAkC,EAClC,oCAAoC,EACpC,gCAAgC,EAChC,+BAA+B,GAEhC,MAAM,iCAAiC,CAAA;AAOxC,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,aAAqB,EACrB,OAAiB;IAEjB,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,MAAM,UAAU,GAAiC,EAAE,CAAA;IACnD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;QAC7D,IAAI,gCAAgC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1C,sEAAsE;YACtE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACrB,UAAU,CAAC,IAAI,CAAC,GAAG,kCAAkC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAA;QACnE,CAAC;aAAM,IAAI,+BAA+B,CAAC,GAAG,CAAC,EAAE,CAAC;YAChD,kEAAkE;YAClE,uEAAuE;YACvE,6EAA6E;YAC7E,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACrB,UAAU,CAAC,IAAI,CAAC,GAAG,oCAAoC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAA;AACnC,CAAC"}

package/dist/commands/migrate/prompts.d.ts

@@ -0,0 +1,6 @@
+import type { DestructiveOperationMarker } from '../../runtime/safety-markers.js';
+export declare function isBackgroundOrCI(): boolean;
+export declare function printDestructiveOperationDetails(markers: DestructiveOperationMarker[]): void;
+export declare function confirmApply(): Promise<boolean>;
+export declare function confirmDestructiveExecution(markers: DestructiveOperationMarker[]): Promise<boolean>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/commands/migrate/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/commands/migrate/prompts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAEjF,wBAAgB,gBAAgB,IAAI,OAAO,CAO1C;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,0BAA0B,EAAE,GAAG,IAAI,CAW5F;AAcD,wBAAgB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAE/C;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,0BAA0B,EAAE,GACpC,OAAO,CAAC,OAAO,CAAC,CAGlB"}

package/dist/commands/migrate/prompts.js

@@ -0,0 +1,40 @@
+import process from 'node:process';
+import { createInterface } from 'node:readline/promises';
+export function isBackgroundOrCI() {
+    return (process.env.CI === '1' ||
+        process.env.CI === 'true' ||
+        !process.stdin.isTTY ||
+        !process.stdout.isTTY);
+}
+export function printDestructiveOperationDetails(markers) {
+    console.log('Destructive operations detected:');
+    for (const [index, marker] of markers.entries()) {
+        console.log(`${index + 1}. ${marker.migration}`);
+        console.log(`   operation: ${marker.type}`);
+        console.log(`   key: ${marker.key}`);
+        console.log(`   warning: ${marker.warningCode}`);
+        console.log(`   reason: ${marker.reason}`);
+        console.log(`   impact: ${marker.impact}`);
+        console.log(`   recommendation: ${marker.recommendation}`);
+    }
+}
+async function promptYes(message) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        console.log('');
+        console.log('Type "yes" to continue. Any other input cancels.');
+        const response = await rl.question(message);
+        return response.trim().toLowerCase() === 'yes';
+    }
+    finally {
+        rl.close();
+    }
+}
+export function confirmApply() {
+    return promptYes('Apply pending migrations now? [no/yes]: ');
+}
+export async function confirmDestructiveExecution(markers) {
+    printDestructiveOperationDetails(markers);
+    return promptYes('Apply destructive operations? [no/yes]: ');
+}
+//# sourceMappingURL=prompts.js.map

package/dist/commands/migrate/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/commands/migrate/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAIxD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG;QACtB,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM;QACzB,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK;QACpB,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CACtB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,OAAqC;IACpF,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAA;IAC/C,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;QAChD,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QAC3C,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,GAAG,EAAE,CAAC,CAAA;QACpC,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;QAChD,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;QAC1C,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;QAC1C,OAAO,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAA;IAC5D,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,OAAe;IACtC,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5E,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACf,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAA;QAC/D,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC3C,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,CAAA;IAChD,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAA;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,SAAS,CAAC,0CAA0C,CAAC,CAAA;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAAqC;IAErC,gCAAgC,CAAC,OAAO,CAAC,CAAA;IACzC,OAAO,SAAS,CAAC,0CAA0C,CAAC,CAAA;AAC9D,CAAC"}

package/dist/commands/migrate/scope.d.ts

@@ -0,0 +1,12 @@
+export interface ScopeFilterResult {
+    /** Migrations to apply under the scope (matched + fail-safe-included). */
+    inScope: string[];
+    /**
+     * Migrations included because their target tables could NOT be determined
+     * (no parseable `-- operation:` markers — e.g. hand-written migrations).
+     * Surfaced to the caller so it can warn instead of silently skipping them.
+     */
+    undetermined: string[];
+}
+export declare function filterPendingByScope(migrationsDir: string, pending: string[], selectedTables: ReadonlySet<string>): Promise<ScopeFilterResult>;
+//# sourceMappingURL=scope.d.ts.map

package/dist/commands/migrate/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/commands/migrate/scope.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB;;;;OAIG;IACH,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EAAE,EACjB,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAmC5B"}

package/dist/commands/migrate/scope.js

@@ -0,0 +1,35 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { extractMigrationOperationSummaries } from '../../runtime/safety-markers.js';
+import { databaseKeyFromOperationKey, tableKeyFromOperationKey, } from '../../runtime/table-scope.js';
+export async function filterPendingByScope(migrationsDir, pending, selectedTables) {
+    const selectedDatabases = new Set([...selectedTables].map((table) => table.split('.')[0] ?? ''));
+    const inScope = [];
+    const undetermined = [];
+    for (const file of pending) {
+        const sql = await readFile(join(migrationsDir, file), 'utf8');
+        const operations = extractMigrationOperationSummaries(sql);
+        // A migration with no parseable operation markers (a hand-written one) has
+        // undeterminable target tables. Silently skipping it under --table is a
+        // quiet correctness gap (#36): the user believes all pending work applied.
+        // Fail-safe by including it, and report it so the caller can warn.
+        if (operations.length === 0) {
+            inScope.push(file);
+            undetermined.push(file);
+            continue;
+        }
+        const matches = operations.some((operation) => {
+            const tableKey = tableKeyFromOperationKey(operation.key);
+            if (tableKey)
+                return selectedTables.has(tableKey);
+            const database = databaseKeyFromOperationKey(operation.key);
+            if (database)
+                return selectedDatabases.has(database);
+            return false;
+        });
+        if (matches)
+            inScope.push(file);
+    }
+    return { inScope, undetermined };
+}
+//# sourceMappingURL=scope.js.map

package/dist/commands/migrate/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../../src/commands/migrate/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,kCAAkC,EAAE,MAAM,iCAAiC,CAAA;AACpF,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,8BAA8B,CAAA;AAarC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,aAAqB,EACrB,OAAiB,EACjB,cAAmC;IAEnC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAC/B,CAAC,GAAG,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAC9D,CAAA;IAED,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,YAAY,GAAa,EAAE,CAAA;IACjC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;QAC7D,MAAM,UAAU,GAAG,kCAAkC,CAAC,GAAG,CAAC,CAAA;QAE1D,2EAA2E;QAC3E,wEAAwE;QACxE,2EAA2E;QAC3E,mEAAmE;QACnE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAClB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACvB,SAAQ;QACV,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;YAC5C,MAAM,QAAQ,GAAG,wBAAwB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;YACxD,IAAI,QAAQ;gBAAE,OAAO,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAEjD,MAAM,QAAQ,GAAG,2BAA2B,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;YAC3D,IAAI,QAAQ;gBAAE,OAAO,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAEpD,OAAO,KAAK,CAAA;QACd,CAAC,CAAC,CAAA;QAEF,IAAI,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA;AAClC,CAAC"}

package/dist/commands/plugin.d.ts

@@ -0,0 +1,3 @@
+import { type ChxPluginCommand } from '../plugins.js';
+export declare const pluginCommand: ChxPluginCommand;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/commands/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/commands/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,gBAAgB,EAAoB,MAAM,eAAe,CAAA;AAOnF,eAAO,MAAM,aAAa,EAAE,gBAK3B,CAAA"}

package/dist/commands/plugin.js

@@ -0,0 +1,129 @@
+import { typedFlags } from '../plugins.js';
+import { GLOBAL_FLAGS } from '../runtime/global-flags.js';
+import { emitJson, printOutput } from '../runtime/json-output.js';
+import { parseFlags, UnknownFlagError, MissingFlagValueError } from '@chkit/core';
+import { resolveTableScope, tableKeysFromDefinitions } from '../runtime/table-scope.js';
+import { loadSchemaDefinitions } from '../runtime/schema-loader.js';
+export const pluginCommand = {
+    name: 'plugin',
+    description: 'List plugins and run plugin namespace commands',
+    flags: [],
+    run: cmdPlugin,
+};
+async function cmdPlugin(ctx) {
+    const { flags, args, config, configPath, pluginRuntime } = ctx;
+    const jsonMode = flags['--json'] === true;
+    const pluginName = args[0];
+    const commandName = args[1];
+    const commandArgs = args.slice(2);
+    if (pluginRuntime.plugins.length === 0) {
+        if (jsonMode) {
+            emitJson('plugin', {
+                error: 'No plugins configured. Add entries to config.plugins first.',
+                plugins: [],
+            });
+            return 1;
+        }
+        throw new Error('No plugins configured. Add entries to config.plugins first.');
+    }
+    if (!pluginName) {
+        const payload = {
+            plugins: pluginRuntime.plugins.map((entry) => ({
+                name: entry.plugin.manifest.name,
+                version: entry.plugin.manifest.version ?? null,
+                commands: (entry.plugin.commands ?? []).map((command) => ({
+                    name: command.name,
+                    description: command.description ?? '',
+                })),
+            })),
+        };
+        if (jsonMode) {
+            emitJson('plugin', payload);
+            return 0;
+        }
+        console.log('Configured plugins:');
+        for (const plugin of payload.plugins) {
+            console.log(`- ${plugin.name}${plugin.version ? ` (v${plugin.version})` : ''}`);
+            if (plugin.commands.length === 0) {
+                console.log('  (no commands)');
+                continue;
+            }
+            for (const command of plugin.commands) {
+                console.log(`  - ${command.name}${command.description ? `: ${command.description}` : ''}`);
+            }
+        }
+        return 0;
+    }
+    const selectedPlugin = pluginRuntime.plugins.find((entry) => entry.plugin.manifest.name === pluginName);
+    if (!selectedPlugin) {
+        const known = pluginRuntime.plugins.map((entry) => entry.plugin.manifest.name).sort();
+        throw new Error(`Unknown plugin "${pluginName}". Available: ${known.length > 0 ? known.join(', ') : '(none)'}.`);
+    }
+    if (!commandName) {
+        const commands = (selectedPlugin.plugin.commands ?? []).map((command) => ({
+            name: command.name,
+            description: command.description ?? '',
+        }));
+        const payload = {
+            plugin: selectedPlugin.plugin.manifest.name,
+            commands,
+        };
+        if (jsonMode) {
+            emitJson('plugin', payload);
+            return 0;
+        }
+        if (commands.length === 0) {
+            console.log(`Plugin "${selectedPlugin.plugin.manifest.name}" has no registered commands.`);
+            return 0;
+        }
+        console.log(`Plugin commands for "${selectedPlugin.plugin.manifest.name}":`);
+        for (const command of commands) {
+            console.log(`- ${command.name}${command.description ? `: ${command.description}` : ''}`);
+        }
+        return 0;
+    }
+    const gf = typedFlags(flags, GLOBAL_FLAGS);
+    const tableSelector = gf['--table'];
+    let tableScope;
+    try {
+        const definitions = await loadSchemaDefinitions(ctx.config.schema);
+        tableScope = resolveTableScope(tableSelector, tableKeysFromDefinitions(definitions));
+    }
+    catch {
+        tableScope = resolveTableScope(tableSelector, []);
+    }
+    // Parse plugin-specific flags when the command declares them
+    const targetCommand = (selectedPlugin.plugin.commands ?? []).find((cmd) => cmd.name === commandName);
+    let mergedFlags = { ...flags };
+    if (targetCommand?.flags && targetCommand.flags.length > 0) {
+        try {
+            const parsed = parseFlags(commandArgs, targetCommand.flags);
+            mergedFlags = { ...flags, ...parsed };
+        }
+        catch (error) {
+            if (error instanceof UnknownFlagError || error instanceof MissingFlagValueError) {
+                if (jsonMode) {
+                    emitJson('plugin', { ok: false, error: error.message });
+                }
+                else {
+                    console.error(error.message);
+                }
+                return 1;
+            }
+            throw error;
+        }
+    }
+    const exitCode = await pluginRuntime.runPluginCommand(pluginName, commandName, {
+        config,
+        configPath,
+        jsonMode,
+        tableScope,
+        args: commandArgs,
+        flags: mergedFlags,
+        print(value) {
+            printOutput(value, jsonMode);
+        },
+    });
+    return exitCode;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/commands/plugin.js.map

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

package/dist/commands/query.d.ts

@@ -0,0 +1,17 @@
+import type { ClickHouseJsonQueryResult } from '@chkit/clickhouse';
+import type { ChxPluginCommand } from '../plugins.js';
+export declare const queryCommand: ChxPluginCommand;
+/**
+ * ClickHouse syntax errors echo back the query — including the `FORMAT JSON`
+ * clause chkit injects, which the user never typed — and can append a ~40-item
+ * "Expected one of" token dump. Strip the injected FORMAT clause and cap the
+ * token list so the message reflects the SQL the user actually wrote. Returns
+ * the original error untouched when there is nothing to clean (e.g. connection
+ * errors already formatted upstream).
+ */
+export declare function cleanQueryError(error: unknown): unknown;
+export declare function formatQueryJson(payload: ClickHouseJsonQueryResult): string;
+export declare function formatRows(rows: Record<string, unknown>[], options?: {
+    limit?: number;
+}): string;
+//# sourceMappingURL=query.d.ts.map

package/dist/commands/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAIrD,eAAO,MAAM,YAAY,EAAE,gBA8C1B,CAAA;AAKD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAiBvD;AAUD,wBAAgB,eAAe,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,CAE1E;AAoCD,wBAAgB,UAAU,CACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B,MAAM,CA0CR"}