codesift-mcp 0.1.0

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

@@ -0,0 +1,22 @@
+import type { CodeSymbol } from "../types.js";
+export interface DiffOutlineResult {
+    added: CodeSymbol[];
+    modified: CodeSymbol[];
+    deleted: string[];
+}
+export interface ChangedFileSymbols {
+    file: string;
+    symbols: string[];
+}
+/**
+ * Outline of changes between two git refs.
+ * Classifies symbols as added (in new files), modified (overlapping changed hunks),
+ * or deleted (in removed files).
+ */
+export declare function diffOutline(repo: string, since: string, until?: string): Promise<DiffOutlineResult>;
+/**
+ * List all symbol names in each changed file.
+ * Simplified version of diffOutline that only reports symbol names per file.
+ */
+export declare function changedSymbols(repo: string, since: string, until?: string): Promise<ChangedFileSymbols[]>;
+//# sourceMappingURL=diff-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff-tools.d.ts","sourceRoot":"","sources":["../../src/tools/diff-tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAsGD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC,CAsC5B;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAsC/B"}

package/dist/tools/diff-tools.js

@@ -0,0 +1,165 @@
+import { execSync } from "node:child_process";
+import { getCodeIndex } from "./index-tools.js";
+import { validateGitRef } from "../utils/git-validation.js";
+/**
+ * Parse unified diff output to extract changed file paths and line ranges.
+ */
+function parseDiffHunks(diffOutput) {
+    const hunks = [];
+    const newFiles = [];
+    const deletedFiles = [];
+    let currentFile = null;
+    let isNewFile = false;
+    let isDeletedFile = false;
+    for (const line of diffOutput.split("\n")) {
+        // Detect file header: diff --git a/path b/path
+        if (line.startsWith("diff --git")) {
+            const match = /diff --git a\/.+ b\/(.+)/.exec(line);
+            if (match?.[1]) {
+                currentFile = match[1];
+                isNewFile = false;
+                isDeletedFile = false;
+            }
+            continue;
+        }
+        // Detect new file
+        if (line.startsWith("new file mode")) {
+            isNewFile = true;
+            if (currentFile) {
+                newFiles.push(currentFile);
+            }
+            continue;
+        }
+        // Detect deleted file
+        if (line.startsWith("deleted file mode")) {
+            isDeletedFile = true;
+            if (currentFile) {
+                deletedFiles.push(currentFile);
+            }
+            continue;
+        }
+        // Parse hunk headers: @@ -old,count +new,count @@
+        if (line.startsWith("@@") && currentFile && !isNewFile && !isDeletedFile) {
+            const hunkMatch = /@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@/.exec(line);
+            if (hunkMatch?.[1]) {
+                const startLine = parseInt(hunkMatch[1], 10);
+                const lineCount = hunkMatch[2] !== undefined ? parseInt(hunkMatch[2], 10) : 1;
+                hunks.push({ file: currentFile, startLine, lineCount });
+            }
+        }
+    }
+    return { hunks, newFiles, deletedFiles };
+}
+/**
+ * Check if a symbol overlaps with any of the changed line ranges.
+ */
+function symbolOverlapsHunks(symbol, hunks) {
+    for (const hunk of hunks) {
+        if (hunk.file !== symbol.file)
+            continue;
+        const hunkEnd = hunk.startLine + hunk.lineCount - 1;
+        // Overlap: symbol range intersects hunk range
+        if (symbol.start_line <= hunkEnd && symbol.end_line >= hunk.startLine) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Run git diff and return the raw output.
+ */
+function runGitDiff(repoRoot, since, until, nameOnly) {
+    validateGitRef(since);
+    validateGitRef(until);
+    const flag = nameOnly ? "--name-only" : "";
+    const cmd = `git diff ${flag} ${since}..${until}`.trim();
+    try {
+        return execSync(cmd, {
+            cwd: repoRoot,
+            encoding: "utf-8",
+            timeout: 10_000,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Git diff failed: ${message}`);
+    }
+}
+/**
+ * Outline of changes between two git refs.
+ * Classifies symbols as added (in new files), modified (overlapping changed hunks),
+ * or deleted (in removed files).
+ */
+export async function diffOutline(repo, since, until) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository not found: ${repo}`);
+    }
+    const untilRef = until ?? "HEAD";
+    const diffOutput = runGitDiff(index.root, since, untilRef, false);
+    const { hunks, newFiles, deletedFiles } = parseDiffHunks(diffOutput);
+    const newFileSet = new Set(newFiles);
+    const deletedFileSet = new Set(deletedFiles);
+    const added = [];
+    const modified = [];
+    for (const sym of index.symbols) {
+        // Symbols in new files are "added"
+        if (newFileSet.has(sym.file)) {
+            added.push(sym);
+            continue;
+        }
+        // Skip symbols in deleted files (they won't be in the index anyway,
+        // but guard just in case)
+        if (deletedFileSet.has(sym.file))
+            continue;
+        // Check if symbol overlaps with any changed hunk
+        if (symbolOverlapsHunks(sym, hunks)) {
+            modified.push(sym);
+        }
+    }
+    return {
+        added,
+        modified,
+        deleted: deletedFiles,
+    };
+}
+/**
+ * List all symbol names in each changed file.
+ * Simplified version of diffOutline that only reports symbol names per file.
+ */
+export async function changedSymbols(repo, since, until) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository not found: ${repo}`);
+    }
+    const untilRef = until ?? "HEAD";
+    const output = runGitDiff(index.root, since, untilRef, true);
+    const changedFiles = output
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    const changedFileSet = new Set(changedFiles);
+    // Group symbols by file
+    const symbolsByFile = new Map();
+    for (const sym of index.symbols) {
+        if (!changedFileSet.has(sym.file))
+            continue;
+        const existing = symbolsByFile.get(sym.file);
+        if (existing) {
+            existing.push(sym.name);
+        }
+        else {
+            symbolsByFile.set(sym.file, [sym.name]);
+        }
+    }
+    const result = [];
+    for (const file of changedFiles) {
+        const symbols = symbolsByFile.get(file);
+        if (symbols && symbols.length > 0) {
+            result.push({ file, symbols });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=diff-tools.js.map

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

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

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

@@ -0,0 +1,11 @@
+export interface GenerateClaudeMdResult {
+    content: string;
+    path?: string;
+}
+/**
+ * Generate a CLAUDE.md architecture overview for a repository.
+ * Analyzes the index to produce a summary of files, symbols, languages,
+ * and directory structure.
+ */
+export declare function generateClaudeMd(repo: string, outputPath?: string): Promise<GenerateClaudeMdResult>;
+//# sourceMappingURL=generate-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tools.d.ts","sourceRoot":"","sources":["../../src/tools/generate-tools.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAuGD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,sBAAsB,CAAC,CAsDjC"}

package/dist/tools/generate-tools.js

@@ -0,0 +1,135 @@
+import { writeFile } from "node:fs/promises";
+import { getCodeIndex } from "./index-tools.js";
+/**
+ * Count symbols per top-level directory from the index.
+ */
+function countByDirectory(index) {
+    const dirStats = new Map();
+    for (const file of index.files) {
+        const dir = getTopDirectory(file.path);
+        const existing = dirStats.get(dir);
+        if (existing) {
+            existing.fileCount += 1;
+            existing.symbolCount += file.symbol_count;
+        }
+        else {
+            dirStats.set(dir, { fileCount: 1, symbolCount: file.symbol_count });
+        }
+    }
+    return dirStats;
+}
+/**
+ * Get the top-level directory from a file path.
+ * For "src/tools/index.ts" returns "src/tools".
+ * For "index.ts" returns ".".
+ */
+function getTopDirectory(filePath) {
+    const lastSlash = filePath.lastIndexOf("/");
+    if (lastSlash < 0)
+        return ".";
+    return filePath.slice(0, lastSlash);
+}
+/**
+ * Count files per language.
+ */
+function countByLanguage(files) {
+    const langCounts = new Map();
+    for (const file of files) {
+        langCounts.set(file.language, (langCounts.get(file.language) ?? 0) + 1);
+    }
+    return langCounts;
+}
+/**
+ * Detect the tech stack from file patterns in the index.
+ */
+function detectTechStack(index) {
+    const stack = [];
+    const fileSet = new Set(index.files.map((f) => f.path));
+    const extensions = new Set(index.files.map((f) => {
+        const dot = f.path.lastIndexOf(".");
+        return dot >= 0 ? f.path.slice(dot) : "";
+    }));
+    // TypeScript
+    if (extensions.has(".ts") || extensions.has(".tsx")) {
+        stack.push("TypeScript");
+    }
+    // JavaScript
+    if (extensions.has(".js") || extensions.has(".jsx")) {
+        stack.push("JavaScript");
+    }
+    // Python
+    if (extensions.has(".py")) {
+        stack.push("Python");
+    }
+    // Detect frameworks from common config files or paths
+    const hasFile = (pattern) => {
+        for (const path of fileSet) {
+            if (path.includes(pattern))
+                return true;
+        }
+        return false;
+    };
+    if (hasFile("next.config"))
+        stack.push("Next.js");
+    if (hasFile("vite.config"))
+        stack.push("Vite");
+    if (hasFile("nest-cli.json") || hasFile("@nestjs"))
+        stack.push("NestJS");
+    if (hasFile("prisma/schema.prisma"))
+        stack.push("Prisma");
+    if (hasFile("tailwind.config"))
+        stack.push("Tailwind CSS");
+    return stack;
+}
+/**
+ * Format the language breakdown string.
+ * Example: "typescript (45), javascript (12), python (3)"
+ */
+function formatLanguageBreakdown(langCounts) {
+    const sorted = [...langCounts.entries()].sort((a, b) => b[1] - a[1]);
+    return sorted.map(([lang, count]) => `${lang} (${count})`).join(", ");
+}
+/**
+ * Generate a CLAUDE.md architecture overview for a repository.
+ * Analyzes the index to produce a summary of files, symbols, languages,
+ * and directory structure.
+ */
+export async function generateClaudeMd(repo, outputPath) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository not found: ${repo}`);
+    }
+    const langCounts = countByLanguage(index.files);
+    const dirStats = countByDirectory(index);
+    const techStack = detectTechStack(index);
+    const lines = [];
+    lines.push("## Architecture Overview (auto-generated by codesift)");
+    lines.push("");
+    // Summary line
+    const langBreakdown = formatLanguageBreakdown(langCounts);
+    lines.push(`**${index.file_count} files, ${index.symbol_count} symbols** | Languages: ${langBreakdown}`);
+    // Tech stack if detected
+    if (techStack.length > 0) {
+        lines.push(`**Tech stack:** ${techStack.join(", ")}`);
+    }
+    lines.push("");
+    // Directory breakdown, sorted by symbol count descending
+    const sortedDirs = [...dirStats.entries()].sort((a, b) => b[1].symbolCount - a[1].symbolCount);
+    for (const [dir, stats] of sortedDirs) {
+        lines.push(`**${dir}/** (${stats.fileCount} files, ${stats.symbolCount} symbols)`);
+    }
+    lines.push("");
+    const content = lines.join("\n");
+    if (outputPath) {
+        try {
+            await writeFile(outputPath, content, "utf-8");
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new Error(`Failed to write CLAUDE.md: ${message}`);
+        }
+        return { content, path: outputPath };
+    }
+    return { content };
+}
+//# sourceMappingURL=generate-tools.js.map

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

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

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

@@ -0,0 +1,60 @@
+import { isTestFileStrict as isTestFile } from "../utils/test-file.js";
+import type { CodeSymbol, Direction, CallNode, ImpactResult } from "../types.js";
+/**
+ * Pre-computed adjacency lists for O(1) lookup during BFS.
+ * Built once per traceCallChain / impactAnalysis call.
+ */
+interface AdjacencyIndex {
+    /** symbol id → symbols that this symbol references (callees) */
+    callees: Map<string, CodeSymbol[]>;
+    /** symbol id → symbols that reference this symbol (callers) */
+    callers: Map<string, CodeSymbol[]>;
+}
+/**
+ * Extract identifiers that look like function/method calls from source code.
+ * Matches patterns like: `functionName(`, `obj.methodName(`, `this.method(`
+ * Returns a Set of the called identifier names.
+ */
+declare function extractCallSites(source: string): Set<string>;
+/**
+ * Build caller/callee adjacency lists by extracting actual call sites from source code.
+ *
+ * For each symbol with source, extracts identifiers used as function calls (pattern: `name(`)
+ * and looks them up in the symbol name index. This produces much more accurate edges than
+ * simple word-boundary matching, which matches any mention of a symbol name.
+ *
+ * @param allSymbols - All symbols in the index
+ * @param skipTests - If true, exclude symbols from test files (default: true)
+ */
+declare function buildAdjacencyIndex(allSymbols: CodeSymbol[], skipTests?: boolean): AdjacencyIndex;
+/**
+ * BFS traversal to build a call chain tree up to the given depth.
+ * Uses pre-built adjacency index for O(1) neighbor lookups.
+ * Enforces MAX_TREE_NODES and MAX_CHILDREN_PER_NODE limits.
+ */
+declare function buildCallTree(root: CodeSymbol, adjacency: AdjacencyIndex, direction: Direction, maxDepth: number): CallNode;
+export interface TraceOptions {
+    depth?: number | undefined;
+    include_source?: boolean | undefined;
+    include_tests?: boolean | undefined;
+}
+/**
+ * Trace the call chain for a symbol in a repository.
+ * Returns a tree of callers or callees up to the specified depth.
+ * By default, source code is stripped from symbols to keep output compact.
+ * Test files are excluded by default (use include_tests: true to include them).
+ */
+export declare function traceCallChain(repo: string, symbolName: string, direction: Direction, depthOrOptions?: number | TraceOptions): Promise<CallNode>;
+export interface ImpactOptions {
+    depth?: number | undefined;
+    until?: string | undefined;
+    include_source?: boolean | undefined;
+}
+/**
+ * Analyze the impact of recent git changes on a repository.
+ * Finds changed files, affected symbols, and builds a dependency graph.
+ * By default, source code is stripped from symbols to keep output compact.
+ */
+export declare function impactAnalysis(repo: string, since: string, depthOrOptions?: number | ImpactOptions, until?: string): Promise<ImpactResult>;
+export { buildAdjacencyIndex, extractCallSites, buildCallTree, isTestFile };
+//# sourceMappingURL=graph-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-tools.d.ts","sourceRoot":"","sources":["../../src/tools/graph-tools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,IAAI,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAa,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmB5F;;;GAGG;AACH,UAAU,cAAc;IACtB,gEAAgE;IAChE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACnC,+DAA+D;IAC/D,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAgBrD;AAcD;;;;;;;;;GASG;AACH,iBAAS,mBAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,SAAS,UAAO,GAAG,cAAc,CAkDvF;AAED;;;;GAIG;AACH,iBAAS,aAAa,CACpB,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,MAAM,GACf,QAAQ,CA0BV;AAoBD,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,SAAS,EACpB,cAAc,CAAC,EAAE,MAAM,GAAG,YAAY,GACrC,OAAO,CAAC,QAAQ,CAAC,CAsCnB;AAkGD,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GAAG,aAAa,EACvC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC,CA8CvB;AAGD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC"}