sdl-mcp 0.6.0

package/dist/code/gate.js

@@ -0,0 +1,134 @@
+import * as db from "../db/queries.js";
+import * as score from "../graph/score.js";
+import { loadConfig } from "../config/loadConfig.js";
+import { extractCodeWindow, identifiersExistInWindow } from "./windows.js";
+import { logger } from "../util/logger.js";
+/**
+ * Minimum utility score threshold for automatic code window approval.
+ * Symbols scoring above this threshold are considered high-value enough
+ * to approve without explicit justification.
+ */
+const UTILITY_SCORE_THRESHOLD = 0.3;
+export function evaluateRequest(request, context) {
+    const config = loadConfig();
+    const policy = context.policy ?? config.policy;
+    const window = extractCodeWindow(request.repoId, request.symbolId);
+    if (!window) {
+        return {
+            approved: false,
+            whyDenied: ["Symbol not found or invalid range"],
+            suggestedNextRequest: undefined,
+        };
+    }
+    const symbol = context.symbol || db.getSymbol(request.symbolId);
+    if (!symbol) {
+        return {
+            approved: false,
+            whyDenied: ["Symbol not found"],
+            suggestedNextRequest: undefined,
+        };
+    }
+    const whyApproved = [];
+    if (request.identifiersToFind.length > 0) {
+        if (window.approved &&
+            identifiersExistInWindow(window.code, request.identifiersToFind)) {
+            whyApproved.push("identifiers-exist");
+            return {
+                ...window,
+                whyApproved,
+            };
+        }
+    }
+    if (context.slice) {
+        const inCards = context.slice.cards.some((c) => c.symbolId === request.symbolId);
+        const inFrontier = context.slice.frontier?.some((f) => f.symbolId === request.symbolId);
+        if (inCards || inFrontier) {
+            whyApproved.push("in-slice-or-frontier");
+            if (window.approved) {
+                return {
+                    ...window,
+                    whyApproved,
+                };
+            }
+        }
+    }
+    const scoreContext = {
+        query: request.reason,
+    };
+    const utilityScore = score.scoreSymbol(symbol, scoreContext);
+    if (utilityScore > UTILITY_SCORE_THRESHOLD) {
+        whyApproved.push(`scorer-utility (${utilityScore.toFixed(2)})`);
+        if (window.approved) {
+            return {
+                ...window,
+                whyApproved,
+            };
+        }
+    }
+    const whyDenied = [];
+    const suggestedNextRequest = generateDenialGuidance(request, "general", policy);
+    if (request.expectedLines > policy.maxWindowLines) {
+        whyDenied.push(`Request exceeds maximum window lines (${request.expectedLines} > ${policy.maxWindowLines})`);
+    }
+    if (request.maxTokens && request.maxTokens > policy.maxWindowTokens) {
+        whyDenied.push(`Request exceeds maximum window tokens (${request.maxTokens} > ${policy.maxWindowTokens})`);
+    }
+    if (request.identifiersToFind.length === 0 && policy.requireIdentifiers) {
+        whyDenied.push("No identifiers to find provided");
+    }
+    else if (request.identifiersToFind.length > 0 &&
+        window.approved &&
+        !identifiersExistInWindow(window.code, request.identifiersToFind)) {
+        whyDenied.push("Identifiers not found in code window");
+    }
+    if (whyDenied.length === 0) {
+        whyDenied.push("Request does not meet approval criteria");
+    }
+    return {
+        approved: false,
+        whyDenied,
+        suggestedNextRequest,
+    };
+}
+export function generateDenialGuidance(request, reason, policyOverride) {
+    const config = loadConfig();
+    const policy = policyOverride ?? config.policy;
+    const suggestions = {};
+    if (request.expectedLines > policy.maxWindowLines) {
+        suggestions.expectedLines = policy.maxWindowLines;
+    }
+    if (request.maxTokens && request.maxTokens > policy.maxWindowTokens) {
+        suggestions.maxTokens = policy.maxWindowTokens;
+    }
+    if (request.identifiersToFind.length === 0) {
+        const symbol = db.getSymbol(request.symbolId);
+        if (symbol && symbol.signature_json) {
+            try {
+                const signature = JSON.parse(symbol.signature_json);
+                if (signature.params && Array.isArray(signature.params)) {
+                    suggestions.identifiersToFind = signature.params
+                        .map((p) => p.name)
+                        .slice(0, 3);
+                }
+            }
+            catch (error) {
+                logger.warn("Failed to parse signature_json for identifier suggestions", {
+                    symbolId: request.symbolId,
+                    error: String(error),
+                });
+                suggestions.identifiersToFind = [symbol.name];
+            }
+        }
+        else if (symbol) {
+            suggestions.identifiersToFind = [symbol.name];
+        }
+    }
+    if (reason === "too-broad" && !request.reason.includes("specific")) {
+        suggestions.reason = `${request.reason} - focus on specific function/class`;
+    }
+    if (Object.keys(suggestions).length === 0) {
+        suggestions.reason = `${request.reason} (please add context or identifiers)`;
+    }
+    return suggestions;
+}
+//# sourceMappingURL=gate.js.map

package/dist/code/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/code/gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAS3C;;;;GAIG;AACH,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAQpC,MAAM,UAAU,eAAe,CAC7B,OAA0B,EAC1B,OAAoB;IAEpB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC;IAE/C,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,CAAC,mCAAmC,CAAC;YAChD,oBAAoB,EAAE,SAAS;SAChC,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,CAAC,kBAAkB,CAAC;YAC/B,oBAAoB,EAAE,SAAS;SAChC,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,IAAI,OAAO,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,IACE,MAAM,CAAC,QAAQ;YACf,wBAAwB,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,EAChE,CAAC;YACD,WAAW,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YACtC,OAAO;gBACL,GAAG,MAAM;gBACT,WAAW;aACZ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,CACvC,CAAC;QACF,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAC7C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,CACvC,CAAC;QACF,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;YAC1B,WAAW,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACzC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,OAAO;oBACL,GAAG,MAAM;oBACT,WAAW;iBACZ,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG;QACnB,KAAK,EAAE,OAAO,CAAC,MAAM;KACtB,CAAC;IACF,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7D,IAAI,YAAY,GAAG,uBAAuB,EAAE,CAAC;QAC3C,WAAW,CAAC,IAAI,CAAC,mBAAmB,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAChE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO;gBACL,GAAG,MAAM;gBACT,WAAW;aACZ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,oBAAoB,GAAG,sBAAsB,CACjD,OAAO,EACP,SAAS,EACT,MAAM,CACP,CAAC;IAEF,IAAI,OAAO,CAAC,aAAa,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAClD,SAAS,CAAC,IAAI,CACZ,yCAAyC,OAAO,CAAC,aAAa,MAAM,MAAM,CAAC,cAAc,GAAG,CAC7F,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QACpE,SAAS,CAAC,IAAI,CACZ,0CAA0C,OAAO,CAAC,SAAS,MAAM,MAAM,CAAC,eAAe,GAAG,CAC3F,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,iBAAiB,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;QACxE,SAAS,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACpD,CAAC;SAAM,IACL,OAAO,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC;QACpC,MAAM,CAAC,QAAQ;QACf,CAAC,wBAAwB,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,EACjE,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,SAAS;QACT,oBAAoB;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAA0B,EAC1B,MAAc,EACd,cAA6B;IAE7B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,cAAc,IAAI,MAAM,CAAC,MAAM,CAAC;IAE/C,MAAM,WAAW,GAA+B,EAAE,CAAC;IAEnD,IAAI,OAAO,CAAC,aAAa,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAClD,WAAW,CAAC,aAAa,GAAG,MAAM,CAAC,cAAc,CAAC;IACpD,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QACpE,WAAW,CAAC,SAAS,GAAG,MAAM,CAAC,eAAe,CAAC;IACjD,CAAC;IAED,IAAI,OAAO,CAAC,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,MAAM,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;gBACpD,IAAI,SAAS,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;oBACxD,WAAW,CAAC,iBAAiB,GAAG,SAAS,CAAC,MAAM;yBAC7C,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;yBACvB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CACT,2DAA2D,EAC3D;oBACE,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;iBACrB,CACF,CAAC;gBACF,WAAW,CAAC,iBAAiB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,EAAE,CAAC;YAClB,WAAW,CAAC,iBAAiB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,IAAI,MAAM,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACnE,WAAW,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,qCAAqC,CAAC;IAC9E,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,WAAW,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,sCAAsC,CAAC;IAC/E,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/code/hotpath.d.ts

@@ -0,0 +1,17 @@
+import type { RepoId, SymbolId } from "../db/schema.js";
+import type { Range } from "../mcp/types.js";
+export interface HotPathOptions {
+    maxLines?: number;
+    maxTokens?: number;
+    contextLines?: number;
+}
+export interface HotPathResult {
+    excerpt: string;
+    actualRange: Range;
+    estimatedTokens: number;
+    matchedIdentifiers: string[];
+    matchedLineNumbers: number[];
+    truncated: boolean;
+}
+export declare function extractHotPath(repoId: RepoId, symbolId: SymbolId, identifiersToFind: string[], options?: HotPathOptions): HotPathResult | null;
+//# sourceMappingURL=hotpath.d.ts.map

package/dist/code/hotpath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotpath.d.ts","sourceRoot":"","sources":["../../src/code/hotpath.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAkB7C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,KAAK,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;CACpB;AAqMD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,OAAO,GAAE,cAAmB,GAC3B,aAAa,GAAG,IAAI,CAuCtB"}

package/dist/code/hotpath.js

@@ -0,0 +1,200 @@
+import { readFileSync } from "fs";
+import { getSymbol, getFile, getRepo } from "../db/queries.js";
+import { getAbsolutePathFromRepoRoot } from "../util/paths.js";
+import { estimateTokens as estimateTokenCount } from "../util/tokenize.js";
+import Parser from "tree-sitter";
+import TypeScript from "tree-sitter-typescript";
+import { DEFAULT_CONTEXT_LINES, DEFAULT_MAX_LINES_HOTPATH, DEFAULT_MAX_TOKENS_HOTPATH, } from "../config/constants.js";
+const tsParser = new Parser();
+const tsxParser = new Parser();
+tsParser.setLanguage(TypeScript.typescript);
+tsxParser.setLanguage(TypeScript.tsx);
+function parseFile(content, extension) {
+    try {
+        const isTS = extension === ".ts";
+        const isTSX = extension === ".tsx";
+        const isJS = extension === ".js";
+        const isJSX = extension === ".jsx";
+        if (!isTS && !isTSX && !isJS && !isJSX) {
+            return null;
+        }
+        const parser = isTS ? tsParser : tsxParser;
+        // Use 1MB buffer to handle files >32KB (tree-sitter default limit)
+        const tree = parser.parse(content, undefined, {
+            bufferSize: 1024 * 1024,
+        });
+        if (!tree || tree.rootNode.hasError) {
+            return null;
+        }
+        return tree;
+    }
+    catch (error) {
+        process.stderr.write(`[sdl-mcp] Failed to parse file for hot path (extension: ${extension}): ${error instanceof Error ? error.message : String(error)}\n`);
+        return null;
+    }
+}
+function findLinesMatchingIdentifiers(tree, identifiersToFind) {
+    const matchedLines = new Set();
+    if (identifiersToFind.length === 0) {
+        return matchedLines;
+    }
+    const identifierSet = new Set(identifiersToFind);
+    function matchesExactIdentifier(text) {
+        if (identifierSet.has(text)) {
+            return true;
+        }
+        return false;
+    }
+    function matchesAsMemberExpression(text) {
+        const parts = text.split(".");
+        return parts.some((part) => identifierSet.has(part));
+    }
+    function walk(node) {
+        if (node.type === "identifier") {
+            if (matchesExactIdentifier(node.text)) {
+                matchedLines.add(node.startPosition.row + 1);
+            }
+        }
+        if (node.type === "call_expression") {
+            const funcNode = node.childForFieldName("function");
+            if (funcNode) {
+                if (funcNode.type === "identifier") {
+                    if (matchesExactIdentifier(funcNode.text)) {
+                        matchedLines.add(node.startPosition.row + 1);
+                    }
+                }
+                else if (funcNode.type === "member_expression") {
+                    if (matchesAsMemberExpression(funcNode.text)) {
+                        matchedLines.add(node.startPosition.row + 1);
+                    }
+                }
+            }
+        }
+        if (node.type === "throw_statement") {
+            const thrown = node.childForFieldName("value");
+            if (thrown) {
+                if (thrown.type === "new_expression") {
+                    const constructorNode = thrown.childForFieldName("constructor");
+                    if (constructorNode && constructorNode.type === "identifier") {
+                        if (matchesExactIdentifier(constructorNode.text)) {
+                            matchedLines.add(node.startPosition.row + 1);
+                        }
+                    }
+                }
+                else if (thrown.type === "identifier") {
+                    if (matchesExactIdentifier(thrown.text)) {
+                        matchedLines.add(node.startPosition.row + 1);
+                    }
+                }
+            }
+        }
+        Array.from(node.children).forEach((child) => {
+            walk(child);
+        });
+    }
+    walk(tree.rootNode);
+    return matchedLines;
+}
+function buildHotPathExcerpt(lines, matchedLines, contextLines, maxLines, maxTokens) {
+    if (matchedLines.size === 0) {
+        const allExcerpt = lines.slice(0, Math.min(maxLines, lines.length));
+        const resultLines = [];
+        let remainingTokens = maxTokens;
+        for (const line of allExcerpt) {
+            const lineTokens = estimateTokenCount(line);
+            if (lineTokens > remainingTokens)
+                break;
+            resultLines.push(line);
+            remainingTokens -= lineTokens;
+        }
+        const excerpt = resultLines.join("\n");
+        return {
+            excerpt,
+            matchedIdentifiers: [],
+            matchedLineNumbers: [],
+            truncated: resultLines.length < lines.length,
+            actualRange: {
+                startLine: 1,
+                startCol: 0,
+                endLine: resultLines.length,
+                endCol: resultLines[resultLines.length - 1]?.length ?? 0,
+            },
+        };
+    }
+    const matchedLineNumbers = Array.from(matchedLines).sort((a, b) => a - b);
+    const excerptLineSet = new Set();
+    matchedLineNumbers.forEach((lineNum) => {
+        const start = Math.max(0, lineNum - 1 - contextLines);
+        const end = Math.min(lines.length, lineNum + contextLines);
+        for (let i = start; i < end; i++) {
+            excerptLineSet.add(i);
+        }
+    });
+    const excerptLineNumbers = Array.from(excerptLineSet).sort((a, b) => a - b);
+    const excerptLines = excerptLineNumbers.map((i) => lines[i]);
+    const resultLines = [];
+    let remainingTokens = maxTokens;
+    for (const line of excerptLines) {
+        const lineTokens = estimateTokenCount(line);
+        if (lineTokens > remainingTokens) {
+            break;
+        }
+        resultLines.push(line);
+        remainingTokens -= lineTokens;
+        if (resultLines.length >= maxLines) {
+            break;
+        }
+    }
+    const excerpt = resultLines.join("\n");
+    const truncated = resultLines.length < excerptLines.length;
+    const startLine = resultLines.length > 0 ? excerptLineNumbers[0] + 1 : 1;
+    const endLine = resultLines.length > 0
+        ? excerptLineNumbers[resultLines.length - 1] + 1
+        : startLine;
+    const actualRange = {
+        startLine,
+        startCol: 0,
+        endLine,
+        endCol: resultLines[resultLines.length - 1]?.length ?? 0,
+    };
+    return {
+        excerpt,
+        matchedIdentifiers: [],
+        matchedLineNumbers,
+        truncated,
+        actualRange,
+    };
+}
+export function extractHotPath(repoId, symbolId, identifiersToFind, options = {}) {
+    const symbol = getSymbol(symbolId);
+    if (!symbol)
+        return null;
+    const file = getFile(symbol.file_id);
+    if (!file)
+        return null;
+    const repo = getRepo(repoId);
+    if (!repo)
+        return null;
+    const filePath = getAbsolutePathFromRepoRoot(repo.root_path, file.rel_path);
+    const extension = file.rel_path.split(".").pop() || "";
+    const content = readFileSync(filePath, "utf-8");
+    const tree = parseFile(content, `.${extension}`);
+    if (!tree) {
+        return null;
+    }
+    const lines = content.split("\n");
+    const contextLines = options.contextLines ?? DEFAULT_CONTEXT_LINES;
+    const maxLines = options.maxLines ?? DEFAULT_MAX_LINES_HOTPATH;
+    const maxTokens = options.maxTokens ?? DEFAULT_MAX_TOKENS_HOTPATH;
+    const matchedLines = findLinesMatchingIdentifiers(tree, identifiersToFind);
+    const { excerpt, matchedLineNumbers, truncated, actualRange } = buildHotPathExcerpt(lines, matchedLines, contextLines, maxLines, maxTokens);
+    return {
+        excerpt,
+        actualRange,
+        estimatedTokens: estimateTokenCount(excerpt),
+        matchedIdentifiers: identifiersToFind,
+        matchedLineNumbers,
+        truncated,
+    };
+}
+//# sourceMappingURL=hotpath.js.map

package/dist/code/hotpath.js.map

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

package/dist/code/redact.d.ts

@@ -0,0 +1,19 @@
+export interface RedactionPattern {
+    name: string;
+    pattern: RegExp;
+}
+export interface RedactionPatternInput {
+    name?: string;
+    pattern: string;
+    flags?: string;
+}
+export interface RedactionConfig {
+    enabled?: boolean;
+    includeDefaults?: boolean;
+    patterns?: RedactionPatternInput[];
+}
+export declare function compilePatterns(inputs: RedactionPatternInput[]): RedactionPattern[];
+export declare function buildRedactionPatterns(config?: RedactionConfig): RedactionPattern[];
+export declare function redactSecrets(code: string, patterns?: RedactionPattern[]): string;
+export declare function shouldRedactFile(filePath: string): boolean;
+//# sourceMappingURL=redact.d.ts.map

package/dist/code/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/code/redact.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACpC;AAuDD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,qBAAqB,EAAE,GAC9B,gBAAgB,EAAE,CAiBpB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,eAAe,GACvB,gBAAgB,EAAE,CAOpB;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,gBAAgB,EAAE,GAC5B,MAAM,CAUR;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAW1D"}

package/dist/code/redact.js

@@ -0,0 +1,92 @@
+import path from "path";
+const DEFAULT_PATTERNS = [
+    {
+        name: "aws-access-key",
+        pattern: /\bAKIA[0-9A-Z]{16,32}\b/gi,
+    },
+    {
+        name: "github-token",
+        pattern: /\bghp_[a-zA-Z0-9]{36}\b/gi,
+    },
+    {
+        name: "api-key",
+        pattern: /\bapi[_-]?key\s*[=:]\s*["']?[a-zA-Z0-9]{20,}["']?\b/gi,
+    },
+    {
+        name: "password",
+        pattern: /\bpassword\s*[=:]\s*["']?[^"'\s]{8,}["']?\b/gi,
+    },
+    {
+        name: "connection-string",
+        pattern: /\b(mongodb:\/\/|postgres:\/\/|mysql:\/\/)[a-zA-Z0-9_\-\.:@\/]+\b/gi,
+    },
+    {
+        name: "jwt-token",
+        pattern: /\beyJ[a-zA-Z0-9_-]{10,}\.[a-zA-Z0-9_-]{10,}\.[a-zA-Z0-9_-]{10,}\b/gi,
+    },
+    {
+        name: "private-key",
+        pattern: /-----BEGIN\s+[A-Z\s]+PRIVATE\s+KEY-----/gi,
+    },
+    {
+        name: "env-variable",
+        pattern: /\b[A-Z_]{2,}\s*[=:]\s*["']?[a-zA-Z0-9_\-]{16,}["']?\b/gi,
+    },
+];
+const EXCLUDED_FILES = [
+    ".env",
+    ".env.local",
+    ".env.production",
+    ".env.development",
+    ".env.test",
+    ".key",
+    ".pem",
+    "credentials.json",
+    "secrets.yaml",
+    "secrets.yml",
+    ".secrets",
+    "config/secrets.json",
+    ".aws/credentials",
+];
+export function compilePatterns(inputs) {
+    const compiled = [];
+    inputs.forEach((input, index) => {
+        try {
+            compiled.push({
+                name: input.name ?? `custom-${index}`,
+                pattern: new RegExp(input.pattern, input.flags ?? "g"),
+            });
+        }
+        catch (error) {
+            process.stderr.write(`[WARN] Invalid redaction pattern skipped: ${input.name ?? input.pattern}\n`);
+        }
+    });
+    return compiled;
+}
+export function buildRedactionPatterns(config) {
+    const includeDefaults = config?.includeDefaults ?? true;
+    const custom = config?.patterns ? compilePatterns(config.patterns) : [];
+    if (includeDefaults) {
+        return [...custom, ...DEFAULT_PATTERNS];
+    }
+    return custom;
+}
+export function redactSecrets(code, patterns) {
+    const patternsToUse = patterns ?? DEFAULT_PATTERNS;
+    let redacted = code;
+    for (const { name, pattern } of patternsToUse) {
+        redacted = redacted.replace(pattern, `[REDACTED:${name}]`);
+    }
+    return redacted;
+}
+export function shouldRedactFile(filePath) {
+    const fileName = path.basename(filePath);
+    const normalizedPath = filePath.replace(/\\/g, "/");
+    for (const excluded of EXCLUDED_FILES) {
+        if (fileName === excluded || normalizedPath.endsWith(excluded)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=redact.js.map

package/dist/code/redact.js.map

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

package/dist/code/skeleton.d.ts

@@ -0,0 +1,32 @@
+import type { RepoId, SymbolId } from "../db/schema.js";
+import type { Range, SkeletonIR } from "../mcp/types.js";
+import Parser from "tree-sitter";
+export interface SkeletonResult {
+    skeleton: string;
+    actualRange: Range;
+    estimatedTokens: number;
+    originalLines: number;
+    truncated: boolean;
+}
+export interface SkeletonIRResult {
+    ir: SkeletonIR;
+    skeletonText: string;
+    actualRange: Range;
+    estimatedTokens: number;
+    originalLines: number;
+}
+export interface SkeletonOptions {
+    maxLines?: number;
+    maxTokens?: number;
+    includeIdentifiers?: string[];
+}
+export declare function extractSkeletonFromNode(node: Parser.SyntaxNode, content: string, includeIdentifiers: string[], depth?: number, exportedOnly?: boolean): string;
+export declare function trimSkeletonToBounds(skeleton: string, maxLines: number, maxTokens: number): {
+    code: string;
+    truncated: boolean;
+};
+export declare function parseFile(content: string, extension: string): Parser.Tree | null;
+export declare function generateSymbolSkeleton(repoId: RepoId, symbolId: SymbolId, options?: SkeletonOptions): SkeletonResult | null;
+export declare function generateFileSkeleton(repoId: RepoId, filePath: string, exportedOnly?: boolean, options?: SkeletonOptions): SkeletonResult | null;
+export declare function generateSkeletonIR(repoId: RepoId, symbolId: SymbolId, options?: SkeletonOptions): SkeletonIRResult | null;
+//# sourceMappingURL=skeleton.d.ts.map

package/dist/code/skeleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton.d.ts","sourceRoot":"","sources":["../../src/code/skeleton.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAc,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIrE,OAAO,MAAM,MAAM,aAAa,CAAC;AAejC,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,KAAK,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,UAAU,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,KAAK,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAUD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,CAAC,UAAU,EACvB,OAAO,EAAE,MAAM,EACf,kBAAkB,EAAE,MAAM,EAAE,EAC5B,KAAK,GAAE,MAAU,EACjB,YAAY,GAAE,OAAe,GAC5B,MAAM,CAqIR;AA2JD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAyBtC;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,IAAI,GAAG,IAAI,CA4BpB;AA6BD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,eAAoB,GAC5B,cAAc,GAAG,IAAI,CA8DvB;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,GAAE,OAAe,EAC7B,OAAO,GAAE,eAAoB,GAC5B,cAAc,GAAG,IAAI,CA8CvB;AA4PD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,eAAoB,GAC5B,gBAAgB,GAAG,IAAI,CA6EzB"}