codevault 1.6.0 → 1.7.0

package/dist/config/constants.d.ts

@@ -0,0 +1,326 @@
+/**
+ * Centralized configuration constants for CodeVault
+ *
+ * This file contains all magic numbers and configuration values used throughout
+ * the codebase. Centralizing these values makes the system easier to tune and
+ * understand.
+ */
+/**
+ * Parsing and Tree-sitter Configuration
+ */
+export declare const PARSING_CONSTANTS: {
+    /**
+     * Threshold in bytes to switch to streaming parser
+     * Large files above this size are parsed in chunks to avoid memory issues
+     */
+    readonly SIZE_THRESHOLD: 30000;
+    /**
+     * Chunk size for streaming parser in bytes
+     * Parser will read this many bytes at a time when streaming
+     */
+    readonly CHUNK_SIZE: 30000;
+};
+/**
+ * Cache Configuration
+ */
+export declare const CACHE_CONSTANTS: {
+    /** Maximum number of BM25 indexes to cache (LRU eviction) */
+    readonly MAX_BM25_CACHE_SIZE: number;
+    /** Maximum number of code chunks to cache in memory */
+    readonly MAX_CHUNK_TEXT_CACHE_SIZE: number;
+    /** Interval for periodic cache cleanup in MCP server (milliseconds) */
+    readonly CACHE_CLEAR_INTERVAL_MS: number;
+};
+/**
+ * Search Configuration
+ */
+export declare const SEARCH_CONSTANTS: {
+    /** Maximum candidates to send to reranking API */
+    readonly RERANKER_MAX_CANDIDATES: number;
+    /** Maximum code chunk size to return in bytes (prevents OOM) */
+    readonly MAX_CHUNK_SIZE: 100000;
+    /** Default result limit for search queries */
+    readonly DEFAULT_SEARCH_LIMIT: 10;
+    /** Maximum search results limit */
+    readonly MAX_SEARCH_LIMIT: 200;
+    /** Selection budget multiplier for hybrid search */
+    readonly SELECTION_BUDGET_MULTIPLIER: 60;
+    /** Reciprocal rank fusion constant */
+    readonly RRF_K_CONSTANT: 60;
+};
+/**
+ * Symbol Boosting Configuration
+ */
+export declare const SYMBOL_BOOST_CONSTANTS: {
+    /** Boost applied when query matches function signature */
+    readonly SIGNATURE_MATCH_BOOST: 0.3;
+    /** Boost applied when query matches neighbor functions */
+    readonly NEIGHBOR_MATCH_BOOST: 0.15;
+    /** Maximum total boost from symbol matching */
+    readonly MAX_SYMBOL_BOOST: 0.45;
+    /** Minimum token length for symbol matching */
+    readonly MIN_TOKEN_LENGTH: 3;
+    /** Maximum parameters to extract from signature */
+    readonly MAX_PARAMETERS: 12;
+};
+/**
+ * File Watcher Configuration
+ */
+export declare const WATCHER_CONSTANTS: {
+    /** Default debounce interval in milliseconds */
+    readonly DEFAULT_DEBOUNCE_MS: 500;
+    /** Minimum debounce interval in milliseconds */
+    readonly MIN_DEBOUNCE_MS: 50;
+    /** Settle delay for watcher shutdown */
+    readonly SETTLE_DELAY_MS: 200;
+    /** Stability threshold for file write detection */
+    readonly STABILITY_THRESHOLD_MS: 100;
+    /** Poll interval for file stability check */
+    readonly POLL_INTERVAL_MS: 50;
+};
+/**
+ * Rate Limiting Configuration
+ */
+export declare const RATE_LIMIT_CONSTANTS: {
+    /** Retry delays for rate limit errors (milliseconds) */
+    readonly RETRY_DELAYS: readonly [1000, 2000, 5000, 10000];
+    /** Maximum queue size to prevent unbounded growth */
+    readonly DEFAULT_MAX_QUEUE_SIZE: 10000;
+    /** Delay buffer added to rate limit calculations */
+    readonly DELAY_BUFFER_MS: 100;
+};
+/**
+ * Batch Processing Configuration
+ */
+export declare const BATCH_CONSTANTS: {
+    /** Maximum retries for failed batches */
+    readonly MAX_BATCH_RETRIES: 3;
+    /** Initial retry delay for batch failures */
+    readonly INITIAL_RETRY_DELAY_MS: 1000;
+    /** Maximum tokens per batch for OpenAI */
+    readonly MAX_BATCH_TOKENS: 100000;
+    /** Maximum tokens per individual item */
+    readonly MAX_ITEM_TOKENS: 8191;
+    /** Default batch size for embedding generation */
+    readonly DEFAULT_BATCH_SIZE: 50;
+};
+/**
+ * Encryption Configuration
+ */
+export declare const ENCRYPTION_CONSTANTS: {
+    /** Magic header for encrypted files */
+    readonly MAGIC_HEADER: "CVAULTE1";
+    /** Salt length in bytes for key derivation */
+    readonly SALT_LENGTH: 16;
+    /** Initialization vector length in bytes */
+    readonly IV_LENGTH: 12;
+    /** Authentication tag length in bytes */
+    readonly TAG_LENGTH: 16;
+    /** HKDF info string for key derivation */
+    readonly HKDF_INFO: "codevault-chunk-v1";
+    /** Required encryption key length in bytes */
+    readonly REQUIRED_KEY_LENGTH: 32;
+};
+/**
+ * LLM Configuration
+ */
+export declare const LLM_CONSTANTS: {
+    /** Default temperature for multi-query generation */
+    readonly MULTI_QUERY_TEMPERATURE: 0.3;
+    /** Default temperature for answer synthesis */
+    readonly DEFAULT_TEMPERATURE: 0.7;
+    /** Maximum tokens for multi-query response */
+    readonly MULTI_QUERY_MAX_TOKENS: 500;
+    /** Default maximum tokens for chat responses */
+    readonly DEFAULT_CHAT_MAX_TOKENS: 4096;
+    /** Maximum context chunks for answer synthesis */
+    readonly DEFAULT_MAX_CHUNKS: 10;
+};
+/**
+ * Chunking Configuration
+ */
+export declare const CHUNKING_CONSTANTS: {
+    /** Minimum token count for a valid chunk */
+    readonly MIN_CHUNK_TOKENS: 50;
+    /** Overlap percentage for line-based chunking */
+    readonly LINE_OVERLAP_PERCENTAGE: 0.2;
+    /** Maximum snippet length for signature extraction */
+    readonly MAX_SIGNATURE_SNIPPET: 400;
+    /** Maximum snippet length for call extraction */
+    readonly MAX_CALL_SNIPPET: 120;
+    /** Maximum snippet length for return type detection */
+    readonly MAX_RETURN_TYPE_SNIPPET: 80;
+};
+/**
+ * Conversational Chat Configuration
+ */
+export declare const CONVERSATION_CONSTANTS: {
+    /** Maximum distinct chunks retained in conversation cache */
+    readonly MAX_CONTEXT_CHUNKS: 200;
+    /** Characters to truncate prompts to */
+    readonly PROMPT_TRUNCATE_LENGTH: 2000;
+};
+/**
+ * Documentation boost configuration
+ */
+export declare const DOC_BOOST_CONSTANTS: {
+    /** Boost applied to README and documentation files */
+    readonly DOC_FILE_BOOST: 0.15;
+    /** Intent match boost */
+    readonly INTENT_MATCH_BOOST: 0.2;
+    /** Tag match boost per tag */
+    readonly TAG_MATCH_BOOST: 0.1;
+};
+/**
+ * Backward compatibility exports
+ * These maintain the old flat constant names for existing code
+ */
+export declare const SIZE_THRESHOLD: 30000;
+export declare const CHUNK_SIZE: 30000;
+export declare const MAX_CHUNK_SIZE: 100000;
+export declare const RRF_K: 60;
+export declare const DOC_BOOST: 0.15;
+export declare const MAX_NEIGHBORS: 12;
+export declare const PROMPT_TRUNCATE_LENGTH: 2000;
+export declare const CONVERSATION_MAX_CONTEXT_CHUNKS: 200;
+export declare const DEFAULT_CACHE_CLEAR_INTERVAL_MS: number;
+/**
+ * Character estimation (4 chars ≈ 1 token)
+ */
+export declare const CHAR_TO_TOKEN_RATIO = 4;
+/**
+ * Get all constants as a single object (useful for debugging)
+ */
+export declare const ALL_CONSTANTS: {
+    readonly PARSING: {
+        /**
+         * Threshold in bytes to switch to streaming parser
+         * Large files above this size are parsed in chunks to avoid memory issues
+         */
+        readonly SIZE_THRESHOLD: 30000;
+        /**
+         * Chunk size for streaming parser in bytes
+         * Parser will read this many bytes at a time when streaming
+         */
+        readonly CHUNK_SIZE: 30000;
+    };
+    readonly CACHE: {
+        /** Maximum number of BM25 indexes to cache (LRU eviction) */
+        readonly MAX_BM25_CACHE_SIZE: number;
+        /** Maximum number of code chunks to cache in memory */
+        readonly MAX_CHUNK_TEXT_CACHE_SIZE: number;
+        /** Interval for periodic cache cleanup in MCP server (milliseconds) */
+        readonly CACHE_CLEAR_INTERVAL_MS: number;
+    };
+    readonly SEARCH: {
+        /** Maximum candidates to send to reranking API */
+        readonly RERANKER_MAX_CANDIDATES: number;
+        /** Maximum code chunk size to return in bytes (prevents OOM) */
+        readonly MAX_CHUNK_SIZE: 100000;
+        /** Default result limit for search queries */
+        readonly DEFAULT_SEARCH_LIMIT: 10;
+        /** Maximum search results limit */
+        readonly MAX_SEARCH_LIMIT: 200;
+        /** Selection budget multiplier for hybrid search */
+        readonly SELECTION_BUDGET_MULTIPLIER: 60;
+        /** Reciprocal rank fusion constant */
+        readonly RRF_K_CONSTANT: 60;
+    };
+    readonly SYMBOL_BOOST: {
+        /** Boost applied when query matches function signature */
+        readonly SIGNATURE_MATCH_BOOST: 0.3;
+        /** Boost applied when query matches neighbor functions */
+        readonly NEIGHBOR_MATCH_BOOST: 0.15;
+        /** Maximum total boost from symbol matching */
+        readonly MAX_SYMBOL_BOOST: 0.45;
+        /** Minimum token length for symbol matching */
+        readonly MIN_TOKEN_LENGTH: 3;
+        /** Maximum parameters to extract from signature */
+        readonly MAX_PARAMETERS: 12;
+    };
+    readonly WATCHER: {
+        /** Default debounce interval in milliseconds */
+        readonly DEFAULT_DEBOUNCE_MS: 500;
+        /** Minimum debounce interval in milliseconds */
+        readonly MIN_DEBOUNCE_MS: 50;
+        /** Settle delay for watcher shutdown */
+        readonly SETTLE_DELAY_MS: 200;
+        /** Stability threshold for file write detection */
+        readonly STABILITY_THRESHOLD_MS: 100;
+        /** Poll interval for file stability check */
+        readonly POLL_INTERVAL_MS: 50;
+    };
+    readonly RATE_LIMIT: {
+        /** Retry delays for rate limit errors (milliseconds) */
+        readonly RETRY_DELAYS: readonly [1000, 2000, 5000, 10000];
+        /** Maximum queue size to prevent unbounded growth */
+        readonly DEFAULT_MAX_QUEUE_SIZE: 10000;
+        /** Delay buffer added to rate limit calculations */
+        readonly DELAY_BUFFER_MS: 100;
+    };
+    readonly BATCH: {
+        /** Maximum retries for failed batches */
+        readonly MAX_BATCH_RETRIES: 3;
+        /** Initial retry delay for batch failures */
+        readonly INITIAL_RETRY_DELAY_MS: 1000;
+        /** Maximum tokens per batch for OpenAI */
+        readonly MAX_BATCH_TOKENS: 100000;
+        /** Maximum tokens per individual item */
+        readonly MAX_ITEM_TOKENS: 8191;
+        /** Default batch size for embedding generation */
+        readonly DEFAULT_BATCH_SIZE: 50;
+    };
+    readonly ENCRYPTION: {
+        /** Magic header for encrypted files */
+        readonly MAGIC_HEADER: "CVAULTE1";
+        /** Salt length in bytes for key derivation */
+        readonly SALT_LENGTH: 16;
+        /** Initialization vector length in bytes */
+        readonly IV_LENGTH: 12;
+        /** Authentication tag length in bytes */
+        readonly TAG_LENGTH: 16;
+        /** HKDF info string for key derivation */
+        readonly HKDF_INFO: "codevault-chunk-v1";
+        /** Required encryption key length in bytes */
+        readonly REQUIRED_KEY_LENGTH: 32;
+    };
+    readonly LLM: {
+        /** Default temperature for multi-query generation */
+        readonly MULTI_QUERY_TEMPERATURE: 0.3;
+        /** Default temperature for answer synthesis */
+        readonly DEFAULT_TEMPERATURE: 0.7;
+        /** Maximum tokens for multi-query response */
+        readonly MULTI_QUERY_MAX_TOKENS: 500;
+        /** Default maximum tokens for chat responses */
+        readonly DEFAULT_CHAT_MAX_TOKENS: 4096;
+        /** Maximum context chunks for answer synthesis */
+        readonly DEFAULT_MAX_CHUNKS: 10;
+    };
+    readonly CHUNKING: {
+        /** Minimum token count for a valid chunk */
+        readonly MIN_CHUNK_TOKENS: 50;
+        /** Overlap percentage for line-based chunking */
+        readonly LINE_OVERLAP_PERCENTAGE: 0.2;
+        /** Maximum snippet length for signature extraction */
+        readonly MAX_SIGNATURE_SNIPPET: 400;
+        /** Maximum snippet length for call extraction */
+        readonly MAX_CALL_SNIPPET: 120;
+        /** Maximum snippet length for return type detection */
+        readonly MAX_RETURN_TYPE_SNIPPET: 80;
+    };
+    readonly CONVERSATION: {
+        /** Maximum distinct chunks retained in conversation cache */
+        readonly MAX_CONTEXT_CHUNKS: 200;
+        /** Characters to truncate prompts to */
+        readonly PROMPT_TRUNCATE_LENGTH: 2000;
+    };
+    readonly DOC_BOOST: {
+        /** Boost applied to README and documentation files */
+        readonly DOC_FILE_BOOST: 0.15;
+        /** Intent match boost */
+        readonly INTENT_MATCH_BOOST: 0.2;
+        /** Tag match boost per tag */
+        readonly TAG_MATCH_BOOST: 0.1;
+    };
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/config/constants.d.ts.map

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

package/dist/config/constants.js

@@ -0,0 +1,214 @@
+/**
+ * Centralized configuration constants for CodeVault
+ *
+ * This file contains all magic numbers and configuration values used throughout
+ * the codebase. Centralizing these values makes the system easier to tune and
+ * understand.
+ */
+/**
+ * Parsing and Tree-sitter Configuration
+ */
+export const PARSING_CONSTANTS = {
+    /**
+     * Threshold in bytes to switch to streaming parser
+     * Large files above this size are parsed in chunks to avoid memory issues
+     */
+    SIZE_THRESHOLD: 30_000,
+    /**
+     * Chunk size for streaming parser in bytes
+     * Parser will read this many bytes at a time when streaming
+     */
+    CHUNK_SIZE: 30_000,
+};
+/**
+ * Cache Configuration
+ */
+export const CACHE_CONSTANTS = {
+    /** Maximum number of BM25 indexes to cache (LRU eviction) */
+    MAX_BM25_CACHE_SIZE: parseInt(process.env.CODEVAULT_MAX_BM25_CACHE || '10', 10),
+    /** Maximum number of code chunks to cache in memory */
+    MAX_CHUNK_TEXT_CACHE_SIZE: parseInt(process.env.CODEVAULT_MAX_CHUNK_CACHE || '1000', 10),
+    /** Interval for periodic cache cleanup in MCP server (milliseconds) */
+    CACHE_CLEAR_INTERVAL_MS: parseInt(process.env.CODEVAULT_CACHE_CLEAR_INTERVAL || '3600000', 10), // 1 hour
+};
+/**
+ * Search Configuration
+ */
+export const SEARCH_CONSTANTS = {
+    /** Maximum candidates to send to reranking API */
+    RERANKER_MAX_CANDIDATES: parseInt(process.env.CODEVAULT_RERANKER_MAX || '50', 10),
+    /** Maximum code chunk size to return in bytes (prevents OOM) */
+    MAX_CHUNK_SIZE: 100_000,
+    /** Default result limit for search queries */
+    DEFAULT_SEARCH_LIMIT: 10,
+    /** Maximum search results limit */
+    MAX_SEARCH_LIMIT: 200,
+    /** Selection budget multiplier for hybrid search */
+    SELECTION_BUDGET_MULTIPLIER: 60,
+    /** Reciprocal rank fusion constant */
+    RRF_K_CONSTANT: 60,
+};
+/**
+ * Symbol Boosting Configuration
+ */
+export const SYMBOL_BOOST_CONSTANTS = {
+    /** Boost applied when query matches function signature */
+    SIGNATURE_MATCH_BOOST: 0.3,
+    /** Boost applied when query matches neighbor functions */
+    NEIGHBOR_MATCH_BOOST: 0.15,
+    /** Maximum total boost from symbol matching */
+    MAX_SYMBOL_BOOST: 0.45,
+    /** Minimum token length for symbol matching */
+    MIN_TOKEN_LENGTH: 3,
+    /** Maximum parameters to extract from signature */
+    MAX_PARAMETERS: 12,
+};
+/**
+ * File Watcher Configuration
+ */
+export const WATCHER_CONSTANTS = {
+    /** Default debounce interval in milliseconds */
+    DEFAULT_DEBOUNCE_MS: 500,
+    /** Minimum debounce interval in milliseconds */
+    MIN_DEBOUNCE_MS: 50,
+    /** Settle delay for watcher shutdown */
+    SETTLE_DELAY_MS: 200,
+    /** Stability threshold for file write detection */
+    STABILITY_THRESHOLD_MS: 100,
+    /** Poll interval for file stability check */
+    POLL_INTERVAL_MS: 50,
+};
+/**
+ * Rate Limiting Configuration
+ */
+export const RATE_LIMIT_CONSTANTS = {
+    /** Retry delays for rate limit errors (milliseconds) */
+    RETRY_DELAYS: [1000, 2000, 5000, 10000],
+    /** Maximum queue size to prevent unbounded growth */
+    DEFAULT_MAX_QUEUE_SIZE: 10_000,
+    /** Delay buffer added to rate limit calculations */
+    DELAY_BUFFER_MS: 100,
+};
+/**
+ * Batch Processing Configuration
+ */
+export const BATCH_CONSTANTS = {
+    /** Maximum retries for failed batches */
+    MAX_BATCH_RETRIES: 3,
+    /** Initial retry delay for batch failures */
+    INITIAL_RETRY_DELAY_MS: 1000,
+    /** Maximum tokens per batch for OpenAI */
+    MAX_BATCH_TOKENS: 100_000,
+    /** Maximum tokens per individual item */
+    MAX_ITEM_TOKENS: 8191,
+    /** Default batch size for embedding generation */
+    DEFAULT_BATCH_SIZE: 50,
+};
+/**
+ * Encryption Configuration
+ */
+export const ENCRYPTION_CONSTANTS = {
+    /** Magic header for encrypted files */
+    MAGIC_HEADER: 'CVAULTE1',
+    /** Salt length in bytes for key derivation */
+    SALT_LENGTH: 16,
+    /** Initialization vector length in bytes */
+    IV_LENGTH: 12,
+    /** Authentication tag length in bytes */
+    TAG_LENGTH: 16,
+    /** HKDF info string for key derivation */
+    HKDF_INFO: 'codevault-chunk-v1',
+    /** Required encryption key length in bytes */
+    REQUIRED_KEY_LENGTH: 32,
+};
+/**
+ * LLM Configuration
+ */
+export const LLM_CONSTANTS = {
+    /** Default temperature for multi-query generation */
+    MULTI_QUERY_TEMPERATURE: 0.3,
+    /** Default temperature for answer synthesis */
+    DEFAULT_TEMPERATURE: 0.7,
+    /** Maximum tokens for multi-query response */
+    MULTI_QUERY_MAX_TOKENS: 500,
+    /** Default maximum tokens for chat responses */
+    DEFAULT_CHAT_MAX_TOKENS: 4096,
+    /** Maximum context chunks for answer synthesis */
+    DEFAULT_MAX_CHUNKS: 10,
+};
+/**
+ * Chunking Configuration
+ */
+export const CHUNKING_CONSTANTS = {
+    /** Minimum token count for a valid chunk */
+    MIN_CHUNK_TOKENS: 50,
+    /** Overlap percentage for line-based chunking */
+    LINE_OVERLAP_PERCENTAGE: 0.2,
+    /** Maximum snippet length for signature extraction */
+    MAX_SIGNATURE_SNIPPET: 400,
+    /** Maximum snippet length for call extraction */
+    MAX_CALL_SNIPPET: 120,
+    /** Maximum snippet length for return type detection */
+    MAX_RETURN_TYPE_SNIPPET: 80,
+};
+/**
+ * Conversational Chat Configuration
+ */
+export const CONVERSATION_CONSTANTS = {
+    /** Maximum distinct chunks retained in conversation cache */
+    MAX_CONTEXT_CHUNKS: 200,
+    /** Characters to truncate prompts to */
+    PROMPT_TRUNCATE_LENGTH: 2000,
+};
+/**
+ * Documentation boost configuration
+ */
+export const DOC_BOOST_CONSTANTS = {
+    /** Boost applied to README and documentation files */
+    DOC_FILE_BOOST: 0.15,
+    /** Intent match boost */
+    INTENT_MATCH_BOOST: 0.2,
+    /** Tag match boost per tag */
+    TAG_MATCH_BOOST: 0.1,
+};
+/**
+ * Backward compatibility exports
+ * These maintain the old flat constant names for existing code
+ */
+// Chunking thresholds
+export const SIZE_THRESHOLD = PARSING_CONSTANTS.SIZE_THRESHOLD;
+export const CHUNK_SIZE = PARSING_CONSTANTS.CHUNK_SIZE;
+export const MAX_CHUNK_SIZE = SEARCH_CONSTANTS.MAX_CHUNK_SIZE;
+// Search and ranking constants
+export const RRF_K = SEARCH_CONSTANTS.RRF_K_CONSTANT;
+export const DOC_BOOST = DOC_BOOST_CONSTANTS.DOC_FILE_BOOST;
+// Symbol graph constants
+export const MAX_NEIGHBORS = SYMBOL_BOOST_CONSTANTS.MAX_PARAMETERS;
+// UI truncation limits
+export const PROMPT_TRUNCATE_LENGTH = CONVERSATION_CONSTANTS.PROMPT_TRUNCATE_LENGTH;
+// Conversational context limits
+export const CONVERSATION_MAX_CONTEXT_CHUNKS = CONVERSATION_CONSTANTS.MAX_CONTEXT_CHUNKS;
+// Cache cleanup interval (in milliseconds)
+export const DEFAULT_CACHE_CLEAR_INTERVAL_MS = CACHE_CONSTANTS.CACHE_CLEAR_INTERVAL_MS;
+/**
+ * Character estimation (4 chars ≈ 1 token)
+ */
+export const CHAR_TO_TOKEN_RATIO = 4;
+/**
+ * Get all constants as a single object (useful for debugging)
+ */
+export const ALL_CONSTANTS = {
+    PARSING: PARSING_CONSTANTS,
+    CACHE: CACHE_CONSTANTS,
+    SEARCH: SEARCH_CONSTANTS,
+    SYMBOL_BOOST: SYMBOL_BOOST_CONSTANTS,
+    WATCHER: WATCHER_CONSTANTS,
+    RATE_LIMIT: RATE_LIMIT_CONSTANTS,
+    BATCH: BATCH_CONSTANTS,
+    ENCRYPTION: ENCRYPTION_CONSTANTS,
+    LLM: LLM_CONSTANTS,
+    CHUNKING: CHUNKING_CONSTANTS,
+    CONVERSATION: CONVERSATION_CONSTANTS,
+    DOC_BOOST: DOC_BOOST_CONSTANTS,
+};
+//# sourceMappingURL=constants.js.map

package/dist/config/constants.js.map

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

package/dist/config/loader.d.ts

@@ -0,0 +1,57 @@
+import type { CodevaultConfig, ConfigSource } from './types.js';
+/**
+ * Read global configuration from ~/.codevault/config.json
+ * @readonly Never modifies files
+ */
+export declare function readGlobalConfig(): CodevaultConfig | null;
+/**
+ * Read project-local configuration from .codevault/config.json
+ * @readonly Never modifies files
+ */
+export declare function readProjectConfig(basePath?: string): CodevaultConfig | null;
+/**
+ * Read configuration from environment variables
+ * @readonly Never modifies files or environment
+ */
+export declare function readEnvConfig(): CodevaultConfig;
+/**
+ * Load merged configuration from all sources
+ * Priority: env > project > global
+ *
+ * @readonly Never modifies config files
+ * @param basePath Project path for project-local config
+ * @returns Merged configuration (in-memory only)
+ */
+export declare function loadConfig(basePath?: string): CodevaultConfig;
+/**
+ * Get configuration sources for debugging
+ * @readonly Never modifies files
+ */
+export declare function getConfigSources(basePath?: string): ConfigSource;
+/**
+ * Write global configuration (CLI only)
+ * This is the ONLY function that writes to disk
+ */
+export declare function saveGlobalConfig(config: CodevaultConfig): void;
+/**
+ * Write project-local configuration (CLI only)
+ * This is the ONLY function that writes project config
+ */
+export declare function saveProjectConfig(config: CodevaultConfig, basePath?: string): void;
+/**
+ * Check if global config exists
+ */
+export declare function hasGlobalConfig(): boolean;
+/**
+ * Check if project config exists
+ */
+export declare function hasProjectConfig(basePath?: string): boolean;
+/**
+ * Get global config file path
+ */
+export declare function getGlobalConfigPath(): string;
+/**
+ * Get project config file path
+ */
+export declare function getProjectConfigPath(basePath?: string): string;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAOhE;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,GAAG,IAAI,CAWzD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,SAAM,GAAG,eAAe,GAAG,IAAI,CAaxE;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAyH/C;AA6ED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,QAAQ,SAAM,GAAG,eAAe,CAO1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,SAAM,GAAG,YAAY,CAM7D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAQ9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,SAAM,GAAG,IAAI,CAW/E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,SAAM,GAAG,OAAO,CAGxD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,SAAM,GAAG,MAAM,CAE3D"}