@neurcode-ai/cli 0.9.48 → 0.9.50

package/dist/context-engine/graph.d.ts

@@ -0,0 +1,6 @@
+import type { ProjectScanResult } from './scanner';
+export type DependencyGraph = {
+    imports: Record<string, string[]>;
+};
+export declare function buildDependencyGraph(scan: ProjectScanResult): DependencyGraph;
+//# sourceMappingURL=graph.d.ts.map

package/dist/context-engine/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/context-engine/graph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACnC,CAAC;AAoCF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,eAAe,CAuB7E"}

package/dist/context-engine/graph.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDependencyGraph = buildDependencyGraph;
+const path_1 = require("path");
+// Matches: import ... from './foo' or require('./foo')
+const IMPORT_RE = /(?:import\s[^'"]*from|require\()\s*['"](\.[^'"]+)['"]/g;
+function resolveImport(fromFile, importPath) {
+    const fromDir = (0, path_1.dirname)(fromFile);
+    let resolved = (0, path_1.normalize)((0, path_1.join)(fromDir, importPath)).replace(/\\/g, '/');
+    // If no extension, try to match against known files by trying common extensions
+    if (!/\.[jt]sx?$/.test(resolved)) {
+        // Return as-is with a placeholder — callers reconcile against real files
+        return resolved;
+    }
+    return resolved;
+}
+function reconcileToKnownFile(candidate, fileSet) {
+    if (fileSet.has(candidate))
+        return candidate;
+    const extensions = ['.ts', '.tsx', '.js', '.jsx'];
+    for (const ext of extensions) {
+        const withExt = `${candidate}${ext}`;
+        if (fileSet.has(withExt))
+            return withExt;
+    }
+    // Try index files
+    for (const ext of extensions) {
+        const index = `${candidate}/index${ext}`;
+        if (fileSet.has(index))
+            return index;
+    }
+    return null;
+}
+function buildDependencyGraph(scan) {
+    const fileSet = new Set(scan.files);
+    const imports = {};
+    for (const file of scan.files) {
+        imports[file] = [];
+        const content = scan.fileContents[file] ?? '';
+        let match;
+        IMPORT_RE.lastIndex = 0;
+        while ((match = IMPORT_RE.exec(content)) !== null) {
+            const importPath = match[1];
+            if (!importPath)
+                continue;
+            const resolved = resolveImport(file, importPath);
+            const known = reconcileToKnownFile(resolved, fileSet);
+            if (known && known !== file) {
+                imports[file].push(known);
+            }
+        }
+    }
+    return { imports };
+}
+//# sourceMappingURL=graph.js.map

package/dist/context-engine/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/context-engine/graph.ts"],"names":[],"mappings":";;AAyCA,oDAuBC;AAhED,+BAAgD;AAOhD,uDAAuD;AACvD,MAAM,SAAS,GAAG,wDAAwD,CAAC;AAE3E,SAAS,aAAa,CAAC,QAAgB,EAAE,UAAkB;IACzD,MAAM,OAAO,GAAG,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,QAAQ,GAAG,IAAA,gBAAS,EAAC,IAAA,WAAI,EAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAExE,gFAAgF;IAChF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,yEAAyE;QACzE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,oBAAoB,CAAC,SAAiB,EAAE,OAAoB;IACnE,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAE7C,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAClD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,GAAG,SAAS,GAAG,GAAG,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;IAC3C,CAAC;IAED,kBAAkB;IAClB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,GAAG,SAAS,SAAS,GAAG,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;IACvC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,oBAAoB,CAAC,IAAuB;IAC1D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,OAAO,GAA6B,EAAE,CAAC;IAE7C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,KAA6B,CAAC;QAElC,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC;QACxB,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAClD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,UAAU;gBAAE,SAAS;YAE1B,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACtD,IAAI,KAAK,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/dist/context-engine/index.d.ts

@@ -0,0 +1,14 @@
+export { scanProject } from './scanner';
+export { buildDependencyGraph } from './graph';
+export { scoreFiles } from './scorer';
+export type { ProjectScanResult } from './scanner';
+export type { DependencyGraph } from './graph';
+export type { ScoredFile } from './scorer';
+export type { FileSuggestion, SuggestionResult } from './suggestions';
+export type ContextAnalysis = {
+    suggestedFiles: string[];
+    confidence: number;
+    details: import('./suggestions').FileSuggestion[];
+};
+export declare function analyzeContext(rootPath: string, intent: string): ContextAnalysis;
+//# sourceMappingURL=index.d.ts.map

package/dist/context-engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context-engine/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtE,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,eAAe,EAAE,cAAc,EAAE,CAAC;CACnD,CAAC;AAEF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAWhF"}

package/dist/context-engine/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scoreFiles = exports.buildDependencyGraph = exports.scanProject = void 0;
+exports.analyzeContext = analyzeContext;
+const scanner_1 = require("./scanner");
+const graph_1 = require("./graph");
+const scorer_1 = require("./scorer");
+const suggestions_1 = require("./suggestions");
+var scanner_2 = require("./scanner");
+Object.defineProperty(exports, "scanProject", { enumerable: true, get: function () { return scanner_2.scanProject; } });
+var graph_2 = require("./graph");
+Object.defineProperty(exports, "buildDependencyGraph", { enumerable: true, get: function () { return graph_2.buildDependencyGraph; } });
+var scorer_2 = require("./scorer");
+Object.defineProperty(exports, "scoreFiles", { enumerable: true, get: function () { return scorer_2.scoreFiles; } });
+function analyzeContext(rootPath, intent) {
+    const scan = (0, scanner_1.scanProject)(rootPath);
+    const graph = (0, graph_1.buildDependencyGraph)(scan);
+    const scored = (0, scorer_1.scoreFiles)(intent, graph);
+    const result = (0, suggestions_1.getSuggestedFiles)(scored, 5);
+    return {
+        suggestedFiles: result.suggestions.map((s) => s.file),
+        confidence: result.confidence,
+        details: result.suggestions,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/context-engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context-engine/index.ts"],"names":[],"mappings":";;;AAmBA,wCAWC;AA9BD,uCAAwC;AACxC,mCAA+C;AAC/C,qCAAsC;AACtC,+CAAkD;AAElD,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AACpB,iCAA+C;AAAtC,6GAAA,oBAAoB,OAAA;AAC7B,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AAYnB,SAAgB,cAAc,CAAC,QAAgB,EAAE,MAAc;IAC7D,MAAM,IAAI,GAAG,IAAA,qBAAW,EAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,IAAA,4BAAoB,EAAC,IAAI,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAA,+BAAiB,EAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAE5C,OAAO;QACL,cAAc,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACrD,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,OAAO,EAAE,MAAM,CAAC,WAAW;KAC5B,CAAC;AACJ,CAAC"}

package/dist/context-engine/scanner.d.ts

@@ -0,0 +1,6 @@
+export type ProjectScanResult = {
+    files: string[];
+    fileContents: Record<string, string>;
+};
+export declare function scanProject(rootPath: string): ProjectScanResult;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/context-engine/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/context-engine/scanner.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,CAAC;AAuDF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAI/D"}

package/dist/context-engine/scanner.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanProject = scanProject;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const INCLUDE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx']);
+const EXCLUDE_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '.cache',
+    'coverage',
+    '.next',
+    '.turbo',
+]);
+function walkDir(dir, rootPath, result) {
+    let entries;
+    try {
+        entries = (0, fs_1.readdirSync)(dir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (EXCLUDE_DIRS.has(entry))
+            continue;
+        const fullPath = (0, path_1.join)(dir, entry);
+        let stat;
+        try {
+            stat = (0, fs_1.statSync)(fullPath);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isDirectory()) {
+            walkDir(fullPath, rootPath, result);
+            continue;
+        }
+        const lastDot = entry.lastIndexOf('.');
+        if (lastDot === -1)
+            continue;
+        const ext = entry.slice(lastDot);
+        if (!INCLUDE_EXTENSIONS.has(ext))
+            continue;
+        // Store relative path from rootPath
+        const relativePath = fullPath.slice(rootPath.length).replace(/\\/g, '/').replace(/^\//, '');
+        result.files.push(relativePath);
+        try {
+            result.fileContents[relativePath] = (0, fs_1.readFileSync)(fullPath, 'utf8');
+        }
+        catch {
+            result.fileContents[relativePath] = '';
+        }
+    }
+}
+function scanProject(rootPath) {
+    const result = { files: [], fileContents: {} };
+    walkDir(rootPath, rootPath, result);
+    return result;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/context-engine/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../src/context-engine/scanner.ts"],"names":[],"mappings":";;AA6DA,kCAIC;AAjED,2BAAyD;AACzD,+BAA4B;AAO5B,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAEnE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,cAAc;IACd,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,UAAU;IACV,OAAO;IACP,QAAQ;CACT,CAAC,CAAC;AAEH,SAAS,OAAO,CAAC,GAAW,EAAE,QAAgB,EAAE,MAAyB;IACvE,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,IAAA,gBAAW,EAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAEtC,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAClC,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,IAAA,aAAQ,EAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,OAAO,KAAK,CAAC,CAAC;YAAE,SAAS;QAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAE3C,oCAAoC;QACpC,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5F,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,GAAG,IAAA,iBAAY,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAgB,WAAW,CAAC,QAAgB;IAC1C,MAAM,MAAM,GAAsB,EAAE,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAClE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/context-engine/scorer.d.ts

@@ -0,0 +1,9 @@
+import type { DependencyGraph } from './graph';
+export type ScoredFile = {
+    file: string;
+    score: number;
+    reasons: string[];
+};
+export declare function extractTokens(intent: string): string[];
+export declare function scoreFiles(intent: string, graph: DependencyGraph): ScoredFile[];
+//# sourceMappingURL=scorer.d.ts.map

package/dist/context-engine/scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.d.ts","sourceRoot":"","sources":["../../src/context-engine/scorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAkBF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAMtD;AAcD,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,eAAe,GACrB,UAAU,EAAE,CAsFd"}

package/dist/context-engine/scorer.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTokens = extractTokens;
+exports.scoreFiles = scoreFiles;
+const STOP_WORDS = new Set([
+    'a', 'an', 'the', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+    'of', 'with', 'by', 'from', 'up', 'about', 'into', 'through', 'during',
+    'is', 'are', 'was', 'were', 'be', 'been', 'being', 'have', 'has', 'had',
+    'do', 'does', 'did', 'will', 'would', 'could', 'should', 'may', 'might',
+    'add', 'create', 'make', 'update', 'change', 'implement', 'fix', 'get',
+    'set', 'use', 'new', 'my', 'your', 'our', 'this', 'that', 'it',
+]);
+const SIGNAL_DIRS = [
+    'auth', 'api', 'middleware', 'service', 'services', 'payment', 'payments',
+    'analytics', 'dashboard', 'user', 'users', 'core', 'lib', 'utils', 'hooks',
+    'store', 'redux', 'context', 'database', 'db', 'models', 'routes', 'router',
+    'controllers', 'handlers', 'components', 'pages', 'views',
+];
+function extractTokens(intent) {
+    return intent
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter((t) => t.length > 1 && !STOP_WORDS.has(t));
+}
+function filenameParts(filePath) {
+    const parts = filePath.replace(/\\/g, '/').split('/');
+    const filename = parts[parts.length - 1] ?? '';
+    // Strip extension and split on separators
+    return filename.replace(/\.[^.]+$/, '').toLowerCase().split(/[-_.]/);
+}
+function dirParts(filePath) {
+    const parts = filePath.replace(/\\/g, '/').split('/');
+    return parts.slice(0, -1).map((p) => p.toLowerCase());
+}
+function scoreFiles(intent, graph) {
+    const tokens = extractTokens(intent);
+    const files = Object.keys(graph.imports);
+    const rawScores = {};
+    const rawReasons = {};
+    for (const file of files) {
+        let score = 0;
+        const reasons = [];
+        const fnParts = filenameParts(file);
+        const dParts = dirParts(file);
+        // Heuristic 1: filename match (+3 per keyword match)
+        for (const token of tokens) {
+            if (fnParts.some((p) => p.includes(token))) {
+                score += 3;
+                reasons.push(`filename matches "${token}"`);
+            }
+        }
+        // Heuristic 2: directory match (+2 per signal dir match)
+        for (const dir of dParts) {
+            if (SIGNAL_DIRS.includes(dir)) {
+                for (const token of tokens) {
+                    if (dir.includes(token)) {
+                        score += 2;
+                        reasons.push(`directory "${dir}" matches "${token}"`);
+                        break;
+                    }
+                }
+                // Also reward being in a recognized signal dir even without token match
+                if (tokens.some((t) => dir.includes(t)))
+                    continue;
+                // Check if any token partially matches a signal-dir keyword
+                for (const token of tokens) {
+                    if (SIGNAL_DIRS.some((sd) => sd.includes(token) && dir === sd)) {
+                        score += 2;
+                        reasons.push(`located in signal directory "${dir}"`);
+                    }
+                }
+            }
+        }
+        // Heuristic 3: token match in content (+1 per unique token match)
+        // We don't have content here, so we rely on the file path
+        const fullPathLower = file.toLowerCase();
+        for (const token of tokens) {
+            if (fullPathLower.includes(token)) {
+                score += 1;
+                reasons.push(`path contains "${token}"`);
+            }
+        }
+        rawScores[file] = score;
+        rawReasons[file] = reasons;
+    }
+    // Heuristic 4: import proximity (+2 if a file imports a high-scoring file)
+    // First pass: collect files with score > 0
+    const threshold = 3;
+    const highScoreFiles = new Set(Object.entries(rawScores)
+        .filter(([, s]) => s >= threshold)
+        .map(([f]) => f));
+    for (const file of files) {
+        const deps = graph.imports[file] ?? [];
+        for (const dep of deps) {
+            if (highScoreFiles.has(dep)) {
+                rawScores[file] = (rawScores[file] ?? 0) + 2;
+                rawReasons[file] = [...(rawReasons[file] ?? []), `imports high-relevance file "${dep}"`];
+                break; // only apply once per file
+            }
+        }
+    }
+    return files
+        .map((file) => ({
+        file,
+        score: rawScores[file] ?? 0,
+        reasons: rawReasons[file] ?? [],
+    }))
+        .filter((f) => f.score > 0)
+        .sort((a, b) => b.score - a.score);
+}
+//# sourceMappingURL=scorer.js.map

package/dist/context-engine/scorer.js.map

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

package/dist/context-engine/suggestions.d.ts

@@ -0,0 +1,12 @@
+import type { ScoredFile } from './scorer';
+export type FileSuggestion = {
+    file: string;
+    confidence: number;
+    reasons: string[];
+};
+export type SuggestionResult = {
+    suggestions: FileSuggestion[];
+    confidence: number;
+};
+export declare function getSuggestedFiles(scored: ScoredFile[], limit?: number): SuggestionResult;
+//# sourceMappingURL=suggestions.d.ts.map

package/dist/context-engine/suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../../src/context-engine/suggestions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,KAAK,SAAI,GACR,gBAAgB,CAsBlB"}

package/dist/context-engine/suggestions.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSuggestedFiles = getSuggestedFiles;
+function getSuggestedFiles(scored, limit = 5) {
+    if (scored.length === 0) {
+        return { suggestions: [], confidence: 0 };
+    }
+    const topN = scored.slice(0, limit);
+    const maxScore = scored[0].score;
+    const suggestions = topN.map((item) => ({
+        file: item.file,
+        confidence: maxScore > 0 ? parseFloat((item.score / maxScore).toFixed(2)) : 0,
+        reasons: item.reasons,
+    }));
+    // Overall confidence: average of top-N normalized scores, capped at 1
+    const avgConfidence = suggestions.reduce((sum, s) => sum + s.confidence, 0) / suggestions.length;
+    return {
+        suggestions,
+        confidence: parseFloat(Math.min(avgConfidence, 1).toFixed(2)),
+    };
+}
+//# sourceMappingURL=suggestions.js.map

package/dist/context-engine/suggestions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.js","sourceRoot":"","sources":["../../src/context-engine/suggestions.ts"],"names":[],"mappings":";;AAaA,8CAyBC;AAzBD,SAAgB,iBAAiB,CAC/B,MAAoB,EACpB,KAAK,GAAG,CAAC;IAET,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAEjC,MAAM,WAAW,GAAqB,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC,CAAC;IAEJ,sEAAsE;IACtE,MAAM,aAAa,GACjB,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC;IAE7E,OAAO;QACL,WAAW;QACX,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;KAC9D,CAAC;AACJ,CAAC"}