codevault 1.6.0 → 1.6.1

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversational-synthesizer.d.ts","sourceRoot":"","sources":["../../src/synthesis/conversational-synthesizer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,MAAM,EACb,mBAAmB,EAAE,mBAAmB,EACxC,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,6BAA6B,CAAC,CAqGxC;AAED;;GAEG;AACH,wBAAuB,uCAAuC,CAC5D,KAAK,EAAE,MAAM,EACb,mBAAmB,EAAE,mBAAmB,EACxC,OAAO,GAAE,8BAAmC,GAC3C,cAAc,CAAC,MAAM,CAAC,CAmExB;AAiJD;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,mBAAmB,CAK/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,gBAAgB,GACrB,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAG3E;AAaD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAQ3E"}

package/dist/synthesis/conversational-synthesizer.js

@@ -0,0 +1,286 @@
+import { searchCode, getChunk } from '../core/search.js';
+import { PROMPT_TRUNCATE_LENGTH, CONVERSATION_MAX_CONTEXT_CHUNKS } from '../config/constants.js';
+import { createChatLLMProvider } from '../providers/chat-llm.js';
+/**
+ * Synthesize an answer in the context of an ongoing conversation
+ */
+export async function synthesizeConversationalAnswer(query, conversationContext, options = {}) {
+    const { provider = 'auto', chatProvider = 'auto', workingPath = '.', scope = {}, maxChunks = 10, useReranking = true, temperature = 0.7, maxHistoryTurns = 5 } = options;
+    try {
+        const chatLLM = createChatLLMProvider(chatProvider);
+        if (chatLLM.init) {
+            await chatLLM.init();
+        }
+        // Search for relevant code chunks for current query
+        const searchScope = {
+            ...scope,
+            reranker: useReranking ? 'api' : 'off',
+            hybrid: true,
+            bm25: true,
+            symbol_boost: true
+        };
+        const searchResult = await searchCode(query, maxChunks, provider, workingPath, searchScope);
+        if (!searchResult.success || searchResult.results.length === 0) {
+            return {
+                success: false,
+                error: 'no_results',
+                query,
+                chunksAnalyzed: 0,
+                chatProvider: chatLLM.getName(),
+                embeddingProvider: provider
+            };
+        }
+        // Retrieve code for new chunks
+        const newChunks = searchResult.results.slice(0, maxChunks);
+        for (const result of newChunks) {
+            if (!conversationContext.allChunks.has(result.sha)) {
+                const chunkResult = await getChunk(result.sha, workingPath);
+                if (chunkResult.success && chunkResult.code) {
+                    conversationContext.allChunks.set(result.sha, {
+                        result,
+                        code: chunkResult.code
+                    });
+                    // Enforce LRU cap on cached chunks
+                    evictOldChunksIfNeeded(conversationContext);
+                }
+            }
+        }
+        // Build conversational prompt
+        const messages = buildConversationalMessages(query, conversationContext, newChunks, maxHistoryTurns);
+        // Expose selected chunks to caller for tracking
+        if (options.onChunksSelected) {
+            options.onChunksSelected(newChunks);
+        }
+        // Generate answer (non-streaming)
+        const answer = await chatLLM.generateCompletion(messages, {
+            temperature,
+            maxTokens: parseInt(process.env.CODEVAULT_CHAT_MAX_TOKENS || '4096', 10)
+        });
+        return {
+            success: true,
+            answer,
+            query,
+            chunksAnalyzed: newChunks.length,
+            chatProvider: chatLLM.getName(),
+            embeddingProvider: provider,
+            newChunks
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message,
+            query,
+            chunksAnalyzed: 0,
+            chatProvider: chatProvider,
+            embeddingProvider: provider
+        };
+    }
+}
+/**
+ * Streaming version for real-time responses
+ */
+export async function* synthesizeConversationalAnswerStreaming(query, conversationContext, options = {}) {
+    const { provider = 'auto', chatProvider = 'auto', workingPath = '.', scope = {}, maxChunks = 10, useReranking = true, temperature = 0.7, maxHistoryTurns = 5 } = options;
+    const chatLLM = createChatLLMProvider(chatProvider);
+    if (chatLLM.init) {
+        await chatLLM.init();
+    }
+    // Search for relevant code chunks
+    const searchScope = {
+        ...scope,
+        reranker: useReranking ? 'api' : 'off',
+        hybrid: true,
+        bm25: true,
+        symbol_boost: true
+    };
+    const searchResult = await searchCode(query, maxChunks, provider, workingPath, searchScope);
+    if (!searchResult.success || searchResult.results.length === 0) {
+        yield `**No relevant code found for:** "${query}"\n\n`;
+        yield `Please try rephrasing your question or ensure the project is indexed.`;
+        return;
+    }
+    // Retrieve code for new chunks
+    const newChunks = searchResult.results.slice(0, maxChunks);
+    for (const result of newChunks) {
+        if (!conversationContext.allChunks.has(result.sha)) {
+            const chunkResult = await getChunk(result.sha, workingPath);
+            if (chunkResult.success && chunkResult.code) {
+                conversationContext.allChunks.set(result.sha, {
+                    result,
+                    code: chunkResult.code
+                });
+                // Enforce LRU cap on cached chunks
+                evictOldChunksIfNeeded(conversationContext);
+            }
+        }
+    }
+    // Build messages with conversation history
+    const messages = buildConversationalMessages(query, conversationContext, newChunks, maxHistoryTurns);
+    // Expose selected chunks to caller for tracking
+    if (options.onChunksSelected) {
+        options.onChunksSelected(newChunks);
+    }
+    // Stream the response
+    for await (const chunk of chatLLM.generateStreamingCompletion(messages, { temperature })) {
+        yield chunk;
+    }
+}
+/**
+ * Build messages array with conversation history
+ */
+function buildConversationalMessages(currentQuery, context, newChunks, maxHistoryTurns) {
+    const messages = [];
+    // System prompt for conversational mode
+    messages.push({
+        role: 'system',
+        content: buildConversationalSystemPrompt()
+    });
+    // Add conversation history (last N turns)
+    const recentTurns = context.turns.slice(-maxHistoryTurns);
+    for (const turn of recentTurns) {
+        messages.push({
+            role: 'user',
+            content: turn.question
+        });
+        messages.push({
+            role: 'assistant',
+            content: turn.answer
+        });
+    }
+    // Add current query with code context
+    const userPrompt = buildConversationalUserPrompt(currentQuery, context, newChunks);
+    messages.push({
+        role: 'user',
+        content: userPrompt
+    });
+    return messages;
+}
+/**
+ * Build system prompt for conversational mode
+ */
+function buildConversationalSystemPrompt() {
+    return `You are an expert code analyst helping a developer understand their codebase through an interactive conversation.
+
+Your role is to:
+1. Answer questions clearly and concisely based on the provided code context
+2. Maintain continuity with the conversation history
+3. Reference previous discussions when relevant
+4. Use proper markdown formatting with code citations
+5. Cite specific files using the format: \`[filename.ext](filename.ext:line)\`
+6. Be conversational but professional
+7. If the question builds on previous context, acknowledge that connection
+
+Format guidelines:
+- Use clear headings and sections
+- Include code blocks with language tags
+- Use bullet points for clarity
+- Bold/italic for emphasis
+- Keep responses focused and relevant to the current question
+
+Remember: You're having an ongoing conversation, not answering isolated questions.`;
+}
+/**
+ * Build user prompt with conversation-aware context
+ */
+function buildConversationalUserPrompt(currentQuery, context, newChunks) {
+    let prompt = `# Current Question\n\n${currentQuery}\n\n`;
+    // Show relevant code chunks for current question
+    if (newChunks.length > 0) {
+        prompt += `# Relevant Code (for current question)\n\n`;
+        prompt += `I found ${newChunks.length} code chunks relevant to your current question:\n\n`;
+        newChunks.forEach((result, index) => {
+            const chunkData = context.allChunks.get(result.sha);
+            const relevanceScore = (result.meta.score * 100).toFixed(1);
+            prompt += `## Chunk ${index + 1}: ${result.meta.symbol} (${relevanceScore}% relevant)\n\n`;
+            prompt += `**File:** \`${result.path}\`\n`;
+            prompt += `**Language:** ${result.lang}\n`;
+            prompt += `**Symbol:** ${result.meta.symbol}\n`;
+            if (result.meta.description) {
+                prompt += `**Description:** ${result.meta.description}\n`;
+            }
+            if (chunkData && chunkData.code) {
+                const limit = PROMPT_TRUNCATE_LENGTH;
+                const truncatedCode = chunkData.code.length > limit
+                    ? chunkData.code.substring(0, limit) + '\n... [truncated]'
+                    : chunkData.code;
+                prompt += `\n**Code:**\n\n\`\`\`${result.lang}\n${truncatedCode}\n\`\`\`\n\n`;
+            }
+            prompt += `---\n\n`;
+        });
+    }
+    // Add reference to previously discussed code if relevant
+    if (context.turns.length > 0) {
+        const previousChunks = new Set();
+        context.turns.forEach(turn => {
+            turn.chunks.forEach(chunk => previousChunks.add(chunk.sha));
+        });
+        const previouslySeenChunks = Array.from(previousChunks)
+            .filter(sha => !newChunks.some(c => c.sha === sha))
+            .slice(0, 5);
+        if (previouslySeenChunks.length > 0) {
+            prompt += `# Previously Discussed Code (available for reference)\n\n`;
+            previouslySeenChunks.forEach(sha => {
+                const chunkData = context.allChunks.get(sha);
+                if (chunkData) {
+                    prompt += `- \`${chunkData.result.path}\` - ${chunkData.result.meta.symbol}\n`;
+                }
+            });
+            prompt += `\n`;
+        }
+    }
+    // Instructions for response
+    prompt += `# Instructions\n\n`;
+    prompt += `Based on our conversation and the code provided, please answer: "${currentQuery}"\n\n`;
+    prompt += `Your response should:\n`;
+    prompt += `1. Build on our previous conversation if relevant\n`;
+    prompt += `2. Directly answer the current question\n`;
+    prompt += `3. Use inline citations like: \`[filename.ext](filename.ext)\`\n`;
+    prompt += `4. Include relevant code snippets\n`;
+    prompt += `5. Use proper markdown formatting\n`;
+    prompt += `6. Be concise but thorough\n`;
+    return prompt;
+}
+/**
+ * Create a new conversation context
+ */
+export function createConversationContext() {
+    return {
+        turns: [],
+        allChunks: new Map()
+    };
+}
+/**
+ * Add a turn to the conversation history
+ */
+export function addConversationTurn(context, turn) {
+    context.turns.push(turn);
+}
+/**
+ * Clear conversation history
+ */
+export function clearConversationHistory(context) {
+    context.turns = [];
+    context.allChunks.clear();
+}
+function evictOldChunksIfNeeded(context) {
+    const max = CONVERSATION_MAX_CONTEXT_CHUNKS || 200;
+    if (context.allChunks.size <= max)
+        return;
+    const excess = context.allChunks.size - max;
+    // Remove first N inserted entries (Map preserves insertion order)
+    const keys = Array.from(context.allChunks.keys());
+    for (let i = 0; i < excess; i++) {
+        context.allChunks.delete(keys[i]);
+    }
+}
+/**
+ * Get conversation summary for display
+ */
+export function getConversationSummary(context) {
+    const turnCount = context.turns.length;
+    const uniqueChunks = context.allChunks.size;
+    const uniqueFiles = new Set(Array.from(context.allChunks.values()).map(chunk => chunk.result.path)).size;
+    return `Conversation: ${turnCount} turn${turnCount !== 1 ? 's' : ''} | ${uniqueChunks} code chunks | ${uniqueFiles} file${uniqueFiles !== 1 ? 's' : ''}`;
+}
+//# sourceMappingURL=conversational-synthesizer.js.map

package/dist/synthesis/conversational-synthesizer.js.map

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

package/dist/synthesis/markdown-formatter.d.ts

@@ -0,0 +1,13 @@
+import type { SynthesisResult } from './synthesizer.js';
+export interface FormattingOptions {
+    includeMetadata?: boolean;
+    includeStats?: boolean;
+    colorize?: boolean;
+}
+export declare function formatSynthesisResult(result: SynthesisResult, options?: FormattingOptions): string;
+export declare function formatStreamingChunk(chunk: string): string;
+export declare function extractCitations(markdown: string): string[];
+export declare function addCitationFooter(markdown: string): string;
+export declare function formatErrorMessage(error: string, query: string): string;
+export declare function formatNoResultsMessage(query: string, queriesUsed?: string[]): string;
+//# sourceMappingURL=markdown-formatter.d.ts.map

package/dist/synthesis/markdown-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-formatter.d.ts","sourceRoot":"","sources":["../../src/synthesis/markdown-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAqDtG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAgB3D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqB1D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAYvE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAmBpF"}

package/dist/synthesis/markdown-formatter.js

@@ -0,0 +1,104 @@
+export function formatSynthesisResult(result, options = {}) {
+    const { includeMetadata = true, includeStats = true, colorize = false } = options;
+    let output = '';
+    // Add metadata header if requested
+    if (includeMetadata && result.metadata) {
+        output += '---\n';
+        output += '**Search Metadata**\n\n';
+        if (result.queriesUsed && result.queriesUsed.length > 1) {
+            output += `- **Queries Used:** ${result.queriesUsed.length}\n`;
+            result.queriesUsed.forEach((q, i) => {
+                output += `  ${i + 1}. "${q}"\n`;
+            });
+        }
+        if (result.metadata.multiQuery) {
+            output += `- **Multi-Query:** Yes\n`;
+        }
+        if (result.metadata.searchType) {
+            output += `- **Search Type:** ${result.metadata.searchType}\n`;
+        }
+        output += `- **Chunks Analyzed:** ${result.chunksAnalyzed}\n`;
+        output += `- **Embedding Provider:** ${result.embeddingProvider}\n`;
+        output += `- **Chat Provider:** ${result.chatProvider}\n`;
+        output += '\n---\n\n';
+    }
+    // Add main answer
+    if (result.success && result.answer) {
+        output += result.answer;
+        if (!result.answer.endsWith('\n')) {
+            output += '\n';
+        }
+    }
+    else if (!result.success) {
+        output += `**Error:** ${result.error || 'Unknown error occurred'}\n`;
+    }
+    // Add stats footer if requested
+    if (includeStats && result.success) {
+        output += '\n\n---\n\n';
+        output += '_Generated using CodeVault semantic search + LLM synthesis_\n';
+    }
+    return output;
+}
+export function formatStreamingChunk(chunk) {
+    // Pass through streaming chunks as-is
+    return chunk;
+}
+export function extractCitations(markdown) {
+    const citations = [];
+    // Match markdown links: [text](path) or `[text](path)`
+    const linkPattern = /\[([^\]]+)\]\(([^)]+)\)/g;
+    let match;
+    while ((match = linkPattern.exec(markdown)) !== null) {
+        const path = match[2];
+        // Filter out external URLs, only keep file paths
+        if (!path.startsWith('http://') && !path.startsWith('https://')) {
+            citations.push(path);
+        }
+    }
+    return Array.from(new Set(citations));
+}
+export function addCitationFooter(markdown) {
+    const citations = extractCitations(markdown);
+    if (citations.length === 0) {
+        return markdown;
+    }
+    let output = markdown;
+    if (!output.endsWith('\n\n')) {
+        output += '\n\n';
+    }
+    output += '## 📚 References\n\n';
+    output += 'The following files were referenced in this answer:\n\n';
+    citations.forEach((citation, index) => {
+        output += `${index + 1}. \`${citation}\`\n`;
+    });
+    return output;
+}
+export function formatErrorMessage(error, query) {
+    let output = `# ❌ Unable to Answer\n\n`;
+    output += `**Question:** "${query}"\n\n`;
+    output += `**Error:** ${error}\n\n`;
+    output += `## Possible Solutions:\n\n`;
+    output += `1. Ensure the project is indexed: \`codevault index\`\n`;
+    output += `2. Check if the question is related to the codebase\n`;
+    output += `3. Try rephrasing your question with more specific terms\n`;
+    output += `4. Verify embedding and chat API configurations\n`;
+    return output;
+}
+export function formatNoResultsMessage(query, queriesUsed) {
+    let output = `# ℹ️ No Relevant Code Found\n\n`;
+    output += `**Question:** "${query}"\n\n`;
+    if (queriesUsed && queriesUsed.length > 1) {
+        output += `**Queries Attempted:**\n`;
+        queriesUsed.forEach((q, i) => {
+            output += `${i + 1}. "${q}"\n`;
+        });
+        output += '\n';
+    }
+    output += `## Suggestions:\n\n`;
+    output += `1. Try using more specific technical terms\n`;
+    output += `2. Check if the relevant code is in the indexed project\n`;
+    output += `3. Use simpler, more direct questions\n`;
+    output += `4. Try searching for function names or class names directly\n`;
+    return output;
+}
+//# sourceMappingURL=markdown-formatter.js.map

package/dist/synthesis/markdown-formatter.js.map

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

package/dist/synthesis/prompt-builder.d.ts

@@ -0,0 +1,21 @@
+import type { SearchResult } from '../core/types.js';
+export interface CodeContext {
+    results: SearchResult[];
+    codeChunks: Map<string, string>;
+    query: string;
+    metadata?: {
+        searchType?: string;
+        provider?: string;
+        totalChunks?: number;
+    };
+}
+export interface PromptOptions {
+    maxContextChunks?: number;
+    includeFileStructure?: boolean;
+    citationStyle?: 'inline' | 'footnote';
+}
+export declare function buildSystemPrompt(): string;
+export declare function buildUserPrompt(context: CodeContext, options?: PromptOptions): string;
+export declare function buildMultiQueryPrompt(query: string): string;
+export declare function parseMultiQueryResponse(response: string): string[];
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/synthesis/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../src/synthesis/prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE;QACT,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACvC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAkB1C;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAyFzF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAc3D;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBlE"}

package/dist/synthesis/prompt-builder.js

@@ -0,0 +1,129 @@
+export function buildSystemPrompt() {
+    return `You are an expert code analyst helping developers understand their codebase. Your role is to:
+
+1. Analyze the provided code chunks and their metadata
+2. Answer the user's question clearly and concisely
+3. Use proper markdown formatting
+4. Include citations to specific files and code snippets
+5. Provide practical, actionable insights
+6. Highlight important patterns, dependencies, and relationships
+
+Format your response in markdown with:
+- Clear headings and sections
+- Code blocks with language tags
+- File path citations like: \`[filename.ext](filename.ext:line)\`
+- Bullet points for clarity
+- Bold/italic for emphasis
+
+Keep responses focused and relevant to the question asked.`;
+}
+export function buildUserPrompt(context, options = {}) {
+    const { query, results, codeChunks, metadata } = context;
+    const maxChunks = options.maxContextChunks || 10;
+    const citationStyle = options.citationStyle || 'inline';
+    let prompt = `# Question\n\n${query}\n\n`;
+    // Add search metadata
+    if (metadata) {
+        prompt += `# Search Context\n\n`;
+        if (metadata.searchType) {
+            prompt += `- Search Type: ${metadata.searchType}\n`;
+        }
+        if (metadata.provider) {
+            prompt += `- Embedding Provider: ${metadata.provider}\n`;
+        }
+        if (metadata.totalChunks) {
+            prompt += `- Total Indexed Chunks: ${metadata.totalChunks}\n`;
+        }
+        prompt += `- Relevant Results: ${results.length}\n\n`;
+    }
+    // Add relevant code chunks
+    prompt += `# Relevant Code Chunks\n\n`;
+    prompt += `I found ${Math.min(results.length, maxChunks)} relevant code chunks. Here they are in order of relevance:\n\n`;
+    const chunksToInclude = results.slice(0, maxChunks);
+    chunksToInclude.forEach((result, index) => {
+        const chunkCode = codeChunks.get(result.sha);
+        const relevanceScore = (result.meta.score * 100).toFixed(1);
+        prompt += `## Chunk ${index + 1}: ${result.meta.symbol} (${relevanceScore}% relevant)\n\n`;
+        prompt += `**File:** \`${result.path}\`\n`;
+        prompt += `**Language:** ${result.lang}\n`;
+        prompt += `**Symbol:** ${result.meta.symbol}\n`;
+        if (result.meta.description) {
+            prompt += `**Description:** ${result.meta.description}\n`;
+        }
+        if (result.meta.intent) {
+            prompt += `**Intent:** ${result.meta.intent}\n`;
+        }
+        // Add search metadata if available
+        if (result.meta.searchType) {
+            prompt += `**Search Type:** ${result.meta.searchType}\n`;
+        }
+        if (result.meta.symbolBoost && result.meta.symbolBoost > 0) {
+            prompt += `**Symbol Match:** Yes (boosted by ${(result.meta.symbolBoost * 100).toFixed(0)}%)\n`;
+        }
+        if (result.meta.rerankerScore !== undefined) {
+            prompt += `**Reranker Score:** ${(result.meta.rerankerScore * 100).toFixed(1)}%\n`;
+        }
+        prompt += `\n**Code:**\n\n`;
+        if (chunkCode) {
+            const truncatedCode = chunkCode.length > 2000
+                ? chunkCode.substring(0, 2000) + '\n... [truncated]'
+                : chunkCode;
+            prompt += `\`\`\`${result.lang}\n${truncatedCode}\n\`\`\`\n\n`;
+        }
+        else {
+            prompt += `_[Code not available]_\n\n`;
+        }
+        prompt += `---\n\n`;
+    });
+    // Add instructions for response format
+    prompt += `# Instructions\n\n`;
+    prompt += `Based on the code chunks above, please answer the question: "${query}"\n\n`;
+    prompt += `Your response should:\n`;
+    prompt += `1. Directly answer the question in clear, natural language\n`;
+    prompt += `2. Reference specific code chunks using inline citations like: \`[filename.ext](filename.ext)\`\n`;
+    prompt += `3. Include relevant code snippets in your explanation\n`;
+    prompt += `4. Highlight key patterns, dependencies, or architectural decisions\n`;
+    prompt += `5. Use proper markdown formatting with headers, lists, and code blocks\n`;
+    prompt += `6. Be concise but thorough - focus on what's most relevant\n\n`;
+    if (citationStyle === 'footnote') {
+        prompt += `7. Add a "References" section at the end with all cited files\n\n`;
+    }
+    return prompt;
+}
+export function buildMultiQueryPrompt(query) {
+    return `You are a query analyzer for code search. Given a complex question about a codebase, break it down into 2-4 specific search queries that would help find relevant code.
+
+Question: "${query}"
+
+Return ONLY a JSON array of search query strings, nothing else. Each query should be:
+- Specific and focused on one aspect
+- Use technical terms that would appear in code
+- Be suitable for semantic search
+
+Example format:
+["authentication middleware", "user login function", "session management"]
+
+Your response (JSON array only):`;
+}
+export function parseMultiQueryResponse(response) {
+    try {
+        // Extract JSON array from response
+        const jsonMatch = response.match(/\[[\s\S]*\]/);
+        if (!jsonMatch) {
+            return [];
+        }
+        const queries = JSON.parse(jsonMatch[0]);
+        if (!Array.isArray(queries)) {
+            return [];
+        }
+        return queries
+            .filter(q => typeof q === 'string' && q.trim().length > 0)
+            .map(q => q.trim())
+            .slice(0, 4); // Max 4 queries
+    }
+    catch (error) {
+        console.error('Failed to parse multi-query response:', error);
+        return [];
+    }
+}
+//# sourceMappingURL=prompt-builder.js.map