codevault 1.6.0 → 1.7.0

package/dist/storage/encrypted-chunks.js

@@ -0,0 +1,238 @@
+import crypto from 'crypto';
+import fs from 'fs';
+import path from 'path';
+import zlib from 'zlib';
+import { log } from '../utils/logger.js';
+const KEY_ENV_VAR = 'CODEVAULT_ENCRYPTION_KEY';
+const MAGIC_HEADER = Buffer.from('CVAULTE1', 'utf8');
+const SALT_LENGTH = 16;
+const IV_LENGTH = 12;
+const TAG_LENGTH = 16;
+const HKDF_INFO = Buffer.from('codevault-chunk-v1', 'utf8');
+let cachedNormalizedKey = null;
+let cachedKeyBuffer = null;
+let cachedKeyError = null;
+function decodeKey(raw) {
+    if (typeof raw !== 'string') {
+        return null;
+    }
+    const trimmed = raw.trim();
+    if (trimmed.length === 0) {
+        return null;
+    }
+    try {
+        const base64 = Buffer.from(trimmed, 'base64');
+        if (base64.length === 32) {
+            return base64;
+        }
+    }
+    catch (error) {
+        log.debug('Failed to decode key as base64, will try hex', { error });
+    }
+    try {
+        const hex = Buffer.from(trimmed, 'hex');
+        if (hex.length === 32) {
+            return hex;
+        }
+    }
+    catch (error) {
+        log.debug('Failed to decode key as hex', { error });
+    }
+    return null;
+}
+export function resetEncryptionCacheForTests() {
+    cachedNormalizedKey = null;
+    cachedKeyBuffer = null;
+    cachedKeyError = null;
+}
+export function getActiveEncryptionKey() {
+    const raw = process.env[KEY_ENV_VAR];
+    const normalized = typeof raw === 'string' ? raw.trim() : '';
+    // FIX: Always check if env var changed to support runtime updates
+    if (normalized === cachedNormalizedKey && cachedKeyBuffer) {
+        return cachedKeyBuffer;
+    }
+    // Invalidate cache when environment variable changes
+    cachedNormalizedKey = normalized;
+    cachedKeyError = null;
+    cachedKeyBuffer = null;
+    if (!normalized) {
+        return null;
+    }
+    const decoded = decodeKey(normalized);
+    if (!decoded) {
+        cachedKeyError = new Error(`${KEY_ENV_VAR} must be a 32-byte key encoded as base64 or hex.`);
+        return null;
+    }
+    cachedKeyBuffer = decoded;
+    return cachedKeyBuffer;
+}
+export function getEncryptionKeyError() {
+    return cachedKeyError;
+}
+const warnedInvalidMode = new Set();
+let warnedInvalidKey = false;
+function normalizeMode(mode) {
+    if (typeof mode !== 'string') {
+        return undefined;
+    }
+    return mode.trim().toLowerCase();
+}
+export function resolveEncryptionPreference({ mode, logger = console } = {}) {
+    const normalizedMode = normalizeMode(mode);
+    if (normalizedMode && normalizedMode !== 'on' && normalizedMode !== 'off' && !warnedInvalidMode.has(normalizedMode)) {
+        if (logger && typeof logger.warn === 'function') {
+            logger.warn(`Unknown --encrypt mode "${mode}". Expected "on" or "off". Falling back to environment configuration.`);
+        }
+        warnedInvalidMode.add(normalizedMode);
+    }
+    if (normalizedMode === 'off') {
+        return { enabled: false, key: null, reason: 'flag_off' };
+    }
+    const key = getActiveEncryptionKey();
+    if (!key) {
+        const keyError = getEncryptionKeyError();
+        if (normalizedMode === 'on') {
+            throw keyError || new Error('CODEVAULT_ENCRYPTION_KEY is not configured but encryption was requested (--encrypt on).');
+        }
+        if (keyError && !warnedInvalidKey && logger && typeof logger.warn === 'function') {
+            logger.warn(`${keyError.message} Encryption disabled.`);
+            warnedInvalidKey = true;
+        }
+        return { enabled: false, key: null, reason: keyError ? 'invalid_key' : 'missing_key' };
+    }
+    return { enabled: true, key, reason: 'enabled' };
+}
+function deriveChunkKey(masterKey, salt) {
+    return Buffer.from(crypto.hkdfSync('sha256', masterKey, salt, HKDF_INFO, 32));
+}
+function encryptBuffer(plaintext, masterKey) {
+    const salt = crypto.randomBytes(SALT_LENGTH);
+    const iv = crypto.randomBytes(IV_LENGTH);
+    const derivedKey = deriveChunkKey(masterKey, salt);
+    const cipher = crypto.createCipheriv('aes-256-gcm', derivedKey, iv);
+    const encrypted = Buffer.concat([cipher.update(plaintext), cipher.final()]);
+    const tag = cipher.getAuthTag();
+    const payload = Buffer.concat([MAGIC_HEADER, salt, iv, encrypted, tag]);
+    return { payload, salt, iv, tag };
+}
+function decryptBuffer(payload, masterKey) {
+    const minimumLength = MAGIC_HEADER.length + SALT_LENGTH + IV_LENGTH + TAG_LENGTH + 1;
+    if (!payload || payload.length < minimumLength) {
+        const error = new Error('Encrypted chunk payload is truncated.');
+        error.code = 'ENCRYPTION_PAYLOAD_INVALID';
+        throw error;
+    }
+    const header = payload.subarray(0, MAGIC_HEADER.length);
+    if (!header.equals(MAGIC_HEADER)) {
+        const error = new Error('Encrypted chunk payload has an unknown header.');
+        error.code = 'ENCRYPTION_FORMAT_UNRECOGNIZED';
+        throw error;
+    }
+    const saltStart = MAGIC_HEADER.length;
+    const ivStart = saltStart + SALT_LENGTH;
+    const cipherStart = ivStart + IV_LENGTH;
+    const cipherEnd = payload.length - TAG_LENGTH;
+    const salt = payload.subarray(saltStart, saltStart + SALT_LENGTH);
+    const iv = payload.subarray(ivStart, ivStart + IV_LENGTH);
+    const ciphertext = payload.subarray(cipherStart, cipherEnd);
+    const tag = payload.subarray(cipherEnd);
+    const derivedKey = deriveChunkKey(masterKey, salt);
+    const decipher = crypto.createDecipheriv('aes-256-gcm', derivedKey, iv);
+    decipher.setAuthTag(tag);
+    try {
+        return Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+    }
+    catch (error) {
+        const authError = new Error('authentication failed');
+        authError.code = 'ENCRYPTION_AUTH_FAILED';
+        authError.cause = error;
+        throw authError;
+    }
+}
+function getChunkPaths(chunkDir, sha) {
+    const plainPath = path.join(chunkDir, `${sha}.gz`);
+    const encryptedPath = path.join(chunkDir, `${sha}.gz.enc`);
+    return { plainPath, encryptedPath };
+}
+export function writeChunkToDisk({ chunkDir, sha, code, encryption }) {
+    const { plainPath, encryptedPath } = getChunkPaths(chunkDir, sha);
+    const buffer = Buffer.isBuffer(code) ? code : Buffer.from(code, 'utf8');
+    const compressed = zlib.gzipSync(buffer);
+    if (encryption && encryption.enabled && encryption.key) {
+        const { payload } = encryptBuffer(compressed, encryption.key);
+        fs.writeFileSync(encryptedPath, payload);
+        if (fs.existsSync(plainPath)) {
+            fs.rmSync(plainPath, { force: true });
+        }
+        return { encrypted: true, path: encryptedPath };
+    }
+    fs.writeFileSync(plainPath, compressed);
+    if (fs.existsSync(encryptedPath)) {
+        fs.rmSync(encryptedPath, { force: true });
+    }
+    return { encrypted: false, path: plainPath };
+}
+export function readChunkFromDisk({ chunkDir, sha, key = getActiveEncryptionKey() }) {
+    const { plainPath, encryptedPath } = getChunkPaths(chunkDir, sha);
+    if (fs.existsSync(encryptedPath)) {
+        if (!key) {
+            const error = new Error(`Chunk ${sha} is encrypted and no CODEVAULT_ENCRYPTION_KEY is configured.`);
+            error.code = 'ENCRYPTION_KEY_REQUIRED';
+            throw error;
+        }
+        const payload = fs.readFileSync(encryptedPath);
+        let decrypted;
+        try {
+            decrypted = decryptBuffer(payload, key);
+        }
+        catch (error) {
+            if (error.code === 'ENCRYPTION_AUTH_FAILED') {
+                const authError = new Error(`Failed to decrypt chunk ${sha}: authentication failed.`);
+                authError.code = 'ENCRYPTION_AUTH_FAILED';
+                authError.cause = error;
+                throw authError;
+            }
+            error.message = `Failed to decrypt chunk ${sha}: ${error.message}`;
+            throw error;
+        }
+        try {
+            const code = zlib.gunzipSync(decrypted).toString('utf8');
+            return { code, encrypted: true };
+        }
+        catch (error) {
+            const decompressionError = new Error(`Failed to decompress chunk ${sha}: ${error.message}`);
+            decompressionError.code = 'CHUNK_DECOMPRESSION_FAILED';
+            decompressionError.cause = error;
+            throw decompressionError;
+        }
+    }
+    if (fs.existsSync(plainPath)) {
+        try {
+            const compressed = fs.readFileSync(plainPath);
+            const code = zlib.gunzipSync(compressed).toString('utf8');
+            return { code, encrypted: false };
+        }
+        catch (error) {
+            const readError = new Error(`Failed to read chunk ${sha}: ${error.message}`);
+            readError.code = 'CHUNK_READ_FAILED';
+            readError.cause = error;
+            throw readError;
+        }
+    }
+    return null;
+}
+export function removeChunkArtifacts(chunkDir, sha) {
+    const { plainPath, encryptedPath } = getChunkPaths(chunkDir, sha);
+    if (fs.existsSync(plainPath)) {
+        fs.rmSync(plainPath, { force: true });
+    }
+    if (fs.existsSync(encryptedPath)) {
+        fs.rmSync(encryptedPath, { force: true });
+    }
+}
+export function isChunkEncryptedOnDisk(chunkDir, sha) {
+    const { encryptedPath } = getChunkPaths(chunkDir, sha);
+    return fs.existsSync(encryptedPath);
+}
+//# sourceMappingURL=encrypted-chunks.js.map

package/dist/storage/encrypted-chunks.js.map

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

package/dist/symbols/extract.d.ts

@@ -0,0 +1,15 @@
+import type { TreeSitterNode } from '../types/ast.js';
+export interface SymbolMetadata {
+    signature: string;
+    parameters: string[];
+    returnType: string | null;
+    calls: string[];
+    keywords: string[];
+}
+export declare function extractSymbolMetadata({ node, source, symbol }: {
+    node: TreeSitterNode;
+    source: string;
+    symbol: string;
+}): SymbolMetadata;
+export declare function queryMatchesSignature(query: string, metadata: any): boolean;
+//# sourceMappingURL=extract.d.ts.map

package/dist/symbols/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/symbols/extract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAYtD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA4LD,wBAAgB,qBAAqB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;IAC9D,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,cAAc,CAgBjB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAyC3E"}

package/dist/symbols/extract.js

@@ -0,0 +1,208 @@
+import { CHUNKING_CONSTANTS, SYMBOL_BOOST_CONSTANTS } from '../config/constants.js';
+const KEYWORD_BLACKLIST = new Set([
+    'if', 'for', 'while', 'switch', 'catch', 'return', 'function', 'class',
+    'new', 'await', 'yield', 'isset', 'empty', 'echo', 'print', 'require', 'include'
+]);
+// Regex cache for performance
+const regexCache = new Map();
+const MAX_CACHE_SIZE = 1000;
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function sliceSignatureSnippet(source, node) {
+    const start = node.startIndex;
+    const end = Math.min(node.endIndex, start + CHUNKING_CONSTANTS.MAX_SIGNATURE_SNIPPET);
+    return source.slice(start, end);
+}
+function findClosingParen(text, startIndex) {
+    let depth = 0;
+    for (let i = startIndex; i < text.length; i++) {
+        const char = text[i];
+        if (char === '(') {
+            depth++;
+        }
+        else if (char === ')') {
+            depth--;
+            if (depth === 0) {
+                return i;
+            }
+        }
+    }
+    return -1;
+}
+function buildMemoizedRegex(word) {
+    const cacheKey = `\\b${word}[a-z0-9_]*\\b`;
+    const cached = regexCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    const regex = new RegExp(cacheKey, 'i');
+    // Add to cache with size limit
+    if (regexCache.size >= MAX_CACHE_SIZE) {
+        const firstKey = regexCache.keys().next().value;
+        if (firstKey !== undefined) {
+            regexCache.delete(firstKey);
+        }
+    }
+    regexCache.set(cacheKey, regex);
+    return regex;
+}
+function extractParameterSection(snippet) {
+    const openIndex = snippet.indexOf('(');
+    if (openIndex === -1) {
+        return { paramsText: '', closeIndex: -1 };
+    }
+    const closeIndex = findClosingParen(snippet, openIndex);
+    if (closeIndex === -1) {
+        return { paramsText: '', closeIndex: -1 };
+    }
+    const paramsText = snippet.slice(openIndex + 1, closeIndex).trim();
+    return { paramsText, closeIndex };
+}
+function normalizeParameter(param) {
+    if (!param) {
+        return '';
+    }
+    const withoutDefaults = param.split('=')[0].trim();
+    const cleaned = withoutDefaults.replace(/^[*&]+/, '').trim();
+    return cleaned;
+}
+function extractParameters(snippet) {
+    const { paramsText, closeIndex } = extractParameterSection(snippet);
+    if (closeIndex === -1 || paramsText.length === 0) {
+        return { parameters: [], closeIndex };
+    }
+    const rawParams = paramsText.split(',');
+    const parameters = rawParams
+        .map(param => normalizeParameter(param))
+        .filter(param => param.length > 0)
+        .slice(0, SYMBOL_BOOST_CONSTANTS.MAX_PARAMETERS);
+    return { parameters, closeIndex };
+}
+function extractReturnType(snippet, closeIndex) {
+    if (closeIndex === -1) {
+        return null;
+    }
+    const after = snippet.slice(closeIndex + 1, closeIndex + CHUNKING_CONSTANTS.MAX_RETURN_TYPE_SNIPPET);
+    const colonMatch = after.match(/:\s*([A-Za-z0-9_\\\[\]<>|?]+)/);
+    if (colonMatch) {
+        return colonMatch[1];
+    }
+    const arrowMatch = after.match(/->\s*([A-Za-z0-9_\\\[\]<>|?]+)/);
+    if (arrowMatch) {
+        return arrowMatch[1];
+    }
+    return null;
+}
+function buildSignature(symbol, snippet, node) {
+    const normalizedSymbol = typeof symbol === 'string' ? symbol.trim() : '';
+    const isClassNode = node.type && node.type.includes('class');
+    if (isClassNode && normalizedSymbol) {
+        return { signature: `class ${normalizedSymbol}`, parameters: [], returnType: null };
+    }
+    if (!normalizedSymbol) {
+        return { signature: '', parameters: [], returnType: null };
+    }
+    const { parameters, closeIndex } = extractParameters(snippet);
+    const returnType = extractReturnType(snippet, closeIndex);
+    const paramText = parameters.length > 0 ? parameters.join(', ') : '';
+    const signature = returnType
+        ? `${normalizedSymbol}(${paramText}) : ${returnType}`
+        : `${normalizedSymbol}(${paramText})`;
+    return { signature, parameters, returnType };
+}
+function extractCallNameFromSnippet(snippet) {
+    const trimmed = snippet.trim();
+    if (!trimmed.includes('(')) {
+        return null;
+    }
+    const callMatch = trimmed.match(/(?:\$?[A-Za-z_][\w]*->|[A-Za-z_][\w]*::|[A-Za-z_][\w]*\.)*([A-Za-z_][\w]*)\s*\(/);
+    if (!callMatch) {
+        return null;
+    }
+    const candidate = callMatch[1];
+    if (!candidate || KEYWORD_BLACKLIST.has(candidate)) {
+        return null;
+    }
+    return candidate;
+}
+function collectCalls(node, source, calls) {
+    const nodeType = node.type || '';
+    const isCallNode = nodeType.includes('call') || nodeType.includes('invocation');
+    if (isCallNode) {
+        const snippet = source.slice(node.startIndex, Math.min(node.endIndex, node.startIndex + CHUNKING_CONSTANTS.MAX_CALL_SNIPPET));
+        const name = extractCallNameFromSnippet(snippet);
+        if (name) {
+            calls.add(name);
+        }
+    }
+    for (let i = 0; i < node.childCount; i++) {
+        const child = node.child(i);
+        if (child) {
+            collectCalls(child, source, calls);
+        }
+    }
+}
+function splitSymbolWords(symbol) {
+    if (!symbol) {
+        return [];
+    }
+    const cleaned = symbol.replace(/[^A-Za-z0-9_]/g, ' ');
+    const words = cleaned
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .split(/[\s_]+/)
+        .map(word => word.trim().toLowerCase())
+        .filter(word => word.length > 0);
+    return words;
+}
+export function extractSymbolMetadata({ node, source, symbol }) {
+    const snippet = sliceSignatureSnippet(source, node);
+    const { signature, parameters, returnType } = buildSignature(symbol, snippet, node);
+    const calls = new Set();
+    collectCalls(node, source, calls);
+    const symbolWords = splitSymbolWords(symbol);
+    return {
+        signature,
+        parameters,
+        returnType,
+        calls: Array.from(calls),
+        keywords: symbolWords
+    };
+}
+export function queryMatchesSignature(query, metadata) {
+    if (!metadata) {
+        return false;
+    }
+    const queryLower = query.toLowerCase();
+    const signature = typeof metadata.signature === 'string' ? metadata.signature.toLowerCase() : '';
+    const symbol = typeof metadata.symbol === 'string' ? metadata.symbol.toLowerCase() : '';
+    if (symbol && queryLower.includes(symbol)) {
+        return true;
+    }
+    if (signature && queryLower.includes(signature)) {
+        return true;
+    }
+    if (Array.isArray(metadata.symbol_parameters)) {
+        for (const param of metadata.symbol_parameters) {
+            if (typeof param === 'string' && param.length > 2) {
+                const needle = param.toLowerCase();
+                if (queryLower.includes(needle)) {
+                    return true;
+                }
+            }
+        }
+    }
+    if (Array.isArray(metadata.keywords) && metadata.keywords.length > 0) {
+        for (const word of metadata.keywords) {
+            if (!word || word.length < SYMBOL_BOOST_CONSTANTS.MIN_TOKEN_LENGTH) {
+                continue;
+            }
+            const pattern = buildMemoizedRegex(escapeRegex(word));
+            if (pattern.test(query)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=extract.js.map

package/dist/symbols/extract.js.map

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

package/dist/symbols/graph.d.ts

@@ -0,0 +1,3 @@
+import type { Codemap } from '../types/codemap.js';
+export declare function attachSymbolGraphToCodemap(codemap: Codemap): Codemap;
+//# sourceMappingURL=graph.d.ts.map

package/dist/symbols/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/symbols/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAqDnD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CA8DpE"}

package/dist/symbols/graph.js

@@ -0,0 +1,89 @@
+import { MAX_NEIGHBORS } from '../config/constants.js';
+function toLower(value) {
+    return typeof value === 'string' ? value.trim().toLowerCase() : '';
+}
+function buildSymbolIndex(codemap) {
+    const index = new Map();
+    for (const [chunkId, entry] of Object.entries(codemap)) {
+        if (!entry || typeof entry !== 'object') {
+            continue;
+        }
+        const symbol = typeof entry.symbol === 'string' ? entry.symbol.trim() : '';
+        if (!symbol) {
+            continue;
+        }
+        const key = symbol.toLowerCase();
+        if (!index.has(key)) {
+            index.set(key, []);
+        }
+        index.get(key).push({
+            chunkId,
+            sha: entry.sha,
+            file: entry.file,
+            symbol
+        });
+    }
+    return index;
+}
+function selectCandidate(candidates, entry) {
+    if (!Array.isArray(candidates) || candidates.length === 0) {
+        return null;
+    }
+    if (!entry || !entry.file) {
+        return candidates[0];
+    }
+    const sameFile = candidates.find(candidate => candidate.file === entry.file);
+    return sameFile || candidates[0];
+}
+export function attachSymbolGraphToCodemap(codemap) {
+    if (!codemap || typeof codemap !== 'object') {
+        return codemap;
+    }
+    const symbolIndex = buildSymbolIndex(codemap);
+    const adjacency = new Map();
+    for (const [chunkId, entry] of Object.entries(codemap)) {
+        if (!entry || typeof entry !== 'object' || typeof entry.sha !== 'string') {
+            continue;
+        }
+        const outgoing = new Set();
+        const rawCalls = Array.isArray(entry.symbol_calls) ? entry.symbol_calls : [];
+        for (const rawName of rawCalls) {
+            const candidateName = toLower(rawName);
+            if (!candidateName) {
+                continue;
+            }
+            const candidates = symbolIndex.get(candidateName);
+            if (!candidates || candidates.length === 0) {
+                continue;
+            }
+            const target = selectCandidate(candidates, entry);
+            if (target && typeof target.sha === 'string' && target.sha.length > 0 && target.sha !== entry.sha) {
+                outgoing.add(target.sha);
+            }
+        }
+        adjacency.set(entry.sha, outgoing);
+        entry.symbol_call_targets = Array.from(outgoing).slice(0, MAX_NEIGHBORS);
+    }
+    const incoming = new Map();
+    for (const [fromSha, targets] of adjacency.entries()) {
+        for (const targetSha of targets) {
+            if (!incoming.has(targetSha)) {
+                incoming.set(targetSha, new Set());
+            }
+            incoming.get(targetSha).add(fromSha);
+        }
+    }
+    for (const entry of Object.values(codemap)) {
+        if (!entry || typeof entry.sha !== 'string') {
+            continue;
+        }
+        const outgoing = adjacency.get(entry.sha) || new Set();
+        const inbound = incoming.get(entry.sha) || new Set();
+        const neighbors = new Set([...outgoing, ...inbound]);
+        entry.symbol_call_targets = Array.from(outgoing).slice(0, MAX_NEIGHBORS);
+        entry.symbol_callers = Array.from(inbound).slice(0, MAX_NEIGHBORS);
+        entry.symbol_neighbors = Array.from(neighbors).slice(0, MAX_NEIGHBORS * 2);
+    }
+    return codemap;
+}
+//# sourceMappingURL=graph.js.map

package/dist/symbols/graph.js.map

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

package/dist/synthesis/conversational-synthesizer.d.ts

@@ -0,0 +1,61 @@
+import type { ScopeFilters } from '../types/search.js';
+import type { SearchResult } from '../core/types.js';
+export interface ConversationTurn {
+    question: string;
+    answer: string;
+    chunks: SearchResult[];
+    timestamp: Date;
+}
+export interface ConversationContext {
+    turns: ConversationTurn[];
+    allChunks: Map<string, {
+        result: SearchResult;
+        code: string;
+    }>;
+}
+export interface ConversationalSynthesisOptions {
+    provider?: string;
+    chatProvider?: string;
+    workingPath?: string;
+    scope?: ScopeFilters;
+    maxChunks?: number;
+    useReranking?: boolean;
+    temperature?: number;
+    maxHistoryTurns?: number;
+    onChunksSelected?: (chunks: SearchResult[]) => void;
+}
+export interface ConversationalSynthesisResult {
+    success: boolean;
+    answer?: string;
+    query: string;
+    chunksAnalyzed: number;
+    chatProvider: string;
+    embeddingProvider: string;
+    error?: string;
+    newChunks?: SearchResult[];
+}
+/**
+ * Synthesize an answer in the context of an ongoing conversation
+ */
+export declare function synthesizeConversationalAnswer(query: string, conversationContext: ConversationContext, options?: ConversationalSynthesisOptions): Promise<ConversationalSynthesisResult>;
+/**
+ * Streaming version for real-time responses
+ */
+export declare function synthesizeConversationalAnswerStreaming(query: string, conversationContext: ConversationContext, options?: ConversationalSynthesisOptions): AsyncGenerator<string>;
+/**
+ * Create a new conversation context
+ */
+export declare function createConversationContext(): ConversationContext;
+/**
+ * Add a turn to the conversation history
+ */
+export declare function addConversationTurn(context: ConversationContext, turn: ConversationTurn): void;
+/**
+ * Clear conversation history
+ */
+export declare function clearConversationHistory(context: ConversationContext): void;
+/**
+ * Get conversation summary for display
+ */
+export declare function getConversationSummary(context: ConversationContext): string;
+//# sourceMappingURL=conversational-synthesizer.d.ts.map