codesift-mcp 0.3.0 → 0.4.0

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

@@ -0,0 +1,32 @@
+import type { SymbolKind } from "../types.js";
+export interface PerfFinding {
+    pattern: string;
+    severity: "high" | "medium" | "low";
+    file: string;
+    line: number;
+    name: string;
+    kind: SymbolKind;
+    context: string;
+    fix_hint: string;
+}
+export interface PerfHotspotsResult {
+    findings: PerfFinding[];
+    patterns_checked: number;
+    symbols_scanned: number;
+    summary: {
+        high: number;
+        medium: number;
+        low: number;
+    };
+}
+export declare function listPerfPatterns(): Record<string, {
+    description: string;
+    severity: string;
+}>;
+export declare function findPerfHotspots(repo: string, options?: {
+    patterns?: string[];
+    file_pattern?: string;
+    include_tests?: boolean;
+    max_results?: number;
+}): Promise<PerfHotspotsResult>;
+//# sourceMappingURL=perf-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"perf-tools.d.ts","sourceRoot":"","sources":["../../src/tools/perf-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD;AAsJD,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ5F;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,kBAAkB,CAAC,CAsF7B"}

package/dist/tools/perf-tools.js

@@ -0,0 +1,227 @@
+import { getCodeIndex } from "./index-tools.js";
+import { isTestFileStrict as isTestFile } from "../utils/test-file.js";
+const PERF_PATTERNS = {
+    "unbounded-query": {
+        regex: /\.(findMany|find|findAll|select)\s*\(\s*\{(?:(?!\btake\b|\blimit\b|\bfirst\b|\btop\b)[\s\S])*?\}\s*\)/,
+        description: "DB query without take/limit — unbounded result set",
+        severity: "high",
+        fix_hint: "Add take/limit to cap result size, or use cursor-based pagination",
+    },
+    "sync-in-handler": {
+        regex: /\b(readFileSync|writeFileSync|appendFileSync|existsSync|mkdirSync|readdirSync|execSync|spawnSync)\s*\(/,
+        description: "Synchronous I/O in request handler — blocks event loop",
+        severity: "high",
+        file_scope: /\b(route|handler|controller|middleware|api|endpoint|server)\b/i,
+        fix_hint: "Use async equivalent (readFile, writeFile, exec) to avoid blocking",
+    },
+    // n-plus-one handled specially — needs balanced-brace loop body extraction.
+    // See scanNPlusOne() below.
+    "unbounded-parallel": {
+        regex: /Promise\.all\s*\(\s*\w+\.map\s*\(/,
+        description: "Promise.all(arr.map(...)) without concurrency control",
+        severity: "medium",
+        fix_hint: "Use pLimit, p-map, or chunk the array to limit concurrent operations",
+    },
+    "missing-pagination": {
+        regex: /\b(res|response|ctx)\.(json|send|status)\s*\([\s\S]*?\b(findMany|find|findAll|select|getAll|list)\b/,
+        description: "API response from unbounded list query — missing pagination",
+        severity: "medium",
+        file_scope: /\b(route|handler|controller|api|endpoint)\b/i,
+        fix_hint: "Add skip/take or cursor params, return {data, total, next_cursor}",
+    },
+    // expensive-recompute handled specially — see scanExpensiveRecompute() below.
+};
+// N+1 metadata (separate from PERF_PATTERNS because it needs custom scanning)
+const N_PLUS_ONE_META = {
+    description: "DB/fetch call inside loop — N+1 query pattern",
+    severity: "high",
+    fix_hint: "Batch queries outside the loop using IN clause or Promise.all with pre-fetched IDs",
+};
+const EXPENSIVE_RECOMPUTE_META = {
+    description: "Same method called multiple times inside loop body",
+    severity: "low",
+    fix_hint: "Hoist the call before the loop or memoize the result",
+};
+// DB call regex — matches method calls that typically indicate DB/fetch
+const DB_CALL_REGEX = /\.(findMany|findFirst|findUnique|findOne|findById|query)\s*\(|\bfetch\s*\(/;
+// Common identifiers to exclude from expensive-recompute backreference
+const RECOMPUTE_BLACKLIST = new Set([
+    "if", "for", "while", "return", "throw", "yield", "await", "new", "typeof",
+    "log", "warn", "error", "info", "debug", "push", "pop", "shift", "unshift",
+    "set", "get", "has", "delete", "add", "then", "catch", "finally", "map",
+    "filter", "forEach", "reduce", "some", "every", "find", "includes",
+]);
+/**
+ * Extract the body of a loop starting at `loopStartIdx` (position of `{` after
+ * `for`/`while` header). Returns the body content between braces, or null if
+ * the braces don't match. Does NOT handle strings or comments — acceptable for
+ * a pattern scanner (will return overly-large body, not smaller).
+ */
+function extractLoopBody(source, openBraceIdx) {
+    let depth = 0;
+    let start = -1;
+    for (let i = openBraceIdx; i < source.length; i++) {
+        if (source[i] === "{") {
+            if (depth === 0)
+                start = i + 1;
+            depth++;
+        }
+        else if (source[i] === "}") {
+            depth--;
+            if (depth === 0 && start >= 0)
+                return source.slice(start, i);
+        }
+    }
+    return null;
+}
+/**
+ * Scan a symbol's source for loops and check if any loop body contains a DB call.
+ * Returns the first match found (line number relative to source start).
+ */
+function scanNPlusOne(source) {
+    const loopHeaderRegex = /\b(for|while)\s*\([^)]*\)\s*\{/g;
+    let headerMatch;
+    while ((headerMatch = loopHeaderRegex.exec(source)) !== null) {
+        const openBraceIdx = source.indexOf("{", headerMatch.index);
+        if (openBraceIdx === -1)
+            continue;
+        const body = extractLoopBody(source, openBraceIdx);
+        if (!body)
+            continue;
+        const dbMatch = DB_CALL_REGEX.exec(body);
+        if (dbMatch) {
+            const linesBefore = source.slice(0, openBraceIdx).split("\n").length;
+            const contextLine = dbMatch[0].split("\n")[0].trim();
+            return { line: linesBefore, context: contextLine };
+        }
+    }
+    return null;
+}
+/**
+ * Scan a loop body for the same method called 2+ times.
+ * Excludes control flow keywords and common JS methods via RECOMPUTE_BLACKLIST.
+ */
+function scanExpensiveRecompute(source) {
+    const loopHeaderRegex = /\b(for|while)\s*\([^)]*\)\s*\{/g;
+    let headerMatch;
+    while ((headerMatch = loopHeaderRegex.exec(source)) !== null) {
+        const openBraceIdx = source.indexOf("{", headerMatch.index);
+        if (openBraceIdx === -1)
+            continue;
+        const body = extractLoopBody(source, openBraceIdx);
+        if (!body)
+            continue;
+        // Collect dot-method call names (at least 3 chars) and count occurrences
+        const methodCounts = new Map();
+        const callRegex = /\.(\w{3,})\s*\(/g;
+        let callMatch;
+        while ((callMatch = callRegex.exec(body)) !== null) {
+            const name = callMatch[1];
+            if (RECOMPUTE_BLACKLIST.has(name))
+                continue;
+            methodCounts.set(name, (methodCounts.get(name) ?? 0) + 1);
+        }
+        for (const [name, count] of methodCounts) {
+            if (count >= 2) {
+                const linesBefore = source.slice(0, openBraceIdx).split("\n").length;
+                return { line: linesBefore, context: `.${name}() called ${count}× in loop body` };
+            }
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Tool implementation
+// ---------------------------------------------------------------------------
+export function listPerfPatterns() {
+    const out = {};
+    for (const [name, p] of Object.entries(PERF_PATTERNS)) {
+        out[name] = { description: p.description, severity: p.severity };
+    }
+    out["n-plus-one"] = { description: N_PLUS_ONE_META.description, severity: N_PLUS_ONE_META.severity };
+    out["expensive-recompute"] = { description: EXPENSIVE_RECOMPUTE_META.description, severity: EXPENSIVE_RECOMPUTE_META.severity };
+    return out;
+}
+export async function findPerfHotspots(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    }
+    const includeTests = options?.include_tests ?? false;
+    const filePattern = options?.file_pattern;
+    const maxResults = options?.max_results ?? 50;
+    const requestedPatterns = options?.patterns;
+    const enabledRegexPatterns = requestedPatterns
+        ? Object.entries(PERF_PATTERNS).filter(([name]) => requestedPatterns.includes(name))
+        : Object.entries(PERF_PATTERNS);
+    const nPlusOneEnabled = !requestedPatterns || requestedPatterns.includes("n-plus-one");
+    const expensiveRecomputeEnabled = !requestedPatterns || requestedPatterns.includes("expensive-recompute");
+    const findings = [];
+    let scanned = 0;
+    const addFinding = (sym, patternName, meta, lineOffset, context) => {
+        findings.push({
+            pattern: patternName,
+            severity: meta.severity,
+            file: sym.file,
+            line: sym.start_line + lineOffset - 1,
+            name: sym.name,
+            kind: sym.kind,
+            context: context.length > 120 ? context.slice(0, 117) + "..." : context,
+            fix_hint: meta.fix_hint,
+        });
+    };
+    for (const sym of index.symbols) {
+        if (findings.length >= maxResults)
+            break;
+        if (!sym.source)
+            continue;
+        if (!includeTests && isTestFile(sym.file))
+            continue;
+        if (filePattern && !sym.file.includes(filePattern))
+            continue;
+        scanned++;
+        // Regex-based patterns
+        for (const [patternName, pattern] of enabledRegexPatterns) {
+            if (findings.length >= maxResults)
+                break;
+            // Apply file_scope filter
+            if (pattern.file_scope && !pattern.file_scope.test(sym.file))
+                continue;
+            const match = pattern.regex.exec(sym.source);
+            if (match) {
+                const matchStart = match.index;
+                const linesBefore = sym.source.slice(0, matchStart).split("\n").length;
+                const matchedLine = match[0].split("\n")[0].trim();
+                addFinding(sym, patternName, pattern, linesBefore, matchedLine);
+            }
+        }
+        // Custom scanners (require balanced-brace parsing)
+        if (nPlusOneEnabled && findings.length < maxResults) {
+            const result = scanNPlusOne(sym.source);
+            if (result)
+                addFinding(sym, "n-plus-one", N_PLUS_ONE_META, result.line, result.context);
+        }
+        if (expensiveRecomputeEnabled && findings.length < maxResults) {
+            const result = scanExpensiveRecompute(sym.source);
+            if (result)
+                addFinding(sym, "expensive-recompute", EXPENSIVE_RECOMPUTE_META, result.line, result.context);
+        }
+    }
+    // Sort: high first, then medium, then low
+    const severityOrder = { high: 0, medium: 1, low: 2 };
+    findings.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
+    const totalPatternsChecked = enabledRegexPatterns.length
+        + (nPlusOneEnabled ? 1 : 0)
+        + (expensiveRecomputeEnabled ? 1 : 0);
+    return {
+        findings,
+        patterns_checked: totalPatternsChecked,
+        symbols_scanned: scanned,
+        summary: {
+            high: findings.filter((f) => f.severity === "high").length,
+            medium: findings.filter((f) => f.severity === "medium").length,
+            low: findings.filter((f) => f.severity === "low").length,
+        },
+    };
+}
+//# sourceMappingURL=perf-tools.js.map

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

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

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

@@ -0,0 +1,176 @@
+export interface PhpNamespaceResolution {
+    class_name: string;
+    namespace: string;
+    file_path: string | null;
+    exists: boolean;
+    psr4_root: string | null;
+    psr4_prefix: string | null;
+}
+export declare function resolvePhpNamespace(repo: string, className: string): Promise<PhpNamespaceResolution>;
+export interface ActiveRecordModel {
+    name: string;
+    file: string;
+    table_name: string | null;
+    relations: {
+        name: string;
+        type: "hasOne" | "hasMany" | "manyMany";
+        target_class: string;
+    }[];
+    rules: string[];
+    behaviors: string[];
+    methods: string[];
+}
+export interface ActiveRecordAnalysis {
+    models: ActiveRecordModel[];
+    total: number;
+}
+export declare function analyzeActiveRecord(repo: string, options?: {
+    model_name?: string;
+    file_pattern?: string;
+}): Promise<ActiveRecordAnalysis>;
+export interface PhpEventChain {
+    event_name: string;
+    triggers: {
+        file: string;
+        line: number;
+        context: string;
+    }[];
+    listeners: {
+        file: string;
+        line: number;
+        context: string;
+    }[];
+}
+export declare function tracePhpEvent(repo: string, options?: {
+    event_name?: string;
+}): Promise<{
+    events: PhpEventChain[];
+    total: number;
+}>;
+export interface PhpViewMapping {
+    controller: string;
+    action: string;
+    view_name: string;
+    view_file: string | null;
+    render_line: number;
+}
+export declare function findPhpViews(repo: string, options?: {
+    controller?: string;
+}): Promise<{
+    mappings: PhpViewMapping[];
+    total: number;
+}>;
+export interface PhpServiceResolution {
+    name: string;
+    class: string | null;
+    file: string | null;
+    config_file: string | null;
+}
+export declare function resolvePhpService(repo: string, options?: {
+    service_name?: string;
+}): Promise<{
+    services: PhpServiceResolution[];
+    total: number;
+}>;
+export interface PhpSecurityFinding {
+    severity: "critical" | "high" | "medium" | "low";
+    pattern: string;
+    file: string;
+    line: number;
+    context: string;
+    description: string;
+}
+export interface PhpSecurityScanResult {
+    findings: PhpSecurityFinding[];
+    summary: {
+        critical: number;
+        high: number;
+        medium: number;
+        low: number;
+        total: number;
+    };
+    checks_run: string[];
+}
+export declare function phpSecurityScan(repo: string, options?: {
+    file_pattern?: string;
+    checks?: string[];
+}): Promise<PhpSecurityScanResult>;
+export interface NPlusOneFinding {
+    file: string;
+    method: string;
+    line: number;
+    relation: string;
+    pattern: string;
+}
+/**
+ * Detect N+1 query patterns in Yii2/Eloquent controllers.
+ *
+ * Pattern: `foreach ($items as $item) { $item->relation->... }` without a
+ * prior `->with('relation')` call in the same method scope. This is the
+ * most common N+1 anti-pattern in Yii2 ActiveRecord code.
+ *
+ * Known limitations (acceptable for a "discovery" tool, not a gate):
+ * - Regex-based — can miss multi-line foreach bodies split across nested blocks
+ * - Doesn't cross function boundaries — eager loading in caller is invisible
+ * - False positives on nested loops if the outer collection is already eager-loaded
+ */
+export declare function findPhpNPlusOne(repo: string, options?: {
+    limit?: number;
+    file_pattern?: string;
+}): Promise<{
+    findings: NPlusOneFinding[];
+    total: number;
+}>;
+export interface GodModelFinding {
+    name: string;
+    file: string;
+    method_count: number;
+    relation_count: number;
+    line_count: number;
+    reasons: string[];
+}
+/**
+ * Flag ActiveRecord models with too many methods, relations, or lines.
+ * Thresholds are configurable (default 50/15/500). Uses analyzeActiveRecord
+ * for model detection, then cross-references the class symbol for line span.
+ *
+ * Classic anti-pattern in large Yii2 apps — Survey.php in Mobi2 has 175
+ * methods, 30 relations, split across a single 3000-line file.
+ */
+export declare function findPhpGodModel(repo: string, options?: {
+    min_methods?: number;
+    min_relations?: number;
+    min_lines?: number;
+}): Promise<{
+    models: GodModelFinding[];
+    total: number;
+}>;
+export interface AuditGate {
+    name: string;
+    status: "ok" | "error" | "timeout";
+    findings_count: number;
+    duration_ms: number;
+    error?: string;
+}
+export interface PhpProjectAudit {
+    repo: string;
+    duration_ms: number;
+    checks_run: string[];
+    gates: AuditGate[];
+    summary: {
+        total_findings: number;
+        critical: number;
+        high: number;
+        medium: number;
+        low: number;
+        health_score: number;
+        top_risks: string[];
+    };
+    security: PhpSecurityScanResult;
+    activerecord: ActiveRecordAnalysis;
+}
+export declare function phpProjectAudit(repo: string, options?: {
+    file_pattern?: string;
+    checks?: string[];
+}): Promise<PhpProjectAudit>;
+//# sourceMappingURL=php-tools.d.ts.map

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

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