erosolar-cli 1.7.367 → 1.7.368

package/dist/tools/localExplore.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Local Explore Engine - Claude Code-style codebase exploration without API calls.
+ *
+ * This module implements an offline exploration system that mimics how Claude Code's
+ * explore agent works, but without requiring an Anthropic API key. It uses:
+ *
+ * 1. Codebase indexing - Build a searchable index of files, functions, classes, imports
+ * 2. Query processing - Parse natural language questions and map to search strategies
+ * 3. Smart search - Combine glob, grep, and structure analysis
+ * 4. Answer generation - Format results in a Claude Code-like way
+ * 5. Caching - Store the index for fast subsequent queries
+ */
+import type { ToolDefinition } from '../core/toolRuntime.js';
+export interface CodebaseIndex {
+    version: number;
+    createdAt: string;
+    rootDir: string;
+    hash: string;
+    files: IndexedFile[];
+    symbols: SymbolIndex;
+    imports: ImportGraph;
+    patterns: DetectedPatterns;
+    quickLookup: QuickLookup;
+}
+export interface IndexedFile {
+    path: string;
+    language: string;
+    size: number;
+    lineCount: number;
+    lastModified: number;
+    symbols: FileSymbols;
+    imports: string[];
+    exports: string[];
+    purpose: string;
+    tags: string[];
+}
+export interface FileSymbols {
+    functions: SymbolInfo[];
+    classes: SymbolInfo[];
+    interfaces: SymbolInfo[];
+    types: SymbolInfo[];
+    constants: SymbolInfo[];
+    variables: SymbolInfo[];
+}
+export interface SymbolInfo {
+    name: string;
+    line: number;
+    kind: 'function' | 'class' | 'interface' | 'type' | 'const' | 'variable' | 'method' | 'property';
+    isExported: boolean;
+    signature?: string;
+    docComment?: string;
+}
+export interface SymbolIndex {
+    byName: Map<string, SymbolLocation[]>;
+    byKind: Map<string, SymbolLocation[]>;
+    byFile: Map<string, string[]>;
+}
+export interface SymbolLocation {
+    file: string;
+    line: number;
+    kind: string;
+    signature?: string;
+}
+export interface ImportGraph {
+    imports: Map<string, string[]>;
+    importedBy: Map<string, string[]>;
+}
+export interface DetectedPatterns {
+    architecture: string[];
+    designPatterns: string[];
+    namingConventions: string[];
+    testPatterns: string[];
+    componentPatterns: string[];
+}
+export interface QuickLookup {
+    entryPoints: string[];
+    configFiles: string[];
+    testFiles: string[];
+    componentFiles: string[];
+    typeFiles: string[];
+    utilityFiles: string[];
+    routeFiles: string[];
+    modelFiles: string[];
+}
+export interface ExploreQuery {
+    type: 'find_file' | 'find_symbol' | 'find_usage' | 'understand' | 'explain' | 'search' | 'architecture' | 'dependencies';
+    keywords: string[];
+    filters: QueryFilters;
+    originalQuery: string;
+}
+export interface QueryFilters {
+    filePattern?: string;
+    language?: string;
+    symbolKind?: string;
+    limit?: number;
+}
+export interface ExploreResult {
+    query: string;
+    queryType: string;
+    files: FileMatch[];
+    symbols: SymbolMatch[];
+    answer: string;
+    suggestions: string[];
+    timeTaken: number;
+}
+export interface FileMatch {
+    path: string;
+    relevance: number;
+    reason: string;
+    snippets?: string[];
+}
+export interface SymbolMatch {
+    name: string;
+    file: string;
+    line: number;
+    kind: string;
+    relevance: number;
+}
+export declare class LocalExploreEngine {
+    private workingDir;
+    private index;
+    private indexPath;
+    constructor(workingDir: string);
+    /**
+     * Initialize or load the codebase index.
+     * Returns true if a fresh index was built.
+     */
+    initialize(forceRebuild?: boolean): Promise<{
+        rebuilt: boolean;
+        fileCount: number;
+    }>;
+    /**
+     * Process a natural language query and return exploration results.
+     */
+    explore(query: string): Promise<ExploreResult>;
+    /**
+     * Get a quick overview of the codebase.
+     */
+    getOverview(): string;
+    private tryLoadCache;
+    private saveCache;
+    private countFiles;
+    private buildIndex;
+    private collectFiles;
+    private indexFile;
+    private extractSymbols;
+    private extractImports;
+    private extractExports;
+    private inferPurpose;
+    private generateTags;
+    private categorizeFile;
+    private detectPatterns;
+    private parseQuery;
+    private executeQuery;
+    private findFiles;
+    private findSymbols;
+    private findUsages;
+    private explainArchitecture;
+    private showDependencies;
+    private explainConcept;
+    private generalSearch;
+    private generateSuggestions;
+}
+export declare function createLocalExploreTool(workingDir: string): ToolDefinition;
+/**
+ * Create all local exploration tools (explore + index management).
+ */
+export declare function createLocalExploreTools(workingDir: string): ToolDefinition[];
+//# sourceMappingURL=localExplore.d.ts.map

package/dist/tools/localExplore.d.ts.map

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