codesift-mcp 0.2.18 → 0.4.0

package/dist/tools/complexity-tools.js

@@ -1,7 +1,7 @@
 import { getCodeIndex } from "./index-tools.js";
 import { isTestFileStrict as isTestFile } from "../utils/test-file.js";
 const ANALYZABLE_KINDS = new Set([
-    "function", "method", "class",
+    "function", "method", "class", "component", "hook",
 ]);
 // Patterns that increase cyclomatic complexity (decision points)
 const BRANCH_PATTERNS = [
@@ -13,9 +13,18 @@ const BRANCH_PATTERNS = [
     /\&\&/g,
     /\|\|/g,
     /\?\?/g, // nullish coalescing
+    // Kotlin branch patterns
+    /\bwhen\s*[\({]/g, // when expression/statement
+    /\?\.let\s*\{/g, // safe call + lambda
+    /\?\.run\s*\{/g, // safe call + run
+    /\?:/g, // Elvis operator
+    // PHP branch patterns
+    /\bforeach\s*\(/g, // foreach loop
+    /\belseif\s*\(/g, // PHP elseif (one word)
+    /\bmatch\s*\(/g, // PHP 8 match expression
 ];
 // Patterns that increase nesting
-const NESTING_OPENERS = /\b(if|for|while|switch|try)\s*[\({]/g;
+const NESTING_OPENERS = /\b(if|for|foreach|while|switch|try|when|match)\s*[\({]/g;
 /**
  * Estimate cyclomatic complexity from source text.
  * Counts decision points: if, else if, case, catch, &&, ||, ??, ternary.
@@ -31,6 +40,53 @@ function countBranches(source) {
     }
     return branches;
 }
+/**
+ * Count React hook calls in source text.
+ * Returns { total, state, effect } for useState, useEffect, and generic use*() calls.
+ */
+function countReactHooks(source) {
+    let total = 0;
+    let state = 0;
+    let effect = 0;
+    const pattern = /\b(use[A-Z]\w*)\s*\(/g;
+    let m;
+    while ((m = pattern.exec(source)) !== null) {
+        const name = m[1];
+        total++;
+        if (name === "useState")
+            state++;
+        else if (name === "useEffect")
+            effect++;
+    }
+    return { total, state, effect };
+}
+/**
+ * Estimate max JSX nesting depth by tracking < and </.
+ * Counts opening tags (<PascalCase or <lowercase) minus self-closing.
+ * Heuristic: scan linearly and track stack depth.
+ */
+function estimateJsxDepth(source) {
+    let maxDepth = 0;
+    let depth = 0;
+    // Match: <TagName ...>  or  </TagName>  or  <TagName .../>
+    const tagPattern = /<(\/?)([A-Za-z][\w.]*)[^>]*?(\/?)>/g;
+    let m;
+    while ((m = tagPattern.exec(source)) !== null) {
+        const closing = m[1] === "/";
+        const selfClosing = m[3] === "/";
+        if (closing) {
+            if (depth > 0)
+                depth--;
+        }
+        else if (!selfClosing) {
+            depth++;
+            if (depth > maxDepth)
+                maxDepth = depth;
+        }
+        // self-closing: no change to depth
+    }
+    return maxDepth;
+}
 /**
  * Estimate max nesting depth by tracking brace depth around control flow.
  * Simple heuristic: count opening braces after control flow keywords.
@@ -73,10 +129,17 @@ export async function analyzeComplexity(repo, options) {
     const minComplexity = options?.min_complexity ?? 1;
     const includeTests = options?.include_tests ?? false;
     const filePattern = options?.file_pattern;
+    // Build a language lookup for SQL file exclusion
+    const sqlFiles = new Set(index.files
+        .filter((f) => f.language === "sql" || f.language === "sql-jinja")
+        .map((f) => f.path));
     // Filter to analyzable symbols
     const symbols = index.symbols.filter((s) => {
         if (!ANALYZABLE_KINDS.has(s.kind))
             return false;
+        // Skip SQL files — cyclomatic complexity is meaningless for DDL
+        if (sqlFiles.has(s.file))
+            return false;
         if (!s.source || s.source.length < 10)
             return false;
         if (!includeTests && isTestFile(s.file))
@@ -93,7 +156,7 @@ export async function analyzeComplexity(repo, options) {
         const complexity = branches + 1;
         const nesting = estimateMaxNesting(source);
         if (complexity >= minComplexity) {
-            results.push({
+            const info = {
                 name: sym.name,
                 kind: sym.kind,
                 file: sym.file,
@@ -103,7 +166,18 @@ export async function analyzeComplexity(repo, options) {
                 cyclomatic_complexity: complexity,
                 max_nesting_depth: nesting,
                 branches,
-            });
+            };
+            // React-specific metrics for components and hooks
+            if (sym.kind === "component" || sym.kind === "hook") {
+                const hooks = countReactHooks(source);
+                info.hook_count = hooks.total;
+                info.state_count = hooks.state;
+                info.effect_count = hooks.effect;
+                if (sym.kind === "component") {
+                    info.jsx_depth = estimateJsxDepth(source);
+                }
+            }
+            results.push(info);
         }
     }
     // Sort by complexity descending

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

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

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

@@ -0,0 +1,60 @@
+export interface ComposeTreeNode {
+    name: string;
+    file: string;
+    start_line: number;
+    is_preview: boolean;
+    children: ComposeTreeNode[];
+}
+export interface ComposeTreeResult {
+    root: ComposeTreeNode;
+    total_components: number;
+    max_depth: number;
+    leaf_components: string[];
+}
+/**
+ * Build the Compose component call tree rooted at `rootName`. Walks
+ * @Composable function bodies lexically to find PascalCase calls matching
+ * other indexed composables. @Preview composables are excluded from the
+ * tree since they're design-time only.
+ *
+ * Cycle-safe: visited set prevents infinite recursion on A→B→A patterns.
+ */
+export declare function traceComposeTree(repo: string, rootName: string, options?: {
+    depth?: number;
+}): Promise<ComposeTreeResult>;
+export interface RecompositionIssue {
+    component: string;
+    file: string;
+    start_line: number;
+    issue: string;
+    severity: "warning" | "critical";
+    param?: string;
+}
+export interface RecompositionResult {
+    issues: RecompositionIssue[];
+    components_scanned: number;
+    components_with_issues: number;
+}
+/**
+ * Scan @Composable functions for recomposition hazards.
+ *
+ * Detects:
+ * 1. **Unstable lambda params** — function-type parameter without `remember`
+ *    wrapper at call site; every recomposition allocates a new closure, causing
+ *    the child to recompose even when nothing changed.
+ * 2. **Mutable collections** — `List<T>` / `MutableList<T>` / `Map<K,V>` /
+ *    `Set<T>` params that aren't `@Stable` / `@Immutable` annotated; Compose
+ *    can't skip recomposition because it can't prove the collection hasn't
+ *    mutated between compositions.
+ * 3. **Missing remember for state allocation** — `mutableStateOf()` /
+ *    `mutableStateListOf()` / `derivedStateOf()` called without a `remember`
+ *    wrapper; the state resets on every recomposition, causing infinite loops
+ *    or lost user input.
+ * 4. **Inline object allocation** — `object : ClickListener { }` or
+ *    `SomeClass()` constructed inside composition body; creates new identity
+ *    every frame.
+ */
+export declare function analyzeComposeRecomposition(repo: string, options?: {
+    file_pattern?: string;
+}): Promise<RecompositionResult>;
+//# sourceMappingURL=compose-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose-tools.d.ts","sourceRoot":"","sources":["../../src/tools/compose-tools.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AA0BD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CA6E5B;AAMD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,GAAG,UAAU,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC,OAAO,CAAC,mBAAmB,CAAC,CA+E9B"}

package/dist/tools/compose-tools.js

@@ -0,0 +1,203 @@
+/**
+ * Jetpack Compose analysis tools.
+ *
+ * trace_compose_tree           — build component hierarchy from @Composable calls
+ * analyze_compose_recomposition — detect unstable params causing unnecessary recompositions
+ */
+import { getCodeIndex } from "./index-tools.js";
+/**
+ * Detect composable function calls inside a @Composable source body.
+ * Composable calls follow the PascalCase convention — we match any
+ * `UpperCaseName(` that corresponds to a known composable symbol.
+ *
+ * This is a lexical scan (not AST) for simplicity and speed. False
+ * positives from string literals or comments are unlikely in practice
+ * because PascalCase function calls are rare outside Compose.
+ */
+function findComposableCallees(source, composableNames) {
+    const callees = new Set();
+    // Match PascalCase identifier immediately followed by ( or (with space)
+    const callRe = /\b([A-Z][a-zA-Z0-9]+)\s*\(/g;
+    let m;
+    while ((m = callRe.exec(source)) !== null) {
+        const name = m[1];
+        if (composableNames.has(name))
+            callees.add(name);
+    }
+    return [...callees];
+}
+/**
+ * Build the Compose component call tree rooted at `rootName`. Walks
+ * @Composable function bodies lexically to find PascalCase calls matching
+ * other indexed composables. @Preview composables are excluded from the
+ * tree since they're design-time only.
+ *
+ * Cycle-safe: visited set prevents infinite recursion on A→B→A patterns.
+ */
+export async function traceComposeTree(repo, rootName, options) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    }
+    const maxDepth = options?.depth ?? 10;
+    // Index all composables by name (excluding @Preview).
+    const composablesByName = new Map();
+    const composableNames = new Set();
+    for (const sym of index.symbols) {
+        if (sym.kind !== "component")
+            continue;
+        if (sym.meta?.["compose_preview"])
+            continue;
+        if (!composablesByName.has(sym.name)) {
+            composablesByName.set(sym.name, sym);
+        }
+        composableNames.add(sym.name);
+    }
+    const root = composablesByName.get(rootName);
+    if (!root) {
+        throw new Error(`"${rootName}" is not a @Composable function. Ensure the file is indexed and the function has the @Composable annotation.`);
+    }
+    const visited = new Set();
+    const allVisited = new Set();
+    const leafComponents = [];
+    function buildNode(sym, depth) {
+        allVisited.add(sym.name);
+        const node = {
+            name: sym.name,
+            file: sym.file,
+            start_line: sym.start_line,
+            is_preview: !!sym.meta?.["compose_preview"],
+            children: [],
+        };
+        if (depth >= maxDepth || visited.has(sym.id))
+            return node;
+        visited.add(sym.id);
+        const source = sym.source ?? "";
+        const callees = findComposableCallees(source, composableNames);
+        for (const calleeName of callees) {
+            if (calleeName === sym.name)
+                continue; // skip self-reference
+            const calleeSym = composablesByName.get(calleeName);
+            if (!calleeSym)
+                continue;
+            if (visited.has(calleeSym.id))
+                continue; // cycle protection
+            node.children.push(buildNode(calleeSym, depth + 1));
+        }
+        if (node.children.length === 0 && depth > 0) {
+            leafComponents.push(sym.name);
+        }
+        visited.delete(sym.id); // allow revisit from different parent (DAG, not tree)
+        return node;
+    }
+    const rootNode = buildNode(root, 0);
+    // Compute max depth.
+    function getDepth(n) {
+        if (n.children.length === 0)
+            return 0;
+        return 1 + Math.max(...n.children.map(getDepth));
+    }
+    return {
+        root: rootNode,
+        total_components: allVisited.size,
+        max_depth: getDepth(rootNode),
+        leaf_components: [...new Set(leafComponents)].sort(),
+    };
+}
+/**
+ * Scan @Composable functions for recomposition hazards.
+ *
+ * Detects:
+ * 1. **Unstable lambda params** — function-type parameter without `remember`
+ *    wrapper at call site; every recomposition allocates a new closure, causing
+ *    the child to recompose even when nothing changed.
+ * 2. **Mutable collections** — `List<T>` / `MutableList<T>` / `Map<K,V>` /
+ *    `Set<T>` params that aren't `@Stable` / `@Immutable` annotated; Compose
+ *    can't skip recomposition because it can't prove the collection hasn't
+ *    mutated between compositions.
+ * 3. **Missing remember for state allocation** — `mutableStateOf()` /
+ *    `mutableStateListOf()` / `derivedStateOf()` called without a `remember`
+ *    wrapper; the state resets on every recomposition, causing infinite loops
+ *    or lost user input.
+ * 4. **Inline object allocation** — `object : ClickListener { }` or
+ *    `SomeClass()` constructed inside composition body; creates new identity
+ *    every frame.
+ */
+export async function analyzeComposeRecomposition(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    }
+    const issues = [];
+    let scanned = 0;
+    const withIssues = new Set();
+    for (const sym of index.symbols) {
+        if (sym.kind !== "component")
+            continue;
+        if (sym.meta?.["compose_preview"])
+            continue;
+        if (options?.file_pattern && !sym.file.includes(options.file_pattern))
+            continue;
+        scanned++;
+        const source = sym.source ?? "";
+        // Issue 1: missing `remember` around state allocation.
+        const stateAllocRe = /\b(mutableStateOf|mutableStateListOf|mutableIntStateOf|mutableFloatStateOf|mutableDoubleStateOf|mutableLongStateOf|derivedStateOf)\s*[<(]/g;
+        let m;
+        while ((m = stateAllocRe.exec(source)) !== null) {
+            // Check if `remember` appears in the ~80 chars before this match.
+            const preceding = source.slice(Math.max(0, m.index - 80), m.index);
+            if (!/\bremember\b/.test(preceding)) {
+                const lineOffset = source.slice(0, m.index).split("\n").length - 1;
+                issues.push({
+                    component: sym.name,
+                    file: sym.file,
+                    start_line: sym.start_line + lineOffset,
+                    issue: `${m[1]} without remember {} wrapper — state resets every recomposition`,
+                    severity: "critical",
+                });
+                withIssues.add(sym.name);
+            }
+        }
+        // Issue 2: unstable collection params.
+        const sig = sym.signature ?? "";
+        const collectionParamRe = /(\w+)\s*:\s*((?:Mutable)?(?:List|Map|Set|ArrayList|HashMap|HashSet))\s*[<,)]/g;
+        while ((m = collectionParamRe.exec(sig)) !== null) {
+            const issueEntry = {
+                component: sym.name,
+                file: sym.file,
+                start_line: sym.start_line,
+                issue: `Parameter "${m[1]}" is ${m[2]}<...> — unstable collection type; Compose can't skip recomposition. Use kotlinx.collections.immutable or wrap in @Stable/@Immutable.`,
+                severity: "warning",
+            };
+            if (m[1] != null)
+                issueEntry.param = m[1];
+            issues.push(issueEntry);
+            withIssues.add(sym.name);
+        }
+        // Issue 3: function-type params likely passed as unstable lambda at call sites.
+        // Detect `() -> Unit` / `(T) -> Unit` style params — these are guaranteed
+        // unstable unless caller wraps them in remember.
+        const lambdaParamRe = /(\w+)\s*:\s*(?:\([^)]*\)\s*->\s*\w+)/g;
+        let lambdaParamCount = 0;
+        while ((m = lambdaParamRe.exec(sig)) !== null) {
+            lambdaParamCount++;
+        }
+        // Only warn when there are many lambda params — 1-2 is standard (onClick, etc.)
+        if (lambdaParamCount > 3) {
+            issues.push({
+                component: sym.name,
+                file: sym.file,
+                start_line: sym.start_line,
+                issue: `${lambdaParamCount} function-type parameters — each one causes recomposition unless caller wraps in remember. Consider extracting state hoisting pattern.`,
+                severity: "warning",
+            });
+            withIssues.add(sym.name);
+        }
+    }
+    return {
+        issues,
+        components_scanned: scanned,
+        components_with_issues: withIssues.size,
+    };
+}
+//# sourceMappingURL=compose-tools.js.map

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

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

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

@@ -0,0 +1,50 @@
+export interface FanMetric {
+    file: string;
+    count: number;
+    connections: string[];
+}
+export interface FanInFanOutResult {
+    fan_in_top: FanMetric[];
+    fan_out_top: FanMetric[];
+    hub_files: FanMetric[];
+    coupling_score: number;
+    total_files: number;
+    total_edges: number;
+}
+export interface CoChangePair {
+    file_a: string;
+    file_b: string;
+    co_commits: number;
+    jaccard: number;
+    support_a: number;
+    support_b: number;
+}
+export interface CoChangeResult {
+    pairs: CoChangePair[];
+    clusters: string[][];
+    total_commits_analyzed: number;
+    period: string;
+}
+export declare function fanInFanOut(repo: string, options?: {
+    path?: string;
+    top_n?: number;
+    level?: "file";
+    min_fan_in?: number;
+    min_fan_out?: number;
+}): Promise<FanInFanOutResult>;
+export declare function computeCoChangePairs(repoRoot: string, options?: {
+    since_days?: number;
+    min_support?: number;
+    max_files_per_commit?: number;
+}): {
+    pairs: CoChangePair[];
+    total_commits: number;
+};
+export declare function coChangeAnalysis(repo: string, options?: {
+    since_days?: number;
+    min_support?: number;
+    min_jaccard?: number;
+    path?: string;
+    top_n?: number;
+}): Promise<CoChangeResult>;
+//# sourceMappingURL=coupling-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coupling-tools.d.ts","sourceRoot":"","sources":["../../src/tools/coupling-tools.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC;IACrB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,iBAAiB,CAAC,CAiG5B;AAUD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,GACA;IAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAsGlD;AAMD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,cAAc,CAAC,CAqCzB"}