codesift-mcp 0.9.5 → 0.10.0

package/dist/register-tool-groups/shared.d.ts

@@ -0,0 +1,156 @@
+import { z } from "zod";
+import type { AuditScanResult } from "../tools/audit-tools.js";
+export { z };
+/** Boolean that also accepts "true"/"false" strings (LLMs often send strings instead of booleans) */
+export declare const zBool: () => z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodPipe<z.ZodString, z.ZodTransform<boolean, string>>]>>;
+export declare const zFiniteNumber: z.ZodNumber;
+/** Coerce string->number for numeric params while rejecting NaN/empty strings. */
+export declare const zNum: () => z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>, z.ZodNumber>]>>;
+type ToolSchemaShape = Record<string, z.ZodTypeAny>;
+export declare function lazySchema(factory: () => ToolSchemaShape): ToolSchemaShape;
+export type ToolCategory = "indexing" | "search" | "outline" | "symbols" | "graph" | "lsp" | "architecture" | "context" | "diff" | "analysis" | "patterns" | "conversations" | "security" | "reporting" | "cross-repo" | "nestjs" | "navigation" | "session" | "meta" | "discovery";
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    schema: Record<string, z.ZodTypeAny>;
+    handler: (args: Record<string, unknown>) => Promise<unknown>;
+    /** Category for tool discovery grouping */
+    category?: ToolCategory;
+    /** Keywords for discover_tools search — helps LLM find the right tool */
+    searchHint?: string;
+    /** Output schema for structured validation and documentation (optional) */
+    outputSchema?: z.ZodTypeAny;
+    /**
+     * Language gate: this tool is only enabled when the project contains
+     * files of the given language. E.g. "python" disables the tool when
+     * no .py files exist. Checked at server startup against process.cwd().
+     */
+    requiresLanguage?: "python" | "php" | "kotlin";
+    /**
+     * Opt-in response memoization. When true the bind site wraps the handler in
+     * an index+git-version-aware LRU cache (see registerToolDefinition): identical
+     * calls against the same repo are served without re-running the handler, and
+     * the served response carries a `⚡ cached` marker.
+     *
+     * The cache key folds in the repo's on-disk index version AND its git-dir state
+     * (HEAD / index / reflog mtimes), both recomputed fresh on every call (statSync
+     * only, no subprocess), so an index change, commit, or branch switch invalidates
+     * the entry IMMEDIATELY — there is no TTL / staleness window.
+     *
+     * Degraded contract: if the repo's index version cannot be observed (repo not in
+     * the registry, registry or index file unreadable) the call is NOT cached at all
+     * — the handler runs every time. An entry keyed without a version component could
+     * never be invalidated, so "unknown version" means "do not memoize", never "cache
+     * forever".
+     *
+     * Only set on deterministic, expensive-to-recompute analysis tools.
+     */
+    cacheable?: boolean;
+    /**
+     * Per-tool client-facing timeout budget in milliseconds. Overrides the
+     * universal default (env CODESIFT_TOOL_TIMEOUT_MS, else 90s). Ignored for
+     * the timeout-exempt long-op allowlist (index_folder/index_file/…).
+     */
+    timeoutMs?: number;
+}
+export interface ToolDefinitionEntry {
+    order: number;
+    definition: ToolDefinition;
+}
+export declare const OutputSchemas: {
+    /** search_symbols, cross_repo_search */
+    readonly searchResults: z.ZodString;
+    /** get_file_tree */
+    readonly fileTree: z.ZodString;
+    /** get_file_outline */
+    readonly fileOutline: z.ZodString;
+    /** get_symbol */
+    readonly symbol: z.ZodNullable<z.ZodString>;
+    /** find_references */
+    readonly references: z.ZodString;
+    /** trace_call_chain */
+    readonly callTree: z.ZodString;
+    /** impact_analysis */
+    readonly impactAnalysis: z.ZodString;
+    /** codebase_retrieval */
+    readonly batchResults: z.ZodString;
+    /** discover_tools */
+    readonly toolDiscovery: z.ZodObject<{
+        query: z.ZodString;
+        matches: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            category: z.ZodString;
+            description: z.ZodString;
+            is_core: z.ZodBoolean;
+        }, z.core.$strip>>;
+        total_tools: z.ZodNumber;
+        categories: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    /** get_call_hierarchy */
+    readonly callHierarchy: z.ZodString;
+    /** analyze_complexity */
+    readonly complexity: z.ZodString;
+    /** find_dead_code */
+    readonly deadCode: z.ZodString;
+    /** find_clones */
+    readonly clones: z.ZodString;
+    /** scan_secrets */
+    readonly secrets: z.ZodString;
+    /** go_to_definition */
+    readonly definition: z.ZodNullable<z.ZodString>;
+    /** get_type_info */
+    readonly typeInfo: z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodString;
+        documentation: z.ZodOptional<z.ZodString>;
+        via: z.ZodLiteral<"lsp">;
+    }, z.core.$strip>, z.ZodObject<{
+        via: z.ZodLiteral<"unavailable">;
+        hint: z.ZodString;
+    }, z.core.$strip>]>;
+    /** rename_symbol */
+    readonly renameResult: z.ZodObject<{
+        files_changed: z.ZodNumber;
+        edits: z.ZodArray<z.ZodObject<{
+            file: z.ZodString;
+            changes: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    /** usage_stats */
+    readonly usageStats: z.ZodObject<{
+        report: z.ZodString;
+    }, z.core.$loose>;
+    /** list_repos */
+    readonly repoList: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$loose>>]>;
+};
+export declare const SYMBOL_TOOLS: Set<string>;
+/**
+ * Build an H11 hint string from a list of FileEntry-like records. Returns
+ * null when no hint is needed. Separated from `checkTextStubHint` so the
+ * purely-deterministic core can be unit-tested without spinning up a real
+ * index.
+ *
+ * A file is counted as a "stub" when its language appears in STUB_LANGUAGES
+ * (queried dynamically). Languages like `kotlin` that have a real extractor
+ * are automatically excluded because they live outside STUB_LANGUAGES, so
+ * H11 no longer fires for Kotlin-heavy repos.
+ */
+export declare function buildH11Hint(files: ReadonlyArray<{
+    path: string;
+    language: string;
+}>): string | null;
+/**
+ * Check if a repo has stub-language files as a dominant portion. Returns a
+ * hint string to prepend to empty results, or null if no hint needed.
+ */
+export declare function checkTextStubHint(repo: string | undefined, toolName: string, resultEmpty: boolean): Promise<string | null>;
+export declare function formatAuditScan(result: AuditScanResult): string;
+interface RegisterToolRuntime {
+    detectAutoLoadToolsCached: (cwd: string) => Promise<string[]>;
+    enableToolByName: (name: string) => boolean;
+}
+export declare function setRegisterToolRuntime(runtime: RegisterToolRuntime): void;
+export declare function detectAutoLoadToolsCached(cwd: string): Promise<string[]>;
+export declare function enableToolByName(name: string): boolean;
+//# sourceMappingURL=shared.d.ts.map

package/dist/register-tool-groups/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/register-tool-groups/shared.ts"],"names":[],"mappings":"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"}

package/dist/register-tool-groups/shared.js

@@ -0,0 +1,182 @@
+import { z } from "zod";
+import { STUB_LANGUAGES } from "../parser/stub-languages.js";
+import { getCodeIndex } from "../register-tool-loaders.js";
+export { z };
+/** Boolean that also accepts "true"/"false" strings (LLMs often send strings instead of booleans) */
+export const zBool = () => z.union([z.boolean(), z.string().transform((s) => s === "true")]).optional();
+export const zFiniteNumber = z.number().finite();
+/** Coerce string->number for numeric params while rejecting NaN/empty strings. */
+export const zNum = () => z.union([
+    zFiniteNumber,
+    z.string()
+        .trim()
+        .min(1, "Expected a number")
+        .transform((value) => Number(value))
+        .pipe(zFiniteNumber),
+]).optional();
+export function lazySchema(factory) {
+    let cached;
+    const resolve = () => {
+        cached ??= factory();
+        return cached;
+    };
+    return new Proxy({}, {
+        get(_target, prop) {
+            return resolve()[prop];
+        },
+        has(_target, prop) {
+            return prop in resolve();
+        },
+        ownKeys() {
+            return Reflect.ownKeys(resolve());
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            const descriptor = Object.getOwnPropertyDescriptor(resolve(), prop);
+            if (descriptor)
+                return descriptor;
+            return {
+                configurable: true,
+                enumerable: true,
+                writable: false,
+                value: resolve()[prop],
+            };
+        },
+    });
+}
+export const OutputSchemas = {
+    /** search_symbols, cross_repo_search */
+    searchResults: z.string().describe("Formatted search results: file:line kind name signature"),
+    /** get_file_tree */
+    fileTree: z.string().describe("File tree with symbol counts per file"),
+    /** get_file_outline */
+    fileOutline: z.string().describe("Symbol outline: line:end_line kind name"),
+    /** get_symbol */
+    symbol: z.string().nullable().describe("Symbol source code or null if not found"),
+    /** find_references */
+    references: z.string().describe("References in file:line: context format"),
+    /** trace_call_chain */
+    callTree: z.string().describe("Call tree hierarchy or Mermaid diagram"),
+    /** impact_analysis */
+    impactAnalysis: z.string().describe("Changed files and affected symbols with risk levels"),
+    /** codebase_retrieval */
+    batchResults: z.string().describe("Concatenated sub-query result sections"),
+    /** discover_tools */
+    toolDiscovery: z.object({
+        query: z.string(),
+        matches: z.array(z.object({
+            name: z.string(),
+            category: z.string(),
+            description: z.string(),
+            is_core: z.boolean(),
+        })),
+        total_tools: z.number(),
+        categories: z.array(z.string()),
+    }),
+    /** get_call_hierarchy */
+    callHierarchy: z.string().describe("Call hierarchy: symbol with incoming and outgoing calls"),
+    /** analyze_complexity */
+    complexity: z.string().describe("Complexity report: CC nest lines file:line name"),
+    /** find_dead_code */
+    deadCode: z.string().describe("Unused exported symbols list"),
+    /** find_clones */
+    clones: z.string().describe("Code clone pairs with similarity scores"),
+    /** scan_secrets */
+    secrets: z.string().describe("Secret findings with severity, type, and masked values"),
+    /** go_to_definition */
+    definition: z.string().nullable().describe("file:line (via lsp|index) with preview"),
+    /** get_type_info */
+    typeInfo: z.union([
+        z.object({ type: z.string(), documentation: z.string().optional(), via: z.literal("lsp") }),
+        z.object({ via: z.literal("unavailable"), hint: z.string() }),
+    ]),
+    /** rename_symbol */
+    renameResult: z.object({
+        files_changed: z.number(),
+        edits: z.array(z.object({ file: z.string(), changes: z.number() })),
+    }),
+    /** usage_stats */
+    usageStats: z.object({ report: z.string() }).passthrough(),
+    /** list_repos */
+    repoList: z.union([z.array(z.string()), z.array(z.object({ name: z.string() }).passthrough())]),
+};
+export const SYMBOL_TOOLS = new Set([
+    "search_symbols", "get_file_outline", "get_symbol", "get_symbols",
+    "find_references", "trace_call_chain", "find_dead_code", "analyze_complexity",
+]);
+/**
+ * Build an H11 hint string from a list of FileEntry-like records. Returns
+ * null when no hint is needed. Separated from `checkTextStubHint` so the
+ * purely-deterministic core can be unit-tested without spinning up a real
+ * index.
+ *
+ * A file is counted as a "stub" when its language appears in STUB_LANGUAGES
+ * (queried dynamically). Languages like `kotlin` that have a real extractor
+ * are automatically excluded because they live outside STUB_LANGUAGES, so
+ * H11 no longer fires for Kotlin-heavy repos.
+ */
+export function buildH11Hint(files) {
+    if (files.length === 0)
+        return null;
+    const stubFiles = files.filter((f) => STUB_LANGUAGES.has(f.language));
+    if (stubFiles.length === 0)
+        return null;
+    const stubPct = Math.round((stubFiles.length / files.length) * 100);
+    if (stubPct < 30)
+        return null;
+    const stubExts = [...new Set(stubFiles.map((f) => "." + f.path.split(".").pop()))].slice(0, 3).join(", ");
+    return `⚡H11 No parser for ${stubExts} files (${stubPct}% of repo). Symbol tools return empty.\n` +
+        `  → search_text(query) works on ALL files (uses ripgrep, not parser)\n` +
+        `  → get_file_tree shows file listing\n` +
+        `  → Only symbol-based tools (this one) need a parser to return results.\n`;
+}
+/**
+ * Check if a repo has stub-language files as a dominant portion. Returns a
+ * hint string to prepend to empty results, or null if no hint needed.
+ */
+export async function checkTextStubHint(repo, toolName, resultEmpty) {
+    if (!resultEmpty || !repo || !SYMBOL_TOOLS.has(toolName))
+        return null;
+    const index = await getCodeIndex(repo);
+    if (!index)
+        return null;
+    return buildH11Hint(index.files);
+}
+export function formatAuditScan(result) {
+    const lines = [];
+    lines.push(`AUDIT SCAN: ${result.repo}`);
+    lines.push(`Gates checked: ${result.summary.gates_checked} | Findings: ${result.summary.total_findings} (${result.summary.critical} critical, ${result.summary.warning} warning)`);
+    lines.push("");
+    for (const gate of result.gates) {
+        const count = gate.findings.length;
+        const status = count === 0 ? "✓ PASS" : `✗ ${count} finding${count > 1 ? "s" : ""}`;
+        lines.push(`${gate.gate} ${status} — ${gate.description}`);
+        lines.push(`  tool: ${gate.tool_used}`);
+        for (const f of gate.findings.slice(0, 10)) {
+            const loc = f.line ? `:${f.line}` : "";
+            const sev = f.severity === "critical" ? "🔴" : "🟡";
+            lines.push(`  ${sev} ${f.file}${loc} — ${f.detail}`);
+        }
+        if (gate.findings.length > 10) {
+            lines.push(`  ... +${gate.findings.length - 10} more`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+let registerToolRuntime;
+export function setRegisterToolRuntime(runtime) {
+    registerToolRuntime = runtime;
+}
+function getRegisterToolRuntime() {
+    if (!registerToolRuntime) {
+        throw new Error("register tool runtime is not initialized");
+    }
+    return registerToolRuntime;
+}
+export function detectAutoLoadToolsCached(cwd) {
+    return getRegisterToolRuntime().detectAutoLoadToolsCached(cwd);
+}
+export function enableToolByName(name) {
+    return getRegisterToolRuntime().enableToolByName(name);
+}
+//# sourceMappingURL=shared.js.map

package/dist/register-tool-groups/shared.js.map

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

package/dist/register-tool-groups/sql.d.ts

@@ -0,0 +1,3 @@
+import { type ToolDefinitionEntry } from "./shared.js";
+export declare const SQL_TOOL_ENTRIES: ToolDefinitionEntry[];
+//# sourceMappingURL=sql.d.ts.map

package/dist/register-tool-groups/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/register-tool-groups/sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,mBAAmB,EAAqB,MAAM,aAAa,CAAC;AAEtG,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,EA6OjD,CAAC"}

package/dist/register-tool-groups/sql.js

@@ -0,0 +1,260 @@
+import { z, zBool, zNum, lazySchema } from "./shared.js";
+export const SQL_TOOL_ENTRIES = [
+    // ── SQL analysis tools (hidden/discoverable) ─────────────
+    { order: 4622, definition: {
+            name: "analyze_schema",
+            category: "analysis",
+            searchHint: "SQL schema ERD entity relationship tables views columns foreign key database migration MySQL Postgres SQLite dialect",
+            description: "Analyze SQL schema: tables, views, columns, foreign keys, relationships. Auto-detects dialect (mysql/postgres/sqlite/mssql) from schema fingerprints. Output as JSON or Mermaid ERD.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                file_pattern: z.string().optional().describe("Filter SQL files by pattern (e.g. 'migrations/')"),
+                output_format: z.enum(["json", "mermaid"]).optional().describe("Output format (default: json)"),
+                include_columns: zBool().describe("Include column details in output (default: true)"),
+                dialect: z.enum(["auto", "mysql", "postgres", "sqlite", "mssql", "unknown"]).optional().describe("Force dialect, or 'auto' to detect from ENGINE=InnoDB / SERIAL / AUTOINCREMENT etc. (default: auto)"),
+            })),
+            handler: async (args) => {
+                const { analyzeSchema } = await import("../tools/sql-tools.js");
+                const opts = {};
+                if (args.file_pattern != null)
+                    opts.file_pattern = args.file_pattern;
+                if (args.output_format != null)
+                    opts.output_format = args.output_format;
+                if (args.include_columns != null)
+                    opts.include_columns = args.include_columns;
+                if (args.dialect != null)
+                    opts.dialect = args.dialect;
+                const result = await analyzeSchema(args.repo, opts);
+                const parts = [];
+                parts.push(`Tables: ${result.tables.length} | Views: ${result.views.length} | Relationships: ${result.relationships.length} | Dialect: ${result.detected_dialect}`);
+                if (result.warnings.length > 0)
+                    parts.push(`Warnings: ${result.warnings.join("; ")}`);
+                if (result.mermaid) {
+                    parts.push("");
+                    parts.push(result.mermaid);
+                }
+                else {
+                    for (const t of result.tables) {
+                        const cols = t.columns.map((c) => `${c.name} ${c.type}`).join(", ");
+                        parts.push(`  ${t.name} (${t.file}:${t.line}) — ${cols || "(no columns)"}`);
+                    }
+                    for (const v of result.views) {
+                        parts.push(`  VIEW ${v.name} (${v.file}:${v.line})`);
+                    }
+                    if (result.relationships.length > 0) {
+                        parts.push("Relationships:");
+                        for (const r of result.relationships) {
+                            parts.push(`  ${r.from_table}.${r.from_column} → ${r.to_table}.${r.to_column} [${r.type}]`);
+                        }
+                    }
+                }
+                return parts.join("\n");
+            },
+        } },
+    { order: 4666, definition: {
+            name: "trace_query",
+            category: "analysis",
+            searchHint: "SQL table query trace references cross-language ORM Prisma Drizzle migration",
+            description: "Trace SQL table references across the codebase: DDL, DML, FK, and ORM models (Prisma, Drizzle).",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                table: z.string().describe("Table name to trace (required)"),
+                include_orm: zBool().describe("Check Prisma/Drizzle ORM models (default: true)"),
+                file_pattern: z.string().optional().describe("Scope search to files matching pattern"),
+                max_references: zNum().describe("Maximum references to return (default: 500)"),
+            })),
+            handler: async (args) => {
+                const { traceQuery } = await import("../tools/sql-tools.js");
+                const opts = {
+                    table: args.table,
+                };
+                if (args.include_orm != null)
+                    opts.include_orm = args.include_orm;
+                if (args.file_pattern != null)
+                    opts.file_pattern = args.file_pattern;
+                if (args.max_references != null)
+                    opts.max_references = args.max_references;
+                const result = await traceQuery(args.repo, opts);
+                const parts = [];
+                if (result.table_definition) {
+                    parts.push(`Definition: ${result.table_definition.file}:${result.table_definition.line} [${result.table_definition.kind}]`);
+                }
+                else {
+                    parts.push(`Definition: not found in index`);
+                }
+                parts.push(`SQL references: ${result.sql_references.length}${result.truncated ? " (truncated)" : ""}`);
+                for (const ref of result.sql_references.slice(0, 50)) {
+                    parts.push(`  ${ref.file}:${ref.line} [${ref.type}] ${ref.context}`);
+                }
+                if (result.orm_references.length > 0) {
+                    parts.push(`ORM references: ${result.orm_references.length}`);
+                    for (const ref of result.orm_references) {
+                        parts.push(`  ${ref.file}:${ref.line} [${ref.orm}] model ${ref.model_name}`);
+                    }
+                }
+                if (result.warnings.length > 0) {
+                    parts.push(`Warnings: ${result.warnings.join("; ")}`);
+                }
+                return parts.join("\n");
+            },
+        } },
+    { order: 4709, definition: {
+            name: "sql_audit",
+            category: "analysis",
+            searchHint: "SQL audit composite drift orphan lint DML safety complexity god table schema diagnostic",
+            description: "Composite SQL audit — runs 5 diagnostic gates (drift, orphan, lint, dml, complexity) in one call. Use this instead of calling the individual gate functions separately.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                checks: z.array(z.enum(["drift", "orphan", "lint", "dml", "complexity"])).optional().describe("Subset of gates to run (default: all 5)"),
+                file_pattern: z.string().optional().describe("Scope to files matching pattern"),
+                max_results: zNum().describe("Max DML findings per pattern (default: 200)"),
+            })),
+            handler: async (args) => {
+                const { sqlAudit } = await import("../tools/sql-tools.js");
+                const opts = {};
+                if (args.checks != null)
+                    opts.checks = args.checks;
+                if (args.file_pattern != null)
+                    opts.file_pattern = args.file_pattern;
+                if (args.max_results != null)
+                    opts.max_results = args.max_results;
+                const result = await sqlAudit(args.repo, opts);
+                const parts = [];
+                parts.push(`SQL audit: ${result.summary.gates_run} gates run, ${result.summary.gates_passed} passed, ${result.summary.gates_failed} failed`);
+                parts.push(`  Total findings:    ${result.summary.total_findings}`);
+                parts.push(`  Critical findings: ${result.summary.critical_findings}`);
+                parts.push("");
+                for (const g of result.gates) {
+                    const icon = g.pass ? "✓" : (g.critical ? "✗ CRITICAL" : "⚠");
+                    parts.push(`${icon} ${g.check}: ${g.summary}`);
+                }
+                if (result.warnings.length > 0) {
+                    parts.push("");
+                    parts.push("─── Warnings ───");
+                    for (const w of result.warnings)
+                        parts.push(`  ⚠ ${w}`);
+                }
+                return parts.join("\n");
+            },
+        } },
+    { order: 4744, definition: {
+            name: "diff_migrations",
+            category: "analysis",
+            searchHint: "migration diff SQL destructive DROP ALTER ADD schema change deploy risk",
+            description: "Scan SQL migration files and classify operations as additive (CREATE TABLE), modifying (ALTER ADD), or destructive (DROP TABLE, DROP COLUMN, TRUNCATE). Flags deploy risks.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                file_pattern: z.string().optional().describe("Scope to migration files matching pattern"),
+            })),
+            handler: async (args) => {
+                const { diffMigrations } = await import("../tools/sql-tools.js");
+                const opts = {};
+                if (args.file_pattern != null)
+                    opts.file_pattern = args.file_pattern;
+                const result = await diffMigrations(args.repo, opts);
+                const parts = [];
+                parts.push(`Migration ops: ${result.summary.additive + result.summary.modifying + result.summary.destructive} across ${result.summary.total_files} files`);
+                parts.push(`  additive:    ${result.summary.additive}`);
+                parts.push(`  modifying:   ${result.summary.modifying}`);
+                parts.push(`  destructive: ${result.summary.destructive}`);
+                if (result.destructive.length > 0) {
+                    parts.push("\n⚠ DESTRUCTIVE:");
+                    for (const d of result.destructive) {
+                        parts.push(`  [${d.severity.toUpperCase()}] ${d.operation} ${d.target}  (${d.file}:${d.line})`);
+                    }
+                }
+                if (result.modifying.length > 0) {
+                    parts.push("\nModifying:");
+                    for (const m of result.modifying.slice(0, 20)) {
+                        parts.push(`  ${m.operation} ${m.target}  (${m.file}:${m.line})`);
+                    }
+                }
+                return parts.join("\n");
+            },
+        } },
+    { order: 4778, definition: {
+            name: "search_columns",
+            category: "search",
+            searchHint: "search column SQL table field name type database schema find",
+            description: "Search SQL columns across all tables by name (substring), type (int/string/float/...), or parent table. Returns column name, type, table, file, and line. Like search_symbols but scoped to SQL fields.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                query: z.string().describe("Column name substring to match (case-insensitive). Empty = no name filter."),
+                type: z.string().optional().describe("Filter by normalized type: int, string, float, bool, datetime, json, uuid, bytes"),
+                table: z.string().optional().describe("Filter by table name substring"),
+                file_pattern: z.string().optional().describe("Scope to files matching pattern"),
+                max_results: zNum().describe("Max columns to return (default: 100)"),
+            })),
+            handler: async (args) => {
+                const { searchColumns } = await import("../tools/sql-tools.js");
+                const opts = {
+                    query: args.query ?? "",
+                };
+                if (args.type != null)
+                    opts.type = args.type;
+                if (args.table != null)
+                    opts.table = args.table;
+                if (args.file_pattern != null)
+                    opts.file_pattern = args.file_pattern;
+                if (args.max_results != null)
+                    opts.max_results = args.max_results;
+                const result = await searchColumns(args.repo, opts);
+                const parts = [];
+                parts.push(`Columns: ${result.columns.length}${result.truncated ? `/${result.total} (truncated)` : ""}`);
+                for (const c of result.columns) {
+                    parts.push(`  ${c.table}.${c.name.padEnd(24)} ${c.normalized_type.padEnd(10)} ${c.file}:${c.line}`);
+                }
+                return parts.join("\n");
+            },
+        } },
+    // --- PostgreSQL live introspection (hidden/discoverable) ---
+    { order: 4810, definition: {
+            name: "introspect_pg",
+            category: "analysis",
+            searchHint: "postgres postgresql live schema introspect information_schema tables columns drift live database",
+            description: "Introspect a live PostgreSQL database schema via information_schema. Reads table/column structure from a running PG instance. Connection string is read from the CODESIFT_PG_CONN_STR environment variable (never passed as an argument — SSRF/CQ5 safety). Optionally runs pgDriftCheck to compare the live schema against migration-derived SQL symbols in the index.",
+            schema: lazySchema(() => ({
+                schema: z.string().optional().describe("PostgreSQL schema name (default: 'public')"),
+                drift_check: z.boolean().optional().describe("When true, compare live schema against migration-derived SQL symbols in the index and return drift report"),
+                repo: z.string().optional().describe("Repository identifier for drift_check (default: auto-detected from CWD). Only used when drift_check=true."),
+            })),
+            handler: async (args) => {
+                const { loadConfig } = await import("../config.js");
+                const connStr = loadConfig().pgConnStr;
+                if (!connStr) {
+                    return { error: "CODESIFT_PG_CONN_STR not set — export a read-only connection string to enable live introspection" };
+                }
+                const { introspectPgSchema, pgDriftCheck } = await import("../tools/pg-introspect-tools.js");
+                const introspectOpts = {};
+                if (args.schema != null)
+                    introspectOpts.schema = args.schema;
+                const result = await introspectPgSchema(connStr, introspectOpts);
+                if ("error" in result)
+                    return result;
+                if (args.drift_check === true) {
+                    // Fail loud at the TOP level (not buried under `drift`) so pipelines
+                    // gating on `"error" in result` don't silently skip drift validation.
+                    // Without resolved migration-schema symbols, pgDriftCheck would report
+                    // a vacuous "no drift" — the exact false-negative we're guarding.
+                    const repo = typeof args.repo === "string" ? args.repo.trim() : "";
+                    if (!repo) {
+                        return {
+                            error: "drift_check requires an explicit `repo` to load migration-derived schema symbols",
+                        };
+                    }
+                    const { getCodeIndex } = await import("../tools/index-tools.js");
+                    const index = await getCodeIndex(repo);
+                    if (!index) {
+                        return {
+                            error: `drift_check: repo '${repo}' is not indexed — cannot load migration-derived schema symbols`,
+                        };
+                    }
+                    const symbols = index.symbols ?? [];
+                    const drift = pgDriftCheck(result, symbols);
+                    return { ...result, drift };
+                }
+                return result;
+            },
+        } },
+];
+//# sourceMappingURL=sql.js.map