codesift-mcp 0.9.5 → 0.9.10

package/dist/tools/kotlin-suspend-tools.js

@@ -0,0 +1,161 @@
+import { getCodeIndex } from "./index-tools.js";
+function canonicalizeDispatcherName(raw) {
+    const lower = raw.toLowerCase();
+    if (lower === "io")
+        return "IO";
+    if (lower === "main" || lower === "mainimmediate")
+        return "Main";
+    if (lower === "default")
+        return "Default";
+    if (lower === "unconfined")
+        return "Unconfined";
+    return raw;
+}
+function classifyDispatcherExpression(expr) {
+    const staticMatch = /^Dispatchers\.(\w+)$/.exec(expr);
+    if (staticMatch)
+        return canonicalizeDispatcherName(staticMatch[1]);
+    const fieldMatch = /^[a-z]\w*\.(io|main|default|unconfined)$/i.exec(expr);
+    if (fieldMatch)
+        return canonicalizeDispatcherName(fieldMatch[1]);
+    const conventionMatch = /^(io|main|default|unconfined)Dispatcher$/i.exec(expr);
+    if (conventionMatch)
+        return canonicalizeDispatcherName(conventionMatch[1]);
+    return null;
+}
+function isSuspendFunction(symbol) {
+    if (symbol.kind !== "function" && symbol.kind !== "method")
+        return false;
+    if (symbol.signature?.startsWith("suspend"))
+        return true;
+    const head = symbol.source?.slice(0, 200);
+    return head ? /\bsuspend\s+fun\b/.test(head) : false;
+}
+function sourceLine(symbol, matchIndex) {
+    return symbol.start_line + (symbol.source ?? "").slice(0, matchIndex).split("\n").length - 1;
+}
+function collectDispatcherTransitions(symbol) {
+    const transitions = [];
+    const source = symbol.source ?? "";
+    const dispatcherPattern = /withContext\s*\(\s*([A-Za-z_][\w.]*)\s*[,)]/g;
+    let match;
+    while ((match = dispatcherPattern.exec(source)) !== null) {
+        const dispatcher = classifyDispatcherExpression(match[1]);
+        if (dispatcher) {
+            transitions.push({ function: symbol.name, dispatcher, line: sourceLine(symbol, match.index) });
+        }
+    }
+    return transitions;
+}
+function blockingWarning(symbol, pattern, message) {
+    const match = pattern.exec(symbol.source ?? "");
+    return match ? {
+        function: symbol.name,
+        file: symbol.file,
+        line: sourceLine(symbol, match.index),
+        message,
+        severity: "critical",
+    } : undefined;
+}
+function cancellationWarning(symbol) {
+    const source = symbol.source ?? "";
+    const match = /\bwhile\s*\(\s*true\s*\)\s*\{/.exec(source);
+    if (!match)
+        return undefined;
+    const bodyStart = match.index + match[0].length;
+    let depth = 1;
+    let bodyEnd = bodyStart;
+    for (let index = bodyStart; index < source.length && depth > 0; index++) {
+        if (source[index] === "{")
+            depth++;
+        else if (source[index] === "}")
+            depth--;
+        bodyEnd = index;
+    }
+    const body = source.slice(bodyStart, bodyEnd);
+    const isCancellable = /\bensureActive\s*\(/.test(body)
+        || /\bisActive\b/.test(body)
+        || /\bcoroutineContext\.isActive\b/.test(body);
+    return isCancellable ? undefined : {
+        function: symbol.name,
+        file: symbol.file,
+        line: sourceLine(symbol, match.index),
+        message: "while(true) loop without ensureActive()/isActive — loop is not cancellable, coroutine will leak",
+        severity: "warning",
+    };
+}
+function analyzeSuspendBody(symbol) {
+    const warnings = [
+        blockingWarning(symbol, /\brunBlocking\s*[\{(]/, "runBlocking inside a suspend function — deadlock risk on caller's dispatcher"),
+        blockingWarning(symbol, /\bThread\.sleep\s*\(/, "Thread.sleep() in suspend function — blocks dispatcher thread, use delay() instead"),
+        cancellationWarning(symbol),
+    ].filter((warning) => warning !== undefined);
+    return { warnings, transitions: collectDispatcherTransitions(symbol) };
+}
+function walkSuspendChain(symbol, level, state) {
+    if (state.visited.has(symbol.id) || level > state.maxDepth)
+        return;
+    state.visited.add(symbol.id);
+    state.chain.push(symbol.name);
+    const analysis = analyzeSuspendBody(symbol);
+    state.warnings.push(...analysis.warnings);
+    state.transitions.push(...analysis.transitions);
+    if (level === state.maxDepth)
+        return;
+    const callPattern = /\b([A-Za-z_]\w*)\s*\(/g;
+    const keywords = new Set(["catch", "for", "if", "try", "when", "while"]);
+    const calleesSeen = new Set();
+    let match;
+    while ((match = callPattern.exec(symbol.source ?? "")) !== null) {
+        const name = match[1];
+        if (name === symbol.name || keywords.has(name) || calleesSeen.has(name))
+            continue;
+        calleesSeen.add(name);
+        for (const callee of state.suspendByName.get(name) ?? []) {
+            if (callee.id !== symbol.id)
+                walkSuspendChain(callee, level + 1, state);
+        }
+    }
+}
+/** Trace a suspend call chain and report dispatcher transitions and warnings. */
+export async function traceSuspendChain(repo, functionName, 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 ?? 3;
+    if (!Number.isInteger(maxDepth) || maxDepth < 0) {
+        throw new Error("depth must be a non-negative integer");
+    }
+    const root = index.symbols.find((symbol) => symbol.name === functionName
+        && (symbol.kind === "function" || symbol.kind === "method"));
+    if (!root)
+        throw new Error(`Suspend function "${functionName}" not found.`);
+    if (!isSuspendFunction(root))
+        throw new Error(`"${functionName}" is not a suspend function.`);
+    const suspendByName = new Map();
+    for (const symbol of index.symbols) {
+        if (!isSuspendFunction(symbol))
+            continue;
+        const overloads = suspendByName.get(symbol.name) ?? [];
+        overloads.push(symbol);
+        suspendByName.set(symbol.name, overloads);
+    }
+    const state = {
+        maxDepth,
+        suspendByName,
+        chain: [],
+        visited: new Set(),
+        warnings: [],
+        transitions: [],
+    };
+    walkSuspendChain(root, 0, state);
+    return {
+        root: root.name,
+        chain: state.chain,
+        dispatcher_transitions: state.transitions,
+        warnings: state.warnings,
+        depth: maxDepth,
+    };
+}
+//# sourceMappingURL=kotlin-suspend-tools.js.map

package/dist/tools/kotlin-suspend-tools.js.map

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

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

@@ -1,142 +1,7 @@
-export interface ExtensionFunctionResult {
-    receiver_type: string;
-    extensions: Array<{
-        name: string;
-        file: string;
-        start_line: number;
-        signature?: string;
-        docstring?: string;
-    }>;
-    total: number;
-}
-/**
- * Find all extension functions defined for a given receiver type.
- * Scans Kotlin symbol signatures for the `ReceiverType.` prefix pattern.
- */
-export declare function findExtensionFunctions(repo: string, receiverType: string, options?: {
-    file_pattern?: string;
-}): Promise<ExtensionFunctionResult>;
-export interface SealedHierarchyResult {
-    sealed_class: {
-        name: string;
-        file: string;
-        start_line: number;
-        kind: string;
-    };
-    subtypes: Array<{
-        name: string;
-        file: string;
-        start_line: number;
-        kind: string;
-    }>;
-    when_blocks: Array<{
-        file: string;
-        line: number;
-        branches_found: string[];
-        branches_missing: string[];
-        is_exhaustive: boolean;
-    }>;
-    total_subtypes: number;
-    total_when_blocks: number;
-    all_exhaustive: boolean;
-}
-/**
- * Analyze a sealed class/interface hierarchy.
- * Finds all subtypes and checks when() blocks for exhaustiveness.
- */
-export declare function analyzeSealedHierarchy(repo: string, sealedClassName: string): Promise<SealedHierarchyResult>;
-export interface SuspendDispatcherTransition {
-    function: string;
-    dispatcher: string;
-    line: number;
-}
-export interface SuspendWarning {
-    function: string;
-    file: string;
-    line: number;
-    message: string;
-    severity: "warning" | "critical";
-}
-export interface SuspendChainResult {
-    root: string;
-    chain: string[];
-    dispatcher_transitions: SuspendDispatcherTransition[];
-    warnings: SuspendWarning[];
-    depth: number;
-}
-/**
- * Trace the suspend function call chain starting from `functionName`. Walks
- * out up to `depth` levels through callees (identified by text scan of the
- * source), filtering to suspend-only nodes. Emits dispatcher transitions and
- * coroutine anti-pattern warnings for each visited function.
- *
- * Walk strategy: we look up each callee name in the symbol index. When a
- * function body contains `otherFn(`, we recurse into the symbol named
- * `otherFn` if it exists and is a suspend function. This is intentionally
- * lexical (not call-graph) — accurate enough for typical coroutine code and
- * avoids a full graph build.
- */
-export declare function traceSuspendChain(repo: string, functionName: string, options?: {
-    depth?: number;
-}): Promise<SuspendChainResult>;
-export interface KmpMatchedDeclaration {
-    name: string;
-    kind: string;
-    expect_source_set: string;
-    actual_source_sets: string[];
-}
-export interface KmpMissingDeclaration {
-    name: string;
-    kind: string;
-    source_set: string;
-    missing_from: string[];
-}
-export interface KmpOrphanDeclaration {
-    name: string;
-    kind: string;
-    source_set: string;
-    file: string;
-}
-export interface KmpAnalysisResult {
-    total_expects: number;
-    fully_matched: number;
-    source_sets_detected: string[];
-    matched: KmpMatchedDeclaration[];
-    missing_actuals: KmpMissingDeclaration[];
-    orphan_actuals: KmpOrphanDeclaration[];
-}
-/**
- * Analyze KMP expect/actual declarations across source sets. Groups symbols
- * tagged with `meta.kmp_modifier` by simple name, splits them into expects
- * and actuals, and reports three verdicts per declaration:
- *
- *   - matched:         commonMain expect + at least one platform actual
- *   - missing_actuals: commonMain expect but one or more platform source
- *                      sets (discovered from the index files list) have no
- *                      corresponding `actual`
- *   - orphan_actuals:  actual without any commonMain expect
- */
-export declare function analyzeKmpDeclarations(repo: string): Promise<KmpAnalysisResult>;
-export interface FlowChainResult {
-    root: string;
-    file: string;
-    start_line: number;
-    operators: string[];
-    operator_count: number;
-    has_terminal: boolean;
-    warnings: string[];
-}
-/**
- * Trace a Kotlin Flow operator chain from a function or property. Scans the
- * symbol source for `.operator(` calls matching known Flow operators, reports
- * the ordered chain, and flags common issues:
- *
- *   - `.collect` without `.catch` — unhandled exception in flow
- *   - `.stateIn(initialValue=...)` without a scope parameter — missing
- *     lifecycle binding (requires `viewModelScope` or `lifecycleScope`)
- *
- * The function name can be either a function returning Flow<T> or a property
- * initialized with a Flow chain.
- */
-export declare function traceFlowChain(repo: string, symbolName: string): Promise<FlowChainResult>;
+/** Stable facade for Kotlin-specific analysis capabilities. */
+export { findExtensionFunctions, type ExtensionFunctionResult, } from "./kotlin-extension-tools.js";
+export { analyzeSealedHierarchy, type SealedHierarchyResult, } from "./kotlin-sealed-tools.js";
+export { traceSuspendChain, type SuspendChainResult, type SuspendDispatcherTransition, type SuspendWarning, } from "./kotlin-suspend-tools.js";
+export { analyzeKmpDeclarations, type KmpAnalysisResult, type KmpMatchedDeclaration, type KmpMissingDeclaration, type KmpOrphanDeclaration, } from "./kotlin-kmp-tools.js";
+export { traceFlowChain, type FlowChainResult, } from "./kotlin-flow-tools.js";
 //# sourceMappingURL=kotlin-tools.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"kotlin-tools.d.ts","sourceRoot":"","sources":["../../src/tools/kotlin-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"kotlin-tools.d.ts","sourceRoot":"","sources":["../../src/tools/kotlin-tools.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,cAAc,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC"}