codedev-mcp 3.2.0

package/dist/analyzers/codebase.js

@@ -0,0 +1,354 @@
+/**
+ * Codebase Mapper
+ * Generates comprehensive overview of any codebase
+ * Handles small to large enterprise codebases efficiently
+ */
+import { readFile, readdir } from 'node:fs/promises';
+import path from 'node:path';
+import { listFiles } from '../search/fast-search.js';
+import { detectLanguage, isCodeFile } from '../utils/languages.js';
+import { extractSymbols } from './symbols.js';
+/**
+ * List of directories generally ignored in tree generation.
+ */
+const TREE_IGNORE_LIST = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '__pycache__',
+    '.venv',
+    'venv',
+    'target',
+    '.next',
+    '.nuxt',
+    'coverage',
+    'vendor',
+    '.idea',
+    '.vscode',
+    '.DS_Store',
+    'Pods',
+    '.dart_tool',
+]);
+/**
+ * Signals used to detect frameworks based on file presence.
+ * Format: [FrameworkName, [SignalFiles]]
+ */
+const FRAMEWORK_SIGNALS = [
+    ['React', ['package.json']],
+    ['Next.js', ['next.config.js', 'next.config.mjs', 'next.config.ts']],
+    ['Vue.js', ['vue.config.js', 'nuxt.config.js', 'nuxt.config.ts']],
+    ['Angular', ['angular.json']],
+    ['Svelte', ['svelte.config.js']],
+    ['Django', ['manage.py']],
+    ['Flask', ['wsgi.py']],
+    ['FastAPI', ['main.py']],
+    ['Spring Boot', ['pom.xml', 'build.gradle']],
+    ['Express.js', ['package.json']],
+    ['Rails', ['Gemfile', 'config/routes.rb']],
+    ['Laravel', ['artisan', 'composer.json']],
+    ['Terraform', ['main.tf']],
+    ['Flutter', ['pubspec.yaml']],
+    ['SwiftUI', ['Package.swift']],
+    ['.NET', ['*.csproj', '*.sln']],
+];
+/**
+ * Generates a full overview of the codebase at the specified directory.
+ *
+ * @param cwd - The root directory of the codebase to map.
+ * @returns A promise resolving to the codebase statistics, tree structure, and summary string.
+ */
+export async function mapCodebase(cwd) {
+    const allFiles = await listFiles(cwd, { type: 'file' });
+    const langCounts = {};
+    let codeFiles = 0;
+    for (const file of allFiles) {
+        const lang = detectLanguage(file);
+        if (lang !== 'unknown') {
+            langCounts[lang] = (langCounts[lang] || 0) + 1;
+        }
+        if (isCodeFile(file))
+            codeFiles++;
+    }
+    const languageBreakdown = {};
+    for (const [lang, count] of Object.entries(langCounts).sort((a, b) => b[1] - a[1])) {
+        languageBreakdown[lang] = {
+            files: count,
+            percentage: Math.round((count / allFiles.length) * 100),
+        };
+    }
+    const dirCounts = {};
+    for (const file of allFiles) {
+        const topDir = file.split('/')[0] || '.';
+        dirCounts[topDir] = (dirCounts[topDir] || 0) + 1;
+    }
+    const topDirectories = Object.entries(dirCounts)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 15)
+        .map(([p, files]) => ({ path: p, files }));
+    const frameworks = await detectFrameworks(cwd, allFiles);
+    const packageManagers = await detectPackageManagers(cwd, allFiles);
+    const hasTests = allFiles.some((f) => /\b(test|spec|__tests__|tests|_test|_spec)\b/i.test(f));
+    const hasCI = allFiles.some((f) => f.includes('.github/workflows') ||
+        f.includes('.gitlab-ci') ||
+        f.includes('Jenkinsfile') ||
+        f.includes('.circleci') ||
+        f.includes('.travis.yml') ||
+        f.includes('azure-pipelines'));
+    const hasDocs = allFiles.some((f) => /^(docs?|documentation)\//i.test(f) || f.toLowerCase() === 'readme.md');
+    const hasDocker = allFiles.some((f) => f.toLowerCase().includes('dockerfile') || f === 'docker-compose.yml' || f === 'docker-compose.yaml');
+    const estimatedSize = allFiles.length < 50 ? 'small' : allFiles.length < 500 ? 'medium' : allFiles.length < 5000 ? 'large' : 'enterprise';
+    const allDirs = new Set();
+    for (const file of allFiles) {
+        const dir = path.dirname(file);
+        if (dir !== '.')
+            allDirs.add(dir);
+    }
+    const stats = {
+        totalFiles: allFiles.length,
+        totalCodeFiles: codeFiles,
+        totalDirectories: allDirs.size,
+        languageBreakdown,
+        topDirectories,
+        estimatedSize,
+        frameworks,
+        packageManagers,
+        hasTests,
+        hasCI,
+        hasDocs,
+        hasDocker,
+    };
+    const maxDepth = estimatedSize === 'enterprise' ? 2 : estimatedSize === 'large' ? 3 : 4;
+    const tree = await generateTree(cwd, maxDepth);
+    const summary = formatSummary(stats);
+    return { stats, tree, summary };
+}
+/**
+ * Detects frameworks used in the codebase based on configuration files and dependencies.
+ *
+ * @param cwd - Root directory.
+ * @param files - List of all files in the codebase.
+ * @returns List of detected framework names.
+ */
+/**
+ * Detects frameworks used in the codebase based on configuration files and dependencies.
+ *
+ * @param cwd - The root directory of the codebase.
+ * @param files - List of all files in the codebase.
+ * @returns A promise resolving to a list of detected framework names.
+ */
+async function detectFrameworks(cwd, files) {
+    // ... (implementation same as before, just adding docs if missing)
+    const frameworks = [];
+    const fileSet = new Set(files.map((f) => f.toLowerCase()));
+    for (const [name, signals] of FRAMEWORK_SIGNALS) {
+        for (const signal of signals) {
+            if (signal.includes('*')) {
+                if (files.some((f) => f.endsWith(signal.replace('*', '')))) {
+                    frameworks.push(name);
+                    break;
+                }
+            }
+            else if (fileSet.has(signal.toLowerCase()) ||
+                files.some((f) => f.toLowerCase().endsWith('/' + signal.toLowerCase()))) {
+                if (name === 'React' && signal === 'package.json') {
+                    if (await hasPackageDependency(cwd, 'react'))
+                        frameworks.push('React');
+                }
+                else if (name === 'Express.js' && signal === 'package.json') {
+                    if (await hasPackageDependency(cwd, 'express'))
+                        frameworks.push('Express.js');
+                }
+                else {
+                    frameworks.push(name);
+                }
+                break;
+            }
+        }
+    }
+    return [...new Set(frameworks)];
+}
+/**
+ * Checks if a package dependency exists in package.json.
+ *
+ * @param cwd - Root directory.
+ * @param packageName - The package to check for.
+ * @returns True if found.
+ */
+async function hasPackageDependency(cwd, packageName) {
+    try {
+        const pkgContent = await readFile(path.join(cwd, 'package.json'), 'utf-8');
+        return pkgContent.includes(`"${packageName}"`);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detects package managers (npm, yarn, etc.) based on lockfiles.
+ *
+ * @param cwd - Root directory.
+ * @param files - List of files.
+ * @returns List of package managers.
+ */
+async function detectPackageManagers(cwd, files) {
+    const managers = [];
+    const fileSet = new Set(files.map((f) => path.basename(f).toLowerCase()));
+    if (fileSet.has('package-lock.json') || fileSet.has('package.json'))
+        managers.push('npm');
+    if (fileSet.has('yarn.lock'))
+        managers.push('yarn');
+    if (fileSet.has('pnpm-lock.yaml'))
+        managers.push('pnpm');
+    if (fileSet.has('bun.lockb'))
+        managers.push('bun');
+    if (fileSet.has('requirements.txt') || fileSet.has('pyproject.toml') || fileSet.has('setup.py'))
+        managers.push('pip');
+    if (fileSet.has('poetry.lock'))
+        managers.push('poetry');
+    if (fileSet.has('pipfile.lock'))
+        managers.push('pipenv');
+    if (fileSet.has('cargo.toml'))
+        managers.push('cargo');
+    if (fileSet.has('go.mod'))
+        managers.push('go modules');
+    if (fileSet.has('gemfile'))
+        managers.push('bundler');
+    if (fileSet.has('composer.json'))
+        managers.push('composer');
+    if (fileSet.has('pubspec.yaml'))
+        managers.push('pub');
+    if (fileSet.has('build.gradle') || fileSet.has('build.gradle.kts'))
+        managers.push('gradle');
+    if (fileSet.has('pom.xml'))
+        managers.push('maven');
+    return managers;
+}
+/**
+ * Generates a visual directory tree structure.
+ *
+ * @param cwd - Root directory.
+ * @param maxDepth - Max depth for recursion.
+ * @returns Tree string.
+ */
+async function generateTree(cwd, maxDepth) {
+    const lines = [];
+    async function walk(dir, prefix, depth) {
+        if (depth > maxDepth) {
+            lines.push(`${prefix}└── ...`);
+            return;
+        }
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            const filtered = entries
+                .filter((e) => !TREE_IGNORE_LIST.has(e.name) && !e.name.startsWith('.'))
+                .sort((a, b) => {
+                if (a.isDirectory() && !b.isDirectory())
+                    return -1;
+                if (!a.isDirectory() && b.isDirectory())
+                    return 1;
+                return a.name.localeCompare(b.name);
+            });
+            for (let i = 0; i < filtered.length; i++) {
+                const entry = filtered[i];
+                const isLast = i === filtered.length - 1;
+                const connector = isLast ? '└── ' : '├── ';
+                const nextPrefix = prefix + (isLast ? '    ' : '│   ');
+                if (entry.isDirectory()) {
+                    lines.push(`${prefix}${connector}${entry.name}/`);
+                    await walk(path.join(dir, entry.name), nextPrefix, depth + 1);
+                }
+                else {
+                    lines.push(`${prefix}${connector}${entry.name}`);
+                }
+            }
+        }
+        catch {
+            // Intentionally suppressed
+        }
+    }
+    lines.push(path.basename(cwd) + '/');
+    await walk(cwd, '', 1);
+    return lines.join('\n');
+}
+/**
+ * Formats the codebase statistics into a human-readable summary string.
+ *
+ * @param stats - The codebase statistics.
+ * @returns Formatted summary string in Markdown.
+ */
+function formatSummary(stats) {
+    const parts = [];
+    parts.push(`## Codebase Overview`);
+    parts.push(`Size: ${stats.estimatedSize.toUpperCase()} (${stats.totalFiles} files, ${stats.totalCodeFiles} code files, ${stats.totalDirectories} directories)`);
+    parts.push('');
+    parts.push(`### Languages`);
+    for (const [lang, info] of Object.entries(stats.languageBreakdown).slice(0, 10)) {
+        const bar = '█'.repeat(Math.max(1, Math.round(info.percentage / 5)));
+        parts.push(`  ${lang.padEnd(15)} ${bar} ${info.files} files (${info.percentage}%)`);
+    }
+    parts.push('');
+    if (stats.frameworks.length > 0) {
+        parts.push(`### Frameworks: ${stats.frameworks.join(', ')}`);
+    }
+    if (stats.packageManagers.length > 0) {
+        parts.push(`### Package Managers: ${stats.packageManagers.join(', ')}`);
+    }
+    const caps = [];
+    if (stats.hasTests)
+        caps.push('✅ Tests');
+    if (stats.hasCI)
+        caps.push('✅ CI/CD');
+    if (stats.hasDocs)
+        caps.push('✅ Docs');
+    if (stats.hasDocker)
+        caps.push('✅ Docker');
+    if (!stats.hasTests)
+        caps.push('❌ Tests');
+    if (!stats.hasCI)
+        caps.push('❌ CI/CD');
+    if (caps.length > 0) {
+        parts.push(`### Infrastructure: ${caps.join(' | ')}`);
+    }
+    parts.push('');
+    parts.push('### Top Directories');
+    for (const dir of stats.topDirectories.slice(0, 10)) {
+        parts.push(`  ${dir.path.padEnd(30)} ${dir.files} files`);
+    }
+    return parts.join('\n');
+}
+/**
+ * Maps symbols (functions, classes, etc.) for code files in the codebase.
+ *
+ * @param cwd - Root directory.
+ * @param options - Filtering and limit options.
+ * @returns List of files with their extracted symbols.
+ */
+export async function mapSymbols(cwd, options) {
+    let files = await listFiles(cwd, { type: 'file' });
+    if (options?.directory) {
+        files = files.filter((f) => f.startsWith(options.directory));
+    }
+    files = files.filter((f) => isCodeFile(f));
+    if (options?.language) {
+        files = files.filter((f) => detectLanguage(f) === options.language);
+    }
+    const maxFiles = options?.maxFiles || 200;
+    if (files.length > maxFiles) {
+        files = files.slice(0, maxFiles);
+    }
+    const results = [];
+    for (const file of files) {
+        try {
+            const symbols = await extractSymbols(path.join(cwd, file));
+            if (symbols.length > 0) {
+                results.push({ file, symbols });
+            }
+        }
+        catch {
+            // Skip files that fail symbol extraction
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=codebase.js.map

package/dist/analyzers/codebase.js.map

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

package/dist/analyzers/complexity-heatmap.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Complexity Heatmap
+ * Ranks files and functions by cyclomatic/cognitive complexity.
+ */
+export interface ComplexityEntry {
+    file: string;
+    symbol?: string;
+    line?: number;
+    metrics: {
+        cyclomatic: number;
+        cognitive: number;
+        nesting: number;
+        loc: number;
+        params?: number;
+    };
+    score: number;
+    grade: 'A' | 'B' | 'C' | 'D' | 'F';
+}
+export interface HeatmapResult {
+    hotspots: ComplexityEntry[];
+    fileScores: {
+        file: string;
+        score: number;
+        grade: string;
+        loc: number;
+    }[];
+    summary: {
+        totalFiles: number;
+        averageScore: number;
+        criticalCount: number;
+        healthyCount: number;
+    };
+}
+/**
+ * Generate a complexity heatmap for source files and functions.
+ * @param cwd - The working directory to scan.
+ * @param options - Configuration options.
+ * @param options.directory - The directory to analyze.
+ * @param options.fileGlob - Glob pattern for files to analyze.
+ * @param options.top - Number of top results to return.
+ * @param options.granularity - Analysis granularity level.
+ * @returns The heatmap result with hotspots and file scores.
+ */
+export declare function generateHeatmap(cwd: string, options?: {
+    directory?: string;
+    fileGlob?: string;
+    top?: number;
+    granularity?: 'file' | 'function';
+}): Promise<HeatmapResult>;
+//# sourceMappingURL=complexity-heatmap.d.ts.map

package/dist/analyzers/complexity-heatmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexity-heatmap.d.ts","sourceRoot":"","sources":["../../src/analyzers/complexity-heatmap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClG,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1E,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACpG;AAiED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;CAAE,GACnG,OAAO,CAAC,aAAa,CAAC,CA2ExB"}

package/dist/analyzers/complexity-heatmap.js

@@ -0,0 +1,156 @@
+/**
+ * Complexity Heatmap
+ * Ranks files and functions by cyclomatic/cognitive complexity.
+ */
+import { listFiles } from '../search/fast-search.js';
+import { extractSymbols } from '../analyzers/symbols.js';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+function cyclomatic(code) {
+    let c = 1;
+    const ps = [
+        /\bif\b/g,
+        /\belse\s+if\b/g,
+        /\bwhile\b/g,
+        /\bfor\b/g,
+        /\bcase\b/g,
+        /\bcatch\b/g,
+        /&&/g,
+        /\|\|/g,
+        /\?[^.?:]/g,
+    ];
+    for (const p of ps) {
+        const m = code.match(p);
+        if (m)
+            c += m.length;
+    }
+    return c;
+}
+function cognitive(code) {
+    let cog = 0, nest = 0;
+    for (const line of code.split('\n')) {
+        const t = line.trim();
+        if (/\b(if|elif|while|for|switch|match)\b/.test(t))
+            cog += 1 + nest;
+        if (/\belse\b/.test(t) && !/else\s+if/.test(t))
+            cog += 1;
+        cog += (t.match(/&&|\|\|/g) || []).length;
+        nest += (line.match(/{/g) || []).length - (line.match(/}/g) || []).length;
+        nest = Math.max(0, nest);
+    }
+    return cog;
+}
+function maxNesting(code) {
+    let max = 0, cur = 0;
+    for (const ch of code) {
+        if (ch === '{') {
+            cur++;
+            max = Math.max(max, cur);
+        }
+        else if (ch === '}')
+            cur = Math.max(0, cur - 1);
+    }
+    return max;
+}
+function grade(s) {
+    if (s <= 20)
+        return 'A';
+    if (s <= 40)
+        return 'B';
+    if (s <= 60)
+        return 'C';
+    if (s <= 80)
+        return 'D';
+    return 'F';
+}
+function score(m) {
+    return Math.round(Math.min(100, (m.cyclomatic / 30) * 100) * 0.3 +
+        Math.min(100, (m.cognitive / 50) * 100) * 0.3 +
+        Math.min(100, (m.nesting / 8) * 100) * 0.2 +
+        Math.min(100, (m.loc / 500) * 100) * 0.2);
+}
+/**
+ * Generate a complexity heatmap for source files and functions.
+ * @param cwd - The working directory to scan.
+ * @param options - Configuration options.
+ * @param options.directory - The directory to analyze.
+ * @param options.fileGlob - Glob pattern for files to analyze.
+ * @param options.top - Number of top results to return.
+ * @param options.granularity - Analysis granularity level.
+ * @returns The heatmap result with hotspots and file scores.
+ */
+export async function generateHeatmap(cwd, options) {
+    const dir = path.resolve(cwd, options?.directory || '.');
+    const files = await listFiles(dir, { glob: options?.fileGlob || '**/*.{ts,tsx,js,jsx,py,java,go,rs,rb,php,cs}' });
+    const top = options?.top || 20;
+    const hotspots = [];
+    const fileScores = [];
+    for (const file of files.slice(0, 500)) {
+        try {
+            const absPath = path.resolve(dir, file);
+            const content = await readFile(absPath, 'utf-8');
+            const lines = content.split('\n');
+            const codeLoc = lines.filter((l) => l.trim() && !l.trim().startsWith('//')).length;
+            const fm = {
+                cyclomatic: cyclomatic(content),
+                cognitive: cognitive(content),
+                nesting: maxNesting(content),
+                loc: codeLoc,
+            };
+            const fs = score(fm);
+            fileScores.push({ file, score: fs, grade: grade(fs), loc: codeLoc });
+            if (options?.granularity !== 'file') {
+                const symbols = await extractSymbols(absPath);
+                for (const fn of symbols.filter((s) => s.kind === 'function' || s.kind === 'class')) {
+                    const start = fn.line - 1;
+                    let end = start, braces = 0, opened = false;
+                    for (let i = start; i < lines.length && i < start + 200; i++) {
+                        for (const ch of lines[i]) {
+                            if (ch === '{') {
+                                braces++;
+                                opened = true;
+                            }
+                            if (ch === '}')
+                                braces--;
+                        }
+                        end = i;
+                        if (opened && braces <= 0)
+                            break;
+                    }
+                    const body = lines.slice(start, end + 1).join('\n');
+                    if (end - start < 3)
+                        continue;
+                    const paramMatch = lines[start]?.match(/\(([^)]*)\)/);
+                    const params = paramMatch ? (paramMatch[1].trim() ? paramMatch[1].split(',').length : 0) : 0;
+                    const m = {
+                        cyclomatic: cyclomatic(body),
+                        cognitive: cognitive(body),
+                        nesting: maxNesting(body),
+                        loc: end - start + 1,
+                        params,
+                    };
+                    const s = score(m);
+                    hotspots.push({ file, symbol: fn.name, line: fn.line, metrics: m, score: s, grade: grade(s) });
+                }
+            }
+        }
+        catch {
+            /* skip */
+        }
+    }
+    hotspots.sort((a, b) => b.score - a.score);
+    fileScores.sort((a, b) => b.score - a.score);
+    const scores = fileScores.map((f) => f.score);
+    const avg = scores.length ? Math.round(scores.reduce((a, b) => a + b, 0) / scores.length) : 0;
+    return {
+        hotspots: hotspots.slice(0, top),
+        fileScores: fileScores.slice(0, top),
+        summary: {
+            totalFiles: fileScores.length,
+            averageScore: avg,
+            criticalCount: fileScores.filter((f) => f.grade === 'D' || f.grade === 'F').length,
+            healthyCount: fileScores.filter((f) => f.grade === 'A' || f.grade === 'B').length,
+        },
+    };
+}
+//# sourceMappingURL=complexity-heatmap.js.map

package/dist/analyzers/complexity-heatmap.js.map

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

package/dist/analyzers/context-pack.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Smart Context Window Packing
+ * Given a question/task, returns the most relevant files and symbols
+ * that fit within a given token budget. Helps agents minimize waste.
+ */
+export interface ContextItem {
+    file: string;
+    startLine?: number;
+    endLine?: number;
+    content: string;
+    /** 0-1 score */
+    relevance: number;
+    /** Why this item was included */
+    reason: string;
+    estimatedTokens: number;
+}
+export interface ContextPackResult {
+    items: ContextItem[];
+    totalTokens: number;
+    budget: number;
+    filesIncluded: number;
+    filesSkipped: number;
+    strategy: string;
+}
+/**
+ * Pack the most relevant context for a given question within a token budget.
+ * @param cwd - The working directory to scan.
+ * @param options - Configuration options.
+ * @param options.query - The search query.
+ * @param options.maxTokens - Maximum token budget.
+ * @param options.includeImports - Whether to include imported files.
+ * @param options.includeSymbols - Whether to include symbols.
+ * @param options.maxFiles - Maximum number of files to include.
+ * @returns The packed context result.
+ */
+export declare function packContext(cwd: string, options: {
+    query: string;
+    maxTokens?: number;
+    includeImports?: boolean;
+    includeSymbols?: boolean;
+    maxFiles?: number;
+}): Promise<ContextPackResult>;
+//# sourceMappingURL=context-pack.d.ts.map

package/dist/analyzers/context-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pack.d.ts","sourceRoot":"","sources":["../../src/analyzers/context-pack.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAuCD;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,iBAAiB,CAAC,CA+I5B"}