codesift-mcp 0.3.0 → 0.5.0

package/dist/tools/serialization-tools.js

@@ -0,0 +1,156 @@
+/**
+ * kotlinx.serialization contract extraction.
+ *
+ * extract_kotlin_serialization_contract — derive JSON schema from @Serializable
+ * data classes by walking indexed symbol signatures + source for field names,
+ * types, @SerialName remapping, nullable types, and default values.
+ */
+import { getCodeIndex } from "./index-tools.js";
+// ---------------------------------------------------------------------------
+// Parsing
+// ---------------------------------------------------------------------------
+/**
+ * Extract primary constructor parameters from a @Serializable data class source.
+ * Returns structured field metadata for JSON schema generation.
+ *
+ * Handles:
+ *   @SerialName("api_name") val localName: String
+ *   val name: String? = null
+ *   val items: List<Item> = emptyList()
+ *   @Contextual val date: LocalDate
+ */
+function extractFields(sym) {
+    const source = sym.source ?? "";
+    // Find the primary constructor opening paren, then scan for balanced close.
+    // Can't use a simple regex because @SerialName("...") contains nested parens.
+    const classMatch = /(?:data\s+)?class\s+\w+(?:\s*<[^>]+>)?\s*\(/.exec(source);
+    if (!classMatch)
+        return [];
+    const openIdx = classMatch.index + classMatch[0].length;
+    let depth = 1;
+    let closeIdx = openIdx;
+    for (let i = openIdx; i < source.length && depth > 0; i++) {
+        if (source[i] === "(")
+            depth++;
+        else if (source[i] === ")")
+            depth--;
+        closeIdx = i;
+    }
+    const paramBlock = source.slice(openIdx, closeIdx);
+    const fields = [];
+    // Split on top-level commas (respecting generics / nested parens).
+    const params = splitTopLevelCommas(paramBlock);
+    for (const raw of params) {
+        const param = raw.trim();
+        if (!param || !param.includes(":"))
+            continue;
+        // Check for @SerialName("name") annotation.
+        const serialNameMatch = /@SerialName\s*\(\s*"([^"]+)"\s*\)/.exec(param);
+        const serialName = serialNameMatch?.[1];
+        // Strip annotations and val/var modifiers.
+        const cleaned = param
+            .replace(/@\w+(?:\([^)]*\))?\s*/g, "")
+            .replace(/\b(?:private|public|internal|protected|override|val|var)\s+/g, "")
+            .trim();
+        const colonIdx = cleaned.indexOf(":");
+        if (colonIdx === -1)
+            continue;
+        const fieldName = cleaned.slice(0, colonIdx).trim();
+        let typeAndDefault = cleaned.slice(colonIdx + 1).trim();
+        // Separate default value.
+        let hasDefault = false;
+        const eqIdx = findTopLevelEquals(typeAndDefault);
+        if (eqIdx !== -1) {
+            hasDefault = true;
+            typeAndDefault = typeAndDefault.slice(0, eqIdx).trim();
+        }
+        // Handle trailing comma.
+        const typeStr = typeAndDefault.replace(/,\s*$/, "").trim();
+        const nullable = typeStr.endsWith("?");
+        const baseType = nullable ? typeStr.slice(0, -1).trim() : typeStr;
+        if (!fieldName)
+            continue;
+        fields.push({
+            name: fieldName,
+            serial_name: serialName ?? fieldName,
+            type: baseType,
+            nullable,
+            has_default: hasDefault,
+        });
+    }
+    return fields;
+}
+function splitTopLevelCommas(text) {
+    const parts = [];
+    let depth = 0;
+    let start = 0;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (ch === "<" || ch === "(" || ch === "[")
+            depth++;
+        else if (ch === ">" || ch === ")" || ch === "]")
+            depth--;
+        else if (ch === "," && depth === 0) {
+            parts.push(text.slice(start, i));
+            start = i + 1;
+        }
+    }
+    parts.push(text.slice(start));
+    return parts;
+}
+function findTopLevelEquals(text) {
+    let depth = 0;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (ch === "<" || ch === "(" || ch === "[")
+            depth++;
+        else if (ch === ">" || ch === ")" || ch === "]")
+            depth--;
+        else if (ch === "=" && depth === 0)
+            return i;
+    }
+    return -1;
+}
+// ---------------------------------------------------------------------------
+// Tool
+// ---------------------------------------------------------------------------
+export async function extractKotlinSerializationContract(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    }
+    const contracts = [];
+    let totalFields = 0;
+    for (const sym of index.symbols) {
+        if (sym.kind !== "class")
+            continue;
+        if (!sym.decorators?.includes("Serializable")) {
+            // Fallback: scan source
+            if (!sym.source?.slice(0, 200).includes("@Serializable"))
+                continue;
+        }
+        if (options?.file_pattern && !sym.file.includes(options.file_pattern))
+            continue;
+        if (options?.class_name && sym.name !== options.class_name)
+            continue;
+        const fields = extractFields(sym);
+        const isPolymorphic = sym.decorators?.includes("Polymorphic") ??
+            /\b@Polymorphic\b/.test(sym.source?.slice(0, 200) ?? "");
+        contracts.push({
+            class_name: sym.name,
+            file: sym.file,
+            start_line: sym.start_line,
+            fields,
+            is_polymorphic: !!isPolymorphic,
+        });
+        totalFields += fields.length;
+    }
+    // Sort by name for stable output.
+    contracts.sort((a, b) => a.class_name.localeCompare(b.class_name));
+    return {
+        contracts,
+        total_classes: contracts.length,
+        total_fields: totalFields,
+    };
+}
+//# sourceMappingURL=serialization-tools.js.map

package/dist/tools/serialization-tools.js.map

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

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

@@ -0,0 +1,274 @@
+/**
+ * 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>;
+export type SqlAuditCheck = "drift" | "orphan" | "lint" | "dml" | "complexity";
+export interface SqlAuditOptions {
+    /** Which checks to run (default: all) */
+    checks?: SqlAuditCheck[];
+    /** Scope to files matching pattern */
+    file_pattern?: string;
+    /** Optional: max_results for dml scan */
+    max_results?: number;
+}
+export interface SqlAuditGate {
+    check: SqlAuditCheck;
+    pass: boolean;
+    critical: boolean;
+    finding_count: number;
+    /** Per-check result shape differs; let consumers drill into .data if needed */
+    data: unknown;
+    /** One-line human-readable summary */
+    summary: string;
+}
+export interface SqlAuditResult {
+    gates: SqlAuditGate[];
+    summary: {
+        total_findings: number;
+        critical_findings: number;
+        gates_run: number;
+        gates_passed: number;
+        gates_failed: number;
+    };
+    warnings: string[];
+}
+/**
+ * Composite SQL audit — runs multiple diagnostic gates in a single call.
+ * Mirrors framework_audit / nest_audit / audit_scan pattern.
+ *
+ * Individual gate functions (analyzeSchemaDrift, findOrphanTables, lintSchema,
+ * scanDmlSafety, analyzeSchemaComplexity) remain exported for internal use
+ * but are NOT registered as separate MCP tools. sql_audit is the single
+ * discoverable entry point.
+ */
+export declare function sqlAudit(repo: string, options?: SqlAuditOptions): Promise<SqlAuditResult>;
+//# 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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"}