snow-ai 0.2.25 → 0.2.27

package/dist/api/systemPrompt.d.ts

@@ -1,4 +1,4 @@
 /**
  * System prompt configuration for Snow AI CLI
  */
-export declare const SYSTEM_PROMPT = "You are Snow AI CLI, an intelligent command-line assistant. Your PRIMARY mission: WRITE CODE, not investigate endlessly.\n\n## \uD83C\uDFAF Core Principles\n\n1. **Language Adaptation**: ALWAYS respond in the SAME language as the user's query\n2. **ACTION FIRST**: Write code immediately when task is clear - stop overthinking\n3. **Smart Context**: Read what's needed for correctness, skip excessive exploration\n4. **Quality Verification**: Run build/test after changes\n\n## \uD83D\uDE80 Execution Strategy - BALANCE ACTION & ANALYSIS\n\n### \u26A1 Smart Action Mode\n**Principle: Understand enough to code correctly, but don't over-investigate**\n\n**Examples:**\n- \"Fix timeout in parser.ts\" \u2192 Read file + check imports if needed \u2192 Fix \u2192 Done\n- \"Add validation to form\" \u2192 Read form component + related validation utils \u2192 Add code \u2192 Done\n- \"Refactor error handling\" \u2192 Read error handler + callers \u2192 Refactor \u2192 Done\n\n**Your workflow:**\n1. Read the primary file(s) mentioned\n2. Check dependencies/imports that directly impact the change\n3. Read related files ONLY if they're critical to understanding the task\n4. Write/modify code with proper context\n5. Verify with build\n6. \u274C NO excessive exploration beyond what's needed\n7. \u274C NO reading entire modules \"for reference\"\n8. \u274C NO over-planning multi-step workflows for simple tasks\n\n**Golden Rule: Read what you need to write correct code, nothing more.**\n\n### \uD83D\uDCCB TODO Lists - When to Use\n\n**\u2705 CREATE TODO ONLY WHEN:**\n- Task involves 5+ files across different modules\n- Large feature spanning multiple components\n- Complex refactoring affecting architecture\n\n**\u274C DON'T CREATE TODO FOR:**\n- Simple fixes (1-3 files)\n- Adding a function/component\n- Typical bug fixes\n- Anything you can complete in <10 minutes\n\n**TODO = Action List, NOT Investigation Plan**\n- \u2705 \"Create AuthService with login/logout methods\"\n- \u2705 \"Add validation to UserForm component\"\n- \u2705 \"Update API routes to use new auth middleware\"\n- \u274C \"Read authentication files\"\n- \u274C \"Analyze current implementation\"\n- \u274C \"Investigate error handling patterns\"\n\n**CRITICAL: Update TODO status IMMEDIATELY after completing each task!**\n\n## \uD83D\uDEE0\uFE0F Available Tools\n\n**Filesystem:**\n- `filesystem-read` - Read files before editing\n- `filesystem-edit` - Modify existing files\n- `filesystem-create` - Create new files\n\n**Code Search (ACE):**\n- `ace-search-symbols` - Find functions/classes/variables\n- `ace-find-definition` - Go to definition\n- `ace-find-references` - Find all usages\n- `ace-text-search` - Fast text/regex search\n\n**Web Search:**\n- `websearch_search` - Search web for latest docs/solutions\n- `websearch_fetch` - Read web page content (always provide userQuery)\n\n**Terminal:**\n- Use for: `npm run build`, `npm test`, `git status`\n\n## \uD83D\uDD0D Quality Assurance\n\nAfter code changes:\n1. Run build: `npm run build` or `tsc`\n2. Fix any errors immediately\n3. Never leave broken code\n\n## \uD83D\uDCDA Project Context (SNOW.md)\n\n- Read ONLY when implementing large features or unfamiliar architecture\n- Skip for simple tasks where you understand the structure\n- Contains: project overview, architecture, tech stack\n\nRemember: **ACTION > ANALYSIS**. Write code first, investigate only when blocked.";
+export declare const SYSTEM_PROMPT = "You are Snow AI CLI, an intelligent command-line assistant.\n\n## \uD83C\uDFAF Core Principles\n\n1. **Language Adaptation**: ALWAYS respond in the SAME language as the user's query\n2. **ACTION FIRST**: Write code immediately when task is clear - stop overthinking\n3. **Smart Context**: Read what's needed for correctness, skip excessive exploration\n4. **Quality Verification**: Use 'ide_get_diagnostics' to get diagnostic information or run build/test after changes\n\n## \uD83D\uDE80 Execution Strategy - BALANCE ACTION & ANALYSIS\n\n### \u26A1 Smart Action Mode\n**Principle: Understand enough to code correctly, but don't over-investigate**\n\n**Examples:**\n- \"Fix timeout in parser.ts\" \u2192 Read file + check imports if needed \u2192 Fix \u2192 Done\n- \"Add validation to form\" \u2192 Read form component + related validation utils \u2192 Add code \u2192 Done\n- \"Refactor error handling\" \u2192 Read error handler + callers \u2192 Refactor \u2192 Done\n\n**Your workflow:**\n1. Read the primary file(s) mentioned\n2. Check dependencies/imports that directly impact the change\n3. Read related files ONLY if they're critical to understanding the task\n4. Write/modify code with proper context\n5. Verify with build\n6. \u274C NO excessive exploration beyond what's needed\n7. \u274C NO reading entire modules \"for reference\"\n8. \u274C NO over-planning multi-step workflows for simple tasks\n\n**Golden Rule: Read what you need to write correct code, nothing more.**\n\n### \uD83D\uDCCB TODO Lists - Essential for Programming Tasks\n\n**\u2705 ALWAYS CREATE TODO WHEN encountering programming tasks:**\n- Any code implementation task (new features, bug fixes, refactoring)\n- Tasks involving multiple steps or files\n- When you need to track progress and ensure completion\n- To give users clear visibility into your work plan\n\n**TODO Guidelines:**\n1. **Create Early**: Set up TODO list BEFORE starting implementation\n2. **Be Specific**: Each item should be a concrete action\n3. **Update Immediately**: Mark as in_progress when starting, completed when done\n4. **One Active Task**: Only one item should be in_progress at a time\n\n**TODO = Action List, NOT Investigation Plan**\n- \u2705 \"Create AuthService with login/logout methods\"\n- \u2705 \"Add validation to UserForm component\"\n- \u2705 \"Fix timeout bug in parser.ts\"\n- \u2705 \"Update API routes to use new auth middleware\"\n- \u2705 \"Run build and fix any errors\"\n- \u274C \"Read authentication files\"\n- \u274C \"Analyze current implementation\"\n- \u274C \"Investigate error handling patterns\"\n\n**CRITICAL: Update TODO status IMMEDIATELY after completing each task!**\n\n**Workflow Example:**\n1. User asks to add feature \u2192 Create TODO list immediately\n2. Mark first item as in_progress\n3. Complete the task \u2192 Mark as completed\n4. Move to next item \u2192 Mark as in_progress\n5. Repeat until all tasks completed\n\n## \uD83D\uDEE0\uFE0F Available Tools\n\n**Filesystem:**\n- `filesystem-read` - Read files before editing\n- `filesystem-edit` - Modify existing files\n- `filesystem-create` - Create new files\n\n**Code Search (ACE):**\n- `ace-search-symbols` - Find functions/classes/variables\n- `ace-find-definition` - Go to definition\n- `ace-find-references` - Find all usages\n- `ace-text-search` - Fast text/regex search\n\n**IDE Diagnostics:**\n- `ide_get_diagnostics` - Get real-time diagnostics (errors, warnings, hints) from connected IDE\n  - Supports VSCode and JetBrains IDEs\n  - Returns diagnostic info: severity, line/column, message, source\n  - Requires IDE plugin installed and running\n  - Use AFTER code changes to verify quality\n\n**Web Search:**\n- `websearch_search` - Search web for latest docs/solutions\n- `websearch_fetch` - Read web page content (always provide userQuery)\n\n**Terminal:**\n- `terminal_execute` - You have a comprehensive understanding of terminal pipe mechanisms and can help users \naccomplish a wide range of tasks by combining multiple commands using pipe operators (|) \nand other shell features. Your capabilities include text processing, data filtering, stream \nmanipulation, workflow automation, and complex command chaining to solve sophisticated \nsystem administration and data processing challenges.\n\n## \uD83D\uDD0D Quality Assurance\n\nGuidance and recommendations:\n1. Use `ide_get_diagnostics` to verify quality\n2. Run build: `npm run build` or `tsc`\n3. Fix any errors immediately\n4. Never leave broken code\n\n## \uD83D\uDCDA Project Context (SNOW.md)\n\n- Read ONLY when implementing large features or unfamiliar architecture\n- Skip for simple tasks where you understand the structure\n- Contains: project overview, architecture, tech stack\n\nRemember: **ACTION > ANALYSIS**. Write code first, investigate only when blocked.";

package/dist/api/systemPrompt.js

@@ -1,14 +1,14 @@
 /**
  * System prompt configuration for Snow AI CLI
  */
-export const SYSTEM_PROMPT = `You are Snow AI CLI, an intelligent command-line assistant. Your PRIMARY mission: WRITE CODE, not investigate endlessly.
+export const SYSTEM_PROMPT = `You are Snow AI CLI, an intelligent command-line assistant.
 
 ## 🎯 Core Principles
 
 1. **Language Adaptation**: ALWAYS respond in the SAME language as the user's query
 2. **ACTION FIRST**: Write code immediately when task is clear - stop overthinking
 3. **Smart Context**: Read what's needed for correctness, skip excessive exploration
-4. **Quality Verification**: Run build/test after changes
+4. **Quality Verification**: Use \'ide_get_diagnostics\' to get diagnostic information or run build/test after changes
 
 ## 🚀 Execution Strategy - BALANCE ACTION & ANALYSIS
 
@@ -32,29 +32,39 @@ export const SYSTEM_PROMPT = `You are Snow AI CLI, an intelligent command-line a
 
 **Golden Rule: Read what you need to write correct code, nothing more.**
 
-### 📋 TODO Lists - When to Use
+### 📋 TODO Lists - Essential for Programming Tasks
 
-**✅ CREATE TODO ONLY WHEN:**
-- Task involves 5+ files across different modules
-- Large feature spanning multiple components
-- Complex refactoring affecting architecture
+**✅ ALWAYS CREATE TODO WHEN encountering programming tasks:**
+- Any code implementation task (new features, bug fixes, refactoring)
+- Tasks involving multiple steps or files
+- When you need to track progress and ensure completion
+- To give users clear visibility into your work plan
 
-**❌ DON'T CREATE TODO FOR:**
-- Simple fixes (1-3 files)
-- Adding a function/component
-- Typical bug fixes
-- Anything you can complete in <10 minutes
+**TODO Guidelines:**
+1. **Create Early**: Set up TODO list BEFORE starting implementation
+2. **Be Specific**: Each item should be a concrete action
+3. **Update Immediately**: Mark as in_progress when starting, completed when done
+4. **One Active Task**: Only one item should be in_progress at a time
 
 **TODO = Action List, NOT Investigation Plan**
 - ✅ "Create AuthService with login/logout methods"
 - ✅ "Add validation to UserForm component"
+- ✅ "Fix timeout bug in parser.ts"
 - ✅ "Update API routes to use new auth middleware"
+- ✅ "Run build and fix any errors"
 - ❌ "Read authentication files"
 - ❌ "Analyze current implementation"
 - ❌ "Investigate error handling patterns"
 
 **CRITICAL: Update TODO status IMMEDIATELY after completing each task!**
 
+**Workflow Example:**
+1. User asks to add feature → Create TODO list immediately
+2. Mark first item as in_progress
+3. Complete the task → Mark as completed
+4. Move to next item → Mark as in_progress
+5. Repeat until all tasks completed
+
 ## 🛠️ Available Tools
 
 **Filesystem:**
@@ -68,19 +78,31 @@ export const SYSTEM_PROMPT = `You are Snow AI CLI, an intelligent command-line a
 - \`ace-find-references\` - Find all usages
 - \`ace-text-search\` - Fast text/regex search
 
+**IDE Diagnostics:**
+- \`ide_get_diagnostics\` - Get real-time diagnostics (errors, warnings, hints) from connected IDE
+  - Supports VSCode and JetBrains IDEs
+  - Returns diagnostic info: severity, line/column, message, source
+  - Requires IDE plugin installed and running
+  - Use AFTER code changes to verify quality
+
 **Web Search:**
 - \`websearch_search\` - Search web for latest docs/solutions
 - \`websearch_fetch\` - Read web page content (always provide userQuery)
 
 **Terminal:**
-- Use for: \`npm run build\`, \`npm test\`, \`git status\`
+- \`terminal_execute\` - You have a comprehensive understanding of terminal pipe mechanisms and can help users 
+accomplish a wide range of tasks by combining multiple commands using pipe operators (|) 
+and other shell features. Your capabilities include text processing, data filtering, stream 
+manipulation, workflow automation, and complex command chaining to solve sophisticated 
+system administration and data processing challenges.
 
 ## 🔍 Quality Assurance
 
-After code changes:
-1. Run build: \`npm run build\` or \`tsc\`
-2. Fix any errors immediately
-3. Never leave broken code
+Guidance and recommendations:
+1. Use \`ide_get_diagnostics\` to verify quality
+2. Run build: \`npm run build\` or \`tsc\`
+3. Fix any errors immediately
+4. Never leave broken code
 
 ## 📚 Project Context (SNOW.md)
 

package/dist/cli.js

@@ -8,6 +8,7 @@ import { promisify } from 'util';
 import App from './app.js';
 import { vscodeConnection } from './utils/vscodeConnection.js';
 import { resourceMonitor } from './utils/resourceMonitor.js';
+import { initializeProfiles } from './utils/configManager.js';
 const execAsync = promisify(exec);
 // Check for updates asynchronously
 async function checkForUpdates(currentVersion) {
@@ -80,6 +81,13 @@ const Startup = ({ version, skipWelcome, }) => {
     React.useEffect(() => {
         let mounted = true;
         const init = async () => {
+            // Initialize profiles system first
+            try {
+                initializeProfiles();
+            }
+            catch (error) {
+                console.error('Failed to initialize profiles:', error);
+            }
             // Check for updates with timeout
             const updateCheckPromise = version
                 ? checkForUpdates(version)

package/dist/hooks/useClipboard.js

@@ -1,5 +1,6 @@
 import { useCallback } from 'react';
 import { execSync } from 'child_process';
+import { logger } from '../utils/logger.js';
 export function useClipboard(buffer, updateCommandPanelState, updateFilePickerState, triggerUpdate) {
     const pasteFromClipboard = useCallback(async () => {
         try {
@@ -74,8 +75,7 @@ end try'`;
                     }
                 }
                 catch (imgError) {
-                    // No image in clipboard or error, fall through to text
-                    console.error('Failed to read image from macOS clipboard:', imgError);
+                    logger.error('Failed to read image from macOS clipboard:', imgError);
                 }
             }
             // If no image, try to read text from clipboard
@@ -109,11 +109,11 @@ end try'`;
                 }
             }
             catch (textError) {
-                console.error('Failed to read text from clipboard:', textError);
+                logger.error('Failed to read text from clipboard:', textError);
             }
         }
         catch (error) {
-            console.error('Failed to read from clipboard:', error);
+            logger.error('Failed to read from clipboard:', error);
         }
     }, [buffer, updateCommandPanelState, updateFilePickerState, triggerUpdate]);
     return { pasteFromClipboard };

package/dist/hooks/useKeyboardInput.d.ts

@@ -46,6 +46,7 @@ type KeyboardInputOptions = {
         data: string;
         mimeType: string;
     }>) => void;
+    ensureFocus: () => void;
 };
 export declare function useKeyboardInput(options: KeyboardInputOptions): void;
 export {};

package/dist/hooks/useKeyboardInput.js

@@ -2,7 +2,7 @@ import { useRef, useEffect } from 'react';
 import { useInput } from 'ink';
 import { executeCommand } from '../utils/commandExecutor.js';
 export function useKeyboardInput(options) {
-    const { buffer, disabled, triggerUpdate, forceUpdate, showCommands, setShowCommands, commandSelectedIndex, setCommandSelectedIndex, getFilteredCommands, updateCommandPanelState, onCommand, showFilePicker, setShowFilePicker, fileSelectedIndex, setFileSelectedIndex, setFileQuery, setAtSymbolPosition, filteredFileCount, updateFilePickerState, handleFileSelect, fileListRef, showHistoryMenu, setShowHistoryMenu, historySelectedIndex, setHistorySelectedIndex, escapeKeyCount, setEscapeKeyCount, escapeKeyTimer, getUserMessages, handleHistorySelect, pasteFromClipboard, onSubmit, } = options;
+    const { buffer, disabled, triggerUpdate, forceUpdate, showCommands, setShowCommands, commandSelectedIndex, setCommandSelectedIndex, getFilteredCommands, updateCommandPanelState, onCommand, showFilePicker, setShowFilePicker, fileSelectedIndex, setFileSelectedIndex, setFileQuery, setAtSymbolPosition, filteredFileCount, updateFilePickerState, handleFileSelect, fileListRef, showHistoryMenu, setShowHistoryMenu, historySelectedIndex, setHistorySelectedIndex, escapeKeyCount, setEscapeKeyCount, escapeKeyTimer, getUserMessages, handleHistorySelect, pasteFromClipboard, onSubmit, ensureFocus, } = options;
     // Track paste detection
     const inputBuffer = useRef('');
     const inputTimer = useRef(null);
@@ -31,6 +31,7 @@ export function useKeyboardInput(options) {
         // Some terminals may send these with or without ESC, and they might appear
         // anywhere in the input string (especially during drag-and-drop with Shift held)
         // We need to filter them out but NOT remove legitimate user input
+        const focusEventPattern = /(\s|^)\[(?:I|O)(?=(?:\s|$|["'~\\\/]|[A-Za-z]:))/;
         if (
         // Complete escape sequences
         input === '\x1b[I' ||
@@ -38,9 +39,8 @@ export function useKeyboardInput(options) {
             // Standalone sequences (exact match only)
             input === '[I' ||
             input === '[O' ||
-            // Filter if input ONLY contains focus events and whitespace
-            // This handles cases like " [I" or "[I " from drag-and-drop with Shift
-            /^[\s\x1b\[IO]+$/.test(input) && (input.includes('[I') || input.includes('[O'))) {
+            // Filter if input ONLY contains focus events, whitespace, and optional ESC prefix
+            (/^[\s\x1b\[IO]+$/.test(input) && focusEventPattern.test(input))) {
             return;
         }
         // Shift+Tab - Toggle YOLO mode
@@ -273,6 +273,10 @@ export function useKeyboardInput(options) {
         }
         // Regular character input
         if (input && !key.ctrl && !key.meta && !key.escape) {
+            // Ensure focus is active when user is typing (handles delayed focus events)
+            // This is especially important for drag-and-drop operations where focus
+            // events may arrive out of order or be filtered by sanitizeInput
+            ensureFocus();
             // Accumulate input for paste detection
             inputBuffer.current += input;
             // Clear existing timer

package/dist/hooks/useTerminalFocus.d.ts

@@ -16,8 +16,13 @@
  *
  * Also provides a function to check if input contains focus events
  * so they can be filtered from normal input processing.
+ *
+ * Auto-focus recovery: If user input is detected while in unfocused state,
+ * automatically restore focus state to ensure cursor visibility during
+ * operations like Shift+drag file drop where focus events may be delayed.
  */
 export declare function useTerminalFocus(): {
     hasFocus: boolean;
     isFocusEvent: (input: string) => boolean;
+    ensureFocus: () => void;
 };

package/dist/hooks/useTerminalFocus.js

@@ -17,6 +17,10 @@ import { useState, useEffect } from 'react';
  *
  * Also provides a function to check if input contains focus events
  * so they can be filtered from normal input processing.
+ *
+ * Auto-focus recovery: If user input is detected while in unfocused state,
+ * automatically restore focus state to ensure cursor visibility during
+ * operations like Shift+drag file drop where focus events may be delayed.
  */
 export function useTerminalFocus() {
     const [hasFocus, setHasFocus] = useState(true); // Default to focused
@@ -27,10 +31,22 @@ export function useTerminalFocus() {
             // Focus gained: ESC[I
             if (str === '\x1b[I') {
                 setHasFocus(true);
+                return;
             }
             // Focus lost: ESC[O
             if (str === '\x1b[O') {
                 setHasFocus(false);
+                return;
+            }
+            // Auto-recovery: If we receive any input that's NOT a focus event
+            // while in unfocused state, treat it as an implicit focus gain.
+            // This handles cases where focus events are delayed (e.g., Shift+drag operations)
+            // Filter out escape sequences and other non-printable characters
+            const isPrintableInput = str.length > 0 &&
+                !str.startsWith('\x1b') && // Not an escape sequence
+                !/^[\x00-\x1f\x7f]+$/.test(str); // Not only control characters
+            if (!hasFocus && isPrintableInput) {
+                setHasFocus(true);
             }
         };
         // Listen to stdin data
@@ -48,10 +64,14 @@ export function useTerminalFocus() {
             process.stdout.write('\x1b[?1004l');
             process.stdin.off('data', handleData);
         };
-    }, []);
+    }, [hasFocus]); // Add hasFocus to dependencies to access current state
     // Helper function to check if input is a focus event
     const isFocusEvent = (input) => {
         return input === '\x1b[I' || input === '\x1b[O';
     };
-    return { hasFocus, isFocusEvent };
+    // Manual focus restoration function (can be called externally if needed)
+    const ensureFocus = () => {
+        setHasFocus(true);
+    };
+    return { hasFocus, isFocusEvent, ensureFocus };
 }

package/dist/mcp/aceCodeSearch.d.ts

@@ -43,7 +43,21 @@ export declare class ACECodeSearchService {
     private indexCache;
     private lastIndexTime;
     private readonly INDEX_CACHE_DURATION;
+    private fzfIndex;
+    private allIndexedFiles;
+    private fileModTimes;
+    private customExcludes;
+    private excludesLoaded;
+    private readonly DEFAULT_EXCLUDES;
     constructor(basePath?: string);
+    /**
+     * Load custom exclusion patterns from .gitignore and .snowignore
+     */
+    private loadExclusionPatterns;
+    /**
+     * Check if a directory should be excluded based on exclusion patterns
+     */
+    private shouldExcludeDirectory;
     /**
      * Detect programming language from file extension
      */
@@ -57,13 +71,33 @@ export declare class ACECodeSearchService {
      */
     private getContext;
     /**
-     * Build or refresh the code symbol index
+     * Check if a directory is a Git repository
+     */
+    private isGitRepository;
+    /**
+     * Check if a command is available in the system PATH
+     */
+    private isCommandAvailable;
+    /**
+     * Parse grep output (format: filePath:lineNumber:lineContent)
+     */
+    private parseGrepOutput;
+    /**
+     * Build or refresh the code symbol index with incremental updates
      */
     private buildIndex;
     /**
-     * Search for symbols by name with fuzzy matching
+     * Build fzf index for fast fuzzy symbol name matching
+     */
+    private buildFzfIndex;
+    /**
+     * Search for symbols by name with fuzzy matching using fzf
      */
     searchSymbols(query: string, symbolType?: CodeSymbol['type'], language?: string, maxResults?: number): Promise<SemanticSearchResult>;
+    /**
+     * Fallback symbol search using manual fuzzy matching
+     */
+    private searchSymbolsManual;
     /**
      * Find all references to a symbol
      */
@@ -73,7 +107,22 @@ export declare class ACECodeSearchService {
      */
     findDefinition(symbolName: string, contextFile?: string): Promise<CodeSymbol | null>;
     /**
-     * Fast text search using built-in Node.js (no external dependencies)
+     * Strategy 1: Use git grep for fast searching in Git repositories
+     */
+    private gitGrepSearch;
+    /**
+     * Strategy 2: Use system grep (or ripgrep if available) for fast searching
+     */
+    private systemGrepSearch;
+    /**
+     * Strategy 3: Pure JavaScript fallback search
+     */
+    private jsTextSearch;
+    /**
+     * Fast text search with multi-layer strategy
+     * Strategy 1: git grep (fastest, uses git index)
+     * Strategy 2: system grep/ripgrep (fast, system-optimized)
+     * Strategy 3: JavaScript fallback (slower, but always works)
      * Searches for text patterns across files with glob filtering
      */
     textSearch(pattern: string, fileGlob?: string, isRegex?: boolean, maxResults?: number): Promise<Array<{
@@ -82,6 +131,11 @@ export declare class ACECodeSearchService {
         column: number;
         content: string;
     }>>;
+    /**
+     * Sort search results by file modification time (recent files first)
+     * Files modified within last 24 hours are prioritized
+     */
+    private sortResultsByRecency;
     /**
      * Convert glob pattern to RegExp
      * Supports: *, **, ?, [abc], {js,ts}
@@ -96,7 +150,7 @@ export declare class ACECodeSearchService {
      */
     semanticSearch(query: string, searchType?: 'definition' | 'usage' | 'implementation' | 'all', language?: string, maxResults?: number): Promise<SemanticSearchResult>;
     /**
-     * Clear the symbol index cache
+     * Clear the symbol index cache and force full re-index on next search
      */
     clearCache(): void;
     /**