chkit 0.1.0-beta.9 → 0.1.1

package/dist/runtime/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/runtime/global-flags.d.ts.map

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

package/dist/runtime/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/runtime/global-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-flags.js","sourceRoot":"","sources":["../../src/runtime/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/runtime/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/runtime/help.d.ts.map

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

package/dist/runtime/help.js

@@ -0,0 +1,94 @@
+const DOCS_URL = 'https://chkit.obsessiondb.com/';
+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`);
+    lines.push(`  ${'skills'.padEnd(14)} Manage agent skills (proxies to the \`skills\` CLI)`);
+    const coreCommands = registry.commands.filter((c) => c.pluginName === 'core');
+    const pluginCommands = registry.commands.filter((c) => c.pluginName !== 'core');
+    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' }));
+    appendDocsHelp(lines);
+    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));
+    }
+    appendDocsHelp(lines);
+    return lines.join('\n');
+}
+function appendDocsHelp(lines) {
+    lines.push('');
+    lines.push('Documentation:');
+    lines.push(`  Full documentation: ${DOCS_URL}`);
+    lines.push('  Agent-readable markdown: fetch any docs page with Accept: text/markdown');
+}
+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/runtime/help.js.map

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

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

@@ -0,0 +1,31 @@
+import { type ClickHouseExecutor } from '@chkit/clickhouse';
+import type { MigrationJournal, MigrationJournalEntry } from './migration-store.js';
+export type OperationStatus = 'started' | 'completed' | 'failed';
+export interface OperationState {
+    operationIndex: number;
+    operationKey: string;
+    operationType: string;
+    queryId: string;
+    status: OperationStatus;
+    startedAt: string;
+    finishedAt: string | null;
+    lastError: string;
+}
+export interface MigrationRowState {
+    name: string;
+    appliedAt: string;
+    checksum: string;
+    chkitVersion: string;
+    migrationCompleted: boolean;
+    operations: OperationState[];
+}
+export interface JournalStore {
+    readJournal(): Promise<MigrationJournal>;
+    readMigrationState(migrationName: string): Promise<MigrationRowState | null>;
+    writeMigrationState(state: MigrationRowState): Promise<void>;
+    appendEntry(entry: MigrationJournalEntry): Promise<void>;
+    readonly databaseMissing: boolean;
+}
+export declare function resolveJournalTableName(): string;
+export declare function createJournalStore(db: ClickHouseExecutor, cluster?: string): JournalStore;
+//# sourceMappingURL=journal-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"journal-store.d.ts","sourceRoot":"","sources":["../../src/runtime/journal-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAGnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAInF,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAA;AAEhE,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,eAAe,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,UAAU,EAAE,cAAc,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACxC,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IAC5E,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,WAAW,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAClC;AAID,wBAAgB,uBAAuB,IAAI,MAAM,CAShD;AAgGD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,CAkLzF"}

package/dist/runtime/journal-store.js

@@ -0,0 +1,250 @@
+import { isUnknownDatabaseError } from '@chkit/clickhouse';
+import { onClusterClause } from '@chkit/core';
+import { CLI_VERSION } from './version.js';
+import { debug } from './debug.js';
+const DEFAULT_JOURNAL_TABLE = '_chkit_migrations';
+export function resolveJournalTableName() {
+    const candidate = process.env.CHKIT_JOURNAL_TABLE?.trim();
+    if (!candidate)
+        return DEFAULT_JOURNAL_TABLE;
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(candidate)) {
+        throw new Error(`Invalid CHKIT_JOURNAL_TABLE "${candidate}". Expected unquoted identifier matching [A-Za-z_][A-Za-z0-9_]*`);
+    }
+    return candidate;
+}
+const OPERATIONS_TUPLE_TYPE = 'Array(Tuple(operation_index Int32, operation_key String, operation_type String, query_id String, status LowCardinality(String), started_at DateTime64(3, \'UTC\'), finished_at Nullable(DateTime64(3, \'UTC\')), last_error String))';
+function isRetryableInsertRace(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message;
+    return message.includes('INSERT race condition') || message.includes('Please retry the INSERT');
+}
+function escapeSqlString(value) {
+    return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+function operationToTupleLiteral(op) {
+    const parts = [
+        String(op.operationIndex),
+        `'${escapeSqlString(op.operationKey)}'`,
+        `'${escapeSqlString(op.operationType)}'`,
+        `'${escapeSqlString(op.queryId)}'`,
+        `'${escapeSqlString(op.status)}'`,
+        `'${escapeSqlString(op.startedAt)}'`,
+        op.finishedAt === null ? 'NULL' : `'${escapeSqlString(op.finishedAt)}'`,
+        `'${escapeSqlString(op.lastError)}'`,
+    ];
+    return `(${parts.join(',')})`;
+}
+function operationsArrayLiteral(operations) {
+    if (operations.length === 0)
+        return '[]';
+    return `[${operations.map(operationToTupleLiteral).join(',')}]`;
+}
+function operationFromTuple(row) {
+    return {
+        operationIndex: Number(row.operation_index),
+        operationKey: row.operation_key,
+        operationType: row.operation_type,
+        queryId: row.query_id,
+        status: row.status,
+        startedAt: row.started_at,
+        finishedAt: row.finished_at,
+        lastError: row.last_error,
+    };
+}
+// The native ClickHouse client returns a JS boolean; the ObsessionDB workbench
+// API returns every cell as a string ("true"/"false"). Compare explicitly —
+// `Boolean("false")` is `true`, which would silently corrupt the read.
+function parseBool(value) {
+    return value === true || value === 1 || value === '1' || value === 'true';
+}
+// `operations` is selected via `toJSONString(...)`, so it arrives as a JSON
+// string from every executor. Tolerate an already-decoded array too (mocks /
+// any future typed executor) and degrade to [] on anything unparseable.
+function parseOperations(value) {
+    if (value == null || value === '')
+        return [];
+    let decoded = value;
+    if (typeof value === 'string') {
+        try {
+            decoded = JSON.parse(value);
+        }
+        catch {
+            return [];
+        }
+    }
+    if (!Array.isArray(decoded))
+        return [];
+    return decoded.map((row) => operationFromTuple(row));
+}
+export function createJournalStore(db, cluster) {
+    const journalTable = resolveJournalTableName();
+    debug('journal', `journal table: ${journalTable}${process.env.CHKIT_JOURNAL_TABLE ? ' (from CHKIT_JOURNAL_TABLE)' : ''}${cluster ? ` (ON CLUSTER ${cluster})` : ''}`);
+    // In cluster mode the journal must be consistent across every node, so it uses
+    // a replicated engine with a no-`{shard}` Keeper path (one cluster-wide group)
+    // created `ON CLUSTER`. `{uuid}` is minted once per CREATE and propagated to
+    // all nodes by ON CLUSTER, so a dropped journal's stale Keeper entries can
+    // never collide with a recreate (REPLICA_ALREADY_EXISTS). The replica id is
+    // `{shard}_{replica}` rather than bare `{replica}`: because the path omits
+    // `{shard}`, all nodes across all shards share it, so the replica name must be
+    // unique cluster-wide — per-shard `{replica}` naming (the common multi-shard
+    // layout) would otherwise collide. The read path already uses SYNC REPLICA +
+    // FINAL + sequential consistency. Single-node/Cloud keeps the plain engine.
+    const onCluster = onClusterClause(cluster);
+    const journalEngine = cluster
+        ? "ReplicatedReplacingMergeTree('/clickhouse/tables/{uuid}/chkit_journal', '{shard}_{replica}', applied_at)"
+        : 'ReplacingMergeTree(applied_at)';
+    const createTableSql = `CREATE TABLE IF NOT EXISTS ${journalTable}${onCluster} (
+    name String,
+    applied_at DateTime64(3, 'UTC'),
+    checksum String,
+    chkit_version String,
+    migration_completed Bool DEFAULT true,
+    operations ${OPERATIONS_TUPLE_TYPE} DEFAULT []
+) ENGINE = ${journalEngine}
+ORDER BY (name)
+SETTINGS index_granularity = 1`;
+    let bootstrapped = false;
+    let _databaseMissing = false;
+    async function ensureTable() {
+        if (bootstrapped)
+            return;
+        debug('journal', `probing journal table "${journalTable}"`);
+        try {
+            await db.query(`SELECT name FROM ${journalTable} LIMIT 0`);
+            debug('journal', 'journal table exists — checking schema');
+            await ensureSchemaUpgraded();
+            bootstrapped = true;
+            return;
+        }
+        catch (error) {
+            if (isUnknownDatabaseError(error)) {
+                debug('journal', 'database does not exist');
+                _databaseMissing = true;
+                bootstrapped = true;
+                return;
+            }
+        }
+        debug('journal', 'creating journal table');
+        try {
+            await db.command(createTableSql);
+        }
+        catch (error) {
+            if (isUnknownDatabaseError(error)) {
+                debug('journal', 'database missing on CREATE — deferring');
+                _databaseMissing = true;
+                bootstrapped = true;
+                return;
+            }
+            throw error;
+        }
+        for (let attempt = 0; attempt < 10; attempt++) {
+            try {
+                await db.query(`SELECT name FROM ${journalTable} LIMIT 0`);
+                debug('journal', `DDL propagation confirmed (attempt ${attempt + 1})`);
+                break;
+            }
+            catch {
+                await new Promise((r) => setTimeout(r, 250));
+            }
+        }
+        bootstrapped = true;
+    }
+    async function ensureSchemaUpgraded() {
+        // Pre-existing journal tables predate per-operation tracking. Add the
+        // columns idempotently so older deployments pick them up on first run
+        // of the new chkit. ALTER ADD COLUMN IF NOT EXISTS is a metadata op,
+        // no data rewrite.
+        await db.command(`ALTER TABLE ${journalTable}${onCluster} ADD COLUMN IF NOT EXISTS migration_completed Bool DEFAULT true`);
+        await db.command(`ALTER TABLE ${journalTable}${onCluster} ADD COLUMN IF NOT EXISTS operations ${OPERATIONS_TUPLE_TYPE} DEFAULT []`);
+    }
+    async function trySyncReplica() {
+        try {
+            await db.command(`SYSTEM SYNC REPLICA ${journalTable}`);
+        }
+        catch {
+            // Non-replicated or single-node setups don't support SYSTEM SYNC REPLICA.
+        }
+    }
+    return {
+        get databaseMissing() {
+            return _databaseMissing;
+        },
+        async readJournal() {
+            debug('journal', 'reading journal');
+            await ensureTable();
+            if (_databaseMissing) {
+                debug('journal', 'database missing — returning empty journal');
+                return { version: 1, applied: [] };
+            }
+            await trySyncReplica();
+            const rows = await db.query(`SELECT name, applied_at, checksum, chkit_version FROM ${journalTable} FINAL WHERE migration_completed = true ORDER BY name SETTINGS select_sequential_consistency = 1`);
+            debug('journal', `journal has ${rows.length} applied entries`);
+            return {
+                version: 1,
+                applied: rows.map((row) => ({
+                    name: row.name,
+                    appliedAt: row.applied_at,
+                    checksum: row.checksum,
+                })),
+            };
+        },
+        async readMigrationState(migrationName) {
+            await ensureTable();
+            if (_databaseMissing)
+                return null;
+            await trySyncReplica();
+            const rows = await db.query(`SELECT name, applied_at, checksum, chkit_version, migration_completed, toJSONString(operations) AS operations FROM ${journalTable} FINAL WHERE name = '${escapeSqlString(migrationName)}' LIMIT 1 SETTINGS select_sequential_consistency = 1`);
+            const row = rows[0];
+            if (!row)
+                return null;
+            return {
+                name: row.name,
+                appliedAt: row.applied_at,
+                checksum: row.checksum,
+                chkitVersion: row.chkit_version,
+                migrationCompleted: parseBool(row.migration_completed),
+                operations: parseOperations(row.operations),
+            };
+        },
+        async writeMigrationState(state) {
+            if (_databaseMissing) {
+                debug('journal', 'resetting databaseMissing flag — migration may have created the database');
+                _databaseMissing = false;
+                bootstrapped = false;
+            }
+            await ensureTable();
+            const insertSql = `INSERT INTO ${journalTable} (name, applied_at, checksum, chkit_version, migration_completed, operations) VALUES ('${escapeSqlString(state.name)}', '${escapeSqlString(state.appliedAt)}', '${escapeSqlString(state.checksum)}', '${escapeSqlString(state.chkitVersion || CLI_VERSION)}', ${state.migrationCompleted ? 'true' : 'false'}, ${operationsArrayLiteral(state.operations)})`;
+            const maxAttempts = 5;
+            for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+                try {
+                    await db.command(insertSql);
+                    break;
+                }
+                catch (error) {
+                    if (!isRetryableInsertRace(error) || attempt === maxAttempts) {
+                        throw error;
+                    }
+                    debug('journal', `insert race detected — retrying (attempt ${attempt}/${maxAttempts})`);
+                    await new Promise((r) => setTimeout(r, attempt * 150));
+                }
+            }
+            await trySyncReplica();
+        },
+        async appendEntry(entry) {
+            debug('journal', `appending entry: ${entry.name} (checksum: ${entry.checksum})`);
+            // Preserve any per-operation history that async statements wrote
+            // earlier in this migration's apply — we just flip migrationCompleted.
+            const existing = await this.readMigrationState(entry.name);
+            await this.writeMigrationState({
+                name: entry.name,
+                appliedAt: entry.appliedAt,
+                checksum: entry.checksum,
+                chkitVersion: CLI_VERSION,
+                migrationCompleted: true,
+                operations: existing?.operations ?? [],
+            });
+        },
+    };
+}
+//# sourceMappingURL=journal-store.js.map

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

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

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

@@ -0,0 +1,25 @@
+type Command = 'generate' | 'migrate' | 'status' | 'drift' | 'check' | 'plugin' | 'query';
+/** Whether any JSON payload (success or error) has already been written to stdout. */
+export declare function hasEmittedJson(): boolean;
+export declare function printOutput(value: unknown, jsonMode: boolean): void;
+export declare function emitJson<T extends object>(command: Command, payload: T): void;
+export interface JsonError {
+    code: string;
+    message: string;
+    hint?: string;
+}
+export interface JsonErrorEnvelope {
+    command: string;
+    schemaVersion: number;
+    ok: false;
+    error: JsonError;
+}
+export declare function buildJsonErrorEnvelope(command: string, error: JsonError): JsonErrorEnvelope;
+/**
+ * Emit a stable machine-readable error envelope to stdout for `--json` consumers.
+ * Without this, a thrown error left stdout empty and printed plain text to
+ * stderr, breaking any pipe to `jq` on the first failure.
+ */
+export declare function emitJsonError(command: string, error: JsonError): void;
+export {};
+//# sourceMappingURL=json-output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json-output.d.ts","sourceRoot":"","sources":["../../src/runtime/json-output.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GACR,UAAU,GACV,SAAS,GACT,QAAQ,GACR,OAAO,GACP,OAAO,GACP,QAAQ,GACR,OAAO,CAAA;AAMX,sFAAsF;AACtF,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAgBnE;AAaD,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAE7E;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,EAAE,EAAE,KAAK,CAAA;IACT,KAAK,EAAE,SAAS,CAAA;CACjB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,iBAAiB,CAO3F;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAGrE"}

package/dist/runtime/json-output.js

@@ -0,0 +1,50 @@
+const JSON_CONTRACT_VERSION = 1;
+let jsonEmitted = false;
+/** Whether any JSON payload (success or error) has already been written to stdout. */
+export function hasEmittedJson() {
+    return jsonEmitted;
+}
+export function printOutput(value, jsonMode) {
+    if (jsonMode) {
+        jsonEmitted = true;
+        // Catch-all: never emit a bare JSON string. A command that prints a plain
+        // string under `--json` (e.g. a status line) is wrapped in a minimal object
+        // so the output is always a parseable object for `jq` consumers.
+        const payload = typeof value === 'string'
+            ? { schemaVersion: JSON_CONTRACT_VERSION, message: value }
+            : value;
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+    }
+    if (typeof value === 'string') {
+        console.log(value);
+    }
+}
+function jsonPayload(command, payload) {
+    return {
+        command,
+        schemaVersion: JSON_CONTRACT_VERSION,
+        ...payload,
+    };
+}
+export function emitJson(command, payload) {
+    printOutput(jsonPayload(command, payload), true);
+}
+export function buildJsonErrorEnvelope(command, error) {
+    return {
+        command,
+        schemaVersion: JSON_CONTRACT_VERSION,
+        ok: false,
+        error,
+    };
+}
+/**
+ * Emit a stable machine-readable error envelope to stdout for `--json` consumers.
+ * Without this, a thrown error left stdout empty and printed plain text to
+ * stderr, breaking any pipe to `jq` on the first failure.
+ */
+export function emitJsonError(command, error) {
+    jsonEmitted = true;
+    console.log(JSON.stringify(buildJsonErrorEnvelope(command, error), null, 2));
+}
+//# sourceMappingURL=json-output.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json-output.js","sourceRoot":"","sources":["../../src/runtime/json-output.ts"],"names":[],"mappings":"AASA,MAAM,qBAAqB,GAAG,CAAC,CAAA;AAE/B,IAAI,WAAW,GAAG,KAAK,CAAA;AAEvB,sFAAsF;AACtF,MAAM,UAAU,cAAc;IAC5B,OAAO,WAAW,CAAA;AACpB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,QAAiB;IAC3D,IAAI,QAAQ,EAAE,CAAC;QACb,WAAW,GAAG,IAAI,CAAA;QAClB,0EAA0E;QAC1E,4EAA4E;QAC5E,iEAAiE;QACjE,MAAM,OAAO,GACX,OAAO,KAAK,KAAK,QAAQ;YACvB,CAAC,CAAC,EAAE,aAAa,EAAE,qBAAqB,EAAE,OAAO,EAAE,KAAK,EAAE;YAC1D,CAAC,CAAC,KAAK,CAAA;QACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAC7C,OAAM;IACR,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACpB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAmB,OAAgB,EAAE,OAAU;IAIjE,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;AAeD,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,KAAgB;IACtE,OAAO;QACL,OAAO;QACP,aAAa,EAAE,qBAAqB;QACpC,EAAE,EAAE,KAAK;QACT,KAAK;KACN,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,KAAgB;IAC7D,WAAW,GAAG,IAAI,CAAA;IAClB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AAC9E,CAAC"}

package/dist/runtime/logging.d.ts

@@ -0,0 +1,3 @@
+export declare function configureCliLogging(): void;
+export declare function isDebugEnabled(): boolean;
+//# sourceMappingURL=logging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/runtime/logging.ts"],"names":[],"mappings":"AAMA,wBAAgB,mBAAmB,IAAI,IAAI,CAuB1C;AAED,wBAAgB,cAAc,IAAI,OAAO,CAExC"}

package/dist/runtime/logging.js

@@ -0,0 +1,31 @@
+import process from 'node:process';
+import { configureSync, getConfig, getConsoleSink, getTextFormatter } from '@logtape/logtape';
+const enabled = process.env.CHKIT_DEBUG === '1' || process.env.CHKIT_DEBUG === 'true';
+export function configureCliLogging() {
+    if (!enabled || getConfig())
+        return;
+    configureSync({
+        sinks: {
+            console: getConsoleSink({
+                formatter: getTextFormatter({ timestamp: 'time' }),
+            }),
+        },
+        loggers: [
+            {
+                category: 'chkit',
+                sinks: ['console'],
+                lowestLevel: 'debug',
+            },
+            {
+                category: 'logtape',
+                sinks: ['console'],
+                lowestLevel: 'error',
+            },
+        ],
+        reset: true,
+    });
+}
+export function isDebugEnabled() {
+    return enabled;
+}
+//# sourceMappingURL=logging.js.map

package/dist/runtime/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/runtime/logging.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAA;AAElC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE7F,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,CAAA;AAErF,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC,OAAO,IAAI,SAAS,EAAE;QAAE,OAAM;IAEnC,aAAa,CAAC;QACZ,KAAK,EAAE;YACL,OAAO,EAAE,cAAc,CAAC;gBACtB,SAAS,EAAE,gBAAgB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;aACnD,CAAC;SACH;QACD,OAAO,EAAE;YACP;gBACE,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,CAAC,SAAS,CAAC;gBAClB,WAAW,EAAE,OAAO;aACrB;YACD;gBACE,QAAQ,EAAE,SAAS;gBACnB,KAAK,EAAE,CAAC,SAAS,CAAC;gBAClB,WAAW,EAAE,OAAO;aACrB;SACF;QACD,KAAK,EAAE,IAAI;KACZ,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/runtime/migration-metadata.d.ts

@@ -0,0 +1,5 @@
+export interface MigrationMetadata {
+    log?: string;
+}
+export declare function extractMigrationMetadata(sql: string): MigrationMetadata;
+//# sourceMappingURL=migration-metadata.d.ts.map

package/dist/runtime/migration-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-metadata.d.ts","sourceRoot":"","sources":["../../src/runtime/migration-metadata.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAMD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAgBvE"}

package/dist/runtime/migration-metadata.js

@@ -0,0 +1,29 @@
+const KNOWN_KEYS = new Set(['log']);
+const META_LINE = /^--\s*([a-z][a-z0-9-]*)\s*:\s*(.+)$/i;
+export function extractMigrationMetadata(sql) {
+    const meta = {};
+    for (const rawLine of sql.split('\n')) {
+        const line = rawLine.trim();
+        if (line === '')
+            continue;
+        if (!line.startsWith('--'))
+            break;
+        const match = line.match(META_LINE);
+        if (!match)
+            continue;
+        const key = match[1]?.toLowerCase();
+        const value = match[2]?.trim();
+        if (!key || !value)
+            continue;
+        if (!isKnownKey(key))
+            continue;
+        if (meta[key] !== undefined)
+            continue;
+        meta[key] = value;
+    }
+    return meta;
+}
+function isKnownKey(key) {
+    return KNOWN_KEYS.has(key);
+}
+//# sourceMappingURL=migration-metadata.js.map

package/dist/runtime/migration-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-metadata.js","sourceRoot":"","sources":["../../src/runtime/migration-metadata.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,GAAG,IAAI,GAAG,CAA0B,CAAC,KAAK,CAAC,CAAC,CAAA;AAE5D,MAAM,SAAS,GAAG,sCAAsC,CAAA;AAExD,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,MAAM,IAAI,GAAsB,EAAE,CAAA;IAClC,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;QAC3B,IAAI,IAAI,KAAK,EAAE;YAAE,SAAQ;QACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAK;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACnC,IAAI,CAAC,KAAK;YAAE,SAAQ;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAA;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAA;QAC9B,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK;YAAE,SAAQ;QAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAQ;QAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,SAAQ;QACrC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACnB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,UAAU,CAAC,GAAG,CAAC,GAA8B,CAAC,CAAA;AACvD,CAAC"}