codevault 1.5.0 → 1.6.1

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/utils/indexer-with-progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexer-with-progress.d.ts","sourceRoot":"","sources":["../../src/utils/indexer-with-progress.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEhF,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5E,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,mBAAmB,GAAG;IAAE,SAAS,CAAC,EAAE,0BAA0B,CAAA;CAAE,GACxE,OAAO,CAAC,kBAAkB,CAAC,CAwD7B"}
+{"version":3,"file":"indexer-with-progress.d.ts","sourceRoot":"","sources":["../../src/utils/indexer-with-progress.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEhF,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5E,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,mBAAmB,GAAG;IAAE,SAAS,CAAC,EAAE,0BAA0B,CAAA;CAAE,GACxE,OAAO,CAAC,kBAAkB,CAAC,CAwC7B"}

package/dist/utils/indexer-with-progress.js

@@ -2,6 +2,7 @@ import fg from 'fast-glob';
 import path from 'path';
 import { indexProject } from '../core/indexer.js';
 import { getSupportedLanguageExtensions } from '../languages/rules.js';
+import { DEFAULT_SCAN_IGNORES } from './scan-patterns.js';
 export async function indexProjectWithProgress(options) {
     const { callbacks, ...indexOptions } = options;
     const repo = path.resolve(options.repoPath || '.');
@@ -11,31 +12,7 @@ export async function indexProjectWithProgress(options) {
         cwd: repo,
         absolute: false,
         followSymbolicLinks: false,
-        ignore: [
-            '**/vendor/**',
-            '**/node_modules/**',
-            '**/.git/**',
-            '**/storage/**',
-            '**/dist/**',
-            '**/build/**',
-            '**/tmp/**',
-            '**/temp/**',
-            '**/.npm/**',
-            '**/.yarn/**',
-            '**/Library/**',
-            '**/System/**',
-            '**/.Trash/**',
-            '**/.codevault/**',
-            '**/codevault.codemap.json',
-            '**/codevault.codemap.json.backup-*',
-            '**/package-lock.json',
-            '**/yarn.lock',
-            '**/pnpm-lock.yaml',
-            '**/*.json',
-            '**/*.sh',
-            '**/examples/**',
-            '**/assets/**'
-        ],
+        ignore: DEFAULT_SCAN_IGNORES,
         onlyFiles: true,
         dot: false
     });
@@ -44,12 +21,20 @@ export async function indexProjectWithProgress(options) {
     }
     // Phase 2: Index with progress tracking
     let processedCount = 0;
+    const processedFiles = new Set();
     const result = await indexProject({
         ...indexOptions,
         onProgress: (event) => {
             if (event.type === 'chunk_processed' && event.file && callbacks?.onFileProgress) {
-                processedCount++;
-                callbacks.onFileProgress(processedCount, files.length, event.file);
+                // Only count each file once (not per chunk)
+                if (!processedFiles.has(event.file)) {
+                    processedFiles.add(event.file);
+                    processedCount++;
+                    callbacks.onFileProgress(processedCount, files.length, event.file);
+                }
+            }
+            if (event.type === 'finalizing' && callbacks?.onFinalizing) {
+                callbacks.onFinalizing();
             }
         }
     });

package/dist/utils/indexer-with-progress.js.map

@@ -1 +1 @@
-{"version":3,"file":"indexer-with-progress.js","sourceRoot":"","sources":["../../src/utils/indexer-with-progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AASvE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAyE;IAEzE,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;IAEnD,6BAA6B;IAC7B,MAAM,gBAAgB,GAAG,8BAA8B,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,gBAAgB,EAAE;QACvC,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,KAAK;QACf,mBAAmB,EAAE,KAAK;QAC1B,MAAM,EAAE;YACN,cAAc;YACd,oBAAoB;YACpB,YAAY;YACZ,eAAe;YACf,YAAY;YACZ,aAAa;YACb,WAAW;YACX,YAAY;YACZ,YAAY;YACZ,aAAa;YACb,eAAe;YACf,cAAc;YACd,cAAc;YACd,kBAAkB;YAClB,2BAA2B;YAC3B,oCAAoC;YACpC,sBAAsB;YACtB,cAAc;YACd,mBAAmB;YACnB,WAAW;YACX,SAAS;YACT,gBAAgB;YAChB,cAAc;SACf;QACD,SAAS,EAAE,IAAI;QACf,GAAG,EAAE,KAAK;KACX,CAAC,CAAC;IAEH,IAAI,SAAS,EAAE,cAAc,EAAE,CAAC;QAC9B,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,wCAAwC;IACxC,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;QAChC,GAAG,YAAY;QACf,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;YACpB,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,IAAI,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE,cAAc,EAAE,CAAC;gBAChF,cAAc,EAAE,CAAC;gBACjB,SAAS,CAAC,cAAc,CAAC,cAAc,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"indexer-with-progress.js","sourceRoot":"","sources":["../../src/utils/indexer-with-progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAS1D,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAyE;IAEzE,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;IAEnD,6BAA6B;IAC7B,MAAM,gBAAgB,GAAG,8BAA8B,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,gBAAgB,EAAE;QACvC,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,KAAK;QACf,mBAAmB,EAAE,KAAK;QAC1B,MAAM,EAAE,oBAAoB;QAC5B,SAAS,EAAE,IAAI;QACf,GAAG,EAAE,KAAK;KACX,CAAC,CAAC;IAEH,IAAI,SAAS,EAAE,cAAc,EAAE,CAAC;QAC9B,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,wCAAwC;IACxC,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;QAChC,GAAG,YAAY;QACf,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;YACpB,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,IAAI,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE,cAAc,EAAE,CAAC;gBAChF,4CAA4C;gBAC5C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC/B,cAAc,EAAE,CAAC;oBACjB,SAAS,CAAC,cAAc,CAAC,cAAc,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,SAAS,EAAE,YAAY,EAAE,CAAC;gBAC3D,SAAS,CAAC,YAAY,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Structured logging utility for CodeVault
+ *
+ * Provides consistent logging with levels, structured metadata, and
+ * environment-based configuration.
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    SILENT = 4
+}
+interface LogMetadata {
+    [key: string]: any;
+}
+declare class Logger {
+    private level;
+    private quiet;
+    constructor();
+    private parseLogLevel;
+    private shouldLog;
+    private formatMessage;
+    debug(message: string, meta?: LogMetadata): void;
+    info(message: string, meta?: LogMetadata): void;
+    warn(message: string, meta?: LogMetadata): void;
+    error(message: string, error?: Error | any, meta?: LogMetadata): void;
+    /**
+     * Check if quiet mode is enabled
+     */
+    isQuiet(): boolean;
+    /**
+     * Set quiet mode (suppresses INFO and DEBUG)
+     */
+    setQuiet(quiet: boolean): void;
+    /**
+     * Set log level
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Get current log level
+     */
+    getLevel(): LogLevel;
+}
+export declare const logger: Logger;
+export declare const log: {
+    debug: (message: string, meta?: LogMetadata) => void;
+    info: (message: string, meta?: LogMetadata) => void;
+    warn: (message: string, meta?: LogMetadata) => void;
+    error: (message: string, error?: Error | any, meta?: LogMetadata) => void;
+    isQuiet: () => boolean;
+    setQuiet: (quiet: boolean) => void;
+};
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,MAAM,IAAI;CACX;AAED,UAAU,WAAW;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,KAAK,CAAU;;IAOvB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,aAAa;IAYrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI;IAKhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI;IAK/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI;IAK/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI;IAiBrE;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAO9B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B;;OAEG;IACH,QAAQ,IAAI,QAAQ;CAGrB;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC;AAGnC,eAAO,MAAM,GAAG;qBACG,MAAM,SAAS,WAAW;oBAC3B,MAAM,SAAS,WAAW;oBAC1B,MAAM,SAAS,WAAW;qBACzB,MAAM,UAAU,KAAK,GAAG,GAAG,SAAS,WAAW;;sBAG9C,OAAO;CAC1B,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,121 @@
+/**
+ * Structured logging utility for CodeVault
+ *
+ * Provides consistent logging with levels, structured metadata, and
+ * environment-based configuration.
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["SILENT"] = 4] = "SILENT";
+})(LogLevel || (LogLevel = {}));
+class Logger {
+    level;
+    quiet;
+    constructor() {
+        this.quiet = process.env.CODEVAULT_QUIET === 'true';
+        this.level = this.parseLogLevel(process.env.CODEVAULT_LOG_LEVEL);
+    }
+    parseLogLevel(level) {
+        if (!level)
+            return this.quiet ? LogLevel.ERROR : LogLevel.INFO;
+        switch (level.toLowerCase()) {
+            case 'debug':
+                return LogLevel.DEBUG;
+            case 'info':
+                return LogLevel.INFO;
+            case 'warn':
+                return LogLevel.WARN;
+            case 'error':
+                return LogLevel.ERROR;
+            case 'silent':
+                return LogLevel.SILENT;
+            default:
+                return LogLevel.INFO;
+        }
+    }
+    shouldLog(level) {
+        return level >= this.level;
+    }
+    formatMessage(level, message, meta) {
+        const timestamp = new Date().toISOString();
+        const prefix = `[${timestamp}] [${level}]`;
+        if (meta && Object.keys(meta).length > 0) {
+            const metaStr = JSON.stringify(meta);
+            return `${prefix} ${message} ${metaStr}`;
+        }
+        return `${prefix} ${message}`;
+    }
+    debug(message, meta) {
+        if (!this.shouldLog(LogLevel.DEBUG))
+            return;
+        console.log(this.formatMessage('DEBUG', message, meta));
+    }
+    info(message, meta) {
+        if (!this.shouldLog(LogLevel.INFO))
+            return;
+        console.log(this.formatMessage('INFO', message, meta));
+    }
+    warn(message, meta) {
+        if (!this.shouldLog(LogLevel.WARN))
+            return;
+        console.warn(this.formatMessage('WARN', message, meta));
+    }
+    error(message, error, meta) {
+        if (!this.shouldLog(LogLevel.ERROR))
+            return;
+        const errorMeta = {
+            ...meta,
+            ...(error instanceof Error
+                ? {
+                    errorMessage: error.message,
+                    errorStack: error.stack,
+                    errorName: error.name,
+                }
+                : { error: String(error) }),
+        };
+        console.error(this.formatMessage('ERROR', message, errorMeta));
+    }
+    /**
+     * Check if quiet mode is enabled
+     */
+    isQuiet() {
+        return this.quiet;
+    }
+    /**
+     * Set quiet mode (suppresses INFO and DEBUG)
+     */
+    setQuiet(quiet) {
+        this.quiet = quiet;
+        if (quiet && this.level < LogLevel.WARN) {
+            this.level = LogLevel.WARN;
+        }
+    }
+    /**
+     * Set log level
+     */
+    setLevel(level) {
+        this.level = level;
+    }
+    /**
+     * Get current log level
+     */
+    getLevel() {
+        return this.level;
+    }
+}
+// Export singleton instance
+export const logger = new Logger();
+// Export convenience functions
+export const log = {
+    debug: (message, meta) => logger.debug(message, meta),
+    info: (message, meta) => logger.info(message, meta),
+    warn: (message, meta) => logger.warn(message, meta),
+    error: (message, error, meta) => logger.error(message, error, meta),
+    isQuiet: () => logger.isQuiet(),
+    setQuiet: (quiet) => logger.setQuiet(quiet),
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/mutex.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Mutex implementation for coordinating async operations
+ *
+ * Provides a proper mutex/lock mechanism to replace polling-based
+ * concurrency control patterns.
+ */
+export declare class Mutex {
+    private locked;
+    private queue;
+    /**
+     * Check if the mutex is currently locked
+     */
+    isLocked(): boolean;
+    /**
+     * Acquire the mutex lock
+     * Waits if already locked
+     */
+    acquire(): Promise<void>;
+    /**
+     * Release the mutex lock
+     * Allows next queued operation to proceed
+     */
+    release(): void;
+    /**
+     * Run a function with automatic acquire/release
+     * Ensures lock is always released even if function throws
+     */
+    runExclusive<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Get queue length (for debugging)
+     */
+    getQueueLength(): number;
+}
+/**
+ * Async semaphore for limiting concurrent operations
+ */
+export declare class Semaphore {
+    private permits;
+    private maxPermits;
+    private queue;
+    constructor(permits: number);
+    /**
+     * Acquire a permit
+     */
+    acquire(): Promise<void>;
+    /**
+     * Release a permit
+     */
+    release(): void;
+    /**
+     * Run function with automatic acquire/release
+     */
+    runExclusive<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Get available permits
+     */
+    getAvailablePermits(): number;
+    /**
+     * Get queue length
+     */
+    getQueueLength(): number;
+}
+//# sourceMappingURL=mutex.d.ts.map

package/dist/utils/mutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.d.ts","sourceRoot":"","sources":["../../src/utils/mutex.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAyB;IAEtC;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B;;;OAGG;IACH,OAAO,IAAI,IAAI;IASf;;;OAGG;IACG,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASvD;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAyB;gBAE1B,OAAO,EAAE,MAAM;IAK3B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACG,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASvD;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB"}