@pleaseai/context-please-core 0.1.0

package/dist/context.d.ts

@@ -0,0 +1,276 @@
+import { Splitter } from './splitter';
+import { Embedding } from './embedding';
+import { VectorDatabase } from './vectordb';
+import { SemanticSearchResult } from './types';
+import { FileSynchronizer } from './sync/synchronizer';
+export interface ContextConfig {
+    embedding?: Embedding;
+    vectorDatabase?: VectorDatabase;
+    codeSplitter?: Splitter;
+    supportedExtensions?: string[];
+    ignorePatterns?: string[];
+    customExtensions?: string[];
+    customIgnorePatterns?: string[];
+}
+export declare class Context {
+    private embedding;
+    private vectorDatabase;
+    private codeSplitter;
+    private supportedExtensions;
+    private ignorePatterns;
+    private synchronizers;
+    constructor(config?: ContextConfig);
+    /**
+     * Get embedding instance
+     */
+    getEmbedding(): Embedding;
+    /**
+     * Get vector database instance
+     */
+    getVectorDatabase(): VectorDatabase;
+    /**
+     * Get code splitter instance
+     */
+    getCodeSplitter(): Splitter;
+    /**
+     * Get supported extensions
+     */
+    getSupportedExtensions(): string[];
+    /**
+     * Get ignore patterns
+     */
+    getIgnorePatterns(): string[];
+    /**
+     * Get synchronizers map
+     */
+    getSynchronizers(): Map<string, FileSynchronizer>;
+    /**
+     * Set synchronizer for a collection
+     */
+    setSynchronizer(collectionName: string, synchronizer: FileSynchronizer): void;
+    /**
+     * Public wrapper for loadIgnorePatterns private method
+     */
+    getLoadedIgnorePatterns(codebasePath: string): Promise<void>;
+    /**
+     * Public wrapper for prepareCollection private method
+     */
+    getPreparedCollection(codebasePath: string): Promise<void>;
+    /**
+     * Get isHybrid setting from environment variable with default true
+     */
+    private getIsHybrid;
+    /**
+     * Generate collection name based on codebase path and hybrid mode
+     */
+    getCollectionName(codebasePath: string): string;
+    /**
+     * Index a codebase for semantic search
+     * @param codebasePath Codebase root path
+     * @param progressCallback Optional progress callback function
+     * @param forceReindex Whether to recreate the collection even if it exists
+     * @returns Indexing statistics
+     */
+    indexCodebase(codebasePath: string, progressCallback?: (progress: {
+        phase: string;
+        current: number;
+        total: number;
+        percentage: number;
+    }) => void, forceReindex?: boolean): Promise<{
+        indexedFiles: number;
+        totalChunks: number;
+        status: 'completed' | 'limit_reached';
+    }>;
+    reindexByChange(codebasePath: string, progressCallback?: (progress: {
+        phase: string;
+        current: number;
+        total: number;
+        percentage: number;
+    }) => void): Promise<{
+        added: number;
+        removed: number;
+        modified: number;
+    }>;
+    private deleteFileChunks;
+    /**
+     * Semantic search with unified implementation
+     * @param codebasePath Codebase path to search in
+     * @param query Search query
+     * @param topK Number of results to return
+     * @param threshold Similarity threshold
+     */
+    semanticSearch(codebasePath: string, query: string, topK?: number, threshold?: number, filterExpr?: string): Promise<SemanticSearchResult[]>;
+    /**
+     * Check if index exists for codebase
+     * @param codebasePath Codebase path to check
+     * @returns Whether index exists
+     */
+    hasIndex(codebasePath: string): Promise<boolean>;
+    /**
+     * Clear index
+     * @param codebasePath Codebase path to clear index for
+     * @param progressCallback Optional progress callback function
+     */
+    clearIndex(codebasePath: string, progressCallback?: (progress: {
+        phase: string;
+        current: number;
+        total: number;
+        percentage: number;
+    }) => void): Promise<void>;
+    /**
+     * Update ignore patterns (merges with default patterns and existing patterns)
+     * @param ignorePatterns Array of ignore patterns to add to defaults
+     */
+    updateIgnorePatterns(ignorePatterns: string[]): void;
+    /**
+     * Add custom ignore patterns (from MCP or other sources) without replacing existing ones
+     * @param customPatterns Array of custom ignore patterns to add
+     */
+    addCustomIgnorePatterns(customPatterns: string[]): void;
+    /**
+     * Reset ignore patterns to defaults only
+     */
+    resetIgnorePatternsToDefaults(): void;
+    /**
+     * Update embedding instance
+     * @param embedding New embedding instance
+     */
+    updateEmbedding(embedding: Embedding): void;
+    /**
+     * Update vector database instance
+     * @param vectorDatabase New vector database instance
+     */
+    updateVectorDatabase(vectorDatabase: VectorDatabase): void;
+    /**
+     * Update splitter instance
+     * @param splitter New splitter instance
+     */
+    updateSplitter(splitter: Splitter): void;
+    /**
+     * Prepare vector collection
+     */
+    private prepareCollection;
+    /**
+     * Recursively get all code files in the codebase
+     */
+    private getCodeFiles;
+    /**
+ * Process a list of files with streaming chunk processing
+ * @param filePaths Array of file paths to process
+ * @param codebasePath Base path for the codebase
+ * @param onFileProcessed Callback called when each file is processed
+ * @returns Object with processed file count and total chunk count
+ */
+    private processFileList;
+    /**
+ * Process accumulated chunk buffer
+ */
+    private processChunkBuffer;
+    /**
+     * Process a batch of chunks
+     */
+    private processChunkBatch;
+    /**
+     * Get programming language based on file extension
+     */
+    private getLanguageFromExtension;
+    /**
+     * Generate unique ID based on chunk content and location
+     * @param relativePath Relative path to the file
+     * @param startLine Start line number
+     * @param endLine End line number
+     * @param content Chunk content
+     * @returns Hash-based unique ID
+     */
+    private generateId;
+    /**
+     * Read ignore patterns from file (e.g., .gitignore)
+     * @param filePath Path to the ignore file
+     * @returns Array of ignore patterns
+     */
+    static getIgnorePatternsFromFile(filePath: string): Promise<string[]>;
+    /**
+     * Load ignore patterns from various ignore files in the codebase
+     * This method preserves any existing custom patterns that were added before
+     * @param codebasePath Path to the codebase
+     */
+    private loadIgnorePatterns;
+    /**
+     * Find all .xxxignore files in the codebase directory
+     * @param codebasePath Path to the codebase
+     * @returns Array of ignore file paths
+     */
+    private findIgnoreFiles;
+    /**
+     * Load global ignore file from ~/.context/.contextignore
+     * @returns Array of ignore patterns
+     */
+    private loadGlobalIgnoreFile;
+    /**
+     * Load ignore patterns from a specific ignore file
+     * @param filePath Path to the ignore file
+     * @param fileName Display name for logging
+     * @returns Array of ignore patterns
+     */
+    private loadIgnoreFile;
+    /**
+     * Check if a path matches any ignore pattern
+     * @param filePath Path to check
+     * @param basePath Base path for relative pattern matching
+     * @returns True if path should be ignored
+     */
+    private matchesIgnorePattern;
+    /**
+     * Simple glob pattern matching
+     * @param filePath File path to test
+     * @param pattern Glob pattern
+     * @returns True if pattern matches
+     */
+    private isPatternMatch;
+    /**
+     * Simple glob matching supporting * wildcard
+     * @param text Text to test
+     * @param pattern Pattern with * wildcards
+     * @returns True if pattern matches
+     */
+    private simpleGlobMatch;
+    /**
+     * Get custom extensions from environment variables
+     * Supports CUSTOM_EXTENSIONS as comma-separated list
+     * @returns Array of custom extensions
+     */
+    private getCustomExtensionsFromEnv;
+    /**
+     * Get custom ignore patterns from environment variables
+     * Supports CUSTOM_IGNORE_PATTERNS as comma-separated list
+     * @returns Array of custom ignore patterns
+     */
+    private getCustomIgnorePatternsFromEnv;
+    /**
+     * Add custom extensions (from MCP or other sources) without replacing existing ones
+     * @param customExtensions Array of custom extensions to add
+     */
+    addCustomExtensions(customExtensions: string[]): void;
+    /**
+     * Get current splitter information
+     */
+    getSplitterInfo(): {
+        type: string;
+        hasBuiltinFallback: boolean;
+        supportedLanguages?: string[];
+    };
+    /**
+     * Check if current splitter supports a specific language
+     * @param language Programming language
+     */
+    isLanguageSupported(language: string): boolean;
+    /**
+     * Get which strategy would be used for a specific language
+     * @param language Programming language
+     */
+    getSplitterStrategyForLanguage(language: string): {
+        strategy: 'ast' | 'langchain';
+        reason: string;
+    };
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

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