chkit 0.1.0-beta.10

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/status.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,kBAAkB,CAAA;AAKrE,eAAO,MAAM,aAAa,EAAE,UAK3B,CAAA"}

package/dist/bin/commands/status.js

@@ -0,0 +1,53 @@
+import { mkdir } from 'node:fs/promises';
+import { emitJson } from '../json-output.js';
+import { createJournalStoreFromConfig } from '../journal-store.js';
+import { findChecksumMismatches, listMigrations } from '../migration-store.js';
+export const statusCommand = {
+    name: 'status',
+    description: 'Show migration status and checksum mismatch information',
+    flags: [],
+    run: cmdStatus,
+};
+async function cmdStatus(ctx) {
+    const { flags, config, dirs } = ctx;
+    const jsonMode = flags['--json'] === true;
+    const { migrationsDir } = dirs;
+    if (!config.clickhouse) {
+        throw new Error('clickhouse config is required for status (journal is stored in ClickHouse)');
+    }
+    const { journalStore } = createJournalStoreFromConfig(config.clickhouse);
+    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 pending = files.filter((f) => !appliedNames.has(f));
+    const checksumMismatches = await findChecksumMismatches(migrationsDir, journal);
+    const payload = {
+        migrationsDir,
+        total: files.length,
+        applied: journal.applied.length,
+        pending: pending.length,
+        pendingMigrations: pending,
+        checksumMismatchCount: checksumMismatches.length,
+        checksumMismatches,
+    };
+    if (jsonMode) {
+        emitJson('status', payload);
+        return;
+    }
+    console.log(`Migrations directory: ${migrationsDir}`);
+    console.log(`Total migrations:     ${files.length}`);
+    console.log(`Applied:              ${journal.applied.length}`);
+    console.log(`Pending:              ${pending.length}`);
+    if (pending.length > 0) {
+        console.log('\nPending migrations:');
+        for (const item of pending)
+            console.log(`- ${item}`);
+    }
+    if (checksumMismatches.length > 0) {
+        console.log('\nChecksum mismatches on applied migrations:');
+        for (const item of checksumMismatches)
+            console.log(`- ${item.name}`);
+    }
+}
+//# sourceMappingURL=status.js.map

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

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

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

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

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

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

package/dist/bin/commands/typegen.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"typegen.js","sourceRoot":"","sources":["../../../src/bin/commands/typegen.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/config.d.ts

@@ -0,0 +1,13 @@
+import { type ChxConfigEnv, type ResolvedChxConfig } from '@chkit/core';
+export declare const DEFAULT_CONFIG_FILE = "clickhouse.config.ts";
+export declare function loadConfig(configPathArg?: string, env?: ChxConfigEnv): Promise<{
+    config: ResolvedChxConfig;
+    path: string;
+}>;
+export declare function writeIfMissing(filePath: string, content: string): Promise<void>;
+export declare function resolveDirs(config: ResolvedChxConfig): {
+    outDir: string;
+    migrationsDir: string;
+    metaDir: string;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/bin/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/bin/config.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,YAAY,EAGjB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAA;AAEpB,eAAO,MAAM,mBAAmB,yBAAyB,CAAA;AAMzD,wBAAsB,UAAU,CAC9B,aAAa,CAAC,EAAE,MAAM,EACtB,GAAG,GAAE,YAAiB,GACrB,OAAO,CAAC;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBtD;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAKjH"}

package/dist/bin/config.js

@@ -0,0 +1,39 @@
+import { existsSync } from 'node:fs';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import process from 'node:process';
+import { pathToFileURL } from 'node:url';
+import { resolveConfig, } from '@chkit/core';
+export const DEFAULT_CONFIG_FILE = 'clickhouse.config.ts';
+function isConfigFunction(candidate) {
+    return typeof candidate === 'function';
+}
+export async function loadConfig(configPathArg, env = {}) {
+    const configPath = resolve(process.cwd(), configPathArg ?? DEFAULT_CONFIG_FILE);
+    if (!existsSync(configPath)) {
+        throw new Error(`Config not found at ${configPath}. Run 'chkit init' first.`);
+    }
+    const mod = await import(pathToFileURL(configPath).href);
+    const candidate = (mod.default ?? mod.config);
+    if (!candidate) {
+        throw new Error(`Config file ${configPath} must export a default/config object or a function via defineConfig.`);
+    }
+    const userConfig = isConfigFunction(candidate) ? await candidate(env) : candidate;
+    return {
+        config: resolveConfig(userConfig),
+        path: configPath,
+    };
+}
+export async function writeIfMissing(filePath, content) {
+    if (existsSync(filePath))
+        return;
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, content, 'utf8');
+}
+export function resolveDirs(config) {
+    const outDir = resolve(process.cwd(), config.outDir);
+    const migrationsDir = resolve(process.cwd(), config.migrationsDir);
+    const metaDir = resolve(process.cwd(), config.metaDir);
+    return { outDir, migrationsDir, metaDir };
+}
+//# sourceMappingURL=config.js.map

package/dist/bin/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/bin/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EACL,aAAa,GAMd,MAAM,aAAa,CAAA;AAEpB,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,CAAA;AAEzD,SAAS,gBAAgB,CAAC,SAAyB;IACjD,OAAO,OAAO,SAAS,KAAK,UAAU,CAAA;AACxC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,aAAsB,EACtB,MAAoB,EAAE;IAEtB,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,IAAI,mBAAmB,CAAC,CAAA;IAC/E,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,uBAAuB,UAAU,2BAA2B,CAAC,CAAA;IAC/E,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAA;IACxD,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,CAA+B,CAAA;IAC3E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,eAAe,UAAU,sEAAsE,CAChG,CAAA;IACH,CAAC;IAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,SAAuB,CAAA;IAEhG,OAAO;QACL,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC;QACjC,IAAI,EAAE,UAAU;KACjB,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,OAAe;IACpE,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAM;IAChC,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAyB;IACnD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IACpD,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,aAAa,CAAC,CAAA;IAClE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IACtD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAA;AAC3C,CAAC"}

package/dist/bin/global-flags.d.ts

@@ -0,0 +1,16 @@
+export declare const GLOBAL_FLAGS: readonly [{
+    readonly name: "--config";
+    readonly type: "string";
+    readonly description: "Path to config file";
+    readonly placeholder: "<path>";
+}, {
+    readonly name: "--json";
+    readonly type: "boolean";
+    readonly description: "Emit machine-readable JSON output";
+}, {
+    readonly name: "--table";
+    readonly type: "string";
+    readonly description: "Limit command scope to tables by exact name or trailing wildcard prefix";
+    readonly placeholder: "<selector>";
+}];
+//# sourceMappingURL=global-flags.d.ts.map

package/dist/bin/global-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-flags.d.ts","sourceRoot":"","sources":["../../src/bin/global-flags.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;EAId,CAAA"}

package/dist/bin/global-flags.js

@@ -0,0 +1,7 @@
+import { defineFlags } from '@chkit/core';
+export const GLOBAL_FLAGS = defineFlags([
+    { name: '--config', type: 'string', description: 'Path to config file', placeholder: '<path>' },
+    { name: '--json', type: 'boolean', description: 'Emit machine-readable JSON output' },
+    { name: '--table', type: 'string', description: 'Limit command scope to tables by exact name or trailing wildcard prefix', placeholder: '<selector>' },
+]);
+//# sourceMappingURL=global-flags.js.map

package/dist/bin/global-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-flags.js","sourceRoot":"","sources":["../../src/bin/global-flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;IACtC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE,WAAW,EAAE,QAAQ,EAAE;IAC/F,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,mCAAmC,EAAE;IACrF,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yEAAyE,EAAE,WAAW,EAAE,YAAY,EAAE;CAC9I,CAAC,CAAA"}

package/dist/bin/help.d.ts

@@ -0,0 +1,5 @@
+import type { FlagDef } from '../plugins.js';
+import type { CommandRegistry, RegisteredCommand } from './command-registry.js';
+export declare function formatGlobalHelp(registry: CommandRegistry, version: string): string;
+export declare function formatCommandHelp(command: RegisteredCommand, globalFlags: readonly FlagDef[]): string;
+//# sourceMappingURL=help.d.ts.map

package/dist/bin/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/bin/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAE/E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA0CnF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAuCrG"}

package/dist/bin/help.js

@@ -0,0 +1,84 @@
+export function formatGlobalHelp(registry, version) {
+    const lines = [];
+    lines.push(`chkit v${version} - ClickHouse toolkit`);
+    lines.push('');
+    lines.push('Usage:');
+    lines.push('  chkit <command> [options]');
+    lines.push('');
+    lines.push('Commands:');
+    lines.push(`  ${'init'.padEnd(14)} Scaffold a new project with config and example schema`);
+    const coreCommands = registry.commands.filter((c) => !c.isPlugin);
+    const pluginCommands = registry.commands.filter((c) => c.isPlugin);
+    for (const cmd of coreCommands) {
+        lines.push(`  ${cmd.name.padEnd(14)} ${cmd.description}`);
+    }
+    if (pluginCommands.length > 0) {
+        lines.push('');
+        lines.push('Plugin commands:');
+        for (const cmd of pluginCommands) {
+            if (cmd.subcommands) {
+                lines.push(`  ${cmd.name.padEnd(14)} ${cmd.description}`);
+                for (const sub of cmd.subcommands) {
+                    lines.push(`    ${sub.name.padEnd(12)} ${sub.description}`);
+                }
+            }
+            else {
+                lines.push(`  ${cmd.name.padEnd(14)} ${cmd.description}`);
+            }
+        }
+    }
+    lines.push('');
+    lines.push('Global options:');
+    for (const flag of registry.globalFlags) {
+        lines.push(formatFlagLine(flag));
+    }
+    lines.push(formatFlagLine({ name: '-h, --help', type: 'boolean', description: 'Show help' }));
+    lines.push(formatFlagLine({ name: '-v, --version', type: 'boolean', description: 'Show version' }));
+    return lines.join('\n');
+}
+export function formatCommandHelp(command, globalFlags) {
+    const lines = [];
+    if (command.subcommands) {
+        lines.push(`chkit ${command.name} <command> [options]`);
+        lines.push(`  ${command.description}`);
+        lines.push('');
+        lines.push('Commands:');
+        for (const sub of command.subcommands) {
+            lines.push(`  ${sub.name.padEnd(14)} ${sub.description}`);
+        }
+    }
+    else {
+        lines.push(`chkit ${command.name} [options]`);
+        lines.push(`  ${command.description}`);
+    }
+    if (command.flags.length > 0) {
+        lines.push('');
+        lines.push('Options:');
+        for (const flag of command.flags) {
+            lines.push(formatFlagLine(flag));
+        }
+    }
+    for (const pf of command.pluginFlags) {
+        lines.push('');
+        lines.push(`Plugin: ${pf.pluginName}`);
+        for (const flag of pf.flags) {
+            lines.push(formatFlagLine(flag));
+        }
+    }
+    lines.push('');
+    lines.push('Global options:');
+    for (const flag of globalFlags) {
+        lines.push(formatFlagLine(flag));
+    }
+    return lines.join('\n');
+}
+function formatFlagLine(flag) {
+    const nameStr = flag.name ?? '';
+    const placeholder = flag.placeholder ? ` ${flag.placeholder}` : '';
+    const label = `${nameStr}${placeholder}`;
+    if (label.length >= 22) {
+        return `  ${label}\n${''.padEnd(24)}${flag.description}`;
+    }
+    return `  ${label.padEnd(22)} ${flag.description}`;
+}
+//# sourceMappingURL=help.js.map

package/dist/bin/help.js.map

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

package/dist/bin/internal-plugins/index.d.ts

@@ -0,0 +1,3 @@
+import type { ChxPlugin } from '../../plugins.js';
+export declare function getInternalPlugins(): ChxPlugin[];
+//# sourceMappingURL=index.d.ts.map

package/dist/bin/internal-plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bin/internal-plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAIjD,wBAAgB,kBAAkB,IAAI,SAAS,EAAE,CAEhD"}

package/dist/bin/internal-plugins/index.js

@@ -0,0 +1,5 @@
+import { createSkillHintPlugin } from './skill-hint.js';
+export function getInternalPlugins() {
+    return [createSkillHintPlugin()];
+}
+//# sourceMappingURL=index.js.map

package/dist/bin/internal-plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/bin/internal-plugins/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAA;AAClC,CAAC"}

package/dist/bin/internal-plugins/skill-hint.d.ts

@@ -0,0 +1,16 @@
+import { type ChxPlugin } from '../../plugins.js';
+export declare const SKILL_INSTALL_COMMAND = "npx skills add obsessiondb/chkit";
+export declare const HINT_INTERVAL_MS: number;
+export interface SkillHintState {
+    lastDismissed?: string;
+}
+export interface SkillHintDeps {
+    isSkillInstalled(): boolean;
+    readState(): SkillHintState;
+    writeState(state: SkillHintState): void;
+    promptUser(): Promise<boolean>;
+    installSkill(): Promise<boolean>;
+    now(): number;
+}
+export declare function createSkillHintPlugin(overrides?: Partial<SkillHintDeps>): ChxPlugin;
+//# sourceMappingURL=skill-hint.d.ts.map

package/dist/bin/internal-plugins/skill-hint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-hint.d.ts","sourceRoot":"","sources":["../../../src/bin/internal-plugins/skill-hint.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE/D,eAAO,MAAM,qBAAqB,qCAAqC,CAAA;AACvE,eAAO,MAAM,gBAAgB,QAA2B,CAAA;AAExD,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,IAAI,OAAO,CAAA;IAC3B,SAAS,IAAI,cAAc,CAAA;IAC3B,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;IACvC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9B,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAChC,GAAG,IAAI,MAAM,CAAA;CACd;AA8DD,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,CAqCnF"}

package/dist/bin/internal-plugins/skill-hint.js

@@ -0,0 +1,101 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import process from 'node:process';
+import { definePlugin } from '../../plugins.js';
+export const SKILL_INSTALL_COMMAND = 'npx skills add obsessiondb/chkit';
+export const HINT_INTERVAL_MS = 30 * 24 * 60 * 60 * 1000; // 30 days
+function getStateDir() {
+    return join(homedir(), '.chkit');
+}
+function getStateFilePath() {
+    return join(getStateDir(), 'skill-hint.json');
+}
+const defaultDeps = {
+    isSkillInstalled() {
+        const cwd = process.cwd();
+        const projectSkill = join(cwd, '.claude', 'skills', 'chkit', 'SKILL.md');
+        const globalSkill = join(homedir(), '.claude', 'skills', 'chkit', 'SKILL.md');
+        return existsSync(projectSkill) || existsSync(globalSkill);
+    },
+    readState() {
+        try {
+            return JSON.parse(readFileSync(getStateFilePath(), 'utf-8'));
+        }
+        catch {
+            return {};
+        }
+    },
+    writeState(state) {
+        const dir = getStateDir();
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(getStateFilePath(), JSON.stringify(state, null, 2) + '\n');
+    },
+    async promptUser() {
+        const { createInterface } = await import('node:readline/promises');
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        try {
+            console.error('');
+            console.error('chkit has an AI agent skill for Claude Code.');
+            console.error(`Install it with: ${SKILL_INSTALL_COMMAND}`);
+            console.error('');
+            const answer = await rl.question('Install now? [y/N] ');
+            return answer.trim().toLowerCase() === 'y' || answer.trim().toLowerCase() === 'yes';
+        }
+        finally {
+            rl.close();
+        }
+    },
+    async installSkill() {
+        const { execSync } = await import('node:child_process');
+        try {
+            console.error('');
+            execSync(SKILL_INSTALL_COMMAND, { stdio: 'inherit' });
+            return true;
+        }
+        catch {
+            console.error(`Failed to install. Run manually: ${SKILL_INSTALL_COMMAND}`);
+            return false;
+        }
+    },
+    now: () => Date.now(),
+};
+export function createSkillHintPlugin(overrides) {
+    const deps = { ...defaultDeps, ...overrides };
+    let pendingMessage;
+    return definePlugin({
+        manifest: {
+            name: '@chkit/internal-skill-hint',
+            apiVersion: 1,
+        },
+        hooks: {
+            async onInit(ctx) {
+                if (!ctx.isInteractive || ctx.jsonMode)
+                    return;
+                if (deps.isSkillInstalled())
+                    return;
+                const state = deps.readState();
+                if (state.lastDismissed) {
+                    const elapsed = deps.now() - new Date(state.lastDismissed).getTime();
+                    if (elapsed < HINT_INTERVAL_MS)
+                        return;
+                }
+                const accepted = await deps.promptUser();
+                if (accepted) {
+                    await deps.installSkill();
+                }
+                else {
+                    deps.writeState({ lastDismissed: new Date(deps.now()).toISOString() });
+                    pendingMessage = `You can install it later with: ${SKILL_INSTALL_COMMAND}`;
+                }
+            },
+            onComplete(ctx) {
+                if (pendingMessage && !ctx.jsonMode && ctx.exitCode === 0) {
+                    console.error('');
+                    console.error(pendingMessage);
+                }
+            },
+        },
+    });
+}
+//# sourceMappingURL=skill-hint.js.map

package/dist/bin/internal-plugins/skill-hint.js.map

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

package/dist/bin/journal-store.d.ts

@@ -0,0 +1,13 @@
+import { type ClickHouseExecutor } from '@chkit/clickhouse';
+import type { ChxConfig } from '@chkit/core';
+import type { MigrationJournal, MigrationJournalEntry } from './migration-store.js';
+export interface JournalStore {
+    readJournal(): Promise<MigrationJournal>;
+    appendEntry(entry: MigrationJournalEntry): Promise<void>;
+}
+export declare function createJournalStore(db: ClickHouseExecutor): JournalStore;
+export declare function createJournalStoreFromConfig(clickhouseConfig: NonNullable<ChxConfig['clickhouse']>): {
+    journalStore: JournalStore;
+    db: ClickHouseExecutor;
+};
+//# sourceMappingURL=journal-store.d.ts.map

package/dist/bin/journal-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-store.d.ts","sourceRoot":"","sources":["../../src/bin/journal-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAGnF,MAAM,WAAW,YAAY;IAC3B,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACxC,WAAW,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACzD;AAkBD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,kBAAkB,GAAG,YAAY,CAiEvE;AAED,wBAAgB,4BAA4B,CAC1C,gBAAgB,EAAE,WAAW,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,GACrD;IAAE,YAAY,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,kBAAkB,CAAA;CAAE,CAGxD"}

package/dist/bin/journal-store.js

@@ -0,0 +1,79 @@
+import { createClickHouseExecutor } from '@chkit/clickhouse';
+import { CLI_VERSION } from './version.js';
+const CREATE_TABLE_SQL = `CREATE TABLE IF NOT EXISTS _chkit_migrations (
+    name String,
+    applied_at DateTime64(3, 'UTC'),
+    checksum String,
+    chkit_version String
+) ENGINE = MergeTree()
+ORDER BY (name)
+SETTINGS index_granularity = 1`;
+export function createJournalStore(db) {
+    let bootstrapped = false;
+    async function ensureTable() {
+        if (bootstrapped)
+            return;
+        // Probe whether the table already exists before issuing CREATE TABLE.
+        // On ClickHouse Cloud, repeated CREATE TABLE IF NOT EXISTS can fail with
+        // "already exists in metadata backend with different schema" because the
+        // engine normalisation (SharedMergeTree vs SharedMergeTree()) differs
+        // between the stored metadata and the new DDL statement.
+        try {
+            await db.query(`SELECT name FROM _chkit_migrations LIMIT 0`);
+            bootstrapped = true;
+            return;
+        }
+        catch {
+            // Table does not exist yet – create it below.
+        }
+        await db.execute(CREATE_TABLE_SQL);
+        // On ClickHouse Cloud, DDL propagation across nodes may lag behind the
+        // CREATE TABLE acknowledgment. Wait until the table is queryable.
+        for (let attempt = 0; attempt < 10; attempt++) {
+            try {
+                await db.query(`SELECT name FROM _chkit_migrations LIMIT 0`);
+                break;
+            }
+            catch {
+                await new Promise((r) => setTimeout(r, 250));
+            }
+        }
+        bootstrapped = true;
+    }
+    return {
+        async readJournal() {
+            await ensureTable();
+            try {
+                await db.execute(`SYSTEM SYNC REPLICA _chkit_migrations`);
+            }
+            catch {
+                // Non-replicated or single-node setups don't support SYSTEM SYNC REPLICA.
+            }
+            const rows = await db.query(`SELECT name, applied_at, checksum, chkit_version FROM _chkit_migrations ORDER BY name SETTINGS select_sequential_consistency = 1`);
+            return {
+                version: 1,
+                applied: rows.map((row) => ({
+                    name: row.name,
+                    appliedAt: row.applied_at,
+                    checksum: row.checksum,
+                })),
+            };
+        },
+        async appendEntry(entry) {
+            await ensureTable();
+            const esc = (s) => s.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+            await db.execute(`INSERT INTO _chkit_migrations (name, applied_at, checksum, chkit_version) VALUES ('${esc(entry.name)}', '${esc(entry.appliedAt)}', '${esc(entry.checksum)}', '${esc(CLI_VERSION)}')`);
+            try {
+                await db.execute(`SYSTEM SYNC REPLICA _chkit_migrations`);
+            }
+            catch {
+                // Non-replicated or single-node setups don't support SYSTEM SYNC REPLICA.
+            }
+        },
+    };
+}
+export function createJournalStoreFromConfig(clickhouseConfig) {
+    const db = createClickHouseExecutor(clickhouseConfig);
+    return { journalStore: createJournalStore(db), db };
+}
+//# sourceMappingURL=journal-store.js.map

package/dist/bin/journal-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-store.js","sourceRoot":"","sources":["../../src/bin/journal-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAA2B,MAAM,mBAAmB,CAAA;AAIrF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAO1C,MAAM,gBAAgB,GAAG;;;;;;;+BAOM,CAAA;AAS/B,MAAM,UAAU,kBAAkB,CAAC,EAAsB;IACvD,IAAI,YAAY,GAAG,KAAK,CAAA;IAExB,KAAK,UAAU,WAAW;QACxB,IAAI,YAAY;YAAE,OAAM;QACxB,sEAAsE;QACtE,yEAAyE;QACzE,yEAAyE;QACzE,sEAAsE;QACtE,yDAAyD;QACzD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAA;YAC5D,YAAY,GAAG,IAAI,CAAA;YACnB,OAAM;QACR,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;QACD,MAAM,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;QAClC,uEAAuE;QACvE,kEAAkE;QAClE,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAA;gBAC5D,MAAK;YACP,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;YAC9C,CAAC;QACH,CAAC;QACD,YAAY,GAAG,IAAI,CAAA;IACrB,CAAC;IAED,OAAO;QACL,KAAK,CAAC,WAAW;YACf,MAAM,WAAW,EAAE,CAAA;YACnB,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAA;YAC3D,CAAC;YAAC,MAAM,CAAC;gBACP,0EAA0E;YAC5E,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CACzB,kIAAkI,CACnI,CAAA;YACD,OAAO;gBACL,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,SAAS,EAAE,GAAG,CAAC,UAAU;oBACzB,QAAQ,EAAE,GAAG,CAAC,QAAQ;iBACvB,CAAC,CAAC;aACJ,CAAA;QACH,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,KAA4B;YAC5C,MAAM,WAAW,EAAE,CAAA;YACnB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YACxE,MAAM,EAAE,CAAC,OAAO,CACd,sFAAsF,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,CACtL,CAAA;YACD,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAA;YAC3D,CAAC;YAAC,MAAM,CAAC;gBACP,0EAA0E;YAC5E,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,gBAAsD;IAEtD,MAAM,EAAE,GAAG,wBAAwB,CAAC,gBAAgB,CAAC,CAAA;IACrD,OAAO,EAAE,YAAY,EAAE,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAA;AACrD,CAAC"}

package/dist/bin/json-output.d.ts

@@ -0,0 +1,8 @@
+export type Command = 'generate' | 'migrate' | 'status' | 'drift' | 'check' | 'plugin';
+export declare function printOutput(value: unknown, jsonMode: boolean): void;
+export declare function jsonPayload<T extends object>(command: Command, payload: T): T & {
+    command: Command;
+    schemaVersion: number;
+};
+export declare function emitJson<T extends object>(command: Command, payload: T): void;
+//# sourceMappingURL=json-output.d.ts.map

package/dist/bin/json-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-output.d.ts","sourceRoot":"","sources":["../../src/bin/json-output.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GACf,UAAU,GACV,SAAS,GACT,QAAQ,GACR,OAAO,GACP,OAAO,GACP,QAAQ,CAAA;AAIZ,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAQnE;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG;IAC/E,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;CACtB,CAMA;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAE7E"}

package/dist/bin/json-output.js

@@ -0,0 +1,21 @@
+const JSON_CONTRACT_VERSION = 1;
+export function printOutput(value, jsonMode) {
+    if (jsonMode) {
+        console.log(JSON.stringify(value, null, 2));
+        return;
+    }
+    if (typeof value === 'string') {
+        console.log(value);
+    }
+}
+export function jsonPayload(command, payload) {
+    return {
+        command,
+        schemaVersion: JSON_CONTRACT_VERSION,
+        ...payload,
+    };
+}
+export function emitJson(command, payload) {
+    printOutput(jsonPayload(command, payload), true);
+}
+//# sourceMappingURL=json-output.js.map

package/dist/bin/json-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-output.js","sourceRoot":"","sources":["../../src/bin/json-output.ts"],"names":[],"mappings":"AAQA,MAAM,qBAAqB,GAAG,CAAC,CAAA;AAE/B,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,QAAiB;IAC3D,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAC3C,OAAM;IACR,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACpB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAmB,OAAgB,EAAE,OAAU;IAIxE,OAAO;QACL,OAAO;QACP,aAAa,EAAE,qBAAqB;QACpC,GAAG,OAAO;KACX,CAAA;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAmB,OAAgB,EAAE,OAAU;IACrE,WAAW,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAA;AAClD,CAAC"}

package/dist/bin/lib.d.ts

@@ -0,0 +1,8 @@
+export { CLI_VERSION } from './version.js';
+export { DEFAULT_CONFIG_FILE, loadConfig, resolveDirs, writeIfMissing, } from './config.js';
+export { createJournalStore, createJournalStoreFromConfig, type JournalStore, } from './journal-store.js';
+export { checksumSQL, findChecksumMismatches, listMigrations, parseJSONOrThrow, readSnapshot, summarizePlan, type ChecksumMismatch, type MigrationJournal, type MigrationJournalEntry, } from './migration-store.js';
+export { emitJson, jsonPayload, printOutput, type Command } from './json-output.js';
+export { collectDestructiveOperationMarkers, extractMigrationOperationSummaries, extractDestructiveOperationSummaries, extractExecutableStatements, migrationContainsDangerOperation, parseOperationLine, type MigrationOperationSummary, type DestructiveOperationMarker, } from './safety-markers.js';
+export { loadSchemaDefinitions } from './schema-loader.js';
+//# sourceMappingURL=lib.d.ts.map

package/dist/bin/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/bin/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE1C,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACnF,OAAO,EACL,kCAAkC,EAClC,kCAAkC,EAClC,oCAAoC,EACpC,2BAA2B,EAC3B,gCAAgC,EAChC,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,GAChC,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/bin/lib.js

@@ -0,0 +1,8 @@
+export { CLI_VERSION } from './version.js';
+export { DEFAULT_CONFIG_FILE, loadConfig, resolveDirs, writeIfMissing, } from './config.js';
+export { createJournalStore, createJournalStoreFromConfig, } from './journal-store.js';
+export { checksumSQL, findChecksumMismatches, listMigrations, parseJSONOrThrow, readSnapshot, summarizePlan, } from './migration-store.js';
+export { emitJson, jsonPayload, printOutput } from './json-output.js';
+export { collectDestructiveOperationMarkers, extractMigrationOperationSummaries, extractDestructiveOperationSummaries, extractExecutableStatements, migrationContainsDangerOperation, parseOperationLine, } from './safety-markers.js';
+export { loadSchemaDefinitions } from './schema-loader.js';
+//# sourceMappingURL=lib.js.map