mincut-context 1.0.0

package/dist/parsers/py.js

@@ -0,0 +1,169 @@
+import Parser from 'tree-sitter';
+import { createRequire } from 'node:module';
+import { approxTokens, } from './parser.js';
+const require_ = createRequire(import.meta.url);
+const Python = require_('tree-sitter-python');
+const pyParser = new Parser();
+pyParser.setLanguage(Python);
+export function parsePython(file, source) {
+    let tree;
+    try {
+        tree = pyParser.parse(source);
+    }
+    catch {
+        return { symbols: [], imports: [], calls: [] };
+    }
+    const ctx = {
+        file,
+        source,
+        symbols: [],
+        imports: [],
+        calls: [],
+        classStack: [],
+        callerStack: [],
+    };
+    visit(tree.rootNode, ctx);
+    return { symbols: ctx.symbols, imports: ctx.imports, calls: ctx.calls };
+}
+function visit(node, ctx) {
+    switch (node.type) {
+        case 'function_definition': {
+            const nameNode = node.childForFieldName('name');
+            if (!nameNode)
+                return visitChildren(node, ctx);
+            const bareName = nameNode.text;
+            const cls = ctx.classStack[ctx.classStack.length - 1];
+            const qualified = cls ? `${cls}.${bareName}` : bareName;
+            const sym = makeSym(ctx, node, bareName, qualified, cls ? 'method' : 'function');
+            ctx.symbols.push(sym);
+            ctx.callerStack.push(sym.id);
+            // Walk the body — nested defs/calls.
+            const body = node.childForFieldName('body');
+            if (body)
+                visit(body, ctx);
+            ctx.callerStack.pop();
+            return;
+        }
+        case 'decorated_definition': {
+            // Skip decorators, descend into the inner definition.
+            const def = node.childForFieldName('definition');
+            if (def)
+                visit(def, ctx);
+            return;
+        }
+        case 'class_definition': {
+            const nameNode = node.childForFieldName('name');
+            if (!nameNode)
+                return visitChildren(node, ctx);
+            const name = nameNode.text;
+            ctx.symbols.push(makeSym(ctx, node, name, name, 'class'));
+            ctx.classStack.push(name);
+            const body = node.childForFieldName('body');
+            if (body)
+                visit(body, ctx);
+            ctx.classStack.pop();
+            return;
+        }
+        case 'import_statement': {
+            // `import X` or `import X as Y` or `import X, Y as Z`
+            for (let i = 0; i < node.namedChildCount; i++) {
+                const c = node.namedChild(i);
+                if (!c)
+                    continue;
+                if (c.type === 'dotted_name') {
+                    ctx.imports.push({ source: c.text, names: [c.text.split('.')[0]] });
+                }
+                else if (c.type === 'aliased_import') {
+                    const inner = c.childForFieldName('name');
+                    const alias = c.childForFieldName('alias');
+                    if (inner) {
+                        ctx.imports.push({
+                            source: inner.text,
+                            names: [inner.text.split('.')[0]],
+                            namespace: alias?.text,
+                        });
+                    }
+                }
+            }
+            return;
+        }
+        case 'import_from_statement': {
+            // `from X import Y` / `from . import Y` / `from X import *`
+            const moduleNode = node.childForFieldName('module_name');
+            let source = '';
+            if (moduleNode) {
+                source = moduleNode.text;
+            }
+            else {
+                // Pure relative `from . import X`
+                const firstChild = node.child(1);
+                if (firstChild && firstChild.text.startsWith('.'))
+                    source = firstChild.text;
+            }
+            const names = [];
+            for (let i = 0; i < node.namedChildCount; i++) {
+                const c = node.namedChild(i);
+                if (!c)
+                    continue;
+                if (c === moduleNode)
+                    continue;
+                if (c.type === 'dotted_name' || c.type === 'identifier') {
+                    if (source && c === moduleNode)
+                        continue;
+                    if (c.text !== source)
+                        names.push(c.text);
+                }
+                else if (c.type === 'aliased_import') {
+                    const inner = c.childForFieldName('name');
+                    if (inner)
+                        names.push(inner.text);
+                }
+            }
+            if (source)
+                ctx.imports.push({ source, names });
+            return;
+        }
+        case 'call': {
+            const fn = node.childForFieldName('function');
+            if (fn) {
+                const name = simpleCallee(fn);
+                if (name && ctx.callerStack.length > 0) {
+                    ctx.calls.push({ from: ctx.callerStack[ctx.callerStack.length - 1], toName: name });
+                }
+            }
+            visitChildren(node, ctx);
+            return;
+        }
+    }
+    visitChildren(node, ctx);
+}
+function visitChildren(node, ctx) {
+    for (let i = 0; i < node.namedChildCount; i++) {
+        const c = node.namedChild(i);
+        if (c)
+            visit(c, ctx);
+    }
+}
+function makeSym(ctx, node, bareName, qualifiedName, kind) {
+    const text = ctx.source.slice(node.startIndex, node.endIndex);
+    return {
+        id: `${ctx.file}:${qualifiedName}`,
+        name: bareName,
+        file: ctx.file,
+        kind,
+        startLine: node.startPosition.row + 1,
+        endLine: node.endPosition.row + 1,
+        tokens: approxTokens(text),
+    };
+}
+function simpleCallee(fn) {
+    if (fn.type === 'identifier')
+        return fn.text;
+    if (fn.type === 'attribute') {
+        const attr = fn.childForFieldName('attribute');
+        if (attr)
+            return attr.text;
+    }
+    return null;
+}
+//# sourceMappingURL=py.js.map

package/dist/parsers/py.js.map

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

package/dist/parsers/ts.d.ts

@@ -0,0 +1,3 @@
+import { type ParseResult } from './parser.js';
+export declare function parseTypeScript(file: string, source: string): ParseResult;
+//# sourceMappingURL=ts.d.ts.map

package/dist/parsers/ts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts.d.ts","sourceRoot":"","sources":["../../src/parsers/ts.ts"],"names":[],"mappings":"AASA,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAOrB,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CA0BzE"}

package/dist/parsers/ts.js

@@ -0,0 +1,240 @@
+import Parser from 'tree-sitter';
+// tree-sitter-typescript has no published .d.ts; require() at runtime avoids
+// pulling in a broken type during tsc compile.
+import { createRequire } from 'node:module';
+const require_ = createRequire(import.meta.url);
+const TypeScript = require_('tree-sitter-typescript');
+import { approxTokens, } from './parser.js';
+const tsParser = new Parser();
+tsParser.setLanguage(TypeScript.typescript);
+const tsxParser = new Parser();
+tsxParser.setLanguage(TypeScript.tsx);
+export function parseTypeScript(file, source) {
+    const parser = file.endsWith('.tsx') || file.endsWith('.jsx') ? tsxParser : tsParser;
+    let tree;
+    try {
+        tree = parser.parse(source);
+    }
+    catch {
+        return { symbols: [], imports: [], calls: [] };
+    }
+    const symbols = [];
+    const imports = [];
+    const calls = [];
+    visit(tree.rootNode, {
+        file,
+        source,
+        symbols,
+        imports,
+        calls,
+        classStack: [],
+        callerStack: [],
+        inTypeContext: false,
+    });
+    return { symbols, imports, calls };
+}
+function visit(node, ctx) {
+    switch (node.type) {
+        case 'function_declaration':
+        case 'generator_function_declaration': {
+            const name = node.childForFieldName('name')?.text;
+            if (name) {
+                const sym = makeSymbol(ctx, node, name, name, 'function');
+                ctx.symbols.push(sym);
+                ctx.callerStack.push(sym.id);
+                visitChildren(node, ctx);
+                ctx.callerStack.pop();
+                return;
+            }
+            break;
+        }
+        case 'lexical_declaration':
+        case 'variable_declaration': {
+            // const foo = () => {} / const X = <div />
+            for (let i = 0; i < node.namedChildCount; i++) {
+                const decl = node.namedChild(i);
+                if (!decl || decl.type !== 'variable_declarator')
+                    continue;
+                const nameNode = decl.childForFieldName('name');
+                const valueNode = decl.childForFieldName('value');
+                if (!nameNode || !valueNode)
+                    continue;
+                const isFunctionish = valueNode.type === 'arrow_function' ||
+                    valueNode.type === 'function_expression' ||
+                    valueNode.type === 'function' ||
+                    valueNode.type === 'jsx_element' ||
+                    valueNode.type === 'jsx_self_closing_element';
+                if (isFunctionish) {
+                    const sym = makeSymbol(ctx, decl, nameNode.text, nameNode.text, 'function');
+                    ctx.symbols.push(sym);
+                    ctx.callerStack.push(sym.id);
+                    visit(valueNode, ctx);
+                    ctx.callerStack.pop();
+                }
+                else {
+                    visit(valueNode, ctx);
+                }
+            }
+            return;
+        }
+        case 'class_declaration': {
+            const name = node.childForFieldName('name')?.text;
+            if (name) {
+                const sym = makeSymbol(ctx, node, name, name, 'class');
+                ctx.symbols.push(sym);
+                ctx.classStack.push(name);
+                visitChildren(node, ctx);
+                ctx.classStack.pop();
+                return;
+            }
+            break;
+        }
+        case 'method_definition': {
+            const name = node.childForFieldName('name')?.text;
+            if (name) {
+                const cls = ctx.classStack[ctx.classStack.length - 1];
+                const qualified = cls ? `${cls}.${name}` : name;
+                const sym = makeSymbol(ctx, node, name, qualified, 'method');
+                ctx.symbols.push(sym);
+                ctx.callerStack.push(sym.id);
+                visitChildren(node, ctx);
+                ctx.callerStack.pop();
+                return;
+            }
+            break;
+        }
+        case 'interface_declaration': {
+            const name = node.childForFieldName('name')?.text;
+            if (name) {
+                ctx.symbols.push(makeSymbol(ctx, node, name, name, 'interface'));
+            }
+            return; // body is types — skip
+        }
+        case 'type_alias_declaration': {
+            const name = node.childForFieldName('name')?.text;
+            if (name)
+                ctx.symbols.push(makeSymbol(ctx, node, name, name, 'type'));
+            return;
+        }
+        case 'import_statement': {
+            const imp = extractImport(node);
+            if (imp)
+                ctx.imports.push(imp);
+            return;
+        }
+        case 'call_expression': {
+            if (!ctx.inTypeContext) {
+                const fn = node.childForFieldName('function');
+                if (fn) {
+                    const name = simpleCalleeName(fn);
+                    if (name && ctx.callerStack.length > 0) {
+                        ctx.calls.push({ from: ctx.callerStack[ctx.callerStack.length - 1], toName: name });
+                    }
+                }
+            }
+            visitChildren(node, ctx);
+            return;
+        }
+        // type contexts — calls inside these don't count
+        case 'type_arguments':
+        case 'type_annotation':
+        case 'type_parameters':
+        case 'generic_type':
+        case 'predefined_type':
+        case 'union_type':
+        case 'intersection_type':
+        case 'conditional_type':
+        case 'mapped_type':
+        case 'tuple_type':
+        case 'object_type':
+        case 'function_type':
+        case 'constructor_type':
+        case 'type_query': {
+            const previous = ctx.inTypeContext;
+            ctx.inTypeContext = true;
+            visitChildren(node, ctx);
+            ctx.inTypeContext = previous;
+            return;
+        }
+    }
+    visitChildren(node, ctx);
+}
+function visitChildren(node, ctx) {
+    for (let i = 0; i < node.namedChildCount; i++) {
+        const child = node.namedChild(i);
+        if (child)
+            visit(child, ctx);
+    }
+}
+function makeSymbol(ctx, node, bareName, qualifiedName, kind) {
+    const text = ctx.source.slice(node.startIndex, node.endIndex);
+    return {
+        id: `${ctx.file}:${qualifiedName}`,
+        name: bareName,
+        file: ctx.file,
+        kind,
+        startLine: node.startPosition.row + 1,
+        endLine: node.endPosition.row + 1,
+        tokens: approxTokens(text),
+    };
+}
+function extractImport(node) {
+    const sourceNode = node.childForFieldName('source');
+    if (!sourceNode)
+        return null;
+    const source = sourceNode.text.replace(/^['"`]|['"`]$/g, '');
+    const names = [];
+    let namespace;
+    // `import_clause`
+    const clause = firstChildOfType(node, 'import_clause');
+    if (!clause) {
+        return { source, names, namespace };
+    }
+    for (let i = 0; i < clause.namedChildCount; i++) {
+        const c = clause.namedChild(i);
+        if (!c)
+            continue;
+        if (c.type === 'identifier') {
+            // default import:  import foo from '...'
+            names.push(c.text);
+        }
+        else if (c.type === 'named_imports') {
+            for (let j = 0; j < c.namedChildCount; j++) {
+                const spec = c.namedChild(j);
+                if (spec?.type === 'import_specifier') {
+                    const alias = spec.childForFieldName('alias');
+                    const orig = spec.childForFieldName('name');
+                    const picked = alias?.text ?? orig?.text;
+                    if (picked)
+                        names.push(picked);
+                }
+            }
+        }
+        else if (c.type === 'namespace_import') {
+            // import * as utils from '...'
+            const id = firstChildOfType(c, 'identifier');
+            if (id)
+                namespace = id.text;
+        }
+    }
+    return { source, names, namespace };
+}
+function firstChildOfType(node, type) {
+    for (let i = 0; i < node.namedChildCount; i++) {
+        const c = node.namedChild(i);
+        if (c?.type === type)
+            return c;
+    }
+    return null;
+}
+function simpleCalleeName(fn) {
+    if (fn.type === 'identifier')
+        return fn.text;
+    if (fn.type === 'member_expression') {
+        const prop = fn.childForFieldName('property');
+        if (prop)
+            return prop.text;
+    }
+    return null;
+}
+//# sourceMappingURL=ts.js.map

package/dist/parsers/ts.js.map

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

package/dist/seeds/embedding.d.ts

@@ -0,0 +1,27 @@
+import type { SymbolGraph } from '../core/graph.js';
+export interface Embedder {
+    /** Batch-embed an array of texts.  Each output Float32Array must be L2-normalized. */
+    embed(texts: string[]): Promise<Float32Array[]>;
+}
+export interface HybridOptions {
+    k: number;
+    embedder: Embedder;
+    /** 0 = keyword-only (same as scoreSeeds), 1 = embedding-only.  Default 0.5. */
+    embedWeight: number;
+    /**
+     * Optional pool size for embedding candidates.  We embed at most this many
+     * symbols (filtered by keyword score first) to keep the model call cheap.
+     */
+    poolSize?: number;
+}
+/**
+ * Hybrid seed scorer.  Combines keyword IDF (from scoreSeeds) with embedding
+ * cosine similarity, falling back to keyword-only if the embedder fails.
+ *
+ *   score(node) = (1 - w) · normalizeMax(keyword)  +  w · cosine(embed(task), embed(node))
+ *
+ * Embedder is dependency-injected so tests can pass a deterministic fake and
+ * production can plug in @xenova/transformers without changing this module.
+ */
+export declare function scoreSeedsHybrid(graph: SymbolGraph, task: string, options: HybridOptions): Promise<Map<string, number>>;
+//# sourceMappingURL=embedding.d.ts.map

package/dist/seeds/embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/seeds/embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,WAAW,QAAQ;IACvB,sFAAsF;IACtF,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,QAAQ,CAAC;IACnB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAuD9B"}

package/dist/seeds/embedding.js

@@ -0,0 +1,90 @@
+import { scoreSeeds } from './keyword.js';
+/**
+ * Hybrid seed scorer.  Combines keyword IDF (from scoreSeeds) with embedding
+ * cosine similarity, falling back to keyword-only if the embedder fails.
+ *
+ *   score(node) = (1 - w) · normalizeMax(keyword)  +  w · cosine(embed(task), embed(node))
+ *
+ * Embedder is dependency-injected so tests can pass a deterministic fake and
+ * production can plug in @xenova/transformers without changing this module.
+ */
+export async function scoreSeedsHybrid(graph, task, options) {
+    const { k, embedder, embedWeight, poolSize = 200 } = options;
+    if (embedWeight < 0 || embedWeight > 1) {
+        throw new Error('embedWeight must be in [0, 1]');
+    }
+    if (graph.order() === 0)
+        return new Map();
+    // 1. Always run keyword scoring as a baseline / fallback.
+    const keywordScores = scoreSeeds(graph, task, { k: Math.max(k * 4, poolSize) });
+    if (embedWeight === 0) {
+        return takeTop(keywordScores, k);
+    }
+    // 2. Build embedding candidate pool.  If keyword finds nothing, embed all
+    // nodes (capped at poolSize) so the semantic path can still surface matches.
+    let candidatePool;
+    if (keywordScores.size > 0) {
+        candidatePool = [...keywordScores.keys()].slice(0, poolSize);
+    }
+    else {
+        candidatePool = graph.nodes().slice(0, poolSize);
+    }
+    if (candidatePool.length === 0)
+        return new Map();
+    // 3. Try embeddings; on failure, return keyword-only.
+    let taskVec;
+    let nodeVecs;
+    const ids = candidatePool;
+    try {
+        const texts = ids.map((id) => describeNode(graph, id));
+        const all = await embedder.embed([task, ...texts]);
+        taskVec = all[0];
+        nodeVecs = all.slice(1);
+    }
+    catch {
+        return takeTop(keywordScores, k);
+    }
+    // 3. Blend scores.
+    const maxKw = Math.max(...keywordScores.values(), 1e-9);
+    const blended = new Map();
+    for (let i = 0; i < ids.length; i++) {
+        const id = ids[i];
+        const kw = (keywordScores.get(id) ?? 0) / maxKw;
+        const cos = cosine(taskVec, nodeVecs[i]);
+        const score = (1 - embedWeight) * kw + embedWeight * cos;
+        if (score > 0)
+            blended.set(id, score);
+    }
+    // 4. Keyword-pool ⊇ embedding pool, so we won't drop any keyword-only hits.
+    if (embedWeight < 1) {
+        for (const [id, score] of keywordScores) {
+            if (!blended.has(id))
+                blended.set(id, ((1 - embedWeight) * score) / maxKw);
+        }
+    }
+    return takeTop(blended, k);
+}
+function takeTop(scores, k) {
+    return new Map([...scores.entries()].sort((a, b) => b[1] - a[1]).slice(0, k));
+}
+function describeNode(graph, id) {
+    const data = graph.getNode(id);
+    if (!data)
+        return id;
+    const parts = [];
+    if (data.name)
+        parts.push(data.name);
+    parts.push(data.kind);
+    parts.push(data.file);
+    return parts.join(' ');
+}
+function cosine(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    let dot = 0;
+    for (let i = 0; i < a.length; i++)
+        dot += a[i] * b[i];
+    // Inputs are L2-normalized (per Embedder contract), so dot == cosine.
+    return Math.max(0, Math.min(1, dot));
+}
+//# sourceMappingURL=embedding.js.map

package/dist/seeds/embedding.js.map

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

package/dist/seeds/keyword.d.ts

@@ -0,0 +1,22 @@
+import type { SymbolGraph } from '../core/graph.js';
+export interface ScoreOptions {
+    /** Top-k seeds to return. */
+    k: number;
+}
+/**
+ * Lower-cased, split-on-non-alphanum, broken on case boundaries.
+ * Drops stopwords and 1-char fragments.
+ */
+export declare function tokenizeTask(task: string): string[];
+/**
+ * Score every node by how strongly its symbol name (tokenized) overlaps with
+ * the task tokens, weighted by inverse document frequency (rarer names matter
+ * more).  Returns the top-k as a Map<nodeId, score>.
+ *
+ *   score(node) = Σ_{token ∈ task ∩ name}  IDF(token) · match_weight
+ *
+ * where match_weight = 1.0 for exact whole-name match, 0.5 for partial
+ * sub-token match.
+ */
+export declare function scoreSeeds(graph: SymbolGraph, task: string, options: ScoreOptions): Map<string, number>;
+//# sourceMappingURL=keyword.d.ts.map

package/dist/seeds/keyword.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword.d.ts","sourceRoot":"","sources":["../../src/seeds/keyword.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAWpD,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAYnD;AAWD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAuDrB"}