codesift-mcp 0.2.18 → 0.4.0

package/dist/tools/sql-tools.d.ts

@@ -0,0 +1,234 @@
+/**
+ * SQL analysis tools — analyze_schema and trace_query.
+ * Hidden/discoverable: not in CORE_TOOL_NAMES.
+ */
+export interface AnalyzeSchemaOptions {
+    file_pattern?: string;
+    output_format?: "json" | "mermaid";
+    include_columns?: boolean;
+}
+export interface TableInfo {
+    name: string;
+    file: string;
+    line: number;
+    columns: Array<{
+        name: string;
+        type: string;
+    }>;
+}
+export interface Relationship {
+    from_table: string;
+    from_column: string;
+    to_table: string;
+    to_column: string;
+    type: "fk" | "self_reference" | "circular";
+}
+export interface SchemaAnalysisResult {
+    tables: TableInfo[];
+    views: Array<{
+        name: string;
+        file: string;
+        line: number;
+    }>;
+    relationships: Relationship[];
+    warnings: string[];
+    mermaid?: string;
+}
+export declare function analyzeSchema(repo: string, options?: AnalyzeSchemaOptions): Promise<SchemaAnalysisResult>;
+export interface TraceQueryOptions {
+    table: string;
+    include_orm?: boolean;
+    file_pattern?: string;
+    max_references?: number;
+}
+export interface SqlReference {
+    file: string;
+    line: number;
+    context: string;
+    type: "ddl" | "dml" | "view" | "fk";
+}
+export interface OrmReference {
+    file: string;
+    line: number;
+    orm: "prisma" | "drizzle";
+    model_name: string;
+}
+export interface TraceQueryResult {
+    table_definition: {
+        file: string;
+        line: number;
+        kind: "table" | "view";
+    } | null;
+    sql_references: SqlReference[];
+    orm_references: OrmReference[];
+    warnings: string[];
+    truncated: boolean;
+}
+export declare function traceQuery(repo: string, options: TraceQueryOptions): Promise<TraceQueryResult>;
+export interface SearchColumnsOptions {
+    /** Substring to match against column name (case-insensitive). Empty string = no name filter. */
+    query: string;
+    /** Optional: filter by normalized column type (int, string, float, bool, datetime, json, uuid, bytes) */
+    type?: string;
+    /** Optional: substring to match against table name */
+    table?: string;
+    /** Optional: file_pattern to scope */
+    file_pattern?: string;
+    /** Maximum columns to return (default: 100) */
+    max_results?: number;
+}
+export interface ColumnSearchHit {
+    name: string;
+    type: string;
+    normalized_type: string;
+    table: string;
+    file: string;
+    line: number;
+}
+export interface SearchColumnsResult {
+    columns: ColumnSearchHit[];
+    total: number;
+    truncated: boolean;
+}
+export declare function searchColumns(repo: string, options: SearchColumnsOptions): Promise<SearchColumnsResult>;
+export interface TableComplexity {
+    name: string;
+    file: string;
+    line: number;
+    column_count: number;
+    fk_count: number;
+    index_count: number;
+    score: number;
+}
+export interface SchemaComplexityResult {
+    tables: TableComplexity[];
+}
+/**
+ * Per-table complexity score: column count + FK count + index count.
+ * Identifies "god tables" that need refactoring. Sorted by score desc.
+ */
+export declare function analyzeSchemaComplexity(repo: string, options?: {
+    file_pattern?: string;
+    top_n?: number;
+}): Promise<SchemaComplexityResult>;
+export interface DmlFinding {
+    rule: string;
+    severity: "high" | "medium" | "info";
+    file: string;
+    line: number;
+    context?: string;
+    detail: string;
+}
+export interface ScanDmlSafetyResult {
+    findings: DmlFinding[];
+    summary: {
+        total: number;
+        by_rule: Record<string, number>;
+        files_scanned: number;
+    };
+}
+/**
+ * Scan codebase for unsafe DML patterns in SQL strings.
+ * Uses ripgrep to find DML statements, then classifies safety.
+ */
+export declare function scanDmlSafety(repo: string, options?: {
+    file_pattern?: string;
+    max_results?: number;
+}): Promise<ScanDmlSafetyResult>;
+export interface LintFinding {
+    rule: string;
+    severity: "warning" | "info";
+    table: string;
+    detail: string;
+    file: string;
+    line: number;
+}
+export interface LintSchemaResult {
+    findings: LintFinding[];
+    summary: {
+        total: number;
+        by_rule: Record<string, number>;
+    };
+    warnings: string[];
+}
+/**
+ * Lint SQL schema for common anti-patterns.
+ * Conservative ruleset with near-zero false positive rate:
+ * - no-primary-key: table without PRIMARY KEY (serious design smell)
+ * - wide-table: table with >20 columns (god table)
+ * - duplicate-index-name: same index name defined multiple times
+ */
+export declare function lintSchema(repo: string, options?: {
+    file_pattern?: string;
+}): Promise<LintSchemaResult>;
+export interface MigrationOp {
+    operation: string;
+    target: string;
+    severity: "low" | "medium" | "high";
+    file: string;
+    line: number;
+    raw: string;
+}
+export interface DiffMigrationsResult {
+    additive: MigrationOp[];
+    modifying: MigrationOp[];
+    destructive: MigrationOp[];
+    summary: {
+        additive: number;
+        modifying: number;
+        destructive: number;
+        total_files: number;
+    };
+}
+export declare function diffMigrations(repo: string, options?: {
+    file_pattern?: string;
+}): Promise<DiffMigrationsResult>;
+export interface OrphanTable {
+    name: string;
+    file: string;
+    line: number;
+    column_count: number;
+}
+export interface FindOrphanTablesResult {
+    orphans: OrphanTable[];
+    total_tables: number;
+    orphan_count: number;
+}
+/**
+ * Find SQL tables with zero references outside their own CREATE TABLE definition.
+ * Uses ripgrep-backed literal search per table for speed.
+ */
+export declare function findOrphanTables(repo: string, options?: {
+    file_pattern?: string;
+}): Promise<FindOrphanTablesResult>;
+export type DriftKind = "extra_in_orm" | "extra_in_sql" | "type_mismatch";
+export interface SchemaDrift {
+    kind: DriftKind;
+    table: string;
+    column?: string;
+    orm: "prisma" | "drizzle" | "typeorm";
+    orm_file?: string;
+    orm_line?: number;
+    sql_file?: string;
+    sql_line?: number;
+    orm_type?: string;
+    sql_type?: string;
+    detail: string;
+}
+export interface DriftSummary {
+    extra_in_orm: number;
+    extra_in_sql: number;
+    type_mismatches: number;
+    total: number;
+}
+export interface SchemaDriftResult {
+    drifts: SchemaDrift[];
+    summary: DriftSummary;
+    orms_detected: Array<"prisma" | "drizzle" | "typeorm">;
+    warnings: string[];
+}
+export interface AnalyzeSchemaDriftOptions {
+    file_pattern?: string;
+}
+export declare function analyzeSchemaDrift(repo: string, options?: AnalyzeSchemaDriftOptions): Promise<SchemaDriftResult>;
+//# sourceMappingURL=sql-tools.d.ts.map

package/dist/tools/sql-tools.d.ts.map

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