@gozzle/cli 0.0.1-canary.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gozzle
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# Gozzle
+
+A safety harness for your ClickHouse, inside your own AI.
+
+Gozzle is a local developer toolkit for ClickHouse. The AI reasons; Gozzle runs checks and produces proof.
+
+## Install
+
+For early canary builds:
+
+```bash
+npm install -g @gozzle/cli@canary
+```
+
+Then print the MCP config snippet:
+
+```bash
+gozzle init
+```
+
+Add the printed config to Claude, Cursor, Codex, or another MCP host.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## ClickHouse Connection
+
+Gozzle reads ClickHouse connection details from environment variables:
+
+```bash
+GOZZLE_CLICKHOUSE_URL=http://localhost:8123
+GOZZLE_CLICKHOUSE_USER=default
+GOZZLE_CLICKHOUSE_PASSWORD=
+GOZZLE_CLICKHOUSE_DATABASE=default
+```
+
+The `GOZZLE_` variables take precedence over the equivalent `CLICKHOUSE_` variables.
+Use a read-only ClickHouse user; Gozzle does not need write access.
+
+## Entry Points
+
+- `gozzle`: CLI entrypoint.
+- `gozzle-mcp`: MCP stdio server entrypoint.
+
+## Canary Publishing
+
+```bash
+npm login
+npm run build
+npm test
+npm publish --tag canary --access public
+```
+
+For later canaries:
+
+```bash
+npm version prerelease --preid canary
+npm publish --tag canary --access public
+```

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/cli.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { readPackageMetadata } from "./shared/package-metadata.js";
+const metadata = readPackageMetadata();
+const command = process.argv[2] ?? "help";
+if (command === "version" || command === "--version" || command === "-v") {
+    console.log(metadata.version);
+    process.exit(0);
+}
+if (command === "init") {
+    printInit();
+    process.exit(0);
+}
+console.log(`gozzle ${metadata.version}`);
+console.log("");
+console.log("Commands:");
+console.log("  gozzle init        Print MCP config for your AI host");
+console.log("  gozzle version     Print the CLI version");
+console.log("  gozzle-mcp         Start the MCP stdio server");
+function printInit() {
+    console.log("Add this MCP server config to Claude, Cursor, Codex, or another MCP host:");
+    console.log("");
+    console.log(JSON.stringify({
+        mcpServers: {
+            gozzle: {
+                command: "gozzle-mcp",
+                env: {
+                    GOZZLE_CLICKHOUSE_URL: "https://your-cluster.clickhouse.cloud:8443",
+                    GOZZLE_CLICKHOUSE_USER: "gozzle_readonly",
+                    GOZZLE_CLICKHOUSE_PASSWORD: "replace-me",
+                    GOZZLE_CLICKHOUSE_DATABASE: "default"
+                }
+            }
+        }
+    }, null, 2));
+    console.log("");
+    console.log("Use a read-only ClickHouse user. Gozzle does not need write access.");
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;AACvC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;AAE1C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,CAAC;IACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,GAAG,CAAC,UAAU,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;AAC1C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACzB,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;AACtE,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;AAC1D,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;AAE/D,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC;IACzF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;QACE,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,OAAO,EAAE,YAAY;gBACrB,GAAG,EAAE;oBACH,qBAAqB,EAAE,4CAA4C;oBACnE,sBAAsB,EAAE,iBAAiB;oBACzC,0BAA0B,EAAE,YAAY;oBACxC,0BAA0B,EAAE,SAAS;iBACtC;aACF;SACF;KACF,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,qEAAqE,CAAC,CAAC;AACrF,CAAC"}

package/dist/src/clickhouse/client.d.ts

@@ -0,0 +1,13 @@
+import type { ClickHouseConnectionConfig } from "../config/clickhouse.js";
+export interface ClickHouseMetadataClient {
+    ping(): Promise<boolean>;
+    queryJson<T>(query: string): Promise<T[]>;
+    close(): Promise<void>;
+}
+export declare class ClickHouseHttpMetadataClient implements ClickHouseMetadataClient {
+    private readonly client;
+    constructor(config: ClickHouseConnectionConfig);
+    ping(): Promise<boolean>;
+    queryJson<T>(query: string): Promise<T[]>;
+    close(): Promise<void>;
+}

package/dist/src/clickhouse/client.js

@@ -0,0 +1,27 @@
+import { createClient } from "@clickhouse/client";
+export class ClickHouseHttpMetadataClient {
+    client;
+    constructor(config) {
+        this.client = createClient({
+            url: config.url,
+            username: config.username,
+            password: config.password,
+            database: config.database
+        });
+    }
+    async ping() {
+        const result = await this.client.ping();
+        return result.success;
+    }
+    async queryJson(query) {
+        const resultSet = await this.client.query({
+            query,
+            format: "JSONEachRow"
+        });
+        return (await resultSet.json());
+    }
+    async close() {
+        await this.client.close();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/clickhouse/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/clickhouse/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AAUzE,MAAM,OAAO,4BAA4B;IACtB,MAAM,CAAmB;IAE1C,YAAY,MAAkC;QAC5C,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;YACzB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACxC,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,SAAS,CAAI,KAAa;QAC9B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YACxC,KAAK;YACL,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAQ,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/src/clickhouse/identifier.d.ts

@@ -0,0 +1,12 @@
+export interface TableIdentifier {
+    database?: string;
+    table: string;
+}
+export interface ResolvedTableIdentifier {
+    database: string;
+    table: string;
+}
+export declare function parseTableIdentifier(input: string): TableIdentifier;
+export declare function resolveTableIdentifier(identifier: TableIdentifier, defaultDatabase: string): ResolvedTableIdentifier;
+export declare function quoteIdentifier(identifier: string): string;
+export declare function formatTableIdentifier(identifier: ResolvedTableIdentifier): string;

package/dist/src/clickhouse/identifier.js

@@ -0,0 +1,38 @@
+const IDENTIFIER_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+export function parseTableIdentifier(input) {
+    const trimmed = input.trim();
+    if (trimmed === "") {
+        throw new Error("Table name is required.");
+    }
+    const parts = trimmed.split(".");
+    if (parts.length > 2) {
+        throw new Error("Use table or database.table format.");
+    }
+    const [database, table] = parts.length === 2 ? parts : [undefined, parts[0]];
+    if (database !== undefined) {
+        validateIdentifierPart(database, "database");
+    }
+    validateIdentifierPart(table, "table");
+    return {
+        database,
+        table
+    };
+}
+export function resolveTableIdentifier(identifier, defaultDatabase) {
+    return {
+        database: identifier.database ?? defaultDatabase,
+        table: identifier.table
+    };
+}
+export function quoteIdentifier(identifier) {
+    return `\`${identifier.replaceAll("`", "``")}\``;
+}
+export function formatTableIdentifier(identifier) {
+    return `${quoteIdentifier(identifier.database)}.${quoteIdentifier(identifier.table)}`;
+}
+function validateIdentifierPart(value, label) {
+    if (!IDENTIFIER_PATTERN.test(value)) {
+        throw new Error(`Invalid ${label} identifier "${value}". Use an unquoted ClickHouse identifier.`);
+    }
+}
+//# sourceMappingURL=identifier.js.map

package/dist/src/clickhouse/identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.js","sourceRoot":"","sources":["../../../src/clickhouse/identifier.ts"],"names":[],"mappings":"AAUA,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAEtD,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEjC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7E,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,sBAAsB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;IAED,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAEvC,OAAO;QACL,QAAQ;QACR,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,UAA2B,EAC3B,eAAuB;IAEvB,OAAO;QACL,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,eAAe;QAChD,KAAK,EAAE,UAAU,CAAC,KAAK;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,OAAO,KAAK,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAAmC;IACvE,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,eAAe,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;AACxF,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa,EAAE,KAAa;IAC1D,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,WAAW,KAAK,gBAAgB,KAAK,2CAA2C,CACjF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/clickhouse/introspection.d.ts

@@ -0,0 +1,15 @@
+import type { ClickHouseConnectionConfig } from "../config/clickhouse.js";
+import type { ClickHouseMetadataClient } from "./client.js";
+export interface ClickHouseConnectionInfo {
+    connected: true;
+    version: string;
+    database: string;
+    currentUser: string;
+    hostName: string;
+    deployment: "cloud" | "self_hosted_or_unknown";
+    readonlySetting?: string;
+    writePrivileges: string[];
+    warnings: string[];
+}
+export declare function inspectClickHouseConnection(client: ClickHouseMetadataClient, config: ClickHouseConnectionConfig): Promise<ClickHouseConnectionInfo>;
+export declare function detectDeployment(url: string): ClickHouseConnectionInfo["deployment"];

package/dist/src/clickhouse/introspection.js

@@ -0,0 +1,88 @@
+const WRITE_PRIVILEGES = new Set([
+    "INSERT",
+    "ALTER",
+    "CREATE",
+    "DROP",
+    "TRUNCATE",
+    "OPTIMIZE",
+    "SYSTEM",
+    "KILL QUERY"
+]);
+export async function inspectClickHouseConnection(client, config) {
+    const pingOk = await client.ping();
+    if (!pingOk) {
+        throw new Error("ClickHouse ping failed.");
+    }
+    const [serverInfo] = await client.queryJson(`
+    SELECT
+      version() AS version,
+      currentDatabase() AS database,
+      currentUser() AS current_user,
+      hostName() AS host_name
+  `);
+    if (!serverInfo) {
+        throw new Error("ClickHouse did not return server metadata.");
+    }
+    const warnings = [];
+    const readonlySetting = await readReadonlySetting(client, warnings);
+    const writePrivileges = await readWritePrivileges(client, warnings);
+    if (readonlySetting !== undefined && readonlySetting !== "1") {
+        warnings.push("Session readonly setting is not enabled. Use a read-only ClickHouse user for Gozzle.");
+    }
+    if (writePrivileges.length > 0) {
+        warnings.push(`Connected user appears to have write-capable grants: ${writePrivileges.join(", ")}. Gozzle only needs read-only access.`);
+    }
+    return {
+        connected: true,
+        version: String(serverInfo.version),
+        database: serverInfo.database,
+        currentUser: serverInfo.current_user,
+        hostName: serverInfo.host_name,
+        deployment: detectDeployment(config.url),
+        readonlySetting,
+        writePrivileges,
+        warnings
+    };
+}
+export function detectDeployment(url) {
+    const hostname = new URL(url).hostname;
+    return hostname.endsWith(".clickhouse.cloud")
+        ? "cloud"
+        : "self_hosted_or_unknown";
+}
+async function readReadonlySetting(client, warnings) {
+    try {
+        const [row] = await client.queryJson(`
+      SELECT value
+      FROM system.settings
+      WHERE name = 'readonly'
+      LIMIT 1
+    `);
+        return row ? String(row.value) : undefined;
+    }
+    catch (error) {
+        warnings.push(`Could not inspect readonly setting: ${formatErrorMessage(error)}`);
+        return undefined;
+    }
+}
+async function readWritePrivileges(client, warnings) {
+    try {
+        const rows = await client.queryJson(`
+      SELECT DISTINCT access_type
+      FROM system.grants
+      WHERE user_name = currentUser()
+      ORDER BY access_type
+    `);
+        return rows
+            .map((row) => row.access_type)
+            .filter((accessType) => WRITE_PRIVILEGES.has(accessType));
+    }
+    catch (error) {
+        warnings.push(`Could not inspect grants: ${formatErrorMessage(error)}`);
+        return [];
+    }
+}
+function formatErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=introspection.js.map

package/dist/src/clickhouse/introspection.js.map

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

package/dist/src/clickhouse/table-inspection.d.ts

@@ -0,0 +1,48 @@
+import type { ClickHouseMetadataClient } from "./client.js";
+import { type ResolvedTableIdentifier } from "./identifier.js";
+export interface TableInspectionOptions {
+    table: string;
+    defaultDatabase: string;
+}
+export interface TableColumn {
+    name: string;
+    type: string;
+    defaultKind?: string;
+    defaultExpression?: string;
+    codecExpression?: string;
+}
+export interface TablePartsSummary {
+    activeParts: number;
+    rows: number;
+    bytesOnDisk: number;
+    partitions: number;
+}
+export interface ReplacingMergeTreeDetails {
+    versionColumn?: string;
+    deletedColumn?: string;
+}
+export interface TableInspection {
+    identifier: ResolvedTableIdentifier;
+    engine: string;
+    engineFull: string;
+    createStatement: string;
+    orderBy?: string;
+    partitionBy?: string;
+    primaryKey?: string;
+    sortingKey?: string;
+    totalRows: number;
+    totalBytes: number;
+    isDistributed: boolean;
+    isReplacingMergeTree: boolean;
+    replacingMergeTree?: ReplacingMergeTreeDetails;
+    columns: TableColumn[];
+    parts: TablePartsSummary;
+    eligibleChecks: {
+        verifyDedup: boolean;
+        dryRunMigration: boolean;
+        diagnoseQuery: boolean;
+    };
+    warnings: string[];
+}
+export declare function inspectTable(client: ClickHouseMetadataClient, options: TableInspectionOptions): Promise<TableInspection>;
+export declare function extractClause(createStatement: string, clauseName: "ORDER BY" | "PARTITION BY"): string | undefined;

package/dist/src/clickhouse/table-inspection.js

@@ -0,0 +1,162 @@
+import { formatTableIdentifier, parseTableIdentifier, resolveTableIdentifier } from "./identifier.js";
+export async function inspectTable(client, options) {
+    const identifier = resolveTableIdentifier(parseTableIdentifier(options.table), options.defaultDatabase);
+    const fullTableName = formatTableIdentifier(identifier);
+    const databaseLiteral = quoteStringLiteral(identifier.database);
+    const tableLiteral = quoteStringLiteral(identifier.table);
+    const [showCreateRows, tableRows, columns, partsRows] = await Promise.all([
+        client.queryJson(`SHOW CREATE TABLE ${fullTableName}`),
+        client.queryJson(`
+      SELECT
+        engine,
+        engine_full,
+        sorting_key,
+        primary_key,
+        partition_key,
+        total_rows,
+        total_bytes
+      FROM system.tables
+      WHERE database = ${databaseLiteral}
+        AND name = ${tableLiteral}
+      LIMIT 1
+    `),
+        client.queryJson(`
+      SELECT
+        name,
+        type,
+        default_kind,
+        default_expression,
+        codec_expression
+      FROM system.columns
+      WHERE database = ${databaseLiteral}
+        AND table = ${tableLiteral}
+      ORDER BY position
+    `),
+        client.queryJson(`
+      SELECT
+        count() AS active_parts,
+        sum(rows) AS rows,
+        sum(bytes_on_disk) AS bytes_on_disk,
+        uniqExact(partition) AS partitions
+      FROM system.parts
+      WHERE database = ${databaseLiteral}
+        AND table = ${tableLiteral}
+        AND active
+    `)
+    ]);
+    const [showCreate] = showCreateRows;
+    const [table] = tableRows;
+    const [parts] = partsRows;
+    if (!table) {
+        throw new Error(`Table not found: ${identifier.database}.${identifier.table}`);
+    }
+    const createStatement = showCreate?.statement ?? "";
+    const engineFull = table.engine_full || table.engine;
+    const isReplacingMergeTree = table.engine.includes("ReplacingMergeTree");
+    const isDistributed = table.engine === "Distributed";
+    const warnings = buildWarnings(table.engine, isReplacingMergeTree, isDistributed);
+    const replacingMergeTree = isReplacingMergeTree
+        ? parseReplacingMergeTreeDetails(engineFull)
+        : undefined;
+    return {
+        identifier,
+        engine: table.engine,
+        engineFull,
+        createStatement,
+        orderBy: extractClause(createStatement, "ORDER BY"),
+        partitionBy: extractClause(createStatement, "PARTITION BY"),
+        primaryKey: normalizeOptional(table.primary_key),
+        sortingKey: normalizeOptional(table.sorting_key),
+        totalRows: toNumber(table.total_rows),
+        totalBytes: toNumber(table.total_bytes),
+        isDistributed,
+        isReplacingMergeTree,
+        replacingMergeTree,
+        columns: columns.map(toTableColumn),
+        parts: {
+            activeParts: toNumber(parts?.active_parts ?? 0),
+            rows: toNumber(parts?.rows ?? 0),
+            bytesOnDisk: toNumber(parts?.bytes_on_disk ?? 0),
+            partitions: toNumber(parts?.partitions ?? 0)
+        },
+        eligibleChecks: {
+            verifyDedup: isReplacingMergeTree && !isDistributed,
+            dryRunMigration: true,
+            diagnoseQuery: true
+        },
+        warnings
+    };
+}
+export function extractClause(createStatement, clauseName) {
+    const index = createStatement.indexOf(clauseName);
+    if (index === -1) {
+        return undefined;
+    }
+    const start = index + clauseName.length;
+    const rest = createStatement.slice(start).trim();
+    const nextClauseIndex = findNextClauseIndex(rest);
+    const rawClause = nextClauseIndex === -1 ? rest : rest.slice(0, nextClauseIndex).trim();
+    return rawClause || undefined;
+}
+function findNextClauseIndex(input) {
+    const candidates = [
+        "\nORDER BY",
+        "\nPARTITION BY",
+        "\nPRIMARY KEY",
+        "\nSAMPLE BY",
+        "\nTTL",
+        "\nSETTINGS",
+        "\nCOMMENT"
+    ];
+    const indexes = candidates
+        .map((candidate) => input.indexOf(candidate))
+        .filter((index) => index >= 0);
+    return indexes.length === 0 ? -1 : Math.min(...indexes);
+}
+function parseReplacingMergeTreeDetails(engineFull) {
+    const match = engineFull.match(/ReplacingMergeTree\s*\(([^)]*)\)/);
+    if (!match) {
+        return {};
+    }
+    const args = match[1]
+        .split(",")
+        .map((arg) => arg.trim())
+        .filter(Boolean);
+    return {
+        versionColumn: args[0],
+        deletedColumn: args[1]
+    };
+}
+function buildWarnings(engine, isReplacingMergeTree, isDistributed) {
+    const warnings = [];
+    if (isReplacingMergeTree) {
+        warnings.push("ReplacingMergeTree table: queries without FINAL may expose duplicate rows.");
+    }
+    if (isDistributed) {
+        warnings.push("Distributed table: local checks may be advisory until shard topology is inspected.");
+    }
+    if (!engine.includes("MergeTree") && !isDistributed) {
+        warnings.push(`Unsupported or uncommon table engine for MVP checks: ${engine}.`);
+    }
+    return warnings;
+}
+function toTableColumn(row) {
+    return {
+        name: row.name,
+        type: row.type,
+        defaultKind: normalizeOptional(row.default_kind),
+        defaultExpression: normalizeOptional(row.default_expression),
+        codecExpression: normalizeOptional(row.codec_expression)
+    };
+}
+function normalizeOptional(value) {
+    return value && value.trim() !== "" ? value : undefined;
+}
+function toNumber(value) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+function quoteStringLiteral(value) {
+    return `'${value.replaceAll("\\", "\\\\").replaceAll("'", "\\'")}'`;
+}
+//# sourceMappingURL=table-inspection.js.map

package/dist/src/clickhouse/table-inspection.js.map

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

package/dist/src/config/clickhouse.d.ts

@@ -0,0 +1,19 @@
+export interface ClickHouseConnectionConfig {
+    url: string;
+    username: string;
+    password: string;
+    database?: string;
+}
+export interface ClickHouseConfigEnv {
+    CLICKHOUSE_URL?: string;
+    CLICKHOUSE_USER?: string;
+    CLICKHOUSE_USERNAME?: string;
+    CLICKHOUSE_PASSWORD?: string;
+    CLICKHOUSE_DATABASE?: string;
+    GOZZLE_CLICKHOUSE_URL?: string;
+    GOZZLE_CLICKHOUSE_USER?: string;
+    GOZZLE_CLICKHOUSE_USERNAME?: string;
+    GOZZLE_CLICKHOUSE_PASSWORD?: string;
+    GOZZLE_CLICKHOUSE_DATABASE?: string;
+}
+export declare function readClickHouseConfig(env?: ClickHouseConfigEnv): ClickHouseConnectionConfig;

package/dist/src/config/clickhouse.js

@@ -0,0 +1,24 @@
+export function readClickHouseConfig(env = process.env) {
+    const url = firstNonEmpty(env.GOZZLE_CLICKHOUSE_URL, env.CLICKHOUSE_URL);
+    if (!url) {
+        throw new Error("Missing ClickHouse URL. Set GOZZLE_CLICKHOUSE_URL or CLICKHOUSE_URL.");
+    }
+    validateUrl(url);
+    return {
+        url,
+        username: firstNonEmpty(env.GOZZLE_CLICKHOUSE_USER, env.GOZZLE_CLICKHOUSE_USERNAME, env.CLICKHOUSE_USER, env.CLICKHOUSE_USERNAME) ?? "default",
+        password: firstNonEmpty(env.GOZZLE_CLICKHOUSE_PASSWORD, env.CLICKHOUSE_PASSWORD) ??
+            "",
+        database: firstNonEmpty(env.GOZZLE_CLICKHOUSE_DATABASE, env.CLICKHOUSE_DATABASE)
+    };
+}
+function firstNonEmpty(...values) {
+    return values.find((value) => value !== undefined && value.trim() !== "");
+}
+function validateUrl(url) {
+    const parsed = new URL(url);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error("ClickHouse URL must use http or https.");
+    }
+}
+//# sourceMappingURL=clickhouse.js.map

package/dist/src/config/clickhouse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse.js","sourceRoot":"","sources":["../../../src/config/clickhouse.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,oBAAoB,CAClC,MAA2B,OAAO,CAAC,GAAG;IAEtC,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,qBAAqB,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IAEzE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,GAAG,CAAC,CAAC;IAEjB,OAAO;QACL,GAAG;QACH,QAAQ,EACN,aAAa,CACX,GAAG,CAAC,sBAAsB,EAC1B,GAAG,CAAC,0BAA0B,EAC9B,GAAG,CAAC,eAAe,EACnB,GAAG,CAAC,mBAAmB,CACxB,IAAI,SAAS;QAChB,QAAQ,EACN,aAAa,CAAC,GAAG,CAAC,0BAA0B,EAAE,GAAG,CAAC,mBAAmB,CAAC;YACtE,EAAE;QACJ,QAAQ,EAAE,aAAa,CACrB,GAAG,CAAC,0BAA0B,EAC9B,GAAG,CAAC,mBAAmB,CACxB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,GAAG,MAAiC;IAEpC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAE5B,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/src/mcp/server.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createGozzleMcpServer(): McpServer;
+export declare function startMcpServer(): Promise<void>;

package/dist/src/mcp/server.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createConnectTool } from "../tools/connect.js";
+import { createHealthTool } from "../tools/health.js";
+import { createInspectTableTool } from "../tools/inspect-table.js";
+import { readPackageMetadata } from "../shared/package-metadata.js";
+export function createGozzleMcpServer() {
+    const metadata = readPackageMetadata();
+    const server = new McpServer({
+        name: "@gozzle/cli",
+        version: metadata.version
+    });
+    createHealthTool(server);
+    createConnectTool(server);
+    createInspectTableTool(server);
+    return server;
+}
+export async function startMcpServer() {
+    const server = createGozzleMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+// Resolve the entry path through symlinks: npm global bins (e.g. `gozzle-mcp`)
+// and how Claude Code launches MCP servers invoke this file via a symlink, so
+// process.argv[1] is the symlink while import.meta.url is the realpath.
+const entry = process.argv[1];
+if (entry && import.meta.url === pathToFileURL(realpathSync(entry)).href) {
+    startMcpServer().catch((error) => {
+        console.error(error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/src/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/mcp/server.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,UAAU,qBAAqB;IACnC,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;KAC1B,CAAC,CAAC;IAEH,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE/B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,+EAA+E;AAC/E,8EAA8E;AAC9E,wEAAwE;AACxE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9B,IAAI,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzE,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACxC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/shared/package-metadata.d.ts

@@ -0,0 +1,4 @@
+export interface PackageMetadata {
+    version: string;
+}
+export declare function readPackageMetadata(): PackageMetadata;

package/dist/src/shared/package-metadata.js

@@ -0,0 +1,33 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+export function readPackageMetadata() {
+    const packageJsonPath = findPackageJson(dirname(fileURLToPath(import.meta.url)));
+    if (packageJsonPath) {
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+        if (typeof packageJson.version === "string") {
+            return {
+                version: packageJson.version
+            };
+        }
+    }
+    return {
+        version: "0.0.1-canary.0"
+    };
+}
+function findPackageJson(startDirectory) {
+    let currentDirectory = startDirectory;
+    for (let index = 0; index < 5; index += 1) {
+        const candidate = join(currentDirectory, "package.json");
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+        const parentDirectory = dirname(currentDirectory);
+        if (parentDirectory === currentDirectory) {
+            return undefined;
+        }
+        currentDirectory = parentDirectory;
+    }
+    return undefined;
+}
+//# sourceMappingURL=package-metadata.js.map

package/dist/src/shared/package-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-metadata.js","sourceRoot":"","sources":["../../../src/shared/package-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAMzC,MAAM,UAAU,mBAAmB;IACjC,MAAM,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEjF,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAEnE,CAAC;QAEF,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO;gBACL,OAAO,EAAE,WAAW,CAAC,OAAO;aAC7B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,gBAAgB;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,cAAsB;IAC7C,IAAI,gBAAgB,GAAG,cAAc,CAAC;IAEtC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;QAEzD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAElD,IAAI,eAAe,KAAK,gBAAgB,EAAE,CAAC;YACzC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,gBAAgB,GAAG,eAAe,CAAC;IACrC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/tools/connect.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createConnectTool(server: McpServer): void;

package/dist/src/tools/connect.js

@@ -0,0 +1,64 @@
+import { ClickHouseHttpMetadataClient } from "../clickhouse/client.js";
+import { inspectClickHouseConnection } from "../clickhouse/introspection.js";
+import { readClickHouseConfig } from "../config/clickhouse.js";
+export function createConnectTool(server) {
+    server.registerTool("connect", {
+        title: "Connect to ClickHouse",
+        description: "Validate the configured ClickHouse connection and report read-only guardrails.",
+        inputSchema: {}
+    }, async () => {
+        let client;
+        try {
+            const config = readClickHouseConfig();
+            client = new ClickHouseHttpMetadataClient(config);
+            const info = await inspectClickHouseConnection(client, config);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatConnectionInfo(info)
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `Gozzle could not connect to ClickHouse.\n\n${formatErrorMessage(error)}`
+                    }
+                ]
+            };
+        }
+        finally {
+            await client?.close();
+        }
+    });
+}
+function formatConnectionInfo(info) {
+    const lines = [
+        "Connected read-only check complete.",
+        "No data leaves this machine.",
+        "",
+        `Version: ${info.version}`,
+        `Database: ${info.database}`,
+        `User: ${info.currentUser}`,
+        `Host: ${info.hostName}`,
+        `Deployment: ${info.deployment}`,
+        `Readonly setting: ${info.readonlySetting ?? "unknown"}`
+    ];
+    if (info.writePrivileges.length > 0) {
+        lines.push(`Write-capable grants: ${info.writePrivileges.join(", ")}`);
+    }
+    if (info.warnings.length > 0) {
+        lines.push("", "Warnings:");
+        lines.push(...info.warnings.map((warning) => `- ${warning}`));
+    }
+    return lines.join("\n");
+}
+function formatErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=connect.js.map

package/dist/src/tools/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../../src/tools/connect.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,gFAAgF;QAClF,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,IAAI,MAAgD,CAAC;QAErD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;YACtC,MAAM,GAAG,IAAI,4BAA4B,CAAC,MAAM,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,MAAM,2BAA2B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAE/D,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC;qBACjC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,8CAA8C,kBAAkB,CACpE,KAAK,CACN,EAAE;qBACJ;iBACF;aACF,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAID,SAAS,oBAAoB,CAAC,IAAoB;IAChD,MAAM,KAAK,GAAG;QACZ,qCAAqC;QACrC,8BAA8B;QAC9B,EAAE;QACF,YAAY,IAAI,CAAC,OAAO,EAAE;QAC1B,aAAa,IAAI,CAAC,QAAQ,EAAE;QAC5B,SAAS,IAAI,CAAC,WAAW,EAAE;QAC3B,SAAS,IAAI,CAAC,QAAQ,EAAE;QACxB,eAAe,IAAI,CAAC,UAAU,EAAE;QAChC,qBAAqB,IAAI,CAAC,eAAe,IAAI,SAAS,EAAE;KACzD,CAAC;IAEF,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/src/tools/health.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createHealthTool(server: McpServer): void;

package/dist/src/tools/health.js

@@ -0,0 +1,15 @@
+export function createHealthTool(server) {
+    server.registerTool("health", {
+        title: "Health Check",
+        description: "Confirm the Gozzle MCP server is running.",
+        inputSchema: {}
+    }, async () => ({
+        content: [
+            {
+                type: "text",
+                text: "Gozzle MCP server is running."
+            }
+        ]
+    }));
+}
+//# sourceMappingURL=health.js.map

package/dist/src/tools/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/tools/health.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,YAAY,CACjB,QAAQ,EACR;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,2CAA2C;QACxD,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,+BAA+B;aACtC;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/src/tools/inspect-table.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type TableInspection } from "../clickhouse/table-inspection.js";
+export declare function createInspectTableTool(server: McpServer): void;
+export declare function formatTableInspection(inspection: TableInspection): string;

package/dist/src/tools/inspect-table.js

@@ -0,0 +1,77 @@
+import { z } from "zod";
+import { ClickHouseHttpMetadataClient } from "../clickhouse/client.js";
+import { inspectTable } from "../clickhouse/table-inspection.js";
+import { readClickHouseConfig } from "../config/clickhouse.js";
+export function createInspectTableTool(server) {
+    server.registerTool("inspect_table", {
+        title: "Inspect ClickHouse Table",
+        description: "Inspect a ClickHouse table's physical layout and eligible Gozzle checks.",
+        inputSchema: {
+            table: z
+                .string()
+                .min(1)
+                .describe("Table name in table or database.table format.")
+        }
+    }, async ({ table }) => {
+        let client;
+        try {
+            const config = readClickHouseConfig();
+            client = new ClickHouseHttpMetadataClient(config);
+            const inspection = await inspectTable(client, {
+                table,
+                defaultDatabase: config.database ?? "default"
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatTableInspection(inspection)
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `Gozzle could not inspect the table.\n\n${formatErrorMessage(error)}`
+                    }
+                ]
+            };
+        }
+        finally {
+            await client?.close();
+        }
+    });
+}
+export function formatTableInspection(inspection) {
+    const lines = [
+        `Table: ${inspection.identifier.database}.${inspection.identifier.table}`,
+        `Engine: ${inspection.engineFull}`,
+        `Order by: ${inspection.orderBy ?? inspection.sortingKey ?? "none"}`,
+        `Partition by: ${inspection.partitionBy ?? "none"}`,
+        `Primary key: ${inspection.primaryKey ?? "none"}`,
+        `Active parts: ${inspection.parts.activeParts}`,
+        `Rows: ${inspection.totalRows}`,
+        `Bytes on disk: ${inspection.totalBytes}`,
+        "",
+        "Eligible checks:",
+        `- verify_dedup: ${inspection.eligibleChecks.verifyDedup ? "yes" : "no"}`,
+        `- dry_run_migration: ${inspection.eligibleChecks.dryRunMigration ? "yes" : "no"}`,
+        `- diagnose_query: ${inspection.eligibleChecks.diagnoseQuery ? "yes" : "no"}`
+    ];
+    if (inspection.replacingMergeTree) {
+        lines.push("", "ReplacingMergeTree:", `- version column: ${inspection.replacingMergeTree.versionColumn ?? "none"}`, `- deleted column: ${inspection.replacingMergeTree.deletedColumn ?? "none"}`);
+    }
+    if (inspection.warnings.length > 0) {
+        lines.push("", "Warnings:");
+        lines.push(...inspection.warnings.map((warning) => `- ${warning}`));
+    }
+    return lines.join("\n");
+}
+function formatErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=inspect-table.js.map

package/dist/src/tools/inspect-table.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@gozzle/cli",
+  "version": "0.0.1-canary.3",
+  "description": "A local safety harness and developer toolkit for ClickHouse.",
+  "type": "module",
+  "private": false,
+  "license": "MIT",
+  "bin": {
+    "gozzle": "./dist/src/cli.js",
+    "gozzle-mcp": "./dist/src/mcp/server.js"
+  },
+  "files": [
+    "dist/src",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "canary"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev:mcp": "tsx src/mcp/server.ts",
+    "dev": "tsx src/cli.ts",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build && npm test",
+    "smoke:mcp": "npm run build && node dist/scripts/mcp-smoke.js",
+    "test": "node --import tsx --test tests/**/*.test.ts"
+  },
+  "dependencies": {
+    "@clickhouse/client": "^1.21.0",
+    "@modelcontextprotocol/sdk": "^1.18.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.8.0"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}